ardour/gtk2_ardour/editor.h

/*
    Copyright (C) 2000-2003 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
    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., 675 Mass Ave, Cambridge, MA 02139, USA.

    $Id$
*/

#ifndef __ardour_editor_h__
#define __ardour_editor_h__

#include <list>
#include <map>
#include <set>
#include <string>
#include <sys/time.h>

#include <cmath>

#include <sndfile.h>

#include <gtkmm.h>
#include <gtkmm/layout.h>
#include <gtkmm/comboboxtext.h>
#include <libgnomecanvas/libgnomecanvas.h>
#include <libgnomecanvas/gnome-canvas-util.h>
#include <gtkmm2ext/selector.h>
#include <gtkmm2ext/click_box.h>

#include <ardour/stateful.h>
#include <ardour/session.h>
#include <ardour/tempo.h>
#include <ardour/location.h>
#include <ardour/region.h>

#include "keyboard_target.h"
#include "audio_clock.h"
#include "gtk-custom-ruler.h"
#include "ardour_dialog.h"
#include "public_editor.h"
#include "editing.h"
#include "enums.h"
#include "region_selection.h"

namespace Gtkmm2ext {
	class TearOff;
}

namespace LinuxAudioSystems {
	class AudioEngine;
}

namespace ARDOUR {
	class DiskStream;
	class RouteGroup;
	class Source;
	class Playlist;
	class Region;
	class Location;
	class TempoSection;
	class NamedSelection;
	class Session;
	class AudioFilter;
	class Crossfade;
}

namespace LADSPA {
	class Plugin;
}

class TimeAxisView;
class AudioTimeAxisView;
class AutomationTimeAxisView;
class AudioRegionView;
class CrossfadeView;
class PluginSelector;
class PlaylistSelector;
class Marker;
class GroupedButtons;
class AutomationLine;
class UIExportSpecification;
class ExportDialog;
class Selection;
class TimeSelection;
class TrackSelection;
class AutomationSelection;
class MixerStrip;
class StreamView;
class ControlPoint;

/* <CMT Additions> */
class ImageFrameView;
class ImageFrameTimeAxisView;
class ImageFrameTimeAxis;
class MarkerTimeAxis ;
class MarkerView ;
class ImageFrameSocketHandler ;
class TimeAxisViewItem ;
/* </CMT Additions> */


class Editor : public PublicEditor
{
  public:
	Editor (ARDOUR::AudioEngine&);
	~Editor ();

	void             connect_to_session (ARDOUR::Session *);
	ARDOUR::Session* current_session() const { return session; }

	jack_nframes_t leftmost_position() const { return leftmost_frame; }
	jack_nframes_t current_page_frames() const {
		return (jack_nframes_t) floor (canvas_width * frames_per_unit);
	}

	void set_snap_to (Editing::SnapType);
	void set_snap_mode (Editing::SnapMode);
	void set_snap_threshold (double pixel_distance) {snap_threshold = pixel_distance;}

	void undo (uint32_t n = 1);
	void redo (uint32_t n = 1);

	XMLNode& get_state ();
	int set_state (const XMLNode& );

	void set_mouse_mode (Editing::MouseMode, bool force=true);
	void step_mouse_mode (bool next);
	Editing::MouseMode current_mouse_mode () { return mouse_mode; }

	void add_imageframe_time_axis(std::string track_name, void*) ;
	void add_imageframe_marker_time_axis(std::string track_name, TimeAxisView* marked_track, void*) ;
	void connect_to_image_compositor() ;
	void scroll_timeaxis_to_imageframe_item(const TimeAxisViewItem* item) ;
	TimeAxisView* get_named_time_axis(std::string name) ;
	/* </CMT Additions> */

	void consider_auditioning (ARDOUR::Region&);
	void hide_a_region (ARDOUR::Region&);
	void remove_a_region (ARDOUR::Region&);

	/* option editor-access */

	void set_show_waveforms (bool yn);
	bool show_waveforms() const { return _show_waveforms; }

	void set_show_waveforms_recording (bool yn);
	bool show_waveforms_recording() const { return _show_waveforms_recording; }
	
	/* things that need to be public to be used in the main menubar */

	void new_region_from_selection ();
	void separate_region_from_selection ();
	void toggle_playback (bool with_abort);

	/* undo related */

	void set_edit_menu (Gtk::Menu&);

	jack_nframes_t unit_to_frame (double unit) {
		return (jack_nframes_t) rint (unit * frames_per_unit);
	}
	
	double frame_to_unit (jack_nframes_t frame) {
		return rint ((double) frame / (double) frames_per_unit);
	}

	double frame_to_unit (double frame) {
		return rint (frame / frames_per_unit);
	}

	/* NOTE: these functions assume that the "pixel" coordinate is
	   the result of using the world->canvas affine transform on a
	   world coordinate. These coordinates already take into
	   account any scrolling carried out by adjusting the
	   xscroll_adjustment.  
	*/

	jack_nframes_t pixel_to_frame (double pixel) {
		
		/* pixel can be less than zero when motion events
		   are processed. since we've already run the world->canvas
		   affine, that means that the location *really* is "off
		   to the right" and thus really is "before the start".
		*/

		if (pixel >= 0) {
			return (jack_nframes_t) rint (pixel * frames_per_unit * GNOME_CANVAS(track_gnome_canvas.gobj())->pixels_per_unit);
		} else {
			return 0;
		}
	}

	gulong frame_to_pixel (jack_nframes_t frame) {
		return (gulong) rint ((frame / (frames_per_unit *  GNOME_CANVAS(track_gnome_canvas.gobj())->pixels_per_unit)));
	}

	/* selection */

	Selection& get_selection() const { return *selection; }
	Selection& get_cut_buffer() const { return *cut_buffer; }

	void play_selection ();
	void select_all_in_track (bool add);
	void select_all (bool add);
	void invert_selection_in_track ();
	void invert_selection ();

	/* tempo */

	void set_show_measures (bool yn);
	bool show_measures () const { return _show_measures; }

	/* export */

	/* these initiate export ... */
	
	void export_session();
	void export_selection();

	/* this is what actually does it */
	
	void export_audiofile (ARDOUR::AudioExportSpecification&);

	/* */

	void add_toplevel_controls (Gtk::Container&);

	void      set_zoom_focus (Editing::ZoomFocus);
	Editing::ZoomFocus get_zoom_focus () const { return zoom_focus; }
	gdouble   get_current_zoom () { return frames_per_unit; }

	void temporal_zoom_step (bool coarser);

	/* stuff that AudioTimeAxisView and related classes use */

	PlaylistSelector& playlist_selector() const;
	void route_name_changed (TimeAxisView *);
	gdouble        frames_per_unit;
	jack_nframes_t leftmost_frame;
	void clear_playlist (ARDOUR::Playlist&);

	TrackViewList* get_valid_views (TimeAxisView*, ARDOUR::RouteGroup* grp = 0);

	Width editor_mixer_strip_width;
	void show_editor_mixer (bool yn);
	void set_selected_mixer_strip (TimeAxisView&);
	void unselect_strip_in_display (TimeAxisView& tv);
	void select_strip_in_display (TimeAxisView& tv);

	/* nudge is initiated by transport controls owned by ARDOUR_UI */

	void nudge_forward (bool next);
	void nudge_backward (bool next);

	/* nudge initiated from context menu */

	void nudge_forward_capture_offset ();
	void nudge_backward_capture_offset ();

	/* playhead/screen stuff */
	
	void set_follow_playhead (bool yn);
	void toggle_follow_playhead ();
	bool follow_playhead() const { return _follow_playhead; }

	/* xfades */

	void toggle_xfades_active();
	void toggle_xfade_visibility ();
	void set_xfade_visibility (bool yn);
	bool xfade_visibility() const { return _xfade_visibility; }

	/* redirect shared ops menu. caller must free returned menu */

	Gtk::Menu* redirect_menu ();

	/* floating windows/transient */

	void ensure_float (Gtk::Window&);

	void show_window ();
	
	void scroll_tracks_down_line ();
	void scroll_tracks_up_line ();

	bool new_regionviews_display_gain () { return _new_regionviews_show_envelope; }
	void prepare_for_cleanup ();

	void reposition_x_origin (jack_nframes_t sample);

  protected:
	void map_transport_state ();
	void map_position_change (jack_nframes_t);

	void on_realize();
	void on_map ();

  private:
	
	ARDOUR::Session     *session;
	ARDOUR::AudioEngine& engine;
	bool                 constructed;

	PlaylistSelector* _playlist_selector;

