All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Modules Pages
GfVec3f Class Reference

Basic type for a vector of 3 float components. More...

#include <vec3f.h>

Public Types

typedef float ScalarType
 Scalar element type and dimension.
 

Public Member Functions

 GfVec3f ()=default
 Default constructor does no initialization.
 
constexpr GfVec3f (float value)
 Initialize all elements to a single value.
 
constexpr GfVec3f (float s0, float s1, float s2)
 Initialize all elements with explicit arguments.
 
template<class Scl >
constexpr GfVec3f (Scl const *p)
 Construct with pointer to values.
 
 GfVec3f (class GfVec3d const &other)
 Construct from GfVec3d.
 
 GfVec3f (class GfVec3h const &other)
 Implicitly convert from GfVec3h.
 
 GfVec3f (class GfVec3i const &other)
 Implicitly convert from GfVec3i.
 
GfVec3fSet (float s0, float s1, float s2)
 Set all elements with passed arguments.
 
GfVec3fSet (float const *a)
 Set all elements with a pointer to data.
 
float const * data () const
 Direct data access.
 
float * data ()
 
float const * GetArray () const
 
float const & operator[] (size_t i) const
 Indexing.
 
float & operator[] (size_t i)
 
bool operator== (GfVec3f const &other) const
 Equality comparison.
 
bool operator!= (GfVec3f const &other) const
 
GF_API bool operator== (class GfVec3d const &other) const
 Equality comparison.
 
GF_API bool operator== (class GfVec3h const &other) const
 Equality comparison.
 
GF_API bool operator== (class GfVec3i const &other) const
 Equality comparison.
 
GfVec3f operator- () const
 Create a vec with negated elements.
 
GfVec3foperator+= (GfVec3f const &other)
 Addition.
 
GfVec3foperator-= (GfVec3f const &other)
 Subtraction.
 
GfVec3foperator*= (double s)
 Multiplication by scalar.
 
GfVec3f operator* (double s) const
 
GfVec3foperator/= (double s)
 Division by scalar.
 
GfVec3f operator/ (double s) const
 
float operator* (GfVec3f const &v) const
 See GfDot().
 
GfVec3f GetProjection (GfVec3f const &v) const
 Returns the projection of this onto v.
 
GfVec3f GetComplement (GfVec3f const &b) const
 Returns the orthogonal complement of this->GetProjection(b).
 
float GetLengthSq () const
 Squared length.
 
float GetLength () const
 Length.
 
float Normalize (float eps=GF_MIN_VECTOR_LENGTH)
 Normalizes the vector in place to unit length, returning the length before normalization.
 
GfVec3f GetNormalized (float eps=GF_MIN_VECTOR_LENGTH) const
 
GF_API void BuildOrthonormalFrame (GfVec3f *v1, GfVec3f *v2, float eps=GF_MIN_VECTOR_LENGTH) const
 Sets v1 and v2 to unit vectors such that v1, v2 and *this are mutually orthogonal.
 

Static Public Member Functions

static GfVec3f XAxis ()
 Create a unit vector along the X-axis.
 
static GfVec3f YAxis ()
 Create a unit vector along the Y-axis.
 
static GfVec3f ZAxis ()
 Create a unit vector along the Z-axis.
 
static GfVec3f Axis (size_t i)
 Create a unit vector along the i-th axis, zero-based.
 
static GF_API bool OrthogonalizeBasis (GfVec3f *tx, GfVec3f *ty, GfVec3f *tz, const bool normalize, double eps=GF_MIN_ORTHO_TOLERANCE)
 Orthogonalize and optionally normalize a set of basis vectors.
 

Static Public Attributes

static const size_t dimension = 3
 

Friends

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

Detailed Description

Basic type for a vector of 3 float components.

Represents a vector of 3 components of type float. It is intended to be fast and simple.

Definition at line 45 of file vec3f.h.

Member Typedef Documentation

◆ ScalarType

typedef float ScalarType

Scalar element type and dimension.

Definition at line 49 of file vec3f.h.

Constructor & Destructor Documentation

◆ GfVec3f() [1/7]

GfVec3f ( )
default

Default constructor does no initialization.

◆ GfVec3f() [2/7]

constexpr GfVec3f ( float  value)
inlineexplicitconstexpr

Initialize all elements to a single value.

Definition at line 56 of file vec3f.h.

◆ GfVec3f() [3/7]

constexpr GfVec3f ( float  s0,
float  s1,
float  s2 
)
inlineconstexpr

Initialize all elements with explicit arguments.

Definition at line 62 of file vec3f.h.

◆ GfVec3f() [4/7]

constexpr GfVec3f ( Scl const *  p)
inlineexplicitconstexpr

Construct with pointer to values.

Definition at line 69 of file vec3f.h.

◆ GfVec3f() [5/7]

GfVec3f ( class GfVec3d const &  other)
inlineexplicit

Construct from GfVec3d.

Definition at line 308 of file vec3f.h.

◆ GfVec3f() [6/7]

GfVec3f ( class GfVec3h const &  other)
inline

Implicitly convert from GfVec3h.

Definition at line 315 of file vec3f.h.

◆ GfVec3f() [7/7]

GfVec3f ( class GfVec3i const &  other)
inline

Implicitly convert from GfVec3i.

Definition at line 322 of file vec3f.h.

Member Function Documentation

◆ Axis()

static GfVec3f 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 3.

Definition at line 104 of file vec3f.h.

