org/jsampler/DefaultSamplerChannelModel.java

/*
 *   JSampler - a java front-end for LinuxSampler
 *
 *   Copyright (C) 2005 Grigor Kirilov Iliev
 *
 *   This file is part of JSampler.
 *
 *   JSampler is free software; you can redistribute it and/or modify
 *   it under the terms of the GNU General Public License version 2
 *   as published by the Free Software Foundation.
 *
 *   JSampler is distributed in the hope that it will be useful,
 *   but WITHOUT ANY WARRANTY; without even the implied warranty of
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 *   GNU General Public License for more details.
 *
 *   You should have received a copy of the GNU General Public License
 *   along with JSampler; if not, write to the Free Software
 *   Foundation, Inc., 59 Temple Place, Suite 330, Boston,
 *   MA  02111-1307  USA
 */

package org.jsampler;

import java.util.Vector;

import javax.swing.SwingUtilities;

import net.sf.juife.Task;
import net.sf.juife.event.TaskEvent;
import net.sf.juife.event.TaskListener;

import org.jsampler.event.SamplerChannelEvent;
import org.jsampler.event.SamplerChannelListener;

import org.jsampler.task.DuplicateChannels;
import org.jsampler.task.LoadEngine;
import org.jsampler.task.LoadInstrument;
import org.jsampler.task.ResetChannel;
import org.jsampler.task.SetChannelAudioOutputDevice;
import org.jsampler.task.SetChannelMidiInputChannel;
import org.jsampler.task.SetChannelMidiInputDevice;
import org.jsampler.task.SetChannelMidiInputPort;
import org.jsampler.task.SetChannelVolume;
import org.jsampler.task.SetMuteChannel;
import org.jsampler.task.SetSoloChannel;

import org.linuxsampler.lscp.SamplerChannel;


/**
 * This class provides default implementation of the <code>SamplerChannelModel</code> interface.
 * @author Grigor Iliev
 */
public class DefaultSamplerChannelModel implements SamplerChannelModel {
        private SamplerChannel channel;
        private int streamCount = 0;
        private int voiceCount = 0;
        
        private final Vector<SamplerChannelListener> listeners =
                new Vector<SamplerChannelListener>();
        
        /**
         * Creates a new instance of <code>DefaultSamplerChannelModel</code> using the
         * specified channel settings.
         * @param channel A non-null <code>SamplerChannel</code> instance containing the current
         * settings of the channel which will be represented by this sampler channel model.
         * @throws IllegalArgumentException If <code>channel</code> is <code>null</code>.
         */
        public DefaultSamplerChannelModel(SamplerChannel channel) {
                if(channel == null) throw new IllegalArgumentException("channel must be non null");
                this.channel = channel;
        }
        
        /**
         * Registers the specified listener for receiving event messages.
         * @param l The <code>SamplerChannelListener</code> to register.
         */
        public void
        addSamplerChannelListener(SamplerChannelListener l) { listeners.add(l); }
        
        /**
         * Removes the specified listener.
         * @param l The <code>SamplerChannelListener</code> to remove.
         */
        public void
        removeSamplerChannelListener(SamplerChannelListener l) { listeners.remove(l); }
        
        /**
         * Gets the sampler channel number.
         * @return The sampler channel number or -1 if the sampler channel number is not set.
         */
        public int
        getChannelID() { return channel == null ? -1 : channel.getChannelID(); }
        
        /**
         * Gets the current settings of the sampler channel.
         * @return <code>SamplerChannel</code> instance containing
         * the current settings of the sampler channel.
         */
        public SamplerChannel
        getChannelInfo() { return channel; }
        
        /**
         * Sets the current settings of the sampler channel.
         * Note that this method does not changes the channel settings on
         * the back-end. It is invoked to update them when the back-end
         * notifies that the channel settings are changed.
         * @param channel A <code>SamplerChannel</code> instance containing
         * the new settings for this sampler channel.
         * @throws IllegalArgumentException If <code>channel</code> is <code>null</code>.
         */
        public void
        setChannelInfo(SamplerChannel channel) {
                if(channel == null) throw new IllegalArgumentException("channel must be non null");
                if(this.channel == channel) return;
                
                this.channel = channel;
                fireSamplerChannelChanged();
        }
        
        /**
         * Gets the number of active disk streams.
         * @return The number of active disk streams.
         */
        public int
        getStreamCount() { return streamCount; }
        
