Auf dieser Seite

LevelAdjust QML Type

Passt die Farbwerte im RGBA-Farbraum an. Mehr...

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

Item

Eigenschaften

Ausführliche Beschreibung

Dieser Effekt passt die Farben des Quellobjekts für jeden Farbkanal separat an. Der Kontrast des Quellobjekts kann angepasst und die Farbbalance verändert werden.

QuelleAngewandter Effekt

Farbenfrohe Schmetterlingsgrafik

Schmetterling mit angewendeter Höhenanpassung

Beispiel

Das folgende Beispiel zeigt, wie der Effekt angewendet wird.

import QtQuick
import Qt5Compat.GraphicalEffects

Item {
    width: 300
    height: 300

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

    LevelAdjust {
        anchors.fill: butterfly
        source: butterfly
        minimumOutput: "#00ffffff"
        maximumOutput: "#ff000000"
    }
}

Eigenschaftsdokumentation

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 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 : variant

Diese Eigenschaft definiert den Skalierungsfaktor, um den der Wert jedes Farbkanals eines Pixels gemäß der folgenden Gleichung verändert wird:

result.rgb = pow(original.rgb, 1.0 / gamma.rgb);

Die Einstellung der Gammawerte unter QtVector3d(1,0, 1,0, 1,0) macht das Bild dunkler, Werte über QtVector3d(1,0, 1,0, 1,0) hellen es auf.

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

Ausgabebeispiele mit unterschiedlichen Gamma-Werten

Butterfly bei Standard-Gamma

Schmetterling mit angepasstem RGB-Gamma

Schmetterling mit extremer Gamma-Anpassung

gamma: Qt.vector3d(1.0, 1.0, 1.0) gamma: Qt.vector3d(1,0, 0,4, 2,0) gamma: Qt.vector3d(1,0, 0,1, 4,0)
minimumInput: #000000minimumInput: #000000minimumInput: #000000
maximumInput: #ffffffmaximumInput: #ffffffmaximumInput: #ffffff
minimumOutput: #000000minimumOutput: #000000minimumOutput: #000000
maximumOutput: #ffffffmaximumOutput: #ffffffmaximumOutput: #ffffff
Luminanzkurven der Farbkanäle der oben gezeigten Bilder.

Standard-Luminanzkurve

Modifizierte Gamma-Luminanzkurve

Extreme Gamma-Luminanzkurve

X-Achse: ursprüngliche Pixelhelligkeit
Y-Achse: Luminanz des Farbkanals mit angewendetem Effekt

maximumInput : color

Diese Eigenschaft definiert den maximalen Eingangspegel für jeden Farbkanal. Sie legt den Weißpunkt fest; alle Pixel, deren Wert über diesem Wert liegt, werden (pro Farbkanal) als weiß dargestellt. Durch Verringern des Werts werden die hellen Bereiche aufgehellt.

Der Wert reicht von „#ffffffff“ bis „#00000000“. Standardmäßig ist die Eigenschaft auf „ "#ffffffff" “ gesetzt (keine Änderung).

Ausgabebeispiele mit unterschiedlichen „maximumInput“-Werten

Keine maximale Eingangsanpassung

Mittlere maximale Eingangsschwelle

Niedrige maximale Eingangsschwelle

maximumInput: #FFFFFFFF maximumInput: #FFFFFF80 maximumInput: #FFFFFF30
minimumInput: #000000minimumInput: #000000minimumInput: #000000
minimumOutput: #000000minimumOutput: #000000minimumOutput: #000000
maximumOutput: #ffffffmaximumOutput: #ffffffmaximumOutput: #ffffff
gamma: Qt.vector3d(1,0, 1,0, 1,0)gamma: Qt.vector3d(1.0, 1.0, 1.0)gamma: Qt.vector3d(1,0, 1,0, 1,0)
Luminanzkurven der Farbkanäle der oben gezeigten Bilder.

Standard-Luminanzkurve

Kurve der mittleren maximalen Eingangsleuchtdichte

Kurve mit niedriger maximaler Eingangsleuchtdichte

X-Achse: ursprüngliche Luminanz der Pixel
Y-Achse: Luminanz des Farbkanals mit angewendetem Effekt

maximumOutput : color

Diese Eigenschaft legt den maximalen Ausgabepegel für jeden Farbkanal fest. Durch Verringern des Werts werden helle Bereiche dunkler, wodurch der Kontrast verringert wird.

Der Wert reicht von „#ffffffff“ bis „#00000000“. Standardmäßig ist die Eigenschaft auf „ "#ffffffff" “ (keine Änderung) gesetzt.

Ausgabebeispiele mit unterschiedlichen „maximumOutput“-Werten

