BrightnessContrast QML Type
Stellt Helligkeit und Kontrast ein. Mehr...
| Import Statement: | import Qt5Compat.GraphicalEffects |
| Since: | QtGraphicalEffects 1.0 |
| Inherits: |
Eigenschaften
- brightness : real
- cached : bool
- contrast : real
- source : variant
Ausführliche Beschreibung
Hinweis: Die Komponente „ MultiEffect “ bietet einen Helligkeits- und Kontrasteffekt mit einigen Leistungsvorteilen. Bei neuem Code sollte sie als Alternative zur Verwendung von Qt Graphical Effects in Betracht gezogen werden.
Dieser Effekt passt die Farben des Quellelements an. Die Helligkeitsanpassung verändert die wahrgenommene Leuchtdichte des Quellelements. Die Kontrastanpassung verstärkt oder verringert die Farb- und Helligkeitsunterschiede.
| 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
}
BrightnessContrast {
anchors.fill: bug
source: bug
brightness: 0.5
contrast: 0.5
}
}Dokumentation zu den Eigenschaften
brightness : real
Diese Eigenschaft legt fest, um wie viel die Helligkeit der Quelle erhöht oder verringert wird.
Der Wert liegt im Bereich von -1,0 bis 1,0. Standardmäßig ist die Eigenschaft auf „ 0.0 “ (keine Änderung) gesetzt.
| Ausgabebeispiele mit unterschiedlichen Helligkeitswerten | ||
|---|---|---|
|
|
|
| Helligkeit: -0,25 | Helligkeit: 0 | Helligkeit: 0,5 |
| contrast: 0 | contrast: 0 | contrast: 0 |
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 für die Speicherung der Effekt-Ausgabe ein zusätzlicher Speicherpuffer 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.
contrast : real
Diese Eigenschaft legt fest, um wie viel der Quellkontrast erhöht oder verringert wird. Die Verringerung des Kontrasts erfolgt linear, die Erhöhung hingegen wird anhand einer nichtlinearen Kurve angewendet, um im oberen Bereich des Wertebereichs eine sehr hohe Kontrasteinstellung zu ermöglichen.
| Kontrastanpassungskurve |
|---|
|
Der Wert reicht von -1,0 bis 1,0. Standardmäßig ist die Eigenschaft auf „ 0.0 “ (keine Änderung) gesetzt.
| Ausgabe-Beispiele mit unterschiedlichen Kontrastwerten | ||
|---|---|---|
|
|
|
| Kontrast: -0,5 | Kontrast: 0 | Kontrast: 0,5 |
| brightness: 0 | brightness: 0 | brightness: 0 |
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 von „source“ 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.








