Passer au contenu principal
Toutes les fonctions de mise à jour des couleurs d’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 subira une étape de fusion supplémentaire avec le noir. Pour éviter cette étape de fusion, ne passez pas de valeur alpha autre que 0xFF lorsque vous définissez 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 sert à mettre à jour une ou plusieurs Lamps d’un LampArray. Les indices de Lamps passés à cette API peuvent être dans n’importe quel ordre. L’exemple suivant montre comment définir des couleurs en alternance sur toutes les Lamps d’un LampArray.
L’exemple suivant montre comment mettre à jour les couleurs de Lamps individuelles ou de groupes de Lamps d’un LampArray.

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

ILampArray::SetColorsForScanCodes offre un moyen simple de définir les couleurs des Lamps de touches précises sur un clavier LampArray. Cela peut être utile, par exemple, pour enseigner aux utilisateurs les touches sur lesquelles appuyer dans un tutoriel, ou pour afficher des informations liées à l’état du jeu sur le clavier. 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 d’ILampArray LampArrayColor ILampArray::SetColor ILampArray::SetColorsForIndices ILampArray::SetColorsForScanCodes
Dernière modification le 6 octobre 2026