Chris@1: Chris@1: Chris@1: Chris@1: Chris@3: Chris@6: Chris@6: Chris@1: VampPluginSDK: PluginLoader.h Source File Chris@1: Chris@6: Chris@6: Chris@1: Chris@1: Chris@6: Chris@1: Chris@1: Chris@6: Chris@1: Chris@1: Chris@6:
Chris@1:
Chris@1: Chris@1: Chris@1: Chris@6: Chris@1: Chris@1: Chris@1:
Chris@1:
VampPluginSDK Chris@6:  2.7 Chris@1:
Chris@1:
Chris@1:
Chris@6: Chris@6: Chris@6: Chris@6: Chris@6: Chris@6: Chris@6:
Chris@1:
Chris@1: Chris@1:
Chris@1:
Chris@1:
Chris@1: Chris@1:
Chris@1:
Chris@1:
Chris@1:
PluginLoader.h
Chris@3:
Chris@1:
Chris@6: Go to the documentation of this file.
1 /* -*- c-basic-offset: 4 indent-tabs-mode: nil -*- vi:set ts=8 sts=4 sw=4: */
2 
3 /*
4  Vamp
5 
6  An API for audio analysis and feature extraction plugins.
7 
8  Centre for Digital Music, Queen Mary, University of London.
9  Copyright 2006-2009 Chris Cannam and QMUL.
10 
11  Permission is hereby granted, free of charge, to any person
12  obtaining a copy of this software and associated documentation
13  files (the "Software"), to deal in the Software without
14  restriction, including without limitation the rights to use, copy,
15  modify, merge, publish, distribute, sublicense, and/or sell copies
16  of the Software, and to permit persons to whom the Software is
17  furnished to do so, subject to the following conditions:
18 
19  The above copyright notice and this permission notice shall be
20  included in all copies or substantial portions of the Software.
21 
22  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
23  EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
24  MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
25  NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR
26  ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
27  CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
28  WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
29 
30  Except as contained in this notice, the names of the Centre for
31  Digital Music; Queen Mary, University of London; and Chris Cannam
32  shall not be used in advertising or otherwise to promote the sale,
33  use or other dealings in this Software without prior written
34  authorization.
35 */
36 
37 #ifndef _VAMP_PLUGIN_LOADER_H_
38 #define _VAMP_PLUGIN_LOADER_H_
39 
40 #include <vector>
41 #include <string>
42 #include <map>
43 
44 #include "hostguard.h"
45 #include "PluginWrapper.h"
46 
47 _VAMP_SDK_HOSTSPACE_BEGIN(PluginLoader.h)
48 
49 namespace Vamp {
50 
51 class Plugin;
52 
53 namespace HostExt {
54 
76 {
77 public:
82  static PluginLoader *getInstance();
83 
104  typedef std::string PluginKey;
105 
110  typedef std::vector<PluginKey> PluginKeyList;
111 
122  typedef std::vector<std::string> PluginCategoryHierarchy;
123 
128  PluginKeyList listPlugins();
129 
142  PluginKeyList listPluginsIn(std::vector<std::string> libraryNames);
143 
156  PluginKeyList listPluginsNotIn(std::vector<std::string> libraryNames);
157 
201 
202  ADAPT_INPUT_DOMAIN = 0x01,
203  ADAPT_CHANNEL_COUNT = 0x02,
204  ADAPT_BUFFER_SIZE = 0x04,
205 
206  ADAPT_ALL_SAFE = 0x03,
207 
208  ADAPT_ALL = 0xff
209  };
210 
228  Plugin *loadPlugin(PluginKey key,
229  float inputSampleRate,
230  int adapterFlags = 0);
231 
237  PluginKey composePluginKey(std::string libraryName,
238  std::string identifier);
239 
249  PluginCategoryHierarchy getPluginCategory(PluginKey plugin);
250 
255  std::string getLibraryPathForPlugin(PluginKey plugin);
256 
257 protected:
258  PluginLoader();
259  virtual ~PluginLoader();
260 
261  class Impl;
262  Impl *m_impl;
263 
265 };
266 
267 }
268 
269 }
270 
272 
273 #endif
274 
std::vector< PluginKey > PluginKeyList
PluginKeyList is a sequence of plugin keys, such as returned by listPlugins().
Definition: PluginLoader.h:110
Chris@6:
Vamp::Plugin is a base class for plugin instance classes that provide feature extraction from audio o...
Chris@6:
#define _VAMP_SDK_HOSTSPACE_BEGIN(h)
Definition: hostguard.h:56
Chris@6:
Definition: FFT.h:43
Chris@6:
std::vector< std::string > PluginCategoryHierarchy
PluginCategoryHierarchy is a sequence of general->specific category names, as may be associated with ...
Definition: PluginLoader.h:122
Chris@6:
static PluginLoader * m_instance
Definition: PluginLoader.h:264
Chris@6: Chris@6:
AdapterFlags
AdapterFlags contains a set of values that may be OR&#39;d together to indicate in which circumstances Pl...
Definition: PluginLoader.h:200
Chris@6: Chris@6:
#define _VAMP_SDK_HOSTSPACE_END(h)
Definition: hostguard.h:59
Chris@6:
Vamp::HostExt::PluginLoader is a convenience class for discovering and loading Vamp plugins using the...
Definition: PluginLoader.h:75
Chris@6:
std::string PluginKey
PluginKey is a string type that is used to identify a plugin uniquely within the scope of "the curren...
Definition: PluginLoader.h:104
Chris@6: Chris@6:
Chris@6:
Chris@6: Chris@6: Chris@1: Chris@1: