/[svn]/linuxsampler/trunk/src/audiodriver/AudioOutputDeviceFactory.h
ViewVC logotype

Annotation of /linuxsampler/trunk/src/audiodriver/AudioOutputDeviceFactory.h

Parent Directory Parent Directory | Revision Log Revision Log

Revision 123 - (hide annotations) (download) (as text)
Mon Jun 14 19:33:16 2004 UTC (19 years, 11 months ago) by schoenebeck
File MIME type: text/x-c++hdr
File size: 4361 byte(s) 
* src/common: added template class 'optional<>' which can be used e.g. as
  return type whenever a value might be returned, but don't has to; this
  template class pretty much acts like a pointer of the given type, but is
  much more safer than a simple pointer
* src/audiodriver: added static class AudioDeviceFactory to create audio
  devices at runtime by using a string and to obtain driver informations
  of drivers at runtime, driver classes should simply use the macro
  REGISTER_AUDIO_OUTPUT_DRIVER(DriverName,DriverClass) in their cpp file
  to register the driver to LinuxSampler (no changes needed anymore in the
  LS code to add a new audio output driver)
* src/drivers: added classes to dynamically manage driver parameters; there
  are two different kinds of parameters: parameters which are need to
  create a new device (DeviceCreationParameterX) used to e.g. create an
  audio output device or a MIDI input device and parameters which are only
  available at runtime, means when a device is already created
  (DeviceRuntimeParameterX) which will be e.g. used as audio channel
  parameters and MIDI port parameters
* src/linuxsampler.cpp: all registered audio output drivers will be shown
  on the console on startup
* src/network: implemented configuration of audio output devices via LSCP
1 schoenebeck 123 /***************************************************************************
2     * *
3     * LinuxSampler - modular, streaming capable sampler *
4     * *
5     * Copyright (C) 2003, 2004 by Benno Senoner and Christian Schoenebeck *
6     * *
7     * This program is free software; you can redistribute it and/or modify *
8     * it under the terms of the GNU General Public License as published by *
9     * the Free Software Foundation; either version 2 of the License, or *
10     * (at your option) any later version. *
11     * *
12     * This program 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 this program; if not, write to the Free Software *
19     * Foundation, Inc., 59 Temple Place, Suite 330, Boston, *
20     * MA 02111-1307 USA *
21     ***************************************************************************/
22    
23     #ifndef __LS_AUDIO_OUTPUT_DEVICE_FACTORY_H__
24     #define __LS_AUDIO_OUTPUT_DEVICE_FACTORY_H__
25    
26     #include <map>
27     #include <vector>
28    
29     #include "../common/LinuxSamplerException.h"
30     #include "AudioOutputDevice.h"
31    
32     #define REGISTER_AUDIO_OUTPUT_DRIVER(DriverName,DriverClass) static LinuxSampler::AudioOutputDeviceFactory::InnerFactoryRegistrator<DriverClass> __auto_register_audio_output_driver__##DriverClass(DriverName)
33    
34     namespace LinuxSampler {
35    
36     class AudioOutputDeviceFactory {
37     public:
38     class InnerFactory {
39     public:
40     virtual AudioOutputDevice* Create(std::map<String,String>& Parameters) = 0;
41     virtual std::map<String,DeviceCreationParameter*> AvailableParameters() = 0;
42     virtual String Description() = 0;
43     virtual String Version() = 0;
44     };
45    
46     template <class Driver_T>
47     class InnerFactoryTemplate : public InnerFactory {
48     public:
49     virtual AudioOutputDevice* Create(std::map<String,String>& Parameters) { return new Driver_T(Parameters); }
50     virtual std::map<String,DeviceCreationParameter*> AvailableParameters() { return Driver_T::AvailableParameters(); }
51     virtual String Description() { return Driver_T::Description(); }
52     virtual String Version() { return Driver_T::Version(); }
53     };
54    
55     template <class Driver_T>
56     class InnerFactoryRegistrator {
57     public:
58     InnerFactoryRegistrator(String DriverName) {
59     AudioOutputDeviceFactory::InnerFactories[DriverName] = new InnerFactoryTemplate<Driver_T>;
60     }
61     };
62    
63     static AudioOutputDevice* Create(String DriverName, std::map<String,String>& Parameters) throw (LinuxSamplerException);
64     static std::vector<String> AvailableDrivers();
65     static String AvailableDriversAsString();
66     static std::map<String,DeviceCreationParameter*> GetAvailableDriverParameters(String DriverName) throw (LinuxSamplerException);
67     static DeviceCreationParameter* GetDriverParameter(String DriverName, String ParameterName) throw (LinuxSamplerException);
68     static String GetDriverDescription(String DriverName) throw (LinuxSamplerException);
69     static String GetDriverVersion(String DriverName) throw (LinuxSamplerException);
70    
71     protected:
72     static std::map<String, InnerFactory*> InnerFactories;
73     };
74    
75     } // namespace LinuxSampler
76    
77     #endif // __LS_AUDIO_OUTPUT_DEVICE_FACTORY_H__
  ViewVC Help
Powered by ViewVC