com.jme3.scene.instancing

Class InstancedGeometry

java.lang.Object

com.jme3.scene.Spatial

com.jme3.scene.Geometry

com.jme3.scene.instancing.InstancedGeometry

All Implemented Interfaces:

HasLocalTransform, CloneableSmartAsset, Collidable, Savable, JmeCloneable, java.lang.Cloneable

public class InstancedGeometry
extends Geometry

Nested Class Summary

Nested classes/interfaces inherited from class com.jme3.scene.Spatial

Spatial.BatchHint, Spatial.CullHint, Spatial.DFSMode

Field Summary

Fields inherited from class com.jme3.scene.Geometry

cachedWorldMat, groupNode, ignoreTransform, lodLevel, material, mesh, SAVABLE_VERSION, startIndex

Fields inherited from class com.jme3.scene.Spatial

batchHint, controls, cullHint, frustrumIntersects, key, localLights, localOverrides, localTransform, name, parent, queueBucket, queueDistance, refreshFlags, RF_BOUND, RF_CHILD_LIGHTLIST, RF_LIGHTLIST, RF_MATPARAM_OVERRIDE, RF_TRANSFORM, shadowMode, userData, worldBound, worldLights, worldOverrides, worldTransform

Constructor Summary

Constructors

Constructor and Description
InstancedGeometry()
InstancedGeometry(java.lang.String name) Creates instanced geometry with the specified mode and name.

Method Summary

Modifier and Type	Method and Description
void	addInstance(Geometry geometry)
void	cloneFields(Cloner cloner, java.lang.Object original) Called internally by com.jme3.util.clone.Cloner.
void	deleteInstance(Geometry geom)
int	getActualNumInstances()
VertexBuffer[]	getAllInstanceData()
Geometry[]	getGeometries()
VertexBuffer[]	getGlobalUserInstanceData() Global user specified per-instance data.
int	getMaxNumInstances()
VertexBuffer	getTransformUserInstanceData() Return user per-instance transform data.
void	read(JmeImporter importer)
void	setGlobalUserInstanceData(VertexBuffer[] globalInstanceData) Specify global user per-instance data.
void	setMaxNumInstances(int maxNumInstances) Set the maximum amount of instances that can be rendered by this instanced geometry when mode is set to auto.
void	setTransformUserInstanceData(VertexBuffer transformInstanceData) Specify camera specific user per-instance data.
void	updateInstances()
protected void	updateWorldBound() updateWorldBound updates the bounding volume that contains this geometry.
void	write(JmeExporter exporter)

Methods inherited from class com.jme3.scene.Geometry

associateWithGroupNode, breadthFirstTraversal, checkCulling, clone, clone, collideWith, computeWorldMatrix, deepClone, depthFirstTraversal, getFallbackMorphTarget, getLodLevel, getMaterial, getMesh, getModelBound, getMorphState, getMorphState, getNbSimultaneousGPUMorph, getTriangleCount, getVertexCount, getWorldMatrix, isBatched, isDirtyMorph, isGrouped, isIgnoreTransform, oldDeepClone, removeFromParent, setDirtyMorph, setFallbackMorphTarget, setIgnoreTransform, setLodLevel, setMaterial, setMesh, setModelBound, setMorphState, setMorphState, setNbSimultaneousGPUMorph, setParent, unassociateFromGroupNode, updateModelBound, updateWorldLightList, updateWorldTransforms

Methods inherited from class com.jme3.scene.Spatial

addControl, addLight, addMatParamOverride, breadthFirstTraversal, center, clearMatParamOverrides, depthFirstTraversal, forceRefresh, getBatchHint, getControl, getControl, getCullHint, getKey, getLastFrustumIntersection, getLocalBatchHint, getLocalCullHint, getLocalLightList, getLocalMatParamOverrides, getLocalQueueBucket, getLocalRotation, getLocalScale, getLocalShadowMode, getLocalToWorldMatrix, getLocalTransform, getLocalTranslation, getName, getNumControls, getParent, getQueueBucket, getShadowMode, getUserData, getUserDataKeys, getWorldBound, getWorldLightList, getWorldMatParamOverrides, getWorldRotation, getWorldScale, getWorldTransform, getWorldTranslation, hasAncestor, jmeClone, localToWorld, lookAt, matches, move, move, oldClone, removeControl, removeControl, removeLight, removeMatParamOverride, rotate, rotate, rotateUpTo, runControlRender, scale, scale, setBatchHint, setBoundRefresh, setCullHint, setKey, setLastFrustumIntersection, setLightListRefresh, setLocalRotation, setLocalRotation, setLocalScale, setLocalScale, setLocalScale, setLocalTransform, setLocalTranslation, setLocalTranslation, setMatParamOverrideRefresh, setName, setQueueBucket, setRequiresUpdates, setShadowMode, setTransformRefresh, setUserData, toString, updateGeometricState, updateLogicalState, updateMatParamOverrides, worldToLocal

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

