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.
TypeScript 2d-game-engine3d3d-game-engineandroidcppecsgame-editorgame-enginegamedeviostypescriptwebassemblywebglwebgpuwechat-minigame
feat(art): add reversible Qinglan face candidate and review evidence
yhhc5d980ca8a59
diff --git a/art/characters/qinglan/README.md b/art/characters/qinglan/README.mdindex 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.mdnew file mode 100644index 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.jsonnew file mode 100644index 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.blendnew file mode 100644index 000000000..a92a062c4Binary files /dev/null and b/art/characters/qinglan/face-study-v5/qinglan-face-candidate.blend differdiff --git a/art/characters/qinglan/face-study-v5/review/art-review.json b/art/characters/qinglan/face-study-v5/review/art-review.jsonnew file mode 100644index 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.pngnew file mode 100644index 000000000..f020755b1Binary files /dev/null and b/art/characters/qinglan/face-study-v5/review/clay/matcap_front.png differdiff --git a/art/characters/qinglan/face-study-v5/review/clay/matcap_low.png b/art/characters/qinglan/face-study-v5/review/clay/matcap_low.pngnew file mode 100644index 000000000..fb872d467Binary files /dev/null and b/art/characters/qinglan/face-study-v5/review/clay/matcap_low.png differdiff --git a/art/characters/qinglan/face-study-v5/review/clay/matcap_right.png b/art/characters/qinglan/face-study-v5/review/clay/matcap_right.pngnew file mode 100644index 000000000..eb1770adfBinary files /dev/null and b/art/characters/qinglan/face-study-v5/review/clay/matcap_right.png differdiff --git a/art/characters/qinglan/face-study-v5/review/clay/matcap_threequarter.png b/art/characters/qinglan/face-study-v5/review/clay/matcap_threequarter.pngnew file mode 100644index 000000000..ab43b0635Binary files /dev/null and b/art/characters/qinglan/face-study-v5/review/clay/matcap_threequarter.png differdiff --git a/art/characters/qinglan/face-study-v5/review/clay/review_sheet.png b/art/characters/qinglan/face-study-v5/review/clay/review_sheet.pngnew file mode 100644index 000000000..b3b5f68eaBinary files /dev/null and b/art/characters/qinglan/face-study-v5/review/clay/review_sheet.png differdiff --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.txtnew file mode 100644index 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 filediff --git a/art/characters/qinglan/face-study-v5/review/clay/silhouette_front.png b/art/characters/qinglan/face-study-v5/review/clay/silhouette_front.pngnew file mode 100644index 000000000..1a95460d9Binary files /dev/null and b/art/characters/qinglan/face-study-v5/review/clay/silhouette_front.png differdiff --git a/art/characters/qinglan/face-study-v5/review/clay/silhouette_low.png b/art/characters/qinglan/face-study-v5/review/clay/silhouette_low.pngnew file mode 100644index 000000000..19b9665e4Binary files /dev/null and b/art/characters/qinglan/face-study-v5/review/clay/silhouette_low.png differdiff --git a/art/characters/qinglan/face-study-v5/review/clay/silhouette_right.png b/art/characters/qinglan/face-study-v5/review/clay/silhouette_right.pngnew file mode 100644index 000000000..1c51dd394Binary files /dev/null and b/art/characters/qinglan/face-study-v5/review/clay/silhouette_right.png differdiff --git a/art/characters/qinglan/face-study-v5/review/clay/silhouette_threequarter.png b/art/characters/qinglan/face-study-v5/review/clay/silhouette_threequarter.pngnew file mode 100644index 000000000..2532f937dBinary files /dev/null and b/art/characters/qinglan/face-study-v5/review/clay/silhouette_threequarter.png differdiff --git a/art/characters/qinglan/face-study-v5/review/clay/threequarter-90mm.png b/art/characters/qinglan/face-study-v5/review/clay/threequarter-90mm.pngnew file mode 100644index 000000000..3822dc6ffBinary files /dev/null and b/art/characters/qinglan/face-study-v5/review/clay/threequarter-90mm.png differdiff --git a/art/characters/qinglan/face-study-v5/review/edit-report.json b/art/characters/qinglan/face-study-v5/review/edit-report.jsonnew file mode 100644index 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 filediff --git a/art/characters/qinglan/face-study-v5/review/face-review.png b/art/characters/qinglan/face-study-v5/review/face-review.pngnew file mode 100644index 000000000..45f96138aBinary files /dev/null and b/art/characters/qinglan/face-study-v5/review/face-review.png differdiff --git a/art/characters/qinglan/face-study-v5/review/front.png b/art/characters/qinglan/face-study-v5/review/front.pngnew file mode 100644index 000000000..bae225093Binary files /dev/null and b/art/characters/qinglan/face-study-v5/review/front.png differdiff --git a/art/characters/qinglan/face-study-v5/review/low.png b/art/characters/qinglan/face-study-v5/review/low.pngnew file mode 100644index 000000000..ce3a72813Binary files /dev/null and b/art/characters/qinglan/face-study-v5/review/low.png differdiff --git a/art/characters/qinglan/face-study-v5/review/profile.png b/art/characters/qinglan/face-study-v5/review/profile.pngnew file mode 100644index 000000000..9aaf9fdc6Binary files /dev/null and b/art/characters/qinglan/face-study-v5/review/profile.png differdiff --git a/art/characters/qinglan/face-study-v5/review/reference-comparison.png b/art/characters/qinglan/face-study-v5/review/reference-comparison.pngnew file mode 100644index 000000000..77398971cBinary files /dev/null and b/art/characters/qinglan/face-study-v5/review/reference-comparison.png differdiff --git a/art/characters/qinglan/face-study-v5/review/threequarter.png b/art/characters/qinglan/face-study-v5/review/threequarter.pngnew file mode 100644index 000000000..c2d892d1bBinary files /dev/null and b/art/characters/qinglan/face-study-v5/review/threequarter.png differdiff --git a/art/characters/qinglan/face-study-v5/review/topology/review_sheet.png b/art/characters/qinglan/face-study-v5/review/topology/review_sheet.pngnew file mode 100644index 000000000..90a7b8958Binary files /dev/null and b/art/characters/qinglan/face-study-v5/review/topology/review_sheet.png differdiff --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.txtnew file mode 100644index 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 filediff --git a/art/characters/qinglan/face-study-v5/review/topology/wire_front.png b/art/characters/qinglan/face-study-v5/review/topology/wire_front.pngnew file mode 100644index 000000000..ef3d1e74cBinary files /dev/null and b/art/characters/qinglan/face-study-v5/review/topology/wire_front.png differdiff --git a/art/characters/qinglan/face-study-v5/review/topology/wire_low.png b/art/characters/qinglan/face-study-v5/review/topology/wire_low.pngnew file mode 100644index 000000000..b3bc6db91Binary files /dev/null and b/art/characters/qinglan/face-study-v5/review/topology/wire_low.png differdiff --git a/art/characters/qinglan/face-study-v5/review/topology/wire_right.png b/art/characters/qinglan/face-study-v5/review/topology/wire_right.pngnew file mode 100644index 000000000..818574ff3Binary files /dev/null and b/art/characters/qinglan/face-study-v5/review/topology/wire_right.png differdiff --git a/art/characters/qinglan/face-study-v5/review/topology/wire_threequarter.png b/art/characters/qinglan/face-study-v5/review/topology/wire_threequarter.pngnew file mode 100644index 000000000..28a873909Binary files /dev/null and b/art/characters/qinglan/face-study-v5/review/topology/wire_threequarter.png differdiff --git a/art/characters/qinglan/face-study-v5/review/verification.json b/art/characters/qinglan/face-study-v5/review/verification.jsonnew file mode 100644index 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 filediff --git a/art/characters/qinglan/face-study-v5/scripts/build.ps1 b/art/characters/qinglan/face-study-v5/scripts/build.ps1new file mode 100644index 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.pynew file mode 100644index 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.pynew file mode 100644index 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.pynew file mode 100644index 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)