|
| int | getLength () const |
| | Returns length of path chain (number of nodekits).
|
| |
| SoNode * | getTail () const |
| | Return the last nodekit in a path chain.
|
| |
| 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.
|
| |
| void | truncate (int start) |
| | Truncates the path chain, removing all nodes from index start on.
|
| |
| void | pop () |
| | Pops the last nodekit off the end of the path.
|
| |
| void | append (SoBaseKit *childKit) |
| | Adds childKit to end of chain; uses first occurrence of childKit as a part within current last nodekit.
|
| |
| 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.
|
| |
| bool | containsNode (SoBaseKit *node) 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.
|
| |
| | SoPath () |
| | Constructs an empty path.
|
| |
| | SoPath (int approxLength) |
| | Constructs a path with a hint to length (number of nodes in chain).
|
| |
| | SoPath (SoNode *node) |
| | Constructs a path and sets the head node to the given node.
|
| |
| void | setHead (SoNode *node) |
| | Sets head node (first node in chain).
|
| |
| void | append (int childIndex) |
| | Adds node to end of chain; the node is the childIndex'th child of the current tail node.
|
| |
| void | append (SoNode *childNode) |
| | Adds node to end of chain; uses the first occurrence of childNode as child of current tail node.
|
| |
| void | append (const SoPath *fromPath) |
| | Adds all nodes 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 | push (int childIndex) |
| | These allow a path to be treated as a stack; they push a node at the end of the chain and pop the last node off.
|
| |
| void | pop () |
| | These allow a path to be treated as a stack; they push a node at the end of the chain and pop the last node off.
|
| |
| SoNode * | getHead () const |
| | These return the first and last nodes in a path chain.
|
| |
| SoNode * | getTail () const |
| | These return the first and last nodes in a path chain.
|
| |
| SoNode * | getNode (int i) const |
| | Returns a pointer to the i'th node in the chain.
|
| |
| SoNode * | getNodeFromTail (int i) const |
| | Returns a pointer to the i'th node.
|
| |
| int | getIndex (int i) const |
| | Return the index of the i'th node (within its parent) in the chain.
|
| |
| int | getIndexFromTail (int i) const |
| | Return the index of the i'th node (within its parent) in the chain, counting backward from the tail node.
|
| |
| int | getLength () const |
| | Returns length of path chain (number of nodes).
|
| |
| void | truncate (int start) |
| | Truncates the path chain, removing all nodes from index start on.
|
| |
| bool | containsNode (const SoNode *node) const |
| | Returns TRUE if the node is found anywhere in the path chain.
|
| |
| bool | containsPath (const SoPath *path) const |
| | Returns TRUE if the nodes in the chain in the passed path are contained (in consecutive order) in this path chain.
|
| |
| int | findFork (const SoPath *path) const |
| | If the two paths have different head nodes, this returns -1.
|
| |
| SoPath * | copy (int startFromNodeIndex=0, int numNodes=0) const |
| | Creates and returns a new path that is a copy of some or all of this path.
|
| |
| virtual SoType | getTypeId () const |
| | Returns type identifier for path instance.
|
| |
| void | insertIndex (SoNode *parent, int newIndex) |
| | This is called when a node in the path chain has a child added.
|
| |
| void | removeIndex (SoNode *parent, int oldIndex) |
| | This is called when a node in the path chain has a child removed.
|
| |
| void | replaceIndex (SoNode *parent, int index, SoNode *newChild) |
| | This is called when a node in the path chain replaces a child.
|
| |
| virtual void | write (SoWriteAction *writeAction) const |
| | Writes path using given write action.
|
| |
| bool | isRelevantNotification (SoNotList *list) const |
| | Returns TRUE if the given notification list involves a change to a node that affects the path.
|
| |
| void | ref () const |
| | Adds and removes a reference to an instance.
|
| |
| void | unref () const |
| |
| void | unrefNoDelete () const |
| |
| void | touch () |
| | Marks an instance as modified, simulating a change to it.
|
| |
| virtual SoType | getTypeId () const =0 |
| | Returns the type identifier for a specific instance.
|
| |
| bool | isOfType (SoType type) const |
| | Returns TRUE if this object is of the type specified in type or is derived from that type.
|
| |
| virtual SbName | getName () const |
| | Returns the name of an instance.
|
| |
| virtual void | setName (const SbName &name) |
| | Sets the name of an instance.
|
| |
| virtual void | startNotify () |
| | Initiates notification from an instance.
|
| |
| virtual void | notify (SoNotList *list) |
| | Propagates modification notification through an instance.
|
| |
| void | addAuditor (void *auditor, SoNotRec::Type type) |
| | Adds/removes an auditor to/from list.
|
| |
| void | removeAuditor (void *auditor, SoNotRec::Type type) |
| |
| const SoAuditorList & | getAuditors () |
| | Returns auditor list– used by SoField and SoEngineOutput to trace forward connections.
|
| |
| int | getRefCount () const |
| | Returns current reference count.
|
| |
| virtual void | addWriteReference (SoOutput *out, bool isFromField=FALSE) |
| | Adds a reference to the instance when writing.
|
| |
| bool | shouldWrite () |
| | Returns TRUE if the instance should be written, based on the write-reference info already accumulated.
|
| |
|
| static SoType | getClassTypeId () |
| | Returns type identifier for SoPath class.
|
| |
| static SoPath * | getByName (const SbName &name) |
| |
| static int | getByName (const SbName &name, SoPathList &list) |
| | These methods lookup and return paths with a given name.
|
| |
| static void | initClass () |
| | Initializes path class.
|
| |
| static SoType | getClassTypeId () |
| | Returns type identifier for this class.
|
| |
| static void | initClass () |
| | Setup type information.
|
| |
| static void | incrementCurrentWriteCounter () |
| | Increments the current write counter at the start of a write operation.
|
| |
| static void | decrementCurrentWriteCounter () |
| | Decrements the current write counter after a write operation, in some rare cases.
|
| |
| static void | addName (SoBase *, const char *) |
| | Internal methods used to maintain the global name dictionary.
|
| |
| static void | removeName (SoBase *, const char *) |
| |
| static SoBase * | getNamedBase (const SbName &, SoType) |
| | Helper routines used to get stuff out of nameDict.
|
| |
| static int | getNamedBases (const SbName &, SoBaseList &, SoType) |
| |
| static bool | read (SoInput *in, SoBase *&base, SoType expectedType) |
| | Reads one instance of some subclass of SoBase.
|
| |
| static void | setInstancePrefix (const SbString &c) |
| | This defaults to "+" and is used when naming nodes that are DEF's and USE'd.
|
| |
| static bool | traceRefs |
| | Turns on/off reference count tracing (for debugging)
|
| |
| enum | BaseFlags { IS_ENGINE = 1
, IS_GROUP = 2
} |
| | This set of enums is used when reading and writing the base. More...
|
| |
| static uint32_t | getCurrentWriteCounter () |
| | Returns current write counter.
|
| |
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.
- See Also
- SoBaseKit, SoPath, SoRayPickAction, SoSearchAction
Definition at line 105 of file SoNodeKitPath.h.
Public Member Functions inherited from SoPath