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

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

# ILampArray::SetColor

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

## 語法

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

### 參數

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

要設定的所需色彩。

### 傳回值

類型：void

## 備註

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

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

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

## 需求

**標頭：** LampArray.h

**程式庫：** xgameplatform.lib

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

## 另請參閱

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


## Related topics

- [SetColorsForIndices](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolorsforindices.md)
- [SetColorsForScanCodes](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolorsforscancodes.md)
- [LampArrayColor](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/structs/lamparraycolor.md)
- [在 LampArray 上設定色彩](https://docs.xbox.com/zh-TW/build/core-features/common/lighting/lighting-colors.md)
- [LampArray 效果](https://docs.xbox.com/zh-TW/build/core-features/common/lighting/lighting-effects.md)