Struct Vec4

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

A 4-dimensional vector with f32 components, often used for homogeneous coordinates.

In 3D graphics, Vec4 is primarily used to represent points (w=1.0) and vectors (w=0.0) in homogeneous space, allowing them to be transformed by a Mat4.

Fields

x: f32

The x component of the vector.

y: f32

The y component of the vector.

z: f32

The z component of the vector.

w: f32

The w component, used for homogeneous coordinates.

Implementations

impl Vec4

pub const ZERO: Self

A vector with all components set to 0.0.

pub const ONE: Self

A vector with all components set to 1.0.

pub const X: Self

The unit vector pointing along the positive X-axis.

pub const Y: Self

The unit vector pointing along the positive Y-axis.

pub const Z: Self

The unit vector pointing along the positive Z-axis.

pub const W: Self

The unit vector pointing along the positive W-axis.

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

Creates a new Vec4 with the specified components.

pub const fn abs(self) -> Self

Returns a new vector with the absolute value of each component.

pub fn from_vec3(v: Vec3, w: f32) -> Self

Creates a Vec4 from a Vec3 and a w component.

pub fn truncate(&self) -> Vec3

Returns the [x, y, z] components of the vector as a Vec3, discarding w.

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

Calculates the dot product of this vector and another.

pub fn get(&self, index: usize) -> f32

Retrieves a component of the vector by its index.

Panics

Panics if index is not between 0 and 3.

Trait Implementations

impl Add for Vec4

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

Adds two vectors component-wise.

type Output = Vec4

The resulting type after applying the + operator.

impl Clone for Vec4

fn clone(&self) -> Vec4

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Vec4

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

Formats the value using the given formatter.

impl Default for Vec4

fn default() -> Vec4

Returns the “default value” for a type.

impl Div<f32> for Vec4

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

Divides the vector by a scalar.

type Output = Vec4

The resulting type after applying the / operator.

impl Index<usize> for Vec4

fn index(&self, index: usize) -> &Self::Output

Allows accessing a vector component by index.

Panics

Panics if index is not between 0 and 3.

type Output = f32

The returned type after indexing.

impl IndexMut<usize> for Vec4

fn index_mut(&mut self, index: usize) -> &mut Self::Output

Allows mutably accessing a vector component by index.

Panics

Panics if index is not between 0 and 3.

impl Mul<Vec4> for Mat4

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

Transforms a Vec4 by this matrix.

type Output = Vec4

The resulting type after applying the * operator.

impl Mul<Vec4> for f32

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

Multiplies a scalar by a vector.

type Output = Vec4

The resulting type after applying the * operator.

impl Mul<f32> for Vec4

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

Multiplies the vector by a scalar.

type Output = Vec4

The resulting type after applying the * operator.

impl Mul for Vec4

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

Multiplies two vectors component-wise.

type Output = Vec4

The resulting type after applying the * operator.

impl Neg for Vec4

fn neg(self) -> Self::Output

Negates the vector.

type Output = Vec4

The resulting type after applying the - operator.

impl PartialEq for Vec4

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

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

Subtracts two vectors component-wise.

type Output = Vec4

The resulting type after applying the - operator.

impl Copy for Vec4

impl StructuralPartialEq for Vec4