SpriteSequence3D QML Type
Fournit des caractéristiques de séquence d'images pour les particules Sprite. Plus d'informations...
| Import Statement: | import QtQuick3D.Particles3D |
| Since: | Qt 6.2 |
| Inherits: |
Propriétés
- AnimationDirection : enumeration
- animationDirection : AnimationDirection
- duration : int
- durationVariation : int
- frameCount : int
- frameIndex : int
- interpolate : bool
- randomStart : bool
Description détaillée
L'élément SpriteSequence3D permet de prendre en charge les images animées comportant plusieurs cadres. Les images doivent être alignées horizontalement dans l'image, la première image étant à gauche et la dernière à droite.
Pour faire d'un site SpriteParticle3D une séquence animée, définissez sa propriété spriteSequence.
Documentation sur les propriétés
AnimationDirection : enumeration
Définit le sens de lecture de l'animation de la séquence.
| Constante | Description |
|---|---|
SpriteSequence3D.Normal | Animer de la première à la dernière image. Lorsque la dernière image est atteinte, l'animation revient à la première image. |
SpriteSequence3D.Reverse | Animer de la dernière image à la première image. Lorsque la première image est atteinte, retour à la dernière image. |
SpriteSequence3D.Alternate | Animation de la première à la dernière image. Lorsque la dernière ou la première image est atteinte, la direction de l'animation est modifiée. Cela rend l'animation de la séquence fluide, même lorsque la première et la dernière image ne correspondent pas. |
SpriteSequence3D.AlternateReverse | Animer de la dernière image à la première image. Lorsque la dernière ou la première image est atteinte, inverser le sens de l'animation. Cela rend l'animation de la séquence fluide même si la première et la dernière image ne correspondent pas. |
SpriteSequence3D.SingleFrame | Ne pas animer l'image. Lorsque randomStart est faux, l'image frameIndex est rendue. Lorsque randomStart est vrai, chaque particule rend une image aléatoire. |
animationDirection : AnimationDirection
Cette propriété définit la direction de l'animation de la séquence.
La valeur par défaut est SpriteSequence3D.Normal.
Voir aussi randomStart.
duration : int
Cette propriété définit la durée en millisecondes de l'animation de la séquence de sprites. Par exemple, si la durée est 400 et que frameCount est 8, chaque image sera affichée pendant 50 millisecondes. Lorsque la valeur est -1, la durée de vie des particules est utilisée comme durée.
La valeur par défaut est -1.
durationVariation : int
Cette propriété définit la variation de la durée en millisecondes. La durée réelle de l'animation est comprise entre duration - durationVariation et duration + durationVariation.
La valeur par défaut est 0 (pas de variation).
frameCount : int
Cette propriété définit le nombre d'images dans sprite. La particule s'anime à travers ces cadres au cours de son duration. Les images doivent être disposées horizontalement dans le même fichier image. Par exemple, le sprite peut être une image 512x64, avec frameCount de 8, ce qui fait que chaque image de particule a une taille de 64x64 pixels.
La valeur par défaut est 1.
Remarque : si votre image ne comporte qu'un seul cadre de sprite, ne définissez pas du tout la propriété spriteSequence.
Voir également interpolate.
frameIndex : int
Cette propriété définit l'index initial de l'image. Il s'agit de la position entre les images où l'animation commence. Par exemple, lorsque frameIndex est 5 et que animationDirection est Normal, la première image rendue est 5. Si animationDirection est Reverse, la première image rendue est 4.
La valeur de frameIndex doit être comprise entre 0 et frameCount - 1. Lorsque animationDirection est SingleFrame et randomStart est false, toutes les particules rendront des sprites avec frameIndex.
La valeur par défaut est 0.
Voir également randomStart et animationDirection.
interpolate : bool
Cette propriété définit si les sprites sont interpolés (mélangés) entre les images pour rendre l'animation plus fluide.
La valeur par défaut est true.
Voir également frameCount.
randomStart : bool
Cette propriété définit si l'animation doit commencer à partir d'une image aléatoire entre 0 et frameCount - 1. Cela permet aux animations de ne pas donner l'impression qu'elles viennent toutes de commencer au début de l'animation.
La valeur par défaut est false.
Voir aussi 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.
