HoldVideoFrames 视频定格驻留与定格动画抽帧特效节点

节点核心功能 (What is it?)

HoldVideoFrames 节点通过将视频中的每一个有效帧在时序上驻留（Hold）指定的帧数，创造出强烈的阶梯式帧推进与逐格定格动画效果（Stop-Motion / Frame-Stepping）。它能够有效打破现代数字视频过于顺滑的 60fps 质感，重现黏土动画、经典日系赛璐璐逐格抽帧或复古机械摄影的独特艺术韵味。

典型适用场景 (When would I use it?)

在以下情况下使用 HoldVideoFrames 节点：

• 模拟定格黏土动画（Stop-Motion Animation）或乐高定格视频的顿挫感；
• 制作带有节律顿挫与机械美感的赛博风格抽帧特效；
• 强行降低有效帧率，让高速运动画面的关键动作清晰可见，便于帧级别深度动作拆解；
• 模拟早期无声电影或老式手摇摄影机的跳帧质感。

使用指南 (How to use it)

基础配置流程 (Basic Setup)

1. 在工作流画布中添加 HoldVideoFrames 节点。
2. 将输入视频连接至 video 输入插槽。
3. 设定 hold_frames 驻留帧数参数（例如设为 3 或 4）。
4. 执行工作流，定格动画风格的视频即刻生成。

参数输入插槽 (Parameters)

• video：待应用定格驻留效果的目标视频流（原生支持 VideoArtifact 与 VideoUrlArtifact）。
• hold_frames：每一帧画面的静止驻留帧数（取值范围：1–10，默认值：2）：
  • 1：无效果，完全按照原始连续帧率播放；
  • 2：每帧重复驻留 2 帧，有效帧率减半，轻微顿挫；
  • 5：每帧驻留 5 帧，显著的逐格定格步进效果；
  • 10：每帧驻留 10 帧，极强烈的慢放定格感。
• processing_speed：转码编码与画质平衡（fast / balanced / quality）。

输出引脚 (Outputs)

• video：完成帧驻留特效处理后的全新视频工件。

典型工作流示例 (Example)

为一段实拍视频制作定格动画顿挫风：

1. 将 LoadVideo 的输出连接至 HoldVideoFrames 节点的 video 输入插槽。
2. 将 hold_frames 设为 3。
3. 运行工作流，导出的视频将产生明显的阶梯感定格顿挫，文件自动命名为 {original_filename}_hold_3_frames.{format}。

关键技术特性 (Important Notes)

• 底层使用精确的帧复制与 PTS 轴重组算法，确保视频总时长按倍率同比例拉长；
• 声音同步提示：由于画面发生了物理阶梯定格与时长拉伸，原片音频在长时间跨度下可能与定格动作产生节奏差异，建议后续通过配音节点单独加注环境音效。

参数调优建议 (Effect Recommendations)

• 轻微动画抽帧感：hold_frames: 2–3，适合动漫风格二次元化；
• 纯正定格黏土动画风：hold_frames: 4–6，顿挫分明，手作感强烈；
• 极限慢速动作拆解：hold_frames: 7–10，清晰展示微动作瞬间。