着色器艺术编程 是做什么的?
将着色器工作视为视觉工程:从目标图像出发,选择能够产生该图像的最小数学模型,在可分步检查的阶段中构建它,并用调试视图验证每个阶段。
工作流程
- 目标。 明确描述图像:主题、相机与取景、主要形体、材质、光照、运动。
- 路线。 从
references/subject-routing.md中选择渲染模型和起始模板: 2D 距离场(海报、图标、图案),SDF 光线步进(物体、角色),高度场步进(地貌),体积积分(云、烟、火)。 - 从库中组装。 使用
python3 scripts/glsl_tools.py search <words>或references/library-index.md查找构建块,并通过名称调用。不要粘贴或重新推导库代码;它们已经过测试。 - 快速得到第一版图像。 坐标、背景、一个图元、一个光源。然后添加调试视图。
- 按顺序优化: 比例、构图、材质分离、光照、氛围、色彩、抗锯齿、性能。
- 打包并检查。
python3 scripts/glsl_tools.py bundle shader.glsl -o out.glsl会精确内联所使用的函数。python3 scripts/glsl_tools.py check out.glsl会进行 lint 检查,并在安装了 glslangValidator 时编译它。修复所有错误,然后交付out.glsl。
从本技能的目录运行这些脚本。它们只需要 Python 3。
约定
- 坐标:
vec2 uv = (2.0 * fragCoord - iResolution.xy) / iResolution.y;,因此一个像素为2.0 / iResolution.y。 - 场景合约:
vec2 map(vec3 p)返回vec2(distance, materialId)。raymarch、calcNormal、softShadow、calcAO和sdfThickness都使用它。 - 调试:
#define DEBUG_MODE 0,其中 0 为最终版,1 为距离场,2 为法线,3 为 ID,4 为步数,5 为遮罩, 6 为光照项。 - 色彩管线: 在线性空间中处理光照,用
srgbToLinear解编码选取的颜色。然后曝光,然后进行色调映射(默认使用tonemapAgX,每个 AA 样本),然后平均,然后进行一次linearToSrgb,然后进行ditherTPDF。 - 距离: 尊重
@exact/@bound/@approx标签。如果变形将 Lipschitz 推到 1 以上,则除以距离或降低raymarch的stepScale。
硬性规则(这些会破坏 Shadertoy/WebGL)
- 禁止
#version行、自定义 uniform、gl_FragColor/texture2D/iGlobalTime。 - 禁止在结构体上使用
?:。改用vec2(distance, id)或if。 - 编写浮点字面量:
2.0 * PI、clamp(x, 0.0, 1.0)。 - 禁止使用
fract(sin(...) * 43758.5453)哈希。使用hash12/hash22/hash33(整数 PCG)。即使在移植时也要替换它们("保持外观"):正弦哈希的确切模式在不同 GPU 上已经不同,而在相同整数单元 ID 上使用 PCG 哈希能使噪声保持相同外观。check会将正弦哈希报告为错误。 - 保护 NaN 源头:
atan(0, 0)、负数的pow、负数的sqrt、normalize(vec3(0))。 - 将
dFdx/fwidth保持在非均匀分支和循环之外,或者使用显式的像素大小。
参考路由
仅阅读任务所需的文件:
| 文件 | 何时阅读 |
|---|---|
references/subject-routing.md | 从主题("一只水母"、"山脉")开始时;将正式名称映射到主题 |
references/library-index.md | 选择函数时:每个库函数的签名、精确性和用途 |
references/sdf-library-guide.md | 建模时:精确性层级、混合、邻域检查的重复、变形限制、WebGL 陷阱 |
references/rendering-pipeline.md | 光照装备、阴影/AO、天空和雾、体积、色调映射、AA、性能 |
references/noise-use-cases.md | 选择 Perlin/value/simplex/cellular 噪声、fBm/ridged/billow/warp/hybrid 配方、游戏用例和源码链接 |
references/procedural-buildings.md | 地块 ID、建筑体量、退线/屋顶、立面过滤、城市重复和游戏集成 |
references/terrain-production.md | 地形表示、设计山谷、坡度/海拔材质、追踪限制、区块和 LOD |
references/water-quality.md | 高质量海洋/海岸水、波浪导数、Fresnel/折射/吸收、泡沫、预设和引擎侧升级 |
references/shader-workflow.md | 端到端规划复杂着色器;审查清单 |
references/composition-and-debugging.md | 图像读取不佳,或视觉上出了问题 |
references/formula-cookbook.md | 多步骤配方:模块化单元晶格、地形合成、有机构图 |
references/formula-code-couples-sdf.md | 有机和模块化 SDF 特征的方程到代码 |
references/formula-code-couples-terrain.md | 高度场、密度场、累积、大气 |
references/formula-code-couples-materials.md | 遮罩、调色板、光照项、打磨、运动 |
templates/ 中的模板是完整、经过渲染验证的起点(仓库 README 中有图库):
raymarch-sdf.glsl、terrain.glsl、ocean.glsl、volumetric-clouds.glsl、sdf-2d-poster.glsl、
pattern-swatches.glsl、noise-progression.glsl、noise-terrain-map.glsl、procedural-city.glsl、
alpine-valley.glsl、coastal-water.glsl。
输出期望
编写着色器时:
- 交付打包好的、可直接粘贴到 Shadertoy 的代码,包含
mainImage(out vec4 fragColor, in vec2 fragCoord)。 - 除非用户提供了纹理,否则避免使用纹理。
- 包含
DEBUG_MODE开关,并将艺术控制参数命名为顶部的常量。 - 最后附上简短的调优指南:哪些常量控制缩放、柔和度、色彩、光照和运动。
- 说明着色器是否通过编译检查以及如何检查的。
- 对于建筑/地形/水,将已实现的功能与引擎侧升级区分开。不要将高度场称为洞穴生成器,将材质窗口称为建模凹槽,或将程序化泡沫/焦散遮罩称为流体/光照模拟。
- 对于质量要求,说明目标和预算,暴露预设/调试视图,并检查渲染输出。使用
// @variant QUALITY=3(或其他定义的整数宏)注释重要的模板预设,以便 CI 编译和渲染它们。在添加细节之前,保持地平线/海岸线接触和时间滤波。
改进现有着色器时:
- 识别其渲染模型和瓶颈。
- 保留其意图和接口。
- 首先修复正确性,然后是可读性、视觉质量和速度。
- 指出有风险的更改(坐标缩放、材质 ID、循环次数)。