Godot 着色器与特效
shader 语言用法、材质选择、粒子、后处理、屏幕与深度采样。先判断内置功能够不够,不够再写 shader。
范围
| 不含 |
去哪 |
| 3D 光照、GI、阴影、环境选型 |
godot-3d |
| Tween、AnimationPlayer |
godot-animation |
C# 通用规则、StringName 缓存 |
godot-csharp |
| 2D 光照节点 |
godot-2d |
| Sprite3D 的透明排序与阴影 |
godot-2d-in-3d |
先查内置
| 需求 |
用这个 |
别自己写 |
| 边缘光 自发光 清漆 次表面 折射 |
StandardMaterial3D 的 rim_enabled emission_enabled clearcoat_enabled subsurf_scatter_enabled refraction_enabled |
同功能的 spatial shader |
| 公告牌 近距离淡出 贴地软边 |
billboard_mode distance_fade_mode proximity_fade_enabled |
顶点着色器转向 深度比较 |
| 三平面贴图 顶点色 高度视差 |
uv1_triplanar vertex_color_use_as_albedo heightmap_enabled |
手写采样 |
| 3D 描边 |
next_pass 材质开 grow,cull_mode 设为剔除正面 |
后处理边缘检测 |
| 2D 加色 减色 乘色 |
CanvasItemMaterial.blend_mode |
canvas_item shader 里的 blend_add |
| 2D 不受光 只受光 |
CanvasItemMaterial.light_mode |
shader 里的 unshaded light_only |
| 整体着色与淡出 |
modulate self_modulate |
为单个颜色写 shader |
| 2D 灯光与环境色 |
PointLight2D CanvasModulate |
多个 SubViewport 模拟光照 |
| 泛光 色调映射 亮度对比度 雾 景深 |
Environment 与 CameraAttributes |
SubViewport 链堆 bloom 与模糊 |
| 粒子运动 颜色曲线 碰撞 子发射器 |
GPUParticles3D 加 ParticleProcessMaterial |
脚本逐帧移动一堆节点 |
| 子弹拖尾 刀光 |
粒子拖尾 RibbonTrailMesh 或 Line2D |
手拼网格 |
| 弹孔 污渍 假阴影 |
Decal |
运行时生成网格 |
| 多个精灵合成后加描边与特效 |
CanvasGroup 加材质 |
每个精灵各写一份 |
| 屏幕模糊 菜单背景 |
hint_screen_texture 配 textureLod,3D 场景也可用 Environment 的 glow 模糊 |
额外相机加 SubViewport |
| 动态噪声 渐变 曲线贴图 |
NoiseTexture2D GradientTexture1D CurveTexture 传给 uniform |
在脚本里逐像素生成 |
| 在 GPU 上往贴图里画 涂抹 轨迹图 4.7+ |
DrawableTexture2D 的 blit_rect(),可配 texture_blit shader,类参考标为实验性 |
每帧 Image.set_pixel 再更新 ImageTexture |
| 天空 全景背景 |
Environment 的 sky 配 ProceduralSkyMaterial PhysicalSkyMaterial PanoramaSkyMaterial |
包住场景的大球加贴图 |
| 受击闪白 |
shader uniform 加 Tween |
modulate 超过 1 |
做法
何时写 shader
内置属性组合不出来才写:
- 逐像素动态效果:溶解、描边、扭曲
- 读屏幕或深度
- 顶点形变:风摇、水波
- 程序化纹理、自定义混合
- 只改颜色、透明、亮度,先用
modulate 与材质属性
shader 类型
shader_type |
用于 |
入口 |
常用 render_mode |
spatial |
3D 网格 |
vertex fragment light |
unshaded cull_disabled blend_add depth_draw_never fog_disabled |
canvas_item |
2D 节点与 UI |
vertex fragment light |
blend_add unshaded light_only |
particles |
GPU 粒子的运动 |
start process |
keep_data disable_velocity |
sky |
天空 |
sky |
|
fog |
FogVolume 体积雾 仅 Forward+ |
fog |
|
texture_blit 4.7+ |
DrawableTexture2D.blit_rect() 的绘制规则 |
blit |
blend_disabled(默认) blend_mix blend_add blend_sub blend_mul |
spatial 另有 blend_mul diffuse_toon specular_disabled shadows_disabled 等
- 完整 render_mode 表见 references/shader-language.md
BaseMaterial3D.stencil_mode 与 stencil 相关 render_mode 是 4.5+
三种参数
| 种类 |
声明 |
作用域 |
设置方式 |
| uniform |
uniform float x; |
每个 ShaderMaterial |
material.set_shader_parameter(&"x", v) |
| instance uniform |
instance uniform float x; |
每个节点 |
node.set_instance_shader_parameter(&"x", v) |
| global uniform |
global uniform float x; |
整个项目 |
RenderingServer.global_shader_parameter_set(&"x", v) |
- 共用一个材质但各自状态不同,如闪白、溶解进度:用 instance uniform,不复制材质
- instance uniform 只用于
spatial 与 canvas_item
- 3D 在
GeometryInstance3D 上设,CanvasItem.set_instance_shader_parameter() 是 4.4+
- instance uniform 不支持纹理与数组,每个 shader 最多 16 个
- 同一网格多个材质时用
instance_index 提示避免冲突
- global uniform 先在项目设置 Shader Globals 页创建,写入
shader_globals/<名字>
- 未创建时编辑器保存 shader 编译失败,运行时只警告且取值不对
- global uniform 适合风力、昼夜、玩家位置,设置便宜
global_shader_parameter_get() 在编辑器外报错返回 null,数值自己记一份
- 颜色 uniform 加
source_color,作反照率的贴图 uniform 也加
命中闪白
shader_type canvas_item;
instance uniform float flash : hint_range(0.0, 1.0) = 0.0;
uniform vec4 flash_color : source_color = vec4(1.0);
void fragment() {
COLOR.rgb = mix(COLOR.rgb, flash_color.rgb, flash);
}
extends Sprite2D
var _tween: Tween
func hit() -> void:
if _tween != null:
_tween.kill()
set_instance_shader_parameter(&"flash", 1.0)
_tween = create_tween()
_tween.tween_property(self, "instance_shader_parameters/flash", 0.0, 0.15)
modulate 是乘法,暗部到不了白,不开 HDR 2D 时超过 1 被截断
- 闪白用
mix 到目标色
- 普通 uniform 可
tween_property(material, "shader_parameter/flash", ...)
- 前提是先
set_shader_parameter() 写过初值
- 共享材质的普通 uniform 会让所有实例一起闪
- 要分开:用 instance uniform,或开材质的
resource_local_to_scene
屏幕与深度纹理
shader_type canvas_item;
uniform sampler2D screen_texture : hint_screen_texture, repeat_disable, filter_linear_mipmap;
uniform float blur : hint_range(0.0, 5.0) = 2.0;
void fragment() {
COLOR = textureLod(screen_texture, SCREEN_UV, blur);
}
- 读模糊版本需要
filter_*_mipmap 且 LOD 大于 0
- 2D 里第一个用
hint_screen_texture 的节点触发整屏拷贝,后面的不再拷
- 重叠时用
BackBufferCopy 节点分段
- 3D 屏幕纹理在不透明物体之后、透明物体之前截取,看不到透明物体
- 用了屏幕纹理的材质自己被当作透明
- 深度纹理
hint_depth_texture 非线性,用 INV_PROJECTION_MATRIX 还原
hint_normal_roughness_texture 仅 Forward+
| 渲染器 |
NDC |
| Forward+、Mobile |
vec3(SCREEN_UV * 2.0 - 1.0, depth) |
| Compatibility |
vec3(SCREEN_UV, depth) * 2.0 - 1.0 |
后处理顺序
前一级够用就停:
| 级 |
方案 |
条件 |
| 1 |
Environment:glow、tonemap、adjustments、fog、ssao |
放在 WorldEnvironment,每个场景树一个 |
| 2 |
CompositorEffect 4.3+,实验性 |
仅 Forward+ 与 Mobile,要 HDR 线性数据、运动矢量、法线粗糙度 |
| 3 |
全屏 shader:CanvasLayer 下铺满的 ColorRect 读 hint_screen_texture |
读已渲染好的帧,没有深度,所有渲染器 |
| 4 |
3D 全屏四边形:QuadMesh 加 POSITION = vec4(VERTEX.xy, 1.0, 1.0) |
要深度又不能用 CompositorEffect,设大 extra_cull_margin |
2D 的 glow
Environment.background_mode 必须设为 Environment.BG_CANVAS,否则 2D 内容不进环境效果,Compatibility 实测。
extends Node2D
func _ready() -> void:
var env: Environment = Environment.new()
env.background_mode = Environment.BG_CANVAS
env.background_canvas_max_layer = 0
env.glow_enabled = true
env.glow_hdr_threshold = 0.8
var world_env: WorldEnvironment = WorldEnvironment.new()
world_env.environment = env
add_child(world_env)
| 条件 |
怎么选谁发光 |
| 无 HDR 2D |
2D 是 SDR,glow_hdr_threshold 调到 1.0 以下,靠亮度区分,控制力弱 |
| 有 HDR 2D |
modulate 或 self_modulate 强度超过 1 |
- HDR 2D:
rendering/viewport/hdr_2d,仅 Forward+ 与 Mobile,启动时读取
- 运行时改根视口的
use_hdr_2d
- HDR 2D 下改在线性空间混合,半透明更显眼,字体变粗
- HDR 2D 下 canvas shader 的颜色采样器必须有
source_color
- UI 不发光:放在层号大于
background_canvas_max_layer 的 CanvasLayer
glow_bloom 大于 0 让整个画面变亮
- Compatibility 的 glow 没有
glow_blend_mode glow_levels/* glow_map
粒子
| 需求 |
选择 |
| 默认 |
GPUParticles3D GPUParticles2D |
| 低端设备 GPU 吃紧 少量粒子 |
CPUParticles3D CPUParticles2D,功能比 GPU 版少,不再加新功能 |
| 多个绘制通道 拖尾 子发射器 吸引器 碰撞 湍流 |
只有 GPU 版 |
| 完全自定义运动 |
process_material 换成 shader_type particles 的 ShaderMaterial |
extends GPUParticles3D
func _ready() -> void:
one_shot = true
finished.connect(queue_free)
restart()
- 一次性特效:
one_shot 加 finished 信号
- 外观用绘制通道网格上的材质
- 序列帧:
BaseMaterial3D.billboard_mode 选 BILLBOARD_PARTICLES 并设帧数
- 子发射器:父节点
sub_emitter 指向子节点,父级材质设 sub_emitter_mode
SUB_EMITTER_AT_START 是 4.4+,子节点总数受它自己的 amount 限制
- 拖尾:
trail_enabled,绘制通道用 RibbonTrailMesh 或 TubeTrailMesh
- 拖尾材质开
use_particle_trails,Compatibility 不支持
- 3D 粒子只与
GPUParticlesCollision3D 派生节点碰撞,2D 只与 LightOccluder2D
- 吸引器、湍流、序列帧细节见 references/particles.md
VisualShader
- 用于美术在图里试效果,预览直观
- 要预处理器
#include 或复杂逻辑用文本 shader
- 工具栏显示生成代码可看等价文本
- 资源检查器 Convert to Shader 转成文本 shader,单向不可逆
复用代码
.gdshaderinc 放函数库,#include "res://shaders/lib.gdshaderinc" 引入
- 只有
.gdshaderinc 能被包含,不能循环包含,深度最多 25
- 包含文件里一般不写
shader_type
陷阱
| 现象 |
做法 |
COLOR = texture(TEXTURE, UV) 后 modulate 失效 |
fragment() 的 COLOR 本来就是纹理乘顶点色,直接改它 |
| 参数设了没效果或表现怪 |
GDScript 浮点 64 位、shader 32 位,类型不对不报错;hint_enum 传整数 |
| 参数名对不上 |
与 shader 完全一致,区分大小写 |
报 Tokenizer: Unknown character,整个 shader 编译失败 |
标识符和 group_uniforms 分组名只认 ASCII,中文只放注释 |
| 改一个实例的参数,所有实例都变 |
ShaderMaterial 共享,用 instance uniform 或 resource_local_to_scene |
每次受击 duplicate() 材质,内存涨 |
改用 instance uniform |
对 uniform tween_property 报 does not exist,await tween.finished 永不返回 |
未 set_shader_parameter() 过的 uniform 读出 null,先写初值,4.7.2 实测 |
TIME 一小时后跳回 |
3600 秒回绕,rendering/limits/time/time_rollover_secs;受 Engine.time_scale 影响,不受暂停影响 |
| 颜色贴图发灰或法线贴图错 |
颜色贴图加 source_color,法线与数据贴图不加 |
| uniform 数组太大编译失败 |
桌面上限 65536 字节,手机 16384 字节,大数组打包进贴图 |
| glow 开了看不见 |
调 glow_hdr_threshold 或 glow_bloom |
旧全屏四边形 POSITION = vec4(VERTEX, 1.0) 不显示 |
4.3 起深度反向,改成上文写法 |
| 多个全屏 shader 叠加顺序不对 |
由 CanvasLayer 的 layer 决定,大的在上 |
| GPU 粒子离开可见框整体消失 |
编辑器 Generate Visibility Rect 或 AABB,或设大 visibility_aabb visibility_rect |
运行时改 GPUParticles3D.amount 粒子重启 |
连续调数量用 amount_ratio |
| 一次性粒子再播无效 |
用 restart();它清掉现有粒子,反复触发时等 finished 再调 |
| 子发射器节点自己不发射 |
被指定为子发射器后 emitting 改不回,不能做自己的子发射器 |
Compatibility 下 CompositorEffect、粒子拖尾、粒子 SDF 碰撞、emit_particle() 无效 |
该渲染器不支持 |
DrawableTexture2D.setup() 按官方教程写报解析错误 |
4.7+ 第 4 个参数是 color,use_mipmaps 在第 5 位 |
参考