CadQuery中如何精确控制工作平面上的模型定位

在使用CadQuery进行3D建模时，我们经常需要在特定表面上创建新的几何体。本文将通过一个典型案例，讲解如何精确控制新几何体在工作平面上的定位方式。

问题背景

当我们在一个立方体的不同表面上添加新的立方体时，可能会遇到定位不一致的问题。例如：

a = Workplane("XY")
a = a.box(9, 20, 4)  # 创建基础立方体
a = a.faces(">Y")     # 选择+Y方向的表面
a = a.box(4, 13, 4, centered=[1,0,0])  # 在选定表面上添加新立方体

上述代码在+Y表面工作正常，但当我们将选择改为faces("<Y")时，新立方体的定位会出现问题，因为它使用了不同的角点作为参考。

解决方案分析

方法一：使用workplane偏移

我们可以通过精确控制工作平面的偏移量来实现对称定位：

a = Workplane("XY")
a = a.box(9, 20, 4)
a = a.faces("<Y")
a = a.workplane(6.5)  # 沿法线方向偏移工作平面
a = a.box(4, 4, 13)   # 创建新立方体

这种方法需要计算偏移量(这里是6.5)，适用于需要精确控制位置的情况。

方法二：使用拉伸操作

更简单的方法是使用拉伸(extrude)操作：

a = Workplane("XY")
a = a.box(9, 20, 4)
a = a.faces("<Y")
a = a.workplane()
a = a.rect(4,4).extrude(13)  # 绘制矩形并拉伸成立方体

这种方法更直观，不需要计算偏移量，且适用于任意表面。

方法三：使用Sketch功能

对于更复杂的2D图形，可以使用Sketch功能：

a = Workplane("XY")
a = a.box(9, 20, 4)
a = a.faces("<Y")
a = a.sketch().rect(4, 4).finalize().extrude(13)

Sketch提供了更丰富的2D绘图功能，适合创建复杂截面后再拉伸。

技术要点总结

1. 工作平面理解：CadQuery中的工作平面决定了新几何体的创建方向和位置参考。

2. 定位方式选择：

   • 直接使用box()方法时，centered参数控制定位，但在不同表面上行为可能不一致
   • 使用拉伸操作可以避免定位问题，操作更直观

3. 复杂形状处理：对于非矩形截面，优先考虑使用Sketch功能创建2D图形后再拉伸。

4. 对称建模技巧：当需要在对称表面上创建相同特征时，使用拉伸方法可以保持一致性，避免复杂的镜像或旋转操作。

最佳实践建议

在实际建模中，推荐优先使用拉伸方法创建特征，特别是当需要在多个对称表面上工作时。这种方法不仅代码简洁，而且可以避免复杂的定位计算，提高建模的可靠性和可维护性。

对于需要参数化设计的场景，可以将关键尺寸定义为变量，这样在修改设计时只需调整变量值，而不需要重新计算所有相关尺寸。