Struct MorphPath 

pub struct MorphPath { /* private fields */ }

A checked path value for geometry interpolation and fill/stroke. Original path snapshots are retained at exact animation endpoints.

use motion_core::prelude::*;
use motion_core::{
    DisplayList, RasterLimits, ResourcePool, ValidatedDisplayList, MAX_PATH_VERBS,
    MAX_STROKE_VERBS, MAX_SVG_PATH_BYTES, sample_offsets,
};
let (from, to) = MorphPath::pair(
    Circle::new(Point::new(8.0, 8.0), 6.0).path(),
    Star::new(Point::new(8.0, 8.0), 5, 6.0, 2.5).path(),
)?;
let animation = Tween::new(from, to, 1.seconds());
let middle = animation.sample(500.milliseconds());
assert!(middle.bounding_box().is_finite());

Implementations

impl MorphPath

pub fn new(path: Path2D) -> Result<Self, ValidationError>

Captures a path and promotes line/quadratic segments to cubic controls. At most 64 contours are accepted; all existing path limits still apply.

pub fn pair( source: Path2D, target: Path2D, ) -> Result<(Self, Self), ValidationError>

Prepares a pair once for repeated Tween sampling, using 32 uniform arc-length landmarks plus both paths’ existing curve boundaries.

pub fn pair_with_samples( source: Path2D, target: Path2D, samples: usize, ) -> Result<(Self, Self), ValidationError>

Prepares 4..=256 arc-length landmarks per contour. Output remains capped by MAX_PATH_VERBS, with at most 64 matched contours and bounded alignment.

pub fn try_interpolate( &self, target: &Self, progress: f64, ) -> Result<Self, ValidationError>

Checked, stateless interpolation. Finite overshoot is allowed; exact progress 0/1 returns the original verb snapshots. Unprepared values compute correspondence on demand; prefer pair for repeated sampling.

Trait Implementations

impl Clone for MorphPath

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MorphPath

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Interpolate for MorphPath

fn interpolate(&self, target: &Self, progress: f64) -> Self

Blends toward target with nominal progress zero at self and one at target.

impl PartialEq for MorphPath

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Shape for MorphPath

fn path(&self) -> Path2D

Returns a checked path snapshot without f32 narrowing.

fn bounding_box(&self) -> Rect

Geometric bounds; defaults to the path’s cached curve bounds.

fn validate(&self) -> Result<(), ValidationError>

Reports retained authoring errors before measuring or drawing.

fn as_rect(&self) -> Option<Rect>

Exact rectangle equivalent, when available, for a rule-independent fast path.

fn fill(self, paint: impl Into<Paint>) -> Styled<Self>

where Self: Sized,

Adds floating fill paint, using the nonzero rule by default.

fn stroke(self, width: f64, paint: impl Into<Paint>) -> Styled<Self>

where Self: Sized,

Adds a bounded curve/path stroke without an implicit fill.