BrightnessContrast QML Type

Stellt Helligkeit und Kontrast ein. Mehr...

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

Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

brightness : real
cached : bool
contrast : real
source : variant

Detaillierte Beschreibung

Dieser Effekt passt die Farben des Quellobjekts an. Die Helligkeitsanpassung ändert die wahrgenommene Luminanz des Quellobjekts. Die Kontrasteinstellung erhöht oder verringert die Farb- und Helligkeitsabweichungen.

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, um wie viel 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 verschiedenen 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 wird erhöht, da ein zusätzlicher Puffer für die Speicherung der Effektausgabe 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, um wie viel der Kontrast der Quelle erhöht oder verringert wird. Die Verringerung des Kontrasts ist linear, aber die Erhöhung wird mit einer nicht-linearen Kurve angewendet, 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 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.