Struct gfxmath_vec3::Vec3

#[repr(C)]pub struct Vec3<T> {
    pub x: T,
    pub y: T,
    pub z: T,
}

Fields

x: T

y: T

z: T

Implementations

impl<T> Vec3<T>

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

use gfxmath_vec3::Vec3;
 
let v = Vec3::<f32>::new(2.5, 0.0, -19.5);
 
assert_eq!(2.5, v.x);
assert_eq!(0.0, v.y);
assert_eq!(-19.5, v.z);

pub fn as_ptr(&self) -> *const T

pub fn as_mut_ptr(&mut self) -> *mut T

pub fn as_slice(&self) -> &[T]

use gfxmath_vec3::Vec3;
 
let a = Vec3::<f32>::new(1.0, 2.0, 3.0);
 
let a_slice = a.as_slice();
 
assert_eq!(1.0, a_slice[0]);
assert_eq!(2.0, a_slice[1]);
assert_eq!(3.0, a_slice[2]);

pub fn as_mut_slice(&mut self) -> &mut [T]

use gfxmath_vec3::Vec3;
 
let mut a = Vec3::<f32>::new(1.0, 2.0, 3.0);
 
{
    let a_slice = a.as_mut_slice();
 
    assert_eq!(1.0, a_slice[0]);
    assert_eq!(2.0, a_slice[1]);
    assert_eq!(3.0, a_slice[2]);
 
    a_slice[2] = 108.0;
    assert_eq!(108.0, a_slice[2]); 
}
 
a.x = 4.5;
assert_eq!(4.5, a.x);
 
let a_slice = a.as_mut_slice();
 
assert_eq!(4.5, a_slice[0]);
assert_eq!(2.0, a_slice[1]);
assert_eq!(108.0, a_slice[2]);

impl<T> Vec3<T> where
    T: Clone, 

pub fn all(val: T) -> Self

use gfxmath_vec3::Vec3;
 
let v = Vec3::<f32>::all(2.5);
 
assert_eq!(2.5, v.x);
assert_eq!(2.5, v.y);
assert_eq!(2.5, v.z);

Trait Implementations

impl<T> Add<&'_ Vec3<T>> for &Vec3<T> where
    T: Add<Output = T> + Copy, 

type Output = Vec3<T>

The resulting type after applying the + operator.

fn add(self, rhs: &Vec3<T>) -> Self::Output

Performs the + operation.

impl<T> Add<&'_ Vec3<T>> for Vec3<T> where
    T: Add<Output = T> + Copy, 

type Output = Vec3<T>

The resulting type after applying the + operator.

fn add(self, rhs: &Vec3<T>) -> Self::Output

Performs the + operation.

impl<T> Add<T> for Vec3<T> where
    T: Add<Output = T> + Copy, 

type Output = Vec3<T>

The resulting type after applying the + operator.

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

use gfxmath_vec3::Vec3;
 
let v = Vec3::<f32>::new(1.0, 2.0, 3.0);

let res: Vec3<f32> = (v + 3.0).into();
 
assert_eq!(4.0, res.x);
assert_eq!(5.0, res.y);
assert_eq!(6.0, res.z);

impl<T> Add<T> for &Vec3<T> where
    T: Add<Output = T> + Copy, 

type Output = Vec3<T>

The resulting type after applying the + operator.

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

Performs the + operation.

impl<T> Add<Vec3<T>> for Vec3<T> where
    T: Add<Output = T> + Copy, 

type Output = Vec3<T>

The resulting type after applying the + operator.

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

use gfxmath_vec3::Vec3;
let a = Vec3::new(1.0, 2.0, 3.0);
let b = Vec3::new(3.0, 4.0, 5.0);
 
let res: Vec3<f32> = &a + &b;
 
assert_eq!(1.0, a.x);
assert_eq!(2.0, a.y);
assert_eq!(3.0, a.z);
 
assert_eq!(3.0, b.x);
assert_eq!(4.0, b.y);
assert_eq!(5.0, b.z);
 
assert_eq!(4.0, res.x);
assert_eq!(6.0, res.y);
assert_eq!(8.0, res.z);

