Shader Art Coding
シェーダー作業はビジュアルエンジニアリングとして扱います。意図する最終画像から出発し、それを生成できる最小の数理モデルを選択し、検査可能な段階で構築し、各段階をデバッグビューで検証します。
ワークフロー
- ターゲット. 画像の主題、カメラとフレーミング、主要な形状、マテリアル、光源、動きを明示します。
- ルート. レンダリングモデルと開始テンプレートを
references/subject-routing.mdから選択します: 2D距離場(ポスター、アイコン、パターン)、SDFレイマーチング(オブジェクト、キャラクター)、ハイトフィールドマーチング(ランドスケープ)、ボリューム積分(雲、煙、火)。 - ライブラリから組み立てる.
python3 scripts/glsl_tools.py search <キーワード>またはreferences/library-index.mdを使用してビルディングブロックを検索し、名前で呼び出します。ライブラリコードを貼り付けたり再導出したりしないでください。テスト済みです。 - 最初の画像を素早く. 座標、背景、1つのプリミティブ、1つの光源。次にデバッグビューを追加します。
- 順序どおりに洗練: 比率、構図、マテリアルの分離、ライティング、雰囲気、色、アンチエイリアシング、パフォーマンス。
- バンドルとチェック.
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;、つまり1ピクセルは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を1回、そしてditherTPDF。 - 距離:
@exact/@bound/@approxタグを尊重します。変形によりLipschitzが1を超える場合は、距離を割るかraymarchのstepScaleを下げます。
厳格なルール(これらは Shadertoy/WebGL を壊します)
#version行、カスタムユニフォーム、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)を使用してください。移植時にも「見た目を維持する」場合でも置き換えてください。sineハッシュの正確なパターンはGPU間ですでに異なり、同一の整数セルIDに対するPCGハッシュもノイズに同じ見た目を与えます。checkは sine ハッシュをエラーとして報告します。- 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 | パーリン/バリュー/シンプレックス/セルラーノイズ、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、ループ回数)を指摘してください。