Godot 可视化着色器中的导数节点 VisualShaderNodeDerivativeFunc 完全指南

原创2026-10-13 17:39:461,987 阅读
文章标签:文档教程游戏开发

Godot 可视化着色器中的导数节点 VisualShaderNodeDerivativeFunc 完全指南

本文围绕 Godot 引擎官方文档中 VisualShaderNodeDerivativeFunc 类参考(classes/class_visualshadernoderivativefunc.rst)展开,系统讲解可视化着色器(VisualShader)中"导数计算"节点的用法、三个核心属性、三种枚举语义,以及它与文本着色器中 dFdx / dFdy / fwidth 系列函数的对应关系。读完本文,你将能准确理解该节点的每个配置项,在 Fragment / Light 可视化着色器中正确接入它,并掌握精度(Precision)、操作类型(OpType)与函数模式(Function)对渲染结果和性能的实际影响。

节点概览:在可视化着色器图中计算导数

VisualShaderNodeDerivativeFunc 是 Godot 可视化着色器节点体系中的一员,其作用是在着色器图(shader graph)中计算某个表达式的导数(derivative)。在图形渲染中,导数常被用于抗锯齿(如边缘羽化)、法线扰动、视差与曲面细分相关的近似计算等场合。

它的类继承关系如下(与文档 VisualShaderNode 一致):

VisualShaderNodeDerivativeFunc
  < VisualShaderNode
    < Resource
      < RefCounted
        < Object

重要限制:该节点只能在 Fragment(片元)和 Light(光照)两种可视化着色器中使用。这与其底层原理一致——导数函数依赖片元之间的相邻采样,而片元着色器才具备这一上下文。当你把 Shader 编辑器顶部的着色器类型切换为 Vertex 时,该节点不会出现在可用节点列表中。

三个属性:决定"怎么算、算什么、多精细"

该节点在检查器(Inspector)中暴露三个属性,默认值均为 0,分别对应三个枚举:

属性 类型 默认值 作用
function Function 0(FUNC_SUM) 选择导数函数类型:按 x 求导、按 y 求导,或 x/y 绝对值之和
op_type OpType 0(OP_TYPE_SCALAR) 指定操作数及返回值的类型(标量 / 2D / 3D / 4D 向量)
precision Precision 0(PRECISION_NONE) 指定导数计算的精度等级(自动 / 粗粒度 / 细粒度)

这三个属性对应代码层分别由 set_function / get_function、set_op_type / get_op_type、set_precision / get_precision 六对方法读写。

function:选择导数函数类型

function 决定节点执行哪种导数运算,枚举定义如下:

常量 值 说明 文本着色器对应
FUNC_SUM 0 x 与 y 方向绝对导数之和 fwidth()
FUNC_X 1 沿窗口 x 坐标、基于局部差分的导数 dFdx()
FUNC_Y 2 沿窗口 y 坐标、基于局部差分的导数 dFdy()
FUNC_MAX 3 表示 Function 枚举大小,仅作边界用途 —

其中 FUNC_SUM 的计算语义等价于 abs(dFdx(p)) + abs(dFdy(p)),即文本着色器中的 fwidth() 函数(参见 shader_functions.rst 的 fwidth 条目)。FUNC_SUM 常被用来估算相邻片元之间某值的变化幅度,例如以 fwidth(UV) 为依据生成与屏幕分辨率自适应的抗锯齿边缘宽度。

op_type:决定操作数与返回值的类型

op_type 决定节点的输入数据类型和输出类型:

常量 值 说明
OP_TYPE_SCALAR 0 浮点标量
OP_TYPE_VECTOR_2D 1 2D 向量(vec2)
OP_TYPE_VECTOR_3D 2 3D 向量(vec3)
OP_TYPE_VECTOR_4D 3 4D 向量(vec4)
OP_TYPE_MAX 4 表示 OpType 枚举大小,仅作边界用途

文本着色器中 dFdx / dFdy / fwidth 均可接受 vec_type(浮点标量或向量)作为参数并返回同类型结果(shader_functions.rst),因此可视化节点也以 op_type 模拟出同样的标量 / 向量多态性。设置 op_type 后,节点的输入、输出端口类型会随之改变——例如设为 OP_TYPE_VECTOR_3D 时,输入输出端口均为 3D 向量端口。

precision:控制导数计算的精度等级

precision 是 Godot 4 新增的粒度控制选项,用于在性能与精度之间权衡:

常量 值 说明 文本着色器对应
PRECISION_NONE 0 不指定精度,由 GPU 驱动自行决定采用何种精度等级;默认选项 dFdx() / dFdy()
PRECISION_COARSE 1 基于当前片元的邻居(可能不包含当前片元本身)计算;通常比 FINE 快,但在需要更高精度时可能不适用 dFdxCoarse() / dFdyCoarse()
PRECISION_FINE 2 基于当前片元及其直接邻居计算;通常比 COARSE 慢,但在需要更高精度时是必要的 dFdxFine() / dFdyFine()
PRECISION_MAX 3 表示 Precision 枚举大小,仅作边界用途 —

