com.openinventor.inventor

Class SoFullPath

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.inventor.misc.SoBase

com.openinventor.inventor.SoPath

com.openinventor.inventor.SoFullPath

All Implemented Interfaces:

SafeDisposable

Deprecated.

As of Open Inventor 9.3

public class SoFullPath
extends SoPath

Path that allows access to hidden children. Open Inventor Java applications should not use this class.
Use instead the SoPath "full" methods to access hidden children in paths. For example:

 SoPath path = ...
 SoNode tail = path.full.getTail();

To build a new SoPath that exposes all the nodes (both visible and hidden) in a given path, for example to apply an action to hidden children, do this:

 SoPath fullpath = path.full.copy(0);

NOTE: Applying an action on an SoFullPath may not give the expected result.
When applying an action on an SoFullPath, the "hidden" children will not be traversed. If you want to apply an action on all the children in the path, use the following technique:

 SoPath* path = ...
 SoRef<SoPath> tempPath = ((SoFullPath*)path)->copy();
   action.apply( tempPath );
 tempPath = NULL;

File format/default:

SoPath {

[head node]
[number of remaining indices]
[index]
&...
[index]

}

See also:

SoPath

Nested Class Summary

Nested classes/interfaces inherited from class com.openinventor.inventor.Inventor

Inventor.ConstructorCommand

Field Summary

Fields inherited from class com.openinventor.inventor.SoPath

full, nodekit, regular

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Method Summary

Modifier and Type	Method and Description
int	getIndexFromTail(int i) Deprecated. Returns the index of the i'th node (within its parent) in the chain, counting backward from the tail node.
int	getInstanceIndexFromTail(int i) Deprecated. get instance Index from tail
int	getLength() Deprecated. Returns length of path chain (number of nodes).
SoNode	getNodeFromTail(int i) Deprecated. Returns the i'th node (within its parent) in the chain, counting backward from the tail node.
SoNode	getTail() Deprecated. Returns the last node in a path chain.
void	pop() Deprecated. The push() and pop() methods 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.

Methods inherited from class com.openinventor.inventor.SoPath

append, append, append, containsNode, containsPath, copy, copy, copy, equals, findFork, getAllByName, getByName, getHead, getIndex, getNode, opeq, push, setHead, truncate

Methods inherited from class com.openinventor.inventor.misc.SoBase

dispose, getEXTERNPROTO, getName, getPROTO, isDisposable, isSynchronizable, setName, setSynchronizable, touch

Methods inherited from class com.openinventor.inventor.Inventor

getAddress, getNativeResourceHandle, startInternalThreads, stopInternalThreads

Methods inherited from class java.lang.Object

getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getTail

public SoNode getTail()

Deprecated.

Returns the last node in a path chain.

Overrides:

getTail in class SoPath

pop

public void pop()

Deprecated.

The push() and pop() methods 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.

Overrides:

pop in class SoPath

getIndexFromTail

public int getIndexFromTail(int i)

Deprecated.

Returns the index of the i'th node (within its parent) in the chain, counting backward from the tail node. Passing 0 for i returns the index of the tail node.

Overrides:

getIndexFromTail in class SoPath

getInstanceIndexFromTail

public int getInstanceIndexFromTail(int i)

Deprecated.

get instance Index from tail

getNodeFromTail

public SoNode getNodeFromTail(int i)

Deprecated.

Returns the i'th node (within its parent) in the chain, counting backward from the tail node. Passing 0 for i returns the tail node.

Overrides:

getNodeFromTail in class SoPath

getLength

public int getLength()

Deprecated.

Returns length of path chain (number of nodes).

Overrides:

getLength in class SoPath