SpriteSequence3D QML Type
Fournit des fonctionnalités de séquence d'images pour les particules Sprite. En savoir plus...
| 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 prend en charge les images animées comportant plusieurs images. Les images doivent être alignées horizontalement dans l'image, la première image se trouvant à gauche et la dernière à droite.
Pour transformer une séquence « SpriteParticle3D » en 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 | Animation de la première image à la dernière image. Lorsque la dernière image est atteinte, retour à la première image. |
SpriteSequence3D.Reverse | Animation 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 image à la dernière image. Lorsque la dernière ou la première image est atteinte, inversion du sens d’animation. Cela permet d’obtenir une animation fluide de la séquence, 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 lorsque la première et la dernière image ne correspondent pas. |
SpriteSequence3D.SingleFrame | Ne pas animer l’image. Lorsque l’ randomStart est à « false », l’ frameIndex e image est rendue. Lorsque l’ randomStart est à « true », chaque particule rend une image aléatoire. |
animationDirection : AnimationDirection
Cette propriété définit le sens d'animation de la séquence.
La valeur par défaut est « SpriteSequence3D.Normal ».
Voir également « randomStart ».
duration : int
Cette propriété définit, en millisecondes, la durée nécessaire à l'animation de la séquence de sprites. Par exemple, si la durée est de 400 et que la valeur de « frameCount » est 8, chaque image s'affichera pendant 50 millisecondes. Lorsque la valeur est -1, la durée de vie (« lifeSpan ») de la particule est utilisée comme durée.
La valeur par défaut est -1.
durationVariation : int
Cette propriété définit la variation de durée en millisecondes. La durée réelle de l'animation se situe entre duration - durationVariation et duration + durationVariation.
La valeur par défaut est 0 (aucune variation).
frameCount : int
Cette propriété définit le nombre d'images composant la séquence d'animation ( sprite). La particule passe par ces images au cours de son animation ( duration). Les images doivent être disposées horizontalement dans le même fichier image. Par exemple, un sprite pourrait être une image de 512x64, avec une résolution ( frameCount ) de 8. La taille de chaque image de la particule serait alors de 64x64 pixels.
La valeur par défaut est 1.
Remarque : si votre image ne comporte qu’une seule image 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 deux images, à partir de laquelle l'animation démarre. Par exemple, lorsque la valeur de « frameIndex » est 5 et celle de « animationDirection » est Normal, la première image affichée est la 5e. Si la valeur de « animationDirection » est Reverse, la première image affichée est la 4e.
La valeur de `frameIndex` doit être comprise entre 0 et ` frameCount - 1`. Lorsque ` animationDirection ` est ` SingleFrame ` et que ` randomStart ` est ` false`, toutes les particules afficheront des sprites avec ` frameIndex`.
La valeur par défaut est 0.
Voir également randomStart et animationDirection.
interpolate : bool
Cette propriété détermine si les sprites sont interpolés (fondus) d'une image à l'autre afin de rendre l'animation plus fluide.
La valeur par défaut est « true ».
Voir également « frameCount ».
randomStart : bool
Cette propriété permet de définir si l'animation doit démarrer à partir d'une image aléatoire comprise entre 0 et frameCount - 1. Cela évite que les animations donnent l'impression d'avoir toutes commencé en même temps dès le début de la séquence.
La valeur par défaut est false.
Voir également 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.
