Godot 视觉着色器 FloatConstant 节点完全指南:VisualShaderNodeFloatConstant 浮点常量详解
Godot 视觉着色器 FloatConstant 节点完全指南:VisualShaderNodeFloatConstant 浮点常量详解
导读
VisualShaderNodeFloatConstant 是 Godot 引擎视觉着色器(VisualShader)图形中用于提供标量浮点常量的基础节点。它只有一个输出端口、没有输入端口,作用相当于在着色语言中直接写下一个 float 字面量,是搭建一切数值计算图时最常用、最底层的"数据源"之一。阅读本文后,你将掌握该节点的继承体系、核心属性 constant 的读写方式、在 Shader Editor 中的实际操作步骤、它最终被翻译成的着色代码形态,以及它与整数、布尔、向量、颜色等兄弟常量节点的选型对比。
节点定位:视觉着色器图里的"数字之源"
在 Godot 的视觉着色器体系中,VisualShaderNodeFloatConstant 属于常量(Constant)节点家族,其完整继承链为:
VisualShaderNodeFloatConstant
└── VisualShaderNodeConstant (常量基类,抽象类)
└── VisualShaderNode (所有视觉着色器节点的基类)
└── Resource
└── RefCounted
└── Object
这条继承链在 类参考文档 和 VisualShaderNodeConstant 基类文档 中均有明确记录。值得注意的是,VisualShaderNode 本身是一种 Resource 而非场景节点,正如 其类参考 开头特别强调的:"Base class for VisualShader nodes. Not related to scene nodes." 每个图节点都是独立封装的资源对象,以矩形框形式呈现,并通过端口与其他节点相连以控制着色流程。
从整个常量家族看,VisualShaderNodeConstant 是抽象基类,它派生出的兄弟节点包括:
VisualShaderNodeBooleanConstant(布尔常量)VisualShaderNodeFloatConstant(浮点常量,本文主角)VisualShaderNodeIntConstant(有符号整数常量)VisualShaderNodeUIntConstant(无符号整数常量)VisualShaderNodeVec2Constant/Vec3Constant/Vec4Constant(2/3/4 维向量常量)VisualShaderNodeColorConstant(颜色常量)VisualShaderNodeTransformConstant(变换矩阵常量)
可见,不同数值类型各有一个专属常量节点,FloatConstant 专门负责 float(32 位浮点标量)这一类。
核心属性:constant 与 set/get 访问器
VisualShaderNodeFloatConstant 的全部状态收敛于唯一一个属性:
| 类型 | 属性名 | 默认值 | 说明 |
|---|---|---|---|
float |
constant |
0.0 |
该节点所代表的浮点常量值 |
对应的访问器方法(可在 GDScript / C# 脚本中调用,也可以从编辑器检查器(Inspector)中修改):
set_constant(value: float)— 设置常量值get_constant() -> float— 获取当前常量值
在 GDScript 中,如果你通过脚本创建并配置这样一个节点(例如配合 VisualShader.add_node() 动态构建着色器图),可以这样写:
var node := VisualShaderNodeFloatConstant.new()
node.constant = 0.75
print(node.get_constant()) # 输出 0.75
var shader := VisualShader.new()
shader.add_node(VisualShader.TYPE_FRAGMENT, node, Vector2(200, 200))
这里使用的 add_node() 正是 VisualShader 类文档 中记载的图构建接口(签名 add_node(type, node, position, id))。相比在编辑器中手拖节点,脚本方式更利于程序化批量生成着色器。
端口形态:零输入、单标量输出
依据 视觉着色器教程 中关于节点接口的说明,所有视觉着色器节点的输入端口位于左侧、输出端口位于右侧,端口颜色标识数据类型。FloatConstant 没有输入端口,仅有一个 标量(Scalar)输出端口:
标量端口以灰色显示,代表"单个数值"(对应 float)。这在端口类型枚举(VisualShaderNode 类参考 中的 PortType 枚举)中与 PORT_TYPE_SCALAR = 0 一一对应——该枚举明确注明"Floating-point scalar. Translated to float type in shader code.",即标量端口在生成着色代码时就是 float 类型。
连接规则同样值得注意(见 视觉着色器教程):
- 把标量输出连到 向量输入 时,向量的所有分量都会取该标量的值(广播语义);
- 把向量输出连到 标量输入 时,标量取向量各分量的平均值。
这意味着一个 FloatConstant(如 0.5)可以直接喂给 vec3 类型的输入端口(等价于 vec3(0.5)),这是做全局缩放、统一偏移时的高频用法。
在 Shader Editor 中的实际操作
创建与配置
- 为任意对象创建
ShaderMaterial并在其Shader属性中新建Shader资源,在 Create Shader 对话框中将类型切换为VisualShader(详细流程见 视觉着色器教程)。 - 打开 Shader Editor,在图表空白处右键弹出 Add Node 菜单(或点击左上角
Add Node按钮)。 - 在节点列表中找到 Constant → Float(常量分类下的浮点项),点击或拖入图中。
- 选中节点后,在右侧 Inspector 中修改 constant 属性即可实时改变数值;修改会立即作用到材质预览上。
节点默认值
新建的 FloatConstant 节点默认值为 0.0,这与类文档中属性默认值一致。你可以将其改为任意合法浮点数,包括负数和带小数的精度值,例如 -1.0、0.3333、3.14159 等。
生成的着色代码:一切回到 float 字面量
Godot 的视觉着色器图在后台会被转换为文本形式的着色器脚本——这一点在 视觉着色器教程 中有明确说明,并且你可以通过编辑器工具栏中的"显示生成的代码(Show generated code)"按钮查看对应代码,方便理解每个节点究竟做了什么。
对于 FloatConstant 节点,其行为在 类参考文档 中被一句话概括:
"Translated to
floatin the shader language."(在着色语言中被翻译为float)
也就是说,图中一个值为 0.5 的浮点常量节点,最终会在生成的 GLSL 风格的着色代码中体现为类似下面的片段:
// 伪代码示意:constant 节点在生成代码中的体现
float _float_constant_0 = 0.5;
根据 着色语言参考,float 是 32 位浮点标量,且 Godot 着色语言与 GLSL ES 3.0 高度兼容。需要留意的是,着色语言不允许隐式类型转换:float a = 2; 是非法写法,必须写成 float a = 2.0; 或 float(2)。因此,在视觉着色器图中若要得到一个精确的浮点常量,使用 FloatConstant 而非 IntConstant 才是正确做法——这从语言层面解释了为什么需要区分整数与浮点两类常量节点。
常量节点家族选型对照
不同的数据类型对应不同的常量节点,选型依据是你需要注入到图中的数据形态:
| 节点 | 数据类型(GDScript) | 生成着色类型 | 默认值 |
|---|---|---|---|
VisualShaderNodeFloatConstant |
float |
float |
0.0 |
VisualShaderNodeIntConstant |
int |
int |
0 |
VisualShaderNodeUIntConstant |
uint |
uint |
0 |
VisualShaderNodeBooleanConstant |
bool |
bool |
false |
VisualShaderNodeVec2Constant |
Vector2 |
vec2 |
Vector2(0, 0) |
VisualShaderNodeVec3Constant |
Vector3 |
vec3 |
Vector3(0, 0, 0) |
VisualShaderNodeVec4Constant |
Vector4 |
vec4 |
— |
VisualShaderNodeTransformConstant |
Transform3D |
mat4 |
— |
VisualShaderNodeColorConstant |
Color |
vec3 + float |
Color(1, 1, 1, 1) |
上表中已确认的数据来自各节点的类参考(IntConstant、BooleanConstant、Vec2Constant、Vec3Constant、ColorConstant);vec4/mat4 的类型映射则可在 VisualShaderNode 的 PortType 枚举 中找到依据(PORT_TYPE_VECTOR_4D → vec4、PORT_TYPE_TRANSFORM → mat4)。其中 ColorConstant 比较特殊,它拥有 RGB 与 Alpha 两个输出端口,分别翻译为 vec3 rgb 和 float alpha——注意 Alpha 通道本身就是浮点标量,与 FloatConstant 的输出类型一致,可直接互连。
选型建议:需要精确的浮点数值(如 UV 缩放、时间系数、透明度阈值、半径等)时使用 FloatConstant;需要整数索引、循环计数或数组下标时使用 IntConstant;需要开/关开关时使用 BooleanConstant;需要颜色时优先使用 ColorConstant(它自带调色盘界面,比手动填三个 FloatConstant 更直观)。
实战组合:浮点常量如何驱动着色计算
浮点常量节点的价值在于作为数值种子参与运算。它常与以下两类节点配合:
与浮点运算节点(FloatOp)配合
VisualShaderNodeFloatOp 接收两个浮点输入 a、b,执行 OP_ADD(a + b)、OP_MUL(a * b)、OP_POW(pow(a, b))、OP_MIN/OP_MAX、OP_STEP 等运算。例如:
- 两个
FloatConstant(0.5与0.25)→FloatOp(OP_ADD)→ 输出0.75; - 一个
FloatConstant(如2.0)+ 时间输入 →FloatOp(OP_MUL)→ 实现速度加倍的动画; - 用
FloatConstant提供step的边沿值,配合FloatOp(OP_STEP)生成二值化效果。
与浮点函数节点(FloatFunc)配合
VisualShaderNodeFloatFunc 对单个标量输入施加数学函数,包括 sin(x)、cos(x)、abs(x)、floor(x)、saturate(x)(钳制到 0.0~1.0)、radians(x)/degrees(x) 等。用 FloatConstant 固定函数输入(如一个固定角度),即可得到确定性的函数输出;再与 UV、法线等向量数据组合,常用于制作呼吸光、边缘光(配合 Fresnel)等效果。
控制 Albedo、透明度等内置槽位
把 FloatConstant 直接接到 Fragment 着色器的输出节点(如 Albedo 的标量通道、Alpha 通道)即可快速验证数值效果。由于标量→向量的广播规则,单个常量甚至可以整体调亮/调暗材质颜色。
浮点精度与注意事项
从 着色语言参考 可以了解到,浮点运算通常是近似的,数值越大(或远离 1 的指数越大),可表示的浮点精度越有限。因此在着色器图中编写浮点常量时建议:
- 保持值域合理(尽量落在
0.0~1.0或较小的量级),避免极端大/小数值导致的精度损失; - 精确的
0.0、1.0这类值优先用常量节点显式给出,不要依赖未初始化的变量——着色语言中的局部变量不会被默认初始化为0.0,未赋值的变量会包含内存中的残留值,可能引发不可预测的视觉闪烁; - 当需要比较两个浮点值时(如
If节点的容差参数),注意浮点近似性,合理设置比较阈值。
小结
VisualShaderNodeFloatConstant 是 Godot 视觉着色器中最基础也最常用的节点之一:它零输入、单输出,仅以一个 float 类型的 constant 属性(默认 0.0)承载全部语义,最终被翻译为着色语言中的 float 字面量。理解它的继承链(VisualShaderNodeConstant → VisualShaderNode → Resource → RefCounted → Object)、端口类型(灰色标量端口)、广播/平均连接规则以及常量家族选型,是搭建一切视觉着色器数值逻辑的起点。想要进一步深入,可以继续阅读 视觉着色器教程(含 Group 节点、Expression 节点等高级用法)和 着色语言参考(数据类型与运算规则)。
