com.openinventor.inventor.nodes

Class SoRenderList

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.inventor.misc.SoBase

com.openinventor.inventor.fields.SoFieldContainer

com.openinventor.inventor.nodes.SoNode

com.openinventor.inventor.nodes.SoGroup

com.openinventor.inventor.nodes.SoSeparator

com.openinventor.inventor.nodes.SoRenderList

All Implemented Interfaces:

SafeDisposable

Direct Known Subclasses:

SoOcclusionCulling, SoOctreeOrdering, SoValueOrdering

Deprecated.

As of Open Inventor 9800 See documentation for more details

public class SoRenderList
extends SoSeparator

Abstract group node that changes traversal from the scene graph to a list of render objects. This abstract node keeps track of paths to the shapes beneath it. Derived classes can traverse or reorganize this list instead of traversing in scene graph order. As the scene graph changes, the SoRenderList node will update the list of paths, calling virtual functions for the derived classes to update their data structures.

<font color="#0000FF">NOTE:</font> This class does not exist in Open Inventor 10.0 and later.

By default, the SoRenderList node keeps track of paths to instances of SoShape, SoLOD, and some manipulators. The list of types to look for can be changed with the functions addRenderObjectType() and removeRenderObjectType(). You can also mark a specific node as a Render Object by giving its name through addRenderObjectName().

Applications should not use an instance of class SoRenderList directly; instead, instances of the derived classes, such as SoValueOrdering and SoOctreeOrdering, should be used.

Action behavior:

Sets: SoCacheElement

See also:

SoGetPrimitiveCountAction, SoLevelOfSimplification, SoOctreeOrdering, SoValueOrdering SoOcclusionCullingDeprecated since Open Inventor 9800
SoRenderList and related classes have been deprecated and will be removed in next major version. Please use SoSeparator instead.

Nested Class Summary

Nested classes/interfaces inherited from class com.openinventor.inventor.nodes.SoSeparator

SoSeparator.Cachings, SoSeparator.FastEditings, SoSeparator.RenderUnitIds

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

Inventor.ConstructorCommand

Field Summary

Fields

Modifier and Type	Field and Description
SoSFBool	isHead Deprecated. Normally each culling node maintains its own render list.

Fields inherited from class com.openinventor.inventor.nodes.SoSeparator

AUTO, boundingBoxCaching, CLEAR_ZBUFFER, directVizCaching, DISABLE, fastEditing, KEEP_ZBUFFER, OFF, ON, pickCulling, renderCaching, renderCulling, renderUnitId

Fields inherited from class com.openinventor.inventor.nodes.SoGroup

boundingBoxIgnoring

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Constructor Summary

Constructors

Constructor and Description
SoRenderList() Deprecated. Default constructor.
SoRenderList(int numChildren) Deprecated. Constructor that takes approximate number of children as a hint.

Method Summary

Modifier and Type	Method and Description
void	addRenderObjectClass(java.lang.Class<? extends Inventor> t) Deprecated. Adds a new type to the search list.
void	addRenderObjectName(java.lang.String n) Deprecated. Adds a new name to the search list.
int	getNumRenderObjectNames() Deprecated. Returns number of names in the search list.
int	getNumRenderObjectTypes() Deprecated. Returns number of types in the search list.
java.lang.Class<? extends Inventor>	getRenderObjectClass(int i) Deprecated. Returns the i th type of the search list.
java.lang.String	getRenderObjectName(int i) Deprecated. Returns the i th name of the search list.
void	removeAllRenderObjectNames() Deprecated. Clears all names from the search list.
void	removeRenderObjectClass(java.lang.Class<? extends Inventor> t) Deprecated. Removes a type from the search list.
void	removeRenderObjectName(java.lang.String n) Deprecated. Removes a name from the search list.

Methods inherited from class com.openinventor.inventor.nodes.SoSeparator

getNumRenderCaches, setNumRenderCaches

Methods inherited from class com.openinventor.inventor.nodes.SoGroup

addChild, findChild, getChild, getNumChildren, insertChild, removeAllChildren, removeChild, removeChild, replaceChild, replaceChild

Methods inherited from class com.openinventor.inventor.nodes.SoNode

affectsState, callback, copy, copy, distribute, doAction, getAlternateRep, getBoundingBox, getByName, getMatrix, getPrimitiveCount, getRenderUnitID, GLRender, GLRenderBelowPath, GLRenderInPath, GLRenderOffPath, grabEventsCleanup, grabEventsSetup, handleEvent, isBoundingBoxIgnoring, isOverride, pick, rayPick, search, setOverride, touch, write

Methods inherited from class com.openinventor.inventor.fields.SoFieldContainer

copyFieldValues, copyFieldValues, enableNotify, fieldsAreEqual, get, getAllFields, getEventIn, getEventOut, getField, getFieldName, hasDefaultValues, isNotifyEnabled, set, setToDefaults

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

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

Methods inherited from class com.openinventor.inventor.Inventor

getAddress, getNativeResourceHandle, startInternalThreads, stopInternalThreads

Methods inherited from class java.lang.Object

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

Field Detail

isHead

public final SoSFBool isHead

Deprecated.

Normally each culling node maintains its own render list. However, culling nodes can be chained, meaning that a culling node (B) that is a child of another culling node (A), can use the result of the culling operation in the parent node (A) instead of maintaining its own render list. In order to enable this behavior, this field should be set to true for the parent (A) and false for the child (B). The default is true.

Constructor Detail

SoRenderList

public SoRenderList()

Deprecated.

Default constructor.

SoRenderList

public SoRenderList(int numChildren)

Deprecated.

Constructor that takes approximate number of children as a hint.

Method Detail

getRenderObjectName

public java.lang.String getRenderObjectName(int i)

Deprecated.

Returns the i th name of the search list.

getRenderObjectClass

public java.lang.Class<? extends Inventor> getRenderObjectClass(int i)

Deprecated.

Returns the i th type of the search list.

removeAllRenderObjectNames

public void removeAllRenderObjectNames()

Deprecated.

Clears all names from the search list.

addRenderObjectClass

public void addRenderObjectClass(java.lang.Class<? extends Inventor> t)

Deprecated.

Adds a new type to the search list.

removeRenderObjectName

public void removeRenderObjectName(java.lang.String n)

Deprecated.

Removes a name from the search list.

addRenderObjectName

public void addRenderObjectName(java.lang.String n)

Deprecated.

Adds a new name to the search list.

getNumRenderObjectNames

public int getNumRenderObjectNames()

Deprecated.

Returns number of names in the search list.

removeRenderObjectClass

public void removeRenderObjectClass(java.lang.Class<? extends Inventor> t)

Deprecated.

Removes a type from the search list.

getNumRenderObjectTypes

public int getNumRenderObjectTypes()

Deprecated.

Returns number of types in the search list.