AssetManager (Bonzai Engine bonzaiengine.com Copyright © 2007-2015 Jérôme Jouvie)

java.lang.Object
- com.bonzaiengine.model.asset.AssetManager

All Implemented Interfaces:

OnLoadListener<Texture>
```
public class AssetManager
extends java.lang.Object
implements OnLoadListener<Texture>
```
Asset manager to store and load assets (model, motion, texture and shader).

Field Summary

Fields
Modifier and Type	Field and Description
`AnimGraphLibrary`	`animGraphs` AnimGraph library
`java.lang.ClassLoader`	`context` `ClassLoader` which may be used by asynchronous loading task to resolve resources
`MaterialLibrary`	`materials` Material library
`ModelLibrary`	`models` Model library
`MotionLibrary`	`motions` Motion library
`ShaderList`	`shaders` Optional: List of shaders
`SplineLibrary`	`splines` Spline library
`TextureList`	`textures` List of textures

Constructor Summary

Constructors
Constructor and Description

AssetManager()

Constructors
Constructor and Description
`AssetManager()`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`static AssetManager`	`create()`
`static AssetManager`	`create(boolean concurrent)`
`void`	`destroy(IGL gl)` Destroy AsyncModel/Texture/Shader with a reference count of 0, and all AsyncMotion, MaterialAdvanced
`void`	`destroy(IGL gl, boolean force)` Destroy all assets if `force` set to true, if false equivalent to `#destroy(IGLApi)`
`void`	`generateShadersAsync(Model model)` Force asynchronous shader generation to the specified `Model`.
`Finder`	`getShaderFinder()`
`ShaderGenerator`	`getShaderGenerator()`
`Finder`	`getTextureFinder()`
`boolean`	`hasAsyncModelLoaded()`
`boolean`	`hasAsyncMotionLoaded()`
`boolean`	`isReadTextureAsync()`
`boolean`	`isWorking()`
`Model`	`loadModel(ModelReaderSettings settings)` Deprecated. use `loadModelAsync(ModelReaderSettings)`
`AsyncModel`	`loadModelAsync(ModelReaderSettings settings)` Deprecated. use `ModelLibrary.use(AssetManager, ModelReaderSettings)`, or to bypass `ModelLibrary` use the `AsyncModel` constructor directly.
`AsyncModel`	`loadModelAsyncWithCache(ModelReaderSettings settings)` Load model asynchronously using download cache
`Motion`	`loadMotion(ReaderSettings settings)` Load a motion, and store in `#motions` if assigned.
`AsyncMotion`	`loadMotionAsync(ReaderSettings settings)` Asynchronous `Motion` loading.
`AsyncMotion`	`loadMotionAsyncWithCache(ReaderSettings settings)` Load motion asynchronously using download cache
`void`	`loadShaders()`
`void`	`loadShaders(Model model)`
`void`	`onContextLost()` The be called when the OpenGL context has been lost
`void`	`onContextLost(Model model)` Must be called after `onContextLost()`
`void`	`onLoad(Texture texture)`
`void`	`onMaterialChanged(Mesh mesh, IMaterial material)` Internal use Notifies a `IMaterial` has a changed in a `Mesh`
`void`	`onMaterialChanged(Model model, MaterialStandard material)` Internal use Notifies a `MaterialStandard` has a shader changed
`void`	`readAndLoadTextures(IGL gl, Model model)` Deprecated.
`void`	`readTextureAsync(Texture texture, TextureParam textureParam)` Asynchronous read textures specified
`void`	`readTextures(Model model)` Synchronous texture read of all textures of the `Model`
`void`	`readTexturesAsync()` Asynchronous read all textures in this `AssetManager`
`void`	`readTexturesAsync(Model model)` Asynchronous read all textures of the specified `Model`
`void`	`setReadTextureAsync(boolean readTextureAsync)` Automatically queue asynchronous texture read when a `Model` has been loaded
`void`	`setShaderGenerator(ShaderGenerator shaderGenerator)` Automatically queue asynchronous shader generation when a `Texture` has been loaded

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

- Field Detail
  - textures
```
public TextureList textures
```
    List of textures
  - shaders
```
public ShaderList shaders
```
    Optional: List of shaders
  - models
```
public ModelLibrary models
```
    Model library
  - motions
```
public MotionLibrary motions
```
    Motion library
  - splines
