Xj3D 2.0 VRML/X3D Code API

Package org.xj3d.loaders.ogl

Implementations of Aviatrix3D file loaders for Web3D file formats.

See:
          Description

Class Summary
BaseLoader Common base implementation Aviatrix3D file loader implementation for reading loading files and building a Aviatrix3D scenegraph with them.
NullLayerManagerFactory Layer manager factory instance that creates null layers handlers.
VRML97Loader A Java3D file loader implementation for reading VRML97 utf8 files only and building a Java3D scenegraph with them.
Web3DLoader A Aviatrix3D file loader implementation for reading all Web3D file formats building a scenegraph with them.
X3DLoader A Java3D file loader implementation for reading X3D utf8 files only and building a Java3D scenegraph with them.
Xj3DClockRuntime Implementation of the org.j3d.renderer.aviatrix3d.loaders.AVRuntimeComponent that can be used to drive the X3D/VRML scene graph clock.
 

Package org.xj3d.loaders.ogl Description

Implementations of Aviatrix3D file loaders for Web3D file formats.

All the files available here implement the org.j3d.renderer.aviatrix3d.loader.AVLoader interface. For more information on how to use loaders, see the How to use the Loader page at aviatrix.j3d.org.

The loaders have two very different code paths depending on what you want to do. If you need just static geometry then the loader will perform a blocking load call and will not return until all of the world file is loaded. If the world contains inlines then in will recurse into these and load them too before returning to the caller. It will also disable all runtime aspects of the scene. Scripts will have their initialize() method called, but nothing will be done with the script or any changes it may make to the scene graph. If you have a proto that depends on the script's initialize() method to build geometry, you will not see it happen.

If you want the full runtime model of VRML/X3D as part of your loading process, then you need to make sure you at least have the RUNTIMES flag set. This will start up the full execution model and the content of the script will run as normal. All user interaction will be applied, but due to the limitations of the loader, things may not really function correctly. For example, clicking on an Anchor node will not do anything, nor will viewpoint binding. Also, by default, the navigation code is turned off. This is because we are assuming that the user will probably use this to load multiple files over time or even simultaneously. If the navigation code is running, each loaded file will be fighting for the mouse events, control of the view and picking. Put a few of these into a single scene simultanouesly, and there is no telling what will happen!


Xj3D 2.0 VRML/X3D Code API

Copyright © 2001 - 2006 Web3D Consortium