impl<T> Add<Vec3<T>> for &Vec3<T> where
    T: Add<Output = T> + Copy, 

type Output = Vec3<T>

The resulting type after applying the + operator.

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

Performs the + operation.

impl<T> AddAssign<&'_ Vec3<T>> for Vec3<T> where
    T: AddAssign<T> + Copy, 

fn add_assign(&mut self, rhs: &Vec3<T>)

Performs the += operation.

impl<T> AddAssign<T> for Vec3<T> where
    T: AddAssign<T> + Copy, 

fn add_assign(&mut self, rhs: T)

use gfxmath_vec3::Vec3;
let mut a = Vec3::new(1.0, 2.0, 3.0);
a += 4.0;
 
assert_eq!(5.0, a.x);
assert_eq!(6.0, a.y);
assert_eq!(7.0, a.z);

impl<T> AddAssign<Vec3<T>> for Vec3<T> where
    T: AddAssign<T> + Copy, 

fn add_assign(&mut self, rhs: Vec3<T>)

use gfxmath_vec3::Vec3;
let mut a = Vec3::new(1.0, 2.0, 3.0);
let b = Vec3::new(3.0, 4.0, 5.0);
 
a += b;
 
assert_eq!(4.0, a.x);
assert_eq!(6.0, a.y);
assert_eq!(8.0, a.z);

impl<T: Clone> Clone for Vec3<T>

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T> Cross<&'_ Vec3<T>> for &Vec3<T> where
    T: Add<Output = T> + Mul<Output = T> + Sub<Output = T> + Copy, 

type Output = Vec3<T>

fn cross(self, rhs: &Vec3<T>) -> Self::Output

impl<T> Cross<&'_ Vec3<T>> for Vec3<T> where
    T: Add<Output = T> + Mul<Output = T> + Sub<Output = T> + Copy, 

type Output = Vec3<T>

fn cross(self, rhs: &Vec3<T>) -> Self::Output

impl<T> Cross<Vec3<T>> for Vec3<T> where
    T: Add<Output = T> + Mul<Output = T> + Sub<Output = T> + Copy, 

type Output = Vec3<T>

fn cross(self, rhs: Vec3<T>) -> Self::Output

use gfxmath_vec3::ops::Cross;
use gfxmath_vec3::Vec3;

let a = Vec3::new(1.0, 3.0, 2.5);
let b = Vec3::all(2.0);

let res = a.cross(b);
 
assert_eq!(1.0, res.x);
assert_eq!(3.0, res.y);
assert_eq!(-4.0, res.z);

impl<T> Cross<Vec3<T>> for &Vec3<T> where
    T: Add<Output = T> + Mul<Output = T> + Sub<Output = T> + Copy, 

type Output = Vec3<T>

fn cross(self, rhs: Vec3<T>) -> Self::Output

impl<T: Debug> Debug for Vec3<T>

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

Formats the value using the given formatter.

impl<T> Div<T> for Vec3<T> where
    T: Div<Output = T> + Copy, 

type Output = Vec3<T>

The resulting type after applying the / operator.

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

Scalar division with vector

use gfxmath_vec3::Vec3;
 
let a = Vec3::<f32>::new(0.5, 2.5, -2.5);
let b = Vec3::from(a / 2.0);
 
assert_eq!( 0.25, b.x);
assert_eq!( 1.25, b.y);
assert_eq!(-1.25, b.z);

impl<T> Div<T> for &Vec3<T> where
    T: Div<Output = T> + Copy, 

type Output = Vec3<T>

The resulting type after applying the / operator.

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

Performs the / operation.

impl<T> DivAssign<&'_ Vec3<T>> for Vec3<T> where
    T: DivAssign<T> + Copy, 

fn div_assign(&mut self, rhs: &Vec3<T>)

Performs the /= operation.

impl<T> DivAssign<T> for Vec3<T> where
    T: DivAssign<T> + Copy, 

fn div_assign(&mut self, rhs: T)

Scalar division with vector

use gfxmath_vec3::Vec3;
 
let mut a = Vec3::<f32>::new(0.5, 2.5, -2.5);
a /= 2.0;
 
