NAME

       SoNodeKitPath — path that points to a list of hierarchical nodekits

INHERITS FROM

       SoBase > SoPath > SoNodeKitPath

SYNOPSIS

       #include <Inventor/SoNodeKitPath.h>

          Methods from class SoNodeKitPath:

     void                append(SoBaseKit *childKit)
     void                append(const SoNodeKitPath *fromPath)
     void                pop()
     SoNode *            getTail() const
     SoNode *            getNode(int i) const
     SoNode *            getNodeFromTail(int i) const
     int                 getLength() const
     void                truncate(int start)
     SbBool              containsNode(const SoNodeKit *nodeKit) const
     int                 findFork(const SoNodeKitPath *path) const
     friend int          operator ==(const SoNodeKitPath &p1, const SoNodeKitPath &p2)

          Methods from class SoPath:

     void                setHead(SoNode *node)
     SoNode *            getHead() const
     SbBool              containsPath(const SoPath *path) const
     SoPath *            copy(int startFromNodeIndex = 0, int numNodes = 0) const
     static SoPath *     getByName(const SbName &name)
     static int          getByName(const SbName &name, SoPathList &list)

          Methods from class SoBase:

     void                ref()
     void                unref() const
     void                unrefNoDelete() const
     void                touch()
     static SoType       getClassTypeId()
     virtual SoType      getTypeId() const
     SbBool              isOfType(SoType type) const
     virtual void        setName(const SbName &name)
     virtual SbName      getName() const

DESCRIPTION

       SoNodeKitPath  is  a subclass of SoPath that lets you look at nodekits below the top nodekit in the path.
       Since nodekits have hidden children, when you call getTail() on a regular path, it returns  the  top-most
       nodekit  on  the path.  This occurs even though the path might contain extra internal information leading
       to a node far deeper in the scene graph. For example, when picking an object inside  an  SoSceneKit,  the
       regular path would end at the scenekit.  But a nodekit path would continue further down listing the other
       nodekits below it in the path.

       Intermediary (private) nodes between nodekits are not included in the nodekit path.

       Note that there is no constructor for an SoNodeKitPath, so you can not create one. Rather,  you  cast  an
       (SoPath  *)  into an (SoNodeKitPath *), which returns nodekit-style values from all the same questions as
       SoPath.

       Also, some methods of SoPath may not be called on an SoNodeKitPath. Any  methods  which  take  a  regular
       SoNode  as  an  argument  (except for setHead()) are not accessible, and replaced by methods that take an
       SoBaseKit as an argument instead. Methods which allow the programmer to refer to the  child  index  of  a
       node  beneath  its  parent are also inaccessible; since a SoNodeKitPath only shows nodekits and hides any
       private parts, successive nodekits in the path may not actually be parent and child.

METHODS

     void                append(SoBaseKit *childKit)
          Adds childKit to end of chain; uses first occurrence  of  childKit  as  a  part  within  current  last
          nodekit. If the path is empty, this is equivalent to setHead(childKit).

     void                append(const SoNodeKitPath *fromPath)
          Adds  all  nodekits in fromPath's chain to end of chain; the head node of fromPath must be the same as
          or a child of the current tail node.

     void                pop()
          Pops the last nodekit off the end of the path.

     SoNode *            getTail() const
          Return the last nodekit in a path chain. Note that getHead() is not redefined from  SoPath,  since  an
          SoNodeKitPath need not begin with a nodekit; the restriction is placed only on successive nodes on the
          path.

     SoNode *            getNode(int i) const
          Returns a pointer to the i'th node in the nodekit path.

     SoNode *            getNodeFromTail(int i) const
          Returns a pointer to the i'th nodekit in the chain, counting backward from the tail nodekit. Passing 0
          for i returns the tail nodekit.

     int                 getLength() const
          Returns length of path chain (number of nodekits).

     void                truncate(int start)
          Truncates  the  path  chain,  removing all nodes from index start on. Calling truncate(0)  empties the
          path entirely.

     SbBool              containsNode(const SoNodeKit *nodeKit) const
          Returns TRUE if the passed nodekit is found anywhere in the path chain.

     int                 findFork(const SoNodeKitPath *path) const
          If the two paths have different head nodes, this returns -1. Otherwise,  it  returns  the  path  chain
          index of the last nodekit (starting at the head) that is the same for both paths.

     friend int          operator ==(const SoNodeKitPath &p1, const SoNodeKitPath &p2)
          Returns TRUE if all node pointers in the two nodekit path chains are equal.

SEE ALSO

       SoBaseKit, SoPath, SoRayPickAction, SoSearchAction

                                                                                            SoNodeKitPath(3IV)()