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
Detaillierte Beschreibung
Hinweis: Die Komponente MultiEffect bietet einen Helligkeits- und Kontrasteffekt mit einigen Leistungsvorteilen. Für neuen Code sollte sie als Alternative zur Verwendung von Qt Graphical Effects in Betracht gezogen werden.
Mit diesem Effekt werden die Farben des Quellobjekts angepasst. Die Helligkeitsanpassung verändert die wahrgenommene Luminanz des Quellobjekts. Die Kontrasteinstellung erhöht oder verringert die Farb- und Helligkeitsvariationen.
| 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: 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 } }
Eigenschaft Dokumentation
brightness : real
Diese Eigenschaft legt fest, wie stark die Helligkeit der Quelle erhöht oder verringert wird.
Der Wert reicht von -1,0 bis 1,0. Standardmäßig ist die Eigenschaft auf 0.0 (keine Änderung) eingestellt.
| 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 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.
contrast : real
Diese Eigenschaft legt fest, wie stark der Quellenkontrast erhöht oder verringert wird. Die Verringerung des Kontrasts ist linear, aber die Erhöhung wird mit einer nicht-linearen Kurve angewandt, um eine sehr hohe Kontrasteinstellung am oberen Ende des Wertebereichs zu ermöglichen.
| Kurve der Kontrasteinstellung |
|---|
|
Der Wert reicht von -1,0 bis 1,0. Standardmäßig ist die Eigenschaft auf 0.0 (keine Änderung) eingestellt.
| Ausgabebeispiele mit verschiedenen 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 einschließt, z. B. indem die Quelle auf das übergeordnete Element des Effekts gesetzt wird.
© 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.








