QRhiSwapChainHdrInfo Struct

Dokumentation zu Member-Variablen

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

Enthält die tatsächlichen Werte, die von der Grafik-API oder der Plattform abgefragt wurden. Der Datentyp 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ängen die minimale und maximale Leuchtdichte von der Bildschirmhelligkeit ab. Während dies für Desktop-PCs nicht relevant ist, kann sich die Bildschirmhelligkeit bei Laptops jederzeit ändern. Eine Erhöhung der Helligkeit führt zu einer Verringerung der maximalen Luminanz. Darüber hinaus können die Ergebnisse auch von der in den Windows-Einstellungen unter „System/Anzeige/HDR“ festgelegten „HDR-Inhaltshelligkeit“ abhängen, sofern eine solche Einstellung vorhanden ist.

Beachten Sie jedoch, dass Änderungen an der Bildschirmhelligkeit des Laptops oder in den Systemeinstellungen während der Ausführung der Anwendung nicht unbedingt in den zurückgegebenen Werten berücksichtigt werden. Das bedeutet, dass ein erneuter Aufruf von `hdrInfo()` für die restliche Laufzeit des Prozesses möglicherweise weiterhin denselben Luminanzbereich wie zuvor zurückgibt. Das genaue Verhalten hängt von DXGI ab, und Qt hat darauf keinen Einfluss.

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

struct {
    float maxColorComponentValue;
    float maxPotentialColorComponentValue;
} colorComponentValue;

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

Siehe auch QRhiSwapChain::hdrInfo().

QRhiSwapChainHdrInfo::LimitsType QRhiSwapChainHdrInfo::limitsType

Bei Metal unter macOS/iOS werden in den Plattform-APIs keine Luminanzwerte bereitgestellt. Stattdessen wird der maximale Wert der Farbkomponente bereitgestellt, der in einer Nicht-HDR-Konfiguration 1,0 betragen würde. Dieser Wert gibt an, welche Informationen unter limits verfügbar sind.

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ßpegel in Nits. Der Wert hängt von der Bildschirmhelligkeit (bei Laptops) sowie von den Einstellungen für die SDR- oder HDR-Inhaltshelligkeit in den Windows-Einstellungen unter „System/Anzeige/HDR“ ab.

Um eine Weißpegelkorrektur für Nicht-HDR-Inhalte (SDR) wie z. B. 2D-UI-Elemente durchzuführen, multiplizieren Sie die endgültige Farbe mit `sdrWhiteLevel / 80,0`, wann immer ` luminanceBehavior ` den Wert ` SceneReferred` annimmt. (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. Dieser entspricht möglicherweise nicht dem tatsächlichen SDR-Weißpegel des Systems, aber der Wert dieser Variablen ist in der Praxis irrelevant, wenn „ luminanceBehavior “ auf „ DisplayReferred “ gesetzt ist, da sich der Farbkomponentenwert von 1,0 in diesem Fall standardmäßig auf das SDR-Weiß bezieht.

Siehe auch „ luminanceBehavior “.