Scene Graph Structure

When it starts up mjbWorld creates a defualt scene graph under which the user can add their own structure consisting of whatever groups, shapes, etc. that they need to use.

This default scene graph provides a basic set of functionality so that the user does not need to wory about the basic infrastructure. This includes a view, a light and various handles, bounding boxes and pick behaviors to allow the user to manipulate the objects. If the application being built does not require these objects they can be edited out of the source code, but it may be worthwhile to keep them in while the program is being constructed to help build any 3D objects that will be needed

---

Tree Control

So there are two parallel trees, in most cases a node in the Scene Graph is paired with an instance of a mjbWorld class (with a name ending with 'Bean'). At the root of the tree some 'short cut' links have been added. For example a link has been added so that the user can go straight to the scene without having to drill down though the localle, branchgroup, etc.

The following diagrams shows how the classes are typically instanciated as the program is running. The classes on the right are the java3D scenegraph structure, on the left is the parallel customised structure to hold data specific to this program. The two structures are cross-linked.

---

rootBean

rootBean is the corresponding class to VirtualUniverse in the scene graph structure.

rootBean is at the top of the hierachy and below it is localeBean

Classes written for this program

Java3D classes (scene graph structure)

---

localeBean

x

---

viewplatformBean

This

Classes written for this program

Java3D classes (scene graph structure)

---

Model Interface

x

---

Java3D Modes used

mjbWorld supports the various Java3D modes:

Immediate Mode In this mode shapes can be drawn individually by calling GraphicsContext3D.draw(Geometry geometry). This is used by the program to draw the control points, see below.	Pure Immediate Mode
	Mixed Immediate Mode
Retained Mode to use this mode attach branch group to locale making it live.	Retained Mode
	Compiled-Retained Mode to use this mode compile branch group - by pressing compile button

 

 

go back to Programmers guide main index