Auf dieser Seite

BrightnessContrast QML Type

Stellt Helligkeit und Kontrast ein. Mehr...

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

Item

Eigenschaften

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.

QuelleAngewandter Effekt

Schwarzer Käfer auf einem Blatt

Käfer mit angepasster Helligkeit und angepasstem Kontrast

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

Dunkler Käfer, Helligkeit -0,25

Käfer bei normaler Helligkeit

Aufgehellter Käfer, Helligkeit 0,5

Helligkeit: -0,25 Helligkeit: 0 Helligkeit: 0,5
contrast: 0contrast: 0contrast: 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

Grafik zur Darstellung der 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

Käfer mit vermindertem Kontrast

Käfer bei normalem Kontrast

Käfer mit erhöhtem Kontrast

Kontrast: -0,5 Kontrast: 0 Kontrast: 0,5
brightness: 0brightness: 0brightness: 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.