SpriteSequence3D QML Type
Stellt Bildsequenzfunktionen für die Sprite-Partikel bereit. Mehr...
| Import Statement: | import QtQuick3D.Particles3D |
| Since: | Qt 6.2 |
| Inherits: |
Eigenschaften
- AnimationDirection : enumeration
- animationDirection : AnimationDirection
- duration : int
- durationVariation : int
- frameCount : int
- frameIndex : int
- interpolate : bool
- randomStart : bool
Ausführliche Beschreibung
Das SpriteSequence3D-Element bietet Unterstützung für animierte Bilder mit mehreren Einzelbildern. Die Einzelbilder sollten im Bild horizontal ausgerichtet sein, wobei das erste Einzelbild links und das letzte rechts liegt.
Um aus einem „ SpriteParticle3D “ eine animierte Sequenz zu erstellen, legen Sie dessen Eigenschaft „ spriteSequence “ fest.
Dokumentation zur Eigenschaft
AnimationDirection : enumeration
Legt die Wiedergaberichtung der Animation für die Sequenz fest.
| Konstante | Beschreibung |
|---|---|
SpriteSequence3D.Normal | Animation vom ersten Bild zum letzten Bild. Sobald das letzte Bild erreicht ist, wird zum ersten Bild zurückgesprungen. |
SpriteSequence3D.Reverse | Animation vom letzten Bild zum ersten Bild. Wenn das erste Bild erreicht ist, springe zurück zum letzten Bild. |
SpriteSequence3D.Alternate | Animiert vom ersten bis zum letzten Frame. Wenn der letzte oder erste Frame erreicht ist, wird die Animationsrichtung gewechselt. Dadurch wird die Sequenzanimation flüssig, auch wenn der erste und der letzte Frame nicht übereinstimmen. |
SpriteSequence3D.AlternateReverse | Animieren Sie vom letzten zum ersten Bild. Wenn das letzte oder erste Bild erreicht ist, wechseln Sie die Animationsrichtung. Dadurch wird die Sequenzanimation flüssig, auch wenn das erste und das letzte Bild nicht übereinstimmen. |
SpriteSequence3D.SingleFrame | Das Bild nicht animieren. Wenn „ randomStart “ auf „false“ gesetzt ist, wird das Bild „ frameIndex “ gerendert. Wenn „ randomStart “ auf „true“ gesetzt ist, rendert jedes Partikel ein zufälliges Bild. |
animationDirection : AnimationDirection
Diese Eigenschaft legt die Animationsrichtung der Sequenz fest.
Der Standardwert ist „ SpriteSequence3D.Normal “.
Siehe auch „ randomStart “.
duration : int
Diese Eigenschaft legt die Dauer in Millisekunden fest, die die Animation der Sprite-Sequenz benötigt. Beträgt die Dauer beispielsweise 400 und der Wert für „ frameCount “ 8, wird jedes Einzelbild 50 Millisekunden lang angezeigt. Ist der Wert -1, wird die Lebensdauer des Partikels als Dauer verwendet.
Der Standardwert ist „ -1 “.
durationVariation : int
Diese Eigenschaft definiert die Variation der Dauer in Millisekunden. Die tatsächliche Dauer der Animation liegt zwischen duration – durationVariation und duration + durationVariation.
Der Standardwert ist 0 (keine Variation).
frameCount : int
Diese Eigenschaft legt die Anzahl der Bildframes in „ sprite “ fest. Das Partikel durchläuft diese Frames während seiner „ duration “. Die Frames sollten horizontal in derselben Bilddatei angeordnet sein. Ein Sprite könnte beispielsweise ein Bild mit der Größe „ 512x64 “ sein, mit einer „ frameCount “ von „ 8 “. Damit hätte jedes Partikel-Frame eine Größe von „ 64x64 “ Pixeln.
Der Standardwert ist 1.
Hinweis: Wenn Ihr Bild nur einen einzigen Sprite-Frame enthält, definieren Sie die Eigenschaft „ spriteSequence “ gar nicht.
Siehe auch „ interpolate “.
frameIndex : int
Diese Eigenschaft definiert den Startindex des Frames. Dies ist die Position zwischen den Frames, an der die Animation gestartet wird. Wenn beispielsweise der Wert von „ frameIndex “ 5 lautet und der Wert von „ animationDirection “ Normal ist, ist der erste gerenderte Frame 5. Wenn der Wert von „ animationDirection “ Reverse ist, ist der erste gerenderte Frame 4.
Der Wert von `frameIndex` muss zwischen 0 und ` frameCount - 1` liegen. Wenn ` animationDirection ` gleich ` SingleFrame ` und ` randomStart ` gleich ` false` ist, rendern alle Partikel Sprites mit dem ` frameIndex`.
Der Standardwert ist 0.
Siehe auch randomStart und animationDirection.
interpolate : bool
Diese Eigenschaft legt fest, ob die Sprites zwischen den Einzelbildern interpoliert (überblendet) werden, damit die Animation flüssiger wirkt.
Der Standardwert ist „ true “.
Siehe auch „ frameCount “.
randomStart : bool
Diese Eigenschaft legt fest, ob die Animation mit einem zufälligen Bild zwischen 0 und frameCount - 1 beginnen soll. Dadurch wird verhindert, dass es so aussieht, als hätten alle Animationen genau zum Startzeitpunkt gleichzeitig begonnen.
Der Standardwert ist false.
Siehe auch animationDirection.
© 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.