Package org.xj3d.impl.core.eventmodel

Class RealTimeSensorManager

java.lang.Object

org.xj3d.impl.core.eventmodel.RealTimeSensorManager

All Implemented Interfaces:

VRMLClock, TimeSensorManager

public class RealTimeSensorManager
extends Object
implements TimeSensorManager

Generalised manager for time sensor nodes that also represents the VRMLClock.

Another problem is dealing with Java time. On Win32 boxes the accuracy is pretty fucked - 10ms at best on an NT/2K box. The result is that we get this behaviour called every frame and we have no way of dealing with the fact that time has not advanced at all according to the system clock. One way of doing this is looking for the last time, checking the difference and then incrementing by a very small amount (say 1ms). This should give accuracy up to about 100Hz frame rate. How we go when it runs faster than that, I have no idea. Jump up and down and bitch to Sun about it.

During each time click we first call the listeners for time information with the current time.

Time management exists on two levels. The timesensor can be enabled and disabled like any other behavior. This allows the user to pause the play back or just halt in mid-stream. The other part allows the user to reset the time clock so that we can start at time zero again. This allows the replaying of a world from the time zero independently of the enable - for example, loading a new world into a browser and keeping the same clock instance.

Version:

$Revision: 1.2 $

Author:

Justin Couch

Constructor Summary

Constructors

Constructor	Description
RealTimeSensorManager()	Create a new time scheduler behaviour

Method Summary

Modifier and Type	Method	Description
void	addTimeListener(VRMLTimeListener l)	Add a time listener to this clock.
void	clear()	Force clearing all state from this manager now.
void	clockTick(long time)	Process the event that builds the current time.
double	getTime()	Request the current time from the system clock.
long	getWallTime()	Request the time in wall-clock coordinates.
void	removeTimeListener(VRMLTimeListener l)	Remove a time listener to this clock.
void	resetTimeZero()	Reset the clock to the current time as time zero.
void	setErrorReporter(org.j3d.util.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.

Methods inherited from class java.lang.Object

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

Constructor Details

RealTimeSensorManager

public RealTimeSensorManager()

Create a new time scheduler behaviour

Method Details

getTime

public double getTime()

Request the current time from the system clock. The time returned is the VRML scene time.

Specified by:

getTime in interface VRMLClock

Returns:

The current time in VRML coodinates

getWallTime

public long getWallTime()

Request the time in wall-clock coordinates. This is standard Unix epoch time.

Specified by:

getWallTime in interface VRMLClock

Returns:

The current wall-clock time

resetTimeZero

public void resetTimeZero()

Reset the clock to the current time as time zero. This can only be called when the timer is not enabled. The last wall clock time is set to now so that fraction information will be correctly oriented for the next time it is enabled called to issue a clock tick.

Specified by:

resetTimeZero in interface VRMLClock

addTimeListener

public void addTimeListener(VRMLTimeListener l)

Add a time listener to this clock. Only one instance of each listener will be registered and null references are ignored.

Specified by:

addTimeListener in interface VRMLClock

Parameters:

l - The listener instance to add

removeTimeListener

public void removeTimeListener(VRMLTimeListener l)

Remove a time listener to this clock. If the listener is not known to this implementation, it is silently ignored.

Specified by:

removeTimeListener in interface VRMLClock

Parameters:

l - The listener instance to add

setErrorReporter

public void setErrorReporter(org.j3d.util.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 TimeSensorManager

Parameters:

reporter - The instance to use or null

clockTick

public void clockTick(long time)

Process the event that builds the current time.

Specified by:

clockTick in interface TimeSensorManager

Parameters:

time - The current clock cycle time in milliseconds

clear

public void clear()

Force clearing all state 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 TimeSensorManager