QRhiSwapChainHdrInfo Struct

Documentation sur les variables membres

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

Contient les valeurs réelles récupérées via l'API graphique ou la plateforme. Le type de données est indiqué par limitsType. Il s'agit donc d'une union. Il existe actuellement deux options :

Valeurs de luminance en nits :

struct {
    float minLuminance;
    float maxLuminance;
} luminanceInNits;

Sous Windows, la luminance minimale et maximale dépend de la luminosité de l'écran. Bien que cela ne soit pas pertinent pour les ordinateurs de bureau, sur les ordinateurs portables, la luminosité de l'écran peut changer à tout moment. Une augmentation de la luminosité implique une diminution de la luminance maximale. De plus, les résultats peuvent également dépendre de la luminosité du contenu HDR définie dans les paramètres Windows, sous Système/Affichage/HDR, si un tel paramètre existe.

Notez toutefois que les modifications apportées à la luminosité de l’écran de l’ordinateur portable ou dans les paramètres système pendant l’exécution de l’application ne se répercutent pas nécessairement sur les valeurs renvoyées, ce qui signifie qu’un nouvel appel à hdrInfo() peut encore renvoyer la même plage de luminance qu’auparavant pendant le reste de la durée de vie du processus. Le comportement exact dépend de DXGI et Qt n’a aucun contrôle sur celui-ci.

Pour macOS/iOS, les valeurs maximales actuelles et maximales potentielles des composantes de couleur sont fournies :

struct {
    float maxColorComponentValue;
    float maxPotentialColorComponentValue;
} colorComponentValue;

La valeur peut dépendre de la luminosité de l’écran, ce qui, sur les ordinateurs portables, signifie que le résultat peut changer lors du prochain appel à hdrInfo() si la luminosité a été modifiée entre-temps. La luminosité maximale de l’écran implique une valeur de couleur maximale de 1,0.

Voir également QRhiSwapChain::hdrInfo().

QRhiSwapChainHdrInfo::LimitsType QRhiSwapChainHdrInfo::limitsType

Avec Metal sur macOS/iOS, les API de la plateforme ne fournissent pas de valeurs de luminance. À la place, elles fournissent la valeur maximale de la composante de couleur, qui serait de 1,0 dans une configuration non HDR. Cette valeur indique le type d’informations disponibles dans ` limits`.

Voir également QRhiSwapChain::hdrInfo().

QRhiSwapChainHdrInfo::LuminanceBehavior QRhiSwapChainHdrInfo::luminanceBehavior

Décrit le comportement présumé de la plateforme en ce qui concerne les valeurs de couleur.

Voir également sdrWhiteLevel.

float QRhiSwapChainHdrInfo::sdrWhiteLevel

Sous Windows, il s'agit du niveau de blanc SDR dynamique exprimé en nits. Cette valeur dépend de la luminosité de l'écran (sur les ordinateurs portables) et des paramètres de luminosité du contenu SDR ou HDR disponibles dans la section Système/Affichage/HDR des paramètres Windows.

Pour effectuer une correction du niveau de blanc sur du contenu non HDR (SDR), tel que les éléments d’interface utilisateur 2D, multipliez la couleur finale par sdrWhiteLevel / 80,0 lorsque luminanceBehavior vaut SceneReferred. (en supposant que vous utilisiez Windows et un espace colorimétrique sRGB étendu linéaire (scRGB))

Sur les autres plateformes, la valeur est toujours prédéfinie à 200. Elle peut ne pas correspondre au niveau de blanc SDR réel du système, mais la valeur de cette variable n’a en pratique aucune importance lorsque la variable « luminanceBehavior » est définie sur « DisplayReferred », car dans ce cas, la valeur de 1,0 de la composante de couleur fait référence par défaut au blanc SDR.

Voir également luminanceBehavior.