	enum ItemType {
		RegionItem,
		StreamItem,
		PlayheadCursorItem,
		EditCursorItem,
		MarkerItem,
		MarkerBarItem,
		RangeMarkerBarItem,
		TransportMarkerBarItem,
		SelectionItem,
		GainControlPointItem,
		GainLineItem,
		GainAutomationControlPointItem,
		GainAutomationLineItem,
		PanAutomationControlPointItem,
		PanAutomationLineItem,
		RedirectAutomationControlPointItem,
		RedirectAutomationLineItem,
		MeterMarkerItem,
		TempoMarkerItem,
		MeterBarItem,
		TempoBarItem,
		AudioRegionViewNameHighlight,
		AudioRegionViewName,
		StartSelectionTrimItem,
		EndSelectionTrimItem,
		AutomationTrackItem,
		FadeInItem,
		FadeInHandleItem,
		FadeOutItem,
		FadeOutHandleItem,

		/* <CMT Additions> */
		MarkerViewItem,
		MarkerTimeAxisItem,
		MarkerViewHandleStartItem,
		MarkerViewHandleEndItem,
		ImageFrameItem,
		ImageFrameTimeAxisItem,
		ImageFrameHandleStartItem,
		ImageFrameHandleEndItem,
		/* </CMT Additions> */

		CrossfadeViewItem,
		
		/* don't remove this */

		NoItem
	};

	void          set_frames_per_unit (double);
	void          frames_per_unit_modified ();

	Editing::MouseMode mouse_mode;
	void      mouse_insert (GdkEventButton *);

	void pane_allocation_handler (GtkAllocation*, Gtk::Paned*);

	Gtk::HPaned   canvas_region_list_pane;
	Gtk::HPaned   track_list_canvas_pane;

	Gtk::EventBox meter_base;
	Gtk::HBox     meter_box;
	Gtk::EventBox marker_base;
	Gtk::HBox     marker_box;
	Gtk::VBox     scrollers_rulers_markers_box;

	void location_changed (ARDOUR::Location *);
	void location_flags_changed (ARDOUR::Location *, void *);
	void refresh_location_display ();
	void refresh_location_display_s (ARDOUR::Change);
	void refresh_location_display_internal (ARDOUR::Locations::LocationList&);
	void add_new_location (ARDOUR::Location *);
	void location_gone (ARDOUR::Location *);
	void remove_marker (Gnome::Canvas::Polygon&, GdkEvent*);
	gint really_remove_marker (ARDOUR::Location* loc);

	uint32_t location_marker_color;
	uint32_t location_range_color;
	uint32_t location_loop_color;
	uint32_t location_punch_color;
	uint32_t location_cd_marker_color;

	struct LocationMarkers {
	    Marker* start;
	    Marker* end;

	    ~LocationMarkers ();

	    void hide();
	    void show ();
	    void set_name (const string&);
	    void set_position (jack_nframes_t start, jack_nframes_t end = 0);
	    void set_color_rgba (uint32_t);
	};

	LocationMarkers  *find_location_markers (ARDOUR::Location *);
	ARDOUR::Location* find_location_from_marker (Marker *, bool& is_start);

	typedef std::map<ARDOUR::Location*,LocationMarkers *> LocationMarkerMap;
	LocationMarkerMap location_markers;

	void hide_marker (GnomeCanvasItem*, GdkEvent*);
	void clear_marker_display ();
	void mouse_add_new_marker (jack_nframes_t where);

	TimeAxisView*      clicked_trackview;
	AudioTimeAxisView* clicked_audio_trackview;
	AudioRegionView*   clicked_regionview;
	AudioRegionView*   latest_regionview;
	uint32_t           clicked_selection;
	CrossfadeView*     clicked_crossfadeview;
	ControlPoint*      clicked_control_point;

	void catch_vanishing_audio_regionview (AudioRegionView *);
	void set_selected_control_point_from_click (bool add = false, bool with_undo = true, bool no_remove=false);
	void set_selected_track_from_click (bool add = false, bool with_undo = true, bool no_remove=false);
	void set_selected_regionview_from_click (bool add = false, bool no_track_remove=false);
	void set_selected_regionview_from_region_list (ARDOUR::Region& region, bool add = false);
	gint set_selected_regionview_from_map_event (GdkEventAny*, StreamView*, ARDOUR::Region*);
	void collect_new_region_view (AudioRegionView *);

	Gtk::Menu track_context_menu;
	Gtk::Menu track_region_context_menu;
	Gtk::Menu track_selection_context_menu;
	Gtk::Menu track_crossfade_context_menu;

	Gtk::MenuItem* region_edit_menu_split_item;
	Gtk::MenuItem* region_edit_menu_split_multichannel_item;
	Gtk::Menu * track_region_edit_playlist_menu;
	Gtk::Menu * track_edit_playlist_submenu;
	Gtk::Menu * track_selection_edit_playlist_submenu;
	
	void popup_track_context_menu (int, int, ItemType, bool, jack_nframes_t);
	Gtk::Menu* build_track_context_menu (jack_nframes_t);
	Gtk::Menu* build_track_bus_context_menu (jack_nframes_t);
	Gtk::Menu* build_track_region_context_menu (jack_nframes_t frame);
	Gtk::Menu* build_track_crossfade_context_menu (jack_nframes_t);
	Gtk::Menu* build_track_selection_context_menu (jack_nframes_t);
	void add_dstream_context_items (Gtk::Menu_Helpers::MenuList&);
	void add_bus_context_items (Gtk::Menu_Helpers::MenuList&);
	void add_region_context_items (StreamView*, ARDOUR::Region*, Gtk::Menu_Helpers::MenuList&);
	void add_crossfade_context_items (StreamView*, ARDOUR::Crossfade*, Gtk::Menu_Helpers::MenuList&, bool many);
	void add_selection_context_items (Gtk::Menu_Helpers::MenuList&);

	void handle_new_route (ARDOUR::Route&);
	void handle_new_route_p (ARDOUR::Route*);
	void remove_route (TimeAxisView *);
	bool route_removal;

	Gtk::HBox           global_hpacker;
	Gtk::VBox           global_vpacker;
	Gtk::VBox           vpacker;

	GdkCursor          *current_canvas_cursor;

	Gnome::CanvasAA track_canvas;
	Gnome::CanvasAA time_canvas;

	Gnome::Canvas::Text* first_action_message;
	Gnome::Canvas::Text* verbose_canvas_cursor;
	bool                 verbose_cursor_visible;

	void session_control_changed (ARDOUR::Session::ControlType);
	void queue_session_control_changed (ARDOUR::Session::ControlType);

	
	gint track_canvas_motion (GdkEvent*);
	void set_verbose_canvas_cursor (string, double x, double y);
	void set_verbose_canvas_cursor_text (string);
	void show_verbose_canvas_cursor();
	void hide_verbose_canvas_cursor();

	bool verbose_cursor_on; // so far unused

	void flush_track_canvas ();
	void flush_time_canvas ();

	Gtk::EventBox      time_canvas_event_box;
	Gtk::EventBox      track_canvas_event_box;
	Gtk::EventBox      time_button_event_box;

	Gnome::Canvas::Group      *minsec_group;
	Gnome::Canvas::Group      *bbt_group;
	Gnome::Canvas::Group      *smpte_group;
	Gnome::Canvas::Group      *frame_group;
	Gnome::Canvas::Group      *tempo_group;
	Gnome::Canvas::Group      *meter_group;
	Gnome::Canvas::Group      *marker_group;
	Gnome::Canvas::Group      *range_marker_group;
	Gnome::Canvas::Group      *transport_marker_group;
	
	enum {
		ruler_metric_smpte = 0,
		ruler_metric_bbt = 1,
		ruler_metric_frames = 2,
		ruler_metric_minsec = 3,

		ruler_time_tempo = 4,
		ruler_time_meter = 5,
		ruler_time_marker = 6,
		ruler_time_range_marker = 7,
		ruler_time_transport_marker = 8,
	};

	static GtkCustomMetric ruler_metrics[4];
	bool                   ruler_shown[9];
	bool                   no_ruler_shown_update;
	
	gint ruler_button_press (GdkEventButton*);
	gint ruler_button_release (GdkEventButton*);
	gint ruler_mouse_motion (GdkEventMotion*);

	gint ruler_pressed_button;
	Gtk::Widget * ruler_grabbed_widget;
	
	void initialize_rulers ();
	void update_just_smpte ();
	void update_fixed_rulers ();
	void update_tempo_based_rulers (); 
	void popup_ruler_menu (jack_nframes_t where = 0, ItemType type = RegionItem);
	void update_ruler_visibility ();
	void ruler_toggled (int);
	gint ruler_label_button_release (GdkEventButton*);
	void store_ruler_visibility ();
	void restore_ruler_visibility ();
	
	static gint _metric_get_smpte (GtkCustomRulerMark **, gulong, gulong, gint);
	static gint _metric_get_bbt (GtkCustomRulerMark **, gulong, gulong, gint);
	static gint _metric_get_frames (GtkCustomRulerMark **, gulong, gulong, gint);
	static gint _metric_get_minsec (GtkCustomRulerMark **, gulong, gulong, gint);
	
