Communitygithub.com

dnlgalleguillos/gauge-light-render

Éclairage, cadrage et rendu d'un sujet Blender avec des résultats mesurés - structures adaptées à la taille du sujet, distance caméra résolue pour un cadrage cible, préréglages de rendu, plateaux tournants et une vérification du rendu pour l'exposition, le contraste, le recadrage et les lumières visibles dans le plan. Utilisé pour l'éclairage, la caméra, le développement du look et les rendus finaux.

Qu'est-ce que gauge-light-render ?

Cette compétence pour agents IA (Claude Code, Cursor, Codex) automatise le flux de travail d'éclairage, de cadrage et de rendu dans Blender, en se basant sur la taille réelle du sujet. Elle résout mathématiquement la distance de la caméra pour un remplissage cible (bisection), met en place des configurations d'éclairage paramétriques (trois points, softbox, dramatique, couvert), applique des préréglages de rendu (brouillon, aperçu, final) avec Cycles et denoising, et valide chaque rendu avec des métriques objectives (blancs écrasés, noirs bouchés, contraste, luminance, visibilité des lumières). Des portes (gates) bien définies rapportent les résultats (cadrage, ratio clé/remplissage, paramètres de rendu, contrôles de rendu) pour une intégration dans des pipelines automatisés ou des boucles de feedback d'agents. Un module de plateau tournant permet des rotations à 360° vérifiées. La compétence insiste sur les règles professionnelles : garder les lumières hors champ, utiliser AgX, et ne jamais lancer de rendu final depuis une session en direct (risque de crash).

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Gauge éclairage et rendu

L'éclairage et la caméra sont réglés en fonction de la taille du sujet, puis vérifiés sur un petit rendu.

1. Cadrage

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 est la part du cadre que le sujet occupe sur son côté limitant (largeur ou hauteur). La distance est résolue par bissection, la caméra regarde le centre du sujet, la profondeur de champ fait la mise au point sur lui. Porte camera-framing : devant la caméra, non recadré, tient dans les limites. Objectif plus long (85-135 mm) pour les produits et les portraits, 24-35 mm pour les intérieurs.

2. Lumière

run_blender_script path=skills/gauge-light-render/scripts/rig.py args={"subject":"Props","preset":"three_point","ground":true}
PréréglageCaractère
three_pointPrincipale + remplissage + contre-jour, usage général
softbox_productGrande lumière supérieure et deux bandes, bords spéculaires propres
dramaticPetite principale dure, contre-jour, presque pas de remplissage
overcastCiel doux, pas d'ombres dures

Les distances et les tailles s'adaptent au rayon du sujet, les puissances au carré de la distance, strength met tout à l'échelle. Les lumières sont invisibles pour la caméra. Porte light-rig indique le rapport clé/remplissage (plage utile 0.8-12 ; 3-4 est naturel).

3. Paramètres

scripts/render_preset.py avec preset = draft (16 échantillons, 50 %), preview (64, 75 %), final (256, 100 %) ; Cycles avec débruitage et AgX. Porte render-settings.

4. Vérification

scripts/render_check.py effectue le rendu et ouvre la porte render-check : blancs écrasés <= 2 %, noirs bouchés <= 10 %, contraste (p95-p5) >= 0.25, luminance moyenne 0.12-0.75, sujet entièrement dans le cadre, aucune lumière surfacique visible dans le plan. Ajoutez reference pour obtenir également la distance par rapport à une autre image. Lancez-le sans interface sur une copie sauvegardée : python skills/gauge-core/scripts/run_headless.py skills/gauge-light-render/scripts/render_check.py --blend scene.blend subject=Props.

Plateau tournant

scripts/turntable.py parente la caméra à un pivot au centre du sujet et la fait tourner sur 360 degrés à vitesse constante ; vérifié aux première, quart et dernière images ainsi qu'à frame_end + 1.

Règles

  • Grandes sources lumineuses = lumière douce. Dimensionnez la lumière principale environ à la taille du sujet, rapprochez-la pour adoucir.
  • Gardez toujours les lumières hors du champ de la caméra ; Blender 5.3 rend les lumières invisibles à la caméra, la porte le vérifie quand même.
  • La transformation de vue par défaut est AgX ; si les hautes lumières écrasent encore, baissez la lumière principale avant de toucher à l'exposition.
  • Rendu final : sauvegardez une copie, lancez sans interface, jamais depuis une session en direct (cela bloque Blender, et un crash perd la scène).
  • Look fil de fer : Workbench ignore le fil de fer dans les rendus ; ajoutez un modificateur Wireframe temporaire à la place.

Individual skills in this repo

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

Skills associés