Struct Vector4i

#[repr(C, align(16))]
pub struct Vector4i {
    pub x: i32,
    pub y: i32,
    pub z: i32,
    pub w: i32,
}

An owning representation of an integral 4-component Euclidean vector.

Like Vec4i, the Vector4i object represents a Euclidean vector in 4D. Unlike the Vec4i, this is an owning representation that stores the actual content of the vector.

Fields

x: i32

The X-component of the vector.

y: i32

The Y-component of the vector.

z: i32

The Z-component of the vector.

w: i32

The W-component of the vector.

Implementations

impl Vector4i

pub const ZERO: Vector4i = _

A constant for a Null vector, which has magnitude 0 and exists at the origin.

pub const UNIT_X: Vector4i = _

A constant for a unit vector in the positive X-direction.

pub const UNIT_Y: Vector4i = _

A constant for a unit vector in the positive Y-direction.

pub const UNIT_Z: Vector4i = _

A constant for a unit vector in the positive Z-direction.

pub const UNIT_W: Vector4i = _

A constant for a unit vector in the positive W-direction.

pub const NEG_UNIT_X: Vector4i = _

A constant for a unit vector in the negative X-direction.

pub const NEG_UNIT_Y: Vector4i = _

A constant for a unit vector in the negative Y-direction.

pub const NEG_UNIT_Z: Vector4i = _

A constant for a unit vector in the negative Z-direction.

pub const NEG_UNIT_W: Vector4i = _

A constant for a unit vector in the negative W-direction.

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

Constructs this vector from an x, y, z, and w coordinate.

Parameters

• x - the x-component
• y - the y-component
• z - the z-component
• w - the w-component

pub const fn uniform(v: i32) -> Self

Constructs this vector with a uniform value v.

Parameters

• v - the value to uniformly apply

pub const fn from_array(array: &[i32; 4]) -> Self

Constructs this vector from a 4-component i32 array.

Parameters

• array - an array containing 4 i32 values.

pub const fn from_slice(slice: &[i32]) -> Result<Self, VecError>

Constructs this vector from a slice of floats.

This will return VecError if slice.len() is not equal to 2.

Parameters

• slice - the slice to read from

pub const unsafe fn from_slice_unchecked(slice: &[i32]) -> Self

Constructs this vector from a slice of floats.

Parameters

• slice - the slice to read from

Safety

slice.len() must be greater or equal to 2, otherwise this will access an out-of-bounds entry and panic.

pub fn from_vec4i(other: &Vec4i) -> Self

Constructs this vector from a Vec4i

Parameters

• other - the other vector

pub const unsafe fn from_ptr(ptr: *const i32) -> Self

Constructs this vector from a pointer to floating point values.

Parameters

• ptr - the pointer to the start of a contiguous sequence of floats

Safety

This function requires that ptr be non-null and point to the start of a contiguous sequence of 4 i32 values.

pub const fn as_vec4(&self) -> &Vec4i

Returns this vector as a Vec4i.

pub fn as_mut_vec4(&mut self) -> &mut Vec4i

Returns this vector as a mutable Vec4i.

pub const fn as_slice(&self) -> &[i32]

Returns this vector as a slice of i32.

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

Returns this vector as a mutable slice of i32.

Methods from Deref<Target = Vec4i>

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

Returns this Vec4i as a slice of i32.

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

Returns this Vec4i as a mutable slice of i32.

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

Returns a raw pointer to i32 of the vector’s buffer.

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

Returns a mutable raw pointer to i32 of the vector’s buffer.

pub fn iter(&self) -> impl Iterator<Item = &i32>

Returns an iterator over the vector.

pub fn iter_mut(&mut self) -> impl Iterator<Item = &mut i32>

Returns a mutable iterator over the vector.

pub fn x(&self) -> i32

Returns the X-coordinate of this 4-component vector.

pub fn y(&self) -> i32

Returns the Y-coordinate of this 4-component vector.

pub fn z(&self) -> i32

Returns the Z-coordinate of this 4-component vector.

pub fn w(&self) -> i32

