Sprite QML Type
Especifica las animaciones de los sprites. Más...
| Import Statement: | import QtQuick |
Propiedades
- duration : int
- durationVariation : int
- frameCount : int
- frameDuration : int
- frameDurationVariation : int
- frameHeight : int
- frameRate : real
- frameRateVariation : real
- frameSync : bool
- frameWidth : int
- frameX : int
- frameY : int
- name : string
- randomStart : bool
- reverse : bool
- source : url
- to : QVariantMap
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.