coin_actions(3)

NAME
coin_actions - Action Classes

 - Actions are objects that traverse a scene graph to drive some scene-related process.

SYNOPSIS

  Classes
class SoAction
The SoAction class is the base class for all traversal actions.
class SoBoxHighlightRenderAction
The SoBoxHighlightRenderAction class renders the scene with highlighted boxes around selections.
class SoCallbackAction
The SoCallbackAction class invokes callbacks at specific nodes.
class SoGLRenderAction
The SoGLRenderAction class renders the scene graph with OpenGL calls.
class SoGetBoundingBoxAction
The SoGetBoundingBoxAction class calculates bounding boxes for nodes and subgraphs.
class SoGetMatrixAction
The SoGetMatrixAction class is an action for accumulating the transformation matrix of a subgraph.
class SoGetPrimitiveCountAction
The SoGetPrimitiveCountAction class counts the primitives in a scene.
class SoHandleEventAction
The SoHandleEventAction class distributes user events to the scene.
class SoLineHighlightRenderAction
The SoLineHighlightRenderAction class renders selections with line highlighting.
class SoPickAction
The SoPickAction class is the base class for picking actions.
class SoRayPickAction
The SoRayPickAction class does ray intersection with scene graphs.
class SoReorganizeAction
The SoReorganizeAction class reorganizes your scene graph to optimize traversal/rendering.
class SoSearchAction
The SoSearchAction class provides methods for searching through scene graphs.
class SoToVRMLAction
The SoToVRMLAction class builds a new scene graph using only VRML 1.0 nodes.
class SoToVRML2Action
The SoToVRML2Action class builds a new scene graph, using only VRML97/VRML2 nodes.
class SoWriteAction
The SoWriteAction class writes a scene graph to file.
class SoAudioRenderAction
The SoAudioRenderAction class renders the aural parts of the scene graph.
class SoActionMethodList
The SoActionMethodList class contains function pointers for action methods.
class SoEnabledElementsList
The SoEnabledElementsList class is a container for type info for element types that are enabled in actions.
class SoIntersectionDetectionAction
The SoIntersectionDetectionAction class is for detecting intersecting primitives in a scene.

Detailed Description

Actions are objects that traverse a scene graph to drive some scene-related process. One example is OpenGL rendering, and another one ray picking. At the most basic level, most action management will be done for the user behind the scenes in an SoSceneManager object, and the only actions one might need to get acquainted with are SoSearchAction and SoWriteAction.

For more advanced usage of Coin, one might want (or need) to take full control over driving all the actions oneself, in which case one will also need to know about the SoGLRenderAction, SoHandleEventAction, SoGetBoundingBoxAction, and SoRayPickAction.

The remaining actions are mostly more special-purpose actions of various kinds, except for the SoCallbackAction.

Before going to the step of implementing an extension action, one should really take a good look at the SoCallbackAction class, which is a general-purpose action that can be used as the framework for implementing almost any traversal-based process, with callback-hooks for all kinds of events that happen during traversal. In most cases, one can avoid the hassle of writing a new action, and just use SoCallbackAction instead.

Author

Generated automatically by Doxygen for Coin from the source code.