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

1.6 KiB
Raw Blame History

rotate_shape

API定义

def rotate_shape(shape: AnyShape, angle: float, axis: Tuple[float, float, float] = (0, 0, 1), origin: Tuple[float, float, float] = (0, 0, 0)) -> AnyShape

来源文件: operations.py

API作用

旋转几何体到新方向

围绕指定轴和中心点旋转几何体,不改变几何体的形状和大小。 旋转操作支持当前坐标系变换,适用于所有类型的几何对象。 角度使用度数制,正值表示右手定则的逆时针旋转。

API参数说明

shape

  • 类型: AnyShape
  • 说明: 要旋转的几何体,可以是点、边、线、面、实体等任意几何对象

angle

  • 类型: float
  • 说明: 旋转角度,单位为度数(0-360),正值表示逆时针旋转

axis

  • 类型: Tuple[float, float, float], optional
  • 说明: 旋转轴向量 (x, y, z), 默认为 (0, 0, 1) 表示绕Z轴旋转

origin

  • 类型: Tuple[float, float, float], optional
  • 说明: 旋转中心点坐标 (x, y, z), 默认为 (0, 0, 0)

返回值说明

AnyShape: 旋转后的几何体,类型与输入相同

异常

  • ValueError: 当几何体或旋转参数无效时抛出异常

API使用例子

例子 1

# 绕Z轴旋转立方体45度
box = make_box_rsolid(2, 2, 2)
rotated_box = rotate_shape(box, 45)

例子 2

# 绕X轴旋转圆形面90度
circle = make_circle_rface((0, 0, 0), 1.0)
rotated_circle = rotate_shape(circle, 90, (1, 0, 0))

例子 3

# 围绕指定点旋转
line = make_line_redge((0, 0, 0), (2, 0, 0))
rotated_line = rotate_shape(line, 90, (0, 0, 1), (1, 0, 0))