Back to Details

multiview-fit-loop

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Multiview Fit Loop

多视图匹配循环

This skill closes the missing loop: render → compare → adjust → render again. It is mandatory when a user says the model still does not fit the templates/originals.
该技能填补了缺失的闭环环节：渲染 → 对比 → 调整 → 再次渲染。当用户表示模型仍无法匹配模板/原始参考时，必须使用此技能。

Required loop

必选循环流程

  1. Render flat, material-independent silhouettes for every available template view: front, side, back, top.
  2. Extract the template object mask, excluding labels, cyan guides, and background.
  3. Compare template vs render per view:
    • bbox center and size
    • centroid drift
    • silhouette coverage/IoU where modality is valid
    • visual overlay
  4. Convert measured deltas into model/camera/recipe adjustments.
  5. Rebuild or transform the model.
  6. Repeat until all hard gates pass or document the remaining conflict.
  1. 为所有可用的模板视图（前、侧、后、顶视图）渲染平面化、与材质无关的轮廓。
  2. 提取模板对象蒙版，排除标签、青色参考线及背景。
  3. 按视图对比模板与渲染结果：
    • bbox中心与尺寸
    • 质心偏移
    • 模态有效时的轮廓覆盖率/IoU
    • 可视化叠加层
  4. 将测量得到的差值转换为模型/相机/参数配置的调整方案。
  5. 重建或变换模型。
  6. 重复上述步骤，直至所有硬性验证标准通过，或记录剩余冲突。

Constraint inconsistency gate

约束不一致检查环节

Before forcing adjustments, check whether the supplied orthographic templates are mutually consistent. A single rigid 3D model cannot simultaneously satisfy contradictory physical ratios, for example if side view says total depth is 0.39 of height but top view says depth is 0.98 of width. When this occurs, stop claiming final fit, write a conflict report, and create separate variants or ask which view is canonical.
在强制调整之前，需检查提供的正交视图模板是否相互一致。单个刚性3D模型无法同时满足矛盾的物理比例，例如侧视图显示总深度为高度的0.39倍，但顶视图显示深度为宽度的0.98倍。出现这种情况时，停止宣称最终匹配完成，撰写冲突报告，并创建单独的变体模型或询问用户以确定哪个视图为标准视图。

Hard gates

硬性验证标准

  • all required views have validation reports and overlays;
  • bbox center drift <= 1.5% of image width;
  • bbox size drift <= 3% for front, <= 5% for side/top/back first-pass depth;
  • structural part count exact;
  • texture UV regions still valid after geometry changes.
  • 所有必填视图均具备验证报告及叠加层；
  • bbox中心偏移量 ≤ 图像宽度的1.5%；
  • 前视图bbox尺寸偏移量 ≤ 3%，侧/顶/后视图首次深度偏移量 ≤ 5%；
  • 结构部件数量完全匹配；
  • 几何变更后纹理UV区域仍保持有效。

View mask rule

视图蒙版规则

For annotated wireframes, choose a template mask mode that isolates the intended construction/object lines and excludes guide colors, labels, captions, and background annotations. For Blender validation renders, use a flat white silhouette on black, not beauty renders with glow/context elements.
对于带注释的线框，选择可隔离目标结构/对象线条的模板蒙版模式，排除参考线颜色、标签、说明文字及背景注释。对于Blender验证渲染，使用黑底白轮廓的平面渲染，而非带有光晕/环境元素的美观渲染。

Scripts

脚本

  • scripts/multiview_fit_report.py
    compares view pairs and writes JSON + overlays.
  • scripts/multiview_fit_report.py
    compares view pairs and writes JSON + overlays.

Adjustment rule

调整规则

Prefer changing recipe parameters or source geometry over camera scale tricks. Camera scale may be used only after model dimensions are correct.
优先调整参数配置或源几何结构，而非使用相机缩放技巧。仅当模型尺寸正确后，才可使用相机缩放。