Struct Vec3 

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

A 3D vector with FFI-safe memory layout.

This type is guaranteed to have the same memory layout as a C struct with three consecutive f32 fields. Use this type for any 3D positions, directions, or colors that cross FFI boundaries.

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.

Implementations

impl Vec3

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

Creates a new Vec3 from x, y, z components.

pub const fn zero() -> Vec3

Returns the zero vector (0, 0, 0).

pub const fn one() -> Vec3

Returns the one vector (1, 1, 1).

pub const fn unit_x() -> Vec3

Returns the unit X vector (1, 0, 0).

pub const fn unit_y() -> Vec3

Returns the unit Y vector (0, 1, 0).

pub const fn unit_z() -> Vec3

Returns the unit Z vector (0, 0, 1).

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

Computes the dot product of two vectors.

pub fn cross(self, other: Vec3) -> Vec3

Computes the cross product of two vectors.

The result is perpendicular to both input vectors, following the right-hand rule.

pub fn length_squared(self) -> f32

Returns the squared length of the vector.

pub fn length(self) -> f32

Returns the length (magnitude) of the vector.

pub fn normalize(self) -> Vec3

Returns a normalized (unit length) version of this vector.

If the vector has zero length, returns the zero vector.

pub fn lerp(self, other: Vec3, t: f32) -> Vec3

Linearly interpolates between two vectors.

Trait Implementations

impl Add for Vec3

type Output = Vec3

The resulting type after applying the + operator.

fn add(self, other: Vec3) -> Vec3

Performs the + operation.

impl Clone for Vec3

fn clone(&self) -> Vec3

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Vec3

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

Formats the value using the given formatter.

impl Default for Vec3

fn default() -> Vec3

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Vec3

fn deserialize<__D>( __deserializer: __D, ) -> Result<Vec3, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Div<f32> for Vec3

type Output = Vec3

The resulting type after applying the / operator.

fn div(self, scalar: f32) -> Vec3

Performs the / operation.

impl From<Vector3<f32>> for Vec3

fn from(v: Vector3<f32>) -> Vec3

Converts to this type from the input type.

impl Mul<f32> for Vec3

type Output = Vec3

The resulting type after applying the * operator.

fn mul(self, scalar: f32) -> Vec3

Performs the * operation.

impl Neg for Vec3

type Output = Vec3

The resulting type after applying the - operator.

fn neg(self) -> Vec3

Performs the unary - operation.

impl PartialEq for Vec3

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

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Sub for Vec3

type Output = Vec3

The resulting type after applying the - operator.

fn sub(self, other: Vec3) -> Vec3

Performs the - operation.

impl Tweenable for Vec3

fn lerp(self, other: Vec3, t: f32) -> Vec3

Linearly interpolates between self and other.

fn tween(self, other: Self, t: f32, easing: fn(f32) -> f32) -> Self

Interpolates between self and other using an easing function.

impl Copy for Vec3

impl StructuralPartialEq for Vec3