XDisplayHdrModeInfo

연결된 디스플레이에서 HDR(High Dynamic Range)에 대한 최소 및 최대 톤 맵 조도 값을 지정합니다.

구문

typedef struct XDisplayHdrModeInfo {  
    float minToneMapLuminance;  
    float maxToneMapLuminance;  
    float maxFullFrameToneMapLuminance;  
} XDisplayHdrModeInfo  

멤버

minToneMapLuminance
형식: float

최소 톤 맵 조도(MinTML) 값(니트)입니다.

maxToneMapLuminance
형식: float

최대 톤 맵 조도(MaxTML) 값(니트)입니다.

maxFullFrameToneMapLuminance
형식: float

최대 전체 프레임 톤 맵 조도(MaxFFTML) 값(니트)입니다.

비고

XDisplayTryEnableHdrMode 함수는 이 함수가 연결된 디스플레이에 대해 HDR 모드를 활성화할 수 있는지 여부를 나타내는 XDisplayHdrModeResult 열거형 값을 반환합니다. XDisplayHdrModeResult::Enabled가 반환된 경우, 이 함수는 또한 HDR 모드에 대한 최소 및 최대 톤 맵 조도 값을 포함하여 디스플레이의 HDR 모드 정보가 포함된 XDisplayHdrModeInfo 구조를 제공합니다.

HDR 조도 값 및 톤 매핑에 대한 자세한 내용은 HDR Gaming Interest Group 웹 사이트의향상된 HDR 게이밍 환경 지원을 참조하세요.

다음 예에서는 연결된 디스플레이에 대해 HDR 모드를 활성화하려고 시도합니다. XDisplayHdrModeInfo::Enabled가 반환된 경우 HDR 모드가 디스플레이에 대해 활성화되고, 게임이 반환된 XDisplayHdrModeInfo 구조의 조도 값을 사용하여 HDR 모드로 초기화됩니다. 그렇지 않으면 HDR 모드가 제공되지 않았거나 비활성화된 것이고, 게임이 SDR(Standard Dynamic Range) 모드로 초기화됩니다.

void Game::InitializeHDRMode() 
{
    // Attempt to enable HDR mode, then initialize based on the 
    // result of the attempt.
    XDisplayHdrModeInfo displayModeHdrInfo;

    if (XDisplayHdrModeResult::Enabled == XDisplayTryEnableHdrMode(XDisplayHdrModePreference::PreferHdr, &displayModeHdrInfo))
    {
        // HDR mode is enabled for the attached display.
        InitializeAsHDR(
            displayModeHdrInfo.minToneMapLuminance,
            displayModeHdrInfo.maxToneMapLuminance,
            displayModeHdrInfo.maxFullFrameToneMapLuminance);
    }
    else
    {
        // Either HDR mode is disabled for the attached display, or the
        // attached display does not support HDR.
        InitializeAsSDR();
    }
}

요구 사항

헤더: XDisplay.h

지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔

참고 항목

XDisplayHdrModeResult
XDisplayTryEnableHdrMode
XDisplay