Loading...
Searching...
No Matches
GfVec2d Class Reference

Basic type for a vector of 2 double components. More...

#include <vec2d.h>

Public Types

typedef double ScalarType
 Scalar element type and dimension.
 

Public Member Functions

 GfVec2d ()=default
 GfVec2d value-initializes to zero and performs no default initialization, like float or double.
 
constexpr GfVec2d (double value)
 Initialize all elements to a single value.
 
constexpr GfVec2d (double s0, double s1)
 Initialize all elements with explicit arguments.
 
template<class Scl >
constexpr GfVec2d (Scl const *p)
 Construct with pointer to values.
 
 GfVec2d (class GfVec2f const &other)
 Implicitly convert from GfVec2f.
 
 GfVec2d (class GfVec2h const &other)
 Implicitly convert from GfVec2h.
 
 GfVec2d (class GfVec2i const &other)
 Implicitly convert from GfVec2i.
 
GfVec2dSet (double s0, double s1)
 Set all elements with passed arguments.
 
GfVec2dSet (double const *a)
 Set all elements with a pointer to data.
 
double const * data () const
 Direct data access.
 
double * data ()
 
double const * GetArray () const
 
double const & operator[] (size_t i) const
 Indexing.
 
double & operator[] (size_t i)
 
bool operator== (GfVec2d const &other) const
 Equality comparison.
 
bool operator!= (GfVec2d const &other) const
 
GF_API bool operator== (class GfVec2f const &other) const
 Equality comparison.
 
GF_API bool operator== (class GfVec2h const &other) const
 Equality comparison.
 
GF_API bool operator== (class GfVec2i const &other) const
 Equality comparison.
 
GfVec2d operator- () const
 Create a vec with negated elements.
 
GfVec2doperator+= (GfVec2d const &other)
 Addition.
 
GfVec2doperator-= (GfVec2d const &other)
 Subtraction.
 
GfVec2doperator*= (double s)
 Multiplication by scalar.
 
GfVec2d operator* (double s) const
 
GfVec2doperator/= (double s)
 Division by scalar.
 
GfVec2d operator/ (double s) const
 
double operator* (GfVec2d const &v) const
 See GfDot().
 
GfVec2d GetProjection (GfVec2d const &v) const
 Returns the projection of this onto v.
 
GfVec2d GetComplement (GfVec2d const &b) const
 Returns the orthogonal complement of this->GetProjection(b).
 
double GetLengthSq () const
 Squared length.
 
double GetLength () const
 Length.
 
double Normalize (double eps=GF_MIN_VECTOR_LENGTH)
 Normalizes the vector in place to unit length, returning the length before normalization.
 
GfVec2d GetNormalized (double eps=GF_MIN_VECTOR_LENGTH) const
 
Swizzles

Each accessor returns a new vector built from this one's components, in the order named.

For example yx() returns GfVec2d(y, x).

Every permutation of 2 to 2 of the 2 components is available. Repeated components (xx, xyy) are not; nor are single-component swizzles, which are just the components themselves.

The results are ordinary GfVecs, so all the usual operators, GfDot() and so on apply to them. They are values, not references into this vector, so they cannot be assigned through.

constexpr GfVec2d xy () const
 
constexpr GfVec2d yx () const
 

Static Public Member Functions

static GfVec2d XAxis ()
 Create a unit vector along the X-axis.
 
static GfVec2d YAxis ()
 Create a unit vector along the Y-axis.
 
static GfVec2d Axis (size_t i)
 Create a unit vector along the i-th axis, zero-based.
 

Public Attributes

Vector Components

The vector's components, which are also its storage.

These are public and directly readable and writable.

The components are contiguous and in declaration order, so &x points to dimension values. See data() and operator[]().

For multi-component access see the swizzle accessors below, which return a new vector by value.

double x
 
double y
 

Static Public Attributes

static const size_t dimension = 2
 

Friends

size_t hash_value (GfVec2d const &vec)
 Hash.
 
GfVec2d operator+ (GfVec2d const &l, GfVec2d const &r)
 
GfVec2d operator- (GfVec2d const &l, GfVec2d const &r)
 
GfVec2d operator* (double s, GfVec2d const &v)
 

Detailed Description

Basic type for a vector of 2 double components.

Represents a vector of 2 components of type double. It is intended to be fast and simple.

Definition at line 45 of file vec2d.h.

Member Typedef Documentation

◆ ScalarType

double ScalarType

Scalar element type and dimension.

Definition at line 49 of file vec2d.h.

Constructor & Destructor Documentation

◆ GfVec2d() [1/7]

GfVec2d ( )
default

GfVec2d value-initializes to zero and performs no default initialization, like float or double.

◆ GfVec2d() [2/7]

GfVec2d ( double value)
inlineexplicitconstexpr

Initialize all elements to a single value.

Definition at line 71 of file vec2d.h.

◆ GfVec2d() [3/7]

GfVec2d ( double s0,
double s1 )
inlineconstexpr

Initialize all elements with explicit arguments.

Definition at line 77 of file vec2d.h.

◆ GfVec2d() [4/7]

template<class Scl >
GfVec2d ( Scl const * p)
inlineexplicitconstexpr

Construct with pointer to values.

Definition at line 84 of file vec2d.h.

◆ GfVec2d() [5/7]

GfVec2d ( class GfVec2f const & other)
inline

Implicitly convert from GfVec2f.

Definition at line 318 of file vec2d.h.

◆ GfVec2d() [6/7]

GfVec2d ( class GfVec2h const & other)
inline

Implicitly convert from GfVec2h.

Definition at line 324 of file vec2d.h.

◆ GfVec2d() [7/7]

GfVec2d ( class GfVec2i const & other)
inline

Implicitly convert from GfVec2i.

