2 Copyright (C) 2002-2009 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 __gtk_ardour_port_matrix_h__
21 #define __gtk_ardour_port_matrix_h__
24 #include <gtkmm/box.h>
25 #include <gtkmm/scrollbar.h>
26 #include <gtkmm/table.h>
27 #include <gtkmm/label.h>
28 #include <gtkmm/checkbutton.h>
29 #include <boost/shared_ptr.hpp>
30 #include "ardour/bundle.h"
31 #include "port_group.h"
33 /** The `port matrix' UI. This is a widget which lets the user alter
34 * associations between one set of ports and another. e.g. to connect
37 * It is made up of a body, PortMatrixBody, which is rendered using cairo,
38 * and some scrollbars and other stuff. All of this is arranged inside the
39 * VBox that we inherit from.
48 class PortMatrix : public Gtk::VBox
51 PortMatrix (ARDOUR::Session&, ARDOUR::DataType);
54 void set_type (ARDOUR::DataType);
56 ARDOUR::DataType type () const {
60 void disassociate_all ();
61 void setup_scrollbars ();
62 void popup_channel_context_menu (int, uint32_t, uint32_t);
65 TOP_TO_RIGHT, ///< column labels on top, row labels to the right
66 LEFT_TO_BOTTOM ///< row labels to the left, column labels on the bottom
69 /** @return Arrangement in use */
70 Arrangement arrangement () const {
74 PortGroupList const * columns () const;
76 /** @return index into the _ports array for the list which is displayed as columns */
77 int column_index () const {
81 PortGroupList const * rows () const;
83 /** @return index into the _ports array for the list which is displayed as rows */
84 int row_index () const {
88 PortGroupList const * ports (int d) const {
92 virtual void setup ();
94 /** @param c Channels; where c[0] is from _ports[0] and c[1] is from _ports[1].
97 virtual void set_state (ARDOUR::BundleChannel c[2], bool s) = 0;
100 ASSOCIATED, ///< the ports are associaed
101 NOT_ASSOCIATED, ///< the ports are not associated
102 UNKNOWN ///< we don't know anything about these two ports' relationship
105 /** @param c Channels; where c[0] is from _ports[0] and c[1] is from _ports[1].
108 virtual State get_state (ARDOUR::BundleChannel c[2]) const = 0;
110 virtual void add_channel (boost::shared_ptr<ARDOUR::Bundle>) = 0;
111 virtual bool can_remove_channels (int) const = 0;
112 virtual void remove_channel (ARDOUR::BundleChannel) = 0;
113 virtual bool can_rename_channels (int) const = 0;
114 virtual void rename_channel (ARDOUR::BundleChannel) {}
121 sigc::signal<void, Result> Finished;
125 /** We have two port group lists. One will be presented on the rows of the matrix,
126 the other on the columns. The PortMatrix chooses the arrangement based on which has
127 more ports in it. Subclasses must fill these two lists with the port groups that they
128 wish to present. The PortMatrix will arrange its layout such that signal flow is vaguely
129 from left to right as you go from list 0 to list 1. Hence subclasses which deal with
130 inputs and outputs should put outputs in list 0 and inputs in list 1. */
131 PortGroupList _ports[2];
132 ARDOUR::Session& _session;
136 void hscroll_changed ();
137 void vscroll_changed ();
138 void routes_changed ();
139 void reconnect_to_routes ();
140 void visibility_toggled (boost::weak_ptr<PortGroup>, Gtk::CheckButton *);
141 void select_arrangement ();
142 void remove_channel_proxy (boost::weak_ptr<ARDOUR::Bundle>, uint32_t);
143 void rename_channel_proxy (boost::weak_ptr<ARDOUR::Bundle>, uint32_t);
145 /// port type that we are working with
146 ARDOUR::DataType _type;
147 std::vector<sigc::connection> _route_connections;
149 PortMatrixBody* _body;
150 Gtk::HScrollbar _hscroll;
151 Gtk::VScrollbar _vscroll;
152 Gtk::HBox _main_hbox;
153 Gtk::HBox _column_visibility_box;
154 bool _column_visibility_box_added;
155 Gtk::Label _column_visibility_label;
156 std::vector<Gtk::CheckButton*> _column_visibility_buttons;
157 Gtk::VBox _row_visibility_box;
158 bool _row_visibility_box_added;
159 Gtk::Label _row_visibility_label;
160 std::vector<Gtk::CheckButton*> _row_visibility_buttons;
161 Gtk::Table _scroller_table;
164 Arrangement _arrangement;