Syntaxe
Paramètres
Cette méthode n’a aucun paramètre.Valeur de retour
Type : GameInputLightingGroups Combinaison d’indicateursGameInputLightingGroups pour chaque groupe d’éclairage nommé qui contient au moins une lampe du périphérique. Retourne GameInputLightingGroupUnknown (0) si le périphérique n’a aucune lampe dans un groupe nommé.
Remarques
Chaque indicateur de la valeur retournée identifie un groupe de lampes nommé, commeGameInputLightingGroupFaceButtons ou GameInputLightingGroupCenterLight, que vous pouvez cibler avec IGameInputDevice::SetLightingColor. La méthode ne signale jamais GameInputLightingGroupUnknown comme groupe, car sa valeur est 0.
Un périphérique peut disposer de lampes qui n’appartiennent à aucun groupe nommé. Une valeur de retour de 0 ne signifie donc pas toujours que le périphérique n’a aucune lampe. Pour déterminer si un périphérique prend en charge l’éclairage, vérifiez si IGameInputDevice::GetSupportedInput inclut GameInputKindLighting, ou appelez IGameInputDevice::GetSupportedLightingGroupSize avec GameInputLightingGroupAll. Pour compter les lampes qui ne font partie d’aucun groupe nommé, appelez GetSupportedLightingGroupSize avec GameInputLightingGroupUnknown.
L’exemple suivant définit en rouge les boutons de façade et en bleu le voyant central sur les périphériques qui disposent de ces groupes, puis applique les 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
GameInputLightingGroups
IGameInputDevice::GetSupportedLightingGroupSize
IGameInputDevice::SetLightingColor
IGameInputDevice::ApplyLightingColors
IGameInputDevice::ApplyLightingSystemDefault
