org.web3d.vrml.renderer.ogl.browser
Class OGLStandardBrowserCore

java.lang.Object
  org.web3d.vrml.renderer.ogl.browser.OGLStandardBrowserCore

All Implemented Interfaces:

BrowserCore, EventModelInitListener, LayerRenderingManager

public class OGLStandardBrowserCore
extends java.lang.Object
implements BrowserCore, EventModelInitListener, LayerRenderingManager

Representation of a core of a browser implemented using the OpenGL rendering APIs.

The universe is responsible for handling the management of the viewpoints within a scene. VRML defines a single viewpoint model for multiple canvases. If we want to set this environment up for stereo rendering or CAVE type environments, the renderer will need to use a single view for all of them. If you are trying to perform multiple views of the scenegraph, such as an editor environment, this universe is not suitable as it uses a single View object and attaches all canvases to that view and hence the underlying currently bound viewpoint.

The universe is not responsible for loading VRML/X3D content. To handle anchors, it delegates to the supplied listener.

Version:

$Revision: 1.34 $

Author:

Justin Couch

Constructor Summary

OGLStandardBrowserCore(EventModelEvaluator eme, org.j3d.aviatrix3d.management.RenderManager sgm, org.j3d.aviatrix3d.management.DisplayCollection dc)
Construct a default, empty universe that contains no scenegraph.

Method Summary

void	addCoreListener(BrowserCoreListener l) Add a listener for browser core events.
void	addNavigationStateListener(NavigationStateListener l) Add a listener for navigation state changes.
void	addNodeObserver(int nodeType, NodeObserver obs) Add an observer for a specific node type.
void	addProfilingListener(ProfilingListener l) Request notification of profiling information.
void	addSensorStatusListener(SensorStatusListener l) Add a listener for sensor state changes.
void	addViewpointStatusListener(ViewpointStatusListener l) Add a listener for viewpoint status changes.
void	captureScreenEnd() Stop capturing the screen on each render.
void	captureScreenOnce(ScreenCaptureListener listener, int width, int height) Capture the screen on the next render.
void	captureScreenStart(ScreenCaptureListener listener, int width, int height) Capture the screen on each render.
void	changeViewpoint(VRMLViewpointNodeType vp) Request that this viewpoint object is bound at the start of the next frame.
void	changeWorld() Notification that its safe to clear the world.
void	clear() Force clearing all currently managed layers from this manager now.
void	dispose() Notify the core that it can dispose all resources.
void	fitToWorld(boolean animated) Move the user's location to see the entire world.
float	getCurrentFrameRate() Get the current frame rate of the browser in frames per second.
float	getCurrentSpeed() Get the current velocity of the bound viewpoint in meters per second.
java.util.Map	getDEFMappings() Get the mapping of DEF names to the node instances that they represent.
java.lang.String	getDescription() Get the description string currently used by the world.
org.j3d.aviatrix3d.management.DisplayCollection	getDisplayManager() Return the display manager
org.j3d.aviatrix3d.pipeline.graphics.GraphicsResizeListener[]	getGraphicsResizeListeners() Get the graphics resize listener instance used by this universe, when managing layers.
java.lang.String	getIDString() Get the ID string for this renderer.
int	getMinimumFrameInterval() Get the currently set minimum frame cycle interval.
int	getRendererType() Get the type of renderer that implements the browser core.
int	getRenderingStyle() Get the currently set rendering style.
int	getRenderingStyle(int layerId) Get the currently set rendering style for a specific layer.
VRMLScene	getScene() Get the scene that this universe is currently holding.
void	getUserPosition(javax.vecmath.Vector3f pos, javax.vecmath.AxisAngle4f ori) Get the user's location and orientation.
VRMLViewpointNodeType	getViewpoint() Get the currently selected viewpoint in the active navigation layer.
VRMLClock	getVRMLClock() Get the clock instance in use by the core.
VRMLExecutionSpace	getWorldExecutionSpace() Convenience method to ask for the execution space that the world is currently operating in.
java.lang.String	getWorldURL() Get the fully qualified URL of the currently loaded world.
void	removeCoreListener(BrowserCoreListener l) Remove a browser core listener.
void	removeNavigationStateListener(NavigationStateListener l) Remove a navigation state listener.
void	removeNodeObserver(int nodeType, NodeObserver obs) Remove the given node observer instance for the specific node type.
void	removeProfilingListener(ProfilingListener l) Remove notification of profiling information.
void	removeSensorStatusListener(SensorStatusListener l) Remove a sensor state listener.
void	removeViewpointStatusListener(ViewpointStatusListener l) Remove a viewpoint state listener.
void	sendURLFailEvent(java.lang.String msg) Send to the core listeners the error message that a URL failed to load for some reason.
void	setActiveLayers(LayerManager[] layers, int numLayers) Set the list of current layers that should be rendered.
void	setDescription(java.lang.String desc) Set the description of the current world.
void	setErrorReporter(ErrorReporter reporter) Register an error reporter with the engine so that any errors generated by the loading of script code can be reported in a nice, pretty fashion.
void	setEventModelStatusListener(EventModelStatusListener l) Set the eventModelStatus listener.
void	setHardwareFOV(float fov) Override the file field of view values with a value that suits the given output device.
void	setLastRenderTime(long lastTime) Set the last frame render time used for FPS calculations.
void	setMinimumFrameInterval(int millis, boolean userSet) Set the minimum frame interval time to limit the CPU resources taken up by the 3D renderer.
void	setNavigationMode(java.lang.String mode) Set the desired navigation mode.
void	setRenderingStyle(int style) Change the rendering style that the browser should currently be using for all layers.
void	setRenderingStyle(int style, int layerId) Change the rendering style that the browser should currently be using for for a specific layer.
void	setRenderOrder(int[] order, int numValid) Set the rendering order for all the layers on this manager
void	setScene(VRMLScene scene, java.lang.String viewpoint) Set the scene to use within this universe.
void	setStereoEnabled(boolean enabled) Set whether stereo is enabled for all layers.
void	shutdown() Shutdown the node manager now.
void	syncUIUpdates() Sync UI updates with the Application thread.
void	worldInitComplete() Notification from the event model evaluator that the initialization phase is now complete.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

OGLStandardBrowserCore

public OGLStandardBrowserCore(EventModelEvaluator eme,
                              org.j3d.aviatrix3d.management.RenderManager sgm,
                              org.j3d.aviatrix3d.management.DisplayCollection dc)

Construct a default, empty universe that contains no scenegraph.

Parameters:

eme - The class used to evaluate the event model

sgm - The manager of the scene graph

Method Detail

worldInitComplete

public void worldInitComplete()

Notification from the event model evaluator that the initialization phase is now complete. Use this to send off the external Browser init event.

Specified by:

worldInitComplete in interface EventModelInitListener

changeWorld

public void changeWorld()

Notification that its safe to clear the world. The underlying rendering layer should now be cleared and loaded with the world.

Specified by:

changeWorld in interface EventModelInitListener

getRendererType

public int getRendererType()

Get the type of renderer that implements the browser core. The only valid values returned are the constants in this interface.

Specified by:

getRendererType in interface BrowserCore

Returns:

The renderer type

getIDString

public java.lang.String getIDString()

Get the ID string for this renderer.

Specified by:

getIDString in interface BrowserCore

Returns:

The String token for this renderer.

setErrorReporter

public void setErrorReporter(ErrorReporter reporter)

Register an error reporter with the engine so that any errors generated by the loading of script code can be reported in a nice, pretty fashion. Setting a value of null will clear the currently set reporter. If one is already set, the new value replaces the old.

Specified by:

setErrorReporter in interface BrowserCore

Specified by:

setErrorReporter in interface LayerRenderingManager

Parameters:

reporter - The instance to use or null

setMinimumFrameInterval

public void setMinimumFrameInterval(int millis,
                                    boolean userSet)

Set the minimum frame interval time to limit the CPU resources taken up by the 3D renderer. By default it will use all of them. The second parameter is used to control whether this is a user-set hard minimum or something set by the browser internals. User set values are always treated as the minimum unless the browser internals set a value that is a slower framerate than the user set. If the browser then sets a faster framerate than the user set value, the user value is used instead.

Specified by:

setMinimumFrameInterval in interface BrowserCore

Parameters:

millis - The minimum time in milleseconds.

userSet - true if this is an end-user set minimum

getMinimumFrameInterval

public int getMinimumFrameInterval()

Get the currently set minimum frame cycle interval. Note that this is the minimum interval, not the actual frame rate. Heavy content loads can easily drag this down below the max frame rate that this will generate.

Specified by:

