Auf dieser Seite

Qt 5 Compatibility APIs: Graphical Effects

Graphical Effects Das Qt XML-ph-0000@deepl.internal-Modul wird zur Kompatibilität mit Anwendungen bereitgestellt, die für Qt 5 geschrieben wurden.

Das Qt- Graphical Effects -Modul bietet eine Reihe von QML-Typen, mit denen sich visuell beeindruckende und konfigurierbare Effekte zu Benutzeroberflächen hinzufügen lassen. Effekte sind visuelle Elemente, die als UI-Komponenten zu einer Benutzeroberfläche unter Qt Quick hinzugefügt werden können.

Graphical Effects Hinweis: Da das Qt XML-ph-0000@deepl.internal-Modul bei der Stapelung von Effekten Leistungseinschränkungen aufweist, ist es in erster Linie aus Gründen der Kompatibilität mit Qt-5-Anwendungen enthalten. Wir empfehlen, neuen Code mit einer der neuen Lösungen für Effekte zu schreiben, die in Qt 6 eingeführt wurden. Für typische UI-Effekte bietet „ Qt Quick “ das „ MultiEffect “, das mehrere Effekte in einem Durchgang anwendet. Für fortgeschrittene Anwendungsfälle, die von dieser Komponente nicht abgedeckt werden, kann das Qt Quick Effect Maker Tool verwendet werden, um genau die Shader-Effekte anzupassen und fein abzustimmen, die Sie benötigen.

Verwendung von Qt Graphical Effects

Um die Typen von Qt Graphical Effects zu importieren, binden Sie das Modul Qt Graphical Effects 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 in die QML-Szene ein und konfigurieren Sie die Effekteigenschaften. Effekte verfügen über eine oder mehrere „source“-Eigenschaften zur Festlegung der visuellen Eingabe, auf die der Effekt angewendet wird. Die veränderte visuelle Ausgabe wird dann im Effekt-Element selbst dargestellt. Der Typ des „source“-Elements kann ein beliebiger QML-Typ sein, sogar ein Video oder ein anderer Effekt. Das Verketten mehrerer Effekte ist eine einfache Möglichkeit, noch eindrucksvollere Ergebnisse zu erzielen.

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

Hinweis: Effekte sind nicht verfügbar, wenn mit dem „ software “-Backend von Qt Quick gearbeitet wird. Weitere Informationen zu den Szenengraph-Backends von Qt Quick finden Sie unter „Scene Graph Adaptations“.

Hinweis: Laufzeitspezifisch generierte Effekte wie „ GaussianBlur “ speichern die Shader-Dateien mithilfe von QTemporaryFile in einem temporären Speicher; daher benötigen sie ein beschreibbares Dateisystem.

Blend

Blend

Fügt zwei Quellelemente mithilfe eines Mischmodus zusammen

Farbe

BrightnessContrast

Passt Helligkeit und Kontrast an

ColorOverlay

Ändert die Farben des Quellelements durch Anwenden einer Überlagerungsfarbe

Colorize

Legt die Farbe im HSL-Farbraum fest

Desaturate

Verringert die Sättigung der Farben

GammaAdjust

Verändert die Luminanz des Quellobjekts

HueSaturation

Verä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 Quellelements gemäß der angegebenen Verschiebungskarte

Schlagschatten

DropShadow

Erzeugt einen weichen Schatten hinter dem Quellobjekt

InnerShadow

Erzeugt einen farbigen und unscharfen Schatten innerhalb des Quellelements

Weichzeichnen

FastBlur

Wendet einen schnellen Weichzeichnungseffekt auf ein oder mehrere Quellobjekte an

GaussianBlur

Wendet einen Unschärfeeffekt in höherer Qualität an

MaskedBlur

Wendet einen Unschärfeeffekt mit variierender Intensität an

RecursiveBlur

Wendet wiederholt Unschärfe an und sorgt so für einen starken Unschärfeeffekt

Bewegungsunschärfe

DirectionalBlur

Wendet einen Unschärfeeffekt in der angegebenen Richtung an

RadialBlur

Wendet eine gerichtete Unschärfe in kreisförmiger Richtung um den Mittelpunkt des Elements an

ZoomBlur

Wendet einen gerichteten Unschärfeeffekt in Richtung des Mittelpunkts des Quellelements an

Leuchten

Glow

Erzeugt ein unscharfes und koloriertes Bild der Quelle und platziert es hinter dem Original, wodurch der Eindruck entsteht, dass die Quelle leuchtet

RectangularGlow

Erzeugt ein unscharfes und koloriertes Rechteck, das den Eindruck vermittelt, dass das Quellobjekt leuchtet

Maske

OpacityMask

Maskiert das Quellobjekt mit einem anderen Objekt

ThresholdMask

Maskiert das Quellobjekt mit einem anderen Objekt und wendet einen Schwellenwert an

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