Qt Lottie Animation
Qt Lottie Animation werden QML-APIs zum Rendern von Grafiken und Animationen in Dateien im Lottie-Format bereitgestellt. Diese werden in der Regel über die Lottie- Plugins für Adobe After Effects exportiert.
Das Element „ LottieAnimation “ rendert Animationen mithilfe des QPainter-Software-Renderers in einen Zwischenpuffer. Dies kann zu gewissen Leistungseinschränkungen hinsichtlich der Größe der Grafiken sowie der Zielhardware führen. Alternativ ist ein Tool namens „lottietoqml“ enthalten. Dieses Tool konvertiert Lottie-Animationen in QML. Dadurch können sie mit dem hardwarebeschleunigten Renderer in „ Qt Quick “ gerendert werden.
Sind die Lottie-Dateien bereits zur Kompilierungszeit bekannt, können Sie diese ebenfalls mit dem Tool „lottietoqml“ oder dem CMake-Befehl „qt_target_qml_from_lottie“, der das Tool umschließt, in QML konvertieren.
Schließlich kann das Element „ VectorImage “ unter Qt Quick Dateien im Lottie-Format direkt laden. Es konvertiert sie zur Laufzeit mithilfe der „lottietoqml “-Funktionalität in einem Plugin in QML.
Erste Schritte
Importieren Sie die Typen mit der folgenden Anweisung:
import Qt.labs.lottieqtEinschränkungen
Die Implementierung folgt der Master-Spezifikation für Lottie. Abweichungen in exportierten Lottie-Dateien gegenüber der Spezifikation werden so weit wie möglich berücksichtigt, sobald 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 zu übergeben.
Einschränkungen auf Animationsebene
Die folgenden Eigenschaften werden nicht unterstützt:
assets- Wiederverwendbarer Text und BildercharsText
Ebenen
Die folgenden Eigenschaften werden nicht unterstützt:
bm(Mischmodus)
Formen
Einige seltener verwendete Elemente und Formen werden nicht unterstützt, darunter:
- Verschachtelte Wiederholungsformen
Beachten Sie außerdem, dass das Verhalten bei der Verwendung mehrerer aktiver Beschneidungspfade (z. B. Beschneidungspfade in verschachtelten Gruppen) unvorhersehbar ist.
Effekte
Die einzigen unterstützten Effekte sind „ Slide “ und „ Layer Fill “.
Beispiele
- Das Beispiel „qtlottieviewer“ veranschaulicht, wie das Element „ LottieAnimation “ verwendet wird, um eine Lottie-Datei in einer „ Qt Quick “-Anwendung zu laden, anzuzeigen und zu steuern.
- Das Beispiel „lottietoqml“ veranschaulicht, wie das Tool „lottietoqml“ 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. Weitere Details finden Sie unter Qt-Lizenzierung.
Referenz
Weiterführende 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.
