Struct Vec4 

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

A 4-dimensional vector.

Fields

x: T

y: T

z: T

w: T

Implementations

impl<T> Vec4<T>

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

Create a new vector.

pub fn map<U, F: FnMut(T) -> U>(self, f: F) -> Vec4<U>

Map the components of this vector.

pub fn splat(value: T) -> Self

where T: Copy,

Create a new vector with all components set to value.

pub fn abs(self) -> Self

where T: Signed,

Returns a copy of this vector with absolute value of all components.

pub fn signum(self) -> Self

where T: Signed,

Returns a copy of this vector with signed value of all components.

pub fn is_zero(self) -> bool

where T: Num,

Returns true if all components are set to zero.

pub fn min(self, rhs: Self) -> Self

where T: Num,

Returns a new value where each component is set to the smallest value of each of the supplied vector’s corresponding components.

pub fn max(self, rhs: Self) -> Self

where T: Num,

Returns a new value where each component is set to the greatest value of each of the supplied vector’s corresponding components.

pub fn clamp(self, min: Self, max: Self) -> Self

where T: Num,

Clamps the vector’s components within the provided bounds.

pub fn round(self) -> Self

where T: Float,

Rounds the components of this vector.

pub fn floor(self) -> Self

where T: Float,

Rounds down the components of this vector.

pub fn ceil(self) -> Self

where T: Float,

Rounds up the components of this vector.

pub fn trunc(self) -> Self

where T: Float,

Truncates the components of this vector. This means that non-integer numbers are always truncated towards zero.

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

where T: Num,

The dot product of this vector and another.

pub fn sqr_len(self) -> T

where T: Num,

The squared length of this vector.

pub fn sqr_dist(self, other: Self) -> T

where T: Num,

The square distance between this vector and another.

pub fn reflect(self, normal: Self) -> Self

where T: Num,

Reflects this vector off the provided normal.

pub fn len(&self) -> T

where T: Float,

The length of this vector.

pub fn dist(self, other: Self) -> T

where T: Float,

The distance between this vector and another.

pub fn norm(self) -> Self

where T: Float,

Returns a normalized version of this vector.

pub fn norm_safe(self) -> Self

where T: Float,

Returns a normalized version of this vector, or a zeroed vector if the vector cannot be normalized.

pub fn len_to(self, new_len: T) -> Self

where T: Float,

Returns a copy of this vector resized to be the provided length.

pub fn len_to_safe(self, new_len: T) -> Self

where T: Float,

Returns a copy of this vector resized to be the provided length, or a zeroed vector if the original could not be normalized.

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

where T: Float,

Returns the normalized direction towards the other point.

impl<T: Num> Vec4<T>

pub const ZERO: Self

pub const ONE: Self

pub const MIN: Self

pub const MAX: Self

impl<T: Copy + AbsDiffEq<Epsilon = T>> Vec4<T>

pub fn abs_diff_eq(&self, other: &Self) -> bool

Returns true if the two values are approximately equal according to the absolute difference between their components.

impl<T: Copy + RelativeEq<Epsilon = T>> Vec4<T>

pub fn relative_eq(&self, other: &Self) -> bool

Returns true if the two values are approximately equal according to the absolute difference between their components, as well as relative-based comparisons.

impl<T: Copy + UlpsEq<Epsilon = T>> Vec4<T>

pub fn ulps_eq(&self, other: &Self) -> bool

Returns true if the two values are approximately equal according to the absolute difference between their components, as well as ULPs (Units in Last Place).

impl<T: Pod + NoUninit> Vec4<T>

pub fn as_bytes(&self) -> &[u8]

This type re-interpreted as a slice of bytes.

pub fn as_bytes_mut(&mut self) -> &mut [u8]

This type re-interpreted as a mutable slice of bytes.

impl<T> Vec4<T>

pub fn with_x(self, x: T) -> Self

Return the vector with the x-value replaced.

pub fn with_y(self, y: T) -> Self

Return the vector with the y-value replaced.

pub fn with_z(self, z: T) -> Self

Return the vector with the z-value replaced.

pub fn with_w(self, w: T) -> Self

Return the vector with the w-value replaced.

impl<T: Copy> Vec4<T>

pub const fn xy(self) -> Vec2<T>

Reduce to a 2D vector by dropping z and w.

pub const fn xyz(self) -> Vec3<T>

Reduce to a 3D vector by dropping w.

pub fn yxzw(self) -> Self

Swizzle components.

pub fn zxyw(self) -> Self

Swizzle components.

pub fn wxzy(self) -> Self

Swizzle components.

pub fn yxwz(self) -> Self

Swizzle components.

