SpriteSequence3D QML Type
Stellt Bildsequenzmerkmale 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
Detaillierte Beschreibung
Das SpriteSequence3D-Element bietet Unterstützung für animierte Bilder mit mehreren Frames. Die Bilder sollten horizontal im Bild ausgerichtet sein, wobei das erste Bild links und das letzte rechts liegt.
Um eine SpriteParticle3D in eine animierte Sequenz zu verwandeln, setzen Sie die Eigenschaft spriteSequence.
Eigenschaft Dokumentation
AnimationDirection : enumeration |
Legt die Wiedergaberichtung der Animation in der Sequenz fest.
| Konstante | Beschreibung |
|---|---|
SpriteSequence3D.Normal | Animiert vom ersten Bild zum letzten Bild. Wenn das letzte Bild erreicht ist, wird zum ersten Bild zurückgesprungen. |
SpriteSequence3D.Reverse | Vom letzten Bild zum ersten Bild animieren. Wenn das erste Bild erreicht ist, wird zum letzten Bild zurückgesprungen. |
SpriteSequence3D.Alternate | Animieren Sie vom ersten Bild zum letzten Bild. Wenn das letzte oder erste Bild erreicht ist, wechseln Sie die Animationsrichtung. Dadurch wird die Sequenzanimation auch dann flüssig, wenn das erste und das letzte Bild nicht übereinstimmen. |
SpriteSequence3D.AlternateReverse | Animieren Sie vom letzten Bild zum ersten Bild. Wenn das letzte oder erste Bild erreicht ist, wechseln Sie die Animationsrichtung. Dadurch wird die Sequenzanimation auch dann flüssig, wenn das erste und das letzte Bild nicht übereinstimmen. |
SpriteSequence3D.SingleFrame | Animieren Sie das Bild nicht. Wenn randomStart falsch ist, wird das Bild frameIndex gerendert. Wenn randomStart wahr ist, wird für jedes Partikel ein zufälliges Bild gerendert. |
animationDirection : AnimationDirection |
Diese Eigenschaft definiert die Animationsrichtung der Sequenz.
Der Standardwert ist SpriteSequence3D.Normal.
Siehe auch randomStart.
duration : int |
Diese Eigenschaft legt die Dauer in Millisekunden fest, wie lange die Sprite-Sequenz für die Animation benötigt. Wenn die Dauer zum Beispiel 400 und frameCount 8 ist, wird jedes Bild 50 Millisekunden lang angezeigt. Wenn der Wert -1 ist, wird die Lebensdauer der Partikel als Dauer verwendet.
Der Standardwert ist -1.
durationVariation : int |
Diese Eigenschaft definiert die Dauer der Animation in Millisekunden. Die tatsächliche Dauer der Animation liegt zwischen duration - durationVariation und duration + durationVariation.
Der Standardwert ist 0 (keine Variation).
frameCount : int |
Mit dieser Eigenschaft wird die Anzahl der Einzelbilder in sprite festgelegt. Der Partikel animiert während seiner duration durch diese Bilder. Die Frames sollten horizontal in der gleichen Bilddatei angeordnet sein. Zum Beispiel könnte das Sprite ein 512x64 Bild sein, mit frameCount von 8. Dies würde jedes Partikelbild zu einer Größe von 64x64 Pixeln machen.
Der Standardwert ist 1.
Hinweis: Wenn Ihr Bild nur einen einzigen Sprite-Frame hat, definieren Sie die Eigenschaft spriteSequence gar nicht.
Siehe auch interpolate.
frameIndex : int |
Diese Eigenschaft definiert den Anfangsindex des Rahmens. Dies ist die Position zwischen den Frames, an der die Animation gestartet wird. Wenn z. B. frameIndex gleich 5 und animationDirection gleich Normal ist, ist das erste gerenderte Bild 5. Wenn animationDirection gleich Reverse ist, ist das erste gerenderte Bild 4.
Der Wert von frameIndex muss zwischen 0 und frameCount - 1 liegen. Wenn animationDirection für SingleFrame und randomStart für false steht, werden alle Partikel mit frameIndex gerendert.
Der Standardwert ist 0.
Siehe auch randomStart und animationDirection.
interpolate : bool |
Diese Eigenschaft legt fest, ob die Sprites zwischen den Frames interpoliert (überblendet) werden, um die Animation glatter erscheinen zu lassen.
Der Standardwert ist true.
Siehe auch frameCount.
randomStart : bool |
Diese Eigenschaft legt fest, ob die Animation mit einem zufälligen Frame zwischen 0 und frameCount - 1 beginnen soll. Dadurch sehen Animationen nicht so aus, als hätten sie gerade erst begonnen, wenn die Animation beginnt.
Der Standardwert ist false.
Siehe auch animationDirection.
© 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.
