Create Hook Keyframes From Floats

节点功能: CreateHookKeyframesFromFloats节点根据用户提供的一组 float 数值列表(表示不同时间点的权重),在指定的时间范围内自动生成多个关键帧,形成一个HOOK_KEYFRAMES对象,供 Hook 动态调度使用。该节点必须接受一组float值用来形成调度策略,目前在animetediff中有相应的节点。

输入参数

参数名称说明
floats_strength强度序列值数组或单一 float,作为关键帧强度。
prev_hook_kf可选参数,表示在已有关键帧基础上添加。常用于关键帧追加合并,例如多个调节区间连续插入时复用此参数。

输出参数

参数名称说明
HOOK_KF输出的关键帧对象

控件参数

参数名称说明
start_percent起始时间百分比,范围 [0, 1]。第一个关键帧插入的位置。例如设为 0.0 表示采样从一开始就应用。
end_percent结束时间百分比,范围 [0, 1]。最后一个关键帧插入的位置。
print_keyframes是否打印关键帧插入日志到控制台,默认 False。勾选后可用于调试,输出每个关键帧的百分比与强度值。

如下图所示,通过前端传入的float策略,设置了共0到5,5个frame,强度从0变化到1,结合该节点设置的作用范围,即0-0.5的范围,形成调度策略,打开print_keyframe之后再后台会输出我们的策略。

  • Hook Keyframe - start_percent:0.0 = 0.0
  • Hook Keyframe - start_percent:0.10000000149011612 = 0.20000000298023224
  • Hook Keyframe - start_percent:0.20000000298023224 = 0.4000000059604645
  • Hook Keyframe - start_percent:0.30000001192092896 = 0.6000000238418579
  • Hook Keyframe - start_percent:0.4000000059604645 = 0.800000011920929
  • Hook Keyframe - start_percent:0.5 = 1.0

更加精细的分析,大家可以查看Create Hook Keyframes Interp的解释。