org.tritonus.share.midi

Class TPreloadingSequencer

java.lang.Object

org.tritonus.share.midi.TMidiDevice

org.tritonus.share.midi.TSequencer

org.tritonus.share.midi.TPreloadingSequencer

All Implemented Interfaces:

AutoCloseable, MidiDevice, Sequencer

public abstract class TPreloadingSequencer
extends TSequencer

Base class for sequencers that work with an internal queue. To be more precise, this is the base class for sequencers that do not load the complete Sequence to internal data structures before start, but take single events from the Sequence and put them to the sequencing queue while running.

Nested Class Summary

Nested classes/interfaces inherited from class org.tritonus.share.midi.TMidiDevice

TMidiDevice.Info, TMidiDevice.TReceiver, TMidiDevice.TTransmitter

Nested classes/interfaces inherited from interface javax.sound.midi.Sequencer

Sequencer.SyncMode

Nested classes/interfaces inherited from interface javax.sound.midi.MidiDevice

MidiDevice.Info

Field Summary

Fields inherited from interface javax.sound.midi.Sequencer

LOOP_CONTINUOUSLY

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	TPreloadingSequencer(MidiDevice.Info info, Collection<Sequencer.SyncMode> masterSyncModes, Collection<Sequencer.SyncMode> slaveSyncModes) Sets the latency to the default value.

Method Summary

Modifier and Type	Method and Description
int	getLatency() Get the preloading intervall.
protected void	openImpl() Subclasses have to override this method to be notified of opening.
abstract void	sendMessageTick(MidiMessage message, long lTick) Put a message into the queue.
void	setLatency(int nLatency) Sets the preloading intervall.

Methods inherited from class org.tritonus.share.midi.TSequencer

addControllerEventListener, addMetaEventListener, checkOpen, getLoopCount, getLoopEndPoint, getLoopStartPoint, getMasterSyncMode, getMasterSyncModes, getMetaEventListeners, getMicrosecondLength, getResolution, getSequence, getSlaveSyncMode, getSlaveSyncModes, getTempoFactor, getTempoInBPM, getTempoInMPQ, getTickLength, getTrackMute, getTrackSolo, isRunning, isTrackEnabled, notifyListeners, removeControllerEventListener, removeMetaEventListener, sendControllerEvent, sendMetaMessage, setLoopCount, setLoopEndPoint, setLoopStartPoint, setMasterSyncMode, setMasterSyncModeImpl, setRealTempo, setSequence, setSequence, setSequenceImpl, setSlaveSyncMode, setSlaveSyncModeImpl, setTempoFactor, setTempoImpl, setTempoInBPM, setTempoInMPQ, setTrackEnabledImpl, setTrackMute, setTrackMuteImpl, setTrackSolo, setTrackSoloImpl, start, startImpl, stop, stopImpl

Methods inherited from class org.tritonus.share.midi.TMidiDevice

addReceiver, addTransmitter, close, closeImpl, getDeviceInfo, getMaxReceivers, getMaxTransmitters, getMicrosecondPosition, getReceiver, getReceivers, getTransmitter, getTransmitters, getUseReceiver, getUseTransmitter, isOpen, open, receive, removeReceiver, removeTransmitter, sendImpl

Methods inherited from class java.lang.Object

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

Methods inherited from interface javax.sound.midi.Sequencer

getMicrosecondPosition, getTickPosition, isRecording, recordDisable, recordEnable, setMicrosecondPosition, setTickPosition, startRecording, stopRecording

Methods inherited from interface javax.sound.midi.MidiDevice

close, getDeviceInfo, getMaxReceivers, getMaxTransmitters, getReceiver, getReceivers, getTransmitter, getTransmitters, isOpen, open

Constructor Detail

TPreloadingSequencer

protected TPreloadingSequencer(MidiDevice.Info info,
                               Collection<Sequencer.SyncMode> masterSyncModes,
                               Collection<Sequencer.SyncMode> slaveSyncModes)

Sets the latency to the default value.

Method Detail

setLatency

public void setLatency(int nLatency)

Sets the preloading intervall. This is the time span between preloading events to an internal queue and playing them. This intervall should be kept constant by the implementation. However, this cannot be guaranteed.

Overrides:

setLatency in class TSequencer

getLatency

public int getLatency()

Get the preloading intervall.

Overrides:

getLatency in class TSequencer

Returns:

the preloading intervall in milliseconds, or -1 if the sequencer doesn't repond to changes in the Sequence at all.

openImpl

protected void openImpl()

Description copied from class: TMidiDevice

Subclasses have to override this method to be notified of opening.

Overrides:

openImpl in class TMidiDevice

sendMessageTick

public abstract void sendMessageTick(MidiMessage message,
                                     long lTick)

Put a message into the queue. This is Claus-Dieter's special method: it puts the message to the ALSA queue for delivery at the specified time. The time has to be given in ticks according to the resolution of the currently active Sequence. For this method to work, the Sequencer has to be started. The message is delivered the same way as messages from a Sequence, i.e. to all registered Transmitters. If the current queue position (as returned by getTickPosition()) is already behind the desired schedule time, the message is ignored.

Parameters:

message - the MidiMessage to put into the queue.

lTick - the desired schedule time in ticks.