跳转至

ResizeVideo 视频重设分辨率与长宽比适配缩放节点

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

ResizeVideo 节点依托底层高精度 FFmpeg 缩放管线，提供多种专业的分辨率调整与几何重采样模式（按指定宽度、指定高度、百分比缩放或精确设定宽高）。它具备完善的长宽比保真策略，支持留边填充（Letterboxing）、居中裁剪填满（Crop to Fill）或强行拉伸，并原生提供包括 Lanczos、Bicubic 等在内的工业级重采样插值算法。

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

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

  • 将高分辨率素材（如 4K）按等比例缩减至 1080p 或 720p，以大幅降低下游 AI 模型显存开销；
  • 按精准百分比（如 50%、200%）缩放视频分辨率；
  • 将不同纵横比的素材（如横屏 16:9 与竖屏 9:16）通过添加黑边统一嵌入到标准画幅中；
  • 裁剪画面以铺满特定的社交媒体视频规范画幅（如适配抖音、小红书、TikTok）；
  • 在视频拼接前标准化各素材的物理像素尺寸。

使用指南 (How to use it)

基础配置流程 (Basic Setup)

  1. 在工作流画布中添加 ResizeVideo 节点。
  2. 将视频输入源连接至 video 输入插槽。
  3. 选择所需的重设尺寸模式（resize_mode）。
  4. 设定对应的目标像素尺寸或缩放百分比。
  5. （在宽高模式下）选择画幅适配策略（fit_mode）及填充背景色（background_color）。
  6. 执行工作流，缩放调整后的视频工件即刻生成。

参数输入插槽 (Parameters)

  • video：待缩放的目标视频流（原生支持 VideoArtifact 与 VideoUrlArtifact）。
  • resize_mode：分辨率重设策略下拉菜单：
    • width：指定目标宽度，高度自适应保持原长宽比；
    • height：指定目标高度，宽度自适应保持原长宽比；
    • percentage：按原始分辨率的百分比进行缩放；
    • width and height：强制指定精准的目标宽度与高度，并结合 fit_mode 适配。
  • target_size：在 width 或 height 模式下的目标像素大小（取值范围：1–8000 像素）。
  • percentage：缩放百分比（取值范围：1–500%，默认值：100）。
  • target_width / target_height：在 width and height 模式下的目标像素宽/高。
  • fit_mode：画幅适配填充策略（仅在 width and height 模式下生效）：
    • fit（留边填充）：严格保持原长宽比，在四周补齐指定背景色黑边（Letterboxing）；
    • fill（裁剪填满）：严格保持原长宽比，居中等比放大并裁切溢出的边缘画面以铺满全屏；
    • stretch（强行拉伸）：忽略原长宽比，强行将画面扭曲拉伸至目标尺寸。
  • background_color：在 fit 留边填充模式下四周黑边底色的十六进制 Hex 颜色代码（默认：#000000）。
  • scaling_algorithm：重采样数学插值算法（默认："bicubic"）：
    • neighbor（最近邻插值，极速但有马赛克锯齿，适合像素风）；
    • bilinear（双线性插值，平滑均衡）；
    • bicubic（双三次插值，清晰度与平滑度的标准业界平衡）；
    • lanczos（Lanczos 高阶 sinc 窗口插值，锐度与微观边缘细节保持极佳）。
  • lanczos_parameter：Lanczos 阶数微调参数（1.0–10.0，默认值：3.0，仅在算法选为 lanczos 时生效）。

输出引脚 (Outputs)

  • resized_video：重设分辨率与缩放完成后的全新视频工件。

典型示例 (Example)

将一段 4K 宽屏视频等比缩放至标准的 1280x720 规格并留黑边填充：

  1. 将 resize_mode 设为 width and height。
  2. 将 target_width 设为 1280。
  3. 将 target_height 设为 720。
  4. 将 fit_mode 设为 fit。
  5. 将 background_color 设为 #000000（纯黑边）。
  6. 将 scaling_algorithm 设为 "lanczos" 保持极限清晰度。
  7. 执行工作流，即可无变形输出标准的 720p 视频。

关键技术特性 (Important Notes)

  • 编码器偶数像素自适应对齐 (Divisible by 2)：由于现代 H.264/H.265 视频编码器在 YUV 4:2:0 色度抽样下强制要求宽高必须为偶数，该节点底层会自动将计算出的奇数像素安全微调为偶数，彻底杜绝转码崩溃；
  • 音频无损直通：调整视频画面的分辨率绝不触碰音频流，原有音轨执行 Direct Stream Copy，无损透传；
  • 自适应跨格式兼容：全面兼容 MP4、MOV、AVI、WebM 等多种主流格式。