Guitarix
gx_pluginloader.h
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2011 Hermann Meyer, James Warden, Andreas Degert, Pete Shorthose
3  *
4  * This program is free software; you can redistribute it and/or modify
5  * it under the terms of the GNU General Public License as published by
6  * the Free Software Foundation; either version 2 of the License, or
7  * (at your option) any later version.
8  *
9  * This program is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12  * GNU General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program; if not, write to the Free Software
16  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
17  */
18 
19 // utility class
20 // FIXME should be moved somewhere else
21 struct stringcomp {
22  inline bool operator() (const char* lhs, const char* rhs) const {
23  return strcmp(lhs, rhs) < 0;
24  }
25 };
26 
27 namespace gx_engine {
28 
29 class EngineControl;
30 
31 /****************************************************************
32  ** class Plugin
33  ** Defines audio processing module and variables for
34  ** user interface
35 */
36 
37 enum { // additional flags for PluginDef (used internally)
38  PGNI_DYN_POSITION = 0x10000, // plugin is part of dynamically ordered rack
39  PGNI_NOT_OWN = 0x20000, // not owned by PluginList
40  PGNI_UI_REG = 0x40000, // Plugin registered in user interface
41  PGNI_IS_LV2 = 0x80000, // Plugin is in LV2 format
42  PGNI_IS_LADSPA = 0x100000, // Plugin is in LADSPA format
43 };
44 
45 class Plugin {
46 private:
53  int pos_tmp;
55 public:
56  PluginDef *get_pdef() { return pdef; }
57  void set_pdef(PluginDef *p) { pdef = p; }
58  enum { POST_WEIGHT = 2000 };
59  Plugin(PluginDef *pl=0);
62  bool get_box_visible() const { return p_box_visible && p_box_visible->get_value(); }
64  bool get_on_off() const { return p_on_off->get_value(); }
65  int get_position() const { return p_position->get_value(); }
66  int get_effect_post_pre() const { return p_effect_post_pre->get_value(); }
67  void set_box_visible(bool v) const { if (p_box_visible) p_box_visible->set(v); }
68  void set_plug_visible(bool v) const { if (p_plug_visible) p_plug_visible->set(v); }
69  void set_on_off(bool v) const { p_on_off->set(v); }
70  void set_position(int v) const { p_position->set(v); }
71  void set_effect_post_pre(int v) const { p_effect_post_pre->set(v); }
72  const std::string& id_box_visible() const { return p_box_visible->id(); }
73  const std::string& id_plug_visible() const { return p_plug_visible->id(); }
74  const std::string& id_on_off() const { return p_on_off->id(); }
75  const std::string& id_position() const { return p_position->id(); }
76  const std::string& id_effect_post_pre() const { return p_effect_post_pre->id(); }
78  void register_vars(ParamMap& param, EngineControl& seq);
79  void copy_position(const Plugin& plugin);
80  friend class PluginListBase;
81  friend class PluginList;
82  friend void printlist(const char *title, const list<Plugin*>& modules, bool header);
83 };
84 
85 /****************************************************************
86  ** class UiBuilderBase
87  */
88 
89 class UiBuilderBase: public UiBuilder {
90 public:
91  virtual bool load(Plugin *p) = 0;
92 };
93 
94 /****************************************************************
95  ** class ParamRegImpl
96  */
97 
98 class ParamRegImpl: public ParamReg {
99 private:
100  static ParamMap *pmap;
101  static float *registerFloatVar_(
102  const char* id, const char* name, const char* tp,
103  const char* tooltip, float* var, float val,
104  float low, float up, float step, const value_pair* values=0);
105  static int *registerIntVar_(
106  const char* id, const char* name, const char* tp,
107  const char* tooltip, int* var, int val,
108  int low, int up, const value_pair* values=0);
109  static bool *registerBoolVar_(
110  const char* id, const char* name, const char* tp,
111  const char* tooltip, bool* var, bool val);
112 public:
113  ParamRegImpl(ParamMap* pm);
114 };
115 
116 /****************************************************************
117  ** class PluginList
118  ** container of plugins for all processing chains
119  */
120 
121 enum PluginPos { // where to add a plugin (per processing chain)
124  PLUGIN_POS_END // keep last one
125 };
126 
127 typedef PluginDef *(*plugindef_creator)();
128 
130 public:
131  typedef pair<const std::string, Plugin*> map_pair;
132  typedef map<const std::string, Plugin*> pluginmap;
133 protected:
136  PLUGIN_POS_COUNT // keep last one
137  };
139  sigc::signal<void,const char*,bool> insert_remove;
140 public:
143  void cleanup();
144  Plugin *find_plugin(const std::string& id) const;
145  Plugin *lookup_plugin(const std::string& id) const;
149  pluginmap::iterator begin() { return pmap.begin(); }
150  pluginmap::iterator end() { return pmap.end(); }
151  int insert_plugin(Plugin *pvars);
152  void update_plugin(Plugin *pvars);
154 };
155 
156 class PluginList: public PluginListBase {
159  int add_module(Plugin *pl, PluginPos pos, int flags);
160 public:
163  void set_samplerate(int samplerate); // call set_samplerate of all plugins
164  int load_from_path(const string& path, PluginPos pos = PLUGIN_POS_RACK);
165  int load_library(const string& path, PluginPos pos = PLUGIN_POS_RACK);
166  int add(Plugin *pl, PluginPos pos, int flags);
167  Plugin *add(PluginDef *p, PluginPos pos = PLUGIN_POS_RACK, int flags=0);
168  int add(PluginDef **p, PluginPos pos = PLUGIN_POS_RACK, int flags=0);
169  int add(plugindef_creator *p, PluginPos pos = PLUGIN_POS_RACK, int flags=0);
172  void registerParameter(Plugin *pl, ParamMap& param, ParamRegImpl& preg);
173  void registerPlugin(Plugin *pl, ParamMap& param, ParameterGroups& groups);
176  void rescueParameter(Plugin *pl, ParamMap& param);
177  void unregisterPlugin(Plugin *pl, ParamMap& param, ParameterGroups& groups);
179  void ordered_mono_list(list<Plugin*>& mono, int mode);
180  void ordered_stereo_list(list<Plugin*>& stereo, int mode);
181  void ordered_list(list<Plugin*>& l, bool stereo, int flagmask, int flagvalue);
182  sigc::signal<void,const char*,bool>& signal_insert_remove() { return insert_remove; }
183 #ifndef NDEBUG
184  void printlist(bool ordered = true);
185 #endif
186 };
187 
188 #ifndef NDEBUG
189 void printlist(const char *title, const list<Plugin*>& modules, bool header=true);
190 #else
191 inline void printlist(const char *, const list<Plugin*>&, bool=true) {}
192 #endif
193 
194 } // !namespace gx_engine
gx_engine::PluginList::registerAllPlugins
void registerAllPlugins(ParamMap &param, ParameterGroups &groups)
gx_engine::Plugin::get_box_visible
bool get_box_visible() const
Definition: gx_pluginloader.h:62
gx_engine::PluginList::add
int add(plugindef_creator *p, PluginPos pos=PLUGIN_POS_RACK, int flags=0)
gx_engine::PluginList::add
Plugin * add(PluginDef *p, PluginPos pos=PLUGIN_POS_RACK, int flags=0)
gx_engine::Plugin::set_plug_visible
void set_plug_visible(bool v) const
Definition: gx_pluginloader.h:68
gx_engine::ParameterV< bool >::set
bool set(bool val) const
gx_engine::PluginList::add_module
int add_module(Plugin *pl, PluginPos pos, int flags)
gx_engine::PluginListBase::begin
pluginmap::iterator begin()
Definition: gx_pluginloader.h:149
gx_engine::Plugin::p_on_off
BoolParameter * p_on_off
Audio Processing.
Definition: gx_pluginloader.h:50
gx_engine::PluginListBase::PLUGIN_POS_COUNT
@ PLUGIN_POS_COUNT
Definition: gx_pluginloader.h:136
gx_engine::plugindef_creator
PluginDef *(* plugindef_creator)()
Definition: gx_pluginloader.h:127
gx_engine::Plugin::pos_tmp
int pos_tmp
Definition: gx_pluginloader.h:53
gx_engine::Plugin::set_box_visible
void set_box_visible(bool v) const
Definition: gx_pluginloader.h:67
gx_engine::ParamRegImpl
Definition: gx_pluginloader.h:98
stringcomp
Definition: gx_pluginloader.h:21
gx_engine::PluginListBase::PluginPosInternal
PluginPosInternal
Definition: gx_pluginloader.h:134
value_pair
Definition: gx_plugin.h:117
gx_engine::UiBuilderBase
Definition: gx_pluginloader.h:89
gx_engine::PluginListBase::~PluginListBase
~PluginListBase()
gx_engine::PluginListBase
Definition: gx_pluginloader.h:129
gx_engine::PGNI_IS_LADSPA
@ PGNI_IS_LADSPA
Definition: gx_pluginloader.h:46
gx_engine::Plugin::id_plug_visible
const std::string & id_plug_visible() const
Definition: gx_pluginloader.h:73
gx_engine::Plugin::id_position
const std::string & id_position() const
Definition: gx_pluginloader.h:75
gx_engine::PLUGIN_POS_END
@ PLUGIN_POS_END
Definition: gx_pluginloader.h:127
gx_engine::Plugin::p_effect_post_pre
IntParameter * p_effect_post_pre
pre/post amp position (post = 0)
Definition: gx_pluginloader.h:52
gx_engine::PluginListBase::lookup_plugin
Plugin * lookup_plugin(const std::string &id) const
gx_engine::PluginList::unregisterPlugin
void unregisterPlugin(Plugin *pl, ParamMap &param, ParameterGroups &groups)
gx_engine::PluginListBase::end
pluginmap::iterator end()
Definition: gx_pluginloader.h:150
gx_engine::PluginList::registerParameter
void registerParameter(Plugin *pl, ParamMap &param, ParamRegImpl &preg)
gx_engine::PluginListBase::PluginListBase
PluginListBase()
gx_engine::PGNI_DYN_POSITION
@ PGNI_DYN_POSITION
Definition: gx_pluginloader.h:42
gx_engine::PluginList::~PluginList
~PluginList()
gx_engine::ParameterV< bool >
Definition: gx_parameter.h:368
gx_engine::PluginListBase::append_rack
void append_rack(UiBuilderBase &ui)
gx_engine::PluginPos
PluginPos
Definition: gx_pluginloader.h:121
gx_engine::Plugin::register_vars
void register_vars(ParamMap &param, EngineControl &seq)
gx_engine::PluginListBase::PLUGIN_POS_RACK_STEREO
@ PLUGIN_POS_RACK_STEREO
Definition: gx_pluginloader.h:135
gx_engine::Plugin::set_pdef
void set_pdef(PluginDef *p)
Definition: gx_pluginloader.h:57
gx_engine::Plugin::get_plug_visible
bool get_plug_visible() const
Definition: gx_pluginloader.h:63
gx_engine::PluginListBase::update_plugin
void update_plugin(Plugin *pvars)
gx_engine::Plugin::set_midi_on_off_blocked
void set_midi_on_off_blocked(bool v)
gx_engine::PluginList::load_from_path
int load_from_path(const string &path, PluginPos pos=PLUGIN_POS_RACK)
gx_engine::PLUGIN_POS_START
@ PLUGIN_POS_START
Definition: gx_pluginloader.h:125
PluginDef
Definition: gx_plugin.h:195
gx_engine::PluginList::load_library
int load_library(const string &path, PluginPos pos=PLUGIN_POS_RACK)
gx_engine::PluginList::ordered_list
void ordered_list(list< Plugin * > &l, bool stereo, int flagmask, int flagvalue)
gx_engine::Plugin::set_position
void set_position(int v) const
Definition: gx_pluginloader.h:70
gx_engine::PluginListBase::pluginmap
map< const std::string, Plugin * > pluginmap
Definition: gx_pluginloader.h:132
gx_engine::Plugin::POST_WEIGHT
@ POST_WEIGHT
Definition: gx_pluginloader.h:58
gx_engine::PluginList::plugin_pos
int plugin_pos[PLUGIN_POS_COUNT]
Definition: gx_pluginloader.h:158
stringcomp::operator()
bool operator()(const char *lhs, const char *rhs) const
Definition: gx_pluginloader.h:22
gx_engine::ParameterV< bool >::get_value
bool get_value() const
Definition: gx_parameter.h:382
gx_engine::PluginListBase::insert_remove
sigc::signal< void, const char *, bool > insert_remove
Definition: gx_pluginloader.h:139
gx_engine::PluginList::PluginList
PluginList(EngineControl &seq)
gx_engine::PluginListBase::cleanup
void cleanup()
gx_engine::Plugin::id_on_off
const std::string & id_on_off() const
Definition: gx_pluginloader.h:74
gx_engine::PluginList::unregisterParameter
void unregisterParameter(Plugin *pl, ParamMap &param)
gx_engine::ParameterV< int >
Definition: gx_parameter.h:311
gx_engine::PGNI_IS_LV2
@ PGNI_IS_LV2
Definition: gx_pluginloader.h:45
gx_engine::PluginList::unregisterGroup
void unregisterGroup(PluginDef *pd, ParameterGroups &groups)
gx_engine::Plugin::copy_position
void copy_position(const Plugin &plugin)
gx_engine
Definition: gx_convolver.h:33
gx_engine::Plugin::set_on_off
void set_on_off(bool v) const
Definition: gx_pluginloader.h:69
gx_engine::PluginListBase::delete_module
void delete_module(Plugin *pl)
gx_engine::Plugin::Plugin
Plugin(gx_system::JsonParser &jp, ParamMap &pmap)
gx_engine::PluginListBase::insert_plugin
int insert_plugin(Plugin *pvars)
gx_engine::Plugin::get_pdef
PluginDef * get_pdef()
Definition: gx_pluginloader.h:56
gx_system::JsonWriter
Definition: gx_json.h:55
gx_engine::Plugin::p_plug_visible
BoolParameter * p_plug_visible
minibox visible (false: full box)
Definition: gx_pluginloader.h:49
gx_system::JsonParser
Definition: gx_json.h:112
gx_engine::Plugin::get_position
int get_position() const
Definition: gx_pluginloader.h:65
gx_engine::PluginList::set_samplerate
void set_samplerate(int samplerate)
gx_engine::PluginList
Definition: gx_pluginloader.h:156
gx_engine::PluginList::registerPlugin
void registerPlugin(Plugin *pl, ParamMap &param, ParameterGroups &groups)
gx_engine::Plugin::get_on_off
bool get_on_off() const
Definition: gx_pluginloader.h:64
gx_engine::Plugin::set_effect_post_pre
void set_effect_post_pre(int v) const
Definition: gx_pluginloader.h:71
gx_engine::PGNI_UI_REG
@ PGNI_UI_REG
Definition: gx_pluginloader.h:44
gx_engine::PluginListBase::pmap
pluginmap pmap
Definition: gx_pluginloader.h:138
gx_engine::Plugin::writeJSON
void writeJSON(gx_system::JsonWriter &jw)
gx_engine::PluginListBase::readJSON
void readJSON(gx_system::JsonParser &jp, ParamMap &pmap)
gx_engine::Plugin::Plugin
Plugin(PluginDef *pl=0)
gx_engine::ParamRegImpl::ParamRegImpl
ParamRegImpl(ParamMap *pm)
gx_engine::EngineControl
Definition: gx_modulesequencer.h:238
gx_engine::PluginListBase::map_pair
pair< const std::string, Plugin * > map_pair
Definition: gx_pluginloader.h:131
gx_engine::Plugin::position_weight
int position_weight()
Definition: gx_pluginloader.h:77
gx_engine::ParameterGroups
Definition: gx_parameter.h:47
gx_engine::ParameterV< int >::get_value
int get_value() const
Definition: gx_parameter.h:325
gx_engine::ParamMap
Definition: gx_parameter.h:534
ParamReg
Parameter registration function pointers.
Definition: gx_plugin.h:141
gx_engine::Parameter::id
const string & id() const
Definition: gx_parameter.h:184
gx_engine::PluginList::printlist
void printlist(bool ordered=true)
gx_engine::PluginList::signal_insert_remove
sigc::signal< void, const char *, bool > & signal_insert_remove()
Definition: gx_pluginloader.h:182
gx_engine::Plugin::p_position
IntParameter * p_position
Position in Rack / Audio Processing Chain.
Definition: gx_pluginloader.h:51
gx_engine::printlist
void printlist(const char *title, const list< Plugin * > &modules, bool header=true)
UiBuilder
Definition: gx_plugin.h:63
gx_engine::ParamRegImpl::registerFloatVar_
static float * registerFloatVar_(const char *id, const char *name, const char *tp, const char *tooltip, float *var, float val, float low, float up, float step, const value_pair *values=0)
gx_engine::PluginList::add
int add(PluginDef **p, PluginPos pos=PLUGIN_POS_RACK, int flags=0)
gx_engine::Plugin::pdef
PluginDef * pdef
Definition: gx_pluginloader.h:47
gx_engine::PluginList::rescueParameter
void rescueParameter(Plugin *pl, ParamMap &param)
gx_engine::ParameterV< int >::set
bool set(int val) const
gx_engine::PLUGIN_POS_RACK
@ PLUGIN_POS_RACK
Definition: gx_pluginloader.h:126
gx_engine::PluginList::add
int add(Plugin *pl, PluginPos pos, int flags)
gx_engine::Plugin::printlist
friend void printlist(const char *title, const list< Plugin * > &modules, bool header)
gx_engine::PluginList::check_version
int check_version(PluginDef *p)
gx_engine::Plugin
Definition: gx_pluginloader.h:45
gx_engine::PluginList::ordered_stereo_list
void ordered_stereo_list(list< Plugin * > &stereo, int mode)
gx_engine::UiBuilderBase::load
virtual bool load(Plugin *p)=0
gx_engine::PluginListBase::writeJSON
void writeJSON(gx_system::JsonWriter &jw)
gx_engine::ParamRegImpl::pmap
static ParamMap * pmap
Definition: gx_pluginloader.h:102
gx_engine::Plugin::p_box_visible
BoolParameter * p_box_visible
In Rack: UI Interface Box visible.
Definition: gx_pluginloader.h:48
gx_engine::PGNI_NOT_OWN
@ PGNI_NOT_OWN
Definition: gx_pluginloader.h:43
gx_engine::PluginList::ordered_mono_list
void ordered_mono_list(list< Plugin * > &mono, int mode)
gx_engine::ParamRegImpl::registerBoolVar_
static bool * registerBoolVar_(const char *id, const char *name, const char *tp, const char *tooltip, bool *var, bool val)
gx_engine::Plugin::id_box_visible
const std::string & id_box_visible() const
Definition: gx_pluginloader.h:72
gx_engine::ParamRegImpl::registerIntVar_
static int * registerIntVar_(const char *id, const char *name, const char *tp, const char *tooltip, int *var, int val, int low, int up, const value_pair *values=0)
gx_engine::PluginListBase::find_plugin
Plugin * find_plugin(const std::string &id) const
gx_engine::PluginList::seq
EngineControl & seq
Definition: gx_pluginloader.h:157
gx_engine::Plugin::id_effect_post_pre
const std::string & id_effect_post_pre() const
Definition: gx_pluginloader.h:76
gx_engine::Plugin::get_effect_post_pre
int get_effect_post_pre() const
Definition: gx_pluginloader.h:66
gx_engine::PluginList::registerGroup
void registerGroup(PluginDef *pd, ParameterGroups &groups)