All Packages  Class Hierarchy  Index

User's Guide and Notes

L3DObserver
This L3DObserver class is a Java interface class designed to provide callbacks from Live3D to the Java applet or JavaScript script. In order to use any of the callbacks outlined in this class, you must implement the advise method outlined in the L3DScene class. In addition, although you may not need to use all of the various interface callbacks available, all must be defined within the context of the applet due to the nature of the Java interface class. If not, a compiler error will result. The defined methods can simply return zero. (see Observer Example for a simple demonstration of this).

L3DMath
The L3DMath class is simply a series of general math and vector math functions that are particularly applicable to those developers working with 3D. They are intended to complement the Math class provided with the basic Java Developers Kit (JDK). Use of these classes requires a Live3D plugin be active at the time, so you would not be able to use these methods with other Java applets unless a 3D scene is currently active.

L3DObject
The L3DObject class can be considered the "Meat and Potatoes" of the Live3D Java API. This class works on shape nodes and group nodes. These are defined by the VRML 1.0 spec as follows:

Shape Nodes: AsciiText, Cone, Cube, Cylinder, IndexedFaceSet, IndexedLineSet, PointSet, Sphere
Group Nodes: Group, Separator, Switch, TransformSeparator, WWWAnchor

These nodes must be DEF'd in order to be identified by the L3DScene getObject method. (See Object Example and its associated .wrl file for a simple demonstration of this).

L3DScene
The L3DScene class is designed to access methods that affect the entire scene, to identify the scene itself or nodes within the scene, and to access the camera (viewpoint). It is through this class that the plug-in itself is identified by the applet or JavaScript and therefore is necessary to utilize any of the other objects/methods described above. (Users of early alpha versions of the API had a L3DPlugin class which has been replaced by this class).

HELPFUL HINTS

• To reload a Java applet scene, hit <SHIFT> RELOAD to reload and re-initialize an applet. If RELOAD is used without the <SHIFT> key, the VRML scene will reload and the applet will not receive the updated pointers necessary to access the scene. In other words, it won't work. This does not apply to JavaScript scenes which reload in their entirety on a regular reload.
• If a scene does not work, always check the Java Console (located under Options on the Navigator menu bar). Their is some debugging print calls that can be used to track movement in the program and also Java errors are printed in the console.
• If you receive a "mayscript not enabled" or similar error, <SHIFT> RELOAD the scene. If it still fails to operate, shut down and restart Navigator.
• If the applet does not run and no errors are displayed, shut down and restart Navigator.
• Use v1.0 of the Java Developers Kit from Sun for compiling. Use of an earlier version or one of the optimized compilers designed for some of the development environments (Symantec Cafe or Borland for example) may not work correctly.
• For the latest information, check out the Live3D Website.