QRhiSwapChainHdrInfo Struct

成员变量文档

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

包含从图形 API 或平台查询到的实际值。数据类型由 `limitsType` 指定。因此，这是一个联合类型。目前有两种选项：

以尼特（nits）为单位的亮度值：

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 内容亮度设置。

若要对非HDR（SDR）内容（如2D用户界面元素）进行白电平校正，当luminanceBehavior 为SceneReferred 时，请将最终颜色值乘以sdrWhiteLevel / 80.0。（假设使用Windows系统及线性扩展sRGB（scRGB）色彩空间）

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

另请参阅 luminanceBehavior 。