著色器藝術編碼 是做什麼的?
將著色器工作視為視覺工程:從目標圖像出發,選擇能產生它的最簡數學模型,以可檢查的階段構建,並透過除錯視圖驗證每個階段。
工作流程
- 目標。 描述圖像:主題、攝影機與構圖、主要形體、材質、光線、動態。
- 路線。 從
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會對其進行語法檢查,並用 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、迴圈計數)。