Open 3D Engine AzCore API Reference 25.10.0
O3DE is an open-source, fully-featured, high-fidelity, modular 3D engine for building games and simulations, available to every industry.
Public Member Functions | Static Public Member Functions | List of all members
AZ::Vector2 Class Reference

2-dimensional vector class. More...

#include <Vector2.h>

Public Member Functions

 AZ_TYPE_INFO (Vector2, "{3D80F623-C85C-4741-90D0-E4E66164E6BF}")
 
 Vector2 ()=default
 Default constructor, components are uninitialized.
 
 Vector2 (const Vector2 &v)=default
 
 Vector2 (float x)
 Constructs vector with all components set to the same specified value.
 
 Vector2 (float x, float y)
 
 Vector2 (const Vector3 &source)
 
 Vector2 (const Vector4 &source)
 
 Vector2 (Simd::Vec2::FloatArgType value)
 For internal use only, arrangement of values in SIMD type is not guaranteed.
 
void StoreToFloat2 (float *values) const
 
float GetX () const
 
float GetY () const
 
void SetX (float x)
 
void SetY (float y)
 
float GetElement (int index) const
 
void SetElement (int index, float value)
 
void Set (float x)
 
void Set (float x, float y)
 
float operator() (int index) const
 Indexed access using operator().
 
float GetLengthSq () const
 Returns squared length of the vector.
 
float GetLength () const
 Returns length of the vector, full accuracy.
 
float GetLengthEstimate () const
 Returns length of the vector, fast but low accuracy, uses raw estimate instructions.
 
float GetLengthReciprocal () const
 Returns 1/length, full accuracy.
 
float GetLengthReciprocalEstimate () const
 Returns 1/length of the vector, fast but low accuracy, uses raw estimate instructions.
 
Vector2 GetNormalized () const
 Returns normalized vector, full accuracy.
 
Vector2 GetNormalizedEstimate () const
 Returns normalized vector, fast but low accuracy, uses raw estimate instructions.
 
void Normalize ()
 Normalizes the vector in-place, full accuracy.
 
void NormalizeEstimate ()
 Normalizes the vector in-place, fast but low accuracy, uses raw estimate instructions.
 
bool IsNormalized (float tolerance=Constants::Tolerance) const
 
void SetLength (float length)
 Scales the vector to have the specified length, full accuracy.
 
void SetLengthEstimate (float length)
 Scales the vector to have the specified length, fast but low accuracy, uses raw estimate instructions.
 
float GetDistanceSq (const Vector2 &v) const
 Returns squared distance to another Vector2.
 
Vector2 Lerp (const Vector2 &dest, float t) const
 
Vector2 Slerp (const Vector2 &dest, float t) const
 
Vector2 Nlerp (const Vector2 &dest, float t) const
 
Vector2 GetPerpendicular () const
 
bool IsClose (const Vector2 &v, float tolerance=0.001f) const
 Checks the vector is equal to another within a floating point tolerance.
 
bool IsZero (float tolerance=AZ::Constants::FloatEpsilon) const
 
bool operator== (const Vector2 &rhs) const
 
bool operator!= (const Vector2 &rhs) const
 
Vector2 GetSelect (const Vector2 &vCmp, const Vector2 &vB)
 
void Select (const Vector2 &vCmp, const Vector2 &vB)
 
Vector2 GetAbs () const
 
Vector2 & operator+= (const Vector2 &rhs)
 
Vector2 & operator-= (const Vector2 &rhs)
 
Vector2 & operator*= (const Vector2 &rhs)
 
Vector2 & operator/= (const Vector2 &rhs)
 
Vector2 & operator*= (float multiplier)
 
Vector2 & operator/= (float divisor)
 
Vector2 operator- () const
 
Vector2 operator+ (const Vector2 &rhs) const
 
Vector2 operator- (const Vector2 &rhs) const
 
Vector2 operator* (const Vector2 &rhs) const
 
Vector2 operator* (float multiplier) const
 
Vector2 operator/ (float divisor) const
 
Vector2 operator/ (const Vector2 &rhs) const
 
Vector2 GetSin () const
 Gets the sine of each component.
 
Vector2 GetCos () const
 Gets the cosine of each component.
 
void GetSinCos (Vector2 &sin, Vector2 &cos) const
 Gets the sine and cosine of each component, quicker than calling GetSin and GetCos separately.
 
Vector2 GetAcos () const
 Gets the arccosine of each component.
 
Vector2 GetAtan () const
 Gets the arctangent of each component.
 
