1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

#![deny(missing_docs)]
/*!
This crate contains new traits useful for working with vector spaces.
They have default implementations, so you can just implement them to get a lot of useful methods for free for your vector type.
But you can also just implement the methods yourself.

You can also define some library in terms of these traits instead of using a specific vector math implementation, so the user can choose, which one to use, or simply add multiple vector math libraries which implement these traits yourself by using this library.
**/

mod dot;
mod inner;
mod vector;

pub use dot::DotProduct;
pub use inner::InnerSpace;
pub use vector::VectorSpace;

use std::ops::{Add, Sub};

/// The linear interpolation of two points.
pub fn interpolate<T: Copy>(a: T, b: T, ratio: <<T as Sub>::Output as VectorSpace>::Scalar) -> T
where
    T: Sub + Add<<T as Sub>::Output, Output = T>,
    <T as Sub>::Output: VectorSpace,
{
    a + (b - a) * ratio
}

/// The distance between two points.
pub fn distance<T: Sub>(a: T, b: T) -> <T::Output as VectorSpace>::Scalar
where
    T::Output: InnerSpace,
{
    (b - a).magnitude()
}

/// The squared distance between two points.
pub fn distance2<T: Sub>(a: T, b: T) -> <T::Output as VectorSpace>::Scalar
where
    T::Output: InnerSpace,
{
    (b - a).magnitude2()
}