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

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

Parent Directory Parent Directory | Revision Log Revision Log

Revision 123 - (show annotations) (download) (as text)
Mon Jun 14 19:33:16 2004 UTC (19 years, 10 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 /***************************************************************************
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