atlas-uv-fitting

Atlas UV 贴图

此技能的存在，是因为指定纹理材质并不等同于贴合纹理。

补充贴图检查规则

不要盲目地将自发光／粗糙度／凹凸／光照贴图连接到每个使用图集映射的部件上。首先确认补充贴图与底色具有相同的 UV 布局和语义区域。如果贴图包含光环点、引导标记、光照贴图色块，或部件以外的装饰，就不要将其连接到该网格；改用恒定粗糙度／凹凸值，并使用显式的边缘／发光几何体。

硬性规则

• 图集纹理必须按区域映射；切勿将完整图集应用于每个结构网格。
• 正面朝向的主体表面使用正面投影 UV 或源区域矩形。
• 侧面／背面使用各自的 UV 孤岛或程序化／烘焙填充。
• 粗糙度、凹凸、法线、AO 和光照贴图图像均设为 Non-Color。
• Alpha 贴花必须使用 Alpha 连接材质，且不得使用黑色衬底平面。
• 除非明确要求，基础 GLB 不应包含参考平面或可选光环。

工作流

1. 对底色／贴花／光环图集运行 scripts/atlas_region_detector.py。
2. 在 atlas_regions.json 中为区域指定语义名称。
3. 为每个网格创建／激活 UV 映射。
4. 将局部 0-1 UV 重新映射到相应的图集矩形。
5. 检查 GLB／导出材质节点图：Principled BSDF + Image Texture 节点。
6. 导出前渲染纹理叠加验证图。

摘要来源

• Blender UV/Image Texture 节点使用 UV 映射来输出渲染／导出的纹理。
• Blender 烘焙需要 UV 映射和活动图像目标。
• Blender glTF 导出器使用 Principled BSDF、UV、纹理和法线时最可靠。
• Khronos glTF PBR：底色、金属度／粗糙度和法线贴图是标准通道。

语义图集映射

区域检测结果仅是候选列表。对于源素材锁定的工作，请创建 atlas_part_map.json，将每个结构部件名称绑定到恰好一个图集区域，或声明为 procedural/no_texture。

映射顺序：

1. 从底色／贴花／光照贴图中检测候选区域。
2. 除非目标是环境／光环，否则排除装饰、光环和复合预览区域。
3. 按角色、宽高比和相对尺寸匹配结构部件。
4. 自动分配 UV 前，手动重命名含义模糊的区域。
5. 连接粗糙度／凹凸／自发光／光照贴图前，确认补充贴图具有相同的区域布局。

除非网格是单张玫瑰花饰片，否则不要将完整的玫瑰花饰／复合图集区域映射到单个花瓣上。单个网格需要各自对应的源区域。

附加脚本

• scripts/atlas_region_mapper.py 会根据宽高比／尺寸相似度，提出部件→图集区域的映射建议。请将输出视为草稿；语义名称仍应优先。