        /**
         * Sets the number of active disk streams.
         * @param count The new number of active disk streams.
         */
        public void
        setStreamCount(int count) {
                if(streamCount == count) return;
                
                streamCount = count;
                fireStreamCountChanged();
        }
        
        /**
         * Gets the number of active voices.
         * @return The number of active voices.
         */
        public int
        getVoiceCount() { return voiceCount; }
        
        /**
         * Sets the number of active voices.
         * @param count The new number of active voices.
         */
        public void
        setVoiceCount(int count) {
                if(voiceCount == count) return;
                
                voiceCount = count;
                fireVoiceCountChanged();
        }
        
        /**
         * Sets the sampler engine type to be used.
         * @param engine The name of the engine type to be used.
         */
        public void
        setEngineType(String engine) {
                final LoadEngine loadEngine = new LoadEngine(engine, getChannelID());
                final SamplerChannelEvent event = new SamplerChannelEvent(this);
                
                loadEngine.addTaskListener(new TaskListener() {
                        public void
                        taskPerformed(TaskEvent e) {
                                /*
                                 * Because with the invokation of the method the task is considered
                                 * to be done, if the task fails, we must notify for a channel
                                 * changes. This should be done to revert the old channel settings.
                                 */
                                if(loadEngine.doneWithErrors()) fireSamplerChannelChanged(event);
                        }
                });
                CC.getTaskQueue().add(loadEngine);
                
                // We leave this event to be notified by the LinuxSampler notification system.
        }
        
        /**
         * Sets the mute mode of the channel. 
         * @param mute Specifies the mute mode. If <code>true</code> the channel is muted, else
         * the channel is unmuted.
         */
        public void
        setMute(boolean mute) {
                final SetMuteChannel smc = new SetMuteChannel(getChannelID(), mute);
                final SamplerChannelEvent event = new SamplerChannelEvent(this);
                
                smc.addTaskListener(new TaskListener() {
                        public void
                        taskPerformed(TaskEvent e) {
                                /*
                                 * Because with the invokation of the method the task is considered
                                 * to be done, if the task fails, we must notify for a channel
                                 * changes. This should be done to revert the old channel settings.
                                 */
                                if(smc.doneWithErrors()) fireSamplerChannelChanged(event);
                        }
                });
                CC.getTaskQueue().add(smc);
                
                // We leave this event to be notified by the LinuxSampler notification system.
        }
        
        /**
         * Sets the solo mode of the channel. 
         * @param solo Specifies the solo mode. If <code>true</code> the channel is soloed, else
         * the channel is unsoloed.
         */
        public void
        setSolo(boolean solo) {
                final SetSoloChannel ssc = new SetSoloChannel(getChannelID(), solo);
                final SamplerChannelEvent event = new SamplerChannelEvent(this);
                
                ssc.addTaskListener(new TaskListener() {
                        public void
                        taskPerformed(TaskEvent e) {
                                /*
                                 * Because with the invokation of the method the task is considered
                                 * to be done, if the task fails, we must notify for a channel
                                 * changes. This should be done to revert the old channel settings.
                                 */
                                if(ssc.doneWithErrors()) fireSamplerChannelChanged(event);
                        }
                });
                CC.getTaskQueue().add(ssc);
                
                // We leave this event to be notified by the LinuxSampler notification system.
        }
        
        /**
         * Sets the channel volume. 
         * @param volume Specifies the new volume value.
         */
        public void
        setVolume(float volume) {
                final SetChannelVolume scv = new SetChannelVolume(getChannelID(), volume);
                final SamplerChannelEvent event = new SamplerChannelEvent(this);
                
                scv.addTaskListener(new TaskListener() {
                        public void
                        taskPerformed(TaskEvent e) {
                                /*
                                 * Because with the invokation of the method the task is considered
                                 * to be done, if the task fails, we must notify for a channel
                                 * changes. This should be done to revert the old channel settings.
                                 */
                                if(scv.doneWithErrors()) fireSamplerChannelChanged(event);
                        }
                });
                CC.getTaskQueue().add(scv);
                
                // We leave this event to be notified by the LinuxSampler notification system.
        }
        
