Sintaxe
Parâmetros
Este método não tem parâmetros.Valor retornado
Tipo: GameInputLightingGroups Uma combinação de sinalizadoresGameInputLightingGroups para cada grupo de iluminação nomeado que contém pelo menos uma lâmpada no dispositivo. Retorna GameInputLightingGroupUnknown (0) se o dispositivo não tiver lâmpadas em nenhum grupo nomeado.
Comentários
Cada sinalizador no valor retornado identifica um grupo nomeado de lâmpadas, comoGameInputLightingGroupFaceButtons ou GameInputLightingGroupCenterLight, que você pode endereçar com IGameInputDevice::SetLightingColor. O método nunca relata GameInputLightingGroupUnknown como um grupo, pois o valor dele é 0.
Um dispositivo pode ter lâmpadas que não pertencem a nenhum grupo nomeado. Portanto, um valor retornado igual a 0 nem sempre significa que o dispositivo não tem lâmpadas. Para determinar se um dispositivo oferece suporte à iluminação, verifique se IGameInputDevice::GetSupportedInput inclui GameInputKindLighting ou chame IGameInputDevice::GetSupportedLightingGroupSize com GameInputLightingGroupAll. Para contar as lâmpadas que não estão em um grupo nomeado, chame GetSupportedLightingGroupSize com GameInputLightingGroupUnknown.
O exemplo a seguir define os botões frontais como vermelhos e a luz central como azul em dispositivos que têm esses grupos e, em seguida, aplica as cores em uma única atualização.
O suporte à iluminação depende do dispositivo e da plataforma. Atualmente, o GameInput oferece suporte à iluminação em dispositivos com Iluminação Dinâmica do Windows (LampArray) e na barra de luz dos controles DualSense.
Requisitos
Cabeçalho: GameInput.h Biblioteca: gameinput.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX SeriesConfira também
Visão geral do GameInputIGameInputDevice
GameInputLightingGroups
IGameInputDevice::GetSupportedLightingGroupSize
IGameInputDevice::SetLightingColor
IGameInputDevice::ApplyLightingColors
IGameInputDevice::ApplyLightingSystemDefault
