Function hollow

cadquery/occ_impl/shapes.py:7590–7636

Make a hollow solid by removing faces and applying thickness t.

(
    s: Shape,
    faces: Shape | None,
    t: float,
    tol: float = 1e-3,
    kind: Literal["arc", "intersection"] = "intersection",
    history: History | None = None,
    name: str | None = None,
)

@multidispatch
def hollow(
    s: Shape,
    faces: Shape | None,
    t: float,
    tol: float = 1e-3,
    kind: Literal["arc", "intersection"] = "intersection",
    history: History | None = None,
    name: str | None = None,
):
    """
    Make a hollow solid by removing faces and applying thickness t.
    """

    bldr = BRepOffsetAPI_MakeThickSolid()
    _faces = (
        _shapes_to_toptools_list(faces.Faces()) if faces else TopTools_ListOfShape()
    )

    bldr.MakeThickSolidByJoin(
        s.solid().wrapped,
        _faces,
        t,
        tol,
        Intersection=True,
        Join=_offset_kind_dict[kind],
    )
    bldr.Build()

    rv = _compound_or_shape(bldr.Shape())

    # if no faces provided a watertight solid will be constructed
    if faces is None:
        sh1 = rv.shell().wrapped
        sh2 = s.shell().wrapped

        # sh1 can be outer or inner shell depending on the thickness sign
        if t > 0:
            sol = BRepBuilderAPI_MakeSolid(sh1, sh2)
        else:
            sol = BRepBuilderAPI_MakeSolid(sh2, sh1)

        # fix needed for the orientations
        rv = _compound_or_shape(sol.Shape()).fix()

    _update_history(history, name, [s], bldr)

    return rv


@multidispatch