        /**
         * Sets the MIDI input device of the channel represented by this model. 
         * @param deviceID Specifies the numerical ID of the MIDI input device to be set.
         */
        public void
        setMidiInputDevice(int deviceID) {
                final Task scmid = new SetChannelMidiInputDevice(getChannelID(), deviceID);
                final SamplerChannelEvent event = new SamplerChannelEvent(this);
                
                scmid.addTaskListener(new TaskListener() {
                        public void
                        taskPerformed(TaskEvent e) {
                                /*
                                 * Because with the invokation of the method the task is considered
                                 * to be done, if the task fails, we must notify for a channel
                                 * changes. This should be done to revert the old channel settings.
                                 */
                                if(scmid.doneWithErrors()) fireSamplerChannelChanged(event);
                        }
                });
                CC.getTaskQueue().add(scmid);
                
                // We leave this event to be notified by the LinuxSampler notification system.
        }
        
        /**
         * Sets the MIDI input port of the channel represented by this model. 
         * @param port Specifies the number of the MIDI input port.
         */
        public void
        setMidiInputPort(int port) {
                final Task scmip = new SetChannelMidiInputPort(getChannelID(), port);
                final SamplerChannelEvent event = new SamplerChannelEvent(this);
                
                scmip.addTaskListener(new TaskListener() {
                        public void
                        taskPerformed(TaskEvent e) {
                                /*
                                 * Because with the invokation of the method the task is considered
                                 * to be done, if the task fails, we must notify for a channel
                                 * changes. This should be done to revert the old channel settings.
                                 */
                                if(scmip.doneWithErrors()) fireSamplerChannelChanged(event);
                        }
                });
                CC.getTaskQueue().add(scmip);
                
                // We leave this event to be notified by the LinuxSampler notification system.
        }
        
        /**
         * Sets the MIDI channel that the channel represented by this model should listen to. 
         * @param channel Specifies the MIDI channel that the channel
         * represented by this model should listen to.
         */
        public void
        setMidiInputChannel(int channel) {
                final Task scmic = new SetChannelMidiInputChannel(getChannelID(), channel);
                final SamplerChannelEvent event = new SamplerChannelEvent(this);
                
                scmic.addTaskListener(new TaskListener() {
                        public void
                        taskPerformed(TaskEvent e) {
                                /*
                                 * Because with the invokation of the method the task is considered
                                 * to be done, if the task fails, we must notify for a channel
                                 * changes. This should be done to revert the old channel settings.
                                 */
                                if(scmic.doneWithErrors()) fireSamplerChannelChanged(event);
                        }
                });
                CC.getTaskQueue().add(scmic);
                
                // We leave this event to be notified by the LinuxSampler notification system.
        }
        
        /**
         * Sets the audio output device of the channel represented by this model. 
         * @param deviceID Specifies the numerical ID of the audio output device to be set.
         */
        public void
        setAudioOutputDevice(int deviceID) {
                final Task scaod = new SetChannelAudioOutputDevice(getChannelID(), deviceID);
                final SamplerChannelEvent event = new SamplerChannelEvent(this);
                
                scaod.addTaskListener(new TaskListener() {
                        public void
                        taskPerformed(TaskEvent e) {
                                /*
                                 * Because with the invokation of the method the task is considered
                                 * to be done, if the task fails, we must notify for a channel
                                 * changes. This should be done to revert the old channel settings.
                                 */
                                if(scaod.doneWithErrors()) fireSamplerChannelChanged(event);
                        }
                });
                CC.getTaskQueue().add(scaod);
                
                // We leave this event to be notified by the LinuxSampler notification system.
        }
        
        /**
         * Loads and assigns the specified instrument
         * to the sampler channel represented by this model.
         * @param filename The file name of the instrument to be loaded.
         * @param InstrIndex The index of the instrument in the instrument file to be loaded.
         */
        public void
        loadInstrument(String filename, int InstrIndex) {
                final Task li = new LoadInstrument(filename, InstrIndex, getChannelID());
                CC.getTaskQueue().add(li);
                
                // We leave this event to be notified by the LinuxSampler notification system.
        }
        
        /** Resets the channel. */
        public void
        resetChannel() {
                CC.getTaskQueue().add(new ResetChannel(getChannelID()));
                
                // We leave this event to be notified by the LinuxSampler notification system.
        }
        
        /** Duplicates the channel. */
        public void
        duplicateChannel() {
                CC.getTaskQueue().add(new DuplicateChannels(getChannelInfo()));
        }
        
