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/xml++.h"
39 #include "midi++/manager.h"
41 #include "ardour/ardour.h"
42 #include "ardour/session.h"
43 #include "ardour/audioengine.h"
44 #include "ardour/ladspa_plugin.h"
45 #include "ardour/buffer_set.h"
46 #include "ardour/audio_buffer.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 latency_compute_run ();
142 LadspaPlugin::~LadspaPlugin ()
147 GoingAway (); /* EMIT SIGNAL */
149 /* XXX who should close a plugin? */
153 delete [] _control_data;
154 delete [] _shadow_data;
158 LadspaPlugin::unique_id() const
161 snprintf (buf, sizeof (buf), "%lu", _descriptor->UniqueID);
166 LadspaPlugin::default_value (uint32_t port)
168 const LADSPA_PortRangeHint *prh = port_range_hints();
170 bool bounds_given = false;
171 bool sr_scaling = false;
172 bool earlier_hint = false;
174 /* defaults - case 1 */
176 if (LADSPA_IS_HINT_HAS_DEFAULT(prh[port].HintDescriptor)) {
177 if (LADSPA_IS_HINT_DEFAULT_MINIMUM(prh[port].HintDescriptor)) {
178 ret = prh[port].LowerBound;
183 /* FIXME: add support for logarithmic defaults */
185 else if (LADSPA_IS_HINT_DEFAULT_LOW(prh[port].HintDescriptor)) {
186 if (LADSPA_IS_HINT_LOGARITHMIC(prh[port].HintDescriptor)) {
187 ret = exp(log(prh[port].LowerBound) * 0.75f + log(prh[port].UpperBound) * 0.25f);
190 ret = prh[port].LowerBound * 0.75f + prh[port].UpperBound * 0.25f;
195 else if (LADSPA_IS_HINT_DEFAULT_MIDDLE(prh[port].HintDescriptor)) {
196 if (LADSPA_IS_HINT_LOGARITHMIC(prh[port].HintDescriptor)) {
197 ret = exp(log(prh[port].LowerBound) * 0.5f + log(prh[port].UpperBound) * 0.5f);
200 ret = prh[port].LowerBound * 0.5f + prh[port].UpperBound * 0.5f;
205 else if (LADSPA_IS_HINT_DEFAULT_HIGH(prh[port].HintDescriptor)) {
206 if (LADSPA_IS_HINT_LOGARITHMIC(prh[port].HintDescriptor)) {
207 ret = exp(log(prh[port].LowerBound) * 0.25f + log(prh[port].UpperBound) * 0.75f);
210 ret = prh[port].LowerBound * 0.25f + prh[port].UpperBound * 0.75f;
215 else if (LADSPA_IS_HINT_DEFAULT_MAXIMUM(prh[port].HintDescriptor)) {
216 ret = prh[port].UpperBound;
220 else if (LADSPA_IS_HINT_DEFAULT_0(prh[port].HintDescriptor)) {
224 else if (LADSPA_IS_HINT_DEFAULT_1(prh[port].HintDescriptor)) {
228 else if (LADSPA_IS_HINT_DEFAULT_100(prh[port].HintDescriptor)) {
232 else if (LADSPA_IS_HINT_DEFAULT_440(prh[port].HintDescriptor)) {
242 /* defaults - case 2 */
243 else if (LADSPA_IS_HINT_BOUNDED_BELOW(prh[port].HintDescriptor) &&
244 !LADSPA_IS_HINT_BOUNDED_ABOVE(prh[port].HintDescriptor)) {
246 if (prh[port].LowerBound < 0) {
249 ret = prh[port].LowerBound;
256 /* defaults - case 3 */
257 else if (!LADSPA_IS_HINT_BOUNDED_BELOW(prh[port].HintDescriptor) &&
258 LADSPA_IS_HINT_BOUNDED_ABOVE(prh[port].HintDescriptor)) {
260 if (prh[port].UpperBound > 0) {
263 ret = prh[port].UpperBound;
270 /* defaults - case 4 */
271 else if (LADSPA_IS_HINT_BOUNDED_BELOW(prh[port].HintDescriptor) &&
272 LADSPA_IS_HINT_BOUNDED_ABOVE(prh[port].HintDescriptor)) {
274 if (prh[port].LowerBound < 0 && prh[port].UpperBound > 0) {
276 } else if (prh[port].LowerBound < 0 && prh[port].UpperBound < 0) {
277 ret = prh[port].UpperBound;
279 ret = prh[port].LowerBound;
285 /* defaults - case 5 */
287 if (LADSPA_IS_HINT_SAMPLE_RATE(prh[port].HintDescriptor) && !earlier_hint) {
301 LadspaPlugin::set_parameter (uint32_t which, float val)
303 if (which < _descriptor->PortCount) {
304 _shadow_data[which] = (LADSPA_Data) val;
306 ParameterChanged (Parameter(PluginAutomation, 0, which), val); /* EMIT SIGNAL */
308 if (which < parameter_count() && controls[which]) {
309 controls[which]->Changed ();
314 warning << string_compose (_("illegal parameter number used with plugin \"%1\". This may"
315 "indicate a change in the plugin design, and presets may be"
322 LadspaPlugin::get_parameter (uint32_t which) const
324 if (LADSPA_IS_PORT_INPUT(port_descriptor (which))) {
325 return (float) _shadow_data[which];
327 return (float) _control_data[which];
332 LadspaPlugin::nth_parameter (uint32_t n, bool& ok) const
338 for (c = 0, x = 0; x < _descriptor->PortCount; ++x) {
339 if (LADSPA_IS_PORT_CONTROL (port_descriptor (x))) {
350 LadspaPlugin::get_state()
352 XMLNode *root = new XMLNode(state_node_name());
355 LocaleGuard lg (X_("POSIX"));
357 for (uint32_t i = 0; i < parameter_count(); ++i){
359 if (LADSPA_IS_PORT_INPUT(port_descriptor (i)) &&
360 LADSPA_IS_PORT_CONTROL(port_descriptor (i))){
362 child = new XMLNode("Port");
363 snprintf(buf, sizeof(buf), "%u", i);
364 child->add_property("number", string(buf));
365 snprintf(buf, sizeof(buf), "%+f", _shadow_data[i]);
366 child->add_property("value", string(buf));
367 root->add_child_nocopy (*child);
375 LadspaPlugin::save_preset (string name)
377 return Plugin::save_preset (name, "ladspa");
381 LadspaPlugin::set_state (const XMLNode& node, int version)
383 if (version < 3000) {
384 return set_state_2X (node, version);
389 XMLNodeConstIterator iter;
394 LocaleGuard lg (X_("POSIX"));
396 cout << "LADSPA Plugin set state " << version << "\n";
397 cout << "- node " << node.name() << "\n";
399 if (node.name() != state_node_name()) {
400 error << _("Bad node sent to LadspaPlugin::set_state") << endmsg;
404 nodes = node.children ("Port");
406 for(iter = nodes.begin(); iter != nodes.end(); ++iter){
410 if ((prop = child->property("number")) != 0) {
411 port = prop->value().c_str();
413 warning << _("LADSPA: no ladspa port number") << endmsg;
416 if ((prop = child->property("value")) != 0) {
417 data = prop->value().c_str();
419 warning << _("LADSPA: no ladspa port data") << endmsg;
423 sscanf (port, "%" PRIu32, &port_id);
424 set_parameter (port_id, atof(data));
427 latency_compute_run ();
433 LadspaPlugin::set_state_2X (const XMLNode& node, int version)
437 XMLNodeConstIterator iter;
442 LocaleGuard lg (X_("POSIX"));
444 cout << "LADSPA Plugin set state " << version << "\n";
445 cout << "- node " << node.name() << "\n";
447 if (node.name() != state_node_name()) {
448 error << _("Bad node sent to LadspaPlugin::set_state") << endmsg;
452 nodes = node.children ("port");
454 for(iter = nodes.begin(); iter != nodes.end(); ++iter){
458 if ((prop = child->property("number")) != 0) {
459 port = prop->value().c_str();
461 warning << _("LADSPA: no ladspa port number") << endmsg;
464 if ((prop = child->property("value")) != 0) {
465 data = prop->value().c_str();
467 warning << _("LADSPA: no ladspa port data") << endmsg;
471 sscanf (port, "%" PRIu32, &port_id);
472 set_parameter (port_id, atof(data));
475 latency_compute_run ();
481 LadspaPlugin::get_parameter_descriptor (uint32_t which, ParameterDescriptor& desc) const
483 LADSPA_PortRangeHint prh;
485 prh = port_range_hints()[which];
488 if (LADSPA_IS_HINT_BOUNDED_BELOW(prh.HintDescriptor)) {
489 desc.min_unbound = false;
490 if (LADSPA_IS_HINT_SAMPLE_RATE(prh.HintDescriptor)) {
491 desc.lower = prh.LowerBound * _session.frame_rate();
493 desc.lower = prh.LowerBound;
496 desc.min_unbound = true;
501 if (LADSPA_IS_HINT_BOUNDED_ABOVE(prh.HintDescriptor)) {
502 desc.max_unbound = false;
503 if (LADSPA_IS_HINT_SAMPLE_RATE(prh.HintDescriptor)) {
504 desc.upper = prh.UpperBound * _session.frame_rate();
506 desc.upper = prh.UpperBound;
509 desc.max_unbound = true;
510 desc.upper = 4; /* completely arbitrary */
513 if (LADSPA_IS_HINT_INTEGER (prh.HintDescriptor)) {
515 desc.smallstep = 0.1;
516 desc.largestep = 10.0;
518 float delta = desc.upper - desc.lower;
519 desc.step = delta / 1000.0f;
520 desc.smallstep = delta / 10000.0f;
521 desc.largestep = delta/10.0f;
524 desc.toggled = LADSPA_IS_HINT_TOGGLED (prh.HintDescriptor);
525 desc.logarithmic = LADSPA_IS_HINT_LOGARITHMIC (prh.HintDescriptor);
526 desc.sr_dependent = LADSPA_IS_HINT_SAMPLE_RATE (prh.HintDescriptor);
527 desc.integer_step = LADSPA_IS_HINT_INTEGER (prh.HintDescriptor);
529 desc.label = port_names()[which];
535 LadspaPlugin::describe_parameter (Evoral::Parameter which)
537 if (which.type() == PluginAutomation && which.id() < parameter_count()) {
538 return port_names()[which.id()];
545 LadspaPlugin::signal_latency () const
548 return _user_latency;
551 if (_latency_control_port) {
552 return (nframes_t) floor (*_latency_control_port);
558 set<Evoral::Parameter>
559 LadspaPlugin::automatable () const
561 set<Evoral::Parameter> ret;
563 for (uint32_t i = 0; i < parameter_count(); ++i){
564 if (LADSPA_IS_PORT_INPUT(port_descriptor (i)) &&
565 LADSPA_IS_PORT_CONTROL(port_descriptor (i))){
567 ret.insert (ret.end(), Evoral::Parameter(PluginAutomation, 0, i));
575 LadspaPlugin::connect_and_run (BufferSet& bufs,
576 ChanMapping in_map, ChanMapping out_map,
577 nframes_t nframes, nframes_t offset)
580 cycles_t then = get_cycles ();
582 uint32_t audio_in_index = 0;
583 uint32_t audio_out_index = 0;
584 for (uint32_t port_index = 0; port_index < parameter_count(); ++port_index) {
585 if (LADSPA_IS_PORT_AUDIO(port_descriptor(port_index))) {
586 if (LADSPA_IS_PORT_INPUT(port_descriptor(port_index))) {
587 const uint32_t buf_index = in_map.get(DataType::AUDIO, audio_in_index++);
588 connect_port(port_index, bufs.get_audio(buf_index).data(offset));
589 } else if (LADSPA_IS_PORT_OUTPUT(port_descriptor(port_index))) {
590 const uint32_t buf_index = out_map.get(DataType::AUDIO, audio_out_index++);
591 connect_port(port_index, bufs.get_audio(buf_index).data(offset));
596 run_in_place (nframes);
598 set_cycles ((uint32_t) (now - then));
604 LadspaPlugin::parameter_is_control (uint32_t param) const
606 return LADSPA_IS_PORT_CONTROL(port_descriptor (param));
610 LadspaPlugin::parameter_is_audio (uint32_t param) const
612 return LADSPA_IS_PORT_AUDIO(port_descriptor (param));
616 LadspaPlugin::parameter_is_output (uint32_t param) const
618 return LADSPA_IS_PORT_OUTPUT(port_descriptor (param));
622 LadspaPlugin::parameter_is_input (uint32_t param) const
624 return LADSPA_IS_PORT_INPUT(port_descriptor (param));
628 LadspaPlugin::print_parameter (uint32_t param, char *buf, uint32_t len) const
631 if (param < parameter_count()) {
632 snprintf (buf, len, "%.3f", get_parameter (param));
640 LadspaPlugin::run_in_place (nframes_t nframes)
642 for (uint32_t i = 0; i < parameter_count(); ++i) {
643 if (LADSPA_IS_PORT_INPUT(port_descriptor (i)) && LADSPA_IS_PORT_CONTROL(port_descriptor (i))) {
644 _control_data[i] = _shadow_data[i];
647 _descriptor->run (_handle, nframes);
651 LadspaPlugin::latency_compute_run ()
653 if (!_latency_control_port) {
657 /* we need to run the plugin so that it can set its latency
663 uint32_t port_index = 0;
664 uint32_t in_index = 0;
665 uint32_t out_index = 0;
666 const nframes_t bufsize = 1024;
667 LADSPA_Data buffer[bufsize];
669 memset(buffer,0,sizeof(LADSPA_Data)*bufsize);
671 /* Note that we've already required that plugins
672 be able to handle in-place processing.
677 while (port_index < parameter_count()) {
678 if (LADSPA_IS_PORT_AUDIO (port_descriptor (port_index))) {
679 if (LADSPA_IS_PORT_INPUT (port_descriptor (port_index))) {
680 connect_port (port_index, buffer);
682 } else if (LADSPA_IS_PORT_OUTPUT (port_descriptor (port_index))) {
683 connect_port (port_index, buffer);
690 run_in_place (bufsize);
695 LadspaPluginInfo::load (Session& session)
701 if ((module = dlopen (path.c_str(), RTLD_NOW)) == 0) {
702 error << string_compose(_("LADSPA: cannot load module from \"%1\""), path) << endmsg;
703 error << dlerror() << endmsg;
705 plugin.reset (new LadspaPlugin (module, session.engine(), session, index, session.frame_rate()));
708 plugin->set_info(PluginInfoPtr(new LadspaPluginInfo(*this)));
712 catch (failed_constructor &err) {
713 return PluginPtr ((Plugin*) 0);