2 Copyright (C) 2016 Paul Davis
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.
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.
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.
20 #ifndef __libardour_stripable_h__
21 #define __libardour_stripable_h__
26 #include <boost/utility.hpp>
27 #include <boost/shared_ptr.hpp>
28 #include <boost/enable_shared_from_this.hpp>
30 #include "pbd/signals.h"
32 #include "ardour/automatable.h"
33 #include "ardour/presentation_info.h"
34 #include "ardour/session_object.h"
35 #include "ardour/libardour_visibility.h"
37 class StripableColorDialog;
41 class AutomationControl;
42 class ReadOnlyControl;
48 class SoloIsolateControl;
49 class SoloSafeControl;
51 class MonitorProcessor;
52 class RecordEnableControl;
53 class RecordSafeControl;
55 /* This is a virtual base class for any object that needs to be potentially
56 * represented by a control-centric user interface using the general model of a
57 * mixing console "strip" - a collection of controls that determine the state
58 * and behaviour of the object.
61 class LIBARDOUR_API Stripable : public SessionObject,
63 public boost::enable_shared_from_this<Stripable>
66 Stripable (Session& session, std::string const & name, PresentationInfo const &);
67 virtual ~Stripable ();
73 bool is_auditioner() const { return _presentation_info.flags() & PresentationInfo::Auditioner; }
74 bool is_private_route() const { return is_auditioner(); }
75 bool is_master() const { return _presentation_info.flags() & PresentationInfo::MasterOut; }
76 bool is_monitor() const { return _presentation_info.flags() & PresentationInfo::MonitorOut; }
78 int set_state (XMLNode const&, int);
80 bool is_hidden() const { return _presentation_info.flags() & PresentationInfo::Hidden; }
81 bool is_selected() const;
83 PresentationInfo const & presentation_info () const { return _presentation_info; }
84 PresentationInfo& presentation_info () { return _presentation_info; }
85 PresentationInfo* presentation_info_ptr () { return &_presentation_info; }
87 /* set just the order */
89 void set_presentation_order (PresentationInfo::order_t);
91 struct LIBARDOUR_API Sorter
93 bool _mixer_order; // master is last
94 Sorter (bool mixer_order = false) : _mixer_order (mixer_order) {}
95 bool operator() (boost::shared_ptr<ARDOUR::Stripable> a, boost::shared_ptr<ARDOUR::Stripable> b);
98 /* gui's call this for their own purposes. */
100 PBD::Signal2<void,std::string,void*> gui_changed;
102 /***************************************************************
103 * Pure interface begins here
104 ***************************************************************/
106 virtual boost::shared_ptr<PeakMeter> peak_meter() = 0;
107 virtual boost::shared_ptr<const PeakMeter> peak_meter() const = 0;
109 virtual boost::shared_ptr<GainControl> gain_control() const = 0;
111 virtual boost::shared_ptr<SoloControl> solo_control() const = 0;
112 virtual boost::shared_ptr<SoloIsolateControl> solo_isolate_control() const = 0;
113 virtual boost::shared_ptr<SoloSafeControl> solo_safe_control() const = 0;
114 virtual boost::shared_ptr<MuteControl> mute_control() const = 0;
116 virtual boost::shared_ptr<PhaseControl> phase_control() const = 0;
117 virtual boost::shared_ptr<GainControl> trim_control() const = 0;
119 virtual boost::shared_ptr<MonitorControl> monitoring_control() const = 0;
121 virtual boost::shared_ptr<AutomationControl> rec_enable_control() const { return boost::shared_ptr<AutomationControl>(); }
122 virtual boost::shared_ptr<AutomationControl> rec_safe_control() const { return boost::shared_ptr<AutomationControl>(); }
124 /* "well-known" controls for panning. Any or all of these may return
127 virtual boost::shared_ptr<AutomationControl> pan_azimuth_control() const = 0;
128 virtual boost::shared_ptr<AutomationControl> pan_elevation_control() const = 0;
129 virtual boost::shared_ptr<AutomationControl> pan_width_control() const = 0;
130 virtual boost::shared_ptr<AutomationControl> pan_frontback_control() const = 0;
131 virtual boost::shared_ptr<AutomationControl> pan_lfe_control() const = 0;
133 /* "well-known" controls for an EQ in this route. Any or all may
134 * be null. eq_band_cnt() must return 0 if there is no EQ present.
135 * Passing an @param band value >= eq_band_cnt() will guarantee the
136 * return of a null ptr (or an empty string for eq_band_name()).
138 virtual uint32_t eq_band_cnt () const = 0;
139 virtual boost::shared_ptr<AutomationControl> eq_enable_controllable () const = 0;
140 virtual std::string eq_band_name (uint32_t) const = 0;
141 virtual boost::shared_ptr<AutomationControl> eq_gain_controllable (uint32_t band) const = 0;
142 virtual boost::shared_ptr<AutomationControl> eq_freq_controllable (uint32_t band) const = 0;
143 virtual boost::shared_ptr<AutomationControl> eq_q_controllable (uint32_t band) const = 0;
144 virtual boost::shared_ptr<AutomationControl> eq_shape_controllable (uint32_t band) const = 0;
146 virtual boost::shared_ptr<AutomationControl> filter_freq_controllable (bool hp /* false for LPF*/) const = 0;
147 virtual boost::shared_ptr<AutomationControl> filter_slope_controllable (bool hp) const = 0;
148 virtual boost::shared_ptr<AutomationControl> filter_enable_controllable (bool hp) const = 0;
150 /* "well-known" controls for a compressor in this route. Any or all may
153 virtual boost::shared_ptr<AutomationControl> comp_enable_controllable () const = 0;
154 virtual boost::shared_ptr<AutomationControl> comp_threshold_controllable () const = 0;
155 virtual boost::shared_ptr<AutomationControl> comp_speed_controllable () const = 0;
156 virtual boost::shared_ptr<AutomationControl> comp_mode_controllable () const = 0;
157 virtual boost::shared_ptr<AutomationControl> comp_makeup_controllable () const = 0;
158 virtual boost::shared_ptr<ReadOnlyControl> comp_redux_controllable () const = 0;
160 /* @param mode must be supplied by the comp_mode_controllable(). All other values
161 * result in undefined behaviour
163 virtual std::string comp_mode_name (uint32_t mode) const = 0;
165 /* @param mode - as for comp mode name. This returns the name for the
166 * parameter/control accessed via comp_speed_controllable(), which can
169 virtual std::string comp_speed_name (uint32_t mode) const = 0;
171 /* "well-known" controls for sends to well-known busses in this route. Any or all may
174 * In Mixbus, these are the sends that connect to the mixbusses.
175 * In Ardour, these are user-created sends that connect to user-created
178 virtual boost::shared_ptr<AutomationControl> send_level_controllable (uint32_t n) const = 0;
179 virtual boost::shared_ptr<AutomationControl> send_enable_controllable (uint32_t n) const = 0;
180 virtual boost::shared_ptr<AutomationControl> send_pan_azi_controllable (uint32_t n) const = 0;
182 /* for the same value of @param n, this returns the name of the send
183 * associated with the pair of controllables returned by the above two methods.
185 virtual std::string send_name (uint32_t n) const = 0;
187 /* well known control that enables/disables sending to the master bus.
189 * In Ardour, this returns null.
190 * In Mixbus, it will return a suitable control, or null depending on
193 virtual boost::shared_ptr<AutomationControl> master_send_enable_controllable () const = 0;
195 virtual bool muted_by_others_soloing () const = 0;
197 virtual boost::shared_ptr<MonitorProcessor> monitor_control() const = 0;
199 StripableColorDialog* active_color_picker() const { return _active_color_picker; }
200 void set_active_color_picker (StripableColorDialog* d) { _active_color_picker = d; }
203 PresentationInfo _presentation_info;
205 StripableColorDialog* _active_color_picker;
210 #endif /* __libardour_stripable_h__ */