Communitygithub.com

dnlgalleguillos/gauge-light-render

Ilumine, enquadre e renderize um assunto no Blender com resultados medidos - rigs dimensionados para o assunto, distância da câmera resolvida para um enquadramento alvo, predefinições de render, mesas giratórias e uma verificação de render para exposição, contraste, corte e luzes visíveis no plano. Use para iluminação, câmera, desenvolvimento de look e renders finais.

O que é gauge-light-render?

Esta skill oferece um fluxo de trabalho automatizado e baseado em métricas para iluminação, enquadramento e renderização no Blender. Ela resolve automaticamente a distância da câmera para garantir que o assunto preencha uma determinada proporção do quadro (usando bissecção), define a profundidade de campo com base na distância focal e no abertura da lente, e configura um sistema de iluminação com vários presets (como três pontos, softbox e dramático). O tamanho e a potência das luzes são dimensionados automaticamente com base no raio e na distância do assunto, garantindo resultados consistentes. A skill também inclui predefinições de renderização (rascunho, pré-visualização e final) usando Cycles com desfoque e AgX para gerenciamento de cores, e executa uma verificação de renderização abrangente que identifica realces estourados, sombras esmagadas, baixo contraste, iluminação inadequada, corte do assunto e luzes visíveis no quadro. Suporta a execução headless em cópias salvas do projeto, geração de mesas giratórias e segue regras rigorosas sobre fontes de luz, transformações de visualização e boas práticas para renders finais. Destina-se a artistas de iluminação, desenvolvedores de look e usuários de Blender que desejam um pipeline de renderização previsível e verificável.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dnlgalleguillos/blender-gauge/tree/HEAD/skills/gauge-light-render

Perguntar na sua IA favorita

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

Documentação

Gauge light e render

A iluminação e a câmera são configuradas a partir do tamanho do assunto, depois verificadas em uma renderização pequena.

1. Enquadramento

run_blender_script path=skills/gauge-light-render/scripts/frame_camera.py
  args={"subject":"Props","lens":85,"azimuth":25,"elevation":18,"fill":0.55,"aperture":2.8}

fill é a parcela do quadro que o assunto ocupa em seu lado limitante (largura ou altura). A distância é resolvida por bissecção, a câmera olha para o centro do assunto, a Profundidade de Campo foca nele. Gate camera-framing: na frente da câmera, não cortada, dentro dos limites. Lentes mais longas (85-135 mm) para produtos e retratos, 24-35 mm para interiores.

2. Iluminação

run_blender_script path=skills/gauge-light-render/scripts/rig.py args={"subject":"Props","preset":"three_point","ground":true}
PresetPersonagem
three_pointchave + preenchimento + contorno, propósito geral
softbox_productluz superior grande e duas tiras, bordas especulares limpas
dramaticchave pequena e dura, contorno, quase sem preenchimento
overcastcéu suave, sem sombras duras

Distâncias e tamanhos escalam com o raio do assunto, potências com a distância ao quadrado, strength escala tudo. As luzes são invisíveis para a câmera. O gate light-rig relata a relação chave/preenchimento (faixa útil 0.8-12; 3-4 natural).

3. Configurações

scripts/render_preset.py com preset = draft (16 amostras, 50 %), preview (64, 75 %), final (256, 100 %); Cycles com denoising e AgX. Gate render-settings.

4. Verificação

scripts/render_check.py renderiza e faz gate render-check: brancos estourados <= 2 %, pretos esmagados <= 10 %, contraste (p95-p5) >= 0.25, luma média 0.12-0.75, assunto totalmente no quadro, nenhuma luz de área visível no plano. Adicione reference para também obter a distância para outra imagem. Execute-o headless em uma cópia salva: python skills/gauge-core/scripts/run_headless.py skills/gauge-light-render/scripts/render_check.py --blend scene.blend subject=Props.

Mesa giratória

scripts/turntable.py parenteia a câmera a um pivô no centro do assunto e a gira 360 graus a velocidade constante; verificado no primeiro, quarto e último quadros e em frame_end + 1.

Regras

  • Fontes de luz grandes = luz suave. Dimensione a chave aproximadamente no tamanho do assunto, aproxime-a para suavizar.
  • Sempre mantenha as luzes fora da vista da câmera; o Blender 5.3 cria luzes invisíveis para a câmera, o gate verifica de qualquer forma.
  • AgX é a transformação de visualização padrão; se os realces ainda estourarem, abaixe a chave antes de tocar na exposição.
  • Renders finais: salve uma cópia, execute headless, nunca de uma sessão ativa (isso bloqueia o Blender e uma falha perde a cena).
  • Visualização wireframe: o Workbench ignora wireframe em renders; adicione um modificador Wireframe temporário.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Habilidades Relacionadas