Open Inventor Reference
Public Member Functions | Static Public Member Functions | Protected Member Functions
SoMultipleCopy Class Reference
Nodes

Group node that traverses multiple times, applying matrices. More...

#include <Inventor/nodes/SoMultipleCopy.h>

Inheritance diagram for SoMultipleCopy:
SoGroup SoNode SoFieldContainer SoBase

List of all members.

Public Member Functions

 SoMultipleCopy ()
 Creates a multiple copy node with default settings.
virtual SbBool affectsState () const
 Overrides default method on SoNode to return FALSE since these nodes are effectively separators.
virtual void doAction (SoAction *action)
 Implement actions.
virtual void callback (SoCallbackAction *action)
virtual void GLRender (SoGLRenderAction *action)
 These virtual functions implement all of the actions for nodes, Most of the default implementations do nothing.
virtual void pick (SoPickAction *action)
virtual void getBoundingBox (SoGetBoundingBoxAction *action)
virtual void handleEvent (SoHandleEventAction *action)
virtual void getMatrix (SoGetMatrixAction *action)
virtual void search (SoSearchAction *action)

Static Public Member Functions

static void initClass ()
 Initializes base node class.

Public Attributes

Fields
SoMFMatrix matrix
 Set of matrices to apply to children.

Protected Member Functions

virtual ~SoMultipleCopy ()

Detailed Description

This group node traverses its children, in order, several times, applying a different matrix each time. The matrices are stored in the multiple-value matrix field. Each matrix is concatenated to the current transformation matrix, and all of the children are traversed. This allows the user to put multiple copies of the same data in different locations easily and efficiently.

Traversing the Nth child sets the current switch value to N, for use with inherited switch values (see SoSwitch).

File Format/Default
MultipleCopy {
  matrix 1 0 0 0
        0 1 0 0
        0 0 1 0
        0 0 0 1
}
Action Behavior
SoGLRenderAction, SoCallbackAction, SoGetBoundingBoxAction, SoRayPickAction
Traverses all children for each matrix, saving and restoring state before and after each traversal.
SoSearchAction
Traverses all children once, setting the inherited switch value to SO_SWITCH_ALL first.
See Also
SoArray, SoSwitch

Definition at line 103 of file SoMultipleCopy.h.

Constructor & Destructor Documentation

SoMultipleCopy::SoMultipleCopy ( )
virtual SoMultipleCopy::~SoMultipleCopy ( ) [protected, virtual]

Member Function Documentation

virtual SbBool SoMultipleCopy::affectsState ( ) const [virtual]

Reimplemented from SoNode.

virtual void SoMultipleCopy::callback ( SoCallbackAction *  action) [virtual]

Reimplemented from SoGroup.

virtual void SoMultipleCopy::doAction ( SoAction *  action) [virtual]

Reimplemented from SoGroup.

virtual void SoMultipleCopy::getBoundingBox ( SoGetBoundingBoxAction *  action) [virtual]

Reimplemented from SoGroup.

virtual void SoMultipleCopy::getMatrix ( SoGetMatrixAction *  action) [virtual]

Reimplemented from SoGroup.

virtual void SoMultipleCopy::GLRender ( SoGLRenderAction *  action) [virtual]

Reimplemented from SoGroup.

virtual void SoMultipleCopy::handleEvent ( SoHandleEventAction *  action) [virtual]

Reimplemented from SoGroup.

static void SoMultipleCopy::initClass ( ) [static]

Reimplemented from SoGroup.

virtual void SoMultipleCopy::pick ( SoPickAction *  action) [virtual]

Reimplemented from SoGroup.

virtual void SoMultipleCopy::search ( SoSearchAction *  action) [virtual]

Reimplemented from SoGroup.

Member Data Documentation

SoMFMatrix SoMultipleCopy::matrix

Definition at line 112 of file SoMultipleCopy.h.

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