The View3D object manages all parameters and settings needed for rendering a three dimensional scene from one viewpoint. A view maintains a link to a Canvas3D that the view is rendered into. It exists outside of the scene graph, but attaches to a camera node object in the scene graph.
The View3D object is the main object for controlling the Xenon3D viewing model. All of the components that specify the view transform used to render to the Canvas3D are either contained in the View3D object or in objects that are referenced by it.
The View3D object has several propertes and methods, but most are calibration variables or user-helper functions. Most properties are affected by the Jogl rendering thread. Therefore, the setting of most properties can only be done from the Jogl rendering thread, in other words: from one of the callback methods of the RenderListener interface. Settings may be retrieved from any thread, though.
Note that the rendering process automatically starts as soon as a the View3D is attached to the Xenon3D object. By default, the rendering is only done whenever a paint event for the canvas occours. For most 3D applications, it will be more appropriate for the rendering to occour as fast as possible or at fixed time intervalls. Use the start() and stop() methods to turn fast rendering on or off.
@author Volker Everts
@version 0.1 - 13.08.2011: Created