Struct rerun::external::glam::DVec2

#[repr(C)]
pub struct DVec2 {
    pub x: f64,
    pub y: f64,
}

A 2-dimensional vector.

Fields

x: f64

y: f64

Implementations

impl DVec2

pub const ZERO: DVec2 = _

All zeroes.

pub const ONE: DVec2 = _

All ones.

pub const NEG_ONE: DVec2 = _

All negative ones.

pub const MIN: DVec2 = _

All f64::MIN.

pub const MAX: DVec2 = _

All f64::MAX.

pub const NAN: DVec2 = _

All f64::NAN.

pub const INFINITY: DVec2 = _

All f64::INFINITY.

pub const NEG_INFINITY: DVec2 = _

All f64::NEG_INFINITY.

pub const X: DVec2 = _

A unit vector pointing along the positive X axis.

pub const Y: DVec2 = _

A unit vector pointing along the positive Y axis.

pub const NEG_X: DVec2 = _

A unit vector pointing along the negative X axis.

pub const NEG_Y: DVec2 = _

A unit vector pointing along the negative Y axis.

pub const AXES: [DVec2; 2] = _

The unit axes.

pub const fn new(x: f64, y: f64) -> DVec2

Creates a new vector.

pub const fn splat(v: f64) -> DVec2

Creates a vector with all elements set to v.

pub fn select(mask: BVec2, if_true: DVec2, if_false: DVec2) -> DVec2

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: [f64; 2]) -> DVec2

Creates a new vector from an array.

pub const fn to_array(&self) -> [f64; 2]

[x, y]

pub const fn from_slice(slice: &[f64]) -> DVec2

Creates a vector from the first 2 values in slice.

Panics

Panics if slice is less than 2 elements long.

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

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

Panics

Panics if slice is less than 2 elements long.

pub const fn extend(self, z: f64) -> DVec3

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

pub fn with_x(self, x: f64) -> DVec2

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

pub fn with_y(self, y: f64) -> DVec2

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

pub fn dot(self, rhs: DVec2) -> f64

Computes the dot product of self and rhs.

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

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

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

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

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

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

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

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

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

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

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

Panics

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

pub fn min_element(self) -> f64

Returns the horizontal minimum of self.

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

pub fn max_element(self) -> f64

Returns the horizontal maximum of self.

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

pub fn element_sum(self) -> f64

Returns the sum of all elements of self.

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

pub fn element_product(self) -> f64

Returns the product of all elements of self.

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

pub fn cmpeq(self, rhs: DVec2) -> BVec2

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: DVec2) -> BVec2

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: DVec2) -> BVec2

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: DVec2) -> BVec2

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: DVec2) -> BVec2

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: DVec2) -> BVec2

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) -> DVec2

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

pub fn signum(self) -> DVec2

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: DVec2) -> DVec2

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 2 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.

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_nan(self) -> bool

Returns true if any elements are NaN.

pub fn is_nan_mask(self) -> BVec2

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(), z.is_nan(), w.is_nan()].

pub fn length(self) -> f64

Computes the length of self.

pub fn length_squared(self) -> f64

Computes the squared length of self.

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

pub fn length_recip(self) -> f64

Computes 1.0 / length().

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

pub fn distance(self, rhs: DVec2) -> f64

Computes the Euclidean distance between two points in space.

pub fn distance_squared(self, rhs: DVec2) -> f64

Compute the squared euclidean distance between two points in space.

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

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

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

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

pub fn normalize(self) -> DVec2

Returns self normalized to length 1.0.

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

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

Panics

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

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

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: DVec2) -> DVec2

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) -> DVec2

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 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: DVec2) -> DVec2

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: DVec2) -> DVec2

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: DVec2) -> DVec2

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: DVec2) -> DVec2

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) -> DVec2

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) -> DVec2

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

pub fn ceil(self) -> DVec2

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

pub fn trunc(self) -> DVec2

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

pub fn fract(self) -> DVec2

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) -> DVec2

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) -> DVec2

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

pub fn powf(self, n: f64) -> DVec2

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

pub fn recip(self) -> DVec2

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

pub fn lerp(self, rhs: DVec2, s: f64) -> DVec2

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: DVec2, d: f64) -> DVec2

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: DVec2) -> DVec2

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: DVec2, max_abs_diff: f64) -> 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: f64, max: f64) -> DVec2

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: f64) -> DVec2

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: f64) -> DVec2

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: DVec2, b: DVec2) -> DVec2

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 from_angle(angle: f64) -> DVec2

