Workplane.offset2D()

简介

Workplane.offset2D() 方法用于创建一个 Workplane 的 2D 平面偏移。该方法可以在创建三维实体时使用，以扩展或收缩二维形状。

语法

offset2D(distance: float, dir: Optional[Tuple[float, float]] = None) -> Workplane

参数

• distance:(float) 偏移距离。可以是正数或负数，分别表示向外或向内偏移。
• dir: 具有两个浮点数元素的元组，表示要偏移的方向。

返回值

Workplane 类型的对象。

示例

import cadquery as cq

# 创建一个提供平面偏移的 Workplane
p = cq.Workplane("XY").rect(2.0, 2.0).offset2D(0.5)

# 创建一个带有圆环的三维模型
result = cq.Workplane("XZ").circle(3.0).extrude(0.5).cut(p.extrude(0.25))

# 导出三维模型
show_object(result)

在上面的示例中，首先创建一个 Workplane 对象 p，在 X-Y 平面上绘制一个边长为 2.0 的矩形，并使用 offset2D 方法向外偏移 0.5 个单位。然后创建一个 Workplane 对象 result，在 X-Z 平面上绘制一个半径为 3.0 的圆形，并将其挤压成高度为 0.5 的圆环。最后，使用 cut 方法从圆环中将 p 对象的模型削除，得到最终的三维模型，打印结果并导出。

注意事项

• offset2D 方法只能在 2D 平面上进行偏移。如果需要在 3D 空间中进行偏移，请使用 translate 方法。
• 如果提供的偏移距离为负数，则会向内偏移形状。
• 如果未指定偏移方向，则默认为向外偏移。可以使用 dir 参数来指定偏移方向。
• offset2D 方法返回一个新的 Workplane 对象。如果需要修改当前对象，请使用 self 对象的 eachpoint 或 transform 方法。