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 で示される。したがって、これはユニオンである。現在2つのオプションがある：

ニット単位の輝度値：

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ホワイトレベル（nits）です。この値は、画面の明るさ（ラップトップの場合）、およびWindows設定のシステム/ディスプレイ/HDRビューのSDRまたはHDRコンテンツの明るさ設定に依存します。

2D UIエレメントなど、非HDR（SDR）コンテンツのホワイトレベル補正を行うには、luminanceBehavior がSceneReferred の場合、最終カラーに sdrWhiteLevel / 80.0 を乗算します。

その他のプ ラ ッ ト フ ォームでは、 こ の値はつねに定義済みの値 200 にな り ます。これはシステムの実際のSDR白レベルとは一致しないかもしれないが、luminanceBehavior がDisplayReferred の場合、色成分値1.0はデフォルトでSDR白を参照するので、この変数の値は実際には関係ない。

luminanceBehaviorも参照のこと 。