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.

Hinweis: Da das Qt Graphical Effects Modul Leistungseinschränkungen hat, wenn Effekte gestapelt werden, ist es hauptsächlich für die Kompatibilität mit Qt 5 Anwendungen enthalten. Wir empfehlen, dass neuer Code mit einer der neuen Lösungen für Effekte geschrieben wird, die in Qt 6 eingeführt wurden. Für typische UI-Effekte bietet Qt Quick die MultiEffect, die mehrere Effekte in einem Durchgang anwendet. Für fortgeschrittene Anwendungsfälle, die von dieser Komponente nicht abgedeckt werden, kann das Werkzeug Qt Quick Effect Maker verwendet werden, um genau die Shader-Effekte anzupassen und fein abzustimmen, die Sie benötigen.

Qt verwenden Graphical Effects

Um die Qt Graphical Effects Typen zu importieren, schließen Sie das Qt Graphical Effects Modul ein, indem Sie die folgende Anweisung in die QML Datei einfügen:

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. Der Typ des Quellelements kann ein beliebiger QML-Typ sein, auch ein Video oder ein anderer Effekt. Das Pipelining mehrerer Effekte ist eine einfache Methode, um noch beeindruckendere Ergebnisse zu erzielen.

Die folgende Liste zeigt die funktionale Aufteilung der Typen, die Teil von Qt Graphical Effects sind.

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, daher benötigen sie ein beschreibbares Dateisystem.

Überblenden

Blend

Fügt zwei Quellenelemente unter Verwendung eines Überblendungsmodus zusammen

Farbe

BrightnessContrast	Passt Helligkeit und Kontrast an
ColorOverlay	Ändert die Farben des Quellobjekts durch Anwendung einer Überlagerungsfarbe
Colorize	Legt die Farbe im HSL-Farbraum fest
Desaturate	Verringert die Sättigung der Farben
GammaAdjust	Ändert die Luminanz des Quellobjekts
HueSaturation	Ändert die Farben des Quellobjekts im HSL-Farbraum
LevelAdjust	Passt die Farbwerte im RGBA-Farbraum an

Farbverlauf

ConicalGradient	Zeichnet einen konischen Farbverlauf
LinearGradient	Zeichnet einen linearen Farbverlauf
RadialGradient	Zeichnet einen radialen Farbverlauf

Verzerrung

Displace

Verschiebt die Pixel des Quellobjekts entsprechend der angegebenen Verschiebungskarte

Schlagschatten

DropShadow	Erzeugt einen weichen Schatten hinter dem Quellobjekt
InnerShadow	Erzeugt einen eingefärbten und verschwommenen Schatten innerhalb der Quelle

Weichzeichnen

FastBlur	Wendet einen schnellen Unschärfeeffekt auf ein oder mehrere Quellobjekte an
GaussianBlur	Wendet einen Unschärfeeffekt höherer Qualität an
MaskedBlur	Wendet einen Unschärfeeffekt mit unterschiedlicher Intensität an
RecursiveBlur	Erzeugt einen starken Unschärfe-Effekt durch wiederholtes Weichzeichnen

Bewegungsunschärfe

DirectionalBlur	Wendet den Unschärfeeffekt auf die angegebene Richtung an
RadialBlur	Wendet einen gerichteten Unschärfeeffekt in einer kreisförmigen Richtung um den Mittelpunkt des Objekts an.
ZoomBlur	Wendet einen gerichteten Unschärfeeffekt in Richtung des Mittelpunkts des Objekts an.

Glühen

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
RectangularGlow	Erzeugt ein unscharfes und eingefärbtes Rechteck, das den Eindruck erweckt, dass die Quelle leuchtet.

Maske

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

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