Struct ico_math::Vector2

#[repr(C)]
pub struct Vector2 {
    pub data: __m128,
}

A vector of 2 floats (x,y).

Fields

data: __m128

Methods

impl Vector2

pub fn new(x: f32, y: f32) -> Vector2

Construct a new vector from f32 components.

pub fn set<T: Into<FloatVector>>(value: T) -> Vector2

Set all values of the vector to the same f32 value.

pub fn zero() -> Vector2

Construct a new vector of zeros.

pub fn x(self) -> FloatVector

Get the x value of the vector, broadcast to all components as a FloatVector (xxxx).

pub fn y(self) -> FloatVector

Get the y value of the vector, broadcast to all components as a FloatVector (yyyy).

pub fn load(raw: &RawVector_f32) -> Vector2

Load a value from aligned memory.

pub fn store(self, dst: &mut RawVector_f32)

Store a value to aligned memory.

pub fn set_x<T: Into<FloatVector>>(&mut self, value: T)

Set the x value of this vector, leaving the other components unchanged.

pub fn set_y<T: Into<FloatVector>>(&mut self, value: T)

Set the y value of this vector, leaving the other components unchanged.

pub fn dot(self, v1: Vector2) -> FloatVector

Compute the 2 element dot-product, and return it as a broadcast FloatVector.

pub fn rotate<T: Into<FloatVector>>(self, radians: T) -> Vector2

Rotate the vector by radians Right handed system, positive rotation is counterclockwise about the axis of rotation.

pub fn add(self, v2: Vector2) -> Vector2

Compute the sum of two vectors and return it as a new vector.

pub fn sub(self, v2: Vector2) -> Vector2

Subtract a vector and return it as a new vector.

pub fn mul(self, v2: Vector2) -> Vector2

Multiply two vectors component-wise, and return it as a new vector.
(x1 * x2, y1 * y2, z1 * z2, w1 * w2)

pub fn div(self, v2: Vector2) -> Vector2

Divide two vectors component-wise, and return it as a new vector.
(x1 / x2, y1 / y2, z1 / z2, w1 / w2)

pub fn mul_add(self, v2: Vector2, v3: Vector2) -> Vector2

Fused Multiply Add. Result = (a * b) + c.

pub fn mul_sub(self, v2: Vector2, v3: Vector2) -> Vector2

Fused Multiply Sub. Result = (a * b) - c.

pub fn neg_mul_add(self, v2: Vector2, v3: Vector2) -> Vector2

Negated Fused Multiply Add. Result = -(a * b) + c.

pub fn neg_mul_sub(self, v2: Vector2, v3: Vector2) -> Vector2

Negated Fused Multiply Sub. Result = -(a * b) - c.

pub fn and<T: SIMDVector2>(self, v2: T) -> Vector2

Compute the bitwise AND of two vectors. This function treats inputs as binary data, and doesn't perform any conversions.

pub fn or<T: SIMDVector2>(self, v2: T) -> Vector2

Compute the bitwise OR of two vectors. This function treats inputs as binary data, and doesn't perform any conversions.

pub fn andnot<T: SIMDVector2>(self, v2: T) -> Vector2

Compute the bitwise ANDNOT of two vectors. This function treats inputs as binary data, and doesn't perform any conversions.

pub fn xor<T: SIMDVector2>(self, v2: T) -> Vector2

Compute the bitwise XOR of two vectors. This function treats inputs as binary data, and doesn't perform any conversions.

pub fn equal(self, v2: Vector2) -> Vector2Bool

Equals, computed component-wise. This compares bits, and is exact.

pub fn not_equal(self, v2: Vector2) -> Vector2Bool

NotEquals, computed component-wise. This compares bits, and is exact.

pub fn greater_equal(self, v2: Vector2) -> Vector2Bool

Greater than or equal to, computed component-wise. This compares bits, and is exact.

pub fn greater(self, v2: Vector2) -> Vector2Bool

Greater than, computed component-wise. This compares bits, and is exact.

pub fn less_equal(self, v2: Vector2) -> Vector2Bool

Less than or equal to, computed component-wise. This compares bits, and is exact.

pub fn less(self, v2: Vector2) -> Vector2Bool

Less than, computed component-wise. This compares bits, and is exact.

pub fn approx_equal(self, v2: Vector2) -> Vector2Bool

