• 音视频
• 视频处理
• 图形学
• 桌面应用

G'MIC Burn（节点标识eu.gmic.Burn）是 Natron 通过 OpenFX 标准封装的一个 G'MIC 滤镜节点，用于对图像施加"灼烧/烧蚀"风格的艺术效果。本文以官方插件文档为主体，完整梳理该节点的输入端口、全部参数含义与默认值，并结合 Natron 源码与文档生成机制说明它在项目中的实际集成方式，帮助你直接在节点图（Node Graph）中正确配置并复现可控效果。

一、节点概述：Natron 中的 G'MIC 滤镜封装

Natron 是一款开源节点图合成软件，支持大量 OpenFX 插件。其中OpenFX-G'MIC是 Natron 官方推荐的开源插件集合之一（见 特性介绍 中的插件列表），它把 G'MIC（GREYC's Magic for Image Computing）框架中的数百个滤镜以 OpenFX 节点形式暴露给 Natron。

本文所述的 G'MIC Burn 节点正是其中一个滤镜封装：

• 插件标识：eu.gmic.Burn
• 文档版本：1.0
• 作者：David Tschumperle（G'MIC 框架作者）；该 OpenFX 封装由 Tobias Fleischer 与 Frederic Devernay 编写
• 最后更新：2012/24/11

从参数构成（Amplitude、Scale、Smoothness）看，Burn 属于典型的参数化艺术滤镜：以输入图像为源，通过幅度、尺度与平滑度三个量协同控制"灼烧"效果的呈现强度与范围，并支持按通道选择性地作用到指定色彩空间分量上。

二、输入端口

Burn 节点只有一个强制输入Source，没有可选输入端口。在节点图中，你需要先把图像节点（如 ReadNode 读取的素材、Noise 等生成节点）连接到 Source 端口，节点才会正常输出处理结果。

三、核心效果参数：Amplitude / Scale / Smoothness

这三个 Double 型参数构成 Burn 滤镜的主控逻辑，建议先调 Scale 确定效果尺度，再微调 Amplitude 与 Smoothness。

三者均可通过双击参数名在时间线上打关键帧做动画。结合 G'MIC 滤镜家族的习惯用法，可以从参数命名推断：Amplitude 决定形态学意义上的侵蚀强度，Scale 决定参与计算的邻域尺度，Smoothness 决定结果的过渡平滑性——具体视觉效果建议以实际渲染对比为准。

四、通道控制：Channel(s) 参数详解

Channels是 Choice 型参数，默认All。它决定滤镜作用于哪些通道，并允许把效果限制在特定色彩空间的单个分量上。完整选项如下：

实际使用中，若只想让"灼烧"效果影响亮度而保留颜色，可以选择YCbCr [Luminance]或Lab [Lightness]；若想保护 Alpha 边缘，则可选择RGB [All]而避开 Alpha。

五、数值处理与预览控制

5.1 Value Action /Value_Action

Choice 型，默认None，用于控制滤镜输出数值的后处理方式：

当 Burn 效果的输出出现大量过曝或欠曝区域时，可以尝试Cut或Normalize来收敛动态范围。

5.2 Preview Type /Preview_Type

Choice 型，默认Full。该参数控制节点预览的显示方式，方便在没有全分辨率渲染的情况下对比效果：

5.3 Preview Split /Preview_Split

Double 型，默认x: 0.5 y: 0.5。与Preview_Type配合使用，定义分割线的位置：x为水平分割比例、y为垂直分割比例，取值范围在 0 到 1 之间，默认 0.5 表示正中分割。

六、输出与性能控制

6.1 Output Layer /Output_Layer

Choice 型，默认Layer 0。G'MIC 滤镜可能产生多层输出（Merged 合并层与多个独立图层），此参数选择输出哪一层：

当滤镜生成多层信息时（例如同时输出结构层与细节层），可通过该参数访问不同图层。

6.2 Resize Mode /Resize_Mode

Choice 型，默认Dynamic。控制滤镜处理时图像尺寸的策略，直接影响渲染速度与内存占用：

对大分辨率素材，可先用Downsample 1/2或更低档位快速预览效果，最终渲染时切回Dynamic或Fixed (Inplace)保证输出精度。

七、通用控制参数

Global_Random_Seed与Animate_Random_Seed是一对关键参数：做静帧艺术效果时应固定种子以保证可复现；做动态随机效果（如火焰、纹理演化）时则开启Animate_Random_Seed。

八、在 Natron 中的集成机制

G'MIC 节点在 Natron 中以独立分组出现，与 Image、Draw、Color 等内建分组并列：

• 节点组索引文件 GMIC 节点组 列出了全部 G'MIC 节点（约 350 个），Burn 节点位于其中；
• 在Engine/AppInstance.cpp的exportDocs()中，GMIC 分组被显式加入文档导出顺序（见 Engine/AppInstance.cpp 中groups << "GMIC"的注释// openfx-gmic），即本文档正是由 Natron 自身按插件分组自动生成的；
• NodeDocumentation.cpp 中的 HTML 侧边导航同样包含 "GMIC nodes" 入口，说明该组文档已整合进 Natron 的在线/离线参考文档体系。

因此，本文所解析的eu.gmic.Burn.rst属于自动生成的插件参考文档：按照 文档编写指南 的说明，Documentation/source/plugins目录下的单个插件文档由 Natron 依据插件源码中的描述与参数 Hint 自动生成，不可手工编辑；其内容与插件属性面板中点击?按钮所见的说明一一对应。你在 Natron 界面中新建节点时，可在左侧工具栏或节点图右键菜单的 GMIC 分组里找到 Burn，并按上文参数表逐一调整。

九、使用建议与注意事项

• 版本与成熟度：CHANGELOG 显示 G'MIC 插件由 Tobias Fleischer 编写并随二进制发行版捆绑，且多处标注 "G'MIC plugins are still beta"（见 CHANGELOG.md）。生产项目中使用前建议先做小样测试并固定Global_Random_Seed，以保证结果可复现。
• 渲染流程：连接 Source → 调整Amplitude/Scale/Smoothness建立基本效果 → 用Channels限定作用域 → 通过Preview_Type与Preview_Split对比前后差异 → 用Resize Mode降档做代理预览 → 最终全分辨率渲染。
• 通道一致性：Channels中涉及 YCbCr、Lab、Lch、HSV、CMYK、YIQ、RYB 等色彩空间转换，若项目使用 OpenColorIO 色彩管理，注意预览与最终渲染在色彩空间一致的前提下进行，避免因颜色转换不一致产生偏差。

通过本文的参数速查表与集成机制说明，你可以在不查阅外部资料的情况下，直接在 Natron 的节点图中配置出稳定、可复现的 G'MIC Burn 效果。

• 音视频
• 视频处理
• 图形学
• 桌面应用