Sketch.rect()

简介

Sketch.rect() 是在 cadquery 中用于绘制矩形的函数。

矩形可以用四条直线或两条线和两个弧线构成。它可以用在 2D 或 3D 模式下。

语法

Sketch.rect(width, height, centered=True)

• width: 矩形的宽度。
• height: 矩形的高度。
• centered: 布尔值，表示矩形的中心是否与当前工作平面的中心对齐。

参数

• width: 必选参数，表示矩形的宽度，浮点数类型。如果值为 0，则会被重置为 1。
• height: 必选参数，表示矩形的高度，浮点数类型。如果值为 0，则会被重置为 1。
• centered: 可选参数，表示矩形的中心是否与当前工作平面的中心对齐。如果为 True，则矩形以当前工作平面的中心为中心；如果为 False，则矩形左下角的点将在当前工作平面的原点(0,0)。

返回值

该函数会返回一个 Sketch 对象，可以用于进一步的操作。

示例

基本使用

import cadquery as cq

# 创建一个空 Sketch 对象
sketch = cq.Workplane()

# 绘制一个宽度为 10，高度为 5 的矩形
sketch_rect = sketch.rect(10, 5)

# 打印生成的几何实体对象
print(sketch_rect)

高度为 0 的矩形

import cadquery as cq

# 创建一个空 Sketch 对象
sketch = cq.Workplane()

# 绘制一个宽度为 10，高度为 0 的矩形
# 程序会自动将高度重置为 1
sketch_rect = sketch.rect(10, 0)

# 打印生成的几何实体对象
print(sketch_rect)

矩形不居中

import cadquery as cq

# 创建一个空 Sketch 对象
sketch = cq.Workplane()

# 绘制一个宽度为 10，高度为 5 的矩形
# 不居中，左下角在工作平面原点(0,0)
sketch_rect = sketch.rect(10, 5, centered=False)

# 打印生成的几何实体对象
print(sketch_rect)

注意事项

• 如果要在 3D 模式下使用，请先调用 toWorldCoords() 函数，否则可能无法看到生成的几何体。
• 如果要将矩形转换为实体，请调用 extrude() 函数。