Was macht Shader Art Coding?
Behandele Shader-Arbeit als visuelle Ingenieurskunst: Beginne mit dem angestrebten Bild, wähle das kleinste mathematische Modell, das es erzeugen kann, baue es in überprüfbaren Schritten auf und verifiziere jeden Schritt mit einer Debug-Ansicht.
Arbeitsablauf
- Ziel. Beschreibe das Bild: Motiv, Kamera und Bildausschnitt, dominante Formen, Materialien, Licht, Bewegung.
- Route. Wähle das Rendering-Modell und die Startvorlage aus
references/subject-routing.md: 2D Distanzfelder (Poster, Icons, Muster), SDF Raymarching (Objekte, Charaktere), Höhenfeld-Marching (Landschaften), Volumen-Integration (Wolken, Rauch, Feuer). - Aus der Bibliothek zusammenstellen. Finde Bausteine mit
python3 scripts/glsl_tools.py search <wörter>oderreferences/library-index.mdund rufe sie beim Namen auf. Keinen Bibliothekscode kopieren oder neu ableiten; er ist getestet. - Erstes Bild schnell. Koordinaten, Hintergrund, ein Primitiv, ein Licht. Danach die Debug-Ansichten hinzufügen.
- In der richtigen Reihenfolge verfeinern: Proportionen, Komposition, Materialtrennung, Beleuchtung, Atmosphäre, Farbe, Antialiasing, Leistung.
- Bündeln und prüfen.
python3 scripts/glsl_tools.py bundle shader.glsl -o out.glslfügt genau die verwendeten Funktionen ein.python3 scripts/glsl_tools.py check out.glsllintet den Shader und kompiliert ihn mit glslangValidator (falls installiert). Jeden Fehler beheben, dannout.glslausliefern.
Führe die Skripte aus dem Verzeichnis dieses Skills aus. Sie benötigen nur Python 3.
Konventionen
- Koordinaten:
vec2 uv = (2.0 * fragCoord - iResolution.xy) / iResolution.y;, also ist ein Pixel2.0 / iResolution.y. - Szene-Vertrag:
vec2 map(vec3 p)gibtvec2(distanz, materialId)zurück.raymarch,calcNormal,softShadow,calcAOundsdfThicknessverwenden es alle. - Debug:
#define DEBUG_MODE 0mit 0=final, 1=Distanzfeld, 2=Normalen, 3=IDs, 4=Schritte, 5=Masks, 6=Beleuchtungsterme. - Farb-Pipeline: Licht in linear und ausgewählte Farben mit
srgbToLineardekodieren. Dann Belichtung, dann das Tonemapping (tonemapAgXstandardmäßig pro AA-Sample), dann der Durchschnitt, dannlinearToSrgbeinmal, dannditherTPDF. - Distanzen: Beachte die Tags
@exact/@bound/@approx. Falls eine Verformung Lipschitz über 1 treibt, teile die Distanz oder senke denstepScalevonraymarch.
Harte Regeln (sonst brechen Shadertoy/WebGL)
- Keine
#version-Zeile, keine benutzerdefinierten Uniforms, keingl_FragColor/texture2D/iGlobalTime. - Kein
?:auf Structs. Verwendevec2(distanz, id)oderif. - Float-Literale schreiben:
2.0 * PI,clamp(x, 0.0, 1.0). - Keine
fract(sin(...) * 43758.5453)-Hashes. Verwendehash12/hash22/hash33(integer PCG). Ersetze sie auch beim Portieren mit "keep the look": Das exakte Muster des Sinus-Hashs variiert bereits zwischen GPUs, und ein PCG-Hash auf denselben Integer-Zellen-IDs verleiht dem Rauschen das gleiche Aussehen.checkmeldet einen Sinus-Hash als Fehler. - NaN-Quellen absichern:
atan(0, 0),powvon Negativen,sqrtvon Negativen,normalize(vec3(0)). dFdx/fwidthaus nicht-uniformen Verzweigungen und Schleifen heraushalten, oder eine explizite Pixelgröße verwenden.
Referenz-Routing
Lies nur, was die Aufgabe benötigt:
| Datei | Lesen, wenn ... |
|---|---|
references/subject-routing.md | von einem Motiv ausgehend ("eine Qualle", "Berge"); bildet formale Namen auf Motive ab |
references/library-index.md | Funktionen auswählen: jede Bibliotheksfunktion mit Signatur, Genauigkeit und Verwendung |
references/sdf-library-guide.md | Modellierung: Genauigkeitsstufen, Blends, nachbar-geprüfte Wiederholungen, Verformungsgrenzen, WebGL-Fallstricke |
references/rendering-pipeline.md | Beleuchtungs-Setups, Schatten/AO, Himmel und Nebel, Volumen, Tonemapping, AA, Leistung |
references/noise-use-cases.md | Perlin/Value/Simplex/Cellular-Rauschen auswählen, fBm/ridged/billow/warp/hybrid-Rezepte, Anwendungsfälle und Quellcode-Links |
references/procedural-buildings.md | Parzellen-IDs, Gebäude-Massing, Rücksprünge/Dächer, Fassadenfilterung, Stadt-Wiederholungen und Spielintegration |
references/terrain-production.md | Geländedarstellungen, entworfene Täler, Hang-/Höhenmaterialien, Tracing-Grenzen, Chunks und LOD |
references/water-quality.md | hochwertiges Ozean-/Küstenwasser, Wellenableitungen, Fresnel/Brechung/Absorption, Schaum, Voreinstellungen und Engine-seitige Upgrades |
references/shader-workflow.md | Planung eines komplexen Shaders von Anfang bis Ende; Checkliste zur Überprüfung |
references/composition-and-debugging.md | das Bild liest sich schlecht, oder etwas ist visuell falsch |
references/formula-cookbook.md | mehrstufige Rezepte: modulare Zellgitter, Geländesynthese, organische Komposition |
references/formula-code-couples-sdf.md | Gleichung-zu-Code für organische und modulare SDF-Merkmale |
references/formula-code-couples-terrain.md | Höhenfelder, Dichtefelder, Akkumulation, Atmosphäre |
references/formula-code-couples-materials.md | Masken, Paletten, Beleuchtungsterme, Politur, Bewegung |
Vorlagen in templates/ sind vollständige, rendergeprüfte Startpunkte (Galerie in der Repository-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.
Ausgabeerwartungen
Beim Schreiben eines Shaders:
- Liefere den gebündelten, paste-bereiten Shadertoy-Code mit
mainImage(out vec4 fragColor, in vec2 fragCoord). - Vermeide Texturen, es sei denn der Benutzer stellt sie bereit.
- Füge
DEBUG_MODE-Schalter ein und benenne die Kunststeuerungen als Konstanten oben. - Beende mit einer kurzen Abstimmungsanleitung: welche Konstanten Skalierung, Weichheit, Farbe, Licht und Bewegung steuern.
- Gib an, ob der Shader compilierungsgeprüft wurde und wie.
- Bei Gebäuden/Gelände/Wasser getrennt implementierte Funktionen von Engine-seitigen Upgrades aufführen. Nenne ein Höhenfeld nicht Höhlengenerator, ein Materialfenster nicht modellierte Vertiefung oder eine prozedurale Schaum-/Kaustik-Maske nicht Flüssigkeits-/Lichtsimulation.
- Bei Qualitätsanfragen: Ziel und Budget angeben, Voreinstellungen/Debug-Ansichten bereitstellen und gerenderte Ausgabe inspizieren. Wichtige Vorlagen-Voreinstellungen mit
// @variant QUALITY=3(oder einem anderen definierten Integer-Makro) annotieren, damit CI sie kompiliert und rendert. Horizont-/Küsten-Kontakt und zeitliche Filterung erhalten, bevor Details hinzugefügt werden.
Bei der Verbesserung eines bestehenden Shaders:
- Identifiziere sein Rendering-Modell und seine Engpässe.
- Bewahre seine Absicht und Schnittstelle.
- Behebe zuerst Korrektheitsfehler, dann Lesbarkeit, visuelle Qualität und Geschwindigkeit.
- Weise auf riskante Änderungen hin (Koordinatenskalierung, Material-IDs, Schleifenzahlen).