port_matrix.h

Go to the documentation of this file.

/*
 * Copyright (C) 2007-2012 Carl Hetherington <carl@carlh.net>
 * Copyright (C) 2008-2012 Paul Davis <paul@linuxaudiosystems.com>
 * Copyright (C) 2009-2011 David Robillard <d@drobilla.net>
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License along
 * with this program; if not, write to the Free Software Foundation, Inc.,
 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
 */
 
#pragma once
 
#include <list>
#include <memory>
 
#include <gtkmm/box.h>
#include <gtkmm/scrollbar.h>
#include <gtkmm/table.h>
#include <gtkmm/label.h>
#include <gtkmm/checkbutton.h>
#include <gtkmm/notebook.h>
 
#include "ardour/bundle.h"
#include "ardour/types.h"
#include "ardour/session_handle.h"
 
#include "port_group.h"
#include "port_matrix_types.h"
 
namespace ARDOUR {
        class Bundle;
}
 
namespace Gtk {
        namespace Menu_Helpers {
                class MenuList;
        }
}
 
class PortMatrixBody;
 
class PortMatrix : public Gtk::Table, public ARDOUR::SessionHandlePtr
{
public:
        PortMatrix (Gtk::Window*, ARDOUR::Session *, ARDOUR::DataType);
        ~PortMatrix ();
 
        void set_type (ARDOUR::DataType);
 
        ARDOUR::DataType type () const {
                return _type;
        }
 
        void disassociate_all ();
        void setup_scrollbars ();
        void popup_menu (ARDOUR::BundleChannel, ARDOUR::BundleChannel, uint32_t);
 
        int min_height_divisor () const {
                return _min_height_divisor;
        }
        void set_min_height_divisor (int f) {
                _min_height_divisor = f;
        }
 
        enum Arrangement {
                TOP_TO_RIGHT,  
                LEFT_TO_BOTTOM 
        };
 
 
        Arrangement arrangement () const {
                return _arrangement;
        }
 
        bool show_only_bundles () const {
                return _show_only_bundles;
        }
 
        PortGroupList const * columns () const;
        std::shared_ptr<const PortGroup> visible_columns () const;
 
        int column_index () const {
                return _column_index;
        }
 
        PortGroupList const * rows () const;
        std::shared_ptr<const PortGroup> visible_rows () const;
 
        int row_index () const {
                return _row_index;
        }
 
        PortGroupList const * ports (int d) const {
                return &_ports[d];
        }
 
        std::shared_ptr<const PortGroup> visible_ports (int d) const;
 
        void init ();
        void setup ();
        virtual void setup_ports (int) = 0;
        void setup_all_ports ();
 
        std::pair<uint32_t, uint32_t> max_size () const;
 
        bool should_show (ARDOUR::DataType) const;
        uint32_t count_of_our_type (ARDOUR::ChanCount) const;
        uint32_t count_of_our_type_min_1 (ARDOUR::ChanCount) const;
 
        PortMatrixNode::State get_association (PortMatrixNode) const;
 
        void flip ();
        bool key_press (GdkEventKey *);
 
        virtual void set_state (ARDOUR::BundleChannel c[2], bool s) = 0;
 
        virtual PortMatrixNode::State get_state (ARDOUR::BundleChannel c[2]) const = 0;
        virtual bool list_is_global (int) const = 0;
 
        virtual bool can_add_channels (std::shared_ptr<ARDOUR::Bundle>) const;
        virtual void add_channel (std::shared_ptr<ARDOUR::Bundle>, ARDOUR::DataType);
        virtual bool can_remove_channels (std::shared_ptr<ARDOUR::Bundle>) const;
        virtual void remove_channel (ARDOUR::BundleChannel);
        virtual void remove_all_channels (std::weak_ptr<ARDOUR::Bundle>);
        virtual bool can_rename_channels (std::shared_ptr<ARDOUR::Bundle>) const {
                return false;
        }
        virtual bool can_add_port (std::shared_ptr<ARDOUR::Bundle>, ARDOUR::DataType t) const;
        virtual void rename_channel (ARDOUR::BundleChannel) {}
        virtual std::string disassociation_verb () const = 0;
        virtual std::string channel_noun () const;
 
        enum Result {
                Cancelled,
                Accepted
        };
 
        sigc::signal<void, Result> Finished;
 
        static bool bundle_with_channels (std::shared_ptr<ARDOUR::Bundle>);
 
protected:
 
        PortGroupList _ports[2];
 
private:
 
        void hscroll_changed ();
        void vscroll_changed ();
        void routes_changed ();
        void reconnect_to_routes ();
        void select_arrangement ();
        bool can_add_port_proxy (std::weak_ptr<ARDOUR::Bundle>, ARDOUR::DataType) const;
        void add_channel_proxy (std::weak_ptr<ARDOUR::Bundle>, ARDOUR::DataType);
        void remove_channel_proxy (std::weak_ptr<ARDOUR::Bundle>, uint32_t);
        void rename_channel_proxy (std::weak_ptr<ARDOUR::Bundle>, uint32_t);
        void disassociate_all_on_channel (std::weak_ptr<ARDOUR::Bundle>, uint32_t, int);
        void disassociate_all_on_bundle (std::weak_ptr<ARDOUR::Bundle>, int);
        void setup_global_ports ();
        void setup_global_ports_proxy ();
        void toggle_show_only_bundles ();
        bool on_scroll_event (GdkEventScroll *);
        std::shared_ptr<ARDOUR::IO> io_from_bundle (std::shared_ptr<ARDOUR::Bundle>) const;
        void setup_notebooks ();
        void remove_notebook_pages (Gtk::Notebook &);
        void notebook_page_selected (GtkNotebookPage *, guint);
        void route_processors_changed (ARDOUR::RouteProcessorChange);
        void body_dimensions_changed ();
        void session_going_away ();
        void add_remove_option (Gtk::Menu_Helpers::MenuList &, std::weak_ptr<ARDOUR::Bundle>, int);
        void add_disassociate_option (Gtk::Menu_Helpers::MenuList &, std::weak_ptr<ARDOUR::Bundle>, int, int);
        void port_connected_or_disconnected ();
        void update_tab_highlighting ();
        std::pair<int, int> check_flip () const;
        bool can_flip () const;
        void parameter_changed (std::string);
 
        Gtk::Window* _parent;
 
        ARDOUR::DataType _type;
        PBD::ScopedConnectionList _route_connections;
        PBD::ScopedConnectionList _changed_connections;
        PBD::ScopedConnectionList _bundle_changed_connections;
 
        PortMatrixBody* _body;
        Gtk::HScrollbar _hscroll;
        Gtk::VScrollbar _vscroll;
        Gtk::Notebook _vnotebook;
        Gtk::Notebook _hnotebook;
        Gtk::Label _vlabel;
        Gtk::Label _hlabel;
        Gtk::VBox _vbox;
        Gtk::HBox _hbox;
        Gtk::Label _hspacer;
        Gtk::Label _vspacer;
        Gtk::Menu* _menu;
        Arrangement _arrangement;
        int _row_index;
        int _column_index;
        int _min_height_divisor;
        bool _show_only_bundles;
        bool _inhibit_toggle_show_only_bundles;
        bool _ignore_notebook_page_selected;
};