	gint metric_get_smpte (GtkCustomRulerMark **, gulong, gulong, gint);
	gint metric_get_bbt (GtkCustomRulerMark **, gulong, gulong, gint);
	gint metric_get_frames (GtkCustomRulerMark **, gulong, gulong, gint);
	gint metric_get_minsec (GtkCustomRulerMark **, gulong, gulong, gint);

	GtkWidget          *_smpte_ruler;
	GtkWidget          *_bbt_ruler;
	GtkWidget          *_frames_ruler;
	GtkWidget          *_minsec_ruler;
	Gtk::Widget        *smpte_ruler;
	Gtk::Widget        *bbt_ruler;
	Gtk::Widget        *frames_ruler;
	Gtk::Widget        *minsec_ruler;
	static Editor      *ruler_editor;

	static const double timebar_height;
	guint32 visible_timebars;
	Gtk::Menu          *editor_ruler_menu;
	
	Gnome::Canvas::SimpleRect* tempo_bar;
	Gnome::Canvas::SimpleRect* meter_bar;
	Gnome::Canvas::SimpleRect* marker_bar;
	Gnome::Canvas::SimpleRect* range_marker_bar;
	Gnome::Canvas::SimpleRect* transport_marker_bar;

	
	Gnome::Canvas::Line* tempo_line;
	Gnome::Canvas::Line* meter_line;
	Gnome::Canvas::Line* marker_line;
	Gnome::Canvas::Line* range_marker_line;
	Gnome::Canvas::Line* transport_marker_line;

	Gnome::Canvas::Points* tempo_line_points;
	Gnome::Canvas::Points* meter_line_points;
	Gnome::Canvas::Points* marker_line_points;
	Gnome::Canvas::Points* range_marker_line_points;
	Gnome::Canvas::Points* transport_marker_line_points;

	Gtk::Label  minsec_label;
	Gtk::Label  bbt_label;
	Gtk::Label  smpte_label;
	Gtk::Label  frame_label;
	Gtk::Label  tempo_label;
	Gtk::Label  meter_label;
	Gtk::Label  mark_label;
	Gtk::Label  range_mark_label;
	Gtk::Label  transport_mark_label;
	

	Gtk::VBox          time_button_vbox;
	Gtk::HBox          time_button_hbox;

	struct Cursor {
	    Editor&             editor;
	    Gnome::Canvas::Points* points;
	    Gnome::Canvas::Item*   canvas_item;
	    jack_nframes_t      current_frame;
	    GtkSignalFunc       callback;
		double				length;

	    Cursor (Editor&, const string& color, GtkSignalFunc callback);
	    ~Cursor ();

	    void set_position (jack_nframes_t);
	    void set_length (double units);
		void set_y_axis (double position);
	};

	friend struct Cursor; /* it needs access to several private
				 fields. XXX fix me.
			      */

	Cursor* playhead_cursor;
	Cursor* edit_cursor;
	Gnome::Canvas::Group* cursor_group;

	void    cursor_to_next_region_point (Cursor*, ARDOUR::RegionPoint);
	void    cursor_to_previous_region_point (Cursor*, ARDOUR::RegionPoint);
	void    cursor_to_region_point (Cursor*, ARDOUR::RegionPoint, int32_t dir);
	void    cursor_to_selection_start (Cursor *);
	void    cursor_to_selection_end   (Cursor *);

	ARDOUR::Region* find_next_region (jack_nframes_t, ARDOUR::RegionPoint, int32_t dir, TrackViewList&, TimeAxisView ** = 0);

	vector<jack_nframes_t> region_boundary_cache;
	void build_region_boundary_cache ();

	Gtk::VBox           trackview_vpacker;

	Gtk::HBox           top_hbox;
	Gtk::HBox           bottom_hbox;
	
	Gtk::Table          edit_packer;
	Gtk::Frame          edit_frame;
	Gtk::VScrollbar     edit_vscrollbar;

	/* the horizontal scroller works in a rather different way
	   than a regular scrollbar, since its used for
	   zoom control/indication as well. But more importantly,
	   its different components (slider, left arrow, right arrow) 
	   have to be packed separately into the edit_packer.
	*/

	Gtk::HScrollbar     edit_hscrollbar;
	Gtk::DrawingArea    edit_hscroll_slider;
	Gtk::Arrow          edit_hscroll_left_arrow;
	Gtk::Arrow          edit_hscroll_right_arrow;
	Gtk::EventBox       edit_hscroll_left_arrow_event;
	Gtk::EventBox       edit_hscroll_right_arrow_event;
	gint                edit_hscroll_slider_width;
	gint                edit_hscroll_slider_height;
	static const gint   edit_hscroll_edge_width = 3;
	bool                edit_hscroll_dragging;
	double              edit_hscroll_drag_last;
	
	void hscroll_slider_allocate (GtkAllocation *);
	gint hscroll_slider_expose (GdkEventExpose*);
	gint hscroll_slider_button_press (GdkEventButton*);
	gint hscroll_slider_button_release (GdkEventButton*);
	gint hscroll_slider_motion (GdkEventMotion*);

	gint hscroll_trough_expose (GdkEventExpose*);
	gint hscroll_trough_button_press (GdkEventButton*);
	gint hscroll_trough_button_release (GdkEventButton*);

	void update_hscroller ();

	gint hscroll_left_arrow_button_press (GdkEventButton *);
	gint hscroll_left_arrow_button_release (GdkEventButton *);
	gint hscroll_right_arrow_button_press (GdkEventButton *);
	gint hscroll_right_arrow_button_release (GdkEventButton *);
	
	guint32             canvas_width;
	guint32             canvas_height;

	Gtk::ScrolledWindow  track_canvas_scroller;
	Gtk::ScrolledWindow  time_canvas_scroller;
	Gtk::ScrolledWindow  edit_controls_scroller;

	gint edit_controls_button_release (GdkEventButton*);
	Gtk::Menu *edit_controls_left_menu;
	Gtk::Menu *edit_controls_right_menu;

	void track_canvas_scroller_realized ();
	void time_canvas_scroller_realized ();

	Gtk::VBox           track_canvas_vbox;
	Gtk::VBox           time_canvas_vbox;
	Gtk::VBox           edit_controls_vbox;
	Gtk::HBox           edit_controls_hbox;

	void tie_vertical_scrolling ();
	void canvas_horizontally_scrolled ();
	void reposition_and_zoom (jack_nframes_t sample, double fpu);
	gint deferred_reposition_and_zoom (jack_nframes_t sample, double fpu);
	void end_location_changed (ARDOUR::Location*);
	bool repos_zoom_queued;
	bool no_zoom_repos_update;
	bool no_tempo_map_update;

	struct RegionListDisplayModelColumns : public Gtk::TreeModel::ColumnRecord {
	    RegionListDisplayModelColumns() {
		    add (name);
		    add (region);
	    }
	    Gtk::TreeModelColumn<Glib::ustring> name;
	    Gtk::TreeModelColumn<ARDOUR::Region*> region;
	};
	    
	RegionListDisplayModelColumns    region_list_columns;
	Gtk::TreeView                    region_list_display;
	Glib::RefPtr<Gtk::TreeStore>     region_list_model;
	Glib::RefPtr<Gtk::TreeModelSort> region_list_sort_model;
	Glib::RefPtr<Gtk::Action>        toggle_full_region_list_action;

	void region_list_selection_changed ();

	Gtk::Menu          *region_list_menu;
	Gtk::ScrolledWindow region_list_scroller;
	Gtk::Frame          region_list_frame;

	bool region_list_display_key_press (GdkEventKey *);
	bool region_list_display_key_release (GdkEventKey *);
	bool region_list_display_button_press (GdkEventButton *);
	bool region_list_display_button_release (GdkEventButton *);
	bool region_list_display_enter_notify (GdkEventCrossing *);
	bool region_list_display_leave_notify (GdkEventCrossing *);
	void region_list_clear ();
	void region_list_selection_mapover (sigc::slot<void,ARDOUR::Region&>);
	void build_region_list_menu ();

	Gtk::CheckMenuItem* toggle_auto_regions_item;
	Gtk::CheckMenuItem* toggle_full_region_list_item;

	Gtk::MenuItem* import_audio_item;
	Gtk::MenuItem* embed_audio_item;

	bool show_automatic_regions_in_region_list;
	Editing::RegionListSortType region_list_sort_type;

	void reset_region_list_sort_direction (bool);
	void reset_region_list_sort_type (Editing::RegionListSortType);

	void toggle_full_region_list ();
	void toggle_show_auto_regions ();

	int region_list_sorter (Gtk::TreeModel::iterator, Gtk::TreeModel::iterator);

	/* named selections */

