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

> Define todas as Lamps de um LampArray com uma única LampArrayColor especificada, oferecendo a maneira mais simples de aplicar uma cor RGB uniforme em todo o dispositivo.

# ILampArray::SetColor

Define todas as Lamps do ILampArray com a cor desejada.

## Sintaxe

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

### Parâmetros

*desiredColor*
Tipo: [LampArrayColor](https://docs.xbox.com/pt-BR/reference/lighting/lamparray/structs/lamparraycolor.md)

A cor desejada a ser definida.

### Valor retornado

Tipo: void

## Comentários

Preto (uma LampArrayColor preenchida com zeros) equivale a uma Lamp 'desligada'.

O valor alfa (LampArrayColor::a) representa a transparência relativa de uma cor, em que zero é totalmente transparente e 0xFF é totalmente opaco. Se for usado um valor alfa diferente de 0xFF, a cor passará por uma etapa adicional de mesclagem com preto. Para evitar essa etapa de mesclagem, não passe nenhum valor alfa diferente de 0xFF ao definir cores.

O estado da Lamp não será enviado ao dispositivo se o ILampArray estiver desabilitado para o processo atual (confira [ILampArray::SetIsEnabled](https://docs.xbox.com/pt-BR/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setisenabled.md)).

## Requisitos

**Cabeçalho:** LampArray.h

**Biblioteca:** xgameplatform.lib

**Plataformas com suporte:** consoles da família XBOX One e consoles XBOX Series

## Confira também

[Visão geral da API de iluminação](https://docs.xbox.com/pt-BR/build/core-features/common/lighting/gc-lighting-toc.md)\
[Definindo cores em um LampArray](https://docs.xbox.com/pt-BR/build/core-features/common/lighting/lighting-colors.md)\
[LampArrayColor](https://docs.xbox.com/pt-BR/reference/lighting/lamparray/structs/lamparraycolor.md)\
[ILampArray::SetColorsForIndices](https://docs.xbox.com/pt-BR/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolorsforindices.md)\
[ILampArray::SetColorsForScanCodes](https://docs.xbox.com/pt-BR/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolorsforscancodes.md)\
[ILampArray](https://docs.xbox.com/pt-BR/reference/lighting/lamparray/interfaces/ilamparray/ilamparray.md)


## Related topics

- [SetColorsForIndices](https://docs.xbox.com/pt-BR/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolorsforindices.md)
- [SetColorsForScanCodes](https://docs.xbox.com/pt-BR/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolorsforscancodes.md)
- [LampArrayColor](https://docs.xbox.com/pt-BR/reference/lighting/lamparray/structs/lamparraycolor.md)
- [Definir cores em um LampArray](https://docs.xbox.com/pt-BR/build/core-features/common/lighting/lighting-colors.md)
- [Efeitos de LampArray](https://docs.xbox.com/pt-BR/build/core-features/common/lighting/lighting-effects.md)