Struct UnevenSampleCurve 

pub struct UnevenSampleCurve<T, I> { /* private fields */ }

A curve that is defined by interpolation over unevenly spaced samples with explicit interpolation.

Implementations

impl<T, I> UnevenSampleCurve<T, I>

pub fn new( timed_samples: impl IntoIterator<Item = (f32, T)>, interpolation: I, ) -> Result<Self, UnevenCoreError>

where I: Fn(&T, &T, f32) -> T,

Create a new UnevenSampleCurve using the provided interpolation to interpolate between adjacent timed_samples. The given samples are filtered to finite times and sorted internally; if there are not at least 2 valid timed samples, an error will be returned.

The interpolation takes two values by reference together with a scalar parameter and produces an owned value. The expectation is that interpolation(&x, &y, 0.0) and interpolation(&x, &y, 1.0) are equivalent to x and y respectively.

pub fn map_sample_times(self, f: impl Fn(f32) -> f32) -> UnevenSampleCurve<T, I>

This UnevenSampleAutoCurve, but with the sample times moved by the map f. In principle, when f is monotone, this is equivalent to CurveExt::reparametrize, but the function inputs to each are inverses of one another.

The samples are re-sorted by time after mapping and deduplicated by output time, so the function f should generally be injective over the sample times of the curve.

Trait Implementations

impl<T: Clone, I: Clone> Clone for UnevenSampleCurve<T, I>

fn clone(&self) -> UnevenSampleCurve<T, I>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T, I> Curve<T> for UnevenSampleCurve<T, I>

where T: Clone, I: Fn(&T, &T, f32) -> T,

fn domain(&self) -> Interval

The interval over which this curve is parametrized.

fn sample_clamped(&self, t: f32) -> T

Sample a point on this curve at the parameter value t, clamping t to lie inside the domain of the curve.

fn sample_unchecked(&self, t: f32) -> T

Sample a point on this curve at the parameter value t, extracting the associated value. This is the unchecked version of sampling, which should only be used if the sample time t is already known to lie within the curve’s domain.

fn sample(&self, t: f32) -> Option<T>

Sample a point on this curve at the parameter value t, returning None if the point is outside of the curve’s domain.

impl<T, I> Debug for UnevenSampleCurve<T, I>

where UnevenCore<T>: Debug,

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

Formats the value using the given formatter.

impl<'de, T, I> Deserialize<'de> for UnevenSampleCurve<T, I>

where T: Deserialize<'de>, I: Deserialize<'de>,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T, I> Serialize for UnevenSampleCurve<T, I>

where T: Serialize, I: Serialize,

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.