	Gtk::VPaned         region_selection_vpane;
	Gtk::TreeView          named_selection_display;
	Gtk::ScrolledWindow named_selection_scroller;

	void name_selection();
	void named_selection_name_chosen ();
	void create_named_selection (string);
	void paste_named_selection (float times);

	void handle_new_named_selection ();
	void add_named_selection_to_named_selection_display (ARDOUR::NamedSelection&);
	void redisplay_named_selections ();

	gint named_selection_display_button_press (GdkEventButton *ev);
	void named_selection_display_selected (gint row, gint col, GdkEvent *ev);
	void named_selection_display_unselected (gint row, gint col, GdkEvent *ev);

	/* track views */
	int track_spacing;
	TrackViewList  track_views;
	TimeAxisView     *trackview_by_y_position (double ypos);

	static GdkCursor* cross_hair_cursor;
	static GdkCursor* trimmer_cursor;
	static GdkCursor* selector_cursor;
	static GdkCursor* grabber_cursor;
	static GdkCursor* zoom_cursor;
	static GdkCursor* time_fx_cursor;
	static GdkCursor* fader_cursor;
	static GdkCursor* speaker_cursor;
	static GdkCursor* null_cursor;
	static GdkCursor* wait_cursor;
	static GdkCursor* timebar_cursor;

	static void build_cursors ();

	sigc::connection scroll_connection;
	jack_nframes_t last_update_frame;
	void center_screen (jack_nframes_t);
	void center_screen_internal (jack_nframes_t, float);
	
	void update_current_screen ();
	sigc::connection slower_update_connection;
	void update_slower ();
	
	gint show_track_context_menu (GdkEventButton *);
	void hide_track_context_menu ();

	void session_going_away ();

	jack_nframes_t cut_buffer_start;
	jack_nframes_t cut_buffer_length;

	gint typed_event (GnomeCanvasItem*, GdkEvent*, ItemType);
	gint button_press_handler (GnomeCanvasItem*, GdkEvent*, ItemType);
	gint button_release_handler (GnomeCanvasItem*, GdkEvent*, ItemType);
	gint motion_handler (GnomeCanvasItem*, GdkEvent*, ItemType);
	gint enter_handler (GnomeCanvasItem*, GdkEvent*, ItemType);
	gint leave_handler (GnomeCanvasItem*, GdkEvent*, ItemType);
	
	/* KEYMAP HANDLING */

	void register_actions ();
	void install_keybindings ();

	int ensure_cursor (jack_nframes_t* pos);

	void fake_handle_new_audio_region (ARDOUR::AudioRegion *);
	void handle_new_audio_region (ARDOUR::AudioRegion *);
	void fake_handle_audio_region_removed (ARDOUR::AudioRegion *);
	void handle_audio_region_removed (ARDOUR::AudioRegion *);
	void add_audio_region_to_region_display (ARDOUR::AudioRegion *);
	void region_hidden (ARDOUR::Region*);
	void redisplay_regions ();
	void insert_into_tmp_audio_regionlist(ARDOUR::AudioRegion *);

	list<ARDOUR::AudioRegion *> tmp_audio_region_list;

	void cut_copy (Editing::CutCopyOp);
	void cut_copy_points (Editing::CutCopyOp);
	void cut_copy_regions (Editing::CutCopyOp);
	void cut_copy_ranges (Editing::CutCopyOp);

	void mouse_paste ();
	void paste_internal (jack_nframes_t position, float times);

	/* EDITING OPERATIONS */
	
	void toggle_region_mute ();
	void toggle_region_opaque ();
	void raise_region ();
	void raise_region_to_top ();
	void lower_region ();
	void lower_region_to_bottom ();
	void split_region ();
	void split_region_at (jack_nframes_t);
	void split_regions_at (jack_nframes_t, AudioRegionSelection&);
	void crop_region_to_selection ();
	void set_region_sync_from_edit_cursor ();
	void remove_region_sync();
	void align_selection (ARDOUR::RegionPoint, jack_nframes_t position);
	void align_selection_relative (ARDOUR::RegionPoint point, jack_nframes_t position);
	void align_region (ARDOUR::Region&, ARDOUR::RegionPoint point, jack_nframes_t position);
	void align_region_internal (ARDOUR::Region&, ARDOUR::RegionPoint point, jack_nframes_t position);
	void remove_some_regions ();
	void remove_clicked_region ();
	void destroy_clicked_region ();
	void edit_region ();
	void duplicate_some_regions (AudioRegionSelection&, float times);
	void duplicate_selection (float times);
	void region_fill_selection ();

	void region_fill_track ();
	void audition_playlist_region_standalone (ARDOUR::AudioRegion&);
	void audition_playlist_region_via_route (ARDOUR::AudioRegion&, ARDOUR::Route&);
	void split_multichannel_region();
	void reverse_region ();
	void normalize_region ();
	void denormalize_region ();

	void audition_region_from_region_list ();
	void hide_region_from_region_list ();
	void remove_region_from_region_list ();

	void align (ARDOUR::RegionPoint);
	void align_relative (ARDOUR::RegionPoint);
	void naturalize ();

	void cut ();
	void copy ();
	void paste (float times);

	int  get_prefix (float&, bool&);

	void keyboard_paste ();
	void keyboard_duplicate_region ();
	void keyboard_duplicate_selection ();
	void keyboard_nudge ();
	void keyboard_insert_region_list_selection ();

	void region_from_selection ();
	void create_region_from_selection (std::vector<ARDOUR::AudioRegion*>&);

	bool region_renamed;
	void rename_region ();
	void rename_region_finished (bool);

	void play_from_start ();
	void play_from_edit_cursor ();
	void play_selected_region ();
	void audition_selected_region ();
	void toggle_loop_playback ();
	void loop_selected_region ();
	void play_location (ARDOUR::Location&);
	void loop_location (ARDOUR::Location&);

	Editing::ZoomFocus zoom_focus;

	void temporal_zoom_selection ();
	void temporal_zoom_session ();
	void temporal_zoom (gdouble scale);
	void temporal_zoom_by_frame (jack_nframes_t start, jack_nframes_t end, string op);
	void temporal_zoom_to_frame (bool coarser, jack_nframes_t frame);

	void amplitude_zoom (gdouble scale);
	void amplitude_zoom_step (bool in);

	void insert_region_list_drag (ARDOUR::AudioRegion&);
	void insert_region_list_selection (float times);

	void insert_sndfile (bool as_tracks);
	void embed_audio ();    // inserts into region list
	int  reject_because_rate_differs (string path, SF_INFO& finfo, string action, bool multiple_pending);

	void do_embed_sndfiles (vector<string> paths, bool split);
	void embed_sndfile (string path, bool split, bool multiple_files, bool& check_sr);

	void do_insert_sndfile (vector<string> path, bool multi, jack_nframes_t frame);
	void insert_paths_as_new_tracks (std::vector<std::string> paths, bool multi); // inserts files as new tracks
	void insert_sndfile_into (string path, bool multi, AudioTimeAxisView* tv, jack_nframes_t& frame, bool prompt=true);
	static void* _insert_sndfile_thread (void*);
	void*  insert_sndfile_thread (void*);

	/* generic interthread progress window */
	
	ArdourDialog* interthread_progress_window;
	Gtk::Label interthread_progress_label;
	Gtk::VBox interthread_progress_vbox;
	Gtk::ProgressBar interthread_progress_bar;
	Gtk::Button interthread_cancel_button;
	Gtk::Label interthread_cancel_label;
	sigc::connection  interthread_progress_connection;
	void interthread_cancel_clicked ();
	void build_interthread_progress_window ();
	ARDOUR::InterThreadInfo* current_interthread_info;

	/* import specific info */

	ARDOUR::Session::import_status import_status;
	gint import_progress_timeout (void *);
	static void *_import_thread (void *);
	void* import_thread ();
	void catch_new_audio_region (ARDOUR::AudioRegion*);
	ARDOUR::AudioRegion* last_audio_region;

	/* to support this ... */

	void import_audio (bool as_tracks);
	void do_import (vector<string> paths, bool split, bool as_tracks);

	void move_to_start ();
	void move_to_end ();
	void goto_frame ();
	void center_playhead ();
	void center_edit_cursor ();
	void edit_cursor_backward ();
	void edit_cursor_forward ();
	void playhead_backward ();
	void playhead_forward ();
	void scroll_backward (float pages=0.8f);
	void scroll_forward (float pages=0.8f);
	void scroll_tracks_down ();
	void scroll_tracks_up ();
	void delete_sample_forward ();
	void delete_sample_backward ();
	void delete_screen ();
	void search_backwards ();
	void search_forwards ();
	void set_mark ();
	void clear_markers ();
	void clear_ranges ();
	void clear_locations ();
	void jump_forward_to_mark ();
	void jump_backward_to_mark ();
	void cursor_align (bool playhead_to_edit);