        /** Notifies listeners that the sampler channel settings has changed. */
        protected void
        fireSamplerChannelChanged() {
                final SamplerChannelEvent e = new SamplerChannelEvent(this);
                
                SwingUtilities.invokeLater(new Runnable() {
                        public void
                        run() { fireSamplerChannelChanged(e); }
                });
        }
        
        /** 
         * Notifies listeners that the sampler channel settings has changed.
         * This method should be invoked from the event-dispatching thread.
         */
        protected void
        fireSamplerChannelChanged(SamplerChannelEvent e) {
                for(SamplerChannelListener l : listeners) l.channelChanged(e);
        }
        
        /** Notifies listeners that the number of active disk streams has changed. */
        protected void
        fireStreamCountChanged() {
                final SamplerChannelEvent e = new SamplerChannelEvent(this);
                
                SwingUtilities.invokeLater(new Runnable() {
                        public void
                        run() { fireStreamCountChanged(e); }
                });
        }
        
        /** 
         * Notifies listeners that the number of active disk streams has changed.
         * This method should be invoked from the event-dispatching thread.
         */
        protected void
        fireStreamCountChanged(SamplerChannelEvent e) {
                for(SamplerChannelListener l : listeners) l.streamCountChanged(e);
        }
        
        /** Notifies listeners that the number of active voices has changed. */
        protected void
        fireVoiceCountChanged() {
                final SamplerChannelEvent e = new SamplerChannelEvent(this);
                
                SwingUtilities.invokeLater(new Runnable() {
                        public void
                        run() { fireVoiceCountChanged(e); }
                });
        }
        
