大式与翼角 · Blender 对表与几何推进 v1.0

编制:小明(建筑设计师)| 2026-11-17
本轮三件事:① 用本机 Blender 跑通九野营造做第二意见对表 ② 清式斗口制骨架 ③ 翼角几何
前置:07_研究用途许可口径_v1.0.md(研究用途、非商用,三区隔离)


1. 结论先行

  1. Blender 不用装,本机已有 4.2.0(D:\Program Files\Blender Foundation\Blender 4.2),恰是九野要求的最低版本。已用隔离脚本目录跑通九野,未改动你原有 Blender 配置。
  2. 对表管道通了,但九野的清式尺寸不能当权威——它的 qing_jujia() 把九檩举架序列当通用序列用,五檩/七檩会取错系数。这条反过来证明我们「按檩数查表」是对的。
  3. 1.4 与 1.414 不必再拍板:两者是不同用途(建模用 √2、算料用 1.4)。母板(小式)实际只差 25.7 mm,此前记的「7 cm」需投影约 5 m 的大式才成立——这条已订正。
  4. 斗口制骨架落地 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.022993.513811.89 段51004 顶点
dadian / 清式 qing / 3 间17365.815046.311027.69 段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.750.50 / 0.70 / 0.90❌ 错
五檩(2 步)0.50 / 0.650.50 / 0.70❌ 错

对我们的意义:不需要「谁更权威」的争论——按檩数查表(我们的做法)在这一点上是对的,外部实现的错法恰好成了我们的反向验证。也说明:九野的 qing 风格自己标了「弱化,仅作对照」,不能拿它的清式尺寸对表。


4. 清式斗口制骨架(engine/doukou.py)

新增规则 I1–I3,状态全部 [待核原文],因为手上没有则例卷二十八前后。

等第斗口单材 1.4足材 2.0栔 0.6
一等6.0 寸 = 192.0268.8384.0115.2
三等5.0 寸 = 160.0224.0320.096.0
八等2.5 寸 = 80.0112.0160.048.0
十一等1.0 寸 = 32.044.864.019.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