trunk/src/Sampler.h

/***************************************************************************
 *                                                                         *
 *   LinuxSampler - modular, streaming capable sampler                     *
 *                                                                         *
 *   Copyright (C) 2003, 2004 by Benno Senoner and Christian Schoenebeck   *
 *   Copyright (C) 2005 Christian Schoenebeck                              *
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 *   This program 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 this program; if not, write to the Free Software           *
 *   Foundation, Inc., 59 Temple Place, Suite 330, Boston,                 *
 *   MA  02111-1307  USA                                                   *
 ***************************************************************************/

#ifndef __LS_SAMPLER_H__
#define __LS_SAMPLER_H__

#include <vector>
#include <map>
#include "common/global.h"
#include "common/LinuxSamplerException.h"
#include "engines/common/EngineChannel.h"
#include "drivers/midi/MidiInputDevice.h"
#include "drivers/audio/AudioOutputDevice.h"

namespace LinuxSampler {

    // just symbol prototyping
    class Sampler;

    /** @brief LinuxSampler sampler channel
     *
     * Encapsulates a channel of a specific sampler engine typ, one
     * connection to a MIDI input device and one connection to an audio
     * output device. You cannot create an instance of this class on your
     * own, you have to use the AddSamplerChannel() method of the Sampler
     * object to create a new sampler channel.
     */
    class SamplerChannel {
        public:
            /**
             * Assign a sampler engine type to this sampler channel.
             *
             * @param EngineType - type of the engine to use
             * @throws LinuxSamplerException - if \a EngineType is invalid
             */
            void SetEngineType(String EngineType) throw (LinuxSamplerException);

            /**
             * Connect this sampler channel to an audio output device, that
             * is an instance of an audio output driver. If this sampler
             * channel was already connected to an audio output device, then
             * the old connection will automatically be removed before.
             *
             * @param pDevice - audio output device to connect to
             */
            void SetAudioOutputDevice(AudioOutputDevice* pDevice);

            /**
             * Connect this sampler channel to a MIDI input device.
             *
             * @param pDevice - MIDI input device to connect to
             */
            void SetMidiInputDevice(MidiInputDevice *pDevice);

            /**
             * Connect this sampler channel to a MIDI input port.
             *
             * @param MidiPort - MIDI port to connect to
             */
            void SetMidiInputPort(int MidiPort);

            /**
             * Define on which MIDI channel(s) this sampler channel should
             * listen to. By default, that is after creation of a new
             * sampler channel, the sampler channel will listen to all MIDI
             * channels.
             *
             * @param MidiChannel - MIDI channel to listen
             */
            void SetMidiInputChannel(MidiInputPort::midi_chan_t MidiChannel);

            /**
             * Connect this sampler channel to a MIDI input triplet.
             *
             * @param pDevice - MIDI input device to connect to
             * @param iMidiPort - MIDI port to connect to
             * @param MidiChannel - optional: MIDI channel on which the
             *                      sampler channel should listen to
             *                      (default: listen on all MIDI channels)
             */
            void SetMidiInput(MidiInputDevice* pDevice, int iMidiPort, MidiInputPort::midi_chan_t MidiChannel = MidiInputPort::midi_chan_all);

            /**
             * Returns the EngineChannel object that was deployed on this
             * sampler channel appropriate to the given sampler engine type.
             *
             * @returns  pointer to engine or NULL if no engine deployed
             */
            EngineChannel* GetEngineChannel();

            /**
             * Returns the MIDI input channel to which this sampler
             * channel is currently connected to.
             *
             * @returns  The MIDI input channel on which the sampler
             *           channel is listening to.
             */
            MidiInputPort::midi_chan_t GetMidiInputChannel();

            /**
             * Returns the MIDI input port number to which this sampler
             * channel is currently connected to.
             *
             * @returns  MIDI input port number or -1 if not connected
             */
            int GetMidiInputPort();

            /**
             * Returns the audio output device to which this sampler channel
             * is currently connected to.
             *
             * @returns  pointer to audio output device or NULL if not
             *           connected
             */
            AudioOutputDevice* GetAudioOutputDevice();

            /**
             * Returns the MIDI input device to which this sampler channel
             * is currently connected to.
             *
             * @returns  pointer to MIDI input device or NULL if not
             *           connected
             */
            MidiInputDevice* GetMidiInputDevice();

            /**
             * Returns the index number of this sampler channel within the
             * Sampler instance.
             */
            uint Index();

