企业官网建设流程全解析

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

导读

Premult（net.sf.openfx.Premult）是 Natron 节点图合成管线中负责通道预乘（premultiplication）的核心节点，它把选定平面（Plane）的通道乘以 Alpha（或其他指定通道），从而把非预乘（straight/unpremultiplied）图像转换为内部统一使用的预乘（associated alpha）表示。本文基于 net.sf.openfx.Premult.rst 展开，结合 Engine 层源码与内置 Python 插件，讲解该节点的全部输入、控件参数、底层像素运算原理，以及如何在 Read 节点、PyPlugs 与混合合成流程中正确使用它。

Premult 节点图标

本文档对应插件版本为2.0（net.sf.openfx.Premult）。该文档由 Natron 自身自动生成，文件头标注 "Do not edit this file! It is generated automatically by Natron itself"，因此下述参数表与节点实际行为完全一致。

Premult 节点是什么

根据插件官方描述，Premult 节点的作用是：

Multiply the selected channels by alpha (or another channel).（将所选通道乘以 Alpha，或其他任意通道。）

它在节点图中的视觉表现如下（来自文档的|pluginIcon|占位符所指向的插件图标 net.sf.openfx.Premult.png）：

[Source] ──► [Premult] ──► 预乘后的图像

为什么要做预乘：Natron 的预乘 Alpha 工作流

Natron 与 Nuke 一致，采用**预乘 Alpha（premultiplied alpha / associated alpha）**作为默认合成工作流。项目文档在 intro.rst 中明确说明：

Natron made the choice of using premultiplied alpha by default in the compositing workflow, like all modern compositing software, because images are stored internally with floating-point values.

原因在于：图像内部以浮点值存储，预乘后的 RGB 值在颜色校正、混合（Merge）、模糊（Blur）等运算中能保持正确的边缘半透明效果，避免出现"黑边/白边"（fringe）。因此 Premult 节点通常用于把非预乘素材（例如多数 3D 渲染器的直通输出）转换为 Natron 内部的预乘表示。

关键行为：未选通道时的"元数据直通"

文档强调了一个容易忽略的行为：

If no channel is selected, or the premultChannel is set to None, the image data is left untouched, but its premultiplication state is set to PreMultiplied.

即当By / premultChannel选择为None（对应选项0常量通道）时，Premult 节点不会修改任何像素数据，但会把输出的预乘状态（premultiplication state）标记为PreMultiplied。这在 Read 节点对素材预乘状态判断错误时非常有用——只需拖入一个 Premult 节点并保持默认参数，就能"纠正"下游节点的元数据认知，而不改变画面本身。

输入（Inputs）

Premult 节点只有一个输入：

输入必须连接，否则节点无法渲染。Source 输入通常来自 Read 节点、Merge 节点或其他任意上游节点。

控件参数详解（Controls）

下表完整列出 Premult 节点的全部控件，字段与文档 net.sf.openfx.Premult.rst 一致：

Plane /inputPlane：选择要预乘的平面

该参数决定"对哪个平面做预乘"。默认值为Color.RGBA，可选值如下：

• Color.RGBA（uk.co.thefoundry.OfxImagePlaneColour）：颜色平面，最常用；
• DisparityLeft.Disparity（uk.co.thefoundry.OfxImagePlaneStereoDisparityLeft）：左眼视差平面；
• DisparityRight.Disparity（uk.co.thefoundry.OfxImagePlaneStereoDisparityRight）：右眼视差平面；
• Backward.Motion（uk.co.thefoundry.OfxImagePlaneBackMotionVector）：向后运动矢量平面；
• Forward.Motion（uk.co.thefoundry.OfxImagePlaneForwardMotionVector）：向前运动矢量平面。

这些标识符对应 OFX 标准中的图像平面命名（uk.co.thefoundry.OfxImagePlane*），说明该节点支持对立体视差与运动矢量等**辅助平面（auxiliary plane）**执行预乘操作，而不仅限于颜色平面。

By /premultChannel：用作预乘依据的通道

该参数指定"乘以（或除以）哪一个通道"，默认Color.A（Alpha 通道），可选值：

• Color.R（uk.co.thefoundry.OfxImagePlaneColour.R）：取 Source 输入的 R 通道；
• Color.G（uk.co.thefoundry.OfxImagePlaneColour.G）：取 G 通道；
• Color.B（uk.co.thefoundry.OfxImagePlaneColour.B）：取 B 通道；
• Color.A（uk.co.thefoundry.OfxImagePlaneColour.A）：取 A 通道（默认）；
• 0：0 常量通道；
• 1：1 常量通道。

