Communitygithub.com

Shader Art Coding

Escribe, depura y dirige artísticamente shaders de fragmentos GLSL procedurales (Shadertoy mainImage, WebGL2 / GLSL ES 3.00): raymarching SDF, edificios/ciudades procedurales, gráficos 2D de campos de distancia, ruido/fBm/warping de dominio, terreno, óptica de agua oceánica/costera, nubes y otros volúmenes, iluminación PBR, color y tonemapping. Incluye una biblioteca de componentes GLSL verificada con un empaquetador y un validador. Úsalo cuando el usuario solicite un shader, Shadertoy, código GLSL/.frag/.glsl, un raymarcher, una escena SDF, una textura procedural o un visual generativo, o quiera que se arregle, optimice, porte o explique un shader. No es para HLSL/Unity ShaderLab ni para cómputo GPU no gráfico.

¿Qué es Shader Art Coding?

Esta habilidad transforma la creación de shaders GLSL en una ingeniería visual disciplinada: parte de una imagen objetivo, selecciona el modelo matemático más pequeño capaz de producirla, lo construye en etapas inspeccionables y verifica cada etapa con vistas de depuración. El flujo de trabajo guía al usuario desde la definición de la imagen (sujeto, cámara, materiales, luz, movimiento) y la elección del modelo de renderizado (campos de distancia 2D, raymarching SDF, marcha por campo de altura, integración de volúmenes) hasta el ensamblaje a partir de una biblioteca de bloques GLSL verificada (exportada con un empaquetador y comprobada con glslangValidator). Está diseñado para Shadertoy y WebGL2/GLSL ES 3.00, impone reglas estrictas (sin #version, sin hashes seno, guardias contra NaN) y proporciona una amplia gama de referencias para enrutamiento de temas, modelado SDF, tubería de renderizado, ruido, edificios procedurales, terreno, agua, composición y depuración. La habilidad también incluye plantillas completas verificadas por renderizado y exige que la entrega final sea código Shadertoy listo para pegar, con interruptores DEBUG_MODE y una guía de ajuste.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿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

  1. Objetivo. Define la imagen: sujeto, cámara y encuadre, formas dominantes, materiales, luz, movimiento.
  2. 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).
  3. Ensambla desde la biblioteca. Encuentra bloques con python3 scripts/glsl_tools.py search <palabras> o references/library-index.md, y llámalos por su nombre. No pegues ni rederives código de la biblioteca; está probado.
  4. Primera imagen rápida. Coordenadas, fondo, una primitiva, una luz. Luego agrega las vistas de depuración.
  5. Refina en orden: proporciones, composición, separación de materiales, iluminación, atmósfera, color, antialiasing, rendimiento.
  6. Empaqueta y verifica. python3 scripts/glsl_tools.py bundle shader.glsl -o out.glsl incluye exactamente las funciones utilizadas. python3 scripts/glsl_tools.py check out.glsl lo lint y lo compila con glslangValidator cuando está instalado. Corrige todos los errores, luego entrega out.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 es 2.0 / iResolution.y.
  • Contrato de escena: vec2 map(vec3 p) devuelve vec2(distancia, materialId). raymarch, calcNormal, softShadow, calcAO y sdfThickness lo utilizan.
  • Depuración: #define DEBUG_MODE 0 con 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 (tonemapAgX por defecto, por muestra AA), luego el promedio, luego linearToSrgb una vez, luego ditherTPDF.
  • Distancias: respeta las etiquetas @exact / @bound / @approx. Si una deformación lleva Lipschitz por encima de 1, divide la distancia o baja el stepScale de raymarch.

Reglas estrictas (estas rompen Shadertoy/WebGL)

  • Sin línea #version, sin uniforms personalizados, sin gl_FragColor / texture2D / iGlobalTime.
  • Sin ?: en structs. Usa vec2(distance, id) o if.
  • Escribe literales float: 2.0 * PI, clamp(x, 0.0, 1.0).
  • Sin hashes fract(sin(...) * 43758.5453). Usa hash12 / 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. check reporta un hash seno como error.
  • Protege fuentes de NaN: atan(0, 0), pow de negativos, sqrt de negativos, normalize(vec3(0)).
  • Mantén dFdx / fwidth fuera 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:

ArchivoLeer cuando
references/subject-routing.mdempezando desde un sujeto ("una medusa", "montañas"); mapea nombres formales a sujetos
references/library-index.mdeligiendo funciones: cada función de la biblioteca con firma, exactitud y usos
references/sdf-library-guide.mdmodelado: niveles de exactitud, mezclas, repetición con verificación de vecinos, límites de deformación, peligros de WebGL
references/rendering-pipeline.mdconfiguraciones de iluminación, sombras/AO, cielo y niebla, volúmenes, tonemapping, AA, rendimiento
references/noise-use-cases.mdeligiendo 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.mdIDs de parcela, macizos de edificios, retranqueos/techos, filtrado de fachadas, repetición de ciudad e integración con juegos
references/terrain-production.mdrepresentaciones de terreno, valles diseñados, materiales de pendiente/altitud, límites de trazado, chunks y LOD
references/water-quality.mdagua 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.mdplanificando un shader complejo de principio a fin; lista de verificación de revisión
references/composition-and-debugging.mdla imagen se lee mal, o algo está visualmente incorrecto
references/formula-cookbook.mdrecetas de varios pasos: celosías celulares modulares, síntesis de terreno, composición orgánica
references/formula-code-couples-sdf.mdecuación a código para características SDF orgánicas y modulares
references/formula-code-couples-terrain.mdcampos de altura, campos de densidad, acumulación, atmósfera
references/formula-code-couples-materials.mdmá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_MODE y 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).

Skills relacionados