Struct Vector3 

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

A 3D vector with x, y, and z components.

Examples

use rs_math3d::vector::{Vector3, CrossProduct};
 
let v1 = Vector3::new(1.0, 0.0, 0.0);
let v2 = Vector3::new(0.0, 1.0, 0.0);
let cross = Vector3::cross(&v1, &v2);
// Result is (0, 0, 1) - the z-axis

Fields

x: T

X component.

y: T

Y component.

z: T

Z component.

Implementations

impl<T: Scalar> Vector3<T>

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

Creates a vector from components.

Trait Implementations

impl<T> Add for Vector3<T>

where T: Scalar,

type Output = Vector3<T>

The resulting type after applying the + operator.

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

Performs the + operation.

impl<T: Clone> Clone for Vector3<T>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T> CrossProduct for Vector3<T>

where T: Scalar,

fn cross(l: &Vector3<T>, r: &Vector3<T>) -> Vector3<T>

Computes the cross product of two 3D vectors.

The cross product v × w produces a vector perpendicular to both v and w, following the right-hand rule.

Properties

• Anti-commutative: v × w = -(w × v)
• Distributive: v × (w + u) = v × w + v × u
• v × v = 0

impl<T: Debug> Debug for Vector3<T>

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

Formats the value using the given formatter.

impl<T: Default> Default for Vector3<T>

fn default() -> Vector3<T>

Returns the “default value” for a type.

impl<T: FloatScalar> Distance<T, Vector3<T>> for Plane<T>

Distance Queries

fn distance(&self, other: &Vector3<T>) -> Option<T>

Computes the distance to another value, or None if undefined.

impl<T: FloatScalar> Distance<T, Vector3<T>> for Segment<T, Vector3<T>>

fn distance(&self, other: &Vector3<T>) -> Option<T>

Computes the distance to another value, or None if undefined.

impl<T> Div<T> for Vector3<T>

where T: Scalar,

type Output = Vector3<T>

The resulting type after applying the / operator.

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

Performs the / operation.

impl<T> Div for Vector3<T>

where T: Scalar,

type Output = Vector3<T>

The resulting type after applying the / operator.

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

Performs the / operation.

impl<T: FloatScalar> FloatVector<T> for Vector3<T>

fn length(&self) -> T

Computes the Euclidean length (magnitude) of the vector.

fn normalize(&self) -> Self

Returns a unit vector in the same direction.

fn distance(l: &Self, r: &Self) -> T

Computes the Euclidean distance between two vectors.

fn length_squared(&self) -> T

Computes the squared length (avoids a square root).

fn try_normalize(&self, epsilon: T) -> Option<Self>

Returns a normalized vector or None when the length is too small.

fn normalize_or_zero(&self, epsilon: T) -> Self

Returns a normalized vector or the zero vector when too small.

fn normalize_with_inv_len(&self, inv_len: T) -> Self

Normalizes using a precomputed inverse length (e.g., from rsqrt).

fn try_normalize_with_inv_len( &self, len_sq: T, inv_len: T, epsilon: T, ) -> Option<Self>

Normalizes with precomputed length squared and inverse length.

impl<T: Scalar> Mul<Matrix3<T>> for Vector3<T>

type Output = Vector3<T>

The resulting type after applying the * operator.

fn mul(self, rhs: Matrix3<T>) -> Vector3<T>

Performs the * operation.

impl<T: Scalar> Mul<Matrix4<T>> for Vector3<T>

type Output = Vector3<T>

The resulting type after applying the * operator.

fn mul(self, rhs: Matrix4<T>) -> Vector3<T>

Performs the * operation.

impl<T> Mul<T> for Vector3<T>

where T: Scalar,

type Output = Vector3<T>

The resulting type after applying the * operator.

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

Performs the * operation.

impl<T: Scalar> Mul<Vector3<T>> for Matrix3<T>

type Output = Vector3<T>

The resulting type after applying the * operator.

fn mul(self, rhs: Vector3<T>) -> Vector3<T>

Performs the * operation.

impl<T: Scalar> Mul<Vector3<T>> for Matrix4<T>

type Output = Vector3<T>

The resulting type after applying the * operator.

fn mul(self, rhs: Vector3<T>) -> Vector3<T>

Performs the * operation.

impl Mul<Vector3<f32>> for f32

type Output = Vector3<f32>

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<Vector3<f64>> for f64

type Output = Vector3<f64>

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<Vector3<i32>> for i32

type Output = Vector3<i32>

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<Vector3<i64>> for i64

type Output = Vector3<i64>

The resulting type after applying the * operator.

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

Performs the * operation.

impl<T> Mul for Vector3<T>

where T: Scalar,

type Output = Vector3<T>

The resulting type after applying the * operator.

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

Performs the * operation.

impl<T: Scalar> Neg for Vector3<T>

type Output = Vector3<T>

The resulting type after applying the - operator.

fn neg(self) -> Self::Output