```
public SplineLibrary splines
```
    Spline library
  - materials
```
public MaterialLibrary materials
```
    Material library
  - animGraphs
```
public AnimGraphLibrary animGraphs
```
    AnimGraph library
  - context
```
public java.lang.ClassLoader context
```
    ClassLoader which may be used by asynchronous loading task to resolve resources
- Constructor Detail
  - AssetManager
```
public AssetManager()
```
- Method Detail
  - create
```
public static AssetManager create()
```
    Returns:
    
    A new AssetManager with a TextureList, ShaderList, MaterialLibrary, ModelLibrary. Asynchronous texture and shader is enabled.
  - create
```
public static AssetManager create(boolean concurrent)
```
    Parameters:
    
    concurrent - true to support concurrent assets modifications
    
    Returns:
    
    A new AssetManager with a TextureList, ShaderList, MaterialLibrary, ModelLibrary. Asynchronous texture and shader is enabled.
  - isWorking
```
public final boolean isWorking()
```
    Returns:
    
    true if async
  - setReadTextureAsync
```
public final void setReadTextureAsync(boolean readTextureAsync)
```
    Automatically queue asynchronous texture read when a Model has been loaded
  - isReadTextureAsync
```
public final boolean isReadTextureAsync()
```
  - setShaderGenerator
```
public final void setShaderGenerator(ShaderGenerator shaderGenerator)
```
    Automatically queue asynchronous shader generation when a Texture has been loaded
    
    Throws:
    
    java.lang.IllegalStateException - if textures is not set
  - getShaderGenerator
```
public final ShaderGenerator getShaderGenerator()
```
  - loadModel
```
@Deprecated
public final Model loadModel(ModelReaderSettings settings)
                                   throws java.io.IOException
```
    Deprecated. use loadModelAsync(ModelReaderSettings)
    Equivalent to:
```
   AsyncModel asyncModel = assets.loadModelAsync(settings);
   Model model = asyncModel.getSync();
   asyncModel.release();
   return model;
```
    Parameters:
    
    settings -
    
    Returns:
    
    loadModelAsync(settings).getSync()
    
    Throws:
    
    java.io.IOException - if an exception occurs while loading
    
    See Also:
    
    loadModelAsync(ModelReaderSettings)
  - loadModelAsync
```
@Deprecated
public final AsyncModel loadModelAsync(ModelReaderSettings settings)
```
    Deprecated. use ModelLibrary.use(AssetManager, ModelReaderSettings), or to bypass ModelLibrary use the AsyncModel constructor directly.
    
    Asynchronous Model loading.
    AsyncModel.release() must be called on the result returned.
    
    Parameters:
    
    settings - ModelReaderSettings of the model to load
    
    Returns:
    
    AsyncModel with reference counter increased by one.
  - loadModelAsyncWithCache
```
public final AsyncModel loadModelAsyncWithCache(ModelReaderSettings settings)
                                         throws java.lang.IllegalStateException
```
    Load model asynchronously using download cache
    
    Parameters:
    
    settings - ModelReaderSettings to load
    
    Returns:
    
    AsyncModel
    
    Throws:
    
    java.lang.IllegalStateException - if models is not set
    
    See Also:
    
    Cache
  - hasAsyncModelLoaded
```
public final boolean hasAsyncModelLoaded()
```
    Returns:
    
    true if at least an AsyncModel has been loaded since last call of this method
  - loadMotion
```
public final Motion loadMotion(ReaderSettings settings)
                        throws java.io.IOException
```
    Load a motion, and store in #motions if assigned.
    Uses #loadMotionAsync(ReaderSettings, String) internally.
    
    Returns:
    
    the Motion loaded
    
    Throws:
    
    java.io.IOException - if an exception occurs while loading
    
    See Also:
    
    #loadMotionAsync(ReaderSettings, String)
  - loadMotionAsync
```
public final AsyncMotion loadMotionAsync(ReaderSettings settings)
```
    Asynchronous Motion loading.
    
    Parameters:
    
    settings - ReaderSettings describing the motion to load
    
    identifier - unique identifier of the motion, used for the key in MotionLibrary
    
    Returns:
    
    AsyncMotion which will load asynchronously the Motion, use AsyncAsset.get()
  - loadMotionAsyncWithCache
