Skip to main content
Toutes les fonctions de mise à jour des couleurs sur ILampArray utilisent la structure LampArrayColor pour représenter une valeur de couleur RGBA. La valeur alpha (LampArrayColor::a) représente la transparence relative d’une couleur, où zéro correspond à une transparence totale et 0xFF à une opacité totale. Si une valeur alpha autre que 0xFF est utilisée, la couleur subit une étape de fusion supplémentaire avec le noir. Pour éviter cette étape de fusion, ne transmettez pas de valeur alpha autre que 0xFF lors de la définition des couleurs. Les API SetColor d’ILampArray sont conçues pour être appelées à partir d’un seul thread, afin d’obtenir les meilleures performances et la cohérence de l’état des Lamps.

Mise à jour de toutes les Lamps

La méthode ILampArray::SetColor modifie toutes les Lamps de l’appareil pour qu’elles correspondent à la couleur souhaitée. L’exemple suivant inscrit un rappel LampArray et définit la couleur de chaque appareil connecté.

Cibler des Lamps individuelles ou des groupes de Lamps

ILampArray::SetColorsForIndices permet de mettre à jour une ou plusieurs Lamps d’un LampArray. Les indices de Lamp transmis à cette API peuvent être dans n’importe quel ordre. L’exemple suivant montre comment définir des couleurs alternées sur toutes les Lamps d’un LampArray.
L’exemple suivant montre comment mettre à jour les couleurs de Lamps individuelles ou de groupes de Lamps sur un LampArray.

Cibler des Lamps à l’aide des codes de touche du clavier

ILampArray::SetColorsForScanCodes offre un moyen simple de définir les couleurs des Lamps de touches spécifiques sur un clavier LampArray. Cela peut être utile, par exemple, pour apprendre aux utilisateurs quelles touches appuyer dans un tutoriel, ou pour afficher sur le clavier des informations relatives à l’état du jeu. L’exemple suivant montre comment modifier la couleur des Lamps des touches WASD sur un clavier LampArray :

Voir aussi

Vue d’ensemble de l’API d’éclairage Référence ILampArray LampArrayColor ILampArray::SetColor ILampArray::SetColorsForIndices ILampArray::SetColorsForScanCodes
Last modified on October 6, 2026