Performs the unary - operation.

impl<T> Rem<T> for Vector3<T>

where T: Scalar,

type Output = Vector3<T>

The resulting type after applying the % operator.

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

Performs the % operation.

impl<T> Rem for Vector3<T>

where T: Scalar,

type Output = Vector3<T>

The resulting type after applying the % operator.

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

Performs the % operation.

impl<T> Sub for Vector3<T>

where T: Scalar,

type Output = Vector3<T>

The resulting type after applying the - operator.

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

Performs the - operation.

impl<T: Scalar> Swizzle2<T> for Vector3<T>

fn xx(&self) -> Vector2<T>

Returns a vector with components (x, x).

fn xy(&self) -> Vector2<T>

Returns a vector with components (x, y).

fn xz(&self) -> Vector2<T>

Returns a vector with components (x, z).

fn yx(&self) -> Vector2<T>

Returns a vector with components (y, x).

fn yy(&self) -> Vector2<T>

Returns a vector with components (y, y).

fn yz(&self) -> Vector2<T>

Returns a vector with components (y, z).

fn zx(&self) -> Vector2<T>

Returns a vector with components (z, x).

fn zy(&self) -> Vector2<T>

Returns a vector with components (z, y).

fn zz(&self) -> Vector2<T>

Returns a vector with components (z, z).

impl<T: Scalar> Swizzle3<T> for Vector3<T>

fn xxx(&self) -> Vector3<T>

Returns a vector with components (x, x, x).

fn xxy(&self) -> Vector3<T>

Returns a vector with components (x, x, y).

fn xxz(&self) -> Vector3<T>

Returns a vector with components (x, x, z).

fn xyx(&self) -> Vector3<T>

Returns a vector with components (x, y, x).

fn xyy(&self) -> Vector3<T>

Returns a vector with components (x, y, y).

fn xyz(&self) -> Vector3<T>

Returns a vector with components (x, y, z).

fn xzx(&self) -> Vector3<T>

Returns a vector with components (x, z, x).

fn xzy(&self) -> Vector3<T>

Returns a vector with components (x, z, y).

fn xzz(&self) -> Vector3<T>

Returns a vector with components (x, z, z).

fn yxx(&self) -> Vector3<T>

Returns a vector with components (y, x, x).

fn yxy(&self) -> Vector3<T>

Returns a vector with components (y, x, y).

fn yxz(&self) -> Vector3<T>

Returns a vector with components (y, x, z).

fn yyx(&self) -> Vector3<T>

Returns a vector with components (y, y, x).

fn yyy(&self) -> Vector3<T>

Returns a vector with components (y, y, y).

fn yyz(&self) -> Vector3<T>

Returns a vector with components (y, y, z).

fn yzx(&self) -> Vector3<T>

Returns a vector with components (y, z, x).

fn yzy(&self) -> Vector3<T>

Returns a vector with components (y, z, y).

fn yzz(&self) -> Vector3<T>

Returns a vector with components (y, z, z).

fn zxx(&self) -> Vector3<T>

Returns a vector with components (z, x, x).

fn zxy(&self) -> Vector3<T>

Returns a vector with components (z, x, y).

fn zxz(&self) -> Vector3<T>

Returns a vector with components (z, x, z).

fn zyx(&self) -> Vector3<T>

Returns a vector with components (z, y, x).

fn zyy(&self) -> Vector3<T>

Returns a vector with components (z, y, y).

fn zyz(&self) -> Vector3<T>

Returns a vector with components (z, y, z).

fn zzx(&self) -> Vector3<T>

Returns a vector with components (z, z, x).

fn zzy(&self) -> Vector3<T>

Returns a vector with components (z, z, y).

fn zzz(&self) -> Vector3<T>

Returns a vector with components (z, z, z).

impl<T: Scalar> Vector<T> for Vector3<T>

fn zero() -> Self

Returns the zero vector (all components are zero).

fn dot(l: &Self, r: &Self) -> T

Computes the dot product of two vectors.

fn add_vv(l: &Self, r: &Self) -> Self

Adds two vectors component-wise.

fn sub_vv(l: &Self, r: &Self) -> Self

Subtracts two vectors component-wise.

fn mul_vv(l: &Self, r: &Self) -> Self

Multiplies two vectors component-wise (Hadamard product).

fn div_vv(l: &Self, r: &Self) -> Self

Divides two vectors component-wise.

fn mul_vs(l: &Self, r: T) -> Self

Multiplies a vector by a scalar.

fn div_vs(l: &Self, r: T) -> Self

Divides a vector by a scalar.

fn rem_vv(l: &Self, r: &Self) -> Self

Computes the remainder of component-wise division.

fn min(l: &Self, r: &Self) -> Self

Returns a vector with the minimum components from both vectors.

fn max(l: &Self, r: &Self) -> Self

Returns a vector with the maximum components from both vectors.

impl<T: Copy> Copy for Vector3<T>