Struct Vector4

#[repr(C, packed(1))]
pub struct Vector4 {
    pub x: f32,
    pub y: f32,
    pub z: f32,
    pub w: f32,
}

Fields

x: f32

y: f32

z: f32

w: f32

Implementations

impl Vector4

pub fn new() -> Vector4

Creates a vector <0.0, 0.0, 0.0, 0.0>

Examples

use vex::Vector4;
 
let actual = Vector4::new();
let expected = Vector4 { x: 0.0, y: 0.0, z: 0.0, w: 0.0 };
assert_eq!(actual, expected);

pub fn one() -> Vector4

Creates a vector <0.0, 0.0, 0.0, 0.0>

Examples

use vex::Vector4;
 
let actual = Vector4::one();
let expected = Vector4 { x: 1.0, y: 1.0, z: 1.0, w: 1.0 };
assert_eq!(actual, expected);

pub fn make(x: f32, y: f32, z: f32, w: f32) -> Vector4

Creates a vector from the provided values

Examples

use vex::Vector4;
 
let actual = Vector4::make(1.0, 2.0, 3.0, 4.0);
let expected = Vector4 { x: 1.0, y: 2.0, z: 3.0, w: 4.0 };
assert_eq!(actual, expected);

pub fn dot(a: &Vector4, b: &Vector4) -> f32

Find the dot product between two vectors

Examples

use vex::Vector4;
 
let a = Vector4::make(1.0, 0.0, 0.0, 0.0);
let b = Vector4::make(0.0, 0.0, 1.0, 0.0);
let actual = Vector4::dot(&a, &b);
let expected = 0.0;
assert_eq!(actual, expected);

pub fn min(a: &Vector4, b: &Vector4) -> Vector4

Find the minimum (component-wise) vector between two vectors

Examples

use vex::Vector4;
 
let a = Vector4::make(1.0, 4.0, 5.0, 7.0);
let b = Vector4::make(2.0, 3.0, 6.0, 8.0);
let actual = Vector4::min(&a, &b);
let expected = Vector4::make(1.0, 3.0, 5.0, 7.0);
assert_eq!(actual, expected);

pub fn max(a: &Vector4, b: &Vector4) -> Vector4

Find the maximum (component-wise) vector between two vectors

Examples

use vex::Vector4;
 
let a = Vector4::make(1.0, 4.0, 5.0, 7.0);
let b = Vector4::make(2.0, 3.0, 6.0, 8.0);
let actual = Vector4::max(&a, &b);
let expected = Vector4::make(2.0, 4.0, 6.0, 8.0);
assert_eq!(actual, expected);

pub fn clamp(&mut self, a: &Vector4, b: &Vector4)

Find the clamped (component-wise) vector between two vectors

Examples

use vex::Vector4;
 
let a = Vector4::make(1.0, 3.0, 5.0, 7.0);
let b = Vector4::make(2.0, 4.0, 6.0, 8.0);
let mut actual = Vector4::make(0.0, 5.0, 10.0, 20.0);
actual.clamp(&a, &b);
let expected = Vector4::make(1.0, 4.0, 6.0, 8.0);
assert_eq!(actual, expected);

pub fn set(&mut self, x: f32, y: f32, z: f32, w: f32)

Set the components of a vector

Examples

use vex::Vector4;
 
let mut actual = Vector4::new();
actual.set(1.0, 2.0, 3.0, 4.0);
let expected = Vector4::make(1.0, 2.0, 3.0, 4.0);
assert_eq!(actual, expected);

pub fn mag(&self) -> f32

Get the magnitude of the vector

Examples

use vex::Vector4;
 
let actual = Vector4::make(1.0, 2.0, 3.0, 4.0).mag();
let expected = 5.47722557505;
assert_eq!(actual, expected);

pub fn mag_sq(&self) -> f32

Get the squared magnitude of the vector

Examples

use vex::Vector4;
 
let actual = Vector4::make(1.0, 2.0, 3.0, 4.0).mag_sq();
let expected = 30.0;
assert_eq!(actual, expected);

pub fn norm(&mut self) -> f32

Normalize the vector

Examples

use vex::Vector4;
 
let mut actual = Vector4::make(1.0, 2.0, 3.0, 4.0);
actual.norm();
let expected = Vector4::make(0.18257418, 0.36514837, 0.5477225, 0.73029673);
assert_eq!(actual, expected);

pub fn abs(&mut self)

Set the components of a vector to their absolute values

Examples

use vex::Vector4;
 
let mut actual = Vector4::make(-1.0, -2.0, -3.0, -4.0);
actual.abs();
let expected = Vector4::make(1.0, 2.0, 3.0, 4.0);
assert_eq!(actual, expected);

pub fn is_valid(&self) -> bool

Determine whether or not all components of the vector are valid

Examples

use vex::Vector4;
 
let actual = Vector4::make(1.0, 2.0, 3.0, 4.0);
assert!(actual.is_valid());

Trait Implementations

impl Add<f32> for Vector4

fn add(self, _rhs: f32) -> Vector4

