com.jme3.bullet.collision.shapes

Class MeshCollisionShape

java.lang.Object

com.jme3.bullet.collision.shapes.CollisionShape

com.jme3.bullet.collision.shapes.MeshCollisionShape

All Implemented Interfaces:

Savable

public class MeshCollisionShape
extends CollisionShape

A mesh collision shape based on Bullet's btBvhTriangleMeshShape.

Field Summary

Fields

Modifier and Type	Field and Description
protected long	meshId Unique identifier of the Bullet mesh.
protected long	nativeBVHBuffer
protected int	numTriangles
protected int	numVertices
protected java.nio.ByteBuffer	triangleIndexBase
protected int	triangleIndexStride
protected java.nio.ByteBuffer	vertexBase
protected int	vertexStride

Fields inherited from class com.jme3.bullet.collision.shapes.CollisionShape

margin, objectId, scale

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	MeshCollisionShape() No-argument constructor needed by SavableClassUtil.
	MeshCollisionShape(java.nio.ByteBuffer indices, java.nio.ByteBuffer vertices, boolean memoryOptimized) An advanced constructor.
	MeshCollisionShape(Mesh mesh) Instantiate a collision shape based on the specified JME mesh, optimized for memory usage.
	MeshCollisionShape(Mesh mesh, boolean memoryOptimized) Instantiate a collision shape based on the specified JME mesh.

Method Summary

Modifier and Type	Method and Description
void	finalize() Finalize this shape just before it is destroyed.
void	read(JmeImporter im) De-serialize this shape, for example when loading from a J3O file.
void	write(JmeExporter ex) Serialize this shape, for example when saving to a J3O file.

Methods inherited from class com.jme3.bullet.collision.shapes.CollisionShape

getDefaultMargin, getMargin, getObjectId, getScale, isNonMoving, setDefaultMargin, setMargin, setObjectId, setScale

Methods inherited from class java.lang.Object

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

Field Detail

numVertices

protected int numVertices

numTriangles

protected int numTriangles

vertexStride

protected int vertexStride

triangleIndexStride

protected int triangleIndexStride

triangleIndexBase

protected java.nio.ByteBuffer triangleIndexBase

vertexBase

protected java.nio.ByteBuffer vertexBase

meshId

protected long meshId

Unique identifier of the Bullet mesh. The constructor sets this to a non-zero value.

nativeBVHBuffer

protected long nativeBVHBuffer

Constructor Detail

MeshCollisionShape

protected MeshCollisionShape()

No-argument constructor needed by SavableClassUtil. Do not invoke directly!

MeshCollisionShape

public MeshCollisionShape(Mesh mesh)

Instantiate a collision shape based on the specified JME mesh, optimized for memory usage.

Parameters:

mesh - the mesh on which to base the shape (not null)

MeshCollisionShape

public MeshCollisionShape(Mesh mesh,
                          boolean memoryOptimized)

Instantiate a collision shape based on the specified JME mesh.

memoryOptimized determines if optimized instead of quantized BVH will be used. Internally, memoryOptimized BVH is slower to calculate (~4x) but also smaller (~0.5x). It is preferable to use the memory optimized version and then serialize the resulting MeshCollisionshape as this will also save the generated BVH. An exception can be procedurally / generated collision shapes, where the generation time is more of a concern

Parameters:

mesh - the mesh on which to base the shape (not null)

memoryOptimized - true to generate a memory-optimized BVH, false to generate quantized BVH

MeshCollisionShape

public MeshCollisionShape(java.nio.ByteBuffer indices,
                          java.nio.ByteBuffer vertices,
                          boolean memoryOptimized)

An advanced constructor. Passing false values can lead to a crash. Usually you don’t want to use this. Use at own risk.

This constructor bypasses all copy logic normally used, this allows for faster Bullet shape generation when using procedurally generated Meshes.

Parameters:

indices - the raw index buffer

vertices - the raw vertex buffer

memoryOptimized - use quantized BVH, uses less memory, but slower

Method Detail

write

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

Serialize this shape, for example when saving to a J3O file.

Specified by:

write in interface Savable

Overrides:

write in class CollisionShape

Parameters:

ex - exporter (not null)

Throws:

java.io.IOException - from exporter

read

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

De-serialize this shape, for example when loading from a J3O file.

Specified by:

read in interface Savable

Overrides:

read in class CollisionShape

Parameters:

im - importer (not null)

Throws:

java.io.IOException - from importer

finalize

public void finalize()
              throws java.lang.Throwable

Finalize this shape just before it is destroyed. Should be invoked only by a subclass or by the garbage collector.

Overrides:

finalize in class CollisionShape

Throws:

java.lang.Throwable - ignored by the garbage collector