Function offset

cadquery/occ_impl/shapes.py:6969–7031

Offset or thicken faces or shells.

(
    s: Shape,
    t: float,
    cap: bool = True,
    both: bool = False,
    tol: float = 1e-6,
    history: History | None = None,
    name: str | None = None,
)

def offset(
    s: Shape,
    t: float,
    cap: bool = True,
    both: bool = False,
    tol: float = 1e-6,
    history: History | None = None,
    name: str | None = None,
) -> Shape:
    """
    Offset or thicken faces or shells.
    """

    def _offset(t: float):

        results = []
        builders = []

        for el in _get(s, ("Face", "Shell")):

            builder = BRepOffset_MakeOffset()
            builders.append(builder)

            builder.Initialize(
                el.wrapped,
                t,
                tol,
                BRepOffset_Mode.BRepOffset_Skin,
                False,
                False,
                GeomAbs_Intersection,
                cap,
            )

            builder.MakeOffsetShape()

            results.append(builder.Shape())

        return results, builders

    if both:
        results_pos, builders1 = _offset(t)
        results_neg, builders2 = _offset(-t)

        results_both = [
            Shape(el1) + Shape(el2) for el1, el2 in zip(results_pos, results_neg)
        ]

        _update_history(history, name, [s], *builders1, *builders2)
        _update_removed(history, s.Faces())

        if len(results_both) == 1:
            rv = results_both[0]
        else:
            rv = Compound.makeCompound(results_both)

    else:
        results, builders = _offset(t)