	void remove_last_capture ();

	void set_selection_from_range (ARDOUR::Location&);
	void set_selection_from_punch ();
	void set_selection_from_loop ();

	void add_location_from_selection ();
	void set_route_loop_selection ();

	void add_location_from_playhead_cursor ();

	void reverse_selection ();
	void edit_envelope ();

	void start_scrolling ();
	void stop_scrolling ();

	void keyboard_selection_begin ();
	void keyboard_selection_finish (bool add);
	bool have_pending_keyboard_selection;
	jack_nframes_t pending_keyboard_selection_start;

	ARDOUR::AudioRegion* select_region_for_operation (int dir, TimeAxisView **tv);
	void extend_selection_to_end_of_region (bool next);
	void extend_selection_to_start_of_region (bool previous);

	Editing::SnapType snap_type;
	Editing::SnapMode snap_mode;
	double snap_threshold;

	void soundfile_chosen_for_insert (string selection, bool split_channels);
	void soundfile_chosen_for_embed (string selection, bool split_channels);
	void soundfile_chosen_for_import (string selection, bool split_channels);

	void handle_gui_changes (string, void *);

	void    hide_all_tracks (bool with_select);

	void route_list_selected (gint row, gint col, GdkEvent* ev);
	void route_list_unselected (gint row, gint col, GdkEvent* ev);
	void redisplay_route_list();
	gint route_list_reordered ();
	bool ignore_route_list_reorder;
	void queue_route_list_reordered (gint row, gint col);

	struct DragInfo {
	    GnomeCanvasItem* item;
	    void* data;
 	    jack_nframes_t last_frame_position;
	    int32_t pointer_frame_offset;
	    jack_nframes_t grab_frame;
	    jack_nframes_t last_pointer_frame;
	    jack_nframes_t current_pointer_frame;
	    double grab_x, grab_y;
	    double cumulative_x_drag;
	    double cumulative_y_drag;
	    double current_pointer_x;
	    double current_pointer_y;
	    void (Editor::*motion_callback)(GnomeCanvasItem*, GdkEvent*);
	    void (Editor::*finished_callback)(GnomeCanvasItem*, GdkEvent*);
	    TimeAxisView* last_trackview;
	    bool x_constrained;
	    bool copy;
	    bool was_rolling;
	    bool first_move;
	    bool move_threshold_passsed;
	    bool want_move_threshold;
	    bool brushing;
	    ARDOUR::Location* copied_location;
	} drag_info;

	struct LineDragInfo {
	    uint32_t before;
	    uint32_t after;
	};

	LineDragInfo current_line_drag_info;

	void start_grab (GdkEvent*, GdkCursor* cursor = 0);
	bool end_grab (GnomeCanvasItem*, GdkEvent*);

	Gtk::Menu fade_context_menu;
	void popup_fade_context_menu (int, int, GnomeCanvasItem*, ItemType);

	void start_fade_in_grab (GnomeCanvasItem*, GdkEvent*);
	void start_fade_out_grab (GnomeCanvasItem*, GdkEvent*);
	void fade_in_drag_motion_callback (GnomeCanvasItem*, GdkEvent*);
	void fade_out_drag_motion_callback (GnomeCanvasItem*, GdkEvent*);
	void fade_in_drag_finished_callback (GnomeCanvasItem*, GdkEvent*);
	void fade_out_drag_finished_callback (GnomeCanvasItem*, GdkEvent*);
	
	std::set<ARDOUR::Playlist*> motion_frozen_playlists;
	void region_drag_motion_callback (GnomeCanvasItem*, GdkEvent*);
	void region_drag_finished_callback (GnomeCanvasItem*, GdkEvent*);
	void region_copy_drag_finished_callback (GnomeCanvasItem*, GdkEvent*);

	void cursor_drag_motion_callback (GnomeCanvasItem*, GdkEvent*);
	void cursor_drag_finished_callback (GnomeCanvasItem*, GdkEvent*);
	void marker_drag_motion_callback (GnomeCanvasItem*, GdkEvent*);
	void marker_drag_finished_callback (GnomeCanvasItem*, GdkEvent*);
	void control_point_drag_motion_callback (GnomeCanvasItem*, GdkEvent*);
	void control_point_drag_finished_callback (GnomeCanvasItem*, GdkEvent*);
	void line_drag_motion_callback (GnomeCanvasItem*, GdkEvent*);
	void line_drag_finished_callback (GnomeCanvasItem*, GdkEvent*);

	void tempo_marker_drag_motion_callback (GnomeCanvasItem*, GdkEvent*);
	void tempo_marker_drag_finished_callback (GnomeCanvasItem*, GdkEvent*);
	void meter_marker_drag_motion_callback (GnomeCanvasItem*, GdkEvent*);
	void meter_marker_drag_finished_callback (GnomeCanvasItem*, GdkEvent*);

	gint mouse_rename_region (GnomeCanvasItem*, GdkEvent*);

	void start_region_grab (GnomeCanvasItem*, GdkEvent*);
	void start_region_copy_grab (GnomeCanvasItem*, GdkEvent*);
	void start_region_brush_grab (GnomeCanvasItem*, GdkEvent*);
	void start_selection_grab (GnomeCanvasItem*, GdkEvent*);
	void start_cursor_grab (GnomeCanvasItem*, GdkEvent*);
	void start_marker_grab (GnomeCanvasItem*, GdkEvent*);
	void start_control_point_grab (GnomeCanvasItem*, GdkEvent*);
	void start_line_grab_from_regionview (GnomeCanvasItem*, GdkEvent*);
	void start_line_grab_from_line (GnomeCanvasItem*, GdkEvent*);
	void start_line_grab (AutomationLine *, GdkEvent*);
	void start_tempo_marker_grab (GnomeCanvasItem*, GdkEvent*);
	void start_meter_marker_grab (GnomeCanvasItem*, GdkEvent*);

	void region_view_item_click (AudioRegionView&, GdkEventButton*);

	void remove_gain_control_point (GnomeCanvasItem*, GdkEvent*);
	void remove_control_point (GnomeCanvasItem*, GdkEvent*);

	void mouse_brush_insert_region (AudioRegionView*, jack_nframes_t pos);
	void brush (jack_nframes_t);

	void show_verbose_time_cursor (jack_nframes_t frame, double offset = 0, double xpos=-1, double ypos=-1);
	void show_verbose_duration_cursor (jack_nframes_t start, jack_nframes_t end, double offset = 0, double xpos=-1, double ypos=-1);

	/* Canvas event handlers */

