Sprite QML 类型

指定精灵动画。更多信息...

导入声明	import QtQuick

包括继承成员在内的所有成员列表

属性

duration : int
durationVariation : int
frameCount : int
frameDuration : int
frameDurationVariation : int
frameHeight : int
frameRate : qreal
frameRateVariation : qreal
frameSync : bool
frameWidth : int
frameX : int
frameY : int
name : string
randomStart : bool
reverse : bool
source : url
to : QVariantMap

详细说明

Sprite 定义了一系列将被 SpriteSequence 动画和渲染的一个或多个帧。精灵可以位于图像文件的中间，也可以沿多行分割，只要它们形成一个连续的行，从文件的左侧边缘开始沿着下一行的文件延伸即可。

有关详细信息，请参阅 Sprite 动画概述。

属性文档

duration : int

动画的持续时间。小于 0 的值是无效的。

如果 frameRate 有效，则将用于计算帧的持续时间。如果没有，并且 frameDuration 有效，则使用 frameDuration。否则使用持续时间。

durationVariation : int

动画的持续时间可以增加或减少的最大值。变化不会将动画的长度减少到小于 0。

如果使用持续时间计算帧的持续时间，则 durationVariation 才会生效。

默认值是 0。

frameCount : int

此精灵中的帧数。

frameDuration : int

动画中每帧的持续时间（以毫秒为单位）。小于 0 的值是无效的。

如果frameRate效验通过，则将用它来计算帧的持续时间。如果无效，且frameDuration有效，则使用frameDuration。否则使用duration。

frameDurationVariation : int

动画中一帧的持续时间可以最多变化这个值。变化不会使动画的长度少于0。

只有在frameDuration用于计算帧的持续时间时，frameDurationVariation才会生效。

默认值是 0。

frameHeight : int

在此精灵中单个帧的高度。

frameRate : qreal

动画中每秒显示的帧数。小于0的值是无效的。

如果frameRate有效，则用它来计算帧的持续时间。如果不有效，且frameDuration有效，则使用frameDuration。否则使用duration。

frameRateVariation : qreal

动画之间帧率的波动可以最多变化这个值。变化不会使动画的长度少于0。

只有在frameRate用于计算帧的持续时间时，frameRateVariation才会生效。

默认值是 0。

frameSync : bool

如果为true，则动画没有持续时间。相反，动画将在每次将帧渲染到屏幕上时前进一帧。这将使其与绘图速率同步，而不是与经过的时间同步。

如果frameSync设置为true，则覆盖所有duration、frameRate和frameDuration。

默认值是false。

frameWidth : int

在此精灵中单个帧的宽度。

frameX : int

精灵第一帧的图像文件的X坐标。

frameY : int

精灵第一帧的图像文件的Y坐标。

name : string

此精灵的名称，用于在其他精灵的to属性中使用。

randomStart : bool

如果为true，则动画将从随机跳过的持续时间开始舞动。这可以让它们看起来不是在动画开始时同时开始。

这只会影响播放的第一个动画。转换到另一个动画或相同的动画再次播放不会触发。

默认值是false。

reverse : bool

如果为true，则动画将以相反的顺序播放。

默认值是false。

source : url

动画的图像源。

如果未指定frameHeight和frameWidth，则假设它是一行连续的方形帧。否则，可以是多行连续的行或矩形帧，当一行结束时，将使用下一行。

如果指定了frameX和frameY，则将从该x/y坐标作为右上角提取帧的一行。

to : QVariantMap

其他精灵及其权重转换列表，例如 {"a":1, "b":2, "c":0}，表示在当前精灵完成时，应将三分之一的转换过渡到精灵 "a"，而三分之二的转换过渡到精灵 "b"。由于转换是随机选择的，这些比例可能不会完全准确。列表中有 "c":0，则不会随机转换到 "c"，但如果设置了精灵目标，它仍然是一个有效的路径。

如果没有指定列表，或者列表中权重的总和为零，则精灵在完成后会重复执行。