Class BaseParticleSystem
java.lang.Object
org.web3d.vrml.renderer.common.nodes.AbstractNode
org.web3d.vrml.renderer.common.nodes.particle.BaseParticleSystem
- All Implemented Interfaces:
VRMLNode
,FrameStateListener
,VRMLBoundedNodeType
,VRMLChildNodeType
,VRMLNodeType
,VRMLParticleSystemNodeType
,VRMLShapeNodeType
,VRMLWorldRootChildNodeType
- Direct Known Subclasses:
NRParticleSystem
,OGLParticleSystem
Common base renderer implementation of a particle system shape node.
This implementation is renderer independent, but uses the common j3d.org interfaces for dealing with the particle systems.
- Version:
- $Revision: 2.6 $
- Author:
- Justin Couch
-
Field Summary
FieldsModifier and TypeFieldDescriptionprotected static final String
Message for when the node in setValue() is not a Appearanceprotected static final String
Message for when the proto is not a Appearanceprotected static final String
Message for when the node in setValue() is not a Colorprotected static final String
Message for when the proto is not a Colorprotected org.j3d.geom.particle.ColorRampFunction
Colour ramp handler for dealing with the colour keys changingprotected org.j3d.geom.particle.ParticleInitializer
Internal implementation of the emitterprotected static final String
Message for when the node in setValue() is not a Emitterprotected static final String
Message for when the proto is not a Emitterprotected static final int
Index for the appearance fieldprotected static final int
Index for the bbox_center fieldprotected static final int
Index of the Bounding box display bboxDisplay fieldprotected static final int
Index for the bbox_size fieldprotected static final int
Index for the colorKey fieldprotected static final int
Index for the colorRamp fieldprotected static final int
Index for the createParticles fieldprotected static final int
Index for the emitter fieldprotected static final int
Index for the enabled fieldprotected static final int
Index for the geometry fieldprotected static final int
Index for the geometryType fieldprotected static final int
Index for the colorKey fieldprotected static final int
Index for the lifetimeVariation fieldprotected static final int
Index for the maxParticles fieldprotected static final int
Index for the particleLifetime fieldprotected static final int
Index for the particleSize fieldprotected static final int
Index for the physics fieldprotected static final int
Index for the texCoordKey fieldprotected static final int
Index for the texCoordRamp fieldprotected static final int
Index of the Bounding box display visible fieldprotected int
The geometry type as a flag.protected static final int
The last field index used by this classprotected static final int
Number of fields constantprotected int
Number of valid colorKey valuesprotected int
Number of valid texCoordKey valuesprotected VRMLProtoInstance
Proto version of the appearanceprotected org.j3d.geom.particle.ParticleSystem
The particle system this node is made ofprotected VRMLProtoInstance
Proto version of the colorRampprotected VRMLProtoInstance
Proto version of the Emitterprotected static final String
Message for when the node in setValue() is not a Physicsprotected static final String
Message for when the proto is not a Physicsprotected VRMLProtoInstance
Proto version of the texCoordRampprotected static final String
Message for when the node in setValue() is not tex coordsprotected static final String
Message for when the proto is not a tex coordsprotected org.j3d.geom.particle.MaxTimeParticleFunction
Particle function for limiting max particle lifeprotected static final int
Particle geometry type is custom lvl 2protected static final int
Particle geometry type is Linesprotected static final int
Particle geometry type is Pointsprotected static final int
Particle geometry type is Quadsprotected static final int
Particle geometry type is point spritesprotected static final int
Particle geometry type is Trianglesprotected VRMLAppearanceNodeType
exposedField SFNode appearance NULLprotected float[]
field SFVec3f bboxCenter 0, 0, 0protected boolean
SFBool bboxDisplay falseprotected float[]
field SFVec3f bboxSize [-1, -1, -1]protected float[]
field MFFloat colorKeyprotected VRMLColorNodeType
field SFNode colorRamp NULLprotected boolean
exposedField SFBool createParticlesprotected VRMLParticleEmitterNodeType
field SFNode emitter NULLprotected boolean
exposedField SFBool enabledprotected String
field SFString geometryType "QUAD"protected boolean
Value of the isActive outputOnly fieldprotected float
exposedField SFFloat lifetimeVariationprotected int
exposedField SFInt32 maxParticlesprotected float
exposedField SFFloat particleLifetimeprotected float[]
exposedField SFFVec2f particleSizeprotected VRMLNodeType[]
The physics nodes mixed proto and child nodesprotected float[]
field MFFloat texCoordKeyprotected VRMLTextureCoordinateNodeType
field SFNode texCoordRamp NULLprotected boolean
SFBool visible trueFields inherited from class org.web3d.vrml.renderer.common.nodes.AbstractNode
errorReporter, FIELD_METADATA, fieldLocalData, hasChanged, inSetup, isDEF, isStatic, LAST_NODE_INDEX, layerIds, nodeName, pMetadata, refCounts, removedLayerIds, stateManager, STATIC_SCENE_GRAPH, vfMetadata, vrmlMajorVersion, vrmlMinorVersion
-
Constructor Summary
ConstructorsModifierConstructorDescriptionprotected
Construct a new default shape node implementation.protected
Construct a new instance of this node based on the details from the given node. -
Method Summary
Modifier and TypeMethodDescriptionGet node content for appearance.float[]
Get the current value of field the bboxCenter field.boolean
Get the current value of the bboxDisplay field.float[]
Get the current value of the bboxSize field.boolean
Get the current enabled state of this model.getFieldDeclaration
(int index) Get the declaration of the field at the given index.int
getFieldIndex
(String fieldName) Get the index of the given field name.getFieldValue
(int index) Get the value of a field.Get node content forgeometry
int[]
Get the list of indices that correspond to fields that contain nodes ie MFNode and SFNode).int
Get the number of fields.int
Get the primary type of this node.int[]
Get the secondary type of this node.org.j3d.geom.particle.ParticleSystem
Get the internal initialiser model that will be used for this particle system implementation.boolean
Get the current value of the visible field.boolean
isActive()
Check to see if this node is currently active for evaluation.boolean
isShared()
Check to see if this node has been used more than once.void
sendRoute
(double time, int srcIndex, VRMLNodeType destNode, int destIndex) Send a routed value from this node to the given destination node.void
setActive
(boolean state) Manually set the particle system to inactive due to the behaviour of the internals.void
setAppearance
(VRMLNodeType newAppearance) Set node content as replacement for appearance.void
setBboxCenter
(float[] newBboxCenter) Convenience method to set a new value the vfBboxCenter fieldsvoid
setBboxDisplay
(boolean val) Set the bounding box display for this node.void
setBboxSize
(float[] newBboxSize) Convenience method to set a new value for the vfBboxSize field.void
setEnabled
(boolean state) Set the enabled state of the Physics model.void
setGeometry
(VRMLNodeType newGeometry) Set node content as replacement forgeometry
.protected void
setParticleSize
(float[] value) Set the size of the particle to a new value.void
setShared
(boolean used) Adjust the sharing count up or down one increment depending on the flag.void
Notification that the construction phase of this node has finished.void
setValue
(int index, boolean value) Set the value of the field at the given index as a boolean.void
setValue
(int index, float value) Set the value of the field at the given index as a float.void
setValue
(int index, float[] value, int numValid) Set the value of the field at the given index as a float.void
setValue
(int index, int value) Set the value of the field at the given index as an int.void
Set the value of the field at the given index as an string.void
setValue
(int index, VRMLNodeType child) Set the value of the field at the given index as a node.void
setValue
(int index, VRMLNodeType[] children, int numValid) Set the value of the field at the given index as a node.void
setVisible
(boolean val) Set visible field for this node.Methods inherited from class org.web3d.vrml.renderer.common.nodes.AbstractNode
addNodeListener, allEventsComplete, checkNodeType, checkSecondaryType, checkSecondaryType, clearRemovedLayerIds, fireFieldChanged, getLayerIds, getMetadataObject, getRefCount, getRemovedLayerIds, getUserData, getVRMLNodeName, hasFieldChanged, isDEF, isSetupFinished, notifyExternProtoLoaded, removeNodeListener, setDEF, setErrorReporter, setFrameStateManager, setMetadataObject, setUserData, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setVersion, throwInitOnlyWriteException, throwInputOnlyWriteException, throwInvalidNodeException, throwInvalidProtoException, throwOutputOnlyWriteException, updateRefCount, updateRefs
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Methods inherited from interface org.web3d.vrml.nodes.FrameStateListener
allEventsComplete
Methods inherited from interface org.web3d.vrml.lang.VRMLNode
getUserData, getVRMLNodeName, isDEF, setErrorReporter, setUserData, setVersion
Methods inherited from interface org.web3d.vrml.nodes.VRMLNodeType
addNodeListener, clearRemovedLayerIds, getLayerIds, getMetadataObject, getRefCount, getRemovedLayerIds, hasFieldChanged, isSetupFinished, notifyExternProtoLoaded, removeNodeListener, setDEF, setFrameStateManager, setMetadataObject, setValue, setValue, setValue, setValue, setValue, setValue, setValue, updateRefCount
-
Field Details
-
FIELD_APPEARANCE
protected static final int FIELD_APPEARANCEIndex for the appearance field- See Also:
-
FIELD_GEOMETRY
protected static final int FIELD_GEOMETRYIndex for the geometry field- See Also:
-
FIELD_BBOX_SIZE
protected static final int FIELD_BBOX_SIZEIndex for the bbox_size field- See Also:
-
FIELD_BBOX_CENTER
protected static final int FIELD_BBOX_CENTERIndex for the bbox_center field- See Also:
-
FIELD_BBOX_DISPLAY
protected static final int FIELD_BBOX_DISPLAYIndex of the Bounding box display bboxDisplay field- See Also:
-
FIELD_VISIBLE
protected static final int FIELD_VISIBLEIndex of the Bounding box display visible field- See Also:
-
FIELD_GEOMETRY_TYPE
protected static final int FIELD_GEOMETRY_TYPEIndex for the geometryType field- See Also:
-
FIELD_ENABLED
protected static final int FIELD_ENABLEDIndex for the enabled field- See Also:
-
FIELD_MAX_PARTICLES
protected static final int FIELD_MAX_PARTICLESIndex for the maxParticles field- See Also:
-
FIELD_PARTICLE_LIFETIME
protected static final int FIELD_PARTICLE_LIFETIMEIndex for the particleLifetime field- See Also:
-
FIELD_LIFETIME_VARIATION
protected static final int FIELD_LIFETIME_VARIATIONIndex for the lifetimeVariation field- See Also:
-
FIELD_EMITTER
protected static final int FIELD_EMITTERIndex for the emitter field- See Also:
-
FIELD_PHYSICS
protected static final int FIELD_PHYSICSIndex for the physics field- See Also:
-
FIELD_COLOR_RAMP
protected static final int FIELD_COLOR_RAMPIndex for the colorRamp field- See Also:
-
FIELD_COLOR_KEY
protected static final int FIELD_COLOR_KEYIndex for the colorKey field- See Also:
-
FIELD_IS_ACTIVE
protected static final int FIELD_IS_ACTIVEIndex for the colorKey field- See Also:
-
FIELD_PARTICLE_SIZE
protected static final int FIELD_PARTICLE_SIZEIndex for the particleSize field- See Also:
-
FIELD_CREATE_PARTICLES
protected static final int FIELD_CREATE_PARTICLESIndex for the createParticles field- See Also:
-
FIELD_TEXCOORD_RAMP
protected static final int FIELD_TEXCOORD_RAMPIndex for the texCoordRamp field- See Also:
-
FIELD_TEXCOORD_KEY
protected static final int FIELD_TEXCOORD_KEYIndex for the texCoordKey field- See Also:
-
LAST_PARTICLE_INDEX
protected static final int LAST_PARTICLE_INDEXThe last field index used by this class- See Also:
-
NUM_FIELDS
protected static final int NUM_FIELDSNumber of fields constant- See Also:
-
EMITTER_PROTO_MSG
Message for when the proto is not a Emitter- See Also:
-
EMITTER_NODE_MSG
Message for when the node in setValue() is not a Emitter- See Also:
-
PHYSICS_PROTO_MSG
Message for when the proto is not a Physics- See Also:
-
PHYSICS_NODE_MSG
Message for when the node in setValue() is not a Physics- See Also:
-
APPEARANCE_PROTO_MSG
Message for when the proto is not a Appearance- See Also:
-
APPEARANCE_NODE_MSG
Message for when the node in setValue() is not a Appearance- See Also:
-
COLOR_PROTO_MSG
-
COLOR_NODE_MSG
Message for when the node in setValue() is not a Color- See Also:
-
TEXCOORD_PROTO_MSG
Message for when the proto is not a tex coords- See Also:
-
TEXCOORD_NODE_MSG
Message for when the node in setValue() is not tex coords- See Also:
-
TYPE_QUADS
protected static final int TYPE_QUADSParticle geometry type is Quads- See Also:
-
TYPE_TRIS
protected static final int TYPE_TRISParticle geometry type is Triangles- See Also:
-
TYPE_LINES
protected static final int TYPE_LINESParticle geometry type is Lines- See Also:
-
TYPE_POINTS
protected static final int TYPE_POINTSParticle geometry type is Points- See Also:
-
TYPE_SPRITES
protected static final int TYPE_SPRITESParticle geometry type is point sprites- See Also:
-
TYPE_CUSTOM
protected static final int TYPE_CUSTOMParticle geometry type is custom lvl 2- See Also:
-
pAppearance
Proto version of the appearance -
vfAppearance
exposedField SFNode appearance NULL -
pEmitter
Proto version of the Emitter -
vfEmitter
field SFNode emitter NULL -
pColorRamp
Proto version of the colorRamp -
vfColorRamp
field SFNode colorRamp NULL -
pTexCoordRamp
Proto version of the texCoordRamp -
vfTexCoordRamp
field SFNode texCoordRamp NULL -
vfPhysics
The physics nodes mixed proto and child nodes -
vfBboxCenter
protected float[] vfBboxCenterfield SFVec3f bboxCenter 0, 0, 0 -
vfBboxSize
protected float[] vfBboxSizefield SFVec3f bboxSize [-1, -1, -1] -
vfBboxDisplay
protected boolean vfBboxDisplaySFBool bboxDisplay false -
vfVisible
protected boolean vfVisibleSFBool visible true -
vfGeometryType
field SFString geometryType "QUAD" -
vfEnabled
protected boolean vfEnabledexposedField SFBool enabled -
vfCreateParticles
protected boolean vfCreateParticlesexposedField SFBool createParticles -
vfMaxParticles
protected int vfMaxParticlesexposedField SFInt32 maxParticles -
vfParticleLifetime
protected float vfParticleLifetimeexposedField SFFloat particleLifetime -
vfParticleSize
protected float[] vfParticleSizeexposedField SFFVec2f particleSize -
vfLifetimeVariation
protected float vfLifetimeVariationexposedField SFFloat lifetimeVariation -
vfColorKey
protected float[] vfColorKeyfield MFFloat colorKey -
numColorKey
protected int numColorKeyNumber of valid colorKey values -
vfTexCoordKey
protected float[] vfTexCoordKeyfield MFFloat texCoordKey -
numTexCoordKey
protected int numTexCoordKeyNumber of valid texCoordKey values -
vfIsActive
protected boolean vfIsActiveValue of the isActive outputOnly field -
geometryType
protected int geometryTypeThe geometry type as a flag. Set during setupFinished -
particleSystem
protected org.j3d.geom.particle.ParticleSystem particleSystemThe particle system this node is made of -
emitter
protected org.j3d.geom.particle.ParticleInitializer emitterInternal implementation of the emitter -
colorFunction
protected org.j3d.geom.particle.ColorRampFunction colorFunctionColour ramp handler for dealing with the colour keys changing -
timeFunction
protected org.j3d.geom.particle.MaxTimeParticleFunction timeFunctionParticle function for limiting max particle life
-
-
Constructor Details
-
BaseParticleSystem
protected BaseParticleSystem()Construct a new default shape node implementation. -
BaseParticleSystem
Construct a new instance of this node based on the details from the given node. If the node is not a Shape node, an exception will be thrown.- Parameters:
node
- The node to copy- Throws:
IllegalArgumentException
- Incorrect node type
-
-
Method Details
-
getSystem
public org.j3d.geom.particle.ParticleSystem getSystem()Get the internal initialiser model that will be used for this particle system implementation. This may not be available until after setupFinished() has been called.- Specified by:
getSystem
in interfaceVRMLParticleSystemNodeType
- Returns:
- The initialiser instance to use
-
setEnabled
public void setEnabled(boolean state) Set the enabled state of the Physics model.- Specified by:
setEnabled
in interfaceVRMLParticleSystemNodeType
- Parameters:
state
- true to enable the use of this model
-
getEnabled
public boolean getEnabled()Get the current enabled state of this model.- Specified by:
getEnabled
in interfaceVRMLParticleSystemNodeType
- Returns:
- The value of the enabled field
-
isActive
public boolean isActive()Check to see if this node is currently active for evaluation.- Specified by:
isActive
in interfaceVRMLParticleSystemNodeType
- Returns:
- true if the node still can run this frame
-
setActive
public void setActive(boolean state) Manually set the particle system to inactive due to the behaviour of the internals. The manager has decided that this node is no longer needing to be run, so indicate that the activity level has changed.- Specified by:
setActive
in interfaceVRMLParticleSystemNodeType
- Parameters:
state
- true to set this as active, false for inActive
-
getAppearance
Get node content for appearance.- Specified by:
getAppearance
in interfaceVRMLShapeNodeType
- Returns:
- The current appearance
-
setAppearance
Set node content as replacement for appearance.- Specified by:
setAppearance
in interfaceVRMLShapeNodeType
- Parameters:
newAppearance
- The new appearance. null will act like delete- Throws:
InvalidFieldValueException
- The node does not match the required type.
-
getGeometry
Get node content forgeometry
- Specified by:
getGeometry
in interfaceVRMLShapeNodeType
- Returns:
- The current geoemtry field
-
setGeometry
Set node content as replacement forgeometry
.- Specified by:
setGeometry
in interfaceVRMLShapeNodeType
- Parameters:
newGeometry
- The new value for geometry. Null will act like delete- Throws:
InvalidFieldValueException
- The node does not match the required type.
-
getBboxCenter
public float[] getBboxCenter()Description copied from interface:VRMLBoundedNodeType
Get the current value of field the bboxCenter field. The default value is0 0 0
.- Specified by:
getBboxCenter
in interfaceVRMLBoundedNodeType
- Returns:
- The value of bboxCenter(SFVec3f)
-
getBboxSize
public float[] getBboxSize()Description copied from interface:VRMLBoundedNodeType
Get the current value of the bboxSize field. The default value is-1 -1 -1
.- Specified by:
getBboxSize
in interfaceVRMLBoundedNodeType
- Returns:
- The size of the bboxSize(SFVec3f)
-
getBboxDisplay
public boolean getBboxDisplay()Description copied from interface:VRMLBoundedNodeType
Get the current value of the bboxDisplay field. The default value isfalse
.- Specified by:
getBboxDisplay
in interfaceVRMLBoundedNodeType
- Returns:
- the value of the bboxDisplay(SFBool)
-
getVisible
public boolean getVisible()Description copied from interface:VRMLBoundedNodeType
Get the current value of the visible field. The default value istrue
.- Specified by:
getVisible
in interfaceVRMLBoundedNodeType
- Returns:
- the value of the visible(SFBool)
-
setupFinished
public void setupFinished()Notification that the construction phase of this node has finished. If the node would like to do any internal processing, such as setting up geometry, then go for it now. Assumes that the derived node has initialised the particleSystem variable of this class before calling this method.- Specified by:
setupFinished
in interfaceVRMLNodeType
- Overrides:
setupFinished
in classAbstractNode
-
getFieldIndex
Get the index of the given field name. If the name does not exist for this node then return a value of -1.- Specified by:
getFieldIndex
in interfaceVRMLNode
- Parameters:
fieldName
- The name of the field we want the index from- Returns:
- The index of the field name or -1
-
getNodeFieldIndices
public int[] getNodeFieldIndices()Get the list of indices that correspond to fields that contain nodes ie MFNode and SFNode). Used for blind scene graph traversal without needing to spend time querying for all fields etc. If a node does not have any fields that contain nodes, this shall return null. The field list covers all field types, regardless of whether they are readable or not at the VRML-level.- Specified by:
getNodeFieldIndices
in interfaceVRMLNode
- Returns:
- The list of field indices that correspond to SF/MFnode fields or null if none
-
getFieldDeclaration
Get the declaration of the field at the given index. This allows for reverse lookup if needed. If the field does not exist, this will give a value of null.- Specified by:
getFieldDeclaration
in interfaceVRMLNode
- Parameters:
index
- The index of the field to get information- Returns:
- A representation of this field's information
-
getNumFields
public int getNumFields()Get the number of fields.- Specified by:
getNumFields
in interfaceVRMLNode
- Returns:
- The number of fields.
-
getPrimaryType
public int getPrimaryType()Get the primary type of this node. Replaces the instanceof mechanism for use in switch statements.- Specified by:
getPrimaryType
in interfaceVRMLNode
- Returns:
- The primary type
-
getSecondaryType
public int[] getSecondaryType()Get the secondary type of this node. Replaces the instanceof mechanism for use in switch statements.- Specified by:
getSecondaryType
in interfaceVRMLNode
- Overrides:
getSecondaryType
in classAbstractNode
- Returns:
- The secondary type
-
getFieldValue
Get the value of a field. If the field is a primitive type, it will return a class representing the value. For arrays or nodes it will return the instance directly.- Specified by:
getFieldValue
in interfaceVRMLNodeType
- Overrides:
getFieldValue
in classAbstractNode
- Parameters:
index
- The index of the field to change.- Returns:
- The class representing the field value
- Throws:
InvalidFieldException
- The field index is not known
-
sendRoute
Send a routed value from this node to the given destination node. The route should use the appropriate setValue() method of the destination node. It should not attempt to cast the node up to a higher level. Routing should also follow the standard rules for the loop breaking and other appropriate rules for the specification.- Specified by:
sendRoute
in interfaceVRMLNodeType
- Overrides:
sendRoute
in classAbstractNode
- Parameters:
time
- The time that this route occurred (not necessarily epoch time. Should be treated as a relative value only)srcIndex
- The index of the field in this node that the value should be sent fromdestNode
- The node reference that we will be sending the value todestIndex
- The index of the field in the destination node that the value should be sent to.
-
setValue
public void setValue(int index, boolean value) throws InvalidFieldException, InvalidFieldValueException Set the value of the field at the given index as a boolean. This is be used to set SFBool field types isActive, enabled and loop.- Specified by:
setValue
in interfaceVRMLNodeType
- Overrides:
setValue
in classAbstractNode
- Parameters:
index
- The index of destination field to setvalue
- The new value to use for the node- Throws:
InvalidFieldException
- The field index is not knownInvalidFieldValueException
- The value provided is not in range or not appropriate for this field
-
setValue
Set the value of the field at the given index as an int. This would be used to set SFInt32 field types.- Specified by:
setValue
in interfaceVRMLNodeType
- Overrides:
setValue
in classAbstractNode
- Parameters:
index
- The index of destination field to setvalue
- The new value to use for the node- Throws:
InvalidFieldValueException
- The node does not match the required type.InvalidFieldException
- The field index is not known
-
setValue
public void setValue(int index, String value) throws InvalidFieldException, InvalidFieldValueException Set the value of the field at the given index as an string. This would be used to set SFString field types.- Specified by:
setValue
in interfaceVRMLNodeType
- Overrides:
setValue
in classAbstractNode
- Parameters:
index
- The index of destination field to setvalue
- The new value to use for the node- Throws:
InvalidFieldValueException
- The node does not match the required type.InvalidFieldException
- The field index is not known
-
setValue
public void setValue(int index, float value) throws InvalidFieldException, InvalidFieldValueException Set the value of the field at the given index as a float. This would be used to set SFFloat field types.- Specified by:
setValue
in interfaceVRMLNodeType
- Overrides:
setValue
in classAbstractNode
- Parameters:
index
- The index of destination field to setvalue
- The new value to use for the node- Throws:
InvalidFieldValueException
- The node does not match the required type.InvalidFieldException
- The field index is not known
-
setValue
public void setValue(int index, float[] value, int numValid) throws InvalidFieldException, InvalidFieldValueException, InvalidFieldAccessException Set the value of the field at the given index as a float. This would be used to set SFFloat field types.- Specified by:
setValue
in interfaceVRMLNodeType
- Overrides:
setValue
in classAbstractNode
- Parameters:
index
- The index of destination field to setvalue
- The new value to use for the nodenumValid
- The number of valid values to copy from the array- Throws:
InvalidFieldException
- The field index is not knownInvalidFieldValueException
- The value provided is out of range for the field type.InvalidFieldAccessException
- The call is attempting to write to a field that does not permit writing now
-
setValue
public void setValue(int index, VRMLNodeType child) throws InvalidFieldException, InvalidFieldValueException, InvalidFieldAccessException Set the value of the field at the given index as a node. This would be used to set SFNode field types.- Specified by:
setValue
in interfaceVRMLNodeType
- Overrides:
setValue
in classAbstractNode
- Parameters:
index
- The index of destination field to setchild
- The new value to use for the node- Throws:
InvalidFieldException
- The field index is not knownInvalidFieldValueException
- The value provided is out of range for the field type.InvalidFieldAccessException
- The call is attempting to write to a field that does not permit writing now
-
setValue
public void setValue(int index, VRMLNodeType[] children, int numValid) throws InvalidFieldException, InvalidFieldValueException Set the value of the field at the given index as a node. This would be used to set SFNode field types.- Specified by:
setValue
in interfaceVRMLNodeType
- Overrides:
setValue
in classAbstractNode
- Parameters:
index
- The index of destination field to setchildren
- The new value to use for the nodenumValid
- The number of valid values to copy from the array- Throws:
InvalidFieldValueException
- The node does not match the required type.InvalidFieldException
- The field index is not known
-
setParticleSize
Set the size of the particle to a new value. This should be overridden by renderer-specific classes for telling the particle system about it.- Parameters:
value
- The new 2D size to use- Throws:
InvalidFieldValueException
- The value is negative
-
setBboxCenter
Convenience method to set a new value the vfBboxCenter fields- Specified by:
setBboxCenter
in interfaceVRMLBoundedNodeType
- Parameters:
newBboxCenter
- The new center of the bounding box- Throws:
InvalidFieldAccessException
- The call is attempting to write to after setup has finished
-
setBboxSize
Convenience method to set a new value for the vfBboxSize field.- Specified by:
setBboxSize
in interfaceVRMLBoundedNodeType
- Parameters:
newBboxSize
- The new size for the bounding box- Throws:
InvalidFieldAccessException
- The call is attempting to write to after setup has finished
-
setBboxDisplay
public void setBboxDisplay(boolean val) Set the bounding box display for this node. Only used by the field parser- Specified by:
setBboxDisplay
in interfaceVRMLBoundedNodeType
- Parameters:
val
- the display value to set
-
setVisible
public void setVisible(boolean val) Set visible field for this node. Only used by the field parser- Specified by:
setVisible
in interfaceVRMLBoundedNodeType
- Parameters:
val
- the display value to set
-