Natron Radial 节点完全指南：径向渐变遮罩的创建、参数详解与实战用法-平芜编程栈

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

【免费下载链接】Natron

Open-source video compositing software. Node-graph based. Similar in functionalities to Adobe After Effects and Nuke by The Foundry.

项目地址：https://gitcode.com/gh_mirrors/na/Natron

点击查看免费下载

Radial（径向渐变）是 Natron「Draw」节点组中最轻量的渐变生成工具之一，它用一条从中心向四周扩散的软边圆盘，为颜色调整、特效区域提供柔和的遮罩过渡。本文以官方指南 thenodes-draw-radial.rst 为骨架，结合插件参数文档与仓库源码，完整讲解 Radial 节点的原理、全部参数、五步上手操作以及遮罩实战技巧，帮助你用它替代部分 Roto/RotoPaint 工作，获得更快的处理速度与更平滑的边缘过渡。

Radial 节点是什么

Radial 节点用于创建一个径向渐变（radial gradient）：从一个中心点向四周扩散，由内圈颜色（Color 0）平滑过渡到外圈颜色（Color 1），其过渡范围由 Softness（软边）参数控制。

它最典型的用途是遮蔽颜色调整（masking off a color adjustment）：把 Radial 接到调色节点的遮罩输入上，只让调色效果作用在画面中心区域，并向四周平滑衰减。官方文档特别强调：

它的Softness 参数可以独立编辑，且不会过多破坏边缘值（edge values），非常适合用来蒙住效果中那些"模糊、无定形"（nebulous）的区域；
相比 Roto 或 RotoPaint 节点，Radial创建更快、处理也更快（"It is faster to use and to process that a Roto or RotoPaint node"）。

在节点分类上，Radial 属于 Draw 节点组（工具栏铅笔图标下的节点），与 LightWrap、Plasma、Ramp、Random Noise、Rectangle、Roto、RotoPaint 并列，参见 Draw 节点组索引与自动生成的 Draw 节点分组文档。

从仓库源码看，Radial 的插件标识符被定义在引擎层常量中：

// Engine/EffectInstance.h，第 53 行 #define PLUGINID_OFX_RADIAL "net.sf.openfx.Radial"

即 Radial 在 Natron 内部对应 OpenFX 插件net.sf.openfx.Radial（插件文档标注的当前版本为 2.1，见 net.sf.openfx.Radial 插件文档）。这意味着你也可以通过脚本以该插件 ID 创建节点，例如app.createNode("net.sf.openfx.Radial")。

五步快速上手

打开 Radial 节点的属性面板后，配合查看器（Viewer）中的矩形手柄（rectangle gizmo），按以下步骤即可完成最常见的遮罩配置：

步骤	操作	效果
1	拖动查看器中可见的矩形手柄调整形状	编辑渐变覆盖范围与比例
2	需要正圆时，按下 Size 参数区中的「2」按钮（宽高等比例锁定）	把矩形锁定为正方形，得到正圆渐变
3	需要圆居中时，按下「Center」按钮	将渐变中心对齐到图像/工程中心
4	将 Softness 设为 0	得到硬边圆盘（hard-edged circle）
5	修改 Color 0 与 Color 1	改变内圈与外圈的末端颜色

其中第 4 步是文档明确给出的关键技巧：A hard-edged circle can be obtained by setting the softness paramet to 0。当 Softness 为 0 时，节点绘制的是一个带抗锯齿边缘的圆盘或椭圆（详见下文参数表）。

此外，Radial 节点支持两种过渡模式，由「Perceptually Linear（感知线性）」复选框开关决定：勾选后，渐变在视觉上更接近人眼感知的线性过渡；不勾选则为默认的线性渐变计算方式。这也是"With or without the Perceptually linear checkbox"的含义。

参数全解

下表完整整理了 Radial 节点的全部控制参数，与自动生成的插件参考文档 net.sf.openfx.Radial.rst 中的 Controls 表格一一对应，并补充了默认值与函数说明：

