VertexLoop

A sequence of vertices forming an open or closed loop

Provides utilities for geometric operations like centroid, area, and bounds. Can be subclassed for specific geometric primitives.

Constructor

VertexLoop(vertices: Points2D, closed: bool = True)

Initialize a vertex loop

area()

Calculate the signed area of the loop

bounds()

Calculate bounding box (min_x, min_y, max_x, max_y)

centroid()

Calculate the centroid (geometric center) of the vertices

is_clockwise()

Check if the loop has clockwise winding (negative area)

reverse()

Return a new VertexLoop with reversed vertex order

rotate(
    angle_degrees: float,
    center: Point2D | None = None
) -> VertexLoop

Rotate all vertices by angle_degrees around center (default: origin). Returns self for chaining.

scale(sx: float, sy: float | None = None) -> VertexLoop

Scale all vertices by (sx, sy). If sy is None, uses sx for both axes. Returns self for chaining.

translate(dx: float, dy: float) -> VertexLoop

Translate all vertices by (dx, dy). Returns self for chaining.