reference-look-calibration

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

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.

本技能用于在几何体和UV锁定后进行最终视觉匹配。不得用于补偿形状错误、UV错误或相机取景错误。

Inputs

输入

accepted geometry / UV fit reports;
reference/original image(s);
product preview render(s);
optional mask overlays and multiview fit reports.

已通过的几何体/UV适配报告；
参考/原始图像；
产品预览渲染图；
可选的遮罩叠加层和多视角适配报告。

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.

使用

scripts/look_fit_report.py

进行比较：

对象/亮部遮罩的IoU和边界框范围；
发光/强调资产的配置色调带遮罩IoU；
对象遮罩下的HSV和BGR均值/标准差；
亮度p95/均值；
饱和度均值；
色调偏移。

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.

相机裁切/正交缩放 — 在颜色调整前必须匹配对象范围。
场景/背景暗度。
基础材质的色调/明度/饱和度。
发光强度和光晕颜色。
光环/HUD环的颜色和厚度。
色彩管理/曝光/伽马（gamma）。
最终渲染叠加层和指标。

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.

在几何体/UV适配检查通过前不得调整灯光。
除非用户明确要求，否则不得更改强调/光晕的色调偏离源参考。
不得使用 bloom、雾或过度曝光来掩盖不匹配的几何体。
在校准前后记录外观指标。

Handoff

交接

Consumes

validation/multiview_fit_report*.json

and product previews. Produces

validation/look_fit_report.json

, look overlays, and updated material/light/render settings.

读取

validation/multiview_fit_report*.json

和产品预览图。生成

validation/look_fit_report.json

、外观叠加层以及更新后的材质/灯光/渲染设置。