SpineParticlesWeb/DateToSpine/docs/13-四点三动画预览记录.md

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，不把跨版本差异塞入界面代码。