universal change in the design of the way Route/Track controls are designed and used...

[ardour.git] / libs / ardour / ardour / route_group.h

diff --git a/libs/ardour/ardour/route_group.h b/libs/ardour/ardour/route_group.h
index 22e527ff9e19feec9c9167e95cc8ae8f15224fa6..feeac6a467cba170104ff4f87888ef191377c6cd 100644 (file)
--- a/libs/ardour/ardour/route_group.h
+++ b/libs/ardour/ardour/route_group.h
@@ -25,28 +25,31 @@
 #include <string>
 #include <stdint.h>
 
+#include "pbd/controllable.h"
 #include "pbd/signals.h"
 #include "pbd/stateful.h"
-#include "pbd/signals.h"
 
+#include "ardour/control_group.h"
 #include "ardour/types.h"
 #include "ardour/session_object.h"
 
+#include "ardour/libardour_visibility.h"
+
 namespace ARDOUR {
 
 namespace Properties {
-       extern PBD::PropertyDescriptor<bool> relative;
-       extern PBD::PropertyDescriptor<bool> active;
-       extern PBD::PropertyDescriptor<bool> gain;
-       extern PBD::PropertyDescriptor<bool> mute;
-       extern PBD::PropertyDescriptor<bool> solo;
-       extern PBD::PropertyDescriptor<bool> recenable;
-       extern PBD::PropertyDescriptor<bool> select;
-       extern PBD::PropertyDescriptor<bool> edit;
-       extern PBD::PropertyDescriptor<bool> route_active;
-       extern PBD::PropertyDescriptor<bool> color;
+       LIBARDOUR_API extern PBD::PropertyDescriptor<bool> relative;
+       LIBARDOUR_API extern PBD::PropertyDescriptor<bool> active;
+       LIBARDOUR_API extern PBD::PropertyDescriptor<bool> gain;
+       LIBARDOUR_API extern PBD::PropertyDescriptor<bool> mute;
+       LIBARDOUR_API extern PBD::PropertyDescriptor<bool> solo;
+       LIBARDOUR_API extern PBD::PropertyDescriptor<bool> recenable;
+       LIBARDOUR_API extern PBD::PropertyDescriptor<bool> select;
+       LIBARDOUR_API extern PBD::PropertyDescriptor<bool> route_active;
+       LIBARDOUR_API extern PBD::PropertyDescriptor<bool> color;
+       LIBARDOUR_API extern PBD::PropertyDescriptor<bool> monitoring;
        /* we use this, but its declared in region.cc */
-       extern PBD::PropertyDescriptor<bool> hidden;
+       LIBARDOUR_API extern PBD::PropertyDescriptor<bool> hidden;
 };
 
 class Route;
@@ -54,7 +57,14 @@ class Track;
 class AudioTrack;
 class Session;
 
-class RouteGroup : public SessionObject
+/** A group identifier for routes.
+ *
+ * RouteGroups permit to define properties which are shared
+ * among all Routes that use the given identifier.
+ *
+ * A route can at most be in one group.
+ */
+class LIBARDOUR_API RouteGroup : public SessionObject
 {
   public:
        static void make_property_quarks();
@@ -70,9 +80,9 @@ class RouteGroup : public SessionObject
        bool is_solo () const { return _solo.val(); }
        bool is_recenable () const { return _recenable.val(); }
        bool is_select () const { return _select.val(); }
-       bool is_edit () const { return _edit.val(); }
        bool is_route_active () const { return _route_active.val(); }
        bool is_color () const { return _color.val(); }
+       bool is_monitoring() const { return _monitoring.val(); }
 
        bool empty() const {return routes->empty();}
        size_t size() const { return routes->size();}
@@ -89,9 +99,9 @@ class RouteGroup : public SessionObject
        void set_solo (bool yn);
        void set_recenable (bool yn);
        void set_select (bool yn);
-       void set_edit (bool yn);
        void set_route_active (bool yn);
        void set_color (bool yn);
+       void set_monitoring (bool yn);
 
        bool enabled_property (PBD::PropertyID);
 
@@ -107,7 +117,7 @@ class RouteGroup : public SessionObject
 
        /* to use these, #include "ardour/route_group_specialized.h" */
 
-       template<class T> void apply (void (Track::*func)(T, void *), T val, void *src);
+       template<class T> void apply (void (Track::*func)(T, PBD::Controllable::GroupControlDisposition), T val, PBD::Controllable::GroupControlDisposition);
 
        /* fills at_set with all members of the group that are AudioTracks */
 
@@ -118,6 +128,7 @@ class RouteGroup : public SessionObject
                changed();
        }
 
+        bool has_subgroup() const;
        void make_subgroup (bool, Placement);
        void destroy_subgroup ();
 
@@ -132,7 +143,7 @@ class RouteGroup : public SessionObject
 
        int set_state (const XMLNode&, int version);
 
-private:
+  private:
        boost::shared_ptr<RouteList> routes;
        boost::shared_ptr<Route> subgroup_bus;
 
@@ -144,12 +155,21 @@ private:
        PBD::Property<bool> _solo;
        PBD::Property<bool> _recenable;
        PBD::Property<bool> _select;
-       PBD::Property<bool> _edit;
        PBD::Property<bool> _route_active;
        PBD::Property<bool> _color;
+       PBD::Property<bool> _monitoring;
+
+       boost::shared_ptr<ControlGroup> _solo_group;
+       boost::shared_ptr<ControlGroup> _mute_group;
+       boost::shared_ptr<ControlGroup> _rec_enable_group;
+       boost::shared_ptr<ControlGroup> _gain_group;
+       boost::shared_ptr<ControlGroup> _monitoring_group;
 
        void remove_when_going_away (boost::weak_ptr<Route>);
        int set_state_2X (const XMLNode&, int);
+
+       void post_set (PBD::PropertyChange const &);
+       void push_to_groups ();
 };
 
 } /* namespace */