Struct nalgebra::Vector3

pub struct Vector3<N> {
    pub x: N,
    pub y: N,
    pub z: N,
}

Vector of dimension 3.

The main differance between a point and a vector is that a vector is not affected by translations.

Fields

x: N

First component of the vector.

y: N

Second component of the vector.

z: N

Third component of the vector.

Methods

impl<N: Zero + One> Vector3<N>

fn x() -> Vector3<N>

Create the element of the canonical basis having this component set to one and all the others set to zero.

fn y() -> Vector3<N>

Create the element of the canonical basis having this component set to one and all the others set to zero.

fn z() -> Vector3<N>

Create the element of the canonical basis having this component set to one and all the others set to zero.

impl<N> Vector3<N>

fn to_point(self) -> Point3<N>

Converts this vector to a point.

fn as_point(&self) -> &Point3<N>

Reinterprets this vector as a point.

impl<N> Vector3<N>

fn new(x: N, y: N, z: N) -> Vector3<N>

Creation from component values.

impl<N: Copy> Vector3<N>

unsafe fn at_fast(&self, i: usize) -> N

Unsafe read access to a vector element by index.

unsafe fn set_fast(&mut self, i: usize, val: N)

Unsafe write access to a vector element by index.

impl<N> Vector3<N>

fn len(&self) -> usize

The dimension of this entity.

Trait Implementations

impl<N: Copy> Copy for Vector3<N>

impl<N: Debug> Debug for Vector3<N>

fn fmt(&self, __arg_0: &mut Formatter) -> Result

Formats the value using the given formatter.

impl<N: Hash> Hash for Vector3<N>

fn hash<__HN: Hasher>(&self, __arg_0: &mut __HN)

Feeds this value into the state given, updating the hasher as necessary.

fn hash_slice<H>(data: &[Self], state: &mut H) where H: Hasher

Feeds a slice of this type into the state provided.

impl<N: Clone> Clone for Vector3<N>

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<N: Decodable> Decodable for Vector3<N>

fn decode<__DN: Decoder>(__arg_0: &mut __DN) -> Result<Vector3<N>, __DN::Error>

impl<N: Encodable> Encodable for Vector3<N>

fn encode<__SN: Encoder>(&self, __arg_0: &mut __SN) -> Result<(), __SN::Error>

impl<N: PartialEq> PartialEq for Vector3<N>

fn eq(&self, __arg_0: &Vector3<N>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, __arg_0: &Vector3<N>) -> bool

This method tests for !=.

impl<N: Eq> Eq for Vector3<N>

impl<N: Add<N, Output=N>> Add<Vector3<N>> for Vector3<N>

type Output = Vector3<N>

The resulting type after applying the + operator

fn add(self, right: Vector3<N>) -> Vector3<N>

The method for the + operator

impl<N: AddAssign<N>> AddAssign<Vector3<N>> for Vector3<N>

fn add_assign(&mut self, right: Vector3<N>)

The method for the += operator

impl<'a, 'b, N> Add<&'a Vector3<N>> for &'b Vector3<N> where &'b N: Add<&'a N, Output=N>

type Output = Vector3<N>

The resulting type after applying the + operator

