Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

精灵动画

播放一次性动画

播放指定物件的一次性动画,播放完成后自动停止。

@[play_sprite_animation] {
    "target": "物件名称",
    "path": "anim_001.png",
    "frame_count": 30,
    "time_sec": 1,
    "reverse": false,
    "wait": false
}

参数说明

  • target:目标物件名称。
  • path:动画资源路径。
  • frame_count:播放帧数。
  • time_sec:播放时间(秒)。
  • reverse:是否倒序播放,可选,默认为 false
  • wait:是否等待动画完成,可选,默认为 false

播放循环动画

播放指定物件的循环动画,会无限循环播放。

@[set_loop_sprite_animation] {
    "target": "物件名称",
    "path": "",
    "frame_count": 30,
    "time_sec": 1,
    "keyframes": []
}

参数说明

  • target:目标物件名称。
  • path:动画资源路径。
  • frame_count:播放帧数。
  • time_sec:播放时间(秒)。
  • keyframes:关键帧数组,在指定帧执行命令,可选。

取消物件动画

停止指定物件的当前动画。

@[clear_sprite_animation] {
    "target": "物件名称"
}

补间动画

对物件进行补间动画,控制位置和旋转变化。

@[tween_word_sprite] {
    "target": "物件名称",
    "position": [X, Y],
    "rotation": 0,
    "time_sec": 1
}

参数说明

  • target:目标物件名称。
  • position:目标位置坐标,坐标单位为 90 像素一格。
  • rotation:旋转角度,可选。
  • time_sec:动画持续时间(秒)。

物件颤抖

让物件在一段时间内反复抖动。常见于剧情演出场景。

@[shake_event] {
    "frame": 300,
    "distance": 10
}

参数说明

  • frame:震动持续帧数。
  • distance:每次震动的移动距离。