Find the resulting vector by adding a scalar to a vector’s components

Examples

use vex::Vector4;
 
let actual = Vector4::make(1.0, 2.0, 3.0, 4.0) + 1.0;
let expected = Vector4::make(2.0, 3.0, 4.0, 5.0);
assert_eq!(actual, expected);

type Output = Vector4

The resulting type after applying the + operator.

impl Add for Vector4

fn add(self, _rhs: Vector4) -> Vector4

Add two vectors

Examples

use vex::Vector4;
 
let a = Vector4::make(1.0, 2.0, 3.0, 4.0);
let b = Vector4::make(5.0, 6.0, 7.0, 8.0);
let actual = a + b;
let expected = Vector4::make(6.0, 8.0, 10.0, 12.0);
assert_eq!(actual, expected);

type Output = Vector4

The resulting type after applying the + operator.

impl AddAssign<f32> for Vector4

fn add_assign(&mut self, _rhs: f32)

Increment a vector by a scalar

Examples

use vex::Vector4;
 
let mut actual = Vector4::make(1.0, 2.0, 3.0, 4.0);
actual += 10.0;
let expected = Vector4::make(11.0, 12.0, 13.0, 14.0);
assert_eq!(actual, expected);

impl AddAssign for Vector4

fn add_assign(&mut self, _rhs: Vector4)

Increment a vector by another vector

Examples

use vex::Vector4;
 
let mut actual = Vector4::make(1.0, 2.0, 3.0, 4.0);
actual += Vector4::make(1.0, 2.0, 3.0, 4.0);
let expected = Vector4::make(2.0, 4.0, 6.0, 8.0);
assert_eq!(actual, expected);

impl Clone for Vector4

fn clone(&self) -> Vector4

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Vector4

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

Formats the value using the given formatter.

impl Display for Vector4

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

Formats the value using the given formatter.

impl Div<f32> for Vector4

fn div(self, _rhs: f32) -> Vector4

Find the resulting vector by dividing a scalar to a vector’s components

Examples

use vex::Vector4;
 
let actual = Vector4::make(1.0, 2.0, 3.0, 4.0) / 2.0;
let expected = Vector4::make(0.5, 1.0, 1.5, 2.0);
assert_eq!(actual, expected);

type Output = Vector4

The resulting type after applying the / operator.

impl Div for Vector4

fn div(self, _rhs: Vector4) -> Vector4

Divide two vectors

Examples

use vex::Vector4;
 
let a = Vector4::make(2.0, 4.0, 6.0, 8.0);
let b = Vector4::make(1.0, 4.0, 12.0, 32.0);
let actual = a / b;
let expected = Vector4::make(2.0, 1.0, 0.5, 0.25);
assert_eq!(actual, expected);

type Output = Vector4

The resulting type after applying the / operator.

impl DivAssign<f32> for Vector4

fn div_assign(&mut self, _rhs: f32)

Divide a vector by a scalar

Examples

use vex::Vector4;
 
let mut actual = Vector4::make(1.0, 2.0, 3.0, 4.0);
actual /= 2.0;
let expected = Vector4::make(0.5, 1.0, 1.5, 2.0);
assert_eq!(actual, expected);

impl DivAssign for Vector4

fn div_assign(&mut self, _rhs: Vector4)

Divide a vector by another vector

Examples

use vex::Vector4;
 
let mut actual = Vector4::make(2.0, 4.0, 6.0, 8.0);
actual /= Vector4::make(1.0, 4.0, 12.0, 32.0);
let expected = Vector4::make(2.0, 1.0, 0.5, 0.25);
assert_eq!(actual, expected);

impl From<Vector3> for Vector4

fn from(item: Vector3) -> Vector4

Creates a Vector4 from the components of a Vector3

Examples

use vex::Vector3;
use vex::Vector4;
 
let input = Vector3::make(1.0, 2.0, 3.0);
let actual = Vector4::from(input);
let expected = Vector4 { x: 1.0, y: 2.0, z: 3.0, w: 0.0 };
assert_eq!(actual, expected);

impl From<Vector4> for Vector3

fn from(item: Vector4) -> Vector3

Creates a Vector3 from the components of a Vector4

Examples

use vex::Vector3;
use vex::Vector4;
 
let input = Vector4::make(1.0, 2.0, 3.0, 4.0);
let actual = Vector3::from(input);
let expected = Vector3 { x: 1.0, y: 2.0, z: 3.0 };
assert_eq!(actual, expected);

impl Index<u32> for Vector4

fn index(&self, index: u32) -> &f32

Looks up a component by index

Examples

use vex::Vector4;
 
let mut v = Vector4::make(1.0, 2.0, 3.0, 4.0);
assert_eq!(v[0], 1.0);
assert_eq!(v[1], 2.0);
assert_eq!(v[2], 3.0);
assert_eq!(v[3], 4.0);

type Output = f32

The returned type after indexing.

impl IndexMut<u32> for Vector4

fn index_mut<'a>(&'a mut self, index: u32) -> &'a mut f32

Mutate a component by index

Examples

use vex::Vector4;
 
