/*******************************************************************************/ /* Copyright (C) 2009 Jonathan Moore Liles */ /* */ /* This program is free software; you can redistribute it and/or modify it */ /* under the terms of the GNU General Public License as published by the */ /* Free Software Foundation; either version 2 of the License, or (at your */ /* option) any later version. */ /* */ /* This program is distributed in the hope that it will be useful, but WITHOUT */ /* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or */ /* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for */ /* more details. */ /* */ /* You should have received a copy of the GNU General Public License along */ /* with This program; see the file COPYING. If not,write to the Free Software */ /* Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */ /*******************************************************************************/ /* Filter module. Can host LADPSA Plugins, or can be inherited from to make internal modules with special features and appearance. */ #include "const.h" #include #include #include #include #include #include #include #include #include #include "Plugin_Module.H" #include "debug.h" #define HAVE_LIBLRDF 1 #include "LADSPAInfo.h" #include "Chain.H" #include "Engine/Engine.H" #include static LADSPAInfo *ladspainfo; Thread* Plugin_Module::plugin_discover_thread; /* keep this out of the header to avoid spreading ladspa.h dependency */ struct Plugin_Module::ImplementationData { const LADSPA_Descriptor *descriptor; // std::vector m_LADSPABufVec; std::vector handle; }; Plugin_Module::Plugin_Module ( ) : Module( 50, 35, name() ) { init(); end(); log_create(); } Plugin_Module::~Plugin_Module ( ) { log_destroy(); plugin_instances( 0 ); } void Plugin_Module::get ( Log_Entry &e ) const { // char s[512]; // snprintf( s, sizeof( s ), "ladspa:%lu", _idata->descriptor->UniqueID ); e.add( ":plugin_id", _idata->descriptor->UniqueID ); /* these help us display the module on systems which are missing this plugin */ e.add( ":plugin_ins", _plugin_ins ); e.add( ":plugin_outs", _plugin_outs ); Module::get( e ); } void Plugin_Module::set ( Log_Entry &e ) { for ( int i = 0; i < e.size(); ++i ) { const char *s, *v; e.get( i, &s, &v ); if ( ! strcmp( s, ":plugin_id" ) ) { load( (unsigned long) atoll ( v ) ); } else if ( ! strcmp( s, ":plugin_ins" ) ) { _plugin_ins = atoi( v ); } else if ( ! strcmp( s, ":plugin_outs" ) ) { _plugin_outs = atoi( v ); } } Module::set( e ); } void Plugin_Module::add_plugins_to_menu ( Fl_Menu_Button *menu ) { Plugin_Module::Plugin_Info *pia = Plugin_Module::get_all_plugins(); char path[1024]; for ( Plugin_Module::Plugin_Info *pi = pia; pi->path; ++pi ) { snprintf( path, sizeof( path ), "Plugin/%s", pi->path ); menu->add(path, 0, NULL, new unsigned long( pi->id ), 0 ); } delete[] pia; } /* allow the user to pick a plugin */ Plugin_Module * Plugin_Module::pick_plugin ( void ) { /**************/ /* build menu */ /**************/ Fl_Menu_Button *menu = new Fl_Menu_Button( 0, 0, 400, 400 ); menu->type( Fl_Menu_Button::POPUP3 ); Plugin_Module::Plugin_Info *pia = Plugin_Module::get_all_plugins(); for ( Plugin_Module::Plugin_Info *pi = pia; pi->path; ++pi ) { menu->add(pi->path, 0, NULL, pi, 0 ); } menu->popup(); if ( menu->value() <= 0 ) return NULL; /************************/ /* load selected plugin */ /************************/ Plugin_Module::Plugin_Info *pi = (Plugin_Module::Plugin_Info*)menu->menu()[ menu->value() ].user_data(); if ( ! pi ) return NULL; Plugin_Module *m = new Plugin_Module(); m->load( pi->id ); delete[] pia; return m; } void Plugin_Module::init ( void ) { _idata = new Plugin_Module::ImplementationData(); _idata->handle.clear(); /* module will be bypassed until plugin is loaded */ _bypass = true; _crosswire = false; align( (Fl_Align)FL_ALIGN_CENTER | FL_ALIGN_INSIDE ); // color( (Fl_Color)fl_color_average( FL_MAGENTA, FL_WHITE, 0.5f ) ); int tw, th, tx, ty; bbox( tx, ty, tw, th ); } int Plugin_Module::can_support_inputs ( int n ) { /* this is the simple case */ if ( plugin_ins() == n ) return plugin_outs(); /* e.g. MONO going into STEREO */ /* we'll duplicate our inputs */ else if ( n < plugin_ins() && 1 == n ) { return plugin_outs(); } /* e.g. STEREO going into MONO */ /* we'll run multiple instances of the plugin */ else if ( n > plugin_ins() && ( plugin_ins() == 1 && plugin_outs() == 1 ) ) { return n; } return -1; } bool Plugin_Module::configure_inputs( int n ) { int inst = _idata->handle.size(); if ( ninputs() != n ) { _crosswire = false; if ( n != ninputs() ) { if ( 1 == n && plugin_ins() > 1 ) { DMESSAGE( "Cross-wiring plugin inputs" ); _crosswire = true; audio_input.clear(); for ( int i = n; i--; ) audio_input.push_back( Port( this, Port::INPUT, Port::AUDIO ) ); } else if ( n >= plugin_ins() && ( plugin_ins() == 1 && plugin_outs() == 1 ) ) { DMESSAGE( "Running multiple instances of plugin" ); audio_input.clear(); audio_output.clear(); for ( int i = n; i--; ) { add_port( Port( this, Port::INPUT, Port::AUDIO ) ); add_port( Port( this, Port::OUTPUT, Port::AUDIO ) ); } inst = n; } else if ( n == plugin_ins() ) { DMESSAGE( "Plugin input configuration is a perfect match" ); } else { DMESSAGE( "Unsupported input configuration" ); return false; } } } if ( loaded() ) { bool b = bypass(); if ( !b ) deactivate(); if ( plugin_instances( inst ) ) instances( inst ); else return false; if ( !b ) activate(); } return true; } void * Plugin_Module::discover_thread ( void * ) { THREAD_ASSERT( Plugin_Discover ); DMESSAGE( "Discovering plugins in the background" ); ladspainfo = new LADSPAInfo(); return NULL; } /* Spawn a background thread for plugin discovery */ void Plugin_Module::spawn_discover_thread ( void ) { if ( plugin_discover_thread ) { FATAL( "Plugin discovery thread is already running or has completed" ); } plugin_discover_thread = new Thread( "Plugin_Discover" ); plugin_discover_thread->clone( &Plugin_Module::discover_thread, NULL ); } void Plugin_Module::join_discover_thread ( void ) { plugin_discover_thread->join(); } /* return a list of available plugins */ Plugin_Module::Plugin_Info * Plugin_Module::get_all_plugins ( void ) { if ( !ladspainfo ) { if ( ! plugin_discover_thread ) ladspainfo = new LADSPAInfo(); else plugin_discover_thread->join(); } std::vector plugins = ladspainfo->GetMenuList(); Plugin_Info* pi = new Plugin_Info[plugins.size() + 1]; int j = 0; for (std::vector::iterator i=plugins.begin(); i!=plugins.end(); i++, j++) { pi[j].path = i->Name.c_str(); pi[j].id = i->UniqueID; } return pi; } bool Plugin_Module::plugin_instances ( unsigned int n ) { if ( _idata->handle.size() > n ) { for ( int i = _idata->handle.size() - n; i--; ) { DMESSAGE( "Destroying plugin instance" ); LADSPA_Handle h = _idata->handle.back(); if ( _idata->descriptor->deactivate ) _idata->descriptor->deactivate( h ); if ( _idata->descriptor->cleanup ) _idata->descriptor->cleanup( h ); _idata->handle.pop_back(); } } else if ( _idata->handle.size() < n ) { for ( int i = n - _idata->handle.size(); i--; ) { LADSPA_Handle h; DMESSAGE( "Instantiating plugin..." ); if ( ! (h = _idata->descriptor->instantiate( _idata->descriptor, Engine::sample_rate() ) ) ) { WARNING( "Failed to instantiate plugin" ); return false; } DMESSAGE( "Instantiated: %p", h ); _idata->handle.push_back( h ); DMESSAGE( "Connecting control ports..." ); int ij = 0; int oj = 0; for ( unsigned int k = 0; k < _idata->descriptor->PortCount; ++k ) { if ( LADSPA_IS_PORT_CONTROL( _idata->descriptor->PortDescriptors[k] ) ) { if ( LADSPA_IS_PORT_INPUT( _idata->descriptor->PortDescriptors[k] ) ) _idata->descriptor->connect_port( h, k, (LADSPA_Data*)control_input[ij++].buffer() ); else if ( LADSPA_IS_PORT_OUTPUT( _idata->descriptor->PortDescriptors[k] ) ) _idata->descriptor->connect_port( h, k, (LADSPA_Data*)control_output[oj++].buffer() ); } } // connect ports to magic bogus value to aid debugging. for ( unsigned int k = 0; k < _idata->descriptor->PortCount; ++k ) if ( LADSPA_IS_PORT_AUDIO( _idata->descriptor->PortDescriptors[k] ) ) _idata->descriptor->connect_port( h, k, (LADSPA_Data*)0x42 ); } } return true; } void Plugin_Module::bypass ( bool v ) { if ( v != bypass() ) { if ( v ) deactivate(); else activate(); } } bool Plugin_Module::load ( unsigned long id ) { if ( !ladspainfo ) { if ( ! plugin_discover_thread ) ladspainfo = new LADSPAInfo(); else plugin_discover_thread->join(); } _idata->descriptor = ladspainfo->GetDescriptorByID( id ); _plugin_ins = _plugin_outs = 0; if ( ! _idata->descriptor ) { /* unknown plugin ID */ WARNING( "Unknown plugin ID: %lu", id ); label( "----" ); return false; } label( _idata->descriptor->Name ); if ( _idata->descriptor ) { if ( LADSPA_IS_INPLACE_BROKEN( _idata->descriptor->Properties ) ) { WARNING( "Cannot use this plugin because it is incapable of processing audio in-place" ); return false; } else if ( ! LADSPA_IS_HARD_RT_CAPABLE( _idata->descriptor->Properties ) ) { WARNING( "Cannot use this plugin because it is incapable of hard real-time operation" ); return false; } MESSAGE( "Name: %s", _idata->descriptor->Name ); for ( unsigned int i = 0; i < _idata->descriptor->PortCount; ++i ) { if ( LADSPA_IS_PORT_AUDIO( _idata->descriptor->PortDescriptors[i] ) ) { if ( LADSPA_IS_PORT_INPUT( _idata->descriptor->PortDescriptors[i] ) ) { add_port( Port( this, Port::INPUT, Port::AUDIO, _idata->descriptor->PortNames[ i ] ) ); _plugin_ins++; } else if (LADSPA_IS_PORT_OUTPUT(_idata->descriptor->PortDescriptors[i])) { _plugin_outs++; add_port( Port( this, Port::OUTPUT, Port::AUDIO, _idata->descriptor->PortNames[ i ] ) ); } } } MESSAGE( "Plugin has %i inputs and %i outputs", _plugin_ins, _plugin_outs); for ( unsigned int i = 0; i < _idata->descriptor->PortCount; ++i ) { if ( LADSPA_IS_PORT_CONTROL( _idata->descriptor->PortDescriptors[i] ) ) { Port::Direction d = Port::INPUT; if ( LADSPA_IS_PORT_INPUT( _idata->descriptor->PortDescriptors[i] ) ) { d = Port::INPUT; } else if ( LADSPA_IS_PORT_OUTPUT( _idata->descriptor->PortDescriptors[i] ) ) { d = Port::OUTPUT; } Port p( this, d, Port::CONTROL, _idata->descriptor->PortNames[ i ] ); LADSPA_PortRangeHintDescriptor hd = _idata->descriptor->PortRangeHints[i].HintDescriptor; if ( LADSPA_IS_HINT_BOUNDED_BELOW(hd) ) { p.hints.ranged = true; p.hints.minimum = _idata->descriptor->PortRangeHints[i].LowerBound; if ( LADSPA_IS_HINT_SAMPLE_RATE(hd) ) { p.hints.minimum *= Engine::sample_rate(); } } if ( LADSPA_IS_HINT_BOUNDED_ABOVE(hd) ) { p.hints.ranged = true; p.hints.maximum = _idata->descriptor->PortRangeHints[i].UpperBound; if ( LADSPA_IS_HINT_SAMPLE_RATE(hd) ) { p.hints.maximum *= Engine::sample_rate(); } } if ( LADSPA_IS_HINT_HAS_DEFAULT(hd) ) { float Max=1.0f, Min=-1.0f, Default=0.0f; int Port=i; // Get the bounding hints for the port LADSPA_PortRangeHintDescriptor HintDesc=_idata->descriptor->PortRangeHints[Port].HintDescriptor; if (LADSPA_IS_HINT_BOUNDED_BELOW(HintDesc)) { Min=_idata->descriptor->PortRangeHints[Port].LowerBound; if (LADSPA_IS_HINT_SAMPLE_RATE(HintDesc)) { Min*=Engine::sample_rate(); } } if (LADSPA_IS_HINT_BOUNDED_ABOVE(HintDesc)) { Max=_idata->descriptor->PortRangeHints[Port].UpperBound; if (LADSPA_IS_HINT_SAMPLE_RATE(HintDesc)) { Max*=Engine::sample_rate(); } } #ifdef LADSPA_VERSION // We've got a version of the header that supports port defaults if (LADSPA_IS_HINT_HAS_DEFAULT(HintDesc)) { // LADSPA_HINT_DEFAULT_0 is assumed anyway, so we don't check for it if (LADSPA_IS_HINT_DEFAULT_1(HintDesc)) { Default = 1.0f; } else if (LADSPA_IS_HINT_DEFAULT_100(HintDesc)) { Default = 100.0f; } else if (LADSPA_IS_HINT_DEFAULT_440(HintDesc)) { Default = 440.0f; } else { // These hints may be affected by SAMPLERATE, LOGARITHMIC and INTEGER if (LADSPA_IS_HINT_DEFAULT_MINIMUM(HintDesc) && LADSPA_IS_HINT_BOUNDED_BELOW(HintDesc)) { Default=_idata->descriptor->PortRangeHints[Port].LowerBound; } else if (LADSPA_IS_HINT_DEFAULT_MAXIMUM(HintDesc) && LADSPA_IS_HINT_BOUNDED_ABOVE(HintDesc)) { Default=_idata->descriptor->PortRangeHints[Port].UpperBound; } else if (LADSPA_IS_HINT_BOUNDED_BELOW(HintDesc) && LADSPA_IS_HINT_BOUNDED_ABOVE(HintDesc)) { // These hints require both upper and lower bounds float lp = 0.0f, up = 0.0f; float min = _idata->descriptor->PortRangeHints[Port].LowerBound; float max = _idata->descriptor->PortRangeHints[Port].UpperBound; if (LADSPA_IS_HINT_DEFAULT_LOW(HintDesc)) { lp = 0.75f; up = 0.25f; } else if (LADSPA_IS_HINT_DEFAULT_MIDDLE(HintDesc)) { lp = 0.5f; up = 0.5f; } else if (LADSPA_IS_HINT_DEFAULT_HIGH(HintDesc)) { lp = 0.25f; up = 0.75f; } if (LADSPA_IS_HINT_LOGARITHMIC(HintDesc)) { p.hints.type = Port::Hints::LOGARITHMIC; if (min==0.0f || max==0.0f) { // Zero at either end means zero no matter // where hint is at, since: // log(n->0) -> Infinity Default = 0.0f; } else { // Catch negatives bool neg_min = min < 0.0f ? true : false; bool neg_max = max < 0.0f ? true : false; if (!neg_min && !neg_max) { Default = exp(::log(min) * lp + ::log(max) * up); } else if (neg_min && neg_max) { Default = -exp(::log(-min) * lp + ::log(-max) * up); } else { // Logarithmic range has asymptote // so just use linear scale Default = min * lp + max * up; } } } else { Default = min * lp + max * up; } } if (LADSPA_IS_HINT_SAMPLE_RATE(HintDesc)) { Default *= Engine::sample_rate(); } if (LADSPA_IS_HINT_INTEGER(HintDesc)) { if ( p.hints.ranged && 0 == p.hints.minimum && 1 == p.hints.maximum ) p.hints.type = Port::Hints::BOOLEAN; else p.hints.type = Port::Hints::INTEGER; Default = floorf(Default); } if (LADSPA_IS_HINT_TOGGLED(HintDesc)){ p.hints.type = Port::Hints::BOOLEAN; } } } #else Default = 0.0f; #endif p.hints.default_value = Default; } float *control_value = new float; *control_value = p.hints.default_value; p.connect_to( control_value ); add_port( p ); DMESSAGE( "Plugin has control port \"%s\" (default: %f)", _idata->descriptor->PortNames[ i ], p.hints.default_value ); } } } else { WARNING( "Failed to load plugin" ); return false; } int instances = plugin_instances( 1 ); if ( instances ) { bypass( false ); } return instances; } void Plugin_Module::set_input_buffer ( int n, void *buf ) { LADSPA_Handle h; if ( instances() > 1 ) { h = _idata->handle[n]; n = 0; } else h = _idata->handle[0]; for ( unsigned int i = 0; i < _idata->descriptor->PortCount; ++i ) if ( LADSPA_IS_PORT_INPUT( _idata->descriptor->PortDescriptors[i] ) && LADSPA_IS_PORT_AUDIO( _idata->descriptor->PortDescriptors[i] ) ) if ( n-- == 0 ) _idata->descriptor->connect_port( h, i, (LADSPA_Data*)buf ); } bool Plugin_Module::loaded ( void ) const { return _idata->descriptor; } void Plugin_Module::set_output_buffer ( int n, void *buf ) { LADSPA_Handle h; if ( instances() > 1 ) { h = _idata->handle[n]; n = 0; } else h = _idata->handle[0]; for ( unsigned int i = 0; i < _idata->descriptor->PortCount; ++i ) if ( LADSPA_IS_PORT_OUTPUT( _idata->descriptor->PortDescriptors[i] ) && LADSPA_IS_PORT_AUDIO( _idata->descriptor->PortDescriptors[i] ) ) if ( n-- == 0 ) _idata->descriptor->connect_port( h, i, (LADSPA_Data*)buf ); } void Plugin_Module::activate ( void ) { if ( !loaded() ) return; DMESSAGE( "Activating plugin \"%s\"", label() ); if ( !bypass() ) FATAL( "Attempt to activate already active plugin" ); if ( chain() ) chain()->engine()->lock(); if ( _idata->descriptor->activate ) for ( unsigned int i = 0; i < _idata->handle.size(); ++i ) _idata->descriptor->activate( _idata->handle[i] ); _bypass = false; if ( chain() ) chain()->engine()->unlock(); } void Plugin_Module::deactivate( void ) { if ( !loaded() ) return; DMESSAGE( "Deactivating plugin \"%s\"", label() ); if ( chain() ) chain()->engine()->lock(); _bypass = true; if ( _idata->descriptor->deactivate ) for ( unsigned int i = 0; i < _idata->handle.size(); ++i ) _idata->descriptor->deactivate( _idata->handle[i] ); if ( chain() ) chain()->engine()->unlock(); } void Plugin_Module::handle_port_connection_change ( void ) { // DMESSAGE( "Connecting audio ports" ); if ( loaded() ) { if ( _crosswire ) { for ( int i = 0; i < plugin_ins(); ++i ) set_input_buffer( i, audio_input[0].buffer() ); } else { for ( unsigned int i = 0; i < audio_input.size(); ++i ) set_input_buffer( i, audio_input[i].buffer() ); } for ( unsigned int i = 0; i < audio_output.size(); ++i ) set_output_buffer( i, audio_output[i].buffer() ); } } /**********/ /* Engine */ /**********/ void Plugin_Module::process ( nframes_t nframes ) { handle_port_connection_change(); if ( !bypass() ) { for ( unsigned int i = 0; i < _idata->handle.size(); ++i ) _idata->descriptor->run( _idata->handle[i], nframes ); } else { /* If this is a mono to stereo plugin, then duplicate the input channel... */ /* There's not much we can do to automatically support other configurations. */ if ( ninputs() == 1 && noutputs() == 2 ) { buffer_copy( (sample_t*)audio_output[1].buffer(), (sample_t*)audio_input[0].buffer(), nframes ); } } }