Coin Logo Coin3D is Free Software,
published under the BSD 3-clause license.
https://bitbucket.org/Coin3D/
http://www.kongsberg.com/kogt/
Action Classes

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

Classes

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

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.