选择0常量通道时效果等同于"None"——不做任何像素修改，仅更新预乘状态元数据（见上文"关键行为"）。选择1则相当于"不改变数据但按常量 1 执行一次预乘运算"（数值上即像素保持不变）。在 Unpremult 节点 中该参数用于执行反预乘（unpremultiply），即把 RGB 除以该通道。

All Planes /processAllPlanes：全平面处理开关

默认Off。勾选后，输入中的所有平面都会被处理，并输出到与输入相同的平面。文档给出的典型用途示例：

It is useful for example to apply a Transform effect on all planes.

即当希望把某个变换（Transform）等效果应用到所有平面（而不只是颜色平面）时，可借助该选项保证视差、运动矢量等平面同样被正确处理，避免仅颜色平面被变换而辅助平面"掉队"。

Clip Info... /clipInfo：查看输入信息

按钮型参数，点击后弹出窗口显示当前输入（Source）的格式信息，用于排查输入分辨率、位深、通道布局与预乘状态等。它是 OFX 插件的通用诊断控件，本身不参与像素运算。

源码级原理：Premult 的像素运算

Premult 节点的核心算法在 Natron Engine 的Image类中实现，位于 Image.h 与 Image.cpp。

预乘/反预乘的模板实现

Image类声明了premultImage与unpremultImage两个公开方法（Image.h）：

void premultImage(const RectI& roi); // 预乘 void unpremultImage(const RectI& roi); // 反预乘

两者都基于模板函数premultForDepth（按位深分派），最终进入premultInternal<PIX, doPremult>模板。实际像素运算是逐像素、逐 RGB 通道执行的（Image.cpp）：

