Auf dieser Seite

GammaAdjust QML Type

Ändert die Helligkeit des Quellelements. Mehr...

Import Statement: import Qt5Compat.GraphicalEffects
Since: QtGraphicalEffects 1.0
Inherits:

Item

Eigenschaften

Ausführliche Beschreibung

GammaAdjust wird auf jedes Pixel gemäß der Kurve angewendet, die als Potenzgesetz vordefiniert ist, wobei die Eigenschaft „gamma“ als reziproker Skalierungsexponent verwendet wird. Weitere Informationen finden Sie in der Dokumentation zu den Eigenschaften unter gamma.

QuelleAngewandter Effekt

Schwarzer Käfer auf einem Blatt

Beetle mit angewendeter Gamma-Anpassung

Beispiel

Das folgende Beispiel zeigt, wie der Effekt angewendet wird.

import QtQuick
import Qt5Compat.GraphicalEffects

Item {
    width: 300
    height: 300

    Image {
        id: bug
        source: "images/bug.jpg"
        sourceSize: Qt.size(parent.width, parent.height)
        smooth: true
        visible: false
    }

    GammaAdjust {
        anchors.fill: bug
        source: bug
        gamma: 0.45
    }
}

Eigenschaftsdokumentation

cached : bool

Diese Eigenschaft ermöglicht es, die Ausgabepixel des Effekts zwischenzuspeichern, um die Rendering-Leistung zu verbessern.

Jedes Mal, wenn die Eigenschaften der Quelle oder des Effekts geändert werden, müssen die Pixel im Cache aktualisiert werden. Der Speicherverbrauch steigt, da ein zusätzlicher Speicherpuffer zum Speichern der Effekt-Ausgabe benötigt wird.

Es wird empfohlen, den Cache zu deaktivieren, wenn die Eigenschaften der Quelle oder des Effekts animiert werden.

Standardmäßig ist die Eigenschaft auf „ false “ gesetzt.

gamma : real

Diese Eigenschaft definiert den Änderungsfaktor, um den die Leuchtdichte jedes Pixels gemäß der folgenden Gleichung verändert wird:

luminance = pow(original_luminance, 1.0 / gamma); // The luminance is assumed to be between 0.0 and 1.0

Werden Gamma-Werte unter 1,0 eingestellt, wird das Bild dunkler; Werte über 1,0 hellen es auf.

Der Wert reicht von 0,0 (am dunkelsten) bis inf (am hellsten). Standardmäßig ist die Eigenschaft auf „ 1.0 “ (keine Änderung) gesetzt.

Ausgabebeispiele mit unterschiedlichen Gamma-Werten

Dunkler Käfer, Gamma 0,5

Beetle bei normalem Gamma

Aufhellter Käfer, Gamma 2.0

gamma: 0,5 gamma: 1,0 gamma: 2,0
Pixel-Luminanzkurven der obigen Bilder.

Luminanzkurve für Gamma 0,5

Luminanzkurve für Gamma 1,0

Luminanzkurve für Gamma 2,0

Rote Kurve: Standard-Gamma (1,0)
Gelbe Kurve: angewendeter Effekt
X-Achse: ursprüngliche Pixelhelligkeit
Y-Achse: Pixelhelligkeit mit angewendetem Effekt

source : variant

Diese Eigenschaft definiert das Quellelement, dessen Luminanz angepasst werden soll.

Hinweis: Es wird nicht unterstützt, dass der Effekt sich selbst einbezieht, beispielsweise indem „source“ auf das übergeordnete Element des Effekts gesetzt wird.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.