Keine Einstellung der maximalen Ausgangsleistung

Mittlerer maximaler Ausgangspegel

Niedriger maximaler Ausgangspegel

maximumOutput: #FFFFFFFF maximumOutput: #FFFFFF80 maximumOutput: #FFFFFF30
minimumInput: #000000minimumInput: #000000minimumInput: #000000
maximumInput: #ffffffmaximumInput: #ffffffmaximumInput: #ffffff
minimumOutput: #000000minimumOutput: #000000minimumOutput: #000000
gamma: Qt.vector3d(1,0, 1,0, 1,0)gamma: Qt.vector3d(1,0, 1,0, 1,0)gamma: Qt.vector3d(1,0, 1,0, 1,0)
Luminanzkurven der Pixel-Farbkanäle der obigen Bilder.

Standard-Luminanzkurve

Kurve der mittleren maximalen Ausgangsleuchtdichte

Kurve der maximalen Ausgangsleuchtdichte bei niedrigen Werten

X-Achse: ursprüngliche Pixelhelligkeit
Y-Achse: Luminanz der Farbkanäle mit angewendeter Wirkung

minimumInput : color

Diese Eigenschaft definiert den minimalen Eingangswert für jeden Farbkanal. Sie legt den Schwarzpunkt fest; alle Pixel, deren Wert unter diesem Wert liegt, werden (pro Farbkanal) als schwarz dargestellt. Durch Erhöhen des Werts werden die dunklen Bereiche dunkler dargestellt.

Der Wert reicht von „#00000000“ bis „#ffffffff“. Standardmäßig ist die Eigenschaft auf „ "#00000000" “ gesetzt (keine Änderung).

Ausgabebeispiele mit unterschiedlichen „minimumInput“-Werten

Keine Mindestanpassung der Eingabe

Niedrige Mindestschwelle für die Eingabe

Hohe Mindestschwelle für die Eingabe

minimumInput: #00000000 minimumInput: #00000040 minimumInput: #00000070
maximumInput: #ffffffmaximumInput: #ffffffmaximumInput: #ffffff
minimumOutput: #000000minimumOutput: #000000minimumOutput: #000000
maximumOutput: #ffffffmaximumOutput: #ffffffmaximumOutput: #ffffff
gamma: Qt.vector3d(1,0, 1,0, 1,0)gamma: Qt.vector3d(1,0, 1,0, 1,0)gamma: Qt.vector3d(1,0, 1,0, 1,0)
Luminanzkurven der Farbkanäle der oben gezeigten Bilder.

Standard-Luminanzkurve

Kurve der minimalen Eingangsleuchtdichte

Kurve mit hoher Mindest-Eingangsleuchtdichte

X-Achse: ursprüngliche Luminanz der Pixel
Y-Achse: Luminanz des Farbkanals mit angewendetem Effekt

minimumOutput : color

Diese Eigenschaft legt den minimalen Ausgabepegel für jeden Farbkanal fest. Durch Erhöhen des Werts werden dunkle Bereiche aufgehellt, wodurch der Kontrast verringert wird.

Der Wert reicht von „#00000000“ bis „#ffffffff“. Standardmäßig ist die Eigenschaft auf „ "#00000000" “ (keine Änderung) gesetzt.

Ausgabebeispiele mit unterschiedlichen „minimumOutput“-Werten

Keine Mindestanpassung der Leistung

Mittlerer Mindestausgangspegel

Hoher Mindestausgangspegel

minimumOutput: #00000000 minimumOutput: #00000070 minimumOutput: #000000A0
minimumInput: #000000minimumInput: #000000minimumInput: #000000
maximumInput: #ffffffmaximumInput: #ffffffmaximumInput: #ffffff
maximumOutput: #ffffffmaximumOutput: #ffffffmaximumOutput: #ffffff
gamma: Qt.vector3d(1,0, 1,0, 1,0)gamma: Qt.vector3d(1,0, 1,0, 1,0)gamma: Qt.vector3d(1,0, 1,0, 1,0)
Luminanzkurven der Farbkanäle der oben gezeigten Bilder.

Standard-Luminanzkurve

Kurve der minimalen Ausgangsleuchtdichte

Kurve mit hoher minimaler Ausgangsleuchtdichte

X-Achse: ursprüngliche Luminanz der Pixel
Y-Achse: Luminanz des Farbkanals mit angewendetem Effekt

source : variant

Diese Eigenschaft definiert das Quellelement, das die Quellpixel für den Effekt bereitstellt.

Hinweis: Es wird nicht unterstützt, dass der Effekt sich selbst einbezieht, beispielsweise durch Festlegen der Quelle auf das übergeordnete Element des Effekts.

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