Struct Vec3A

pub struct Vec3A(/* private fields */);

A 3-dimensional vector.

SIMD vector types are used for storage on supported platforms for better performance than the Vec3 type.

It is possible to convert between Vec3 and Vec3A types using From or Into trait implementations.

This type is 16 byte aligned.

Implementations

impl Vec3A

pub const ZERO: Vec3A

All zeroes.

pub const ONE: Vec3A

All ones.

pub const NEG_ONE: Vec3A

All negative ones.

pub const MIN: Vec3A

All f32::MIN.

pub const MAX: Vec3A

All f32::MAX.

pub const NAN: Vec3A

All f32::NAN.

pub const INFINITY: Vec3A

All f32::INFINITY.

pub const NEG_INFINITY: Vec3A

All f32::NEG_INFINITY.

pub const X: Vec3A

A unit vector pointing along the positive X axis.

pub const Y: Vec3A

A unit vector pointing along the positive Y axis.

pub const Z: Vec3A

A unit vector pointing along the positive Z axis.

pub const NEG_X: Vec3A

A unit vector pointing along the negative X axis.

pub const NEG_Y: Vec3A

A unit vector pointing along the negative Y axis.

pub const NEG_Z: Vec3A

A unit vector pointing along the negative Z axis.

pub const AXES: [Vec3A; 3]

The unit axes.

pub const USES_CORE_SIMD: bool = false

Vec3A uses Rust Portable SIMD

pub const USES_NEON: bool = false

Vec3A uses Arm NEON

pub const USES_SCALAR_MATH: bool = false

Vec3A uses scalar math

pub const USES_SSE2: bool = true

Vec3A uses Intel SSE2

pub const USES_WASM32_SIMD: bool = false

Vec3A uses WebAssembly 128-bit SIMD

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

Creates a new vector.

pub const fn splat(v: f32) -> Vec3A

Creates a vector with all elements set to v.

pub fn map<F>(self, f: F) -> Vec3A

where F: Fn(f32) -> f32,

Returns a vector containing each element of self modified by a mapping function f.

pub fn select(mask: BVec3A, if_true: Vec3A, if_false: Vec3A) -> Vec3A

Creates a vector from the elements in if_true and if_false, selecting which to use for each element of self.

A true element in the mask uses the corresponding element from if_true, and false uses the element from if_false.

pub const fn from_array(a: [f32; 3]) -> Vec3A

Creates a new vector from an array.

pub const fn to_array(&self) -> [f32; 3]

Converts self to [x, y, z]

pub const fn from_slice(slice: &[f32]) -> Vec3A

Creates a vector from the first 3 values in slice.

Panics

Panics if slice is less than 3 elements long.

pub fn write_to_slice(self, slice: &mut [f32])

Writes the elements of self to the first 3 elements in slice.

Panics

Panics if slice is less than 3 elements long.

pub fn from_vec4(v: Vec4) -> Vec3A

Creates a Vec3A from the x, y and z elements of self discarding w.

On architectures where SIMD is supported such as SSE2 on x86_64 this conversion is a noop.

pub fn extend(self, w: f32) -> Vec4

Creates a 4D vector from self and the given w value.

pub fn truncate(self) -> Vec2

Creates a 2D vector from the x and y elements of self, discarding z.

Truncation may also be performed by using self.xy().

pub fn to_vec3(self) -> Vec3

pub fn with_x(self, x: f32) -> Vec3A

Creates a 3D vector from self with the given value of x.

pub fn with_y(self, y: f32) -> Vec3A

Creates a 3D vector from self with the given value of y.

pub fn with_z(self, z: f32) -> Vec3A

Creates a 3D vector from self with the given value of z.

pub fn dot(self, rhs: Vec3A) -> f32

Computes the dot product of self and rhs.

pub fn dot_into_vec(self, rhs: Vec3A) -> Vec3A

Returns a vector where every component is the dot product of self and rhs.

pub fn cross(self, rhs: Vec3A) -> Vec3A

Computes the cross product of self and rhs.

pub fn min(self, rhs: Vec3A) -> Vec3A

Returns a vector containing the minimum values for each element of self and rhs.

In other words this computes [min(x, rhs.x), min(self.y, rhs.y), ..].

NaN propogation does not follow IEEE 754-2008 semantics for minNum and may differ on different SIMD architectures.

pub fn max(self, rhs: Vec3A) -> Vec3A

Returns a vector containing the maximum values for each element of self and rhs.

In other words this computes [max(self.x, rhs.x), max(self.y, rhs.y), ..].

NaN propogation does not follow IEEE 754-2008 semantics for maxNum and may differ on different SIMD architectures.

pub fn clamp(self, min: Vec3A, max: Vec3A) -> Vec3A

Component-wise clamping of values, similar to f32::clamp.

Each element in min must be less-or-equal to the corresponding element in max.

NaN propogation does not follow IEEE 754-2008 semantics and may differ on different SIMD architectures.

Panics

Will panic if min is greater than max when glam_assert is enabled.

pub fn min_element(self) -> f32

Returns the horizontal minimum of self.

In other words this computes min(x, y, ..).

NaN propogation does not follow IEEE 754-2008 semantics and may differ on different SIMD architectures.

pub fn max_element(self) -> f32

Returns the horizontal maximum of self.

In other words this computes max(x, y, ..).

NaN propogation does not follow IEEE 754-2008 semantics and may differ on different SIMD architectures.

pub fn min_position(self) -> usize

Returns the index of the first minimum element of self.

pub fn max_position(self) -> usize

Returns the index of the first maximum element of self.

pub fn element_sum(self) -> f32

Returns the sum of all elements of self.

In other words, this computes self.x + self.y + ...

pub fn element_product(self) -> f32

Returns the product of all elements of self.

In other words, this computes self.x * self.y * ...

pub fn cmpeq(self, rhs: Vec3A) -> BVec3A

Returns a vector mask containing the result of a == comparison for each element of self and rhs.

In other words, this computes [self.x == rhs.x, self.y == rhs.y, ..] for all elements.

pub fn cmpne(self, rhs: Vec3A) -> BVec3A

