com.jme3.scene.plugins.blender.meshes

Class TemporalMesh

java.lang.Object

com.jme3.scene.Spatial

com.jme3.scene.Geometry

com.jme3.scene.plugins.blender.meshes.TemporalMesh

All Implemented Interfaces:

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

Direct Known Subclasses:

CurvesTemporalMesh

public class TemporalMesh
extends Geometry

The class extends Geometry so that it can be temporalily added to the object's node. Later each such node's child will be transformed into a list of geometries.

Nested Class Summary

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

Spatial.BatchHint, Spatial.CullHint, Spatial.DFSMode

Field Summary

Fields

Modifier and Type	Field and Description
protected BlenderContext	blenderContext The blender context.
protected java.util.Map<java.lang.String,java.lang.Integer>	boneIndexes The bone indexes.
protected BoundingBox	boundingBox The bounding box of the temporal mesh.
protected java.util.List<Edge>	edges The edges of the mesh.
protected java.util.List<Face>	faces The faces of the mesh.
protected java.util.Map<java.lang.Integer,java.util.Set<Edge>>	indexToEdgeMapping A map between index and edges that contain it (for faster index - edge queries).
protected java.util.Map<java.lang.Integer,java.util.Set<Face>>	indexToFaceMapping A map between index and faces that contain it (for faster index - face queries).
protected MaterialContext[]	materials Materials used by the mesh.
protected Structure	meshStructure The mesh's structure.
protected java.util.List<Vector3f>	normals Loaded normals.
protected java.util.List<Point>	points The points of the mesh.
protected java.util.List<Modifier>	postMeshCreationModifiers The modifiers that should be applied after the mesh has been created.
protected Properties	properties The properties of the mesh.
protected java.util.List<java.util.Map<java.lang.String,java.lang.Float>>	vertexGroups Loaded vertex groups.
protected java.util.List<Vector3f>	vertices Loaded vertices.
protected java.util.List<byte[]>	verticesColors Loaded vertex colors.

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

Modifier	Constructor and Description
	TemporalMesh(Structure meshStructure, BlenderContext blenderContext) Creates a temporal mesh based on the given mesh structure.
protected	TemporalMesh(Structure meshStructure, BlenderContext blenderContext, boolean loadData) Creates a temporal mesh based on the given mesh structure.

Method Summary

Modifier and Type	Method and Description
void	addBoneIndex(java.lang.String boneName, java.lang.Integer boneIndex) Adds bone index to the mesh.
void	append(TemporalMesh mesh) The method appends the given mesh to the current one.
void	applyAfterMeshCreate(Modifier modifier) The modifier to be applied after the geometries are created.
void	clear() Removes all vertices from the mesh.
TemporalMesh	clone() This version of clone is a shallow clone, in other words, the same mesh is referenced as the original geometry.
boolean	equals(java.lang.Object obj)
java.util.Collection<Edge>	getAdjacentEdges(java.lang.Integer index)
java.util.Collection<Face>	getAdjacentFaces(Edge edge)
java.util.Collection<Face>	getAdjacentFaces(java.lang.Integer index)
BlenderContext	getBlenderContext()
java.util.List<Edge>	getEdges()
java.util.List<Face>	getFaces()
BoundingVolume	getModelBound()
java.util.List<Vector3f>	getNormals()
java.util.List<Point>	getPoints()
int	getVertexCount() Returns this geometry's mesh vertex count.
java.util.List<java.util.Map<java.lang.String,java.lang.Float>>	getVertexGroups()
java.util.List<Vector3f>	getVertices()
java.util.List<byte[]>	getVerticesColors()
BoundingVolume	getWorldBound() getWorldBound retrieves the world bound at this node level.
int	hashCode()
boolean	isBoundary(Edge edge) Tells if the given edge is a boundary edge.
boolean	isBoundary(java.lang.Integer index) The method tells if the given index is a boundary index.
protected void	prepareFacesGeometry(java.util.List<Geometry> result, MeshHelper meshHelper) The method creates geometries from faces.
protected void	prepareLinesGeometry(java.util.List<Geometry> result, MeshHelper meshHelper) The method creates geometries from lines.
protected void	preparePointsGeometry(java.util.List<Geometry> result, MeshHelper meshHelper) The method creates geometries from points.
void	rebuildIndexesMappings() The method rebuilds the mappings between faces and edges.
void	setMaterials(MaterialContext[] materials) Sets the materials of the mesh.
void	setProperties(Properties properties) Sets the properties of the mesh.
void	toGeometries() The mesh builds geometries from the mesh.
java.lang.String	toString() Returns the Spatial's name followed by the class of the spatial Example: "MyNode (com.jme3.scene.Spatial)
void	triangulate() Triangulates the mesh.
void	updateModelBound() Updates the bounding volume of the mesh.

