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

# SetColor

> ILampArray::SetColor

# ILampArray::SetColor

将 ILampArray 上的每个 Lamp 设置为所需颜色。

## 语法

```cpp theme={null}
void SetColor(
    LampArrayColor desiredColor)
```

### 参数

*desiredColor*
类型：[LampArrayColor](https://docs.xbox.com/zh-CN/reference/lighting/lamparray/structs/lamparraycolor.md)

要设置的目标颜色。

### 返回值

类型：void

## 备注

黑色（一个填充为零的 LampArrayColor）等同于 Lamp 处于“关闭”状态。

alpha 值 (LampArrayColor::a) 表示颜色的相对透明度，其中零表示完全透明，0xFF 表示完全不透明。如果使用的 alpha 值不是 0xFF，颜色将会与黑色进行额外的混合步骤。为了避免这一混合步骤，设置颜色时请勿传入除 0xFF 以外的 alpha 值。

如果 ILampArray 在当前进程中被禁用，Lamp 状态不会刷新到设备（请参阅 [ILampArray::SetIsEnabled](https://docs.xbox.com/zh-CN/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setisenabled.md)）。

## 要求

**头文件：** LampArray.h

**库：** xgameplatform.lib

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

## 另请参阅

[光照 API 概览](https://docs.xbox.com/zh-CN/build/core-features/common/lighting/gc-lighting-toc.md)\
[在 LampArray 上设置颜色](https://docs.xbox.com/zh-CN/build/core-features/common/lighting/lighting-colors.md)\
[LampArrayColor](https://docs.xbox.com/zh-CN/reference/lighting/lamparray/structs/lamparraycolor.md)\
[ILampArray::SetColorsForIndices](https://docs.xbox.com/zh-CN/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolorsforindices.md)\
[ILampArray::SetColorsForScanCodes](https://docs.xbox.com/zh-CN/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolorsforscancodes.md)\
[ILampArray](https://docs.xbox.com/zh-CN/reference/lighting/lamparray/interfaces/ilamparray/ilamparray.md)


## Related topics

- [SetColorsForIndices](https://docs.xbox.com/zh-CN/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolorsforindices.md)
- [SetColorsForScanCodes](https://docs.xbox.com/zh-CN/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolorsforscancodes.md)
- [在 LampArray 上设置颜色](https://docs.xbox.com/zh-CN/build/core-features/common/lighting/lighting-colors.md)
- [LampArray 效果](https://docs.xbox.com/zh-CN/build/core-features/common/lighting/lighting-effects.md)
- [GetMinUpdateIntervalInMicroseconds](https://docs.xbox.com/zh-CN/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getminupdateintervalinmicroseconds.md)