Returns a vector mask containing the result of a != comparison for each element of self and rhs.

In other words this computes [self.x != rhs.x, self.y != rhs.y, ..] for all elements.

pub fn cmpge(self, rhs: Vec3A) -> BVec3A

Returns a vector mask containing the result of a >= comparison for each element of self and rhs.

In other words this computes [self.x >= rhs.x, self.y >= rhs.y, ..] for all elements.

pub fn cmpgt(self, rhs: Vec3A) -> BVec3A

Returns a vector mask containing the result of a > comparison for each element of self and rhs.

In other words this computes [self.x > rhs.x, self.y > rhs.y, ..] for all elements.

pub fn cmple(self, rhs: Vec3A) -> BVec3A

Returns a vector mask containing the result of a <= comparison for each element of self and rhs.

In other words this computes [self.x <= rhs.x, self.y <= rhs.y, ..] for all elements.

pub fn cmplt(self, rhs: Vec3A) -> BVec3A

Returns a vector mask containing the result of a < comparison for each element of self and rhs.

In other words this computes [self.x < rhs.x, self.y < rhs.y, ..] for all elements.

pub fn abs(self) -> Vec3A

Returns a vector containing the absolute value of each element of self.

pub fn signum(self) -> Vec3A

Returns a vector with elements representing the sign of self.

• 1.0 if the number is positive, +0.0 or INFINITY
• -1.0 if the number is negative, -0.0 or NEG_INFINITY
• NAN if the number is NAN

pub fn copysign(self, rhs: Vec3A) -> Vec3A

Returns a vector with signs of rhs and the magnitudes of self.

pub fn is_negative_bitmask(self) -> u32

Returns a bitmask with the lowest 3 bits set to the sign bits from the elements of self.

A negative element results in a 1 bit and a positive element in a 0 bit. Element x goes into the first lowest bit, element y into the second, etc.

An element is negative if it has a negative sign, including -0.0, NaNs with negative sign bit and negative infinity.

pub fn is_finite(self) -> bool

Returns true if, and only if, all elements are finite. If any element is either NaN, positive or negative infinity, this will return false.

pub fn is_finite_mask(self) -> BVec3A

Performs is_finite on each element of self, returning a vector mask of the results.

In other words, this computes [x.is_finite(), y.is_finite(), ...].

pub fn is_nan(self) -> bool

Returns true if any elements are NaN.

pub fn is_nan_mask(self) -> BVec3A

Performs is_nan on each element of self, returning a vector mask of the results.

In other words, this computes [x.is_nan(), y.is_nan(), ...].

pub fn length(self) -> f32

Computes the length of self.

pub fn length_squared(self) -> f32

Computes the squared length of self.

This is faster than length() as it avoids a square root operation.

pub fn length_recip(self) -> f32

Computes 1.0 / length().

For valid results, self must not be of length zero.

pub fn distance(self, rhs: Vec3A) -> f32

Computes the Euclidean distance between two points in space.

pub fn distance_squared(self, rhs: Vec3A) -> f32

Compute the squared euclidean distance between two points in space.

pub fn div_euclid(self, rhs: Vec3A) -> Vec3A

Returns the element-wise quotient of [Euclidean division] of self by rhs.

pub fn rem_euclid(self, rhs: Vec3A) -> Vec3A

Returns the element-wise remainder of Euclidean division of self by rhs.

pub fn normalize(self) -> Vec3A

Returns self normalized to length 1.0.

For valid results, self must be finite and not of length zero, nor very close to zero.

See also Self::try_normalize() and Self::normalize_or_zero().

Panics

Will panic if the resulting normalized vector is not finite when glam_assert is enabled.

pub fn try_normalize(self) -> Option<Vec3A>

Returns self normalized to length 1.0 if possible, else returns None.

In particular, if the input is zero (or very close to zero), or non-finite, the result of this operation will be None.

See also Self::normalize_or_zero().

pub fn normalize_or(self, fallback: Vec3A) -> Vec3A

Returns self normalized to length 1.0 if possible, else returns a fallback value.

In particular, if the input is zero (or very close to zero), or non-finite, the result of this operation will be the fallback value.

See also Self::try_normalize().

pub fn normalize_or_zero(self) -> Vec3A

Returns self normalized to length 1.0 if possible, else returns zero.

In particular, if the input is zero (or very close to zero), or non-finite, the result of this operation will be zero.

See also Self::try_normalize().

pub fn normalize_and_length(self) -> (Vec3A, f32)

Returns self normalized to length 1.0 and the length of self.

If self is zero length then (Self::X, 0.0) is returned.

pub fn is_normalized(self) -> bool

Returns whether self is length 1.0 or not.

Uses a precision threshold of approximately 1e-4.

pub fn project_onto(self, rhs: Vec3A) -> Vec3A

Returns the vector projection of self onto rhs.

rhs must be of non-zero length.

Panics

Will panic if rhs is zero length when glam_assert is enabled.

pub fn reject_from(self, rhs: Vec3A) -> Vec3A

Returns the vector rejection of self from rhs.

The vector rejection is the vector perpendicular to the projection of self onto rhs, in rhs words the result of self - self.project_onto(rhs).

rhs must be of non-zero length.

Panics

Will panic if rhs has a length of zero when glam_assert is enabled.

pub fn project_onto_normalized(self, rhs: Vec3A) -> Vec3A

Returns the vector projection of self onto rhs.

rhs must be normalized.

Panics

Will panic if rhs is not normalized when glam_assert is enabled.

pub fn reject_from_normalized(self, rhs: Vec3A) -> Vec3A

Returns the vector rejection of self from rhs.

The vector rejection is the vector perpendicular to the projection of self onto rhs, in rhs words the result of self - self.project_onto(rhs).

rhs must be normalized.

Panics

Will panic if rhs is not normalized when glam_assert is enabled.

pub fn round(self) -> Vec3A

Returns a vector containing the nearest integer to a number for each element of self. Round half-way cases away from 0.0.

pub fn floor(self) -> Vec3A

Returns a vector containing the largest integer less than or equal to a number for each element of self.

pub fn ceil(self) -> Vec3A

Returns a vector containing the smallest integer greater than or equal to a number for each element of self.

