Skip to content

A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.

feat(art): add reversible Qinglan face candidate and review evidence

yhhc5d980ca8a59
diff --git a/art/characters/qinglan/README.md b/art/characters/qinglan/README.md
index 38e04bbb7..5c6163ff4 100644
--- a/art/characters/qinglan/README.md
+++ b/art/characters/qinglan/README.md
@@ -4,12 +4,15 @@
用户已否决 `face-study-v3` 的脸部效果。该版本保留用于定位变形问题和回退,不应作为后续细节制作的造型基础;见 [脸部审查记录](face-study-v3/review/art-review.json)。网格与导出检查通过不能代表人物造型合格。
-本轮按「先把人做好」的方向,优先处理人体和脸部:保留完整的参数化人体来源,修正手臂摆姿对大腿的误影响,调整下颌、面颊、鼻唇与杏眼比例,补充贴合眼睑的眉毛和睫毛。人物检查使用无遮发的正面、侧面、四分之三视图,以及完整人体正侧面。
+最新脸部候选位于 [face-study-v5](face-study-v5/README.md)。本版改用 Blender 官方 CC0 女性基网格,实际接入 Scenario 的 Blender、雕刻与拓扑技能,保留原作者的多级雕刻数据及分区可撤销修改。当前仍需继续修正五官气质与参考接近程度,未进入服装或精细表面制作。
+
+此前的人体版本保留了参数化人体来源、手臂姿态、眉毛及睫毛试作。相关文件用于过程记录;最新 V5 是独立脸部候选,下方完整角色与导出说明对应此前版本。
## 文件
| 文件 | 用途 |
| --- | --- |
+| `face-study-v5/qinglan-face-candidate.blend` | 最新可编辑脸部候选、11 个分区形态键及灰模/拓扑检查;尚未美术验收 |
| `qinglan-human-study.blend` | 完整人体与独立头部检查场景;灰色区域是检查材质,不是服装网格 |
| `qinglan-highpoly.blend` | 带完整衣饰、头发、佩剑的高模,保留多级细分、曲线和来源集合 |
| `export/qinglan-static.glb` | 12 个语义部件的静态检查模型,包含贴图 |
diff --git a/art/characters/qinglan/face-study-v5/README.md b/art/characters/qinglan/face-study-v5/README.md
new file mode 100644
index 000000000..ae968359d
--- /dev/null
+++ b/art/characters/qinglan/face-study-v5/README.md
@@ -0,0 +1,40 @@
+# 青岚脸部候选 · V5
+
+当前阶段是脸部比例与结构评审,尚未通过仙侠角色的造型验收。主文件为 `qinglan-face-candidate.blend`;正面、侧面、三分之四及低角度检查位于 `review/`。
+
+## 本版方法
+
+以 Blender 官方 Human Base Meshes v1.4.1 中 Dan Ulrich 制作的女性写实基网格为来源,保留其 Multires 雕刻细节。该资产集合的许可证元数据与随包 README 均为 CC0。没有使用游戏提取网格。
+
+实际调用的三个技能为 `scenario-blender-expert`、`scenario-blender-sculpting`、`scenario-blender-retopology`,固定版本 `d44410f058991f677ccf733a8e86ce95110857eb`。流程为:成熟人头来源 → 带保护遮罩的局部网格修改 → 可撤销形态键 → 固定视角灰模 → 实际控制网格及渲染网格检查。没有使用全头插值拟合、自动生成角色服务或 computer use。
+
+`Qinglan_Head_Multires` 是可编辑来源,保留 11 个分区形态键。`Basis_Studio_Female` 为原始女性基础形状。为保留原作者的 Multires 网格数据,身体控制网格仍在此对象内,头部以下由 Mask 隐藏;局部修改对保护区域的位移为零。最后的几何节点仅整理开放的颈部连接边界,不改变来源控制点。
+
+`Inspection_Cage` 和 `Inspection_High` 集合默认隐藏,是检查时的几何快照,不会随着来源形态键自动更新。修改形态键后需重新运行 `scripts/verify_review.py` 更新检查快照。直接编辑应使用 `Qinglan_Head_Multires`。
+
+## 检查与限制
+
+- `review/face-review.png`:中性材质三视图。
+- `review/reference-comparison.png`:参考与实际几何的正面对照;参考并非标定摄影,不能当作精确重建误差图。
+- `review/topology/review_sheet.png`:实际控制边线。
+- `review/clay/review_sheet.png`:没有虹膜材质影响的剪影与灰模。
+- `review/edit-report.json`:每次局部改动的范围、最大位移和保护区域。
+- `review/verification.json`:重新打开文件后的形态键、拓扑和头部渲染检查。
+
+头部渲染检查的通过仅覆盖网格交付项目,不表示角色已美术验收,也不表示已完成面部表情、闭眼、口腔变形、眼部材质、游戏运行时导出或 Estella 验收。高密度自交检查与低模口腔相接部位需要单独复核,详见检查文件;本版不能作为可发布游戏角色。
+
+控制网格的交叉面逐对与原始基网格对比:原始 57 对,本版 55 对,新增 0 对。剩余相接不是清理完成的证据。高密度网格的自交检查因密度限制未执行;其检查报告中的 `null` 表示未检查。开放颈部边界仅作为头部连接处,尚未制作最终胸像切面。
+
+目前与参考的差距仍包括眼睑气质、鼻唇细腻程度和整体身份特征。该版本的目的在于提供可靠且可回退的脸部来源,不推进衣饰、毛孔或其他表面细节来掩盖这些差距。
+
+## 重建
+
+环境为 Blender 5.2.1 LTS、上述三项已安装技能和用于检查图排版的 Matplotlib。全流程后台运行,不打开可见应用。打开交付的 `.blend` 不需要下载来源文件或安装插件;参考图已打包。
+
+重新从来源构建时,下载 [官方 Human Base Meshes v1.4.1](https://download.blender.org/demo/asset-bundles/human-base-meshes/human-base-meshes-bundle-v1.4.1.zip),解压后运行:
+
+```powershell
+./scripts/build.ps1 -SourceBundle 'D:\path\human_base_meshes_bundle.blend'
+```
+
+来源许可说明见 [Blender 官方资源页](https://www.blender.org/download/demo-files/),技能见 [Scenario Blender skills](https://github.com/scenario-labs/skills/tree/main/skills/dcc/blender)。真实笔刷精修需要已连接的 Blender MCP 会话;当前后台流程完成的是可编辑的脸部结构候选。
diff --git a/art/characters/qinglan/face-study-v5/provenance.json b/art/characters/qinglan/face-study-v5/provenance.json
new file mode 100644
index 000000000..5c0319d7c
--- /dev/null
+++ b/art/characters/qinglan/face-study-v5/provenance.json
@@ -0,0 +1,54 @@
+{
+ "asset": "Qinglan face geometry candidate V5",
+ "status": "editable_candidate_not_art_approved",
+ "created": "2026-10-29",
+ "source": {
+ "publisher": "Blender",
+ "bundle": "Human Base Meshes v1.4.1",
+ "page": "https://www.blender.org/download/demo-files/",
+ "download": "https://download.blender.org/demo/asset-bundles/human-base-meshes/human-base-meshes-bundle-v1.4.1.zip",
+ "author": "Dan Ulrich",
+ "collection": "Body Female - Realistic",
+ "objects": [
+ "GEO-body_female_realistic",
+ "GEO-body_female_realistic.eye.L",
+ "GEO-body_female_realistic.eye.R"
+ ],
+ "license": "CC0-1.0",
+ "license_evidence": "Selected asset collection metadata and the bundle's Human Base Meshes README both state CC0. No Rain Rig objects were imported.",
+ "zip_sha256": "811f43accbb31a88266d932f8f5563b2d13586fca0ba2693aad1f5fe582b3515",
+ "blend_sha256": "3c121505651140ceb4d69fd1d8923f7788ffadd81672f5be14845a5f2c75c137"
+ },
+ "workflow_tools": {
+ "blender": "5.2.1 LTS",
+ "skill_repository": "https://github.com/scenario-labs/skills",
+ "skill_revision": "d44410f058991f677ccf733a8e86ce95110857eb",
+ "skill_license": "MIT",
+ "skills": [
+ "scenario-blender-expert",
+ "scenario-blender-sculpting",
+ "scenario-blender-retopology"
+ ],
+ "used_helpers": [
+ "bx_sculpt.Sculptor",
+ "bx_sculpt.write_shape_key",
+ "bx_sculpt.final_render",
+ "bx_review.review",
+ "bx_retopo.topology_report",
+ "bx_audit.audit",
+ "bx_audit.deliverable"
+ ],
+ "execution": "Headless Blender CLI and data-level mesh edits; no computer use and no live sculpt-brush operations."
+ },
+ "reference": {
+ "file": "../references/qinglan-face-target.png",
+ "use": "Working visual design, packed into the blend; not calibrated photographic reconstruction.",
+ "game_influence": "Beautiful adult xianxia female character; no extracted game meshes or game textures used."
+ },
+ "adaptation": {
+ "method": "11 independently reversible local shape-key deltas, compact protection masks, preserved source Multires grids and eye globes.",
+ "eye_cavity_protection": "Eye-aperture edits fade to zero behind the visible lid region; control-cage intersection pairs compared to the source.",
+ "body": "Original body controls retained only to preserve Multires data, protected from local edits and hidden after Multires.",
+ "inspection_snapshots": "Hidden cage and high-surface collections are static verification snapshots; edit Qinglan_Head_Multires and regenerate them."
+ }
+}
diff --git a/art/characters/qinglan/face-study-v5/qinglan-face-candidate.blend b/art/characters/qinglan/face-study-v5/qinglan-face-candidate.blend
new file mode 100644
index 000000000..a92a062c4
Binary files /dev/null and b/art/characters/qinglan/face-study-v5/qinglan-face-candidate.blend differ
diff --git a/art/characters/qinglan/face-study-v5/review/art-review.json b/art/characters/qinglan/face-study-v5/review/art-review.json
new file mode 100644
index 000000000..5da0f5ce8
--- /dev/null
+++ b/art/characters/qinglan/face-study-v5/review/art-review.json
@@ -0,0 +1,44 @@
+{
+ "asset": "qinglan-face-candidate.blend",
+ "review_date": "2026-10-29",
+ "status": "needs_revision",
+ "user_approved": false,
+ "stage": "Editable face structure candidate; not a finished xianxia character",
+ "evidence": [
+ "face-review.png",
+ "reference-comparison.png",
+ "front.png",
+ "profile.png",
+ "threequarter.png",
+ "low.png",
+ "topology/review_sheet.png",
+ "clay/review_sheet.png"
+ ],
+ "usable_progress": [
+ "Original artist-authored quad control topology and Multires detail are preserved.",
+ "Local edits are separated into 11 reversible shape keys; protected body controls remain unchanged.",
+ "Eye-aperture edit now protects the internal socket; it adds no control-cage intersection pairs relative to the source.",
+ "Nose, lips, cheek and lower-jaw changes can be inspected from front, profile and three-quarter under neutral lighting."
+ ],
+ "weakest_link": "Eye shape and gaze still read as a generic mannequin rather than the intended refined xianxia face.",
+ "remaining_art_issues": [
+ "Upper and lower lids need more deliberate curvature, canthal placement and fit around the eyeballs.",
+ "Nasal tip, nostril rims and philtrum need finer coordinated shaping against the working reference.",
+ "Lip contour and chin-to-cheek transition remain firmer and more generic than the reference.",
+ "Temporary iris and pupil patches are inspection aids, not final eye anatomy or shading.",
+ "The open neck attachment is an isolated-head study boundary, not a finished bust base."
+ ],
+ "technical_limits": {
+ "head_render_gate": "passed; does not imply art acceptance or game readiness",
+ "control_cage_intersections": "55 overlapping face pairs remain, all also present in the original source; zero newly introduced pairs",
+ "dense_surface_self_intersections": "not checked by the skill audit because the mesh exceeds its face-count threshold",
+ "not_validated": [
+ "expression deformation",
+ "blink and mouth closure",
+ "rigging and skinning",
+ "game topology and runtime budget",
+ "Estella and device acceptance"
+ ]
+ },
+ "next_work": "Continue on the editable face source, concentrating on eye/lid structure and the nose-lip region before clothing or surface texture. The installed sculpting skill places client-quality brush finishing in a live Blender session via MCP; the bridge was unavailable at this checkpoint. No computer use was used."
+}
diff --git a/art/characters/qinglan/face-study-v5/review/clay/matcap_front.png b/art/characters/qinglan/face-study-v5/review/clay/matcap_front.png
new file mode 100644
index 000000000..f020755b1
Binary files /dev/null and b/art/characters/qinglan/face-study-v5/review/clay/matcap_front.png differ
diff --git a/art/characters/qinglan/face-study-v5/review/clay/matcap_low.png b/art/characters/qinglan/face-study-v5/review/clay/matcap_low.png
new file mode 100644
index 000000000..fb872d467
Binary files /dev/null and b/art/characters/qinglan/face-study-v5/review/clay/matcap_low.png differ
diff --git a/art/characters/qinglan/face-study-v5/review/clay/matcap_right.png b/art/characters/qinglan/face-study-v5/review/clay/matcap_right.png
new file mode 100644
index 000000000..eb1770adf
Binary files /dev/null and b/art/characters/qinglan/face-study-v5/review/clay/matcap_right.png differ
diff --git a/art/characters/qinglan/face-study-v5/review/clay/matcap_threequarter.png b/art/characters/qinglan/face-study-v5/review/clay/matcap_threequarter.png
new file mode 100644
index 000000000..ab43b0635
Binary files /dev/null and b/art/characters/qinglan/face-study-v5/review/clay/matcap_threequarter.png differ
diff --git a/art/characters/qinglan/face-study-v5/review/clay/review_sheet.png b/art/characters/qinglan/face-study-v5/review/clay/review_sheet.png
new file mode 100644
index 000000000..b3b5f68ea
Binary files /dev/null and b/art/characters/qinglan/face-study-v5/review/clay/review_sheet.png differ
diff --git a/art/characters/qinglan/face-study-v5/review/clay/review_sheet_legend.txt b/art/characters/qinglan/face-study-v5/review/clay/review_sheet_legend.txt
new file mode 100644
index 000000000..12580174d
--- /dev/null
+++ b/art/characters/qinglan/face-study-v5/review/clay/review_sheet_legend.txt
@@ -0,0 +1,9 @@
+rows x cols (top-left first):
+silhouette / front
+silhouette / right
+silhouette / threequarter
+silhouette / low
+matcap / front
+matcap / right
+matcap / threequarter
+matcap / low
\ No newline at end of file
diff --git a/art/characters/qinglan/face-study-v5/review/clay/silhouette_front.png b/art/characters/qinglan/face-study-v5/review/clay/silhouette_front.png
new file mode 100644
index 000000000..1a95460d9
Binary files /dev/null and b/art/characters/qinglan/face-study-v5/review/clay/silhouette_front.png differ
diff --git a/art/characters/qinglan/face-study-v5/review/clay/silhouette_low.png b/art/characters/qinglan/face-study-v5/review/clay/silhouette_low.png
new file mode 100644
index 000000000..19b9665e4
Binary files /dev/null and b/art/characters/qinglan/face-study-v5/review/clay/silhouette_low.png differ
diff --git a/art/characters/qinglan/face-study-v5/review/clay/silhouette_right.png b/art/characters/qinglan/face-study-v5/review/clay/silhouette_right.png
new file mode 100644
index 000000000..1c51dd394
Binary files /dev/null and b/art/characters/qinglan/face-study-v5/review/clay/silhouette_right.png differ
diff --git a/art/characters/qinglan/face-study-v5/review/clay/silhouette_threequarter.png b/art/characters/qinglan/face-study-v5/review/clay/silhouette_threequarter.png
new file mode 100644
index 000000000..2532f937d
Binary files /dev/null and b/art/characters/qinglan/face-study-v5/review/clay/silhouette_threequarter.png differ
diff --git a/art/characters/qinglan/face-study-v5/review/clay/threequarter-90mm.png b/art/characters/qinglan/face-study-v5/review/clay/threequarter-90mm.png
new file mode 100644
index 000000000..3822dc6ff
Binary files /dev/null and b/art/characters/qinglan/face-study-v5/review/clay/threequarter-90mm.png differ
diff --git a/art/characters/qinglan/face-study-v5/review/edit-report.json b/art/characters/qinglan/face-study-v5/review/edit-report.json
new file mode 100644
index 000000000..c995fec93
--- /dev/null
+++ b/art/characters/qinglan/face-study-v5/review/edit-report.json
@@ -0,0 +1,259 @@
+{
+ "stages": [
+ {
+ "name": "01_Soften_brow",
+ "center": [
+ 0.01600000075995922,
+ -0.13784480094909668,
+ 1.5479999780654907
+ ],
+ "radius_m": 0.024,
+ "delta": [
+ 0,
+ 0.0018,
+ -0.0005
+ ],
+ "scale": null,
+ "depth_protection": null,
+ "affected_vertices": 283,
+ "unchanged_vertices": 10299,
+ "protected_vertices": 6943,
+ "protected_delta_mm": 0,
+ "max_delta_mm": 1.8246565570262168
+ },
+ {
+ "name": "02_Nose_width",
+ "center": [
+ 0.0,
+ -0.1652541160583496,
+ 1.4980000257492065
+ ],
+ "radius_m": 0.026,
+ "delta": null,
+ "scale": [
+ 0.78,
+ 1,
+ 1
+ ],
+ "depth_protection": null,
+ "affected_vertices": 239,
+ "unchanged_vertices": 10343,
+ "protected_vertices": 6943,
+ "protected_delta_mm": 0,
+ "max_delta_mm": 1.2695975535089894
+ },
+ {
+ "name": "03_Nose_projection",
+ "center": [
+ 0.0,
+ -0.1671433448791504,
+ 1.503999948501587
+ ],
+ "radius_m": 0.022,
+ "delta": [
+ 0,
+ 0.0022,
+ 0
+ ],
+ "scale": null,
+ "depth_protection": null,
+ "affected_vertices": 102,
+ "unchanged_vertices": 10480,
+ "protected_vertices": 6943,
+ "protected_delta_mm": 0,
+ "max_delta_mm": 2.166103338911901
+ },
+ {
+ "name": "04_Mouth_width",
+ "center": [
+ 0.0,
+ -0.15564846992492676,
+ 1.4700000286102295
+ ],
+ "radius_m": 0.03,
+ "delta": null,
+ "scale": [
+ 0.91,
+ 1,
+ 1
+ ],
+ "depth_protection": null,
+ "affected_vertices": 563,
+ "unchanged_vertices": 10019,
+ "protected_vertices": 6943,
+ "protected_delta_mm": 0,
+ "max_delta_mm": 0.6611821654816333
+ },
+ {
+ "name": "05_Lip_projection",
+ "center": [
+ 0.0,
+ -0.15321731567382812,
+ 1.468000054359436
+ ],
+ "radius_m": 0.021,
+ "delta": [
+ 0,
+ 0.0012,
+ 0
+ ],
+ "scale": null,
+ "depth_protection": null,
+ "affected_vertices": 181,
+ "unchanged_vertices": 10401,
+ "protected_vertices": 6943,
+ "protected_delta_mm": 0,
+ "max_delta_mm": 1.1794513534570394
+ },
+ {
+ "name": "06_Jaw_taper",
+ "center": [
+ 0.05700000002980232,
+ -0.1005101203918457,
+ 1.4639999866485596
+ ],
+ "radius_m": 0.043,
+ "delta": [
+ -0.0036,
+ 0,
+ 0
+ ],
+ "scale": null,
+ "depth_protection": null,
+ "affected_vertices": 256,
+ "unchanged_vertices": 10326,
+ "protected_vertices": 6943,
+ "protected_delta_mm": 0,
+ "max_delta_mm": 3.5892543635796734
+ },
+ {
+ "name": "07_Chin_width",
+ "center": [
+ 0.0,
+ -0.14474129676818848,
+ 1.4450000524520874
+ ],
+ "radius_m": 0.035,
+ "delta": null,
+ "scale": [
+ 0.85,
+ 1,
+ 1
+ ],
+ "depth_protection": null,
+ "affected_vertices": 601,
+ "unchanged_vertices": 9981,
+ "protected_vertices": 6943,
+ "protected_delta_mm": 0,
+ "max_delta_mm": 1.2863791844430623
+ },
+ {
+ "name": "08_Cheek_softness",
+ "center": [
+ 0.041999999433755875,
+ -0.13443708419799805,
+ 1.5010000467300415
+ ],
+ "radius_m": 0.032,
+ "delta": [
+ 0,
+ -0.0015,
+ 0
+ ],
+ "scale": null,
+ "depth_protection": null,
+ "affected_vertices": 374,
+ "unchanged_vertices": 10208,
+ "protected_vertices": 6943,
+ "protected_delta_mm": 0,
+ "max_delta_mm": 1.4669430207712164
+ },
+ {
+ "name": "09_Eye_aperture",
+ "center": [
+ 0.032999999821186066,
+ -0.10571980476379395,
+ 1.534999966621399
+ ],
+ "radius_m": 0.026,
+ "delta": null,
+ "scale": [
+ 1.23,
+ 1,
+ 1.08
+ ],
+ "depth_protection": [
+ -0.123,
+ -0.108
+ ],
+ "affected_vertices": 493,
+ "unchanged_vertices": 10089,
+ "protected_vertices": 6943,
+ "protected_delta_mm": 0,
+ "max_delta_mm": 0.5436212236320836
+ },
+ {
+ "name": "10_Lower_face_proportion",
+ "method": "Masked lower-jaw scale about the mouth; compact band",
+ "scale": [
+ 1,
+ 1,
+ 0.72
+ ],
+ "affected_vertices": 762,
+ "unchanged_vertices": 9820,
+ "protected_vertices": 9812,
+ "protected_delta_mm": 0,
+ "max_delta_mm": 13.65955564428778
+ },
+ {
+ "name": "11_Nasal_tip",
+ "center": [
+ 0.0,
+ -0.16490674018859863,
+ 1.5049999952316284
+ ],
+ "radius_m": 0.024,
+ "delta": [
+ 0,
+ 0,
+ -0.0055
+ ],
+ "scale": null,
+ "depth_protection": null,
+ "affected_vertices": 128,
+ "unchanged_vertices": 10454,
+ "protected_vertices": 6943,
+ "protected_delta_mm": 0,
+ "max_delta_mm": 5.318127645062898
+ }
+ ],
+ "eyes": [
+ {
+ "name": "GEO-body_female_realistic.eye.L",
+ "center": [
+ 0.032859278842806816,
+ -0.12403267994523048,
+ 1.6024056673049927
+ ],
+ "radii": [
+ 0.011999053880572319,
+ 0.012186940759420395,
+ 0.013212323188781738
+ ]
+ },
+ {
+ "name": "GEO-body_female_realistic.eye.R",
+ "center": [
+ -0.03288150578737259,
+ -0.12384172156453133,
+ 1.602405309677124
+ ],
+ "radii": [
+ 0.012002263218164444,
+ 0.012197863310575485,
+ 0.013212323188781738
+ ]
+ }
+ ]
+}
\ No newline at end of file
diff --git a/art/characters/qinglan/face-study-v5/review/face-review.png b/art/characters/qinglan/face-study-v5/review/face-review.png
new file mode 100644
index 000000000..45f96138a
Binary files /dev/null and b/art/characters/qinglan/face-study-v5/review/face-review.png differ
diff --git a/art/characters/qinglan/face-study-v5/review/front.png b/art/characters/qinglan/face-study-v5/review/front.png
new file mode 100644
index 000000000..bae225093
Binary files /dev/null and b/art/characters/qinglan/face-study-v5/review/front.png differ
diff --git a/art/characters/qinglan/face-study-v5/review/low.png b/art/characters/qinglan/face-study-v5/review/low.png
new file mode 100644
index 000000000..ce3a72813
Binary files /dev/null and b/art/characters/qinglan/face-study-v5/review/low.png differ
diff --git a/art/characters/qinglan/face-study-v5/review/profile.png b/art/characters/qinglan/face-study-v5/review/profile.png
new file mode 100644
index 000000000..9aaf9fdc6
Binary files /dev/null and b/art/characters/qinglan/face-study-v5/review/profile.png differ
diff --git a/art/characters/qinglan/face-study-v5/review/reference-comparison.png b/art/characters/qinglan/face-study-v5/review/reference-comparison.png
new file mode 100644
index 000000000..77398971c
Binary files /dev/null and b/art/characters/qinglan/face-study-v5/review/reference-comparison.png differ
diff --git a/art/characters/qinglan/face-study-v5/review/threequarter.png b/art/characters/qinglan/face-study-v5/review/threequarter.png
new file mode 100644
index 000000000..c2d892d1b
Binary files /dev/null and b/art/characters/qinglan/face-study-v5/review/threequarter.png differ
diff --git a/art/characters/qinglan/face-study-v5/review/topology/review_sheet.png b/art/characters/qinglan/face-study-v5/review/topology/review_sheet.png
new file mode 100644
index 000000000..90a7b8958
Binary files /dev/null and b/art/characters/qinglan/face-study-v5/review/topology/review_sheet.png differ
diff --git a/art/characters/qinglan/face-study-v5/review/topology/review_sheet_legend.txt b/art/characters/qinglan/face-study-v5/review/topology/review_sheet_legend.txt
new file mode 100644
index 000000000..bb5bbf452
--- /dev/null
+++ b/art/characters/qinglan/face-study-v5/review/topology/review_sheet_legend.txt
@@ -0,0 +1,5 @@
+rows x cols (top-left first):
+wire / front
+wire / right
+wire / threequarter
+wire / low
\ No newline at end of file
diff --git a/art/characters/qinglan/face-study-v5/review/topology/wire_front.png b/art/characters/qinglan/face-study-v5/review/topology/wire_front.png
new file mode 100644
index 000000000..ef3d1e74c
Binary files /dev/null and b/art/characters/qinglan/face-study-v5/review/topology/wire_front.png differ
diff --git a/art/characters/qinglan/face-study-v5/review/topology/wire_low.png b/art/characters/qinglan/face-study-v5/review/topology/wire_low.png
new file mode 100644
index 000000000..b3bc6db91
Binary files /dev/null and b/art/characters/qinglan/face-study-v5/review/topology/wire_low.png differ
diff --git a/art/characters/qinglan/face-study-v5/review/topology/wire_right.png b/art/characters/qinglan/face-study-v5/review/topology/wire_right.png
new file mode 100644
index 000000000..818574ff3
Binary files /dev/null and b/art/characters/qinglan/face-study-v5/review/topology/wire_right.png differ
diff --git a/art/characters/qinglan/face-study-v5/review/topology/wire_threequarter.png b/art/characters/qinglan/face-study-v5/review/topology/wire_threequarter.png
new file mode 100644
index 000000000..28a873909
Binary files /dev/null and b/art/characters/qinglan/face-study-v5/review/topology/wire_threequarter.png differ
diff --git a/art/characters/qinglan/face-study-v5/review/verification.json b/art/characters/qinglan/face-study-v5/review/verification.json
new file mode 100644
index 000000000..44c29c1ce
--- /dev/null
+++ b/art/characters/qinglan/face-study-v5/review/verification.json
@@ -0,0 +1,665 @@
+{
+ "scope": "Head mesh only. Eye shading, rig deformation, game export and art acceptance are separate.",
+ "shape_keys": 11,
+ "protected_body_vertices": 6943,
+ "protected_body_delta_m": 0,
+ "shape_key_mix_error_m": 6.731388187194899e-08,
+ "multires_level": 3,
+ "topology": {
+ "object": "Qinglan_Control_Cage",
+ "verts": 3771,
+ "edges": 7514,
+ "faces": 3744,
+ "tris_equivalent": 7468,
+ "tris": 20,
+ "quads": 3724,
+ "ngons": 0,
+ "quads_pct": 99.47,
+ "valence_hist_interior": {
+ "3": 68,
+ "4": 3547,
+ "5": 84
+ },
+ "poles_e3": 68,
+ "poles_e5plus": 84,
+ "valence_6plus": 0,
+ "non_manifold_edges": 0,
+ "boundary_loops": [
+ 72
+ ],
+ "loose_verts": 0,
+ "loose_edges": 0,
+ "zero_area_faces": 0,
+ "duplicate_verts": 0,
+ "flipped_faces": 0,
+ "self_intersections": 55,
+ "edge_len_mean": 0.00637,
+ "edge_len_cv": 0.701,
+ "dimensions": [
+ 0.2579,
+ 0.222,
+ 0.3036
+ ],
+ "cage_dihedral_mean": 15.38,
+ "cage_dihedral_p95": 51.39,
+ "rim_poles": 18,
+ "center_poles": 0,
+ "crease_poles": null,
+ "adjacent_e5": 20,
+ "valence2": 0,
+ "non_quads_visible": 20,
+ "sym_local_pct": 77.41,
+ "pole_density_pct": 4.06
+ },
+ "source_cage_audit": {
+ "object": "Baseline_Audit_Only",
+ "verts": 3771,
+ "edges": 7514,
+ "faces": 3744,
+ "tris_equivalent": 7468,
+ "tris": 20,
+ "quads": 3724,
+ "ngons": 0,
+ "quads_pct": 99.47,
+ "valence_hist_interior": {
+ "3": 68,
+ "4": 3547,
+ "5": 84
+ },
+ "poles_e3": 68,
+ "poles_e5plus": 84,
+ "valence_6plus": 0,
+ "non_manifold_edges": 0,
+ "boundary_loops": [
+ 72
+ ],
+ "loose_verts": 0,
+ "loose_edges": 0,
+ "zero_area_faces": 0,
+ "duplicate_verts": 0,
+ "flipped_faces": 0,
+ "self_intersections": 57,
+ "edge_len_mean": 0.006426,
+ "edge_len_cv": 0.688,
+ "symmetry_pct": 76.9,
+ "dimensions": [
+ 0.2579,
+ 0.2242,
+ 0.3036
+ ],
+ "ngon_faces_sample": [],
+ "pole_e5_sample": [
+ [
+ -0.0209,
+ -0.1402,
+ 1.527
+ ],
+ [
+ -0.0219,
+ -0.1391,
+ 1.5282
+ ],
+ [
+ -0.0236,
+ -0.1331,
+ 1.5985
+ ],
+ [
+ -0.0223,
+ -0.1322,
+ 1.6034
+ ],
+ [
+ -0.0472,
+ -0.1261,
+ 1.6008
+ ],
+ [
+ -0.0087,
+ -0.1633,
+ 1.5626
+ ],
+ [
+ -0.0735,
+ -0.0632,
+ 1.6051
+ ],
+ [
+ -0.0441,
+ -0.1302,
+ 1.589
+ ],
+ [
+ -0.0079,
+ -0.1482,
+ 1.5924
+ ],
+ [
+ -0.0752,
+ -0.0574,
+ 1.6253
+ ],
+ [
+ -0.0297,
+ -0.1364,
+ 1.6156
+ ],
+ [
+ -0.0218,
+ -0.141,
+ 1.5083
+ ],
+ [
+ -0.016,
+ -0.1345,
+ 1.6027
+ ],
+ [
+ -0.0155,
+ -0.1496,
+ 1.5492
+ ],
+ [
+ -0.0639,
+ -0.064,
+ 1.5381
+ ],
+ [
+ -0.0086,
+ -0.1432,
+ 1.6173
+ ],
+ [
+ -0.0199,
+ -0.1439,
+ 1.5624
+ ],
+ [
+ -0.0189,
+ -0.1354,
+ 1.594
+ ],
+ [
+ -0.0142,
+ -0.1502,
+ 1.5555
+ ],
+ [
+ -0.0648,
+ -0.0967,
+ 1.551
+ ],
+ [
+ -0.0056,
+ -0.1562,
+ 1.556
+ ],
+ [
+ -0.0049,
+ -0.1548,
+ 1.561
+ ],
+ [
+ -0.0283,
+ -0.1305,
+ 1.5365
+ ],
+ [
+ -0.0153,
+ -0.1446,
+ 1.5429
+ ],
+ [
+ -0.0165,
+ -0.1348,
+ 1.5064
+ ]
+ ],
+ "pole_e3_sample": [
+ [
+ -0.0267,
+ -0.1094,
+ 1.6043
+ ],
+ [
+ -0.0286,
+ -0.1086,
+ 1.6005
+ ],
+ [
+ -0.0322,
+ -0.1078,
+ 1.6021
+ ],
+ [
+ -0.0302,
+ -0.1086,
+ 1.6063
+ ],
+ [
+ -0.0214,
+ -0.1374,
+ 1.5258
+ ],
+ [
+ -0.0224,
+ -0.1376,
+ 1.5283
+ ],
+ [
+ -0.0184,
+ -0.1331,
+ 1.6005
+ ],
+ [
+ -0.0192,
+ -0.1336,
+ 1.5983
+ ],
+ [
+ -0.0079,
+ -0.161,
+ 1.5626
+ ],
+ [
+ -0.0172,
+ -0.1465,
+ 1.5628
+ ],
+ [
+ -0.0103,
+ -0.1442,
+ 1.4901
+ ],
+ [
+ -0.0495,
+ -0.1253,
+ 1.6025
+ ],
+ [
+ -0.0232,
+ -0.1422,
+ 1.6262
+ ],
+ [
+ -0.0281,
+ -0.1359,
+ 1.593
+ ],
+ [
+ -0.0247,
+ -0.1033,
+ 1.6965
+ ],
+ [
+ -0.0118,
+ -0.1534,
+ 1.56
+ ],
+ [
+ -0.007,
+ -0.1554,
+ 1.5654
+ ],
+ [
+ -0.0033,
+ -0.16,
+ 1.5641
+ ],
+ [
+ -0.023,
+ -0.1341,
+ 1.608
+ ],
+ [
+ -0.0095,
+ -0.152,
+ 1.5614
+ ],
+ [
+ -0.0264,
+ -0.1324,
+ 1.5316
+ ],
+ [
+ -0.0262,
+ -0.1312,
+ 1.5273
+ ],
+ [
+ -0.0111,
+ -0.1463,
+ 1.5473
+ ],
+ [
+ -0.0241,
+ -0.0779,
+ 1.5085
+ ],
+ [
+ -0.0279,
+ -0.0799,
+ 1.5586
+ ]
+ ]
+ },
+ "surface_audit": {
+ "object": "Qinglan_High_Inspection",
+ "verts": 243617,
+ "edges": 486944,
+ "faces": 243328,
+ "tris_equivalent": 486656,
+ "tris": 0,
+ "quads": 243328,
+ "ngons": 0,
+ "quads_pct": 100.0,
+ "valence_hist_interior": {
+ "3": 88,
+ "4": 242869,
+ "5": 84
+ },
+ "poles_e3": 88,
+ "poles_e5plus": 84,
+ "valence_6plus": 0,
+ "non_manifold_edges": 0,
+ "boundary_loops": [
+ 576
+ ],
+ "loose_verts": 0,
+ "loose_edges": 0,
+ "zero_area_faces": 0,
+ "duplicate_verts": 0,
+ "flipped_faces": 0,
+ "self_intersections": null,
+ "edge_len_mean": 0.000817,
+ "edge_len_cv": 0.883,
+ "symmetry_pct": 84.13,
+ "dimensions": [
+ 0.2917,
+ 0.2327,
+ 0.3221
+ ],
+ "ngon_faces_sample": [],
+ "pole_e5_sample": [
+ [
+ -0.0207,
+ -0.1402,
+ 1.5272
+ ],
+ [
+ -0.0218,
+ -0.1391,
+ 1.5283
+ ],
+ [
+ -0.0236,
+ -0.1329,
+ 1.5984
+ ],
+ [
+ -0.0223,
+ -0.1318,
+ 1.6033
+ ],
+ [
+ -0.0473,
+ -0.1261,
+ 1.6008
+ ],
+ [
+ -0.0076,
+ -0.1622,
+ 1.5595
+ ],
+ [
+ -0.0735,
+ -0.0632,
+ 1.6051
+ ],
+ [
+ -0.0441,
+ -0.1305,
+ 1.589
+ ],
+ [
+ -0.0079,
+ -0.1482,
+ 1.5924
+ ],
+ [
+ -0.0752,
+ -0.0574,
+ 1.6253
+ ],
+ [
+ -0.0296,
+ -0.1357,
+ 1.6154
+ ],
+ [
+ -0.0209,
+ -0.141,
+ 1.5141
+ ],
+ [
+ -0.016,
+ -0.1339,
+ 1.6025
+ ],
+ [
+ -0.0153,
+ -0.1496,
+ 1.5492
+ ],
+ [
+ -0.0638,
+ -0.064,
+ 1.5381
+ ],
+ [
+ -0.0086,
+ -0.1419,
+ 1.6169
+ ],
+ [
+ -0.0199,
+ -0.1442,
+ 1.5624
+ ],
+ [
+ -0.0189,
+ -0.1353,
+ 1.594
+ ],
+ [
+ -0.014,
+ -0.1503,
+ 1.5555
+ ],
+ [
+ -0.0635,
+ -0.0967,
+ 1.551
+ ],
+ [
+ -0.005,
+ -0.156,
+ 1.555
+ ],
+ [
+ -0.0044,
+ -0.1544,
+ 1.5595
+ ],
+ [
+ -0.0283,
+ -0.1305,
+ 1.5364
+ ],
+ [
+ -0.015,
+ -0.1446,
+ 1.5429
+ ],
+ [
+ -0.0156,
+ -0.1348,
+ 1.5124
+ ]
+ ],
+ "pole_e3_sample": [
+ [
+ -0.0267,
+ -0.1094,
+ 1.6043
+ ],
+ [
+ -0.0286,
+ -0.1086,
+ 1.6005
+ ],
+ [
+ -0.0322,
+ -0.1078,
+ 1.6021
+ ],
+ [
+ -0.0302,
+ -0.1086,
+ 1.6063
+ ],
+ [
+ -0.0213,
+ -0.1374,
+ 1.5263
+ ],
+ [
+ -0.0223,
+ -0.1376,
+ 1.5284
+ ],
+ [
+ -0.0184,
+ -0.1328,
+ 1.6004
+ ],
+ [
+ -0.0192,
+ -0.1334,
+ 1.5982
+ ],
+ [
+ -0.007,
+ -0.1601,
+ 1.5597
+ ],
+ [
+ -0.0172,
+ -0.1466,
+ 1.5628
+ ],
+ [
+ -0.0095,
+ -0.1442,
+ 1.5011
+ ],
+ [
+ -0.0496,
+ -0.1253,
+ 1.6025
+ ],
+ [
+ -0.0232,
+ -0.1412,
+ 1.6259
+ ],
+ [
+ -0.0281,
+ -0.136,
+ 1.593
+ ],
+ [
+ -0.0247,
+ -0.1033,
+ 1.6965
+ ],
+ [
+ -0.0113,
+ -0.1533,
+ 1.5597
+ ],
+ [
+ -0.0064,
+ -0.1552,
+ 1.5635
+ ],
+ [
+ -0.0027,
+ -0.1592,
+ 1.5609
+ ],
+ [
+ -0.023,
+ -0.1333,
+ 1.6077
+ ],
+ [
+ -0.0091,
+ -0.1519,
+ 1.5609
+ ],
+ [
+ -0.0264,
+ -0.1324,
+ 1.5316
+ ],
+ [
+ -0.0262,
+ -0.1312,
+ 1.5275
+ ],
+ [
+ -0.0109,
+ -0.1462,
+ 1.5473
+ ],
+ [
+ -0.024,
+ -0.0782,
+ 1.5118
+ ],
+ [
+ -0.0279,
+ -0.0799,
+ 1.5586
+ ]
+ ]
+ },
+ "control_cage_intersection_comparison": {
+ "source_pairs": 57,
+ "candidate_pairs": 55,
+ "new_pairs": 0,
+ "removed_pairs": 2,
+ "all_remaining_pairs_also_in_source": true,
+ "note": "Pair overlap test on the control cage; source contacts still need correction for production. Dense surface self-intersections are not covered."
+ },
+ "head_render_gate": {
+ "profile": "render",
+ "eps": 4.9e-05,
+ "tol": 0.000986,
+ "gap": 0.004929,
+ "pass": true,
+ "errors": [],
+ "warnings": [],
+ "per_object": {
+ "Qinglan_High_Inspection": {
+ "tris": 486656,
+ "parts": 1,
+ "errors": [],
+ "warnings": []
+ }
+ },
+ "skipped": []
+ },
+ "art_acceptance": "pending; not implied by numerical checks"
+}
\ No newline at end of file
diff --git a/art/characters/qinglan/face-study-v5/scripts/build.ps1 b/art/characters/qinglan/face-study-v5/scripts/build.ps1
new file mode 100644
index 000000000..b6b0b3851
--- /dev/null
+++ b/art/characters/qinglan/face-study-v5/scripts/build.ps1
@@ -0,0 +1,17 @@
+param(
+ [string]$Blender = 'C:\Program Files\Blender Foundation\Blender 5.2\blender.exe',
+ [string]$SourceBundle = 'D:\tmp\blender-human-base-v1.4.1\source\human-base-meshes-bundle-v1.4.1\human_base_meshes_bundle.blend',
+ [string]$SkillsRoot = "$env:USERPROFILE\.codex\skills",
+ [string]$PlotModules = 'D:\tmp\qinglan-face-plot'
+)
+$ErrorActionPreference='Stop'
+if (-not (Test-Path -LiteralPath $SourceBundle)) { throw "Missing source bundle: $SourceBundle" }
+$env:BLENDER_HUMAN_BASE_BUNDLE=$SourceBundle
+$env:SCENARIO_SKILLS_ROOT=$SkillsRoot
+foreach ($stage in @('build_face.py','verify_review.py')) {
+ & $Blender --background --factory-startup --python-exit-code 1 --python (Join-Path $PSScriptRoot $stage)
+ if ($LASTEXITCODE -ne 0) { throw "Blender stage failed: $stage" }
+}
+if (Test-Path -LiteralPath $PlotModules) { $env:PYTHONPATH=$PlotModules }
+python (Join-Path $PSScriptRoot 'compose_review.py')
+if ($LASTEXITCODE -ne 0) { throw 'Review sheet generation failed' }
diff --git a/art/characters/qinglan/face-study-v5/scripts/build_face.py b/art/characters/qinglan/face-study-v5/scripts/build_face.py
new file mode 100644
index 000000000..f29ce8a42
--- /dev/null
+++ b/art/characters/qinglan/face-study-v5/scripts/build_face.py
@@ -0,0 +1,209 @@
+"""Local, reversible face refinement on Blender Studio's CC0 female base.
+
+The artist-authored Multires surface is retained. The body is protected and
+masked after Multires; this avoids discarding sculpt detail when isolating a head.
+"""
+import bpy, sys, json, math, hashlib, os
+import numpy as np
+from pathlib import Path
+from mathutils import Vector, Matrix
+
+ROOT=Path(__file__).resolve().parents[1]
+SOURCE=Path(os.environ.get('BLENDER_HUMAN_BASE_BUNDLE','D:/tmp/blender-human-base-v1.4.1/source/human-base-meshes-bundle-v1.4.1/human_base_meshes_bundle.blend'))
+SKILLS=Path(os.environ.get('SCENARIO_SKILLS_ROOT',str(Path.home()/'.codex/skills')))
+sys.path += [str(SKILLS/'scenario-blender-expert/scripts'),str(SKILLS/'scenario-blender-sculpting/scripts'),str(SKILLS/'scenario-blender-retopology/scripts')]
+import bx_sculpt as S, bx_review
+(ROOT/'review').mkdir(exist_ok=True,parents=True)
+for ob in list(bpy.data.objects):bpy.data.objects.remove(ob,do_unlink=True)
+with bpy.data.libraries.load(str(SOURCE),link=False) as (src,dst):
+ dst.objects=['GEO-body_female_realistic','GEO-body_female_realistic.eye.L','GEO-body_female_realistic.eye.R']
+objs=dst.objects
+for ob in objs:
+ bpy.context.scene.collection.objects.link(ob);ob.hide_set(False);ob.hide_viewport=False;ob.hide_render=False
+bpy.context.view_layer.update()
+worlds=[ob.matrix_world.copy() for ob in objs];offset=worlds[0].translation.copy()
+for ob,mw in zip(objs,worlds):
+ ob.parent=None;ob.matrix_world=Matrix.Translation(-offset)@mw;ob.animation_data_clear()
+head=objs[0];head.name='Qinglan_Head_Multires'
+head['source_author']='Dan Ulrich / Blender Studio Human Base Meshes v1.4.1'
+head['source_license']='CC0-1.0'
+head['source_file_sha256']=hashlib.sha256(SOURCE.read_bytes()).hexdigest()
+head['art_status']='Face identity candidate, not production approval'
+base=np.array([v.co[:] for v in head.data.vertices]);current=base.copy()
+stages=[];deltas=[]
+
+def local(name,hint,radius,delta=None,scale=None,depth_protection=None):
+ global current
+ head.data.vertices.foreach_set('co',current.astype(np.float32).ravel());head.data.update()
+ sc=S.Sculptor(head,symmetry_x=hint[0]!=0)
+ before=sc.co.copy();protected=before[:,2]<1.39
+ transition=np.clip((before[:,2]-1.39)/.020,0,1)
+ sc.mask=1-transition*transition*(3-2*transition)
+ center=sc.on_surface(hint,(0,1,0))
+ if delta is not None:sc.grab(center,radius,delta)
+ else:sc.move_feature(center,radius,scale=scale,pivot=center,blur=2)
+ current=sc.co.copy();change=current-before
+ if depth_protection is not None:
+ full,stop=depth_protection
+ weight=np.clip((stop-base[:,1])/(stop-full),0,1)
+ weight=weight*weight*(3-2*weight)
+ change*=weight[:,None];current=before+change
+ length=np.linalg.norm(change,axis=1)
+ assert float(length[protected].max(initial=0))==0
+ stages.append({'name':name,'center':center.tolist(),'radius_m':radius,
+ 'delta':delta,'scale':scale,'depth_protection':depth_protection,
+ 'affected_vertices':int((length>1e-9).sum()),
+ 'unchanged_vertices':int((length<=1e-9).sum()),
+ 'protected_vertices':int(protected.sum()),'protected_delta_mm':0,
+ 'max_delta_mm':float(length.max()*1000)})
+ deltas.append((name,change))
+
+def shorten_lower_face():
+ global current
+ head.data.vertices.foreach_set('co',current.astype(np.float32).ravel());head.data.update()
+ sc=S.Sculptor(head,symmetry_x=False);before=sc.co.copy()
+ def smooth(t):
+ t=np.clip(t,0,1);return t*t*(3-2*t)
+ influence=smooth((before[:,2]-1.390)/.030)*smooth((1.470-before[:,2])/.008)
+ influence*=smooth((-.035-before[:,1])/.060)
+ sc.mask=1-influence
+ sc.move_feature((0,-.11,1.445),.18,scale=(1,1,.72),pivot=(0,-.11,1.468),falloff='constant',blur=0)
+ current=sc.co.copy();change=current-before;length=np.linalg.norm(change,axis=1)
+ protected=influence==0;assert float(length[protected].max(initial=0))==0
+ name='10_Lower_face_proportion'
+ stages.append({'name':name,'method':'Masked lower-jaw scale about the mouth; compact band',
+ 'scale':[1,1,.72],'affected_vertices':int((length>1e-9).sum()),
+ 'unchanged_vertices':int((length<=1e-9).sum()),'protected_vertices':int(protected.sum()),
+ 'protected_delta_mm':0,'max_delta_mm':float(length.max()*1000)})
+ deltas.append((name,change))
+
+# Neutral adult female reference: softer brow, delicate alae, restrained lips,
+# tapered lower face; source orbital and nasolabial anatomy stays continuous.
+local('01_Soften_brow',(.016,-.3,1.548),.024,delta=(0,.0018,-.0005))
+local('02_Nose_width',(0,-.3,1.498),.026,scale=(.78,1,1))
+local('03_Nose_projection',(0,-.3,1.504),.022,delta=(0,.0022,0))
+local('04_Mouth_width',(0,-.3,1.470),.030,scale=(.91,1,1))
+local('05_Lip_projection',(0,-.3,1.468),.021,delta=(0,.0012,0))
+local('06_Jaw_taper',(.057,-.3,1.464),.043,delta=(-.0036,0,0))
+local('07_Chin_width',(0,-.3,1.445),.035,scale=(.85,1,1))
+local('08_Cheek_softness',(.042,-.3,1.501),.032,delta=(0,-.0015,0))
+local('09_Eye_aperture',(.033,-.3,1.535),.026,scale=(1.23,1,1.08),depth_protection=(-.123,-.108))
+shorten_lower_face()
+local('11_Nasal_tip',(0,-.3,1.505),.024,delta=(0,0,-.0055))
+
+head.data.vertices.foreach_set('co',base.astype(np.float32).ravel());head.data.update()
+head.shape_key_add(name='Basis_Studio_Female',from_mix=False)
+for name,change in deltas:S.write_shape_key(head,name,base+change,value=1)
+sid=head.data.attributes.new('source_vertex_id','INT','POINT')
+sid.data.foreach_set('value',np.arange(len(base),dtype=np.int32))
+group=head.vertex_groups.new(name='Head_Display_Only')
+group.add([int(i) for i in np.flatnonzero(base[:,2]>1.365)],1,'REPLACE')
+mask=head.modifiers.new('Isolate_Head_After_Multires','MASK');mask.vertex_group=group.name
+mask.show_in_editmode=True
+head['mask_note']='Body topology retained only to preserve original Multires grids; body vertices protected during edits'
+
+# A display-only neck trim after the mask. The open attachment border is kept,
+# but its saw-tooth height is flattened without touching source control points.
+ng=bpy.data.node_groups.new('Flat_Neck_Attachment_Border','GeometryNodeTree')
+ng.interface.new_socket(name='Geometry',in_out='INPUT',socket_type='NodeSocketGeometry')
+ng.interface.new_socket(name='Geometry',in_out='OUTPUT',socket_type='NodeSocketGeometry')
+nodes=ng.nodes;links=ng.links
+inp=nodes.new('NodeGroupInput');out=nodes.new('NodeGroupOutput')
+neighbours=nodes.new('GeometryNodeInputMeshVertexNeighbors')
+compare=nodes.new('FunctionNodeCompare');compare.data_type='INT';compare.operation='GREATER_THAN'
+links.new(neighbours.outputs['Vertex Count'],compare.inputs['A'])
+links.new(neighbours.outputs['Face Count'],compare.inputs['B'])
+pos=nodes.new('GeometryNodeInputPosition');xyz=nodes.new('ShaderNodeSeparateXYZ');links.new(pos.outputs[0],xyz.inputs[0])
+stats=nodes.new('GeometryNodeAttributeStatistic');stats.data_type='FLOAT';stats.domain='POINT'
+links.new(inp.outputs[0],stats.inputs['Geometry']);links.new(compare.outputs['Result'],stats.inputs['Selection'])
+links.new(xyz.outputs['Z'],stats.inputs['Attribute'])
+combine=nodes.new('ShaderNodeCombineXYZ');links.new(xyz.outputs['X'],combine.inputs['X']);links.new(xyz.outputs['Y'],combine.inputs['Y'])
+links.new(stats.outputs['Min'],combine.inputs['Z'])
+setpos=nodes.new('GeometryNodeSetPosition');links.new(inp.outputs[0],setpos.inputs['Geometry'])
+links.new(compare.outputs['Result'],setpos.inputs['Selection']);links.new(combine.outputs[0],setpos.inputs['Position'])
+links.new(setpos.outputs['Geometry'],out.inputs[0])
+trim=head.modifiers.new('Flat_Neck_Border','NODES');trim.node_group=ng
+
+# Face study scale: crown at 1.72 m; height/width independently calibrated to the
+# working design. These are visual proportion edits, not a calibrated fit.
+# The source-space edits above remain in anatomical metres.
+normalise=Matrix.Diagonal((1.0,1.02,1.10,1.0))
+normalise.translation.z=1.72-1.641334056854248*1.10
+for ob in objs:[email protected]_world
+bpy.context.view_layer.update()
+
+scene=bpy.context.scene
+def mat(name,color,roughness=.6):
+ m=bpy.data.materials.new(name);m.diffuse_color=(*color,1);m.use_nodes=True
+ bs=m.node_tree.nodes.get('Principled BSDF');bs.inputs['Base Color'].default_value=(*color,1)
+ bs.inputs['Roughness'].default_value=roughness
+ return m
+clay=mat('Neutral_Clay',(.36,.38,.40));white=mat('Sclera',(.65,.64,.62),.28)
+iris=mat('Iris',(.030,.021,.014),.3);pupil=mat('Pupil',(.002,.002,.002),.2)
+for ob in objs:
+ ob.data.materials.clear();ob.data.materials.append(clay if ob==head else white)
+ for p in ob.data.polygons:p.material_index=0;p.use_smooth=True
+
+eye_info=[]
+for eye in objs[1:]:
+ c=eye.matrix_world.translation.copy()
+ # Source eyes are a physically sized 24 mm globe. Add only the readable iris.
+ p=np.array([tuple([email protected]) for v in eye.data.vertices])
+ center=(p.min(0)+p.max(0))/2;radii=(p.max(0)-p.min(0))/2
+ eye_info.append({'name':eye.name,'center':center.tolist(),'radii':radii.tolist()})
+ for label,radius,material,off in [('Iris',.0055,iris,.00005),('Pupil',.0023,pupil,.00010)]:
+ verts=[(center[0],center[1]-radii[1]-off,center[2])];faces=[]
+ for j in range(1,11):
+ r=radius*j/10
+ for i in range(80):
+ a=math.tau*i/80;dx=r*math.cos(a);dz=r*math.sin(a)
+ y=center[1]-radii[1]*math.sqrt(max(0,1-(dx/radii[0])**2-(dz/radii[2])**2))-off
+ verts.append((center[0]+dx,y,center[2]+dz))
+ for i in range(80):faces.append((0,1+i,1+(i+1)%80))
+ for j in range(9):
+ for i in range(80):
+ a=1+j*80+i;b=1+j*80+(i+1)%80;faces.append((a,a+80,b+80,b))
+ me=bpy.data.meshes.new(label);me.from_pydata(verts,[],faces);me.materials.append(material);me.update()
+ ob=bpy.data.objects.new(label+('_L' if center[0]>0 else '_R'),me);scene.collection.objects.link(ob)
+ for p in me.polygons:p.use_smooth=True
+
+def aim(ob,target):ob.rotation_euler=(Vector(target)-ob.location).to_track_quat('-Z','Y').to_euler()
+def light(name,loc,energy,size):
+ d=bpy.data.lights.new(name,'AREA');d.energy=energy;d.shape='DISK';d.size=size
+ ob=bpy.data.objects.new(name,d);scene.collection.objects.link(ob);ob.location=loc;aim(ob,(0,-.06,1.59))
+light('Key',(-.65,-.9,2.45),55,.8);light('Fill',(.65,-.7,1.9),24,.85);light('Rim',(.5,.6,2.2),28,.6)
+world=bpy.data.worlds.new('Neutral_Studio');world.use_nodes=True
+world.node_tree.nodes['Background'].inputs[0].default_value=(.32,.34,.37,1)
+world.node_tree.nodes['Background'].inputs[1].default_value=.35;scene.world=world
+scene.render.engine='CYCLES';scene.cycles.samples=40;scene.cycles.use_denoising=True
+prefs=bpy.context.preferences.addons['cycles'].preferences;prefs.compute_device_type='OPTIX';prefs.get_devices()
+for d in prefs.devices:d.use=d.type=='OPTIX'
+scene.cycles.device='GPU'
+scene.view_settings.view_transform='AgX';scene.view_settings.exposure=-.6
+scene.render.resolution_x=600;scene.render.resolution_y=800;scene.render.resolution_percentage=100
+scene.render.image_settings.file_format='PNG';scene.render.image_settings.color_mode='RGB'
+cameras={}
+for name,direction in [('front',(0,-1,0)),('profile',(-1,0,0)),('threequarter',(.7,-1,0)),('low',(.45,-1,-.25))]:
+ cd=bpy.data.cameras.new(name);cd.type='ORTHO' if name in ('front','profile') else 'PERSP'
+ cd.ortho_scale=.309;cd.lens=90;cd.sensor_fit='VERTICAL';cd.sensor_height=24
+ ob=bpy.data.objects.new('Review_'+name,cd);scene.collection.objects.link(ob)
+ target=Vector((0,-.065 if name=='profile' else -.043,1.582));ob.location=target+Vector(direction).normalized()*1.16;aim(ob,target)
+ cameras[name]=ob
+scene.camera=cameras['threequarter']
+ref=bpy.data.images.load(str(ROOT.parent/'references/qinglan-face-target.png'));ref.pack()
+for ob in bpy.context.selected_objects:ob.select_set(False)
+head.select_set(True);bpy.context.view_layer.objects.active=head
+for screen in bpy.data.screens:
+ for area in screen.areas:
+ if area.type=='VIEW_3D':
+ space=area.spaces.active;space.clip_start=.001
+ space.region_3d.view_location=(0,-.06,1.59)
+ space.region_3d.view_distance=.48
+ space.region_3d.view_rotation=cameras['threequarter'].rotation_euler.to_quaternion()
+ space.shading.type='SOLID';space.shading.color_type='MATERIAL'
+bpy.context.view_layer.update()
+(ROOT/'review/edit-report.json').write_text(json.dumps({'stages':stages,'eyes':eye_info},indent=2))
+bpy.ops.wm.save_as_mainfile(filepath=str(ROOT/'qinglan-face-candidate.blend'),compress=True)
+for name,cam in cameras.items():
+ scene.camera=cam;scene.render.filepath=str(ROOT/'review'/(name+'.png'));bpy.ops.render.render(write_still=True)
+print('STUDIO_CANDIDATE_READY '+json.dumps({'stages':len(stages),'base_vertices':len(base)}),flush=True)
diff --git a/art/characters/qinglan/face-study-v5/scripts/compose_review.py b/art/characters/qinglan/face-study-v5/scripts/compose_review.py
new file mode 100644
index 000000000..e4916c316
--- /dev/null
+++ b/art/characters/qinglan/face-study-v5/scripts/compose_review.py
@@ -0,0 +1,23 @@
+"""Technical contact sheets of unaltered Blender renders and the working reference."""
+from pathlib import Path
+import matplotlib
+matplotlib.use('Agg')
+import matplotlib.pyplot as plt
+ROOT=Path(__file__).resolve().parents[1]
+fig,axes=plt.subplots(1,3,figsize=(15,7),dpi=120,facecolor='#e7e9ec')
+for ax,name,label in zip(axes,['front','threequarter','profile'],['Front / orthographic','Three-quarter / 90 mm','Profile / orthographic']):
+ ax.imshow(plt.imread(ROOT/'review'/f'{name}.png'));ax.axis('off');ax.set_title(label,fontsize=13,pad=10)
+fig.suptitle('QINGLAN | FACE GEOMETRY STUDY',fontsize=20,y=.97)
+fig.text(.5,.025,'Editable candidate - facial likeness pending - neutral materials, no hair or skin texture',ha='center',fontsize=12)
+fig.subplots_adjust(left=.02,right=.98,top=.865,bottom=.07,wspace=.025)
+fig.savefig(ROOT/'review/face-review.png',facecolor=fig.get_facecolor());plt.close(fig)
+ref=plt.imread(ROOT.parent/'references/qinglan-face-target.png')
+fig,axes=plt.subplots(1,2,figsize=(9,7),dpi=130,facecolor='#e7e9ec')
+axes[0].imshow(ref[:828,:592]);axes[0].set_title('Working design reference',fontsize=13)
+axes[1].imshow(plt.imread(ROOT/'review/front.png'));axes[1].set_title('Current neutral geometry',fontsize=13)
+for ax in axes:ax.axis('off')
+fig.suptitle('FACE IDENTITY REVIEW - NOT AN ACCEPTANCE',fontsize=15,y=.98)
+fig.text(.5,.025,'Visual comparison only; the reference is not a calibrated camera reconstruction.',ha='center',fontsize=10)
+fig.subplots_adjust(left=.02,right=.98,top=.92,bottom=.07,wspace=.06)
+fig.savefig(ROOT/'review/reference-comparison.png',facecolor=fig.get_facecolor());plt.close(fig)
+print('FACE_REVIEW_SHEETS_READY')
diff --git a/art/characters/qinglan/face-study-v5/scripts/verify_review.py b/art/characters/qinglan/face-study-v5/scripts/verify_review.py
new file mode 100644
index 000000000..58d0d45cc
--- /dev/null
+++ b/art/characters/qinglan/face-study-v5/scripts/verify_review.py
@@ -0,0 +1,98 @@
+"""Reopen, audit actual evaluated geometry, and render cage/clay evidence."""
+import bpy,bmesh,json,sys,hashlib,os
+import numpy as np
+from pathlib import Path
+from mathutils import Vector
+from mathutils.bvhtree import BVHTree
+ROOT=Path(__file__).resolve().parents[1]
+SKILLS=Path(os.environ.get('SCENARIO_SKILLS_ROOT',str(Path.home()/'.codex/skills')))
+sys.path += [str(SKILLS/'scenario-blender-expert/scripts'),str(SKILLS/'scenario-blender-sculpting/scripts'),str(SKILLS/'scenario-blender-retopology/scripts')]
+import bx_audit as A, bx_review, bx_retopo as R, bx_sculpt as S
+bpy.ops.wm.open_mainfile(filepath=str(ROOT/'qinglan-face-candidate.blend'))
+head=bpy.data.objects['Qinglan_Head_Multires']
+for name in ('Inspection_Cage','Inspection_High'):
+ col=bpy.data.collections.get(name)
+ if col:
+ for ob in list(col.objects):bpy.data.objects.remove(ob,do_unlink=True)
+ bpy.data.collections.remove(col)
+keys=head.data.shape_keys.key_blocks
+base=np.array([v.co[:] for v in keys[0].data]);mixed=base.copy()
+protected=base[:,2]<1.39
+for k in list(keys)[1:]:
+ co=np.array([v.co[:] for v in k.data]);delta=co-base
+ assert np.isfinite(co).all()
+ assert np.max(np.abs(delta[protected]),initial=0)==0, k.name
+ mixed+=delta*k.value
+
+def snapshot(ob,name):
+ bpy.context.view_layer.update();dg=bpy.context.evaluated_depsgraph_get()
+ mesh=bpy.data.meshes.new_from_object(ob.evaluated_get(dg),preserve_all_data_layers=True,depsgraph=dg)
+ mesh.transform(ob.matrix_world);mesh.update()
+ copy=bpy.data.objects.new(name,mesh);bpy.context.scene.collection.objects.link(copy)
+ return copy
+
+def intersection_pairs(ob):
+ bm=bmesh.new();bm.from_mesh(ob.data)
+ bm.faces.ensure_lookup_table();bm.verts.ensure_lookup_table()
+ tree=BVHTree.FromBMesh(bm)
+ pairs={(a,b) for a,b in tree.overlap(tree)
+ if a<b and not set(bm.faces[a].verts)&set(bm.faces[b].verts)}
+ bm.free();return pairs
+
+multi=next(m for m in head.modifiers if m.type=='MULTIRES')
+levels=multi.levels;multi.levels=0
+cage=snapshot(head,'Qinglan_Control_Cage')
+assert cage.data.attributes.get('source_vertex_id') is not None
+ids=np.array([v.value for v in cage.data.attributes['source_vertex_id'].data])
+mw=np.array(head.matrix_world)
+expected=mixed[ids]@mw[:3,:3].T+mw[:3,3]
+actual=np.array([v.co[:] for v in cage.data.vertices])
+face_region=base[ids,2]>1.39
+mix_error=float(np.max(np.linalg.norm(actual[face_region]-expected[face_region],axis=1)))
+assert mix_error<2e-6,mix_error
+multi.levels=levels
+high=snapshot(head,'Qinglan_High_Inspection')
+topology=R.topology_report(cage)
+for k in list(keys)[1:]:k.value=0
+multi.levels=0
+baseline_cage=snapshot(head,'Baseline_Audit_Only')
+baseline_audit=A.audit(baseline_cage)
+source_pairs=intersection_pairs(baseline_cage)
+candidate_pairs=intersection_pairs(cage)
+new_pairs=candidate_pairs-source_pairs
+assert not new_pairs, f'Local edits introduced {len(new_pairs)} cage intersections'
+intersections={'source_pairs':len(source_pairs),'candidate_pairs':len(candidate_pairs),
+ 'new_pairs':len(new_pairs),'removed_pairs':len(source_pairs-candidate_pairs),
+ 'all_remaining_pairs_also_in_source':not new_pairs,
+ 'note':'Pair overlap test on the control cage; source contacts still need correction for production. Dense surface self-intersections are not covered.'}
+bpy.data.objects.remove(baseline_cage,do_unlink=True)
+for k in list(keys)[1:]:k.value=1
+multi.levels=levels
+mesh_audit=A.audit(high)
+delivery=A.deliverable([high],profile='render')
+report={'scope':'Head mesh only. Eye shading, rig deformation, game export and art acceptance are separate.',
+ 'shape_keys':len(keys)-1,'protected_body_vertices':int(protected.sum()),
+ 'protected_body_delta_m':0,'shape_key_mix_error_m':mix_error,
+ 'multires_level':levels,'topology':topology,'source_cage_audit':baseline_audit,'surface_audit':mesh_audit,
+ 'control_cage_intersection_comparison':intersections,
+ 'head_render_gate':delivery,'art_acceptance':'pending; not implied by numerical checks'}
+(ROOT/'review/verification.json').write_text(json.dumps(report,indent=2))
+
+# The wire sheet shows the artist's real control edges, not triangulated shading.
+bx_review.review([cage],str(ROOT/'review/topology'),views=('front','right','threequarter','low'),modes=('wire',),res=400)
+bx_review.review([high],str(ROOT/'review/clay'),views=('front','right','threequarter','low'),modes=('silhouette','matcap'),res=400)
+S.final_render([high],str(ROOT/'review/clay/threequarter-90mm.png'),direction=(.7,-1,0),res=800,cavity=False)
+
+for ob,colname in [(cage,'Inspection_Cage'),(high,'Inspection_High')]:
+ col=bpy.data.collections.new(colname);bpy.context.scene.collection.children.link(col)
+ for c in list(ob.users_collection):c.objects.unlink(ob)
+ col.objects.link(ob);col.hide_render=True;ob.hide_set(True)
+ ob['purpose']='Read-only evaluation snapshot for inspection; edit source Multires keys to revise the face'
+head['technical_report']='review/verification.json'
+head['art_status']='Review candidate; reference likeness and game readiness not approved'
+bpy.context.scene.camera=bpy.data.objects['Review_threequarter']
+bpy.ops.wm.save_as_mainfile(filepath=str(ROOT/'qinglan-face-candidate.blend'),compress=True)
+print('VERIFY_RESULT '+json.dumps({'cage_vertices':topology['verts'],'cage_faces':topology['faces'],
+ 'quads_pct':topology['quads_pct'],'high_faces':mesh_audit['faces'],
+ 'head_render_pass':delivery['pass'],'errors':delivery['errors'],'warnings':delivery['warnings'],
+ 'shape_key_mix_error_m':mix_error,'intersections':intersections}),flush=True)