CadQuery安装

CadQuery是Python的一款CAD开发库，有了这个，可以直接用Python代码来开发3D模型。可用conda来安装，由于依赖较多，建议新建一个环境

conda create -n cad
conda activate cad
conda install -c conda-forge cadquery

安装完成后，可以做一个简单的示例

import cadquery as cq
from cadquery.vis import show
result = cq.Workplane("XY" ).box(3, 3, 0.5).edges("|Z").fillet(0.125)
show(result)

两行代码，第一行创建模型，第二行对模型进行可视化

CQ-editor

CQ-editor是基于QT的CadQuery用户图形界面。这是个绿色软件，无需安装，双击直接启动。界面如下

如图可知，CQ-editor 主要分为几大核心区域，例如代码编辑区、3D 视图区、对象树 以及控制台等。

在左侧的代码窗口中，和上面的纯python代码相比，多了一行绘图show_object，但实测就算没有这个，中间窗格仍会显示3D图形。

初步示例

CadQuery给出的第一个示例如下

绘制代码为

height = 60.0
width = 80.0
thickness = 10.0
diameter = 22.0
padding = 12.0

result = (
    cq.Workplane("XY")
    .box(height, width, thickness)
    .faces(">Z")
    .workplane()
    .hole(diameter)
    .faces(">Z")
    .workplane()
    .rect(height - padding, width - padding, forConstruction=True)
    .vertices()
    .cboreHole(2.4, 4.4, 2.1)
)
show(result)

其工作流程为

1. 先指定工作平面为XY，并在XY平面上绘制$60\times 80\times 10$的立方体。
2. 选定Z坐标最大的面（即刚刚创建立方体的顶面）为新的工作平面，并打一个直径为$22$的洞。
3. 选定Z坐标最大的面，绘制一个辅助矩形，并选中该矩形的顶点，向下钻4个沉头孔。

代码中，box, hole, rect, cboreHole都是几何体，分别为长方体、圆孔、矩形、沉头孔，其中cbore 是 Counterbore 的缩写。

【Workplane】用于指定工作平面，在CadQuery中，每次操作，均需在指定的工作平面上。

【faces】用于切换工作平面，$>Z$是一种选择器，表示Z坐标最大的面。类似的还有$<Z$表示底面, $>X$表示右侧面等。

【forConstruction】是辅助线标记，选为True后，创建的rect不会生成任何实体材料。

模型导出

CadQuery支持多种模型的导出，常用导出格式包括

其导出代码为

cq.exporters.export(result, "my_part.step")