let mut v = Vector4::new();
v[0] = 4.0;
v[1] = 5.0;
v[2] = 6.0;
v[3] = 7.0;
assert_eq!(v[0], 4.0);
assert_eq!(v[1], 5.0);
assert_eq!(v[2], 6.0);
assert_eq!(v[3], 7.0);

impl Matrix<Vector4> for Matrix4

fn transform_point(&self, point: &Vector4) -> Vector4

Find the resulting vector given a vector and matrix

Examples

use vex::Matrix;
use vex::Matrix4;
use vex::Vector4;
 
let m = Matrix4::make(1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0, 9.0, 10.0, 11.0, 12.0, 13.0, 14.0, 15.0, 16.0);
let v = Vector4::make(1.0, 2.0, 3.0, 4.0);
let actual = m.transform_point(&v);
let expected = Vector4::make(90.0, 100.0, 110.0, 120.0);
assert_eq!(actual, expected);

impl Mul<f32> for Vector4

fn mul(self, _rhs: f32) -> Vector4

Find the resulting vector by multiplying a scalar to a vector’s components

Examples

use vex::Vector4;
 
let actual = Vector4::make(1.0, 2.0, 3.0, 4.0) * 2.0;
let expected = Vector4::make(2.0, 4.0, 6.0, 8.0);
assert_eq!(actual, expected);

type Output = Vector4

The resulting type after applying the * operator.

impl Mul for Vector4

fn mul(self, _rhs: Vector4) -> Vector4

Multiply two vectors

Examples

use vex::Vector4;
 
let a = Vector4::make(1.0, 2.0, 3.0, 4.0);
let b = Vector4::make(5.0, 6.0, 7.0, 8.0);
let actual = a * b;
let expected = Vector4::make(5.0, 12.0, 21.0, 32.0);
assert_eq!(actual, expected);

type Output = Vector4

The resulting type after applying the * operator.

impl MulAssign<f32> for Vector4

fn mul_assign(&mut self, _rhs: f32)

Multiply a vector by a scalar

Examples

use vex::Vector4;
 
let mut actual = Vector4::make(1.0, 2.0, 3.0, 4.0);
actual *= 2.0;
let expected = Vector4::make(2.0, 4.0, 6.0, 8.0);
assert_eq!(actual, expected);

impl MulAssign for Vector4

fn mul_assign(&mut self, _rhs: Vector4)

Multiply a vector by another vector

Examples

use vex::Vector4;
 
let mut actual = Vector4::make(1.0, 2.0, 3.0, 4.0);
actual *= Vector4::make(2.0, 3.0, 6.0, 8.0);
let expected = Vector4::make(2.0, 6.0, 18.0, 32.0);
assert_eq!(actual, expected);

impl Neg for Vector4

fn neg(self) -> Vector4

Negates all components in a vector

Examples

use vex::Vector4;
 
let actual = -Vector4::make(1.0, 2.0, 3.0, 4.0);
let expected = Vector4::make(-1.0, -2.0, -3.0, -4.0);
assert_eq!(actual, expected);

type Output = Vector4

The resulting type after applying the - operator.

impl PartialEq for Vector4

fn eq(&self, _rhs: &Vector4) -> bool

Determines if two vectors’ components are equivalent

Examples

use vex::Vector4;
 
assert!(Vector4::new() == Vector4::new());

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<f32> for Vector4

fn sub(self, _rhs: f32) -> Vector4

Find the resulting vector by subtracting a scalar from a vector’s components

Examples

use vex::Vector4;
 
let actual = Vector4::make(1.0, 2.0, 3.0, 4.0) - 10.0;
let expected = Vector4::make(-9.0, -8.0, -7.0, -6.0);
assert_eq!(actual, expected);

type Output = Vector4

The resulting type after applying the - operator.

impl Sub for Vector4

fn sub(self, _rhs: Vector4) -> Vector4

Subtract two vectors

Examples

use vex::Vector4;
 
let a = Vector4::make(1.0, 2.0, 3.0, 4.0);
let b = Vector4::make(5.0, 4.0, 3.0, 2.0);
let actual = a - b;
let expected = Vector4::make(-4.0, -2.0, 0.0, 2.0);
assert_eq!(actual, expected);

type Output = Vector4

The resulting type after applying the - operator.

impl SubAssign<f32> for Vector4

fn sub_assign(&mut self, _rhs: f32)

Decrement a vector by a scalar

Examples

use vex::Vector4;
 
let mut actual = Vector4::make(1.0, 2.0, 3.0, 4.0);
actual -= 1.0;
let expected = Vector4::make(0.0, 1.0, 2.0, 3.0);
assert_eq!(actual, expected);

impl SubAssign for Vector4

fn sub_assign(&mut self, _rhs: Vector4)

Decrement a vector by another vector

Examples

use vex::Vector4;
 
let mut actual = Vector4::make(1.0, 2.0, 3.0, 4.0);
actual -= Vector4::make(1.0, 2.0, 3.0, 4.0);
assert_eq!(actual, Vector4::new());

impl Copy for Vector4