Workplane.cboreHole()

简介

cboreHole() 方法可以在当前工作平面上创建钻孔，并将其放大为沉孔。您可以在此孔中放置螺栓等零件。

此方法在 CADQuery 中的低级 API 中实现。这可以使 CADQuery 可以通过本API非常快速地进行建模。

用法

要使用 cboreHole() 方法，请首先选择要放置孔的工作平面。使用 workplane() 方法来选择工作平面。

import cadquery as cq

box = cq.Workplane("XY").box(2, 2, 2)  # 创建一个长方体
hole = box.faces(">Z").workplane().cboreHole(
    0.25,  # 孔的直径
    0.5,   # 沉孔的深度
    0.25   # 沉孔的角度
)

上面的代码将选择 box 的上表面，并在该表面上创建一个 0.25 直径，0.5 深度并带有 0.25 角度的钻孔。结果 hole 是创建的孔的集合。

您可以进一步使用 hole 对象来添加螺栓等元素。

bolt = cq.Workplane("XY").circle(0.1).extrude(0.3)

hole = box.faces(">Z").workplane().cboreHole(0.25, 0.5, 0.25)

result = hole.add(bolt)  # 将bolt添加到hole

在上面的代码中，我们首先创建一个螺栓，然后将其添加到创建的钻孔（hole）中。

参数

cboreHole() 方法采用以下参数来定义孔的属性：

• diameter：钻孔的直径。
• depth：钻孔的深度。
• cbore_diameter：钻孔的角度。

注意事项

• 默认单位为毫米。
• 如果您正在使用英制单位，请将 inch 参数设置为 True。
• cboreHole() 方法返回的是 CQ 对象，它只是包含一个或多个面（如果生成了多个孔的话）的集合。请注意，这个对象通常不能直接用于渲染。因此，建议使用 val() 方法来将结果转换为标准 Python 数据结构（LIST、DICT、TUPLE）。

结论

cboreHole() 是一个方便的 CADQuery 方法，可以快速创建孔和沉孔。使用此方法，您可以将其他元素放在孔中，例如螺钉和螺栓等。因为此方法在 CADQuery 中的低级 API 中实现，所以可以获得非常好的性能。