        protected:
            SamplerChannel(Sampler* pS);
            virtual ~SamplerChannel();

            /** Getting MIDI input device port given its index number. */
            MidiInputPort* GetMidiInputDevicePort(int iMidiPort);

            Sampler*           pSampler;
            EngineChannel*     pEngineChannel;
            AudioOutputDevice* pAudioOutputDevice;
            MidiInputDevice*   pMidiInputDevice;
            int                midiPort;
            MidiInputPort::midi_chan_t midiChannel;
            int                iIndex;

            friend class Sampler;
    };

    /** @brief LinuxSampler main class
     *
     * This is the toplevel class for a LinuxSampler instance.
     *
     * LinuxSampler can have arbitrary numbers of sampler channels. Each
     * sampler channel can individually be deployed with it's own sampler
     * engine, connected to an arbitrary MIDI input device and connected to
     * an arbitrary audio output device. Here an example setup:
     *
     *  S.Channel.      MIDI in         S.Engine                Audio out
     *  -------------------------------------------------------------------
     *  0               Alsa    ->      gig::Engine     ->      Jack
     *  1               VSTi    ->      Akai::Engine    ->      VSTi
     *  2               Jack    ->      DLS::Engine     ->      Jack
     *  3               Jack    ->      SF::Engine      ->      Alsa
     *
     *  ... (and so on) ...
     *
     * Note that not all audio and MIDI backends and sampler engines listed
     * in the example above are already implemented!
     *
     * As you can see in the example setup, LinuxSampler is capable to use
     * several, different audio output and MIDI input systems
     * simultaniously at the same time. Here the example setup shown in the
     * ascpect of MIDI input and audio output devices / drivers:
     *
     *                            ######################### #########################
     *                            # AudioOutputDeviceJack # # AudioOutputDeviceVSTi #
     *                            ######################### #########################
     *                                          ^   ^           ^
     *    /------------>|Sampler Channel 0|-----/   |           |
     *    |  /--------->|Sampler Channel 1|---------------------/
     *    |  |    /---->|Sampler Channel 2|---------/
     *    |  |    |  /->|Sampler Channel 3|------------>#########################
     *    |  |    |  |  ... (and so on) ...             # AudioOutputDeviceAlsa #
     *    |  |    |  |                                  #########################
     *    |  |    |  \----------------------------------------------------\
     *    |  |    \-------------------------------------------\           |
     *    |  \--------------------\                           |           |
     *    |                       |                           |           |
     *  ####################### ####################### #######################
     *  # MidiInputDeviceAlsa # # MidiInputDeviceVSTi # # MidiInputDeviceJack #
     *  ####################### ####################### #######################
     *
     * As you can see in this example setup, one device (that is midi input
     * driver / audio output driver) can be connected multiple times to
     * different sampler channels.
     */
    class Sampler {
        public:
            /**
             * Constructor. Create a LinuxSampler instance.
             */
            Sampler();

            /**
             * Destructor.
             */
            virtual ~Sampler();

            /**
             * Returns the number of sampler channels currently allocated.
             */
            uint SamplerChannels();

            /**
             * Create and add a new sampler channel to this Sampler
             * instance. For race condition reasons the new channel will use
             * an index past the last already existing sampler channel
             * index (in case the index limit was not reached yet, otherwise
             * a free index starting from 0 is searched).
             *
             * @returns  pointer to new sampler channel
             */
            SamplerChannel* AddSamplerChannel();

            /**
             * Returns the sampler channel of the given sampler channel
             * index.
             *
             * @returns  pointer to sought sampler channel
             */
            SamplerChannel* GetSamplerChannel(uint uiSamplerChannel);

            /**
             * Returns all created sampler channels.
             */
            std::map<uint, SamplerChannel*> GetSamplerChannels();

            /**
             * Destroy and remove the given sampler channel from this
             * Sampler instance.
             *
             * @param pSamplerChannel - pointer to sampler channel to remove
             */
            void RemoveSamplerChannel(SamplerChannel* pSamplerChannel);

            /**
             * Destroy and remove the given sampler channel from this
             * Sampler instance.
             *
             * @param uiSamplerChannel - index of the sampler channel to
             *                           remove
             */
            void RemoveSamplerChannel(uint uiSamplerChannel);

            /**
             * Returns the names of all available audio output drivers.
             */
            std::vector<String> AvailableAudioOutputDrivers();

