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
art: refine Qinglan facial control-cage proportions
yhha3ad44e9992b
diff --git a/art/characters/qinglan/README.md b/art/characters/qinglan/README.mdindex 4cd2974b6..6560e864a 100644--- a/art/characters/qinglan/README.md+++ b/art/characters/qinglan/README.md@@ -4,17 +4,20 @@用户已否决 `face-study-v3` 的脸部效果。该版本保留用于定位变形问题和回退,不应作为后续细节制作的造型基础;见 [脸部审查记录](face-study-v3/review/art-review.json)。网格与导出检查通过不能代表人物造型合格。-最新脸部候选位于 [face-study-v6](face-study-v6/README.md)。本版在用户打开的 Blender 中通过 MCP 调用原生 Grab 与 Smooth 笔刷,保留 V5 来源和三组可回退的局部雕刻修改,并提供同机位前后对照。当前仍需继续修正五官气质与参考接近程度。+最新脸部比例候选位于 [face-study-v7](face-study-v7/README.md)。本轮回到约 3,700 面的控制网格,调整口裂高度、下颌、眼裂和耳位,并提供设计稿叠加、估计视角对照与真实控制网格图。五官气质、脸颊过渡和嘴唇接合仍需修改;本版尚未美术验收,也未通过严格的新增交叉检查。++[face-study-v6](face-study-v6/README.md) 保留此前通过 Blender MCP 调用原生 Grab 与 Smooth 的高分辨率笔刷试改及同机位前后对照。[face-study-v5](face-study-v5/README.md) 保留 Blender 官方 CC0 女性基网格来源、原作者的多级雕刻数据,以及 Scenario Blender、雕刻与拓扑技能的接入记录。-此前的人体版本保留了参数化人体来源、手臂姿态、眉毛及睫毛试作。相关文件用于过程记录;最新 V5 是独立脸部候选,下方完整角色与导出说明对应此前版本。+此前的人体版本保留了参数化人体来源、手臂姿态、眉毛及睫毛试作。相关文件用于过程记录;V7 是独立脸部候选,下方完整角色与导出说明对应此前版本。## 文件| 文件 | 用途 || --- | --- |-| `face-study-v6/qinglan-live-face.blend` | 最新实时雕刻候选、3 个原生笔刷修订形态键及前后对照;尚未美术验收 |+| `face-study-v7/qinglan-identity-cage.blend` | 最新控制网格比例候选、参考叠加及多视角检查;待继续修改 |+| `face-study-v6/qinglan-live-face.blend` | 实时雕刻试改、3 个原生笔刷修订形态键及前后对照;尚未美术验收 || `face-study-v5/qinglan-face-candidate.blend` | V5 脸部来源、11 个分区形态键及灰模/拓扑检查;尚未美术验收 || `qinglan-human-study.blend` | 完整人体与独立头部检查场景;灰色区域是检查材质,不是服装网格 || `qinglan-highpoly.blend` | 带完整衣饰、头发、佩剑的高模,保留多级细分、曲线和来源集合 |diff --git a/art/characters/qinglan/face-study-v7/README.md b/art/characters/qinglan/face-study-v7/README.mdnew file mode 100644index 000000000..9e49fd37e--- /dev/null+++ b/art/characters/qinglan/face-study-v7/README.md@@ -0,0 +1,37 @@+# 青岚 · V7 控制网格比例候选++本轮从 V5 的原始四边面控制网格调整脸部大比例。口裂上移约 8.5 mm,缩窄嘴部,调整下颌与下巴,延展眼裂,联动眼球和虹膜,并加入眉形占位、耳位与鼻尖调整。保留的效果见 `review/reference-overlay.png` 和 `review/reference-multiview.png`。++**状态:待修改、未通过脸部身份验收。** 五官位置有改善,但脸颊过渡、眼睑厚度与鼻唇体积仍未达到设计稿。眉毛是网格占位,不是最终毛发;没有用皮肤贴图或头发遮挡差异。++## 打开和编辑++打开 `qinglan-identity-cage.blend`,编辑 `Qinglan_Identity_Cage`。显示出的头颈控制网格有 3,771 个顶点、3,744 个面,其中 99.47% 是四边面;完整来源的 10,582 个控制顶点仍保留,以维持原作者的 Multires 数据。修改集中在脸部,身体由后置 Mask 隐藏。二级细分检查表面有 60,688 个四边面。++原有 11 个形态键保留。新增键以 `V7_` 开头,7 个启用,另 4 个试改因视觉问题被静音且权重归零。`review/accepted-key-values.json` 是最终启用状态;过程编辑 JSON 中的最大位移描述试改本身,不能替代最终权重。++将所有 `V7_` 键置零,可恢复 V5 的头部造型;眼球、虹膜和眉形需要另外关闭或恢复。V5、V6 原文件没有覆盖。V7 没有承接 V6 的高分辨率原生笔刷修订。++脚本修改形态键前,把 Multires 的视口级别设为 0,更新后再恢复为 1。此会话在较高级别更新控制数据时出现 Blender 5.2.1 细分属性插值崩溃,已从阶段备份恢复;最终文件已多次在后台重新打开。初期编辑通过用户已打开的 Blender MCP 完成,连接中断后使用后台 Blender 继续。全程未使用 computer use,也未自动打开新的可见窗口。++## 对照与检查++- `review/reference-overlay.png`:设计稿、V6、V7 和叠加;按瞳距及眼线对齐。+- `review/reference-multiview.png`:设计稿与估计视角下的正面、侧面、三分之四。参考不是标定照片;90 mm 镜头、约 72° / 25° 方向是检查用估计。+- `review/after-*.png`:固定正交正侧面、透视三分之四及低角度原始渲染。+- `review/cage-*.png`:真实控制网格边,不是高密度表面三角线。+- `review/verification.json`:保存后重新求值的控制网格、二级表面及局部交叉检查。++头部的 `render` 结构检查没有发现零面积面、翻转面或非流形内部边;这不能证明没有自交。控制网格的局部交叉对为来源 52、当前 52,新增对 0。二级表面的局部交叉对为来源 412、当前 412,其中 **24 对不同于来源**,位于嘴唇接合处。因此严格的“没有新增交叉对”检查仍失败,本版不能作为已清理完毕的生产网格。++检查先取 BVH 候选,再在毫米尺度计算线段与三角面的交叉。范围为脸部局部;相切、共面重合及全身不在该结论内。原来源的内部接触、开口颈边、表情、骨骼、UV、游戏预算和 Estella 验收仍未完成。++## 工具与过程++实际使用 `scenario-blender-expert`、`scenario-blender-sculpting`、`scenario-blender-retopology` 及 `estella-character-production` 的控制网格、分阶段回退、固定视角审查和网格检查流程。本轮是参考约束下的网格数据编辑,没有新增原生雕刻笔画,也没有激活付费工具。++`scripts/identity_cage.py` 提供局部编辑;其余编辑脚本保存试改与回退过程。不要不加选择地重放全部试改。`finalize_candidate.py` 明确关闭失败的脸颊填充和强制张嘴调整;最终文件和键权重记录为准。++`render_review.py`、`render_cage.py` 可通过 `blender --background --factory-startup --python-exit-code 1 --python ...` 重做检查图。`audit_saved.py` 默认严格检查并因上述 24 对交叉退出失败;附加 `-- --report-only` 仅生成如实记录失败状态的报告,不代表检查通过。`compose_review.py` 用 Matplotlib 排列原始图片,没有对脸部图像进行修补。++来源沿用 [V5 的授权记录](../face-study-v5/provenance.json):Blender 官方 Human Base Meshes v1.4.1,Dan Ulrich 的 CC0 女性基网格。diff --git a/art/characters/qinglan/face-study-v7/provenance.json b/art/characters/qinglan/face-study-v7/provenance.jsonnew file mode 100644index 000000000..ff176c88a--- /dev/null+++ b/art/characters/qinglan/face-study-v7/provenance.json@@ -0,0 +1,167 @@+{+ "asset": "Qinglan V7 reference-led control-cage proportion study",+ "status": "editable_review_candidate_not_art_or_production_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"+ },+ "parent_file": "../face-study-v5/qinglan-face-candidate.blend",+ "parent_sha256": "19f5e9271b7b51d1ed9879425b7cb9a2d5609063324f89fe10a68c848b71613d",+ "current_file": "qinglan-identity-cage.blend",+ "current_sha256": "f82e51a1cb6fb475adbf56d79ccc58544454201525da248a85c66adddf4823cb",+ "reference": {+ "file": "../references/qinglan-face-target.png",+ "sha256": "6ab4f8b82b92dc3ccb31c8b2b4e398b016a50b72e4ee6d8efd9c4dcbf5104405",+ "calibrated": false+ },+ "workflow": {+ "blender": "5.2.1 LTS",+ "skill_revision": "d44410f058991f677ccf733a8e86ce95110857eb",+ "skills": [+ "scenario-blender-expert",+ "scenario-blender-sculpting",+ "scenario-blender-retopology",+ "estella-character-production"+ ],+ "execution": "Initial control edits over the live Blender MCP connection; after a Blender process crash, recovered from a stage copy and continued through headless CLI. No computer use, no newly launched GUI, no paid add-on activation.",+ "native_brushes_this_version": false,+ "comparison_images": "Unaltered reference/render pixels arranged with Matplotlib; approximate eye/eye-chin alignment."+ },+ "final_keys": [+ {+ "name": "Basis_Studio_Female",+ "value": 1.0,+ "muted": false+ },+ {+ "name": "01_Soften_brow",+ "value": 1.0,+ "muted": false+ },+ {+ "name": "02_Nose_width",+ "value": 1.0,+ "muted": false+ },+ {+ "name": "03_Nose_projection",+ "value": 1.0,+ "muted": false+ },+ {+ "name": "04_Mouth_width",+ "value": 1.0,+ "muted": false+ },+ {+ "name": "05_Lip_projection",+ "value": 1.0,+ "muted": false+ },+ {+ "name": "06_Jaw_taper",+ "value": 1.0,+ "muted": false+ },+ {+ "name": "07_Chin_width",+ "value": 1.0,+ "muted": false+ },+ {+ "name": "08_Cheek_softness",+ "value": 1.0,+ "muted": false+ },+ {+ "name": "09_Eye_aperture",+ "value": 1.0,+ "muted": false+ },+ {+ "name": "10_Lower_face_proportion",+ "value": 1.0,+ "muted": false+ },+ {+ "name": "11_Nasal_tip",+ "value": 1.0,+ "muted": false+ },+ {+ "name": "V7_01_Mouth_Height",+ "value": 1.0,+ "muted": false+ },+ {+ "name": "V7_02_Mouth_Width",+ "value": 1.0,+ "muted": false+ },+ {+ "name": "V7_03_Jaw_Chin_Taper",+ "value": 0.5,+ "muted": false+ },+ {+ "name": "V7_04_Orbital_Proportion",+ "value": 1.0,+ "muted": false+ },+ {+ "name": "V7_05_Cheek_Transition",+ "value": 0.0,+ "muted": true+ },+ {+ "name": "V7_06_Chin_Roundness",+ "value": 1.0,+ "muted": false+ },+ {+ "name": "V7_07_Ear_Proportion",+ "value": 1.0,+ "muted": false+ },+ {+ "name": "V7_08_Nose_Profile",+ "value": 1.0,+ "muted": false+ },+ {+ "name": "V7_09_Upper_Lip",+ "value": 0.0,+ "muted": true+ },+ {+ "name": "V7_10_Oral_Contact",+ "value": 0.0,+ "muted": true+ },+ {+ "name": "V7_11_Cheek_Plane_Fairing",+ "value": 0.0,+ "muted": true+ }+ ],+ "limits": [+ "Facial identity needs further work",+ "Strict new-crossing-pair check fails at Multires level 2",+ "Internal source contacts and neck attachment unfinished",+ "No rig, expression, UV, runtime export or Estella acceptance"+ ]+}\ No newline at end of filediff --git a/art/characters/qinglan/face-study-v7/qinglan-identity-cage.blend b/art/characters/qinglan/face-study-v7/qinglan-identity-cage.blendnew file mode 100644index 000000000..4dfbac5deBinary files /dev/null and b/art/characters/qinglan/face-study-v7/qinglan-identity-cage.blend differdiff --git a/art/characters/qinglan/face-study-v7/review/accepted-key-values.json b/art/characters/qinglan/face-study-v7/review/accepted-key-values.jsonnew file mode 100644index 000000000..3025ccf61--- /dev/null+++ b/art/characters/qinglan/face-study-v7/review/accepted-key-values.json@@ -0,0 +1,117 @@+[+ {+ "name": "Basis_Studio_Female",+ "value": 1.0,+ "muted": false+ },+ {+ "name": "01_Soften_brow",+ "value": 1.0,+ "muted": false+ },+ {+ "name": "02_Nose_width",+ "value": 1.0,+ "muted": false+ },+ {+ "name": "03_Nose_projection",+ "value": 1.0,+ "muted": false+ },+ {+ "name": "04_Mouth_width",+ "value": 1.0,+ "muted": false+ },+ {+ "name": "05_Lip_projection",+ "value": 1.0,+ "muted": false+ },+ {+ "name": "06_Jaw_taper",+ "value": 1.0,+ "muted": false+ },+ {+ "name": "07_Chin_width",+ "value": 1.0,+ "muted": false+ },+ {+ "name": "08_Cheek_softness",+ "value": 1.0,+ "muted": false+ },+ {+ "name": "09_Eye_aperture",+ "value": 1.0,+ "muted": false+ },+ {+ "name": "10_Lower_face_proportion",+ "value": 1.0,+ "muted": false+ },+ {+ "name": "11_Nasal_tip",+ "value": 1.0,+ "muted": false+ },+ {+ "name": "V7_01_Mouth_Height",+ "value": 1.0,+ "muted": false+ },+ {+ "name": "V7_02_Mouth_Width",+ "value": 1.0,+ "muted": false+ },+ {+ "name": "V7_03_Jaw_Chin_Taper",+ "value": 0.5,+ "muted": false+ },+ {+ "name": "V7_04_Orbital_Proportion",+ "value": 1.0,+ "muted": false+ },+ {+ "name": "V7_05_Cheek_Transition",+ "value": 0.0,+ "muted": true+ },+ {+ "name": "V7_06_Chin_Roundness",+ "value": 1.0,+ "muted": false+ },+ {+ "name": "V7_07_Ear_Proportion",+ "value": 1.0,+ "muted": false+ },+ {+ "name": "V7_08_Nose_Profile",+ "value": 1.0,+ "muted": false+ },+ {+ "name": "V7_09_Upper_Lip",+ "value": 0.0,+ "muted": true+ },+ {+ "name": "V7_10_Oral_Contact",+ "value": 0.0,+ "muted": true+ },+ {+ "name": "V7_11_Cheek_Plane_Fairing",+ "value": 0.0,+ "muted": true+ }+]\ No newline at end of filediff --git a/art/characters/qinglan/face-study-v7/review/after-front.png b/art/characters/qinglan/face-study-v7/review/after-front.pngnew file mode 100644index 000000000..86c2415ebBinary files /dev/null and b/art/characters/qinglan/face-study-v7/review/after-front.png differdiff --git a/art/characters/qinglan/face-study-v7/review/after-low.png b/art/characters/qinglan/face-study-v7/review/after-low.pngnew file mode 100644index 000000000..487b28ce6Binary files /dev/null and b/art/characters/qinglan/face-study-v7/review/after-low.png differdiff --git a/art/characters/qinglan/face-study-v7/review/after-profile.png b/art/characters/qinglan/face-study-v7/review/after-profile.pngnew file mode 100644index 000000000..1ec6a3387Binary files /dev/null and b/art/characters/qinglan/face-study-v7/review/after-profile.png differdiff --git a/art/characters/qinglan/face-study-v7/review/after-threequarter.png b/art/characters/qinglan/face-study-v7/review/after-threequarter.pngnew file mode 100644index 000000000..f62c27a4bBinary files /dev/null and b/art/characters/qinglan/face-study-v7/review/after-threequarter.png differdiff --git a/art/characters/qinglan/face-study-v7/review/art-review.json b/art/characters/qinglan/face-study-v7/review/art-review.jsonnew file mode 100644index 000000000..510cc5c32--- /dev/null+++ b/art/characters/qinglan/face-study-v7/review/art-review.json@@ -0,0 +1,45 @@+{+ "status": "needs_revision",+ "stage": "Primary facial proportion comparison complete; head-identity gate remains open",+ "accepted_changes": [+ "Mouth region raised toward the front reference",+ "Reduced mouth width",+ "Moderate jaw taper and rounded chin edge",+ "Extended eye aperture with coordinated globe/iris changes",+ "Raised and shortened source ears",+ "Brow silhouette proxies"+ ],+ "rejected_changes": [+ "Broad cheek fill and constrained cheek envelope produced undesirable transitions",+ "Extra upper-lip lift and forced lip-shell separation changed the intended closed-mouth expression"+ ],+ "remaining_art_issues": [+ "Cheekbone-to-jaw transition remains too angular",+ "Lids and orbital mass remain too heavy for the reference",+ "Nose/lip surface planes and chin still carry the base-mesh identity",+ "Brows are simple proxies; no final hairline, lashes or groom"+ ],+ "technical": {+ "render_structure_gate": true,+ "strict_contact_check": false,+ "cage_source_crossings": 52,+ "cage_new_crossings": 0,+ "level2_source_crossings": 412,+ "level2_current_crossings": 412,+ "level2_new_pairs": 24+ },+ "reviewed_views": [+ "after-front.png",+ "after-profile.png",+ "after-threequarter.png",+ "after-low.png",+ "reference-camera-front.png",+ "reference-camera-profile.png",+ "reference-camera-threequarter.png",+ "cage-front.png",+ "cage-threequarter.png",+ "reference-overlay.png",+ "reference-multiview.png"+ ],+ "next_work": "Remain at the head-identity gate. Correct cheek planes and lid thickness in small local areas, compare fixed renders, and clean the lip contact topology before production export."+}\ No newline at end of filediff --git a/art/characters/qinglan/face-study-v7/review/cage-front.png b/art/characters/qinglan/face-study-v7/review/cage-front.pngnew file mode 100644index 000000000..f7c01199cBinary files /dev/null and b/art/characters/qinglan/face-study-v7/review/cage-front.png differdiff --git a/art/characters/qinglan/face-study-v7/review/cage-threequarter.png b/art/characters/qinglan/face-study-v7/review/cage-threequarter.pngnew file mode 100644index 000000000..146ea1fc1Binary files /dev/null and b/art/characters/qinglan/face-study-v7/review/cage-threequarter.png differdiff --git a/art/characters/qinglan/face-study-v7/review/cameras.json b/art/characters/qinglan/face-study-v7/review/cameras.jsonnew file mode 100644index 000000000..862c1940a--- /dev/null+++ b/art/characters/qinglan/face-study-v7/review/cameras.json@@ -0,0 +1,121 @@+[+ {+ "name": "Reference_front",+ "type": "PERSP",+ "lens_mm": 90.0,+ "ortho_scale": 6.0,+ "location": [+ 0.0,+ -0.8379999995231628,+ 1.5820000171661377+ ],+ "rotation_euler": [+ 1.5707964897155762,+ -0.0,+ 0.0+ ],+ "calibrated": false+ },+ {+ "name": "Reference_profile",+ "type": "PERSP",+ "lens_mm": 90.0,+ "ortho_scale": 6.0,+ "location": [+ -0.8179086446762085,+ -0.3397546410560608,+ 1.5820000171661377+ ],+ "rotation_euler": [+ 1.570796251296997,+ -8.364411030470364e-08,+ -1.2566369771957397+ ],+ "calibrated": false+ },+ {+ "name": "Reference_threequarter",+ "type": "PERSP",+ "lens_mm": 90.0,+ "ortho_scale": 6.0,+ "location": [+ 0.33386844396591187,+ -0.7639831900596619,+ 1.5820000171661377+ ],+ "rotation_euler": [+ 1.5707961320877075,+ -2.329406001422285e-09,+ 0.43633222579956055+ ],+ "calibrated": false+ },+ {+ "name": "Review_front",+ "type": "ORTHO",+ "lens_mm": 90.0,+ "ortho_scale": 0.3089999854564667,+ "location": [+ 0.0,+ -1.2029999494552612,+ 1.5820000171661377+ ],+ "rotation_euler": [+ 1.5707964897155762,+ -0.0,+ 0.0+ ],+ "calibrated": false+ },+ {+ "name": "Review_low",+ "type": "PERSP",+ "lens_mm": 90.0,+ "ortho_scale": 0.3089999854564667,+ "location": [+ 0.46411454677581787,+ -1.0743657350540161,+ 1.3241585493087769+ ],+ "rotation_euler": [+ 1.7949458360671997,+ -4.796226704684159e-08,+ 0.4228539764881134+ ],+ "calibrated": false+ },+ {+ "name": "Review_profile",+ "type": "ORTHO",+ "lens_mm": 90.0,+ "ortho_scale": 0.3089999854564667,+ "location": [+ -1.159999966621399,+ -0.06499999761581421,+ 1.5820000171661377+ ],+ "rotation_euler": [+ 1.5707963705062866,+ -0.0,+ -1.5707963705062866+ ],+ "calibrated": false+ },+ {+ "name": "Review_threequarter",+ "type": "PERSP",+ "lens_mm": 90.0,+ "ortho_scale": 0.3089999854564667,+ "location": [+ 0.665216326713562,+ -0.9933090209960938,+ 1.5820000171661377+ ],+ "rotation_euler": [+ 1.5707963705062866,+ 1.4855039864869468e-08,+ 0.610725998878479+ ],+ "calibrated": false+ }+]\ No newline at end of filediff --git a/art/characters/qinglan/face-study-v7/review/cheek-fairing.json b/art/characters/qinglan/face-study-v7/review/cheek-fairing.jsonnew file mode 100644index 000000000..b4fc760b2--- /dev/null+++ b/art/characters/qinglan/face-study-v7/review/cheek-fairing.json@@ -0,0 +1,9 @@+{+ "target": "Fill the hollow cheek surface to a local convex envelope; matched X/Z contour held",+ "depth_only": true,+ "internal_vertices_protected_by_front_visibility": true,+ "key": "V7_11_Cheek_Plane_Fairing",+ "moved_control_vertices": 307,+ "max_displacement_mm": 18.000000000000004,+ "protected_body_delta_m": 0+}\ No newline at end of filediff --git a/art/characters/qinglan/face-study-v7/review/contact-protection.json b/art/characters/qinglan/face-study-v7/review/contact-protection.jsonnew file mode 100644index 000000000..eafe05314--- /dev/null+++ b/art/characters/qinglan/face-study-v7/review/contact-protection.json@@ -0,0 +1,17 @@+{+ "orbital": {+ "target": "Visible lid edits with fixed deep orbital return",+ "key": "V7_04_Orbital_Proportion",+ "moved_control_vertices": 662,+ "max_displacement_mm": 5.767201229172113,+ "protected_body_delta_m": 0+ },+ "oral": {+ "target": "Separate upper/lower lip shells using geodesic surface labels",+ "separation_each_side_m": 0.0011,+ "key": "V7_10_Oral_Contact",+ "moved_control_vertices": 425,+ "max_displacement_mm": 1.100000000000101,+ "protected_body_delta_m": 0+ }+}\ No newline at end of filediff --git a/art/characters/qinglan/face-study-v7/review/control-edits.json b/art/characters/qinglan/face-study-v7/review/control-edits.jsonnew file mode 100644index 000000000..801c33b83--- /dev/null+++ b/art/characters/qinglan/face-study-v7/review/control-edits.json@@ -0,0 +1,36 @@+[+ {+ "target": "Raise oral region toward reference lip-line height",+ "target_lift_m": 0.0085,+ "key": "V7_01_Mouth_Height",+ "moved_control_vertices": 1019,+ "max_displacement_mm": 8.499999999999952,+ "protected_body_delta_m": 0+ },+ {+ "target": "Compact lip outline",+ "central_width_scale": 0.9,+ "key": "V7_02_Mouth_Width",+ "moved_control_vertices": 820,+ "max_displacement_mm": 3.1586424794584484,+ "protected_body_delta_m": 0+ },+ {+ "target": "Oval lower-face contour; oral rings protected from jaw taper",+ "strength": 0.65,+ "key": "V7_03_Jaw_Chin_Taper",+ "moved_control_vertices": 1664,+ "max_displacement_mm": 6.620841878967831,+ "protected_body_delta_m": 0+ },+ {+ "target": "Wider almond-shaped aperture with coordinated lid tilt",+ "outer_canthal_target_m": 0.0055,+ "inner_canthal_target_m": -0.001,+ "tilt_m": 0.002,+ "key": "V7_04_Orbital_Proportion",+ "moved_control_vertices": 662,+ "max_displacement_mm": 5.7671600440269675,+ "protected_body_delta_m": 0+ }+]\ No newline at end of filediff --git a/art/characters/qinglan/face-study-v7/review/face-review.png b/art/characters/qinglan/face-study-v7/review/face-review.pngnew file mode 100644index 000000000..46478bd35Binary files /dev/null and b/art/characters/qinglan/face-study-v7/review/face-review.png differdiff --git a/art/characters/qinglan/face-study-v7/review/feature-edits.json b/art/characters/qinglan/face-study-v7/review/feature-edits.jsonnew file mode 100644index 000000000..9feadf156--- /dev/null+++ b/art/characters/qinglan/face-study-v7/review/feature-edits.json@@ -0,0 +1,23 @@+[+ {+ "target": "Raise and shorten low source ears to the reference eye/nose-base band",+ "key": "V7_07_Ear_Proportion",+ "moved_control_vertices": 558,+ "max_displacement_mm": 13.15680692571292,+ "protected_body_delta_m": 0+ },+ {+ "target": "Soften projecting nasal tip while preserving bridge and nostril topology",+ "key": "V7_08_Nose_Profile",+ "moved_control_vertices": 188,+ "max_displacement_mm": 3.200000000000008,+ "protected_body_delta_m": 0+ },+ {+ "target": "Restore upper-lip volume above the raised mouth seam",+ "key": "V7_09_Upper_Lip",+ "moved_control_vertices": 203,+ "max_displacement_mm": 2.4041630560342337,+ "protected_body_delta_m": 0+ }+]\ No newline at end of filediff --git a/art/characters/qinglan/face-study-v7/review/globe-fit.json b/art/characters/qinglan/face-study-v7/review/globe-fit.jsonnew file mode 100644index 000000000..19c1a93fe--- /dev/null+++ b/art/characters/qinglan/face-study-v7/review/globe-fit.json@@ -0,0 +1,12 @@+[+ {+ "side": "L",+ "method": "Same spatial deformation as orbital control region",+ "max_delta_mm": 5.647635334806258+ },+ {+ "side": "R",+ "method": "Same spatial deformation as orbital control region",+ "max_delta_mm": 5.638280084070033+ }+]\ No newline at end of filediff --git a/art/characters/qinglan/face-study-v7/review/iris-fit.json b/art/characters/qinglan/face-study-v7/review/iris-fit.jsonnew file mode 100644index 000000000..bfda54ca2--- /dev/null+++ b/art/characters/qinglan/face-study-v7/review/iris-fit.json@@ -0,0 +1,26 @@+[+ {+ "object": "Iris_L",+ "radius_m": 0.0066,+ "surface_offset_m": 6e-05,+ "ray_misses": 0+ },+ {+ "object": "Pupil_L",+ "radius_m": 0.0017,+ "surface_offset_m": 0.00012,+ "ray_misses": 0+ },+ {+ "object": "Iris_R",+ "radius_m": 0.0066,+ "surface_offset_m": 6e-05,+ "ray_misses": 0+ },+ {+ "object": "Pupil_R",+ "radius_m": 0.0017,+ "surface_offset_m": 0.00012,+ "ray_misses": 0+ }+]\ No newline at end of filediff --git a/art/characters/qinglan/face-study-v7/review/projected-pupils.json b/art/characters/qinglan/face-study-v7/review/projected-pupils.jsonnew file mode 100644index 000000000..bed170665--- /dev/null+++ b/art/characters/qinglan/face-study-v7/review/projected-pupils.json@@ -0,0 +1,42 @@+{+ "Review_front": {+ "L": [+ 385.07258892059326,+ 347.17040061950684+ ],+ "R": [+ 214.869886636734,+ 347.1713066101074+ ]+ },+ "Reference_front": {+ "L": [+ 393.6455726623535,+ 341.84627532958984+ ],+ "R": [+ 206.3164472579956,+ 341.8630123138428+ ]+ },+ "Reference_profile": {+ "L": [+ 459.0073227882385,+ 353.19910049438477+ ],+ "R": [+ 420.64218521118164,+ 349.58887100219727+ ]+ },+ "Reference_threequarter": {+ "L": [+ 278.4447491168976,+ 341.3761615753174+ ],+ "R": [+ 114.93492722511292,+ 343.6403751373291+ ]+ }+}\ No newline at end of filediff --git a/art/characters/qinglan/face-study-v7/review/reference-camera-front.png b/art/characters/qinglan/face-study-v7/review/reference-camera-front.pngnew file mode 100644index 000000000..dbabc6534Binary files /dev/null and b/art/characters/qinglan/face-study-v7/review/reference-camera-front.png differdiff --git a/art/characters/qinglan/face-study-v7/review/reference-camera-profile.png b/art/characters/qinglan/face-study-v7/review/reference-camera-profile.pngnew file mode 100644index 000000000..bf5d7ab93Binary files /dev/null and b/art/characters/qinglan/face-study-v7/review/reference-camera-profile.png differdiff --git a/art/characters/qinglan/face-study-v7/review/reference-camera-threequarter.png b/art/characters/qinglan/face-study-v7/review/reference-camera-threequarter.pngnew file mode 100644index 000000000..4fd090ed8Binary files /dev/null and b/art/characters/qinglan/face-study-v7/review/reference-camera-threequarter.png differdiff --git a/art/characters/qinglan/face-study-v7/review/reference-multiview.png b/art/characters/qinglan/face-study-v7/review/reference-multiview.pngnew file mode 100644index 000000000..aaa7d2f17Binary files /dev/null and b/art/characters/qinglan/face-study-v7/review/reference-multiview.png differdiff --git a/art/characters/qinglan/face-study-v7/review/reference-overlay.png b/art/characters/qinglan/face-study-v7/review/reference-overlay.pngnew file mode 100644index 000000000..062309bf5Binary files /dev/null and b/art/characters/qinglan/face-study-v7/review/reference-overlay.png differdiff --git a/art/characters/qinglan/face-study-v7/review/secondary-edits.json b/art/characters/qinglan/face-study-v7/review/secondary-edits.jsonnew file mode 100644index 000000000..d3cc4bbe4--- /dev/null+++ b/art/characters/qinglan/face-study-v7/review/secondary-edits.json@@ -0,0 +1,18 @@+[+ {+ "target": "Restore cheek fullness and fair cheek-to-jaw depth",+ "cheek_fill_m": 0.006,+ "relax_iterations": 6,+ "key": "V7_05_Cheek_Transition",+ "moved_control_vertices": 769,+ "max_displacement_mm": 6.338067959714949,+ "protected_body_delta_m": 0+ },+ {+ "target": "Round the blunt chin edge while holding the central chin anchor",+ "key": "V7_06_Chin_Roundness",+ "moved_control_vertices": 357,+ "max_displacement_mm": 3.1416584610686193,+ "protected_body_delta_m": 0+ }+]\ No newline at end of filediff --git a/art/characters/qinglan/face-study-v7/review/verification.json b/art/characters/qinglan/face-study-v7/review/verification.jsonnew file mode 100644index 000000000..c5db9f9e0--- /dev/null+++ b/art/characters/qinglan/face-study-v7/review/verification.json@@ -0,0 +1,890 @@+{+ "scope": "Editable face proportion study; no rig, engine or visual acceptance implied.",+ "protected_body_delta_m": 0.0,+ "source_topology_vertices": 10582,+ "new_key_count": 11,+ "levels": {+ "0": {+ "vertices": 3771,+ "faces": 3744,+ "audit": {+ "object": "Audit_Only_V7",+ "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.006328,+ "edge_len_cv": 0.707,+ "symmetry_pct": 77.41,+ "dimensions": [+ 0.2579,+ 0.2188,+ 0.3036+ ],+ "ngon_faces_sample": [],+ "pole_e5_sample": [+ [+ -0.0186,+ -0.1402,+ 1.5357+ ],+ [+ -0.0196,+ -0.1391,+ 1.5367+ ],+ [+ -0.0228,+ -0.1329,+ 1.5978+ ],+ [+ -0.0214,+ -0.1317,+ 1.6018+ ],+ [+ -0.0524,+ -0.1261,+ 1.6023+ ],+ [+ -0.0074,+ -0.1591,+ 1.5595+ ],+ [+ -0.0725,+ -0.0632,+ 1.6084+ ],+ [+ -0.0492,+ -0.1305,+ 1.5904+ ],+ [+ -0.0079,+ -0.1481,+ 1.5924+ ],+ [+ -0.0747,+ -0.0574,+ 1.6259+ ],+ [+ -0.0295,+ -0.1358,+ 1.6141+ ],+ [+ -0.0192,+ -0.141,+ 1.522+ ],+ [+ -0.0153,+ -0.1339,+ 1.6013+ ],+ [+ -0.0143,+ -0.1494,+ 1.5513+ ],+ [+ -0.0607,+ -0.064,+ 1.5404+ ],+ [+ -0.0086,+ -0.1418,+ 1.6169+ ],+ [+ -0.0199,+ -0.1442,+ 1.5624+ ],+ [+ -0.018,+ -0.1353,+ 1.5927+ ],+ [+ -0.0135,+ -0.1496,+ 1.5555+ ],+ [+ -0.0613,+ -0.0967,+ 1.5514+ ],+ [+ -0.0048,+ -0.1535,+ 1.5551+ ],+ [+ -0.0044,+ -0.1517,+ 1.5596+ ],+ [+ -0.0255,+ -0.1305,+ 1.5448+ ],+ [+ -0.0138,+ -0.1446,+ 1.5487+ ],+ [+ -0.0145,+ -0.1348,+ 1.5202+ ]+ ],+ "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.0192,+ -0.1374,+ 1.5348+ ],+ [+ -0.0201,+ -0.1376,+ 1.5369+ ],+ [+ -0.0175,+ -0.1328,+ 1.5989+ ],+ [+ -0.0182,+ -0.1334,+ 1.5969+ ],+ [+ -0.0068,+ -0.157,+ 1.5598+ ],+ [+ -0.0172,+ -0.1465,+ 1.5628+ ],+ [+ -0.009,+ -0.1442,+ 1.5042+ ],+ [+ -0.054,+ -0.1253,+ 1.604+ ],+ [+ -0.0226,+ -0.1412,+ 1.6255+ ],+ [+ -0.0278,+ -0.136,+ 1.5929+ ],+ [+ -0.0247,+ -0.1033,+ 1.6965+ ],+ [+ -0.0112,+ -0.1512,+ 1.5597+ ],+ [+ -0.0064,+ -0.1521,+ 1.5634+ ],+ [+ -0.0028,+ -0.1558,+ 1.5607+ ],+ [+ -0.0221,+ -0.1333,+ 1.6057+ ],+ [+ -0.009,+ -0.15,+ 1.561+ ],+ [+ -0.0238,+ -0.1324,+ 1.5401+ ],+ [+ -0.0236,+ -0.1312,+ 1.5359+ ],+ [+ -0.0101,+ -0.1462,+ 1.5505+ ],+ [+ -0.0228,+ -0.0779,+ 1.5195+ ],+ [+ -0.0276,+ -0.0799,+ 1.5586+ ]+ ]+ },+ "render_gate": {+ "profile": "render",+ "eps": 4.5e-05,+ "tol": 0.000909,+ "gap": 0.004545,+ "pass": true,+ "errors": [],+ "warnings": [],+ "per_object": {+ "Audit_Only_V7": {+ "tris": 7468,+ "parts": 1,+ "errors": [],+ "warnings": []+ }+ },+ "skipped": []+ },+ "max_total_delta_mm": 13.753316094861326,+ "face_patch_faces": 2407,+ "source_bvh_candidates": 55,+ "current_bvh_candidates": 55,+ "source_confirmed_crossings": 52,+ "current_confirmed_crossings": 52,+ "new_confirmed_crossings": 0,+ "new_crossing_pairs": [],+ "new_crossing_centers": [],+ "limits": "Local face patch, millimetre-scale segment/triangle tests; inherited crossings retained, tangencies and coplanar overlaps not certified."+ },+ "2": {+ "vertices": 60833,+ "faces": 60688,+ "audit": {+ "object": "Audit_Only_V7",+ "verts": 60833,+ "edges": 121520,+ "faces": 60688,+ "tris_equivalent": 121376,+ "tris": 0,+ "quads": 60688,+ "ngons": 0,+ "quads_pct": 100.0,+ "valence_hist_interior": {+ "3": 88,+ "4": 60373,+ "5": 84+ },+ "poles_e3": 88,+ "poles_e5plus": 84,+ "valence_6plus": 0,+ "non_manifold_edges": 0,+ "boundary_loops": [+ 288+ ],+ "loose_verts": 0,+ "loose_edges": 0,+ "zero_area_faces": 0,+ "duplicate_verts": 0,+ "flipped_faces": 0,+ "self_intersections": 457,+ "edge_len_mean": 0.001615,+ "edge_len_cv": 0.788,+ "symmetry_pct": 79.33,+ "dimensions": [+ 0.2868,+ 0.228,+ 0.3194+ ],+ "ngon_faces_sample": [],+ "pole_e5_sample": [+ [+ -0.0186,+ -0.1402,+ 1.5357+ ],+ [+ -0.0196,+ -0.1391,+ 1.5368+ ],+ [+ -0.0228,+ -0.1329,+ 1.5978+ ],+ [+ -0.0214,+ -0.1318,+ 1.6018+ ],+ [+ -0.0523,+ -0.1262,+ 1.6023+ ],+ [+ -0.0076,+ -0.1591,+ 1.5595+ ],+ [+ -0.0725,+ -0.0632,+ 1.6081+ ],+ [+ -0.0485,+ -0.1305,+ 1.5903+ ],+ [+ -0.0079,+ -0.148,+ 1.5924+ ],+ [+ -0.0747,+ -0.0574,+ 1.6263+ ],+ [+ -0.0297,+ -0.1357,+ 1.6141+ ],+ [+ -0.0192,+ -0.141,+ 1.5219+ ],+ [+ -0.0153,+ -0.1339,+ 1.6013+ ],+ [+ -0.0143,+ -0.1494,+ 1.5515+ ],+ [+ -0.0608,+ -0.064,+ 1.5404+ ],+ [+ -0.0085,+ -0.1419,+ 1.6168+ ],+ [+ -0.0198,+ -0.1442,+ 1.5625+ ],+ [+ -0.018,+ -0.1353,+ 1.5928+ ],+ [+ -0.0135,+ -0.1495,+ 1.5557+ ],+ [+ -0.0613,+ -0.0967,+ 1.5519+ ],+ [+ -0.0049,+ -0.1537,+ 1.5553+ ],+ [+ -0.0044,+ -0.1516,+ 1.5594+ ],+ [+ -0.0256,+ -0.1305,+ 1.5442+ ],+ [+ -0.0138,+ -0.1446,+ 1.5487+ ],+ [+ -0.0146,+ -0.1348,+ 1.52+ ]+ ],+ "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.0192,+ -0.1374,+ 1.5348+ ],+ [+ -0.0201,+ -0.1376,+ 1.5369+ ],+ [+ -0.0175,+ -0.1328,+ 1.5989+ ],+ [+ -0.0182,+ -0.1334,+ 1.597+ ],+ [+ -0.0069,+ -0.1569,+ 1.5597+ ],+ [+ -0.0172,+ -0.1465,+ 1.5628+ ],+ [+ -0.009,+ -0.1442,+ 1.5042+ ],+ [+ -0.054,+ -0.1252,+ 1.604+ ],+ [+ -0.0227,+ -0.1412,+ 1.6255+ ],+ [+ -0.0278,+ -0.136,+ 1.5929+ ],+ [+ -0.0247,+ -0.1033,+ 1.6965+ ],+ [+ -0.0112,+ -0.1513,+ 1.5597+ ],+ [+ -0.0064,+ -0.1522,+ 1.5635+ ],+ [+ -0.0027,+ -0.156,+ 1.5609+ ],+ [+ -0.0221,+ -0.1333,+ 1.6058+ ],+ [+ -0.0091,+ -0.1498,+ 1.5609+ ],+ [+ -0.0238,+ -0.1324,+ 1.5401+ ],+ [+ -0.0235,+ -0.1312,+ 1.536+ ],+ [+ -0.0101,+ -0.1461,+ 1.5508+ ],+ [+ -0.0228,+ -0.0782,+ 1.5195+ ],+ [+ -0.0274,+ -0.0799,+ 1.5588+ ]+ ]+ },+ "render_gate": {+ "profile": "render",+ "eps": 4.9e-05,+ "tol": 0.000972,+ "gap": 0.004861,+ "pass": true,+ "errors": [],+ "warnings": [],+ "per_object": {+ "Audit_Only_V7": {+ "tris": 121376,+ "parts": 1,+ "errors": [],+ "warnings": []+ }+ },+ "skipped": []+ },+ "max_total_delta_mm": 13.404875736928174,+ "face_patch_faces": 37776,+ "source_bvh_candidates": 421,+ "current_bvh_candidates": 423,+ "source_confirmed_crossings": 412,+ "current_confirmed_crossings": 412,+ "new_confirmed_crossings": 24,+ "new_crossing_pairs": [+ [+ 6682,+ 13793+ ],+ [+ 6928,+ 13780+ ],+ [+ 7076,+ 17666+ ],+ [+ 7086,+ 10472+ ],+ [+ 7086,+ 10474+ ],+ [+ 7086,+ 10484+ ],+ [+ 8577,+ 10507+ ],+ [+ 8577,+ 10513+ ],+ [+ 8584,+ 10513+ ],+ [+ 8584,+ 10525+ ],+ [+ 15192,+ 16014+ ],+ [+ 35807,+ 39607+ ],+ [+ 36063,+ 42904+ ],+ [+ 36063,+ 45291+ ],+ [+ 36202,+ 46782+ ],+ [+ 36202,+ 46783+ ],+ [+ 36202,+ 46792+ ],+ [+ 36203,+ 39600+ ],+ [+ 36203,+ 46792+ ],+ [+ 37696,+ 39625+ ],+ [+ 37696,+ 39632+ ],+ [+ 37698,+ 39625+ ],+ [+ 37707,+ 39627+ ],+ [+ 39648,+ 44948+ ]+ ],+ "new_crossing_centers": [+ [+ -0.013933849055320024,+ -0.14943054504692554,+ 1.5363970845937729+ ],+ [+ -0.012274825130589306,+ -0.1489502638578415,+ 1.5364719480276108+ ],+ [+ -0.01702784327790141,+ -0.14386029914021492,+ 1.5357954651117325+ ],+ [+ -0.015833888668566942,+ -0.14496950432658195,+ 1.536106824874878+ ],+ [+ -0.01601894269697368,+ -0.1447228156030178,+ 1.5361255705356598+ ],+ [+ -0.016196890966966748,+ -0.14448141679167747,+ 1.5361500829458237+ ],+ [+ -0.01942742126993835,+ -0.14089735969901085,+ 1.535470262169838+ ],+ [+ -0.019527794094756246,+ -0.1411265768110752,+ 1.5352728068828583+ ],+ [+ -0.019603338791057467,+ -0.14134369418025017,+ 1.5351724475622177+ ],+ [+ -0.019734679022803903,+ -0.1415418591350317,+ 1.5350283980369568+ ],+ [+ -0.016105018090456724,+ -0.14728002808988094,+ 1.535971000790596+ ],+ [+ 0.015137860202230513,+ -0.1461978666484356,+ 1.5361702591180801+ ],+ [+ 0.011197539628483355,+ -0.1496316511183977,+ 1.536720722913742+ ],+ [+ 0.010931915719993412,+ -0.14986305497586727,+ 1.5367355048656464+ ],+ [+ 0.016983462497591972,+ -0.14342406950891018,+ 1.5360122323036194+ ],+ [+ 0.01715043978765607,+ -0.14363949187099934,+ 1.5356962978839874+ ],+ [+ 0.016820366960018873,+ -0.14365237578749657,+ 1.5359944105148315+ ],+ [+ 0.016403302317485213,+ -0.14420903287827969,+ 1.5360139906406403+ ],+ [+ 0.01656227116473019,+ -0.14397111535072327,+ 1.5360273718833923+ ],+ [+ 0.019423044519498944,+ -0.14094420708715916,+ 1.5354686826467514+ ],+ [+ 0.019533694488927722,+ -0.14121193438768387,+ 1.535291850566864+ ],+ [+ 0.0193657495547086,+ -0.14105859957635403,+ 1.5355149656534195+ ],+ [+ 0.019134995993226767,+ -0.1410205326974392,+ 1.5356097519397736+ ],+ [+ 0.020205320324748755,+ -0.1420870628207922,+ 1.5348308235406876+ ]+ ],+ "limits": "Local face patch, millimetre-scale segment/triangle tests; inherited crossings retained, tangencies and coplanar overlaps not certified."+ }+ },+ "delivery_profile": "render only",+ "checks_passed": false,+ "key_values": {+ "V7_01_Mouth_Height": 1.0,+ "V7_02_Mouth_Width": 1.0,+ "V7_03_Jaw_Chin_Taper": 0.5,+ "V7_04_Orbital_Proportion": 1.0,+ "V7_05_Cheek_Transition": 0,+ "V7_06_Chin_Roundness": 1.0,+ "V7_07_Ear_Proportion": 1.0,+ "V7_08_Nose_Profile": 1.0,+ "V7_09_Upper_Lip": 0,+ "V7_10_Oral_Contact": 0,+ "V7_11_Cheek_Plane_Fairing": 0+ },+ "status": "needs_revision_contact_pairs_remain"+}\ No newline at end of filediff --git a/art/characters/qinglan/face-study-v7/scripts/audit_saved.py b/art/characters/qinglan/face-study-v7/scripts/audit_saved.pynew file mode 100644index 000000000..8bb17e718--- /dev/null+++ b/art/characters/qinglan/face-study-v7/scripts/audit_saved.py@@ -0,0 +1,91 @@+"""Compare actual evaluated cage and Multires geometry against the V5 source.++New self-crossings are distinguished from inherited contacts. This is a local+face test; it does not approve likeness, expression deformation or a game asset.+"""+import bpy,json,sys+import numpy as np+from pathlib import Path+from mathutils import Vector+from mathutils.bvhtree import BVHTree+from mathutils.geometry import intersect_ray_tri+ROOT=Path(__file__).resolve().parents[1]+sys.path.extend([str(ROOT/'scripts'),str(Path.home()/'.codex/skills/scenario-blender-expert/scripts')])+import identity_cage as I+import bx_audit as A+bpy.ops.wm.open_mainfile(filepath=str(ROOT/'qinglan-identity-cage.blend'))+head=bpy.data.objects['Qinglan_Identity_Cage'];multi=next(m for m in head.modifiers if m.type=='MULTIRES')+keys=head.data.shape_keys.key_blocks;new_keys=[k for k in keys if k.name.startswith('V7_')]+enabled_values={k.name:(0 if k.mute else k.value) for k in new_keys}+source=I.world_coords(head,I.mixed_coords(head))+current=I.world_coords(head,I.mixed_coords(head,exclude_prefix='NONE'))+protected=source[:,2]<1.47+protected_delta=float(np.linalg.norm(current-source,axis=1)[protected].max(initial=0))+assert protected_delta<2e-7+assert np.isfinite(current).all()+report={'scope':'Editable face proportion study; no rig, engine or visual acceptance implied.',+ 'protected_body_delta_m':protected_delta,'source_topology_vertices':len(source),+ 'new_key_count':len(new_keys),'levels':{},'delivery_profile':'render only'}+def evaluate(level,enabled):+ multi.levels=level+ for key in new_keys:key.value=enabled_values[key.name] if enabled else 0+ bpy.context.view_layer.update();dg=bpy.context.evaluated_depsgraph_get()+ mesh=bpy.data.meshes.new_from_object(head.evaluated_get(dg),preserve_all_data_layers=True,depsgraph=dg)+ mesh.transform(head.matrix_world)+ return mesh+def bvh_candidates(co,polys,face_ids):+ tree=BVHTree.FromPolygons([Vector(p) for p in co],polys)+ return {(face_ids[a],face_ids[b]) for a,b in tree.overlap(tree) if a<b and not set(polys[a])&set(polys[b])}+def narrow(co,pairs,triangles):+ points=[Vector((p-np.array((0,-.12,1.60)))*1000) for p in co]+ def cross(ta,tb):+ a=[points[i] for i in ta];b=[points[i] for i in tb]+ for edges,face in ((a,b),(b,a)):+ for i in range(3):+ origin=edges[i];direction=edges[(i+1)%3]-origin+ if direction.length_squared<1e-20:continue+ hit=intersect_ray_tri(*face,direction.normalized(),origin,True)+ if hit is not None:+ t=(hit-origin).dot(direction)/direction.length_squared+ if 1e-6<t<1-1e-6:return True+ return False+ return {p for p in pairs if any(cross(a,b) for a in triangles[p[0]] for b in triangles[p[1]])}+probe=intersect_ray_tri(Vector((0,0,0)),Vector((1,0,0)),Vector((0,1,0)),Vector((0,0,1)),Vector((.25,.25,-1)),True)+assert probe is not None and probe.length<1+failed=[]+for level in (0,2):+ before=evaluate(level,False);after=evaluate(level,True)+ base=I.coords(before.vertices);actual=I.coords(after.vertices)+ assert len(base)==len(actual) and len(before.polygons)==len(after.polygons)+ polys=[];face_ids=[]+ for p in after.polygons:+ idx=list(p.vertices);v=base[idx]+ if np.any((np.abs(v[:,0])<.082)&(v[:,1]<-.065)&(v[:,2]>1.47)&(v[:,2]<1.65)):+ polys.append(idx);face_ids.append(p.index)+ bp=bvh_candidates(base,polys,face_ids);ap=bvh_candidates(actual,polys,face_ids)+ after.calc_loop_triangles();triangles={}+ for tri in after.loop_triangles:triangles.setdefault(tri.polygon_index,[]).append(tuple(tri.vertices))+ bc=narrow(base,bp,triangles);ac=narrow(actual,ap,triangles);new=ac-bc+ snapshot=bpy.data.objects.new('Audit_Only_V7',after)+ audit=A.audit(snapshot)+ gate=A.deliverable([snapshot],profile='render')+ deltas=np.linalg.norm(actual-base,axis=1)+ result={'vertices':len(actual),'faces':len(after.polygons),'audit':audit,'render_gate':gate,+ 'max_total_delta_mm':float(deltas.max()*1000),'face_patch_faces':len(polys),+ 'source_bvh_candidates':len(bp),'current_bvh_candidates':len(ap),+ 'source_confirmed_crossings':len(bc),'current_confirmed_crossings':len(ac),+ 'new_confirmed_crossings':len(new),+ 'new_crossing_pairs':[list(p) for p in sorted(new)],+ 'new_crossing_centers':[actual[list(after.polygons[a].vertices)+list(after.polygons[b].vertices)].mean(0).tolist() for a,b in sorted(new)],+ 'limits':'Local face patch, millimetre-scale segment/triangle tests; inherited crossings retained, tangencies and coplanar overlaps not certified.'}+ report['levels'][str(level)]=result+ if new or not gate['pass']:failed.append(level)+ bpy.data.objects.remove(snapshot,do_unlink=True);bpy.data.meshes.remove(after);bpy.data.meshes.remove(before)+ print('LEVEL_AUDIT '+json.dumps({'level':level,'faces':result['faces'],'source_crossings':len(bc),'current_crossings':len(ac),'new_crossings':len(new),'render_gate':gate['pass']}),flush=True)+report['checks_passed']=not failed+report['key_values']=enabled_values+report['status']='passed_local_geometry_checks' if not failed else 'needs_revision_contact_pairs_remain'+(ROOT/'review/verification.json').write_text(json.dumps(report,indent=2))+if '--report-only' not in sys.argv:+ assert not failed,'New intersections or a render gate error require correction: '+str(failed)+print('V7_AUDIT_COMPLETE',flush=True)diff --git a/art/characters/qinglan/face-study-v7/scripts/compose_review.py b/art/characters/qinglan/face-study-v7/scripts/compose_review.pynew file mode 100644index 000000000..b7e793373--- /dev/null+++ b/art/characters/qinglan/face-study-v7/scripts/compose_review.py@@ -0,0 +1,65 @@+"""Technical comparison of unchanged source images and Blender renders."""+from pathlib import Path+import numpy as np+import matplotlib+matplotlib.use('Agg')+import matplotlib.pyplot as plt+from matplotlib.font_manager import FontProperties+from PIL import Image+import json+ROOT=Path(__file__).resolve().parents[1]+REF=ROOT.parent/'references/qinglan-face-target.png'+font=FontProperties(fname='C:/Windows/Fonts/msyh.ttc')+ref=np.array(Image.open(REF).convert('RGB'))[:828,:592]+v6=np.array(Image.open(ROOT.parent/'face-study-v6/review/after-front.png').convert('RGB'))+model=np.array(Image.open(ROOT/'review/after-front.png').convert('RGB'))+anchors=[((203.5,364.5),(377.5,364.5)),((214.5,347.0),(385.5,347.0)),((214.5,347.0),(385.5,347.0))]+projection=json.loads((ROOT/'review/projected-pupils.json').read_text())+anchors[2]=(projection['Review_front']['R'],projection['Review_front']['L'])+def place(ax,im,pts,alpha=1):+ (x1,y1),(x2,y2)=pts;d=x2-x1;cx=(x1+x2)/2;cy=(y1+y2)/2+ h,w=im.shape[:2];ax.imshow(im,extent=(-cx/d,(w-cx)/d,(h-cy)/d,-cy/d),alpha=alpha)+ ax.set_xlim(-1.25,1.25);ax.set_ylim(1.80,-.50);ax.axis('off')+fig,axes=plt.subplots(1,4,figsize=(16,6.5),dpi=120,facecolor='#edf0f3')+for ax,im,pts,title in zip(axes,(ref,v6,model),anchors,('设计稿','上一版 V6','控制网格调整 V7')):+ place(ax,im,pts);ax.set_title(title,fontproperties=font,fontsize=15)+ ax.axhline(0,color='#35c5e6',lw=.8);ax.axvline(0,color='white',alpha=.3,lw=.5)+place(axes[3],ref,anchors[0]);place(axes[3],model,anchors[2],.40)+axes[3].set_title('设计稿 / V7 叠加',fontproperties=font,fontsize=15)+fig.suptitle('青岚 · 脸部比例检查',fontproperties=font,fontsize=20,y=.97)+fig.text(.5,.03,'统一瞳距与眼线;手动近似锚点。参考未标定,叠加用于发现比例问题,不能作为精确重建证明。',fontproperties=font,ha='center',fontsize=10)+fig.subplots_adjust(left=.01,right=.99,top=.90,bottom=.08,wspace=.03)+fig.savefig(ROOT/'review/reference-overlay.png');plt.close(fig)+fig,axes=plt.subplots(1,3,figsize=(12,6),dpi=130,facecolor='#edf0f3')+for ax,name in zip(axes,('front','threequarter','profile')):+ ax.imshow(plt.imread(ROOT/'review'/f'after-{name}.png'));ax.axis('off');ax.set_title(name,fontsize=12)+fig.suptitle('QINGLAN | V7 CONTROL-CAGE STUDY',fontsize=17,y=.98)+fig.text(.5,.025,'Editable proportions and brow proxies. Facial identity remains under review.',ha='center',fontsize=10)+fig.subplots_adjust(left=.02,right=.98,top=.89,bottom=.065,wspace=.02)+fig.savefig(ROOT/'review/face-review.png');plt.close(fig)++sheet=np.array(Image.open(REF).convert('RGB'))+fig,axes=plt.subplots(2,3,figsize=(12,9),dpi=140,facecolor='#edf0f3')+for col,name in enumerate(('front','profile','threequarter')):+ crop=sheet[:828,[0,592,1182][col]:[592,1182,1774][col]]+ render=np.array(Image.open(ROOT/'review'/f'reference-camera-{name}.png').convert('RGB'))+ if name=='profile':+ # Approximate visual eye/chin anchors; the reference camera is unknown.+ transforms=[(461,362,(634-362)/1.6),(projection['Reference_profile']['R'][0],projection['Reference_profile']['R'][1],(606-projection['Reference_profile']['R'][1])/1.6)]+ limits=(-1.65,.67)+ else:+ refpts=anchors[0] if name=='front' else ((101,366),(257,361))+ modpts=(projection['Reference_'+name]['R'],projection['Reference_'+name]['L'])+ transforms=[((a[0]+b[0])/2,(a[1]+b[1])/2,b[0]-a[0]) for a,b in (refpts,modpts)]+ limits=(-1.23,1.23) if name=='front' else (-1.10,1.60)+ for row,(im,(cx,cy,d)) in enumerate(zip((crop,render),transforms)):+ ax=axes[row,col];h,w=im.shape[:2]+ ax.imshow(im,extent=(-cx/d,(w-cx)/d,(h-cy)/d,-cy/d))+ ax.set_xlim(*limits);ax.set_ylim(1.85,-.60);ax.axis('off')+ ax.axhline(0,color='#35c5e6',lw=.6,alpha=.6)+ ax.set_title(('设计稿' if row==0 else 'V7 透视检查')+' · '+name,fontproperties=font,fontsize=12)+fig.suptitle('青岚 · 多角度身份检查',fontproperties=font,fontsize=19,y=.985)+fig.text(.5,.022,'90 mm 透视;侧面约 72°、三分之四约 25°。人工近似对齐,镜头未标定;保留灰模差异供继续修改。',fontproperties=font,ha='center',fontsize=10)+fig.subplots_adjust(left=.025,right=.975,top=.90,bottom=.065,hspace=.16,wspace=.05)+fig.savefig(ROOT/'review/reference-multiview.png');plt.close(fig)+print('COMPARISONS_READY')diff --git a/art/characters/qinglan/face-study-v7/scripts/fair_cheeks.py b/art/characters/qinglan/face-study-v7/scripts/fair_cheeks.pynew file mode 100644index 000000000..9c787d0ad--- /dev/null+++ b/art/characters/qinglan/face-study-v7/scripts/fair_cheeks.py@@ -0,0 +1,34 @@+"""Fair the broad cheek plane without changing the matched front contour."""+import bpy,sys,json+import numpy as np+from pathlib import Path+from mathutils import Vector+from mathutils.bvhtree import BVHTree+ROOT=Path(__file__).resolve().parents[1]+sys.path.append(str(ROOT/'scripts'))+import identity_cage as I+bpy.ops.wm.open_mainfile(filepath=str(ROOT/'qinglan-identity-cage.blend'))+head=bpy.data.objects['Qinglan_Identity_Cage'];keys=head.data.shape_keys.key_blocks+multi=next(m for m in head.modifiers if m.type=='MULTIRES');multi.levels=0+name='V7_11_Cheek_Plane_Fairing'+if name in keys:keys[name].value=0+for rejected in ('V7_09_Upper_Lip','V7_10_Oral_Contact'):+ if rejected in keys:keys[rejected].value=0+current=I.world_coords(head,I.mixed_coords(head,exclude_prefix='NONE'));new=current.copy()+u=np.abs(current[:,0]);z=current[:,2];y=current[:,1]+weight=I.band(u,.027,.038,.067,.082)*I.band(z,1.510,1.538,1.564,1.593)*I.smooth((-.045-y)/.035)+tree=BVHTree.FromPolygons([Vector(p) for p in current],[list(p.vertices) for p in head.data.polygons])+visible=np.zeros(len(current))+for i in np.flatnonzero(weight>0):+ hit,normal,index,distance=tree.ray_cast(Vector((current[i,0],-.4,current[i,2])),Vector((0,1,0)))+ if hit is not None and current[i,1]-hit.y<.001:visible[i]=1+# A smooth convex cheek envelope is an explicit volume guide, limited to+# the externally visible cheek. It cannot move the oral cavity or eye return.+target=-.04-.12*np.sqrt(np.maximum(1-(u/.074)**2,0))+fill=np.minimum(np.maximum(y-target,0),.018)+new[:,1]-=fill*weight*visible+report=I.key_delta(head,name,current,new,{'target':'Fill the hollow cheek surface to a local convex envelope; matched X/Z contour held','depth_only':True,'internal_vertices_protected_by_front_visibility':True})+(ROOT/'review/cheek-fairing.json').write_text(json.dumps(report,indent=2))+multi.levels=1;bpy.context.view_layer.update()+I.save_stage('05-cheek-planes');I.save_main()+print('CHEEK_FAIRING_SAVED '+json.dumps(report),flush=True)diff --git a/art/characters/qinglan/face-study-v7/scripts/finalize_candidate.py b/art/characters/qinglan/face-study-v7/scripts/finalize_candidate.pynew file mode 100644index 000000000..354887b0f--- /dev/null+++ b/art/characters/qinglan/face-study-v7/scripts/finalize_candidate.py@@ -0,0 +1,38 @@+"""Keep the successful proportion edits; reject cheek patches and opened lips."""+import bpy,sys,json,math+from pathlib import Path+from mathutils import Vector+ROOT=Path(__file__).resolve().parents[1]+sys.path.append(str(ROOT/'scripts'))+import identity_cage as I+bpy.ops.wm.open_mainfile(filepath=str(ROOT/'qinglan-identity-cage.blend'))+head=bpy.data.objects['Qinglan_Identity_Cage'];keys=head.data.shape_keys.key_blocks+multi=next(m for m in head.modifiers if m.type=='MULTIRES');multi.levels=0+for name in ('V7_05_Cheek_Transition','V7_09_Upper_Lip','V7_10_Oral_Contact','V7_11_Cheek_Plane_Fairing'):+ if name in keys:keys[name].value=0;keys[name].mute=True+keys['V7_03_Jaw_Chin_Taper'].value=.5+multi.levels=2;bpy.context.view_layer.update();I.brow_proxies()+multi.levels=1;multi.render_levels=2;multi.sculpt_levels=1+head['art_status']='Proportion revision for reference review; facial identity not approved'+head['rejected_edits']='Cheek envelope, broad cheek fill, extra upper-lip lift and forced lip opening are muted after visual review'+head['editing_note']='Set Multires viewport level to 0 before scripted control-key changes; restore 1 after update'+for ob in bpy.context.selected_objects:ob.select_set(False)+head.hide_set(False);head.select_set(True);bpy.context.view_layer.objects.active=head+head.active_shape_key_index=keys.find('V7_01_Mouth_Height')+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,-.055,1.585);space.region_3d.view_distance=.46+ space.overlay.show_overlays=False+scene=bpy.context.scene;scene.camera=bpy.data.objects['Review_threequarter']+camera=bpy.data.objects['Reference_profile'];target=Vector((0,-.074,1.582));angle=math.radians(-72)+camera.location=target+Vector((math.sin(angle),-math.cos(angle),0))*.86+camera.rotation_euler=(target-camera.location).to_track_quat('-Z','Y').to_euler()+camera_report=[]+for ob in bpy.data.objects:+ if ob.type=='CAMERA':camera_report.append({'name':ob.name,'type':ob.data.type,'lens_mm':ob.data.lens,'ortho_scale':ob.data.ortho_scale,'location':list(ob.location),'rotation_euler':list(ob.rotation_euler),'calibrated':False})+(ROOT/'review/cameras.json').write_text(json.dumps(camera_report,indent=2))+(ROOT/'review/accepted-key-values.json').write_text(json.dumps([{'name':k.name,'value':k.value,'muted':k.mute} for k in keys],indent=2))+I.save_stage('06-reviewed-proportions');I.save_main()+print('REVIEW_CANDIDATE_SAVED',flush=True)diff --git a/art/characters/qinglan/face-study-v7/scripts/identity_cage.py b/art/characters/qinglan/face-study-v7/scripts/identity_cage.pynew file mode 100644index 000000000..10ba47cfa--- /dev/null+++ b/art/characters/qinglan/face-study-v7/scripts/identity_cage.py@@ -0,0 +1,257 @@+"""Reference-led edits on the original face control cage in the live session.++Each edit has compact anatomical bounds and its own relative shape key. The+original topology and Multires grids stay intact; no global landmark warp.+"""+import bpy,json,sys+import numpy as np+from pathlib import Path+from mathutils import Vector++ROOT=Path(__file__).resolve().parents[1]+OUT=ROOT.parents[3]/'output/qinglan/identity-v7'+for path in (ROOT/'review',OUT):path.mkdir(parents=True,exist_ok=True)+SKILLS=Path.home()/'.codex/skills'+sys.path.append(str(SKILLS/'scenario-blender-expert/scripts'))+import bx_gui as G++def coords(data):+ a=np.empty(len(data)*3,dtype=np.float64)+ data.foreach_get('co',a)+ return a.reshape(-1,3)++def smooth(t):+ t=np.clip(t,0,1);return t*t*(3-2*t)++def band(z,a,b,c,d):+ return smooth((z-a)/(b-a))*smooth((d-z)/(d-c))++def piecewise(x,xp,yp):+ out=np.full_like(x,yp[0],dtype=float)+ for i in range(len(xp)-1):+ t=smooth((x-xp[i])/(xp[i+1]-xp[i]))+ out+=(yp[i+1]-yp[i])*t+ return out++def world_coords(ob,co):+ m=np.array(ob.matrix_world)+ return co@m[:3,:3].T+m[:3,3]++def local_coords(ob,co):+ m=np.array(ob.matrix_world.inverted())+ return co@m[:3,:3].T+m[:3,3]++def mixed_coords(ob,exclude_prefix='V7_'):+ keys=ob.data.shape_keys.key_blocks+ base=coords(keys[0].data);out=base.copy()+ for k in list(keys)[1:]:+ if not k.name.startswith(exclude_prefix) and not k.mute:out+=(coords(k.data)-base)*k.value+ return out++def prepare():+ assert bpy.data.filepath.endswith(('qinglan-live-face.blend','qinglan-identity-cage.blend'))+ source=bpy.data.objects['Qinglan_Head_Multires']+ head=bpy.data.objects.get('Qinglan_Identity_Cage')+ if head is None:+ head=source.copy();head.data=source.data.copy();head.name='Qinglan_Identity_Cage'+ bpy.context.scene.collection.objects.link(head)+ for name in ('Qinglan_Head_Multires','Qinglan_Live_Sculpt'):+ ob=bpy.data.objects.get(name)+ if ob:ob.hide_render=True;ob.hide_set(True)+ head.hide_render=False;head.hide_set(False)+ multi=next(m for m in head.modifiers if m.type=='MULTIRES')+ multi.levels=1;multi.render_levels=2;multi.sculpt_levels=1+ head['editing_stage']='Reference identity at control-cage resolution'+ head['source']='V5 original quad topology and Multires, with all original keys retained'+ head['protected_body']='All new shape-key deltas below world Z 1.47 m are zero'+ for ob in bpy.context.selected_objects:ob.select_set(False)+ head.select_set(True);bpy.context.view_layer.objects.active=head+ G.set_view('FRONT')+ w,a,r,v=G.view3d();v.view_location=(0,-.055,1.585);v.view_distance=.46;v.update()+ a.spaces.active.overlay.show_overlays=False+ return head++def eye_field(p,outer=.0055,inner=-.0010,tilt=.0020):+ out=p.copy();u=np.abs(p[:,0]);z=p[:,2]+ wz=band(z,1.576,1.590,1.617,1.638)+ # The inner orbital return has pre-existing touching faces. Keep that+ # return fixed; only deform the visible lid and the forward globe surface.+ front=smooth((-.116-p[:,1])/.012)+ dx=piecewise(u,[0,.008,.020,.0329,.045,.074],[0,0,inner,0,outer,0])+ out[:,0]+=np.sign(p[:,0])*dx*wz*front+ orbital=band(u,.010,.020,.050,.069)*front+ tilt_weight=band(z,1.582,1.591,1.614,1.631)+ out[:,2]+=tilt*np.clip((u-.0329)/.018,-1,1)*orbital*tilt_weight+ upper=band(z,1.601,1.607,1.611,1.630)+ lower=band(z,1.579,1.592,1.598,1.602)+ mid=band(u,.014,.026,.040,.058)*front+ out[:,2]+=(-.0011*upper+.00045*lower)*mid+ return out++def key_delta(ob,name,current,new,stage):+ keys=ob.data.shape_keys.key_blocks;base=coords(keys[0].data)+ delta=local_coords(ob,new)-local_coords(ob,current)+ key=keys.get(name) or ob.shape_key_add(name=name)+ key.data.foreach_set('co',(base+delta).astype(np.float32).ravel())+ key.value=0;key.value=1;ob.data.update()+ length=np.linalg.norm(new-current,axis=1)+ assert np.max(length[current[:,2]<1.47],initial=0)==0+ stage.update({'key':name,'moved_control_vertices':int((length>1e-8).sum()),+ 'max_displacement_mm':float(length.max()*1000),'protected_body_delta_m':0})+ return stage++def secondary_volume(cheek_fill=.006,jaw_relax=.35):+ head=bpy.data.objects['Qinglan_Identity_Cage'];keys=head.data.shape_keys.key_blocks+ names=('V7_05_Cheek_Transition','V7_06_Chin_Roundness')+ for name in names:+ if name in keys:keys[name].value=0+ current=world_coords(head,mixed_coords(head,exclude_prefix='NONE'));new=current.copy()+ u=np.abs(current[:,0]);z=current[:,2];y=current[:,1]+ # Restore the soft tissue beneath the zygoma after the silhouette taper.+ # Compact support excludes the lips, eyelids, ear canal and neck.+ weight=band(u,.026,.043,.062,.082)*band(z,1.505,1.537,1.555,1.584)*smooth((-.025-y)/.050)+ new[:,1]-=cheek_fill*weight+ # Local fairing of cheek depth. X and Z remain the approved proportions.+ edges=np.array([e.vertices[:] for e in head.data.edges]);a=edges[:,0];b=edges[:,1]+ degree=np.bincount(edges.ravel(),minlength=len(current))+ for _ in range(6):+ sums=np.bincount(a,weights=new[b,1],minlength=len(current))+np.bincount(b,weights=new[a,1],minlength=len(current))+ mean=sums/np.maximum(degree,1)+ new[:,1]+=(mean-new[:,1])*weight*jaw_relax+ reports=[key_delta(head,names[0],current,new,{'target':'Restore cheek fullness and fair cheek-to-jaw depth','cheek_fill_m':cheek_fill,'relax_iterations':6})]+ current=new;new=current.copy();u=np.abs(current[:,0]);z=current[:,2]+ w=band(z,1.472,1.488,1.505,1.525)*smooth((-.025-current[:,1])/.050)+ w*=1-smooth((u-.028)/.025)+ new[:,2]+=.0032*np.clip(u/.030,0,1)**2*w+ reports.append(key_delta(head,names[1],current,new,{'target':'Round the blunt chin edge while holding the central chin anchor'}))+ bpy.context.view_layer.update()+ (ROOT/'review/secondary-edits.json').write_text(json.dumps(reports,indent=2))+ print(json.dumps(reports))++def rebuild(mouth_lift=.0085,mouth_width=.90,outer_eye=.0055,inner_eye=-.0010,eye_tilt=.0020,jaw_strength=1.0):+ head=bpy.data.objects['Qinglan_Identity_Cage'];keys=head.data.shape_keys.key_blocks+ next(m for m in head.modifiers if m.type=='MULTIRES').levels=0+ for k in keys:+ if k.name.startswith('V7_'):k.value=0+ current=world_coords(head,mixed_coords(head));stages=[]+ # Nose base and chin are stationary anchors. The whole mouth region,+ # including its internal seam, follows a smooth monotonic vertical field.+ new=current.copy();z=current[:,2];u=np.abs(current[:,0])+ w=band(z,1.489,1.520,1.535,1.556)+ w*=smooth((-.035-current[:,1])/.035)*(1-smooth((u-.045)/.030))+ new[:,2]+=mouth_lift*w+ stages.append(key_delta(head,'V7_01_Mouth_Height',current,new,{'target':'Raise oral region toward reference lip-line height','target_lift_m':mouth_lift}))+ current=new+ new=current.copy();u=np.abs(current[:,0]);z=current[:,2]+ w=band(z,1.511,1.528,1.544,1.563)*smooth((-.055-current[:,1])/.035)+ w*=1-smooth((u-.030)/.024)+ new[:,0]*=1-(1-mouth_width)*w+ stages.append(key_delta(head,'V7_02_Mouth_Width',current,new,{'target':'Compact lip outline','central_width_scale':mouth_width}))+ current=new+ # Taper jaw outside the oral rings; avoid multiplying the mouth-width edit.+ new=current.copy();u=np.abs(current[:,0]);z=current[:,2]+ amount=piecewise(z,[1.474,1.490,1.508,1.536,1.555,1.576,1.602],[0,.10,.17,.16,.10,.035,0])*jaw_strength+ outer=smooth((u-.026)/.023)+ chin=1-smooth((z-1.510)/.016)+ shape=np.maximum(outer,chin)+ front=smooth((.015-current[:,1])/.035)+ new[:,0]*=1-amount*shape*front+ stages.append(key_delta(head,'V7_03_Jaw_Chin_Taper',current,new,{'target':'Oval lower-face contour; oral rings protected from jaw taper','strength':jaw_strength}))+ current=new+ new=eye_field(current,outer=outer_eye,inner=inner_eye,tilt=eye_tilt)+ stages.append(key_delta(head,'V7_04_Orbital_Proportion',current,new,{'target':'Wider almond-shaped aperture with coordinated lid tilt','outer_canthal_target_m':outer_eye,'inner_canthal_target_m':inner_eye,'tilt_m':eye_tilt}))+ head.active_shape_key_index=len(keys)-1+ bpy.context.view_layer.update()+ (ROOT/'review/control-edits.json').write_text(json.dumps(stages,indent=2))+ print(json.dumps({'stages':stages,'total_control_vertices':len(current)}))++def fit_globes(outer_eye=.0055,inner_eye=-.0010,eye_tilt=.0020):+ report=[]+ for side in ('L','R'):+ ob=bpy.data.objects['GEO-body_female_realistic.eye.'+side]+ keys=ob.data.shape_keys.key_blocks+ for k in keys:+ if k.name.startswith('V7_'):k.value=0+ old_local=mixed_coords(ob);old=world_coords(ob,old_local);new=eye_field(old,outer=outer_eye,inner=inner_eye,tilt=eye_tilt)+ key=keys.get('V7_Orbital_Fit') or ob.shape_key_add(name='V7_Orbital_Fit')+ key.data.foreach_set('co',(coords(keys[0].data)+local_coords(ob,new)-old_local).astype(np.float32).ravel())+ key.value=0;key.value=1;ob.data.update()+ report.append({'side':side,'method':'Same spatial deformation as orbital control region','max_delta_mm':float(np.linalg.norm(new-old,axis=1).max()*1000)})+ bpy.context.view_layer.update()+ (ROOT/'review/globe-fit.json').write_text(json.dumps(report,indent=2))+ print(json.dumps(report))++def fit_irises(iris_radius=.0066,pupil_radius=.0017):+ report=[]+ bpy.context.view_layer.update();dg=bpy.context.evaluated_depsgraph_get()+ for side in ('L','R'):+ globe=bpy.data.objects['GEO-body_female_realistic.eye.'+side]+ ev=globe.evaluated_get(dg);inv=globe.matrix_world.inverted()+ for prefix,radius,offset in (('Iris_',iris_radius,.00006),('Pupil_',pupil_radius,.00012)):+ ob=bpy.data.objects[prefix+side];keys=ob.data.shape_keys.key_blocks+ for k in keys:+ if k.name.startswith('V7_'):k.value=0+ old_local=mixed_coords(ob);old=world_coords(ob,old_local)+ center=old[0].copy();xz=old[:,[0,2]]-center[[0,2]]+ old_radius=np.linalg.norm(xz,axis=1).max()+ xz*=radius/old_radius+ target=old.copy();target[:,[0,2]]=xz+center[[0,2]]+ for i,p in enumerate(target):+ origin=inv@Vector((p[0],-.4,p[2]))+ direction=(inv.to_3x3()@Vector((0,1,0))).normalized()+ hit,q,n,index=ev.ray_cast(origin,direction)+ if not hit:raise RuntimeError('Iris projection missed eye globe')+ target[i,1]=(globe.matrix_world@q).y-offset+ key=keys.get('V7_Iris_Fit') or ob.shape_key_add(name='V7_Iris_Fit')+ key.data.foreach_set('co',(coords(keys[0].data)+local_coords(ob,target)-old_local).astype(np.float32).ravel())+ key.value=1;ob.data.update()+ report.append({'object':ob.name,'radius_m':radius,'surface_offset_m':offset,'ray_misses':0})+ bpy.context.view_layer.update()+ (ROOT/'review/iris-fit.json').write_text(json.dumps(report,indent=2))+ print(json.dumps(report))++def brow_proxies():+ head=bpy.data.objects['Qinglan_Identity_Cage']+ bpy.context.view_layer.update();dg=bpy.context.evaluated_depsgraph_get();ev=head.evaluated_get(dg)+ inv=head.matrix_world.inverted()+ mat=bpy.data.materials.get('Qinglan_Brow_Blockout') or bpy.data.materials.new('Qinglan_Brow_Blockout')+ mat.diffuse_color=(.045,.034,.027,1);mat.use_nodes=True+ bs=next((n for n in mat.node_tree.nodes if n.type=='BSDF_PRINCIPLED'),None)+ if bs is None:+ bs=mat.node_tree.nodes.new('ShaderNodeBsdfPrincipled')+ output=next((n for n in mat.node_tree.nodes if n.type=='OUTPUT_MATERIAL'),None) or mat.node_tree.nodes.new('ShaderNodeOutputMaterial')+ mat.node_tree.links.new(bs.outputs['BSDF'],output.inputs['Surface'])+ bs.inputs['Base Color'].default_value=(.045,.034,.027,1);bs.inputs['Roughness'].default_value=.75+ controls=np.array([[.0135,1.6140,.0011],[.025,1.6188,.0019],[.039,1.6203,.0020],[.050,1.6187,.0013],[.057,1.6157,.00008]])+ slopes=np.gradient(controls[:,1:],controls[:,0],axis=0)+ for side in (-1,1):+ name='Qinglan_Brow_Proxy_'+('L' if side>0 else 'R')+ old=bpy.data.objects.get(name)+ if old:bpy.data.objects.remove(old,do_unlink=True)+ verts=[];faces=[]+ for i in range(65):+ x=controls[0,0]+i/64*(controls[-1,0]-controls[0,0])+ seg=min(max(np.searchsorted(controls[:,0],x)-1,0),len(controls)-2)+ dx=controls[seg+1,0]-controls[seg,0];t=(x-controls[seg,0])/dx+ z,width=(2*t**3-3*t*t+1)*controls[seg,1:]+(t**3-2*t*t+t)*dx*slopes[seg]+(-2*t**3+3*t*t)*controls[seg+1,1:]+(t**3-t*t)*dx*slopes[seg+1]+ for j in range(5):+ zz=z+(j/4*2-1)*width+ origin=inv@Vector((side*x,-.4,zz));direction=(inv.to_3x3()@Vector((0,1,0))).normalized()+ hit,p,n,index=ev.ray_cast(origin,direction)+ if not hit:raise RuntimeError('Brow ray missed the face')+ q=head.matrix_world@p;q.y-=.00022;verts.append(q)+ for i in range(64):+ for j in range(4):+ a=i*5+j;face=(a,a+5,a+6,a+1);faces.append(face if side>0 else tuple(reversed(face)))+ mesh=bpy.data.meshes.new(name);mesh.from_pydata(verts,[],faces);mesh.materials.append(mat);mesh.update()+ ob=bpy.data.objects.new(name,mesh);bpy.context.scene.collection.objects.link(ob)+ ob['purpose']='Temporary brow silhouette for identity review, not final hair'+ for p in mesh.polygons:p.use_smooth=True+ print('BROW_PROXIES_READY')++def save_stage(label):+ bpy.ops.wm.save_as_mainfile(filepath=str(OUT/(label+'.blend')),copy=True,compress=True)++def save_main():+ bpy.ops.wm.save_as_mainfile(filepath=str(ROOT/'qinglan-identity-cage.blend'),compress=True)+diff --git a/art/characters/qinglan/face-study-v7/scripts/package_review.py b/art/characters/qinglan/face-study-v7/scripts/package_review.pynew file mode 100644index 000000000..60b66280f--- /dev/null+++ b/art/characters/qinglan/face-study-v7/scripts/package_review.py@@ -0,0 +1,39 @@+"""Record final provenance and the actual review status, including failed gates."""+import json,hashlib+from pathlib import Path+ROOT=Path(__file__).resolve().parents[1]+source=json.loads((ROOT.parent/'face-study-v5/provenance.json').read_text(encoding='utf-8'))+verification=json.loads((ROOT/'review/verification.json').read_text())+keys=json.loads((ROOT/'review/accepted-key-values.json').read_text())+sha=lambda p:hashlib.sha256(p.read_bytes()).hexdigest()+provenance={+ 'asset':'Qinglan V7 reference-led control-cage proportion study',+ 'status':'editable_review_candidate_not_art_or_production_approved',+ 'created':'2026-10-29',+ 'source':source['source'],+ 'parent_file':'../face-study-v5/qinglan-face-candidate.blend',+ 'parent_sha256':sha(ROOT.parent/'face-study-v5/qinglan-face-candidate.blend'),+ 'current_file':'qinglan-identity-cage.blend','current_sha256':sha(ROOT/'qinglan-identity-cage.blend'),+ 'reference':{'file':'../references/qinglan-face-target.png','sha256':sha(ROOT.parent/'references/qinglan-face-target.png'),'calibrated':False},+ 'workflow':{'blender':'5.2.1 LTS','skill_revision':'d44410f058991f677ccf733a8e86ce95110857eb',+ 'skills':['scenario-blender-expert','scenario-blender-sculpting','scenario-blender-retopology','estella-character-production'],+ 'execution':'Initial control edits over the live Blender MCP connection; after a Blender process crash, recovered from a stage copy and continued through headless CLI. No computer use, no newly launched GUI, no paid add-on activation.',+ 'native_brushes_this_version':False,'comparison_images':'Unaltered reference/render pixels arranged with Matplotlib; approximate eye/eye-chin alignment.'},+ 'final_keys':keys,+ 'limits':['Facial identity needs further work','Strict new-crossing-pair check fails at Multires level 2','Internal source contacts and neck attachment unfinished','No rig, expression, UV, runtime export or Estella acceptance']}+(ROOT/'provenance.json').write_text(json.dumps(provenance,ensure_ascii=False,indent=2),encoding='utf-8')+review={'status':'needs_revision','stage':'Primary facial proportion comparison complete; head-identity gate remains open',+ 'accepted_changes':['Mouth region raised toward the front reference','Reduced mouth width','Moderate jaw taper and rounded chin edge','Extended eye aperture with coordinated globe/iris changes','Raised and shortened source ears','Brow silhouette proxies'],+ 'rejected_changes':['Broad cheek fill and constrained cheek envelope produced undesirable transitions','Extra upper-lip lift and forced lip-shell separation changed the intended closed-mouth expression'],+ 'remaining_art_issues':['Cheekbone-to-jaw transition remains too angular','Lids and orbital mass remain too heavy for the reference','Nose/lip surface planes and chin still carry the base-mesh identity','Brows are simple proxies; no final hairline, lashes or groom'],+ 'technical':{'render_structure_gate':True,'strict_contact_check':verification['checks_passed'],+ 'cage_source_crossings':verification['levels']['0']['source_confirmed_crossings'],+ 'cage_new_crossings':verification['levels']['0']['new_confirmed_crossings'],+ 'level2_source_crossings':verification['levels']['2']['source_confirmed_crossings'],+ 'level2_current_crossings':verification['levels']['2']['current_confirmed_crossings'],+ 'level2_new_pairs':verification['levels']['2']['new_confirmed_crossings']},+ 'reviewed_views':['after-front.png','after-profile.png','after-threequarter.png','after-low.png','reference-camera-front.png','reference-camera-profile.png','reference-camera-threequarter.png','cage-front.png','cage-threequarter.png','reference-overlay.png','reference-multiview.png'],+ 'next_work':'Remain at the head-identity gate. Correct cheek planes and lid thickness in small local areas, compare fixed renders, and clean the lip contact topology before production export.'}+(ROOT/'review/art-review.json').write_text(json.dumps(review,ensure_ascii=False,indent=2),encoding='utf-8')+for path in (ROOT/'review').glob('*.json'):json.loads(path.read_text(encoding='utf-8'))+print(json.dumps({'blend_bytes':(ROOT/'qinglan-identity-cage.blend').stat().st_size,'status':review['status'],'strict_contact_check':review['technical']['strict_contact_check']}))diff --git a/art/characters/qinglan/face-study-v7/scripts/preview_subdivision.py b/art/characters/qinglan/face-study-v7/scripts/preview_subdivision.pynew file mode 100644index 000000000..5ef63aafb--- /dev/null+++ b/art/characters/qinglan/face-study-v7/scripts/preview_subdivision.py@@ -0,0 +1,21 @@+"""Compare the control surface with inherited sculpt displacement, without overwriting it."""+import bpy,sys,json+from pathlib import Path+ROOT=Path(__file__).resolve().parents[1]+bpy.ops.wm.open_mainfile(filepath=str(ROOT/'qinglan-identity-cage.blend'))+head=bpy.data.objects['Qinglan_Identity_Cage']+head.data.shape_keys.key_blocks['V7_10_Oral_Contact'].value=0+head.hide_set(False);bpy.context.view_layer.objects.active=head;head.select_set(True)+multi=next(m for m in head.modifiers if m.type=='MULTIRES')+multi.show_viewport=False;multi.show_render=False+sub=head.modifiers.new('Control_Surface_Subdivision','SUBSURF');sub.levels=2;sub.render_levels=2+bpy.ops.object.modifier_move_to_index(modifier=sub.name,index=0)+scene=bpy.context.scene;scene.render.engine='CYCLES';scene.cycles.samples=24+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'+out=ROOT.parents[3]/'output/qinglan/identity-v7'+for name in ('front','threequarter','profile'):+ scene.camera=bpy.data.objects['Review_'+name];scene.render.filepath=str(out/f'subdivision-{name}.png');bpy.ops.render.render(write_still=True)+bpy.ops.wm.save_as_mainfile(filepath=str(out/'control-surface-preview.blend'),copy=True,compress=True)+print('CONTROL_SURFACE_PREVIEW_COMPLETE',flush=True)diff --git a/art/characters/qinglan/face-study-v7/scripts/protect_contacts.py b/art/characters/qinglan/face-study-v7/scripts/protect_contacts.pynew file mode 100644index 000000000..5269fce12--- /dev/null+++ b/art/characters/qinglan/face-study-v7/scripts/protect_contacts.py@@ -0,0 +1,59 @@+"""Protect the deep orbital return and separate contacting lip shells by flow."""+import bpy,sys,json,heapq+import numpy as np+from pathlib import Path+ROOT=Path(__file__).resolve().parents[1]+sys.path.append(str(ROOT/'scripts'))+import identity_cage as I+bpy.ops.wm.open_mainfile(filepath=str(ROOT/'qinglan-identity-cage.blend'))+head=bpy.data.objects['Qinglan_Identity_Cage'];keys=head.data.shape_keys.key_blocks+multi=next(m for m in head.modifiers if m.type=='MULTIRES')+multi.levels=0+bpy.context.view_layer.update()+print('CONTACT_START',flush=True)+if 'V7_10_Oral_Contact' in keys:keys['V7_10_Oral_Contact'].value=0+keys['V7_04_Orbital_Proportion'].value=0+current=I.world_coords(head,I.mixed_coords(head,exclude_prefix='NONE'))+new=I.eye_field(current)+eye_report=I.key_delta(head,'V7_04_Orbital_Proportion',current,new,{'target':'Visible lid edits with fixed deep orbital return'})+print('ORBITAL_KEY_UPDATED',flush=True)+I.fit_globes();I.fit_irises()+print('EYEBALLS_UPDATED',flush=True)+source=I.world_coords(head,I.mixed_coords(head))+edges=np.array([e.vertices[:] for e in head.data.edges]);neighbors=[[] for _ in source]+for a,b in edges:+ length=float(np.linalg.norm(source[a]-source[b]));neighbors[a].append((int(b),length));neighbors[b].append((int(a),length))+u=np.abs(source[:,0]);z=source[:,2];y=source[:,1]+def distances(seed):+ d=np.full(len(source),np.inf);heap=[]+ for i in np.flatnonzero(seed):d[i]=0;heapq.heappush(heap,(0,int(i)))+ while heap:+ v,i=heapq.heappop(heap)+ if v>d[i]:continue+ for j,length in neighbors[i]:+ candidate=v+length+ if candidate<d[j]:d[j]=candidate;heapq.heappush(heap,(candidate,j))+ return d+upper=distances((u<.020)&(z>1.532)&(z<1.540)&(y<-.137))+lower=distances((u<.020)&(z>1.514)&(z<1.523)&(y<-.137))+assert np.isfinite(upper).any() and np.isfinite(lower).any()+current=I.world_coords(head,I.mixed_coords(head,exclude_prefix='NONE'));new=current.copy()+weight=I.band(z,1.514,1.524,1.531,1.543)*(1-I.smooth((u-.024)/.014))*I.smooth((-.114-y)/.020)+weight*=np.isfinite(upper)&np.isfinite(lower)+sign=np.where(upper<lower,1,-1)+new[:,2]+=.0011*sign*weight+oral_report=I.key_delta(head,'V7_10_Oral_Contact',current,new,{'target':'Separate upper/lower lip shells using geodesic surface labels','separation_each_side_m':.0011})+(ROOT/'review/contact-protection.json').write_text(json.dumps({'orbital':eye_report,'oral':oral_report},indent=2))+# Match the framing of the fixed inspection images. Lens remains at 90 mm.+from mathutils import Vector+for ob in bpy.data.objects:+ if ob.name.startswith('Reference_') and ob.type=='CAMERA':+ target=Vector((0,-.048,1.582));ob.location=target+(ob.location-target).normalized()*.79+multi.levels=2+bpy.context.view_layer.update()+I.brow_proxies()+multi.levels=1+for item in (cameras:=json.loads((ROOT/'review/cameras.json').read_text())):item['distance_m']=.79+(ROOT/'review/cameras.json').write_text(json.dumps(cameras,indent=2))+I.save_stage('04-contact-protection');I.save_main()+print('CONTACT_PROTECTION_SAVED',flush=True)diff --git a/art/characters/qinglan/face-study-v7/scripts/rebuild_primary.py b/art/characters/qinglan/face-study-v7/scripts/rebuild_primary.pynew file mode 100644index 000000000..b534036ca--- /dev/null+++ b/art/characters/qinglan/face-study-v7/scripts/rebuild_primary.py@@ -0,0 +1,12 @@+"""Refine the mouth field as a rigid oral band, preserving the lip structure."""+import bpy,sys+from pathlib import Path+ROOT=Path(__file__).resolve().parents[1]+sys.path.append(str(ROOT/'scripts'))+import identity_cage as I+bpy.ops.wm.open_mainfile(filepath=str(ROOT/'qinglan-identity-cage.blend'))+I.rebuild(jaw_strength=.65)+I.secondary_volume(cheek_fill=.006)+I.fit_globes();I.fit_irises()+I.save_main()+print('PRIMARY_FIELD_REBUILT',flush=True)diff --git a/art/characters/qinglan/face-study-v7/scripts/recover_stage.py b/art/characters/qinglan/face-study-v7/scripts/recover_stage.pynew file mode 100644index 000000000..1e0090a49--- /dev/null+++ b/art/characters/qinglan/face-study-v7/scripts/recover_stage.py@@ -0,0 +1,22 @@+"""Validate and recover the last stage copy after a lost live session."""+import bpy,sys,json+from pathlib import Path+ROOT=Path(__file__).resolve().parents[1]+sys.path.append(str(ROOT/'scripts'))+import identity_cage as I+source=I.OUT/'02-cheek-continuity.blend'+bpy.ops.wm.open_mainfile(filepath=str(source))+head=bpy.data.objects['Qinglan_Identity_Cage']+keys=[(k.name,k.value) for k in head.data.shape_keys.key_blocks if k.name.startswith('V7_')]+assert len(keys)==6 and all(v==1 for _,v in keys)+assert all(bpy.data.objects.get('Qinglan_Brow_Proxy_'+side) for side in ('L','R'))+print('RECOVERED_STATE '+json.dumps(keys),flush=True)+# V5/V6 remain in their original files. Drop only redundant hidden objects+# from this candidate, reducing the saved dependency graph and file size.+for name in ('Qinglan_Head_Multires','Qinglan_Live_Sculpt','Inspection_Cage','Inspection_High'):+ ob=bpy.data.objects.get(name)+ if ob and ob.hide_render:+ mesh=ob.data;bpy.data.objects.remove(ob,do_unlink=True)+ if mesh.users==0:bpy.data.meshes.remove(mesh)+I.save_main()+print('RECOVERY_SAVED',flush=True)diff --git a/art/characters/qinglan/face-study-v7/scripts/refine_saved.py b/art/characters/qinglan/face-study-v7/scripts/refine_saved.pynew file mode 100644index 000000000..206b468fb--- /dev/null+++ b/art/characters/qinglan/face-study-v7/scripts/refine_saved.py@@ -0,0 +1,53 @@+"""Continue reversible control-mesh work on the recovered saved candidate."""+import bpy,sys,json,math+import numpy as np+from pathlib import Path+from mathutils import Vector+ROOT=Path(__file__).resolve().parents[1]+sys.path.append(str(ROOT/'scripts'))+import identity_cage as I+bpy.ops.wm.open_mainfile(filepath=str(ROOT/'qinglan-identity-cage.blend'))+head=bpy.data.objects['Qinglan_Identity_Cage'];keys=head.data.shape_keys.key_blocks+next(m for m in head.modifiers if m.type=='MULTIRES').levels=0+for name in ('V7_07_Ear_Proportion','V7_08_Nose_Profile','V7_09_Upper_Lip'):+ if name in keys:keys[name].value=0+reports=[]+current=I.world_coords(head,I.mixed_coords(head,exclude_prefix='NONE'))+new=current.copy();x=np.abs(current[:,0]);z=current[:,2];y=current[:,1]+# Ears in the reference sit above the nasal base; the source ears are low.+weight=I.smooth((x-.062)/.016)*I.band(z,1.505,1.535,1.610,1.636)*I.smooth((y+.085)/.030)+new[:,2]+=(.010-.16*(z-1.574))*weight+new[:,0]-=np.sign(current[:,0])*.0015*weight+reports.append(I.key_delta(head,'V7_07_Ear_Proportion',current,new,{'target':'Raise and shorten low source ears to the reference eye/nose-base band'}))+current=new;new=current.copy();x=np.abs(current[:,0]);z=current[:,2];y=current[:,1]+# Reduce the sharply projecting source tip; the bridge stays anchored.+w=(1-I.smooth((x-.008)/.013))*I.band(z,1.548,1.558,1.572,1.599)*I.smooth((-.145-y)/.012)+new[:,1]+=.0032*w+reports.append(I.key_delta(head,'V7_08_Nose_Profile',current,new,{'target':'Soften projecting nasal tip while preserving bridge and nostril topology'}))+current=new;new=current.copy();x=np.abs(current[:,0]);z=current[:,2];y=current[:,1]+# The raised oral region compressed the upper vermilion. Restore its height+# without opening the mouth seam or shortening the philtrum further.+w=I.band(z,1.5363,1.5395,1.5432,1.5518)*(1-I.smooth((x-.010)/.016))*I.smooth((-.129-y)/.012)+new[:,2]+=.0023*w+new[:,1]-=.0007*w+reports.append(I.key_delta(head,'V7_09_Upper_Lip',current,new,{'target':'Restore upper-lip volume above the raised mouth seam'}))+bpy.context.view_layer.update()+(ROOT/'review/feature-edits.json').write_text(json.dumps(reports,indent=2))+# Reference views are illustrations, not calibrated orthographic views.+# These explicitly labelled long-lens estimates complement fixed ortho views.+cameras=[]+for name,yaw in [('Reference_front',0),('Reference_profile',-72),('Reference_threequarter',25)]:+ ob=bpy.data.objects.get(name)+ if ob is None:+ data=bpy.data.cameras.new(name);ob=bpy.data.objects.new(name,data);bpy.context.scene.collection.objects.link(ob)+ target=Vector((0,-.048,1.582));angle=math.radians(yaw)+ ob.location=target+Vector((math.sin(angle),-math.cos(angle),0))*.79+ ob.rotation_euler=(target-ob.location).to_track_quat('-Z','Y').to_euler()+ ob.data.type='PERSP';ob.data.lens=90;ob.data.sensor_width=36+ ob.data.clip_start=.001;ob.data.clip_end=20+ ob['calibration']='Approximate yaw and long-lens perspective; reference metadata unavailable'+ cameras.append({'name':name,'yaw_degrees':yaw,'focal_length_mm':90,'distance_m':.79,'calibrated':False})+(ROOT/'review/cameras.json').write_text(json.dumps(cameras,indent=2))+I.save_stage('03-features-and-reference-cameras')+I.save_main()+print('REFINEMENT_SAVED '+json.dumps(reports),flush=True)diff --git a/art/characters/qinglan/face-study-v7/scripts/render_cage.py b/art/characters/qinglan/face-study-v7/scripts/render_cage.pynew file mode 100644index 000000000..01c6251fe--- /dev/null+++ b/art/characters/qinglan/face-study-v7/scripts/render_cage.py@@ -0,0 +1,34 @@+"""Render real control edges, not a dense triangulated beauty surface."""+import bpy,json,sys+from pathlib import Path+from bpy_extras.object_utils import world_to_camera_view+from mathutils import Vector+ROOT=Path(__file__).resolve().parents[1]+sys.path.append(str(ROOT/'scripts'))+import identity_cage as I+bpy.ops.wm.open_mainfile(filepath=str(ROOT/'qinglan-identity-cage.blend'))+head=bpy.data.objects['Qinglan_Identity_Cage'];scene=bpy.context.scene+# Project actual pupil patch centers to support subsequent image overlays.+landmarks={}+for name in ('Review_front','Reference_front','Reference_profile','Reference_threequarter'):+ camera=bpy.data.objects[name];points={}+ for side in ('L','R'):+ eye=bpy.data.objects['Iris_'+side];co=I.world_coords(eye,I.mixed_coords(eye,exclude_prefix='NONE'))[0]+ p=world_to_camera_view(scene,camera,Vector(co));points[side]=[float(p.x*600),float((1-p.y)*800)]+ landmarks[name]=points+(ROOT/'review/projected-pupils.json').write_text(json.dumps(landmarks,indent=2))+multi=next(m for m in head.modifiers if m.type=='MULTIRES');multi.levels=0;multi.render_levels=0+mat=bpy.data.materials.new('Review_Control_Edges');mat.diffuse_color=(.012,.018,.022,1);mat.use_nodes=True+bs=next((n for n in mat.node_tree.nodes if n.type=='BSDF_PRINCIPLED'),None)+if bs is None:+ bs=mat.node_tree.nodes.new('ShaderNodeBsdfPrincipled');out=mat.node_tree.nodes.new('ShaderNodeOutputMaterial');mat.node_tree.links.new(bs.outputs['BSDF'],out.inputs['Surface'])+bs.inputs['Base Color'].default_value=(.012,.018,.022,1);bs.inputs['Roughness'].default_value=.7+idx=len(head.data.materials);head.data.materials.append(mat)+wire=head.modifiers.new('Review_Control_Edges','WIREFRAME');wire.thickness=.00012;wire.use_replace=False;wire.offset=1;wire.material_offset=idx+scene.render.engine='CYCLES';scene.cycles.samples=24+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'+for name in ('front','threequarter'):+ scene.camera=bpy.data.objects['Review_'+name];scene.render.filepath=str(ROOT/'review'/f'cage-{name}.png');bpy.ops.render.render(write_still=True)+print('CONTROL_CAGE_RENDERED',flush=True)diff --git a/art/characters/qinglan/face-study-v7/scripts/render_review.py b/art/characters/qinglan/face-study-v7/scripts/render_review.pynew file mode 100644index 000000000..f07113d3c--- /dev/null+++ b/art/characters/qinglan/face-study-v7/scripts/render_review.py@@ -0,0 +1,26 @@+"""Render a saved control-cage candidate without changing the live session."""+import bpy,sys,json+from pathlib import Path+from mathutils import Vector+ROOT=Path(__file__).resolve().parents[1]+bpy.ops.wm.open_mainfile(filepath=str(ROOT/'qinglan-identity-cage.blend'))+scene=bpy.context.scene+scene.render.engine='CYCLES';scene.cycles.samples=32+prefs=bpy.context.preferences.addons['cycles'].preferences+prefs.compute_device_type='OPTIX';prefs.get_devices()+for device in prefs.devices:device.use=device.type=='OPTIX'+scene.cycles.device='GPU'+scene.render.resolution_x=600;scene.render.resolution_y=800+scene.render.resolution_percentage=100+names=('front','profile','threequarter','low')+if '--front-only' in sys.argv:names=('front',)+for name in names:+ scene.camera=bpy.data.objects['Review_'+name]+ scene.render.filepath=str(ROOT/'review'/f'after-{name}.png')+ bpy.ops.render.render(write_still=True)+if '--reference-views' in sys.argv:+ for name in ('front','profile','threequarter'):+ scene.camera=bpy.data.objects['Reference_'+name]+ scene.render.filepath=str(ROOT/'review'/f'reference-camera-{name}.png')+ bpy.ops.render.render(write_still=True)+print('REVIEW_RENDER_COMPLETE '+json.dumps({'views':names}),flush=True)