CadQuery 2开发手册

CadQuery 是一个基于 Python 的开源三维几何建模工具，它可以用于快速创建 CAD 模型、进行模型分析、进行模拟等。本技术手册将会介绍 CadQuery 的使用方法和常见操作。

安装 CadQuery

使用 pip 命令进行安装：

pip install cadquery

安装成功后，可以在 Python 交互环境中使用以下命令进行验证：

import cadquery as cq

如果没有报错，则表示安装成功。

创建 Sketch

在 CadQuery 中，我们需要先创建一个 Sketch（草图）来描述模型的形状。Sketch 由一系列的几何图形组成， 如点、线、圆、矩形、多边形等。

以下是创建一个 Sketch 的示例代码：

# 创建一个长方形
r = cq.Workplane("XY").rect(10, 5)

# 创建一个圆形
c = cq.Workplane("XY").circle(3)

# 在长方形和圆形上进行偏移操作
result = r.faces(">Z").workplane().pushPoints([(5, 0)]).circle(2).cut(c)

在这个例子中，我们先创建了一个长方形和一个圆形，然后在长方形的顶面上创建了一个圆形， 并用它来切割圆形。注意，我们使用了 Workplane 对象来进行几何操作，Workplane 对象可以 看作是 Sketch 的一种表示方式。

创建 Solid

在 Sketch 创建完成后，我们可以使用 CadQuery 提供的一系列操作来创建 Solid（实体）， 如拉伸、旋转、扫描等。

以下是创建 Solid 的示例代码：

# 创建一个圆柱体
result = cq.Workplane("XY").circle(5).extrude(10)

# 创建一个球体
result = cq.Workplane("XY").sphere(5)

# 创建一个梯形体
result = cq.Workplane("XY").trapezoid(5, 10, 5).extrude(10)

在这个例子中，我们分别创建了一个圆柱体、一个球体和一个梯形体，然后使用 extrude 操作将 Sketch 沿着指定的方向拉伸成 Solid。

创建 Assembly

Assembly（装配）是指将多个 Solid 组合在一起，形成一个完整的模型。在 CadQuery 中，我们可以使用 Assembly 对象来进行装配操作。

以下是创建 Assembly 的示例代码：

# 创建两个 Solid
s1 = cq.Workplane("XY").box(5, 5, 5)
s2 = cq.Workplane("XY").box(10, 10, 10)

# 创建 Assembly，并将两个 Solid 组合在一起
result = cq.Assembly(s1, s2)

# 将两个 Solid 进行布置
result = result.moved((5, 5, 5)).rotated((0, 0, 45))

在这个例子中，我们创建了两个 Solid，组合在一起并进行了旋转。