VertexPolygon

Arbitrary polygon as a VertexLoop

Creates a polygon from arbitrary vertices. Optionally redistributes vertices to achieve a specific num_vertices count for morphing compatibility.

Constructor

VertexPolygon(
    vertices: Points2D,
    closed: bool = True,
    auto_close: bool = True,
    num_vertices: int = None
)

Create a polygon from arbitrary vertices

vertices: List of (x, y) tuples defining the polygon
closed: Whether the polygon is closed
auto_close: If True and closed=True, ensures last vertex equals first
num_vertices: If provided, redistributes vertices to this count (important for morphing!)

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: Optional[Point2D] = None
) -> VertexLoop

Rotate vertices in-place by angle_degrees around center

angle_degrees: Rotation angle in degrees (positive = counter-clockwise)
center: Center of rotation (default is origin) Returns self for method chaining.

scale(sx: float, sy: Optional[float] = None) -> VertexLoop

Scale vertices in-place by (sx, sy)

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

Translate vertices in-place by (dx, dy)