com.sun.media.amovie

Class AMController

java.lang.Object

com.sun.tv.media.MediaController

com.sun.media.amovie.AMController

All Implemented Interfaces:

EventListener, Clock, Controller, ControllerListener, Duration

public class AMController
extends MediaController

Controller for Active Movie based MPEG player.

Field Summary

Fields

Modifier and Type	Field and Description
protected Time	eomDuration
protected static int	TRYSET_CANT
protected static int	TRYSET_DONE
protected static int	TRYSET_PASTEOM

Fields inherited from class com.sun.tv.media.MediaController

parent, state

Fields inherited from interface javax.media.Controller

LATENCY_UNKNOWN, Prefetched, Prefetching, Realized, Realizing, Started, Unrealized

Fields inherited from interface javax.media.Clock

RESET

Fields inherited from interface javax.media.Duration

DURATION_UNBOUNDED, DURATION_UNKNOWN

Constructor Summary

Constructors

Constructor and Description
AMController(Handler handler) Methods

Method Summary

Methods

Modifier and Type	Method and Description
protected void	abortPrefetch() Called when the prefetch() is aborted, i.e.
protected void	abortRealize() Called when the realize() is aborted, i.e.
boolean	audioEnabled()
int	canRead(int bytes) Stream related calls made from native code
long	canSeek(long seekTo)
protected void	doClose() Invoked by close() to cleanup the Controller.
protected void	doDeallocate() Called by deallocate().
protected boolean	doPrefetch() The stub function to perform the steps to prefetch the controller.
protected boolean	doRealize() The stub function to perform the steps to realize the controller.
float	doSetRate(float factor)
protected void	doStart() Start immediately.
void	doStop() Invoked from stop().
void	finalize()
void	gainChange(float g)
Control[]	getControls() Return a list of Control objects this Controller supports.
Time	getDuration() Return the duration of the media.
TimeBase	getTimeBase() Get the current time base.
Component	getVisualComponent()
boolean	isConfigurable()
void	muteChange(boolean state)
int	read(byte[] data, int offset, int length)
long	seek(long seekTo)
void	setMediaTime(Time time) Set the media time.
void	setSource(DataSource s)
void	setTimeBase(TimeBase tb) Set the timebase used by the controller.
boolean	startSource(boolean on, boolean regardless)
protected int	trySetMediaTime(Time time)
boolean	videoEnabled()

Methods inherited from class com.sun.tv.media.MediaController

addControllerListener, cleanup, close, completePrefetch, completeRealize, controllerUpdate, deallocate, dispatchEvent, doFailedPrefetch, doFailedRealize, getControl, getMediaClockTime, getMediaNanoseconds, getMediaTime, getRate, getStartLatency, getState, getStopTime, getSyncTime, getTargetState, mapToTimeBase, prefetch, processEvent, realize, removeControllerListener, sendEvent, setMediaLength, setRate, setStopTime, setTargetState, stop, stopAtTime, syncStart

Methods inherited from class java.lang.Object

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

Field Detail

TRYSET_DONE

protected static final int TRYSET_DONE

See Also:

Constant Field Values

TRYSET_CANT

protected static final int TRYSET_CANT

See Also:

Constant Field Values

TRYSET_PASTEOM

protected static final int TRYSET_PASTEOM

See Also:

Constant Field Values

eomDuration

protected Time eomDuration

Constructor Detail

AMController

public AMController(Handler handler)

Methods

Method Detail

setSource

public void setSource(DataSource s)
               throws IncompatibleSourceException

Throws:

IncompatibleSourceException

setTimeBase

public void setTimeBase(TimeBase tb)
                 throws IncompatibleTimeBaseException

Description copied from class: MediaController

Set the timebase used by the controller. i.e. all media-time to time-base-time will be computed with the given time base. The subclass should implement and further specialized this method to do the real work. But it should also invoke this method to maintain the correct states.

Specified by:

setTimeBase in interface Clock

Overrides:

setTimeBase in class MediaController

Parameters:

tb - the time base to set to.

Throws:

IncompatibleTimeBaseException - is thrown if the Controller cannot accept the given time base.

getTimeBase

public TimeBase getTimeBase()

Description copied from class: MediaController

Get the current time base.

Specified by:

getTimeBase in interface Clock

Overrides:

getTimeBase in class MediaController

Returns:

the current time base.

isConfigurable

public boolean isConfigurable()

getControls

public Control[] getControls()

Description copied from class: MediaController

Return a list of Control objects this Controller supports. If there are no controls, then an array of length zero is returned.

Specified by:

getControls in interface Controller

Overrides:

getControls in class MediaController

Returns:

list of Controller controls.

canRead

public int canRead(int bytes)

Stream related calls made from native code

canSeek

public long canSeek(long seekTo)

seek

public long seek(long seekTo)

read

public int read(byte[] data,
       int offset,
       int length)

doRealize

protected boolean doRealize()

Description copied from class: MediaController

The stub function to perform the steps to realize the controller. Call realize() for the public method. This is called from a separately running thread. So do take necessary precautions to protect shared resources. It's OK to put an empty stub function body here.

Return true if the realize is successful. Return false and set the processError string if failed.

This function is not declared synchronized because first it is already guaranteed by realize() not to be called more than once simultaneously. Secondly if this is synchronized, then other synchronized methods, deallocate() and processEvent() will be blocked since they are synchronized methods. Override this to implement subclass behavior.

Specified by:

doRealize in class MediaController

Returns:

true if successful.

abortRealize

protected void abortRealize()

Description copied from class: MediaController

Called when the realize() is aborted, i.e. deallocate() was called while realizing. Release all resources claimed previously by the realize() call. Override this to implement subclass behavior.

Specified by:

abortRealize in class MediaController

abortPrefetch

protected void abortPrefetch()

Description copied from class: MediaController

Called when the prefetch() is aborted, i.e. deallocate() was called while prefetching. Release all resources claimed previously by the prefetch call. Override this to implement subclass behavior.

Specified by:

abortPrefetch in class MediaController

doPrefetch

protected boolean doPrefetch()

Description copied from class: MediaController

The stub function to perform the steps to prefetch the controller. Call prefetch for the public method. This is called from a separately running thread. So do take necessary precautions to protect shared resources. It's OK to put an empty stub function body here.

Return true if the prefetch is successful. Return false and set the processError string if failed.

This function is not declared synchronized because first it is already guaranteed by realize() not to be called more than once simultaneously. Secondly if this is synchronized, then other synchronized methods, deallocate() and processEvent() will be blocked since they are synchronized methods. Override this to implement subclass behavior.

Specified by:

doPrefetch in class MediaController

Returns:

true if successful.

doStart

protected final void doStart()

Description copied from class: MediaController

Start immediately. Invoked from start(tbt) when the scheduled start time is reached. Use the public start(tbt) method for the public interface. Override this to implement subclass behavior.

Specified by:

doStart in class MediaController

doStop

public void doStop()

Description copied from class: MediaController

Invoked from stop(). Override this to implement subclass behavior.

Overrides:

doStop in class MediaController

doDeallocate

protected void doDeallocate()

Description copied from class: MediaController

Called by deallocate(). Subclasses should implement this for its specific behavior.

Overrides:

doDeallocate in class MediaController

finalize

public void finalize()

Overrides:

finalize in class Object

doClose

protected void doClose()

Description copied from class: MediaController

Invoked by close() to cleanup the Controller. Override this to implement subclass behavior.

Overrides:

doClose in class MediaController

setMediaTime

public void setMediaTime(Time time)

Description copied from class: MediaController

Set the media time. Invoke clock.setMediaTime() to maintain the clock states. The subclass should implement and further specialized this method to do the real work. But it should also invoke this method to maintain the correct states.

Specified by:

setMediaTime in interface Clock

Overrides:

setMediaTime in class MediaController

Parameters:

time - the media time to set to.

trySetMediaTime

protected int trySetMediaTime(Time time)

doSetRate

public float doSetRate(float factor)

Overrides:

doSetRate in class MediaController

getVisualComponent

public Component getVisualComponent()

getDuration

public Time getDuration()

Description copied from class: MediaController

Return the duration of the media. It's unknown until we implement a particular node.

Specified by:

getDuration in interface Duration

Overrides:

getDuration in class MediaController

Returns:

the duration of the media.

startSource

public boolean startSource(boolean on,
                  boolean regardless)

audioEnabled

public boolean audioEnabled()

videoEnabled

public boolean videoEnabled()

gainChange

public void gainChange(float g)

muteChange

public void muteChange(boolean state)