¿Qué hace Shader Art Coding?
Trata el trabajo con shaders como ingeniería visual: parte de la imagen deseada, elige el modelo matemático más pequeño que pueda producirla, constrúyelo en etapas inspeccionables y verifica cada etapa con una vista de depuración.
Flujo de trabajo
- Objetivo. Define la imagen: sujeto, cámara y encuadre, formas dominantes, materiales, luz, movimiento.
- Ruta. Elige el modelo de renderizado y la plantilla de inicio de
references/subject-routing.md: campos de distancia 2D (pósters, iconos, patrones), raymarching SDF (objetos, personajes), marcha por campo de altura (paisajes), integración de volúmenes (nubes, humo, fuego). - Ensambla desde la biblioteca. Encuentra bloques con
python3 scripts/glsl_tools.py search <palabras>oreferences/library-index.md, y llámalos por su nombre. No pegues ni rederives código de la biblioteca; está probado. - Primera imagen rápida. Coordenadas, fondo, una primitiva, una luz. Luego agrega las vistas de depuración.
- Refina en orden: proporciones, composición, separación de materiales, iluminación, atmósfera, color, antialiasing, rendimiento.
- Empaqueta y verifica.
python3 scripts/glsl_tools.py bundle shader.glsl -o out.glslincluye exactamente las funciones utilizadas.python3 scripts/glsl_tools.py check out.glsllo lint y lo compila con glslangValidator cuando está instalado. Corrige todos los errores, luego entregaout.glsl.
Ejecuta los scripts desde el directorio de esta habilidad. Solo necesitan Python 3.
Convenciones
- Coordenadas:
vec2 uv = (2.0 * fragCoord - iResolution.xy) / iResolution.y;, por lo que un píxel es2.0 / iResolution.y. - Contrato de escena:
vec2 map(vec3 p)devuelvevec2(distancia, materialId).raymarch,calcNormal,softShadow,calcAOysdfThicknesslo utilizan. - Depuración:
#define DEBUG_MODE 0con 0 final, 1 campo de distancia, 2 normales, 3 ids, 4 pasos, 5 máscaras, 6 términos de iluminación. - Tubería de color: iluminación en lineal y decodifica colores seleccionados con
srgbToLinear. Luego exposición, luego el tonemap (tonemapAgXpor defecto, por muestra AA), luego el promedio, luegolinearToSrgbuna vez, luegoditherTPDF. - Distancias: respeta las etiquetas
@exact/@bound/@approx. Si una deformación lleva Lipschitz por encima de 1, divide la distancia o baja elstepScalederaymarch.
Reglas estrictas (estas rompen Shadertoy/WebGL)
- Sin línea
#version, sin uniforms personalizados, singl_FragColor/texture2D/iGlobalTime. - Sin
?:en structs. Usavec2(distance, id)oif. - Escribe literales float:
2.0 * PI,clamp(x, 0.0, 1.0). - Sin hashes
fract(sin(...) * 43758.5453). Usahash12/hash22/hash33(PCG entero). Reemplázalos incluso al portar con "mantener el aspecto": el patrón exacto del hash seno ya difiere entre GPUs, y un hash PCG en los mismos ids de celda entera le da al ruido el mismo aspecto.checkreporta un hash seno como error. - Protege fuentes de NaN:
atan(0, 0),powde negativos,sqrtde negativos,normalize(vec3(0)). - Mantén
dFdx/fwidthfuera de ramas y bucles no uniformes, o usa un tamaño de píxel explícito.
Enrutamiento de referencias
Lee solo lo que la tarea necesita:
| Archivo | Leer cuando |
|---|---|
references/subject-routing.md | empezando desde un sujeto ("una medusa", "montañas"); mapea nombres formales a sujetos |
references/library-index.md | eligiendo funciones: cada función de la biblioteca con firma, exactitud y usos |
references/sdf-library-guide.md | modelado: niveles de exactitud, mezclas, repetición con verificación de vecinos, límites de deformación, peligros de WebGL |
references/rendering-pipeline.md | configuraciones de iluminación, sombras/AO, cielo y niebla, volúmenes, tonemapping, AA, rendimiento |
references/noise-use-cases.md | eligiendo ruido Perlin/valor/simplex/celular, recetas fBm/ridged/billow/warp/híbridas, casos de uso de juegos y enlaces a código fuente primario |
references/procedural-buildings.md | IDs de parcela, macizos de edificios, retranqueos/techos, filtrado de fachadas, repetición de ciudad e integración con juegos |
references/terrain-production.md | representaciones de terreno, valles diseñados, materiales de pendiente/altitud, límites de trazado, chunks y LOD |
references/water-quality.md | agua oceánica/costera de alta calidad, derivadas de olas, Fresnel/refracción/absorción, espuma, ajustes preestablecidos y mejoras del lado del motor |
references/shader-workflow.md | planificando un shader complejo de principio a fin; lista de verificación de revisión |
references/composition-and-debugging.md | la imagen se lee mal, o algo está visualmente incorrecto |
references/formula-cookbook.md | recetas de varios pasos: celosías celulares modulares, síntesis de terreno, composición orgánica |
references/formula-code-couples-sdf.md | ecuación a código para características SDF orgánicas y modulares |
references/formula-code-couples-terrain.md | campos de altura, campos de densidad, acumulación, atmósfera |
references/formula-code-couples-materials.md | máscaras, paletas, términos de iluminación, pulido, movimiento |
Las plantillas en templates/ son puntos de partida completos y verificados por renderizado (galería en el README del repositorio):
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.
Expectativas de salida
Al escribir un shader:
- Entrega el código Shadertoy empaquetado y listo para pegar con
mainImage(out vec4 fragColor, in vec2 fragCoord). - Evita texturas a menos que el usuario las proporcione.
- Incluye interruptores
DEBUG_MODEy nombra los controles artísticos como constantes al inicio. - Termina con una breve guía de ajuste: qué constantes controlan escala, suavidad, color, luz y movimiento.
- Indica si el shader fue verificado por compilación, y cómo.
- Para edificios/terreno/agua, separa las características implementadas de las mejoras del lado del motor. No llames a un campo de altura un generador de cuevas, a una ventana de material un rebaje modelado, o a una máscara de espuma/cáustica procedural una simulación de fluido/luz.
- Para solicitudes de calidad, indica el objetivo y el presupuesto, expone ajustes preestablecidos/vistas de depuración e inspecciona la salida renderizada. Anota los ajustes preestablecidos importantes de las plantillas con
// @variant QUALITY=3(u otro macro entero definido) para que CI los compile y renderice. Preserva el contacto horizonte/costa y el filtrado temporal antes de agregar detalle.
Al mejorar un shader existente:
- Identifica su modelo de renderizado y sus cuellos de botella.
- Preserva su intención e interfaz.
- Corrige primero la corrección, luego la legibilidad, la calidad visual y la velocidad.
- Señala los cambios riesgosos (escala de coordenadas, ids de material, conteos de bucles).