Sets any public part in the interaction kit as a "surrogate" path instead. The object at the end of the path serves as a stand-in when a pick occurs, and can thus initiate interaction.
Instead of the
usual
setPart(), which replaces
partName with a new node, this will remove the node being used for
partName from the scene and remember the
surrogatePath you give it. Later, any pick on
surrogatePath will be regarded as a pick on
partName.
For example, set the
XRotator
part of an
SoTrackballDragger to be the path to an object in the scene. The rest of the trackball will look the same, but the
XRotator stripe will disappear. However, click the mouse on the object at the end of
surrogatePath and the ball
will start to drag in rotation around its X axis.
Note that this is different from setting the part to be the node at the end of the path. When you set the part as a node, a second instance will be drawn
in the local space of the interaction kit. When you set it as a path, the object itself is used, not a copy.
The
partName may be any part name that follows the nodekit syntax for parts, such as
childList[0].shape or
rotator.rotatorActive. (See the
getPart() method
in the
SoBaseKit reference page for a complete description.)