Reference Look Calibration
This skill handles the final visual match after geometry and UVs are locked. It must not compensate for wrong shape, wrong UVs, or wrong camera framing.
Inputs
- accepted geometry / UV fit reports;
- reference/original image(s);
- product preview render(s);
- optional mask overlays and multiview fit reports.
Metrics
Use scripts/look_fit_report.py to compare:
- object/bright-mask IoU and bbox extent;
- configured hue-band mask IoU for glow/accent assets;
- mean/std HSV and BGR under object mask;
- brightness p95 / mean;
- saturation mean;
- hue drift.
Calibration order
- Camera crop / orthographic scale — object extent must match before color tuning.
- World/background darkness.
- Base material hue/value/saturation.
- Emission strength and glow color.
- Aura/HUD ring color and thickness.
- Color management / exposure / gamma.
- Final render overlay and metrics.
Hard rules
- Do not tune lighting before geometry/UV fit gates pass.
- Do not change accent/glow hue away from the source reference unless the user explicitly asks.
- Do not hide mismatched geometry with bloom, fog, or overexposure.
- Write look metrics before and after calibration.
Handoff
Consumes validation/multiview_fit_report*.json and product previews. Produces validation/look_fit_report.json, look overlays, and updated material/light/render settings.