org.j3d.renderer.aviatrix3d.navigation (Aviatrix3d Library 3.0.0)

Interface Summary
Interface	Description
CollisionListener	A listener interface used to notify of a collision between the user position and geometry in the scene.
FrameUpdateListener	A listener interface used internally to notify of an update or change in the system that will effect the display.

Class Summary
Class	Description
AVViewpointData	A class to represent viewpoint information so that we can put it on screen, move around to it etc etc.
ViewpointManager	A handler for viewpoint information for a given canvas.
ViewpointTransition	This class will create smooth transitions from one viewpoint to another.

Package org.j3d.renderer.aviatrix3d.navigation Description

User interface components and capabilities for implementing simple navigation on any Aviatrix3D DrawableSurface based on the core org.j3d.ui.navigation package.

A set of convenience toolbars are provided that interact with the normal world. These use images from the config area in the navigation sub-directory. Once this code is working nicely, some examples and nice looking pictures will be added here.

Implementation Details

There are a collection of different implementation items within this package. Mostly this is just general run of the mill listener handling and event propogation. There are two major algorithms to be interested in - the terrain following/collision detection code and the mouse movement methods.

A complete tutorial and write up of the terrain following code can be found on the j3d.org Collision Detection Tutorial and further information in the j3d.org Code Repository Navigation Implementation document.

Acknowledgements

This code is based on the work of the Halden VR Centre, Institute for Energy Technology. The code provided from them has been cleaned up dramatically and made more suitable to use as a general library. Regardless, many thanks go to Laszlo Seregi and the team there for providing this codebase!