Struct XYZ 

pub struct XYZ<T>(/* private fields */);

Internal shared storage for 3D Cartesian coordinates.

This is a thin wrapper around nalgebra::Vector3<T> that provides centralized implementations of component-wise operations.

Type Parameter

• T: The component type (e.g., f64, Quantity<U>)

Implementations

impl<T> XYZ<T>

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

Creates a new XYZ from individual components.

pub const fn from_vec3(vec: Vector3<T>) -> Self

Creates an XYZ from a nalgebra Vector3.

pub const fn as_vec3(&self) -> &Vector3<T>

Returns the underlying nalgebra Vector3.

pub fn into_vec3(self) -> Vector3<T>

Consumes self and returns the underlying Vector3.

impl<T: Copy> XYZ<T>

pub fn x(&self) -> T

Returns the x-component.

pub fn y(&self) -> T

Returns the y-component.

pub fn z(&self) -> T

Returns the z-component.

pub fn components(&self) -> (T, T, T)

Returns components as a tuple.

impl XYZ<f64>

pub const ZERO: Self

The zero vector.

pub fn magnitude(&self) -> f64

Computes the Euclidean magnitude (length) of the vector.

pub fn magnitude_squared(&self) -> f64

Computes the squared magnitude (avoids sqrt).

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

Computes the dot product with another vector.

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

Computes the cross product with another vector.

pub fn try_normalize(&self) -> Option<Self>

Returns a normalized (unit length) version, or None if magnitude is zero.

pub fn normalize_unchecked(&self) -> Self

Returns a normalized version, assuming non-zero magnitude.

Safety

Caller must ensure the vector is non-zero.

pub fn scale(&self, factor: f64) -> Self

Scales the vector by a scalar factor.

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

Component-wise addition.

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

Component-wise subtraction.

pub fn neg(&self) -> Self

Negates all components.

impl<U: Unit> XYZ<Quantity<U>>

pub const ZERO: Self

The zero vector for this unit type.

pub fn magnitude(&self) -> Quantity<U>

Computes the Euclidean magnitude in the same unit.

pub fn magnitude_squared(&self) -> f64

Computes the squared magnitude.

pub fn to_raw(&self) -> XYZ<f64>

Extracts raw f64 values as an XYZ.

pub fn from_raw(raw: XYZ<f64>) -> Self

Creates from raw f64 values.

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

Component-wise addition.

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

Component-wise subtraction.

Trait Implementations

impl<U: Unit> Add for XYZ<Quantity<U>>

type Output = XYZ<Quantity<U>>

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add for XYZ<f64>

type Output = XYZ<f64>

The resulting type after applying the + operator.

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

Performs the + operation.

impl<T: Clone> Clone for XYZ<T>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for XYZ<T>

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

Formats the value using the given formatter.

impl<T: Default> Default for XYZ<T>

fn default() -> Self

Returns the “default value” for a type.

impl<T: Display + Copy> Display for XYZ<T>

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

Formats the value using the given formatter.

impl<T: LowerExp + Copy> LowerExp for XYZ<T>

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

Formats the value using the given formatter.

impl<U: Unit> Mul<XYZ<Quantity<U>>> for Isometry3

type Output = XYZ<Quantity<U>>

The resulting type after applying the * operator.

fn mul(self, rhs: XYZ<Quantity<U>>) -> XYZ<Quantity<U>>

Performs the * operation.

impl<U: Unit> Mul<XYZ<Quantity<U>>> for Rotation3

type Output = XYZ<Quantity<U>>

The resulting type after applying the * operator.

fn mul(self, rhs: XYZ<Quantity<U>>) -> XYZ<Quantity<U>>

Performs the * operation.

impl<U: Unit> Mul<XYZ<Quantity<U>>> for Translation3

type Output = XYZ<Quantity<U>>

The resulting type after applying the * operator.

fn mul(self, rhs: XYZ<Quantity<U>>) -> XYZ<Quantity<U>>

Performs the * operation.

impl Mul<XYZ<f64>> for f64

type Output = XYZ<f64>

The resulting type after applying the * operator.

fn mul(self, xyz: XYZ<f64>) -> Self::Output

Performs the * operation.

impl Mul<f64> for XYZ<f64>

type Output = XYZ<f64>

The resulting type after applying the * operator.

fn mul(self, scalar: f64) -> Self::Output

Performs the * operation.

impl<U: Unit> Neg for XYZ<Quantity<U>>

type Output = XYZ<Quantity<U>>

The resulting type after applying the - operator.

fn neg(self) -> Self::Output

Performs the unary - operation.

impl Neg for XYZ<f64>

type Output = XYZ<f64>

The resulting type after applying the - operator.

fn neg(self) -> Self::Output

Performs the unary - operation.

impl<T: PartialEq> PartialEq for XYZ<T>

fn eq(&self, other: &XYZ<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<U: Unit> Sub for XYZ<Quantity<U>>

type Output = XYZ<Quantity<U>>

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub for XYZ<f64>

type Output = XYZ<f64>

The resulting type after applying the - operator.

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

Performs the - operation.

impl<T: UpperExp + Copy> UpperExp for XYZ<T>

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

Formats the value using the given formatter.

impl<T: Copy> Copy for XYZ<T>

impl<T> StructuralPartialEq for XYZ<T>