◆ BuildOrthonormalFrame()

GF_API void BuildOrthonormalFrame ( GfVec3f v1,
GfVec3f v2,
float  eps = GF_MIN_VECTOR_LENGTH 
) const

Sets v1 and v2 to unit vectors such that v1, v2 and *this are mutually orthogonal.

If the length L of *this is smaller than eps, then v1 and v2 will have magnitude L/eps. As a result, the function delivers a continuous result as *this shrinks in length.

◆ data() [1/2]

float * data ( )
inline

Definition at line 126 of file vec3f.h.

◆ data() [2/2]

float const * data ( ) const
inline

Direct data access.

Definition at line 125 of file vec3f.h.

◆ GetArray()

float const * GetArray ( ) const
inline

Definition at line 127 of file vec3f.h.

◆ GetComplement()

GfVec3f GetComplement ( GfVec3f const &  b) const
inline

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

That is:

*this - this->GetProjection(b)
GfVec3f GetProjection(GfVec3f const &v) const
Returns the projection of this onto v.
Definition: vec3f.h:221

Definition at line 230 of file vec3f.h.

◆ GetLength()

float GetLength ( ) const
inline

Length.

Definition at line 240 of file vec3f.h.

◆ GetLengthSq()

float GetLengthSq ( ) const
inline

Squared length.

Definition at line 235 of file vec3f.h.

◆ GetNormalized()

GfVec3f GetNormalized ( float  eps = GF_MIN_VECTOR_LENGTH) const
inline

Definition at line 260 of file vec3f.h.

◆ GetProjection()

GfVec3f GetProjection ( GfVec3f const &  v) const
inline

Returns the projection of this onto v.

That is:

v * (*this * v)

Definition at line 221 of file vec3f.h.

◆ Normalize()

float Normalize ( float  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 252 of file vec3f.h.

◆ operator!=()

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

Definition at line 144 of file vec3f.h.

◆ operator*() [1/2]

GfVec3f operator* ( double  s) const
inline

Definition at line 193 of file vec3f.h.

◆ operator*() [2/2]

float operator* ( GfVec3f const &  v) const
inline

See GfDot().

Definition at line 213 of file vec3f.h.

◆ operator*=()

GfVec3f & operator*= ( double  s)
inline

Multiplication by scalar.

Definition at line 187 of file vec3f.h.

◆ operator+=()

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

Addition.

Definition at line 165 of file vec3f.h.

◆ operator-()

GfVec3f operator- ( ) const
inline

Create a vec with negated elements.

Definition at line 160 of file vec3f.h.

◆ operator-=()

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

Subtraction.

Definition at line 176 of file vec3f.h.

◆ operator/()

GfVec3f operator/ ( double  s) const
inline

Definition at line 208 of file vec3f.h.

◆ operator/=()

GfVec3f & operator/= ( double  s)
inline

Division by scalar.

Definition at line 202 of file vec3f.h.

◆ operator==() [1/4]

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

Equality comparison.

◆ operator==() [2/4]

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

Equality comparison.

◆ operator==() [3/4]

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

Equality comparison.

◆ operator==() [4/4]

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

Equality comparison.

Definition at line 139 of file vec3f.h.

◆ operator[]() [1/2]

float & operator[] ( size_t  i)
inline

Definition at line 131 of file vec3f.h.

◆ operator[]() [2/2]

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

Indexing.

Definition at line 130 of file vec3f.h.

◆ OrthogonalizeBasis()

static GF_API bool OrthogonalizeBasis ( GfVec3f tx,
GfVec3f ty,
GfVec3f tz,
const bool  normalize,
double  eps = GF_MIN_ORTHO_TOLERANCE 
)
static

Orthogonalize and optionally normalize a set of basis vectors.

This uses an iterative method that is very stable even when the vectors are far from orthogonal (close to colinear). The number of iterations and thus the computation time does increase as the vectors become close to colinear, however. Returns a bool specifying whether the solution converged after a number of iterations. If it did not converge, the returned vectors will be as close as possible to orthogonal within the iteration limit. Colinear vectors will be unaltered, and the method will return false.

◆ Set() [1/2]

GfVec3f & Set ( float const *  a)
inline

Set all elements with a pointer to data.

Definition at line 120 of file vec3f.h.

◆ Set() [2/2]

GfVec3f & Set ( float  s0,
float  s1,
float  s2 
)
inline

Set all elements with passed arguments.

Definition at line 112 of file vec3f.h.

◆ XAxis()

static GfVec3f XAxis ( )
inlinestatic

Create a unit vector along the X-axis.

Definition at line 84 of file vec3f.h.

◆ YAxis()

static GfVec3f YAxis ( )
inlinestatic

Create a unit vector along the Y-axis.

Definition at line 90 of file vec3f.h.

◆ ZAxis()

static GfVec3f ZAxis ( )
inlinestatic

Create a unit vector along the Z-axis.

Definition at line 96 of file vec3f.h.

Friends And Related Function Documentation

◆ hash_value

size_t hash_value ( GfVec3f const &  vec)
friend

Hash.

Definition at line 134 of file vec3f.h.

◆ operator*

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

Definition at line 196 of file vec3f.h.

◆ operator+

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

Definition at line 171 of file vec3f.h.

◆ operator-

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

Definition at line 182 of file vec3f.h.

Member Data Documentation

◆ dimension

const size_t dimension = 3
static

Definition at line 50 of file vec3f.h.


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