QRhiSwapChainHdrInfo Struct

Documentation sur les variables membres

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

Contient les valeurs réelles demandées à l'API graphique ou à la plate-forme. 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. L'augmentation de la luminosité entraîne une diminution de la luminance maximale. En outre, les résultats peuvent également dépendre de la luminosité du contenu HDR définie dans la vue Système/Affichage/HDR des paramètres Windows, le cas échéant.

Notez toutefois que les modifications apportées à la luminosité de l'écran de l'ordinateur portable ou aux paramètres du système pendant l'exécution de l'application ne sont pas nécessairement reflétées dans les valeurs renvoyées, ce qui signifie que le fait de rappeler hdrInfo() peut toujours renvoyer la même plage de luminance qu'auparavant pour le reste de la durée de vie du processus. Le comportement exact dépend de DXGI et Qt n'a aucun contrôle dessus.

Pour macOS/iOS, les valeurs maximales actuelles et 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, il n'y a pas de valeurs de luminance exposées dans les API de la plateforme. À la place, la valeur maximale de la composante de couleur, qui serait de 1,0 dans une configuration non HDR, est fournie. Cette valeur indique le type d'informations disponibles sur limits.

Voir également QRhiSwapChain::hdrInfo().

QRhiSwapChainHdrInfo::LuminanceBehavior QRhiSwapChainHdrInfo::luminanceBehavior

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

Voir aussi sdrWhiteLevel.

float QRhiSwapChainHdrInfo::sdrWhiteLevel

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

Pour effectuer une correction du niveau de blanc pour le contenu non HDR (SDR), tel que les éléments 2D de l'interface utilisateur, multipliez la couleur finale par sdrWhiteLevel / 80.0 lorsque luminanceBehavior est SceneReferred(en supposant que Windows et un espace colorimétrique linéaire sRGB étendu (scRGB)).

Sur d'autres plateformes, la valeur est toujours une valeur prédéfinie, 200. Cette valeur peut ne pas correspondre au niveau de blanc SDR réel du système, mais la valeur de cette variable n'est pas pertinente dans la pratique lorsque luminanceBehavior est DisplayReferred, car la valeur de la composante couleur de 1,0 se réfère alors au blanc SDR par défaut.

Voir également luminanceBehavior.