QRhiSwapChainHdrInfo Struct

メンバ変数のドキュメント

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

グラフィックスAPIまたはプラットフォームから取得した実際の値が含まれます。データの型はlimitsType で指定されます。したがって、これはユニオン型となります。現在、以下の2つのオプションがあります：

ニット単位の輝度値：

struct {
    float minLuminance;
    float maxLuminance;
} luminanceInNits;

Windows では、輝度の最小値と最大値は画面の明るさに依存します。デスクトップPCでは関係ありませんが、ノートPCでは画面の明るさがいつでも変化する可能性があります。 輝度を上げると、最大輝度は低下します。さらに、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」も参照してください 。