Methods inherited from class com.jme3.scene.Geometry

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

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, 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, updateGeometricState, updateLogicalState, updateMatParamOverrides, worldToLocal

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

blenderContext

protected final BlenderContext blenderContext

The blender context.

meshStructure

protected final Structure meshStructure

The mesh's structure.

vertices

protected java.util.List<Vector3f> vertices

Loaded vertices.

normals

protected java.util.List<Vector3f> normals

Loaded normals.

vertexGroups

protected java.util.List<java.util.Map<java.lang.String,java.lang.Float>> vertexGroups

Loaded vertex groups.

verticesColors

protected java.util.List<byte[]> verticesColors

Loaded vertex colors.

materials

protected MaterialContext[] materials

Materials used by the mesh.

properties

protected Properties properties

The properties of the mesh.

boneIndexes

protected java.util.Map<java.lang.String,java.lang.Integer> boneIndexes

The bone indexes.

postMeshCreationModifiers

protected java.util.List<Modifier> postMeshCreationModifiers

The modifiers that should be applied after the mesh has been created.

faces

protected java.util.List<Face> faces

The faces of the mesh.

edges

protected java.util.List<Edge> edges

The edges of the mesh.

points

protected java.util.List<Point> points

The points of the mesh.

indexToFaceMapping

protected java.util.Map<java.lang.Integer,java.util.Set<Face>> indexToFaceMapping

A map between index and faces that contain it (for faster index - face queries).

indexToEdgeMapping

protected java.util.Map<java.lang.Integer,java.util.Set<Edge>> indexToEdgeMapping

A map between index and edges that contain it (for faster index - edge queries).

boundingBox

protected BoundingBox boundingBox

The bounding box of the temporal mesh.

Constructor Detail

TemporalMesh

public TemporalMesh(Structure meshStructure,
                    BlenderContext blenderContext)
             throws BlenderFileException

Creates a temporal mesh based on the given mesh structure.

Parameters:

meshStructure - the mesh structure

blenderContext - the blender context

Throws:

BlenderFileException - an exception is thrown when problems with file reading occur

TemporalMesh

protected TemporalMesh(Structure meshStructure,
                       BlenderContext blenderContext,
                       boolean loadData)
                throws BlenderFileException

Creates a temporal mesh based on the given mesh structure.

Parameters:

meshStructure - the mesh structure

blenderContext - the blender context

loadData - tells if the data should be loaded from the mesh structure

Throws:

BlenderFileException - an exception is thrown when problems with file reading occur

Method Detail

getBlenderContext

public BlenderContext getBlenderContext()

Returns:

the blender context

getVertices

public java.util.List<Vector3f> getVertices()

Returns:

the vertices of the mesh

getNormals

public java.util.List<Vector3f> getNormals()

Returns:

the normals of the mesh

getFaces

public java.util.List<Face> getFaces()

Returns:

all faces

getEdges

public java.util.List<Edge> getEdges()

Returns:

all edges

getPoints

public java.util.List<Point> getPoints()

Returns:

all points (do not mistake it with vertices)

getVerticesColors

public java.util.List<byte[]> getVerticesColors()

Returns:

all vertices colors

getVertexGroups

public java.util.List<java.util.Map<java.lang.String,java.lang.Float>> getVertexGroups()

Returns:

all vertex groups for the vertices (each map has groups for the proper vertex)

getAdjacentFaces

public java.util.Collection<Face> getAdjacentFaces(java.lang.Integer index)

Returns:

the faces that contain the given index or null if none contain it

getAdjacentFaces

public java.util.Collection<Face> getAdjacentFaces(Edge edge)

Parameters:

edge - the edge of the mesh

Returns:

a list of faces that contain the given edge or an empty list

getAdjacentEdges

public java.util.Collection<Edge> getAdjacentEdges(java.lang.Integer index)

Parameters:

index - the index of the mesh

Returns:

a list of edges that contain the index

isBoundary

public boolean isBoundary(Edge edge)

Tells if the given edge is a boundary edge. The boundary edge means that it belongs to a single face or to none.

Parameters:

edge - the edge of the mesh

Returns:

true if the edge is a boundary one and false otherwise

isBoundary

public boolean isBoundary(java.lang.Integer index)

The method tells if the given index is a boundary index. A boundary index belongs to at least one boundary edge.

Parameters:

index - the index of the mesh

Returns:

true if the index is a boundary one and false otherwise

clone

public TemporalMesh clone()

Description copied from class: Geometry

This version of clone is a shallow clone, in other words, the same mesh is referenced as the original geometry. Exception: if the mesh is marked as being a software animated mesh, (bind pose is set) then the positions and normals are deep copied.

Specified by:

clone in interface CloneableSmartAsset

Overrides:

clone in class Geometry

Returns:

A clone of this Spatial, the scene graph in its entirety is cloned and can be altered independently of the original scene graph. Note that meshes of geometries are not cloned explicitly, they are shared if static, or specially cloned if animated.

See Also:

Mesh.cloneForAnim()

rebuildIndexesMappings

public void rebuildIndexesMappings()

The method rebuilds the mappings between faces and edges. Should be called after every major change of the temporal mesh done outside it.

Note: I will remove this method soon and cause the mappings to be done automatically when the mesh is modified.

updateModelBound

public void updateModelBound()

Description copied from class: Geometry

Updates the bounding volume of the mesh. Should be called when the mesh has been modified.

Overrides:

updateModelBound in class Geometry

getModelBound

public BoundingVolume getModelBound()

Overrides:

getModelBound in class Geometry

Returns:

The bounding volume of the mesh, in model space.

getWorldBound

public BoundingVolume getWorldBound()

Description copied from class: Spatial

getWorldBound retrieves the world bound at this node level.

Overrides:

getWorldBound in class Spatial

Returns:

the world bound at this level.

triangulate

public void triangulate()

Triangulates the mesh.

append

public void append(TemporalMesh mesh)

The method appends the given mesh to the current one. New faces and vertices and indexes are added.

Parameters:

mesh - the mesh to be appended

setProperties

public void setProperties(Properties properties)

Sets the properties of the mesh.

Parameters:

properties - the properties of the mesh

setMaterials

public void setMaterials(MaterialContext[] materials)

Sets the materials of the mesh.

Parameters:

materials - the materials of the mesh

addBoneIndex

public void addBoneIndex(java.lang.String boneName,
                         java.lang.Integer boneIndex)

Adds bone index to the mesh.

Parameters:

boneName - the name of the bone

boneIndex - the index of the bone

applyAfterMeshCreate

public void applyAfterMeshCreate(Modifier modifier)

The modifier to be applied after the geometries are created.

Parameters:

modifier - the modifier to be applied

getVertexCount

public int getVertexCount()

Description copied from class: Geometry

Returns this geometry's mesh vertex count.

Overrides:

getVertexCount in class Geometry

Returns:

this geometry's mesh vertex count.

See Also:

Mesh.getVertexCount()

clear

public void clear()

Removes all vertices from the mesh.

toGeometries

public void toGeometries()

The mesh builds geometries from the mesh. The result is stored in the blender context under the mesh's OMA.

prepareFacesGeometry

protected void prepareFacesGeometry(java.util.List<Geometry> result,
                                    MeshHelper meshHelper)

The method creates geometries from faces.

Parameters:

result - the list where new geometries will be appended

meshHelper - the mesh helper

prepareLinesGeometry

protected void prepareLinesGeometry(java.util.List<Geometry> result,
                                    MeshHelper meshHelper)

The method creates geometries from lines.

Parameters:

result - the list where new geometries will be appended

meshHelper - the mesh helper

preparePointsGeometry

protected void preparePointsGeometry(java.util.List<Geometry> result,
                                     MeshHelper meshHelper)

The method creates geometries from points.

Parameters:

result - the list where new geometries will be appended

meshHelper - the mesh helper

toString

public java.lang.String toString()

Description copied from class: Spatial

Returns the Spatial's name followed by the class of the spatial
Example: "MyNode (com.jme3.scene.Spatial)

Overrides:

toString in class Spatial

Returns:

Spatial's name followed by the class of the Spatial

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object