table of contents
other sections
SoNodeKitPath(3IV)() | SoNodeKitPath(3IV)() |
NAME¶
SoNodeKitPath — path that points to a list of hierarchical nodekitsINHERITS FROM¶
SoBase > SoPath > SoNodeKitPathSYNOPSIS¶
#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.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.