QRhiSwapChainHdrInfo Struct

成员变量文档

union QRhiSwapChainHdrInfo::(unnamed union at /data/snapshot-qt6-6.9-rel/qt5/qtbase/src/gui/rhi/qrhi.h:1554: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 内容亮度设置。

要对非 HDR (SDR) 内容（如 2D UI 元素）执行白电平校正，只要luminanceBehavior 是SceneReferred ，就将最终颜色与 sdrWhiteLevel / 80.0 相乘（假定使用 Windows 和线性扩展 sRGB (scRGB) 色彩空间）。

在其他平台上，该值始终是一个预定义值，即 200。这可能与系统的实际 SDR 白电平不符，但当luminanceBehavior 为DisplayReferred 时，该变量的值实际上并不重要，因为此时色彩分量值 1.0 默认指的是 SDR 白电平。

另请参阅 luminanceBehavior 。