Communitygithub.com

Shader Art Coding (Codage artistique de shaders)

Écrit, débogue et dirige artistiquement des shaders GLSL fragmentaires procéduraux (Shadertoy mainImage, WebGL2 / GLSL ES 3.00) : SDF raymarching, bâtiments/villes procéduraux, graphiques 2D par champs de distance, bruit / fBm / domain warping, terrains, optique d'eau océanique/côtière, nuages et autres volumes, éclairage PBR, couleur et mappage de tons.

Qu'est-ce que Shader Art Coding (Codage artistique de shaders) ?

Cette compétence transforme une description visuelle en code GLSL fonctionnel, en suivant un flux de travail rigoureux : cibler l'image, choisir le modèle mathématique le plus simple, construire par étapes inspectables avec des vues de débogage. Elle fournit une bibliothèque vérifiée de blocs de construction GLSL (SDF, bruit, éclairage, etc.) ainsi qu'un bundler et un vérificateur de code, garantissant que le shader final est correct et optimisé pour Shadertoy et WebGL. La compétence est conçue pour être utilisée dans des contextes de développement d'agents IA (comme Claude Code, Cursor, Codex) où un utilisateur demande un shader, un raymarcher, une texture procédurale, ou souhaite corriger, optimiser, porter ou expliquer un shader existant. Elle exclut HLSL/Unity ShaderLab et le calcul GPU non graphique. Le processus automatisé avec scripts Python permet la recherche de fonctions, le regroupement des dépendances et la vérification de la compilation.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Codage artistique de shaders (Shader Art Coding)

Tout travail de shader doit être considéré comme de l'ingénierie visuelle : partez de l'image souhaitée, choisissez le plus petit modèle mathématique capable de la produire, construisez-le par étapes inspectables et vérifiez chaque étape à l'aide d'une vue de débogage.

Flux de travail

  1. Cible. Décrivez l'image : sujet, caméra et cadrage, formes dominantes, matériaux, lumière, mouvement.
  2. Itinéraire. Choisissez le modèle de rendu et le modèle de départ dans references/subject-routing.md : champs de distance 2D (affiches, icônes, motifs), raymarching SDF (objets, personnages), marching sur champ de hauteur (paysages), intégration de volume (nuages, fumée, feu).
  3. Assemblez à partir de la bibliothèque. Trouvez les blocs de construction avec python3 scripts/glsl_tools.py search <mots> ou references/library-index.md, et appelez-les par leur nom. Ne copiez pas et ne redérivez pas le code de la bibliothèque ; il est testé.
  4. Première image rapide. Coordonnées, arrière-plan, une primitive, une lumière. Ajoutez ensuite les vues de débogage.
  5. Affinez dans l'ordre : proportions, composition, séparation des matériaux, éclairage, ambiance, couleur, anticrénelage, performances.
  6. Regroupez et vérifiez. python3 scripts/glsl_tools.py bundle shader.glsl -o out.glsl intègre exactement les fonctions utilisées. python3 scripts/glsl_tools.py check out.glsl le nettoie et le compile avec glslangValidator lorsqu'il est installé. Corrigez chaque erreur, puis fournissez out.glsl.

Exécutez les scripts depuis le répertoire de cette compétence. Ils nécessitent uniquement Python 3.

Conventions

  • Coordonnées : vec2 uv = (2.0 * fragCoord - iResolution.xy) / iResolution.y;, donc un pixel fait 2.0 / iResolution.y.
  • Contrat de scène : vec2 map(vec3 p) retourne vec2(distance, materialId). raymarch, calcNormal, softShadow, calcAO et sdfThickness l'utilisent tous.
  • Débogage : #define DEBUG_MODE 0 avec 0 final, 1 champ de distance, 2 normales, 3 identifiants, 4 étapes, 5 masques, 6 termes d'éclairage.
  • Pipeline couleur : lumière en linéaire et décodez les couleurs choisies avec srgbToLinear. Ensuite exposition, puis le mappage de tons (tonemapAgX par défaut, par échantillon AA), puis la moyenne, puis linearToSrgb une fois, puis ditherTPDF.
  • Distances : respectez les balises @exact / @bound / @approx. Si une déformation pousse Lipschitz au-dessus de 1, divisez la distance ou abaissez le stepScale de raymarch.

