Communitygithub.com

著色器藝術編碼

編寫、除錯與藝術指導程序化 GLSL 片段著色器(Shadertoy mainImage、WebGL2 / GLSL ES 3.00):SDF 光線步進、程序化建築/城市、2D 距離場圖形、雜訊/fBm/域扭曲、地形、海洋/海岸水體光學、雲朵及其他體積效果、PBR 光照、色彩與色調映射。

著色器藝術編碼 是什麼?

這項技能提供了一個完整的 GLSL 片段著色器開發環境,專注於 Shadertoy 和 WebGL2/GLSL ES 3.00 平台。它將著色器工作視為視覺工程,從目標圖像出發,選擇最簡潔的數學模型,以可檢查的階段逐步構建,並通過除錯視圖驗證每個階段。技能包含一個經過驗證的 GLSL 建構區塊庫,附帶打包器和檢查器,用於自動內聯函數呼叫、檢查代碼正確性,並編譯搭配 glslangValidator。流程涵蓋了 SDF 光線步進、地形、海洋、雲朵、程序化城市、2D 海報等多種渲染模型,並針對每個主題提供豐富的參考文件和範本。對於寫入的著色器,它會強制執行嚴格慣例(例如無 #version 行、無紋理、安全的雜訊雜湊、NaN 防護),並提供除錯模式、色調映射管線和效能優化建議。該技能還包含詳細的參考文件路由,用於引導使用者根據任務選擇正確的公式、雜訊用例、程序化建築、地形製作和水體品質指南。

相容平台~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 會對其進行語法檢查,並用 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/值/單純形/細胞雜訊、fBm/脊狀/波狀/扭曲/混合配方、遊戲使用案例和原始碼連結
references/procedural-buildings.md地塊 ID、建築體量、退縮/屋頂、立面過濾、城市重複和遊戲整合
references/terrain-production.md地形表示、設計峽谷、坡度/海拔材質、追蹤限制、區塊和 LOD
references/water-quality.md高品質海洋/海岸水體、波浪導數、菲涅耳/折射/吸收、泡沫、預設和引擎端升級
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、迴圈計數)。

相關技能