参数名称 | 说明 |
---|---|
prev_hook_kf | 已存在的关键帧组对象,可用于添加多个关键帧。若为空则新建一个 HookKeyframeGroup,否则在现有组上追加。 |
Create Hook Keyframes Interp.
节点功能: CreateHookKeyframesInterpolated节点是一个强大的调度策略,根据给定的起始强度和终止强度,在一定时间范围内自动生成一系列平滑变化的关键帧,并输出为HOOK_KEYFRAMES对象,用于Hook动态调度。首先根据起止时间段(start_percent 到 end_percent)生成平均分布的时间点(百分比);然后根据插值方式(linear, ease-in, 等)计算每个时间点对应的权重值;创建HookKeyframe并依次加入到关键帧组中;最终返回HOOK_KEYFRAMES,可用于SetHookKeyframes。打开print_keyframes之后,会在后台输出调度策略。
输入参数
输出参数
参数名称 | 说明 |
---|---|
HOOK_KF | 包含一组插值关键帧的调度对象。 |
控件参数
参数名称 | 说明 |
---|---|
strength_start | 插值序列的起始强度值。指定关键帧插值的起点强度,通常对应 hook 的最初强度。 |
strength_end | 插值序列的终止强度值。指定关键帧插值的终点强度。建议与 strength_start 配合使用形成渐变控制。 |
interpolation | 插值方式。 linear(线性插值):直线过渡,变化速率不变。 smooth(平滑插值):曲线过渡自然,适合渐变场景。 ease-in(缓入插值):开始变化慢,之后加快,可用于淡入等效果。 ease-out(缓出插值):开始变化快,之后减速,适用于淡出等情况。 ease-in-out(缓入缓出插值):先慢后快再变慢,节奏柔和。 constant(恒定值插值):强度保持初始状态,无变化,用于固定区段强度。 power(指数插值):随时间指数增长,前期变化慢后期快。 sigmoid(S 型插值):类似生长函数,变化平滑,中心陡峭,可控制前中后期权重分布。 sinusoidal(正弦波插值):类似正弦函数,周期性波动,有轻微震荡感。 |
start_percent | 插值起始位置(占推理总步数的百分比)。例如 0.0 表示从第 0% 步开始生效。建议小于 end_percent。 |
end_percent | 插值终止位置(占推理总步数的百分比)。例如 1.0 表示到最后一个采样步完成。 |
keyframes_count | 生成关键帧的总数。决定插值曲线的离散精度,越大则变化越平滑。 |
print_keyframes | 是否在控制台打印关键帧生成信息。建议调试时启用,可查看实际生成的起止步数与强度值。 |
下图为测试工作流,生成一张图片,在该节点设置star和end分别是0到0.5的作用范围,strength变化从0到1,变化策略为linear,即为线性变化,所以从0到1强度线性变化,一共(keyframe)5步,那么对应的值就是0,0.25,0.5,0.75,1,又因为我们设置了策略的作用范围(star_percent和end_persent),所以说在0-0.5的范围内,对应0,0.25,0.5,0.75,1,也就形成了在后台输出的调度策略。
(总结来说就是0-0.5的采样中让强度从0变化到1,应用线性变化的方式)
- Hook Keyframe - start_percent:0.0 = 0.0
- Hook Keyframe - start_percent:0.125 = 0.25
- Hook Keyframe - start_percent:0.25 = 0.5
- Hook Keyframe - start_percent:0.375 = 0.75
- Hook Keyframe - start_percent:0.5 = 1.0