dnlgalleguillos/gauge-reference

Gauge reference

« Faire ressembler à cela » n'est terminé que lorsqu'un nombre le confirme. Cette compétence transforme une référence en mesures, construit dans une collection isolée, et compare chaque rendu à la cible.

Ordre d'autorité

1. Ce que l'utilisateur a écrit (valeurs et règles explicites).
2. Les captures d'écran des nœuds : elles décident des connexions et paramètres.
3. Le rendu de référence : il décide de l'apparence. Toute chose que vous déduisez plutôt que de lire est une hypothèse : listez-la dans votre réponse et laissez l'utilisateur confirmer.

Flux de travail

1. Débuter un espace de travail isolé : scripts/workspace.py action=begin name=match1 (sauvegarde la caméra, le monde, le moteur, les paramètres de vue ; crée la collection).
2. Lire les captures d'écran avec references/reading-node-screenshots.md : écrivez le graphe sous forme de texte (nœud, valeurs clés, liens) avant de construire. Les petits nombres dans une capture d'écran sont faciles à mal lire ; signalez les incertains.
3. Mesurer la référence : scripts/ref_report.py image=ref.png donne la luminance moyenne, le contraste, l'écrêtage, la saturation, une palette de couleurs hex sRGB avec parts et une carte de netteté 4x4 (où se trouve le focus). scripts/ref_colors.py lit les couleurs exactes à des points ; le hex est ce que vous voyez, linear est ce qui entre dans un shader.
4. Construire les nœuds avec gauge.node_build / gauge.gn_make (voir gauge-materials, gauge-geonodes), puis relire ce que vous avez construit avec scripts/node_text.py et le comparer à votre transcription.
5. Rendre petit, puis scripts/ref_match.py image=mine.png reference=ref.png. Chaque vérification échouée apporte une correction avec un nombre : exposition en stops (multiplier la lumière par 2^-stops), ratio de contraste, teinte par canal, erreur structurelle.
6. Modifier une chose, rendre, mesurer à nouveau. Arrêtez-vous lorsque le seuil est passé (par défaut : exposition dans 0,35 stop, ratio de contraste entre 0,85 et 1,15, teinte dans 0,04, erreur <= 0,08).
7. Fin : workspace.py action=end restaure la scène et liste ce qu'il supprimerait ; passez confirm=true uniquement lorsque l'utilisateur est d'accord.

Outils

Script	Réponses
ref_report.py	ce que contient cette image (et à quelle distance d'une autre)
ref_colors.py	couleur exacte à un point
ref_match.py	mon rendu est-il assez proche, et que modifier
node_text.py	que contient ce matériau / groupe / monde / arbre de compositeur
workspace.py	début / fin sans laisser de désordre

Règles

• Correspondre d'abord à la structure (cadrage, formes, direction de la lumière), la couleur ensuite, le détail en dernier.
• Corriger l'exposition avant la couleur : une erreur de 1 stop décale chaque mesure de couleur.
• Un rendu à 50 % de taille et 24 échantillons suffit pour juger tout ce qui précède.
• Les images de référence avec compression ou un gamma différent ne sont pas exactes : faites confiance à la palette et aux ratios, pas aux pixels individuels.