Mesh

java.lang.Object
- com.threed.jpct.Mesh

All Implemented Interfaces:

java.io.Serializable
```
public final class Mesh
extends java.lang.Object
implements java.io.Serializable
```
In a Mesh, jPCT stores the actual vertex and triangle information for an object. Mesh can't be instantiated directly. Meshes are shareable between objects. This means that more than one object may use the same instance of Mesh. This saves memory and is more cache-friendly. Meshes are also used for implementing keyframe animation.

See Also:

Object3D, Object3D.getMesh(), Object3D.cloneObject(), Animation, Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`static boolean`	`COMPRESS` The mesh will be compressed
`static boolean`	`DONT_COMPRESS` The mesh won't be compressed
`static int`	`SERIALIZE_ALL` normal serialization (default)
`static int`	`SERIALIZE_LOW_PRECISION` float data will be saved as 16 bit precision. on the average ~0.3 percent of precision will be lost
`static int`	`SERIALIZE_VERTICES_ONLY` Normals will not be serialized and will have to be recalculated during deserialization.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addVertexAttributes(VertexAttributes attrs)` Adds some vertex attributes to this mesh.
`void`	`applyVertexController()` Executes the apply() method of the assigned VertexController and updates the mesh's vertex data with the new values generated by the controller.
`Mesh`	`cloneMesh(boolean compressed)` Returns a copy of this mesh.
`void`	`compress()` Compresses the mesh by removing unused information from it.
`float[]`	`getBoundingBox()` Returns the bounding box in object space of this mesh in a float array.
`int`	`getTriangleCount()` The number of triangles for this mesh.
`int`	`getUniqueVertexCount()` Returns the number of unique vertices.
`VertexAttributes[]`	`getVertexAttributes()` Returns an array with all the currently assigned vertex attributes.
`int`	`getVertexCount()` Returns the number of vertices this mesh consists of
`boolean`	`isLocked()` Returns if this mesh has been locked or not!
`void`	`removeVertexController()` Removes the VertexController from this mesh.
`void`	`setLocked(boolean locked)` Locks a mesh.
`void`	`setSerializeMethod(int method)` Sets the serialization method.
`boolean`	`setVertexController(IVertexController controller, boolean modify)` Sets the VertexController for this Mesh.
`void`	`strip()` Removes triangle information from this mesh.

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - COMPRESS
```
public static final boolean COMPRESS
```
    The mesh will be compressed
    
    See Also:
    
    Constant Field Values
  - DONT_COMPRESS
```
public static final boolean DONT_COMPRESS
```
    The mesh won't be compressed
    
    See Also:
    
    Constant Field Values
  - SERIALIZE_ALL
```
public static final int SERIALIZE_ALL
```
    normal serialization (default)
    
    See Also:
    
    Constant Field Values
  - SERIALIZE_VERTICES_ONLY
```
public static final int SERIALIZE_VERTICES_ONLY
```
    Normals will not be serialized and will have to be recalculated during deserialization. This saves a lot of space but increases load time.
    
    See Also:
    
    Constant Field Values
  - SERIALIZE_LOW_PRECISION
```
public static final int SERIALIZE_LOW_PRECISION
```
    float data will be saved as 16 bit precision. on the average ~0.3 percent of precision will be lost
    
    See Also:
    
    Constant Field Values
- Method Detail
  - setVertexController
```
public boolean setVertexController(IVertexController controller,
                                   boolean modify)
