closed-surface-uv-coverage

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Closed Surface UV Coverage

闭合表面UV覆盖

This skill prevents a common false pass: a model looks textured from the front because it has a projected front image or curve overlays, but the closed surface has untextured back caps or plain sidewalls when viewed in a spin/turntable.

本技巧可避免常见的误判情况：模型从正面看似乎已完成纹理制作，因为它有投影的正面图像或曲线叠加层，但从旋转/转盘视角观察时，闭合表面的背面端面或侧壁是无纹理的。

Failure modes to catch

需要排查的失效模式

Back detail is only a floating plane or curve overlay, not a material/UV on the back surface.
Sidewalls have procedural color only; no side UV island, generated/object coordinate material, or baked strip.
A back projection covers only a center shape and leaves the actual silhouette/back mesh plain.
Side/back QA uses front-biased frames and misses edge-on/back-on samples.
Decorative HUD/aura is mistaken for surface texture coverage.

背面细节仅为浮动平面或曲线叠加层，而非背面表面上的材质/UV。
侧壁仅使用程序化颜色；没有侧面UV岛、基于生成/对象坐标的材质，或烘焙的条带纹理。
背面投影仅覆盖中心形状，实际轮廓/背面网格仍无纹理。
侧面/背面质检使用偏向正面的帧，遗漏了边缘视角/背面视角的样本。
装饰性HUD/光晕被误认为是表面纹理覆盖。

Required surface taxonomy

所需的表面分类

For extruded/logo-like assets, classify visible surfaces before look-dev:

```
front_cap
```
— canonical front texture/decal.
```
back_cap
```
— back texture, back linework, or baked/procedural fill mapped to the real back cap.
```
sidewall
```
— depth surface connecting front/back, with its own UV parameterization or procedural material.
```
overlay_context
```
— HUD/aura/circles; never counted as model surface coverage.

对于挤压或类Logo资产，在进行视觉开发前先对可见表面进行分类：

```
front_cap
```
— 标准正面纹理/贴花。
```
back_cap
```
— 映射到实际背面端面的背面纹理、背面线条，或烘焙/程序化填充。
```
sidewall
```
— 连接前后端面的深度表面，拥有独立的UV参数化或程序化材质。
```
overlay_context
```
— HUD/光晕/圆形效果；绝不计入模型表面覆盖范围。

Workflow

工作流程

Audit current coverage: list mesh material slots, UV layers, image texture nodes, and face counts for front/back/side material indices.
Reject overlay-only fixes: curves/planes may add rim accents, but they do not satisfy back/side fill unless the mesh surface beneath is also textured/materialized.
Create per-surface UVs:
- front/back caps: project local X/Z to UV 0–1 or map into a back/front atlas rectangle;
- sidewall: map perimeter arc length to U and depth/front-back coordinate to V;
- if a clean side texture is unavailable, use a generated procedural side material plus baked glow/edge strip and document it.
Assign true surface materials: back cap and sidewall mesh faces must have material nodes, active UVs, and/or generated coordinates. Optional curves are accents only.
Validate turntable frames: sample front, 45°, side/edge-on, back-on, opposite 45°, and rest. Back and side frames must show surface fill, not just outlines.

审核当前覆盖情况：列出网格材质槽、UV层、图像纹理节点，以及前后侧材质索引对应的面数。
拒绝仅用叠加层的修复方案：曲线/平面可用于添加边缘装饰，但除非下方网格表面也进行了纹理/材质处理，否则无法满足背面/侧面的填充要求。
创建分表面UV：
- 前后端面：将局部X/Z轴投影到UV 0–1范围，或映射到前后端面图集矩形中；
- 侧壁：将周长弧长映射到U轴，深度/前后坐标映射到V轴；
- 若没有清晰的侧面纹理，可使用生成式程序化侧面材质加上烘焙光晕/边缘条带，并做好记录。
分配真实表面材质：背面端面和侧壁网格面必须拥有材质节点、激活的UV和/或生成坐标。可选的曲线仅作为装饰。
验证转台帧：采样正面、45°角、侧面/边缘视角、背面视角、反向45°角及其他视角。背面和侧面帧必须显示表面填充效果，而非仅轮廓。

Acceptance gates

验收标准

Back cap mesh faces have either an image/procedural material with a declared UV/generated coordinate policy, not only separate curves.
Sidewall mesh faces have a sidewall material with UV/generated coordinates and visible depth treatment.
Overlay/context collections are excluded from coverage counts.
QA contact sheet includes back and edge-on frames.
A
```
surface_coverage_report.json
```
states which surfaces are image-textured, procedural, baked, or intentionally plain.

背面端面网格面需带有图像/程序化材质，并声明UV/生成坐标规则，不能仅依赖独立曲线。
侧壁网格面需带有侧壁材质，具备UV/生成坐标及可见的深度处理效果。
叠加层/上下文集合不计入覆盖范围统计。
质检联系表包含背面和边缘视角的帧。
需提供
```
surface_coverage_report.json
```
文件，说明哪些表面使用图像纹理、程序化材质、烘焙纹理，或故意保留无纹理状态。

Handoff

交接时机

Use after geometry is locked and before final material/look/animation acceptance. It complements

blender-uv-texturing

and

atlas-uv-fitting

: those skills explain UV/material setup; this skill enforces complete visible-surface coverage.

在几何体锁定后、最终材质/视觉效果/动画验收前使用。本技巧是

blender-uv-texturing

和

atlas-uv-fitting

的补充：那些技巧讲解UV/材质设置，而本技巧强制要求完整的可见表面覆盖。

Script

脚本

```
scripts/surface_texture_coverage_audit.py
```
audits selected mesh objects for UV layers, material image nodes, face material counts, and overlay-only warning patterns.

```
scripts/surface_texture_coverage_audit.py
```
：审核所选网格对象的UV层、材质图像节点、面材质计数，以及仅用叠加层的警告模式。