gtk2_ardour/port_group.h

   1 /*
   2     Copyright (C) 2002-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
  20 #ifndef  __gtk_ardour_port_group_h__
  21 #define  __gtk_ardour_port_group_h__
  22
  23 #include <vector>
  24 #include <string>
  25 #include <set>
  26 #include <gtkmm/widget.h>
  27 #include <gtkmm/checkbutton.h>
  28 #include <boost/shared_ptr.hpp>
  29 #include "ardour/data_type.h"
  30 #include "ardour/types.h"
  31
  32 namespace ARDOUR {
  33         class Session;
  34         class Bundle;
  35         class Processor;
  36         class IO;
  37 }
  38
  39 class PortMatrix;
  40 class RouteBundle;
  41 class PublicEditor;
  42
  43 /** A list of bundles and ports, grouped by some aspect of their
  44  *  type e.g. busses, tracks, system.  Each group has 0 or more bundles
  45  *  and 0 or more ports, where the ports are not in the bundles.
  46  */
  47 class PortGroup : public sigc::trackable
  48 {
  49 public:
  50         PortGroup (std::string const & n);
  51
  52         void add_bundle (boost::shared_ptr<ARDOUR::Bundle>);
  53         void add_bundle (boost::shared_ptr<ARDOUR::Bundle>, boost::shared_ptr<ARDOUR::IO> io);
  54         void add_bundle (boost::shared_ptr<ARDOUR::Bundle>, boost::shared_ptr<ARDOUR::IO>, Gdk::Color);
  55         void remove_bundle (boost::shared_ptr<ARDOUR::Bundle>);
  56         boost::shared_ptr<ARDOUR::Bundle> only_bundle ();
  57         void clear ();
  58         uint32_t total_channels () const;
  59         boost::shared_ptr<ARDOUR::IO> io_from_bundle (boost::shared_ptr<ARDOUR::Bundle>) const;
  60
  61         std::string name; ///< name for the group
  62
  63         bool visible () const {
  64                 return _visible;
  65         }
  66
  67         void set_visible (bool v) {
  68                 _visible = v;
  69                 Changed ();
  70         }
  71
  72         bool has_port (std::string const &) const;
  73
  74         sigc::signal<void> Changed;
  75         sigc::signal<void, ARDOUR::Bundle::Change> BundleChanged;
  76
  77         struct BundleRecord {
  78                 boost::shared_ptr<ARDOUR::Bundle> bundle;
  79                 boost::shared_ptr<ARDOUR::IO> io;
  80                 Gdk::Color colour;
  81                 bool has_colour;
  82                 sigc::connection changed_connection;
  83         };
  84
  85         typedef std::list<BundleRecord> BundleList;
  86
  87         BundleList const & bundles () const {
  88                 return _bundles;
  89         }
  90
  91 private:
  92         void bundle_changed (ARDOUR::Bundle::Change);
  93         void add_bundle_internal (boost::shared_ptr<ARDOUR::Bundle>, boost::shared_ptr<ARDOUR::IO>, bool, Gdk::Color);
  94
  95         BundleList _bundles;
  96         bool _visible; ///< true if the group is visible in the UI
  97 };
  98
  99 /// A list of PortGroups
 100 class PortGroupList : public sigc::trackable
 101 {
 102   public:
 103         PortGroupList ();
 104
 105         typedef std::vector<boost::shared_ptr<PortGroup> > List;
 106
 107         void add_group (boost::shared_ptr<PortGroup>);
 108         void set_type (ARDOUR::DataType);
 109         void gather (ARDOUR::Session &, bool);
 110         PortGroup::BundleList const & bundles () const;
 111         void clear ();
 112         void remove_bundle (boost::shared_ptr<ARDOUR::Bundle>);
 113         uint32_t total_visible_channels () const;
 114         uint32_t size () const {
 115                 return _groups.size();
 116         }
 117         boost::shared_ptr<ARDOUR::IO> io_from_bundle (boost::shared_ptr<ARDOUR::Bundle>) const;
 118
 119         void suspend_signals ();
 120         void resume_signals ();
 121
 122         List::const_iterator begin () const {
 123                 return _groups.begin();
 124         }
 125
 126         List::const_iterator end () const {
 127                 return _groups.end();
 128         }
 129
 130         sigc::signal<void> Changed;
 131         sigc::signal<void, ARDOUR::Bundle::Change> BundleChanged;
 132
 133   private:
 134         bool port_has_prefix (std::string const &, std::string const &) const;
 135         std::string common_prefix (std::vector<std::string> const &) const;
 136         std::string common_prefix_before (std::vector<std::string> const &, std::string const &) const;
 137         void emit_changed ();
 138         void emit_bundle_changed (ARDOUR::Bundle::Change);
 139         boost::shared_ptr<ARDOUR::Bundle> make_bundle_from_ports (std::vector<std::string> const &, bool) const;
 140         void maybe_add_processor_to_bundle (boost::weak_ptr<ARDOUR::Processor>, boost::shared_ptr<RouteBundle>, bool, std::set<boost::shared_ptr<ARDOUR::IO> > &);
 141
 142         ARDOUR::DataType _type;
 143         mutable PortGroup::BundleList _bundles;
 144         List _groups;
 145         std::vector<sigc::connection> _bundle_changed_connections;
 146         bool _signals_suspended;
 147         bool _pending_change;
 148         ARDOUR::Bundle::Change _pending_bundle_change;
 149 };
 150
 151
 152 class RouteBundle : public ARDOUR::Bundle
 153 {
 154 public:
 155         RouteBundle (boost::shared_ptr<ARDOUR::Bundle>);
 156
 157         void add_processor_bundle (boost::shared_ptr<ARDOUR::Bundle>);
 158
 159 private:
 160         void reread_component_bundles ();
 161
 162         boost::shared_ptr<ARDOUR::Bundle> _route;
 163         std::vector<boost::shared_ptr<ARDOUR::Bundle> > _processor;
 164 };
 165
 166 #endif /* __gtk_ardour_port_group_h__ */