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

1.2 KiB
Raw Blame History

make_circle_rwire

API定义

def make_circle_rwire(center: Tuple[float, float, float], radius: float, normal: Tuple[float, float, float] = (0, 0, 1)) -> Wire

来源文件: operations.py

API作用

创建圆形并返回线对象

创建圆形线对象,用于构建封闭的圆形轮廓。与make_circle_redge不同, 此函数返回的是线对象,可以直接用于创建面或进行其他线操作。

API参数说明

center

  • 类型: Tuple[float, float, float]
  • 说明: 圆心坐标 (x, y, z),定义圆的中心位置

radius

  • 类型: float
  • 说明: 圆的半径,必须为正数

normal

  • 类型: Tuple[float, float, float], optional
  • 说明: 圆所在平面的法向量 (x, y, z), 默认为 (0, 0, 1) 表示XY平面

返回值说明

Wire: 创建的线对象,表示一个完整的圆形轮廓

异常

  • ValueError: 当半径小于等于0或其他参数无效时抛出异常

API使用例子

例子 1

# 创建标准圆形轮廓
circle_wire = make_circle_rwire((0, 0, 0), 3.0)

例子 2

# 创建小圆轮廓
small_circle = make_circle_rwire((1, 1, 0), 0.5)