com.tuneology.avm.player
Class MadplayPlayer

java.lang.Object
  |
  +--com.tuneology.avm.player.Player
        |
        +--com.tuneology.avm.player.LocalPlayer
              |
              +--com.tuneology.avm.player.MadplayPlayer

All Implemented Interfaces:

AudioPlayer, MediaPlayer

public class MadplayPlayer

extends LocalPlayer

implements AudioPlayer

An interface to madplay, a sound file player for Unix.

Version:

$Id: MadplayPlayer.java,v 1.7 2003/07/10 19:52:12 xnarf Exp $

Author:

Fran Taylor

Fields inherited from class com.tuneology.avm.player.LocalPlayer

mixer, mixerChannel, paused

Fields inherited from class com.tuneology.avm.player.Player

dev, listeners, looping

Constructor Summary

MadplayPlayer(java.lang.String dev, java.lang.String name)
Instantiate a new player.

Method Summary

void	close() Close the player and release its resources.
void	cueFile(MediaData mf) Loads a file, sets the current position to the beginning, and pauses.
static java.lang.String	getDescription()
int	getSize() Returns the maximum size of the current file.
static java.lang.String	getVersionString()
Volume	getVolume() Gets the audio output volume.
VolumeRange	getVolumeRange()
void	jumpTo(int pos) Moves the current position.
void	pause() Temporarily stops playing at the current position.
void	play() Starts playing after calling stop or cuefile.
boolean	playFile(java.lang.String url) Play the file, blocking until it's done.
void	playNextTrack()
void	playPrevTrack()
void	playStream(java.io.InputStream str)
void	setVolume(Volume vol) Sets the audio output volume.
void	shutdown()
void	stop() Stops playing and resets the current position to the beginning.
void	unpause() Starts playing after calling pause.

Methods inherited from class com.tuneology.avm.player.LocalPlayer

canEject, eject, getCanvas, getMixerChannel, getPcmChannel, initInstance, setArtist, setTime, setTitle, setTotal, setTrack

Methods inherited from class com.tuneology.avm.player.Player

addStatusListener, findPlayerClass, findVideoPlayerClass, formatSeconds, getAudioDevices, getAudioPlayers, getDescription, getDevice, getDeviceDescription, getLoop, getName, getVersions, getVideoPlayers, newMediaPlayer, removeStatusListener, setDevice, setLoop, shutdownPlayers

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.tuneology.avm.player.MediaPlayer

addStatusListener, getCanvas, getDevice, getLoop, getName, removeStatusListener, setArtist, setDevice, setLoop, setTitle, setTotal, setTrack

Constructor Detail

MadplayPlayer

public MadplayPlayer(java.lang.String dev,
                     java.lang.String name)
              throws java.lang.Exception

Instantiate a new player.

Parameters:

dev - The output device. For the default audio output, specify blank or null. For esd output, specify the form "esd:hostname".

name - The name of the player.

Method Detail

playFile

public boolean playFile(java.lang.String url)
                 throws java.lang.Exception

Description copied from interface: MediaPlayer

Play the file, blocking until it's done.

Specified by:

playFile in interface MediaPlayer

Parameters:

url -

Throws:

java.lang.Exception -

playStream

public void playStream(java.io.InputStream str)
                throws java.lang.Exception

Specified by:

playStream in interface MediaPlayer

Parameters:

str -

Throws:

java.lang.Exception -

cueFile

public void cueFile(MediaData mf)
             throws java.lang.Exception

Description copied from interface: MediaPlayer

Loads a file, sets the current position to the beginning, and pauses. Call unpause() to begin playing.

Specified by:

cueFile in interface MediaPlayer

Parameters:

f -

Throws:

java.lang.Exception -

getSize

public int getSize()
            throws java.lang.Exception

Description copied from interface: MediaPlayer

Returns the maximum size of the current file.

Specified by:

getSize in interface MediaPlayer

Returns:

the size of the current file.

Throws:

java.lang.Exception -

jumpTo

public void jumpTo(int pos)
            throws java.lang.Exception

Description copied from interface: MediaPlayer

Moves the current position. Valid values are 0 - getSize(). If the player was playing, it will continue playing at the new position. If the player was paused, it will remain paused at the new position.

Specified by:

jumpTo in interface MediaPlayer

Overrides:

jumpTo in class LocalPlayer

Parameters:

pos -

Throws:

java.lang.Exception -

play

public void play()
          throws java.lang.Exception

Description copied from interface: MediaPlayer

Starts playing after calling stop or cuefile.

Specified by:

play in interface MediaPlayer

Overrides:

play in class LocalPlayer

Throws:

java.lang.Exception -

playNextTrack

public void playNextTrack()
                   throws java.lang.Exception

Specified by:

playNextTrack in interface MediaPlayer

Overrides:

playNextTrack in class LocalPlayer

Throws:

java.lang.Exception -

playPrevTrack

public void playPrevTrack()
                   throws java.lang.Exception

Specified by:

playPrevTrack in interface MediaPlayer

Overrides:

playPrevTrack in class LocalPlayer

Throws:

java.lang.Exception -

getVolumeRange

public VolumeRange getVolumeRange()
                           throws java.lang.Exception

Specified by:

getVolumeRange in interface MediaPlayer

Overrides:

getVolumeRange in class LocalPlayer

Throws:

java.lang.Exception -

getVolume

public Volume getVolume()
                 throws java.io.IOException

Gets the audio output volume.

Specified by:

getVolume in interface MediaPlayer

Overrides:

getVolume in class LocalPlayer

Returns:

volume level.

Throws:

java.io.IOException -

setVolume

public void setVolume(Volume vol)
               throws java.io.IOException

Sets the audio output volume.

Specified by:

setVolume in interface MediaPlayer

Overrides:

setVolume in class LocalPlayer

Parameters:

vol -

Throws:

java.io.IOException -

shutdown

public void shutdown()

Overrides:

shutdown in class Player

pause

public void pause()
           throws java.lang.Exception

Description copied from interface: MediaPlayer

Temporarily stops playing at the current position.

Specified by:

pause in interface MediaPlayer

Overrides:

pause in class LocalPlayer

Throws:

java.lang.Exception -

unpause

public void unpause()
             throws java.lang.Exception

Description copied from interface: MediaPlayer

Starts playing after calling pause.

Specified by:

unpause in interface MediaPlayer

Overrides:

unpause in class LocalPlayer

Throws:

java.lang.Exception -

stop

public void stop()
          throws java.lang.Exception

Description copied from interface: MediaPlayer

Stops playing and resets the current position to the beginning.

Specified by:

stop in interface MediaPlayer

Overrides:

stop in class LocalPlayer

Throws:

java.lang.Exception -

close

public void close()

Description copied from interface: MediaPlayer

Close the player and release its resources.

Specified by:

close in interface MediaPlayer

Following copied from interface: com.tuneology.avm.player.MediaPlayer

Throws:

java.lang.Exception -

getVersionString

public static java.lang.String getVersionString()

getDescription

public static java.lang.String getDescription()