Syntaxe
Paramètres
Cette méthode n’a aucun paramètre.Valeur de retour
Type : voidRemarques
Les couleurs que vous définissez en appelant IGameInputDevice::SetLightingColor sont uniquement préparées ; elles ne modifient pas les lampes tant que vous n’appelez pasApplyLightingColors. Cette méthode envoie au périphérique les couleurs préparées de toutes les lampes en une seule écriture, de sorte que les modifications apportées à plusieurs groupes ou lampes prennent effet en même temps.
Seules les lampes pour lesquelles une couleur a été préparée sont mises à jour. Si aucune couleur n’est préparée, l’appel n’a aucun effet.
Les couleurs préparées restent en vigueur après leur application. Pour modifier ultérieurement un groupe, préparez la nouvelle couleur pour ce groupe et appelez de nouveau ApplyLightingColors ; les couleurs des autres lampes sont conservées. Pour ignorer toutes les couleurs préparées et rétablir le comportement par défaut des lampes, appelez IGameInputDevice::ApplyLightingSystemDefault.
Lorsque le périphérique se déconnecte, ses couleurs préparées sont ignorées. Les appels sur un périphérique déconnecté n’ont aucun effet.
L’exemple suivant définit en rouge les boutons de façade d’une manette et en bleu son voyant central, puis applique les deux couleurs en une seule mise à jour.
La prise en charge de l’éclairage dépend du périphérique et de la plateforme. Actuellement, GameInput prend en charge l’éclairage des périphériques Windows Dynamic Lighting (LampArray) et de la barre lumineuse des manettes DualSense.
Configuration requise
En-tête : GameInput.h Bibliothèque : gameinput.lib Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX SeriesVoir aussi
Vue d’ensemble de GameInputIGameInputDevice
IGameInputDevice::SetLightingColor
IGameInputDevice::ApplyLightingSystemDefault
IGameInputDevice::GetSupportedLightingGroups
GameInputColor
GameInputLightingGroups
