dnlgalleguillos/gauge-reference

Gauge reference

«Haz que se vea así» solo está terminado cuando un número lo dice. Esta habilidad convierte una referencia en mediciones, la construye en una colección aislada y compara cada render con el objetivo.

Orden de autoridad

1. Lo que el usuario escribió (valores y reglas explícitas).
2. Capturas de pantalla de nodos: ellas deciden conexiones y ajustes.
3. El render de referencia: él decide apariencia. Cualquier cosa que infieras en lugar de leer es una suposición: enumérala en tu respuesta y deja que el usuario la confirme.

Flujo de trabajo

1. Inicia un espacio de trabajo aislado: scripts/workspace.py action=begin name=match1 (guarda cámara, mundo, motor y ajustes de vista; crea la colección).
2. Lee las capturas de pantalla con references/reading-node-screenshots.md: escribe el grafo como texto (nodo, valores clave, enlaces) antes de construirlo. Los números pequeños en una captura son fáciles de leer mal; marca los inciertos.
3. Mide la referencia: scripts/ref_report.py image=ref.png proporciona luminancia media, contraste, recorte, saturación, una paleta de hex sRGB con porcentajes y un mapa de nitidez 4×4 (dónde está el enfoque). scripts/ref_colors.py lee colores exactos en puntos; el hex es lo que ves, linear es lo que entra en un shader.
4. Construye los nodos con gauge.node_build / gauge.gn_make (consulta gauge-materials, gauge-geonodes), luego vuelve a leer lo que construiste con scripts/node_text.py y compáralo con tu transcripción.
5. Renderiza pequeño, luego scripts/ref_match.py image=mine.png reference=ref.png. Cada verificación fallida lleva una corrección con un número: exposición en pasos (multiplica la luz por 2^-stops), ratio de contraste, tinte por canal, error estructural.
6. Cambia una cosa, renderiza, mide de nuevo. Detente cuando todas las comprobaciones pasen (valores por defecto: exposición dentro de 0.35 pasos, ratio de contraste 0.85-1.15, tinte dentro de 0.04, error <= 0.08).
7. Finaliza: workspace.py action=end restaura la escena y enumera lo que eliminaría; pasa confirm=true solo cuando el usuario esté de acuerdo.

Herramientas

Script	Responde a
ref_report.py	qué hay en esta imagen (y qué distancia tiene de otra)
ref_colors.py	color exacto en un punto
ref_match.py	si mi render se acerca lo suficiente y qué cambiar
node_text.py	qué contiene este material / grupo / mundo / árbol de composición
workspace.py	iniciar / finalizar sin dejar desorden

Reglas

• Iguala primero la estructura (encuadre, formas, dirección de la luz), después el color, y por último el detalle.
• Corrige la exposición antes que el color: un error de 1 paso desplaza todas las mediciones de color.
• Un render al 50 % de tamaño y con 24 muestras es suficiente para juzgar todo lo anterior.
• Las imágenes de referencia con compresión o una gamma diferente no son exactas: confía en la paleta y los ratios, no en píxeles individuales.