libs/ardour/control_group.cc

   1 /*
   2     Copyright (C) 2016 Paul Davis
   3
   4     This program is free software; you can redistribute it and/or modify it
   5     under the terms of the GNU General Public License as published by the Free
   6     Software Foundation; either version 2 of the License, or (at your option)
   7     any later version.
   8
   9     This program is distributed in the hope that it will be useful, but WITHOUT
  10     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  11     FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  12     for more details.
  13
  14     You should have received a copy of the GNU General Public License along
  15     with this program; if not, write to the Free Software Foundation, Inc.,
  16     675 Mass Ave, Cambridge, MA 02139, USA.
  17 */
  18
  19 #include <vector>
  20
  21 #include "pbd/unwind.h"
  22
  23 #include "ardour/control_group.h"
  24 #include "ardour/gain_control.h"
  25
  26 using namespace ARDOUR;
  27 using namespace PBD;
  28
  29 ControlGroup::ControlGroup (Evoral::Parameter p)
  30         : _parameter (p)
  31         , _active (true)
  32         , _mode (Mode (0))
  33         , propagating (false)
  34 {
  35 }
  36
  37
  38 ControlGroup::~ControlGroup ()
  39 {
  40         clear ();
  41 }
  42
  43 void
  44 ControlGroup::set_active (bool yn)
  45 {
  46         _active = yn;
  47 }
  48
  49 void
  50 ControlGroup::set_mode (Mode m)
  51 {
  52         _mode = m;
  53 }
  54
  55 void
  56 ControlGroup::clear ()
  57 {
  58         /* we're giving up on all members, so we don't care about their
  59          * DropReferences signals anymore
  60          */
  61
  62         member_connections.drop_connections ();
  63
  64         /* make a copy so that when the control calls ::remove_control(), we
  65          * don't deadlock.
  66          */
  67
  68         std::vector<boost::shared_ptr<AutomationControl> > controls;
  69         {
  70                 Glib::Threads::RWLock::WriterLock lm (controls_lock);
  71                 for (ControlMap::const_iterator i = _controls.begin(); i != _controls.end(); ++i) {
  72                         controls.push_back (i->second);
  73                 }
  74         }
  75
  76         _controls.clear ();
  77
  78         for (std::vector<boost::shared_ptr<AutomationControl> >::iterator c = controls.begin(); c != controls.end(); ++c) {
  79                 (*c)->set_group (boost::shared_ptr<ControlGroup>());
  80         }
  81 }
  82
  83 ControlList
  84 ControlGroup::controls () const
  85 {
  86         ControlList c;
  87
  88         if (_active) {
  89                 Glib::Threads::RWLock::WriterLock lm (controls_lock);
  90                 for (ControlMap::const_iterator i = _controls.begin(); i != _controls.end(); ++i) {
  91                         c.push_back (i->second);
  92                 }
  93         }
  94
  95         return c;
  96 }
  97
  98 void
  99 ControlGroup::control_going_away (boost::weak_ptr<AutomationControl> wac)
 100 {
 101         boost::shared_ptr<AutomationControl> ac (wac.lock());
 102         if (!ac) {
 103                 return;
 104         }
 105
 106         remove_control (ac);
 107 }
 108
 109 int
 110 ControlGroup::remove_control (boost::shared_ptr<AutomationControl> ac)
 111 {
 112         int erased;
 113
 114         {
 115                 Glib::Threads::RWLock::WriterLock lm (controls_lock);
 116                 erased = _controls.erase (ac->id());
 117         }
 118
 119         if (erased) {
 120                 ac->set_group (boost::shared_ptr<ControlGroup>());
 121         }
 122
 123         /* return zero if erased, non-zero otherwise */
 124         return !erased;
 125 }
 126
 127 int
 128 ControlGroup::add_control (boost::shared_ptr<AutomationControl> ac)
 129 {
 130         if (ac->parameter() != _parameter) {
 131                 return -1;
 132         }
 133
 134         std::pair<ControlMap::iterator,bool> res;
 135
 136         {
 137                 Glib::Threads::RWLock::WriterLock lm (controls_lock);
 138                 res = _controls.insert (std::make_pair (ac->id(), ac));
 139         }
 140
 141         if (!res.second) {
 142                 /* already in ControlMap */
 143                 return -1;
 144         }
 145
 146         /* Inserted */
 147
 148         ac->set_group (shared_from_this());
 149
 150         ac->DropReferences.connect_same_thread (member_connections, boost::bind (&ControlGroup::control_going_away, this, boost::weak_ptr<AutomationControl>(ac)));
 151
 152         return 0;
 153 }
 154
 155 void
 156 ControlGroup::pre_realtime_queue_stuff (double val)
 157 {
 158         Glib::Threads::RWLock::ReaderLock lm (controls_lock);
 159
 160         for (ControlMap::iterator c = _controls.begin(); c != _controls.end(); ++c) {
 161                 c->second->do_pre_realtime_queue_stuff (val);
 162         }
 163 }
 164
 165 void
 166 ControlGroup::set_group_value (boost::shared_ptr<AutomationControl> control, double val)
 167 {
 168         double old = control->get_value ();
 169
 170         /* set the primary control */
 171
 172         control->set_value (val, Controllable::ForGroup);
 173
 174         /* now propagate across the group */
 175
 176         Glib::Threads::RWLock::ReaderLock lm (controls_lock);
 177
 178         if (_mode & Relative) {
 179
 180                 const double factor = old / control->get_value ();
 181
 182                 for (ControlMap::iterator c = _controls.begin(); c != _controls.end(); ++c) {
 183                         if (c->second != control) {
 184                                 c->second->set_value (factor * c->second->get_value(), Controllable::ForGroup);
 185                         }
 186                 }
 187
 188         } else {
 189
 190                 for (ControlMap::iterator c = _controls.begin(); c != _controls.end(); ++c) {
 191                         if (c->second != control) {
 192                                 c->second->set_value (val, Controllable::ForGroup);
 193                         }
 194                 }
 195         }
 196 }
 197
 198 /*---- GAIN CONTROL GROUP -----------*/
 199
 200 GainControlGroup::GainControlGroup ()
 201         : ControlGroup (GainAutomation)
 202 {
 203 }
 204
 205 gain_t
 206 GainControlGroup::get_min_factor (gain_t factor)
 207 {
 208         /* CALLER MUST HOLD READER LOCK */
 209
 210         for (ControlMap::iterator c = _controls.begin(); c != _controls.end(); ++c) {
 211                 gain_t const g = c->second->get_value();
 212
 213                 if ((g + g * factor) >= 0.0f) {
 214                         continue;
 215                 }
 216
 217                 if (g <= 0.0000003f) {
 218                         return 0.0f;
 219                 }
 220
 221                 factor = 0.0000003f / g - 1.0f;
 222         }
 223
 224         return factor;
 225 }
 226
 227 gain_t
 228 GainControlGroup::get_max_factor (gain_t factor)
 229 {
 230         /* CALLER MUST HOLD READER LOCK */
 231
 232         for (ControlMap::iterator c = _controls.begin(); c != _controls.end(); ++c) {
 233                 gain_t const g = c->second->get_value();
 234
 235                 // if the current factor woulnd't raise this route above maximum
 236                 if ((g + g * factor) <= 1.99526231f) {
 237                         continue;
 238                 }
 239
 240                 // if route gain is already at peak, return 0.0f factor
 241                 if (g >= 1.99526231f) {
 242                         return 0.0f;
 243                 }
 244
 245                 // factor is calculated so that it would raise current route to max
 246                 factor = 1.99526231f / g - 1.0f;
 247         }
 248
 249         return factor;
 250 }
 251
 252 void
 253 GainControlGroup::set_group_value (boost::shared_ptr<AutomationControl> control, double val)
 254 {
 255         Glib::Threads::RWLock::ReaderLock lm (controls_lock);
 256
 257         if (_mode & Relative) {
 258
 259                 gain_t usable_gain = control->get_value();
 260
 261                 if (usable_gain < 0.000001f) {
 262                         usable_gain = 0.000001f;
 263                 }
 264
 265                 gain_t delta = val;
 266                 if (delta < 0.000001f) {
 267                         delta = 0.000001f;
 268                 }
 269
 270                 delta -= usable_gain;
 271
 272                 if (delta == 0.0f) {
 273                         return;
 274                 }
 275
 276                 gain_t factor = delta / usable_gain;
 277
 278                 if (factor > 0.0f) {
 279                         factor = get_max_factor (factor);
 280                         if (factor == 0.0f) {
 281                                 control->Changed (true, Controllable::ForGroup); /* EMIT SIGNAL */
 282                                 return;
 283                         }
 284                 } else {
 285                         factor = get_min_factor (factor);
 286                         if (factor == 0.0f) {
 287                                 control->Changed (true, Controllable::ForGroup); /* EMIT SIGNAL */
 288                                 return;
 289                         }
 290                 }
 291
 292                 /* set the primary control */
 293
 294                 control->set_value (val, Controllable::ForGroup);
 295
 296                 /* now propagate across the group */
 297
 298                 for (ControlMap::iterator c = _controls.begin(); c != _controls.end(); ++c) {
 299                         if (c->second == control) {
 300                                 continue;
 301                         }
 302
 303                         boost::shared_ptr<GainControl> gc = boost::dynamic_pointer_cast<GainControl> (c->second);
 304
 305                         if (gc) {
 306                                 gc->inc_gain (factor);
 307                         }
 308                 }
 309
 310         } else {
 311
 312                 /* just set entire group */
 313
 314                 for (ControlMap::iterator c = _controls.begin(); c != _controls.end(); ++c) {
 315                         c->second->set_value (val, Controllable::ForGroup);
 316                 }
 317         }
 318 }