Sprite QML Type

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

• Lista de todos los miembros, incluidos los heredados

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

Sprite define una serie de uno o más fotogramas para ser animados y renderizados por SpriteSequence. Los sprites pueden estar en medio de un archivo de imagen, o divididos a lo largo de varias filas, siempre y cuando formen una línea contigua que envuelva a la siguiente fila del archivo desde el borde izquierdo del mismo.

Para más detalles, consulte la descripción general de las 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, entonces se utilizará para calcular la duración de los fotogramas. Si no, y frameDuration es válido, entonces se utilizará frameDuration. En caso contrario se utilizará duration.

durationVariation : int

La duración de la animación puede variar hasta esta cantidad. La variación nunca disminuirá la duración de la animación a menos de 0.

durationVariation sólo tendrá efecto si se utiliza duration para calcular la duración de los fotogramas.

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, entonces se utilizará para calcular la duración de los fotogramas. Si no, y frameDuration es válido, entonces se utilizará frameDuration. En caso contrario se utilizará duration.

frameDurationVariation : int

La duración de un fotograma de la animación puede variar hasta esta cantidad. La variación nunca disminuirá la duración de la animación a menos de 0.

frameDurationVariation sólo tendrá efecto si se utiliza frameDuration para calcular la duración de los fotogramas.

Por defecto es 0.

frameHeight : int

Altura de un fotograma en este sprite.

frameRate : real

Fotogramas por segundo a mostrar en la animación. Los valores inferiores a 0 no son válidos.

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

frameRateVariation : real

La velocidad de fotogramas entre animaciones puede variar hasta esta cantidad. La variación nunca disminuirá la duración de la animación a menos de 0.

frameRateVariation sólo tendrá efecto si se utiliza frameRate para calcular la duración de los fotogramas.

Por defecto es 0.

frameSync : bool

Si es verdadero, la animación no tendrá duración. En su lugar, la animación avanzará un fotograma cada vez que se renderice un fotograma en la pantalla. Esto la sincroniza con la tasa de pintura en oposición al tiempo transcurrido.

Si frameSync se establece en true, anula toda la duración, frameRate y frameDuration.

Por defecto es false.

frameWidth : int

Anchura de un fotograma 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 su uso en la propiedad to de otros sprites.

randomStart : bool

Si es verdadero, entonces la animación comenzará su primera animación con una cantidad aleatoria de su duración omitida. Esto permite que no parezca que todas acaban de empezar cuando comienza la animación.

Esto sólo afecta a la primera animación reproducida. La transición a otra animación, o la misma animación de nuevo, no activará esto.

Por defecto es false.

reverse : bool

Si es true, la animación se reproducirá en sentido inverso.

Por defecto es false.

source : url

La fuente de la imagen para la animación.

Si no se especifica frameHeight y frameWidth, se asume que es una única fila larga de fotogramas cuadrados. En caso contrario, pueden ser múltiples filas contiguas o fotogramas rectangluares, cuando se acabe una fila se utilizará la siguiente.

Si se especifican frameX y frameY, se tomará la fila de cuadros con esa coordenada x/y como esquina superior izquierda.

to : QVariantMap

Una lista de otros sprites y transiciones ponderadas a ellos, por ejemplo {"a":1, "b":2, "c":0} especificaría que un tercio debería hacer la transición al sprite "a" cuando este sprite termine, y dos tercios deberían hacer la transición al sprite "b" cuando este sprite termine. Como las transiciones se eligen al azar, estas proporciones no serán exactas. Con "c":0 en la lista, ningún sprite transicionará aleatoriamente a "c", pero será una ruta válida si se establece un sprite objetivo.

Si no se especifica ninguna lista, o la suma de pesos en la lista es cero, entonces el sprite se repetirá después de completarse.