05.设计原则 - CadQuery 中文文档

原则 1：直观构造

CadQuery 旨在使使用 python 脚本构建模型变得简单直观。CadQuery 致力于让脚本能够像人类口头描述对象一样粗略地阅读。

例如，考虑这个对象：

人类会将其描述为：
“一个 80 毫米方形 x 30 毫米厚的块，在四角有用于安装 M2 内六角螺钉的埋头孔，中间有一个直径为 22 毫米的圆形凹槽，用于安装轴承”

我们的目标是让生成该对象的 CadQuery 脚本尽可能接近人类使用的英语短语。

原则 2：把握设计意图

不属于上述部件描述的特征与属于上述部件描述的特征同样重要。例如，大多数人会认为：

• 埋头孔与边缘的距离都是一致的
• 无论块有多大，圆形凹槽始终位于块的中心

如果你有 3D CAD 系统的使用经验，你就会知道这个对象中包含了一个关键的设计意图。基础图块制作完成后，如何确定孔的位置是关键。如果孔位于一侧边缘，改变块大小将产生与孔位于中心时的效果不同。

许多脚本语言不提供把握设计意图的方法，因为它们要求您始终在全局坐标中工作。CadQuery 则不同，它能以相对的方式定位相对于其他特征的位置，从而保留设计意图，就像人类在创建图纸或建造物体时一样。

事实上，尽管很多人都知道如何使用 3D CAD 系统，但很少有人了解构建物体的方式对其可维护性和设计变更的适应性有多么重要。

原则 3：插件是一等公民

任何用于构建 3D 模型的系统都将发展为包含大量的库和特征构建器。重要的是，这些插件可以无缝地包含在核心中，并与内置库一起使用。插件应该易于安装且易于使用。

原则 4：CAD 模型作为源代码是合理的

令人惊讶的是，3D CAD 世界主要由创建不透明二进制文件的系统主导。就像软件世界一样，CAD 模型也非常复杂。

CAD 模型与软件有许多共同之处，使用软件行业的标准工具将使 CAD 模型受益匪浅，如：

1. 轻松地重用对象之间的功能
2. 使用版本控制系统存储对象
3. 使用源代码控制工具计算对象之间的差异
4. 在互联网上共享对象
5. 允许从库内构建对象来自动化测试和生成

CadQuery 的设计目的是使三维内容创建变得足够简单，与使用现有的 “不透明”、"点击式 "解决方案相比，无需做更多工作即可实现上述优势。

文章来源：CadQuery 中文文档