Skip to content

Animation Track 与 Record Mode

同时显示动画 Scene 与 Inspector 的 Timeline 项目

Record Mode 把 Inspector 中的修改写进所选动画 Property,Scene 则实时预览采样结果。

Animation Track 采样强类型 Property,并应用到 FX Object。Transform Property 写入 position、rotation 或 scale;Config Property Track 写入 Emitter Runtime 上已注册的 RuntimeValue Slot。

可动画 Property 类型

  • position、rotation、scale;
  • 标量 float/int 和 boolean Runtime Value;
  • NumberFunctionNumberFunction3
  • Color/HDR Color;
  • Emitter Type 注册的 Renderer 与 Material Override 字段;
  • 每个 Config 动态生成的 Additional GPU Data Channel。

Property 菜单来自 Target Object 的 FXObjectType。它不能通过反射动画任意字段;字段必须有受支持 ConfigValueType 的 Runtime Binding。

Key 与 Sub Clip

Item用途
Keyframe在指定时间采样一个值,并在 Key 之间插值。
Curve Clip在 Clip 范围内使用 Curve。
Gradient Clip在范围内编辑 Color/Alpha Stop。
Expression Clip使用 Clip Local Time 计算表达式。

Curve Key 提供 Tangent Handle;Color Lane 提供 Gradient Stop。Lane Item 使用和普通 Clip 相同的多选与移动规则。

Record Mode

Record Mode 会在播放推进时,把实时 Inspector 或 Gizmo 修改写入所选 Animation Property。

  1. 将 Animation Track 绑定到 Target。
  2. 添加并选择 Property。
  3. 开启 Record。
  4. 播放,并在需要的时间修改 Target。
  5. 关闭 Record,从零播放检查插值。

录制期间会冻结 Recording Target 的 Per-frame Animation Re-apply,避免用户刚做的修改立即被采样 Pose 覆盖。需要时 Capture 会读取 Authored/Live Value,绕过现有 Runtime Override。

Runtime Binding 行为

应用 Config Animation 时调用 slot.set(sampledValue)。删除或 Mute Property 时调用 slot.clear(),恢复 Authored Config。播放时不需要复制或修改 FX Definition。

同一个 Slot 的多个 Writer

Property Active 时,Timeline 拥有该 Slot。Java 只写一次同一 Slot,可能在下一次 Timeline Evaluate 时被覆盖。应使用其他 Property、按需要持续更新,或删除/Mute Timeline Binding。

Released under the MIT License.