            /**
             * Create an audio output device.
             *
             * @param AudioDriver - name of the audio driver
             * @param Parameters - eventually needed driver parameters to
             *                     create the device
             * @returns  pointer to created audio output device
             * @throws LinuxSamplerException  if device could not be created
             */
            AudioOutputDevice* CreateAudioOutputDevice(String AudioDriver, std::map<String,String> Parameters) throw (LinuxSamplerException);

            /**
             * Create a midi input device.
             *
             * @param MidiDriver - name of the midi driver
             * @param Parameters - eventually needed driver parameters to
             *                     create the device
             * @returns  pointer to created midi input device
             * @throws LinuxSamplerException  if device could not be created
             */
            MidiInputDevice* CreateMidiInputDevice(String MidiDriver, std::map<String,String> Parameters) throw (LinuxSamplerException);

            /**
             * Returns the number of all created audio output devices.
             */
            uint AudioOutputDevices();

            /**
             * Returns the number of all created MIDI input devices.
             */
            uint MidiInputDevices();

            /**
             * Returns all created audio output devices.
             */
            std::map<uint, AudioOutputDevice*> GetAudioOutputDevices();

            /**
             * Returns all created MIDI input devices.
             */
            std::map<uint, MidiInputDevice*> GetMidiInputDevices();

            /**
             * Destroy the given audio output device and takes care if there
             * are still sampler angines connected to this device, etc.
             *
             * @throws LinuxSamplerException  if sampler channels are still
             *                                connected to the device
             */
            void DestroyAudioOutputDevice(AudioOutputDevice* pDevice) throw (LinuxSamplerException);

            /**
             * Destroy the given MIDI input device and takes care if there
             * are still sampler angines connected to this device, etc.
             *
             * @throws LinuxSamplerException  if sampler channels are still
             *                                connected to the device
             */
            void DestroyMidiInputDevice(MidiInputDevice* pDevice) throw (LinuxSamplerException);

            /**
             * Reset the whole sampler. Destroy all engines, sampler
             * channels, MIDI input devices and audio output devices.
             */
            void Reset();

        protected:
            typedef std::map<uint, AudioOutputDevice*> AudioOutputDeviceMap;
            typedef std::map<uint, MidiInputDevice*> MidiInputDeviceMap;
            typedef std::map<uint, SamplerChannel*> SamplerChannelMap;

            SamplerChannelMap     mSamplerChannels;    ///< contains all created sampler channels
            AudioOutputDeviceMap  mAudioOutputDevices; ///< contains all created audio output devices
            MidiInputDeviceMap    mMidiInputDevices;   ///< contains all created MIDI input devices

            friend class SamplerChannel;
    };
}