        /** 
         * Notifies listeners that the number of active voices has changed.
         * This method should be invoked from the event-dispatching thread.
         */
        protected void
        fireVoiceCountChanged(SamplerChannelEvent e) {
                for(SamplerChannelListener l : listeners) l.voiceCountChanged(e);
        }
}
1	/*
2	* JSampler - a java front-end for LinuxSampler
3	*
4	* Copyright (C) 2005 Grigor Kirilov Iliev
5	*
6	* This file is part of JSampler.
7	*
8	* JSampler is free software; you can redistribute it and/or modify
9	* it under the terms of the GNU General Public License version 2
10	* as published by the Free Software Foundation.
11	*
12	* JSampler is distributed in the hope that it will be useful,
13	* but WITHOUT ANY WARRANTY; without even the implied warranty of
14	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15	* GNU General Public License for more details.
16	*
17	* You should have received a copy of the GNU General Public License
18	* along with JSampler; if not, write to the Free Software
19	* Foundation, Inc., 59 Temple Place, Suite 330, Boston,
20	* MA 02111-1307 USA
21	*/
22
23	package org.jsampler;
24
25	import java.util.Vector;
26
27	import javax.swing.SwingUtilities;
28
29	import net.sf.juife.Task;
30	import net.sf.juife.event.TaskEvent;
31	import net.sf.juife.event.TaskListener;
32
33	import org.jsampler.event.SamplerChannelEvent;
34	import org.jsampler.event.SamplerChannelListener;
35
36	import org.jsampler.task.DuplicateChannels;
37	import org.jsampler.task.LoadEngine;
38	import org.jsampler.task.LoadInstrument;
39	import org.jsampler.task.ResetChannel;
40	import org.jsampler.task.SetChannelAudioOutputDevice;
41	import org.jsampler.task.SetChannelMidiInputChannel;
42	import org.jsampler.task.SetChannelMidiInputDevice;
43	import org.jsampler.task.SetChannelMidiInputPort;
44	import org.jsampler.task.SetChannelVolume;
45	import org.jsampler.task.SetMuteChannel;
46	import org.jsampler.task.SetSoloChannel;
47
48	import org.linuxsampler.lscp.SamplerChannel;
49
50
51	/**
52	* This class provides default implementation of the <code>SamplerChannelModel</code> interface.
53	* @author Grigor Iliev
54	*/
55	public class DefaultSamplerChannelModel implements SamplerChannelModel {
56	private SamplerChannel channel;
57	private int streamCount = 0;
58	private int voiceCount = 0;
59
60	private final Vector<SamplerChannelListener> listeners =
61	new Vector<SamplerChannelListener>();
62
63	/**
64	* Creates a new instance of <code>DefaultSamplerChannelModel</code> using the
65	* specified channel settings.
66	* @param channel A non-null <code>SamplerChannel</code> instance containing the current
67	* settings of the channel which will be represented by this sampler channel model.
68	* @throws IllegalArgumentException If <code>channel</code> is <code>null</code>.
69	*/
70	public DefaultSamplerChannelModel(SamplerChannel channel) {
71	if(channel == null) throw new IllegalArgumentException("channel must be non null");
72	this.channel = channel;
73	}
74
75	/**
76	* Registers the specified listener for receiving event messages.
77	* @param l The <code>SamplerChannelListener</code> to register.
78	*/
79	public void
80	addSamplerChannelListener(SamplerChannelListener l) { listeners.add(l); }
81
82	/**
83	* Removes the specified listener.
84	* @param l The <code>SamplerChannelListener</code> to remove.
85	*/
86	public void
87	removeSamplerChannelListener(SamplerChannelListener l) { listeners.remove(l); }
88
89	/**
90	* Gets the sampler channel number.
91	* @return The sampler channel number or -1 if the sampler channel number is not set.
92	*/
93	public int
94	getChannelID() { return channel == null ? -1 : channel.getChannelID(); }
95
96	/**
97	* Gets the current settings of the sampler channel.
98	* @return <code>SamplerChannel</code> instance containing
99	* the current settings of the sampler channel.
100	*/
101	public SamplerChannel
102	getChannelInfo() { return channel; }
103
104	/**
105	* Sets the current settings of the sampler channel.
106	* Note that this method does not changes the channel settings on
107	* the back-end. It is invoked to update them when the back-end
108	* notifies that the channel settings are changed.
109	* @param channel A <code>SamplerChannel</code> instance containing
110	* the new settings for this sampler channel.
111	* @throws IllegalArgumentException If <code>channel</code> is <code>null</code>.
112	*/
113	public void
114	setChannelInfo(SamplerChannel channel) {
115	if(channel == null) throw new IllegalArgumentException("channel must be non null");
116	if(this.channel == channel) return;
117
118	this.channel = channel;
119	fireSamplerChannelChanged();
120	}
121
122	/**
123	* Gets the number of active disk streams.
124	* @return The number of active disk streams.
125	*/
126	public int
127	getStreamCount() { return streamCount; }
128
129	/**
130	* Sets the number of active disk streams.
131	* @param count The new number of active disk streams.
132	*/
133	public void
134	setStreamCount(int count) {
135	if(streamCount == count) return;
136
137	streamCount = count;
138	fireStreamCountChanged();
139	}
140
141	/**
142	* Gets the number of active voices.
143	* @return The number of active voices.
144	*/
145	public int
146	getVoiceCount() { return voiceCount; }
147
148	/**
149	* Sets the number of active voices.
150	* @param count The new number of active voices.
151	*/
152	public void
153	setVoiceCount(int count) {
154	if(voiceCount == count) return;
155
156	voiceCount = count;
157	fireVoiceCountChanged();
158	}
159
160	/**
161	* Sets the sampler engine type to be used.
162	* @param engine The name of the engine type to be used.
163	*/
164	public void
165	setEngineType(String engine) {
166	final LoadEngine loadEngine = new LoadEngine(engine, getChannelID());
167	final SamplerChannelEvent event = new SamplerChannelEvent(this);
168
169	loadEngine.addTaskListener(new TaskListener() {
170	public void
171	taskPerformed(TaskEvent e) {
172	/*
173	* Because with the invokation of the method the task is considered
174	* to be done, if the task fails, we must notify for a channel
175	* changes. This should be done to revert the old channel settings.
176	*/
177	if(loadEngine.doneWithErrors()) fireSamplerChannelChanged(event);
178	}
179	});
180	CC.getTaskQueue().add(loadEngine);
181
182	// We leave this event to be notified by the LinuxSampler notification system.
183	}
184
185	/**
186	* Sets the mute mode of the channel.
187	* @param mute Specifies the mute mode. If <code>true</code> the channel is muted, else
188	* the channel is unmuted.
189	*/
190	public void
191	setMute(boolean mute) {
192	final SetMuteChannel smc = new SetMuteChannel(getChannelID(), mute);
193	final SamplerChannelEvent event = new SamplerChannelEvent(this);
194
195	smc.addTaskListener(new TaskListener() {
196	public void
197	taskPerformed(TaskEvent e) {
198	/*
199	* Because with the invokation of the method the task is considered
200	* to be done, if the task fails, we must notify for a channel
201	* changes. This should be done to revert the old channel settings.
202	*/
203	if(smc.doneWithErrors()) fireSamplerChannelChanged(event);
204	}
205	});
206	CC.getTaskQueue().add(smc);
207
208	// We leave this event to be notified by the LinuxSampler notification system.
209	}
210
211	/**
212	* Sets the solo mode of the channel.
213	* @param solo Specifies the solo mode. If <code>true</code> the channel is soloed, else
214	* the channel is unsoloed.
215	*/
216	public void
217	setSolo(boolean solo) {
218	final SetSoloChannel ssc = new SetSoloChannel(getChannelID(), solo);
219	final SamplerChannelEvent event = new SamplerChannelEvent(this);
220
221	ssc.addTaskListener(new TaskListener() {
222	public void
223	taskPerformed(TaskEvent e) {
224	/*
225	* Because with the invokation of the method the task is considered
226	* to be done, if the task fails, we must notify for a channel
227	* changes. This should be done to revert the old channel settings.
228	*/
229	if(ssc.doneWithErrors()) fireSamplerChannelChanged(event);
230	}
231	});
232	CC.getTaskQueue().add(ssc);
233
234	// We leave this event to be notified by the LinuxSampler notification system.
235	}
236
237	/**
238	* Sets the channel volume.
239	* @param volume Specifies the new volume value.
240	*/
241	public void
242	setVolume(float volume) {
243	final SetChannelVolume scv = new SetChannelVolume(getChannelID(), volume);
244	final SamplerChannelEvent event = new SamplerChannelEvent(this);
245
246	scv.addTaskListener(new TaskListener() {
247	public void
248	taskPerformed(TaskEvent e) {
249	/*
250	* Because with the invokation of the method the task is considered
251	* to be done, if the task fails, we must notify for a channel
252	* changes. This should be done to revert the old channel settings.
253	*/
254	if(scv.doneWithErrors()) fireSamplerChannelChanged(event);
255	}
256	});
257	CC.getTaskQueue().add(scv);
258
259	// We leave this event to be notified by the LinuxSampler notification system.
260	}
261
262	/**
263	* Sets the MIDI input device of the channel represented by this model.
264	* @param deviceID Specifies the numerical ID of the MIDI input device to be set.
265	*/
266	public void
267	setMidiInputDevice(int deviceID) {
268	final Task scmid = new SetChannelMidiInputDevice(getChannelID(), deviceID);
269	final SamplerChannelEvent event = new SamplerChannelEvent(this);
270
271	scmid.addTaskListener(new TaskListener() {
272	public void
273	taskPerformed(TaskEvent e) {
274	/*
275	* Because with the invokation of the method the task is considered
276	* to be done, if the task fails, we must notify for a channel
277	* changes. This should be done to revert the old channel settings.
278	*/
279	if(scmid.doneWithErrors()) fireSamplerChannelChanged(event);
280	}
281	});
282	CC.getTaskQueue().add(scmid);
283
284	// We leave this event to be notified by the LinuxSampler notification system.
285	}
286
287	/**
288	* Sets the MIDI input port of the channel represented by this model.
289	* @param port Specifies the number of the MIDI input port.
290	*/
291	public void
292	setMidiInputPort(int port) {
293	final Task scmip = new SetChannelMidiInputPort(getChannelID(), port);
294	final SamplerChannelEvent event = new SamplerChannelEvent(this);
295
296	scmip.addTaskListener(new TaskListener() {
297	public void
298	taskPerformed(TaskEvent e) {
299	/*
300	* Because with the invokation of the method the task is considered
301	* to be done, if the task fails, we must notify for a channel
302	* changes. This should be done to revert the old channel settings.
303	*/
304	if(scmip.doneWithErrors()) fireSamplerChannelChanged(event);
305	}
306	});
307	CC.getTaskQueue().add(scmip);
308
309	// We leave this event to be notified by the LinuxSampler notification system.
310	}
311
312	/**
313	* Sets the MIDI channel that the channel represented by this model should listen to.
314	* @param channel Specifies the MIDI channel that the channel
315	* represented by this model should listen to.
316	*/
317	public void
318	setMidiInputChannel(int channel) {
319	final Task scmic = new SetChannelMidiInputChannel(getChannelID(), channel);
320	final SamplerChannelEvent event = new SamplerChannelEvent(this);
321
322	scmic.addTaskListener(new TaskListener() {
323	public void
324	taskPerformed(TaskEvent e) {
325	/*
326	* Because with the invokation of the method the task is considered
327	* to be done, if the task fails, we must notify for a channel
328	* changes. This should be done to revert the old channel settings.
329	*/
330	if(scmic.doneWithErrors()) fireSamplerChannelChanged(event);
331	}
332	});
333	CC.getTaskQueue().add(scmic);
334
335	// We leave this event to be notified by the LinuxSampler notification system.
336	}
337
338	/**
339	* Sets the audio output device of the channel represented by this model.
340	* @param deviceID Specifies the numerical ID of the audio output device to be set.
341	*/
342	public void
343	setAudioOutputDevice(int deviceID) {
344	final Task scaod = new SetChannelAudioOutputDevice(getChannelID(), deviceID);
345	final SamplerChannelEvent event = new SamplerChannelEvent(this);
346
347	scaod.addTaskListener(new TaskListener() {
348	public void
349	taskPerformed(TaskEvent e) {
350	/*
351	* Because with the invokation of the method the task is considered
352	* to be done, if the task fails, we must notify for a channel
353	* changes. This should be done to revert the old channel settings.
354	*/
355	if(scaod.doneWithErrors()) fireSamplerChannelChanged(event);
356	}
357	});
358	CC.getTaskQueue().add(scaod);
359
360	// We leave this event to be notified by the LinuxSampler notification system.
361	}
362
363	/**
364	* Loads and assigns the specified instrument
365	* to the sampler channel represented by this model.
366	* @param filename The file name of the instrument to be loaded.
367	* @param InstrIndex The index of the instrument in the instrument file to be loaded.
368	*/
369	public void
370	loadInstrument(String filename, int InstrIndex) {
371	final Task li = new LoadInstrument(filename, InstrIndex, getChannelID());
372	CC.getTaskQueue().add(li);
373
374	// We leave this event to be notified by the LinuxSampler notification system.
375	}
376
377	/** Resets the channel. */
378	public void
379	resetChannel() {
380	CC.getTaskQueue().add(new ResetChannel(getChannelID()));
381
382	// We leave this event to be notified by the LinuxSampler notification system.
383	}
384
385	/** Duplicates the channel. */
386	public void
387	duplicateChannel() {
388	CC.getTaskQueue().add(new DuplicateChannels(getChannelInfo()));
389	}
390
391	/** Notifies listeners that the sampler channel settings has changed. */
392	protected void
393	fireSamplerChannelChanged() {
394	final SamplerChannelEvent e = new SamplerChannelEvent(this);
395
396	SwingUtilities.invokeLater(new Runnable() {
397	public void
398	run() { fireSamplerChannelChanged(e); }
399	});
400	}
401
402	/**
403	* Notifies listeners that the sampler channel settings has changed.
404	* This method should be invoked from the event-dispatching thread.
405	*/
406	protected void
407	fireSamplerChannelChanged(SamplerChannelEvent e) {
408	for(SamplerChannelListener l : listeners) l.channelChanged(e);
409	}
410
411	/** Notifies listeners that the number of active disk streams has changed. */
412	protected void
413	fireStreamCountChanged() {
414	final SamplerChannelEvent e = new SamplerChannelEvent(this);
415
416	SwingUtilities.invokeLater(new Runnable() {
417	public void
418	run() { fireStreamCountChanged(e); }
419	});
420	}
421
422	/**
423	* Notifies listeners that the number of active disk streams has changed.
424	* This method should be invoked from the event-dispatching thread.
425	*/
426	protected void
427	fireStreamCountChanged(SamplerChannelEvent e) {
428	for(SamplerChannelListener l : listeners) l.streamCountChanged(e);
429	}
430
431	/** Notifies listeners that the number of active voices has changed. */
432	protected void
433	fireVoiceCountChanged() {
434	final SamplerChannelEvent e = new SamplerChannelEvent(this);
435
436	SwingUtilities.invokeLater(new Runnable() {
437	public void
438	run() { fireVoiceCountChanged(e); }
439	});
440	}
441
442	/**
443	* Notifies listeners that the number of active voices has changed.
444	* This method should be invoked from the event-dispatching thread.
445	*/
446	protected void
447	fireVoiceCountChanged(SamplerChannelEvent e) {
448	for(SamplerChannelListener l : listeners) l.voiceCountChanged(e);
449	}
450	}