dnlgalleguillos/gauge-reference

Gauge-Referenz

„Mach es so aussehen wie dieses“ ist erst dann abgeschlossen, wenn eine Zahl es sagt. Dieses Skill verwandelt eine Referenz in Messungen, baut sie in einer isolierten Sammlung auf und vergleicht jedes Rendering mit dem Ziel.

Autoritätsreihenfolge

1. Was der Benutzer geschrieben hat (explizite Werte und Regeln).
2. Node-Screenshots: Sie bestimmen Verbindungen und Einstellungen.
3. Das Referenz-Rendering: Es bestimmt das Erscheinungsbild. Alles, was du eher schlussfolgerst als liest, ist eine Annahme: Liste es in deiner Antwort auf und lass den Benutzer bestätigen.

Arbeitsablauf

1. Beginne einen isolierten Arbeitsbereich: scripts/workspace.py action=begin name=match1 (speichert Kamera, Welt, Engine, Ansichtseinstellungen; erstellt die Sammlung).
2. Lies die Screenshots mit references/reading-node-screenshots.md: Schreibe den Graphen als Text (Node, Schlüsselwerte, Links), bevor du baust. Kleine Zahlen in einem Screenshot sind leicht falsch zu lesen; markiere die unsicheren.
3. Messe die Referenz: scripts/ref_report.py image=ref.png gibt die mittlere Luma, Kontrast, Beschneidung, Sättigung, eine Palette von sRGB-Hex mit Anteilen und eine 4x4-Schärfekarte (wo der Fokus liegt). scripts/ref_colors.py liest exakte Farben an Punkten; das Hex ist, was du siehst, linear ist, was in einen Shader geht.
4. Baue die Nodes mit gauge.node_build / gauge.gn_make (siehe gauge-materials, gauge-geonodes) und lies dann das Gebaute mit scripts/node_text.py erneut und vergleiche es mit deiner Transkription.
5. Rendere klein, dann scripts/ref_match.py image=mine.png reference=ref.png. Jeder fehlgeschlagene Check trägt eine Korrektur mit einer Zahl: Belichtung in Blendenstufen (Licht mit 2^-stops multiplizieren), Kontrastverhältnis, Farbton pro Kanal, struktureller Fehler.
6. Ändere eine Sache, rendere, messe erneut. Stoppe, wenn die Schranke passiert (Standard: Belichtung innerhalb von 0,35 Blendenstufen, Kontrastverhältnis 0,85–1,15, Farbton innerhalb von 0,04, Fehler <= 0,08).
7. Beende: workspace.py action=end stellt die Szene wieder her und listet auf, was es löschen würde; übergib confirm=true nur, wenn der Benutzer zustimmt.

Werkzeuge

Skript	Antworten
ref_report.py	Was ist in diesem Bild (und wie weit ist es von einem anderen entfernt)
ref_colors.py	Exakte Farbe an einem Punkt
ref_match.py	Ist mein Rendering nah genug und was soll geändert werden
node_text.py	Was enthält dieses Material / diese Gruppe / diese Welt / dieser Compositor-Baum
workspace.py	Anfang / Ende ohne ein Chaos zu hinterlassen

Regeln

• Gleiche zuerst die Struktur an (Bildausschnitt, Formen, Lichtrichtung), dann Farbe, zuletzt Details.
• Korrigiere die Belichtung vor der Farbe: Ein Fehler von einer Blendenstufe verschiebt jede Farbmessung.
• Ein Rendering bei 50 % Größe und 24 Samples reicht aus, um all das oben Genannte zu beurteilen.
• Referenzbilder mit Kompression oder einem anderen Gammawert sind nicht exakt: Vertraue der Palette und den Verhältnissen, nicht einzelnen Pixeln.