CadQuery中基于草图平面创建扫掠特征的技术解析

在三维建模领域，扫掠(Sweep)是一种常见的建模技术，它通过沿着路径移动轮廓形状来创建复杂的三维几何体。本文将深入探讨如何在CadQuery中利用草图(Sketch)功能创建扫掠特征，特别是针对平面轮廓的处理方法。

扫掠操作的基本原理

扫掠操作需要两个核心元素：

1. 轮廓形状：通常是一个二维几何图形，如圆形、多边形等
2. 扫掠路径：定义轮廓移动轨迹的三维曲线

在CadQuery中，我们可以使用sweep()函数来实现这一操作。传统方法通常需要先明确获取轮廓的线框(Wire)数据，而最新版本的CadQuery提供了更便捷的工作流程。

草图功能的演进

早期版本中，当用户使用cq.Sketch创建轮廓后，需要通过各种间接方法获取其几何数据：

# 旧版获取轮廓线框的方法
wi = wp._getFaces()[0].wires()  # 使用内部方法
# 或
wi = list(iter(wp.val()))[0].wires()  # 通过迭代器

这种设计不够直观，也增加了代码的复杂性。随着CadQuery的发展，现在可以直接通过val()方法获取草图生成的几何体：

# 新版直接获取方法
profile = cq.Sketch().circle(1).val()

实际应用示例

让我们看一个完整的扫掠示例，展示如何创建三角形截面的弯曲管道：

import cadquery as cq

# 定义扫掠路径的控制点
pts = [(10, 10, 0), (20, 10, 10), (30, 10, -10), (30, 0, 0)]

# 创建扫掠路径(样条曲线)
path = cq.Workplane().spline(pts).val()

# 创建三角形轮廓草图
profile_sketch = cq.Sketch().push([(-1, 0), (1, 0)]).regularPolygon(1, 3)

# 将轮廓移动到路径起点并执行扫掠
result = cq.sweep(
    profile_sketch.moved(path.locationAt(0)).val(), 
    path, 
    True
)

技术要点解析

1. 路径创建：使用spline()函数通过控制点创建平滑的三维曲线
2. 轮廓定位：moved()方法将轮廓精确定位到路径起点
3. 扫掠参数：True参数表示生成实体而非曲面

最佳实践建议

1. 对于复杂轮廓，考虑使用push()方法定位多个子图形
2. 确保轮廓平面与路径起点切线方向垂直，避免几何扭曲
3. 使用locationAt()方法可以精确定位轮廓在路径上的位置

总结

CadQuery通过不断优化其API设计，使得基于草图的扫掠操作变得更加直观和高效。从最初需要间接获取几何数据，到现在可以直接使用val()方法，这一演进显著提升了开发体验。掌握这些技巧，可以让我们在参数化建模中创建更加复杂和精确的几何形状。