Method vertices

cadquery/cq.py:792–824

Select the vertices of objects on the stack, optionally filtering the selection. If there are multiple objects on the stack, the vertices of all objects are collected and a list of all the distinct vertices is returned. :param selector: optional Selector object, or

(
        self: T,
        selector: Optional[Union[Selector, str]] = None,
        tag: Optional[str] = None,
    )

        return toReturn

    def vertices(
        self: T,
        selector: Optional[Union[Selector, str]] = None,
        tag: Optional[str] = None,
    ) -> T:
        """
        Select the vertices of objects on the stack, optionally filtering the selection. If there
        are multiple objects on the stack, the vertices of all objects are collected and a list of
        all the distinct vertices is returned.

        :param selector: optional Selector object, or string selector expression
            (see :class:`StringSyntaxSelector`)
        :param tag: if set, search the tagged object instead of self
        :return: a CQ object whose stack contains  the *distinct* vertices of *all* objects on the
            current stack, after being filtered by the selector, if provided

        If there are no vertices for any objects on the current stack, an empty CQ object
        is returned

        The typical use is to select the vertices of a single object on the stack. For example::

            Workplane().box(1, 1, 1).faces("+Z").vertices().size()

        returns 4, because the topmost face of a cube will contain four vertices. While this::

            Workplane().box(1, 1, 1).faces().vertices().size()

        returns 8, because a cube has a total of 8 vertices

        **Note** Circles are peculiar, they have a single vertex at the center!

        """
        return self._selectObjects("Vertices", selector, tag)

    def faces(
        self: T,