assert_eq!( 0.25, a.x);
assert_eq!( 1.25, a.y);
assert_eq!(-1.25, a.z);

impl<T> DivAssign<Vec3<T>> for Vec3<T> where
    T: DivAssign<T> + Copy, 

fn div_assign(&mut self, rhs: Vec3<T>)

Scalar division with vector

use gfxmath_vec3::Vec3;
 
let mut a = Vec3::<f32>::new(0.5, 2.5, -2.5);
let b = Vec3::<f32>::new(0.5, 2.5, -2.5);
a /= b;
 
assert_eq!(1.0, a.x);
assert_eq!(1.0, a.y);
assert_eq!(1.0, a.z);

impl<T> Dot<&'_ Vec3<T>> for &Vec3<T> where
    T: Add<Output = T> + Mul<Output = T> + Copy, 

type Output = T

fn dot(self, rhs: &Vec3<T>) -> Self::Output

impl<T> Dot<&'_ Vec3<T>> for Vec3<T> where
    T: Add<Output = T> + Mul<Output = T> + Copy, 

type Output = T

fn dot(self, rhs: &Vec3<T>) -> Self::Output

impl<T> Dot<Vec3<T>> for Vec3<T> where
    T: Add<Output = T> + Mul<Output = T> + Copy, 

type Output = T

fn dot(self, rhs: Vec3<T>) -> Self::Output

use gfxmath_vec3::{Vec3, ops::Dot};
 
let a = Vec3::new(3.0, 4.0, 5.0);
let b = Vec3::new(2.0, 1.0, 3.0);
 
let res = a.dot(b);
 
assert_eq!(25.0, res);

impl<T> Dot<Vec3<T>> for &Vec3<T> where
    T: Add<Output = T> + Mul<Output = T> + Copy, 

type Output = T

fn dot(self, rhs: Vec3<T>) -> Self::Output

impl<T> From<&'_ (T, T, T)> for Vec3<T> where
    T: Copy, 

use gfxmath_vec3::Vec3;
 
let t = (3.0, 4.0, 9.0);
let v: Vec3<f32> = (&t).into();
 
assert_eq!(3.0, v.x);
assert_eq!(4.0, v.y);
assert_eq!(9.0, v.z);

fn from(val: &(T, T, T)) -> Self

Performs the conversion.

impl<T> From<(T, T, T)> for Vec3<T>

use gfxmath_vec3::Vec3;
 
let v: Vec3<f32> = (3.0, 4.0, 9.0).into();
 
assert_eq!(3.0, v.x);
assert_eq!(4.0, v.y);
assert_eq!(9.0, v.z);

fn from(val: (T, T, T)) -> Self

Performs the conversion.

impl Hash for Vec3<f32>

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

pub fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl Hash for Vec3<f64>

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

pub fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl Hash for Vec3<i32>

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

pub fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl Hash for Vec3<i64>

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

pub fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl Hash for Vec3<u32>

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

pub fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl Hash for Vec3<u64>

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

pub fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl<T> Mul<&'_ Vec3<T>> for &Vec3<T> where
    T: Mul<Output = T> + Copy, 

type Output = Vec3<T>

The resulting type after applying the * operator.

fn mul(self, rhs: &Vec3<T>) -> Self::Output

Performs the * operation.

impl<T> Mul<&'_ Vec3<T>> for Vec3<T> where
    T: Mul<Output = T> + Copy, 

type Output = Vec3<T>

The resulting type after applying the * operator.

fn mul(self, rhs: &Vec3<T>) -> Self::Output

Performs the * operation.

impl<T> Mul<T> for Vec3<T> where
    T: Mul<Output = T> + Copy, 

type Output = Vec3<T>

The resulting type after applying the * operator.

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

Scalar multiplication with vector

use gfxmath_vec3::Vec3;
 
let a = Vec3::<f32>::new(0.5, 2.5, -2.5);
let b = Vec3::from(a * 2.0);
 
assert_eq!( 1.0, b.x);
assert_eq!( 5.0, b.y);
assert_eq!(-5.0, b.z);