pub fn yzxw(self) -> Self

Swizzle components.

pub fn zyxw(self) -> Self

Swizzle components.

pub fn wzxy(self) -> Self

Swizzle components.

pub fn yzwx(self) -> Self

Swizzle components.

pub fn zywx(self) -> Self

Swizzle components.

pub fn wzyx(self) -> Self

Swizzle components.

pub fn ywzx(self) -> Self

Swizzle components.

impl<T: Num> Vec4<T>

pub const X_AXIS: Self

A unit vector representing the x-axis, equal to (1, 0, 0, 0).

pub const Y_AXIS: Self

A unit vector representing the y-axis, equal to (0, 1, 0, 0).

pub const Z_AXIS: Self

A unit vector representing the z-axis, equal to (0, 0, 1, 0).

pub const W_AXIS: Self

A unit vector representing the w-axis, equal to (0, 0, 0, 1).

Trait Implementations

impl<T> AbsDiffEq for Vec4<T>

where T: AbsDiffEq, T::Epsilon: Copy,

type Epsilon = <T as AbsDiffEq>::Epsilon

Used for specifying relative comparisons.

fn default_epsilon() -> Self::Epsilon

The default tolerance to use when testing values that are close together.

fn abs_diff_eq(&self, other: &Self, epsilon: Self::Epsilon) -> bool

A test for equality that uses the absolute difference to compute the approximate equality of two numbers.

fn abs_diff_ne(&self, other: &Rhs, epsilon: Self::Epsilon) -> bool

The inverse of AbsDiffEq::abs_diff_eq.

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

type Output = Vec4<T>

The resulting type after applying the + operator.

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

Performs the + operation.

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

type Output = Vec4<T>

The resulting type after applying the + operator.

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

Performs the + operation.

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

type Output = Vec4<T>

The resulting type after applying the + operator.

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

Performs the + operation.

impl<T: Add<T, Output = T>> Add for Vec4<T>

type Output = Vec4<T>

The resulting type after applying the + operator.

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

Performs the + operation.

impl<T: Copy + AddAssign<T>> AddAssign<&Vec4<T>> for Vec4<T>

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

Performs the += operation.

impl<T: AddAssign<T>> AddAssign for Vec4<T>

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

Performs the += operation.

impl<T: Float> Approach for Vec4<T>

type Factor = T

The distance factor by which this type can approach its target.

fn approach(self, target: Self, amount: Self::Factor) -> Self

Approach the target by the provided amount without overshooting.

impl<T: Clone> Clone for Vec4<T>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for Vec4<T>

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

Formats the value using the given formatter.

impl<'de, T: Deserialize<'de>> Deserialize<'de> for Vec4<T>

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T: Display> Display for Vec4<T>

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

Formats the value using the given formatter.

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

type Output = Vec4<T>

The resulting type after applying the / operator.

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

Performs the / operation.

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

type Output = Vec4<T>

The resulting type after applying the / operator.

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

Performs the / operation.

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

type Output = Vec4<T>

The resulting type after applying the / operator.

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

Performs the / operation.

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

type Output = Vec4<T>

The resulting type after applying the / operator.

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

Performs the / operation.

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

type Output = Vec4<T>

The resulting type after applying the / operator.

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

Performs the / operation.

impl<T: Div<T, Output = T>> Div for Vec4<T>

type Output = Vec4<T>

The resulting type after applying the / operator.

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

Performs the / operation.

impl<T: Copy + DivAssign<T>> DivAssign<&T> for Vec4<T>

fn div_assign(&mut self, rhs: &T)

Performs the /= operation.

impl<T: Copy + DivAssign<T>> DivAssign<&Vec4<T>> for Vec4<T>

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

Performs the /= operation.

impl<T: Copy + DivAssign<T>> DivAssign<T> for Vec4<T>

fn div_assign(&mut self, rhs: T)

Performs the /= operation.

impl<T: DivAssign<T>> DivAssign for Vec4<T>

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

Performs the /= operation.

impl<T> From<[T; 4]> for Vec4<T>

fn from([x, y, z, w]: [T; 4]) -> Self

Converts to this type from the input type.

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

fn from((x, y, z, w): (T, T, T, T)) -> Self

Converts to this type from the input type.

impl<T: Num> From<Vec2<T>> for Vec4<T>

fn from(_: Vec2<T>) -> Self

Converts to this type from the input type.

impl<T: Num> From<Vec3<T>> for Vec4<T>

fn from(_: Vec3<T>) -> Self

Converts to this type from the input type.

impl<T> From<Vec4<T>> for [T; 4]

fn from(_: Vec4<T>) -> [T; 4]

Converts to this type from the input type.

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

