HDK
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Pages
openvdb::OPENVDB_VERSION_NAME::math::Vec3< T > Class Template Reference

#include <Mat.h>

+ Inheritance diagram for openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >:

Public Types

typedef T value_type
 
typedef T ValueType
 
- Public Types inherited from openvdb::OPENVDB_VERSION_NAME::math::Tuple< 3, T >
typedef T value_type
 
typedef T ValueType
 

Public Member Functions

 Vec3 ()
 Trivial constructor, the vector is NOT initialized. More...
 
 Vec3 (T val)
 Construct a vector all of whose components have the given value. More...
 
 Vec3 (T x, T y, T z)
 Constructor with three arguments, e.g. Vec3d v(1,2,3);. More...
 
template<typename Source >
 Vec3 (Source *a)
 Constructor with array argument, e.g. double a[3]; Vec3d v(a);. More...
 
template<typename Source >
 Vec3 (const Tuple< 3, Source > &v)
 Construct a Vec3 from a 3-Tuple with a possibly different value type. More...
 
template<typename Other >
 Vec3 (Other val, typename std::enable_if< std::is_arithmetic< Other >::value, Conversion >::type=Conversion{})
 Construct a vector all of whose components have the given value, which may be of an arithmetic type different from this vector's value type. More...
 
template<typename Other >
 Vec3 (const Vec3< Other > &v)
 Construct a Vec3 from another Vec3 with a possibly different value type. More...
 
T & x ()
 Reference to the component, e.g. v.x() = 4.5f;. More...
 
T & y ()
 
T & z ()
 
x () const
 Get the component, e.g. float f = v.y();. More...
 
y () const
 
z () const
 
T * asPointer ()
 
const T * asPointer () const
 
T & operator() (int i)
 Alternative indexed reference to the elements. More...
 
operator() (int i) const
 Alternative indexed constant reference to the elements,. More...
 
const Vec3< T > & init (T x=0, T y=0, T z=0)
 
const Vec3< T > & setZero ()
 Set "this" vector to zero. More...
 
template<typename Source >
const Vec3< T > & operator= (const Vec3< Source > &v)
 Assignment operator. More...
 
bool eq (const Vec3< T > &v, T eps=static_cast< T >(1.0e-7)) const
 Test if "this" vector is equivalent to vector v with tolerance of eps. More...
 
Vec3< T > operator- () const
 Negation operator, for e.g. v1 = -v2;. More...
 
template<typename T0 , typename T1 >
const Vec3< T > & add (const Vec3< T0 > &v1, const Vec3< T1 > &v2)
 
template<typename T0 , typename T1 >
const Vec3< T > & sub (const Vec3< T0 > &v1, const Vec3< T1 > &v2)
 
template<typename T0 , typename T1 >
const Vec3< T > & scale (T0 scale, const Vec3< T1 > &v)
 
template<typename T0 , typename T1 >
const Vec3< T > & div (T0 scale, const Vec3< T1 > &v)
 
dot (const Vec3< T > &v) const
 Dot product. More...
 
length () const
 Length of the vector. More...
 
lengthSqr () const
 
Vec3< T > cross (const Vec3< T > &v) const
 Return the cross product of "this" vector and v;. More...
 
const Vec3< T > & cross (const Vec3< T > &v1, const Vec3< T > &v2)
 this = v1 cross v2, v1 and v2 must be distinct objects than "this" More...
 
template<typename S >
const Vec3< T > & operator*= (S scalar)
 Returns v, where $v_i *= scalar$ for $i \in [0, 2]$. More...
 
template<typename S >
const Vec3< T > & operator*= (const Vec3< S > &v1)
 Returns v0, where $v0_i *= v1_i$ for $i \in [0, 2]$. More...
 
template<typename S >
const Vec3< T > & operator/= (S scalar)
 Returns v, where $v_i /= scalar$ for $i \in [0, 2]$. More...
 
template<typename S >
const Vec3< T > & operator/= (const Vec3< S > &v1)
 Returns v0, where $v0_i /= v1_i$ for $i \in [0, 2]$. More...
 
template<typename S >
const Vec3< T > & operator+= (S scalar)
 Returns v, where $v_i += scalar$ for $i \in [0, 2]$. More...
 
template<typename S >
const Vec3< T > & operator+= (const Vec3< S > &v1)
 Returns v0, where $v0_i += v1_i$ for $i \in [0, 2]$. More...
 
template<typename S >
const Vec3< T > & operator-= (S scalar)
 Returns v, where $v_i += scalar$ for $i \in [0, 2]$. More...
 
template<typename S >
const Vec3< T > & operator-= (const Vec3< S > &v1)
 Returns v0, where $v0_i -= v1_i$ for $i \in [0, 2]$. More...
 
const Vec3< T > & exp ()
 
const Vec3< T > & log ()
 
