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

# Método ILampArray::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](/pt-BR/reference/lighting/lamparray/structs/lamparraycolor)

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](/pt-BR/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setisenabled)).

## 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](/pt-BR/build/core-features/common/lighting/gc-lighting-toc)\
[Definindo cores em um LampArray](/pt-BR/build/core-features/common/lighting/lighting-colors)\
[LampArrayColor](/pt-BR/reference/lighting/lamparray/structs/lamparraycolor)\
[ILampArray::SetColorsForIndices](/pt-BR/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolorsforindices)\
[ILampArray::SetColorsForScanCodes](/pt-BR/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolorsforscancodes)\
[ILampArray](/pt-BR/reference/lighting/lamparray/interfaces/ilamparray/ilamparray)


## Related topics

- [Definir cores em um LampArray](/pt-BR/build/core-features/common/lighting/lighting-colors.md)
- [Método ILampArray::SetColorsForIndices](/pt-BR/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolorsforindices.md)
- [Método ILampArray::SetColorsForScanCodes](/pt-BR/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolorsforscancodes.md)
- [Método ILampArray::GetIndicesForPurposes](/pt-BR/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getindicesforpurposes.md)
- [Método ILampArray::SupportsScanCodes](/pt-BR/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_supportsscancodes.md)