pub fn trunc(self) -> Vec3A

Returns a vector containing the integer part each element of self. This means numbers are always truncated towards zero.

pub fn fract(self) -> Vec3A

Returns a vector containing the fractional part of the vector as self - self.trunc().

Note that this differs from the GLSL implementation of fract which returns self - self.floor().

Note that this is fast but not precise for large numbers.

pub fn fract_gl(self) -> Vec3A

Returns a vector containing the fractional part of the vector as self - self.floor().

Note that this differs from the Rust implementation of fract which returns self - self.trunc().

Note that this is fast but not precise for large numbers.

pub fn exp(self) -> Vec3A

Returns a vector containing e^self (the exponential function) for each element of self.

pub fn powf(self, n: f32) -> Vec3A

Returns a vector containing each element of self raised to the power of n.

pub fn recip(self) -> Vec3A

Returns a vector containing the reciprocal 1.0/n of each element of self.

pub fn lerp(self, rhs: Vec3A, s: f32) -> Vec3A

Performs a linear interpolation between self and rhs based on the value s.

When s is 0.0, the result will be equal to self. When s is 1.0, the result will be equal to rhs. When s is outside of range [0, 1], the result is linearly extrapolated.

pub fn move_towards(&self, rhs: Vec3A, d: f32) -> Vec3A

Moves towards rhs based on the value d.

When d is 0.0, the result will be equal to self. When d is equal to self.distance(rhs), the result will be equal to rhs. Will not go past rhs.

pub fn midpoint(self, rhs: Vec3A) -> Vec3A

Calculates the midpoint between self and rhs.

The midpoint is the average of, or halfway point between, two vectors. a.midpoint(b) should yield the same result as a.lerp(b, 0.5) while being slightly cheaper to compute.

pub fn abs_diff_eq(self, rhs: Vec3A, max_abs_diff: f32) -> bool

Returns true if the absolute difference of all elements between self and rhs is less than or equal to max_abs_diff.

This can be used to compare if two vectors contain similar elements. It works best when comparing with a known value. The max_abs_diff that should be used used depends on the values being compared against.

For more see comparing floating point numbers.

pub fn clamp_length(self, min: f32, max: f32) -> Vec3A

Returns a vector with a length no less than min and no more than max.

Panics

Will panic if min is greater than max, or if either min or max is negative, when glam_assert is enabled.

pub fn clamp_length_max(self, max: f32) -> Vec3A

Returns a vector with a length no more than max.

Panics

Will panic if max is negative when glam_assert is enabled.

pub fn clamp_length_min(self, min: f32) -> Vec3A

Returns a vector with a length no less than min.

Panics

Will panic if min is negative when glam_assert is enabled.

pub fn mul_add(self, a: Vec3A, b: Vec3A) -> Vec3A

Fused multiply-add. Computes (self * a) + b element-wise with only one rounding error, yielding a more accurate result than an unfused multiply-add.

Using mul_add may be more performant than an unfused multiply-add if the target architecture has a dedicated fma CPU instruction. However, this is not always true, and will be heavily dependant on designing algorithms with specific target hardware in mind.

pub fn reflect(self, normal: Vec3A) -> Vec3A

Returns the reflection vector for a given incident vector self and surface normal normal.

normal must be normalized.

Panics

Will panic if normal is not normalized when glam_assert is enabled.

pub fn refract(self, normal: Vec3A, eta: f32) -> Vec3A

Returns the refraction direction for a given incident vector self, surface normal normal and ratio of indices of refraction, eta. When total internal reflection occurs, a zero vector will be returned.

self and normal must be normalized.

Panics

Will panic if self or normal is not normalized when glam_assert is enabled.

pub fn angle_between(self, rhs: Vec3A) -> f32

Returns the angle (in radians) between two vectors in the range [0, +π].

The inputs do not need to be unit vectors however they must be non-zero.

pub fn rotate_towards(self, rhs: Vec3A, max_angle: f32) -> Vec3A

Rotates towards rhs up to max_angle (in radians).

When max_angle is 0.0, the result will be equal to self. When max_angle is equal to self.angle_between(rhs), the result will be parallel to rhs. If max_angle is negative, rotates towards the exact opposite of rhs. Will not go past the target.

pub fn any_orthogonal_vector(&self) -> Vec3A

Returns some vector that is orthogonal to the given one.

The input vector must be finite and non-zero.

The output vector is not necessarily unit length. For that use Self::any_orthonormal_vector() instead.

pub fn any_orthonormal_vector(&self) -> Vec3A

Returns any unit vector that is orthogonal to the given one.

The input vector must be unit length.

Panics

Will panic if self is not normalized when glam_assert is enabled.

pub fn any_orthonormal_pair(&self) -> (Vec3A, Vec3A)

Given a unit vector return two other vectors that together form an orthonormal basis. That is, all three vectors are orthogonal to each other and are normalized.

Panics

Will panic if self is not normalized when glam_assert is enabled.

pub fn slerp(self, rhs: Vec3A, s: f32) -> Vec3A

Performs a spherical linear interpolation between self and rhs based on the value s.

When s is 0.0, the result will be equal to self. When s is 1.0, the result will be equal to rhs. When s is outside of range [0, 1], the result is linearly extrapolated.

pub fn as_dvec3(&self) -> DVec3

Casts all elements of self to f64.

pub fn as_i8vec3(&self) -> I8Vec3

Casts all elements of self to i8.

pub fn as_u8vec3(&self) -> U8Vec3

Casts all elements of self to u8.

pub fn as_i16vec3(&self) -> I16Vec3

Casts all elements of self to i16.

pub fn as_u16vec3(&self) -> U16Vec3

Casts all elements of self to u16.

pub fn as_ivec3(&self) -> IVec3

Casts all elements of self to i32.

pub fn as_uvec3(&self) -> UVec3

Casts all elements of self to u32.

pub fn as_i64vec3(&self) -> I64Vec3

Casts all elements of self to i64.

pub fn as_u64vec3(&self) -> U64Vec3

Casts all elements of self to u64.

pub fn as_usizevec3(&self) -> USizeVec3

Casts all elements of self to usize.

