libs/ardour/ardour/controllable_descriptor.h

   1 /*
   2     Copyright (C) 2009 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 #ifndef __libardour_controllable_descriptor_h__
  20 #define __libardour_controllable_descriptor_h__
  21
  22 #include <vector>
  23 #include <string>
  24 #include <stdint.h>
  25
  26 #include "ardour/libardour_visibility.h"
  27
  28 namespace ARDOUR {
  29
  30 class LIBARDOUR_API ControllableDescriptor {
  31 public:
  32     enum TopLevelType {
  33             PresentationOrderRoute,
  34             PresentationOrderTrack,
  35             PresentationOrderBus,
  36             PresentationOrderVCA,
  37             NamedRoute,
  38             SelectionCount,
  39     };
  40
  41     enum SubType {
  42             Gain,
  43             Trim,
  44             Solo,
  45             Mute,
  46             Recenable,
  47             PanDirection,
  48             PanWidth,
  49             PanElevation,
  50             Balance,
  51             SendGain,
  52             PluginParameter
  53     };
  54
  55     ControllableDescriptor ()
  56             : _top_level_type (PresentationOrderRoute)
  57             , _subtype (Gain)
  58             , _banked (false)
  59             , _bank_offset (0)
  60     {}
  61
  62     int set (const std::string&);
  63
  64     /* it is only valid to call top_level_name() if top_level_type() returns
  65        NamedRoute
  66     */
  67
  68     TopLevelType top_level_type() const { return _top_level_type; }
  69     const std::string& top_level_name() const { return _top_level_name; }
  70
  71     SubType subtype() const { return _subtype; }
  72
  73     uint32_t presentation_order() const;
  74     uint32_t selection_id() const;
  75     uint32_t target (uint32_t n) const;
  76     bool banked() const { return _banked; }
  77
  78     void set_bank_offset (uint32_t o) { _bank_offset = o; }
  79
  80 private:
  81     TopLevelType          _top_level_type;
  82     SubType               _subtype;
  83     std::string           _top_level_name;
  84     union {
  85             uint32_t  _presentation_order;
  86             uint32_t  _selection_id;
  87     };
  88     std::vector<uint32_t> _target;
  89     uint32_t              _banked;
  90     uint32_t              _bank_offset;
  91 };
  92
  93 }
  94
  95 #endif /* __libardour_controllable_descriptor_h__ */