> ## 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::SetColor 方法

> 將 LampArray 上的每個 Lamp 設定為單一指定的 LampArrayColor，這是在裝置上套用統一 RGB 色彩最簡單的方式。

# ILampArray::SetColor

將 ILampArray 上的每個 Lamp 設定為所需的色彩。

## 語法

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

### 參數

*desiredColor*
類型：[LampArrayColor](/zh-TW/reference/lighting/lamparray/structs/lamparraycolor)

要設定的所需色彩。

### 傳回值

類型：void

## 備註

黑色 (以零填滿的 LampArrayColor) 相當於 Lamp 處於「關閉」狀態。

Alpha 值 (LampArrayColor::a) 代表色彩的相對透明度，其中零表示完全透明，0xFF 表示完全不透明。如果使用 0xFF 以外的 Alpha 值，色彩將會額外經過一個與黑色混合的步驟。若要避免此混合步驟，設定色彩時請勿傳入 0xFF 以外的任何 Alpha 值。

如果目前處理程序已停用 ILampArray，Lamp 狀態將不會排清至裝置 (請參閱 [ILampArray::SetIsEnabled](/zh-TW/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setisenabled))。

## 需求

**標頭：** LampArray.h

**程式庫：** xgameplatform.lib

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

## 另請參閱

[照明 API 概觀](/zh-TW/build/core-features/common/lighting/gc-lighting-toc)\
[在 LampArray 上設定色彩](/zh-TW/build/core-features/common/lighting/lighting-colors)\
[LampArrayColor](/zh-TW/reference/lighting/lamparray/structs/lamparraycolor)\
[ILampArray::SetColorsForIndices](/zh-TW/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolorsforindices)\
[ILampArray::SetColorsForScanCodes](/zh-TW/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolorsforscancodes)\
[ILampArray](/zh-TW/reference/lighting/lamparray/interfaces/ilamparray/ilamparray)


## Related topics

- [在 LampArray 上設定色彩](/zh-TW/build/core-features/common/lighting/lighting-colors.md)
- [ILampArray::SetColorsForIndices 方法](/zh-TW/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolorsforindices.md)
- [ILampArray::SetColorsForScanCodes 方法](/zh-TW/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolorsforscancodes.md)
- [ILampArray::GetIndicesForPurposes 方法](/zh-TW/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getindicesforpurposes.md)
- [ILampArray::SupportsScanCodes 方法](/zh-TW/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_supportsscancodes.md)