Natron Color 节点组完全指南：色彩校正、OCIO 色彩管理与色彩空间转换

音视频视频处理图形学桌面应用【免费下载链接】NatronOpen-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点击查看免费下载导读本文以 Natron 官方文档中的 Color 节点组Documentation/source/_groupColor.rst为核心系统梳理该节点组内全部 52 个色彩相关节点的功能、参数与脚本名并结合 Engine/Settings.cpp 中的 OCIO 配置加载实现深入讲解 OpenColorIO 色彩管理在项目中的实际运行机制。读完本文你将掌握 Grade、ColorCorrect、OCIO 系列与各类色彩空间转换节点的选用思路并能依据脚本名在 PyPlug 或 Python 脚本中精准操控这些节点。Color 节点组是 Natron 中处理色彩校正、色彩匹配、色彩空间转换与显示管理的主要阵地。这些节点绝大部分来自 OpenFX 插件net.sf.openfx.*、fr.inria.openfx.*、net.sf.cimg.*既保留了 Nuke 系调色工具的使用习惯如 Grade 的黑白场重映射又引入了完整的 OpenColorIOOCIO色彩管理链fr.inria.openfx.OCIO*系列。同时Color 组也承担着将 RGB 与 HSV/HSL/HSI、YCbCr/YPbPr/YUV、XYZ/Lab/xyY 等模型相互转换的任务是搭建规范化调色流水线的基石。认识 Color 节点组如何访问 Color 节点组原文档明确指出节点组Node groups可通过两种方式访问点击左侧工具栏left toolbar中的分组按钮在 Node Graph节点图区域右键单击鼠标在弹出的菜单中浏览分组。在节点图空白处右键选择Color分组即可看到本文将要介绍的全部色彩类节点。Color 组与 Image、Draw、Time、Channel、Filter、Keyer、Merge、Transform、Views、Other、GMIC、Extra 等分组一同构成了完整的参考手册结构其索引位于 Documentation/source/_group.rst。文档的自动生成机制需要特别说明的是_groupColor.rst及其引用的插件文档首部都带有如下声明Do not edit this file! It is generated automatically by Natron itself.这意味着这些文档并非人工维护的静态文件而是由 Natron 依据插件内部注册的元数据节点描述、参数名称、类型、默认值与提示信息自动生成。因此文档中的“参数/脚本名”表格Parameter / script name与插件属性面板中显示的控件完全一一对应你可以放心地将表中列出的脚本名直接用于 PyPlug 的getParam(scriptName)调用或 Python 脚本赋值。色彩校正与基础运算节点这一类节点解决“如何调整一张图的明暗与色偏”的问题是日常合成中最常用的一批工具。Grade黑白场重映射与色彩匹配Gradenet.sf.openfx.GradePlugin版本 2.0用于修改图像从黑点到白点的色调分布tonal spread其核心公式如下A multiply * (white - black) / (whitepoint - blackpoint) B offset black - A * blackpoint output pow(A * input B, 1 / gamma)各参数与默认值参数中文/ 脚本名类型默认值功能Black Point /blackPointColorr:0 g:0 b:0 a:0图像中最暗像素的颜色White Point /whitePointColorr:1 g:1 b:1 a:1图像中最亮像素的颜色Lift /blackColorr:0 g:0 b:0 a:0对应 blackpoint 的颜色被设为该值Gain /whiteColorr:1 g:1 b:1 a:1对应 whitepoint 的颜色被设为该值Multiply /multiplyColorr:1 g:1 b:1 a:1乘以上述结果Offset /offsetColorr:0 g:0 b:0 a:0加在上述结果上对黑白同时生效Gamma /gammaColorr:1 g:1 b:1 a:1最终 gamma 校正负值不受 gamma 影响Normalize /normalizeButton—根据输入的最小/最大值自动设定黑白场Reverse /reverseBooleanOff反向应用校正Clamp Black /clampBlackBooleanOn输出低于 0 的颜色置 0Clamp White /clampWhiteBooleanOff输出高于 1 的颜色置 1(Un)premult /premultBooleanOff处理前除以 alpha、处理后重新乘回 alphaInvert Mask /maskInvertBooleanOff勾选后效果在 mask 为 0 处完全生效Mix /mixDouble1原图与变换结果的混合系数实战 1两图色彩匹配。Grade 可用来匹配两张图像的色彩先把目标图像的最暗点与最亮点分别用 blackpoint、whitepoint 归一为黑与白再通过 black暗部与 white亮部把这两个点映射到新位置如需进一步校正可叠加 multiply/offset/gamma。实战 2生成带软边的掩码。利用阈值化生成软边掩码将 Black Point 与 White Point 设为略低于、略高于阈值的数值并勾选 Clamp Black 与 Clamp White。若希望得到只含 0 和 1 的二值掩码则应改用 Clamp 节点详见下文。ColorCorrect分区阴影/中间调/高光校正ColorCorrectnet.sf.openfx.ColorCorrectPlugin版本 2.1可调整图像的饱和度、对比度、gamma、增益与偏移并将调整按 Shadows / Midtones / Highlights 三个区间分别进行区间范围由 “Ranges” 选项卡中的曲线控制。其对比度公式为Output (Input / 0.18) ^ Contrast * 0.18其主控Master参数与默认值如下另有 Shadows/Midtones/Highlights 三组同名参数各自带Enable开关默认 On参数 / 脚本名类型默认值Saturation /MasterSaturationColorr:1 g:1 b:1 a:1Contrast /MasterContrastColorr:1 g:1 b:1 a:1Gamma /MasterGammaColorr:1 g:1 b:1 a:1Gain /MasterGainColorr:1 g:1 b:1 a:1Offset /MasterOffsetColorr:0 g:0 b:0 a:0Range /rangeDoublemin:0 max:1Tone Ranges /toneRangesParametricShadow/Highlight 查找表Luminance Math /luminanceMathChoiceRec. 709Clamp Black /clampBlackBooleanOnClamp White /clampWhiteBooleanOff(Un)premult /premultBooleanOffInvert Mask /maskInvertBooleanOffMix /mixDouble1Gamma、Saturation 与基础数学运算Gammanet.sf.openfx.GammaPlugin版本 2.0对选中通道施加 gamma 函数实际函数为pow(x, 1/max(1e-8, value))。参数valueColor默认 r:1 g:1 b:1 a:1与invertBooleanOff反转 gamma 变换另有 premult / maskInvert / mix 通用参数。Saturationnet.sf.openfx.SaturationPlugin版本 2.0修改图像色彩饱和度。saturationDouble默认 1置 0 得到灰度图、luminanceMathChoice默认 Rec. 709详见下文、clampBlackOn/clampWhiteOff。Multiplynet.sf.openfx.MultiplyPlugin版本 2.0用常量乘选中通道value默认 r:1 g:1 b:1 a:1。Addnet.sf.openfx.AddPlugin版本 2.0向选中通道加常量value默认 r:0 g:0 b:0 a:0。Invertnet.sf.openfx.Invert版本 2.0反转选中通道无额外参数仅通用参数。Quantizenet.sf.openfx.Quantize版本 1.0降低每通道颜色级别数。colorsDouble默认 16、ditherChoice默认 None可选 Bayer 2x2/4x4/8x8、void-and-cluster 14x14/25x25、Random、seedInteger默认 2000仅随机抖动有效、staticSeedBooleanOff勾选后每帧抖动图案恒定。ClipTestnet.sf.openfx.ClipTestPlugin版本 2.0在超出指定范围的所有像素上绘制斑马纹zebra stripes用于检查裁切。lower默认 r:0 g:0 b:0 a:0upper默认 r:1 g:1 b:1 a:1。Clamp通道值钳制与二值掩码生成Clampnet.sf.openfx.Clamp版本 2.0将选中通道钳制在指定范围。其参数包含两套“钳制目标值”机制参数 / 脚本名类型默认值功能Minimum /minimumColorr:0 g:0 b:0 a:0低于该值的值被设为该值或 minClampToEnable Minimum /minimumEnableBooleanOn是否钳制最小值Maximum /maximumColorr:1 g:1 b:1 a:1高于该值的值被设为该值或 maxClampToEnable Maximum /maximumEnableBooleanOn是否钳制最大值MinClampTo /minClampToColorr:0 g:0 b:0 a:0启用后低于 minimum 的值被钳到该值设为自定义颜色可可视化被钳区域Enable MinClampTo /minClampToEnableBooleanOff开低于 minimum 的值→minClampTo关→minimumMaxClampTo /maxClampToColorr:1 g:1 b:1 a:1启用后高于 maximum 的值被钳到该值Enable MaxClampTo /maxClampToEnableBooleanOff开高于 maximum 的值→maxClampTo关→maximum实战生成二值掩码。文档给出了明确的阈值化配方假设希望所有大于等于某阈值 T 的像素变为 1、其余变为 0则将 “Minimum” 设为 T“Maximum” 设为任意严格小于 T 的值阈值非负时可取 0同时勾选 “Enable MinClampTo” 与 “Enable MaxClampTo”并保持 MinClampTo0.0与 MaxClampTo1.0默认值。输出即为二值掩码。若需要更柔和的非二值掩码可对 Clamp 输出做模糊或改用 Grade 的黑白场加 Clamp 方案。ColorMatrix4×4 矩阵运算ColorMatrixnet.sf.openfx.ColorMatrixPlugin版本 2.0用任意 4×4 矩阵乘 RGBA 通道。矩阵行分别由四个 Color 参数指定outputRed默认 r:1 g:0 b:0 a:0、outputGreenr:0 g:1 b:0 a:0、outputBluer:0 g:0 b:1 a:0、outputAlphar:0 g:0 b:0 a:1。修改这些颜色值即相当于编辑矩阵对应行的四个系数。ColorSuppress去除杂色与脱溢色despillColorSuppressnet.sf.openfx.ColorSuppress版本 1.0从图像中去除某种颜色或色偏可只修正颜色、也可把颜色量提取到 Alpha 通道用于修复 despill 或从颜色中提取掩码。参数redSuppress/greenSuppress/blueSuppress/cyanSuppress/magentaSuppress/yellowSuppressDouble默认 0各色相抑制比例、outputModeChoice默认 ImageImage / Alpha / Image and Alpha、preserveLumaBooleanOff保持亮度、luminanceMath默认 Rec. 709。通用控制参数premult、Mask、Mix除各节点专有参数外Color 组几乎所有节点都带一组通用控制(Un)premult /premult处理前把图像除以 alpha、处理后重新乘回。输入为预乘premultiplied图像时建议开启色彩转换类单向节点如 RGB→HSV则只提供 Unpremult 或 Premult 其中一种详见“色彩空间转换”一节。Invert Mask /maskInvert勾选后效果在 mask 为 0 处完全生效即反转掩码含义。Mix /mix原图与变换结果的混合系数1 表示完全采用变换结果0 表示原样输出。基于曲线的调色节点ColorLookup参数化查找曲线与色彩重映射ColorLookupnet.sf.openfx.ColorLookupPlugin版本 1.1施加参数化查找曲线且可单独调整各通道。主曲线master与红、绿、蓝曲线组合但不与 alpha 曲线组合。关键参数rangeDoublemin:0 max:1期望的输入值范围该范围内使用查找表加速计算输入超出 [0,1] 时建议设置。lookupTableParametricmaster/red/green/blue/alpha 五条曲线。backgroundDisplayChoice默认 Color Ramp曲线背景可显示 Color Ramp 或 RGB Histogram。updateHistogramButton从当前帧输入刷新直方图。source/targetColor默认 r:0 g:0 b:0 a:0新增曲线控制点的源/目标颜色。setMaster/setRGB/setRGBA/setAButton分别把 source→target 映射点加到主曲线 / RGB 三曲线 / RGBA 四曲线 / alpha 曲线。可反复添加多个点。masterCurveModeChoice默认 Standard主曲线算法包括Standard对 R、G、B 独立施曲线。文档特别指出其缺点例如用 S 形曲线增强对比度时红绿高而蓝低的橙色会偏向黄色。Weighted Standard限制 Standard 模式的色偏但无法完全消除。Film-Like结果与 Standard 高度相似对比度增强伴随强饱和提升但保持 RGB-HSV 色调恒定即色偏问题更少。该曲线由 Adobe 为 DNG 设计Adobe Camera Raw 与 Lightroom 均使用此类型。Luminance先算像素相对亮度对亮度值施曲线求出前后亮度倍率后均匀施加到各 RGB 分量因此色彩与饱和度保持稳定但增强对比的曲线仍可能轻微去饱和。luminanceMathChoice默认 Rec. 709仅被 Set Master 使用的亮度公式。实战镜头间色彩匹配与黑白渐变着色。通过设置 Source/Target 颜色并点击 “Set RGB” 或 “Set RGBA”即可把一张图的某个颜色精确重映射到目标颜色这对匹配两个镜头、或给黑白渐变添加自定义颜色非常实用。HueCorrect基于色相的曲线调色HueCorrectnet.sf.openfx.HueCorrect版本 2.0用查找曲线做“色相相关”的调整。先从源 RGB 计算色相与饱和度再按色相取值依次施加下列调整hue参数组Parametric 类型hue色相偏移sat饱和度增益最后施加lum亮度增益red/green/blue各通道增益r_sup红色抑制若 r min(g,b)则 r min(g,b) r_sup * (r - min(g,b))g_sup、b_sup同理sat_thrsh源饱和度低于该值时不施加 lum/red/green/blue 增益高于该值则渐进施加。其他参数huevshueBooleanOff显示 hue vs hue 调整专用曲线背景参考、luminanceMath默认 Rec. 709仅被 Set Master 使用、mixLuminanceEnableBooleanOn与mixLuminanceDouble0——用 “Luminance Mix” 参数可部分或完全恢复原始亮度亮度由 Luminance Math 参数计算。HSVTool色相/饱和度/亮度调整与色彩替换HSVToolnet.sf.openfx.HSVToolPlugin版本 1.0提供三类工作模式色彩替换Color replacement设置srcColor与dstColor替换范围由 Hue / Saturation / Brightness 三组参数决定。修改 srcColor 会自动重置色相/饱和度/亮度范围与默认渐变dstColor 应在 srcColor 之后设置它决定色相旋转与饱和度、亮度调整量。色彩调整Color adjust使用 Hue 的 Rotation 与 Saturation、Lightness 的 Adjustment配合 Range 与 falloff 参数实现更复杂的调整。色相键控Hue keyer将最后的outputAlpha参数设为 All默认 Hue在查看器中显示 Alpha 通道先设 Hue 参数组的 Range再依次收窄其他 Range 参数并配合 Falloff 与 Adjustment 微调。outputAlpha可选 Source / Hue / Saturation / Brightness / min(Hue,Saturation) / min(Hue,Brightness) / min(Saturation,Brightness) / min(all) 等输出非 Source 时输出自动非预乘。HSVTool 还提供分析矩形enableRectangle、bottomLeft默认 x:0.25 y:0.25、size默认 w:0.5 h:0.5、hidpi与setSrcFromRectangle按钮可从画面选区内自动分析并设置源颜色与范围。OCIO 系列节点OpenColorIO 色彩管理链OCIO 系列节点由fr.inria.openfx.OCIO*提供是 Natron 接入 OpenColorIO 行业色彩管理标准的主要途径。所有 OCIO 节点均共享ocioConfigFileOCIO 配置文件与 “OCIO config help…”ocioHelp按钮。OCIOColorSpace色彩空间转换OCIOColorSpacefr.inria.openfx.OCIOColorSpace版本 1.0使用 OpenColorIO 配置文件完成色彩空间转换。参数ocioConfigFile、ocioInputSpaceIndex输入色彩空间、ocioOutputSpaceIndex输出色彩空间、key1–key4与value1–value4OCIO Contexts键值对可用于对不同镜头应用特定 LUT 或调色、enableGPUBooleanOff启用基于 OpenGL 的 GPU 渲染仅在未勾选 premult 时可用及通用参数。OCIODisplay显示设备管理OCIODisplayfr.inria.openfx.OCIODisplay版本 1.0用 OpenColorIO 对图像序列施加色彩空间转换使其能准确显示在特定显示设备上。参数ocioConfigFile、ocioInputSpaceIndex、displayIndex显示设备、viewIndex视图变换、gainDouble默认 1在显示变换之前于场景线性域做曝光调整、gammaDouble默认 1显示变换之后的 gamma 校正、channelSelectorChoice默认 RGBRGB / R / G / B / A / Luminance、enableGPU、key1–value4等。OCIOCDLTransformASC CDL 调色OCIOCDLTransformfr.inria.openfx.OCIOCDLTransform版本 1.0用 OpenColorIO 施加 ASC Color Decision ListCDL调色每通道公式为out (in * slope offset) ^ power随后按标准 Rec.709 饱和度系数对全部通道施加饱和度luma 0.2126 * inR 0.7152 * inG 0.0722 * inB outR Clamp( luma sat * (inR - luma) ) outG Clamp( luma sat * (inG - luma) ) outB Clamp( luma sat * (inB - luma) )参数slopeColor默认 r:1 g:1 b:1、offsetColor默认 r:0 g:0 b:0、powerColor默认 r:1 g:1 b:1、saturationDouble默认 1、directionChoiceForward/Inverse、readFromFileBooleanOff、file.cc 或 .ccc 文件.ccc 时需 cccId、reloadButton、cccIdString.ccc 中查找的 id、export导出为 .cc XML可被 OCIOFileTransform 或 OCIO 配置中的 FileTransform 加载文件必须尚不存在、enableGPU及通用参数。OCIOFileTransform从文件加载变换OCIOFileTransformfr.inria.openfx.OCIOFileTransform版本 1.0从文件加载变换并施加通常是 1D/3D LUT也可以是 ASC ColorCorrection XML 等。注意文件变换不附带任何输入/输出色彩空间处理——若文件期望对数编码像素却对线性图像施加将得到错误结果。支持格式包括.3dlflame/lustre、.cc、.ccc、.cdl、.clfAcademy/ASC Common LUT Format、.ctf、.cspcinespace、.lutDiscreet/houdini、.icc、.icm、.pf、.cubeiridas_cube / resolve_cube、.itx、.look、.mga、.m3d、.spi1d、.spi3d、.spimtx、.cubtruelight、.vfnukevf。参数file、reload、directionForward/Inverse、interpolationChoice默认 LinearNearest / Linear / Tetrahedral / Best非 LUT 文件忽略、enableGPU及通用参数。OCIOLogConvert场景线性与合成对数互转OCIOLogConvertfr.inria.openfx.OCIOLogConvert版本 1.0用 OpenColorIO 在 SCENE_LINEAR 与 COMPOSITING_LOG 之间转换Lin 与 Log 分别对应 OCIO 配置中的两个 profile。参数ocioConfigFile、ocioHelp、operationChoice默认 Log to Linlog2lin / lin2log、enableGPU及通用参数。OCIOLookTransform创意调色LookOCIOLookTransformfr.inria.openfx.OCIOLookTransform版本 1.0施加 OCIO 中预定义的 “look”——一种具名的创意性色彩变换区别于技术/数学定义的色彩空间。典型用途VFX 前施加的中性调色或导演决定的逐镜头 DI 调色在视图变换前施加。Look 必须在 OCIO 配置中预先定义常引用逐镜头/序列的 LUT 或 CC。参数ocioConfigFile、ocioInputSpaceIndex、singleLookBooleanOn勾选只施加单个 Look、lookChoice默认 “Filmic - Very High Contrast”可选 Filmic 系列、Agfa/Kodak 胶片模拟系列等、appendButton把选中 Look 追加到组合、lookCombinationStringLook 语法多个 Look 用逗号组合firstlook, secondlook方向用 /- 前缀firstlook, -secondlook缺失 fallback 用|指定如firstlook, -secondlook | -secondlook、directionForward/Inverse、ocioOutputSpaceIndex、key1–value4、enableGPU及通用参数。OCIO 配置的加载机制源码级解析从 Engine/Settings.cpp 的Settings::tryLoadOpenColorIOConfig()可以看到 Natron 加载 OCIO 配置的完整优先级OCIO环境变量优先QString configFile QFile::decodeName( qgetenv(NATRON_OCIO_ENV_VAR_NAME) )环境变量指定的配置文件优先于一切对应文档 Documentation/source/_environment.rst 中 “OCIO: This variable can be used to point to the global OpenColorIO config file … it supersedes the OpenColorIO setting in Natrons preferences”若环境变量为空则尝试偏好设置里的自定义配置文件Custom OpenColorIO configuration file若仍为空则从偏好设置的_ocioConfigKnob下拉项读取默认配置名为blenderNATRON_DEFAULT_OCIO_CONFIG_NAME再在默认配置目录如/usr/share/OpenColorIO-Configs、binary/../share/OpenColorIO-Configs、binary/../Resources/OpenColorIO-Configs中查找configName.ocio或configName/config.ocio最终通过qputenv(NATRON_OCIO_ENV_VAR_NAME, stdConfigFile)写入OCIO环境变量并调用appPTR-onOCIOConfigPathChanged(configPath)通知全局配置路径变化。因此若希望全局统一色彩管理可直接设置环境变量export OCIO/path/to/your/config.ocioNatron 偏好设置中还提供 “Warn on OpenColorIO config change”warnOCIOChanged与 “Warn on startup if OpenColorIO config is not the default”startupCheckOCIO两个提示开关。另请注意仓库根目录的 OpenColorIO-Configs-README.md 说明默认 OpenColorIO 配置需按 INSTALL 文件指示下载并解压到源码树根目录例如curl -k -L https://github.com/NatronGitHub/OpenColorIO-Configs/archive/Natron-v2.4.tar.gz | tar zxf -后重命名为OpenColorIO-Configs否则 OCIO 节点无默认配置可用。色彩空间转换节点Color 组包含一整套色彩模型互转节点大多只带一个premult类型参数从 RGB 出发的转换提供 Unpremult处理前除 alpha回到 RGB 的转换提供 Premult处理后乘 alpha得到预乘输出。RGB ↔ HSV / HSL / HSIRGBToHSV / RGBToHSL / RGBToHSInet.sf.openfx.RGBToHSV、RGBToHSL、RGBToHSI版本 1.0分别转换为 HSVA. R. Smith1978、HSLJoblove Greenberg1978、HSIGonzalez Woods1992。H 单位为度S/V/L/I 与 RGB 同单位转换前对 RGB 不做 gamma 校正。HSVToRGB / HSLToRGB / HSIToRGB版本 1.0逆向转换转换后同样不做 gamma 校正。文档对 HSI 空间有专门说明I 轴代表亮度信息H 与 S 是在垂直于 I 的平面上的极坐标红 0°、绿 120°、蓝 240°S 表示颜色向量在该平面投影的幅值即鲜艳程度主要缺点在于饱和度为零时色相无定义。文档同时提醒HSI 并非“感知均匀”色彩空间CIE-LAB 与 CIE-LUV 才是感知均匀性的代表尝试。RGB ↔ YCbCr / YPbPr / YUV601 / 709这些节点成对出现共 12 个RGBToYCbCr601、RGBToYCbCr709、YCbCrToRGB601、YCbCrToRGB709、RGBToYPbPr601、RGBToYPbPr709、YPbPrToRGB601、YPbPrToRGB709、RGBToYUV601、RGBToYUV709、YUVToRGB601、YUVToRGB709均为版本 1.0。方向性描述从 RGB 出发的节点如 RGBToYCbCr601先使用 OETF 对 RGB 做 gamma 压缩再转换——601 系使用 sRGB OETF709 系使用 Rec.709 OETF回到 RGB 的节点如 YCbCrToRGB709转换后使用 EOTF 对 RGB 做 gamma 解压——601 系使用 sRGB EOTF709 系使用 Rec.709 EOTF。由此可知Natron 的 YCbCr/YPbPr/YUV 节点族默认假设源/目标为“线性”RGB 场景并自带 OETF/EOTF 编解码。RGB ↔ XYZ ↔ Lab ↔ xyYRGB709ToXYZ / XYZToRGB709版本 1.0RGB 使用 Rec.709 色域 D65 白点X、Y、Z 与 RGB 同单位。RGB709ToLab / LabToRGB709版本 1.0L*a*b 坐标除以 100 以便可视化。XYZToLab / LabToXYZ版本 1.0CIE XYZ 与 CIE L*a*b 互转L*a*b 同样除以 100。XYZToxyY / xyYToXYZ版本 1.0CIE XYZ 与 CIE xyY 互转。VectorToColor矢量可视化VectorToColornet.sf.openfx.VectorToColorPlugin版本 1.0把 x、y 矢量分量编码为颜色表示H色相给出方向S饱和度设为幅度/范数V 为 1S 与 V 的角色可互换输出可为 RGB 或 HSVH 用度。参数xChannelChoice默认 rr/g/b/a 四选一、yChannel默认 g、oppositeBooleanOff使用 X、Y 的相反值、inverseYBooleanOn默认反转 Y——因为多数光流结果显示使用向下 Y 轴、modulateVBooleanOff用矢量幅度调制 V 而非 S、hsvOutputBooleanOff。常用于把光流/运动矢量可视化。对数/线性转换节点Log2Linnet.sf.openfx.Log2Lin版本 1.0在 Cineon 文件使用的对数编码与线性编码之间转换可自定义参数而不使用 Kodak 推荐设置。参数operationChoice默认 Log to Linlog2lin / lin2log分别用于 Read 节点之后与 Write 节点之前、blackColor默认 r:95 g:95 b:95Cineon 文件中对应黑的值、whiteColor默认 r:685 g:685 b:685对应白的值、gammaColor默认 r:0.6 g:0.6 b:0.6胶片响应 gamma。PLogLinnet.sf.openfx.PLogLin版本 1.0对数与线性互转采用 “Josh Pines log conversion”即 printing density transform基于单一灰点而非 Cineon 公式的白黑点。公式Log to Lin: xLin linRef * pow( 10.0, (xLog * 1023. - logRef) * density / nGamma ) Lin to Log: xLog (logRef log10( max( xLin, 1e-10 ) / linRef ) * nGamma / density) / 1023.参数operation默认 Log to Lin、linRefColor默认 r:0.18 g:0.18 b:0.18参考灰点的线性值、logRefColor默认 r:445 g:445 b:445参考灰点的对数值、nGammaColor默认 r:0.6 g:0.6 b:0.6胶片响应 gamma、densityColor默认 r:0.002 g:0.002 b:0.002每个对数码值的密度即负片 gamma 随对数码值的变化率通常保持默认 0.002。两者对比Log2Lin 基于 Cineon 白/黑点PLogLin 基于单一灰点print density模型适合 Cineon 之外的扫描件或需按灰点对齐的场景。直方图均衡化节点Equalizenet.sf.cimg.CImgEqualize版本 2.0均衡像素值直方图使用 CImg 库的equalize函数。参数nb_levelsInteger默认 4096直方图级别数、min_valueDouble默认 0低于该值的像素不计入直方图、max_valueDouble默认 1高于该值的像素不计入直方图。文档提示仅均衡图像亮度时改用 HistEQ。HistEQnet.sf.cimg.CImgHistEQ版本 2.0均衡亮度直方图对图像 HSV 分解后的 V 通道施加 CImg 的equalize函数。参数仅nb_levels默认 4096与通用参数。两个 CImg 节点文档均注明 CImg 是免费开源库采用 CeCILL-C近似 GNU LGPL或 CeCILL兼容 GNU GPL许可证可用于商业应用。实战工作流建议完整调色链路示例一个典型的 Natron 调色链可这样组织Read 之后若素材为对数编码先接 Log2Lin或 PLogLin转为线性或接 OCIOLogConvert / OCIOColorSpace 按 OCIO 配置完成色彩空间转换技术校正用 ColorCorrect 分区阴影/中间调/高光做一级校色或直接用 Grade 做黑白场重映射与镜头匹配创意调色用 ColorLookupMaster Curve Mode 可选 Film-Like / Luminance、HueCorrect、HSVTool色彩替换或 OCIOLookTransform 施加风格显示预览在 Viewer 前接 OCIODisplay选择显示设备与视图变换并在其 Gain场景线性域曝光与 Gamma显示变换后上微调输出前若需写回对数/视频编码接相应的 Log2Lin/PLogLinlin2log或色彩空间转换节点质量检查用 ClipTest 的斑马纹快速定位超出范围低于 lower、高于 upper的像素用 Quantize 预演色阶缩减效果配合 dither 抑制条带。掩码生成组合拳需要硬边二值掩码用 Clamp阈值配方见上文需要软边掩码用 Grade 黑白场 Clamp Black/White或对 Clamp 输出做模糊需要按色相提取掩码用 HSVTool 的 Hue keyer 模式outputAlpha 设为 All配合 Range/Falloff或 ColorSuppress 的 Alpha 输出模式。在脚本中使用脚本名由于文档表格中的脚本名与属性面板一一对应可放心在 PyPlug 或 Python 中引用例如grade app.createNode(net.sf.openfx.GradePlugin) grade.getParam(blackPoint).set(0.0, 0.0, 0.0, 1.0) grade.getParam(clampWhite).set(True)参考资料Color 节点组索引Documentation/source/_groupColor.rst参考手册总索引含节点组、偏好设置、环境变量章节Documentation/source/_group.rst环境变量说明含OCIO、OFX_PLUGIN_PATH、NATRON_PLUGIN_PATH等Documentation/source/_environment.rstOCIO 配置加载实现Engine/Settings.cppOpenColorIO 默认配置安装说明OpenColorIO-Configs-README.md各插件详细文档目录Documentation/source/plugins本文涉及的全部参数名、默认值与公式均取自上述文档与源码可直接作为选用节点、编写脚本时的参考依据。赞分享音视频视频处理图形学桌面应用【免费下载链接】NatronOpen-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点击查看免费下载相关推荐libvips 色彩空间完全指南色彩转换、色差计算与 ICC 色彩管理libvips 色彩空间完全指南色彩转换、色差计算与 ICC 色彩管理 libvips 的 colour 模块 libvips/colour/ https:图像处理GTM节点在TBase中的关键作用全局事务管理机制详解GTM节点在TBase中的关键作用全局事务管理机制详解 TBase作为企业级分布式HTAP数据库通过单一集群同时提供高一致性的分布式数据库服务和高性能数据仓Sunshine色彩空间HDR色彩管理Sunshine色彩空间HDR色彩管理 引言游戏串流的新视觉革命 你还在为游戏串流时的色彩失真而烦恼吗是否曾经在享受HDRHigh Dynamic Ra音视频后端创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考