getMinimumFrameInterval in interface BrowserCore

Returns:

The cycle interval time in milliseconds

getVRMLClock

public VRMLClock getVRMLClock()

Get the clock instance in use by the core. We need this for when new nodes are added to the scene to make sure they are all appropriately configured.

Specified by:

getVRMLClock in interface BrowserCore

Returns:

The clock used by the browser core

getDEFMappings

public java.util.Map getDEFMappings()

Get the mapping of DEF names to the node instances that they represent. Primarily used for the EAI functionality. The map instance changes each time a new world is loaded so will need to be re-fetched. If no mappings are available (eg scripting replaceWorld() type call) then the map will be empty.

Specified by:

getDEFMappings in interface BrowserCore

Returns:

The current mapping of DEF names to node instances

getWorldExecutionSpace

public VRMLExecutionSpace getWorldExecutionSpace()

Convenience method to ask for the execution space that the world is currently operating in. Sometimes this is not known, particularly if the end user has called a loadURL type function that is asynchronous. This will change each time a new scene is loaded.

Specified by:

getWorldExecutionSpace in interface BrowserCore

Returns:

The current world execution space.

getDescription

public java.lang.String getDescription()

Get the description string currently used by the world. Returns null if not set or supported.

Specified by:

getDescription in interface BrowserCore

Returns:

The current description string or null

setDescription

public void setDescription(java.lang.String desc)

Set the description of the current world. If the world is operating as part of a web browser then it shall attempt to set the title of the window. If the browser is from a component then the result is dependent on the implementation

Specified by:

setDescription in interface BrowserCore

Parameters:

desc - The description string to set.

getCurrentSpeed

public float getCurrentSpeed()

Get the current velocity of the bound viewpoint in meters per second. The velocity is defined in terms of the world values, not the local coordinate system of the viewpoint.

Specified by:

getCurrentSpeed in interface BrowserCore

Returns:

The velocity in m/s or 0.0 if not supported

getCurrentFrameRate

public float getCurrentFrameRate()

Get the current frame rate of the browser in frames per second.

Specified by:

getCurrentFrameRate in interface BrowserCore

Returns:

The current frame rate or 0.0 if not supported

setLastRenderTime

public void setLastRenderTime(long lastTime)

Set the last frame render time used for FPS calculations. Only the per frame mamanger should call this.

Specified by:

setLastRenderTime in interface BrowserCore

Parameters:

lastTime - The time it took to render the last frame in milliseconds.

setEventModelStatusListener

public void setEventModelStatusListener(EventModelStatusListener l)

Set the eventModelStatus listener.

Specified by:

setEventModelStatusListener in interface BrowserCore

Parameters:

l - The listener. Null will clear it.

addNavigationStateListener

public void addNavigationStateListener(NavigationStateListener l)

Add a listener for navigation state changes. A listener can only be added once. Duplicate requests are ignored.

Specified by:

addNavigationStateListener in interface BrowserCore

Parameters:

l - The listener to add

removeNavigationStateListener

public void removeNavigationStateListener(NavigationStateListener l)

Remove a navigation state listener. If the reference is null or not known, the request is silently ignored.

Specified by:

removeNavigationStateListener in interface BrowserCore

Parameters:

l - The listener to remove

addSensorStatusListener

public void addSensorStatusListener(SensorStatusListener l)

Add a listener for sensor state changes. A listener can only be added once. Duplicate requests are ignored.

Specified by:

addSensorStatusListener in interface BrowserCore

Parameters:

l - The listener to add

removeSensorStatusListener

public void removeSensorStatusListener(SensorStatusListener l)

Remove a sensor state listener. If the reference is null or not known, the request is silently ignored.

Specified by:

removeSensorStatusListener in interface BrowserCore

Parameters:

l - The listener to remove

addViewpointStatusListener

public void addViewpointStatusListener(ViewpointStatusListener l)

Add a listener for viewpoint status changes. A listener can only be added once. Duplicate requests are ignored.

Specified by:

addViewpointStatusListener in interface BrowserCore

Parameters:

l - The listener to add

removeViewpointStatusListener

public void removeViewpointStatusListener(ViewpointStatusListener l)

Remove a viewpoint state listener. If the reference is null or not known, the request is silently ignored.

Specified by:

removeViewpointStatusListener in interface BrowserCore

Parameters:

l - The listener to remove

addNodeObserver

