Communitygithub.com

Codificação de Arte com Shaders

Escreve, depura e direciona artisticamente shaders GLSL fragment (Shadertoy mainImage, WebGL2/GLSL ES 3.00): raymarching SDF, edifícios/cidades processuais, gráficos de campo de distância 2D, ruído/fBm/warp de domínio, terreno, óptica de água oceânica/costeira, nuvens e outros volumes, iluminação PBR, cor e mapeamento de tom. Inclui uma biblioteca verificada de blocos de construção GLSL com um empacotador e verificador. Use quando o usuário pedir um shader, Shadertoy, código GLSL/.frag/.glsl, um raymarcher, uma cena SDF, uma textura processual ou visual generativo, ou quiser um shader corrigido, otimizado, portado ou explicado. Não é para HLSL/Unity ShaderLab ou computação GPU não gráfica.

O que é Codificação de Arte com Shaders?

Esta skill capacita o agente a atuar como um especialista em shaders artísticos processuais, focado em GLSL ES 3.00 para plataformas como Shadertoy e WebGL2. Ela fornece um fluxo de trabalho estruturado que começa com a definição da imagem alvo e a escolha do modelo de renderização (como campos de distância 2D ou raymarching SDF), e então utiliza uma biblioteca verificada de funções GLSL para construir o shader em etapas inspecionáveis. As funções da biblioteca podem ser pesquisadas e incluídas por nome, evitando erros de reimplementação. A skill também automatiza a verificação e o empacotamento do shader final com scripts Python, garantindo que o código esteja livre de erros comuns de WebGL (como hashes de seno ou literais de ponto flutuante incorretos) e pronto para ser copiado e colado. Além disso, mantém uma extensa documentação de referência para tópicos como ruído, edifícios processuais, terreno, água e composição, permitindo que o agente aborde desde cenas orgânicas complexas até pôsteres abstratos 2D. O resultado é um shader finalizado, depurado e pronto para uso, acompanhado de um pequeno guia de ajuste.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Codificação de Arte com Shaders faz?

Trate o trabalho com shaders como engenharia visual: comece pela imagem pretendida, escolha o menor modelo matemático que possa produzi-la, construa em etapas inspecionáveis e verifique cada etapa com uma visualização de depuração.

Fluxo de Trabalho

  1. Alvo. Defina a imagem: assunto, câmera e enquadramento, formas dominantes, materiais, luz, movimento.
  2. Rota. Escolha o modelo de renderização e o template inicial a partir de references/subject-routing.md: Campos de distância 2D (pôsteres, ícones, padrões), raymarching SDF (objetos, personagens), marcha de campo de altura (paisagens), integração de volume (nuvens, fumaça, fogo).
  3. Monte a partir da biblioteca. Encontre blocos de construção com python3 scripts/glsl_tools.py search <palavras> ou references/library-index.md, e chame-os pelo nome. Não cole ou rederive código da biblioteca; ele é testado.
  4. Primeira imagem rápida. Coordenadas, fundo, uma primitiva, uma luz. Em seguida, adicione as visualizações de depuração.
  5. Refine em ordem: proporções, composição, separação de materiais, iluminação, atmosfera, cor, anti-aliasing, desempenho.
  6. Empacote e verifique. python3 scripts/glsl_tools.py bundle shader.glsl -o out.glsl insere exatamente as funções usadas. python3 scripts/glsl_tools.py check out.glsl faz lint e compila com glslangValidator quando instalado. Corrija todos os erros e então entregue out.glsl.

Execute os scripts a partir do diretório desta skill. Eles precisam apenas de Python 3.

Convenções

  • Coordenadas: vec2 uv = (2.0 * fragCoord - iResolution.xy) / iResolution.y;, então um pixel é 2.0 / iResolution.y.
  • Contrato de cena: vec2 map(vec3 p) retorna vec2(distância, idMaterial). raymarch, calcNormal, softShadow, calcAO e sdfThickness usam isso.
  • Depuração: #define DEBUG_MODE 0 com 0 final, 1 campo de distância, 2 normais, 3 ids, 4 passos, 5 máscaras, 6 termos de iluminação.
  • Pipeline de cor: luz em linear e decodifique as cores selecionadas com srgbToLinear. Em seguida, exposição, depois o mapeamento de tom (tonemapAgX por padrão, por amostra AA), depois a média, depois linearToSrgb uma vez, depois ditherTPDF.
  • Distâncias: respeite as tags @exato / @limitado / @aproximado. Se uma deformação empurrar Lipschitz acima de 1, divida a distância ou reduza o stepScale do raymarch.