float GetAtan2 () const
 Gets the angle between the positive x-axis and the ray to the point (x,y). (-pi,pi].
 
Vector2 GetAngleMod () const
 Wraps the angle in each component into the [-pi,pi] range.
 
float Angle (const Vector2 &v) const
 
float AngleDeg (const Vector2 &v) const
 
float AngleSafe (const Vector2 &v) const
 Calculates the closest angle(radians) towards the given vector with in the [0, pi] range.
 
float AngleSafeDeg (const Vector2 &v) const
 Calculates the closest angle(degrees) towards the given vector with in the [0, 180] range.
 
Vector2 GetReciprocal () const
 Returns the reciprocal of each component of the vector, full accuracy.
 
Vector2 GetReciprocalEstimate () const
 Returns the reciprocal of each component of the vector, fast but low accuracy, uses raw estimate instructions.
 
float Dot (const Vector2 &rhs) const
 Dot product of two vectors.
 
Vector2 GetMadd (const Vector2 &mul, const Vector2 &add)
 Perform multiply-add operator (this = this * mul + add).
 
void Madd (const Vector2 &mul, const Vector2 &add)
 
void Project (const Vector2 &rhs)
 
void ProjectOnNormal (const Vector2 &normal)
 
Vector2 GetProjected (const Vector2 &rhs) const
 
Vector2 GetProjectedOnNormal (const Vector2 &normal)
 
bool IsFinite () const
 Returns true if the vector contains no nan or inf values, false if at least one element is not finite.
 
Simd::Vec2::FloatType GetSimdValue () const
 Returns the underlying SIMD vector.
 
void SetSimdValue (Simd::Vec2::FloatArgType value)
 Directly sets the underlying SIMD vector.
 
float NormalizeWithLength ()
 
float NormalizeWithLengthEstimate ()
 
Vector2 GetNormalizedSafe (float tolerance=Constants::Tolerance) const
 
Vector2 GetNormalizedSafeEstimate (float tolerance=Constants::Tolerance) const
 
void NormalizeSafe (float tolerance=Constants::Tolerance)
 
void NormalizeSafeEstimate (float tolerance=Constants::Tolerance)
 
float NormalizeSafeWithLength (float tolerance=Constants::Tolerance)
 
float NormalizeSafeWithLengthEstimate (float tolerance=Constants::Tolerance)
 
float GetDistance (const Vector2 &v) const
 
float GetDistanceEstimate (const Vector2 &v) const
 
bool IsLessThan (const Vector2 &v) const
 
bool IsLessEqualThan (const Vector2 &v) const
 
bool IsGreaterThan (const Vector2 &v) const
 
bool IsGreaterEqualThan (const Vector2 &v) const
 
Vector2 GetFloor () const
 
Vector2 GetCeil () const
 
Vector2 GetRound () const
 
Vector2 GetMin (const Vector2 &v) const
 
Vector2 GetMax (const Vector2 &v) const
 
Vector2 GetClamp (const Vector2 &min, const Vector2 &max) const
 

Static Public Member Functions

static void Reflect (ReflectContext *context)
 
static Vector2 CreateZero ()
 Creates a vector with all components set to zero, more efficient than calling Vector2(0.0f).
 
static Vector2 CreateOne ()
 Creates a vector with all components set to one.
 
static Vector2 CreateAxisX (float length=1.0f)
 
static Vector2 CreateAxisY (float length=1.0f)
 
static Vector2 CreateFromFloat2 (const float *values)
 Sets components from an array of 2 floats, stored in xy order.
 
static Vector2 CreateFromAngle (float angle=0.0f)
 Creates a normalized Vector2 from an angle in radians.
 
static Vector2 CreateSelectCmpEqual (const Vector2 &cmp1, const Vector2 &cmp2, const Vector2 &vA, const Vector2 &vB)
 operation r.x = (cmp1.x == cmp2.x) ? vA.x : vB.x per component.
 
static Vector2 CreateSelectCmpGreaterEqual (const Vector2 &cmp1, const Vector2 &cmp2, const Vector2 &vA, const Vector2 &vB)
 operation ( r.x = (cmp1.x >= cmp2.x) ? vA.x : vB.x ) per component.
 
static Vector2 CreateSelectCmpGreater (const Vector2 &cmp1, const Vector2 &cmp2, const Vector2 &vA, const Vector2 &vB)
 operation ( r.x = (cmp1.x > cmp2.x) ? vA.x : vB.x ) per component.
 

Detailed Description

2-dimensional vector class.

Member Function Documentation