```
public final AsyncMotion loadMotionAsyncWithCache(ReaderSettings settings)
                                           throws java.lang.IllegalStateException
```
    Load motion asynchronously using download cache
    
    Parameters:
    
    settings - ReaderSettings to load
    
    Returns:
    
    AsyncMotion
    
    Throws:
    
    java.lang.IllegalStateException - if motions is not set
    
    See Also:
    
    Cache
  - hasAsyncMotionLoaded
```
public final boolean hasAsyncMotionLoaded()
```
    Returns:
    
    true if at least an AsyncMotion has been loaded since last call of this method
  - readAndLoadTextures
```
@Deprecated
public final void readAndLoadTextures(IGL gl,
                                                   Model model)
```
    Deprecated.
    
    Read and load all textures of a model.
    This is a blocking operation (synchronous) and may stall opengl context / rendering, therefore it is deprecated.
  - readTextures
```
public final void readTextures(Model model)
```
    Synchronous texture read of all textures of the Model
    
    See Also:
    
    readTexturesAsync(Model)
  - readTexturesAsync
```
public final void readTexturesAsync()
                             throws java.lang.IllegalStateException
```
    Asynchronous read all textures in this AssetManager
    
    Throws:
    
    java.lang.IllegalStateException - if models is not set
  - readTexturesAsync
```
public final void readTexturesAsync(Model model)
```
    Asynchronous read all textures of the specified Model
  - readTextureAsync
```
public final void readTextureAsync(Texture texture,
                                   TextureParam textureParam)
```
    Asynchronous read textures specified
  - onLoad
```
public final void onLoad(Texture texture)
```
    Specified by:
    
    onLoad in interface OnLoadListener<Texture>
  - destroy
```
public final void destroy(IGL gl)
```
    Destroy AsyncModel/Texture/Shader with a reference count of 0, and all AsyncMotion, MaterialAdvanced
    
    See Also:
    
    #destroy(IGLApi, boolean)
  - destroy
```
public final void destroy(IGL gl,
                          boolean force)
```
    Destroy all assets if force set to true, if false equivalent to #destroy(IGLApi)
    
    See Also:
    
    #destroy(IGLApi)
  - onContextLost
```
public final void onContextLost()
```
    The be called when the OpenGL context has been lost
  - onContextLost
```
public final void onContextLost(Model model)
```
    Must be called after onContextLost()
    
    Parameters:
    
    model - discard renderer data. Also, if automatic asynchronous loading is used, according assets (texture and/or shader) will be reloaded
    
    See Also:
    
    onContextLost(), setReadTextureAsync(boolean), setShaderGenerator(ShaderGenerator)
  - getTextureFinder
```
public final Finder getTextureFinder()
```
  - getShaderFinder
```
public final Finder getShaderFinder()
```
  - loadShaders
```
public final void loadShaders()
```
  - loadShaders
```
public final void loadShaders(Model model)
```
  - generateShadersAsync
```
public final void generateShadersAsync(Model model)
                                throws java.lang.IllegalStateException
```
    Force asynchronous shader generation to the specified Model.
    Requires setShaderGenerator(ShaderGenerator) to be set.
    
    Parameters:
    
    model - Model to generate shader to
    
    Throws:
    
    java.lang.IllegalStateException
    
    See Also:
    
    setShaderGenerator(ShaderGenerator)
  - onMaterialChanged
```
public final void onMaterialChanged(Model model,
                                    MaterialStandard material)
```
    Internal use
    Notifies a MaterialStandard has a shader changed
  - onMaterialChanged
```
public final void onMaterialChanged(Mesh mesh,
                                    IMaterial material)
```
    Internal use
    Notifies a IMaterial has a changed in a Mesh

Class AssetManager

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

textures

shaders

models

motions

splines

materials

animGraphs

context

Constructor Detail

AssetManager

Method Detail

create

create

isWorking

setReadTextureAsync

isReadTextureAsync

setShaderGenerator

getShaderGenerator

loadModel

loadModelAsync

loadModelAsyncWithCache

hasAsyncModelLoaded

loadMotion

loadMotionAsync

loadMotionAsyncWithCache

hasAsyncMotionLoaded

readAndLoadTextures

readTextures

readTexturesAsync

readTexturesAsync

readTextureAsync

onLoad

destroy

destroy

onContextLost

onContextLost

getTextureFinder

getShaderFinder

loadShaders

loadShaders

generateShadersAsync

onMaterialChanged

onMaterialChanged