C

动画精灵目录 QML 类型

在目录中绘制存储的精灵动画。 更多...

导入语句import QtQuickUltralite.Extras 2.8
自Qt Quick Ultralite 2.4
继承

Item

属性属性

信号信号

方法方法

详细描述详细描述

AnimatedSpriteDirectory 类型类似 AnimatedSprite，但它是通过目录中的图像来获取精灵动画的图像。它需要一个目录路径的 sourcePath 值，这个目录包含一系列图像。这些图像是精灵动画的帧，AnimatedSpriteDirectory 会像 AnimatedSprite 一样播放每张图像。

动画帧的顺序遵循 ImageFiles 节中图像的列表顺序。将这些图像文件标记为 ImageFiles.MCU.resourceAnimatedSprite，以确保 Qt Quick Ultralite Tools 将它们识别为精灵动画帧的候选者。标记这些图像还可以识别它们的目录名称并正确渲染每个图像。

QML在 QML 项目中声明图像
 
import QtQuickUltralite.Extras

AnimatedSpriteDirectory {
    sourcePath: "loading"
}
    ImageFiles {
        files: [
            "loading/01.png",
            "loading/02.png",
            "loading/03.png",
            "loading/04.png"
        ]
        MCU.resourceAnimatedSprite: true
    }

与AnimatedSprite不同，AnimatedSpriteDirectory没有frameCount、frameWidth和frameHeight属性。它从指定的目录中的图像中获得这些值。目录中的图像数量作为frameCount，图像的宽度和高度分别作为frameWidth和frameHeight。

注意：所有图像的宽度和高必须一致，否则资源编译器（qulrcc工具）无法生成原始图像数据。

参见：管理资源。

属性文档

currentFrame : int

当动画不活动时，设置此属性以手动advance当前帧。您也可以调用advance()方法。


frameDuration : int

每帧动画的持续时间（以毫秒为单位）。只有正值才是有效的。

在动画活动时更改此属性将重新启动动画。


loops : int

表示动画应重播的次数。只有正值是有效的。

将其设置为AnimatedSpriteDirectory.Infinite以无限播放动画。

默认值是AnimatedSpriteDirectory.Infinite。


paused : bool

表示动画是否已暂停。

当动画暂停时，可以手动将其当前帧向前推进。

默认值是false。


running : bool

表示动画是否正在播放。

默认值是true。


sourcePath : string

指向包含精灵动画图像的目录的路径。在ImageFiles节点中，通过将ImageFiles.MCU.resourceAnimatedSprite属性设置为true来为路径中的图像标记。

注意：如果未标记图像，则给定的sourcePath无效。


信号文档

finished()

此信号表示精灵动画已完成。

如果设置running属性为false或loops属性为AnimatedSpriteDirectory.Infinite，则不会发出该信号。

注意：相应处理程序是onFinished。


方法文档

advance()

通过一帧前进精灵动画。


pause()

暂停精灵动画。如果paused是true，则此操作不会执行任何操作。


restart()

重新启动精灵动画。


resume()

如果paused是true，则将精灵动画继续播放。否则，此操作不执行任何操作。


start()

开始播放精灵动画。如果动画已经在运行，调用此方法将没有任何效果。


stop()

停止播放精灵动画。如果动画未在运行，调用此方法将没有任何效果。


在某些Qt许可证下可用。
了解更多信息。