sum () const
 Return the sum of all the vector components. More...
 
product () const
 Return the product of all the vector components. More...
 
bool normalize (T eps=T(1.0e-7))
 this = normalized this More...
 
Vec3< T > unit (T eps=0) const
 return normalized this, throws if null vector More...
 
Vec3< T > unit (T eps, T &len) const
 return normalized this and length, throws if null vector More...
 
Vec3< T > unitSafe () const
 return normalized this, or (1, 0, 0) if this is null vector More...
 
component (const Vec3< T > &onto, T eps=static_cast< T >(1.0e-7)) const
 
Vec3< T > projection (const Vec3< T > &onto, T eps=static_cast< T >(1.0e-7)) const
 
Vec3< T > getArbPerpendicular () const
 
bool isNan () const
 True if a Nan is present in vector. More...
 
bool isInfinite () const
 True if an Inf is present in vector. More...
 
bool isFinite () const
 True if all no Nan or Inf values present. More...
 
Vec3< T > sorted () const
 Return a vector with the components of this in ascending order. More...
 
Vec3< T > reversed () const
 Return the vector (z, y, x) More...
 
- Public Member Functions inherited from openvdb::OPENVDB_VERSION_NAME::math::Tuple< 3, T >
 Tuple ()
 Default ctor. Does nothing. More...
 
 Tuple (Tuple const &src)
 Copy constructor. Used when the class signature matches exactly. More...
 
 Tuple (Tuple< src_size, src_valtype > const &src)
 Conversion constructor. More...
 
Tupleoperator= (Tuple const &src)
 Assignment operator. More...
 
T operator[] (int i) const
 
Toperator[] (int i)
 
std::string str () const
 
void write (std::ostream &os) const
 
void read (std::istream &is)
 
void toV (S *v) const
 Copies this tuple into an array of a compatible type. More...
 
value_typeasV ()
 Exposes the internal array. Be careful when using this function. More...
 
value_type constasV () const
 Exposes the internal array. Be careful when using this function. More...
 

Static Public Member Functions

static unsigned numRows ()
 
static unsigned numColumns ()
 
static unsigned numElements ()
 
static Vec3< T > zero ()
 Predefined constants, e.g. Vec3d v = Vec3d::xNegAxis();. More...
 
static Vec3< T > ones ()
 

Additional Inherited Members

- Static Public Attributes inherited from openvdb::OPENVDB_VERSION_NAME::math::Tuple< 3, T >
static const int size
 
- Protected Attributes inherited from openvdb::OPENVDB_VERSION_NAME::math::Tuple< 3, T >
T mm [SIZE]
 

Detailed Description

template<typename T>
class openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >

Definition at line 162 of file Mat.h.

Member Typedef Documentation

template<typename T>
typedef T openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::value_type

Definition at line 52 of file Vec3.h.

template<typename T>
typedef T openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::ValueType

Definition at line 53 of file Vec3.h.

Constructor & Destructor Documentation

template<typename T>
openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::Vec3 ( )
inline

Trivial constructor, the vector is NOT initialized.

Definition at line 56 of file Vec3.h.

template<typename T>
openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::Vec3 ( val)
inlineexplicit

Construct a vector all of whose components have the given value.

Definition at line 59 of file Vec3.h.

template<typename T>
openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::Vec3 ( x,
y,
z 
)
inline

Constructor with three arguments, e.g. Vec3d v(1,2,3);.

Definition at line 62 of file Vec3.h.

template<typename T>
template<typename Source >
openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::Vec3 ( Source *  a)
inline

Constructor with array argument, e.g. double a[3]; Vec3d v(a);.

Definition at line 71 of file Vec3.h.

template<typename T>
template<typename Source >
openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::Vec3 ( const Tuple< 3, Source > &  v)
inlineexplicit

Construct a Vec3 from a 3-Tuple with a possibly different value type.

Type conversion warnings are suppressed.

Definition at line 81 of file Vec3.h.

template<typename T>
template<typename Other >
openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::Vec3 ( Other  val,
typename std::enable_if< std::is_arithmetic< Other >::value, Conversion >::type  = Conversion{} 
)
inlineexplicit

Construct a vector all of whose components have the given value, which may be of an arithmetic type different from this vector's value type.

Type conversion warnings are suppressed.

Definition at line 92 of file Vec3.h.

template<typename T>
template<typename Other >
openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::Vec3 ( const Vec3< Other > &  v)
inline

Construct a Vec3 from another Vec3 with a possibly different value type.

Type conversion warnings are suppressed.

Definition at line 101 of file Vec3.h.

Member Function Documentation

template<typename T>
template<typename T0 , typename T1 >
const Vec3<T>& openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::add ( const Vec3< T0 > &  v1,
const Vec3< T1 > &  v2 
)
inline

this = v1 + v2 "this", v1 and v2 need not be distinct objects, e.g. v.add(v1,v);

