javax.realtime
Class HighResolutionClock

java.lang.Object
  javax.realtime.Clock
      javax.realtime.HighResolutionClock

public class HighResolutionClock

extends Clock

This class provide an high resolution clock. The resolution is the same as the clock speed at which the processor is running, on Pentium processors.

Author:

Angelo Corsaro

Constructor Summary

HighResolutionClock()

Method Summary

RelativeTime	clockTickToTime(long clockTicks)
void	clockTickToTime(long ticks, RelativeTime time)
RelativeTime	getEpochOffset() Gets the relative time of the offset of the epoch of this Clock from the Epoch.
RelativeTime	getResolution() Return the resolution of the clock -- the interval between ticks.
AbsoluteTime	getTime() Return the current time in a freshly allocated object.
AbsoluteTime	getTime(AbsoluteTime time) Return the current time in an existing object.
static HighResolutionClock	instance()
void	setResolution(RelativeTime resolution) Set the resolution of this.

Methods inherited from class javax.realtime.Clock

getRealtimeClock

Methods inherited from class java.lang.Object

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

Constructor Detail

HighResolutionClock

public HighResolutionClock()

Method Detail

instance

public static HighResolutionClock instance()

getEpochOffset

public RelativeTime getEpochOffset()

Gets the relative time of the offset of the epoch of this Clock from the Epoch. This clock implementation returns RelativeTime(0,0) in accordance with the spec.

Specified by:

getEpochOffset in class Clock

Returns:

a newly-allocated RelativeTime object representing the offset of the epoch; the returned object is associated with this Clock

Since:

0.4.0

getResolution

public RelativeTime getResolution()

Return the resolution of the clock -- the interval between ticks.

Specified by:

getResolution in class Clock

Returns:

A RelativeTime object representing the resolution of this.

setResolution

public void setResolution(RelativeTime resolution)

Set the resolution of this. For some hardwhere clocks setting resolution impossible and if called on those nothing happens.

Implementation Note: If the requested resolution overceeds the one obtainable by the underlying hardware this method guarantees that the finest resolution possible is set.

Specified by:

setResolution in class Clock

Parameters:

resolution - The new resolution of this.

getTime

public AbsoluteTime getTime()

Return the current time in a freshly allocated object.

Specified by:

getTime in class Clock

Returns:

An AbsoluteTime object representing the current time.

getTime

public AbsoluteTime getTime(AbsoluteTime time)

Return the current time in an existing object. The time represented by the given AbsoluteTime is changed some time between the invocation of the method and the return of the method.

Specified by:

getTime in class Clock

Parameters:

time - The AbsoluteTime object which will have its time changed.

Returns:

time

clockTickToTime

public RelativeTime clockTickToTime(long clockTicks)

clockTickToTime

public void clockTickToTime(long ticks,
                            RelativeTime time)