This document is for a version of USD that is under development. See this page for the current release.
All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Modules Pages
vec3f.h File Reference
+ Include dependency graph for vec3f.h:

Go to the source code of this file.

Classes

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

Functions

GF_API std::ostream & operator<< (std::ostream &, GfVec3f const &)
 Output a GfVec3f.
 
GfVec3f GfCompMult (GfVec3f const &v1, GfVec3f const &v2)
 Returns component-wise multiplication of vectors v1 and v2.
 
GfVec3f GfCompDiv (GfVec3f const &v1, GfVec3f const &v2)
 Returns component-wise quotient of vectors v1 and v2.
 
float GfDot (GfVec3f const &v1, GfVec3f const &v2)
 Returns the dot (inner) product of two vectors.
 
float GfGetLength (GfVec3f const &v)
 Returns the geometric length of v.
 
float GfNormalize (GfVec3f *v, float eps=GF_MIN_VECTOR_LENGTH)
 Normalizes *v in place to unit length, returning the length before normalization.
 
GfVec3f GfGetNormalized (GfVec3f const &v, float eps=GF_MIN_VECTOR_LENGTH)
 Returns a normalized (unit-length) vector with the same direction as v.
 
GfVec3f GfGetProjection (GfVec3f const &a, GfVec3f const &b)
 Returns the projection of a onto b.
 
GfVec3f GfGetComplement (GfVec3f const &a, GfVec3f const &b)
 Returns the orthogonal complement of a.GetProjection(b).
 
bool GfIsClose (GfVec3f const &v1, GfVec3f const &v2, double tolerance)
 Tests for equality within a given tolerance, returning true if the length of the difference vector is less than or equal to tolerance.
 
GF_API bool GfOrthogonalizeBasis (GfVec3f *tx, GfVec3f *ty, GfVec3f *tz, bool normalize, double eps=GF_MIN_ORTHO_TOLERANCE)
 
GF_API void GfBuildOrthonormalFrame (GfVec3f const &v0, GfVec3f *v1, GfVec3f *v2, float eps=GF_MIN_VECTOR_LENGTH)
 
GfVec3f GfCross (GfVec3f const &v1, GfVec3f const &v2)
 Returns the cross product of v1 and v2.
 
GfVec3f operator^ (GfVec3f const &v1, GfVec3f const &v2)
 Returns the cross product of v1 and v2.
 
GF_API GfVec3f GfSlerp (double alpha, GfVec3f const &v0, GfVec3f const &v1)
 Spherical linear interpolation in three dimensions.
 

Function Documentation

◆ GfCompDiv()

GfVec3f GfCompDiv ( GfVec3f const &  v1,
GfVec3f const &  v2 
)
inline

Returns component-wise quotient of vectors v1 and v2.

Definition at line 341 of file vec3f.h.

◆ GfCompMult()

GfVec3f GfCompMult ( GfVec3f const &  v1,
GfVec3f const &  v2 
)
inline

Returns component-wise multiplication of vectors v1 and v2.

Definition at line 331 of file vec3f.h.

◆ GfCross()

GfVec3f GfCross ( GfVec3f const &  v1,
GfVec3f const &  v2 
)
inline

Returns the cross product of v1 and v2.

Definition at line 423 of file vec3f.h.

◆ GfDot()

float GfDot ( GfVec3f const &  v1,
GfVec3f const &  v2 
)
inline

Returns the dot (inner) product of two vectors.

Definition at line 351 of file vec3f.h.

◆ GfGetComplement()

GfVec3f GfGetComplement ( GfVec3f const &  a,
GfVec3f const &  b 
)
inline

Returns the orthogonal complement of a.GetProjection(b).

That is:

a - a.GetProjection(b)

Definition at line 396 of file vec3f.h.

◆ GfGetLength()

float GfGetLength ( GfVec3f const &  v)
inline

Returns the geometric length of v.

Definition at line 358 of file vec3f.h.

◆ GfGetNormalized()

GfVec3f GfGetNormalized ( GfVec3f const &  v,
float  eps = GF_MIN_VECTOR_LENGTH 
)
inline

Returns a normalized (unit-length) vector with the same direction as v.

If the length of this vector is smaller than eps, the vector divided by eps is returned.

Definition at line 376 of file vec3f.h.

◆ GfGetProjection()

GfVec3f GfGetProjection ( GfVec3f const &  a,
GfVec3f const &  b 
)
inline

Returns the projection of a onto b.

That is:

b * (a * b)

Definition at line 386 of file vec3f.h.

◆ GfIsClose()

bool GfIsClose ( GfVec3f const &  v1,
GfVec3f const &  v2,
double  tolerance 
)
inline

Tests for equality within a given tolerance, returning true if the length of the difference vector is less than or equal to tolerance.

Definition at line 404 of file vec3f.h.

◆ GfNormalize()

float GfNormalize ( GfVec3f v,
float  eps = GF_MIN_VECTOR_LENGTH 
)
inline

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

If the length of *v is smaller than eps then *v is set to *v/eps. The original length of *v is returned.

Definition at line 367 of file vec3f.h.

◆ GfSlerp()

GF_API GfVec3f GfSlerp ( double  alpha,
GfVec3f const &  v0,
GfVec3f const &  v1 
)

Spherical linear interpolation in three dimensions.

◆ operator^()

GfVec3f operator^ ( GfVec3f const &  v1,
GfVec3f const &  v2 
)
inline

Returns the cross product of v1 and v2.

See also
GfCross()

Definition at line 434 of file vec3f.h.