Definition at line 171 of file Vec3.h.

template<typename T>
T* openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::asPointer ( )
inline

Definition at line 118 of file Vec3.h.

template<typename T>
const T* openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::asPointer ( ) const
inline

Definition at line 119 of file Vec3.h.

template<typename T>
T openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::component ( const Vec3< T > &  onto,
eps = static_cast<T>(1.0e-7) 
) const
inline

Returns the scalar component of v in the direction of onto, onto need not be unit. e.g double c = Vec3d::component(v1,v2);

Definition at line 418 of file Vec3.h.

template<typename T>
Vec3<T> openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::cross ( const Vec3< T > &  v) const
inline

Return the cross product of "this" vector and v;.

Definition at line 244 of file Vec3.h.

template<typename T>
const Vec3<T>& openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::cross ( const Vec3< T > &  v1,
const Vec3< T > &  v2 
)
inline

this = v1 cross v2, v1 and v2 must be distinct objects than "this"

Definition at line 253 of file Vec3.h.

template<typename T>
template<typename T0 , typename T1 >
const Vec3<T>& openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::div ( T0  scale,
const Vec3< T1 > &  v 
)
inline

Definition at line 205 of file Vec3.h.

template<typename T>
T openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::dot ( const Vec3< T > &  v) const
inline

Dot product.

Definition at line 215 of file Vec3.h.

template<typename T>
bool openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::eq ( const Vec3< T > &  v,
eps = static_cast<T>(1.0e-7) 
) const
inline

Test if "this" vector is equivalent to vector v with tolerance of eps.

Definition at line 157 of file Vec3.h.

template<typename T>
const Vec3<T>& openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::exp ( )
inline

Return a reference to itself after the exponent has been applied to all the vector components.

Definition at line 345 of file Vec3.h.

template<typename T>
Vec3<T> openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::getArbPerpendicular ( ) const
inline

Return an arbitrary unit vector perpendicular to v Vector this must be a unit vector e.g. v = v.normalize(); Vec3d n = v.getArbPerpendicular();

Definition at line 439 of file Vec3.h.

template<typename T>
const Vec3<T>& openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::init ( x = 0,
y = 0,
z = 0 
)
inline

"this" vector gets initialized to [x, y, z], calling v.init(); has same effect as calling v = Vec3::zero();

Definition at line 129 of file Vec3.h.

template<typename T>
bool openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::isFinite ( ) const
inline

True if all no Nan or Inf values present.

Definition at line 473 of file Vec3.h.

template<typename T>
bool openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::isInfinite ( ) const
inline

True if an Inf is present in vector.

Definition at line 467 of file Vec3.h.

template<typename T>
bool openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::isNan ( ) const
inline

True if a Nan is present in vector.

Definition at line 464 of file Vec3.h.

template<typename T>
T openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::length ( void  ) const
inline

Length of the vector.

Definition at line 224 of file Vec3.h.

template<typename T>
T openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::lengthSqr ( ) const
inline

Squared length of the vector, much faster than length() as it does not involve square root

Definition at line 235 of file Vec3.h.

template<typename T>
const Vec3<T>& openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::log ( )
inline

Return a reference to itself after log has been applied to all the vector components.

Definition at line 355 of file Vec3.h.

template<typename T>
bool openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::normalize ( eps = T(1.0e-7))
inline

this = normalized this

Definition at line 376 of file Vec3.h.

template<typename T>
static unsigned openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::numColumns ( )
inlinestatic

Definition at line 413 of file Vec3.h.

template<typename T>
static unsigned openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::numElements ( )
inlinestatic

Definition at line 414 of file Vec3.h.

template<typename T>
static unsigned openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::numRows ( )
inlinestatic

Definition at line 412 of file Vec3.h.

template<typename T>
static Vec3<T> openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::ones ( )
inlinestatic

Definition at line 496 of file Vec3.h.

template<typename T>
T& openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::operator() ( int  i)
inline

Alternative indexed reference to the elements.

Definition at line 122 of file Vec3.h.

template<typename T>
T openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::operator() ( int  i) const
inline

Alternative indexed constant reference to the elements,.

Definition at line 125 of file Vec3.h.

template<typename T>
template<typename S >
const Vec3<T>& openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::operator*= ( scalar)
inline

Returns v, where $v_i *= scalar$ for $i \in [0, 2]$.

Definition at line 265 of file Vec3.h.

template<typename T>
template<typename S >
const Vec3<T>& openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::operator*= ( const Vec3< S > &  v1)
inline

Returns v0, where $v0_i *= v1_i$ for $i \in [0, 2]$.

Definition at line 275 of file Vec3.h.

template<typename T>
template<typename S >
const Vec3<T>& openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::operator+= ( scalar)
inline

Returns v, where $v_i += scalar$ for $i \in [0, 2]$.

