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
Verschmelzen von zwei Quellelementen unter Verwendung eines Mischmodus | |
Passt Helligkeit und Kontrast an | |
Ändert die Farben des Quellobjekts durch Anwendung einer Überlagerungsfarbe | |
Setzt die Farbe im HSL-Farbraum | |
Zeichnet einen konischen Farbverlauf | |
Verringert die Sättigung der Farben | |
Wendet den Weichzeichnungseffekt in der angegebenen Richtung an | |
Verschiebt die Pixel des Quellobjekts entsprechend der angegebenen Displacement Map | |
Erzeugt einen weichen Schatten hinter dem Ausgangselement | |
Wendet einen schnellen Unschärfeeffekt auf ein oder mehrere Quellelemente an | |
Ändert die Luminanz des Quellobjekts | |
Wendet einen höherwertigen Unschärfeeffekt an | |
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 | |
Ändert die Farben des Quellobjekts im HSL-Farbraum | |
Erzeugt einen eingefärbten und unscharfen Schatten innerhalb der Quelle | |
Passt die Farbwerte im RGBA-Farbraum an | |
Zeichnet einen linearen Farbverlauf | |
Wendet einen Unschärfeeffekt mit unterschiedlicher Intensität an | |
Maskiert das Quellelement mit einem anderen Element | |
Wendet einen gerichteten Weichzeichner in einer kreisförmigen Richtung um den Mittelpunkt des Objekts an | |
Zeichnet einen radialen Farbverlauf | |
Erzeugt ein verschwommenes und eingefärbtes Rechteck, das den Eindruck erweckt, dass die Quelle leuchtet | |
Wiederholte Unschärfe, um einen starken Unschärfeeffekt zu erzielen | |
Maskiert das Quellelement mit einem anderen Element und wendet einen Schwellenwert an | |
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.