> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GetPosition

> 傳回 Lamp 相對於其 LampArray 週框方塊原點的 3D 位置，用於在空間中排列 Lamp 以產生照明效果。

# ILampInfo::GetPosition

傳回 Lamp 相對於 LampArray 週框方塊原點的 3D 位置。

## 語法

```cpp theme={null}
LampArrayPosition GetPosition(
)
```

### 參數

此方法沒有參數。

### 傳回值

類型：[LampArrayPosition](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/structs/lamparrayposition.md)

Lamp 的位置。

## 備註

週框方塊的原點 (零) 是方塊最上方、最遠處的左側角落。

X 對應寬度，由左至右遞增。\
Y 對應高度，由最遠處至最近處遞增。\
Z 對應深度，由上至下遞增。

位置值以公尺為單位。

以下是鍵盤上品牌 Lamp 位置的範例：

![鍵盤 Lamp 位置](https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/reference/lampinfoposition.png?fit=max\&auto=format\&n=gzrdvT5kpqAXKEQt\&q=85\&s=96636e1a82b7fe5ef0e091cfa3993147)

## 需求

**標頭：** LampArray.h

**程式庫：** xgameplatform.lib

**支援的平台：** XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[照明 API 概觀](https://docs.xbox.com/zh-TW/build/core-features/common/lighting/gc-lighting-toc.md)\
[ILampArray::GetBoundingBox](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getboundingbox.md)\
[ILampInfo](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/interfaces/ilampinfo/ilampinfo.md)


## Related topics

- [LampArrayPosition](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/structs/lamparrayposition.md)
- [GetBoundingBox](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getboundingbox.md)
- [LampArray 效果](https://docs.xbox.com/zh-TW/build/core-features/common/lighting/lighting-effects.md)
- [ILampInfo (介面內容)](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/interfaces/ilampinfo/ilampinfo.md)
- [GetXmaDecodePositionForSample](https://docs.xbox.com/zh-TW/reference/audio/xma2defs/functions/getxmadecodepositionforsample.md)