En esta página

Sprite QML Type

Especifica las animaciones de los sprites. Más...

Import Statement: import QtQuick

Propiedades

Descripción detallada

Un sprite define una serie de uno o más fotogramas que deben ser animados y renderizados por SpriteSequence. Los sprites pueden encontrarse en el centro de un archivo de imagen o distribuidos en varias filas, siempre y cuando formen una línea contigua que continúe en la siguiente fila del archivo desde el borde izquierdo del mismo.

Para obtener más información, consulta la descripción general de Animaciones de sprites.

Documentación de propiedades

duration : int

Duración de la animación. Los valores inferiores a 0 no son válidos.

Si frameRate es válido, se utilizará para calcular la duración de los fotogramas. Si no lo es, y frameDuration es válido, se utilizará frameDuration. En caso contrario, se utilizará la duración.

durationVariation : int

La duración de la animación puede variar hasta este valor. La variación nunca reducirá la duración de la animación a menos de 0.

durationVariation solo surtirá efecto si se utiliza duration para calcular la duración de los fotogramas.

El valor por defecto es 0.

frameCount : int

Número de fotogramas de este sprite.

frameDuration : int

Duración de cada fotograma de la animación en milisegundos. Los valores inferiores a 0 no son válidos.

Si « frameRate » es válido, se utilizará para calcular la duración de los fotogramas. Si no lo es, y «frameDuration» es válido, se utilizará «frameDuration». En caso contrario, se utilizará «duration».

frameDurationVariation : int

La duración de un fotograma de la animación puede variar hasta este valor. La variación nunca reducirá la duración de la animación a menos de 0.

frameDurationVariation solo surtirá efecto si se utiliza « frameDuration » para calcular la duración de los fotogramas.

El valor por defecto es 0.

frameHeight : int

Altura de un fotograma individual en este sprite.

frameRate : real

Número de fotogramas por segundo que se mostrarán en la animación. Los valores inferiores a 0 no son válidos.

Si «frameRate» es válido, se utilizará para calcular la duración de los fotogramas. Si no lo es, y « frameDuration » es válido, se utilizará « frameDuration ». En caso contrario, se utilizará «duration».

frameRateVariation : real

La frecuencia de fotogramas entre animaciones puede variar hasta este valor. La variación nunca reducirá la duración de la animación a menos de 0.

frameRateVariation solo surtirá efecto si se utiliza « frameRate » para calcular la duración de los fotogramas.

El valor por defecto es 0.

frameSync : bool

Si el valor es «true», la animación no tendrá duración. En su lugar, la animación avanzará un fotograma cada vez que se muestre un fotograma en pantalla. De este modo, se sincroniza con la frecuencia de actualización, en lugar de con el tiempo transcurrido.

Si «frameSync» se establece en «true», anula todos los valores de «duration», « frameRate » y « frameDuration ».

El valor por defecto es «false».

frameWidth : int

Ancho de un fotograma individual en este sprite.

frameX : int

La coordenada X en el archivo de imagen del primer fotograma del sprite.

frameY : int

La coordenada Y en el archivo de imagen del primer fotograma del sprite.

name : string

El nombre de este sprite, para utilizarlo en la propiedad «to» de otros sprites.

randomStart : bool

Si es cierto, la animación comenzará su primera secuencia tras saltarse una parte aleatoria de su duración. Esto evita que parezca que todas las animaciones acaban de empezar en el momento en que se inicia la animación.

Esto solo afecta a la primera animación que se reproduce. La transición a otra animación, o a la misma animación de nuevo, no activará esta opción.

El valor por defecto es «false».

reverse : bool

Si es «true», la animación se reproducirá al revés.

El valor por defecto es «false».

source : url

La fuente de la imagen para la animación.

Si no se especifican frameHeight y frameWidth, se supone que se trata de una única fila larga de fotogramas cuadrados. De lo contrario, puede tratarse de varias filas contiguas o de fotogramas rectangulares; cuando se agote una fila, se utilizará la siguiente.

Si se especifican frameX y frameY, la fila de fotogramas se tomará con esas coordenadas x/y como esquina superior izquierda.

to : QVariantMap

Una lista de otros sprites y las transiciones ponderadas hacia ellos; por ejemplo, {"a":1, "b":2, "c":0} indicaría que un tercio debería pasar al sprite «a» al finalizar este sprite, y dos tercios deberían pasar al sprite «b» al finalizar este sprite. Dado que las transiciones se eligen al azar, estas proporciones no serán exactas. Al incluir «c»:0 en la lista, ningún sprite pasará aleatoriamente al «c», pero será una ruta válida si se establece un objetivo de sprite.

Si no se especifica ninguna lista, o si la suma de los pesos de la lista es cero, el sprite se repetirá tras completarse.

© 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.