fn from(_: Vec4<T>) -> (T, T, T, T)

Converts to this type from the input type.

impl<T: Hash> Hash for Vec4<T>

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

Feeds this value into the given Hasher.

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

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<T: Float + Interp<Factor = T>> Interp for Vec4<T>

type Factor = T

The factor by which this type is interpolated.

fn lerp(self, target: Self, t: Self::Factor) -> Self

Linear interpolation.

fn quad_bezier(self, control: Self, target: Self, t: Self::Factor) -> Self

Quadratic bezier interpolation.

fn cubic_bezier( self, control1: Self, control2: Self, target: Self, t: Self::Factor, ) -> Self

Cubic bezier interpolation.

fn hermite( self, tangent1: Self::Factor, target: Self, tangent2: Self::Factor, t: Self::Factor, ) -> Self

Cubic Hermite interpolation.

fn catmull_rom( self, control1: Self, control2: Self, target: Self, t: Self::Factor, ) -> Self

Catmull-Rom interpolation.

fn smooth_step(self, target: Self, t: Self::Factor) -> Self

Smooth-step interpolation.

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

type Output = Vec4<T>

The resulting type after applying the * operator.

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

Performs the * operation.

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

type Output = Vec4<T>

The resulting type after applying the * operator.

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

Performs the * operation.

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

type Output = Vec4<T>

The resulting type after applying the * operator.

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

Performs the * operation.

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

type Output = Vec4<T>

The resulting type after applying the * operator.

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

Performs the * operation.

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

type Output = Vec4<T>

The resulting type after applying the * operator.

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

Performs the * operation.

impl<T: Mul<T, Output = T>> Mul for Vec4<T>

type Output = Vec4<T>

The resulting type after applying the * operator.

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

Performs the * operation.

impl<T: Copy + MulAssign<T>> MulAssign<&T> for Vec4<T>

fn mul_assign(&mut self, rhs: &T)

Performs the *= operation.

impl<T: Copy + MulAssign<T>> MulAssign<&Vec4<T>> for Vec4<T>

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

Performs the *= operation.

impl<T: Copy + MulAssign<T>> MulAssign<T> for Vec4<T>

fn mul_assign(&mut self, rhs: T)

Performs the *= operation.

impl<T: MulAssign<T>> MulAssign for Vec4<T>

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

Performs the *= operation.

impl<T: Neg<Output = T>> Neg for Vec4<T>

type Output = Vec4<T>

The resulting type after applying the - operator.

fn neg(self) -> Self::Output

Performs the unary - operation.

impl<T: Numeric<AsU8 = u8, AsU16 = u16, AsU32 = u32, AsU64 = u64, AsU128 = u128, AsUSize = usize, AsI8 = i8, AsI16 = i16, AsI32 = i32, AsI64 = i64, AsI128 = i128, AsISize = isize, AsF32 = f32, AsF64 = f64>> Numeric for Vec4<T>

type AsU8 = Vec4<u8>

type AsU16 = Vec4<u16>

type AsU32 = Vec4<u32>

type AsU64 = Vec4<u64>

type AsU128 = Vec4<u128>

type AsUSize = Vec4<usize>

type AsI8 = Vec4<i8>

type AsI16 = Vec4<i16>

type AsI32 = Vec4<i32>

type AsI64 = Vec4<i64>

type AsI128 = Vec4<i128>

type AsISize = Vec4<isize>

type AsF32 = Vec4<f32>

type AsF64 = Vec4<f64>

fn to_u8(self) -> Vec4<u8>

fn to_u16(self) -> Vec4<u16>

fn to_u32(self) -> Vec4<u32>

fn to_u64(self) -> Vec4<u64>

fn to_u128(self) -> Vec4<u128>

fn to_usize(self) -> Vec4<usize>

fn to_i8(self) -> Vec4<i8>

fn to_i16(self) -> Vec4<i16>

fn to_i32(self) -> Vec4<i32>

fn to_i64(self) -> Vec4<i64>

fn to_i128(self) -> Vec4<i128>

fn to_isize(self) -> Vec4<isize>

fn to_f32(self) -> Vec4<f32>

fn to_f64(self) -> Vec4<f64>

impl<T: Ord> Ord for Vec4<T>

fn cmp(&self, other: &Vec4<T>) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl<T: PartialEq> PartialEq for Vec4<T>

fn eq(&self, other: &Vec4<T>) -> 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<T: PartialOrd> PartialOrd for Vec4<T>

