跳转至

AddFilmGrain 视频胶片颗粒与真实胶卷噪波节点

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

AddFilmGrain 节点通过高精度的时域噪波生成算法（Temporal Noise Generation）与基于亮度通道的动态蒙版（Luminance Masking），为数字视频流添加逼真的有机胶片颗粒质感。它模拟了真实银盐胶片在化学感光时的物理微粒结构，使颗粒根据画面不同明暗区域的亮度自适应呈现，消除纯数字摄影机或 AI 生成视频过于平滑生硬的塑料质感。

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

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

  • 为过分锐利干净的数字视频或 AI 生成视频赋予电影级（Cinematic）的有机胶片微粒与呼吸感；
  • 制作复古（Vintage）、老式录像带或经典黑白电影怀旧视觉特效；
  • 赋予扁平画面更深邃的视觉层次、空间景深感与光影质感；
  • 统一多段素材之间的噪点水平，掩盖局部画面的轻微压缩瑕疵或色阶断层。

使用指南 (How to use it)

基础配置流程 (Basic Setup)

  1. 在工作流画布中添加 AddFilmGrain 节点。
  2. 将视频输入源连接至 video 输入插槽。
  3. 调节 grain_intensity（颗粒强度）、luminance_threshold（亮度响应阈值）以及 grain_scale（颗粒微粒尺寸）。
  4. 执行工作流，合成电影颗粒的视频将即刻生成。

参数输入插槽 (Parameters)

  • video：待添加胶片颗粒的目标视频流（原生支持 VideoArtifact 与 VideoUrlArtifact）。
  • grain_intensity：胶片颗粒的物理强度（取值范围：0.05–1.0，默认值：0.15）：
    • 0.05：极轻微细微颗粒，若隐若现；
    • 0.15：适中优雅的电影级颗粒（默认标准）；
    • 0.5：明显的粗颗粒胶片质感；
    • 1.0：极限重度胶片噪波。
  • luminance_threshold：颗粒最清晰显现的亮度参考阈值（取值范围：50–100，默认值：75）：
    • 50：颗粒偏重显现在画面暗部区域；
    • 75：颗粒在中高光与中间调区域呈现最自然（推荐用于提亮区域）；
    • 100：颗粒主要集中附着于亮部与极高光。
  • grain_scale：胶片颗粒微粒的物理几何缩放比例（取值范围：1.0–4.0，默认值：2.0）：
    • 1.0：细腻微小的极细胶片粒子（Fine Grain，类似低 ISO 感光度）；
    • 2.0：适中中等大小粒子（默认）；
    • 4.0：大颗粒粗粝质感（类似高 ISO 胶卷或 16mm/8mm 胶片）。
  • processing_speed：转码编码速度与导出画质平衡策略（默认值："balanced"）：
    • fast：极致极速处理，画质略降（FFmpeg ultrafast 预设，CRF 30）；
    • balanced：画质与速度的最佳平衡点（FFmpeg medium 预设，CRF 23）；
    • quality：极致广播级画质，较慢渲染（FFmpeg slow 预设，CRF 18）。

输出引脚 (Outputs)

  • video：合成逼真胶片颗粒后的全新视频工件。

典型工作流示例 (Example)

为纯净的数字短片添加低调优雅的电影质感：

  1. 将 LoadVideo 节点的输出连接至 AddFilmGrain 的 video 输入插槽。
  2. 将 grain_intensity 设置为 0.12，以获得细腻不突兀的自然质感。
  3. 将 luminance_threshold 设为 75，确保高光与浅色区域呈现均匀过渡。
  4. 将 grain_scale 设为 2.0。
  5. 执行工作流，生成的视频将在帧与帧之间产生连贯流动的有机颗粒感，输出文件自动命名为 {original_filename}_grain_0.12.{format}。

关键技术特性 (Important Notes)

  • 时域动态颗粒 (Temporal Noise)：颗粒每一帧都在根据伪随机算法独立微幅流动，绝非一张静态噪波图片的简单死板叠加；
  • 亮度感知自适应：颗粒显现度与各个像素的亮度值实时强相关，精准还原光学胶片的光化学特性；
  • 音频轨 100% 无损透传：原视频中的伴音音轨会被完美拷贝并精确对齐，不会发生音画不同步；
  • 日志诊断完备：节点内置完备的 FFmpeg 处理日志探针，便于排查复杂长视频的渲染状态。

参数调优专家建议 (Parameter Recommendations)

  • 现代电影高级感 (Subtle Film Look)：grain_intensity: 0.08–0.15，luminance_threshold: 75，grain_scale: 1.5–2.0；
  • 复古老式录像与胶卷 (Vintage/Retro)：grain_intensity: 0.3–0.6，grain_scale: 2.5–3.0；
  • 粗粝感 16mm 艺术电影 (Heavy Grain)：grain_intensity: 0.7–1.0，grain_scale: 3.0–4.0；
  • 人物特写肖像 (Portraits)：luminance_threshold: 70–80，确保人脸肤色区域颗粒自然通透；
  • 风光大场景 (Landscapes)：luminance_threshold: 60–70，增强天空与中间调大面积区域的细节层次。

常见问题与排查 (Common Issues)

  • 长视频超时 (Processing Timeout)：超大分辨率或超长视频编码较慢，节点配置了 5 分钟安全超时看门狗保护。
  • 颗粒感过强像噪点失真：若画面过于噪杂，请适当调低 grain_intensity 至 0.1 以下。
  • 颗粒在画面中不显眼：若画面整体偏暗而 threshold 设得过高，可适度下调 luminance_threshold 并增加 grain_scale。