Class DirectionMinMaxSelector

cadquery/selectors.py:399–426

Selects objects closest or farthest in the specified direction. Applicability: All object types. for a vertex, its point is used. for all other kinds of objects, the center of mass of the object is used. You can use the string shortcuts >(X|Y|Z) or <(X|Y|Z) if you want

class DirectionMinMaxSelector(CenterNthSelector):
    """
    Selects objects closest or farthest in the specified direction.

    Applicability:
        All object types. for a vertex, its point is used. for all other kinds
        of objects, the center of mass of the object is used.

    You can use the string shortcuts >(X|Y|Z) or <(X|Y|Z) if you want to select
    based on a cardinal direction.

    For example this::

        CQ(aCube).faces(DirectionMinMaxSelector((0, 0, 1), True))

    Means to select the face having the center of mass farthest in the positive
    z direction, and is the same as::

        CQ(aCube).faces(">Z")

    """

    def __init__(
        self, vector: Vector, directionMax: bool = True, tolerance: float = 0.0001
    ):
        super().__init__(
            n=-1, vector=vector, directionMax=directionMax, tolerance=tolerance
        )


# inherit from CenterNthSelector to get the CenterNthSelector.key method