Qt Lottie Animation
Qt Lottie Animation bietet QML-APIs zum Rendern von Grafiken und Animationen in Dateien im Lottie-Format. Diese werden normalerweise von den Lottie-Plugins für Adobe After Effects exportiert.
Das Element LottieAnimation rendert Animationen in einen Zwischenpuffer unter Verwendung des QPainter-Software-Renderers. Dies kann zu Leistungseinschränkungen in Bezug auf die Größe der Illustrationen sowie auf die Zielhardware führen. Als Alternative ist ein Werkzeug namens lottietoqml enthalten. Dieses Tool konvertiert Lottie-Animationen in QML. Dadurch können sie mit dem hardwarebeschleunigten Renderer in Qt Quick gerendert werden.
Wenn die Lottie-Dateien zum Zeitpunkt des Kompilierens bekannt sind, können Sie sie auch mit dem Werkzeug lottietoqml oder dem CMake-Befehl qt_target_qml_from_lottie, der das Werkzeug umhüllt, in QML konvertieren.
Schließlich kann das Element VectorImage Qt Quick Dateien im Lottie-Format direkt laden. Er konvertiert sie zur Laufzeit mit Hilfe der lottietoqml-Funktionalität in einem Plugin in QML.
Erste Schritte
Importieren Sie die Typen mit der folgenden Anweisung:
import Qt.labs.lottieqt
Beschränkungen
Die Implementierung folgt der Masterspezifikation für Lottie. Abweichungen in exportierten Lottie-Dateien im Vergleich zur Spezifikation werden so weit wie möglich berücksichtigt, wenn Unterschiede festgestellt werden.
Allgemeine Einschränkungen
- Ausdrücke werden nicht unterstützt
- die Zeitleiste unterstützt nur den Frame-Modus, nicht den Zeit-Modus
Warnung: Bei den Eingabedateien für Qt Lottie Animation wird davon ausgegangen, dass es sich um vertrauenswürdige Inhalte handelt. Anwendungsentwicklern wird empfohlen, niemals Daten aus nicht vertrauenswürdigen Quellen einzugeben.
Einschränkungen der Animationsebene
Die folgenden Eigenschaften werden nicht unterstützt:
assets- wiederverwendbarer Text und BildercharsText
Ebenen
Die folgenden Eigenschaften werden nicht unterstützt:
ao(Autoausrichtung)bm(Mischmodus)maskProperties(Masken)sr(Zeitdehnung)
Formen
Einige seltener verwendete Elemente und Formen werden nicht unterstützt, darunter:
- das Element
gstroke(Verlaufsstrich) - Verschachtelte Wiederholerformen
Beachten Sie auch, dass das Verhalten bei der Verwendung mehrerer aktiver Trimmpfade (z. B. Trimmpfade in verschachtelten Gruppen) nicht vorhersehbar ist.
Effekte
Die einzigen unterstützten Effekte sind Slide und Layer Fill.
Beispiele
- Das qtlottieviewer-Beispiel demonstriert die Verwendung des Elements LottieAnimation zum Laden, Anzeigen und Steuern einer Lottie-Datei in einer Qt Quick -Anwendung.
- Das lottietoqml-Beispiel demonstriert, wie das lottietoqml-Tool verwendet werden kann, um Lottie-Dateien in Qt Quick -Szenen zu konvertieren und diese in eine Anwendung zu laden.
Lizenzen
Qt Lottie Animation ist unter kommerziellen Lizenzen von The Qt Company erhältlich. Darüber hinaus ist es unter der GNU General Public License, Version 3, verfügbar. Siehe Qt Licensing für weitere Details.
Referenz
Verwandte Informationen
© 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.
