2 Copyright (C) 2000-2006 Paul Davis
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.
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.
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., 675 Mass Ave, Cambridge, MA 02139, USA.
20 #define __STDC_FORMAT_MACROS 1
27 #include <cstdio> // so libraptor doesn't complain
35 #include <pbd/compose.h>
36 #include <pbd/error.h>
37 #include <pbd/pathscanner.h>
38 #include <pbd/xml++.h>
40 #include <midi++/manager.h>
42 #include <ardour/ardour.h>
43 #include <ardour/session.h>
44 #include <ardour/audioengine.h>
45 #include <ardour/ladspa_plugin.h>
46 #include <ardour/buffer_set.h>
48 #include <pbd/stl_delete.h>
54 using namespace ARDOUR;
57 LadspaPlugin::LadspaPlugin (void *mod, AudioEngine& e, Session& session, uint32_t index, nframes_t rate)
60 init (mod, index, rate);
63 LadspaPlugin::LadspaPlugin (const LadspaPlugin &other)
66 init (other.module, other._index, other.sample_rate);
68 for (uint32_t i = 0; i < parameter_count(); ++i) {
69 control_data[i] = other.shadow_data[i];
70 shadow_data[i] = other.shadow_data[i];
75 LadspaPlugin::init (void *mod, uint32_t index, nframes_t rate)
77 LADSPA_Descriptor_Function dfunc;
84 latency_control_port = 0;
85 was_activated = false;
87 dfunc = (LADSPA_Descriptor_Function) dlsym (module, "ladspa_descriptor");
89 if ((errstr = dlerror()) != NULL) {
90 error << _("LADSPA: module has no descriptor function.") << endmsg;
91 throw failed_constructor();
94 if ((descriptor = dfunc (index)) == 0) {
95 error << _("LADSPA: plugin has gone away since discovery!") << endmsg;
96 throw failed_constructor();
101 if (LADSPA_IS_INPLACE_BROKEN(descriptor->Properties)) {
102 error << string_compose(_("LADSPA: \"%1\" cannot be used, since it cannot do inplace processing"), descriptor->Name) << endmsg;
103 throw failed_constructor();
108 if (descriptor->instantiate == 0) {
109 throw failed_constructor();
112 if ((handle = descriptor->instantiate (descriptor, rate)) == 0) {
113 throw failed_constructor();
116 port_cnt = parameter_count();
118 control_data = new LADSPA_Data[port_cnt];
119 shadow_data = new LADSPA_Data[port_cnt];
121 for (i = 0; i < port_cnt; ++i) {
122 if (LADSPA_IS_PORT_CONTROL(port_descriptor (i))) {
123 connect_port (i, &control_data[i]);
125 if (LADSPA_IS_PORT_OUTPUT(port_descriptor (i)) &&
126 strcmp (port_names()[i], X_("latency")) == 0) {
127 latency_control_port = &control_data[i];
128 *latency_control_port = 0;
131 if (!LADSPA_IS_PORT_INPUT(port_descriptor (i))) {
135 shadow_data[i] = default_value (i);
139 Plugin::setup_controls ();
141 latency_compute_run ();
144 LadspaPlugin::~LadspaPlugin ()
149 GoingAway (); /* EMIT SIGNAL */
151 /* XXX who should close a plugin? */
156 delete [] control_data;
160 delete [] shadow_data;
165 LadspaPlugin::store_state (PluginState& state)
167 state.parameters.clear ();
169 for (uint32_t i = 0; i < parameter_count(); ++i){
171 if (LADSPA_IS_PORT_INPUT(port_descriptor (i)) &&
172 LADSPA_IS_PORT_CONTROL(port_descriptor (i))){
173 pair<uint32_t,float> datum;
176 datum.second = shadow_data[i];
178 state.parameters.insert (datum);
184 LadspaPlugin::restore_state (PluginState& state)
186 for (map<uint32_t,float>::iterator i = state.parameters.begin(); i != state.parameters.end(); ++i) {
187 set_parameter (i->first, i->second);
192 LadspaPlugin::default_value (uint32_t port)
194 const LADSPA_PortRangeHint *prh = port_range_hints();
196 bool bounds_given = false;
197 bool sr_scaling = false;
198 bool earlier_hint = false;
200 /* defaults - case 1 */
202 if (LADSPA_IS_HINT_HAS_DEFAULT(prh[port].HintDescriptor)) {
203 if (LADSPA_IS_HINT_DEFAULT_MINIMUM(prh[port].HintDescriptor)) {
204 ret = prh[port].LowerBound;
210 /* FIXME: add support for logarithmic defaults */
212 else if (LADSPA_IS_HINT_DEFAULT_LOW(prh[port].HintDescriptor)) {
213 ret = prh[port].LowerBound * 0.75f + prh[port].UpperBound * 0.25f;
218 else if (LADSPA_IS_HINT_DEFAULT_MIDDLE(prh[port].HintDescriptor)) {
219 ret = prh[port].LowerBound * 0.50f + prh[port].UpperBound * 0.50f;
224 else if (LADSPA_IS_HINT_DEFAULT_HIGH(prh[port].HintDescriptor)) {
225 ret = prh[port].LowerBound * 0.25f + prh[port].UpperBound * 0.75f;
230 else if (LADSPA_IS_HINT_DEFAULT_MAXIMUM(prh[port].HintDescriptor)) {
231 ret = prh[port].UpperBound;
236 else if (LADSPA_IS_HINT_DEFAULT_0(prh[port].HintDescriptor)) {
240 else if (LADSPA_IS_HINT_DEFAULT_1(prh[port].HintDescriptor)) {
244 else if (LADSPA_IS_HINT_DEFAULT_100(prh[port].HintDescriptor)) {
248 else if (LADSPA_IS_HINT_DEFAULT_440(prh[port].HintDescriptor)) {
258 /* defaults - case 2 */
259 else if (LADSPA_IS_HINT_BOUNDED_BELOW(prh[port].HintDescriptor) &&
260 !LADSPA_IS_HINT_BOUNDED_ABOVE(prh[port].HintDescriptor)) {
262 if (prh[port].LowerBound < 0) {
265 ret = prh[port].LowerBound;
272 /* defaults - case 3 */
273 else if (!LADSPA_IS_HINT_BOUNDED_BELOW(prh[port].HintDescriptor) &&
274 LADSPA_IS_HINT_BOUNDED_ABOVE(prh[port].HintDescriptor)) {
276 if (prh[port].UpperBound > 0) {
279 ret = prh[port].UpperBound;
286 /* defaults - case 4 */
287 else if (LADSPA_IS_HINT_BOUNDED_BELOW(prh[port].HintDescriptor) &&
288 LADSPA_IS_HINT_BOUNDED_ABOVE(prh[port].HintDescriptor)) {
290 if (prh[port].LowerBound < 0 && prh[port].UpperBound > 0) {
292 } else if (prh[port].LowerBound < 0 && prh[port].UpperBound < 0) {
293 ret = prh[port].UpperBound;
295 ret = prh[port].LowerBound;
301 /* defaults - case 5 */
303 if (LADSPA_IS_HINT_SAMPLE_RATE(prh[port].HintDescriptor) && !earlier_hint) {
317 LadspaPlugin::set_parameter (uint32_t which, float val)
319 if (which < descriptor->PortCount) {
320 shadow_data[which] = (LADSPA_Data) val;
321 ParameterChanged (which, val); /* EMIT SIGNAL */
323 if (which < parameter_count() && controls[which]) {
324 controls[which]->Changed ();
328 warning << string_compose (_("illegal parameter number used with plugin \"%1\". This may"
329 "indicate a change in the plugin design, and presets may be"
336 LadspaPlugin::get_parameter (uint32_t which) const
338 if (LADSPA_IS_PORT_INPUT(port_descriptor (which))) {
339 return (float) shadow_data[which];
341 return (float) control_data[which];
346 LadspaPlugin::nth_parameter (uint32_t n, bool& ok) const
352 for (c = 0, x = 0; x < descriptor->PortCount; ++x) {
353 if (LADSPA_IS_PORT_CONTROL (port_descriptor (x))) {
364 LadspaPlugin::get_state()
366 XMLNode *root = new XMLNode(state_node_name());
369 LocaleGuard lg (X_("POSIX"));
371 for (uint32_t i = 0; i < parameter_count(); ++i){
373 if (LADSPA_IS_PORT_INPUT(port_descriptor (i)) &&
374 LADSPA_IS_PORT_CONTROL(port_descriptor (i))){
376 child = new XMLNode("port");
377 snprintf(buf, sizeof(buf), "%u", i);
378 child->add_property("number", string(buf));
379 snprintf(buf, sizeof(buf), "%+f", shadow_data[i]);
380 child->add_property("value", string(buf));
381 root->add_child_nocopy (*child);
389 LadspaPlugin::save_preset (string name)
391 return Plugin::save_preset (name, "ladspa");
395 LadspaPlugin::set_state(const XMLNode& node)
399 XMLNodeConstIterator iter;
404 LocaleGuard lg (X_("POSIX"));
406 if (node.name() != state_node_name()) {
407 error << _("Bad node sent to LadspaPlugin::set_state") << endmsg;
411 nodes = node.children ("port");
413 for(iter = nodes.begin(); iter != nodes.end(); ++iter){
417 if ((prop = child->property("number")) != 0) {
418 port = prop->value().c_str();
420 warning << _("LADSPA: no ladspa port number") << endmsg;
423 if ((prop = child->property("value")) != 0) {
424 data = prop->value().c_str();
426 warning << _("LADSPA: no ladspa port data") << endmsg;
430 sscanf (port, "%" PRIu32, &port_id);
431 set_parameter (port_id, atof(data));
434 latency_compute_run ();
440 LadspaPlugin::get_parameter_descriptor (uint32_t which, ParameterDescriptor& desc) const
442 LADSPA_PortRangeHint prh;
444 prh = port_range_hints()[which];
447 if (LADSPA_IS_HINT_BOUNDED_BELOW(prh.HintDescriptor)) {
448 desc.min_unbound = false;
449 if (LADSPA_IS_HINT_SAMPLE_RATE(prh.HintDescriptor)) {
450 desc.lower = prh.LowerBound * _session.frame_rate();
452 desc.lower = prh.LowerBound;
455 desc.min_unbound = true;
460 if (LADSPA_IS_HINT_BOUNDED_ABOVE(prh.HintDescriptor)) {
461 desc.max_unbound = false;
462 if (LADSPA_IS_HINT_SAMPLE_RATE(prh.HintDescriptor)) {
463 desc.upper = prh.UpperBound * _session.frame_rate();
465 desc.upper = prh.UpperBound;
468 desc.max_unbound = true;
469 desc.upper = 4; /* completely arbitrary */
472 if (LADSPA_IS_HINT_INTEGER (prh.HintDescriptor)) {
474 desc.smallstep = 0.1;
475 desc.largestep = 10.0;
477 float delta = desc.upper - desc.lower;
478 desc.step = delta / 1000.0f;
479 desc.smallstep = delta / 10000.0f;
480 desc.largestep = delta/10.0f;
483 desc.toggled = LADSPA_IS_HINT_TOGGLED (prh.HintDescriptor);
484 desc.logarithmic = LADSPA_IS_HINT_LOGARITHMIC (prh.HintDescriptor);
485 desc.sr_dependent = LADSPA_IS_HINT_SAMPLE_RATE (prh.HintDescriptor);
486 desc.integer_step = LADSPA_IS_HINT_INTEGER (prh.HintDescriptor);
488 desc.label = port_names()[which];
496 LadspaPlugin::describe_parameter (uint32_t which)
498 if (which < parameter_count()) {
499 return port_names()[which];
506 LadspaPlugin::latency () const
508 if (latency_control_port) {
509 return (nframes_t) floor (*latency_control_port);
516 LadspaPlugin::automatable () const
520 for (uint32_t i = 0; i < parameter_count(); ++i){
521 if (LADSPA_IS_PORT_INPUT(port_descriptor (i)) &&
522 LADSPA_IS_PORT_CONTROL(port_descriptor (i))){
524 ret.insert (ret.end(), i);
532 LadspaPlugin::connect_and_run (BufferSet& bufs, uint32_t& in_index, uint32_t& out_index, nframes_t nframes, nframes_t offset)
534 uint32_t port_index = 0;
537 then = get_cycles ();
539 const uint32_t nbufs = bufs.count().n_audio();
541 while (port_index < parameter_count()) {
542 if (LADSPA_IS_PORT_AUDIO (port_descriptor(port_index))) {
543 if (LADSPA_IS_PORT_INPUT (port_descriptor(port_index))) {
544 const size_t index = min(in_index, nbufs - 1);
545 connect_port (port_index, bufs.get_audio(index).data(nframes, offset));
546 //cerr << this << ' ' << name() << " @ " << offset << " inport " << in_index << " = buf "
547 // << min((uint32_t)in_index,nbufs) << " = " << &bufs[min((uint32_t)in_index,nbufs)][offset] << endl;
551 } else if (LADSPA_IS_PORT_OUTPUT (port_descriptor (port_index))) {
552 const size_t index = min(out_index,nbufs - 1);
553 connect_port (port_index, bufs.get_audio(index).data(nframes, offset));
554 // cerr << this << ' ' << name() << " @ " << offset << " outport " << out_index << " = buf "
555 // << min((uint32_t)out_index,nbufs) << " = " << &bufs[min((uint32_t)out_index,nbufs)][offset] << endl;
564 set_cycles ((uint32_t) (now - then));
570 LadspaPlugin::parameter_is_control (uint32_t param) const
572 return LADSPA_IS_PORT_CONTROL(port_descriptor (param));
576 LadspaPlugin::parameter_is_audio (uint32_t param) const
578 return LADSPA_IS_PORT_AUDIO(port_descriptor (param));
582 LadspaPlugin::parameter_is_output (uint32_t param) const
584 return LADSPA_IS_PORT_OUTPUT(port_descriptor (param));
588 LadspaPlugin::parameter_is_input (uint32_t param) const
590 return LADSPA_IS_PORT_INPUT(port_descriptor (param));
594 LadspaPlugin::print_parameter (uint32_t param, char *buf, uint32_t len) const
597 if (param < parameter_count()) {
598 snprintf (buf, len, "%.3f", get_parameter (param));
606 LadspaPlugin::run (nframes_t nframes)
608 for (uint32_t i = 0; i < parameter_count(); ++i) {
609 if (LADSPA_IS_PORT_INPUT(port_descriptor (i)) && LADSPA_IS_PORT_CONTROL(port_descriptor (i))) {
610 control_data[i] = shadow_data[i];
613 descriptor->run (handle, nframes);
617 LadspaPlugin::latency_compute_run ()
619 if (!latency_control_port) {
623 /* we need to run the plugin so that it can set its latency
629 uint32_t port_index = 0;
630 uint32_t in_index = 0;
631 uint32_t out_index = 0;
632 const nframes_t bufsize = 1024;
633 LADSPA_Data buffer[bufsize];
635 memset(buffer,0,sizeof(LADSPA_Data)*bufsize);
637 /* Note that we've already required that plugins
638 be able to handle in-place processing.
643 while (port_index < parameter_count()) {
644 if (LADSPA_IS_PORT_AUDIO (port_descriptor (port_index))) {
645 if (LADSPA_IS_PORT_INPUT (port_descriptor (port_index))) {
646 connect_port (port_index, buffer);
648 } else if (LADSPA_IS_PORT_OUTPUT (port_descriptor (port_index))) {
649 connect_port (port_index, buffer);
661 LadspaPluginInfo::load (Session& session)
667 if ((module = dlopen (path.c_str(), RTLD_NOW)) == 0) {
668 error << string_compose(_("LADSPA: cannot load module from \"%1\""), path) << endmsg;
669 error << dlerror() << endmsg;
671 plugin.reset (new LadspaPlugin (module, session.engine(), session, index, session.frame_rate()));
674 plugin->set_info(PluginInfoPtr(new LadspaPluginInfo(*this)));
678 catch (failed_constructor &err) {
679 return PluginPtr ((Plugin*) 0);