impl<T> Mul<T> for &Vec3<T> where
    T: Mul<Output = T> + Copy, 

type Output = Vec3<T>

The resulting type after applying the * operator.

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

Performs the * operation.

impl<T> Mul<Vec3<T>> for Vec3<T> where
    T: Mul<Output = T> + Copy, 

type Output = Vec3<T>

The resulting type after applying the * operator.

fn mul(self, rhs: Vec3<T>) -> Self::Output

use gfxmath_vec3::Vec3;
 
let mut a = Vec3::<f32>::new(1.5, 2.5, -2.0);
let b = Vec3::<f32>::new(4.0, 2.0,  4.0);
let c = Vec3::from(&a * &b);
 
a.x = 2.0;
 
assert_eq!( 6.0, c.x);
assert_eq!( 5.0, c.y);
assert_eq!(-8.0, c.z);
 
let c = Vec3::from(a * b);

assert_eq!( 8.0, c.x);
assert_eq!( 5.0, c.y);
assert_eq!(-8.0, c.z);

impl<T> Mul<Vec3<T>> for &Vec3<T> where
    T: Mul<Output = T> + Copy, 

type Output = Vec3<T>

The resulting type after applying the * operator.

fn mul(self, rhs: Vec3<T>) -> Self::Output

Performs the * operation.

impl<T> MulAssign<&'_ Vec3<T>> for Vec3<T> where
    T: MulAssign<T> + Copy, 

fn mul_assign(&mut self, rhs: &Vec3<T>)

Performs the *= operation.

impl<T> MulAssign<T> for Vec3<T> where
    T: MulAssign<T> + Copy, 

fn mul_assign(&mut self, rhs: T)

use gfxmath_vec3::Vec3;
 
let mut a = Vec3::<f32>::new(1.5, 2.5, -2.0);
a *= 2.0;
 
assert_eq!( 3.0, a.x);
assert_eq!( 5.0, a.y);
assert_eq!(-4.0, a.z);
 

impl<T> MulAssign<Vec3<T>> for Vec3<T> where
    T: MulAssign<T> + Copy, 

fn mul_assign(&mut self, rhs: Vec3<T>)

use gfxmath_vec3::Vec3;
 
let mut a = Vec3::<f32>::new(1.5, 2.5, -2.0);
let b = Vec3::<f32>::new(4.0, 2.0,  4.0);
a *= b;
 
assert_eq!( 6.0, a.x);
assert_eq!( 5.0, a.y);
assert_eq!(-8.0, a.z);
 

impl<T> Neg for Vec3<T> where
    T: Neg<Output = T> + Copy, 

type Output = Vec3<T>

The resulting type after applying the - operator.

fn neg(self) -> Self::Output

use gfxmath_vec3::ops::Cross;
use gfxmath_vec3::Vec3;

let a = Vec3::new(1.0, 3.0, 2.5);

let res = -a;
 
assert_eq!(-1.0, res.x);
assert_eq!(-3.0, res.y);
assert_eq!(-2.5, res.z);

impl<T> Neg for &Vec3<T> where
    T: Neg<Output = T> + Copy, 

type Output = Vec3<T>

The resulting type after applying the - operator.

fn neg(self) -> Self::Output

Performs the unary - operation.

impl Norm for Vec3<f32>

type Output = Option<Vec3<f32>>

fn norm(self) -> Self::Output

use gfxmath_vec3::ops::Norm;
use gfxmath_vec3::Vec3;
 
let a = Vec3::<f32>::new(3.0, 4.0, 0.0);
let an = a.norm().unwrap();
 
assert_eq!(3.0/5.0, an.x);
assert_eq!(4.0/5.0, an.y);
assert_eq!(0.0, an.z);

impl Norm for &Vec3<f32>

type Output = Option<Vec3<f32>>

fn norm(self) -> Self::Output

impl Norm for Vec3<f64>

type Output = Option<Vec3<f64>>

fn norm(self) -> Self::Output

use gfxmath_vec3::ops::Norm;
use gfxmath_vec3::Vec3;
 
let a = Vec3::<f64>::new(3.0, 4.0, 0.0);
let an = a.norm().unwrap();
 