fn add(self, right: &'a Vector3<N>) -> Vector3<N>

The method for the + operator

impl<'a, N> Add<&'a Vector3<N>> for Vector3<N> where N: Add<&'a N, Output=N>

type Output = Vector3<N>

The resulting type after applying the + operator

fn add(self, right: &'a Vector3<N>) -> Vector3<N>

The method for the + operator

impl<'a, N> Add<Vector3<N>> for &'a Vector3<N> where &'a N: Add<N, Output=N>

type Output = Vector3<N>

The resulting type after applying the + operator

fn add(self, right: Vector3<N>) -> Vector3<N>

The method for the + operator

impl<N: Sub<N, Output=N>> Sub<Vector3<N>> for Vector3<N>

type Output = Vector3<N>

The resulting type after applying the - operator

fn sub(self, right: Vector3<N>) -> Vector3<N>

The method for the - operator

impl<N: SubAssign<N>> SubAssign<Vector3<N>> for Vector3<N>

fn sub_assign(&mut self, right: Vector3<N>)

The method for the -= operator

impl<'a, 'b, N> Sub<&'a Vector3<N>> for &'b Vector3<N> where &'b N: Sub<&'a N, Output=N>

type Output = Vector3<N>

The resulting type after applying the - operator

fn sub(self, right: &'a Vector3<N>) -> Vector3<N>

The method for the - operator

impl<'a, N> Sub<&'a Vector3<N>> for Vector3<N> where N: Sub<&'a N, Output=N>

type Output = Vector3<N>

The resulting type after applying the - operator

fn sub(self, right: &'a Vector3<N>) -> Vector3<N>

The method for the - operator

impl<'a, N> Sub<Vector3<N>> for &'a Vector3<N> where &'a N: Sub<N, Output=N>

type Output = Vector3<N>

The resulting type after applying the - operator

fn sub(self, right: Vector3<N>) -> Vector3<N>

The method for the - operator

impl<N: Mul<N, Output=N>> Mul<Vector3<N>> for Vector3<N>

type Output = Vector3<N>

The resulting type after applying the * operator

fn mul(self, right: Vector3<N>) -> Vector3<N>

The method for the * operator

impl<N: MulAssign<N>> MulAssign<Vector3<N>> for Vector3<N>

fn mul_assign(&mut self, right: Vector3<N>)

The method for the *= operator

impl<'a, 'b, N> Mul<&'a Vector3<N>> for &'b Vector3<N> where &'b N: Mul<&'a N, Output=N>

type Output = Vector3<N>

The resulting type after applying the * operator

fn mul(self, right: &'a Vector3<N>) -> Vector3<N>

The method for the * operator

impl<'a, N> Mul<&'a Vector3<N>> for Vector3<N> where N: Mul<&'a N, Output=N>

type Output = Vector3<N>

The resulting type after applying the * operator

fn mul(self, right: &'a Vector3<N>) -> Vector3<N>

The method for the * operator

impl<'a, N> Mul<Vector3<N>> for &'a Vector3<N> where &'a N: Mul<N, Output=N>

type Output = Vector3<N>

The resulting type after applying the * operator

fn mul(self, right: Vector3<N>) -> Vector3<N>

The method for the * operator

impl<N: Div<N, Output=N>> Div<Vector3<N>> for Vector3<N>

type Output = Vector3<N>

The resulting type after applying the / operator

fn div(self, right: Vector3<N>) -> Vector3<N>

The method for the / operator

impl<N: DivAssign<N>> DivAssign<Vector3<N>> for Vector3<N>

fn div_assign(&mut self, right: Vector3<N>)

The method for the /= operator

impl<'a, 'b, N> Div<&'a Vector3<N>> for &'b Vector3<N> where &'b N: Div<&'a N, Output=N>

type Output = Vector3<N>

The resulting type after applying the / operator

fn div(self, right: &'a Vector3<N>) -> Vector3<N>

The method for the / operator

impl<'a, N> Div<&'a Vector3<N>> for Vector3<N> where N: Div<&'a N, Output=N>

type Output = Vector3<N>

The resulting type after applying the / operator

fn div(self, right: &'a Vector3<N>) -> Vector3<N>

The method for the / operator

impl<'a, N> Div<Vector3<N>> for &'a Vector3<N> where &'a N: Div<N, Output=N>

type Output = Vector3<N>

The resulting type after applying the / operator

fn div(self, right: Vector3<N>) -> Vector3<N>

The method for the / operator

impl<N: Zero> Zero for Vector3<N>

fn zero() -> Vector3<N>

Returns the additive identity element of Self, 0.

fn is_zero(&self) -> bool

Returns true if self is equal to the additive identity.

impl<N: BaseNum> One for Vector3<N>

fn one() -> Vector3<N>

Returns the multiplicative identity element of Self, 1.

impl<N: Absolute<N>> Absolute<Vector3<N>> for Vector3<N>

fn abs(m: &Vector3<N>) -> Vector3<N>

Computes some absolute value of this object. Typically, this will make all component of a matrix or vector positive.

impl<N: BaseNum> Dot<N> for Vector3<N>

fn dot(&self, other: &Vector3<N>) -> N

Computes the dot (inner) product of two vectors.

impl<N: BaseFloat> Norm for Vector3<N>

type NormType = N

The scalar type for the norm (i.e. the undelying field).

fn norm_squared(&self) -> N

Computes the squared norm of self.

fn normalize(&self) -> Vector3<N>

Gets the normalized version of a copy of v.

fn normalize_mut(&mut self) -> N

Normalizes self.

fn try_normalize(&self, min_norm: N) -> Option<Vector3<N>>

Gets the normalized version of a copy of v or None if the vector has a norm smaller or equal to min_norm. In particular, .try_normalize(0.0) returns None if the norm is exactly zero.

fn try_normalize_mut(&mut self, min_norm: N) -> Option<N>

Normalized v or does nothing if the vector has a norm smaller or equal to min_norm.

fn norm(&self) -> Self::NormType

Computes the norm of self.

impl<N: Copy + Add<N, Output=N> + Neg<Output=N>> Translation<Vector3<N>> for Vector3<N>

fn translation(&self) -> Vector3<N>

Gets the translation associated with this object.

fn inverse_translation(&self) -> Vector3<N>

Gets the inverse translation associated with this object.

fn append_translation_mut(&mut self, t: &Vector3<N>)

Appends a translation to this object.

fn append_translation(&self, t: &Vector3<N>) -> Vector3<N>

Appends the translation amount to a copy of t.

fn prepend_translation_mut(&mut self, t: &Vector3<N>)

Prepends a translation to this object.

fn prepend_translation(&self, t: &Vector3<N>) -> Vector3<N>

Prepends the translation amount to a copy of t.

fn set_translation(&mut self, t: Vector3<N>)

Sets the translation.

impl<N: Copy + Add<N, Output=N> + Sub<N, Output=N>> Translate<Point3<N>> for Vector3<N>

fn translate(&self, other: &Point3<N>) -> Point3<N>

Apply a translation to an object.

fn inverse_translate(&self, other: &Point3<N>) -> Point3<N>

Apply an inverse translation to an object.

impl<N, O: Copy> Rotate<O> for Vector3<N>

fn rotate(&self, other: &O) -> O

Applies a rotation to v.

fn inverse_rotate(&self, other: &O) -> O

Applies an inverse rotation to v.

impl<N: Copy + Add<N, Output=N> + Sub<N, Output=N>> Transform<Point3<N>> for Vector3<N>

fn transform(&self, other: &Point3<N>) -> Point3<N>

Applies a transformation to v.

fn inverse_transform(&self, other: &Point3<N>) -> Point3<N>

Applies an inverse transformation to v.

impl<N> NumVector<N> for Vector3<N> where N: BaseNum

impl<N> FloatVector<N> for Vector3<N> where N: BaseFloat

impl<N: BaseFloat + Cast<f64>> Mean<N> for Vector3<N>

fn mean(&self) -> N

Computes the mean of the observations stored by v.

impl<N: Display> Display for Vector3<N>

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

Formats the value using the given formatter.

impl<N: Neg<Output=N> + Copy> Neg for Vector3<N>

type Output = Vector3<N>

The resulting type after applying the - operator

fn neg(self) -> Vector3<N>

The method for the unary - operator

impl<'a, N> Neg for &'a Vector3<N> where &'a N: Neg<Output=N>

type Output = Vector3<N>

The resulting type after applying the - operator

fn neg(self) -> Vector3<N>

The method for the unary - operator

impl<N: Copy> Repeat<N> for Vector3<N>

fn repeat(val: N) -> Vector3<N>

Returns a value with filled by val.

impl<N: Rand> Rand for Vector3<N>

fn rand<R: Rng>(rng: &mut R) -> Vector3<N>

Generates a random instance of this type using the specified source of randomness.

impl<N: Copy + AddAssign<N>> AddAssign<N> for Vector3<N>

fn add_assign(&mut self, right: N)

The method for the += operator

impl<N: Copy + Add<N, Output=N>> Add<N> for Vector3<N>

type Output = Vector3<N>

The resulting type after applying the + operator

fn add(self, right: N) -> Vector3<N>

The method for the + operator

impl<'a, 'b, N> Add<&'a N> for &'b Vector3<N> where &'b N: Add<&'a N, Output=N>

type Output = Vector3<N>

The resulting type after applying the + operator

fn add(self, right: &'a N) -> Vector3<N>

The method for the + operator

impl<'a, N> Add<N> for &'a Vector3<N> where &'a N: Add<&'b N, Output=N>

type Output = Vector3<N>

The resulting type after applying the + operator

fn add(self, right: N) -> Vector3<N>

The method for the + operator

impl<'a, N> Add<&'a N> for Vector3<N> where N: Add<&'a N, Output=N>

type Output = Vector3<N>

The resulting type after applying the + operator

fn add(self, right: &'a N) -> Vector3<N>

The method for the + operator

impl<N: Copy + SubAssign<N>> SubAssign<N> for Vector3<N>

fn sub_assign(&mut self, right: N)

The method for the -= operator

impl<N: Copy + Sub<N, Output=N>> Sub<N> for Vector3<N>

type Output = Vector3<N>

The resulting type after applying the - operator

fn sub(self, right: N) -> Vector3<N>

The method for the - operator

impl<'a, 'b, N> Sub<&'a N> for &'b Vector3<N> where &'b N: Sub<&'a N, Output=N>

type Output = Vector3<N>

The resulting type after applying the - operator

fn sub(self, right: &'a N) -> Vector3<N>

The method for the - operator

impl<'a, N> Sub<N> for &'a Vector3<N> where &'a N: Sub<&'b N, Output=N>

type Output = Vector3<N>

The resulting type after applying the - operator

fn sub(self, right: N) -> Vector3<N>

The method for the - operator

impl<'a, N> Sub<&'a N> for Vector3<N> where N: Sub<&'a N, Output=N>

type Output = Vector3<N>

The resulting type after applying the - operator

fn sub(self, right: &'a N) -> Vector3<N>

The method for the - operator

impl<N: Copy + MulAssign<N>> MulAssign<N> for Vector3<N>

fn mul_assign(&mut self, right: N)

The method for the *= operator

impl<N: Copy + Mul<N, Output=N>> Mul<N> for Vector3<N>

type Output = Vector3<N>

The resulting type after applying the * operator

fn mul(self, right: N) -> Vector3<N>

The method for the * operator

impl<'a, 'b, N> Mul<&'a N> for &'b Vector3<N> where &'b N: Mul<&'a N, Output=N>

type Output = Vector3<N>

The resulting type after applying the * operator

fn mul(self, right: &'a N) -> Vector3<N>

The method for the * operator

impl<'a, N> Mul<N> for &'a Vector3<N> where &'a N: Mul<&'b N, Output=N>

type Output = Vector3<N>

The resulting type after applying the * operator

fn mul(self, right: N) -> Vector3<N>

The method for the * operator

impl<'a, N> Mul<&'a N> for Vector3<N> where N: Mul<&'a N, Output=N>

type Output = Vector3<N>

The resulting type after applying the * operator

fn mul(self, right: &'a N) -> Vector3<N>

The method for the * operator

impl<N: Copy + DivAssign<N>> DivAssign<N> for Vector3<N>

fn div_assign(&mut self, right: N)

The method for the /= operator

impl<N: Copy + Div<N, Output=N>> Div<N> for Vector3<N>

type Output = Vector3<N>

The resulting type after applying the / operator

fn div(self, right: N) -> Vector3<N>

The method for the / operator

impl<'a, 'b, N> Div<&'a N> for &'b Vector3<N> where &'b N: Div<&'a N, Output=N>

type Output = Vector3<N>

The resulting type after applying the / operator

fn div(self, right: &'a N) -> Vector3<N>

The method for the / operator

impl<'a, N> Div<N> for &'a Vector3<N> where &'a N: Div<&'b N, Output=N>

type Output = Vector3<N>

The resulting type after applying the / operator

fn div(self, right: N) -> Vector3<N>

The method for the / operator

impl<'a, N> Div<&'a N> for Vector3<N> where N: Div<&'a N, Output=N>

type Output = Vector3<N>

The resulting type after applying the / operator

fn div(self, right: &'a N) -> Vector3<N>

The method for the / operator

impl<N: BaseFloat> PartialOrder for Vector3<N>

fn inf(&self, other: &Vector3<N>) -> Vector3<N>

Returns the infimum of this value and another

fn sup(&self, other: &Vector3<N>) -> Vector3<N>

Returns the supremum of this value and another

fn partial_cmp(&self, other: &Vector3<N>) -> PartialOrdering

Compare self and other using a partial ordering relation.

fn partial_lt(&self, other: &Vector3<N>) -> bool

Returns true iff self and other are comparable and self < other.

fn partial_le(&self, other: &Vector3<N>) -> bool

Returns true iff self and other are comparable and self <= other.

fn partial_gt(&self, other: &Vector3<N>) -> bool

Returns true iff self and other are comparable and self > other.

fn partial_ge(&self, other: &Vector3<N>) -> bool

Returns true iff self and other are comparable and self >= other.

fn partial_min<'a>(&'a self, other: &'a Self) -> Option<&'a Self>

Return the minimum of self and other if they are comparable.

fn partial_max<'a>(&'a self, other: &'a Self) -> Option<&'a Self>

Return the maximum of self and other if they are comparable.

fn partial_clamp<'a>(&'a self, min: &'a Self, max: &'a Self) -> Option<&'a Self>

Clamp value between min and max. Returns None if value is not comparable to min or max.

impl<Nin: Copy, Nout: Copy + Cast<Nin>> Cast<Vector3<Nin>> for Vector3<Nout>

fn from(v: Vector3<Nin>) -> Vector3<Nout>

Converts an element of type T to an element of type Self.

impl<N: ApproxEq<N>> ApproxEq<N> for Vector3<N>

fn approx_epsilon() -> N

Default epsilon for approximation.

fn approx_ulps() -> u32

Default ULPs for approximation.

fn approx_eq(&self, other: &Vector3<N>) -> bool

Tests approximate equality.

fn approx_eq_eps(&self, other: &Vector3<N>, eps: &N) -> bool

Tests approximate equality using a custom epsilon.

fn approx_eq_ulps(&self, other: &Vector3<N>, ulps: u32) -> bool

Tests approximate equality using units in the last place (ULPs)

impl<N: Axpy<N>> Axpy<N> for Vector3<N>

fn axpy(&mut self, a: &N, x: &Vector3<N>)

Adds $$a * x$$ to self.

impl<N: Bounded> Bounded for Vector3<N>

fn max_value() -> Vector3<N>

The maximum value.

fn min_value() -> Vector3<N>

The minimum value.

impl<N> AsRef<[N; 3]> for Vector3<N>

fn as_ref(&self) -> &[N; 3]

Performs the conversion.

impl<N> AsMut<[N; 3]> for Vector3<N>

fn as_mut(&mut self) -> &mut [N; 3]

Performs the conversion.

impl<'a, N> From<&'a [N; 3]> for &'a Vector3<N>

fn from(arr: &'a [N; 3]) -> &'a Vector3<N>

Performs the conversion.

impl<'a, N> From<&'a mut [N; 3]> for &'a mut Vector3<N>

fn from(arr: &'a mut [N; 3]) -> &'a mut Vector3<N>

Performs the conversion.

impl<'a, N: Clone> From<&'a [N; 3]> for Vector3<N>

fn from(arr: &'a [N; 3]) -> Vector3<N>

Performs the conversion.

impl<N> Dimension for Vector3<N>

fn dimension(_: Option<Vector3<N>>) -> usize

The dimension of the object.

impl<N> Shape<usize> for Vector3<N>

fn shape(&self) -> usize

Returns the shape of an indexable object.

impl<N: Copy> Indexable<usize, N> for Vector3<N>

fn swap(&mut self, i1: usize, i2: usize)

Swaps the i-th element of self with its j-th element.

unsafe fn unsafe_at(&self, i: usize) -> N

Reads the i-th element of self.

unsafe fn unsafe_set(&mut self, i: usize, val: N)

Writes to the i-th element of self.

impl<N, T> Index<T> for Vector3<N> where [N]: Index<T>

type Output = [N]::Output

The returned type after indexing

fn index(&self, i: T) -> &[N]::Output

The method for the indexing (Foo[Bar]) operation

impl<N, T> IndexMut<T> for Vector3<N> where [N]: IndexMut<T>

fn index_mut(&mut self, i: T) -> &mut [N]::Output

The method for the indexing (Foo[Bar]) operation

impl<N> Iterable<N> for Vector3<N>

fn iter(&self) -> Iter<N>

Gets a vector-like read-only iterator.

impl<N> IterableMut<N> for Vector3<N>

fn iter_mut(&mut self) -> IterMut<N>

Gets a vector-like read-write iterator.

impl<N> FromIterator<N> for Vector3<N>

fn from_iter<I: IntoIterator<Item=N>>(iterator: I) -> Vector3<N>

Creates a value from an iterator.

impl<N: Copy + One + Zero> ToHomogeneous<Vector4<N>> for Vector3<N>

fn to_homogeneous(&self) -> Vector4<N>

Gets the homogeneous coordinates form of this object.

impl<N: Copy + Div<N, Output=N> + One + Zero> FromHomogeneous<Vector4<N>> for Vector3<N>

fn from(v: &Vector4<N>) -> Vector3<N>

Builds an object from its homogeneous coordinate form.

impl<N: BaseNum + Neg<Output=N>> Mul<UnitQuaternion<N>> for Vector3<N>

type Output = Vector3<N>

The resulting type after applying the * operator

fn mul(self, right: UnitQuaternion<N>) -> Vector3<N>

The method for the * operator

impl<N: BaseNum + Neg<Output=N>> MulAssign<UnitQuaternion<N>> for Vector3<N>

fn mul_assign(&mut self, right: UnitQuaternion<N>)

The method for the *= operator

impl<N: Copy + Mul<N, Output=N> + Zero> Outer for Vector3<N>

type OuterProductType = Matrix3<N>

Result type of the outer product.

fn outer(&self, other: &Vector3<N>) -> Matrix3<N>

Computes the outer product: a * b

impl<N: BaseNum> Mul<Rotation3<N>> for Vector3<N>

type Output = Vector3<N>

The resulting type after applying the * operator

fn mul(self, right: Rotation3<N>) -> Vector3<N>

The method for the * operator

impl<N: Copy + BaseNum> MulAssign<Rotation3<N>> for Vector3<N>

fn mul_assign(&mut self, right: Rotation3<N>)

The method for the *= operator

impl<N: Copy + Mul<N, Output=N> + Add<N, Output=N>> Mul<Matrix3<N>> for Vector3<N>

type Output = Vector3<N>

The resulting type after applying the * operator

fn mul(self, right: Matrix3<N>) -> Vector3<N>

The method for the * operator

impl<N: Copy + Mul<N, Output=N> + Add<N, Output=N>> MulAssign<Matrix3<N>> for Vector3<N>

fn mul_assign(&mut self, right: Matrix3<N>)

The method for the *= operator

impl<N: BaseFloat> RotationTo for Vector3<N>

type AngleType = N

Type of the angle between two elements.

type DeltaRotationType = Rotation3<N>

Type of the rotation between two elements.

fn angle_to(&self, other: &Self) -> N

Computes an angle nedded to transform the first element to the second one using a rotation.

fn rotation_to(&self, other: &Self) -> Rotation3<N>

Computes the smallest rotation needed to transform the first element to the second one.

impl<N: Copy + Mul<N, Output=N> + Sub<N, Output=N>> Cross for Vector3<N>

type CrossProductType = Vector3<N>

The cross product output.

fn cross(&self, other: &Vector3<N>) -> Vector3<N>

Computes the cross product between two elements (usually vectors).

impl<N: Neg<Output=N> + Zero + Copy> CrossMatrix<Matrix3<N>> for Vector3<N>

fn cross_matrix(&self) -> Matrix3<N>

The matrix associated to any cross product with this vector. I.e. v.cross(anything) = v.cross_matrix().rmul(anything).

impl<N: BaseFloat> Basis for Vector3<N>

fn canonical_basis<F: FnMut(Vector3<N>) -> bool>(f: F)

Iterates through the canonical basis of the space in which this object lives.

fn orthonormal_subspace_basis<F: FnMut(Vector3<N>) -> bool>(n: &Vector3<N>, f: F)

Iterates through a basis of the subspace orthogonal to self.

fn canonical_basis_element(i: usize) -> Option<Vector3<N>>

Gets the ith element of the canonical basis.

impl<N: Cast<f64> + Copy> UniformSphereSample for Vector3<N>

fn sample<F: FnMut(Vector3<N>)>(f: F)

Iterate through the samples.