Règles strictes (elles cassent Shadertoy/WebGL)

  • Pas de ligne #version , pas d'uniformes personnalisés, pas de gl_FragColor / texture2D / iGlobalTime.
  • Pas de ?: sur les structures. Utilisez vec2(distance, id) ou if.
  • Écrivez les littéraux flottants : 2.0 * PI, clamp(x, 0.0, 1.0).
  • Pas de hachages fract(sin(...) * 43758.5453). Utilisez hash12 / hash22 / hash33 (PCG entier). Remplacez-les même lors du portage avec "conserver l'aspect" : le motif exact du hachage sinusoïdal diffère déjà entre les GPU, et un hachage PCG sur les mêmes identifiants de cellule entière donne au bruit le même aspect. check signale un hachage sinusoïdal comme une erreur.
  • Protégez les sources NaN : atan(0, 0), pow de négatifs, sqrt de négatifs, normalize(vec3(0)).
  • Gardez dFdx / fwidth en dehors des branches et boucles non uniformes, ou utilisez une taille de pixel explicite.

Routage de référence

Lisez uniquement ce dont la tâche a besoin :

FichierÀ lire quand
references/subject-routing.mdvous partez d'un sujet ("une méduse", "des montagnes") ; fait correspondre les noms formels aux sujets
references/library-index.mdvous choisissez des fonctions : chaque fonction de la bibliothèque avec signature, exactitude et utilisations
references/sdf-library-guide.mdmodélisation : niveaux d'exactitude, mélanges, répétition vérifiée par voisinage, limites de déformation, pièges WebGL
references/rendering-pipeline.mdconfigurations d'éclairage, ombres/AO, ciel et brouillard, volumes, mappage de tons, AA, performances
references/noise-use-cases.mdchoix du bruit Perlin/valeur/simplex/cellulaire, recettes fBm/crêté/billow/warp/hybride, cas d'utilisation de jeux et liens vers le code source principal
references/procedural-buildings.mdidentifiants de parcelle, massification des bâtiments, retraits/toits, filtrage des façades, répétition urbaine et intégration dans le jeu
references/terrain-production.mdreprésentations du terrain, vallées conçues, matériaux de pente/altitude, limites de tracé, chunks et LOD
references/water-quality.mdeau océanique/côtière de haute qualité, dérivées de vagues, Fresnel/réfraction/absorption, écume, préréglages et améliorations côté moteur
references/shader-workflow.mdplanification d'un shader complexe de bout en bout ; liste de contrôle de révision
references/composition-and-debugging.mdl'image se lit mal, ou quelque chose est visuellement faux
references/formula-cookbook.mdrecettes multi-étapes : réseaux de cellules modulaires, synthèse de terrain, composition organique
references/formula-code-couples-sdf.mdéquation-à-code pour les fonctionnalités SDF organiques et modulaires
references/formula-code-couples-terrain.mdchamps de hauteur, champs de densité, accumulation, atmosphère
references/formula-code-couples-materials.mdmasques, palettes, termes d'éclairage, polissage, mouvement

Les modèles dans templates/ sont des points de départ complets et vérifiés (galerie dans le README du dépôt) : 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.

Attentes en matière de sortie

Lors de l'écriture d'un shader :

  • Fournissez le code Shadertoy regroupé et prêt à être collé avec mainImage(out vec4 fragColor, in vec2 fragCoord).
  • Évitez les textures sauf si l'utilisateur les fournit.
  • Incluez les commutateurs DEBUG_MODE et nommez les contrôles artistiques comme constantes en haut.
  • Terminez par un petit guide de réglage : quelles constantes contrôlent l'échelle, la douceur, la couleur, la lumière et le mouvement.
  • Dites si le shader a été vérifié par compilation, et comment.
  • Pour les bâtiments/terrains/eau, séparez les fonctionnalités implémentées des améliorations côté moteur. N'appelez pas un champ de hauteur un générateur de grotte, une fenêtre de matériau un renfoncement modélisé, ou un masque de mousse/caustique procédural une simulation de fluide/lumière.
  • Pour les demandes de qualité, énoncez la cible et le budget, exposez les préréglages/vues de débogage, et inspectez le rendu de sortie. Annotez les préréglages importants des modèles avec // @variant QUALITY=3 (ou une autre macro entière définie) afin que CI les compile et les rende. Préservez le contact horizon/rivage et le filtrage temporel avant d'ajouter des détails.

Lors de l'amélioration d'un shader existant :

  • Identifiez son modèle de rendu et ses goulots d'étranglement.
  • Préservez son intention et son interface.
  • Corrigez d'abord l'exactitude, puis la lisibilité, la qualité visuelle et la vitesse.
  • Signalez les changements risqués (échelle des coordonnées, identifiants de matériau, nombre de boucles).

Skills associés