SpriteSequence3D QML Type
Proporciona funciones 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 permite utilizar imágenes animadas con varios fotogramas. Los fotogramas deben estar alineados horizontalmente en la imagen, de modo que el primero quede a la izquierda y el último a la derecha.
Para convertir un « SpriteParticle3D » en una secuencia animada, configura su propiedad « spriteSequence ».
Documentación de la propiedad
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 llega al último fotograma, vuelve al primero. |
SpriteSequence3D.Reverse | Anima desde el último fotograma hasta el primero. Cuando se llega al primer fotograma, vuelve al último fotograma. |
SpriteSequence3D.Alternate | Animación desde el primer fotograma hasta el último. Al llegar al último o al primer fotograma, cambia la dirección de la animación. Esto hace que la animación de la secuencia sea fluida incluso cuando el primer y el último fotograma no coinciden. |
SpriteSequence3D.AlternateReverse | Animación desde el último fotograma hasta el primero. Al llegar al último o al primer fotograma, cambia la dirección de la animación. Esto hace que la animación de la secuencia sea fluida incluso cuando el primer y el último fotograma no coinciden. |
SpriteSequence3D.SingleFrame | No animar el fotograma. Cuando el valor de « randomStart » es «false», se renderiza un fotogr frameIndex. Cuando el valor de « randomStart » es «true», cada partícula renderiza un fotogr . |
animationDirection : AnimationDirection
Esta propiedad define la dirección de la 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 el valor de « frameCount » es 8, cada fotograma se mostrará durante 50 milisegundos. Cuando el valor es -1, se utiliza la vida útil 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 se sitúa entre duration - durationVariation y duration + durationVariation.
El valor por defecto es 0 (sin variación).
frameCount : int
Esta propiedad define el número 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 de 512x64, con frameCount de 8. De este modo, el tamaño de cada fotograma de la partícula sería de 64x64 píxeles.
El valor por defecto es 1.
Nota: Si tu imagen solo tiene un fotograma de sprite, no definas la propiedad spriteSequence en absoluto.
Véase también interpolate.
frameIndex : int
Esta propiedad define el índice inicial del fotograma. Se trata de la posición entre fotogramas en la que se inicia la animación. Por ejemplo, cuando el valor de « frameIndex » es 5 y el de « animationDirection » es Normal, el primer fotograma renderizado es el 5. Si el valor de « animationDirection » es Reverse, el primer fotograma renderizado es el 4.
El valor de `frameIndex` debe estar comprendido entre 0 y ` frameCount - 1`. Cuando ` animationDirection ` es ` SingleFrame ` y ` randomStart ` es ` false`, todas las partículas renderizarán sprites con ` frameIndex`.
El valor por defecto es 0.
Véase también randomStart y animationDirection.
interpolate : bool
Esta propiedad define si los sprites se interpolan (se fusionan) entre fotogramas para que la animación resulte más fluida.
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 comprendido entre 0 y frameCount - 1. Esto permite que las animaciones no den la impresión de haber comenzado todas al mismo tiempo cuando arranca la animación.
El valor por defecto es false.
Véase 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.