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
- Alvo. Defina a imagem: assunto, câmera e enquadramento, formas dominantes, materiais, luz, movimento.
- 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). - Monte a partir da biblioteca. Encontre blocos de construção com
python3 scripts/glsl_tools.py search <palavras>oureferences/library-index.md, e chame-os pelo nome. Não cole ou rederive código da biblioteca; ele é testado. - Primeira imagem rápida. Coordenadas, fundo, uma primitiva, uma luz. Em seguida, adicione as visualizações de depuração.
- Refine em ordem: proporções, composição, separação de materiais, iluminação, atmosfera, cor, anti-aliasing, desempenho.
- Empacote e verifique.
python3 scripts/glsl_tools.py bundle shader.glsl -o out.glslinsere exatamente as funções usadas.python3 scripts/glsl_tools.py check out.glslfaz lint e compila com glslangValidator quando instalado. Corrija todos os erros e então entregueout.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)retornavec2(distância, idMaterial).raymarch,calcNormal,softShadow,calcAOesdfThicknessusam isso. - Depuração:
#define DEBUG_MODE 0com 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 (tonemapAgXpor padrão, por amostra AA), depois a média, depoislinearToSrgbuma vez, depoisditherTPDF. - Distâncias: respeite as tags
@exato/@limitado/@aproximado. Se uma deformação empurrar Lipschitz acima de 1, divida a distância ou reduza ostepScaledoraymarch.
Regras rígidas (essas quebram Shadertoy/WebGL)
- Sem linha
#version, sem uniforms personalizados, semgl_FragColor/texture2D/iGlobalTime. - Sem
?:em structs. Usevec2(distância, id)ouif. - Escreva literais de ponto flutuante:
2.0 * PI,clamp(x, 0.0, 1.0). - Sem hashes
fract(sin(...) * 43758.5453). Usehash12/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.checkrelata um hash seno como erro. - Proteja fontes de NaN:
atan(0, 0),powde negativos,sqrtde negativos,normalize(vec3(0)). - Mantenha
dFdx/fwidthfora 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:
| Arquivo | Leia quando |
|---|---|
references/subject-routing.md | começando de um assunto ("uma água-viva", "montanhas"); mapeia nomes formais para assuntos |
references/library-index.md | escolhendo funções: cada função da biblioteca com assinatura, exatidão e usos |
references/sdf-library-guide.md | modelagem: níveis de exatidão, blends, repetição verificada por vizinhos, limites de deformação, armadilhas WebGL |
references/rendering-pipeline.md | rigs de iluminação, sombras/AO, céu e neblina, volumes, mapeamento de tom, AA, desempenho |
references/noise-use-cases.md | escolhendo 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.md | IDs de parcelas, volumetria de edifícios, recuos/telhados, filtragem de fachadas, repetição de cidade e integração com jogos |
references/terrain-production.md | representaçõ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.md | planejando um shader complexo do início ao fim; lista de verificação de revisão |
references/composition-and-debugging.md | a imagem é mal lida, ou algo está visualmente errado |
references/formula-cookbook.md | receitas de múltiplas etapas: treliças de células modulares, síntese de terreno, composição orgânica |
references/formula-code-couples-sdf.md | equação-para-código para recursos SDF orgânicos e modulares |
references/formula-code-couples-terrain.md | campos de altura, campos de densidade, acumulação, atmosfera |
references/formula-code-couples-materials.md | má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_MODEe 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).