QRhiSwapChainHdrInfo Struct

Documentación de la variable miembro

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

Contiene los valores reales consultados a la API gráfica o a la plataforma. El tipo de datos se indica mediante limitsType. Se trata, por tanto, de una unión. Actualmente existen dos opciones:

Valores de luminancia en nits:

struct {
    float minLuminance;
    float maxLuminance;
} luminanceInNits;

En Windows la luminancia mínima y máxima depende del brillo de la pantalla. Aunque no es relevante para ordenadores de sobremesa, en portátiles el brillo de la pantalla puede cambiar en cualquier momento. Aumentar el brillo implica disminuir la luminancia máxima. Además, los resultados también pueden depender del Brillo del contenido HDR configurado en la vista Sistema/Pantalla/HDR de la Configuración de Windows, si existe tal configuración.

Tenga en cuenta, sin embargo, que los cambios realizados en el brillo de la pantalla del portátil o en la configuración del sistema mientras se ejecuta la aplicación no se reflejan necesariamente en los valores devueltos, lo que significa que volver a llamar a hdrInfo() puede seguir devolviendo el mismo rango de luminancia que antes durante el resto de la vida del proceso. El comportamiento exacto depende de DXGI y Qt no tiene control sobre él.

Para macOS/iOS, se proporcionan los valores máximo actual y máximo potencial del componente de color:

struct {
    float maxColorComponentValue;
    float maxPotentialColorComponentValue;
} colorComponentValue;

El valor puede depender del brillo de la pantalla, lo que en portátiles significa que el resultado puede cambiar en la siguiente llamada a hdrInfo() si el brillo se ha modificado entretanto. El brillo máximo de la pantalla implica un valor de color máximo de 1,0.

Véase también QRhiSwapChain::hdrInfo().

QRhiSwapChainHdrInfo::LimitsType QRhiSwapChainHdrInfo::limitsType

Con Metal en macOS/iOS, no hay valores de luminancia expuestos en las API de la plataforma. En su lugar, se proporciona el valor máximo del componente de color, que sería 1,0 en una configuración no HDR. Este valor indica qué tipo de información está disponible en limits.

Véase también QRhiSwapChain::hdrInfo().

QRhiSwapChainHdrInfo::LuminanceBehavior QRhiSwapChainHdrInfo::luminanceBehavior

Describe el comportamiento supuesto de la plataforma con respecto a los valores de color.

Véase también sdrWhiteLevel.

float QRhiSwapChainHdrInfo::sdrWhiteLevel

En Windows es el nivel de blanco dinámico SDR en nits. El valor depende del brillo de la pantalla (en portátiles) y de los ajustes de Brillo del contenido SDR o HDR en la vista Sistema/Pantalla/HDR de los ajustes de Windows.

Para realizar la corrección del nivel de blanco para contenidos no HDR (SDR), como elementos de interfaz de usuario 2D, multiplique el color final por sdrWhiteLevel / 80.0 siempre que luminanceBehavior sea SceneReferred. (suponiendo Windows y un espacio de color sRGB (scRGB) lineal extendido).

En otras plataformas el valor es siempre un valor predefinido, 200. Esto puede no coincidir con el nivel de blanco SDR real del sistema, pero el valor de esta variable no es relevante en la práctica cuando luminanceBehavior es DisplayReferred, porque entonces el valor del componente de color de 1.0 se refiere al blanco SDR por defecto.

Véase también luminanceBehavior.