Definition at line 305 of file Vec3.h.

template<typename T>
template<typename S >
const Vec3<T>& openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::operator+= ( const Vec3< S > &  v1)
inline

Returns v0, where $v0_i += v1_i$ for $i \in [0, 2]$.

Definition at line 315 of file Vec3.h.

template<typename T>
Vec3<T> openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::operator- ( ) const
inline

Negation operator, for e.g. v1 = -v2;.

Definition at line 166 of file Vec3.h.

template<typename T>
template<typename S >
const Vec3<T>& openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::operator-= ( scalar)
inline

Returns v, where $v_i += scalar$ for $i \in [0, 2]$.

Definition at line 325 of file Vec3.h.

template<typename T>
template<typename S >
const Vec3<T>& openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::operator-= ( const Vec3< S > &  v1)
inline

Returns v0, where $v0_i -= v1_i$ for $i \in [0, 2]$.

Definition at line 335 of file Vec3.h.

template<typename T>
template<typename S >
const Vec3<T>& openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::operator/= ( scalar)
inline

Returns v, where $v_i /= scalar$ for $i \in [0, 2]$.

Definition at line 285 of file Vec3.h.

template<typename T>
template<typename S >
const Vec3<T>& openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::operator/= ( const Vec3< S > &  v1)
inline

Returns v0, where $v0_i /= v1_i$ for $i \in [0, 2]$.

Definition at line 295 of file Vec3.h.

template<typename T>
template<typename Source >
const Vec3<T>& openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::operator= ( const Vec3< Source > &  v)
inline

Assignment operator.

Type conversion warnings are not suppressed.

Definition at line 146 of file Vec3.h.

template<typename T>
T openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::product ( ) const
inline

Return the product of all the vector components.

Definition at line 370 of file Vec3.h.

template<typename T>
Vec3<T> openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::projection ( const Vec3< T > &  onto,
eps = static_cast<T>(1.0e-7) 
) const
inline

Return the projection of v onto the vector, onto need not be unit e.g. Vec3d a = vprojection(n);

Definition at line 428 of file Vec3.h.

template<typename T>
Vec3<T> openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::reversed ( ) const
inline

Return the vector (z, y, x)

Definition at line 489 of file Vec3.h.

template<typename T>
template<typename T0 , typename T1 >
const Vec3<T>& openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::scale ( T0  scale,
const Vec3< T1 > &  v 
)
inline

this = scalar*v, v need not be a distinct object from "this", e.g. v.scale(1.5,v1);

Definition at line 195 of file Vec3.h.

template<typename T>
const Vec3<T>& openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::setZero ( )
inline

Set "this" vector to zero.

Definition at line 137 of file Vec3.h.

template<typename T>
Vec3<T> openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::sorted ( ) const
inline

Return a vector with the components of this in ascending order.

Definition at line 479 of file Vec3.h.

template<typename T>
template<typename T0 , typename T1 >
const Vec3<T>& openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::sub ( const Vec3< T0 > &  v1,
const Vec3< T1 > &  v2 
)
inline

this = v1 - v2 "this", v1 and v2 need not be distinct objects, e.g. v.sub(v1,v);

Definition at line 183 of file Vec3.h.

template<typename T>
T openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::sum ( ) const
inline

Return the sum of all the vector components.

Definition at line 364 of file Vec3.h.

template<typename T>
Vec3<T> openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::unit ( eps = 0) const
inline

return normalized this, throws if null vector

Definition at line 388 of file Vec3.h.

template<typename T>
Vec3<T> openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::unit ( eps,
T &  len 
) const
inline

return normalized this and length, throws if null vector

Definition at line 395 of file Vec3.h.

template<typename T>
Vec3<T> openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::unitSafe ( ) const
inline

return normalized this, or (1, 0, 0) if this is null vector

Definition at line 405 of file Vec3.h.

template<typename T>
T& openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::x ( )
inline

Reference to the component, e.g. v.x() = 4.5f;.

Definition at line 109 of file Vec3.h.

template<typename T>
T openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::x ( ) const
inline

Get the component, e.g. float f = v.y();.

Definition at line 114 of file Vec3.h.

template<typename T>
T& openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::y ( )
inline

Definition at line 110 of file Vec3.h.

template<typename T>
T openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::y ( ) const
inline

Definition at line 115 of file Vec3.h.

template<typename T>
T& openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::z ( )
inline

Definition at line 111 of file Vec3.h.

template<typename T>
T openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::z ( ) const
inline

Definition at line 116 of file Vec3.h.

template<typename T>
static Vec3<T> openvdb::OPENVDB_VERSION_NAME::math::Vec3< T >::zero ( )
inlinestatic

Predefined constants, e.g. Vec3d v = Vec3d::xNegAxis();.

Definition at line 495 of file Vec3.h.


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