Creates a 2D vector containing [angle.cos(), angle.sin()]. This can be used in conjunction with the rotate() method, e.g. DVec2::from_angle(PI).rotate(DVec2::Y) will create the vector [-1, 0] and rotate DVec2::Y around it returning -DVec2::Y.

pub fn to_angle(self) -> f64

Returns the angle (in radians) of this vector in the range [-π, +π].

The input does not need to be a unit vector however it must be non-zero.

pub fn angle_between(self, rhs: DVec2) -> f64

👎Deprecated since 0.27.0: Use angle_to() instead, the semantics of angle_between will change in the future.

pub fn angle_to(self, rhs: DVec2) -> f64

Returns the angle of rotation (in radians) from self to rhs in the range [-π, +π].

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

pub fn perp(self) -> DVec2

Returns a vector that is equal to self rotated by 90 degrees.

pub fn perp_dot(self, rhs: DVec2) -> f64

The perpendicular dot product of self and rhs. Also known as the wedge product, 2D cross product, and determinant.

pub fn rotate(self, rhs: DVec2) -> DVec2

Returns rhs rotated by the angle of self. If self is normalized, then this just rotation. This is what you usually want. Otherwise, it will be like a rotation with a multiplication by self’s length.

pub fn rotate_towards(&self, rhs: DVec2, max_angle: f64) -> DVec2

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 equal to rhs. If max_angle is negative, rotates towards the exact opposite of rhs. Will not go past the target.

pub fn as_vec2(&self) -> Vec2

Casts all elements of self to f32.

pub fn as_i16vec2(&self) -> I16Vec2

Casts all elements of self to i16.

pub fn as_u16vec2(&self) -> U16Vec2

Casts all elements of self to u16.

pub fn as_ivec2(&self) -> IVec2

Casts all elements of self to i32.

pub fn as_uvec2(&self) -> UVec2

Casts all elements of self to u32.

pub fn as_i64vec2(&self) -> I64Vec2

Casts all elements of self to i64.

pub fn as_u64vec2(&self) -> U64Vec2

Casts all elements of self to u64.

Trait Implementations

impl Add<DVec2> for f64

type Output = DVec2

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add<f64> for DVec2

type Output = DVec2

The resulting type after applying the + operator.

fn add(self, rhs: f64) -> DVec2

Performs the + operation.

impl Add for DVec2

type Output = DVec2

The resulting type after applying the + operator.

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

Performs the + operation.

impl AddAssign<f64> for DVec2

fn add_assign(&mut self, rhs: f64)

Performs the += operation.

impl AddAssign for DVec2

fn add_assign(&mut self, rhs: DVec2)

Performs the += operation.

impl AsMut<[f64; 2]> for DVec2

fn as_mut(&mut self) -> &mut [f64; 2]

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

impl AsRef<[f64; 2]> for DVec2

fn as_ref(&self) -> &[f64; 2]

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

impl Clone for DVec2

fn clone(&self) -> DVec2

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for DVec2

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

Formats the value using the given formatter.

impl Default for DVec2

fn default() -> DVec2

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for DVec2

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for DVec2

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

Formats the value using the given formatter.

impl Div<DVec2> for f64

type Output = DVec2

The resulting type after applying the / operator.

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

Performs the / operation.

impl Div<f64> for DVec2

type Output = DVec2

The resulting type after applying the / operator.

fn div(self, rhs: f64) -> DVec2

Performs the / operation.

impl Div for DVec2

type Output = DVec2

The resulting type after applying the / operator.

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

Performs the / operation.

impl DivAssign<f64> for DVec2

fn div_assign(&mut self, rhs: f64)

Performs the /= operation.

impl DivAssign for DVec2

fn div_assign(&mut self, rhs: DVec2)

Performs the /= operation.

impl From<[f64; 2]> for DVec2

fn from(a: [f64; 2]) -> DVec2

Converts to this type from the input type.

impl From<(f64, f64)> for DVec2

fn from(t: (f64, f64)) -> DVec2

Converts to this type from the input type.

impl From<BVec2> for DVec2

fn from(v: BVec2) -> DVec2

Converts to this type from the input type.

impl From<DVec2> for [f64; 2]

fn from(v: DVec2) -> [f64; 2]

Converts to this type from the input type.

impl From<IVec2> for DVec2

fn from(v: IVec2) -> DVec2

Converts to this type from the input type.

impl From<UVec2> for DVec2