#endif // __LS_SAMPLER_H__
1	schoenebeck	53	/***************************************************************************
2			* *
3			* LinuxSampler - modular, streaming capable sampler *
4			* *
5	schoenebeck	61	* Copyright (C) 2003, 2004 by Benno Senoner and Christian Schoenebeck *
6	schoenebeck	411	* Copyright (C) 2005 Christian Schoenebeck *
7	schoenebeck	53	* *
8			* This program is free software; you can redistribute it and/or modify *
9			* it under the terms of the GNU General Public License as published by *
10			* the Free Software Foundation; either version 2 of the License, or *
11			* (at your option) any later version. *
12			* *
13			* This program is distributed in the hope that it will be useful, *
14			* but WITHOUT ANY WARRANTY; without even the implied warranty of *
15			* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
16			* GNU General Public License for more details. *
17			* *
18			* You should have received a copy of the GNU General Public License *
19			* along with this program; if not, write to the Free Software *
20			* Foundation, Inc., 59 Temple Place, Suite 330, Boston, *
21			* MA 02111-1307 USA *
22			***************************************************************************/
23
24			#ifndef __LS_SAMPLER_H__
25			#define __LS_SAMPLER_H__
26
27			#include <vector>
28			#include <map>
29			#include "common/global.h"
30			#include "common/LinuxSamplerException.h"
31	schoenebeck	411	#include "engines/common/EngineChannel.h"
32	schoenebeck	203	#include "drivers/midi/MidiInputDevice.h"
33			#include "drivers/audio/AudioOutputDevice.h"
34	schoenebeck	53
35			namespace LinuxSampler {
36
37			// just symbol prototyping
38			class Sampler;
39
40	schoenebeck	411	/** @brief LinuxSampler sampler channel
41	schoenebeck	57	*
42	schoenebeck	411	* Encapsulates a channel of a specific sampler engine typ, one
43			* connection to a MIDI input device and one connection to an audio
44			* output device. You cannot create an instance of this class on your
45			* own, you have to use the AddSamplerChannel() method of the Sampler
46			* object to create a new sampler channel.
47	schoenebeck	57	*/
48	schoenebeck	53	class SamplerChannel {
49			public:
50	schoenebeck	57	/**
51	schoenebeck	411	* Assign a sampler engine type to this sampler channel.
52	schoenebeck	57	*
53	schoenebeck	411	* @param EngineType - type of the engine to use
54			* @throws LinuxSamplerException - if \a EngineType is invalid
55	schoenebeck	57	*/
56	schoenebeck	411	void SetEngineType(String EngineType) throw (LinuxSamplerException);
57	schoenebeck	57
58			/**
59	schoenebeck	123	* Connect this sampler channel to an audio output device, that
60			* is an instance of an audio output driver. If this sampler
61			* channel was already connected to an audio output device, then
62			* the old connection will automatically be removed before.
63	schoenebeck	57	*
64	schoenebeck	123	* @param pDevice - audio output device to connect to
65	schoenebeck	57	*/
66	schoenebeck	123	void SetAudioOutputDevice(AudioOutputDevice* pDevice);
67	schoenebeck	57
68			/**
69	schoenebeck	411	* Connect this sampler channel to a MIDI input device.
70	schoenebeck	57	*
71	capela	159	* @param pDevice - MIDI input device to connect to
72			*/
73			void SetMidiInputDevice(MidiInputDevice *pDevice);
74
75			/**
76	schoenebeck	411	* Connect this sampler channel to a MIDI input port.
77	capela	159	*
78			* @param MidiPort - MIDI port to connect to
79			*/
80			void SetMidiInputPort(int MidiPort);
81
82			/**
83	schoenebeck	411	* Define on which MIDI channel(s) this sampler channel should
84			* listen to. By default, that is after creation of a new
85			* sampler channel, the sampler channel will listen to all MIDI
86			* channels.
87	capela	159	*
88	schoenebeck	411	* @param MidiChannel - MIDI channel to listen
89	capela	159	*/
90	schoenebeck	221	void SetMidiInputChannel(MidiInputPort::midi_chan_t MidiChannel);
91	capela	159
92			/**
93			* Connect this sampler channel to a MIDI input triplet.
94			*
95			* @param pDevice - MIDI input device to connect to
96	schoenebeck	221	* @param iMidiPort - MIDI port to connect to
97	schoenebeck	57	* @param MidiChannel - optional: MIDI channel on which the
98			* sampler channel should listen to
99			* (default: listen on all MIDI channels)
100			*/
101	schoenebeck	221	void SetMidiInput(MidiInputDevice* pDevice, int iMidiPort, MidiInputPort::midi_chan_t MidiChannel = MidiInputPort::midi_chan_all);
102	schoenebeck	57
103			/**
104	schoenebeck	411	* Returns the EngineChannel object that was deployed on this
105			* sampler channel appropriate to the given sampler engine type.
106	schoenebeck	57	*
107			* @returns pointer to engine or NULL if no engine deployed
108			*/
109	schoenebeck	411	EngineChannel* GetEngineChannel();
110	schoenebeck	57
111			/**
112	capela	159	* Returns the MIDI input channel to which this sampler
113			* channel is currently connected to.
114	schoenebeck	57	*
115	capela	159	* @returns The MIDI input channel on which the sampler
116			* channel is listening to.
117	schoenebeck	57	*/
118	schoenebeck	221	MidiInputPort::midi_chan_t GetMidiInputChannel();
119	schoenebeck	57
120			/**
121	capela	159	* Returns the MIDI input port number to which this sampler
122			* channel is currently connected to.
123			*
124			* @returns MIDI input port number or -1 if not connected
125			*/
126			int GetMidiInputPort();
127
128			/**
129	schoenebeck	57	* Returns the audio output device to which this sampler channel
130			* is currently connected to.
131			*
132			* @returns pointer to audio output device or NULL if not
133			* connected
134			*/
135			AudioOutputDevice* GetAudioOutputDevice();
136
137			/**
138	capela	159	* Returns the MIDI input device to which this sampler channel
139	senkov	155	* is currently connected to.
140			*
141	capela	159	* @returns pointer to MIDI input device or NULL if not
142	senkov	155	* connected
143			*/
144			MidiInputDevice* GetMidiInputDevice();
145
146			/**
147	schoenebeck	57	* Returns the index number of this sampler channel within the
148			* Sampler instance.
149			*/
150			uint Index();
151
152			protected:
153	schoenebeck	53	SamplerChannel(Sampler* pS);
154	letz	502	virtual ~SamplerChannel();
155	schoenebeck	57
156	capela	159	/** Getting MIDI input device port given its index number. */
157	schoenebeck	221	MidiInputPort* GetMidiInputDevicePort(int iMidiPort);
158	schoenebeck	203
159	schoenebeck	53	Sampler* pSampler;
160	schoenebeck	411	EngineChannel* pEngineChannel;
161	schoenebeck	53	AudioOutputDevice* pAudioOutputDevice;
162	capela	159	MidiInputDevice* pMidiInputDevice;
163			int midiPort;
164	schoenebeck	221	MidiInputPort::midi_chan_t midiChannel;
165	schoenebeck	53	int iIndex;
166	schoenebeck	57
167			friend class Sampler;
168	schoenebeck	53	};
169
170	schoenebeck	411	/** @brief LinuxSampler main class
171	schoenebeck	57	*
172			* This is the toplevel class for a LinuxSampler instance.
173			*
174			* LinuxSampler can have arbitrary numbers of sampler channels. Each
175			* sampler channel can individually be deployed with it's own sampler
176			* engine, connected to an arbitrary MIDI input device and connected to
177			* an arbitrary audio output device. Here an example setup:
178			*
179			* S.Channel. MIDI in S.Engine Audio out
180			* -------------------------------------------------------------------
181			* 0 Alsa -> gig::Engine -> Jack
182			* 1 VSTi -> Akai::Engine -> VSTi
183			* 2 Jack -> DLS::Engine -> Jack
184			* 3 Jack -> SF::Engine -> Alsa
185			*
186			* ... (and so on) ...
187			*
188			* Note that not all audio and MIDI backends and sampler engines listed
189			* in the example above are already implemented!
190			*
191			* As you can see in the example setup, LinuxSampler is capable to use
192			* several, different audio output and MIDI input systems
193			* simultaniously at the same time. Here the example setup shown in the
194			* ascpect of MIDI input and audio output devices / drivers:
195			*
196			* ######################### #########################
197			* # AudioOutputDeviceJack # # AudioOutputDeviceVSTi #
198			* ######################### #########################
199			* ^ ^ ^
200			* /------------>\|Sampler Channel 0\|-----/ \| \|
201			* \| /--------->\|Sampler Channel 1\|---------------------/
202			* \| \| /---->\|Sampler Channel 2\|---------/
203			* \| \| \| /->\|Sampler Channel 3\|------------>#########################
204			* \| \| \| \| ... (and so on) ... # AudioOutputDeviceAlsa #
205			* \| \| \| \| #########################
206			* \| \| \| \----------------------------------------------------\
207			* \| \| \-------------------------------------------\ \|
208			* \| \--------------------\ \| \|
209			* \| \| \| \|
210			* ####################### ####################### #######################
211			* # MidiInputDeviceAlsa # # MidiInputDeviceVSTi # # MidiInputDeviceJack #
212			* ####################### ####################### #######################
213			*
214			* As you can see in this example setup, one device (that is midi input
215			* driver / audio output driver) can be connected multiple times to
216			* different sampler channels.
217			*/
218	schoenebeck	53	class Sampler {
219			public:
220	schoenebeck	57	/**
221			* Constructor. Create a LinuxSampler instance.
222			*/
223	schoenebeck	53	Sampler();
224	schoenebeck	57
225			/**
226			* Destructor.
227			*/
228	letz	502	virtual ~Sampler();
229	schoenebeck	57
230			/**
231			* Returns the number of sampler channels currently allocated.
232			*/
233			uint SamplerChannels();
234
235			/**
236	schoenebeck	209	* Create and add a new sampler channel to this Sampler
237			* instance. For race condition reasons the new channel will use
238			* an index past the last already existing sampler channel
239			* index (in case the index limit was not reached yet, otherwise
240			* a free index starting from 0 is searched).
241	schoenebeck	57	*
242			* @returns pointer to new sampler channel
243			*/
244			SamplerChannel* AddSamplerChannel();
245
246			/**
247			* Returns the sampler channel of the given sampler channel
248			* index.
249			*
250			* @returns pointer to sought sampler channel
251			*/
252			SamplerChannel* GetSamplerChannel(uint uiSamplerChannel);
253
254			/**
255	schoenebeck	209	* Returns all created sampler channels.
256			*/
257			std::map<uint, SamplerChannel*> GetSamplerChannels();
258
259			/**
260	schoenebeck	57	* Destroy and remove the given sampler channel from this
261			* Sampler instance.
262			*
263			* @param pSamplerChannel - pointer to sampler channel to remove
264			*/
265			void RemoveSamplerChannel(SamplerChannel* pSamplerChannel);
266
267			/**
268			* Destroy and remove the given sampler channel from this
269			* Sampler instance.
270			*
271			* @param uiSamplerChannel - index of the sampler channel to
272			* remove
273			*/
274			void RemoveSamplerChannel(uint uiSamplerChannel);
275
276	schoenebeck	209	/**
277			* Returns the names of all available audio output drivers.
278			*/
279	schoenebeck	123	std::vector<String> AvailableAudioOutputDrivers();
280
281	schoenebeck	57	/**
282	senkov	155	* Create an audio output device.
283	schoenebeck	57	*
284	schoenebeck	123	* @param AudioDriver - name of the audio driver
285			* @param Parameters - eventually needed driver parameters to
286			* create the device
287	schoenebeck	57	* @returns pointer to created audio output device
288	schoenebeck	123	* @throws LinuxSamplerException if device could not be created
289	schoenebeck	57	*/
290	schoenebeck	123	AudioOutputDevice* CreateAudioOutputDevice(String AudioDriver, std::map<String,String> Parameters) throw (LinuxSamplerException);
291	schoenebeck	57
292	senkov	155	/**
293			* Create a midi input device.
294			*
295			* @param MidiDriver - name of the midi driver
296			* @param Parameters - eventually needed driver parameters to
297			* create the device
298			* @returns pointer to created midi input device
299			* @throws LinuxSamplerException if device could not be created
300			*/
301			MidiInputDevice* CreateMidiInputDevice(String MidiDriver, std::map<String,String> Parameters) throw (LinuxSamplerException);
302
303	schoenebeck	209	/**
304			* Returns the number of all created audio output devices.
305			*/
306	schoenebeck	123	uint AudioOutputDevices();
307	schoenebeck	209
308			/**
309			* Returns the number of all created MIDI input devices.
310			*/
311	senkov	155	uint MidiInputDevices();
312	schoenebeck	57
313	schoenebeck	209	/**
314			* Returns all created audio output devices.
315			*/
316	schoenebeck	123	std::map<uint, AudioOutputDevice*> GetAudioOutputDevices();
317
318	schoenebeck	209	/**
319			* Returns all created MIDI input devices.
320			*/
321	senkov	155	std::map<uint, MidiInputDevice*> GetMidiInputDevices();
322
323	schoenebeck	209	/**
324			* Destroy the given audio output device and takes care if there
325			* are still sampler angines connected to this device, etc.
326			*
327			* @throws LinuxSamplerException if sampler channels are still
328			* connected to the device
329			*/
330	schoenebeck	123	void DestroyAudioOutputDevice(AudioOutputDevice* pDevice) throw (LinuxSamplerException);
331
332	schoenebeck	209	/**
333			* Destroy the given MIDI input device and takes care if there
334			* are still sampler angines connected to this device, etc.
335			*
336			* @throws LinuxSamplerException if sampler channels are still
337			* connected to the device
338			*/
339			void DestroyMidiInputDevice(MidiInputDevice* pDevice) throw (LinuxSamplerException);
340
341	schoenebeck	212	/**
342			* Reset the whole sampler. Destroy all engines, sampler
343			* channels, MIDI input devices and audio output devices.
344			*/
345			void Reset();
346
347	schoenebeck	53	protected:
348	schoenebeck	123	typedef std::map<uint, AudioOutputDevice*> AudioOutputDeviceMap;
349	senkov	155	typedef std::map<uint, MidiInputDevice*> MidiInputDeviceMap;
350	schoenebeck	209	typedef std::map<uint, SamplerChannel*> SamplerChannelMap;
351	schoenebeck	53
352	schoenebeck	209	SamplerChannelMap mSamplerChannels; ///< contains all created sampler channels
353			AudioOutputDeviceMap mAudioOutputDevices; ///< contains all created audio output devices
354			MidiInputDeviceMap mMidiInputDevices; ///< contains all created MIDI input devices
355	schoenebeck	53
356			friend class SamplerChannel;
357			};
358			}
359
360			#endif // __LS_SAMPLER_H__