GammaAdjust QML Type

Ändert die Leuchtdichte des Quellobjekts. Mehr...

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

Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

cached : bool
gamma : real
source : variant

Ausführliche Beschreibung

GammaAdjust wird auf jedes Pixel entsprechend der Kurve angewendet, die als Potenzgesetzausdruck vordefiniert ist, wobei die Eigenschaft gamma als reziproker Skalierungsexponent verwendet wird. Weitere Einzelheiten finden Sie in der Eigenschaftsdokumentation von gamma.

Quelle	Angewandter Effekt

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
    }
}

Dokumentation der Eigenschaft

cached : bool

Mit dieser Eigenschaft können die Ausgabepixel des Effekts zwischengespeichert werden, 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 erhöht sich, da für die Speicherung der Effektausgabe ein zusätzlicher Speicherplatz benötigt wird.

Es wird empfohlen, den Cache zu deaktivieren, wenn die Quelle oder die Effekteigenschaften animiert werden.

Standardmäßig ist die Eigenschaft auf false eingestellt.

gamma : real

Diese Eigenschaft definiert den Änderungsfaktor dafür, wie die Luminanz jedes Pixels gemäß der Gleichung geändert wird:

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

Bei Gamma-Werten unter 1,0 wird das Bild dunkler, bei Werten über 1,0 wird es heller.

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

Ausgabebeispiele mit verschiedenen Gammawerten

gamma: 0,5	gamma: 1.0	gamma: 2.0

Pixel-Luminanz-Kurven der obigen Bilder.

Rote Kurve: Standard-Gamma (1,0)
Gelbe Kurve: angewandter Effekt
X-Achse: ursprüngliche Pixelluminanz
Y-Achse: Pixelluminanz mit angewandtem Effekt

source : variant

Diese Eigenschaft definiert die Quelle, für die die Luminanz angepasst werden soll.

Hinweis: Es wird nicht unterstützt, dass der Effekt sich selbst einschließt, z. B. indem die Quelle auf das übergeordnete Element des Effekts gesetzt wird.

© 2025 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.