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

# ILampInfo::GetPosition 方法

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

# ILampInfo::GetPosition

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

## 語法

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

### 參數

此方法沒有參數。

### 傳回值

類型：[LampArrayPosition](/zh-TW/reference/lighting/lamparray/structs/lamparrayposition)

Lamp 的位置。

## 備註

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

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

位置值以公尺為單位。

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

<img src="https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/reference/lampinfoposition.png?fit=max&auto=format&n=gzrdvT5kpqAXKEQt&q=85&s=96636e1a82b7fe5ef0e091cfa3993147" alt="鍵盤 Lamp 位置" width="802" height="698" data-path="images/gdk/reference/lampinfoposition.png" />

## 需求

**標頭：** LampArray.h

**程式庫：** xgameplatform.lib

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

## 另請參閱

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


## Related topics

- [ILampInfo::GetIndex 方法](/zh-TW/reference/lighting/lamparray/interfaces/ilampinfo/methods/ilampinfo_getindex.md)
- [ILampInfo::GetPurposes 方法](/zh-TW/reference/lighting/lamparray/interfaces/ilampinfo/methods/ilampinfo_getpurposes.md)
- [ILampInfo::GetNearestSupportedColor 方法](/zh-TW/reference/lighting/lamparray/interfaces/ilampinfo/methods/ilampinfo_getnearestsupportedcolor.md)
- [ILampInfo::GetFixedColor 方法](/zh-TW/reference/lighting/lamparray/interfaces/ilampinfo/methods/ilampinfo_getfixedcolor.md)
- [ILampInfo::GetScanCode 方法](/zh-TW/reference/lighting/lamparray/interfaces/ilampinfo/methods/ilampinfo_getscancode.md)