Trait Implementations

impl AbsDiffEq for Vec3A

type Epsilon = <f32 as AbsDiffEq>::Epsilon

Used for specifying relative comparisons.

fn default_epsilon() -> <Vec3A as AbsDiffEq>::Epsilon

The default tolerance to use when testing values that are close together.

fn abs_diff_eq( &self, other: &Vec3A, epsilon: <Vec3A as AbsDiffEq>::Epsilon, ) -> bool

A test for equality that uses the absolute difference to compute the approximate equality of two numbers.

fn abs_diff_ne(&self, other: &Rhs, epsilon: Self::Epsilon) -> bool

The inverse of AbsDiffEq::abs_diff_eq.

impl Add<&Vec3A> for &Vec3A

type Output = Vec3A

The resulting type after applying the + operator.

fn add(self, rhs: &Vec3A) -> Vec3A

Performs the + operation.

impl Add<&Vec3A> for Vec3A

type Output = Vec3A

The resulting type after applying the + operator.

fn add(self, rhs: &Vec3A) -> Vec3A

Performs the + operation.

impl Add<&f32> for &Vec3A

type Output = Vec3A

The resulting type after applying the + operator.

fn add(self, rhs: &f32) -> Vec3A

Performs the + operation.

impl Add<&f32> for Vec3A

type Output = Vec3A

The resulting type after applying the + operator.

fn add(self, rhs: &f32) -> Vec3A

Performs the + operation.

impl Add<Vec3A> for &Vec3A

type Output = Vec3A

The resulting type after applying the + operator.

fn add(self, rhs: Vec3A) -> Vec3A

Performs the + operation.

impl Add<f32> for &Vec3A

type Output = Vec3A

The resulting type after applying the + operator.

fn add(self, rhs: f32) -> Vec3A

Performs the + operation.

impl Add<f32> for Vec3A

type Output = Vec3A

The resulting type after applying the + operator.

fn add(self, rhs: f32) -> Vec3A

Performs the + operation.

impl Add for Vec3A

type Output = Vec3A

The resulting type after applying the + operator.

fn add(self, rhs: Vec3A) -> Vec3A

Performs the + operation.

impl AddAssign<&Vec3A> for Vec3A

fn add_assign(&mut self, rhs: &Vec3A)

Performs the += operation.

impl AddAssign<&f32> for Vec3A

fn add_assign(&mut self, rhs: &f32)

Performs the += operation.

impl AddAssign<f32> for Vec3A

fn add_assign(&mut self, rhs: f32)

Performs the += operation.

impl AddAssign for Vec3A

fn add_assign(&mut self, rhs: Vec3A)

Performs the += operation.

impl AsMut<[f32; 3]> for Vec3A

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

Converts this type into a mutable reference of the (usually inferred) input type.

impl AsRef<[f32; 3]> for Vec3A

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

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for Vec3A

fn clone(&self) -> Vec3A

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Vec3A

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

Formats the value using the given formatter.

impl Default for Vec3A

fn default() -> Vec3A

Returns the “default value” for a type.

impl Deref for Vec3A

type Target = Vec3<f32>

The resulting type after dereferencing.

fn deref(&self) -> &<Vec3A as Deref>::Target

Dereferences the value.

impl DerefMut for Vec3A

fn deref_mut(&mut self) -> &mut <Vec3A as Deref>::Target

Mutably dereferences the value.

impl<'de> Deserialize<'de> for Vec3A

Deserialize expects a sequence of 3 values.

fn deserialize<D>( deserializer: D, ) -> Result<Vec3A, <D as Deserializer<'de>>::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Vec3A

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

Formats the value using the given formatter.

impl Div<&Vec3A> for &Vec3A

type Output = Vec3A

The resulting type after applying the / operator.

fn div(self, rhs: &Vec3A) -> Vec3A

Performs the / operation.

impl Div<&Vec3A> for Vec3A

type Output = Vec3A

The resulting type after applying the / operator.

fn div(self, rhs: &Vec3A) -> Vec3A

Performs the / operation.

impl Div<&f32> for &Vec3A

type Output = Vec3A

The resulting type after applying the / operator.

fn div(self, rhs: &f32) -> Vec3A

Performs the / operation.

impl Div<&f32> for Vec3A

type Output = Vec3A

The resulting type after applying the / operator.

fn div(self, rhs: &f32) -> Vec3A

Performs the / operation.

impl Div<Vec3A> for &Vec3A

type Output = Vec3A

The resulting type after applying the / operator.

fn div(self, rhs: Vec3A) -> Vec3A

Performs the / operation.

impl Div<f32> for &Vec3A

type Output = Vec3A

The resulting type after applying the / operator.

fn div(self, rhs: f32) -> Vec3A

Performs the / operation.

impl Div<f32> for Vec3A

type Output = Vec3A

The resulting type after applying the / operator.

fn div(self, rhs: f32) -> Vec3A

Performs the / operation.

impl Div for Vec3A

type Output = Vec3A

The resulting type after applying the / operator.

fn div(self, rhs: Vec3A) -> Vec3A

Performs the / operation.

impl DivAssign<&Vec3A> for Vec3A

fn div_assign(&mut self, rhs: &Vec3A)

Performs the /= operation.

impl DivAssign<&f32> for Vec3A

fn div_assign(&mut self, rhs: &f32)

Performs the /= operation.

impl DivAssign<f32> for Vec3A

fn div_assign(&mut self, rhs: f32)

Performs the /= operation.

impl DivAssign for Vec3A

fn div_assign(&mut self, rhs: Vec3A)

Performs the /= operation.

impl From<[f32; 3]> for Vec3A

fn from(a: [f32; 3]) -> Vec3A

Converts to this type from the input type.

impl From<(Vec2, f32)> for Vec3A

fn from(_: (Vec2, f32)) -> Vec3A

Converts to this type from the input type.

impl From<(f32, f32, f32)> for Vec3A

fn from(t: (f32, f32, f32)) -> Vec3A

Converts to this type from the input type.

impl From<BVec3> for Vec3A

fn from(v: BVec3) -> Vec3A

Converts to this type from the input type.