Definition at line 330 of file vec2d.h.

Member Function Documentation

◆ Axis()

static GfVec2d Axis ( size_t i)
inlinestatic

Create a unit vector along the i-th axis, zero-based.

Return the zero vector if i is greater than or equal to 2.

Definition at line 113 of file vec2d.h.

◆ data() [1/2]

double * data ( )
inline

Definition at line 138 of file vec2d.h.

◆ data() [2/2]

double const * data ( ) const
inline

Direct data access.

data() is the only member that relies on the components being contiguous; every other member either names them directly or goes through here.

Definition at line 137 of file vec2d.h.

◆ GetArray()

double const * GetArray ( ) const
inline

Definition at line 139 of file vec2d.h.

◆ GetComplement()

GfVec2d GetComplement ( GfVec2d const & b) const
inline

Returns the orthogonal complement of this->GetProjection(b).

That is:

*this - this->GetProjection(b)
GfVec2d GetProjection(GfVec2d const &v) const
Returns the projection of this onto v.
Definition vec2d.h:229

Definition at line 238 of file vec2d.h.

◆ GetLength()

double GetLength ( ) const
inline

Length.

Definition at line 248 of file vec2d.h.

◆ GetLengthSq()

double GetLengthSq ( ) const
inline

Squared length.

Definition at line 243 of file vec2d.h.

◆ GetNormalized()

GfVec2d GetNormalized ( double eps = GF_MIN_VECTOR_LENGTH) const
inline

Definition at line 268 of file vec2d.h.

◆ GetProjection()

GfVec2d GetProjection ( GfVec2d const & v) const
inline

Returns the projection of this onto v.

That is:

v * (*this * v)

Definition at line 229 of file vec2d.h.

◆ Normalize()

double Normalize ( double eps = GF_MIN_VECTOR_LENGTH)
inline

Normalizes the vector in place to unit length, returning the length before normalization.

If the length of the vector is smaller than eps, then the vector is set to vector/eps. The original length of the vector is returned. See also GfNormalize().

Definition at line 260 of file vec2d.h.

◆ operator!=()

bool operator!= ( GfVec2d const & other) const
inline

Definition at line 155 of file vec2d.h.

◆ operator*() [1/2]

GfVec2d operator* ( double s) const
inline

Definition at line 201 of file vec2d.h.

◆ operator*() [2/2]

double operator* ( GfVec2d const & v) const
inline

See GfDot().

Definition at line 221 of file vec2d.h.

◆ operator*=()

GfVec2d & operator*= ( double s)
inline

Multiplication by scalar.

Definition at line 196 of file vec2d.h.

◆ operator+=()

GfVec2d & operator+= ( GfVec2d const & other)
inline

Addition.

Definition at line 176 of file vec2d.h.

◆ operator-()

GfVec2d operator- ( ) const
inline

Create a vec with negated elements.

Definition at line 171 of file vec2d.h.

◆ operator-=()

GfVec2d & operator-= ( GfVec2d const & other)
inline

Subtraction.

Definition at line 186 of file vec2d.h.

◆ operator/()

GfVec2d operator/ ( double s) const
inline

Definition at line 216 of file vec2d.h.

◆ operator/=()

GfVec2d & operator/= ( double s)
inline

Division by scalar.

Definition at line 210 of file vec2d.h.

◆ operator==() [1/4]

GF_API bool operator== ( class GfVec2f const & other) const

Equality comparison.

◆ operator==() [2/4]

GF_API bool operator== ( class GfVec2h const & other) const

Equality comparison.

◆ operator==() [3/4]

GF_API bool operator== ( class GfVec2i const & other) const

Equality comparison.

◆ operator==() [4/4]

bool operator== ( GfVec2d const & other) const
inline

Equality comparison.

Definition at line 151 of file vec2d.h.

◆ operator[]() [1/2]

double & operator[] ( size_t i)
inline

Definition at line 143 of file vec2d.h.

◆ operator[]() [2/2]

double const & operator[] ( size_t i) const
inline

Indexing.

Definition at line 142 of file vec2d.h.

◆ Set() [1/2]

GfVec2d & Set ( double const * a)
inline

Set all elements with a pointer to data.

Definition at line 128 of file vec2d.h.

◆ Set() [2/2]

GfVec2d & Set ( double s0,
double s1 )
inline

Set all elements with passed arguments.

Definition at line 121 of file vec2d.h.

◆ XAxis()

static GfVec2d XAxis ( )
inlinestatic

Create a unit vector along the X-axis.

Definition at line 98 of file vec2d.h.

◆ xy()

Vec xy ( ) const
constexpr

Definition at line 338 of file vec2d.h.

◆ YAxis()

static GfVec2d YAxis ( )
inlinestatic

Create a unit vector along the Y-axis.

Definition at line 105 of file vec2d.h.

◆ yx()

Vec yx ( ) const
constexpr

Definition at line 346 of file vec2d.h.

Friends And Related Symbol Documentation

◆ hash_value

size_t hash_value ( GfVec2d const & vec)
friend

Hash.

Definition at line 146 of file vec2d.h.

◆ operator*

GfVec2d operator* ( double s,
GfVec2d const & v )
friend

Definition at line 204 of file vec2d.h.

◆ operator+

GfVec2d operator+ ( GfVec2d const & l,
GfVec2d const & r )
friend

Definition at line 181 of file vec2d.h.

◆ operator-

GfVec2d operator- ( GfVec2d const & l,
GfVec2d const & r )
friend

Definition at line 191 of file vec2d.h.

Member Data Documentation

◆ dimension

const size_t dimension = 2
static

Definition at line 50 of file vec2d.h.

◆ x

double x

Definition at line 63 of file vec2d.h.

◆ y

double y

Definition at line 63 of file vec2d.h.


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