Class Wire

cadquery/occ_impl/shapes.py:2883–3266

A series of connected, ordered Edges, that typically bounds a Face

class Wire(Shape, Mixin1D):
    """
    A series of connected, ordered Edges, that typically bounds a Face
    """

    wrapped: TopoDS_Wire

    def _nbEdges(self) -> int:
        """
        Number of edges.
        """

        sa = ShapeAnalysis_Wire()
        sa.Load(self.wrapped)

        return sa.NbEdges()

    def _geomAdaptor(self) -> BRepAdaptor_Curve | BRepAdaptor_CompCurve:
        """
        Return the underlying geometry.
        """

        rv: BRepAdaptor_Curve | BRepAdaptor_CompCurve

        if self._nbEdges() == 1:
            rv = self.Edges()[-1]._geomAdaptor()
        else:
            rv = BRepAdaptor_CompCurve(self.wrapped)

        return rv

    def close(self) -> Wire:
        """
        Close a Wire
        """

        if not self.IsClosed():
            e = Edge.makeLine(self.endPoint(), self.startPoint())
            rv = Wire.combine((self, e))[0]
        else:
            rv = self

        return rv

    @classmethod
    def combine(
        cls, listOfWires: Iterable[Wire | Edge], tol: float = 1e-9
    ) -> list[Wire]:
        """
        Attempt to combine a list of wires and edges into a new wire.

        :param cls:
        :param listOfWires:
        :param tol: default 1e-9
        :return: list[Wire]
        """

        edges_in = TopTools_HSequenceOfShape()