精灵动画块用于修改角色立绘或场景图层的位置、大小、旋转和透明度。动画由一个或多个关键帧组成。
v1.9.0 起不再提供新建入口：Tab 菜单已移除「精灵动画」。已有剧本中的精灵动画块仍可正常查看、编辑和运行。新的单对象动画请使用摄像机块并把作用对象选到具体立绘或图层；多轨编排请使用镜头动画。 基本用法
在空白旁白块按 Tab，选择「精灵动画」。选择目标后，在时间轴上添加关键帧并设置属性、时长和缓动。
动画目标
先选择动画目标：
| 目标类型 | 说明 |
|---|
| 角色立绘 | 动画作用于某个角色的立绘。留空则默认为主角 |
| 场景图层 | 动画作用于当前场景中的某个图层。需要先选择图层所属的场景 |
选择「场景图层」时，Studio 会根据剧本上下文自动推断当前使用的场景，并列出它的所有图层供你选择。
可动画属性
每个关键帧可以设置以下 9 种属性的任意组合：
| 属性 | 说明 |
|---|
| X 坐标 | 水平位置，支持像素值（如 100）或百分比（如 50%） |
| Y 坐标 | 垂直位置 |
| 宽度 | 目标宽度，支持像素值或百分比 |
| 高度 | 目标高度 |
| 水平缩放 | 横向缩放倍数，1 为原始大小 |
| 垂直缩放 | 纵向缩放倍数 |
| 旋转 | 旋转角度 |
| 透明度 | 0 完全透明，1 完全不透明 |
| 锚点 | 变换的中心点，可以选「居中」或「左上角」 |
每个关键帧不需要设置所有属性。只设置你需要变化的属性，其他属性会保持当前值不变。
关键帧时间轴
关键帧时间轴按顺序执行各帧。每个关键帧定义目标属性、时长和缓动。
单帧动画
单帧动画从当前状态过渡到目标状态。例如，在 500ms 内将角色移动到画面中央。
多帧动画
多帧动画按顺序执行多个目标状态。每段过渡可以设置独立的时长和缓动。
缓动函数
每个关键帧可以单独设置缓动函数，控制过渡的速度曲线：
| 缓动 | 效果 |
|---|
| 线性 | 匀速变化 |
| 缓入 | 开始慢，结束快，适合起步 |
| 缓出 | 开始快，结束慢，适合减速停下 |
| 缓入缓出 | 开始和结束较慢，中间较快 |
| 弹跳 | 到达终点时弹跳几下，适合落地效果 |
| 回弹 | 先超过目标再弹回来，适合弹性效果 |
循环与等待
- 循环次数：
0 表示执行一次；正整数表示重复次数；无限表示持续循环
- 等待完成：默认开启；关闭后，动画与后续 Block 并行执行
典型用法
- 角色入场：透明度 0→1 + X 从屏幕外移到目标位置，配合缓出效果做出自然的滑入感
- 角色退场：透明度 1→0 + X 移出屏幕，或者缩放到 0 做消失效果
- 强调动作：短暂放大（比如 1.0→1.1→1.0），模拟角色的惊讶或震动
- 场景元素动画：场景图层中的云缓慢移动、水面上下起伏、树叶摇摆
- 角色呼吸感：微小的缩放循环（scaleY 在 1.0 和 1.02 之间反复），让静态立绘有一点生命感
