Interface OutputSynthManager

All Known Implementing Classes:

DefaultOutputSynthManager

public interface OutputSynthManager

A manager for OutputSynth instances.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static class	OutputSynthManager.DefaultRhythmVoiceInstrumentProviderImpl	Implement the RhythmVoiceInstrumentProvider service using the default OutputSynth provided by the OutputSynthManager.

Field Summary

Fields

Modifier and Type	Field	Description
static final Logger	LOGGER
static final String	PROP_DEFAULT_OUTPUTSYNTH	Property change event fired each time a new OutputSynth is associated to the default JJazzLab MidiDevice OUT: oldValue=old OutputSynth, newValue=new OutputSynth.
static final String	PROP_MDOUT_OUTPUTSYNTH	Property change event fired each time a new OutputSynth is associated to a MidiDevice OUT: oldValue=Midi device OUT name, newValue=OutputSynth.
static final String	STD_GM
static final String	STD_GM2
static final String	STD_GS
static final String	STD_JJAZZLAB_SOUNDFONT_GM2
static final String	STD_JJAZZLAB_SOUNDFONT_GS
static final String	STD_JJAZZLAB_SOUNDFONT_XG
static final String	STD_XG

Method Summary

Modifier and Type	Method	Description
void	addPropertyChangeListener(PropertyChangeListener l)
void	addPropertyChangeListener(String propName, PropertyChangeListener l)
static OutputSynthManager	getDefault()	Get the first implementation available in the global lookup, or if not found return the DefaultOutputSynthManager instance.
OutputSynth	getDefaultOutputSynth()	Get the current OuputSynth associated to the default JJazzLab Midi Device OUT.
OutputSynth	getMidiDeviceOutputSynth(String mdOutName)	Get the OutputSynth associated to the specified output MidiDevice.
default OutputSynth	getStandardOutputSynth(String stdName)	Get a new instance of a standard OutputSynth.
default void	refresh()	Scan all the system OUT MidiDevices and make sure each MidiDevice is associated to an OutputSynth.
void	removePropertyChangeListener(PropertyChangeListener l)
void	removePropertyChangeListener(String propName, PropertyChangeListener l)
void	setMidiDeviceOutputSynth(String mdOutName, OutputSynth outSynth)	Associate outSynth to the specified midi OUT device name.

Field Details

STD_GM

static final String STD_GM

See Also:

• Constant Field Values

STD_GM2

static final String STD_GM2

See Also:

• Constant Field Values

STD_XG

static final String STD_XG

See Also:

• Constant Field Values

STD_GS

static final String STD_GS

See Also:

• Constant Field Values

STD_JJAZZLAB_SOUNDFONT_GS

static final String STD_JJAZZLAB_SOUNDFONT_GS

See Also:

• Constant Field Values

STD_JJAZZLAB_SOUNDFONT_XG

static final String STD_JJAZZLAB_SOUNDFONT_XG

See Also:

• Constant Field Values

STD_JJAZZLAB_SOUNDFONT_GM2

static final String STD_JJAZZLAB_SOUNDFONT_GM2

See Also:

• Constant Field Values

PROP_DEFAULT_OUTPUTSYNTH

static final String PROP_DEFAULT_OUTPUTSYNTH

Property change event fired each time a new OutputSynth is associated to the default JJazzLab MidiDevice OUT: oldValue=old OutputSynth, newValue=new OutputSynth.

The change event is also fired when default JJazzLab MidiDevice OUT changes.

See Also:

• Constant Field Values

PROP_MDOUT_OUTPUTSYNTH

static final String PROP_MDOUT_OUTPUTSYNTH

Property change event fired each time a new OutputSynth is associated to a MidiDevice OUT: oldValue=Midi device OUT name, newValue=OutputSynth.

See Also:

• Constant Field Values

LOGGER

static final Logger LOGGER

Method Details

getDefault

static OutputSynthManager getDefault()

Get the first implementation available in the global lookup, or if not found return the DefaultOutputSynthManager instance.

Returns:

getDefaultOutputSynth

OutputSynth getDefaultOutputSynth()

Get the current OuputSynth associated to the default JJazzLab Midi Device OUT.

If no Midi Device OUT defined, then return a shared instance of a GM Output Synth.

Returns:

Can't be null

See Also:

• JJazzMidiSystem

getStandardOutputSynth

default OutputSynth getStandardOutputSynth(String stdName)

Get a new instance of a standard OutputSynth.

Parameters:

stdName - The name of the standard output synth, eg "GM".

Returns:

Can be null

getMidiDeviceOutputSynth

OutputSynth getMidiDeviceOutputSynth(String mdOutName)

Get the OutputSynth associated to the specified output MidiDevice.

If no OutputSynth found for this session, try to restore it from a previous session (saved as preferences). If nothing found return the shared GM output synth instance.

Parameters:

mdOutName - A Midi device OUT name, can't be null or empty

Returns:

Can't be null.

setMidiDeviceOutputSynth

void setMidiDeviceOutputSynth(String mdOutName,
 OutputSynth outSynth)

Associate outSynth to the specified midi OUT device name.

Parameters:

mdOutName - Can't be null

outSynth - Can't be null

refresh

default void refresh()

Scan all the system OUT MidiDevices and make sure each MidiDevice is associated to an OutputSynth.

Should be called if the list of available OUT system MidiDevices has changed.

addPropertyChangeListener

void addPropertyChangeListener(PropertyChangeListener l)

addPropertyChangeListener

void addPropertyChangeListener(String propName,
 PropertyChangeListener l)

removePropertyChangeListener

void removePropertyChangeListener(PropertyChangeListener l)

removePropertyChangeListener

void removePropertyChangeListener(String propName,
 PropertyChangeListener l)