Interface Sequencer

public int[] addControllerEventListener(ControllerEventListener listener,
                                        controllers[] )

Add a controller event listening object to this sequencer. It will receive notification whenever the sequencer processes a controller event for a specified controller number..

Parameters:

listener - the listener to add

Returns:

the controller numbers being listened to

public boolean addMetaEventListener(MetaEventListener listener)

Add a meta event listening object to this sequencer. It will receive notification whenever the sequencer processes a meta event. A listener may fail to get added if this sequencer doesn't support meta events.

Parameters:

listener - the listener to add

Returns:

true if listener was added, false othewise

public Sequencer.SyncMode getMasterSyncMode()

Get the source of timing information.

Returns:

the current source of timing information

public Sequencer.SyncMode[] getMasterSyncModes()

Get an array of timing sources supported by this sequencer.

Returns:

an array of timing sources supported by this sequencer

public long getMicrosecondLength()

Get the length of the current sequence in microseconds.

Returns:

the length of the current sequence in microseconds

public long getMicrosecondPosition()

Get the current playback position of the sequencer in microseconds.

Specified by:

getMicrosecondPosition in interface MidiDevice

Returns:

the current playback position of the sequencer in microseconds

public Sequence getSequence()

Get the current sequence object for this sequencer.

Returns:

the current sequence object. May be null.

public Sequencer.SyncMode getSlaveSyncMode()

Get the current slave synchronization mode.

Returns:

the current slave synchronization mode

public Sequencer.SyncMode[] getSlaveSyncModes()

Get an array of slave sync modes supported by this sequencer.

Returns:

an array of slave sync modes supported by this sequencer

public float getTempoFactor()

Get the current scaling factor for the playback tempo.

Returns:

the current tempo scaling factor

public float getTempoInBPM()

Get the current tempo in beats per minute.

Returns:

the current tempo in beats per minute

public float getTempoInMPQ()

Get the current tempo in microseconds per quarter note.

Returns:

the current tempo in microseconds per quarter note.

public long getTickLength()

Get the length of the current sequence in MIDI ticks.

Returns:

the length of the current sequence in MIDI ticks

public long getTickPosition()

Get the current playback position of the sequencer in MIDI ticks.

Returns:

the current playback position of the sequencer in MIDI ticks

public boolean getTrackMute(int track)

Get the mute state of a specific track.

Parameters:

track - the track to query

Returns:

the mute state for track

public boolean getTrackSolo(int track)

Get the solo state for a specific track.

Parameters:

track - the track to query

Returns:

the solo state for track

public boolean isRecording()

Returns true if sequence is recording.

Returns:

true if the sequence is recording and false otherwise

public boolean isRunning()

Returns true if the sequence is playing.

Returns:

true if the sequence is playing and false otherwise

public void recordDisable(Track track)

Disable recording for a specific track.

Parameters:

track - the track to disable recording for

public void recordEnable(Track track,
                         int channel)

Enable recording for a specific track using data from a specific channel.

Parameters:

track - the track to enable for recording

channel - the channel from which to record

public int[] removeControllerEventListener(ControllerEventListener listener,
                                           controllers[] )

Remove a controller listener from this sequencer for the specified controller numbers.

Parameters:

listener - the listener to remove

Returns:

the controller numbers being unlistened

public void removeMetaEventListener(MetaEventListener listener)

Remove a meta event listener from this sequencer.

Parameters:

listener - the listener to remove

public void setMasterSyncMode(Sequencer.SyncMode sync)

Set the source of timing information. sync must be found in the array returned by getMasterSyncModes(). FIXME: What happens if it isn't?

Parameters:

sync - the new source of timing information

public void setMicrosecondPosition(long microsecond)

Set the current playback position of the sequencer in microseconds.

Parameters:

microsecond - the new playback position of the sequencer in microseconds

public void setSequence(InputStream istream)
            throws IOException,
                   InvalidMidiDataException

Set the sequence for this sequencer. istream reads on a valid MIDI file.

Parameters:

istream - an input stream for a valid MIDI file

Throws:

IOException - if an I/O exception happens

InvalidMidiDataException - if the MIDI file contains bad data

public void setSequence(Sequence seq)
            throws InvalidMidiDataException

Set the Sequence object for this sequencer.

Parameters:

seq - the Sequence to process

Throws:

InvalidMidiDataException - if the sequence is invalid for any reason

public void setSlaveSyncMode(Sequencer.SyncMode sync)

Set the slave synchronization mode for this sequencer. sync must be found in the array returned by getSlaveSyncModes(). FIXME: What happens if it isn't?

Parameters:

sync - the new slave sync mode for this sequencer

public void setTempoFactor(float factor)

Set a scaling factor for the playback tempo, which is 1.0 by default.

Parameters:

factor - the new tempo scaling factor

public void setTempoInBPM(float bpm)

Sets the current tempo in beats per minute.

Parameters:

bpm - the new tempo in bears per minutes

public void setTempoInMPQ(float mpq)

Sets the current tempo in microseconds per quarter note.

Parameters:

mpq - the new tempo in microseconds per quarter note.

public void setTickPosition(long tick)

Set the current playback position of the sequencer in MIDI ticks.

Parameters:

tick - the new playback position of the sequencer in MIDI ticks

public void setTrackMute(int track,
                         boolean mute)

Sets the mute state for a specific track.

Parameters:

track - the track to modify

mute - the new mute state

public void setTrackSolo(int track,
                         boolean solo)

Sets the solo state for a specific track.

Parameters:

track - the track to modify

solo - the new solo state

public void start()

Start playback of the current sequence.

public void startRecording()

Start playback and record of MIDI events. Any tracks enabled for recording will have their events replaced. Any newly recorded events, and all events from non-recording tracks will be sent to the sequencer's transmitter.

public void stop()

Stop playback of the current sequence.

public void stopRecording()

Stop recording, although continue playing.