技能介绍

你在写什么

在 Godot 4.x 里，.gdshader 和 ShaderMaterial 是 2D 精灵、UI 贴图和 3D 表面材质共用的扩展点：描边、溶解、水面滚动、边缘光、卡通着色，以及屏幕空间后处理，都要在 Godot Shading Language 里把 fragment()（必要时 vertex() / light()）写对，并把可调参数暴露成 Inspector 里的 uniform。

技能覆盖的工作流

选对类型：首行 shader_type canvas_item;（Sprite2D、TextureRect 等）或 shader_type spatial;（3D 材质）。
挂到节点：ShaderMaterial 绑定 .gdshader，uniform 带 source_color、hint_range 等 hint，便于调色与数值编辑。
写输出变量：2D 写 COLOR；3D 写 ALBEDO、EMISSION、ALPHA 等——在 spatial 里写 COLOR 不会生效。
动画与采样：用内置 TIME 驱动 UV 滚动；texture(tex, UV) 读贴图；GDScript 用 material.set_shader_parameter("name", value) 改参数。
4.x 读屏：不再用已移除的 SCREEN_TEXTURE，应声明 uniform sampler2D x : hint_screen_texture; 并用 SCREEN_UV 采样。

技能内还整理了 2D tint/滚动、噪声溶解、3D 自发光 rim、屏显后处理等 Patterns，并指向 references/shading-language.md 查内置变量与 render mode。

适用边界与坑

别混用技能：跨引擎的 UV/顶点片元概念 → shader-programming；粒子节点 → 通用 3D；非着色器视觉管线另找对应技能。
3.x → 4.x：hint_color / hint_albedo 等改为 source_color；颜色 uniform 不加 source_color 会按线性值显示，发灰或发暗。
透明与 UV：3D 半透明需 render mode 或材质透明设置；UV 超出 [0,1] 要 sampler 加 : repeat_enable 才能平铺。
TIME 持续增长，周期效果用 fract() / mod() 包一层；能改 alpha 就别滥用 discard，部分硬件上代价高且影响 early-Z。