	gint canvas_crossfade_view_event (GdkEvent* event);
	gint canvas_fade_in_event (GdkEvent* event);
	gint canvas_fade_in_handle_event (GdkEvent* event);
	gint canvas_fade_out_event (GdkEvent* event);
	gint canvas_fade_out_handle_event (GdkEvent* event);
	gint canvas_region_view_event (GdkEvent* event);
	gint canvas_region_view_name_highlight_event (GdkEvent* event);
	gint canvas_region_view_name_event (GdkEvent* event);
	gint canvas_stream_view_event (GdkEvent* event);
	gint canvas_marker_event (GdkEvent* event);
	gint canvas_zoom_rect_event (GdkEvent* event);
	gint canvas_selection_rect_event (GdkEvent* event);
	gint canvas_selection_start_trim_event (GdkEvent* event);
	gint canvas_selection_end_trim_event (GdkEvent* event);
	gint canvas_control_point_event (GdkEvent* event);
	gint canvas_line_event (GdkEvent* event);
	gint canvas_tempo_marker_event (GdkEvent* event);
	gint canvas_meter_marker_event (GdkEvent* event);
	gint canvas_tempo_bar_event (GdkEvent* event);
	gint canvas_meter_bar_event (GdkEvent* event);
	gint canvas_marker_bar_event (GdkEvent* event);
	gint canvas_range_marker_bar_event (GdkEvent* event);
	gint canvas_transport_marker_bar_event (GdkEvent* event);
	gint canvas_imageframe_item_view_event(GdkEvent* event) ;
	gint canvas_imageframe_view_event(GdkEvent* event) ;
	gint canvas_imageframe_start_handle_event(GdkEvent* event) ;
	gint canvas_imageframe_end_handle_event(GdkEvent* event) ;
	gint canvas_marker_time_axis_view_event(GdkEvent* event) ;
	gint canvas_markerview_item_view_event(GdkEvent* event) ;
	gint canvas_markerview_start_handle_event(GdkEvent* event) ;
	gint canvas_markerview_end_handle_event(GdkEvent* event) ;
	gint canvas_automation_track_event(GdkEvent* event) ;

#if 0
	gint canvas_crossfade_view_event (GnomeCanvasItem* item, GdkEvent* event, CrossfadeView*);
	gint canvas_fade_in_event (GnomeCanvasItem* item, GdkEvent* event, AudioRegionView*);
	gint canvas_fade_in_handle_event (GnomeCanvasItem* item, GdkEvent* event, AudioRegionView*);
	gint canvas_fade_out_event (GnomeCanvasItem* item, GdkEvent* event, AudioRegionView*);
	gint canvas_fade_out_handle_event (GnomeCanvasItem* item, GdkEvent* event, AudioRegionView*);
	gint canvas_region_view_event (GnomeCanvasItem* item, GdkEvent* event, AudioRegionView*);
	gint canvas_stream_view_event (GnomeCanvasItem* item, GdkEvent* event, AudioTimeAxisView*);
	gint canvas_automation_track_event (GnomeCanvasItem* item, GdkEvent* event, AutomationTimeAxisView*);
	gint canvas_marker_event (GnomeCanvasItem* item, GdkEvent* event);
	gint canvas_zoom_rect_event (GnomeCanvasItem* item, GdkEvent* event);
	gint canvas_selection_rect_event (GnomeCanvasItem* item, GdkEvent* event);
	gint canvas_selection_start_trim_event (GnomeCanvasItem* item, GdkEvent* event);
	gint canvas_selection_end_trim_event (GnomeCanvasItem* item, GdkEvent* event);
	gint canvas_control_point_event (GnomeCanvasItem* item, GdkEvent* event);
	gint canvas_line_event (GnomeCanvasItem* item, GdkEvent* event);
	gint canvas_tempo_marker_event (GnomeCanvasItem* item, GdkEvent* event);
	gint canvas_meter_marker_event (GnomeCanvasItem* item, GdkEvent* event);
	gint canvas_tempo_bar_event (GnomeCanvasItem* item, GdkEvent* event);
	gint canvas_meter_bar_event (GnomeCanvasItem* item, GdkEvent* event);
	gint canvas_marker_bar_event (GnomeCanvasItem* item, GdkEvent* event);
	gint canvas_range_marker_bar_event (GnomeCanvasItem* item, GdkEvent* event);
	gint canvas_transport_marker_bar_event (GnomeCanvasItem* item, GdkEvent* event);
	gint canvas_region_view_name_highlight_event (GnomeCanvasItem* item, GdkEvent* event);
	gint canvas_region_view_name_event (GnomeCanvasItem* item, GdkEvent* event);
#endif	

	gint canvas_copy_region_event (GdkEvent* event);
	gint canvas_playhead_cursor_event (GdkEvent* event);
	gint canvas_edit_cursor_event (GdkEvent* event);
	gint track_canvas_event (GdkEvent* event);

	gint track_canvas_button_press_event (GdkEventButton *);
	gint track_canvas_button_release_event (GdkEventButton *);
	
	void track_canvas_allocate (GtkAllocation* alloc);
	void time_canvas_allocate (GtkAllocation* alloc);

	void set_edit_cursor (GdkEvent* event);
	void set_playhead_cursor (GdkEvent* event);

	void kbd_driver (sigc::slot<void,GdkEvent*>, bool use_track_canvas = true, bool use_time_canvas = true, bool can_select = true);
	void kbd_set_playhead_cursor ();
	void kbd_set_edit_cursor ();
	void kbd_split ();
	void kbd_align (ARDOUR::RegionPoint);
	void kbd_align_relative (ARDOUR::RegionPoint);
	void kbd_brush ();
	void kbd_audition ();

	void kbd_do_split (GdkEvent*);
	void kbd_do_align (GdkEvent*, ARDOUR::RegionPoint);
	void kbd_do_align_relative (GdkEvent*, ARDOUR::RegionPoint);
	void kbd_do_brush (GdkEvent*);
	void kbd_do_audition (GdkEvent*);

	void fake_handle_new_duration ();
	void handle_new_duration ();
	void initialize_canvas ();
	void reset_scrolling_region (GtkAllocation* alloc = 0);
	void scroll_canvas ();

        /* sub-event loop handling */

        int32_t sub_event_loop_status;
        void run_sub_event_loop ();
        void finish_sub_event_loop (int status);
        gint finish_sub_event_loop_on_delete (GdkEventAny*, int32_t status);
	
	/* display control */
	
	bool _show_measures;
	bool _show_waveforms;
	bool _follow_playhead;
	bool _show_waveforms_recording;
	
	void add_bbt_marks (ARDOUR::TempoMap::BBTPointList&);

	ARDOUR::TempoMap::BBTPointList *current_bbt_points;
	
	typedef vector<GnomeCanvasItem*> TimeLineList;
	TimeLineList free_measure_lines;
	TimeLineList used_measure_lines;

	GnomeCanvasItem* time_line_group;
	GnomeCanvasItem* get_time_line ();
	void hide_measures ();
	void draw_measures ();
	void draw_time_bars ();

	void new_tempo_section ();

	void mouse_add_new_tempo_event (jack_nframes_t where);
	void mouse_add_new_meter_event (jack_nframes_t where);

	void remove_tempo_marker (GnomeCanvasItem*);
	void remove_meter_marker (GnomeCanvasItem*);
	gint real_remove_tempo_marker (ARDOUR::TempoSection*);
	gint real_remove_meter_marker (ARDOUR::MeterSection*);
	
	void edit_tempo_section (ARDOUR::TempoSection*);
	void edit_meter_section (ARDOUR::MeterSection*);
	void edit_tempo_marker (GnomeCanvasItem*);
	void edit_meter_marker (GnomeCanvasItem*);
	
	void marker_menu_edit ();
	void marker_menu_remove ();
	void marker_menu_rename ();
	void marker_menu_hide ();
	void marker_menu_loop_range ();
	void marker_menu_play_from ();
	void marker_menu_set_playhead ();
	void marker_menu_set_from_playhead ();
	void marker_menu_set_from_selection ();
	void new_transport_marker_menu_set_loop ();
	void new_transport_marker_menu_set_punch ();
	void update_loop_range_view (bool visibility=false);
	void update_punch_range_view (bool visibility=false);
        gint new_transport_marker_menu_popdown (GdkEventAny*);
	void marker_context_menu (GdkEventButton*, GnomeCanvasItem*);
	void tm_marker_context_menu (GdkEventButton*, GnomeCanvasItem*);
	void transport_marker_context_menu (GdkEventButton*, GnomeCanvasItem*);
	void new_transport_marker_context_menu (GdkEventButton*, GnomeCanvasItem*);
	void build_marker_menu ();
	void build_tm_marker_menu ();
	void build_transport_marker_menu ();
	void build_new_transport_marker_menu ();

	Gtk::Menu* tm_marker_menu;
	Gtk::Menu* marker_menu;
	Gtk::Menu* transport_marker_menu;
	Gtk::Menu* new_transport_marker_menu;
	GnomeCanvasItem* marker_menu_item;

	typedef list<Marker*> Marks;
	Marks metric_marks;

	void remove_metric_marks ();
	void draw_metric_marks (const ARDOUR::Metrics& metrics);

	void tempo_map_changed (ARDOUR::Change);
	void redisplay_tempo ();
	
	void snap_to (jack_nframes_t& first, int32_t direction = 0, bool for_mark = false);
	uint32_t bbt_beat_subdivision;

	/* toolbar */
	
	Gtk::ToggleButton        editor_mixer_button;

	void editor_mixer_button_toggled ();

	AudioClock               selection_start_clock;
	Gtk::Label               selection_start_clock_label;
	AudioClock               selection_end_clock;
	Gtk::Label               selection_end_clock_label;
	AudioClock               edit_cursor_clock;
	Gtk::Label               edit_cursor_clock_label;
	AudioClock               zoom_range_clock;
	Gtk::Button              zoom_in_button;
	Gtk::Button              zoom_out_button;
	Gtk::Button              zoom_out_full_button;
	Gtk::Button              zoom_onetoone_button;

	Gtk::VBox                toolbar_clock_vbox;
	Gtk::VBox                toolbar_selection_clock_vbox; 
	Gtk::Table               toolbar_selection_clock_table;
	Gtk::Label               toolbar_selection_cursor_label;
	
	Gtk::Table               mouse_mode_button_table;
	Gtkmm2ext::TearOff*       mouse_mode_tearoff;
	Gtk::ToggleButton        mouse_select_button;
	Gtk::ToggleButton        mouse_move_button;
	Gtk::ToggleButton        mouse_gain_button;
	Gtk::ToggleButton        mouse_zoom_button;
	Gtk::ToggleButton        mouse_timefx_button;
	Gtk::ToggleButton        mouse_audition_button;
	GroupedButtons          *mouse_mode_button_set;
	void                     mouse_mode_toggled (Editing::MouseMode m);
	bool                     ignore_mouse_mode_toggle;

	gint                     mouse_select_button_release (GdkEventButton*);