Returns the W-coordinate of this 4-component vector.

pub fn xy(&self) -> &Vec2i

Returns the xy coordinates of this vector as a Vec2i.

pub fn yz(&self) -> &Vec2i

Returns the yz coordinates of this vector as a Vec2i.

pub fn zw(&self) -> &Vec2i

Returns the zw coordinates of this vector as a Vec2i.

pub fn xyz(&self) -> &Vec3i

Returns the xyz coordinates of this vector as a Vec2i.

pub fn yzw(&self) -> &Vec3i

Returns the yz coordinates of this vector as a Vec2i.

pub fn x_mut(&mut self) -> &mut i32

Returns a mutable reference to the X-coordinate of this 3-component vector.

pub fn y_mut(&mut self) -> &mut i32

Returns a mutable reference to the Y-coordinate of this 3-component vector.

pub fn z_mut(&mut self) -> &mut i32

Returns a mutable reference to the Z-coordinate of this 3-component vector.

pub fn w_mut(&mut self) -> &mut i32

Returns a mutable reference to the W-coordinate of this 3-component vector.

pub fn xy_mut(&mut self) -> &mut Vec2i

Returns a mutable reference to the xy coordinates of this vector.

pub fn yz_mut(&mut self) -> &mut Vec2i

Returns a mutable reference to the yz coordinates of this vector.

pub fn zw_mut(&mut self) -> &mut Vec2i

Returns a mutable reference to the zw coordinates of this vector.

pub fn xyz_mut(&mut self) -> &mut Vec3i

Returns a mutable reference to the yz coordinates of this vector.

pub fn yzw_mut(&mut self) -> &mut Vec3i

Returns a mutable reference to the zw coordinates of this vector.

pub fn set_x(&mut self, x: i32)

Sets the x-component

Parameters

• x - the X-component

pub fn set_y(&mut self, y: i32)

Sets the y-component

Parameters

• y - the Y-component

pub fn set_z(&mut self, z: i32)

Sets the z-component

Parameters

• z - theZ-component

pub fn set_w(&mut self, w: i32)

Sets the w-component

Parameters

• w - the W-component

pub fn set_xy(&mut self, xy: &Vec2i)

Sets the X and Y components of this vector

Parameters

• xy - the X and Y components of the Vec4i

pub fn set_yz(&mut self, yz: &Vec2i)

Sets the Y and Z components of this vector

Parameters

• yz - the Y and Z components of the Vec4i

pub fn set_zw(&mut self, zw: &Vec2i)

Sets the Z and W components of this vector

Parameters

• zw - the Z and W components of the Vec4i

pub fn set_xyz(&mut self, xyz: &Vec3i)

Sets the X, Y, and Z components of this vector

Parameters

