This class is used to search scene graphs for specific nodes, nodes of a specific type, nodes with a specific name, or any combination of these. It can search for just the first or last node satisfying the criteria or for all such nodes. The action returns a path (OIV.Inventor.SoPath) to each node found. The searched for node is the "tail" of each path.

Note that the search criteria are cumulative. For example, if you do a search by name (OIV.Inventor.Actions.SoSearchAction.SetName(System.String)), then reuse the same OIV.Inventor.Actions.SoSearchAction object to do a search by type (OIV.Inventor.Actions.SoSearchAction.SetType(System.Type, System.Boolean)), the action will actually search for a node that satisfies both criteria. To avoid this problem, call OIV.Inventor.Actions.SoSearchAction.Reset() before reusing the action object.

By default OIV.Inventor.Actions.SoSearchAction only searches nodes that are actually traversed. For example it would not search all the children of an OIV.Inventor.Nodes.SoSwitch node unless the whichChild field is set to SO_SWITCH_ALL. To search all nodes in the scene graph (except nodekits - see next paragraph) call setSearchingAll(true).

Nodekits:

• By default OIV.Inventor.Actions.SoSearchAction will not search inside nodekits even when setSearchingAll is true. This is because nodekits try to keep their children hidden. To allow searching inside nodekits call the static method SoBaseKit.setSearchingChildren(true).

• A common problem is that when the searched for node is found inside a nodekit, the OIV.Inventor.SoPath method getTail() does not return the found node. This is also because nodekits try to keep their children hidden. To avoid this problem use FullPath.GetTail() instead.

Hidden references:

OIV.Inventor.Actions.SoSearchAction creates one or more OIV.Inventor.SoPath objects when applied to the scene graph. The OIV.Inventor.SoPath object references each node in the path. This reference will prevent the node and its associated memory from being reclaimed for as long as the OIV.Inventor.SoPath object exists. These OIV.Inventor.SoPath objects are stored internally in the action and exist until the action object itself is reclaimed or reset.

OIV.Inventor.Actions.SoSearchAction is convenient for finding one or many nodes in the scene graph. However it may be an inefficient solution for finding a large number of nodes because it uses CPU time and memory to create an OIV.Inventor.SoPath for every node found. If you expect to find many nodes, especially if you just need the node object and not a path, then you should consider using OIV.Inventor.Actions.SoCallbackAction instead.

For example, if you want to count all the shape nodes in the scene graph, you could use an OIV.Inventor.Actions.SoSearchAction similar to the second example below. The number of shapes would conveniently be the number of paths created by the action, but you wouldn't actually make any use of the path information. Using OIV.Inventor.Actions.SoCallbackAction would be a little more work, because you have to implement a counter in a delegate method. But it would be much more efficient because the action simply calls your delegatewhen each shape node is visited during the traversal.

EXAMPLE

Example 1: Given an instance of a node, create a path to the location of that node in the scene graph:

SoSearchAction sa = new SoSearchAction();
 sa.SetNode( coneNode );
 sa.SetSearchingAll( true );              // Optional: Search all nodes
 SoBaseKit.SetSearchingChildren( true );  // Optional: Search inside nodekits
 sa.Apply( root );
 SoPath path = sa.GetPath();
 if (path != null) {
   SoNode node = path.FullPath.GetTail();
 }

Example 2: Find all the OIV.Inventor.Nodes.SoFont nodes in the scene graph:

SoSearchAction sa = new SoSearchAction();
 sa.SetType( typeof(SoFont) );
 sa.SetInterest( SoSearchAction.Interests.ALL );   // Find ALL instances
 sa.SetSearchingAll( true );              // Optional: Search all nodes
 SoBaseKit.SetSearchingChildren( true );  // Optional: Search inside nodekits
 sa.Apply( rootNode );
 SoPathList pathList = sa.GetPaths();     // Get list of paths
 foreach (SoPath path in pathList)
 {
   SoFont fontNode = (SoFont)path.FullPath.GetTail();
   . . .
 }

Reference