◆ Angle()

AZ_MATH_INLINE float AZ::Vector2::Angle ( const Vector2 &  v) const

Calculates the closest angle(radians) towards the given vector with in the [0, pi] range. Note: It's unsafe if any of the vectors are (0, 0)

◆ AngleDeg()

AZ_MATH_INLINE float AZ::Vector2::AngleDeg ( const Vector2 &  v) const

Calculates the closest angle(degrees) towards the given vector with in the [0, 180] range. Note: It's unsafe if any of the vectors are (0, 0)

◆ GetDistance()

AZ_MATH_INLINE float AZ::Vector2::GetDistance ( const Vector2 &  v) const

Returns distance to another Vector2.

◆ GetFloor()

AZ_MATH_INLINE Vector2 AZ::Vector2::GetFloor ( ) const

Floor/Ceil/Round functions, operate on each component individually, result will be a new Vector2.

◆ GetMin()

AZ_MATH_INLINE Vector2 AZ::Vector2::GetMin ( const Vector2 &  v) const

Min/Max functions, operate on each component individually, result will be a new Vector2.

◆ GetNormalizedSafe()

AZ_MATH_INLINE Vector2 AZ::Vector2::GetNormalizedSafe ( float  tolerance = Constants::Tolerance) const

Safe normalization, returns (0,0) if the length of the vector is too small.

◆ GetPerpendicular()

AZ_MATH_INLINE Vector2 AZ::Vector2::GetPerpendicular ( ) const

Gets perpendicular vector, i.e. rotates through 90 degrees. The positive rotation direction is defined such that the x-axis is rotated into the y-axis.

◆ GetProjected()

AZ_MATH_INLINE Vector2 AZ::Vector2::GetProjected ( const Vector2 &  rhs) const

Project this vector onto another and return the resulting projection. P = (a.Dot(b) / b.Dot(b)) * b

◆ GetProjectedOnNormal()

AZ_MATH_INLINE Vector2 AZ::Vector2::GetProjectedOnNormal ( const Vector2 &  normal)

Project this vector onto a normal and return the resulting projection. P = (v.Dot(Normal) * normal)

◆ GetSelect()

AZ_MATH_INLINE Vector2 AZ::Vector2::GetSelect ( const Vector2 &  vCmp,
const Vector2 &  vB 
)

Vector select operation (vR = (vCmp==0) ? vA : vB). This is a special case (from CmpEqual) and it's a lot faster

◆ IsLessThan()

AZ_MATH_INLINE bool AZ::Vector2::IsLessThan ( const Vector2 &  v) const

Comparison functions, not implemented as operators since that would probably be a little dangerous. These functions return true only if all components pass the comparison test.

◆ Lerp()

AZ_MATH_INLINE Vector2 AZ::Vector2::Lerp ( const Vector2 &  dest,
float  t 
) const

Linear interpolation between this vector and a destination.

Returns
(this)(1-t) + dest*t

◆ Nlerp()

AZ_MATH_INLINE Vector2 AZ::Vector2::Nlerp ( const Vector2 &  dest,
float  t 
) const

Normalized linear interpolation between this vector and a destination. Linearly interpolates between the two vectors and normalizes the result.

◆ NormalizeWithLength()

AZ_MATH_INLINE float AZ::Vector2::NormalizeWithLength ( )

Normalizes the vector in-place and returns the previous length. This takes a few more instructions than calling just Normalize().

◆ Project()

AZ_MATH_INLINE void AZ::Vector2::Project ( const Vector2 &  rhs)

Project vector onto another. P = (a.Dot(b) / b.Dot(b)) * b

◆ ProjectOnNormal()

AZ_MATH_INLINE void AZ::Vector2::ProjectOnNormal ( const Vector2 &  normal)

Project vector onto a normal (faster function). P = (v.Dot(Normal) * normal)

◆ Reflect()

static void AZ::Vector2::Reflect ( ReflectContext *  context)
static

AzCore Reflection.

Parameters
contextreflection context

◆ Slerp()

AZ_MATH_INLINE Vector2 AZ::Vector2::Slerp ( const Vector2 &  dest,
float  t 
) const

Spherical linear interpolation between normalized vectors. Interpolates along the great circle connecting the two vectors.

◆ StoreToFloat2()

AZ_MATH_INLINE void AZ::Vector2::StoreToFloat2 ( float *  values) const

Stores the vector to an array of 2 floats. The floats need only be 4 byte aligned, 16 byte alignment is not required.

The documentation for this class was generated from the following files: