Open Inventor Reference
SoModelMatrixElement Class Reference

Element that stores the current model matrix - the cumulative transformation applied to subsequent shapes. More...

#include <Inventor/elements/SoModelMatrixElement.h>

Inheritance diagram for SoModelMatrixElement:
SoAccumulatedElement SoElement SoBBoxModelMatrixElement SoGLModelMatrixElement

Public Member Functions

virtual void init (SoState *state)
 Initializes element. More...
 
virtual bool matches (const SoElement *elt) const
 Override standard matches to invalidate on cull-test. More...
 
virtual void push (SoState *state)
 Overrides push() method to copy values from next instance in the stack. More...
 
virtual void print (FILE *fp) const
 Prints element (for debugging) More...
 
- Public Member Functions inherited from SoElement
virtual void pop (SoState *state, const SoElement *prevTopElement)
 
SoType getTypeId () const
 Returns type identifier for element instance. More...
 
int getStackIndex () const
 Returns the stack index for an element instance. More...
 
void setDepth (int dpth)
 Sets stuff in an element instance. More...
 
void setNext (SoElement *nxt)
 
void setNextInStack (SoElement *nxt)
 
void setNextFree (SoElement *nxt)
 
int getDepth () const
 Returns stuff from element instance. More...
 
SoElementgetNext () const
 
virtual ~SoElement ()
 Destructor. More...
 

Static Public Member Functions

static void makeIdentity (SoState *state, SoNode *node)
 Sets the model matrix to the identity matrix. More...
 
static void set (SoState *state, SoNode *node, const SbMatrix &matrix)
 Sets the model matrix to the given matrix. More...
 
static void mult (SoState *state, SoNode *node, const SbMatrix &matrix)
 Multiplies the given matrix into the model matrix. More...
 
static void translateBy (SoState *state, SoNode *node, const SbVec3f &translation)
 Each of these multiplies a matrix that performs the specified transformation into the model matrix. More...
 
static void rotateBy (SoState *state, SoNode *node, const SbRotation &rotation)
 
static void scaleBy (SoState *state, SoNode *node, const SbVec3f &scaleFactor)
 
static SbMatrix pushMatrix (SoState *state)
 These methods are used by the TransformSeparator node. More...
 
static void popMatrix (SoState *state, const SbMatrix &m)
 
static void setCullMatrix (SoState *state, SoNode *node, const SbMatrix &matrix)
 Sets the transformation that defines the volume that view-volume culling should be tested against. More...
 
static const SbMatrixgetCombinedCullMatrix (SoState *state)
 This method gets the model*cullMatrix combined matrix (which is cached by this element). More...
 
static const SbMatrixget (SoState *state)
 Returns current model matrix from the state. More...
 
static const SbMatrixget (SoState *state, bool &isIdent)
 Returns current model matrix from the state, sets given flag to TRUE if matrix is known to be identity. More...
 
static void initClass ()
 Initializes the SoModelMatrixElement class. More...
 
- Static Public Member Functions inherited from SoAccumulatedElement
static void initClass ()
 Initializes the SoAccumulatedElement class. More...
 
- Static Public Member Functions inherited from SoElement
static SoType getClassTypeId ()
 Returns type identifier for SoElement class. More...
 
static void initElements ()
 Initialize ALL Inventor element classes. More...
 
static void initClass ()
 Initializes the SoElement class. More...
 
static int getNumStackIndices ()
 Returns the number of stack indices allocated. More...
 
static SoType getIdFromStackIndex (int stackIndex)
 Returns the id for the element with the given stack index. More...
 

Protected Member Functions

virtual void makeEltIdentity ()
 Sets the matrix in an instance to identity. More...
 
virtual void setElt (const SbMatrix &matrix)
 Sets the matrix in an instance to given matrix. More...
 
virtual void multElt (const SbMatrix &matrix)
 Multiplies into the matrix in an instance. More...
 
virtual void translateEltBy (const SbVec3f &translation)
 Each of these performs the appropriate operation on the matrix in an instance. More...
 
virtual void rotateEltBy (const SbRotation &translation)
 
virtual void scaleEltBy (const SbVec3f &scaleFactor)
 
virtual SbMatrix pushMatrixElt ()
 virtual methods for push/pop so GL element can Do The Right Thing: More...
 
virtual void popMatrixElt (const SbMatrix &m)
 
virtual ~SoModelMatrixElement ()
 
- Protected Member Functions inherited from SoAccumulatedElement
void clearNodeIds ()
 Clears out the list of node id's. More...
 
void addNodeId (const SoNode *node)
 Adds the id of the given node to the current list. More...
 
void setNodeId (const SoNode *node)
 Sets the node id list to JUST the id of the given node. More...
 
virtual SoElementcopyMatchInfo () const
 Create and return a copy of this element; this will copy the nodeId list properly. More...
 
virtual void captureThis (SoState *state) const
 Override normal capture method to capture elements at other depths that we are accumulating with. More...
 
virtual ~SoAccumulatedElement ()
 Destructor. More...
 
- Protected Member Functions inherited from SoElement
 SoElement ()
 Constructor; use typeId.createInstance to create elements. More...
 
void capture (SoState *state) const
 Does whatever is necessary in state to capture this element for caching purposes. More...
 
void setTypeId (SoType id)
 Sets typeId in instance. More...
 
void setStackIndex (int index)
 Sets stackIndex in instance. More...
 
SoElementgetNextInStack () const
 Returns next instance in specific element stack. More...
 
SoElementgetNextFree () const
 Returns next free element in a specific element stack. More...
 

Friends

class SoLocalBBoxMatrixElement
 

Additional Inherited Members

- Static Protected Member Functions inherited from SoElement
static SoElementgetElement (SoState *state, int stackIndex)
 Returns an instance of an element from the stack with the given index in the given state. More...
 
static const SoElementgetConstElement (SoState *state, int stackIndex)
 Returns a read-only pointer to the top instance in the given element stack. More...
 
static int createStackIndex (SoType id)
 Creates and returns a new stack index. More...
 
- Protected Attributes inherited from SoAccumulatedElement
SbPList nodeIds
 This stores the list of node id's as pointers, since they should be the same length as int32_ts. More...
 
- Static Protected Attributes inherited from SoElement
static int classStackIndex
 Stack index for SoElement class. More...
 

Detailed Description

Because the matrix is cumulative, this class is derived from SoAccumulatedElement. The set() method replaces the current matrix, while all the others (mult(), translateBy(), etc.) multiply into it. Node id's of the nodes that affect the element are accumulated properly.

This element also stores the current view-volume culling transformation, which is normally the view*projection matrices (set by cameras), but which may be modified by sophisticated culling schemes.

Definition at line 80 of file SoModelMatrixElement.h.

Constructor & Destructor Documentation

◆ ~SoModelMatrixElement()

virtual SoModelMatrixElement::~SoModelMatrixElement ( )
protectedvirtual

Member Function Documentation

◆ get() [1/2]

static const SbMatrix& SoModelMatrixElement::get ( SoState state)
static

◆ get() [2/2]

static const SbMatrix& SoModelMatrixElement::get ( SoState state,
bool &  isIdent 
)
static

◆ getCombinedCullMatrix()

static const SbMatrix& SoModelMatrixElement::getCombinedCullMatrix ( SoState state)
static

◆ init()

virtual void SoModelMatrixElement::init ( SoState state)
virtual

Reimplemented from SoElement.

Reimplemented in SoGLModelMatrixElement, and SoBBoxModelMatrixElement.

◆ initClass()

static void SoModelMatrixElement::initClass ( )
static

◆ makeEltIdentity()

virtual void SoModelMatrixElement::makeEltIdentity ( )
protectedvirtual

◆ makeIdentity()

static void SoModelMatrixElement::makeIdentity ( SoState state,
SoNode node 
)
static

◆ matches()

virtual bool SoModelMatrixElement::matches ( const SoElement elt) const
virtual

Reimplemented from SoAccumulatedElement.

◆ mult()

static void SoModelMatrixElement::mult ( SoState state,
SoNode node,
const SbMatrix matrix 
)
static

◆ multElt()

virtual void SoModelMatrixElement::multElt ( const SbMatrix matrix)
protectedvirtual

◆ popMatrix()

static void SoModelMatrixElement::popMatrix ( SoState state,
const SbMatrix m 
)
static

◆ popMatrixElt()

virtual void SoModelMatrixElement::popMatrixElt ( const SbMatrix m)
protectedvirtual

◆ print()

virtual void SoModelMatrixElement::print ( FILE *  fp) const
virtual

Reimplemented from SoAccumulatedElement.

◆ push()

virtual void SoModelMatrixElement::push ( SoState state)
virtual

Reimplemented from SoElement.

Reimplemented in SoGLModelMatrixElement, and SoBBoxModelMatrixElement.

◆ pushMatrix()

static SbMatrix SoModelMatrixElement::pushMatrix ( SoState state)
static

WARNING! For proper caching behavior, the matrix returned by ::pushMatrix() must be used ONLY as a later argument to ::popMatrix(), and you must NOT modify the matrix between the push and the pop. If you need the matrix for any other reason, you MUST use the ::get() routine.

◆ pushMatrixElt()

virtual SbMatrix SoModelMatrixElement::pushMatrixElt ( )
protectedvirtual

◆ rotateBy()

static void SoModelMatrixElement::rotateBy ( SoState state,
SoNode node,
const SbRotation rotation 
)
static

◆ rotateEltBy()

virtual void SoModelMatrixElement::rotateEltBy ( const SbRotation translation)
protectedvirtual

◆ scaleBy()

static void SoModelMatrixElement::scaleBy ( SoState state,
SoNode node,
const SbVec3f scaleFactor 
)
static

◆ scaleEltBy()

virtual void SoModelMatrixElement::scaleEltBy ( const SbVec3f scaleFactor)
protectedvirtual

◆ set()

static void SoModelMatrixElement::set ( SoState state,
SoNode node,
const SbMatrix matrix 
)
static

◆ setCullMatrix()

static void SoModelMatrixElement::setCullMatrix ( SoState state,
SoNode node,
const SbMatrix matrix 
)
static

◆ setElt()

virtual void SoModelMatrixElement::setElt ( const SbMatrix matrix)
protectedvirtual

◆ translateBy()

static void SoModelMatrixElement::translateBy ( SoState state,
SoNode node,
const SbVec3f translation 
)
static

◆ translateEltBy()

virtual void SoModelMatrixElement::translateEltBy ( const SbVec3f translation)
protectedvirtual

Friends And Related Function Documentation

◆ SoLocalBBoxMatrixElement

friend class SoLocalBBoxMatrixElement
friend

Definition at line 179 of file SoModelMatrixElement.h.

Member Data Documentation

◆ haveCullMatrix

unsigned int SoModelMatrixElement::haveCullMatrix

Definition at line 175 of file SoModelMatrixElement.h.

◆ haveModelCull

unsigned int SoModelMatrixElement::haveModelCull

Definition at line 176 of file SoModelMatrixElement.h.

◆ isModelIdentity

unsigned int SoModelMatrixElement::isModelIdentity

Definition at line 174 of file SoModelMatrixElement.h.


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