> ## 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.

# ILampArray::GetBoundingBox 方法

> 傳回包圍 LampArray 周邊裝置上每個 Lamp 的邏輯 3D 週框方塊，以距離裝置原點的毫米表示。

# ILampArray::GetBoundingBox

傳回包圍 ILampArray 的邏輯 3D 週框方塊。

## 語法

```cpp theme={null}
void GetBoundingBox(
    LampArrayPosition* boundingBox)
```

### 參數

*boundingBox*  \_Out\_\
類型：[LampArrayPosition\*](/zh-TW/reference/lighting/lamparray/structs/lamparrayposition)

週框方塊的值。

### 傳回值

類型：void

## 備註

週框方塊的原點 (零) 是方塊最上方、最遠端的左側角落。[ILampInfo::GetPosition](/zh-TW/reference/lighting/lamparray/interfaces/ilampinfo/methods/ilampinfo_getposition) 的結果是以此原點為基準定向。

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

值以公尺為單位測量。

以下是鍵盤週框方塊的範例：

<img src="https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/reference/lamparrayboundingboxkbd.png?fit=max&auto=format&n=gzrdvT5kpqAXKEQt&q=85&s=2332b170bdd3aca9c71e4117e5efd462" alt="鍵盤週框方塊" width="1054" height="785" data-path="images/gdk/reference/lamparrayboundingboxkbd.png" />

以下是滑鼠週框方塊的範例：

<img src="https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/reference/lamparrayboundingboxmouse.png?fit=max&auto=format&n=gzrdvT5kpqAXKEQt&q=85&s=4ca1a174145c554028f92258dd9e2653" alt="滑鼠週框方塊" width="794" height="645" data-path="images/gdk/reference/lamparrayboundingboxmouse.png" />

## 需求

**標頭：** LampArray.h

**程式庫：** xgameplatform.lib

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

## 另請參閱

[照明 API 概觀](/zh-TW/build/core-features/common/lighting/gc-lighting-toc)\
[LampArrayPosition](/zh-TW/reference/lighting/lamparray/structs/lamparrayposition)\
[ILampArray](/zh-TW/reference/lighting/lamparray/interfaces/ilamparray/ilamparray)


## Related topics

- [ILampArray::GetBoundingBox](/ja-jp/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getboundingbox.md)
- [ILampArray::GetBoundingBox method](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getboundingbox.md)
- [Método ILampArray::GetBoundingBox](/es/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getboundingbox.md)
- [LampArrayPosition](/ko/reference/lighting/lamparray/structs/lamparrayposition.md)
- [LampArrayPosition struct reference](/reference/lighting/lamparray/structs/lamparrayposition.md)