Regras rígidas (essas quebram Shadertoy/WebGL)

  • Sem linha #version, sem uniforms personalizados, sem gl_FragColor / texture2D / iGlobalTime.
  • Sem ?: em structs. Use vec2(distância, id) ou if.
  • Escreva literais de ponto flutuante: 2.0 * PI, clamp(x, 0.0, 1.0).
  • Sem hashes fract(sin(...) * 43758.5453). Use hash12 / hash22 / hash33 (PCG inteiro). Substitua-os mesmo ao portar com "mantenha a aparência": o padrão exato do hash seno já difere entre GPUs, e um hash PCG nos mesmos IDs de célula inteira dá ao ruído a mesma aparência. check relata um hash seno como erro.
  • Proteja fontes de NaN: atan(0, 0), pow de negativos, sqrt de negativos, normalize(vec3(0)).
  • Mantenha dFdx / fwidth fora de branches e loops não uniformes, ou use um tamanho de pixel explícito.

Roteamento de referência

Leia apenas o que a tarefa precisa:

ArquivoLeia quando
references/subject-routing.mdcomeçando de um assunto ("uma água-viva", "montanhas"); mapeia nomes formais para assuntos
references/library-index.mdescolhendo funções: cada função da biblioteca com assinatura, exatidão e usos
references/sdf-library-guide.mdmodelagem: níveis de exatidão, blends, repetição verificada por vizinhos, limites de deformação, armadilhas WebGL
references/rendering-pipeline.mdrigs de iluminação, sombras/AO, céu e neblina, volumes, mapeamento de tom, AA, desempenho
references/noise-use-cases.mdescolhendo ruído Perlin/value/simplex/cellular, receitas fBm/ridged/billow/warp/híbridas, casos de uso em jogos e links de código-fonte primário
references/procedural-buildings.mdIDs de parcelas, volumetria de edifícios, recuos/telhados, filtragem de fachadas, repetição de cidade e integração com jogos
references/terrain-production.mdrepresentações de terreno, vales projetados, materiais de inclinação/altitude, limites de tracing, chunks e LOD
references/water-quality.mdágua oceânica/costeira de alta qualidade, derivadas de ondas, Fresnel/refração/absorção, espuma, predefinições e atualizações do lado do motor
references/shader-workflow.mdplanejando um shader complexo do início ao fim; lista de verificação de revisão
references/composition-and-debugging.mda imagem é mal lida, ou algo está visualmente errado
references/formula-cookbook.mdreceitas de múltiplas etapas: treliças de células modulares, síntese de terreno, composição orgânica
references/formula-code-couples-sdf.mdequação-para-código para recursos SDF orgânicos e modulares
references/formula-code-couples-terrain.mdcampos de altura, campos de densidade, acumulação, atmosfera
references/formula-code-couples-materials.mdmáscaras, paletas, termos de iluminação, polimento, movimento

Templates em templates/ são pontos de partida completos e verificados por renderização (galeria no README do repositório): 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 saída

Ao escrever um shader:

  • Entregue o código Shadertoy empacotado e pronto para colar com mainImage(out vec4 fragColor, in vec2 fragCoord).
  • Evite texturas a menos que o usuário as forneça.
  • Inclua chaves DEBUG_MODE e nomeie os controles artísticos como constantes no topo.
  • Termine com um pequeno guia de ajuste: quais constantes controlam escala, suavidade, cor, luz e movimento.
  • Informe se o shader foi verificado por compilação, e como.
  • Para edifícios/terreno/água, separe os recursos implementados das atualizações do lado do motor. Não chame um campo de altura de gerador de cavernas, uma janela de material de reentrância modelada, ou uma máscara de espuma/cáustica processual de simulação de fluido/luz.
  • Para solicitações de qualidade, declare o alvo e o orçamento, exponha predefinições/visualizações de depuração e inspecione a saída renderizada. Anote as predefinições importantes do template com // @variant QUALITY=3 (ou outra macro inteira definida) para que o CI compile e as renderize. Preserve o contato horizonte/costa e a filtragem temporal antes de adicionar detalhes.

Ao melhorar um shader existente:

  • Identifique seu modelo de renderização e gargalos.
  • Preserve sua intenção e interface.
  • Corrija a correção primeiro, depois legibilidade, qualidade visual e velocidade.
  • Destaque mudanças arriscadas (escala de coordenadas, ids de material, contagens de loop).

Habilidades Relacionadas