Files
CADmind/backend/engine/fastener_defaults.py
2026-09-24 10:40:57 +08:00

44 lines
2.0 KiB
Python
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""统一管住 bd_warehouse 标准件的精度策略,不让每个调用点各自决定。
bd_warehouse 的每一种紧固件(HexHeadScrew/HexNut/SocketHeadCapScrew/SetScrew/...)
构造函数都带一个 simple 参数,默认是 True —— 螺纹部分只给一个光杆/光孔,没有真实牙型。
这个默认值几乎不可能是我们要的:我们的目标是可加工的精确零件,不是预览占位模型。
之前的问题就出在这里:改了 HexHeadScrew 一处调用的 simple=False,
换成 HexNut 又是一个新的默认 True,同一类bug换个零件就复现一次。
所以这里只允许通过 build_fastener() 构造标准件,禁止在别处直接 new 一个
bd_warehouse 的类——精度策略只在这一个地方决定。
"""
from bd_warehouse import fastener as _fastener
# 面数下限:真实螺纹几何的面数远高于simple模式(光杆/光孔只是十几~二十几个面)。
# 用于生成后的兜底校验,防止未来 bd_warehouse 升级或调用方式变化导致
# simple 模式又悄悄混进来而没人发现。
_MIN_FACES_FOR_REAL_THREAD = 40
def build_fastener(class_name: str, **params):
"""按名字构造一个 bd_warehouse 标准件,强制使用真实螺纹几何。
class_name: bd_warehouse.fastener 里的类名,如 "HexHeadScrew"、"HexNut"
params: 该类需要的参数(size/length/fastener_type等),不需要也不应该传 simple
"""
if not hasattr(_fastener, class_name):
raise ValueError(f"bd_warehouse.fastener 中不存在 '{class_name}'")
cls = getattr(_fastener, class_name)
params = dict(params)
params["simple"] = False # 唯一允许设置这个参数的地方
part = cls(**params)
face_count = len(part.faces())
if face_count < _MIN_FACES_FOR_REAL_THREAD:
raise RuntimeError(
f"{class_name} 生成结果只有 {face_count} 个面,疑似退化成了简化(无螺纹)模式,"
f"已阻止导出。请检查 bd_warehouse 版本或调用参数。"
)
return part