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
- Cible. Décrivez l'image : sujet, caméra et cadrage, formes dominantes, matériaux, lumière, mouvement.
- 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). - Assemblez à partir de la bibliothèque. Trouvez les blocs de construction avec
python3 scripts/glsl_tools.py search <mots>oureferences/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é. - Première image rapide. Coordonnées, arrière-plan, une primitive, une lumière. Ajoutez ensuite les vues de débogage.
- Affinez dans l'ordre : proportions, composition, séparation des matériaux, éclairage, ambiance, couleur, anticrénelage, performances.
- Regroupez et vérifiez.
python3 scripts/glsl_tools.py bundle shader.glsl -o out.glslintègre exactement les fonctions utilisées.python3 scripts/glsl_tools.py check out.glslle nettoie et le compile avec glslangValidator lorsqu'il est installé. Corrigez chaque erreur, puis fournissezout.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 fait2.0 / iResolution.y. - Contrat de scène :
vec2 map(vec3 p)retournevec2(distance, materialId).raymarch,calcNormal,softShadow,calcAOetsdfThicknessl'utilisent tous. - Débogage :
#define DEBUG_MODE 0avec 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 (tonemapAgXpar défaut, par échantillon AA), puis la moyenne, puislinearToSrgbune fois, puisditherTPDF. - Distances : respectez les balises
@exact/@bound/@approx. Si une déformation pousse Lipschitz au-dessus de 1, divisez la distance ou abaissez lestepScalederaymarch.
Règles strictes (elles cassent Shadertoy/WebGL)
- Pas de ligne
#version, pas d'uniformes personnalisés, pas degl_FragColor/texture2D/iGlobalTime. - Pas de
?:sur les structures. Utilisezvec2(distance, id)ouif. - Écrivez les littéraux flottants :
2.0 * PI,clamp(x, 0.0, 1.0). - Pas de hachages
fract(sin(...) * 43758.5453). Utilisezhash12/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.checksignale un hachage sinusoïdal comme une erreur. - Protégez les sources NaN :
atan(0, 0),powde négatifs,sqrtde négatifs,normalize(vec3(0)). - Gardez
dFdx/fwidthen 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.md | vous partez d'un sujet ("une méduse", "des montagnes") ; fait correspondre les noms formels aux sujets |
references/library-index.md | vous choisissez des fonctions : chaque fonction de la bibliothèque avec signature, exactitude et utilisations |
references/sdf-library-guide.md | modélisation : niveaux d'exactitude, mélanges, répétition vérifiée par voisinage, limites de déformation, pièges WebGL |
references/rendering-pipeline.md | configurations d'éclairage, ombres/AO, ciel et brouillard, volumes, mappage de tons, AA, performances |
references/noise-use-cases.md | choix 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.md | identifiants 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.md | représentations du terrain, vallées conçues, matériaux de pente/altitude, limites de tracé, chunks et LOD |
references/water-quality.md | eau 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.md | planification d'un shader complexe de bout en bout ; liste de contrôle de révision |
references/composition-and-debugging.md | l'image se lit mal, ou quelque chose est visuellement faux |
references/formula-cookbook.md | recettes 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.md | champs de hauteur, champs de densité, accumulation, atmosphère |
references/formula-code-couples-materials.md | masques, 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_MODEet 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).