	Gtk::VBox                automation_box;
	Gtk::Button              automation_mode_button;
	Gtk::ToggleButton        global_automation_button;

	Gtk::ComboBoxText edit_mode_selector;
	Gtk::Label               edit_mode_label;
	Gtk::VBox                edit_mode_box;

	gint edit_mode_selection_done (GdkEventAny*);

	Gtk::ComboBoxText snap_type_selector;
	Gtk::Label               snap_type_label;
	Gtk::VBox                snap_type_box;

	gint snap_type_selection_done (GdkEventAny*);

	Gtk::ComboBoxText               snap_mode_selector;
	Gtk::Label               snap_mode_label;
	Gtk::VBox                snap_mode_box;

	gint snap_mode_selection_done (GdkEventAny*);

	Gtk::ComboBoxText zoom_focus_selector;
	Gtk::Label               zoom_focus_label;
	Gtk::VBox                zoom_focus_box;
	
	gint zoom_focus_selection_done (GdkEventAny*);

	Gtk::Label          zoom_indicator_label;
	Gtk::HBox           zoom_indicator_box;
	Gtk::VBox           zoom_indicator_vbox;

	void                update_zoom_indicator ();
	void                zoom_adjustment_changed();

	void                edit_cursor_clock_changed();
	
	void setup_toolbar ();

	Gtkmm2ext::TearOff*       tools_tearoff;
	Gtk::HBox                toolbar_hbox;
	Gtk::EventBox            toolbar_base;
	Gtk::Frame               toolbar_frame;

	/* selection process */

	Selection* selection;
	Selection* cut_buffer;

	void time_selection_changed ();
	void track_selection_changed ();
	void region_selection_changed ();
	void point_selection_changed ();
	void audio_track_selection_changed ();
	void line_selection_changed ();

	enum SelectionOp {
		CreateSelection,
		SelectionStartTrim,
		SelectionEndTrim,
		SelectionMove
	} selection_op;

	void start_selection_op (GnomeCanvasItem* item, GdkEvent* event, SelectionOp);
	void drag_selection (GnomeCanvasItem* item, GdkEvent* event);
	void end_selection_op (GnomeCanvasItem* item, GdkEvent* event);
	void cancel_selection ();

	void region_selection_op (void (ARDOUR::Region::*pmf)(void));
	void region_selection_op (void (ARDOUR::Region::*pmf)(void*), void*);
	void region_selection_op (void (ARDOUR::Region::*pmf)(bool), bool);

	bool audio_region_selection_covers (jack_nframes_t where);

	Gtk::VPaned  route_group_vpane;
	Gtk::Frame   route_list_frame;
	Gtk::Frame   edit_group_list_frame;

	/* transport range select process */
	enum RangeMarkerOp {
		CreateRangeMarker,
		CreateTransportMarker
	} range_marker_op;

	void start_range_markerbar_op (GnomeCanvasItem* item, GdkEvent* event, RangeMarkerOp);
	void drag_range_markerbar_op (GnomeCanvasItem* item, GdkEvent* event);
	void end_range_markerbar_op (GnomeCanvasItem* item, GdkEvent* event);

	
	GnomeCanvasItem      *range_bar_drag_rect;
	GnomeCanvasItem      *transport_bar_drag_rect;
	GnomeCanvasItem      *marker_drag_line;
	GnomeCanvasPoints    *marker_drag_line_points;
	GnomeCanvasItem      *range_marker_drag_rect;

	void update_marker_drag_item (ARDOUR::Location *);
	
	GnomeCanvasItem      *transport_bar_range_rect;
	GnomeCanvasItem      *transport_bar_preroll_rect;
	GnomeCanvasItem      *transport_bar_postroll_rect;
	GnomeCanvasItem      *transport_loop_range_rect;
	GnomeCanvasItem      *transport_punch_range_rect;
	GnomeCanvasItem      *transport_punchin_line;
	GnomeCanvasItem      *transport_punchout_line;
	GnomeCanvasItem      *transport_preroll_rect;
	GnomeCanvasItem      *transport_postroll_rect;

	ARDOUR::Location*  transport_loop_location();
	ARDOUR::Location*  transport_punch_location();

	ARDOUR::Location   *temp_location;
	
	/* object rubberband select process */
	
	void start_rubberband_select (GnomeCanvasItem* item, GdkEvent* event);
	void drag_rubberband_select (GnomeCanvasItem* item, GdkEvent* event);
	void end_rubberband_select (GnomeCanvasItem* item, GdkEvent* event);

	bool select_all_within (jack_nframes_t start, jack_nframes_t end, gdouble topy, gdouble boty, bool add);
	
	GnomeCanvasItem   *rubberband_rect;
	
	/* mouse zoom process */

	void start_mouse_zoom (GnomeCanvasItem* item, GdkEvent* event);
	void drag_mouse_zoom (GnomeCanvasItem* item, GdkEvent* event);
	void end_mouse_zoom (GnomeCanvasItem* item, GdkEvent* event);

	GnomeCanvasItem   *zoom_rect;
	void reposition_zoom_rect (jack_nframes_t start, jack_nframes_t end);
	
	/* diskstream/route display management */

	Gtk::TreeView          route_list;
	Gtk::ScrolledWindow route_list_scroller;
	Gtk::Menu          *route_list_menu;

	void route_list_column_click (gint);
	void build_route_list_menu ();
	void select_all_routes ();
	void unselect_all_routes ();
	void select_all_audiotracks ();
	void unselect_all_audiotracks ();
	void select_all_audiobus ();
	void unselect_all_audiobus ();

	/* edit group management */

	Gtk::Button         edit_group_list_button;
	Gtk::Label          edit_group_list_button_label;
	Gtk::TreeView       edit_group_list;
	Gtk::ScrolledWindow edit_group_list_scroller;
	Gtk::Menu          *edit_group_list_menu;
	Gtk::VBox           edit_group_vbox;


	void edit_group_list_column_click (gint);
	void build_edit_group_list_menu ();
	void select_all_edit_groups ();
	void unselect_all_edit_groups ();
	void new_edit_group ();
	void edit_group_list_button_clicked ();
	gint edit_group_list_button_press_event (GdkEventButton* ev);
	void edit_group_selected (gint row, gint col, GdkEvent* ev);
	void edit_group_unselected (gint row, gint col, GdkEvent* ev);
	void fake_add_edit_group (ARDOUR::RouteGroup* group);
	void add_edit_group (ARDOUR::RouteGroup* group);
	void group_flags_changed (void*, ARDOUR::RouteGroup*);

	Gtk::VBox           list_vpacker;

	static GdkPixmap* check_pixmap;
	static GdkBitmap* check_mask;
	static GdkPixmap* empty_pixmap;
	static GdkBitmap* empty_mask;

	/* autoscrolling */

	int autoscroll_timeout_tag;
	int autoscroll_direction;
	uint32_t autoscroll_cnt;
	jack_nframes_t autoscroll_distance;
     
	static gint _autoscroll_canvas (void *);
	gint autoscroll_canvas ();
	void start_canvas_autoscroll (int direction);
	void stop_canvas_autoscroll ();
	void maybe_autoscroll (GdkEvent*);

	/* trimming */
	enum TrimOp {
		StartTrim,
		EndTrim,
		ContentsTrim,
	} trim_op;

	void start_trim (GnomeCanvasItem*, GdkEvent*);
	void point_trim (GdkEvent*);
	void trim_motion_callback (GnomeCanvasItem*, GdkEvent*);
	void single_contents_trim (AudioRegionView&, jack_nframes_t, bool, bool, bool);
	void single_start_trim (AudioRegionView&, jack_nframes_t, bool, bool);
	void single_end_trim (AudioRegionView&, jack_nframes_t, bool, bool);

	void trim_finished_callback (GnomeCanvasItem*, GdkEvent*);
	void thaw_region_after_trim (AudioRegionView& rv);
	
	void trim_region_to_edit_cursor ();
	void trim_region_from_edit_cursor ();

	bool show_gain_after_trim;

	/* Drag-n-Drop */

	int convert_drop_to_paths (std::vector<std::string>& paths,
				   GdkDragContext     *context,
				   gint                x,
				   gint                y,
				   GtkSelectionData   *data,
				   guint               info,
				   guint               time);

	void  track_canvas_drag_data_received  (GdkDragContext     *context,
						gint                x,
						gint                y,
						GtkSelectionData   *data,
						guint               info,
						guint               time);

	void  region_list_display_drag_data_received  (GdkDragContext     *context,
						       gint                x,
						       gint                y,
						       GtkSelectionData   *data,
						       guint               info,
						       guint               time);
	
	/* audio export */

	ExportDialog *export_dialog;
	void export_range (jack_nframes_t start, jack_nframes_t end);

