Animaciones de sprites
Motor de sprites
El Qt Quick motor de sprites es una máquina de estados estocástica combinada con la capacidad de dividir imágenes que contienen varios fotogramas de una animación.
Máquina de estados
Una de las funciones principales del motor de sprites es su máquina de estados interna. No es lo mismo que los estados y transiciones de Qt Quick, sino que se parece más a una máquina de estados convencional. Los sprites pueden tener transiciones ponderadas hacia otros sprites o de vuelta a sí mismos. Cuando finaliza la animación de un sprite, el motor de sprites elegirá el siguiente sprite al azar, basándose en las transiciones ponderadas disponibles para el sprite que acaba de terminar.
Puedes influir en el sprite que se está reproduciendo actualmente de dos maneras. Puedes forzar arbitrariamente que comience a reproducirse inmediatamente cualquier sprite, o puedes indicarle que realice una transición gradual hacia un sprite determinado. Si le indicas que realice una transición gradual, alcanzará el sprite de destino pasando por transiciones de estado válidas utilizando el menor número posible de sprites intermedios (pero ignorando las ponderaciones relativas). Esto te permite insertar fácilmente una animación de transición entre dos sprites diferentes.
![]()
A modo de ejemplo, fíjate en el diagrama anterior, que ilustra los sprites de un hipotético personaje de un juego de plataformas en 2D. El personaje comienza mostrando el estado de pie. Desde este estado, salvo que haya una entrada externa, pasará a la animación de espera, a la de caminar o volverá a reproducir la animación de pie. Dado que las ponderaciones de esas transiciones son uno, cero y tres, respectivamente, tiene una probabilidad de una entre cuatro de reproducir la animación de espera cuando finalice la animación de pie, y una probabilidad de tres entre cuatro de reproducir de nuevo la animación de pie. Esto permite que el personaje tenga un comportamiento ligeramente animado y variable mientras espera.
Dado que la transición a la animación de caminar tiene una ponderación de cero, la animación de estar de pie no suele pasar a ella. Sin embargo, si se establece la animación de destino como la de caminar, se reproducirá esta última al finalizar la animación de estar de pie. Si anteriormente se encontraba en la animación de espera, terminaría de reproducirla, luego pasaría a la animación de estar de pie y, a continuación, a la de caminar. A continuación, seguiría reproduciendo la animación de caminar hasta que se desactivara la animación de destino; en ese momento, pasaría a la animación de estar de pie tras terminar la animación de caminar.
Si a continuación configuras el estado de destino como la animación de salto, terminará la animación de caminar antes de reproducir la de salto. Dado que la animación de salto no realiza transiciones a otros estados, seguirá reproduciéndose hasta que se fuerce el cambio de estado. En este ejemplo, podrías volver a establecerlo en «caminar» y cambiar la animación de destino a «caminar» o a «ninguna» (lo que haría que se reprodujera la animación de «de pie» tras la de «caminar» ). Ten en cuenta que, al establecer la animación de forma forzada, puedes iniciar su reproducción de inmediato.
Formato de entrada
Los formatos de archivo aceptados por el motor de sprites son los mismos que los aceptados por otros tipos de QML, como Image. Sin embargo, para animar la imagen, el motor de sprites requiere que el archivo de imagen contenga todos los fotogramas de la animación. Deben estar dispuestos en una línea contigua, que puede continuar desde el borde derecho del archivo hasta una fila inferior que comience por el borde izquierdo del archivo (y que se sitúe directamente debajo de la fila anterior).
![]()
Tomemos como ejemplo la imagen anterior. Por ahora, fíjate solo en los números negros y supón que los cuadrados miden 40 × 40 píxeles. Normalmente, la imagen se lee desde la esquina superior izquierda. Si especificas un tamaño de fotograma de 40 × 40 píxeles y un número de fotogramas de 8, el motor leerá los fotogramas tal y como están numerados. El fotograma de la esquina superior izquierda sería el primero, el de la esquina superior derecha sería el quinto y, a continuación, pasaría a la siguiente fila (en la posición de píxeles 0,40 del archivo) para leer el sexto fotograma. Dejaría de leer tras el fotograma marcado con el número 8 y, si hubiera datos de imagen en el cuadrado situado debajo del fotograma cuatro, estos no se incluirían en la animación.
Es posible cargar animaciones desde un desplazamiento arbitrario, pero seguirán el mismo patrón. Consideremos ahora los números rojos. Si especificamos que la animación comience en la posición de píxel 120,0, con un número de fotogramas de 5 y el mismo tamaño de fotograma que antes, se cargarán los fotogramas tal y como están numerados en rojo. Los primeros 120×40 de la imagen no se utilizarán, ya que comienza a leer bloques de 40×40 a partir de la posición 120,0. Cuando llega al final del archivo en 160,0, empieza a leer la siguiente fila a partir de 0,40.
Los números azules indican los números de fotograma si se intentaran cargar dos fotogramas de ese tamaño, empezando por 40,40. Ten en cuenta que es posible cargar varios sprites desde un mismo archivo de imagen. Los números rojos, azules y negros pueden cargarse como animaciones independientes en el mismo motor de sprites. El siguiente código carga las animaciones tal y como se muestra en la imagen. También especifica que las animaciones deben reproducirse a 20 fotogramas por segundo.
Sprite {
name: "black"
source: "image.png"
frameCount: 8
frameWidth: 40
frameHeight: 40
frameRate: 20
}
Sprite {
name: "red"
source: "image.png"
frameX: 120
frameCount: 5
frameWidth: 40
frameHeight: 40
frameRate: 20
}
Sprite {
name: "blue"
source: "image.png"
frameX: 40
frameX: 40
frameCount: 2
frameWidth: 40
frameHeight: 40
frameRate: 20
}Los fotogramas de una misma animación deben tener el mismo tamaño. Sin embargo, esto no es necesario para varias animaciones dentro del mismo archivo. Los sprites sin un « frameCount » especificado se asumen como si ocuparan todo el archivo, por lo que debes especificar el tamaño del fotograma. Los sprites sin un tamaño de fotograma se asumen como cuadrados y ocupan todo el archivo sin repetición, por lo que debes especificar un número de fotogramas.
El motor de sprites copia y recorta internamente las imágenes para adaptarlas a un formato interno más fácil de leer, lo que conlleva algunas limitaciones de memoria gráfica. Dado que requiere que todos los sprites de un mismo motor se encuentren en la misma textura, intentar cargar muchas animaciones diferentes puede hacer que se alcancen los límites de memoria de texturas en dispositivos integrados. En estas situaciones, se mostrará una advertencia en la consola indicando el tamaño máximo de la textura.
Existen varias herramientas que ayudan a convertir un conjunto de imágenes en hojas de sprites. A continuación se muestran algunos ejemplos:
- Complemento de Photoshop: http://www.johnwordsworth.com/projects/photoshop-sprite-sheet-generator-script
- Complemento SpriteSheet de GIMP
- Herramienta de línea de comandos: http://www.imagemagick.org/script/montage.php
Tipos de QML que utilizan el motor de sprites
Los sprites para el motor de sprites se pueden definir utilizando el tipo « Sprite ». Este tipo incluye los parámetros de entrada, así como la duración de la animación y las transiciones ponderadas a otras animaciones. Se trata de una clase de datos pura, que no renderiza nada.
SpriteSequence Es un tipo que utiliza un motor de sprites para dibujar los sprites definidos en él. Se trata de un motor de sprites único y autónomo, que no interactúa con otros motores de sprites. Los tipos ` Sprite ` pueden compartirse entre tipos que utilicen el motor de sprites, pero esto no se realiza de forma automática. Por lo tanto, si has definido un sprite en un ` SpriteSequence `, tendrás que redefinirlo (o hacer referencia al mismo tipo ` Sprite `) en la propiedad `sprites` de otro ` SpriteSequence ` para poder realizar la transición a esa animación.
Además, ImageParticle puede utilizar tipos de Sprite para definir sprites para cada partícula. De nuevo, se trata de un único motor de sprites por tipo. Funciona de forma similar a SpriteSequence, pero también cuenta con la variabilidad parametrizada que proporciona el tipo ImageParticle.
Tipo AnimatedSprite
Para casos de uso en los que no sea necesario realizar transiciones entre animaciones, se recomienda utilizar el tipo AnimatedSprite. Este tipo muestra animaciones de sprites con el mismo formato de entrada, pero solo una a la vez. Además, ofrece un control manual más preciso, ya que no hay ningún motor de sprites que gestione la sincronización y las transiciones en segundo plano.
© 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.