Struct splines::Spline

pub struct Spline<T>(_);

Spline curve used to provide interpolation between control points (keys).

Methods

impl<T> Spline<T>

pub fn from_vec(keys: Vec<Key<T>>) -> Self

Create a new spline out of keys. The keys don’t have to be sorted even though it’s recommended to provide ascending sorted ones (for performance purposes).

pub fn from_iter<I>(iter: I) -> Self where     I: Iterator<Item = Key<T>>,

Create a new spline by consuming an Iterater<Item = Key<T>>. They keys don’t have to be sorted.

Note on iterators

It’s valid to use any iterator that implements Iterator<Item = Key<T>>. However, you should use Spline::from_vec if you are passing a Vec<_>. This will remove dynamic allocations.

pub fn keys(&self) -> &[Key<T>]

Retrieve the keys of a spline.

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

Sample a spline at a given time.

The current implementation, based on immutability, cannot perform in constant time. This means that sampling’s processing complexity is currently O(log n). It’s possible to achieve O(1) performance by using a slightly different spline type. If you are interested by this feature, an implementation for a dedicated type is foreseen yet not started yet.

Return

None if you try to sample a value at a time that has no key associated with. That can also happen if you try to sample between two keys with a specific interpolation mode that make the sampling impossible. For instance, Interpolate::CatmullRom requires four keys. If you’re near the beginning of the spline or its end, ensure you have enough keys around to make the sampling.

pub fn clamped_sample(&self, t: f32) -> T where     T: Interpolate,

Sample a spline at a given time with clamping.

Return

If you sample before the first key or after the last one, return the first key or the last one, respectively. Otherwise, behave the same way as Spline::sample.

Panic

This function panics if you have no key.

Trait Implementations

impl<T: Debug> Debug for Spline<T>

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

Formats the value using the given formatter.

impl<T: Clone> Clone for Spline<T>

fn clone(&self) -> Spline<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a, T> IntoIterator for &'a Spline<T>

type Item = &'a Key<T>

The type of the elements being iterated over.

type IntoIter = Iter<'a, T>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.