assert_eq!(3.0/5.0, an.x);
assert_eq!(4.0/5.0, an.y);
assert_eq!(0.0, an.z);

impl Norm for &Vec3<f64>

type Output = Option<Vec3<f64>>

fn norm(self) -> Self::Output

impl<T: PartialEq> PartialEq<Vec3<T>> for Vec3<T>

fn eq(&self, other: &Vec3<T>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Vec3<T>) -> bool

This method tests for !=.

impl<T> StructuralPartialEq for Vec3<T>

impl<T> Sub<&'_ Vec3<T>> for &Vec3<T> where
    T: Sub<Output = T> + Copy, 

type Output = Vec3<T>

The resulting type after applying the - operator.

fn sub(self, rhs: &Vec3<T>) -> Self::Output

Performs the - operation.

impl<T> Sub<&'_ Vec3<T>> for Vec3<T> where
    T: Sub<Output = T> + Copy, 

type Output = Vec3<T>

The resulting type after applying the - operator.

fn sub(self, rhs: &Vec3<T>) -> Self::Output

Performs the - operation.

impl<T> Sub<T> for Vec3<T> where
    T: Sub<Output = T> + Copy, 

type Output = Vec3<T>

The resulting type after applying the - operator.

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

use gfxmath_vec3::Vec3;
 
let v = Vec3::new(1.0, 2.0, 3.0);

let res = v - 3.0;
 
assert_eq!(-2.0, res.x);
assert_eq!(-1.0, res.y);
assert_eq!( 0.0, res.z);

impl<T> Sub<T> for &Vec3<T> where
    T: Sub<Output = T> + Copy, 

type Output = Vec3<T>

The resulting type after applying the - operator.

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

Performs the - operation.

impl<T> Sub<Vec3<T>> for Vec3<T> where
    T: Sub<Output = T> + Copy, 

type Output = Vec3<T>

The resulting type after applying the - operator.

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

use gfxmath_vec3::Vec3;
 
let mut a = Vec3::<f32>::new(0.5, 2.5, -2.5);
let b = Vec3::<f32>::new(1.5, 2.5,  2.0);
let c = Vec3::from(&a - &b);
 
a.x = 1.0;
 
assert_eq!(-1.0, c.x);
assert_eq!( 0.0, c.y);
assert_eq!(-4.5, c.z);
 
let c2 = Vec3::from(a - b);

assert_eq!(-0.5, c2.x);
assert_eq!( 0.0, c2.y);
assert_eq!(-4.5, c2.z);

impl<T> Sub<Vec3<T>> for &Vec3<T> where
    T: Sub<Output = T> + Copy, 

type Output = Vec3<T>

The resulting type after applying the - operator.

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

Performs the - operation.

impl<T> SubAssign<&'_ Vec3<T>> for Vec3<T> where
    T: SubAssign<T> + Copy, 

fn sub_assign(&mut self, rhs: &Vec3<T>)

Performs the -= operation.

impl<T> SubAssign<T> for Vec3<T> where
    T: SubAssign<T> + Copy, 

fn sub_assign(&mut self, rhs: T)

use gfxmath_vec3::Vec3;
 
let mut a = Vec3::<f32>::new(0.5, 2.5, -2.5);
 
a -= -1.0;
 
assert_eq!( 1.5, a.x);
assert_eq!( 3.5, a.y);
assert_eq!(-1.5, a.z);

impl<T> SubAssign<Vec3<T>> for Vec3<T> where
    T: SubAssign<T> + Copy, 

fn sub_assign(&mut self, rhs: Vec3<T>)

use gfxmath_vec3::Vec3;
 
let mut a = Vec3::<f32>::new(0.5, 2.5, -2.5);
let mut b = Vec3::<f32>::new(1.5, 2.5,  2.0);
 
a -= &b;
 
assert_eq!(-1.0, a.x);
assert_eq!( 0.0, a.y);
assert_eq!(-4.5, a.z);
 
a -= b;
assert_eq!(-2.5, a.x);
assert_eq!(-2.5, a.y);
assert_eq!(-6.5, a.z);