关键限制:当使用 Compatibility 渲染器时,precision 设置不生效(该属性描述中明确注明 "When using the Compatibility renderer, this setting has no effect")。这与文本着色器函数参考中的说明互相印证:dFdxCoarse / dFdxFine / dFdyCoarse / dFdyFine / fwidthCoarse / fwidthFine 在 Godot 文档中均标注 "Not available when using the Compatibility renderer"(参见 shader_functions.rst 等条目)。因此,如果你的项目运行在 Compatibility 渲染器(如部分 Web 平台或老旧设备)上,该属性不会产生实际差异。

在可视化着色器编辑器中的接入方式

在 Godot 编辑器中接入该节点的典型流程如下:

  1. 创建一个 ShaderMaterial,为其 Shader 属性新建一个 VisualShader 类型的 Shader 资源(创建方法详见 visual_shaders.rst)。
  2. 打开 Shader 编辑器,将顶部下拉菜单中的着色器类型切换为 Fragment 或 Light——这是该节点可用的前提。
  3. 点击 Add Node 按钮或在图区右键,在弹出的节点分类菜单中,从导数相关分类下找到 DerivativeFunc 节点并添加。
  4. 将任意连续信号的输出连接到该节点的输入端口(如 UV、纹理采样结果、法线等),再把它的输出接入后续节点或输出节点的对应插座。
  5. 在检查器中按需调整 function、op_type 与 precision 三个属性。

一个典型的应用场景是边缘检测与抗锯齿:将 UV 坐标或某个标量信号接入 FUNC_SUM 模式,利用其"x、y 方向绝对导数之和"来度量相邻片元间信号的变化剧烈程度,再配合 SmoothStep 等节点把变化剧烈的区域压成一条窄带,即可实现分辨率自适应的描边或边缘淡化效果。

原理与使用边界:从文本着色器函数看底层行为

该节点在底层编译生成的就是 Godot Shading Language 中的导数函数调用。理解文本着色器中对应函数的语义,有助于避免误用:

  • 局部差分(local differencing):dFdx(p) 返回 p 相对于窗口 x 坐标的偏导数,dFdy(p) 相对于窗口 y 坐标,二者均使用局部差分计算(shader_functions.rst)。
  • 自动粒度:不带精度的 dFdx() / dFdy() 会根据性能因素或 GL_FRAGMENT_SHADER_DERIVATIVE_HINT 提示,自行选择返回 coarse 或 fine 的变体(见上表 PRECISION_NONE 的说明)。可视化节点中 precision 属性正是对同一机制的手动覆盖。
  • 连续性假设:导数计算假定输入表达式 p 是连续的,因此经由非均匀控制流(non-uniform control flow)求值的表达式可能产生未定义结果。在可视化图中,这提醒你不要在分支不统一地影响输入信号的前提下对结果求导。
  • 高阶导数未定义:隐含高阶导数的表达式,如 dFdx(dFdx(n)),以及混合阶导数如 dFdx(dFdy(n)),其结果未定义(shader_functions.rst)。同理,在可视化图中不要把本节点的输出再接入另一个导数节点做嵌套求导。

版本迁移备忘:Godot 4 中的节点合并

如果你从 Godot 3 迁移到 Godot 4,需要留意命名变化:Godot 3 中的 VisualShaderNodeScalarDerivativeFunc 与 VisualShaderNodeVectorDerivativeFunc 两个节点,在 Godot 4 中已合并为同一个 VisualShaderNodeDerivativeFunc,标量与向量形态的区别由新节点内部的 op_type 属性取代(参见 upgrading_to_godot_4.rst 的节点重命名对照表)。也就是说,升级后的旧图会自动映射到新节点,而新节点不再区分"标量版 / 向量版",通过一个属性即可覆盖全部 4 种数据类型。

小结

VisualShaderNodeDerivativeFunc 是可视化着色器图与文本着色器导数能力之间的桥梁:

  • 仅在 Fragment / Light 着色器中可用;
  • 用 function 选择 FUNC_SUM / FUNC_X / FUNC_Y,分别对应 fwidth / dFdx / dFdy;
  • 用 op_type 覆盖标量到 4D 向量的 4 种数据类型;
  • 用 precision 在 PRECISION_NONE / PRECISION_COARSE / PRECISION_FINE 之间权衡速度与精度,但在 Compatibility 渲染器下不生效;
  • 使用时须遵守"输入必须连续、禁止嵌套高阶求导"的约束,并通过 function、op_type、precision 三者的组合适配具体效果。

如需继续深入,可阅读仓库中的 可视化着色器入门教程、文本着色器函数完整参考 以及基类 VisualShaderNode 类参考,它们能帮助你理解节点端口类型、图结构组织与所有内置着色器函数的具体语义。

登录后查看全文
godot-docs