SVGPath

Structured representation of an SVG path that supports morphing

Stores path as a list of command objects (MoveTo, LineTo, etc.) rather than a string, enabling smooth interpolation between paths.

Constructor

SVGPath(
    commands: List[PathCommand],
    path_string: Optional[str] = None
) -> None

from_string(path_string: str) -> SVGPath

Parses an SVG path data string (e.g., "M 0,0 L 100,100") into an SVGPath object.

A new SVGPath instance. Raises: ValueError: If parsing encounters an unexpected command or missing coordinates.

interpolate(
    path1: 'SVGPath',
    path2: 'SVGPath',
    t: float,
    auto_normalize: bool = True
) -> 'SVGPath'

Interpolate between two paths with automatic normalization

Interpolated path at time t Raises: ValueError: If paths are incompatible and auto_normalize fails

is_compatible_for_morphing(other: SVGPath) -> bool

Check if two paths can be morphed

True if paths can be morphed

normalize_for_morphing(other: 'SVGPath') -> tuple['SVGPath', 'SVGPath']

Normalize two paths to be compatible for morphing

Tuple of (normalized_self, normalized_other) Raises: ValueError: If paths can't be made compatible

to_absolute()

Convert all commands to absolute coordinates

New SVGPath with all absolute commands

to_cubic_beziers()

Convert all curve commands to cubic Bezier curves

to_string()

Convert to SVG path data string

SVG path data string (e.g., "M 0,0 L 100,100")