QRhiSwapChainHdrInfo Struct

멤버 변수 설명서

union QRhiSwapChainHdrInfo::(unnamed union) QRhiSwapChainHdrInfo::limits

그래픽 API 또는 플랫폼에서 조회한 실제 값을 포함합니다. 데이터 유형은 limitsType 로 표시됩니다. 따라서 이는 연합(union)입니다. 현재 두 가지 옵션이 있습니다:

니트(nit) 단위의 휘도 값:

struct {
    float minLuminance;
    float maxLuminance;
} luminanceInNits;

Windows에서 최소 및 최대 휘도는 화면 밝기에 따라 달라집니다. 데스크톱의 경우 관련이 없지만, 노트북에서는 화면 밝기가 언제든지 변경될 수 있습니다. 밝기가 증가하면 최대 휘도가 감소합니다. 또한, 해당 설정이 있는 경우 결과는 Windows 설정의 ‘시스템/디스플레이/HDR’ 탭에서 설정된 HDR 콘텐츠 밝기에 따라 달라질 수도 있습니다.

다만, 애플리케이션 실행 중에 노트북 화면의 밝기나 시스템 설정을 변경하더라도 반환된 값에 반드시 반영되지는 않는다는 점에 유의하십시오. 즉, hdrInfo()를 다시 호출하더라도 프로세스가 종료될 때까지 이전과 동일한 휘도 범위가 반환될 수 있습니다. 정확한 동작은 DXGI에 달려 있으며, Qt는 이를 제어할 수 없습니다.

macOS/iOS의 경우, 현재 최대 및 잠재적 최대 색상 구성 요소 값이 제공됩니다:

struct {
    float maxColorComponentValue;
    float maxPotentialColorComponentValue;
} colorComponentValue;

이 값은 화면 밝기에 따라 달라질 수 있으며, 노트북의 경우 그 사이 화면 밝기가 변경되었다면 다음 hdrInfo() 호출 시 결과가 달라질 수 있습니다. 최대 화면 밝기는 최대 색상 값 1.0을 의미합니다.

QRhiSwapChain::hdrInfo()도 참조하십시오 .

QRhiSwapChainHdrInfo::LimitsType QRhiSwapChainHdrInfo::limitsType

macOS/iOS의 Metal에서는 플랫폼 API를 통해 휘도 값이 노출되지 않습니다. 대신, HDR이 아닌 설정에서는 1.0이 되는 최대 색상 구성 요소 값이 제공됩니다. 이 값은 limits 에서 어떤 종류의 정보를 확인할 수 있는지를 나타냅니다.

QRhiSwapChain::hdrInfo()도 참조하십시오 .

QRhiSwapChainHdrInfo::LuminanceBehavior QRhiSwapChainHdrInfo::luminanceBehavior

색상 값과 관련하여 플랫폼이 보일 것으로 예상되는 동작을 설명합니다.

sdrWhiteLevel도 참조하십시오 .

float QRhiSwapChainHdrInfo::sdrWhiteLevel

Windows에서는 이 값이 니트(nits) 단위의 동적 SDR 화이트 레벨을 나타냅니다. 이 값은 화면 밝기(노트북의 경우)와 Windows 설정의 ‘시스템/디스플레이/HDR’ 화면에서 지정된 SDR 또는 HDR 콘텐츠 밝기 설정에 따라 달라집니다.

2D UI 요소와 같은 비-HDR(SDR) 콘텐츠에 대해 백색 레벨 보정을 수행하려면, ` luminanceBehavior `가 ` SceneReferred`인 경우 최종 색상에 `sdrWhiteLevel / 80.0`을 곱하십시오. (Windows 및 선형 확장 sRGB(scRGB) 색 공간을 가정함)

다른 플랫폼에서는 이 값이 항상 미리 정의된 값인 200입니다. 이는 시스템의 실제 SDR 백색 레벨과 일치하지 않을 수 있지만, luminanceBehavior 가 DisplayReferred 일 때는 이 변수의 값이 실제로는 관련이 없습니다. 이때 1.0의 색상 구성 요소 값은 기본적으로 SDR 백색을 가리키기 때문입니다.

luminanceBehavior도 참조하십시오 .