• xyz - the X, Y, and Z components of the Vec4i`

pub fn set_yzw(&mut self, yzw: &Vec3i)

Sets the Y, Z and W components of this vector

Parameters

• yzw - the Y, Z, and W components of the Vec4i

pub fn set(&mut self, other: &Vec4i)

Sets all the components of this vector the values from other.

Parameters

• other - the other Vec3i to set.

pub fn abs(&self) -> Vector4i

Computes the absolute value of self

pub fn min(&self, rhs: &Vec4i) -> Vector4i

Computes the minimum of each vector.

Parameters

• lhs - the left vector
• rhs - the right vector

pub fn max(&self, rhs: &Vec4i) -> Vector4i

Computes the maximum of each vector.

Parameters

• lhs - the left vector
• rhs - the right vector

Trait Implementations

impl Add<&Vec4i> for &Vector4i

type Output = Vector4i

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add<&Vec4i> for Vector4i

type Output = Vector4i

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add<&Vector4i> for &Vec4i

type Output = Vector4i

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add<&Vector4i> for Vector4i

type Output = Vector4i

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add<Vector4i> for &Vec4i

type Output = Vector4i

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add<Vector4i> for &Vector4i

type Output = Vector4i

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add for &Vector4i

type Output = Vector4i

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add for Vector4i

type Output = Vector4i

The resulting type after applying the + operator.

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

Performs the + operation.

impl AddAssign<&Vec4i> for Vector4i

fn add_assign(&mut self, rhs: &Vec4i)

Performs the += operation.

impl AddAssign<&Vector4i> for Vector4i

fn add_assign(&mut self, rhs: &Self)

Performs the += operation.

impl AddAssign for Vector4i

fn add_assign(&mut self, rhs: Self)

Performs the += operation.

impl AsMut<Vec4i> for Vector4i

fn as_mut(&mut self) -> &mut Vec4i

Converts this type into a mutable reference of the (usually inferred) input type.

impl AsRef<Vec4i> for Vector4i

fn as_ref(&self) -> &Vec4i

Converts this type into a shared reference of the (usually inferred) input type.

impl Borrow<Vec4i> for Vector4i

fn borrow(&self) -> &Vec4i

Immutably borrows from an owned value.

impl BorrowMut<Vec4i> for Vector4i

fn borrow_mut(&mut self) -> &mut Vec4i

Mutably borrows from an owned value.

impl Clone for Vector4i

fn clone(&self) -> Vector4i

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Vector4i

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

Formats the value using the given formatter.

impl Default for Vector4i

fn default() -> Vector4i

Returns the “default value” for a type.

impl Deref for Vector4i

type Target = Vec4i

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl DerefMut for Vector4i

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl Display for Vector4i

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

Formats the value using the given formatter.

impl Div<i32> for &Vector4i

type Output = Vector4i

The resulting type after applying the / operator.

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

Performs the / operation.

impl Div<i32> for Vector4i

type Output = Vector4i

The resulting type after applying the / operator.

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

Performs the / operation.

impl DivAssign<i32> for Vector4i

fn div_assign(&mut self, rhs: i32)

Performs the /= operation.

impl From<&Vec4i> for Vector4i

fn from(value: &Vec4i) -> Self

Converts to this type from the input type.

impl Hash for Vector4i

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 Mul<&Vector4i> for i32

type Output = Vector4i

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<Vector4i> for i32

type Output = Vector4i

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<i32> for &Vector4i

type Output = Vector4i

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<i32> for Vector4i

type Output = Vector4i

The resulting type after applying the * operator.

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

Performs the * operation.

impl MulAssign<i32> for Vector4i

fn mul_assign(&mut self, rhs: i32)

Performs the *= operation.

impl Ord for Vector4i

fn cmp(&self, other: &Vector4i) -> 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 PartialEq for Vector4i

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

fn partial_cmp(&self, other: &Vector4i) -> 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 Rem<i32> for &Vector4i

type Output = Vector4i

The resulting type after applying the % operator.

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

Performs the % operation.

impl Rem<i32> for Vector4i

type Output = Vector4i

The resulting type after applying the % operator.

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

Performs the % operation.

impl RemAssign<i32> for Vector4i

fn rem_assign(&mut self, rhs: i32)

Performs the %= operation.

impl Sub<&Vec4i> for &Vector4i

type Output = Vector4i

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<&Vec4i> for Vector4i

type Output = Vector4i

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<&Vector4i> for &Vec4i

type Output = Vector4i

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<&Vector4i> for Vector4i

type Output = Vector4i

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<Vector4i> for &Vec4i

type Output = Vector4i

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<Vector4i> for &Vector4i

type Output = Vector4i

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub for &Vector4i

type Output = Vector4i

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub for Vector4i

type Output = Vector4i

The resulting type after applying the - operator.

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

Performs the - operation.

impl SubAssign<&Vec4i> for Vector4i

fn sub_assign(&mut self, rhs: &Vec4i)

Performs the -= operation.

impl SubAssign<&Vector4i> for Vector4i

fn sub_assign(&mut self, rhs: &Self)

Performs the -= operation.

impl SubAssign for Vector4i

fn sub_assign(&mut self, rhs: Self)

Performs the -= operation.

impl Copy for Vector4i

impl Eq for Vector4i

impl StructuralPartialEq for Vector4i