Module com.marginallyclever.ro3

Package com.marginallyclever.ro3.mesh

Class Mesh

java.lang.Object

com.marginallyclever.ro3.mesh.Mesh

All Implemented Interfaces:

OpenGL3Resource

Direct Known Subclasses:

ProceduralMesh

public class Mesh
extends Object
implements OpenGL3Resource

Mesh contains the vertex data for a 3D model. It may also contain normal, color, and texture data.

It uses Vertex Array Objects and Vertex Buffer Objects to optimize rendering large collections of triangles.

Field Summary

Fields

Modifier and Type	Field	Description
final List<Float>	colorArray
final List<Integer>	indexArray
final List<Float>	normalArray
static final int	NUM_BUFFERS
int	renderStyle
final List<Float>	textureArray
final List<Float>	vertexArray

Constructor Summary

Constructors

Constructor	Description
Mesh()
Mesh(int renderStyle)

Method Summary

Modifier and Type	Method	Description
void	addColor(float r, float g, float b, float a)	Add a color to the mesh.
void	addIndex(int n)
void	addNormal(float x, float y, float z)
void	addNormal(javax.vecmath.Tuple3d n)
void	addPropertyChangeListener(PropertyChangeListener listener)
void	addTexCoord(float u, float v)	Add a texture coordinate to the mesh.
void	addVertex(float x, float y, float z)
void	addVertex(javax.vecmath.Tuple3d p)
void	clear()	Remove all vertexes, normals, colors, texture coordinates, etc.
PathMesh	createPathMesh(javax.vecmath.Matrix4d worldMatrix)	Create a PathMesh from this mesh, transformed by the given world matrix.
void	fireMeshChanged()
AABB	getBoundingBox()
Color	getColor(int t)
boolean	getHasColors()
boolean	getHasIndexes()
boolean	getHasNormals()
boolean	getHasTextures()
javax.vecmath.Vector3d	getNormal(int t)
int	getNumTriangles()
int	getNumVertices()
javax.vecmath.Point3d	getRandomPointOnSurface()	Assumes that all triangles are outward facing and part of a closed, convex, non-intersecting mesh.
javax.vecmath.Point3d	getRandomPointOnTriangle(int triangleIndex)
int	getRenderStyle()
String	getSourceName()
javax.vecmath.Point2d	getTexCoord(int t)
double	getTriangleArea(int triangleIndex)
javax.vecmath.Point3d	getVertex(int t)
VertexProvider	getVertexProvider()
Hit	intersect(Ray ray)	Intersect a ray with this mesh.
boolean	isDirty()
boolean	isLoaded()
boolean	isTransparent()
void	removePropertyChangeListener(PropertyChangeListener listener)
void	render(com.jogamp.opengl.GL3 gl)	Render the entire mesh.
void	render(com.jogamp.opengl.GL3 gl, int startIndex, int count)	Render a portion of the mesh.
void	setDirty(boolean isDirty)
void	setLoaded(boolean loaded)
void	setRenderStyle(int style)
void	setSourceName(String filename)
void	setTexCoord(int i, double u, double v)
void	setVertex(int i, double x, double y, double z)
void	unload(com.jogamp.opengl.GL3 gl)	Destroy the buffers stored in the video card memory.
void	updateBoundingBox()	Force recalculation of the minimum bounding box to contain this STL file.
void	updateVertexBuffers(com.jogamp.opengl.GL3 gl3)

Methods inherited from class java.lang.Object

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

Field Details

NUM_BUFFERS

public static final int NUM_BUFFERS

See Also:

• Constant Field Values

vertexArray

public final transient List<Float> vertexArray

normalArray

public final transient List<Float> normalArray

colorArray

public final transient List<Float> colorArray

textureArray

public final transient List<Float> textureArray

indexArray

public final transient List<Integer> indexArray

renderStyle

public int renderStyle

Constructor Details

Mesh

public Mesh()

Mesh

public Mesh(int renderStyle)

Method Details

clear

public void clear()

Remove all vertexes, normals, colors, texture coordinates, etc. on the next call to render(GL3) the mesh will be rebuilt to nothing. See also unload(GL3)

