X-Git-Url: https://main.carlh.net/gitweb/?a=blobdiff_plain;f=gtk2_ardour%2Fgroup_tabs.h;h=dbe3174f1b2129551299bda49705f9a12a06eb13;hb=e3b0cb086d2cec5f28a24fed16fd62e06080fe1a;hp=0ba4b7bdbb8f4b23ecba3bca83b7f5da30e7541a;hpb=167929c25a4d2f839e078eeaa50ab40b8f544978;p=ardour.git

diff --git a/gtk2_ardour/group_tabs.h b/gtk2_ardour/group_tabs.h
index 0ba4b7bdbb..dbe3174f1b 100644
--- a/gtk2_ardour/group_tabs.h
+++ b/gtk2_ardour/group_tabs.h
@@ -1,5 +1,5 @@
 /*
-    Copyright (C) 2009 Paul Davis 
+    Copyright (C) 2009 Paul Davis
 
     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
@@ -18,6 +18,7 @@
 */
 
 #include <gtkmm/menu.h>
+#include "editor_component.h"
 #include "cairo_widget.h"
 
 namespace ARDOUR {
@@ -27,33 +28,56 @@ namespace ARDOUR {
 
 class Editor;
 
-class GroupTabs : public CairoWidget
+/** Parent class for tabs which represent route groups as coloured tabs;
+ *  Currently used on the left-hand side of the editor and at the top of the mixer.
+ */
+class GroupTabs : public CairoWidget, public EditorComponent
 {
 public:
-	GroupTabs ();
+	GroupTabs (Editor *);
 
 	void set_session (ARDOUR::Session *);
 
 protected:
 
 	struct Tab {
+		Tab () : group (0) {}
+		
 		double from;
 		double to;
-		Gdk::Color colour;
-		ARDOUR::RouteGroup* group;
-		double first_ui_size;
-		double last_ui_size;
+		Gdk::Color colour; ///< colour
+		ARDOUR::RouteGroup* group; ///< route group
 	};
 
-	ARDOUR::Session* _session;
-
 private:
+	/** Compute all the tabs for this widget.
+	 *  @return Tabs.
+	 */
 	virtual std::list<Tab> compute_tabs () const = 0;
-	virtual void draw_tab (cairo_t *, Tab const &) const = 0;
+
+	/** Draw a tab.
+	 *  @param cr Cairo context.
+	 *  @param t Tab.
+	 */
+	virtual void draw_tab (cairo_t* cr, Tab const & t) const = 0;
+
+	/** @param x x coordinate
+	 *  @param y y coordinate
+	 *  @return x or y, depending on which is the primary coordinate for this widget.
+	 */
 	virtual double primary_coordinate (double, double) const = 0;
-	virtual void reflect_tabs (std::list<Tab> const &) = 0;
+
+	virtual ARDOUR::RouteList routes_for_tab (Tab const * t) const = 0;
+
+	/** @return Size of the widget along the primary axis */
 	virtual double extent () const = 0;
-	virtual Gtk::Menu* get_menu (ARDOUR::RouteGroup *) = 0;
+
+	/** @param g Route group, or 0.
+         *  @return Menu to be popped up on right-click over the given route group.
+	 */
+	virtual Gtk::Menu* get_menu (ARDOUR::RouteGroup* g) = 0;
+
+	virtual ARDOUR::RouteGroup* new_route_group () const = 0;
 
 	void render (cairo_t *);
 	void on_size_request (Gtk::Requisition *);
@@ -61,12 +85,16 @@ private:
 	bool on_motion_notify_event (GdkEventMotion *);
 	bool on_button_release_event (GdkEventButton *);
 
-	Tab * click_to_tab (double, Tab**, Tab**);
-
-	std::list<Tab> _tabs;
-	Tab* _dragging;
-	bool _drag_moved;
-	bool _drag_from;
-	double _drag_last;
-	double _drag_limit;
+	Tab * click_to_tab (double, std::list<Tab>::iterator *, std::list<Tab>::iterator *);
+
+	std::list<Tab> _tabs; ///< current list of tabs
+	Tab* _dragging; ///< tab being dragged, or 0
+	bool _dragging_new_tab; ///< true if we're dragging a new tab
+	bool _drag_moved; ///< true if there has been movement during any current drag
+	double _drag_fixed; ///< the position of the fixed end of the tab being dragged
+	double _drag_moving; ///< the position of the moving end of the tab being dragged
+	double _drag_offset; ///< offset from the mouse to the end of the tab being dragged
+	double _drag_min; ///< minimum position for drag
+	double _drag_max; ///< maximum position for drag
+	double _drag_first; ///< first mouse pointer position during drag
 };