SpriteSequence3D QML Type
Proporciona características de secuencia de imágenes para las partículas Sprite. Más...
| Import Statement: | import QtQuick3D.Particles3D |
| Since: | Qt 6.2 |
| Inherits: |
Propiedades
- AnimationDirection : enumeration
- animationDirection : AnimationDirection
- duration : int
- durationVariation : int
- frameCount : int
- frameIndex : int
- interpolate : bool
- randomStart : bool
Descripción detallada
El elemento SpriteSequence3D proporciona soporte para imágenes animadas con múltiples fotogramas. Los fotogramas deben estar alineados horizontalmente en la imagen, estando el primero a la izquierda y el último a la derecha.
Para hacer de SpriteParticle3D una secuencia animada, establezca su propiedad spriteSequence.
Documentación de propiedades
AnimationDirection : enumeration
Define la dirección de reproducción de la animación de la secuencia.
| Constante | Descripción |
|---|---|
SpriteSequence3D.Normal | Anima desde el primer fotograma hasta el último. Cuando se alcanza el último fotograma, salta al primer fotograma. |
SpriteSequence3D.Reverse | Animar desde el último fotograma hasta el primer fotograma. Cuando se alcanza el primer fotograma, salta al último fotograma. |
SpriteSequence3D.Alternate | Animar desde el primer fotograma hasta el último. Cuando se alcanza el último o el primer fotograma, cambia la dirección de la animación. Esto hace que la animación de la secuencia sea suave incluso cuando el primer y el último fotograma no coinciden. |
SpriteSequence3D.AlternateReverse | Animar desde el último fotograma hasta el primero. Cuando se alcanza el último o el primer fotograma, cambia la dirección de la animación. Esto hace que la animación de la secuencia sea suave incluso cuando el primer y el último fotograma no coinciden. |
SpriteSequence3D.SingleFrame | No animes el fotograma. Cuando randomStart es falso, se renderiza el fotograma frameIndex. Cuando randomStart es verdadero, cada partícula renderiza un fotograma aleatorio. |
animationDirection : AnimationDirection
Esta propiedad define la dirección de animación de la secuencia.
El valor por defecto es SpriteSequence3D.Normal.
Véase también randomStart.
duration : int
Esta propiedad define la duración en milisegundos que tarda en animarse la secuencia de sprites. Por ejemplo, si la duración es 400 y frameCount es 8, cada fotograma se mostrará durante 50 milisegundos. Cuando el valor es -1, se utiliza el lifeSpan de la partícula como duración.
El valor por defecto es -1.
durationVariation : int
Esta propiedad define la variación de la duración en milisegundos. La duración real de la animación está comprendida entre duration - durationVariation y duration + durationVariation.
El valor por defecto es 0 (sin variación).
frameCount : int
Esta propiedad define la cantidad de fotogramas de la imagen en sprite. La partícula se anima a través de estos fotogramas durante su duration. Los fotogramas deben estar dispuestos horizontalmente en el mismo archivo de imagen. Por ejemplo, el sprite podría ser una imagen 512x64, con frameCount de 8. Esto haría que cada fotograma de partícula tuviera un tamaño de 64x64 píxeles.
El valor por defecto es 1.
Nota: Si su imagen sólo tiene un único fotograma de sprite, no defina la propiedad spriteSequence en absoluto.
Véase también interpolate.
frameIndex : int
Esta propiedad define el índice inicial del fotograma. Es la posición entre fotogramas en la que se inicia la animación. Por ejemplo cuando el frameIndex es 5 y el animationDirection es Normal, el primer fotograma renderizado es el 5. Si el animationDirection es Reverse, el primer fotograma renderizado es el 4.
El valor de frameIndex debe estar entre 0 y frameCount - 1. Si animationDirection es SingleFrame y randomStart es false, todas las partículas renderizarán sprites con el valor frameIndex.
El valor por defecto es 0.
Véase también randomStart y animationDirection.
interpolate : bool
Esta propiedad define si los sprites se interpolan (mezclan) entre fotogramas para que la animación parezca más suave.
El valor por defecto es true.
Véase también frameCount.
randomStart : bool
Esta propiedad define si la animación debe comenzar desde un fotograma aleatorio entre 0 y frameCount - 1. Esto permite que las animaciones no parezcan que acaban de empezar cuando comienza la animación.
El valor por defecto es false.
Ver también 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.