setSourceName

public void setSourceName(String filename)

getSourceName

public String getSourceName()

isLoaded

public boolean isLoaded()

setLoaded

public void setLoaded(boolean loaded)

isTransparent

public boolean isTransparent()

unload

public void unload(com.jogamp.opengl.GL3 gl)

Destroy the buffers stored in the video card memory. This does not free the arrays used by the mesh. See also clear()

Specified by:

unload in interface OpenGL3Resource

Parameters:

gl - the OpenGL context

getVertexProvider

public VertexProvider getVertexProvider()

render

public void render(com.jogamp.opengl.GL3 gl)

Render the entire mesh.

Parameters:

gl - the OpenGL context

render

public void render(com.jogamp.opengl.GL3 gl,
 int startIndex,
 int count)

Render a portion of the mesh.

Parameters:

gl - the OpenGL context

startIndex - index of the first vertex to viewport

count - number of vertices to viewport

addNormal

public void addNormal(float x,
 float y,
 float z)

addNormal

public void addNormal(javax.vecmath.Tuple3d n)

addVertex

public void addVertex(float x,
 float y,
 float z)

addVertex

public void addVertex(javax.vecmath.Tuple3d p)

addColor

public void addColor(float r,
 float g,
 float b,
 float a)

Add a color to the mesh.

Parameters:

r - red, 0-1

g - green, 0-1

b - blue, 0-1

a - alpha, 0-1

addTexCoord

public void addTexCoord(float u,
 float v)

Add a texture coordinate to the mesh.

Parameters:

u - 0-1

v - 0-1

addIndex

public void addIndex(int n)

updateBoundingBox

public void updateBoundingBox()

Force recalculation of the minimum bounding box to contain this STL file. Done automatically every time updateBuffers() is called. Meaningless if there is no vertexArray of points.

getBoundingBox

public AABB getBoundingBox()

Returns:

AABB in the mesh's local space.

getNumTriangles

public int getNumTriangles()

getNumVertices

public int getNumVertices()

getVertex

public javax.vecmath.Point3d getVertex(int t)

getNormal

public javax.vecmath.Vector3d getNormal(int t)

getTexCoord

public javax.vecmath.Point2d getTexCoord(int t)

getColor

public Color getColor(int t)

isDirty

public boolean isDirty()

setDirty

public void setDirty(boolean isDirty)

getHasNormals

public boolean getHasNormals()

getHasColors

public boolean getHasColors()

getHasTextures

public boolean getHasTextures()

getHasIndexes

public boolean getHasIndexes()

setRenderStyle

public void setRenderStyle(int style)

getRenderStyle

public int getRenderStyle()

intersect

public Hit intersect(Ray ray)

Intersect a ray with this mesh.

Parameters:

ray - The ray to intersect with, in local space.

Returns:

The RayHit object containing the intersection point and normal, or null if no intersection.

setVertex

public void setVertex(int i,
 double x,
 double y,
 double z)

setTexCoord

public void setTexCoord(int i,
 double u,
 double v)

updateVertexBuffers

public void updateVertexBuffers(com.jogamp.opengl.GL3 gl3)

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)

fireMeshChanged

public void fireMeshChanged()

getRandomPointOnSurface

public javax.vecmath.Point3d getRandomPointOnSurface()

Assumes that all triangles are outward facing and part of a closed, convex, non-intersecting mesh.

This is a very rough approximation. The most correct way to do this is to find the area of every triangle, then pick a random triangle weighted by area, then pick a random point on that triangle.

The actual algorithm picks a random triangle, then a random point inside that triangle.

Returns:

a random point on the surface of this mesh.

getRandomPointOnTriangle

public javax.vecmath.Point3d getRandomPointOnTriangle(int triangleIndex)

getTriangleArea

public double getTriangleArea(int triangleIndex)

createPathMesh

public PathMesh createPathMesh(javax.vecmath.Matrix4d worldMatrix)

Create a PathMesh from this mesh, transformed by the given world matrix.

Parameters:

worldMatrix - the world matrix to transform the mesh by.

Returns:

the new PathMesh.