Files
SpineParticlesWeb/DateToSpine/docs/13-四点三动画预览记录.md
T
2026-09-07 21:29:15 +08:00

41 lines
1.8 KiB
Markdown

# 4.3 动画预览阶段记录
## 阶段结果
4.3 官方 Runtime 已从“只读资源信息”升级为真实动画绘制。主界面现在会直接显示骨骼角色,而不是整张 Atlas 纹理。
## 已实现
- Runtime ABI 增加动画选择、逐帧更新和绘制命令接口。
- 4.3 adapter 创建 `Skeleton``AnimationState``SkeletonRenderer`
- 输出世界坐标、UV、颜色、索引、纹理路径和混合模式。
- Runtime 内部完成 Mesh 和 Clipping 处理。
- Qt 独立预览画布按纹理三角形绘制并自动适应窗口。
- 支持 Normal、Additive、Multiply、Screen 四种混合模式映射。
- 默认循环播放动画列表第一项;列表为空时保持静态姿态,不启动动画播放。
- 用户切换下拉框时立即切换动画并循环播放。
- 预览画布尺寸独立于每帧骨骼边界;首次加载后锁定视口,动画过程不再忽大忽小。
- 默认以画布可容纳的最大比例显示,并保留少量安全边距。
- 滚动鼠标中键时,以鼠标所在位置为中心缩放画布。
- 单击鼠标中键时重置缩放和画布位置。
- 按住鼠标右键拖动时平移画布;右键短按时回到中心。
- 软件绘制路径消除了逐三角形抗锯齿造成的 Mesh 接缝。
## 测试证据
官方 Spineboy 4.3 JSON 测试已经验证:
- 动画可被选择。
- 每帧能产生绘制命令、顶点和三角形索引。
- 绘制命令引用的纹理文件存在。
- 时间推进后世界坐标确实发生变化。
- JSON 和 SKEL 仍能重复加载。
阶段截图:`阶段产出/骨骼动画预览-4.3.png`
固定画布截图:`阶段产出/固定画布最大显示-4.3.png`
## 后续范围
下一步复用相同 ABI 分别适配 4.2、4.1、4.0 和 3.8。各版本仍使用独立官方 Runtime,不把跨版本差异塞入界面代码。