/[svn]/linuxsampler/trunk/src/Sampler.h
ViewVC logotype

Diff of /linuxsampler/trunk/src/Sampler.h

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 53 by schoenebeck, Mon Apr 26 17:15:51 2004 UTC revision 890 by schoenebeck, Sat Jul 1 13:43:04 2006 UTC
# Line 2  Line 2 
2   *                                                                         *   *                                                                         *
3   *   LinuxSampler - modular, streaming capable sampler                     *   *   LinuxSampler - modular, streaming capable sampler                     *
4   *                                                                         *   *                                                                         *
5   *   Copyright (C) 2003 by Benno Senoner and Christian Schoenebeck         *   *   Copyright (C) 2003, 2004 by Benno Senoner and Christian Schoenebeck   *
6     *   Copyright (C) 2005, 2006 Christian Schoenebeck                        *
7   *                                                                         *   *                                                                         *
8   *   This program is free software; you can redistribute it and/or modify  *   *   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  *   *   it under the terms of the GNU General Public License as published by  *
# Line 26  Line 27 
27  #include <vector>  #include <vector>
28  #include <map>  #include <map>
29  #include "common/global.h"  #include "common/global.h"
30  #include "common/LinuxSamplerException.h"  #include "common/Exception.h"
31  #include "engines/common/Engine.h"  #include "engines/EngineChannel.h"
32  #include "mididriver/MidiInputDevice.h"  #include "drivers/midi/MidiInputDevice.h"
33  #include "audiodriver/AudioOutputDevice.h"  #include "drivers/audio/AudioOutputDevice.h"
34    
35  namespace LinuxSampler {  namespace LinuxSampler {
36    
     /**  
      * Which sampler engine to be used.  
      */  
     enum engine_type_t {  
         engine_type_gig  
     };  
   
     /**  
      * Which audio output system to be used.  
      */  
     enum audio_output_type_t {  
         audio_output_type_alsa,  
         audio_output_type_jack  
     };  
   
     /**  
      * Which MIDI input system to be used.  
      */  
     enum midi_input_type_t {  
         midi_input_type_alsa  
     };  
   
37      // just symbol prototyping      // just symbol prototyping
38      class Sampler;      class Sampler;
39    
40        /** @brief LinuxSampler sampler channel
41         *
42         * Encapsulates a channel of a specific sampler engine type, 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         */
48      class SamplerChannel {      class SamplerChannel {
49          public:          public:
50              SamplerChannel(Sampler* pS);              /**
51             ~SamplerChannel();               * Assign a sampler engine type to this sampler channel.
52              void               LoadEngine(engine_type_t EngineType);               *
53              void               SetAudioOutputDevice(audio_output_type_t AudioType);               * @param EngineType - type of the engine to use
54              void               SetMidiInputDevice(midi_input_type_t MidiType, MidiInputDevice::midi_chan_t MidiChannel = MidiInputDevice::midi_chan_all);               * @throws Exception - if \a EngineType is invalid
55              Engine*            GetEngine();               */
56              MidiInputDevice*   GetMidiInputDevice();              void SetEngineType(String EngineType) throw (Exception);
57    
58                /**
59                 * 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                 *
64                 * @param pDevice - audio output device to connect to
65                 */
66                void SetAudioOutputDevice(AudioOutputDevice* pDevice);
67    
68                /**
69                 * Connect this sampler channel to a MIDI input device.
70                 *
71                 * @param pDevice - MIDI input device to connect to
72                 */
73                void SetMidiInputDevice(MidiInputDevice *pDevice);
74    
75                /**
76                 * Connect this sampler channel to a MIDI input port.
77                 *
78                 * @param MidiPort - MIDI port to connect to
79                 */
80                void SetMidiInputPort(int MidiPort);
81    
82                /**
83                 * 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                 *
88                 * @param MidiChannel - MIDI channel to listen
89                 */
90                void SetMidiInputChannel(midi_chan_t MidiChannel);
91    
92                /**
93                 * Connect this sampler channel to a MIDI input triplet.
94                 *
95                 * @param pDevice - MIDI input device to connect to
96                 * @param iMidiPort - MIDI port to connect to
97                 * @param MidiChannel - optional: MIDI channel on which the
98                 *                      sampler channel should listen to
99                 *                      (default: listen on all MIDI channels)
100                 */
101                void SetMidiInput(MidiInputDevice* pDevice, int iMidiPort, midi_chan_t MidiChannel = midi_chan_all);
102    
103                /**
104                 * Returns the EngineChannel object that was deployed on this
105                 * sampler channel appropriate to the given sampler engine type.
106                 *
107                 * @returns  pointer to engine or NULL if no engine deployed
108                 */
109                EngineChannel* GetEngineChannel();
110    
111                /**
112                 * Returns the MIDI input channel to which this sampler
113                 * channel is currently connected to.
114                 *
115                 * @returns  The MIDI input channel on which the sampler
116                 *           channel is listening to.
117                 */
118                midi_chan_t GetMidiInputChannel();
119    
120                /**
121                 * 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                 * 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();              AudioOutputDevice* GetAudioOutputDevice();
136              uint               Index();  
137                /**
138                 * Returns the MIDI input device to which this sampler channel
139                 * is currently connected to.
140                 *
141                 * @returns  pointer to MIDI input device or NULL if not
142                 *           connected
143                 */
144                MidiInputDevice* GetMidiInputDevice();
145    
146                /**
147                 * Returns the index number of this sampler channel within the
148                 * Sampler instance.
149                 */
150                uint Index();
151    
152          protected:          protected:
153                SamplerChannel(Sampler* pS);
154                virtual ~SamplerChannel();
155    
156                /** Getting MIDI input device port given its index number. */
157                MidiInputPort* __GetMidiInputDevicePort(int iMidiPort);
158    
159              Sampler*           pSampler;              Sampler*           pSampler;
160              Engine*            pEngine;              EngineChannel*     pEngineChannel;
             MidiInputDevice*   pMidiInputDevice;  
161              AudioOutputDevice* pAudioOutputDevice;              AudioOutputDevice* pAudioOutputDevice;
162                MidiInputDevice*   pMidiInputDevice;
163              int                iIndex;              int                iIndex;
164    
165                friend class Sampler;
166            private:
167                int                iMidiPort;   ///< Don't access directly, read GetMidiInputPort() instead !
168                midi_chan_t        midiChannel; ///< Don't access directly, read GetMidiInputChannel() instead !
169      };      };
170    
171        /** @brief LinuxSampler main class
172         *
173         * This is the toplevel class for a LinuxSampler instance.
174         *
175         * LinuxSampler can have arbitrary numbers of sampler channels. Each
176         * sampler channel can individually be deployed with it's own sampler
177         * engine, connected to an arbitrary MIDI input device and connected to
178         * an arbitrary audio output device. Here an example setup:
179         * @code
180         * S.Channel.       MIDI in         S.Engine                Audio out
181         * -------------------------------------------------------------------
182         * 0                Alsa    ->      gig::Engine     ->      Jack
183         * 1                VSTi    ->      Akai::Engine    ->      VSTi
184         * 2                Jack    ->      DLS::Engine     ->      Jack
185         * 3                Jack    ->      SF::Engine      ->      Alsa
186         *
187         * ... (and so on) ...
188         * @endcode
189         *
190         * Note that not all audio and MIDI backends and sampler engines listed
191         * in the example above are already implemented!
192         *
193         * As you can see in the example setup, LinuxSampler is capable to use
194         * several, different audio output and MIDI input systems
195         * simultaniously at the same time. Here the example setup shown in the
196         * ascpect of MIDI input and audio output devices / drivers:
197         * @code
198         *                    ######################### #########################
199         *                    # AudioOutputDeviceJack # # AudioOutputDeviceVSTi #
200         *                    ######################### #########################
201         *                                   ^   ^           ^
202         *   /------------>|Sampler Channel 0|-----/   |             |
203         *   |  /--------->|Sampler Channel 1|---------------------/
204         *   |  |    /------>|Sampler Channel 2|---------/
205         *   |  |    |  /--->|Sampler Channel 3|------------>#########################
206         *   |  |    |  |    ... (and so on) ...             # AudioOutputDeviceAlsa #
207         *   |  |    |  |                                    #########################
208         *   |  |    |  \-----------------------------------------------------\
209         *   |  |    \--------------------------------------------\           |
210         *   |  \--------------------\                            |           |
211         *   |                         |                          |           |
212         * ####################### ####################### #######################
213         * # MidiInputDeviceAlsa # # MidiInputDeviceVSTi # # MidiInputDeviceJack #
214         * ####################### ####################### #######################
215         * @endcode
216         *
217         * As you can see in this example setup, one device (that is midi input
218         * driver / audio output driver) can be connected multiple times to
219         * different sampler channels.
220         */
221      class Sampler {      class Sampler {
222          public:          public:
223                /**
224                 * Constructor. Create a LinuxSampler instance.
225                 */
226              Sampler();              Sampler();
            ~Sampler();  
             uint               SamplerChannels();  
             SamplerChannel*    AddSamplerChannel();  
             SamplerChannel*    GetSamplerChannel(uint uiSamplerChannel);  
             void               RemoveSamplerChannel(SamplerChannel* pSamplerChannel);  
             void               RemoveSamplerChannel(uint uiSamplerChannel);  
             AudioOutputDevice* CreateAudioOutputDevice(audio_output_type_t AudioType);  
             AudioOutputDevice* GetAudioOutputDevice(audio_output_type_t AudioType);  
             MidiInputDevice*   CreateMidiInputDevice(midi_input_type_t MidiType);  
             MidiInputDevice*   GetMidiInputDevice(midi_input_type_t MidiType);  
         protected:  
             typedef std::map<audio_output_type_t, AudioOutputDevice*> AudioOutputDeviceMap;  
             typedef std::map<midi_input_type_t, MidiInputDevice*> MidiInputDeviceMap;  
227    
228              std::vector<SamplerChannel*> vSamplerChannels;   ///< contains all created sampler channels              /**
229              AudioOutputDeviceMap         AudioOutputDevices; ///< contains all created audio output devices               * Destructor.
230              MidiInputDeviceMap           MidiInputDevices;               */
231                virtual ~Sampler();
232    
233                /**
234                 * Returns the number of sampler channels currently allocated.
235                 */
236                uint SamplerChannels();
237    
238                /**
239                 * Create and add a new sampler channel to this Sampler
240                 * instance. For race condition reasons the new channel will use
241                 * an index past the last already existing sampler channel
242                 * index (in case the index limit was not reached yet, otherwise
243                 * a free index starting from 0 is searched).
244                 *
245                 * @returns  pointer to new sampler channel
246                 */
247                SamplerChannel* AddSamplerChannel();
248    
249                /**
250                 * Returns the sampler channel of the given sampler channel
251                 * index.
252                 *
253                 * @returns  pointer to sought sampler channel
254                 */
255                SamplerChannel* GetSamplerChannel(uint uiSamplerChannel);
256    
257                /**
258                 * Returns all created sampler channels.
259                 */
260                std::map<uint, SamplerChannel*> GetSamplerChannels();
261    
262                /**
263                 * Destroy and remove the given sampler channel from this
264                 * Sampler instance.
265                 *
266                 * @param pSamplerChannel - pointer to sampler channel to remove
267                 */
268                void RemoveSamplerChannel(SamplerChannel* pSamplerChannel);
269    
270                /**
271                 * Destroy and remove the given sampler channel from this
272                 * Sampler instance.
273                 *
274                 * @param uiSamplerChannel - index of the sampler channel to
275                 *                           remove
276                 */
277                void RemoveSamplerChannel(uint uiSamplerChannel);
278    
279                /**
280                 * Returns the names of all available audio output drivers.
281                 */
282                std::vector<String> AvailableAudioOutputDrivers();
283    
284                /**
285                 * Create an audio output device.
286                 *
287                 * @param AudioDriver - name of the audio driver
288                 * @param Parameters - eventually needed driver parameters to
289                 *                     create the device
290                 * @returns  pointer to created audio output device
291                 * @throws Exception  if device could not be created
292                 */
293                AudioOutputDevice* CreateAudioOutputDevice(String AudioDriver, std::map<String,String> Parameters) throw (Exception);
294    
295                /**
296                 * Create a midi input device.
297                 *
298                 * @param MidiDriver - name of the midi driver
299                 * @param Parameters - eventually needed driver parameters to
300                 *                     create the device
301                 * @returns  pointer to created midi input device
302                 * @throws Exception  if device could not be created
303                 */
304                MidiInputDevice* CreateMidiInputDevice(String MidiDriver, std::map<String,String> Parameters) throw (Exception);
305    
306                /**
307                 * Returns the number of all created audio output devices.
308                 */
309                uint AudioOutputDevices();
310    
311                /**
312                 * Returns the number of all created MIDI input devices.
313                 */
314                uint MidiInputDevices();
315    
316                /**
317                 * Returns all created audio output devices.
318                 */
319                std::map<uint, AudioOutputDevice*> GetAudioOutputDevices();
320    
321                /**
322                 * Returns all created MIDI input devices.
323                 */
324                std::map<uint, MidiInputDevice*> GetMidiInputDevices();
325    
326                /**
327                 * Destroy the given audio output device and takes care if there
328                 * are still sampler angines connected to this device, etc.
329                 *
330                 * @throws Exception  if sampler channels are still
331                 *                    connected to the device
332                 */
333                void DestroyAudioOutputDevice(AudioOutputDevice* pDevice) throw (Exception);
334    
335                /**
336                 * Destroy the given MIDI input device and takes care if there
337                 * are still sampler angines connected to this device, etc.
338                 *
339                 * @throws Exception  if sampler channels are still
340                 *                    connected to the device
341                 */
342                void DestroyMidiInputDevice(MidiInputDevice* pDevice) throw (Exception);
343    
344                /**
345                 * Gets the current number of all active voices.
346                 * @returns The current number of all active voices.
347                 */
348                int GetVoiceCount();
349    
350                /**
351                 * Reset the whole sampler. Destroy all engines, sampler
352                 * channels, MIDI input devices and audio output devices.
353                 */
354                void Reset();
355    
356            protected:
357                typedef std::map<uint, AudioOutputDevice*> AudioOutputDeviceMap;
358                typedef std::map<uint, MidiInputDevice*> MidiInputDeviceMap;
359                typedef std::map<uint, SamplerChannel*> SamplerChannelMap;
360    
361                SamplerChannelMap     mSamplerChannels;    ///< contains all created sampler channels
362                AudioOutputDeviceMap  mAudioOutputDevices; ///< contains all created audio output devices
363                MidiInputDeviceMap    mMidiInputDevices;   ///< contains all created MIDI input devices
364    
365              friend class SamplerChannel;              friend class SamplerChannel;
366      };      };
Legend:
Removed from v.53  
changed lines
  Added in v.890
  ViewVC Help
Powered by ViewVC