fn partial_cmp(&self, other: &Vec4<T>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<T> RelativeEq for Vec4<T>

where T: RelativeEq, T::Epsilon: Copy,

fn default_max_relative() -> Self::Epsilon

The default relative tolerance for testing values that are far-apart.

fn relative_eq( &self, other: &Self, epsilon: Self::Epsilon, max_relative: Self::Epsilon, ) -> bool

A test for equality that uses a relative comparison if the values are far apart.

fn relative_ne( &self, other: &Rhs, epsilon: Self::Epsilon, max_relative: Self::Epsilon, ) -> bool

The inverse of RelativeEq::relative_eq.

impl<T: Copy + Rem<T, Output = T>> Rem<&Vec4<T>> for &Vec4<T>

type Output = Vec4<T>

The resulting type after applying the % operator.

fn rem(self, rhs: &Vec4<T>) -> Self::Output

Performs the % operation.

impl<T: Copy + Rem<T, Output = T>> Rem<&Vec4<T>> for Vec4<T>

type Output = Vec4<T>

The resulting type after applying the % operator.

fn rem(self, rhs: &Vec4<T>) -> Self::Output

Performs the % operation.

impl<T: Copy + Rem<T, Output = T>> Rem<T> for &Vec4<T>

type Output = Vec4<T>

The resulting type after applying the % operator.

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

Performs the % operation.

impl<T: Copy + Rem<T, Output = T>> Rem<T> for Vec4<T>

type Output = Vec4<T>

The resulting type after applying the % operator.

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

Performs the % operation.

impl<T: Copy + Rem<T, Output = T>> Rem<Vec4<T>> for &Vec4<T>

type Output = Vec4<T>

The resulting type after applying the % operator.

fn rem(self, rhs: Vec4<T>) -> Self::Output

Performs the % operation.

impl<T: Rem<T, Output = T>> Rem for Vec4<T>

type Output = Vec4<T>

The resulting type after applying the % operator.

fn rem(self, rhs: Vec4<T>) -> Self::Output

Performs the % operation.

impl<T: Copy + RemAssign<T>> RemAssign<&T> for Vec4<T>

fn rem_assign(&mut self, rhs: &T)

Performs the %= operation.

impl<T: Copy + RemAssign<T>> RemAssign<&Vec4<T>> for Vec4<T>

fn rem_assign(&mut self, rhs: &Vec4<T>)

Performs the %= operation.

impl<T: Copy + RemAssign<T>> RemAssign<T> for Vec4<T>

fn rem_assign(&mut self, rhs: T)

Performs the %= operation.

impl<T: RemAssign<T>> RemAssign for Vec4<T>

fn rem_assign(&mut self, rhs: Vec4<T>)

Performs the %= operation.

impl<T: Serialize> Serialize for Vec4<T>

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl<T: Float + SmoothInterp<Factor = T>> SmoothInterp for Vec4<T>

fn smooth_damp( &mut self, velocity: &mut Self, target: Self, smooth_time: Self::Factor, max_speed: Self::Factor, delta_time: Self::Factor, )

Accelerate towards a target with stateful velocity.

fn smooth_lerp(self, target: Self, t: Self::Factor, dt: Self::Factor) -> Self

Lerp towards a target with a framerate-invariant version.

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

type Output = Vec4<T>

The resulting type after applying the - operator.

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

Performs the - operation.

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

type Output = Vec4<T>

The resulting type after applying the - operator.

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

Performs the - operation.

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

type Output = Vec4<T>

The resulting type after applying the - operator.

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

Performs the - operation.

impl<T: Sub<T, Output = T>> Sub for Vec4<T>

type Output = Vec4<T>

The resulting type after applying the - operator.

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

Performs the - operation.

impl<T: Copy + SubAssign<T>> SubAssign<&Vec4<T>> for Vec4<T>

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

Performs the -= operation.

impl<T: SubAssign<T>> SubAssign for Vec4<T>

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

Performs the -= operation.

impl<T> UlpsEq for Vec4<T>

where T: UlpsEq, T::Epsilon: Copy,

fn default_max_ulps() -> u32

The default ULPs to tolerate when testing values that are far-apart.

fn ulps_eq(&self, other: &Self, epsilon: Self::Epsilon, max_ulps: u32) -> bool

A test for equality that uses units in the last place (ULP) if the values are far apart.

fn ulps_ne(&self, other: &Rhs, epsilon: Self::Epsilon, max_ulps: u32) -> bool

The inverse of UlpsEq::ulps_eq.

impl<T: Zeroable> Zeroable for Vec4<T>

fn zeroed() -> Self

Calls zeroed.

impl<T: Copy> Copy for Vec4<T>

impl<T: Eq> Eq for Vec4<T>

impl<T: Pod> Pod for Vec4<T>

impl<T> StructuralPartialEq for Vec4<T>