cadquery
Sketch
Workplane
Assembly

Sketch.face()

Sketch.face() 方法是 CadQuery 库中一个用于创建二维草图上的面的函数。该函数接受多个参数,包括平面、边、角度和弧度等。

参数

参数名 类型 描述
plane Plane 面所在的平面
edges List[Edge] 面所包含的边的列表
wires List[Wire] 面所包含的线的列表(可选参数)
stitches bool 是否设置面的“拼合”(可选参数,默认为 True)。如果设置为 False,则不会生成该面的共面面,边界可能会与周围物体接触。
face Face 要计算的现有面(可选参数)
useXDir bool (从v 2.1) 如果为 True,则在选择与 X 轴平行的边时、面法向量应沿 X 形向量旋转,而非 Y 轴。

返回值

Sketch.face() 函数将返回一个创建的面,即 Face 类型的对象。

示例

以下是使用 Sketch.face() 函数同时为两个平面创建一个包含多条直线的面的示例:

import cadquery as cq

# 创建 Sketch 的二维草图
s = cq.Workplane('XY').rect(10, 10)

# 定义一个面的平面和边
p1 = cq.Plane.XY()
e1 = s.edges()

# 使用 Sketch.face() 方法创建面
face1 = cq.Face.makeFromWires(e1)

# 定义第二个面
e2 = s.translate((0, 0, 5)).edges()
face2 = cq.Face.makeFromWires(e2)

# 将面组合到一起
merged = face1.union(face2)

# 显示组合后的面
show_object(merged)

注意事项

  • 如果使用 Sketch.face() 方法创建的面不在 XY 平面上,则需要使用 Plane 类创建一个新的平面。