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

> ILampArray::GetBoundingBox

# ILampArray::GetBoundingBox

返回包含 ILampArray 的逻辑 3D 边界框。

## 语法

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

### 参数

*boundingBox*  \_Out\_\
类型：[LampArrayPosition\*](/reference/lighting/lamparray/structs/lamparrayposition)

边界框的值。

### 返回值

类型：void

## 备注

边界框的原点（零点）是该框最上方、最远、最左侧的角。[ILampInfo::GetPosition](/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="Keyboard bounding box" 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="Mouse bounding box" width="794" height="645" data-path="images/gdk/reference/lamparrayboundingboxmouse.png" />

## 要求

**头文件：** LampArray.h

**库：** xgameplatform.lib

**支持的平台：** XBOX One 系列主机和 XBOX Series 主机

## 另请参阅

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


## Related topics

- [LampArrayPosition](/zh-CN/reference/lighting/lamparray/structs/lamparrayposition.md)
- [ILampInfo::GetPosition](/zh-CN/reference/lighting/lamparray/interfaces/ilampinfo/methods/ilampinfo_getposition.md)
- [LampArray 效果](/zh-CN/build/core-features/common/lighting/lighting-effects.md)
- [ILampArray::GetLampArrayKind](/zh-CN/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getlamparraykind.md)
- [ILampArray::GetLampInfo](/zh-CN/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getlampinfo.md)