Struct Vector3 

pub struct Vector3 {
    pub x: f64,
    pub y: f64,
    pub z: f64,
}

A three-dimensional vector.

Examples

use use_vector::Vector3;

let vector = Vector3::new(2.0, 3.0, 6.0);

assert_eq!(vector.magnitude(), 7.0);

Fields

x: f64

The x component.

y: f64

The y component.

z: f64

The z component.

Implementations

impl Vector3

pub const ZERO: Self

The zero vector.

pub const ONE: Self

A vector with every component set to 1.0.

pub const fn new(x: f64, y: f64, z: f64) -> Self

Creates a vector from its components.

pub fn dot(self, other: Self) -> f64

Returns the dot product with other.

pub fn magnitude_squared(self) -> f64

Returns the squared Euclidean magnitude.

pub fn magnitude(self) -> f64

Returns the Euclidean magnitude.

pub fn normalize(self) -> Option<Self>

Returns a normalized vector when the magnitude is finite and non-zero.

Returns None for zero vectors or vectors with non-finite magnitude.

pub fn scale(self, scalar: f64) -> Self

Returns the vector scaled by scalar.

pub fn distance(self, other: Self) -> f64

Returns the Euclidean distance to other.

pub fn distance_squared(self, other: Self) -> f64

Returns the squared Euclidean distance to other.

pub fn lerp(self, other: Self, t: f64) -> Self

Returns the linear interpolation between self and other for t.

pub fn cross(self, other: Self) -> Self

Returns the cross product with other.

Examples

use use_vector::Vector3;

let x = Vector3::new(1.0, 0.0, 0.0);
let y = Vector3::new(0.0, 1.0, 0.0);

assert_eq!(x.cross(y), Vector3::new(0.0, 0.0, 1.0));

Trait Implementations

impl Add for Vector3

type Output = Vector3

The resulting type after applying the + operator.

fn add(self, rhs: Self) -> Self::Output

Performs the + operation.

impl Clone for Vector3

fn clone(&self) -> Vector3

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Vector3

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

Formats the value using the given formatter.

impl Div<f64> for Vector3

type Output = Vector3

The resulting type after applying the / operator.

fn div(self, rhs: f64) -> Self::Output

Performs the / operation.

impl Mul<f64> for Vector3

type Output = Vector3

The resulting type after applying the * operator.

fn mul(self, rhs: f64) -> Self::Output

Performs the * operation.

impl Neg for Vector3

type Output = Vector3

The resulting type after applying the - operator.

fn neg(self) -> Self::Output

Performs the unary - operation.

impl PartialEq for Vector3

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Sub for Vector3

type Output = Vector3

The resulting type after applying the - operator.

fn sub(self, rhs: Self) -> Self::Output

Performs the - operation.

impl Copy for Vector3

impl StructuralPartialEq for Vector3