net.dzzd.access
Interface IScene3DLoader

All Superinterfaces:

IMonitoredSceneObject, IScene2DLoader, ISceneLoader

public interface IScene3DLoader

extends IScene2DLoader

Used for accessing to a Scene3DLoader.

Since:

1.0

Version:

1.0, 24/07/2007

Author:

Bruno Augier

See Also:

IScene3D

Method Summary

IScene3DObject[]	getScene3DObjects() Gets an array of all Scene3dObject loaded by this Scene3DLoader
void	loadScene3D(java.lang.String baseURL, java.lang.String file) Asynchroneously load a scene3D from a file using an URL.
void	loadScene3D(java.lang.String baseURL, java.lang.String file, java.lang.String ressourcePath) Asynchroneously load a scene3D from a file using an URL.

Methods inherited from interface net.dzzd.access.ISceneLoader

getMaterials, getSceneObjects, getTextures

Methods inherited from interface net.dzzd.access.IMonitoredSceneObject

copy

Method Detail

loadScene3D

public void loadScene3D(java.lang.String baseURL,
                        java.lang.String file)

Asynchroneously load a scene3D from a file using an URL.
this method can load 3d file from a network or a file.

external scene files, as textures files, are expected to be at the same baseURL location.
if none use : loadScene3D(String baseURL,String file,String ressourcPath) instead

loading sample:
loadScene3D("http://myserver.com/","my3dsfile.3ds");

this function will return immediadly and loading state will be accessible via monitored objects.


it is possible to load multiple 3ds file if needed

each loaded 3ds file will create a root mesh object with the 3ds file name as its name

loading sample:
loadScene3D("http://myserver.com/","my3dsfile.3ds");
loadScene3D("http://myserver.com/","myobjfile2.obj");
.....once loaded, you can do the following to get the root object of all 3d object of one of the loaded file.
getMesh3DByName("my3dsfile.3ds");
or
getMesh3DByName("myobjfile2.3ds");

Parameters:

baseURL - the base URL location.

file - the file name.

loadScene3D

public void loadScene3D(java.lang.String baseURL,
                        java.lang.String file,
                        java.lang.String ressourcePath)

Asynchroneously load a scene3D from a file using an URL.
this method can load 3d file from a network or a file.



loading sample:
loadScene3D("http://myserver.com/","my3dsfile.3ds");

this function will return immediadly and loading state will be accessible via monitored objects.


it is possible to load multiple 3ds file if needed

each loaded 3ds file will create a root mesh object with the 3ds file name as its name

loading sample:
loadScene3D("http://myserver.com/","my3dsfile.3ds");
loadScene3D("http://myserver.com/","myobjfile2.obj");
.....once loaded, you can do the following to get the root object of all 3d object of one of the loaded file.
getMesh3DByName("my3dsfile.3ds");
or
getMesh3DByName("myobjfile2.3ds");

Parameters:

baseURL - the base URL location.

file - the file name.

getScene3DObjects

public IScene3DObject[] getScene3DObjects()

Gets an array of all Scene3dObject loaded by this Scene3DLoader

Returns:

an array containing all Scene3DObject loaded (null if none)