LevelAdjust QML Type
Passt die Farbwerte im RGBA-Farbraum an. Mehr...
| Import Statement: | import Qt5Compat.GraphicalEffects |
| Since: | QtGraphicalEffects 1.0 |
| Inherits: |
Eigenschaften
- cached : bool
- gamma : variant
- maximumInput : color
- maximumOutput : color
- minimumInput : color
- minimumOutput : color
- source : variant
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.
| 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: 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 | ||
|---|---|---|
|
|
|
| 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: #000000 | minimumInput: #000000 | minimumInput: #000000 |
| maximumInput: #ffffff | maximumInput: #ffffff | maximumInput: #ffffff |
| minimumOutput: #000000 | minimumOutput: #000000 | minimumOutput: #000000 |
| maximumOutput: #ffffff | maximumOutput: #ffffff | maximumOutput: #ffffff |
| Luminanzkurven der Farbkanäle der oben gezeigten Bilder. | ||
|---|---|---|
|
|
|
| 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 | ||
|---|---|---|
|
|
|
| maximumInput: #FFFFFFFF | maximumInput: #FFFFFF80 | maximumInput: #FFFFFF30 |
| minimumInput: #000000 | minimumInput: #000000 | minimumInput: #000000 |
| minimumOutput: #000000 | minimumOutput: #000000 | minimumOutput: #000000 |
| maximumOutput: #ffffff | maximumOutput: #ffffff | maximumOutput: #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. | ||
|---|---|---|
|
|
|
| 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 | ||
|---|---|---|
|
|
|
| maximumOutput: #FFFFFFFF | maximumOutput: #FFFFFF80 | maximumOutput: #FFFFFF30 |
| minimumInput: #000000 | minimumInput: #000000 | minimumInput: #000000 |
| maximumInput: #ffffff | maximumInput: #ffffff | maximumInput: #ffffff |
| minimumOutput: #000000 | minimumOutput: #000000 | minimumOutput: #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. | ||
|---|---|---|
|
|
|
| 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 | ||
|---|---|---|
|
|
|
| minimumInput: #00000000 | minimumInput: #00000040 | minimumInput: #00000070 |
| maximumInput: #ffffff | maximumInput: #ffffff | maximumInput: #ffffff |
| minimumOutput: #000000 | minimumOutput: #000000 | minimumOutput: #000000 |
| maximumOutput: #ffffff | maximumOutput: #ffffff | maximumOutput: #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. | ||
|---|---|---|
|
|
|
| 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 | ||
|---|---|---|
|
|
|
| minimumOutput: #00000000 | minimumOutput: #00000070 | minimumOutput: #000000A0 |
| minimumInput: #000000 | minimumInput: #000000 | minimumInput: #000000 |
| maximumInput: #ffffff | maximumInput: #ffffff | maximumInput: #ffffff |
| maximumOutput: #ffffff | maximumOutput: #ffffff | maximumOutput: #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. | ||
|---|---|---|
|
|
|
| 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.



























