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
vec3h.h File Reference
+ Include dependency graph for vec3h.h:
+ This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes

class  GfVec3h
 Basic type for a vector of 3 GfHalf components. More...
 

Functions

GF_API std::ostream & operator<< (std::ostream &, GfVec3h const &)
 Output a GfVec3h.
 
GfVec3h GfCompMult (GfVec3h const &v1, GfVec3h const &v2)
 Returns component-wise multiplication of vectors v1 and v2.
 
GfVec3h GfCompDiv (GfVec3h const &v1, GfVec3h const &v2)
 Returns component-wise quotient of vectors v1 and v2.
 
GfHalf GfDot (GfVec3h const &v1, GfVec3h const &v2)
 Returns the dot (inner) product of two vectors.
 
GfHalf GfGetLength (GfVec3h const &v)
 Returns the geometric length of v.
 
GfHalf GfNormalize (GfVec3h *v, GfHalf eps=0.001)
 Normalizes *v in place to unit length, returning the length before normalization.
 
GfVec3h GfGetNormalized (GfVec3h const &v, GfHalf eps=0.001)
 Returns a normalized (unit-length) vector with the same direction as v.
 
GfVec3h GfGetProjection (GfVec3h const &a, GfVec3h const &b)
 Returns the projection of a onto b.
 
GfVec3h GfGetComplement (GfVec3h const &a, GfVec3h const &b)
 Returns the orthogonal complement of a.GetProjection(b).
 
bool GfIsClose (GfVec3h const &v1, GfVec3h 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 (GfVec3h *tx, GfVec3h *ty, GfVec3h *tz, bool normalize, double eps=GF_MIN_ORTHO_TOLERANCE)
 
GF_API void GfBuildOrthonormalFrame (GfVec3h const &v0, GfVec3h *v1, GfVec3h *v2, GfHalf eps=0.001)
 
GfVec3h GfCross (GfVec3h const &v1, GfVec3h const &v2)
 Returns the cross product of v1 and v2.
 
GfVec3h operator^ (GfVec3h const &v1, GfVec3h const &v2)
 Returns the cross product of v1 and v2.
 
GF_API GfVec3h GfSlerp (double alpha, GfVec3h const &v0, GfVec3h const &v1)
 Spherical linear interpolation in three dimensions.
 

Function Documentation

◆ GfCompDiv()

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

Returns component-wise quotient of vectors v1 and v2.

Definition at line 342 of file vec3h.h.

◆ GfCompMult()

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

Returns component-wise multiplication of vectors v1 and v2.

Definition at line 332 of file vec3h.h.

◆ GfCross()

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

Returns the cross product of v1 and v2.

Definition at line 424 of file vec3h.h.

◆ GfDot()

GfHalf GfDot ( GfVec3h const &  v1,
GfVec3h const &  v2 
)
inline

Returns the dot (inner) product of two vectors.

Definition at line 352 of file vec3h.h.

◆ GfGetComplement()

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

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

That is:

a - a.GetProjection(b)

Definition at line 397 of file vec3h.h.

◆ GfGetLength()

GfHalf GfGetLength ( GfVec3h const &  v)
inline

Returns the geometric length of v.

Definition at line 359 of file vec3h.h.

◆ GfGetNormalized()

GfVec3h GfGetNormalized ( GfVec3h const &  v,
GfHalf  eps = 0.001 
)
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 377 of file vec3h.h.

◆ GfGetProjection()

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

Returns the projection of a onto b.

That is:

b * (a * b)

Definition at line 387 of file vec3h.h.

◆ GfIsClose()

bool GfIsClose ( GfVec3h const &  v1,
GfVec3h 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 405 of file vec3h.h.

◆ GfNormalize()

GfHalf GfNormalize ( GfVec3h v,
GfHalf  eps = 0.001 
)
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 368 of file vec3h.h.

◆ GfSlerp()

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

Spherical linear interpolation in three dimensions.

◆ operator^()

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

Returns the cross product of v1 and v2.

See also
GfCross()

Definition at line 435 of file vec3h.h.