44 lines
2.0 KiB
Python
44 lines
2.0 KiB
Python
"""统一管住 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
|