man SoAction () - abstract base class for all actions

NAME

SoAction - abstract base class for all actions

INHERITS FROM

SoAction

SYNOPSIS

#include <Inventor/actions/SoAction.h> Methods from class SoAction: c } c } ~SoAction()

c } c } apply(SoNode *node)

c } c } apply(SoPath *path)

c } c } apply(const SoPathList &pathList, SbBool obeysRules = FALSE)

c } c } getClassTypeId()

c } c } getTypeId()

c } c } isOfType(SoType type)

c } c } invalidateState()

DESCRIPTION

SoAction is the abstract base class for all actions. Classes derived from SoAction define operations to be applied at each node encountered during traversal of a scene graph. The function that gets called to implement the action for a particular node type is determined by a lookup table in the global database.

METHODS

c } c } ~SoAction()

Destructor. c } c } apply(SoNode *node)

c } c } apply(SoPath *path)

c } c } apply(const SoPathList &pathList, SbBool obeysRules = FALSE)

Initiates an action on the graph defined either by a node, path, or list of paths. TRUE can be passed for the obeysRules flag if the given path list has the following 4 properties:

1 - All paths have the same head node 2 - Paths are sorted in traversal order 3 - If one path ends at node A, no other path continues through A 4 - No two paths are the same

These rules will be obeyed by path lists returned by picking and by searches for non-group nodes. c } c } getClassTypeId()

Returns the type identifier for this class. c } c } getTypeId()

Returns the type identifier for a specific instance. c } c } isOfType(SoType type)

Returns TRUE if this instance is of the type specified in type or is derived from that type. Otherwise, it returns FALSE. For example,

actionPtr->isOfType(SoGetMatrixAction::getClassTypeId())

returns TRUE if actionPtr is an instance of SoGetMatrixAction or one of its subclasses. c } c } invalidateState()

Invalidates the current traversal state in the action, forcing it to be recreated when the action is next applied. This is typically unnecessary in most applications.

SEE ALSO

SoNode, SoPath, SoPathList, SoCallbackAction, SoGLRenderAction, SoGetBoundingBoxAction, SoGetMatrixAction, SoHandleEventAction, SoPickAction, SoRayPickAction, SoSearchAction, SoWriteAction