Workplane.rarray()

Workplane.rarray()是cadquery中一个非常有用的函数。它能够在一个工作平面上创建一个规则的点阵，使得我们可以轻松地在其中添加特定的几何对象。

语法

workplane.rarray(spacing, xcount, ycount, center=False, axis=None)

• spacing：指定点阵中相邻点之间的距离或间距，可以是一个数字或一个元组，元组结构为(x-spacing, y-spacing)。
• xcount：指定每行的点数。
• ycount：指定每列的点数。
• center：指定点阵是否应该从中心点开始。默认为False。
• axis：指定点阵在工作平面上的旋转轴，可以是三维空间中的向量或是字符串"X", "Y", "Z"。默认为None。

示例

以下是一些示例，展示了如何使用Workplane.rarray()创建点阵。

import cadquery as cq

# 创建 5x5 的正方形点阵，间距为 10
result = cq.Workplane("XY").rarray(10, 5, 5)

# 创建 5x5 的圆形点阵，间距为 10
result = cq.Workplane("XY").rarray((10, 10), 5, 5).circle(4)

# 创建从原点开始的 3x3 点阵，间距为 5，绕 Z 轴旋转 45 度
result = cq.Workplane("XY").rarray(5, 3, 3, center=True, axis=(0, 0, 1)).box(1, 2, 3)

注意事项

• 在旋转点阵时，轴向应该是针对对象的，而不是工作平面。
• 返回结果是一个Workplane对象，因此可以在它上面添加各种几何对象。