LevelAdjust QML Type
Passt die Farbpegel 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
Detaillierte Beschreibung
Dieser Effekt passt die Farben des Quellobjekts separat für jeden Farbkanal an. Der Kontrast des Quellobjekts kann angepasst und die Farbbalance verändert werden.
| Quelle | Angewandter Effekt |
|---|---|
|
|
Beispiel
Das folgende Beispiel zeigt, wie Sie den Effekt anwenden können.
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" } }
Eigenschaft Dokumentation
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 : variant |
Diese Eigenschaft definiert den Änderungsfaktor dafür, wie der Wert jedes Pixelfarbkanals gemäß der Gleichung geä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, die 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 Veränderung) gesetzt.
| Ausgabebeispiele mit verschiedenen Gammawerten | ||
|---|---|---|
|
|
|
| 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 |
| Pixel-Farbkanal-Luminanzkurven der obigen Bilder. | ||
|---|---|---|
|
|
|
| X-Achse: ursprüngliche Pixelluminanz | ||
| Y-Achse: Farbkanal-Luminanz mit angewandtem Effekt |
maximumInput : color |
Diese Eigenschaft definiert den maximalen Eingangspegel für jeden Farbkanal. Sie legt den Weißpunkt fest. Alle Pixel, die einen höheren Wert als diese Eigenschaft haben, werden als weiß gerendert (pro Farbkanal). Durch Verringern des Wertes werden die hellen Bereiche aufgehellt.
Der Wert reicht von "#ffffffff" bis "#00000000". Standardmäßig ist die Eigenschaft auf "#ffffffff" (keine Änderung) eingestellt.
| Ausgabebeispiele mit verschiedenen maximumInput-Werten | ||
|---|---|---|
|
|
|
| maximumInput: #FFFFFFFF | maximumInput: #FFFFFF80 | maximalerEingang: #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) |
| Pixel-Farbkanal-Luminanzkurven der obigen Bilder. | ||
|---|---|---|
|
|
|
| X-Achse: Pixel-Originalleuchtdichte | ||
| Y-Achse: Farbkanal-Luminanz mit angewandtem Effekt |
maximumOutput : color |
Diese Eigenschaft definiert den maximalen Ausgangspegel für jeden Farbkanal. Durch Verringern des Wertes werden die hellen Bereiche dunkler, wodurch der Kontrast verringert wird.
Der Wert reicht von "#ffffffff" bis "#00000000". Standardmäßig ist die Eigenschaft auf "#ffffffff" (keine Änderung) eingestellt.
| Ausgabebeispiele mit verschiedenen maximumOutput-Werten | ||
|---|---|---|
|
|
|
| maximumOutput: #FFFFFFFF | maximumOutput: #FFFFFF80 | maximalerAusgang: #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) |
| Pixel-Farbkanal-Luminanzkurven der obigen Bilder. | ||
|---|---|---|
|
|
|
| X-Achse: Pixel-Originalleuchtdichte | ||
| Y-Achse: Farbkanalluminanz mit angewandtem Effekt |
minimumInput : color |
Diese Eigenschaft definiert den minimalen Eingangspegel für jeden Farbkanal. Sie legt den Schwarzpunkt fest. Alle Pixel, die einen niedrigeren Wert als diese Eigenschaft haben, werden als schwarz gerendert (pro Farbkanal). Durch Erhöhen des Wertes werden die dunklen Bereiche dunkler.
Der Wert reicht von "#00000000" bis "#ffffffff". Standardmäßig ist die Eigenschaft auf "#00000000" (keine Änderung) eingestellt.
| Ausgabebeispiele mit verschiedenen 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) |
| Pixel-Farbkanal-Luminanzkurven der obigen Bilder. | ||
|---|---|---|
|
|
|
| X-Achse: Pixel-Originalleuchtdichte | ||
| Y-Achse: Farbkanal-Luminanz mit angewandtem Effekt |
minimumOutput : color |
Diese Eigenschaft definiert den minimalen Ausgabepegel für jeden Farbkanal. Durch Erhöhen des Wertes werden die dunklen Bereiche aufgehellt und der Kontrast verringert.
Der Wert reicht von "#00000000" bis "#ffffffff". Standardmäßig ist die Eigenschaft auf "#00000000" (keine Änderung) eingestellt.
| Ausgabebeispiele mit verschiedenen 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) |
| Pixel-Farbkanal-Luminanzkurven der obigen Bilder. | ||
|---|---|---|
|
|
|
| X-Achse: Pixel ursprüngliche Leuchtdichte | ||
| Y-Achse: Farbkanalluminanz mit angewandtem Effekt |
source : variant |
Diese Eigenschaft definiert das Quellelement, das die Quellpixel für den Effekt liefert.
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.
