Communitygithub.com

着色器艺术编程

编写、调试和艺术指导过程式 GLSL 片段着色器(Shadertoy mainImage,WebGL2 / GLSL ES 3.00):涵盖 SDF 光线步进、程序化建筑/城市、2D 距离场图形、噪声 / fBm / 域扭曲、地形、海洋/海岸水光学、云层及其他体积效果、PBR 光照、色彩与色调映射。附带经过验证的 GLSL 构建块库、打包器和检查器。

着色器艺术编程 是什么?

此技能专为 AI 代理设计,用于协助 GLSL 片段着色器的开发、调试和优化,主要面向 Shadertoy 平台和 WebGL2 / GLSL ES 3.00 环境。它提供完整的工程化工作流:从明确视觉目标开始,选择渲染模型(如 2D 距离场、SDF 光线步进、高度场步进、体积积分),然后从内置的已测试 GLSL 构建块库中组合函数,快速得到第一版图像,再逐步优化比例、构图、材质、光照和性能。技能内置了一个 Python 脚本工具链(glsl_tools.py),支持按名称搜索库函数、打包仅包含所用函数的着色器,并使用 glslangValidator 进行编译检查,确保输出代码可直接粘贴到 Shadertoy 运行。该技能定义了严格的编码规范:禁止使用 `#version`、`gl_FragColor`、`texture2D` 等旧式语法;禁止浮点数中的正弦哈希(改用 PCG 整数哈希);要求在所有分支中保护 NaN 源头;并提供统一的调试宏模式(DEBUG_MODE)和色彩管线(线性光、AgX 色调映射、抖动)。参考文档涵盖主题路由、SDF 库指南、渲染管线、噪声用例、程序化建筑、地形、水质量等10余个文件,模板目录提供11个可直接运行的完整着色器起点。当用户要求编写 Shadertoy 着色器、GLSL/.frag/.glsl 代码、光线步进器、SDF 场景、程序化纹理或生成式视觉效果,或需要修复、优化、移植、解释着色器时,应使用此技能。该技能不适用于 HLSL/Unity ShaderLab 或非图形 GPU 计算。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/LyalinDotCom/gemini-shader-test-carbon/tree/main/shader-skills/skills/shader-art-coding

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

着色器艺术编程 是做什么的?

将着色器工作视为视觉工程:从目标图像出发,选择能够产生该图像的最小数学模型,在可分步检查的阶段中构建它,并用调试视图验证每个阶段。

工作流程

  1. 目标。 明确描述图像:主题、相机与取景、主要形体、材质、光照、运动。
  2. 路线。 从 references/subject-routing.md 中选择渲染模型和起始模板: 2D 距离场(海报、图标、图案),SDF 光线步进(物体、角色),高度场步进(地貌),体积积分(云、烟、火)。
  3. 从库中组装。 使用 python3 scripts/glsl_tools.py search <words> 或 references/library-index.md 查找构建块,并通过名称调用。不要粘贴或重新推导库代码;它们已经过测试。
  4. 快速得到第一版图像。 坐标、背景、一个图元、一个光源。然后添加调试视图。
  5. 按顺序优化: 比例、构图、材质分离、光照、氛围、色彩、抗锯齿、性能。
  6. 打包并检查。 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、循环次数)。

相关技能