QRhiSwapChainHdrInfo Struct

멤버 변수 문서

union QRhiSwapChainHdrInfo::(unnamed union at /data/snapshot-qt6-6.8-rel/qt5/qtbase/src/gui/rhi/qrhi.h:1524:5) QRhiSwapChainHdrInfo::limits

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

휘도 값(니트 단위):

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에서는 니트 단위의 동적 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 를참조하세요 .