fi.hut.tml.xsmiles.mlfc.smil.viewer.swing.media
Class XMLMedia

java.lang.Object
  fi.hut.tml.xsmiles.mlfc.smil.viewer.swing.media.XMLMedia

All Implemented Interfaces:

Media

public class XMLMedia

extends java.lang.Object

implements Media

This is the implementation of image media.

Constructor Summary

XMLMedia(Viewer v)

Method Summary

void	addMediaListener(MediaListener listener) Adds a MediaListener for this media.
void	close() This will freeze all memory and references to this media.
int	getOriginalDuration() Get the duration of media.
int	getOriginalHeight() Get the real height of the media.
int	getOriginalWidth() Get the real width of the media.
boolean	isStatic() Checks if this media is static or continuous.
void	pause() Pauses the media.
void	play() Plays the media.
void	prefetch() Prefetches media.
void	setBounds(int x, int y, int width, int height) Set the coordinates for the media.
void	setContainer(java.awt.Container container) Sets the container the media will be rendered in.
void	setMediaTime(int millisecs) This moves the time position in media.
void	setMLFCListener(MLFCListener listener) All traffic to the browser, such as openLocation, etc goes through this listener.
void	setSoundVolume(int percentage) Set the sound volume for media.
void	setUrl(java.net.URL url) Sets the URL for this media.
void	showControls(boolean visible) Requests the media player to display a control panel for media.
void	stop() Stops the media.

Methods inherited from class java.lang.Object

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

Constructor Detail

XMLMedia

public XMLMedia(Viewer v)

Method Detail

isStatic

public boolean isStatic()

Checks if this media is static or continuous.

Specified by:

isStatic in interface Media

Returns:

true if media is static.

setUrl

public void setUrl(java.net.URL url)

Description copied from interface: Media

Sets the URL for this media. This method will only set the URL for the media. To actually download the data, prefetch() or play() should be called.

Specified by:

setUrl in interface Media

Parameters:

url - URL for media

prefetch

public void prefetch()

Description copied from interface: Media

Prefetches media. The URL must have been set using setUrl(). The data will be downloaded from the URL. After calling this method, the media will be in memory and can be played. This is a blocking method.

Specified by:

prefetch in interface Media

setContainer

public void setContainer(java.awt.Container container)

Description copied from interface: Media

Sets the container the media will be rendered in. If media is audio, this can be null. Can be called if media is already visible in one container, it will then move to the new container.

Specified by:

setContainer in interface Media

Parameters:

container - This container will contain the media.

play

public void play()

Description copied from interface: Media

Plays the media. The media will be added to the container set using setContainer(). It will be visible. It will also play any animation it possibly has. Also, audio media is started using this method.

If the media is not yet prefetched, it will first be prefetched.

Specified by:

play in interface Media

pause

public void pause()

Description copied from interface: Media

Pauses the media. The media will stay visible, but any animations will be paused. Audio media will be silent. NOT IMPLEMENTED YET. ?How to restart paused media?

Specified by:

pause in interface Media

stop

public void stop()

Description copied from interface: Media

Stops the media. The media will be stopped and it will be invisible. Audio will be silent.

Specified by:

stop in interface Media

setMediaTime

public void setMediaTime(int millisecs)

This moves the time position in media. Not effective for this media.

Specified by:

setMediaTime in interface Media

Parameters:

millisecs - Time in millisecs

setBounds

public void setBounds(int x,
                      int y,
                      int width,
                      int height)

Description copied from interface: Media

Set the coordinates for the media. These are relative to the given container, set using setContainer(). Setting the bounds will always immediately move the media to a new location, if it is visible.

Specified by:

setBounds in interface Media

close

public void close()

Description copied from interface: Media

This will freeze all memory and references to this media. If the media is not yet stopped, it will first be stopped.

Specified by:

close in interface Media

getOriginalWidth

public int getOriginalWidth()

Get the real width of the media.

Specified by:

getOriginalWidth in interface Media

Returns:

Original width of the media. -1 means no particular width (audio) or unknown width (text, XML media...)

getOriginalHeight

public int getOriginalHeight()

Get the real height of the media.

Specified by:

getOriginalHeight in interface Media

Returns:

Original height of the media. -1 means no particular height (audio) or unknown height (text, XML media...)

setSoundVolume

public void setSoundVolume(int percentage)

Set the sound volume for media. Does nothing for this media player.

Specified by:

setSoundVolume in interface Media

Parameters:

percentage - Not used.

getOriginalDuration

public int getOriginalDuration()

Get the duration of media. Only applicable for continuous media (audio, video).

Specified by:

getOriginalDuration in interface Media

Returns:

The duration of media in millisecs. -1 means indefinite (infinite streamed media or unknown duration).

addMediaListener

public void addMediaListener(MediaListener listener)

Description copied from interface: Media

Adds a MediaListener for this media. The listener will be called

1. When the media has been prefetched. (NOT IMPLEMENTED YET).
2. When the media ends. (continuous media, video/audio)

Static media, such as text and images will end immediately, notifying immediately about the end of media.

Specified by:

addMediaListener in interface Media

showControls

public void showControls(boolean visible)

Requests the media player to display a control panel for media. For audio and video, these can be a volume/play/stop controls, for images, these can be zoom controls. The controls are GUI dependent, generated through ComponentFactory.

Specified by:

showControls in interface Media

Parameters:

visible - true=Display controls, false=don't display controls.

setMLFCListener

public void setMLFCListener(MLFCListener listener)

All traffic to the browser, such as openLocation, etc goes through this listener. If no listener supplied media players should still function with some basic level.

Specified by:

setMLFCListener in interface Media

Parameters:

listener - The MLFCListener supplied by the browser

See Also:

MLFCListener