大式与翼角 · Blender 对表与几何推进 v1.0
编制:小明(建筑设计师)| 2026-11-17
本轮三件事:① 用本机 Blender 跑通九野营造做第二意见对表 ② 清式斗口制骨架 ③ 翼角几何
前置:07_研究用途许可口径_v1.0.md(研究用途、非商用,三区隔离)
1. 结论先行
- Blender 不用装,本机已有 4.2.0(
D:\Program Files\Blender Foundation\Blender 4.2),恰是九野要求的最低版本。已用隔离脚本目录跑通九野,未改动你原有 Blender 配置。 - 对表管道通了,但九野的清式尺寸不能当权威——它的
qing_jujia()把九檩举架序列当通用序列用,五檩/七檩会取错系数。这条反过来证明我们「按檩数查表」是对的。 - 1.4 与 1.414 不必再拍板:两者是不同用途(建模用 √2、算料用 1.4)。母板(小式)实际只差 25.7 mm,此前记的「7 cm」需投影约 5 m 的大式才成立——这条已订正。
- 斗口制骨架落地 3 条规则,但状态全部是
[待核原文];出挑那一条故意让函数抛错,防止未核数值静默进图。
2. Blender 环境实测
| 项 | 结果 |
|---|---|
| 是否已装 | ✅ 已装,Blender 4.2.0(build 2024-07-16) |
| 路径 | D:Program FilesBlender FoundationBlender 4.2blender.exe |
| 九野要求 | README:「需要 Blender 4.2 或更高版本,已在 4.5 上测试」→ 本机 4.2 恰好达标 |
| 是否改动原配置 | ❌ 未改。用 BLENDER_USER_SCRIPTS=/tmp/bjtest 指向临时目录,插件装在临时目录的 addons/ 下 |
| 跑通验证 | addon_utils.enable('jiuye_yingzao') 返回模块对象,catalog.generate() 出模型 |
2.1 踩到的三个坑(都已解,记下来省下次)
| 坑 | 现象 | 解法 |
|---|---|---|
| 本机挂了 ACES OCIO 配置 | colorspace_settings.name='sRGB' 报枚举不存在(列出全是 ACES 色彩空间) | 运行前 unset OCIO;并给赋值加 try/except 兜底 |
| 未取贴图 | Cannot read ...textures/derived/wood_Color.jpg | 我们只取源码与数据(贴图 CC0 但体积大),把 materials._image 换成 1×1 占位图,材质管线其余不动 |
env -u OCIO 会吞掉输出 | Blender 输出 0 行、退出码 0(GUI 子系统经 env 启动后丢失控制台) | 用 shell 内 unset OCIO,不要用 env -u 前缀 |
2.2 探针脚本
vendor/_ref/_probe/probe_jiuye.py(B 区,不进交付):固定输入 → 生成 → 量世界坐标包围盒 + 分构件 z 范围 + 顶点数 → 打 PROBE_JSON。
unset OCIO && export BLENDER_USER_SCRIPTS=/tmp/bjtest
blender -b --factory-startup --python probe_jiuye.py -- \
--type dadian --style qing --bays 3 --bay_w 3.84 --jia 4 --jia_len 1.6 --col_h 3.2
3. 九野实测数据
| 算例 | 通面阔 | 通进深 | 总高 | 图元 | 网格 |
|---|---|---|---|---|---|
dadian / 宋风 lanxi / 5 间 | 21587.0 | 22993.5 | 13811.8 | 9 段 | 51004 顶点 |
dadian / 清式 qing / 3 间 | 17365.8 | 15046.3 | 11027.6 | 9 段 | 44842 顶点 |
网格按八段切开,与我们规划的模块边界一致:Platform / Columns / Beams / Brackets / Roof / Roof_timber / Walls / Openings / Railings —— 这印证了 ACA 的八段式划分不是孤例。
3.1 ★ 发现:九野的 qing_jujia 取错举架系数
源码 core/rules.py:101:
def qing_jujia(depth, n_jia, steps=(0.5, 0.65, 0.75, 0.9, 1.0)):
span = depth / 2 / max(1, n_jia)
for k in range(n_jia):
z += span * steps[min(k, len(steps) - 1)]
steps 是九檩的序列(五 / 六五 / 七五 / 九)。于是:
| 檩数 | 九野实取 | 则例应为 | 结论 |
|---|---|---|---|
| 九檩(4 步) | 0.50 / 0.65 / 0.75 / 0.90 | 同 | ✅ 对 |
| 七檩(3 步) | 0.50 / 0.65 / 0.75 | 0.50 / 0.70 / 0.90 | ❌ 错 |
| 五檩(2 步) | 0.50 / 0.65 | 0.50 / 0.70 | ❌ 错 |
对我们的意义:不需要「谁更权威」的争论——按檩数查表(我们的做法)在这一点上是对的,外部实现的错法恰好成了我们的反向验证。也说明:九野的 qing 风格自己标了「弱化,仅作对照」,不能拿它的清式尺寸对表。
4. 清式斗口制骨架(engine/doukou.py)
新增规则 I1–I3,状态全部 [待核原文],因为手上没有则例卷二十八前后。
| 等第 | 斗口 | 单材 1.4 | 足材 2.0 | 栔 0.6 |
|---|---|---|---|---|
| 一等 | 6.0 寸 = 192.0 | 268.8 | 384.0 | 115.2 |
| 三等 | 5.0 寸 = 160.0 | 224.0 | 320.0 | 96.0 |
| 八等 | 2.5 寸 = 80.0 | 112.0 | 160.0 | 48.0 |
| 十一等 | 1.0 寸 = 32.0 | 44.8 | 64.0 | 19.2 |
(全表 python -m engine.doukou 打印)
互证:ACA-Builder 的 DEFAULT_DK = 0.08 m 反查正落八等(2.5 寸),偏差 0。两个独立来源对上,说明这组换算至少自洽。
自洽校验:单材 1.4 + 栔 0.6 = 足材 2.0 ✅。宋式是 15 + 6 = 21 份,结构同、数值异——这条差异本身就是「宋清不可混引」的又一例证。
出挑故意不实现:chutiao_mm() 直接 raise NotImplementedError。理由:口径未核的数值,一旦能被调用就一定会有人拿去出图。宁可让它报错。
5. 翼角几何(engine/yijiao.py)
5.1 三种量分开算(这是本模块的全部要点)
| 口径 | 算什么 | 母板实得 | 状态 |
|---|---|---|---|
| ① 则例原文 | 翼角椽净长 = 步架 + 出檐 − 角梁之厚半份;再每尺加翘一寸 | 净长 2486.4 → 加翘 2735.0 mm | [已验证·原文] |
| ② 匠作口诀 | 冲出 = 3 × 椽径;起翘 = 4 × 椽径 | 冲出 316.8;起翘 422.4 mm | 口诀(非则例,ACA 源码可互证) |
| ③ 几何真值 | 角梁平面投影 =(出檐 + 冲出)× √2;斜长 = √(投影² + 起翘²) | 投影 1805.7;真值斜长 2553.6 mm | 数学 |
则例算例复现:步架 3.5 尺 + 出檐 2.64 尺 − 半份 2.3 寸 = 5.91 尺;×1.10 = 6.50 尺 → 原文「共长六尺五寸」✅
「角梁之厚半份 = 2.3 寸」是由算例反推的(6.14 − 5.91),原文没直给角梁厚 —— 状态标
[待核原文],不许当则例引用。
5.2 1.4 还是 1.414:不必拍板了
| 用途 | 用哪个 | 理由 |
|---|---|---|
| 建模 / 定位 | √2 = 1.414 | 端点必须落在几何位置上,用 1.4 会差 1%,翼角接不上 |
| 算料 / 采购 | 1.4(方五斜七) | 古人估料口诀,采购单按这个走才对得上传统料单 |
差值订正:母板(小式,投影 1805.7)二者差 25.7 mm。此前文档写「约差 7 cm」是大式量级(投影约 5 m 时才成立),已在小式语境下订正。这与引擎既有的「算料长 / 建模长」分离原则完全一致,不需要新机制。
5.3 逐根椽表(简化,缺口写明)
现输出「等分转角 + 长度线性过渡」的 7 根表(转角 0→45°,长度 2486.4→2735.0)。
缺口:未计撇度 / 扭度 / 逐根翘度。翼角无法纯公式,最终仍须逐根出表校核——这条留在规则库 G1 的 gap 里,不掩饰。
6. 验证证据
| 维度 | 结果 |
|---|---|
| 回归测试 | 54/54(原 44 + 翼角 5 + 斗口 5) |
| 则例算例复现 | 66/66 |
| 母板对表 | 24/24 |
| 规则库 | 38 条(新增 I1–I3;G1/G3 状态更新)自动生成、防手改校验通过 |
| 三区隔离闸门 | 通过(新模块不含外部实现引用) |
| Blender 实测 | 4.2.0 加载九野 0.4.0,两算例出模型、量测完成 |
7. 剩余缺口(按优先级)
| # | 缺口 | 卡在哪 |
|---|---|---|
| 1 | 斗口制十一等、材份系数、拽架出挑 | 无则例卷二十八前后原文 → 现全部 [待核原文];出挑函数故意抛错 |
| 2 | 翼角逐根撇度/扭度/翘度 | 需逐根出表 + 实物校核;不能纯公式 |
| 3 | 翼角与角梁进 3D | 需先有 roof_form(庑殿/歇山);当前算例全是悬山/硬山,转角处无翼角 |
| 4 | 望板厚 / 苫背厚 | 原文未定(H1/H2) |
| 5 | 椽档两说互斥 | 每丈 20 根 vs 空档随椽径,差 30% |
建议下一步:做 roof_form 参数(庑殿/歇山),翼角才有地方落——这是第 3 项的前置,比继续抠斗口更实。
08 v1.0 · 2026-11-17 · Blender 4.2 已验、九野对表已通、斗口制与翼角骨架已落;下一步 roof_form