	int write_region_selection(AudioRegionSelection&);
	bool write_region (string path, ARDOUR::AudioRegion&);
	void export_region ();
	void write_a_region ();
	void bounce_region_selection ();
	void bounce_range_selection ();
	void external_edit_region ();

	int write_audio_selection (TimeSelection&);
	bool write_audio_range (ARDOUR::Playlist&, uint32_t channels, list<ARDOUR::AudioRange>&);

	void write_selection ();

	/* history */

	UndoAction get_memento() const;

	void begin_reversible_command (string cmd_name);
	void commit_reversible_command ();

	/* visual history */

	UndoHistory visual_history;
	UndoCommand current_visual_command;

	void begin_reversible_visual_command (string cmd_name);
	void commit_reversible_visual_command ();

	void update_title ();	
	void update_title_s (string snapshot_name);

	struct State {
	    Selection* selection;
	    double     frames_per_unit;

	    State();
	    ~State();
	};

	void store_state (State&) const;
	void restore_state (State *);

	void instant_save ();

	ARDOUR::AudioRegion* last_audition_region;
	
	/* freeze operations */

	ARDOUR::InterThreadInfo freeze_status;
	gint freeze_progress_timeout (void *);
	static void* _freeze_thread (void*);
	void* freeze_thread ();

	void freeze_route ();
	void unfreeze_route ();

	/* edit-group solo + mute */

	void set_edit_group_solo (ARDOUR::Route&, bool);
	void set_edit_group_mute (ARDOUR::Route&, bool);

	/* duplication */

	void duplicate_dialog (bool for_region);
	
	/* edit menu */

	Gtk::Menu* edit_menu;
	void edit_menu_map_handler ();

	jack_nframes_t event_frame (GdkEvent*, double* px = 0, double* py = 0);

	void time_fx_motion (GnomeCanvasItem*, GdkEvent*);
	void start_time_fx (GnomeCanvasItem*, GdkEvent*);
	void end_time_fx (GnomeCanvasItem*, GdkEvent*);

	struct TimeStretchDialog : public ArdourDialog {
	    ARDOUR::Session::TimeStretchRequest request;
	    Editor&               editor;
	    AudioRegionSelection  regions;
	    Gtk::ProgressBar      progress_bar;
	    Gtk::ToggleButton     quick_button;
	    Gtk::ToggleButton     antialias_button;
	    Gtk::Button           cancel_button;
	    Gtk::Button           action_button;
	    Gtk::HBox             lower_button_box;
	    Gtk::HBox             upper_button_box;
	    Gtk::VBox             packer;
	    int                   status;

	    TimeStretchDialog (Editor& e);

	    gint update_progress ();
	    sigc::connection first_cancel;
	    sigc::connection first_delete;
	    void cancel_timestretch_in_progress ();
	    gint delete_timestretch_in_progress (GdkEventAny*);
	};

	/* "whats mine is yours" */

	friend class TimeStretchDialog;

	TimeStretchDialog* current_timestretch;

	static void* timestretch_thread (void *arg);
	int run_timestretch (AudioRegionSelection&, float fraction);
	void do_timestretch (TimeStretchDialog&);

	/* editor-mixer strip */

	MixerStrip *current_mixer_strip;
	Gtk::VBox current_mixer_strip_vbox;
	void cms_deleted ();
	void current_mixer_strip_hidden ();
	void current_mixer_strip_removed ();

	void detach_tearoff (Gtk::Box* b, Gtk::Widget* w);
	void reattach_tearoff (Gtk::Box* b, Gtk::Widget* w, int32_t n);

	/* nudging tracks */

	void nudge_track (bool use_edit_cursor, bool forwards);

	/* xfades */

	bool _xfade_visibility;
	
	/* <CMT Additions> */
	void handle_new_imageframe_time_axis_view(std::string track_name, void* src) ;
	void handle_new_imageframe_marker_time_axis_view(std::string track_name, TimeAxisView* marked_track) ;

	void start_imageframe_grab(GnomeCanvasItem*, GdkEvent*) ;
	void start_markerview_grab(GnomeCanvasItem*, GdkEvent*) ;

	void imageframe_drag_motion_callback(GnomeCanvasItem*, GdkEvent*) ;
	void markerview_drag_motion_callback(GnomeCanvasItem*, GdkEvent*) ;
	void timeaxis_item_drag_finished_callback(GnomeCanvasItem*, GdkEvent*) ;

	gint canvas_imageframe_item_view_event(GnomeCanvasItem* item, GdkEvent* event, ImageFrameView* ifv);
	gint canvas_imageframe_view_event(GnomeCanvasItem* item, GdkEvent* event, ImageFrameTimeAxis* ifta);
	gint canvas_imageframe_start_handle_event(GnomeCanvasItem* item, GdkEvent* event, ImageFrameView* ifv);
	gint canvas_imageframe_end_handle_event(GnomeCanvasItem* item, GdkEvent* event, ImageFrameView* ifv);

	gint canvas_marker_time_axis_view_event(GnomeCanvasItem* item, GdkEvent* event, MarkerTimeAxis* mta);
	gint canvas_markerview_item_view_event(GnomeCanvasItem* item, GdkEvent* event, MarkerView* mv);
	gint canvas_markerview_start_handle_event(GnomeCanvasItem* item, GdkEvent* event, MarkerView* mv);
	gint canvas_markerview_end_handle_event(GnomeCanvasItem* item, GdkEvent* event, MarkerView* mv);

	void imageframe_start_handle_op(GnomeCanvasItem* item, GdkEvent* event) ;
	void imageframe_end_handle_op(GnomeCanvasItem* item, GdkEvent* event) ;
	void imageframe_start_handle_trim_motion(GnomeCanvasItem* item, GdkEvent* event) ;
	void imageframe_start_handle_end_trim(GnomeCanvasItem* item, GdkEvent* event) ;
	void imageframe_end_handle_trim_motion(GnomeCanvasItem* item, GdkEvent* event) ;
	void imageframe_end_handle_end_trim(GnomeCanvasItem* item, GdkEvent* event) ;
	
	void markerview_item_start_handle_op(GnomeCanvasItem* item, GdkEvent* event) ;
	void markerview_item_end_handle_op(GnomeCanvasItem* item, GdkEvent* event) ;
	void markerview_start_handle_trim_motion(GnomeCanvasItem* item, GdkEvent* event) ;
	void markerview_start_handle_end_trim(GnomeCanvasItem* item, GdkEvent* event) ;
	void markerview_end_handle_trim_motion(GnomeCanvasItem* item, GdkEvent* event) ;
	void markerview_end_handle_end_trim(GnomeCanvasItem* item, GdkEvent* event) ;

	void popup_imageframe_edit_menu(int button, int32_t time, GnomeCanvasItem* ifv, bool with_frame) ;
	void popup_marker_time_axis_edit_menu(int button, int32_t time, GnomeCanvasItem* ifv, bool with_frame) ;

	ImageFrameSocketHandler* image_socket_listener ;
	/* </CMT Additions> */

	void toggle_xfade_active (ARDOUR::Crossfade*);
	void toggle_xfade_length (ARDOUR::Crossfade*);
	void edit_xfade (ARDOUR::Crossfade*);
	void remove_xfade ();
	void xfade_edit_left_region ();
	void xfade_edit_right_region ();

	static const int32_t default_width = 995;
	static const int32_t default_height = 765;

	/* nudge */

	Gtk::Button      nudge_forward_button;
	Gtk::Button      nudge_backward_button;
	Gtk::HBox        nudge_hbox;
	Gtk::VBox        nudge_vbox;
	Gtk::Label       nudge_label;
	AudioClock       nudge_clock;

	jack_nframes_t get_nudge_distance (jack_nframes_t pos, jack_nframes_t& next);
	
	/* audio filters */

	void apply_filter (ARDOUR::AudioFilter&, string cmd);

	/* handling cleanup */

	int playlist_deletion_dialog (ARDOUR::Playlist*);

	vector<sigc::connection> session_connections;

	/* tracking step changes of track height */

	TimeAxisView* current_stepping_trackview;
	struct timeval last_track_height_step_timestamp;
	gint track_height_step_timeout();
	sigc::connection step_timeout;

	TimeAxisView* entered_track;
	AudioRegionView* entered_regionview;
	bool clear_entered_track;
	gint left_track_canvas (GdkEventCrossing*);
	void set_entered_track (TimeAxisView*);
	void set_entered_regionview (AudioRegionView*);
	gint left_automation_track ();

	bool _new_regionviews_show_envelope;

	void toggle_gain_envelope_visibility ();
	void toggle_gain_envelope_active ();
	
	typedef std::map<Editing::ColorID,std::string> ColorStyleMap;
	void init_colormap ();

	/* GTK2 stuff */

	Glib::RefPtr<Gtk::UIManager> ui_manager;
};

#endif /* __ardour_editor_h__ */