public void addNodeObserver(int nodeType,
                            NodeObserver obs)

Add an observer for a specific node type. A single instance may be registered for more than one type. Each type registered will result in a separate call per frame - one per type. If the observer is currently added for this type ID, the request is ignored.

Specified by:

addNodeObserver in interface BrowserCore

Parameters:

nodeType - The type identifier of the node being observed

obs - The observer instance to add

removeNodeObserver

public void removeNodeObserver(int nodeType,
                               NodeObserver obs)

Remove the given node observer instance for the specific node type. It will not be removed for any other requested node types. If the instance is not registered for the given node type ID, the request will be silently ignored.

Specified by:

removeNodeObserver in interface BrowserCore

Parameters:

nodeType - The type identifier of the node being observed

obs - The observer instance to remove

dispose

public void dispose()

Notify the core that it can dispose all resources. The core cannot be used for rendering after that.

Specified by:

dispose in interface BrowserCore

getWorldURL

public java.lang.String getWorldURL()

Get the fully qualified URL of the currently loaded world. This returns the entire URL including any possible arguments that might be associated with a CGI call or similar mechanism. If the initial world is replaced with loadURL then the string will reflect the new URL. If replaceWorld is called then the URL still represents the original world.

Specified by:

getWorldURL in interface BrowserCore

Returns:

A string of the URL or null if not supported.

setScene

public void setScene(VRMLScene scene,
                     java.lang.String viewpoint)

Set the scene to use within this universe. If null, this will clear this scene and de-register all listeners. The View will be detached from the ViewPlatform and therefore the canvas will go blank.

Specified by:

setScene in interface BrowserCore

Parameters:

scene - The new scene to load, or null

viewpoint - The viewpoint.description to bind to or null for default

changeViewpoint

public void changeViewpoint(VRMLViewpointNodeType vp)

Request that this viewpoint object is bound at the start of the next frame. This method should only be called by external users such as UI toolkits etc that need to synchronize the viewpoint change with rendering loop, but are not able to synchronize themselves because they exist on a different thread that cannot block.

Specified by:

changeViewpoint in interface BrowserCore

Parameters:

vp - The new viewpoint instance to bind to

addCoreListener

public void addCoreListener(BrowserCoreListener l)

Add a listener for browser core events. These events are used to notify all listeners of internal structure changes, such as the browser starting and stopping. A listener can only be added once. Duplicate requests are ignored.

Specified by:

addCoreListener in interface BrowserCore

Parameters:

l - The listener to add

removeCoreListener

public void removeCoreListener(BrowserCoreListener l)

Remove a browser core listener. If the reference is null or not known, the request is silently ignored.

Specified by:

removeCoreListener in interface BrowserCore

Parameters:

l - The listener to remove

addProfilingListener

public void addProfilingListener(ProfilingListener l)

Request notification of profiling information.

Specified by:

addProfilingListener in interface BrowserCore

Parameters:

l - The listener

removeProfilingListener

public void removeProfilingListener(ProfilingListener l)

Remove notification of profiling information.

Specified by:

removeProfilingListener in interface BrowserCore

Parameters:

l - The listener

sendURLFailEvent

public void sendURLFailEvent(java.lang.String msg)

Send to the core listeners the error message that a URL failed to load for some reason. This is for the EAI/ESAI spec conformance.

Specified by:

sendURLFailEvent in interface BrowserCore

Parameters:

msg - The message to send

setNavigationMode

public void setNavigationMode(java.lang.String mode)

Set the desired navigation mode. The mode string is one of the spec-defined strings for the NavigationInfo node in the VRML/X3D specification.

Specified by:

setNavigationMode in interface BrowserCore

Parameters:

mode - The requested mode.

getUserPosition

public void getUserPosition(javax.vecmath.Vector3f pos,
                            javax.vecmath.AxisAngle4f ori)

Get the user's location and orientation. This will use the viewpoint bound in the active layer.

Parameters:

pos - The current user position

ori - The current user orientation

fitToWorld

public void fitToWorld(boolean animated)

Move the user's location to see the entire world. Change the users orientation to look at the center of the world.

Specified by:

fitToWorld in interface BrowserCore

Parameters:

animated - Should the transistion be animated. Defaults to FALSE.

syncUIUpdates

public void syncUIUpdates()

Sync UI updates with the Application thread. This method alls the core to push work off to the app thread.

Specified by:

