Communitygithub.com

シェーダーアートコーディング

手続き型GLSLフラグメントシェーダー(Shadertoy mainImage、WebGL2 / GLSL ES 3.00)の記述、デバッグ、アートディレクションを行います。SDFレイマーチング、手続き型建築物/都市、2D距離場グラフィックス、ノイズ/fBm/ドメインワーピング、地形、海洋/沿岸水域光学、雲などのボリューム、PBRライティング、カラーとトーンマッピングを扱います。

シェーダーアートコーディング とは?

このスキルは、GLSLフラグメントシェーダーの作成、デバッグ、最適化、移植、解説を専門としています。主にShadertoyやWebGL2環境向けのシェーダー開発を対象としており、SDFレイマーチング、手続き型テクスチャ、地形、海洋、雲など、多様なビジュアル表現をサポートします。本スキルの特徴は、ビジュアルエンジニアリングのアプローチを採用し、意図する最終画像から出発して最小限の数理モデルを選択、段階的に構築・検証するワークフローを提供する点です。また、検証済みのGLSLビルディングブロックライブラリをバンドル・チェックするスクリプトが付属しており、コードの品質と移植性を高めます。ユーザーが「シェーダー」「Shadertoy」「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に質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Shader Art Coding

シェーダー作業はビジュアルエンジニアリングとして扱います。意図する最終画像から出発し、それを生成できる最小の数理モデルを選択し、検査可能な段階で構築し、各段階をデバッグビューで検証します。

ワークフロー

  1. ターゲット. 画像の主題、カメラとフレーミング、主要な形状、マテリアル、光源、動きを明示します。
  2. ルート. レンダリングモデルと開始テンプレートを references/subject-routing.md から選択します: 2D距離場(ポスター、アイコン、パターン)、SDFレイマーチング(オブジェクト、キャラクター)、ハイトフィールドマーチング(ランドスケープ)、ボリューム積分(雲、煙、火)。
  3. ライブラリから組み立てる. python3 scripts/glsl_tools.py search <キーワード> または references/library-index.md を使用してビルディングブロックを検索し、名前で呼び出します。ライブラリコードを貼り付けたり再導出したりしないでください。テスト済みです。
  4. 最初の画像を素早く. 座標、背景、1つのプリミティブ、1つの光源。次にデバッグビューを追加します。
  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;、つまり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、ループ回数)を指摘してください。

関連スキル