企业官网建设流程全解析

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

本指南以 Documentation/source/plugins/eu.gmic.Curvature.rst 为核心，系统讲解 Natron 节点式合成器中G'MIC Curvature（eu.gmic.Curvature）节点的功能定位、输入接口与全部控制参数，并结合仓库源码说明这类"GMIC 节点参考文档"的自动生成链路。读完本文，你将能独立在 Node Graph 中接入并调优该节点，理解 Smoothness、Threshold、Preview Type 等参数的实际作用与取值边界，并学会在 GMIC 节点组文档 中按标识符检索同类插件。

节点概览：来自 G'MIC 框架的曲率计算滤镜

Curvature 节点是 Natron 内置 GMIC 节点组（见 _groupGMIC.rst）中的一员，其完整插件标识为eu.gmic.Curvature，文档中标注的版本为1.0。按文档描述，它是G'MIC（GREYC's Magic for Image Computing）开源图像处理框架的包装节点（Wrapper），该包装由 Tobias Fleischer 与 Frederic Devernay 编写；滤镜本体作者为 David Tschumperle，文档记录的最近更新日期为2010/29/12。

从参数结构看，这是一个基于图像局部几何信息（曲率）的边缘/细节提取型滤镜：它通过 Smoothness 控制计算时的平滑程度，通过 Min/Max Threshold 对计算结果做阈值截断，并通过 Absolute Value、Negative Colors 决定输出值的取绝对值与极性映射。这类滤镜在合成流程中常用于：

• 提取图像的曲率/边缘特征，作为后续特效或遮罩的辅助信号；
• 对输入画面做非真实感（NPR）风格化处理的前置步骤；
• 生成可继续叠加模糊、Merge 等下游节点的中间层。

输入接口：单一必选 Source

节点的输入定义十分简洁，只有一个必选输入：

也就是说，使用该节点前必须将上游画面（Read、生成器或上一级滤镜的输出）连接到其 Source 输入。与其他 GMIC 节点一致，Curvature 处理的是输入图像的全部通道数据，是否包含 Alpha 由后续的Ignore_Alpha参数决定。

核心滤镜参数：控制曲率计算的五个开关

以下参数是该节点区别于其他 GMIC 滤镜的特有参数，直接决定曲率计算的行为与输出观感：

实战调参建议（基于参数语义，可结合具体素材验证）：

• 默认值Smoothness=2是兼顾细节保留与噪声抑制的起点。若画面噪点明显，可先上调 Smoothness；若边缘过粗、细节丢失，则下调。
• Min/Max Threshold与Absolute_Value常搭配使用：先开启 Absolute Value 得到全正值曲率图，再通过两条阈值把响应范围压缩到可预测的动态区间，便于下游做分级（如提取强边缘遮罩）。
• Negative_Colors更多是风格化手段，应在确认曲率计算本身满意后再切换观察。

预览控制参数：在 Viewer 中对比原图与结果

GMIC 系列节点内置了一套交互预览机制，Curvature 节点同样提供：

• Preview Type = Full：显示完整滤镜结果；
• Forward/Backward Horizontal/Vertical：以水平或垂直方向的前进/后退方式在"原图"与"结果"之间做过渡对比；
• Duplicate Top/Left/Bottom/Right：画面一侧显示原图、另一侧显示结果，便于直接对照；
• Duplicate Horizontal/Vertical：沿整幅画面做左右或上下镜像对比；
• Checkered / Checkered Inverse：以棋盘格交错方式展示原图与结果，适合逐区域精细对比；
• Preview Split：与分割型预览配合，x、y两个归一化值（默认 0.5/0.5，即画面中心）控制分割线的位置。

这一组参数只影响 Viewer 中的交互预览，不改变最终输出，可放心用于在调参过程中反复比对原图与效果。

输出与分辨率控制

• Output Layer：选择输出图像的哪一层。Merged输出合并后的复合层；Layer 0与负编号（Layer -1至Layer -9）用于多图层输入（如 PSD、EXR 多层素材），负编号代表从底层倒数的图层。此参数为处理多层输入的 GMIC 滤镜通用选项。
• Resize Mode：控制滤镜处理的画布/分辨率策略：
  • Fixed (Inplace)：在输入尺寸固定原地处理，不改变画布；
  • Dynamic（默认）：输出画布随滤镜需求动态扩展（例如某些曲率/卷积运算需要扩展边界）；
  • Downsample 1/2、1/4、1/8、1/16：先降采样再处理，用于大幅画面时的快速预览或对高频细节不敏感的场景，可在处理耗时与细节质量之间取舍。
• Ignore Alpha：开启后滤镜仅处理 RGB 通道而忽略 Alpha，避免曲率计算受到透明通道边缘的干扰；对于需要保留原 Alpha 边界不变的应用建议开启。
• Preview/Draft Mode：开启后以草稿/低质量模式进行预览，加快交互响应，正式渲染时可关闭。

