Files
make-cad/docs/api/linear_pattern_rsolidlist.md
T

1.6 KiB

linear_pattern_rsolidlist

API Definition

def linear_pattern_rsolidlist(shape: AnyShape, direction: Tuple[float, float, float], count: int, spacing: float) -> List[Solid]

Source: operations.py

Description

创建线性阵列

沿指定方向创建几何体的线性阵列,生成指定数量的等间距排列对象。 常用于创建重复结构,如齿轮齿、栅栏、螺栓阵列等。

Parameters

shape

  • Type: AnyShape
  • Description: 要阵列的几何体,可以是任意类型的几何对象

direction

  • Type: Tuple[float, float, float]
  • Description: 阵列方向向量 (x, y, z), 定义阵列的方向,会被标准化处理

count

  • Type: int
  • Description: 阵列数量,必须为正整数,包括原始对象

spacing

  • Type: float
  • Description: 阵列间距,必须为正数,定义相邻对象间的距离

Returns

List[Solid]: 阵列后的几何体列表,包含原始对象和所有复制的对象

Raises

  • ValueError: 当阵列数量小于等于0或间距小于等于0时抛出异常

Examples

Example 1

# 创建立方体的线性阵列
box = make_box_rsolid(1, 1, 1)
boxes = linear_pattern_rsolidlist(box, (2, 0, 0), 5, 2.0)
# 创建5个立方体,沿X轴方向间距2.0

Example 2

# 创建圆柱体的对角线阵列
cylinder = make_cylinder_rsolid(0.5, 2.0)
cylinders = linear_pattern_rsolidlist(cylinder, (1, 1, 0), 4, 1.5)

Example 3

# 创建复杂几何体的阵列
complex_shape = union_rsolidlist([box, cylinder])[0]
array = linear_pattern_rsolidlist(complex_shape, (0, 3, 0), 3, 3.0)