libs/ardour/ardour/automation_control.h

   1 /*
   2     Copyright (C) 2007 Paul Davis
   3     Author: David Robillard
   4
   5     This program is free software; you can redistribute it and/or modify
   6     it under the terms of the GNU General Public License as published by
   7     the Free Software Foundation; either version 2 of the License, or
   8     (at your option) any later version.
   9
  10     This program is distributed in the hope that it will be useful,
  11     but WITHOUT ANY WARRANTY; without even the implied warranty of
  12     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13     GNU General Public License for more details.
  14
  15     You should have received a copy of the GNU General Public License
  16     along with this program; if not, write to the Free Software
  17     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  18
  19 */
  20
  21 #ifndef __ardour_automation_control_h__
  22 #define __ardour_automation_control_h__
  23
  24 #include <map>
  25
  26 #include <glibmm/threads.h>
  27
  28 #include <boost/shared_ptr.hpp>
  29 #include <boost/enable_shared_from_this.hpp>
  30
  31 #include "pbd/controllable.h"
  32
  33 #include "evoral/types.hpp"
  34 #include "evoral/Control.hpp"
  35
  36 #include "ardour/libardour_visibility.h"
  37 #include "ardour/automation_list.h"
  38 #include "ardour/parameter_descriptor.h"
  39
  40 namespace ARDOUR {
  41
  42 class Session;
  43 class Automatable;
  44
  45
  46 /** A PBD::Controllable with associated automation data (AutomationList)
  47  */
  48 class LIBARDOUR_API AutomationControl
  49         : public PBD::Controllable
  50         , public Evoral::Control
  51         , public boost::enable_shared_from_this<AutomationControl>
  52 {
  53 public:
  54         AutomationControl(ARDOUR::Session&,
  55                           const Evoral::Parameter&                  parameter,
  56                           const ParameterDescriptor&                desc,
  57                           boost::shared_ptr<ARDOUR::AutomationList> l=boost::shared_ptr<ARDOUR::AutomationList>(),
  58                           const std::string&                        name="");
  59
  60         ~AutomationControl ();
  61
  62         boost::shared_ptr<AutomationList> alist() const {
  63                 return boost::dynamic_pointer_cast<AutomationList>(_list);
  64         }
  65
  66         void set_list (boost::shared_ptr<Evoral::ControlList>);
  67
  68         inline bool automation_playback() const {
  69                 return alist() ? alist()->automation_playback() : false;
  70         }
  71
  72         inline bool automation_write() const {
  73                 return alist() ? alist()->automation_write() : false;
  74         }
  75
  76         inline AutoState automation_state() const {
  77                 return alist() ? alist()->automation_state() : Off;
  78         }
  79
  80         inline AutoStyle automation_style() const {
  81                 return alist() ? alist()->automation_style() : Absolute;
  82         }
  83
  84         void set_automation_state(AutoState as);
  85         void set_automation_style(AutoStyle as);
  86         void start_touch(double when);
  87         void stop_touch(bool mark, double when);
  88
  89         /* inherited from PBD::Controllable.
  90          * Derived classes MUST call ::writable() to verify
  91          * that writing to the parameter is legal at that time.
  92          */
  93         double get_value () const;
  94         /* inherited from PBD::Controllable.
  95          * Derived classes MUST call ::writable() to verify
  96          * that writing to the parameter is legal at that time.
  97          */
  98         void set_value (double value, PBD::Controllable::GroupControlDisposition group_override);
  99         /* automation related value setting */
 100         virtual bool writable () const;
 101         /* Call to ::set_value() with no test for writable() because
 102          * this is only used by automation playback. We would like
 103          * to make it pure virtual
 104          */
 105         virtual void set_value_unchecked (double val) {}
 106
 107         double lower()   const { return _desc.lower; }
 108         double upper()   const { return _desc.upper; }
 109         double normal()  const { return _desc.normal; }
 110         bool   toggled() const { return _desc.toggled; }
 111
 112         double internal_to_interface (double i) const;
 113         double interface_to_internal (double i) const;
 114
 115         const ParameterDescriptor& desc() const { return _desc; }
 116
 117         const ARDOUR::Session& session() const { return _session; }
 118         void commit_transaction (bool did_write);
 119
 120         void add_master (boost::shared_ptr<AutomationControl>);
 121         void remove_master (boost::shared_ptr<AutomationControl>);
 122         void clear_masters ();
 123         bool slaved_to (boost::shared_ptr<AutomationControl>) const;
 124         bool slaved () const;
 125         std::vector<PBD::ID> masters () const;
 126
 127         PBD::Signal0<void> MasterStatusChange;
 128
 129   protected:
 130         ARDOUR::Session& _session;
 131
 132         const ParameterDescriptor _desc;
 133
 134
 135         class MasterRecord {
 136           public:
 137                 MasterRecord (boost::shared_ptr<AutomationControl> gc, double r)
 138                         : _master (gc)
 139                         , _ratio (r)
 140                 {}
 141
 142                 boost::shared_ptr<AutomationControl> master() const { return _master; }
 143                 double ratio () const { return _ratio; }
 144                 void reset_ratio (double r) { _ratio = r; }
 145
 146                 PBD::ScopedConnection connection;
 147
 148          private:
 149                 boost::shared_ptr<AutomationControl> _master;
 150                 double _ratio;
 151
 152         };
 153
 154         mutable Glib::Threads::RWLock master_lock;
 155         typedef std::map<PBD::ID,MasterRecord> Masters;
 156         Masters _masters;
 157         PBD::ScopedConnectionList masters_connections;
 158
 159         virtual void master_changed (bool from_self, GroupControlDisposition gcd);
 160         void master_going_away (boost::weak_ptr<AutomationControl>);
 161         virtual void recompute_masters_ratios (double val) { /* do nothing by default */}
 162         virtual double get_masters_value_locked () const;
 163         double get_value_locked() const;
 164 };
 165
 166
 167 } // namespace ARDOUR
 168
 169 #endif /* __ardour_automation_control_h__ */