fn from(v: UVec2) -> DVec2

Converts to this type from the input type.

impl From<Vec2> for DVec2

fn from(v: Vec2) -> DVec2

Converts to this type from the input type.

impl Index<usize> for DVec2

type Output = f64

The returned type after indexing.

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

Performs the indexing (container[index]) operation.

impl IndexMut<usize> for DVec2

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

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

impl Mul<DVec2> for DMat2

type Output = DVec2

The resulting type after applying the * operator.

fn mul(self, rhs: DVec2) -> <DMat2 as Mul<DVec2>>::Output

Performs the * operation.

impl Mul<DVec2> for f64

type Output = DVec2

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<f64> for DVec2

type Output = DVec2

The resulting type after applying the * operator.

fn mul(self, rhs: f64) -> DVec2

Performs the * operation.

impl Mul for DVec2

type Output = DVec2

The resulting type after applying the * operator.

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

Performs the * operation.

impl MulAssign<f64> for DVec2

fn mul_assign(&mut self, rhs: f64)

Performs the *= operation.

impl MulAssign for DVec2

fn mul_assign(&mut self, rhs: DVec2)

Performs the *= operation.

impl Neg for DVec2

type Output = DVec2

The resulting type after applying the - operator.

fn neg(self) -> DVec2

Performs the unary - operation.

impl PartialEq for DVec2

fn eq(&self, other: &DVec2) -> bool

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

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

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

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

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

Method which takes an iterator and generates Self from the elements by multiplying the items.

impl Product for DVec2

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

where I: Iterator<Item = DVec2>,

Method which takes an iterator and generates Self from the elements by multiplying the items.

impl Rem<DVec2> for f64

type Output = DVec2

The resulting type after applying the % operator.

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

Performs the % operation.

impl Rem<f64> for DVec2

type Output = DVec2

The resulting type after applying the % operator.

fn rem(self, rhs: f64) -> DVec2

Performs the % operation.

impl Rem for DVec2

type Output = DVec2

The resulting type after applying the % operator.

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

Performs the % operation.

impl RemAssign<f64> for DVec2

fn rem_assign(&mut self, rhs: f64)

Performs the %= operation.

impl RemAssign for DVec2

fn rem_assign(&mut self, rhs: DVec2)

Performs the %= operation.

impl Serialize for DVec2

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<DVec2> for f64

type Output = DVec2

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<f64> for DVec2

type Output = DVec2

The resulting type after applying the - operator.

fn sub(self, rhs: f64) -> DVec2

Performs the - operation.

impl Sub for DVec2

type Output = DVec2

The resulting type after applying the - operator.

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

Performs the - operation.

impl SubAssign<f64> for DVec2

fn sub_assign(&mut self, rhs: f64)

Performs the -= operation.

impl SubAssign for DVec2

fn sub_assign(&mut self, rhs: DVec2)

Performs the -= operation.

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

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

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

Method which takes an iterator and generates Self from the elements by “summing up” the items.

impl Sum for DVec2

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

where I: Iterator<Item = DVec2>,

Method which takes an iterator and generates Self from the elements by “summing up” the items.

impl Vec2Swizzles for DVec2

type Vec3 = DVec3

type Vec4 = DVec4

fn xx(self) -> DVec2

fn xy(self) -> DVec2

fn yx(self) -> DVec2

fn yy(self) -> DVec2

fn xxx(self) -> DVec3

fn xxy(self) -> DVec3

fn xyx(self) -> DVec3

fn xyy(self) -> DVec3

fn yxx(self) -> DVec3

fn yxy(self) -> DVec3

fn yyx(self) -> DVec3

fn yyy(self) -> DVec3

fn xxxx(self) -> DVec4

fn xxxy(self) -> DVec4

fn xxyx(self) -> DVec4

fn xxyy(self) -> DVec4

fn xyxx(self) -> DVec4

fn xyxy(self) -> DVec4

fn xyyx(self) -> DVec4

fn xyyy(self) -> DVec4

fn yxxx(self) -> DVec4

fn yxxy(self) -> DVec4

fn yxyx(self) -> DVec4

fn yxyy(self) -> DVec4

fn yyxx(self) -> DVec4

fn yyxy(self) -> DVec4

fn yyyx(self) -> DVec4

fn yyyy(self) -> DVec4

impl Zeroable for DVec2

fn zeroed() -> Self

Calls zeroed.

impl Copy for DVec2

impl Pod for DVec2

impl StructuralPartialEq for DVec2