Open CASCADE Technology 7.8.2.dev
NCollection_Vec4< Element_t > Class Template Reference

Generic 4-components vector. To be used as RGBA color vector or XYZW 3D-point with special W-component for operations with projection / model view matrices. Use this class for 3D-points carefully because declared W-component may results in incorrect results if used without matrices. More...

#include <NCollection_Vec4.hxx>

Public Member Functions

 NCollection_Vec4 ()
 Empty constructor. Construct the zero vector.
 
 NCollection_Vec4 (const Element_t theValue)
 Initialize ALL components of vector within specified value.
 
 NCollection_Vec4 (const Element_t theX, const Element_t theY, const Element_t theZ, const Element_t theW)
 Per-component constructor.
 
 NCollection_Vec4 (const NCollection_Vec2< Element_t > &theVec2)
 Constructor from 2-components vector.
 
 NCollection_Vec4 (const NCollection_Vec3< Element_t > &theVec3, const Element_t theW=Element_t(0))
 Constructor from 3-components vector + optional 4th value.
 
template<typename OtherElement_t >
 NCollection_Vec4 (const NCollection_Vec4< OtherElement_t > &theOtherVec4)
 Conversion constructor (explicitly converts some 4-component vector with other element type to a new 4-component vector with the element type Element_t, whose elements are static_cast'ed corresponding elements of theOtherVec4 vector)
 
void SetValues (const Element_t theX, const Element_t theY, const Element_t theZ, const Element_t theW)
 Assign new values to the vector.
 
void SetValues (const NCollection_Vec3< Element_t > &theVec3, const Element_t theW)
 Assign new values as 3-component vector and a 4-th value.
 
Element_t x () const
 Alias to 1st component as X coordinate in XYZW.
 
Element_t r () const
 Alias to 1st component as RED channel in RGBA.
 
Element_t y () const
 Alias to 2nd component as Y coordinate in XYZW.
 
Element_t g () const
 Alias to 2nd component as GREEN channel in RGBA.
 
Element_t z () const
 Alias to 3rd component as Z coordinate in XYZW.
 
Element_t b () const
 Alias to 3rd component as BLUE channel in RGBA.
 
Element_t w () const
 Alias to 4th component as W coordinate in XYZW.
 
Element_t a () const
 Alias to 4th component as ALPHA channel in RGBA.
 
Element_t & x ()
 Alias to 1st component as X coordinate in XYZW.
 
Element_t & r ()
 Alias to 1st component as RED channel in RGBA.
 
Element_t & y ()
 Alias to 2nd component as Y coordinate in XYZW.
 
Element_t & g ()
 Alias to 2nd component as GREEN channel in RGBA.
 
Element_t & z ()
 Alias to 3rd component as Z coordinate in XYZW.
 
Element_t & b ()
 Alias to 3rd component as BLUE channel in RGBA.
 
Element_t & w ()
 Alias to 4th component as W coordinate in XYZW.
 
Element_t & a ()
 Alias to 4th component as ALPHA channel in RGBA.
 
bool IsEqual (const NCollection_Vec4 &theOther) const
 Check this vector with another vector for equality (without tolerance!).
 
bool operator== (const NCollection_Vec4 &theOther) const
 Check this vector with another vector for equality (without tolerance!).
 
bool operator!= (const NCollection_Vec4 &theOther) const
 Check this vector with another vector for non-equality (without tolerance!).
 
const Element_t * GetData () const
 Raw access to the data (for OpenGL exchange).
 
Element_t * ChangeData ()
 
 operator const Element_t * () const
 
 operator Element_t * ()
 
NCollection_Vec4operator+= (const NCollection_Vec4 &theAdd)
 Compute per-component summary.
 
NCollection_Vec4 operator- () const
 Unary -.
 
NCollection_Vec4operator-= (const NCollection_Vec4 &theDec)
 Compute per-component subtraction.
 
NCollection_Vec4operator*= (const NCollection_Vec4 &theRight)
 Compute per-component multiplication.
 
void Multiply (const Element_t theFactor)
 Compute per-component multiplication.
 
NCollection_Vec4operator*= (const Element_t theFactor)
 Compute per-component multiplication.
 
NCollection_Vec4 operator* (const Element_t theFactor) const
 Compute per-component multiplication.
 
NCollection_Vec4 Multiplied (const Element_t theFactor) const
 Compute per-component multiplication.
 
NCollection_Vec4 cwiseMin (const NCollection_Vec4 &theVec) const
 Compute component-wise minimum of two vectors.
 
NCollection_Vec4 cwiseMax (const NCollection_Vec4 &theVec) const
 Compute component-wise maximum of two vectors.
 
NCollection_Vec4 cwiseAbs () const
 Compute component-wise modulus of the vector.
 
Element_t maxComp () const
 Compute maximum component of the vector.
 
Element_t minComp () const
 Compute minimum component of the vector.
 
Element_t Dot (const NCollection_Vec4 &theOther) const
 Computes the dot product.
 
NCollection_Vec4operator/= (const Element_t theInvFactor)
 Compute per-component division by scale factor.
 
NCollection_Vec4operator/= (const NCollection_Vec4 &theRight)
 Compute per-component division.
 
NCollection_Vec4 operator/ (const Element_t theInvFactor)
 Compute per-component division by scale factor.
 
void DumpJson (Standard_OStream &theOStream, Standard_Integer theDepth=-1) const
 Dumps the content of me into the stream.
 
NCollection_Vec4< float > & operator/= (const float theInvFactor)
 Optimized concretization for float type.
 
NCollection_Vec4< double > & operator/= (const double theInvFactor)
 Optimized concretization for double type.
 

Static Public Member Functions

static int Length ()
 Returns the number of components.
 

Detailed Description

template<typename Element_t>
class NCollection_Vec4< Element_t >

Generic 4-components vector. To be used as RGBA color vector or XYZW 3D-point with special W-component for operations with projection / model view matrices. Use this class for 3D-points carefully because declared W-component may results in incorrect results if used without matrices.

Constructor & Destructor Documentation

◆ NCollection_Vec4() [1/6]

template<typename Element_t >
NCollection_Vec4< Element_t >::NCollection_Vec4 ( )
inline

Empty constructor. Construct the zero vector.

◆ NCollection_Vec4() [2/6]

template<typename Element_t >
NCollection_Vec4< Element_t >::NCollection_Vec4 ( const Element_t theValue)
inlineexplicit

Initialize ALL components of vector within specified value.

◆ NCollection_Vec4() [3/6]

template<typename Element_t >
NCollection_Vec4< Element_t >::NCollection_Vec4 ( const Element_t theX,
const Element_t theY,
const Element_t theZ,
const Element_t theW )
inlineexplicit

Per-component constructor.

◆ NCollection_Vec4() [4/6]

template<typename Element_t >
NCollection_Vec4< Element_t >::NCollection_Vec4 ( const NCollection_Vec2< Element_t > & theVec2)
inlineexplicit

Constructor from 2-components vector.

◆ NCollection_Vec4() [5/6]

template<typename Element_t >
NCollection_Vec4< Element_t >::NCollection_Vec4 ( const NCollection_Vec3< Element_t > & theVec3,
const Element_t theW = Element_t(0) )
inlineexplicit

Constructor from 3-components vector + optional 4th value.

◆ NCollection_Vec4() [6/6]

template<typename Element_t >
template<typename OtherElement_t >
NCollection_Vec4< Element_t >::NCollection_Vec4 ( const NCollection_Vec4< OtherElement_t > & theOtherVec4)
inlineexplicit

Conversion constructor (explicitly converts some 4-component vector with other element type to a new 4-component vector with the element type Element_t, whose elements are static_cast'ed corresponding elements of theOtherVec4 vector)

Template Parameters
OtherElement_tthe element type of the other 4-component vector theOtherVec4
Parameters
theOtherVec4the 4-component vector that needs to be converted

Member Function Documentation

◆ a() [1/2]

template<typename Element_t >
Element_t & NCollection_Vec4< Element_t >::a ( )
inline

Alias to 4th component as ALPHA channel in RGBA.

◆ a() [2/2]

template<typename Element_t >
Element_t NCollection_Vec4< Element_t >::a ( ) const
inline

Alias to 4th component as ALPHA channel in RGBA.

◆ b() [1/2]

template<typename Element_t >
Element_t & NCollection_Vec4< Element_t >::b ( )
inline

Alias to 3rd component as BLUE channel in RGBA.

◆ b() [2/2]

template<typename Element_t >
Element_t NCollection_Vec4< Element_t >::b ( ) const
inline

Alias to 3rd component as BLUE channel in RGBA.

◆ ChangeData()

template<typename Element_t >
Element_t * NCollection_Vec4< Element_t >::ChangeData ( )
inline

◆ cwiseAbs()

template<typename Element_t >
NCollection_Vec4 NCollection_Vec4< Element_t >::cwiseAbs ( ) const
inline

Compute component-wise modulus of the vector.

◆ cwiseMax()

template<typename Element_t >
NCollection_Vec4 NCollection_Vec4< Element_t >::cwiseMax ( const NCollection_Vec4< Element_t > & theVec) const
inline

Compute component-wise maximum of two vectors.

◆ cwiseMin()

template<typename Element_t >
NCollection_Vec4 NCollection_Vec4< Element_t >::cwiseMin ( const NCollection_Vec4< Element_t > & theVec) const
inline

Compute component-wise minimum of two vectors.

◆ Dot()

template<typename Element_t >
Element_t NCollection_Vec4< Element_t >::Dot ( const NCollection_Vec4< Element_t > & theOther) const
inline

Computes the dot product.

◆ DumpJson()

template<typename Element_t >
void NCollection_Vec4< Element_t >::DumpJson ( Standard_OStream & theOStream,
Standard_Integer theDepth = -1 ) const
inline

Dumps the content of me into the stream.

◆ g() [1/2]

template<typename Element_t >
Element_t & NCollection_Vec4< Element_t >::g ( )
inline

Alias to 2nd component as GREEN channel in RGBA.

◆ g() [2/2]

template<typename Element_t >
Element_t NCollection_Vec4< Element_t >::g ( ) const
inline

Alias to 2nd component as GREEN channel in RGBA.

◆ GetData()

template<typename Element_t >
const Element_t * NCollection_Vec4< Element_t >::GetData ( ) const
inline

Raw access to the data (for OpenGL exchange).

◆ IsEqual()

template<typename Element_t >
bool NCollection_Vec4< Element_t >::IsEqual ( const NCollection_Vec4< Element_t > & theOther) const
inline

Check this vector with another vector for equality (without tolerance!).

◆ Length()

template<typename Element_t >
static int NCollection_Vec4< Element_t >::Length ( )
inlinestatic

Returns the number of components.

◆ maxComp()

template<typename Element_t >
Element_t NCollection_Vec4< Element_t >::maxComp ( ) const
inline

Compute maximum component of the vector.

◆ minComp()

template<typename Element_t >
Element_t NCollection_Vec4< Element_t >::minComp ( ) const
inline

Compute minimum component of the vector.

◆ Multiplied()

template<typename Element_t >
NCollection_Vec4 NCollection_Vec4< Element_t >::Multiplied ( const Element_t theFactor) const
inline

Compute per-component multiplication.

◆ Multiply()

template<typename Element_t >
void NCollection_Vec4< Element_t >::Multiply ( const Element_t theFactor)
inline

Compute per-component multiplication.

◆ operator const Element_t *()

template<typename Element_t >
NCollection_Vec4< Element_t >::operator const Element_t * ( ) const
inline

◆ operator Element_t *()

template<typename Element_t >
NCollection_Vec4< Element_t >::operator Element_t * ( )
inline

◆ operator!=()

template<typename Element_t >
bool NCollection_Vec4< Element_t >::operator!= ( const NCollection_Vec4< Element_t > & theOther) const
inline

Check this vector with another vector for non-equality (without tolerance!).

◆ operator*()

template<typename Element_t >
NCollection_Vec4 NCollection_Vec4< Element_t >::operator* ( const Element_t theFactor) const
inline

Compute per-component multiplication.

◆ operator*=() [1/2]

template<typename Element_t >
NCollection_Vec4 & NCollection_Vec4< Element_t >::operator*= ( const Element_t theFactor)
inline

Compute per-component multiplication.

◆ operator*=() [2/2]

template<typename Element_t >
NCollection_Vec4 & NCollection_Vec4< Element_t >::operator*= ( const NCollection_Vec4< Element_t > & theRight)
inline

Compute per-component multiplication.

◆ operator+=()

template<typename Element_t >
NCollection_Vec4 & NCollection_Vec4< Element_t >::operator+= ( const NCollection_Vec4< Element_t > & theAdd)
inline

Compute per-component summary.

◆ operator-()

template<typename Element_t >
NCollection_Vec4 NCollection_Vec4< Element_t >::operator- ( ) const
inline

Unary -.

◆ operator-=()

template<typename Element_t >
NCollection_Vec4 & NCollection_Vec4< Element_t >::operator-= ( const NCollection_Vec4< Element_t > & theDec)
inline

Compute per-component subtraction.

◆ operator/()

template<typename Element_t >
NCollection_Vec4 NCollection_Vec4< Element_t >::operator/ ( const Element_t theInvFactor)
inline

Compute per-component division by scale factor.

◆ operator/=() [1/4]

NCollection_Vec4< double > & NCollection_Vec4< double >::operator/= ( const double theInvFactor)
inline

Optimized concretization for double type.

◆ operator/=() [2/4]

template<typename Element_t >
NCollection_Vec4 & NCollection_Vec4< Element_t >::operator/= ( const Element_t theInvFactor)
inline

Compute per-component division by scale factor.

◆ operator/=() [3/4]

NCollection_Vec4< float > & NCollection_Vec4< float >::operator/= ( const float theInvFactor)
inline

Optimized concretization for float type.

◆ operator/=() [4/4]

template<typename Element_t >
NCollection_Vec4 & NCollection_Vec4< Element_t >::operator/= ( const NCollection_Vec4< Element_t > & theRight)
inline

Compute per-component division.

◆ operator==()

template<typename Element_t >
bool NCollection_Vec4< Element_t >::operator== ( const NCollection_Vec4< Element_t > & theOther) const
inline

Check this vector with another vector for equality (without tolerance!).

◆ r() [1/2]

template<typename Element_t >
Element_t & NCollection_Vec4< Element_t >::r ( )
inline

Alias to 1st component as RED channel in RGBA.

◆ r() [2/2]

template<typename Element_t >
Element_t NCollection_Vec4< Element_t >::r ( ) const
inline

Alias to 1st component as RED channel in RGBA.

◆ SetValues() [1/2]

template<typename Element_t >
void NCollection_Vec4< Element_t >::SetValues ( const Element_t theX,
const Element_t theY,
const Element_t theZ,
const Element_t theW )
inline

Assign new values to the vector.

◆ SetValues() [2/2]

template<typename Element_t >
void NCollection_Vec4< Element_t >::SetValues ( const NCollection_Vec3< Element_t > & theVec3,
const Element_t theW )
inline

Assign new values as 3-component vector and a 4-th value.

◆ w() [1/2]

template<typename Element_t >
Element_t & NCollection_Vec4< Element_t >::w ( )
inline

Alias to 4th component as W coordinate in XYZW.

◆ w() [2/2]

template<typename Element_t >
Element_t NCollection_Vec4< Element_t >::w ( ) const
inline

Alias to 4th component as W coordinate in XYZW.

◆ x() [1/2]

template<typename Element_t >
Element_t & NCollection_Vec4< Element_t >::x ( )
inline

Alias to 1st component as X coordinate in XYZW.

Returns
2 of XYZW components in specified order as vector in GLSL-style
3 of XYZW components in specified order as vector in GLSL-style
RGB components as vector

◆ x() [2/2]

template<typename Element_t >
Element_t NCollection_Vec4< Element_t >::x ( ) const
inline

Alias to 1st component as X coordinate in XYZW.

◆ y() [1/2]

template<typename Element_t >
Element_t & NCollection_Vec4< Element_t >::y ( )
inline

Alias to 2nd component as Y coordinate in XYZW.

◆ y() [2/2]

template<typename Element_t >
Element_t NCollection_Vec4< Element_t >::y ( ) const
inline

Alias to 2nd component as Y coordinate in XYZW.

◆ z() [1/2]

template<typename Element_t >
Element_t & NCollection_Vec4< Element_t >::z ( )
inline

Alias to 3rd component as Z coordinate in XYZW.

◆ z() [2/2]

template<typename Element_t >
Element_t NCollection_Vec4< Element_t >::z ( ) const
inline

Alias to 3rd component as Z coordinate in XYZW.


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