SoMultiPathSwitch Class Reference

Group node that traverses only when traversed along a given path. More...

#include <Inventor/nodes/SoMultiPathSwitch.h>

Inheritance diagram for SoMultiPathSwitch:
SoGroup SoNode SoFieldContainer SoBase SoRefCounter SoTypedObject

List of all members.

Public Member Functions

virtual SoType getTypeId () const
 SoMultiPathSwitch ()
 SoMultiPathSwitch (int nChildren)

Static Public Member Functions

static SoType getClassTypeId ()

Public Attributes

SoMFPath paths

Detailed Description

Group node that traverses only when traversed along a given path.

SoMultiPathSwitch is a group node that traverses its children only if the current traversal path matches one of the SoPath specified in the paths field.

This can be used, for example, to affect only specific instances of a subgraph. The paths field contains a list of paths up to (but not including) the SoMultiPathsSwitch. The paths need not go all the way back to the root; if they do not, then only the number of ancestors that are in the path are compared to see if the children should be traversed.

An empty paths (the default) means that no children are traversed.

Effectively this is an extended version of SoPathSwitch.

Note: This node disables the bounding box cache for all SoSeparator nodes above it in the scene graph. This may reduce performance when moving the camera and the viewer's auto clip plane adjustment is enabled (the default). (It does not affect render caching.)




SoMultiSwitch, SoPath, SoPathSwitch, SoSwitch

See related examples:

InteractiveSwitch, MultiPathSwitch, MultiSwitch, PathSwitch

Constructor & Destructor Documentation

SoMultiPathSwitch::SoMultiPathSwitch (  ) 

Create a multi-path switch node with default settings.

SoMultiPathSwitch::SoMultiPathSwitch ( int  nChildren  ) 

Constructor that takes approximate number of children.

Member Function Documentation

static SoType SoMultiPathSwitch::getClassTypeId (  )  [static]

Returns the type identifier for this class.

Reimplemented from SoGroup.

virtual SoType SoMultiPathSwitch::getTypeId (  )  const [virtual]

Returns the type identifier for this specific instance.

Reimplemented from SoGroup.

Member Data Documentation

The list of paths that can match the current traversal path.

Default is empty (no children will be traversed).

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

Open Inventor Toolkit reference manual, generated on 12 Sep 2022
Copyright © Thermo Fisher Scientific All rights reserved.