com.openinventor.inventor.nodes

Class SoNode

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.inventor.misc.SoBase

com.openinventor.inventor.fields.SoFieldContainer

com.openinventor.inventor.nodes.SoNode

All Implemented Interfaces:

SafeDisposable

Direct Known Subclasses:

MoActionNode, OrthoSliceBorder, PoNode, Ruler, SoAnnoText3Property, SoBackground, SoBaseColor, SoBaseKit, SoBaseScreen, SoBBox, SoBevelProperty, SoBumpMappingProperty, SoCallback, SoCamera, SoClipPlane, SoClusterGateway, SoColorIndex, SoColorMap, SoComplexity, SoCoordinate3, SoCoordinate4, SoDataCompositor, SoDataRange, SoDataSet, SoDataSetId, SoDepthBuffer, SoDepthComposerParams, SoDepthOffset, SoDirectVizManager, SoDirectVizShader, SoDrawStyle, SoEdgeFlag, SoEnvironment, SoEventCallback, SoFile, SoFont, SoFullSceneAntialiasing, SoGeometryPriority, SoGeoOrigin, SoGeoRender, SoGroup, SoHardwareQuery, SoInfo, SoInteractiveComplexity, SoLabel, SoLight, SoLightModel, SoMarker, SoMasterConfig, SoMaterial, SoMaterialBinding, SoNodeKitListPart, SoNormal, SoNormalBinding, SoNurbsBoundary, SoNurbsProperty, SoOffscreenVolumeRender, SoPackedColor, SoPattern, SoPickStyle, SoPolygonOffset, SoProfile, SoProfileCoordinate2, SoProfileCoordinate3, SoProjection, SoRemoteParams, SoRemoteVizClient, SoRenderToTextureProperty, SoROI, SoScaleVizParameters, SoScreenDrawer, SoShaderObject, SoShaderParameter, SoShaderProgram, SoShadowStyle, SoShape, SoShapeHints, SoTextProperty, SoTexture, SoTexture2Transform, SoTexture3Transform, SoTextureCombiner, SoTextureCoordinate2, SoTextureCoordinate3, SoTextureCoordinateBinding, SoTextureCoordinateFunction, SoTextureMatrix, SoTextureUnit, SoTileComposerParams, SoTimeHints, SoTracker, SoTransferFunction, SoTransformation, SoTransparencyType, SoVertexFlag, SoVertexProperty, SoViewport, SoViewportClipping, SoVolumeDataDrawStyle, SoVolumeRenderingPhysicalQuality, SoVolumeTransform, SoVRMLNode, SoVRMLScript, SoWWWInline

public class SoNode
extends SoFieldContainer

Abstract base class for all database nodes. This is the abstract base class from which all scene graph node classes are derived.

File format/default:

This is an abstract class. See the reference page of a derived class for the format and default values.

Action behavior:

SoSearchAction
If the node, type, or name matches the search criteria, returns a path to the node.

SoWriteAction
Writes the contents of the node to the current SoOutput.

See also:

SoPath, SoAction, SoNodeKit

Nested Class Summary

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

Inventor.ConstructorCommand

Field Summary

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Method Summary

Modifier and Type	Method and Description
boolean	affectsState() Returns true if a node has an effect on the state during traversal.
void	callback(SoCallbackAction action)
SoNode	copy() Calls copy(false).
SoNode	copy(boolean copyConnections) Creates and returns an exact copy of the node.
void	distribute(SoDistributeAction action)
void	doAction(SoAction action)
SoNode	getAlternateRep(SoAction action) This method is called by actions to allow the node to provide an "alternate representation" when appropriate (typically depending on the action type).
void	getBoundingBox(SoGetBoundingBoxAction action)
static SoNode	getByName(java.lang.String name) A node's name can be set using SoBase.setName().
void	getMatrix(SoGetMatrixAction action)
void	getPrimitiveCount(SoGetPrimitiveCountAction action)
int	getRenderUnitID()
void	GLRender(SoGLRenderAction action)
void	GLRenderBelowPath(SoGLRenderAction action)
void	GLRenderInPath(SoGLRenderAction action)
void	GLRenderOffPath(SoGLRenderAction action)
void	grabEventsCleanup()
void	grabEventsSetup()
void	handleEvent(SoHandleEventAction action)
boolean	isBoundingBoxIgnoring() This method is used by getBoundingBox action traversal to know if the current node must be traversed or not, ie the bounding should be ignored.
boolean	isOverride() Returns the state of the override flag.
void	pick(SoPickAction action)
void	rayPick(SoRayPickAction action)
void	search(SoSearchAction action)
void	setOverride(boolean state) Turns the override flag on or off.
void	touch() Marks an instance as modified, simulating a change to it.
void	write(SoWriteAction action)

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