syncUIUpdates in interface BrowserCore

setRenderingStyle

public void setRenderingStyle(int style)
                       throws java.lang.IllegalArgumentException

Change the rendering style that the browser should currently be using for all layers. Various options are available based on the constants defined in this interface.

Specified by:

setRenderingStyle in interface BrowserCore

Specified by:

setRenderingStyle in interface LayerRenderingManager

Parameters:

style - One of the RENDER_* constants

Throws:

java.lang.IllegalArgumentException - A style constant that is not recognized by the implementation was provided

See Also:

Xj3DConstants

getRenderingStyle

public int getRenderingStyle()

Get the currently set rendering style. The default style is RENDER_SHADED.

Specified by:

getRenderingStyle in interface BrowserCore

Specified by:

getRenderingStyle in interface LayerRenderingManager

Returns:

one of the RENDER_ constants

See Also:

Xj3DConstants

setRenderingStyle

public void setRenderingStyle(int style,
                              int layerId)
                       throws java.lang.IllegalArgumentException

Change the rendering style that the browser should currently be using for for a specific layer. Various options are available based on the constants defined in this interface.

Specified by:

setRenderingStyle in interface LayerRenderingManager

Parameters:

style - One of the RENDER_* constants

layerId - The ID of the layer that should have the style changed

Throws:

java.lang.IllegalArgumentException - A style constant that is not recognized by the implementation was provided

See Also:

Xj3DConstants

getRenderingStyle

public int getRenderingStyle(int layerId)

Get the currently set rendering style for a specific layer. The default style is RENDER_SHADED.

Specified by:

getRenderingStyle in interface LayerRenderingManager

Returns:

one of the RENDER_ constants

See Also:

Xj3DConstants

setActiveLayers

public void setActiveLayers(LayerManager[] layers,
                            int numLayers)

Set the list of current layers that should be rendered.

Specified by:

setActiveLayers in interface LayerRenderingManager

Parameters:

layers - The list of layer managers to be rendered

numLayers - The number of active items in the list

setRenderOrder

public void setRenderOrder(int[] order,
                           int numValid)

Set the rendering order for all the layers on this manager

Specified by:

setRenderOrder in interface LayerRenderingManager

Parameters:

order - The index of the list of rendered layers ids

numValid - The number of valid items in the order list

shutdown

public void shutdown()

Shutdown the node manager now. If this is using any external resources it should remove those now as the entire application is about to die

Specified by:

shutdown in interface LayerRenderingManager

clear

public void clear()

Force clearing all currently managed layers from this manager now. This is used to indicate that a new world is about to be loaded and everything should be cleaned out now.

Specified by:

clear in interface LayerRenderingManager

getDisplayManager

public org.j3d.aviatrix3d.management.DisplayCollection getDisplayManager()

Return the display manager

Returns:

The DisplayCollection object

captureScreenOnce

public void captureScreenOnce(ScreenCaptureListener listener,
                              int width,
                              int height)

Capture the screen on the next render.

Parameters:

listener - Listener for capture results

width - The screen width

height - The screen height

captureScreenStart

public void captureScreenStart(ScreenCaptureListener listener,
                               int width,
                               int height)

Capture the screen on each render.

Parameters:

listener - Listener for capture results

width - The screen width

height - The screen height

captureScreenEnd

public void captureScreenEnd()

Stop capturing the screen on each render.

getGraphicsResizeListeners

public org.j3d.aviatrix3d.pipeline.graphics.GraphicsResizeListener[] getGraphicsResizeListeners()

Get the graphics resize listener instance used by this universe, when managing layers. The listener can be registered with the drawing surfac and used to control the viewport layers internally generated. This instance does not change over time.

Returns:

The listener instance used internally

setHardwareFOV

public void setHardwareFOV(float fov)

Override the file field of view values with a value that suits the given output device. A value of 0 = no, otherwise use this instead of content

Parameters:

fov - The fov in degrees.

setStereoEnabled

public void setStereoEnabled(boolean enabled)

Set whether stereo is enabled for all layers.

getScene

public VRMLScene getScene()

Get the scene that this universe is currently holding. If none is set then null is returned.

Returns:

The currently set scene instance

getViewpoint

public VRMLViewpointNodeType getViewpoint()

Get the currently selected viewpoint in the active navigation layer. If there is no scene set then this returns null.

Returns:

The current active viewpoint