com.sun.tv.media

Class MediaClock

java.lang.Object

com.sun.tv.media.MediaClock

All Implemented Interfaces:

Clock

public class MediaClock
extends Object
implements Clock

This class is a part of the porting layer implementation for JavaTV MediaClock implements javax.media.Clock. This is not a running thread that implements the clock ticks. It just implements the math and maintains the correct states to perform the computations from media-time to time-base-time.

Version:

1.16, 98/10/29

Field Summary

Fields inherited from interface javax.media.Clock

RESET

Constructor Summary

Constructors

Constructor and Description
MediaClock() constructs a MediaClock

Method Summary

Methods

Modifier and Type	Method and Description
long	getMediaNanoseconds() Get the current media time in nanoseconds.
Time	getMediaTime() Return the current media time.
float	getRate() Get the current presentation speed.
protected int	getState() Return the current state of the clock in either started or stopped state.
Time	getStopTime() Return the preset stop time.
Time	getSyncTime() Return the Sync Time.
TimeBase	getTimeBase() Get the Time Base that the clock is currently using.
Time	mapToTimeBase(Time t) Map the the given media-time to time-base-time.
protected void	setMediaLength(long t) Set the upper bound of the media time.
protected void	setMediaStart(long t) Set the lower bound of the media time.
void	setMediaTime(Time now) Set the media time.
float	setRate(float factor) Set the rate of presentation: 1.0: normal, 2.0: twice the speed.
void	setStopTime(Time t) Preset a stop time in media time.
void	setTimeBase(TimeBase master) Set a time base on the clock.
void	stop() Stop the clock immediately.
void	syncStart(Time tbt) Start the clock with the given time-base-time
protected long	validateTime(long t) Check the time and restricted to not go beyond the duration of the media.

Methods inherited from class java.lang.Object

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

Constructor Detail

MediaClock

public MediaClock()

constructs a MediaClock

Method Detail

setTimeBase

public void setTimeBase(TimeBase master)
                 throws IncompatibleTimeBaseException

Set a time base on the clock. All media-time to time-base-time will be computed with the given time base.

Specified by:

setTimeBase in interface Clock

Parameters:

master - the new master time base.

Throws:

IncompatibleTimeBaseException - thrown if clock cannot accept the given time base.

syncStart

public void syncStart(Time tbt)

Start the clock with the given time-base-time

Specified by:

syncStart in interface Clock

Parameters:

the - time base time to start the clock.

stop

public void stop()

Stop the clock immediately.

Specified by:

stop in interface Clock

setStopTime

public void setStopTime(Time t)

Preset a stop time in media time.

Specified by:

setStopTime in interface Clock

Parameters:

t - the preset stop time.

getStopTime

public Time getStopTime()

Return the preset stop time.

Specified by:

getStopTime in interface Clock

Returns:

the preset stop time.

setMediaTime

public void setMediaTime(Time now)

Set the media time. This will be the media presented at the clock's start time.

Specified by:

setMediaTime in interface Clock

Parameters:

the - media time to set to.

getMediaTime

public Time getMediaTime()

Return the current media time.

Specified by:

getMediaTime in interface Clock

Returns:

the current media time.

getMediaNanoseconds

public long getMediaNanoseconds()

Get the current media time in nanoseconds.

Specified by:

getMediaNanoseconds in interface Clock

Returns:

the current media time in nanoseconds.

setMediaStart

protected void setMediaStart(long t)

Set the lower bound of the media time.

Parameters:

t - the lower bound of the media time.

setMediaLength

protected void setMediaLength(long t)

Set the upper bound of the media time.

Parameters:

t - the upper bound of the media time.

validateTime

protected long validateTime(long t)

Check the time and restricted to not go beyond the duration of the media.

Returns:

the given time within the valid boundary.

getState

protected int getState()

Return the current state of the clock in either started or stopped state.

Returns:

the current clock state.

getSyncTime

public Time getSyncTime()

Return the Sync Time. Not yet implementated.

Specified by:

getSyncTime in interface Clock

getTimeBase

public TimeBase getTimeBase()

Get the Time Base that the clock is currently using.

Specified by:

getTimeBase in interface Clock

Returns:

the Time Base that the clock is currently using.

mapToTimeBase

public Time mapToTimeBase(Time t)
                   throws ClockStoppedException

Map the the given media-time to time-base-time.

Specified by:

mapToTimeBase in interface Clock

Parameters:

t - media time

Returns:

time base time.

Throws:

ClockStoppedException - is thrown if this method is invoked on a stopped clock.

setRate

public float setRate(float factor)

Set the rate of presentation: 1.0: normal, 2.0: twice the speed. -2.0: twice the speed in reverse.

Specified by:

setRate in interface Clock

Parameters:

the - speed factor.

Returns:

the actual rate the clock is set to.

getRate

public float getRate()

Get the current presentation speed.

Specified by:

getRate in interface Clock

Returns:

the current presentation speed.