```
    Sets the VertexController for this Mesh. A VertexController is the only way for an application to modify the vertex data of jPCT's meshes after build-time.
    Usually, a custom VertexController extend the GenericVertexController the API provides. An instance can only be assigned to one mesh at a time.
    This mesh should include vertex normals, i.e. it has to belong to an object for which build() has been called already. If that's not the case, jPCT will print out a warning message.
    
    Parameters:
    
    controller - the controller
    
    modify - the mode, i.e. if the modifications are cumulative or not
    
    Returns:
    
    true, if everything went well
    
    See Also:
    
    IVertexController.ALTER_SOURCE_MESH, IVertexController.PRESERVE_SOURCE_MESH, IVertexController, GenericVertexController
  - applyVertexController
```
public void applyVertexController()
```
    Executes the apply() method of the assigned VertexController and updates the mesh's vertex data with the new values generated by the controller.
  - removeVertexController
```
public void removeVertexController()
```
    Removes the VertexController from this mesh. When doing so, the controller's destroy() method will be called.
  - strip
```
public void strip()
```
    Removes triangle information from this mesh. This is useful to save some memory for meshes that are used for keyframing only (triangle information are not needed in that case). For any other meshes: Don't call this method. It will break your mesh!
  - setLocked
```
public void setLocked(boolean locked)
```
    Locks a mesh. A locked mesh can't and won't be stripped even if you call the corresponding methods. This can be used to strip Object3Ds that are sharing Meshes.
    
    Parameters:
    
    locked - should it be locked?
  - isLocked
```
public boolean isLocked()
```
    Returns if this mesh has been locked or not!
    
    Returns:
    
    locked?
  - compress
```
public void compress()
```
    Compresses the mesh by removing unused information from it. When creating a mesh, it is usually not known how many unique vertices it may contain, so space is reserved for the extreme case that no vertex-sharing is possible within this mesh (the vertex sharing is something that jPCT automatically takes care of). The more vertices are sharable between the triangles of the mesh, the more space remains unused. compress() frees this space at the cost that no additional vertices can be added to the mesh after compressing it. If one is sure that this is not required, compressing a mesh can be helpful to save memory. Meshes of loaded MD2- and 3DS-models are compressed by default.
    
    See Also:
    
    getVertexCount(), getUniqueVertexCount()
  - cloneMesh
```
public Mesh cloneMesh(boolean compressed)
```
    Returns a copy of this mesh. A copy of a mesh can be used to take a mesh from an existing object and modify it without modifying the source mesh. With this, you can also use meshes from existing objects (not only temporary ones) as meshes for a keyframe animation [like: Animation.addKeyFrame(obj.getMesh().cloneMesh(...))]. Cloning a compressed mesh without letting cloneMesh compress it again will result in an uncompressed one (eats up more memory, but triangles may be added to such a mesh again).
    
    Parameters:
    
    compressed - indicates if compress() should by called after cloning the mesh or not
    
    Returns:
    
    a copy of this mesh
    
    See Also:
    
    COMPRESS, DONT_COMPRESS, compress()
  - getVertexCount
```
public int getVertexCount()
```
    Returns the number of vertices this mesh consists of
    
    Returns:
    
    the number of vertices
  - getUniqueVertexCount
```
public int getUniqueVertexCount()
```
    Returns the number of unique vertices. Unlike getVertexCount(), this number takes into account that vertices are shared between triangles whenever possible to lower geometry processing time. jPCT does only transform as many vertices as this number indicates.
    
    Returns:
    
    the number of unique vertices
  - getTriangleCount
```
public int getTriangleCount()
```
    The number of triangles for this mesh.
    
    Returns:
    
    the number of triangles
  - getBoundingBox
```
public float[] getBoundingBox()
```
    Returns the bounding box in object space of this mesh in a float array. Format is minX, maxX, minY, maxY, minZ, maxZ. Calculation is done everytime this method is being called, so don't call it without need.
    
    Returns:
    
    float[] the corners of the BB in object space
  - addVertexAttributes
```
public void addVertexAttributes(VertexAttributes attrs)
```
    Adds some vertex attributes to this mesh. The instance of VertexAttributes' attribute count has to match the unique vertex count of this mesh. You can add multiple attributes.
    
    Parameters:
    
    attrs - the new attributes
  - getVertexAttributes
```
public VertexAttributes[] getVertexAttributes()
```
    Returns an array with all the currently assigned vertex attributes.
    
    Returns:
    
    the attributes or null, if none has been assigned
  - setSerializeMethod
```
public void setSerializeMethod(int method)
```
    Sets the serialization method. Can be used to decrease the size of a serialized Mesh at the cost of loading speed and/or accuracy.
    
    Parameters:
    
    method - Either SERIALIZE_ALL, DONT_SERIALIZE_NORMALS or SERIALIZE_LOW_PRECISION. Methods can be combined by using the or-operator.

Class Mesh

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

COMPRESS

DONT_COMPRESS

SERIALIZE_ALL

SERIALIZE_VERTICES_ONLY

SERIALIZE_LOW_PRECISION

Method Detail

setVertexController

applyVertexController

removeVertexController

strip

setLocked

isLocked

compress

cloneMesh

getVertexCount

getUniqueVertexCount

getTriangleCount

getBoundingBox

addVertexAttributes

getVertexAttributes

setSerializeMethod