for (int c = 0; c < 3; ++c) { if (doPremult) { dstPix[c] = PIX(float(dstPix[c]) * dstPix[3]); // RGB = RGB × A } else { if (dstPix[3] != 0) { dstPix[c] = PIX( dstPix[c] / float(dstPix[3]) ); // RGB = RGB ÷ A } } }

即：

• 预乘（Premult）：RGB' = RGB × A，逐通道相乘；
• 反预乘（Unpremult）：RGB' = RGB ÷ A，且仅在A ≠ 0时执行除法，避免除零产生 NaN 或无穷值。

从代码可见，运算只修改前三个颜色通道，Alpha 通道本身保持不变；同时模板按像素类型PIX（如unsigned char、float、half）自动适配位深，浮点内部表示下不会引入量化误差。这也解释了 Natron 文档 intro.rst 所述"内部以浮点值存储"对预乘工作流的重要性。

预乘状态的枚举与元数据传播

Natron 在 Enums.h 中定义了三种预乘状态：

enum ImagePremultiplicationEnum { eImagePremultiplicationOpaque = 0, eImagePremultiplicationPremultiplied, eImagePremultiplicationUnPremultiplied, };

分别对应 OFX 标准中的三种图像预乘属性值。在 OFX 宿主适配层，Natron 将内部枚举映射为 OFX 字符串属性（OfxClipInstance.cpp）：

static const std::string prem(kOfxImagePreMultiplied); static const std::string unprem(kOfxImageUnPreMultiplied); static const std::string opq(kOfxImageOpaque);

并在每次向上游插件/下游节点传递图像时，把内部图像的预乘状态写入 OFX 属性kOfxImageEffectPropPreMultiplication（OfxClipInstance.cpp）：

ofxImageBase->setStringProperty( kOfxImageEffectPropPreMultiplication, OfxClipInstance::natronsPremultToOfxPremult( internalImage->getPremultiplication() ) );

因此，Premult 节点"不改像素只改状态"的行为在实现上就是：像素旁路（pass-through），但把输出图像的_premult成员置为eImagePremultiplicationPremultiplied。下游的 Merge、Viewer、Write 等节点会读取该状态来决定合成与输出方式。

状态标记的查看：Viewer 与 Checkerboard

在 ViewerGL.cpp 中，Viewer 的BlendSetter会根据图像的ImagePremultiplicationEnum选择 OpenGL 混合模式：预乘图像使用对应预乘混合因子，非预乘图像使用普通 Alpha 混合。这也是为什么"数据直通但状态翻转"的 Premult 节点会影响 Viewer 的棋盘格（checkerboard）显示结果。

Premult 与 Unpremult：一对互逆节点

Premult 的孪生节点是 Unpremult 节点（net.sf.openfx.Unpremult，版本同为 2.0）：

Divide the selected channels by alpha (or another channel)（将所选通道除以 Alpha，或其他任意通道。）

两者的参数表完全对称（inputPlane、premultChannel、processAllPlanes、clipInfo），差别仅在于一个是乘、一个是除：

在 Read 节点中，素材的预乘状态由 "Premultiplication" 设置决定（thenodes-image-read.rst）：

Natron can work in both modes (and switch from one to the other with Premult and Unpremult Nodes). For a video leave all this to opaque, for most photoshop like documents use "premultiplied" in all, for some 3D render passes you will switch both to "unpremultiplied".

如果 Read 节点对文件预乘状态的判断与实际情况不符（例如 3D 渲染器输出的是非预乘图像，而 Read 误判为预乘），可以在 Read 之后串联 Premult 或 Unpremult 节点进行显式修正。典型链路：

Read (非预乘素材) └──► Premult # RGB×A，标记为 PreMultiplied └──► Merge / Blur / Grade ...（内部预乘工作流）

输出时的预乘状态

Write 节点会根据节点树中预乘标记的处理情况自动推断输出文件的 "Input Premult" 值（thenodes-image-write.rst），因此只要在树中正确使用 Premult/Unpremult 维护好状态标记，输出文件就能正确记录预乘信息，避免写出黑边图像。

在 Natron 内置 Python 插件（PyPlugs）中的实际用法

Natron 自带的若干内置 Python 插件在内部直接创建net.sf.openfx.Premult节点，是观察其工程化用法的最佳示例。例如 DropShadow.py：

# Start of node "Premult1" lastNode = app.createNode("net.sf.openfx.Premult", 2, group) lastNode.setScriptName("Premult1") lastNode.setLabel("Premult1") # ... groupPremult1 = lastNode # End of node "Premult1" groupPremult1.connectInput(0, groupBlur1) # 对模糊后的 Alpha 通道执行预乘 groupMerge1.connectInput(0, groupPremult1)

同样的模式还出现在 Fill.py（对 Shuffle 输出的颜色执行预乘后再进 Merge）、LightWrap.py（对 Keyer 结果做预乘再参与合并）以及 PIKColor.py 中。可以看到，这些插件的共同套路是：先用 Shuffle / Keyer / Blur 等节点构造（可能为直通非预乘的）中间结果，再接一个 Premult 节点把颜色乘回 Alpha，最后才交给 Merge 参与合成——这正是预乘工作流的正确打开方式。

实战建议与注意事项

结合官方合成教程 tutorials-evaluating-script-structure.rst 中的警告，使用 Premult 节点时应注意：

1. 不要对预乘图像直接做颜色校正：Color correction should not be done on images that are premultiplied。需要调色时，应先加 Unpremult 节点还原直通色，再调色，最后重新 Premult（可用Premult → Unpremult → Grade → Premult三段式，或直接利用 Unpremult 节点）。
2. 避免重复预乘：Do not apply premultiplication twice in a row to the same image. It can damage the edges of the alpha。连续两次 Premult 会造成 RGB 数值被 A² 加权，破坏半透明边缘，务必在节点树中保持"预乘 ↔ 非预乘"状态清晰可查。
3. 利用"状态直通"技巧：当素材元数据预乘状态与真实数据不符、但你又不想改动像素时，直接串联一个 Premult 节点并保持premultChannel = 0（或默认的 A 与像素无关的场景），即可只修正状态标记。
4. 3D 渲染 pass 通常是非预乘：正如 thenodes-image-read.rst 所提示，多数软件输出预乘图像，但并非所有 3D 渲染器如此。从渲染器导出的 beauty pass 进入合成前，应根据其输出规范决定补 Premult 还是 Unpremult。
5. 保持与 Merge 的一致性：Natron 是预乘合成器（thenodes-merge-merge.rst），Merge 节点按预乘语义计算，任何送入 Merge 的颜色都应处于正确的预乘状态，否则会产生错误边缘。

小结

Premult 节点虽只有四个控件，却是 Natron 预乘 Alpha 工作流中承上启下的关键节点：它既能对任意平面（颜色、视差、运动矢量）执行RGB × A的像素级预乘，也能在数据不变的前提下仅翻转输出图像的预乘状态元数据。理解其参数（inputPlane、premultChannel、processAllPlanes）、底层模板实现（Image.cpp）以及状态枚举映射（Enums.h），即可在 Read、Merge、Write 与 PyPlugs 插件链路中正确维护预乘状态，避免黑边与边缘损伤。

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