随机种子与调试日志

• Global Random Seed：若滤镜内部使用随机过程（G'MIC 系列中若干滤镜含随机成分），该整数作为随机数种子；固定种子可让结果可复现，适合镜头间保持一致。
• Animate Random Seed：开启后每帧自动推进随机种子，产生逐帧变化的随机效果（如动画纹理），用于希望结果随时间演变的场景。
• Log Verbosity：控制 G'MIC 内核向控制台输出的日志详细程度。Off 时不输出；Level 1 至 Level 3 逐级增加调试信息，遇到插件行为异常时可调高等级排查，正常使用保持 Off。

从源码看这些文档从何而来（仓库证据）

你在 Documentation/source/plugins 目录看到的eu.gmic.Curvature.rst并非手写维护，而是由 Natron 自身在运行时导出的自动生成文档。文件头部的 HTML 注释（"Do not edit this file! It is generated automatically by Natron itself."）即为标记。仓库中可验证的生成链路如下：

1. 文档内容生成：Engine/NodeDocumentation.cpp 中的Node::makeDocumentation()（第 62 行起）负责按固定模板输出 Markdown，其内容来源是插件在 OFX 描述阶段注册的插件描述、输入标签/提示、参数名称与枚举选项——这正是本文前述各表中"Parameter / script name"与选项列表的直接出处；
2. 批量导出：Engine/AppInstance.cpp 中的AppInstance::exportDocs()（第 1412 行）遍历已加载插件，为每个非弃用插件创建节点并调用makeDocumentation(false)（第 1498 行）生成 Markdown，同时把插件图标复制为<pluginID>.png（第 1487-1496 行）；GMIC 插件组在分组列表中对应字符串"GMIC"（第 1428 行）；
3. RST 转换：tools/genStaticDocs.sh 调用NatronRenderer --export-docs导出临时 Markdown，再经 pandoc 转换为带 grid 表格的 RST 文件并补充.. _eu.gmic.Curvature:锚点、表格列宽指令CONTROLSTABLEPROPS替换等后处理（见脚本第 82-93 行）。

因此，本文档表内"类型/默认值/可选值"信息与运行时节点属性面板完全一致——你在 Natron 里右键创建该节点后，看到的参数面板即由此数据驱动。若要为插件补充额外的长文说明，按 Documentation/source/guide/tutorials-writedoc.rst 所述，可在插件包内放置Contents/Resources/pluginId.md（本例即eu.gmic.Curvature.md），其内容会被插入到 Description 与 Inputs 两节之间。

在合成流程中的典型用法与相邻节点

Curvature 节点位于GMIC 节点组（左侧工具栏或 Node Graph 右键菜单中的 GMIC 分组，该组共收录约 200 个 G'MIC 滤镜，见 _groupGMIC.rst）。与其定位相邻的同类节点可对照使用：

• eu.gmic.Laplacian：同为边缘/导数型滤镜，参数表与 Curvature 高度一致（同样含 Smoothness、双阈值、Absolute Value、Negative Colors 及全套预览控制），默认Smoothness=0，适合做更锐利的拉普拉斯边缘提取；
• eu.gmic.SmoothMeanCurvature：属于"平滑/降噪"家族，通过 Time Step、Iterations 做均值曲率流平滑，与 Curvature 的"提取"用途互补。

推荐接入流程示例（在 Node Graph 中操作）：

1. 使用 Read 节点导入素材，选中后按1键在 Viewer 显示；
2. 在节点图空白处右键 → GMIC → Curvature（或使用节点创建对话框搜索Curvature），将其 Source 连接到 Read 输出；
3. 在属性面板依次调整Smoothness→Min/Max Threshold→Absolute Value，同时把Preview Type设为Duplicate Horizontal、Preview_Split保留默认x:0.5 y:0.5，实时对比左右两侧的原图与曲率结果；
4. 确认满意后，将输出接入 Merge、Grade 等下游节点，或直接连接到 Write 输出节点渲染。

小结

G'MIC Curvature 是 Natron 中一个结构清晰、参数收敛的曲率特征提取滤镜：Smoothness与双阈值控制计算的敏感度和动态范围，Absolute Value/Negative Colors决定输出极性，而Preview Type/Preview Split、Output Layer、Resize Mode、Ignore Alpha、随机种子与日志等级等则构成 GMIC 节点族的通用控制层。理解这些参数的默认值与作用边界，即可将该节点稳定地纳入曲率图生成、边缘遮罩提取或风格化处理的合成管线。若需查阅同族节点的参数差异，可按插件标识符在 Documentation/source/plugins 目录下检索对应 RST 文件。

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