QML类型说明-AnimatedSprite

AnimatedSprite

ImportStatement:   import QtQuick2.2

Inherits:     Item

 

Properties

currentFrame : int

frameCount : int

frameDuration : int

frameHeight : int

frameRate : qreal

frameSync : bool

frameWidth : int

frameX : int

frameY : int

interpolate : bool

loops : int

paused : bool

reverse : bool

running : bool

source : url

Methods

int advance()

int pause()

int restart()

int resume()

DetailedDescription

动画精灵为一个图像文件提供了渲染和控制后的多个帧。我们可以以显示器的刷新率播放这些帧，也可以人工的控制帧的刷新。关于动画精灵更详细的文档，可以参看QT的动画精灵说明文档。注意：QML的这个组件，只是封装了一个单一的动画，而不是使用精灵引擎定义多个动画。

PropertyDocumentation

currentFrame : int

播放暂停时，这个属性可以设置，也可以调用callingadvance()去修改。

 

frameCount : int

这个动画精灵的帧的数目。

 

frameDuration : int

动画的每一帧的持续时间。这个值小于等于0是无效的。

如果frameRate是有效的，则frameRate将被用来计算帧的播放时间，如果frameRate是无效的而frameDuration是有效的，则使用frameDuration来计算帧的时间。修改这个参数，将会重新启动动画。

 

frameHeight : int

动画精灵中一个单帧的高度。如果是文件中的唯一精灵，这个参数可以省略。

 

frameRate : qreal

动画每秒显示的帧数，这个值小于等于0是无效的。如果frameRate是有效的，则这个值被用来计算帧的持续时间，如果这个值是无效的，同时frameDuration是有效的，则使用frameDuration来计算帧的持续时间。改变这个参数将会重新启动动画。

 

frameSync : bool

假如为真，则动画的每一帧没有持续时间。这意味着，当每一帧绘制好后，直接刷新到屏幕上。这个属性设置为真，将会自动计算并覆盖frameRate和frameDuration。这个属性的默认值为假，假如这个属性发生变化，则动画将重新启动。

 

frameWidth : int

动画精灵中一个单帧的宽度。如果是文件中的唯一精灵，这个参数可以省略。

 

frameX : int

动画精灵的第一帧在资源文件位置的X坐标。如果第一帧从资源文件的左上角开始，则这个属性可以省略。

 

frameY : int

动画精灵的第一帧在资源文件位置的Y坐标。如果第一帧从资源文件的左上角开始，则这个属性可以省略。

 

interpolate : bool

假如这个值为真，则在精灵帧之间增加插帧让动画显得更平滑。默认值为真。

 

loops : int

动画播放多少次后自动停止，负值无效。假如这个值被设置成AnimatedSprite.Infinite，则动画会一直播放下去。这个值得默认值是AnimatedSprite.Infinite

 

paused : bool

当暂停时，当前帧能被人工提前。默认为假。

 

reverse : bool

假如为真，则动画将倒着播放（播放顺序？），默认为假。

 

running : bool

精灵是不是动画，默认为真。

 

source : url

动画的图像源。假如frameHeight和frameWidth没有被指定，那么动画的帧按资源图片大小被假设为单一的长方形帧。假如frameHeight和frameWidth被指定，则动画被认为是连续的帧。资源没有被一帧用尽的其他画面，被认为是其他帧，逐一被用。假如frameX和frameY被指定，则第一帧被移动到资源文件左上角的x,y部分开始。

 

MethodDocumentation

int advance()

提前动画精灵的一帧。

 

int pause()

暂停动画精灵，假如paused是真，则什么都不做。

 

int restart()

停止，然后启动动画精灵。

 

int resume()

当paused为真时，则继续播放动画，否则什么都不做。