Module com.marginallyclever.ro3

Package com.marginallyclever.ro3.mesh

Class MeshFactory

java.lang.Object

com.marginallyclever.ro3.factories.Factory

com.marginallyclever.ro3.mesh.MeshFactory

public class MeshFactory
extends Factory

MeshFactory loads a mesh from a file using one of many MeshLoader classes. It also keeps a pool of all mesh loaded so that only one instance of each shape is loaded.

Constructor Summary

Constructors

Constructor	Description
MeshFactory()

Method Summary

Modifier and Type	Method	Description
void	addToPool(Lifetime lifetime, String key, Mesh mesh)	Add a mesh to the pool if it is not already present.
boolean	canLoad(String absolutePath)
Mesh	get(Lifetime lifetime, String filename)	Makes sure to only load one instance of each source file.
Mesh	get(Lifetime lifetime, String filename, javax.vecmath.Vector3d scaleFactor)	Get a mesh from the pool, loading it if necessary, and applying a scale factor.
List<FileFilter>	getAllExtensions()
List<Mesh>	getAllResources()
List<String>	getAllSourcesForExport()
String	getMaterialPath(String absolutePath)
List<Mesh>	getResources(Lifetime lifetime)	Get all meshes in the pool with a specific lifetime.
boolean	hasMaterial(String absolutePath)
void	reload(Mesh myMesh)
void	removeFromPool(Mesh mesh)	Remove a mesh from the pool.
void	removeSceneResources()	Clear all meshes with lifetime SCENE from the pool.
void	unloadAll(com.jogamp.opengl.GL3 gl)	Unload all meshes in the pool from OpenGL memory.

Methods inherited from class com.marginallyclever.ro3.factories.Factory

addItemListener, removeItemListener

Methods inherited from class java.lang.Object

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

Constructor Details

MeshFactory

public MeshFactory()

Method Details

get

public Mesh get(Lifetime lifetime,
 String filename)

Makes sure to only load one instance of each source file. Loads all the data immediately. Loads at the default scale.

Parameters:

lifetime - the lifetime of the mesh

filename - file from which to load. It may be "filename.ext" or "zipfile.zip:filename.ext"

Returns:

a non-null instance of Mesh. It may contain nothing.

get

public Mesh get(Lifetime lifetime,
 String filename,
 javax.vecmath.Vector3d scaleFactor)

Get a mesh from the pool, loading it if necessary, and applying a scale factor.

Parameters:

lifetime - the lifetime of the mesh

filename - file from which to load. It may be "filename.ext" or "zipfile.zip:filename.ext"

scaleFactor - the scale factor to apply to the mesh

Returns:

a non-null instance of Mesh. It may contain nothing.

reload

public void reload(Mesh myMesh)

getAllExtensions

public List<FileFilter> getAllExtensions()

canLoad

public boolean canLoad(String absolutePath)

hasMaterial

public boolean hasMaterial(String absolutePath)

getMaterialPath

public String getMaterialPath(String absolutePath)

getAllSourcesForExport

public List<String> getAllSourcesForExport()

getResources

public List<Mesh> getResources(Lifetime lifetime)

Get all meshes in the pool with a specific lifetime.

Parameters:

lifetime - the lifetime to filter by

Returns:

a collection of meshes with the specified lifetime

getAllResources

public List<Mesh> getAllResources()

removeSceneResources

public void removeSceneResources()

Clear all meshes with lifetime SCENE from the pool.

Specified by:

removeSceneResources in class Factory

addToPool

public void addToPool(Lifetime lifetime,
 String key,
 Mesh mesh)

Add a mesh to the pool if it is not already present.

Parameters:

lifetime - the lifetime of the mesh

key - the key to use for the mesh

mesh - the mesh to add

removeFromPool

public void removeFromPool(Mesh mesh)

Remove a mesh from the pool.

Parameters:

mesh - the mesh to remove

unloadAll

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

Unload all meshes in the pool from OpenGL memory. This must be called from the OpenGL thread.

Parameters:

gl - the OpenGL context