Relative and absolute epsilon comparison.
Uses machine epsilon as absolute, and 4*machine epsilon for relative. return abs(a - b) <= max(machine_epsilon, (max( abs(a), abs(b) ) * relative_epsilon); Adapted from Knuth.
https://randomascii.wordpress.com/2012/02/25/comparing-floating-point-numbers-2012-edition/

pub fn definitely_greater(self, v2: Vector2) -> Vector2Bool

Adapted from Knuth with an added absolute epsilon return (a - b) > max(machine_epsilon, (max( abs(a), abs(b) ) * relative_epsilon);

pub fn definitely_less(self, v2: Vector2) -> Vector2Bool

Adapted from Knuth with an added absolute epsilon return (a - b) > max(machine_epsilon, (max( abs(a), abs(b) ) * relative_epsilon);

pub fn abs(self) -> Vector2

The absolute value of each component of the vector.

pub fn copysign(self, v2: Vector2) -> Vector2

Take the magnitude of the first argument (self), and use the sign of the second argument to produce a new vector

pub fn floor(self) -> Vector2

Floor function. Returns signed 0 when applicable.

pub fn ceil(self) -> Vector2

Ceil function. Returns signed 0 when applicable.

pub fn round(self) -> Vector2

Round to nearest even function. Returns signed 0 when applicable.

pub fn truncate(self) -> Vector2

Truncate function.

pub fn floor_to_int(self) -> Vector2Int

Convert to an integer vector using the floor function.

pub fn ceil_to_int(self) -> Vector2Int

Convert to an integer vector using the ceil function.

pub fn round_to_int(self) -> Vector2Int

Convert to an integer vector using the round function.

pub fn truncate_to_int(self) -> Vector2Int

Convert to an integer vector using the truncate function.

pub fn frac(self) -> Vector2

Compute the fractional component of each component Result = X - Floor(x)

pub fn sqrt(self) -> Vector2

Compute the square root of each component

pub fn sin(self) -> Vector2

Compute the approximate sin of each component

pub fn cos(self) -> Vector2

Compute the approximate cos of each component

pub fn tan(self) -> Vector2

Compute the approximate tan of each component

pub fn acos(self) -> Vector2

Compute the approximate acos of each component

pub fn asin(self) -> Vector2

Compute the approximate asin of each component

pub fn atan2(self, x: Vector2) -> Vector2

pub fn max(self, v2: Vector2) -> Vector2

Compute the component-wise max.

pub fn min(self, v2: Vector2) -> Vector2

Compute the component-wise min.

pub fn horizontal_min(self) -> FloatVector

pub fn horizontal_max(self) -> FloatVector

pub fn select(self, v2: Vector2, mask: Vector2Bool) -> Vector2

Choose component wise between A and B based on the mask. False = A, True = B.

pub fn lerp<T: Into<FloatVector>>(self, v2: Vector2, t: T) -> Vector2

Linear interpolate from a to b based on a float.

pub fn normalize(self) -> Vector2

Normalize the vector. Returns a zero vector if the result would be infinity or NAN.

pub fn normalize_length(self) -> (Vector2, FloatVector)

Normalize the vector. Returns a zero vector if the result would be infinity or NAN. Also returns the length of the vector prior to normalization.

pub fn sqr_magnitude(self) -> FloatVector

The square magnitude of the vector. Equal to Dot(self, self).

pub fn magnitude(self) -> FloatVector

The magnitude of the vector. Equal to Sqrt(Dot(self, self)).

pub fn xxxx(self) -> Vector4

pub fn yyyy(self) -> Vector4

pub fn xx(self) -> Vector2

pub fn xy(self) -> Vector2

pub fn yx(self) -> Vector2

pub fn yy(self) -> Vector2

Trait Implementations

impl SIMDVector2 for Vector2

fn data(self) -> __m128

fn data_i(self) -> __m128i

impl Clone for Vector2

fn clone(&self) -> Vector2

Returns a copy of the value.

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

Performs copy-assignment from source.

impl From<f32> for Vector2

fn from(v: f32) -> Vector2

Performs the conversion.

impl From<FloatVector> for Vector2

fn from(v: FloatVector) -> Vector2

Performs the conversion.

impl From<Vector3> for Vector2

fn from(v: Vector3) -> Vector2

Performs the conversion.

impl From<Vector4> for Vector2

fn from(v: Vector4) -> Vector2

Performs the conversion.

impl From<Vector2Int> for Vector2

fn from(v: Vector2Int) -> Vector2

Performs the conversion.

impl From<Vector2> for Vector2Int

fn from(v: Vector2) -> Vector2Int

Performs the conversion.

impl From<Vector2> for Vector3

fn from(v: Vector2) -> Vector3

Performs the conversion.

impl From<Vector2> for Vector4

fn from(v: Vector2) -> Vector4

Performs the conversion.

impl PartialEq<Vector2> for Vector2

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

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

#[must_use] fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl Copy for Vector2

impl Debug for Vector2

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

Formats the value using the given formatter.

impl<T: Into<FloatVector>> Div<T> for Vector2

type Output = Vector2

The resulting type after applying the / operator.

fn div(self, _rhs: T) -> Vector2

Performs the / operation.

impl Div<Vector2> for FloatVector

type Output = Vector2

The resulting type after applying the / operator.

fn div(self: FloatVector, _rhs: Vector2) -> Vector2

Performs the / operation.

impl Add<Vector2> for Vector2

type Output = Vector2

The resulting type after applying the + operator.

fn add(self, _rhs: Vector2) -> Vector2

Performs the + operation.

impl Sub<Vector2> for Vector2

type Output = Vector2

The resulting type after applying the - operator.

fn sub(self, _rhs: Vector2) -> Vector2

Performs the - operation.

impl<T: Into<FloatVector>> Mul<T> for Vector2

type Output = Vector2

The resulting type after applying the * operator.

fn mul(self, _rhs: T) -> Vector2

Performs the * operation.

impl Mul<Vector2> for FloatVector

type Output = Vector2

The resulting type after applying the * operator.

fn mul(self: FloatVector, _rhs: Vector2) -> Vector2

Performs the * operation.

impl Neg for Vector2

type Output = Vector2

The resulting type after applying the - operator.

fn neg(self) -> Self::Output

Performs the unary - operation.

impl AddAssign<Vector2> for Vector2

fn add_assign(&mut self, other: Vector2)

Performs the += operation.

impl SubAssign<Vector2> for Vector2

fn sub_assign(&mut self, other: Vector2)

Performs the -= operation.

impl<T: Into<FloatVector>> MulAssign<T> for Vector2

fn mul_assign(&mut self, _rhs: T)

Performs the *= operation.

impl<T: Into<FloatVector>> DivAssign<T> for Vector2

fn div_assign(&mut self, _rhs: T)

Performs the /= operation.