impl From<BVec3A> for Vec3A

fn from(v: BVec3A) -> Vec3A

Converts to this type from the input type.

impl From<Dir3A> for Vec3A

fn from(value: Dir3A) -> Self

Converts to this type from the input type.

impl From<Vec3> for Vec3A

fn from(v: Vec3) -> Vec3A

Converts to this type from the input type.

impl From<Vec3A> for Isometry3d

fn from(translation: Vec3A) -> Self

Converts to this type from the input type.

impl From<Vec3A> for Vec3

fn from(v: Vec3A) -> Vec3

Converts to this type from the input type.

impl From<__m128> for Vec3A

fn from(t: __m128) -> Vec3A

Converts to this type from the input type.

impl FromReflect for Vec3A

fn from_reflect(reflect: &(dyn PartialReflect + 'static)) -> Option<Vec3A>

Constructs a concrete instance of Self from a reflected value.

fn take_from_reflect( reflect: Box<dyn PartialReflect>, ) -> Result<Self, Box<dyn PartialReflect>>

Attempts to downcast the given value to Self using, constructing the value using from_reflect if that fails.

impl GetTypeRegistration for Vec3A

fn get_type_registration() -> TypeRegistration

Returns the default TypeRegistration for this type.

fn register_type_dependencies(registry: &mut TypeRegistry)

Registers other types needed by this type.

impl Index<usize> for Vec3A

type Output = f32

The returned type after indexing.

fn index(&self, index: usize) -> &<Vec3A as Index<usize>>::Output

Performs the indexing (container[index]) operation.

impl IndexMut<usize> for Vec3A

fn index_mut(&mut self, index: usize) -> &mut <Vec3A as Index<usize>>::Output

Performs the mutable indexing (container[index]) operation.

impl Mul<&Vec3A> for &Mat3

type Output = Vec3A

The resulting type after applying the * operator.

fn mul(self, rhs: &Vec3A) -> Vec3A

Performs the * operation.

impl Mul<&Vec3A> for &Mat3A

type Output = Vec3A

The resulting type after applying the * operator.

fn mul(self, rhs: &Vec3A) -> Vec3A

Performs the * operation.

impl Mul<&Vec3A> for &Quat

type Output = Vec3A

The resulting type after applying the * operator.

fn mul(self, rhs: &Vec3A) -> Vec3A

Performs the * operation.

impl Mul<&Vec3A> for &Vec3A

type Output = Vec3A

The resulting type after applying the * operator.

fn mul(self, rhs: &Vec3A) -> Vec3A

Performs the * operation.

impl Mul<&Vec3A> for Mat3

type Output = Vec3A

The resulting type after applying the * operator.

fn mul(self, rhs: &Vec3A) -> Vec3A

Performs the * operation.

impl Mul<&Vec3A> for Mat3A

type Output = Vec3A

The resulting type after applying the * operator.

fn mul(self, rhs: &Vec3A) -> Vec3A

Performs the * operation.

impl Mul<&Vec3A> for Quat

type Output = Vec3A

The resulting type after applying the * operator.

fn mul(self, rhs: &Vec3A) -> Vec3A

Performs the * operation.

impl Mul<&Vec3A> for Vec3A

type Output = Vec3A

The resulting type after applying the * operator.

fn mul(self, rhs: &Vec3A) -> Vec3A

Performs the * operation.

impl Mul<&f32> for &Vec3A

type Output = Vec3A

The resulting type after applying the * operator.

fn mul(self, rhs: &f32) -> Vec3A

Performs the * operation.

impl Mul<&f32> for Vec3A

type Output = Vec3A

The resulting type after applying the * operator.

fn mul(self, rhs: &f32) -> Vec3A

Performs the * operation.

impl Mul<Vec3A> for &Mat3

type Output = Vec3A

The resulting type after applying the * operator.

fn mul(self, rhs: Vec3A) -> Vec3A

Performs the * operation.

impl Mul<Vec3A> for &Mat3A

type Output = Vec3A

The resulting type after applying the * operator.

fn mul(self, rhs: Vec3A) -> Vec3A

Performs the * operation.

impl Mul<Vec3A> for &Quat

type Output = Vec3A

The resulting type after applying the * operator.

fn mul(self, rhs: Vec3A) -> Vec3A

Performs the * operation.

impl Mul<Vec3A> for &Vec3A

type Output = Vec3A

The resulting type after applying the * operator.

fn mul(self, rhs: Vec3A) -> Vec3A

Performs the * operation.

impl Mul<Vec3A> for Isometry3d

type Output = Vec3A

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<Vec3A> for Mat3

type Output = Vec3A

The resulting type after applying the * operator.

fn mul(self, rhs: Vec3A) -> Vec3A

Performs the * operation.

impl Mul<Vec3A> for Mat3A

type Output = Vec3A

The resulting type after applying the * operator.

fn mul(self, rhs: Vec3A) -> <Mat3A as Mul<Vec3A>>::Output

Performs the * operation.

impl Mul<Vec3A> for Quat

type Output = Vec3A

The resulting type after applying the * operator.

fn mul(self, rhs: Vec3A) -> <Quat as Mul<Vec3A>>::Output

Performs the * operation.

impl Mul<f32> for &Vec3A

type Output = Vec3A

The resulting type after applying the * operator.

fn mul(self, rhs: f32) -> Vec3A

Performs the * operation.

impl Mul<f32> for Vec3A

type Output = Vec3A

The resulting type after applying the * operator.

fn mul(self, rhs: f32) -> Vec3A

Performs the * operation.

impl Mul for Vec3A

type Output = Vec3A

The resulting type after applying the * operator.

fn mul(self, rhs: Vec3A) -> Vec3A

Performs the * operation.

impl MulAssign<&Vec3A> for Vec3A

fn mul_assign(&mut self, rhs: &Vec3A)

Performs the *= operation.

impl MulAssign<&f32> for Vec3A

fn mul_assign(&mut self, rhs: &f32)

Performs the *= operation.

impl MulAssign<f32> for Vec3A

fn mul_assign(&mut self, rhs: f32)

Performs the *= operation.

impl MulAssign for Vec3A

fn mul_assign(&mut self, rhs: Vec3A)

Performs the *= operation.

impl Neg for &Vec3A

type Output = Vec3A

The resulting type after applying the - operator.

fn neg(self) -> Vec3A

Performs the unary - operation.

impl Neg for Vec3A

type Output = Vec3A

The resulting type after applying the - operator.

fn neg(self) -> Vec3A

Performs the unary - operation.

impl NormedVectorSpace for Vec3A

fn norm(self) -> f32

The size of this element. The return value should always be nonnegative.

fn norm_squared(self) -> f32

The squared norm of this element. Computing this is often faster than computing NormedVectorSpace::norm.

fn distance(self, rhs: Self) -> Self::Scalar

The distance between this element and another, as determined by the norm.

fn distance_squared(self, rhs: Self) -> Self::Scalar

The squared distance between this element and another, as determined by the norm. Note that this is often faster to compute in practice than NormedVectorSpace::distance.

impl PartialEq for Vec3A

fn eq(&self, rhs: &Vec3A) -> 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 PartialReflect for Vec3A

fn get_represented_type_info(&self) -> Option<&'static TypeInfo>

Returns the TypeInfo of the type represented by this value.

fn try_apply( &mut self, value: &(dyn PartialReflect + 'static), ) -> Result<(), ApplyError>

Tries to apply a reflected value to this value.

fn reflect_kind(&self) -> ReflectKind

Returns a zero-sized enumeration of “kinds” of type.

fn reflect_ref(&self) -> ReflectRef<'_>

Returns an immutable enumeration of “kinds” of type.

fn reflect_mut(&mut self) -> ReflectMut<'_>

Returns a mutable enumeration of “kinds” of type.

fn reflect_owned(self: Box<Vec3A>) -> ReflectOwned

Returns an owned enumeration of “kinds” of type.

fn try_into_reflect( self: Box<Vec3A>, ) -> Result<Box<dyn Reflect>, Box<dyn PartialReflect>>

Attempts to cast this type to a boxed, fully-reflected value.

fn try_as_reflect(&self) -> Option<&(dyn Reflect + 'static)>

Attempts to cast this type to a fully-reflected value.

fn try_as_reflect_mut(&mut self) -> Option<&mut (dyn Reflect + 'static)>

Attempts to cast this type to a mutable, fully-reflected value.

fn into_partial_reflect(self: Box<Vec3A>) -> Box<dyn PartialReflect>

Casts this type to a boxed, reflected value.

fn as_partial_reflect(&self) -> &(dyn PartialReflect + 'static)

Casts this type to a reflected value.

fn as_partial_reflect_mut(&mut self) -> &mut (dyn PartialReflect + 'static)

Casts this type to a mutable, reflected value.

fn reflect_partial_eq( &self, value: &(dyn PartialReflect + 'static), ) -> Option<bool>

Returns a “partial equality” comparison result.

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

Debug formatter for the value.

fn reflect_clone(&self) -> Result<Box<dyn Reflect>, ReflectCloneError>

Attempts to clone Self using reflection.

fn apply(&mut self, value: &(dyn PartialReflect + 'static))

Applies a reflected value to this value.

fn to_dynamic(&self) -> Box<dyn PartialReflect>

Converts this reflected value into its dynamic representation based on its kind.

fn reflect_clone_and_take<T>(&self) -> Result<T, ReflectCloneError>

where T: 'static, Self: Sized + TypePath,

For a type implementing PartialReflect, combines reflect_clone and take in a useful fashion, automatically constructing an appropriate ReflectCloneError if the downcast fails.

fn reflect_hash(&self) -> Option<u64>

Returns a hash of the value (which includes the type).

fn is_dynamic(&self) -> bool

Indicates whether or not this type is a dynamic type.

impl<'a> Product<&'a Vec3A> for Vec3A

fn product<I>(iter: I) -> Vec3A

where I: Iterator<Item = &'a Vec3A>,

Takes an iterator and generates Self from the elements by multiplying the items.

impl Product for Vec3A

fn product<I>(iter: I) -> Vec3A

where I: Iterator<Item = Vec3A>,

Takes an iterator and generates Self from the elements by multiplying the items.

impl Reflect for Vec3A

fn into_any(self: Box<Vec3A>) -> Box<dyn Any>

Returns the value as a Box<dyn Any>.

fn as_any(&self) -> &(dyn Any + 'static)

Returns the value as a &dyn Any.

fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)

Returns the value as a &mut dyn Any.

fn into_reflect(self: Box<Vec3A>) -> Box<dyn Reflect>

Casts this type to a boxed, fully-reflected value.

fn as_reflect(&self) -> &(dyn Reflect + 'static)

Casts this type to a fully-reflected value.

fn as_reflect_mut(&mut self) -> &mut (dyn Reflect + 'static)

Casts this type to a mutable, fully-reflected value.

fn set(&mut self, value: Box<dyn Reflect>) -> Result<(), Box<dyn Reflect>>

Performs a type-checked assignment of a reflected value to this value.

impl RelativeEq for Vec3A

fn default_max_relative() -> <Vec3A as AbsDiffEq>::Epsilon

The default relative tolerance for testing values that are far-apart.

fn relative_eq( &self, other: &Vec3A, epsilon: <Vec3A as AbsDiffEq>::Epsilon, max_relative: <Vec3A as AbsDiffEq>::Epsilon, ) -> bool

A test for equality that uses a relative comparison if the values are far apart.

fn relative_ne( &self, other: &Rhs, epsilon: Self::Epsilon, max_relative: Self::Epsilon, ) -> bool

The inverse of RelativeEq::relative_eq.

impl Rem<&Vec3A> for &Vec3A

type Output = Vec3A

The resulting type after applying the % operator.

fn rem(self, rhs: &Vec3A) -> Vec3A

Performs the % operation.

impl Rem<&Vec3A> for Vec3A

type Output = Vec3A

The resulting type after applying the % operator.

fn rem(self, rhs: &Vec3A) -> Vec3A

Performs the % operation.

impl Rem<&f32> for &Vec3A

type Output = Vec3A

The resulting type after applying the % operator.

fn rem(self, rhs: &f32) -> Vec3A

Performs the % operation.

impl Rem<&f32> for Vec3A

type Output = Vec3A

The resulting type after applying the % operator.

fn rem(self, rhs: &f32) -> Vec3A

Performs the % operation.

impl Rem<Vec3A> for &Vec3A

type Output = Vec3A

The resulting type after applying the % operator.

fn rem(self, rhs: Vec3A) -> Vec3A

Performs the % operation.

impl Rem<f32> for &Vec3A

type Output = Vec3A

The resulting type after applying the % operator.

fn rem(self, rhs: f32) -> Vec3A

Performs the % operation.

impl Rem<f32> for Vec3A

type Output = Vec3A

The resulting type after applying the % operator.

fn rem(self, rhs: f32) -> Vec3A

Performs the % operation.

impl Rem for Vec3A

type Output = Vec3A

The resulting type after applying the % operator.

fn rem(self, rhs: Vec3A) -> Vec3A

Performs the % operation.

impl RemAssign<&Vec3A> for Vec3A

fn rem_assign(&mut self, rhs: &Vec3A)

Performs the %= operation.

impl RemAssign<&f32> for Vec3A

fn rem_assign(&mut self, rhs: &f32)

Performs the %= operation.

impl RemAssign<f32> for Vec3A

fn rem_assign(&mut self, rhs: f32)

Performs the %= operation.

impl RemAssign for Vec3A

fn rem_assign(&mut self, rhs: Vec3A)

Performs the %= operation.

impl Serialize for Vec3A

Serialize as a sequence of 3 values.

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 Struct for Vec3A

fn field(&self, name: &str) -> Option<&(dyn PartialReflect + 'static)>

Returns a reference to the value of the field named name as a &dyn PartialReflect.

fn field_mut( &mut self, name: &str, ) -> Option<&mut (dyn PartialReflect + 'static)>

Returns a mutable reference to the value of the field named name as a &mut dyn PartialReflect.

fn field_at(&self, index: usize) -> Option<&(dyn PartialReflect + 'static)>

Returns a reference to the value of the field with index index as a &dyn PartialReflect.

fn field_at_mut( &mut self, index: usize, ) -> Option<&mut (dyn PartialReflect + 'static)>

Returns a mutable reference to the value of the field with index index as a &mut dyn PartialReflect.

fn name_at(&self, index: usize) -> Option<&str>

Returns the name of the field with index index.

fn field_len(&self) -> usize

Returns the number of fields in the struct.

fn iter_fields(&self) -> FieldIter<'_>

Returns an iterator over the values of the reflectable fields for this struct.

fn to_dynamic_struct(&self) -> DynamicStruct

Creates a new DynamicStruct from this struct.

fn get_represented_struct_info(&self) -> Option<&'static StructInfo>

Will return None if TypeInfo is not available.

impl Sub<&Vec3A> for &Vec3A

type Output = Vec3A

The resulting type after applying the - operator.

fn sub(self, rhs: &Vec3A) -> Vec3A

Performs the - operation.

impl Sub<&Vec3A> for Vec3A

type Output = Vec3A

The resulting type after applying the - operator.

fn sub(self, rhs: &Vec3A) -> Vec3A

Performs the - operation.

impl Sub<&f32> for &Vec3A

type Output = Vec3A

The resulting type after applying the - operator.

fn sub(self, rhs: &f32) -> Vec3A

Performs the - operation.

impl Sub<&f32> for Vec3A

type Output = Vec3A

The resulting type after applying the - operator.

fn sub(self, rhs: &f32) -> Vec3A

Performs the - operation.

impl Sub<Vec3A> for &Vec3A

type Output = Vec3A

The resulting type after applying the - operator.

fn sub(self, rhs: Vec3A) -> Vec3A

Performs the - operation.

impl Sub<f32> for &Vec3A

type Output = Vec3A

The resulting type after applying the - operator.

fn sub(self, rhs: f32) -> Vec3A

Performs the - operation.

impl Sub<f32> for Vec3A

type Output = Vec3A

The resulting type after applying the - operator.

fn sub(self, rhs: f32) -> Vec3A

Performs the - operation.

impl Sub for Vec3A

type Output = Vec3A

The resulting type after applying the - operator.

fn sub(self, rhs: Vec3A) -> Vec3A

Performs the - operation.

impl SubAssign<&Vec3A> for Vec3A

fn sub_assign(&mut self, rhs: &Vec3A)

Performs the -= operation.

impl SubAssign<&f32> for Vec3A

fn sub_assign(&mut self, rhs: &f32)

Performs the -= operation.

impl SubAssign<f32> for Vec3A

fn sub_assign(&mut self, rhs: f32)

Performs the -= operation.

impl SubAssign for Vec3A

fn sub_assign(&mut self, rhs: Vec3A)

Performs the -= operation.

impl<'a> Sum<&'a Vec3A> for Vec3A

fn sum<I>(iter: I) -> Vec3A

where I: Iterator<Item = &'a Vec3A>,

Takes an iterator and generates Self from the elements by “summing up” the items.

impl Sum for Vec3A

fn sum<I>(iter: I) -> Vec3A

where I: Iterator<Item = Vec3A>,

Takes an iterator and generates Self from the elements by “summing up” the items.

impl TryFrom<Vec3A> for Dir3A

type Error = InvalidDirectionError

The type returned in the event of a conversion error.

fn try_from(value: Vec3A) -> Result<Self, Self::Error>

Performs the conversion.

impl TypePath for Vec3A

fn type_path() -> &'static str

Returns the fully qualified path of the underlying type.

fn short_type_path() -> &'static str

Returns a short, pretty-print enabled path to the type.

fn type_ident() -> Option<&'static str>

Returns the name of the type, or None if it is anonymous.

fn crate_name() -> Option<&'static str>

Returns the name of the crate the type is in, or None if it is anonymous.

fn module_path() -> Option<&'static str>

Returns the path to the module the type is in, or None if it is anonymous.

impl Typed for Vec3A

fn type_info() -> &'static TypeInfo

Returns the compile-time info for the underlying type.

impl UlpsEq for Vec3A

fn default_max_ulps() -> u32

The default ULPs to tolerate when testing values that are far-apart.

fn ulps_eq( &self, other: &Vec3A, epsilon: <Vec3A as AbsDiffEq>::Epsilon, max_ulps: u32, ) -> bool

A test for equality that uses units in the last place (ULP) if the values are far apart.

fn ulps_ne(&self, other: &Rhs, epsilon: Self::Epsilon, max_ulps: u32) -> bool

The inverse of UlpsEq::ulps_eq.

impl Vec3Swizzles for Vec3A

type Vec2 = Vec2

type Vec4 = Vec4

fn xx(self) -> Vec2

fn xy(self) -> Vec2

fn with_xy(self, rhs: Vec2) -> Vec3A

fn xz(self) -> Vec2

fn with_xz(self, rhs: Vec2) -> Vec3A

fn yx(self) -> Vec2

fn with_yx(self, rhs: Vec2) -> Vec3A

fn yy(self) -> Vec2

fn yz(self) -> Vec2

fn with_yz(self, rhs: Vec2) -> Vec3A

fn zx(self) -> Vec2

fn with_zx(self, rhs: Vec2) -> Vec3A

fn zy(self) -> Vec2

fn with_zy(self, rhs: Vec2) -> Vec3A

fn zz(self) -> Vec2

fn xxx(self) -> Vec3A

fn xxy(self) -> Vec3A

fn xxz(self) -> Vec3A

fn xyx(self) -> Vec3A

fn xyy(self) -> Vec3A

fn xzx(self) -> Vec3A

fn xzy(self) -> Vec3A

fn xzz(self) -> Vec3A

fn yxx(self) -> Vec3A

fn yxy(self) -> Vec3A

fn yxz(self) -> Vec3A

fn yyx(self) -> Vec3A

fn yyy(self) -> Vec3A

fn yyz(self) -> Vec3A

fn yzx(self) -> Vec3A

fn yzy(self) -> Vec3A

fn yzz(self) -> Vec3A

fn zxx(self) -> Vec3A

fn zxy(self) -> Vec3A

fn zxz(self) -> Vec3A

fn zyx(self) -> Vec3A

fn zyy(self) -> Vec3A

fn zyz(self) -> Vec3A

fn zzx(self) -> Vec3A

fn zzy(self) -> Vec3A

fn zzz(self) -> Vec3A

fn xxxx(self) -> Vec4

fn xxxy(self) -> Vec4

fn xxxz(self) -> Vec4

fn xxyx(self) -> Vec4

fn xxyy(self) -> Vec4

fn xxyz(self) -> Vec4

fn xxzx(self) -> Vec4

fn xxzy(self) -> Vec4

fn xxzz(self) -> Vec4

fn xyxx(self) -> Vec4

fn xyxy(self) -> Vec4

fn xyxz(self) -> Vec4

fn xyyx(self) -> Vec4

fn xyyy(self) -> Vec4

fn xyyz(self) -> Vec4

fn xyzx(self) -> Vec4

fn xyzy(self) -> Vec4

fn xyzz(self) -> Vec4

fn xzxx(self) -> Vec4

fn xzxy(self) -> Vec4

fn xzxz(self) -> Vec4

fn xzyx(self) -> Vec4

fn xzyy(self) -> Vec4

fn xzyz(self) -> Vec4

fn xzzx(self) -> Vec4

fn xzzy(self) -> Vec4

fn xzzz(self) -> Vec4

fn yxxx(self) -> Vec4

fn yxxy(self) -> Vec4

fn yxxz(self) -> Vec4

fn yxyx(self) -> Vec4

fn yxyy(self) -> Vec4

fn yxyz(self) -> Vec4

fn yxzx(self) -> Vec4

fn yxzy(self) -> Vec4

fn yxzz(self) -> Vec4

fn yyxx(self) -> Vec4

fn yyxy(self) -> Vec4

fn yyxz(self) -> Vec4

fn yyyx(self) -> Vec4

fn yyyy(self) -> Vec4

fn yyyz(self) -> Vec4

fn yyzx(self) -> Vec4

fn yyzy(self) -> Vec4

fn yyzz(self) -> Vec4

fn yzxx(self) -> Vec4

fn yzxy(self) -> Vec4

fn yzxz(self) -> Vec4

fn yzyx(self) -> Vec4

fn yzyy(self) -> Vec4

fn yzyz(self) -> Vec4

fn yzzx(self) -> Vec4

fn yzzy(self) -> Vec4

fn yzzz(self) -> Vec4

fn zxxx(self) -> Vec4

fn zxxy(self) -> Vec4

fn zxxz(self) -> Vec4

fn zxyx(self) -> Vec4

fn zxyy(self) -> Vec4

fn zxyz(self) -> Vec4

fn zxzx(self) -> Vec4

fn zxzy(self) -> Vec4

fn zxzz(self) -> Vec4

fn zyxx(self) -> Vec4

fn zyxy(self) -> Vec4

fn zyxz(self) -> Vec4

fn zyyx(self) -> Vec4

fn zyyy(self) -> Vec4

fn zyyz(self) -> Vec4

fn zyzx(self) -> Vec4

fn zyzy(self) -> Vec4

fn zyzz(self) -> Vec4

fn zzxx(self) -> Vec4

fn zzxy(self) -> Vec4

fn zzxz(self) -> Vec4

fn zzyx(self) -> Vec4

fn zzyy(self) -> Vec4

fn zzyz(self) -> Vec4

fn zzzx(self) -> Vec4

fn zzzy(self) -> Vec4

fn zzzz(self) -> Vec4

fn xyz(self) -> Self

impl VectorSpace for Vec3A

const ZERO: Self = Vec3A::ZERO

The zero vector, which is the identity of addition for the vector space type.

type Scalar = f32

The scalar type of this vector space.

fn lerp(self, rhs: Self, t: Self::Scalar) -> Self

Perform vector space linear interpolation between this element and another, based on the parameter t. When t is 0, self is recovered. When t is 1, rhs is recovered.

impl Zeroable for Vec3A

fn zeroed() -> Self

Calls zeroed.

impl Copy for Vec3A

impl Pod for Vec3A