Function shell

cadquery/occ_impl/shapes.py:6060–6117

Build shell from faces. If ctx is specified, local sewing is performed.

(
    *s: Shape,
    tol: float = 1e-6,
    manifold: bool = True,
    ctx: Sequence[Shape] | Shape | None = None,
    history: History | None = None,
    name: str | None = None,
)

@multidispatch
def shell(
    *s: Shape,
    tol: float = 1e-6,
    manifold: bool = True,
    ctx: Sequence[Shape] | Shape | None = None,
    history: History | None = None,
    name: str | None = None,
) -> Shape:
    """
    Build shell from faces. If ctx is specified, local sewing is performed.
    """

    builder = BRepBuilderAPI_Sewing(tol, option4=not manifold)
    if ctx:
        if isinstance(ctx, Shape):
            builder.Load(ctx.wrapped)
        else:
            builder.Load(compound(ctx).wrapped)

    faces: list[Face] = []

    for el in s:
        for f in _get(el, "Face"):
            builder.Add(f.wrapped)
            faces.append(f)

    builder.Perform()
    sewed = builder.SewedShape()

    # if specified, use context for history mapping
    if ctx:
        if isinstance(ctx, Shape):
            faces.extend(ctx.Faces())
        else:
            for el in ctx:
                faces.extend(el.Faces())

    _update_history(history, name, faces, builder.GetContext().History())
    _process_sewing_history(history, faces, builder)

    rv = []

    # split the results
    rv_faces, rv_shells = _shape_to_faces_shells(sewed)

    rv.extend(rv_shells)

    # for one closed face sewing will not produce a shell, so a special treatment is needed
    for f_topo in rv_faces:
        tmp = TopoDS_Shell()

        builder_topo = TopoDS_Builder()
        builder_topo.MakeShell(tmp)
        builder_topo.Add(tmp, f_topo)

        rv.append(tmp)

    return _compound_or_shape(rv)