abc.midi
Class TunePlayer

java.lang.Object
  abc.midi.TunePlayer

All Implemented Interfaces:

java.util.EventListener, javax.sound.midi.MetaEventListener

public class TunePlayer
extends java.lang.Object
implements javax.sound.midi.MetaEventListener

TunePlayer objects enable you to play tunes using default MIDI sequencer.

TunePlayer

public TunePlayer()

Constructs a tune player with default midi converter.

See Also:

BasicMidiConverter

TunePlayer

public TunePlayer(MidiConverterInterface converter)

Constructs a tune player with the specified midi converter.

addListener

public void addListener(TunePlayerListenerInterface listener)

Adds a listener to this tune player.

Parameters:

listener - The listener to be added to this tune player.

removeListener

public void removeListener(TunePlayerListenerInterface listener)

Removes a listener from this tune player.

Parameters:

listener - The listener to be removed from this tune player.

setTempo

public void setTempo(int tempo)

Sets the tempo used to play the tune. N.B: This is real time tempo change : the tempo will change even if a tune is playing.

Parameters:

tempo - the tempo used to play the tune.

getTempo

public int getTempo()

Returns the tempo currently used to play tunes.

Returns:

The tempo currently used to play tunes.

getInstrument

public javax.sound.midi.Instrument getInstrument()

Returns the instrument currently used for sequence playback.

Returns:

The instrument currently used for sequence playback. Returns null if not set.

setInstrument

public void setInstrument(javax.sound.midi.Instrument instr)
                   throws javax.sound.midi.MidiUnavailableException

Sets the instrument to be used for sequence playback. This implicitly loads the given instrument.

Parameters:

instr - The instrument to be used for sequence playback.

Throws:

javax.sound.midi.MidiUnavailableException

getTune

public Tune getTune()

The tune that is currently played,

play

public void play(Tune tune)
          throws java.lang.IllegalStateException

Plays the given tune.

Parameters:

tune - The tune to be played.

Throws:

java.lang.IllegalStateException - Thrown if the player hasn't been started before.

isPlaying

public boolean isPlaying()

Returns true if this player is currently playing a tune.

Returns:

true if this player is currently playing a tune, false otherwise.

meta

public void meta(javax.sound.midi.MetaMessage meta)

Specified by:

meta in interface javax.sound.midi.MetaEventListener

start

public void start()

Starts the player so that it can play tunes. (Retrieves the default sequencer during this phasis).

stopPlaying

public void stopPlaying()

Stops the playing of the current tune if any.

stop

public void stop()

Stops this player.