CadQuery中草图在不同平面上的方向控制技巧

在三维建模过程中，草图(Sketch)的方向控制是一个常见但容易被忽视的问题。本文将以CadQuery项目为例，深入探讨如何在不同基准平面上保持草图方向一致性的技术细节。

问题背景

当我们在CadQuery中使用草图进行建模时，可能会遇到一个有趣的现象：同一个草图放置在XZ平面和ZX平面上时，会呈现出不同的方向。这是因为这两个平面虽然几何上相同，但它们的坐标系定义方式不同：

• XZ平面：X轴为第一轴，Z轴为第二轴
• ZX平面：Z轴为第一轴，X轴为第二轴

这种坐标系定义的差异会导致草图在放置时自动旋转90度，从而产生不同的视觉效果。

解决方案

CadQuery的最新版本(master分支)提供了moved()方法，可以方便地调整草图的方向。通过在放置草图时添加旋转参数，我们可以强制统一不同平面上的草图方向：

.placeSketch(rect_sketch.moved(rz=90))

其中rz=90表示绕Z轴旋转90度。这种方法简单直接，能够有效解决方向不一致的问题。

技术原理

在底层实现上，CadQuery的草图系统基于OCCT(Open CASCADE Technology)的几何内核。当草图被放置到工作平面时，系统会自动计算从草图局部坐标系到目标坐标系的变换矩阵。对于XZ和ZX平面，这个变换矩阵会有所不同，从而导致方向差异。

moved()方法实际上是应用了一个额外的变换矩阵，覆盖了系统默认的变换行为。通过显式指定旋转角度，我们可以确保无论目标平面如何定义，草图都能保持一致的视觉方向。

实际应用建议

1. 一致性优先：在复杂项目中，建议统一使用一种平面定义方式(XZ或ZX)，避免混用导致的方向混乱。

2. 显式控制：当必须使用不同平面时，使用moved()方法明确指定旋转角度，确保结果可预测。

3. 调试技巧：可以通过单独显示草图和工作平面来验证方向是否正确，再进行后续操作。

4. 版本注意：此功能需要较新版本的CadQuery，旧版本可能需要手动计算变换矩阵。

总结

掌握草图方向控制是提高CadQuery建模效率的重要技能。通过理解坐标系变换原理并合理使用moved()方法，开发者可以确保模型在不同平面上的表现一致性，减少调试时间，提高工作效率。随着CadQuery的持续发展，这类几何操作将会变得更加直观和便捷。