svg_path/fit

default_minimize_options

pub fn default_minimize_options() -> svg_path.MinimizeOptions

Return the default options for segment minimization.

default_parametric_options

</>

pub fn default_parametric_options() -> svg_path.ParametricOptions

Return the default options for parametric subpath fitting.

fit_cubic_with_endpoint_tangents

</>

pub fn fit_cubic_with_endpoint_tangents(
  start start: svg_path.Point,
  end end: svg_path.Point,
  start_tangent start_tangent: svg_path.Point,
  end_tangent end_tangent: svg_path.Point,
  samples samples: List(#(Float, svg_path.Point)),
) -> Result(
  #(svg_path.Segment, svg_path.CubicFitReport),
  svg_path.Error,
)

Fit a cubic Bezier segment with fixed endpoints and endpoint tangents.

This is a geometry-model convenience wrapper around bezier.fit_cubic_with_endpoint_tangents. It accepts svg_path.Point values, returns an svg_path.CubicBezier segment, and maps fit failures into svg_path.Error.

fit_cubic_with_endpoints

</>

pub fn fit_cubic_with_endpoints(
  start start: svg_path.Point,
  end end: svg_path.Point,
  samples samples: List(#(Float, svg_path.Point)),
) -> Result(
  #(svg_path.Segment, svg_path.CubicFitReport),
  svg_path.Error,
)

Fit a cubic Bezier segment with fixed endpoints and no tangent constraints.

This is a geometry-model convenience wrapper around bezier.fit_cubic_with_endpoints. It accepts svg_path.Point values, returns an svg_path.CubicBezier segment, and maps fit failures into svg_path.Error.

segment_minimize

</>

pub fn segment_minimize(
  segment: svg_path.Segment,
  measure f: fn(svg_path.Point) -> Float,
) -> Result(Float, svg_path.Error)

Return the segment parameter where a scalar function is minimized.

This numerically minimizes f(segment_point(t)) for t in 0.0..1.0.

segment_minimize_with

</>

pub fn segment_minimize_with(
  segment: svg_path.Segment,
  measure f: fn(svg_path.Point) -> Float,
  options options: svg_path.MinimizeOptions,
) -> Result(Float, svg_path.Error)

Return the segment parameter where a scalar function is minimized using explicit options.

subpath_from_parametric

</>

pub fn subpath_from_parametric(
  from start: Float,
  to end: Float,
  point point_function: fn(Float) -> svg_path.Point,
) -> Result(svg_path.Subpath, svg_path.Error)

Approximate a parametric curve with a sequence of cubic Bezier segments.

The parameter interval is split uniformly into default_parametric_options().initial_piece_count pieces. Each piece is fitted with a cubic, then recursively bisected in parameter space until the maximum sampled fitting error is within tolerance. from and to must be finite and unequal; descending intervals are allowed. Otherwise returns InvalidParametricInterval. Fitting and construction errors propagate; this function does not guarantee a successful fit.

subpath_from_parametric_with

</>

pub fn subpath_from_parametric_with(
  from start: Float,
  to end: Float,
  point point_function: fn(Float) -> svg_path.Point,
  options options: svg_path.ParametricOptions,
) -> Result(svg_path.Subpath, svg_path.Error)

Approximate a parametric curve with a sequence of cubic Bezier segments using explicit options.

If options.tangent is Some(tangent_function), each cubic is constrained to match the endpoint tangent directions returned by that function. If it is None, control points are fitted from samples while the endpoints are fixed. The interval restrictions are the same as for subpath_from_parametric. Options must satisfy the constraints documented on ParametricOptions; invalid options, failed fits, and exhausted refinement return errors.

svg_path - v3.0.0

Values