InstancedGeometry

public InstancedGeometry()

InstancedGeometry

public InstancedGeometry(java.lang.String name)

Creates instanced geometry with the specified mode and name.

Parameters:

name - The name of the spatial.

See Also:

Spatial.Spatial(java.lang.String)

Method Detail

getGlobalUserInstanceData

public VertexBuffer[] getGlobalUserInstanceData()

Global user specified per-instance data. By default set to null, specify an array of VertexBuffers via setGlobalUserInstanceData(com.jme3.scene.VertexBuffer[]).

Returns:

global user specified per-instance data.

See Also:

setGlobalUserInstanceData(com.jme3.scene.VertexBuffer[])

setGlobalUserInstanceData

public void setGlobalUserInstanceData(VertexBuffer[] globalInstanceData)

Specify global user per-instance data. By default set to null, specify an array of VertexBuffers that contain per-instance vertex attributes.

Parameters:

globalInstanceData - global user per-instance data.

Throws:

java.lang.IllegalArgumentException - If one of the VertexBuffers is not instanced.

setTransformUserInstanceData

public void setTransformUserInstanceData(VertexBuffer transformInstanceData)

Specify camera specific user per-instance data.

Parameters:

transformInstanceData - The transforms for each instance.

getTransformUserInstanceData

public VertexBuffer getTransformUserInstanceData()

Return user per-instance transform data.

Returns:

The per-instance transform data.

See Also:

setTransformUserInstanceData(com.jme3.scene.VertexBuffer)

setMaxNumInstances

public final void setMaxNumInstances(int maxNumInstances)

Set the maximum amount of instances that can be rendered by this instanced geometry when mode is set to auto. This re-allocates internal structures and therefore should be called only when necessary.

Parameters:

maxNumInstances - The maximum number of instances that can be rendered.

Throws:

java.lang.IllegalStateException - If mode is set to manual.

java.lang.IllegalArgumentException - If maxNumInstances is zero or negative

getMaxNumInstances

public int getMaxNumInstances()

getActualNumInstances

public int getActualNumInstances()

updateInstances

public void updateInstances()

deleteInstance

public void deleteInstance(Geometry geom)

addInstance

public void addInstance(Geometry geometry)

updateWorldBound

protected void updateWorldBound()

Description copied from class: Geometry

updateWorldBound updates the bounding volume that contains this geometry. The location of the geometry is based on the location of all this node's parents.

Overrides:

updateWorldBound in class Geometry

See Also:

Spatial.updateWorldBound()

getGeometries

public Geometry[] getGeometries()

getAllInstanceData

public VertexBuffer[] getAllInstanceData()

cloneFields

public void cloneFields(Cloner cloner,
                        java.lang.Object original)

Called internally by com.jme3.util.clone.Cloner. Do not call directly.

Specified by:

cloneFields in interface JmeCloneable

Overrides:

cloneFields in class Geometry

Parameters:

cloner - The cloner that is performing the cloning operation. The cloneFields method can call back into the cloner to make clones of its subordinate fields.

original - The original object from which this object was cloned. This is provided for the very rare case that this object needs to refer to its original for some reason. In general, all of the relevant values should have been transferred during the shallow clone and this object need merely clone what it wants.

write

public void write(JmeExporter exporter)
           throws java.io.IOException

Specified by:

write in interface Savable

Overrides:

write in class Geometry

Throws:

java.io.IOException

read

public void read(JmeImporter importer)
          throws java.io.IOException

Specified by:

read in interface Savable

Overrides:

read in class Geometry

Throws:

java.io.IOException