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

> Sets every Lamp on a LampArray to a single specified LampArrayColor, providing the simplest way to apply a uniform RGB color across the device.

# ILampArray::SetColor

Sets every Lamp on the ILampArray to the desired color.

## Syntax

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

### Parameters

*desiredColor*
Type: [LampArrayColor](/reference/lighting/lamparray/structs/lamparraycolor)

The desired color to set.

### Return value

Type: void

## Remarks

Black (a zero-filled LampArrayColor) is equivalent to a Lamp being 'off'.

The alpha value (LampArrayColor::a) represents the relative transparency of a color, where zero is fully transparent and 0xFF is fully opaque. If an alpha value other than 0xFF is used, the color will undergo an additional blending step against black. To avoid this blending step, do not pass in any alpha value other than 0xFF when setting colors.

Lamp state will not be flushed to the device if the ILampArray is disabled for the current process (see [ILampArray::SetIsEnabled](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setisenabled)).

## Requirements

**Header:** LampArray.h

**Library:** xgameplatform.lib

**Supported platforms:** XBOX One family consoles and XBOX Series consoles

## See also

[Lighting API Overview](/build/core-features/common/lighting/gc-lighting-toc)\
[Setting Colors on a LampArray](/build/core-features/common/lighting/lighting-colors)\
[LampArrayColor](/reference/lighting/lamparray/structs/lamparraycolor)\
[ILampArray::SetColorsForIndices](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolorsforindices)\
[ILampArray::SetColorsForScanCodes](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolorsforscancodes)\
[ILampArray](/reference/lighting/lamparray/interfaces/ilamparray/ilamparray)


## Related topics

- [Setting colors on a LampArray](/build/core-features/common/lighting/lighting-colors.md)
- [ILampArray::SetColorsForIndices method](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolorsforindices.md)
- [ILampArray::SetColorsForScanCodes method](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolorsforscancodes.md)
- [ILampArray::SupportsScanCodes method](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_supportsscancodes.md)
- [ILampArray::GetIndicesForPurposes method](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getindicesforpurposes.md)