参数 / 脚本名	类型	默认值	作用
Extent /`extent`	Choice	Size	输出范围（尺寸与偏移）。可选：Format（format）使用预定义图像格式；Size（size）使用自定义范围；Project（project）使用工程范围；Default（default）使用默认范围（例如已连接源片段的范围）
Center /`recenter`	Button	—	将区域定义（RoD）居中到输入范围；若无输入，则居中到工程窗口
Reformat /`reformat`	Boolean	Off	将输出格式设置为给定范围（Bottom Left 或 Size 参数被动画化时除外）
Format /`NatronParamFormatChoice`	Choice	HD 1920x1080	输出格式，可选：PC_Video 640x480、NTSC 720x486 0.91、PAL 720x576 1.09、NTSC_16:9 720x486 1.21、PAL_16:9 720x576 1.46、HD_720 1280x720、HD 1920x1080、UHD_4K 3840x2160、1K_Super_35(full-ap) 1024x778、1K_Cinemascope 914x778 2.00、2K_Super_35(full-ap) 2048x1556、2K_Cinemascope 1828x1556 2.00、2K_DCP 2048x1080、4K_Super_35(full-ap) 4096x3112、4K_Cinemascope 3656x3112 2.00、4K_DCP 4096x2160、square_256、square_512、square_1K 1024x1024、square_2K 2048x2048
Bottom Left /`bottomLeft`	Double	x: 0, y: 0	尺寸矩形的左下角坐标
Size /`size`	Double	w: 1, h: 1	尺寸矩形的宽与高
Interactive Update /`interactive`	Boolean	Off	勾选后在查看器交互过程中实时更新参数值；否则在释放笔刷/手柄时才更新
HiDPI /`hidpi`	Boolean	Off	显示区域为高 DPI（如 Retina）时勾选，OpenGL 覆盖层绘制会放大两倍
Frame Range /`frameRange`	Integer	min: 1, max: 1	时间域范围
Softness /`softness`	Double	1	径向渐变的软边程度；设为 0 时绘制抗锯齿圆盘或椭圆
Perceptually Linear /`plinear`	Boolean	Off	让径向渐变在视觉上看起来更线性（符合人眼感知）
Color 0 /`color0`	Color	r: 0, g: 0, b: 0, a: 0	内圈末端颜色（默认全透明黑）
Color 1 /`color1`	Color	r: 1, g: 1, b: 1, a: 1	外圈末端颜色（默认不透明白）
Expand RoD /`expandRoD`	Boolean	On	当连接了 Source 且 color0 为全透明黑时，将源范围扩展为包含形状范围
Invert Mask /`maskInvert`	Boolean	Off	勾选后，效果在遮罩为 0 的区域完全生效（遮罩反相）
Mix /`mix`	Double	1	原始图像与处理后图像的混合比例

上述参数中的多数（Extent、Mix、Mask、Frame Range 等）属于 Natron 节点的通用属性，其通用行为可参考节点通用属性文档。

关键参数解读

Extent 与「填满图像」：官方指南指出To fill the image with the effect set "Extent" to "Project"。将 Extent 设为Project，Radial 的范围即扩展为整个工程画面；作为生成器使用时，区域定义则为所选格式或工程输出格式。
Softness 的边缘价值：这是 Radial 相比硬蒙版的核心优势——增大软边不会"吃掉"中心区域的边缘值，遮罩过渡平滑可控，适合模糊区域遮蔽。
Perceptually Linear：默认关闭。开启后渐变更符合人眼亮度感知，避免径向渐变在中段看起来"过窄或过宽"的观感问题。

输入与合成行为

Radial 节点拥有两个可选输入（参见插件文档 Inputs 表）：

输入	说明	是否可选
Source	源图像	可选
Mask	遮罩	可选

合成行为如下（插件文档 Description 明确说明）：

渐变使用'over'（叠加）算子与源图像合成；
未连接 Source 时，节点表现为生成器（generator），其区域定义（region of definition）为：
- 若 Extent 参数为某种格式，则为该格式；
- 若 Color 0 非全黑透明，则为工程输出格式；
- 若 Color 0 为全黑透明，则为所选范围外加 1 像素边框。

这一行为意味着 Radial 既可作为纯渐变背景生成器，也可以叠加在源图像之上充当软遮罩层。

实战：用 Radial 遮蔽颜色调整

一个典型的工作流示例：

在节点图中创建调色节点（如 Grade / ColorCorrect），并创建一个 Radial 节点；
将 Radial 的输出接入调色节点的Mask输入；
打开 Radial 属性面板，用查看器中的矩形手柄框选希望保留调色效果的画面区域；
按需按下「2」按钮锁定正圆，或按「Center」居中；
调整 Softness 获得柔和过渡；若需要完全硬边（如严格限定的选区），将 Softness 设为 0；
必要时勾选Invert Mask反向遮蔽，让效果作用于遮罩为 0 的区域。

当需要遮蔽的是画面中"模糊、无定形的区域"（如光晕、雾气、辉光边缘）时，Radial 的软边渐变比逐点勾画 Roto 形状更高效——这正是官方指南推荐它的场景。而如果需要精细的贝塞尔/样条轮廓或逐点羽化，则仍应选择 Roto 与 RotoPaint 节点，其工具覆盖面更广（RotoPaint 还支持画笔笔触）。

源码实现佐证

插件标识：引擎层以PLUGINID_OFX_RADIAL = "net.sf.openfx.Radial"常量登记该节点（Engine/EffectInstance.h），与插件文档、Draw 节点分组中的net.sf.openfx.Radial完全对应。
GUI 渲染：GUI 层在绘制基于椭圆的渐变覆盖层时使用 Qt 的QRadialGradient（参见 Gui/NodeGui.cpp，其中以椭圆中心与半径构造径向渐变），与 Radial 节点"中心向外扩散"的渐变理念一致，可用于理解查看器中形状手柄与渐变的视觉呈现方式。
文档联动：net.sf.openfx.Radial 插件文档由 Natron 自动生成（文件头部注明 "generated automatically by Natron itself"），其中的参数表即为节点属性面板实际呈现的完整参数集，可作为任何版本核对时的权威参考。

小结

Radial 是 Natron 中创建径向渐变与软边遮罩的首选工具：参数少、上手快、处理开销低。掌握"矩形手柄调形状 + Size 的「2」按钮锁定正圆 + Center 居中 + Softness 控制软硬边 + Color 0/1 决定颜色 + Extent 控制范围"这一套操作，即可高效完成大多数局部调色遮蔽任务；需要更复杂轮廓时再切换到 Roto/RotoPaint，二者互为补充，覆盖从快速遮罩到精细 rotoscoping 的完整需求。