Method Detail

copy

public SoNode copy()

Calls copy(false).

callback

public void callback(SoCallbackAction action)

setOverride

public void setOverride(boolean state)

Turns the override flag on or off.

The following property nodes are affected by the override flag: SoBaseColor, SoColorIndex, SoComplexity, SoDepthBuffer, SoDrawStyle, SoEnvironment, SoFont, SoFullSceneAntialiasing, SoLightModel, SoMaterial, SoMaterialBinding, SoPackedColor, SoPattern, SoPickStyle, SoPolygonOffset, SoShapeHints, SoTransparencyType, SoVertexProperty, SoTextProperty.

Every node has an override flag associated with it. The override flag is a powerful mechanism typically used (sparingly) near the top of a scene graph. When this flag is set, any nodes of the same type encountered later in the graph are ignored even if they also have their own override flag set. For example, you might insert a line-style SoDrawStyle node at the top of a graph to ensure that the whole scene is drawn as wireframe objects, regardless of drawing styles specified lower in the scene graph. Use the setOverride() method to set and reset the override flag. The isOverride() method returns the state of the override flag.

Normally, the override flag is not used within a scene graph for modeling. Use it in applications where you need to specify a temporary change to the whole graph.

Note: The override flag is not written to a file.

Setting the override flag on a node whose field values are not inherited (for example on a sphere with a radius of 7) has no effect on other nodes in the graph of that type.

getByName

public static SoNode getByName(java.lang.String name)

A node's name can be set using SoBase.setName(). This method allows nodes to be looked up by name. It returns the last node given the specified name.

copy

public SoNode copy(boolean copyConnections)

Creates and returns an exact copy of the node. If the node is a group, it copies the children as well. If copyConnections is true (it is false by default), any connections to (but not from) fields of the node are copied, as well. Note that multiple references to a node under the node to be copied will result in multiple references to the copy of that node. To be copyable, a custom node must define a default contructor. Note that OIV require that every custom node must define a default contructor.

Please also note that instance data other than Inventor fields and public children will not be copied by this method. If extra data needs to be copied as well, this method will have to be manually overridden.

affectsState

public boolean affectsState()

Returns true if a node has an effect on the state during traversal. The default method returns true. Node classes (such as SoSeparator) that isolate their effects from the rest of the graph override this method to return false.

isOverride

public boolean isOverride()

Returns the state of the override flag.

doAction

public void doAction(SoAction action)

rayPick

public void rayPick(SoRayPickAction action)

search

public void search(SoSearchAction action)

isBoundingBoxIgnoring

public boolean isBoundingBoxIgnoring()

This method is used by getBoundingBox action traversal to know if the current node must be traversed or not, ie the bounding should be ignored. See boundingBoxIgnoring field of nodes SoGroup, SoShape and SoBaseKit. Default is false.

write

public void write(SoWriteAction action)

getMatrix

public void getMatrix(SoGetMatrixAction action)

getBoundingBox

public void getBoundingBox(SoGetBoundingBoxAction action)

handleEvent

public void handleEvent(SoHandleEventAction action)

pick

public void pick(SoPickAction action)

GLRender

public void GLRender(SoGLRenderAction action)

grabEventsSetup

public void grabEventsSetup()

GLRenderOffPath

public void GLRenderOffPath(SoGLRenderAction action)

grabEventsCleanup

public void grabEventsCleanup()

touch

public void touch()

Marks an instance as modified, simulating a change to it. This will notify auditors (parent nodes, connected engines, and so on) of a change to this object and cause attached sensors to be triggered.

Overrides:

touch in class SoBase

getRenderUnitID

public int getRenderUnitID()

distribute

public void distribute(SoDistributeAction action)

getPrimitiveCount

public void getPrimitiveCount(SoGetPrimitiveCountAction action)

getAlternateRep

public SoNode getAlternateRep(SoAction action)

This method is called by actions to allow the node to provide an "alternate representation" when appropriate (typically depending on the action type). For example, when an SoIndexedTexture2 node is traversed by an SoToU3DAction, it returns an SoTexture2 node as its alternate representation, because indexed textures are not supported in U3D. A custom node can use this mechanism to provide an alternate representation using standard nodes when it is travered by an SoWriteAction.

By default the node itself is returned.

GLRenderInPath

public void GLRenderInPath(SoGLRenderAction action)

GLRenderBelowPath

public void GLRenderBelowPath(SoGLRenderAction action)