13
0
livetrax/libs/ardour/panner_manager.cc
Robin Gareus a7a781971e
Change default stereo panner to equal power balance
The stereo-width panner is not generally useful. In order to
change the azimuth, width has to be reduced, which usually leads
to comb-filter artifacts.

Equal power stereo, also matches the default mono to stereo panner
better than the stereo-width panner.

Last but not least, control surfaces only have an azimuth control
knob, without an easy way to reduce width, this leaves
the panner insensitive.
2020-03-15 21:39:53 +01:00

291 lines
8.1 KiB
C++

/*
* Copyright (C) 2011-2016 Paul Davis <paul@linuxaudiosystems.com>
* Copyright (C) 2011 Carl Hetherington <carl@carlh.net>
* Copyright (C) 2011 David Robillard <d@drobilla.net>
* Copyright (C) 2012-2014 Tim Mayberry <mojofunk@gmail.com>
* Copyright (C) 2014 John Emmas <john@creativepost.co.uk>
* Copyright (C) 2014 Robin Gareus <robin@gareus.org>
*
* 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; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*/
#include <unistd.h>
#include <glibmm/pattern.h>
#include <glibmm/fileutils.h>
#include "pbd/error.h"
#include "pbd/compose.h"
#include "pbd/file_utils.h"
#include "pbd/stateful.h"
#include "pbd/stl_delete.h"
#include "ardour/debug.h"
#include "ardour/panner_manager.h"
#include "ardour/search_paths.h"
#include "pbd/i18n.h"
using namespace std;
using namespace ARDOUR;
using namespace PBD;
PannerManager* PannerManager::_instance = 0;
PannerManager::PannerManager ()
{
}
PannerManager::~PannerManager ()
{
for (list<PannerInfo*>::iterator p = panner_info.begin(); p != panner_info.end(); ++p) {
delete *p;
}
}
PannerManager&
PannerManager::instance ()
{
if (_instance == 0) {
_instance = new PannerManager ();
}
return *_instance;
}
static bool panner_filter (const string& str, void */*arg*/)
{
#ifdef COMPILER_MSVC
/**
* Different build targets (Debug / Release etc) use different versions
* of the 'C' runtime (which can't be 'mixed & matched'). Therefore, in
* case the supplied search path contains multiple version(s) of a given
* panner module, only select the one(s) which match the current build
* target (otherwise, all hell will break loose !!)
*/
#if defined (_DEBUG)
return str.length() > 12 && (str.find ("panner_") == 0) && (str.find ("D.dll") == (str.length() - 5));
#elif defined (RDC_BUILD)
return str.length() > 14 && (str.find ("panner_") == 0) && (str.find ("RDC.dll") == (str.length() - 7));
#elif defined (_WIN64)
return str.length() > 13 && (str.find ("panner_") == 0) && (str.find ("64.dll") == (str.length() - 6));
#else
return str.length() > 13 && (str.find ("panner_") == 0) && (str.find ("32.dll") == (str.length() - 6));
#endif
#elif defined (__APPLE__)
return str[0] != '.' && (str.length() > 6 && str.find (".dylib") == (str.length() - 6));
#else
return str[0] != '.' && (str.length() > 3 && (str.find (".so") == (str.length() - 3) || str.find (".dll") == (str.length() - 4)));
#endif
}
void
PannerManager::discover_panners ()
{
std::vector<std::string> panner_modules;
DEBUG_TRACE (DEBUG::Panning, string_compose (_("looking for panners in %1\n"), panner_search_path().to_string()));
find_files_matching_filter (panner_modules, panner_search_path(), panner_filter, 0, false, true, true);
for (vector<std::string>::iterator i = panner_modules.begin(); i != panner_modules.end(); ++i) {
panner_discover (*i);
}
}
int
PannerManager::panner_discover (string path)
{
PannerInfo* pinfo;
if ((pinfo = get_descriptor (path)) != 0) {
list<PannerInfo*>::iterator i;
for (i = panner_info.begin(); i != panner_info.end(); ++i) {
if (pinfo->descriptor.name == (*i)->descriptor.name) {
break;
}
}
if (i == panner_info.end()) {
panner_info.push_back (pinfo);
DEBUG_TRACE (DEBUG::Panning, string_compose(_("Panner discovered: \"%1\" in %2\n"), pinfo->descriptor.name, path));
} else {
delete pinfo;
}
}
return 0;
}
PannerInfo*
PannerManager::get_descriptor (string path)
{
Glib::Module* module = new Glib::Module(path);
PannerInfo* info = 0;
PanPluginDescriptor *descriptor = 0;
PanPluginDescriptor* (*dfunc)(void);
void* func = 0;
if (!module) {
error << string_compose(_("PannerManager: cannot load module \"%1\" (%2)"), path,
Glib::Module::get_last_error()) << endmsg;
delete module;
return 0;
}
if (!module->get_symbol("panner_descriptor", func)) {
error << string_compose(_("PannerManager: module \"%1\" has no descriptor function."), path) << endmsg;
error << Glib::Module::get_last_error() << endmsg;
delete module;
return 0;
}
dfunc = (PanPluginDescriptor* (*)(void))func;
descriptor = dfunc();
if (descriptor) {
info = new PannerInfo (*descriptor, module);
} else {
delete module;
}
return info;
}
PannerInfo*
PannerManager::select_panner (ChanCount in, ChanCount out, std::string const uri)
{
PannerInfo* rv = NULL;
int32_t nin = in.n_audio();
int32_t nout = out.n_audio();
uint32_t priority = 0;
/* look for user-preference -- check if channels match */
for (list<PannerInfo*>::iterator p = panner_info.begin(); p != panner_info.end(); ++p) {
PanPluginDescriptor const& d ((*p)->descriptor);
if (d.panner_uri != uri) continue;
if (d.in != nin && d.in != -1) continue;
if (d.out != nout && d.out != -1) continue;
return *p;
}
/* look for exact match first */
for (list<PannerInfo*>::iterator p = panner_info.begin(); p != panner_info.end(); ++p) {
PanPluginDescriptor const& d ((*p)->descriptor);
/* backward compat */
if (Stateful::loading_state_version < 6000 && d.panner_uri == "http://ardour.org/plugin/panner_2in2out") {
if (d.in == nin && d.out == nout) {
priority = 9999;
rv = *p;
}
}
if (d.in == nin && d.out == nout && d.priority > priority) {
priority = d.priority;
rv = *p;
}
}
if (rv) { return rv; }
/* no exact match, look for good fit on inputs and variable on outputs */
#if 0
priority = 0;
/* unused, so far Ardour only features 4 panners:
* in = 1 ; out = 2 // Mono to Stereo
* in = 2 ; out = 2 // Equal Power Stereo
* in = 2 ; out = 2 // Stereo Balance
* in = -1 ; out = -1 // VBAP
*/
for (list<PannerInfo*>::iterator p = panner_info.begin(); p != panner_info.end(); ++p) {
PanPluginDescriptor const& d ((*p)->descriptor);
if (d.in == nin && d.out == -1 && d.priority > priority) {
priority = d.priority;
rv = *p;
}
}
if (rv) { return rv; }
/* no exact match, look for good fit on outputs and variable on inputs */
priority = 0;
for (list<PannerInfo*>::iterator p = panner_info.begin(); p != panner_info.end(); ++p) {
PanPluginDescriptor const& d ((*p)->descriptor);
if (d.in == -1 && d.out == nout && d.priority > priority) {
priority = d.priority;
rv = *p;
}
}
if (rv) { return rv; }
#endif
/* no exact match, look for variable fit on inputs and outputs */
priority = 0;
for (list<PannerInfo*>::iterator p = panner_info.begin(); p != panner_info.end(); ++p) {
PanPluginDescriptor const& d ((*p)->descriptor);
if (d.in == -1 && d.out == -1 && d.priority > priority) {
priority = d.priority;
rv = *p;
}
}
if (rv) { return rv; }
warning << string_compose (_("no panner discovered for in/out = %1/%2"), nin, nout) << endmsg;
return 0;
}
PannerInfo*
PannerManager::get_by_uri (std::string uri) const
{
PannerInfo* pi = NULL;
for (list<PannerInfo*>::const_iterator p = panner_info.begin(); p != panner_info.end(); ++p) {
if ((*p)->descriptor.panner_uri != uri) continue;
pi = (*p);
break;
}
return pi;
}
PannerUriMap
PannerManager::get_available_panners(uint32_t const a_in, uint32_t const a_out) const
{
int const in = a_in;
int const out = a_out;
PannerUriMap panner_list;
if (out < 2 || in == 0) {
return panner_list;
}
/* get available panners for current configuration. */
for (list<PannerInfo*>::const_iterator p = panner_info.begin(); p != panner_info.end(); ++p) {
PanPluginDescriptor const& d ((*p)->descriptor);
if (d.in != -1 && d.in != in) continue;
if (d.out != -1 && d.out != out) continue;
if (d.in == -1 && d.out == -1 && out <= 2) continue;
panner_list.insert(std::pair<std::string,std::string>(d.panner_uri,d.name));
}
return panner_list;
}