libs/ardour/ardour/monitor_processor.h

   1 /*
   2     Copyright (C) 2010 Paul Davis
   3
   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.
   8
   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.
  13
  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.
  17
  18 */
  19
  20 #ifndef __ardour_monitor_processor_h__
  21 #define __ardour_monitor_processor_h__
  22
  23 #include <algorithm>
  24 #include <iostream>
  25 #include <vector>
  26
  27 #include "pbd/signals.h"
  28 #include "pbd/compose.h"
  29 #include "pbd/controllable.h"
  30
  31 #include "ardour/libardour_visibility.h"
  32 #include "ardour/types.h"
  33 #include "ardour/processor.h"
  34
  35 #include "ardour/dB.h"
  36
  37 class XMLNode;
  38
  39 namespace ARDOUR {
  40
  41 class Session;
  42
  43 template<typename T>
  44 class /*LIBARDOUR_API*/ MPControl : public PBD::Controllable {
  45 public:
  46         MPControl (T initial, const std::string& name, PBD::Controllable::Flag flag,
  47                    float lower = 0.0f, float upper = 1.0f)
  48                 : PBD::Controllable (name, flag)
  49                 , _value (initial)
  50                 , _lower (lower)
  51                 , _upper (upper)
  52         {}
  53
  54         /* Controllable API */
  55
  56         void set_value (double v) {
  57                 T newval = (T) v;
  58                 if (newval != _value) {
  59                         _value = std::max (_lower, std::min (_upper, newval));
  60                         Changed(); /* EMIT SIGNAL */
  61                 }
  62         }
  63
  64         double get_value () const {
  65                 return (float) _value;
  66         }
  67
  68         double internal_to_user (double i) const { return accurate_coefficient_to_dB (i);}
  69         double user_to_internal (double u) const { return dB_to_coefficient(u) ;}
  70
  71         std::string get_user_string () const
  72         {
  73                 char theBuf[32]; sprintf( theBuf, "%3.1f dB", accurate_coefficient_to_dB (get_value()));
  74                 return std::string(theBuf);
  75         }
  76
  77         double lower () const { return _lower; }
  78         double upper () const { return _upper; }
  79
  80         /* "access as T" API */
  81
  82         MPControl& operator=(const T& v) {
  83                 if (v != _value) {
  84                         _value = std::max (_lower, std::min (_upper, v));
  85                         Changed (); /* EMIT SIGNAL */
  86                 }
  87                 return *this;
  88         }
  89
  90         bool operator==(const T& v) const {
  91                 return _value == v;
  92         }
  93
  94         bool operator<(const T& v) const {
  95                 return _value < v;
  96         }
  97
  98         bool operator<=(const T& v) const {
  99                 return _value <= v;
 100         }
 101
 102         bool operator>(const T& v) const {
 103                 return _value > v;
 104         }
 105
 106         bool operator>=(const T& v) const {
 107                 return _value >= v;
 108         }
 109
 110         operator T() const { return _value; }
 111         T val() const { return _value; }
 112
 113 protected:
 114         T _value;
 115         T _lower;
 116         T _upper;
 117 };
 118
 119 class LIBARDOUR_API MonitorProcessor : public Processor
 120 {
 121 public:
 122         MonitorProcessor (Session&);
 123         ~MonitorProcessor ();
 124
 125         bool display_to_user() const;
 126
 127         void run (BufferSet& /*bufs*/, framepos_t /*start_frame*/, framepos_t /*end_frame*/, pframes_t /*nframes*/, bool /*result_required*/);
 128
 129         XMLNode& state (bool full);
 130         int set_state (const XMLNode&, int /* version */);
 131
 132         bool configure_io (ChanCount in, ChanCount out);
 133         bool can_support_io_configuration (const ChanCount& in, ChanCount& out);
 134
 135         void set_cut_all (bool);
 136         void set_dim_all (bool);
 137         void set_polarity (uint32_t, bool invert);
 138         void set_cut (uint32_t, bool cut);
 139         void set_dim (uint32_t, bool dim);
 140         void set_solo (uint32_t, bool);
 141         void set_mono (bool);
 142
 143         gain_t dim_level() const { return _dim_level; }
 144         gain_t solo_boost_level() const { return _solo_boost_level; }
 145
 146         bool dimmed (uint32_t chn) const;
 147         bool soloed (uint32_t chn) const;
 148         bool inverted (uint32_t chn) const;
 149         bool cut (uint32_t chn) const;
 150         bool cut_all () const;
 151         bool dim_all () const;
 152         bool mono () const;
 153
 154         PBD::Signal0<void> Changed;
 155
 156         boost::shared_ptr<PBD::Controllable> channel_cut_control (uint32_t) const;
 157         boost::shared_ptr<PBD::Controllable> channel_dim_control (uint32_t) const;
 158         boost::shared_ptr<PBD::Controllable> channel_polarity_control (uint32_t) const;
 159         boost::shared_ptr<PBD::Controllable> channel_solo_control (uint32_t) const;
 160
 161         boost::shared_ptr<PBD::Controllable> dim_control () const { return _dim_all_control; }
 162         boost::shared_ptr<PBD::Controllable> cut_control () const { return _cut_all_control; }
 163         boost::shared_ptr<PBD::Controllable> mono_control () const { return _mono_control; }
 164         boost::shared_ptr<PBD::Controllable> dim_level_control () const { return _dim_level_control; }
 165         boost::shared_ptr<PBD::Controllable> solo_boost_control () const { return _solo_boost_level_control; }
 166
 167 private:
 168         struct ChannelRecord {
 169                 gain_t current_gain;
 170
 171                 /* pointers - created first, but managed by boost::shared_ptr<> */
 172
 173                 MPControl<gain_t>* cut_ptr;
 174                 MPControl<bool>*   dim_ptr;
 175                 MPControl<gain_t>* polarity_ptr;
 176                 MPControl<bool>*   soloed_ptr;
 177
 178                 /* shared ptr access and lifetime management, for external users */
 179
 180                 boost::shared_ptr<PBD::Controllable> cut_control;
 181                 boost::shared_ptr<PBD::Controllable> dim_control;
 182                 boost::shared_ptr<PBD::Controllable> polarity_control;
 183                 boost::shared_ptr<PBD::Controllable> soloed_control;
 184
 185                 /* typed controllables for internal use */
 186
 187                 MPControl<gain_t>& cut;
 188                 MPControl<bool>&   dim;
 189                 MPControl<gain_t>& polarity;
 190                 MPControl<bool>&   soloed;
 191
 192                 ChannelRecord (uint32_t);
 193         };
 194
 195         std::vector<ChannelRecord*> _channels;
 196
 197         uint32_t             solo_cnt;
 198
 199         /* pointers - created first, but managed by boost::shared_ptr<> */
 200
 201         MPControl<bool>*            _dim_all_ptr;
 202         MPControl<bool>*            _cut_all_ptr;
 203         MPControl<bool>*            _mono_ptr;
 204         MPControl<volatile gain_t>* _dim_level_ptr;
 205         MPControl<volatile gain_t>* _solo_boost_level_ptr;
 206
 207         /* shared ptr access and lifetime management, for external users */
 208
 209         boost::shared_ptr<PBD::Controllable> _dim_all_control;
 210         boost::shared_ptr<PBD::Controllable> _cut_all_control;
 211         boost::shared_ptr<PBD::Controllable> _mono_control;
 212         boost::shared_ptr<PBD::Controllable> _dim_level_control;
 213         boost::shared_ptr<PBD::Controllable> _solo_boost_level_control;
 214
 215         /* typed controllables for internal use */
 216
 217         MPControl<bool>&            _dim_all;
 218         MPControl<bool>&            _cut_all;
 219         MPControl<bool>&            _mono;
 220         MPControl<volatile gain_t>& _dim_level;
 221         MPControl<volatile gain_t>& _solo_boost_level;
 222
 223         void allocate_channels (uint32_t);
 224 };
 225
 226 } /* namespace */
 227
 228 #endif /* __ardour_monitor_processor_h__ */