Qt 5 Compatibility APIs: Graphical Effects

Das Modul Qt Graphical Effects wird aus Gründen der Kompatibilität mit Anwendungen bereitgestellt, die für Qt 5 geschrieben wurden.

Das Modul Qt Graphical Effects bietet eine Reihe von QML-Typen zum Hinzufügen visuell beeindruckender und konfigurierbarer Effekte zu Benutzeroberflächen. Effekte sind visuelle Elemente, die der Benutzeroberfläche Qt Quick als UI-Komponenten hinzugefügt werden können.

Die API besteht aus über 20 Effekten, die als separate QML-Typen bereitgestellt werden. Die Effekte decken Funktionsbereiche wie Maskierung, Unschärfe, Färbung und vieles mehr ab.

Erste Schritte

Um Qt Graphical Effects zu laden, fügen Sie die folgende Importanweisung zu Ihrer .qml-Datei hinzu:

import Qt5Compat.GraphicalEffects

Um die Effekte zu verwenden, fügen Sie einfach eine spezifische Effektdeklaration zur QML-Szene hinzu und konfigurieren die Effekteigenschaften. Effekte haben eine oder mehrere Quelleneigenschaften, um die visuelle Eingabe zu spezifizieren, auf die der Effekt angewendet wird. Die veränderte visuelle Ausgabe wird dann im Effektelement selbst dargestellt. Die Quelle kann ein anderes, oft verborgenes Element in der QML-Szene sein. Komplexere Effekte können mehrere Quellen haben. Das Quellelement kann ein beliebiger QML-Typ sein, sogar ein Video oder ein anderer Effekt. Das Pipelining mehrerer Effekte ist eine einfache Methode, um noch beeindruckendere Ergebnisse zu erzielen.

Jeder Effekt verfügt über eine Reihe von Eigenschaften, die zur Konfiguration der Effektausgabe verwendet werden können. Eigenschaften können wie alle anderen QML-Eigenschaften animiert werden. Die QML-Typdokumentation enthält Eigenschaftsbeschreibungen und grundlegende Anwendungsbeispiele.

Hinweis: Effekte sind nicht verfügbar, wenn sie mit dem software Backend von Qt Quick ausgeführt werden. Weitere Informationen zu Qt Quick Szenegraph-Backends finden Sie unter Szenegraph-Anpassungen.

Hinweis: Laufzeit-generierte Effekte wie GaussianBlur speichern die Shader-Dateien in einem temporären Speicher unter Verwendung von QTemporaryFile. Sie benötigen daher ein beschreibbares Dateisystem.

QML-Typen

Blend

Verschmelzen von zwei Quellelementen unter Verwendung eines Mischmodus

BrightnessContrast

Passt Helligkeit und Kontrast an

ColorOverlay

Ändert die Farben des Quellobjekts durch Anwendung einer Überlagerungsfarbe

Colorize

Setzt die Farbe im HSL-Farbraum

ConicalGradient

Zeichnet einen konischen Farbverlauf

Desaturate

Verringert die Sättigung der Farben

DirectionalBlur

Wendet den Weichzeichnungseffekt in der angegebenen Richtung an

Displace

Verschiebt die Pixel des Quellobjekts entsprechend der angegebenen Displacement Map

DropShadow

Erzeugt einen weichen Schatten hinter dem Ausgangselement

FastBlur

Wendet einen schnellen Unschärfeeffekt auf ein oder mehrere Quellelemente an

GammaAdjust

Ändert die Luminanz des Quellobjekts

GaussianBlur

Wendet einen höherwertigen Unschärfeeffekt an

Glow

Erzeugt ein unscharfes und eingefärbtes Bild der Quelle und platziert es hinter dem Original, so dass der Eindruck entsteht, die Quelle würde leuchten

HueSaturation

Ändert die Farben des Quellobjekts im HSL-Farbraum

InnerShadow

Erzeugt einen eingefärbten und unscharfen Schatten innerhalb der Quelle

LevelAdjust

Passt die Farbwerte im RGBA-Farbraum an

LinearGradient

Zeichnet einen linearen Farbverlauf

MaskedBlur

Wendet einen Unschärfeeffekt mit unterschiedlicher Intensität an

OpacityMask

Maskiert das Quellelement mit einem anderen Element

RadialBlur

Wendet einen gerichteten Weichzeichner in einer kreisförmigen Richtung um den Mittelpunkt des Objekts an

RadialGradient

Zeichnet einen radialen Farbverlauf

RectangularGlow

Erzeugt ein verschwommenes und eingefärbtes Rechteck, das den Eindruck erweckt, dass die Quelle leuchtet

RecursiveBlur

Wiederholte Unschärfe, um einen starken Unschärfeeffekt zu erzielen

ThresholdMask

Maskiert das Quellelement mit einem anderen Element und wendet einen Schwellenwert an

ZoomBlur

Wendet einen gerichteten Unschärfeeffekt in Richtung des Mittelpunkts des Quellobjekts an.

Referenz

© 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.