QRhiSwapChainHdrInfo Struct

Dokumentation der Mitgliedsvariablen

union QRhiSwapChainHdrInfo::(unnamed union at /data/snapshot-qt6-6.8-rel/qt5/qtbase/src/gui/rhi/qrhi.h:1524:5) QRhiSwapChainHdrInfo::limits

Enthält die tatsächlichen Werte, die von der Grafik-API oder der Plattform abgefragt werden. Der Typ der Daten wird durch limitsType angegeben. Es handelt sich also um eine Vereinigung. Derzeit gibt es zwei Optionen:

Luminanzwerte in Nits:

struct {
    float minLuminance;
    float maxLuminance;
} luminanceInNits;

Unter Windows hängt die minimale und maximale Leuchtdichte von der Bildschirmhelligkeit ab. Während dies für Desktops nicht relevant ist, kann sich die Bildschirmhelligkeit auf Laptops jederzeit ändern. Eine Erhöhung der Helligkeit bedeutet eine Verringerung der maximalen Leuchtdichte. Darüber hinaus können die Ergebnisse auch von der HDR-Inhaltshelligkeit abhängen, die in der Ansicht System/Anzeige/HDR in den Windows-Einstellungen festgelegt ist, sofern es eine solche Einstellung gibt.

Beachten Sie jedoch, dass Änderungen an der Helligkeit des Laptop-Bildschirms oder an den Systemeinstellungen während der Ausführung der Anwendung nicht unbedingt in den zurückgegebenen Werten widergespiegelt werden, was bedeutet, dass ein erneuter Aufruf von hdrInfo() für den Rest der Lebensdauer des Prozesses immer noch den gleichen Luminanzbereich wie zuvor zurückgeben kann. Das genaue Verhalten liegt bei DXGI und Qt hat keine Kontrolle darüber.

Für macOS/iOS werden die aktuellen maximalen und potenziellen maximalen Farbkomponentenwerte angegeben:

struct {
    float maxColorComponentValue;
    float maxPotentialColorComponentValue;
} colorComponentValue;

Der Wert kann von der Bildschirmhelligkeit abhängen, was auf Laptops bedeutet, dass sich das Ergebnis beim nächsten Aufruf von hdrInfo() ändern kann, wenn die Helligkeit zwischenzeitlich geändert wurde. Die maximale Bildschirmhelligkeit impliziert einen maximalen Farbwert von 1,0.

Siehe auch QRhiSwapChain::hdrInfo().

QRhiSwapChainHdrInfo::LimitsType QRhiSwapChainHdrInfo::limitsType

Bei Metal auf macOS/iOS werden in den Plattform-APIs keine Luminanzwerte angezeigt. Stattdessen wird der maximale Farbkomponentenwert, der bei einer Nicht-HDR-Einstellung 1,0 betragen würde, bereitgestellt. Dieser Wert zeigt an, welche Art von Informationen in limits verfügbar ist.

Siehe auch QRhiSwapChain::hdrInfo().

QRhiSwapChainHdrInfo::LuminanceBehavior QRhiSwapChainHdrInfo::luminanceBehavior

Beschreibt das voraussichtliche Verhalten der Plattform in Bezug auf Farbwerte.

Siehe auch sdrWhiteLevel.

float QRhiSwapChainHdrInfo::sdrWhiteLevel

Unter Windows ist dies der dynamische SDR-Weißwert in Nits. Der Wert ist abhängig von der Bildschirmhelligkeit (bei Laptops) und den Einstellungen für die SDR- oder HDR-Inhaltshelligkeit in der Ansicht System/Anzeige/HDR der Windows-Einstellungen.

Um eine Weißwertkorrektur für Nicht-HDR-Inhalte (SDR), wie 2D-Benutzeroberflächenelemente, durchzuführen, multiplizieren Sie die endgültige Farbe mit sdrWhiteLevel / 80.0, wenn luminanceBehavior SceneReferred ist. (unter der Annahme, dass Windows und ein linear erweiterter sRGB-Farbraum (scRGB) verwendet werden)

Auf anderen Plattformen ist der Wert immer ein vordefinierter Wert, nämlich 200. Dies entspricht möglicherweise nicht dem tatsächlichen SDR-Weißwert des Systems, aber der Wert dieser Variablen ist in der Praxis nicht relevant, wenn luminanceBehavior DisplayReferred ist, da sich der Farbkomponentenwert von 1,0 dann standardmäßig auf den SDR-Weißwert bezieht.

Siehe auch luminanceBehavior.