6903cd20c9236abd6e3273cd26ba6b507d7e7830
[ardour.git] / gtk2_ardour / editor.h
1 /*
2     Copyright (C) 2000-2003 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 __ardour_editor_h__
21 #define __ardour_editor_h__
22
23 #include <list>
24 #include <map>
25 #include <set>
26 #include <string>
27 #include <sys/time.h>
28 #include <bitset>
29
30 #include <boost/optional.hpp>
31
32 #include <libgnomecanvasmm/canvas.h>
33 #include <libgnomecanvasmm/group.h>
34 #include <libgnomecanvasmm/line.h>
35 #include <libgnomecanvasmm/pixbuf.h>
36
37 #include <cmath>
38
39 #include <gtkmm/comboboxtext.h>
40 #include <gtkmm/layout.h>
41
42 #include "gtkmm2ext/selector.h"
43 #include "gtkmm2ext/click_box.h"
44 #include "gtkmm2ext/dndtreeview.h"
45 #include "gtkmm2ext/stateful_button.h"
46
47 #include "pbd/stateful.h"
48 #include "pbd/signals.h"
49
50 #include "ardour/import_status.h"
51 #include "ardour/tempo.h"
52 #include "ardour/location.h"
53 #include "ardour/audioregion.h"
54 #include "ardour/track.h"
55 #include "ardour/types.h"
56 #include "ardour/route_group.h"
57
58 #include "audio_clock.h"
59 #include "gtk-custom-ruler.h"
60 #include "ardour_dialog.h"
61 #include "public_editor.h"
62 #include "editing.h"
63 #include "enums.h"
64 #include "editor_items.h"
65 #include "region_selection.h"
66 #include "canvas.h"
67 #include "window_proxy.h"
68
69 namespace Gnome { namespace Canvas {
70         class NoEventText;
71 } }
72
73 namespace Gtkmm2ext {
74         class TearOff;
75 }
76
77 namespace ARDOUR {
78         class RouteGroup;
79         class Playlist;
80         class AudioPlaylist;
81         class Region;
82         class Location;
83         class TempoSection;
84         class NamedSelection;
85         class Session;
86         class Filter;
87         class Crossfade;
88         class ChanCount;
89         class MidiOperator;
90         class MidiTrack;
91         class AudioTrack;
92 }
93
94 namespace LADSPA {
95         class Plugin;
96 }
97
98 class AnalysisWindow;
99 class AudioRegionView;
100 class AudioStreamView;
101 class AudioTimeAxisView;
102 class AutomationLine;
103 class AutomationSelection;
104 class AutomationTimeAxisView;
105 class BundleManager;
106 class ControlPoint;
107 class CrossfadeView;
108 class DragManager;
109 class GroupedButtons;
110 class Marker;
111 class MidiRegionView;
112 class MixerStrip;
113 class PlaylistSelector;
114 class PluginSelector;
115 class RhythmFerret;
116 class Selection;
117 class SoundFileOmega;
118 class StreamView;
119 class TempoLines;
120 class TimeAxisView;
121 class TimeFXDialog;
122 class TimeSelection;
123 class EditorGroupTabs;
124 class EditorRoutes;
125 class EditorRouteGroups;
126 class EditorRegions;
127 class EditorLocations;
128 class EditorSnapshots;
129 class EditorSummary;
130 class RegionLayeringOrderEditor;
131 class ProgressReporter;
132 class EditorCursor;
133 class MouseCursors;
134
135 /* <CMT Additions> */
136 class ImageFrameView;
137 class ImageFrameTimeAxisView;
138 class ImageFrameTimeAxis;
139 class MarkerTimeAxis ;
140 class MarkerView ;
141 class ImageFrameSocketHandler ;
142 class TimeAxisViewItem ;
143 /* </CMT Additions> */
144
145 class Editor : public PublicEditor, public PBD::ScopedConnectionList, public ARDOUR::SessionHandlePtr
146 {
147   public:
148         Editor ();
149         ~Editor ();
150
151         void             set_session (ARDOUR::Session *);
152         ARDOUR::Session* session() const { return _session; }
153
154         void             first_idle ();
155         virtual bool     have_idled () const { return _have_idled; }
156
157         framepos_t leftmost_position() const { return leftmost_frame; }
158
159         framecnt_t current_page_frames() const {
160                 return (framecnt_t) floor (_canvas_width * frames_per_unit);
161         }
162
163         double canvas_height () const {
164                 return _canvas_height;
165         }
166
167         void cycle_snap_mode ();
168         void cycle_snap_choice ();
169         void set_snap_to (Editing::SnapType);
170         void set_snap_mode (Editing::SnapMode);
171         void set_snap_threshold (double pixel_distance) {snap_threshold = pixel_distance;}
172
173         Editing::SnapMode  snap_mode () const;
174         Editing::SnapType  snap_type () const;
175
176         void undo (uint32_t n = 1);
177         void redo (uint32_t n = 1);
178
179         XMLNode& get_state ();
180         int set_state (const XMLNode&, int version);
181
182         void set_mouse_mode (Editing::MouseMode, bool force=true);
183         void step_mouse_mode (bool next);
184         Editing::MouseMode current_mouse_mode () const { return mouse_mode; }
185         Editing::MidiEditMode current_midi_edit_mode () const;
186         void remove_midi_note (ArdourCanvas::Item *, GdkEvent *);
187
188         bool internal_editing() const { return _internal_editing ; }
189         void set_internal_edit (bool yn);
190
191 #ifdef WITH_CMT
192         void add_imageframe_time_axis(const std::string & track_name, void*) ;
193         void add_imageframe_marker_time_axis(const std::string & track_name, TimeAxisView* marked_track, void*) ;
194         void connect_to_image_compositor() ;
195         void scroll_timeaxis_to_imageframe_item(const TimeAxisViewItem* item) ;
196         TimeAxisView* get_named_time_axis(const std::string & name) ;
197 #endif /* WITH_CMT */
198
199         void foreach_time_axis_view (sigc::slot<void,TimeAxisView&>);
200         void add_to_idle_resize (TimeAxisView*, int32_t);
201
202         RouteTimeAxisView* get_route_view_by_route_id (PBD::ID& id) const;
203
204         void consider_auditioning (boost::shared_ptr<ARDOUR::Region>);
205         void hide_a_region (boost::shared_ptr<ARDOUR::Region>);
206         void show_a_region (boost::shared_ptr<ARDOUR::Region>);
207
208 #ifdef USE_RUBBERBAND
209         std::vector<std::string> rb_opt_strings;
210         int rb_current_opt;
211 #endif
212
213         /* things that need to be public to be used in the main menubar */
214
215         void new_region_from_selection ();
216         void separate_regions_between (const TimeSelection&);
217         void separate_region_from_selection ();
218         void separate_under_selected_regions ();
219         void separate_region_from_punch ();
220         void separate_region_from_loop ();
221         void separate_regions_using_location (ARDOUR::Location&);
222         void transition_to_rolling (bool forward);
223
224         /* undo related */
225
226         framepos_t unit_to_frame (double unit) const {
227                 return (framepos_t) rint (unit * frames_per_unit);
228         }
229
230         double frame_to_unit (framepos_t frame) const {
231                 return rint ((double) frame / (double) frames_per_unit);
232         }
233
234         double frame_to_unit (double frame) const {
235                 return rint (frame / frames_per_unit);
236         }
237
238         /* NOTE: these functions assume that the "pixel" coordinate is
239            the result of using the world->canvas affine transform on a
240            world coordinate. These coordinates already take into
241            account any scrolling carried out by adjusting the
242            xscroll_adjustment.
243         */
244
245         framepos_t pixel_to_frame (double pixel) const {
246
247                 /* pixel can be less than zero when motion events
248                    are processed. since we've already run the world->canvas
249                    affine, that means that the location *really* is "off
250                    to the right" and thus really is "before the start".
251                 */
252
253                 if (pixel >= 0) {
254                         return (framepos_t) rint (pixel * frames_per_unit * GNOME_CANVAS(track_canvas->gobj())->pixels_per_unit);
255                 } else {
256                         return 0;
257                 }
258         }
259
260         gulong frame_to_pixel (framepos_t frame) const {
261                 return (gulong) rint ((frame / (frames_per_unit * GNOME_CANVAS(track_canvas->gobj())->pixels_per_unit)));
262         }
263
264         void flush_canvas ();
265
266         /* selection */
267
268         Selection& get_selection() const { return *selection; }
269         Selection& get_cut_buffer() const { return *cut_buffer; }
270
271         bool extend_selection_to_track (TimeAxisView&);
272
273         void play_selection ();
274         void select_all_in_track (Selection::Operation op);
275         void select_all (Selection::Operation op);
276         void invert_selection_in_track ();
277         void invert_selection ();
278         void deselect_all ();
279
280         void set_selected_regionview_from_region_list (boost::shared_ptr<ARDOUR::Region> region, Selection::Operation op = Selection::Set);
281
282         /* tempo */
283
284         void set_show_measures (bool yn);
285         bool show_measures () const { return _show_measures; }
286
287         /* analysis window */
288
289         void analyze_region_selection();
290         void analyze_range_selection();
291
292         /* export */
293
294         void export_audio ();
295         void stem_export ();
296         void export_selection ();
297         void export_range ();
298         void export_region ();
299
300         void add_toplevel_controls (Gtk::Container&);
301         Gtk::HBox& get_status_bar_packer()  { return status_bar_hpacker; }
302
303         void               set_zoom_focus (Editing::ZoomFocus);
304         Editing::ZoomFocus get_zoom_focus () const { return zoom_focus; }
305         double             get_current_zoom () const { return frames_per_unit; }
306
307         void temporal_zoom_step (bool coarser);
308         void tav_zoom_step (bool coarser);
309
310         /* stuff that AudioTimeAxisView and related classes use */
311
312         PlaylistSelector& playlist_selector() const;
313         void clear_playlist (boost::shared_ptr<ARDOUR::Playlist>);
314
315         void new_playlists (TimeAxisView* v);
316         void copy_playlists (TimeAxisView* v);
317         void clear_playlists (TimeAxisView* v);
318
319         void get_onscreen_tracks (TrackViewList&);
320
321         Width editor_mixer_strip_width;
322         void maybe_add_mixer_strip_width (XMLNode&);
323         void show_editor_mixer (bool yn);
324         void create_editor_mixer ();
325         void show_editor_list (bool yn);
326         void set_selected_mixer_strip (TimeAxisView&);
327         void mixer_strip_width_changed ();
328         void hide_track_in_display (TimeAxisView* tv, bool temporary = false);
329
330         /* nudge is initiated by transport controls owned by ARDOUR_UI */
331
332         framecnt_t get_nudge_distance (framepos_t pos, framecnt_t& next);
333         Evoral::MusicalTime get_grid_type_as_beats (bool& success, framepos_t position);
334
335         void nudge_forward (bool next, bool force_playhead);
336         void nudge_backward (bool next, bool force_playhead);
337
338         /* nudge initiated from context menu */
339
340         void nudge_forward_capture_offset ();
341         void nudge_backward_capture_offset ();
342
343         /* playhead/screen stuff */
344
345         void set_stationary_playhead (bool yn);
346         void toggle_stationary_playhead ();
347         bool stationary_playhead() const { return _stationary_playhead; }
348         
349         void set_follow_playhead (bool yn, bool catch_up = true);
350         void toggle_follow_playhead ();
351         bool follow_playhead() const { return _follow_playhead; }
352         bool dragging_playhead () const { return _dragging_playhead; }
353
354         void toggle_zero_line_visibility ();
355         void set_summary ();
356         void set_group_tabs ();
357         void toggle_measure_visibility ();
358         void toggle_logo_visibility ();
359
360         /* fades/xfades */
361
362         void toggle_region_fades (int dir);
363         void update_region_fade_visibility ();
364         bool xfade_visibility() const { return _xfade_visibility; }
365         void update_xfade_visibility ();
366
367         /* redirect shared ops menu. caller must free returned menu */
368
369         Gtk::Menu* redirect_menu ();
370
371         /* floating windows/transient */
372
373         void ensure_float (Gtk::Window&);
374
375         void show_window ();
376
377         void scroll_tracks_down_line ();
378         void scroll_tracks_up_line ();
379
380         void prepare_for_cleanup ();
381         void finish_cleanup ();
382
383         void maximise_editing_space();
384         void restore_editing_space();
385
386         void reset_x_origin (framepos_t);
387         void reset_x_origin_to_follow_playhead ();
388         void reset_y_origin (double);
389         void reset_zoom (double);
390         void reposition_and_zoom (framepos_t, double);
391
392         framepos_t get_preferred_edit_position (bool ignore_playhead = false);
393
394         bool update_mouse_speed ();
395         bool decelerate_mouse_speed ();
396
397         void toggle_meter_updating();
398
399         void show_rhythm_ferret();
400
401         void goto_visual_state (uint32_t);
402         void save_visual_state (uint32_t);
403
404         void queue_draw_resize_line (int at);
405         void start_resize_line_ops ();
406         void end_resize_line_ops ();
407
408         TrackViewList const & get_track_views () {
409                 return track_views;
410         }
411
412         int get_regionview_count_from_region_list (boost::shared_ptr<ARDOUR::Region>);
413
414         void do_import (std::vector<std::string> paths, Editing::ImportDisposition, Editing::ImportMode mode, ARDOUR::SrcQuality, framepos_t&);
415         void do_embed (std::vector<std::string> paths, Editing::ImportDisposition, Editing::ImportMode mode,  framepos_t&);
416
417         void get_regions_corresponding_to (boost::shared_ptr<ARDOUR::Region> region, std::vector<RegionView*>& regions);
418
419         void show_verbose_canvas_cursor_with (const std::string& txt, int32_t xoffset = 0, int32_t yoffset = 0);
420         void hide_verbose_canvas_cursor();
421
422         void center_screen (framepos_t);
423
424         TrackViewList axis_views_from_routes (boost::shared_ptr<ARDOUR::RouteList>) const;
425         Gtkmm2ext::TearOff* mouse_mode_tearoff () const { return _mouse_mode_tearoff; }
426         Gtkmm2ext::TearOff* tools_tearoff () const { return _tools_tearoff; }
427
428         void snap_to (framepos_t& first, int32_t direction = 0, bool for_mark = false);
429         void snap_to_with_modifier (framepos_t& first, GdkEvent const *, int32_t direction = 0, bool for_mark = false);
430         void snap_to (framepos_t& first, framepos_t& last, int32_t direction = 0, bool for_mark = false);
431
432         void begin_reversible_command (std::string cmd_name);
433         void begin_reversible_command (GQuark);
434         void commit_reversible_command ();
435
436         DragManager* drags () const {
437                 return _drags;
438         }
439
440         void maybe_autoscroll (bool, bool);
441         
442         Gdk::Cursor* get_canvas_cursor () const { return current_canvas_cursor; }
443         void set_canvas_cursor (Gdk::Cursor*, bool save=false);
444         void set_current_trimmable (boost::shared_ptr<ARDOUR::Trimmable>);
445         void set_current_movable (boost::shared_ptr<ARDOUR::Movable>);
446
447         MouseCursors const * cursors () const {
448                 return _cursors;
449         }
450
451   protected:
452         void map_transport_state ();
453         void map_position_change (framepos_t);
454
455         void on_realize();
456
457   private:
458
459         void color_handler ();
460
461         bool                 constructed;
462
463         // to keep track of the playhead position for control_scroll
464         boost::optional<framepos_t> _control_scroll_target;
465
466         PlaylistSelector* _playlist_selector;
467
468         typedef std::pair<TimeAxisView*,XMLNode*> TAVState;
469
470         struct VisualState {
471             double              y_position;
472             double              frames_per_unit;
473             framepos_t         leftmost_frame;
474             Editing::ZoomFocus  zoom_focus;
475             std::list<TAVState> track_states;
476         };
477
478         std::list<VisualState*> undo_visual_stack;
479         std::list<VisualState*> redo_visual_stack;
480         VisualState* current_visual_state (bool with_tracks = true);
481         void undo_visual_state ();
482         void redo_visual_state ();
483         void use_visual_state (VisualState&);
484         bool no_save_visual;
485         void swap_visual_state ();
486
487         std::vector<VisualState*> visual_states;
488         sigc::connection visual_state_op_connection;
489         void start_visual_state_op (uint32_t n);
490         void cancel_visual_state_op (uint32_t n);
491         bool end_visual_state_op (uint32_t n);
492
493         framepos_t leftmost_frame;
494         double      frames_per_unit;
495         Editing::ZoomFocus zoom_focus;
496
497         void set_frames_per_unit (double);
498         void post_zoom ();
499
500         Editing::MouseMode mouse_mode;
501         bool _internal_editing;
502         Editing::MouseMode effective_mouse_mode () const;
503
504         enum JoinObjectRangeState {
505                 JOIN_OBJECT_RANGE_NONE,
506                 /** `join object/range' mode is active and the mouse is over a place where object mode should happen */
507                 JOIN_OBJECT_RANGE_OBJECT,
508                 /** `join object/range' mode is active and the mouse is over a place where range mode should happen */
509                 JOIN_OBJECT_RANGE_RANGE
510         };
511
512         JoinObjectRangeState _join_object_range_state;
513
514         void update_join_object_range_location (double, double);
515
516         int  post_maximal_editor_width;
517         int  post_maximal_editor_height;
518         int  post_maximal_horizontal_pane_position;
519         int  post_maximal_vertical_pane_position;
520         int  pre_maximal_horizontal_pane_position;
521         int  pre_maximal_vertical_pane_position;
522         int  pre_maximal_editor_width;
523         int  pre_maximal_editor_height;
524         void pane_allocation_handler (Gtk::Allocation&, Gtk::Paned*);
525
526         Gtk::Notebook _the_notebook;
527         bool _notebook_shrunk;
528         void add_notebook_page (std::string const &, Gtk::Widget &);
529         bool notebook_tab_clicked (GdkEventButton *, Gtk::Widget *);
530         
531         Gtk::HPaned   edit_pane;
532         Gtk::VPaned   editor_summary_pane;
533
534         Gtk::EventBox meter_base;
535         Gtk::HBox     meter_box;
536         Gtk::EventBox marker_base;
537         Gtk::HBox     marker_box;
538         Gtk::VBox     scrollers_rulers_markers_box;
539
540         void location_changed (ARDOUR::Location *);
541         void location_flags_changed (ARDOUR::Location *, void *);
542         void refresh_location_display ();
543         void refresh_location_display_s (const PBD::PropertyChange&);
544         void refresh_location_display_internal (ARDOUR::Locations::LocationList&);
545         void add_new_location (ARDOUR::Location *);
546         void location_gone (ARDOUR::Location *);
547         void remove_marker (ArdourCanvas::Item&, GdkEvent*);
548         gint really_remove_marker (ARDOUR::Location* loc);
549         void goto_nth_marker (int nth);
550         void toggle_marker_lines ();
551         void set_marker_line_visibility (bool);
552
553         uint32_t location_marker_color;
554         uint32_t location_range_color;
555         uint32_t location_loop_color;
556         uint32_t location_punch_color;
557         uint32_t location_cd_marker_color;
558
559         struct LocationMarkers {
560                 Marker* start;
561                 Marker* end;
562                 bool    valid;
563                 
564                 LocationMarkers () : start(0), end(0), valid (true) {}
565                 
566                 ~LocationMarkers ();
567                 
568                 void hide ();
569                 void show ();
570
571                 void set_show_lines (bool);
572                 void set_selected (bool);
573                 void canvas_height_set (double);
574                 void setup_lines ();
575                 
576                 void set_name (const std::string&);
577                 void set_position (framepos_t start, framepos_t end = 0);
578                 void set_color_rgba (uint32_t);
579         };
580
581         LocationMarkers  *find_location_markers (ARDOUR::Location *) const;
582         ARDOUR::Location* find_location_from_marker (Marker *, bool& is_start) const;
583         Marker* entered_marker;
584         bool _show_marker_lines;
585
586         typedef std::map<ARDOUR::Location*,LocationMarkers *> LocationMarkerMap;
587         LocationMarkerMap location_markers;
588
589         void update_marker_labels ();
590         void update_marker_labels (ArdourCanvas::Group *);
591         void check_marker_label (Marker *);
592
593         /** A set of lists of Markers that are in each of the canvas groups
594          *  for the marker sections at the top of the editor.  These lists
595          *  are kept sorted in time order between marker movements, so that after
596          *  a marker has moved we can decide whether we need to update the labels
597          *  for all markers or for just a few.
598          */
599         std::map<ArdourCanvas::Group *, std::list<Marker *> > _sorted_marker_lists;
600         void remove_sorted_marker (Marker *);
601
602         void hide_marker (ArdourCanvas::Item*, GdkEvent*);
603         void clear_marker_display ();
604         void mouse_add_new_marker (framepos_t where, bool is_cd=false, bool is_xrun=false);
605         bool choose_new_marker_name(std::string &name);
606         void update_cd_marker_display ();
607         void ensure_cd_marker_updated (LocationMarkers * lam, ARDOUR::Location * location);
608
609         TimeAxisView*      clicked_axisview;
610         RouteTimeAxisView* clicked_routeview;
611         /** The last RegionView that was clicked on, or 0 if the last click was not
612          * on a RegionView.  This is set up by the canvas event handlers in
613          * editor_canvas_events.cc
614          */
615         RegionView*        clicked_regionview;
616         RegionSelection    latest_regionviews;
617         uint32_t           clicked_selection;
618         CrossfadeView*     clicked_crossfadeview;
619         ControlPoint*      clicked_control_point;
620
621         void sort_track_selection (TrackViewList* sel = 0);
622
623         void get_equivalent_regions (RegionView* rv, std::vector<RegionView*> &, PBD::PropertyID) const;
624         RegionSelection get_equivalent_regions (RegionSelection &, PBD::PropertyID) const;
625         void mapover_tracks (sigc::slot<void,RouteTimeAxisView&,uint32_t> sl, TimeAxisView*, PBD::PropertyID) const;
626
627         /* functions to be passed to mapover_tracks(), possibly with sigc::bind()-supplied arguments */
628
629         void mapped_get_equivalent_regions (RouteTimeAxisView&, uint32_t, RegionView *, std::vector<RegionView*>*) const;
630         void mapped_use_new_playlist (RouteTimeAxisView&, uint32_t, std::vector<boost::shared_ptr<ARDOUR::Playlist> > const &);
631         void mapped_use_copy_playlist (RouteTimeAxisView&, uint32_t, std::vector<boost::shared_ptr<ARDOUR::Playlist> > const &);
632         void mapped_clear_playlist (RouteTimeAxisView&, uint32_t);
633
634         /* end */
635
636         void button_selection (ArdourCanvas::Item* item, GdkEvent* event, ItemType item_type);
637         bool button_release_can_deselect;
638
639         void catch_vanishing_regionview (RegionView *);
640
641         void set_selected_track (TimeAxisView&, Selection::Operation op = Selection::Set, bool no_remove=false);
642         void select_all_tracks ();
643         void select_all_internal_edit (Selection::Operation);
644
645         bool set_selected_control_point_from_click (Selection::Operation op = Selection::Set, bool no_remove=false);
646         void set_selected_track_from_click (bool press, Selection::Operation op = Selection::Set, bool no_remove=false);
647         void set_selected_track_as_side_effect (Selection::Operation op, bool force = false);
648         bool set_selected_regionview_from_click (bool press, Selection::Operation op = Selection::Set, bool no_track_remove=false);
649
650         bool set_selected_regionview_from_map_event (GdkEventAny*, StreamView*, boost::weak_ptr<ARDOUR::Region>);
651         void collect_new_region_view (RegionView *);
652         void collect_and_select_new_region_view (RegionView *);
653
654         long select_range_around_region (RegionView *);
655
656         Gtk::Menu track_context_menu;
657         Gtk::Menu track_region_context_menu;
658         Gtk::Menu track_selection_context_menu;
659         Gtk::Menu track_crossfade_context_menu;
660
661         Gtk::MenuItem* region_edit_menu_split_item;
662         Gtk::MenuItem* region_edit_menu_split_multichannel_item;
663         Gtk::Menu * track_region_edit_playlist_menu;
664         Gtk::Menu * track_edit_playlist_submenu;
665         Gtk::Menu * track_selection_edit_playlist_submenu;
666
667         void popup_track_context_menu (int, int, ItemType, bool);
668         Gtk::Menu* build_track_context_menu ();
669         Gtk::Menu* build_track_bus_context_menu ();
670         Gtk::Menu* build_track_region_context_menu ();
671         Gtk::Menu* build_track_crossfade_context_menu ();
672         Gtk::Menu* build_track_selection_context_menu ();
673         void add_dstream_context_items (Gtk::Menu_Helpers::MenuList&);
674         void add_bus_context_items (Gtk::Menu_Helpers::MenuList&);
675         void add_region_context_items (Gtk::Menu_Helpers::MenuList&, bool);
676         void add_crossfade_context_items (AudioStreamView*, boost::shared_ptr<ARDOUR::Crossfade>, Gtk::Menu_Helpers::MenuList&, bool many);
677         void add_selection_context_items (Gtk::Menu_Helpers::MenuList&);
678         Gtk::MenuItem* _popup_region_menu_item;
679
680         void handle_new_route (ARDOUR::RouteList&);
681         void timeaxisview_deleted (TimeAxisView *);
682
683         Gtk::HBox           global_hpacker;
684         Gtk::VBox           global_vpacker;
685         Gtk::VBox           vpacker;
686
687         Gdk::Cursor*          current_canvas_cursor;
688         Gdk::Cursor* which_grabber_cursor ();
689         void set_canvas_cursor ();
690
691         ArdourCanvas::Canvas* track_canvas;
692
693         ArdourCanvas::NoEventText* verbose_canvas_cursor;
694         bool                 verbose_cursor_visible;
695
696         void parameter_changed (std::string);
697
698         bool track_canvas_motion (GdkEvent*);
699
700         void set_verbose_canvas_cursor (const std::string &, double x, double y);
701         void set_verbose_canvas_cursor_text (const std::string &);
702         void show_verbose_canvas_cursor();
703
704         bool verbose_cursor_on; // so far unused
705
706         Gtk::EventBox             time_canvas_event_box;
707         Gtk::EventBox             track_canvas_event_box;
708         Gtk::EventBox             time_button_event_box;
709         Gtk::EventBox             ruler_label_event_box;
710
711         ArdourCanvas::Group      *minsec_group;
712         ArdourCanvas::Pixbuf     *logo_item;
713         ArdourCanvas::Group      *bbt_group;
714         ArdourCanvas::Group      *timecode_group;
715         ArdourCanvas::Group      *frame_group;
716         ArdourCanvas::Group      *tempo_group;
717         ArdourCanvas::Group      *meter_group;
718         ArdourCanvas::Group      *marker_group;
719         ArdourCanvas::Group      *range_marker_group;
720         ArdourCanvas::Group      *transport_marker_group;
721         ArdourCanvas::Group*      cd_marker_group;
722
723         ArdourCanvas::Group*      timebar_group;
724
725         /* These bars never need to be scrolled */
726         ArdourCanvas::Group*      meter_bar_group;
727         ArdourCanvas::Group*      tempo_bar_group;
728         ArdourCanvas::Group*      marker_bar_group;
729         ArdourCanvas::Group*      range_marker_bar_group;
730         ArdourCanvas::Group*      transport_marker_bar_group;
731         ArdourCanvas::Group*      cd_marker_bar_group;
732
733         /** The group containing all items that require horizontal scrolling. */
734         ArdourCanvas::Group* _background_group;
735         /*
736            The _master_group is the group containing all items
737            that require horizontal scrolling..
738            It is primarily used to separate canvas items
739            that require horizontal scrolling from those that do not.
740         */
741         ArdourCanvas::Group* _master_group;
742
743         /* The group containing all trackviews.  Only scrolled vertically. */
744         ArdourCanvas::Group* _trackview_group;
745
746         /* The group used for region motion.  Sits on top of _trackview_group */
747         ArdourCanvas::Group* _region_motion_group;
748
749         enum RulerType {
750                 ruler_metric_timecode = 0,
751                 ruler_metric_bbt = 1,
752                 ruler_metric_samples = 2,
753                 ruler_metric_minsec = 3,
754
755                 ruler_time_tempo = 4,
756                 ruler_time_meter = 5,
757                 ruler_time_marker = 6,
758                 ruler_time_range_marker = 7,
759                 ruler_time_transport_marker = 8,
760                 ruler_time_cd_marker = 9,
761         };
762
763         static GtkCustomMetric ruler_metrics[4];
764         Glib::RefPtr<Gtk::ToggleAction> ruler_timecode_action;
765         Glib::RefPtr<Gtk::ToggleAction> ruler_bbt_action;
766         Glib::RefPtr<Gtk::ToggleAction> ruler_samples_action;
767         Glib::RefPtr<Gtk::ToggleAction> ruler_minsec_action;
768         Glib::RefPtr<Gtk::ToggleAction> ruler_tempo_action;
769         Glib::RefPtr<Gtk::ToggleAction> ruler_meter_action;
770         Glib::RefPtr<Gtk::ToggleAction> ruler_marker_action;
771         Glib::RefPtr<Gtk::ToggleAction> ruler_range_action;
772         Glib::RefPtr<Gtk::ToggleAction> ruler_loop_punch_action;
773         Glib::RefPtr<Gtk::ToggleAction> ruler_cd_marker_action;
774         bool                            no_ruler_shown_update;
775
776         gint ruler_button_press (GdkEventButton*);
777         gint ruler_button_release (GdkEventButton*);
778         gint ruler_mouse_motion (GdkEventMotion*);
779         bool ruler_scroll (GdkEventScroll* event);
780
781         Gtk::Widget * ruler_grabbed_widget;
782
783         void initialize_rulers ();
784         void update_just_timecode ();
785         void compute_fixed_ruler_scale (); //calculates the RulerScale of the fixed rulers
786         void update_fixed_rulers ();
787         void update_tempo_based_rulers ();
788         void popup_ruler_menu (framepos_t where = 0, ItemType type = RegionItem);
789         void update_ruler_visibility ();
790         void set_ruler_visible (RulerType, bool);
791         void toggle_ruler_visibility (RulerType rt);
792         void ruler_toggled (int);
793         gint ruler_label_button_release (GdkEventButton*);
794         void store_ruler_visibility ();
795         void restore_ruler_visibility ();
796
797         static gint _metric_get_timecode (GtkCustomRulerMark **, gdouble, gdouble, gint);
798         static gint _metric_get_bbt (GtkCustomRulerMark **, gdouble, gdouble, gint);
799         static gint _metric_get_samples (GtkCustomRulerMark **, gdouble, gdouble, gint);
800         static gint _metric_get_minsec (GtkCustomRulerMark **, gdouble, gdouble, gint);
801
802         enum MinsecRulerScale {
803                 minsec_show_seconds,
804                 minsec_show_minutes,
805                 minsec_show_hours,
806                 minsec_show_frames
807         };
808
809         MinsecRulerScale minsec_ruler_scale;
810
811         framecnt_t minsec_mark_interval;
812         gint minsec_mark_modulo;
813         gint minsec_nmarks;
814         void set_minsec_ruler_scale (framepos_t, framepos_t);
815
816         enum TimecodeRulerScale {
817                 timecode_show_bits,
818                 timecode_show_frames,
819                 timecode_show_seconds,
820                 timecode_show_minutes,
821                 timecode_show_hours
822         };
823
824         TimecodeRulerScale timecode_ruler_scale;
825
826         gint timecode_mark_modulo;
827         gint timecode_nmarks;
828         void set_timecode_ruler_scale (framepos_t, framepos_t);
829
830         framecnt_t _samples_ruler_interval;
831         void set_samples_ruler_scale (framepos_t, framepos_t);
832
833         enum BBTRulerScale {
834                 bbt_over,
835                 bbt_show_64,
836                 bbt_show_16,
837                 bbt_show_4,
838                 bbt_show_1,
839                 bbt_show_beats,
840                 bbt_show_ticks,
841                 bbt_show_ticks_detail,
842                 bbt_show_ticks_super_detail
843         };
844
845         BBTRulerScale bbt_ruler_scale;
846
847         uint32_t bbt_bars;
848         gint bbt_nmarks;
849         uint32_t bbt_bar_helper_on;
850         uint32_t bbt_accent_modulo;
851         void compute_bbt_ruler_scale (framepos_t lower, framepos_t upper);
852
853         gint metric_get_timecode (GtkCustomRulerMark **, gdouble, gdouble, gint);
854         gint metric_get_bbt (GtkCustomRulerMark **, gdouble, gdouble, gint);
855         gint metric_get_samples (GtkCustomRulerMark **, gdouble, gdouble, gint);
856         gint metric_get_minsec (GtkCustomRulerMark **, gdouble, gdouble, gint);
857
858         Gtk::Widget        *_ruler_separator;
859         GtkWidget          *_timecode_ruler;
860         GtkWidget          *_bbt_ruler;
861         GtkWidget          *_samples_ruler;
862         GtkWidget          *_minsec_ruler;
863         Gtk::Widget        *timecode_ruler;
864         Gtk::Widget        *bbt_ruler;
865         Gtk::Widget        *samples_ruler;
866         Gtk::Widget        *minsec_ruler;
867         static Editor      *ruler_editor;
868
869         static const double timebar_height;
870         guint32 visible_timebars;
871         gdouble canvas_timebars_vsize;
872         gdouble get_canvas_timebars_vsize () const { return canvas_timebars_vsize; }
873         Gtk::Menu          *editor_ruler_menu;
874
875         ArdourCanvas::SimpleRect* tempo_bar;
876         ArdourCanvas::SimpleRect* meter_bar;
877         ArdourCanvas::SimpleRect* marker_bar;
878         ArdourCanvas::SimpleRect* range_marker_bar;
879         ArdourCanvas::SimpleRect* transport_marker_bar;
880         ArdourCanvas::SimpleRect* cd_marker_bar;
881
882         Gtk::Label  minsec_label;
883         Gtk::Label  bbt_label;
884         Gtk::Label  timecode_label;
885         Gtk::Label  samples_label;
886         Gtk::Label  tempo_label;
887         Gtk::Label  meter_label;
888         Gtk::Label  mark_label;
889         Gtk::Label  range_mark_label;
890         Gtk::Label  transport_mark_label;
891         Gtk::Label  cd_mark_label;
892
893         Gtk::VBox          time_button_vbox;
894         Gtk::HBox          time_button_hbox;
895
896         friend class EditorCursor;
897
898         EditorCursor*        playhead_cursor;
899         ArdourCanvas::Group* cursor_group;
900
901         framepos_t get_region_boundary (framepos_t pos, int32_t dir, bool with_selection, bool only_onscreen);
902
903         void    cursor_to_region_boundary (bool with_selection, int32_t dir);
904         void    cursor_to_next_region_boundary (bool with_selection);
905         void    cursor_to_previous_region_boundary (bool with_selection);
906         void    cursor_to_next_region_point (EditorCursor*, ARDOUR::RegionPoint);
907         void    cursor_to_previous_region_point (EditorCursor*, ARDOUR::RegionPoint);
908         void    cursor_to_region_point (EditorCursor*, ARDOUR::RegionPoint, int32_t dir);
909         void    cursor_to_selection_start (EditorCursor *);
910         void    cursor_to_selection_end   (EditorCursor *);
911
912         void    selected_marker_to_region_boundary (bool with_selection, int32_t dir);
913         void    selected_marker_to_next_region_boundary (bool with_selection);
914         void    selected_marker_to_previous_region_boundary (bool with_selection);
915         void    selected_marker_to_next_region_point (ARDOUR::RegionPoint);
916         void    selected_marker_to_previous_region_point (ARDOUR::RegionPoint);
917         void    selected_marker_to_region_point (ARDOUR::RegionPoint, int32_t dir);
918         void    selected_marker_to_selection_start ();
919         void    selected_marker_to_selection_end   ();
920
921         void    select_all_selectables_using_cursor (EditorCursor *, bool);
922         void    select_all_selectables_using_edit (bool);
923         void    select_all_selectables_between (bool within);
924         void    select_range_between ();
925
926         boost::shared_ptr<ARDOUR::Region> find_next_region (ARDOUR::framepos_t, ARDOUR::RegionPoint, int32_t dir, TrackViewList&, TimeAxisView ** = 0);
927         ARDOUR::framepos_t find_next_region_boundary (ARDOUR::framepos_t, int32_t dir, const TrackViewList&);
928
929         std::vector<ARDOUR::framepos_t> region_boundary_cache;
930         void build_region_boundary_cache ();
931
932         Gtk::HBox           top_hbox;
933         Gtk::HBox           bottom_hbox;
934
935         Gtk::Table          edit_packer;
936
937         Gtk::Adjustment     vertical_adjustment;
938         
939         Gtk::Layout         controls_layout;
940         bool control_layout_scroll (GdkEventScroll* ev);
941         void reset_controls_layout_width ();
942         void reset_controls_layout_height (int32_t height);
943
944         bool horizontal_scroll_left_press ();
945         void horizontal_scroll_left_release ();
946         bool horizontal_scroll_right_press ();
947         void horizontal_scroll_right_release ();
948         sigc::connection _scroll_connection;
949         int _scroll_callbacks;
950
951         double _canvas_width;
952         double _canvas_height; ///< height of the visible area of the track canvas
953         double full_canvas_height; ///< full height of the canvas
954
955         bool track_canvas_map_handler (GdkEventAny*);
956
957         gint edit_controls_button_release (GdkEventButton*);
958         Gtk::Menu *edit_controls_left_menu;
959         Gtk::Menu *edit_controls_right_menu;
960
961         Gtk::VBox           ruler_label_vbox;
962         Gtk::VBox           track_canvas_vbox;
963         Gtk::VBox           time_canvas_vbox;
964         Gtk::VBox           edit_controls_vbox;
965         Gtk::HBox           edit_controls_hbox;
966
967         void control_scroll (float);
968         void access_action (std::string,std::string);
969         bool deferred_control_scroll (framepos_t);
970         sigc::connection control_scroll_connection;
971
972         gdouble get_trackview_group_vertical_offset () const { return vertical_adjustment.get_value () - canvas_timebars_vsize;}
973
974         ArdourCanvas::Group* get_background_group () const { return _background_group; }
975         ArdourCanvas::Group* get_trackview_group () const { return _trackview_group; }
976         double last_trackview_group_vertical_offset;
977         void tie_vertical_scrolling ();
978         void set_horizontal_position (double);
979         double horizontal_position () const;
980         void scroll_canvas_vertically ();
981
982         struct VisualChange {
983                 enum Type {
984                         TimeOrigin = 0x1,
985                         ZoomLevel = 0x2,
986                         YOrigin = 0x4
987                 };
988
989                 Type pending;
990                 framepos_t time_origin;
991                 double frames_per_unit;
992                 double y_origin;
993
994                 int idle_handler_id;
995
996                 VisualChange() : pending ((VisualChange::Type) 0), time_origin (0), frames_per_unit (0), idle_handler_id (-1) {}
997                 void add (Type t) {
998                         pending = Type (pending | t);
999                 }
1000         };
1001
1002
1003         VisualChange pending_visual_change;
1004
1005         static int _idle_visual_changer (void *arg);
1006         int idle_visual_changer ();
1007
1008         void queue_visual_change (framepos_t);
1009         void queue_visual_change (double);
1010         void queue_visual_change_y (double);
1011         void ensure_visual_change_idle_handler ();
1012
1013         /* track views */
1014         TrackViewList track_views;
1015         std::pair<TimeAxisView*, ARDOUR::layer_t> trackview_by_y_position (double);
1016         TimeAxisView* axis_view_from_route (boost::shared_ptr<ARDOUR::Route>) const;
1017
1018         TrackViewList get_tracks_for_range_action () const;
1019
1020         sigc::connection super_rapid_screen_update_connection;
1021         framepos_t last_update_frame;
1022         void center_screen_internal (framepos_t, float);
1023
1024         void super_rapid_screen_update ();
1025
1026         void session_going_away ();
1027
1028         framepos_t cut_buffer_start;
1029         framecnt_t cut_buffer_length;
1030
1031         Gdk::Cursor* pre_press_cursor;
1032         boost::weak_ptr<ARDOUR::Trimmable> _trimmable;
1033         boost::weak_ptr<ARDOUR::Movable> _movable;
1034
1035         bool typed_event (ArdourCanvas::Item*, GdkEvent*, ItemType);
1036         bool button_press_handler (ArdourCanvas::Item*, GdkEvent*, ItemType);
1037         bool button_press_handler_1 (ArdourCanvas::Item *, GdkEvent *, ItemType);
1038         bool button_press_handler_2 (ArdourCanvas::Item *, GdkEvent *, ItemType);
1039         bool button_release_handler (ArdourCanvas::Item*, GdkEvent*, ItemType);
1040         bool motion_handler (ArdourCanvas::Item*, GdkEvent*, bool from_autoscroll = false);
1041         bool enter_handler (ArdourCanvas::Item*, GdkEvent*, ItemType);
1042         bool leave_handler (ArdourCanvas::Item*, GdkEvent*, ItemType);
1043
1044         /* KEYMAP HANDLING */
1045
1046         void register_actions ();
1047         void register_region_actions ();
1048
1049         int ensure_cursor (framepos_t* pos);
1050
1051         void cut_copy (Editing::CutCopyOp);
1052         bool can_cut_copy () const;
1053         void cut_copy_points (Editing::CutCopyOp);
1054         void cut_copy_regions (Editing::CutCopyOp, RegionSelection&);
1055         void cut_copy_ranges (Editing::CutCopyOp);
1056         void cut_copy_midi (Editing::CutCopyOp);
1057
1058         void mouse_paste ();
1059         void paste_internal (framepos_t position, float times);
1060
1061         /* EDITING OPERATIONS */
1062
1063         void reset_point_selection ();
1064         void toggle_region_lock ();
1065         void toggle_opaque_region ();
1066         void toggle_record_enable ();
1067         void toggle_region_lock_style ();
1068         void raise_region ();
1069         void raise_region_to_top ();
1070         void change_region_layering_order ();
1071         void lower_region ();
1072         void lower_region_to_bottom ();
1073         void split_regions_at (framepos_t, RegionSelection&);
1074         void split_region_at_transients ();
1075         void split_region_at_points (boost::shared_ptr<ARDOUR::Region>, ARDOUR::AnalysisFeatureList&, bool can_ferret, bool select_new = false);
1076         void crop_region_to_selection ();
1077         void crop_region_to (framepos_t start, framepos_t end);
1078         void set_sync_point (framepos_t, const RegionSelection&);
1079         void set_region_sync_position ();
1080         void remove_region_sync();
1081         void align_regions (ARDOUR::RegionPoint);
1082         void align_regions_relative (ARDOUR::RegionPoint point);
1083         void align_region (boost::shared_ptr<ARDOUR::Region>, ARDOUR::RegionPoint point, framepos_t position);
1084         void align_region_internal (boost::shared_ptr<ARDOUR::Region>, ARDOUR::RegionPoint point, framepos_t position);
1085         void remove_selected_regions ();
1086         void remove_clicked_region ();
1087         void show_region_properties ();
1088         void show_midi_list_editor ();
1089         void rename_region ();
1090         void duplicate_some_regions (RegionSelection&, float times);
1091         void duplicate_selection (float times);
1092         void region_fill_selection ();
1093
1094         void region_fill_track ();
1095         void audition_playlist_region_standalone (boost::shared_ptr<ARDOUR::Region>);
1096         void audition_playlist_region_via_route (boost::shared_ptr<ARDOUR::Region>, ARDOUR::Route&);
1097         void split_multichannel_region();
1098         void reverse_region ();
1099         void strip_region_silence ();
1100         void normalize_region ();
1101         void reset_region_scale_amplitude ();
1102         void adjust_region_gain (bool up);
1103         void quantize_region ();
1104         void insert_patch_change ();
1105         void fork_region ();
1106
1107         void do_insert_time ();
1108         void insert_time (framepos_t, framecnt_t, Editing::InsertTimeOption, bool, bool, bool, bool, bool);
1109
1110         void tab_to_transient (bool forward);
1111
1112         void set_tempo_from_region ();
1113         void use_range_as_bar ();
1114
1115         void define_one_bar (framepos_t start, framepos_t end);
1116
1117         void audition_region_from_region_list ();
1118         void hide_region_from_region_list ();
1119         void show_region_in_region_list ();
1120
1121         void naturalize_region ();
1122
1123         void reset_focus ();
1124
1125         void split_region ();
1126
1127         void cut ();
1128         void copy ();
1129         void paste (float times);
1130         
1131         void place_transient ();
1132         void remove_transient (ArdourCanvas::Item* item);
1133         void snap_regions_to_grid ();
1134         void close_region_gaps ();
1135
1136         int  get_prefix (float&, bool&);
1137
1138         void keyboard_paste ();
1139
1140         void region_from_selection ();
1141         void create_region_from_selection (std::vector<boost::shared_ptr<ARDOUR::Region> >&);
1142
1143         void play_from_start ();
1144         void play_from_edit_point ();
1145         void play_from_edit_point_and_return ();
1146         void play_selected_region ();
1147         void play_edit_range ();
1148         void play_location (ARDOUR::Location&);
1149         void loop_location (ARDOUR::Location&);
1150
1151         void temporal_zoom_selection ();
1152         void temporal_zoom_region (bool both_axes);
1153         void zoom_to_region (bool both_axes);
1154         void temporal_zoom_session ();
1155         void temporal_zoom (gdouble scale);
1156         void temporal_zoom_by_frame (framepos_t start, framepos_t end, const std::string & op);
1157         void temporal_zoom_to_frame (bool coarser, framepos_t frame);
1158
1159         void amplitude_zoom (gdouble scale);
1160         void amplitude_zoom_step (bool in);
1161
1162         void insert_region_list_drag (boost::shared_ptr<ARDOUR::Region>, int x, int y);
1163         void insert_region_list_selection (float times);
1164
1165         void insert_route_list_drag (boost::shared_ptr<ARDOUR::Route>, int x, int y);
1166
1167         /* import & embed */
1168
1169         void add_external_audio_action (Editing::ImportMode);
1170         void external_audio_dialog ();
1171         void session_import_dialog ();
1172
1173         int  check_whether_and_how_to_import(std::string, bool all_or_nothing = true);
1174         bool check_multichannel_status (const std::vector<std::string>& paths);
1175
1176         SoundFileOmega* sfbrowser;
1177
1178         void bring_in_external_audio (Editing::ImportMode mode,  framepos_t& pos);
1179
1180         bool  idle_drop_paths  (std::vector<std::string> paths, framepos_t frame, double ypos);
1181         void  drop_paths_part_two  (const std::vector<std::string>& paths, framepos_t frame, double ypos);
1182
1183         int  import_sndfiles (std::vector<std::string> paths, Editing::ImportMode mode,  ARDOUR::SrcQuality, framepos_t& pos,
1184                               int target_regions, int target_tracks, boost::shared_ptr<ARDOUR::Track>&, bool);
1185         int  embed_sndfiles (std::vector<std::string> paths, bool multiple_files, bool& check_sample_rate, Editing::ImportMode mode,
1186                              framepos_t& pos, int target_regions, int target_tracks, boost::shared_ptr<ARDOUR::Track>&);
1187
1188         int add_sources (std::vector<std::string> paths, ARDOUR::SourceList& sources, framepos_t& pos, Editing::ImportMode,
1189                          int target_regions, int target_tracks, boost::shared_ptr<ARDOUR::Track>&, bool add_channel_suffix);
1190         int finish_bringing_in_material (boost::shared_ptr<ARDOUR::Region> region, uint32_t, uint32_t,  framepos_t& pos, Editing::ImportMode mode,
1191                                       boost::shared_ptr<ARDOUR::Track>& existing_track);
1192
1193         boost::shared_ptr<ARDOUR::AudioTrack> get_nth_selected_audio_track (int nth) const;
1194         boost::shared_ptr<ARDOUR::MidiTrack> get_nth_selected_midi_track (int nth) const;
1195
1196         ARDOUR::InterThreadInfo* current_interthread_info;
1197
1198         AnalysisWindow* analysis_window;
1199
1200         /* import specific info */
1201
1202         struct EditorImportStatus : public ARDOUR::ImportStatus {
1203             Editing::ImportMode mode;
1204             framepos_t pos;
1205             int target_tracks;
1206             int target_regions;
1207             boost::shared_ptr<ARDOUR::Track> track;
1208             bool replace;
1209         };
1210
1211         EditorImportStatus import_status;
1212         static void *_import_thread (void *);
1213         void* import_thread ();
1214         void finish_import ();
1215
1216         /* to support this ... */
1217
1218         void import_audio (bool as_tracks);
1219         void do_import (std::vector<std::string> paths, bool split, bool as_tracks);
1220
1221         void move_to_start ();
1222         void move_to_end ();
1223         void goto_frame ();
1224         void center_playhead ();
1225         void center_edit_point ();
1226         void edit_cursor_backward ();
1227         void edit_cursor_forward ();
1228         void playhead_forward_to_grid ();
1229         void playhead_backward_to_grid ();
1230         void playhead_backward ();
1231         void playhead_forward ();
1232         void scroll_playhead (bool forward);
1233         void scroll_backward (float pages=0.8f);
1234         void scroll_forward (float pages=0.8f);
1235         void scroll_tracks_down ();
1236         void scroll_tracks_up ();
1237         void delete_sample_forward ();
1238         void delete_sample_backward ();
1239         void delete_screen ();
1240         void search_backwards ();
1241         void search_forwards ();
1242         void set_mark ();
1243         void clear_markers ();
1244         void clear_ranges ();
1245         void clear_locations ();
1246         void unhide_markers ();
1247         void unhide_ranges ();
1248         void jump_forward_to_mark ();
1249         void jump_backward_to_mark ();
1250         void cursor_align (bool playhead_to_edit);
1251
1252         void remove_last_capture ();
1253         void select_all_selectables_using_time_selection ();
1254         void select_all_selectables_using_loop();
1255         void select_all_selectables_using_punch();
1256         void set_selection_from_range (ARDOUR::Location&);
1257         void set_selection_from_punch ();
1258         void set_selection_from_loop ();
1259         void set_selection_from_region ();
1260
1261         void add_location_mark (framepos_t where);
1262         void add_location_from_region ();
1263         void add_locations_from_region ();
1264         void add_location_from_selection ();
1265         void set_loop_from_selection (bool play);
1266         void set_punch_from_selection ();
1267         void set_punch_from_region ();
1268
1269         void set_loop_from_edit_range (bool play);
1270         void set_loop_from_region (bool play);
1271         void set_punch_from_edit_range ();
1272
1273         void set_loop_range (framepos_t start, framepos_t end, std::string cmd);
1274         void set_punch_range (framepos_t start, framepos_t end, std::string cmd);
1275
1276         void add_location_from_playhead_cursor ();
1277         bool select_new_marker;
1278
1279         void reverse_selection ();
1280         void edit_envelope ();
1281
1282         double last_scrub_x;
1283         int scrubbing_direction;
1284         int scrub_reversals;
1285         int scrub_reverse_distance;
1286         void scrub (framepos_t, double);
1287
1288         void keyboard_selection_begin ();
1289         void keyboard_selection_finish (bool add);
1290         bool have_pending_keyboard_selection;
1291         framepos_t pending_keyboard_selection_start;
1292
1293         boost::shared_ptr<ARDOUR::Region> select_region_for_operation (int dir, TimeAxisView **tv);
1294         void extend_selection_to_end_of_region (bool next);
1295         void extend_selection_to_start_of_region (bool previous);
1296
1297         Editing::SnapType _snap_type;
1298         Editing::SnapMode _snap_mode;
1299
1300         /// Snap threshold in pixels
1301         double snap_threshold;
1302
1303         bool ignore_gui_changes;
1304
1305         DragManager* _drags;
1306
1307         void escape ();
1308
1309         Gtk::Menu fade_context_menu;
1310         void popup_fade_context_menu (int, int, ArdourCanvas::Item*, ItemType);
1311
1312         void set_fade_in_shape (ARDOUR::FadeShape);
1313         void set_fade_out_shape (ARDOUR::FadeShape);
1314
1315         void set_fade_length (bool in);
1316         void set_fade_in_active (bool);
1317         void set_fade_out_active (bool);
1318
1319         std::set<boost::shared_ptr<ARDOUR::Playlist> > motion_frozen_playlists;
1320
1321         bool _dragging_playhead;
1322         bool _dragging_edit_point;
1323
1324         void marker_drag_motion_callback (GdkEvent*);
1325         void marker_drag_finished_callback (GdkEvent*);
1326
1327         gint mouse_rename_region (ArdourCanvas::Item*, GdkEvent*);
1328
1329         void add_region_drag (ArdourCanvas::Item*, GdkEvent*, RegionView*);
1330         void start_create_region_grab (ArdourCanvas::Item*, GdkEvent*);
1331         void add_region_copy_drag (ArdourCanvas::Item*, GdkEvent*, RegionView*);
1332         void add_region_brush_drag (ArdourCanvas::Item*, GdkEvent*, RegionView*);
1333         void start_selection_grab (ArdourCanvas::Item*, GdkEvent*);
1334
1335         void region_view_item_click (AudioRegionView&, GdkEventButton*);
1336
1337         void remove_gain_control_point (ArdourCanvas::Item*, GdkEvent*);
1338         void remove_control_point (ArdourCanvas::Item*, GdkEvent*);
1339
1340         void mouse_brush_insert_region (RegionView*, framepos_t pos);
1341         void brush (framepos_t);
1342
1343         void show_verbose_time_cursor (framepos_t frame, double offset = 0, double xpos=-1, double ypos=-1);
1344         void show_verbose_duration_cursor (framepos_t start, framepos_t end, double offset = 0, double xpos=-1, double ypos=-1);
1345         double clamp_verbose_cursor_x (double);
1346         double clamp_verbose_cursor_y (double);
1347
1348         /* Canvas event handlers */
1349
1350         bool canvas_control_point_event (GdkEvent* event,ArdourCanvas::Item*, ControlPoint*);
1351         bool canvas_line_event (GdkEvent* event,ArdourCanvas::Item*, AutomationLine*);
1352         bool canvas_selection_rect_event (GdkEvent* event,ArdourCanvas::Item*, SelectionRect*);
1353         bool canvas_selection_start_trim_event (GdkEvent* event,ArdourCanvas::Item*, SelectionRect*);
1354         bool canvas_selection_end_trim_event (GdkEvent* event,ArdourCanvas::Item*, SelectionRect*);
1355         bool canvas_crossfade_view_event (GdkEvent* event,ArdourCanvas::Item*, CrossfadeView*);
1356         bool canvas_fade_in_event (GdkEvent* event,ArdourCanvas::Item*, AudioRegionView*);
1357         bool canvas_fade_in_handle_event (GdkEvent* event,ArdourCanvas::Item*, AudioRegionView*);
1358         bool canvas_fade_out_event (GdkEvent* event,ArdourCanvas::Item*, AudioRegionView*);
1359         bool canvas_fade_out_handle_event (GdkEvent* event,ArdourCanvas::Item*, AudioRegionView*);
1360         bool canvas_region_view_event (GdkEvent* event,ArdourCanvas::Item*, RegionView*);
1361         bool canvas_frame_handle_event (GdkEvent* event,ArdourCanvas::Item*, RegionView*);
1362         bool canvas_region_view_name_highlight_event (GdkEvent* event,ArdourCanvas::Item*, RegionView*);
1363         bool canvas_region_view_name_event (GdkEvent* event,ArdourCanvas::Item*, RegionView*);
1364         bool canvas_feature_line_event (GdkEvent* event, ArdourCanvas::Item*, RegionView*);
1365         bool canvas_stream_view_event (GdkEvent* event,ArdourCanvas::Item*, RouteTimeAxisView*);
1366         bool canvas_marker_event (GdkEvent* event,ArdourCanvas::Item*, Marker*);
1367         bool canvas_zoom_rect_event (GdkEvent* event,ArdourCanvas::Item*);
1368         bool canvas_tempo_marker_event (GdkEvent* event,ArdourCanvas::Item*, TempoMarker*);
1369         bool canvas_meter_marker_event (GdkEvent* event,ArdourCanvas::Item*, MeterMarker*);
1370         bool canvas_automation_track_event(GdkEvent* event, ArdourCanvas::Item*, AutomationTimeAxisView*) ;
1371         bool canvas_note_event (GdkEvent* event, ArdourCanvas::Item*);
1372
1373         bool canvas_tempo_bar_event (GdkEvent* event, ArdourCanvas::Item*);
1374         bool canvas_meter_bar_event (GdkEvent* event, ArdourCanvas::Item*);
1375         bool canvas_marker_bar_event (GdkEvent* event, ArdourCanvas::Item*);
1376         bool canvas_range_marker_bar_event (GdkEvent* event, ArdourCanvas::Item*);
1377         bool canvas_transport_marker_bar_event (GdkEvent* event, ArdourCanvas::Item*);
1378         bool canvas_cd_marker_bar_event (GdkEvent* event, ArdourCanvas::Item*);
1379
1380         bool canvas_imageframe_item_view_event(GdkEvent* event, ArdourCanvas::Item*,ImageFrameView*);
1381         bool canvas_imageframe_view_event(GdkEvent* event, ArdourCanvas::Item*,ImageFrameTimeAxis*);
1382         bool canvas_imageframe_start_handle_event(GdkEvent* event, ArdourCanvas::Item*,ImageFrameView*);
1383         bool canvas_imageframe_end_handle_event(GdkEvent* event, ArdourCanvas::Item*,ImageFrameView*);
1384         bool canvas_marker_time_axis_view_event(GdkEvent* event, ArdourCanvas::Item*,MarkerTimeAxis*);
1385         bool canvas_markerview_item_view_event(GdkEvent* event, ArdourCanvas::Item*,MarkerView*);
1386         bool canvas_markerview_start_handle_event(GdkEvent* event, ArdourCanvas::Item*,MarkerView*);
1387         bool canvas_markerview_end_handle_event(GdkEvent* event, ArdourCanvas::Item*,MarkerView*);
1388         
1389         PBD::Signal0<void> EditorFreeze;
1390         PBD::Signal0<void> EditorThaw;
1391
1392   private:
1393         friend class DragManager;
1394         friend class EditorRouteGroups;
1395         friend class EditorRegions;
1396
1397         ArdourCanvas::Item *last_item_entered;
1398         /** true if the mouse is over a place where region trim can happen */
1399         bool _over_region_trim_target;
1400
1401         /* non-public event handlers */
1402
1403         bool canvas_playhead_cursor_event (GdkEvent* event, ArdourCanvas::Item*);
1404         bool track_canvas_scroll (GdkEventScroll* event);
1405
1406         bool track_canvas_scroll_event (GdkEventScroll* event);
1407         bool track_canvas_button_press_event (GdkEventButton* event);
1408         bool track_canvas_button_release_event (GdkEventButton* event);
1409         bool track_canvas_motion_notify_event (GdkEventMotion* event);
1410
1411         Gtk::Allocation canvas_allocation;
1412         void track_canvas_allocate (Gtk::Allocation alloc);
1413         bool track_canvas_size_allocated ();
1414         bool track_canvas_drag_motion (Glib::RefPtr<Gdk::DragContext> const &, int, int, guint);
1415         bool track_canvas_key_press (GdkEventKey *);
1416         bool track_canvas_key_release (GdkEventKey *);
1417
1418         void set_playhead_cursor ();
1419
1420         void kbd_driver (sigc::slot<void,GdkEvent*>, bool use_track_canvas = true, bool use_time_canvas = true, bool can_select = true);
1421         void toggle_region_mute ();
1422         void kbd_brush ();
1423
1424         void kbd_do_brush (GdkEvent*);
1425         void kbd_do_audition (GdkEvent*);
1426
1427         void initialize_canvas ();
1428
1429         /* display control */
1430
1431         bool _show_measures;
1432         /// true if the editor should follow the playhead, otherwise false
1433         bool _follow_playhead;
1434         /// true if we scroll the tracks rather than the playhead
1435         bool _stationary_playhead;
1436
1437         ARDOUR::TempoMap::BBTPointList *current_bbt_points;
1438
1439         TempoLines* tempo_lines;
1440
1441         ArdourCanvas::Group* time_line_group;
1442
1443         void hide_measures ();
1444         void draw_measures ();
1445         bool redraw_measures ();
1446
1447         void new_tempo_section ();
1448
1449         void mouse_add_new_tempo_event (framepos_t where);
1450         void mouse_add_new_meter_event (framepos_t where);
1451
1452         void remove_tempo_marker (ArdourCanvas::Item*);
1453         void remove_meter_marker (ArdourCanvas::Item*);
1454         gint real_remove_tempo_marker (ARDOUR::TempoSection*);
1455         gint real_remove_meter_marker (ARDOUR::MeterSection*);
1456
1457         void edit_tempo_section (ARDOUR::TempoSection*);
1458         void edit_meter_section (ARDOUR::MeterSection*);
1459         void edit_tempo_marker (ArdourCanvas::Item*);
1460         void edit_meter_marker (ArdourCanvas::Item*);
1461         void edit_control_point (ArdourCanvas::Item*);
1462         void edit_note (ArdourCanvas::Item *);
1463
1464         void marker_menu_edit ();
1465         void marker_menu_remove ();
1466         void marker_menu_rename ();
1467         void toggle_marker_menu_lock ();
1468         void toggle_marker_menu_glue ();
1469         void marker_menu_hide ();
1470         void marker_menu_loop_range ();
1471         void marker_menu_select_all_selectables_using_range ();
1472         void marker_menu_select_using_range ();
1473         void marker_menu_separate_regions_using_location ();
1474         void marker_menu_play_from ();
1475         void marker_menu_play_range ();
1476         void marker_menu_set_playhead ();
1477         void marker_menu_set_from_playhead ();
1478         void marker_menu_set_from_selection ();
1479         void marker_menu_range_to_next ();
1480         void new_transport_marker_menu_set_loop ();
1481         void new_transport_marker_menu_set_punch ();
1482         void update_loop_range_view (bool visibility=false);
1483         void update_punch_range_view (bool visibility=false);
1484         void new_transport_marker_menu_popdown ();
1485         void marker_context_menu (GdkEventButton*, ArdourCanvas::Item*);
1486         void tempo_or_meter_marker_context_menu (GdkEventButton*, ArdourCanvas::Item*);
1487         void transport_marker_context_menu (GdkEventButton*, ArdourCanvas::Item*);
1488         void new_transport_marker_context_menu (GdkEventButton*, ArdourCanvas::Item*);
1489         void build_range_marker_menu (bool);
1490         void build_marker_menu (ARDOUR::Location *);
1491         void build_tempo_or_meter_marker_menu (bool);
1492         void build_new_transport_marker_menu ();
1493         void dynamic_cast_marker_object (void*, MeterMarker**, TempoMarker**) const;
1494
1495         Gtk::Menu* tempo_or_meter_marker_menu;
1496         Gtk::Menu* marker_menu;
1497         Gtk::Menu* range_marker_menu;
1498         Gtk::Menu* transport_marker_menu;
1499         Gtk::Menu* new_transport_marker_menu;
1500         Gtk::Menu* cd_marker_menu;
1501         ArdourCanvas::Item* marker_menu_item;
1502
1503         typedef std::list<Marker*> Marks;
1504         Marks metric_marks;
1505
1506         void remove_metric_marks ();
1507         void draw_metric_marks (const ARDOUR::Metrics& metrics);
1508
1509         void compute_current_bbt_points (framepos_t left, framepos_t right);
1510         void tempo_map_changed (const PBD::PropertyChange&);
1511         void redisplay_tempo (bool immediate_redraw);
1512
1513         uint32_t bbt_beat_subdivision;
1514
1515         /* toolbar */
1516
1517         Gtk::ToggleButton editor_mixer_button;
1518         Gtk::ToggleButton editor_list_button;
1519         void editor_mixer_button_toggled ();
1520         void editor_list_button_toggled ();
1521
1522         AudioClock               zoom_range_clock;
1523         Gtk::Button              zoom_in_button;
1524         Gtk::Button              zoom_out_button;
1525         Gtk::Button              zoom_out_full_button;
1526         Gtk::Button              zoom_onetoone_button;
1527
1528         Gtk::Button              tav_expand_button;
1529         Gtk::Button              tav_shrink_button;
1530
1531         Gtk::VBox                toolbar_clock_vbox;
1532         Gtk::VBox                toolbar_selection_clock_vbox;
1533         Gtk::Table               toolbar_selection_clock_table;
1534         Gtk::Label               toolbar_selection_cursor_label;
1535
1536         Gtkmm2ext::TearOff*      _mouse_mode_tearoff;
1537         Gtkmm2ext::StatefulToggleButton mouse_select_button;
1538         Gtkmm2ext::StatefulToggleButton mouse_move_button;
1539         Gtkmm2ext::StatefulToggleButton mouse_gain_button;
1540         Gtkmm2ext::StatefulToggleButton mouse_zoom_button;
1541         Gtkmm2ext::StatefulToggleButton mouse_timefx_button;
1542         Gtkmm2ext::StatefulToggleButton mouse_audition_button;
1543         Gtkmm2ext::StatefulToggleButton join_object_range_button;
1544
1545         void                     mouse_mode_toggled (Editing::MouseMode m);
1546         void                     mouse_mode_object_range_toggled () {}
1547         bool                     ignore_mouse_mode_toggle;
1548
1549         Gtkmm2ext::StatefulToggleButton internal_edit_button;
1550         void                     toggle_internal_editing ();
1551
1552         gint                     mouse_select_button_release (GdkEventButton*);
1553
1554         Gtk::VBox                automation_box;
1555         Gtk::Button              automation_mode_button;
1556         Gtk::ToggleButton        global_automation_button;
1557
1558         Gtk::ComboBoxText edit_mode_selector;
1559         Gtk::VBox         edit_mode_box;
1560         std::vector<std::string> edit_mode_strings;
1561
1562         void set_edit_mode (ARDOUR::EditMode);
1563         void cycle_edit_mode ();
1564         void edit_mode_selection_done ();
1565
1566         Gtk::ComboBoxText snap_type_selector;
1567         Gtk::ComboBoxText snap_mode_selector;
1568         Gtk::HBox         snap_box;
1569
1570         std::vector<std::string> snap_type_strings;
1571         std::vector<std::string> snap_mode_strings;
1572
1573         void snap_type_selection_done ();
1574         void snap_mode_selection_done ();
1575         void snap_mode_chosen (Editing::SnapMode);
1576         void snap_type_chosen (Editing::SnapType);
1577
1578         Glib::RefPtr<Gtk::RadioAction> snap_type_action (Editing::SnapType);
1579         Glib::RefPtr<Gtk::RadioAction> snap_mode_action (Editing::SnapMode);
1580
1581         Gtk::ComboBoxText zoom_focus_selector;
1582         Gtk::VBox         zoom_focus_box;
1583
1584         std::vector<std::string> zoom_focus_strings;
1585
1586         void zoom_focus_selection_done ();
1587         void zoom_focus_chosen (Editing::ZoomFocus);
1588
1589         Glib::RefPtr<Gtk::RadioAction> zoom_focus_action (Editing::ZoomFocus);
1590
1591         Gtk::HBox           _zoom_box;
1592         Gtkmm2ext::TearOff* _zoom_tearoff;
1593         void                zoom_adjustment_changed();
1594
1595         void setup_toolbar ();
1596
1597         void setup_tooltips ();
1598
1599         Gtkmm2ext::TearOff*     _tools_tearoff;
1600         Gtk::HBox                toolbar_hbox;
1601         Gtk::EventBox            toolbar_base;
1602         Gtk::Frame               toolbar_frame;
1603         Gtk::Viewport           _toolbar_viewport;
1604         
1605         /* midi toolbar */
1606
1607         Gtk::HBox                panic_box;
1608         Gtk::Button              midi_panic_button;
1609         Gtk::ToggleButton        midi_sound_notes;
1610         void                     midi_panic ();
1611         bool                     sound_notes () const { return midi_sound_notes.get_active(); }
1612
1613         void setup_midi_toolbar ();
1614
1615         /* selection process */
1616
1617         Selection* selection;
1618         Selection* cut_buffer;
1619
1620         void time_selection_changed ();
1621         void track_selection_changed ();
1622         void region_selection_changed ();
1623         sigc::connection editor_regions_selection_changed_connection;
1624         void sensitize_all_region_actions (bool);
1625         void sensitize_the_right_region_actions ();
1626         bool _all_region_actions_sensitized;
1627         /** Flag to block region action handlers from doing what they normally do;
1628          *  I tried Gtk::Action::block_activate() but this doesn't work (ie it doesn't
1629          *  block) when setting a ToggleAction's active state.
1630          */
1631         bool _ignore_region_action;
1632         bool _last_region_menu_was_main;
1633         void point_selection_changed ();
1634         void marker_selection_changed ();
1635
1636         void cancel_selection ();
1637
1638         bool audio_region_selection_covers (framepos_t where);
1639
1640         /* transport range select process */
1641
1642         ArdourCanvas::SimpleRect*  cd_marker_bar_drag_rect;
1643         ArdourCanvas::SimpleRect*  range_bar_drag_rect;
1644         ArdourCanvas::SimpleRect*  transport_bar_drag_rect;
1645
1646 #ifdef GTKOSX
1647         ArdourCanvas::SimpleRect     *bogus_background_rect;
1648 #endif
1649         ArdourCanvas::SimpleRect     *transport_bar_range_rect;
1650         ArdourCanvas::SimpleRect     *transport_bar_preroll_rect;
1651         ArdourCanvas::SimpleRect     *transport_bar_postroll_rect;
1652         ArdourCanvas::SimpleRect     *transport_loop_range_rect;
1653         ArdourCanvas::SimpleRect     *transport_punch_range_rect;
1654         ArdourCanvas::SimpleLine     *transport_punchin_line;
1655         ArdourCanvas::SimpleLine     *transport_punchout_line;
1656         ArdourCanvas::SimpleRect     *transport_preroll_rect;
1657         ArdourCanvas::SimpleRect     *transport_postroll_rect;
1658
1659         ARDOUR::Location*  transport_loop_location();
1660         ARDOUR::Location*  transport_punch_location();
1661
1662         ARDOUR::Location   *temp_location;
1663
1664         /* object rubberband select process */
1665
1666         void select_all_within (framepos_t, framepos_t, double, double, TrackViewList const &, Selection::Operation, bool);
1667
1668         ArdourCanvas::SimpleRect   *rubberband_rect;
1669
1670         /* mouse zoom process */
1671
1672         ArdourCanvas::SimpleRect   *zoom_rect;
1673         void reposition_zoom_rect (framepos_t start, framepos_t end);
1674
1675         EditorRouteGroups* _route_groups;
1676         EditorRoutes* _routes;
1677         EditorRegions* _regions;
1678         EditorSnapshots* _snapshots;
1679         EditorLocations* _locations;
1680
1681         /* diskstream/route display management */
1682         Glib::RefPtr<Gdk::Pixbuf> rec_enabled_icon;
1683         Glib::RefPtr<Gdk::Pixbuf> rec_disabled_icon;
1684
1685         Glib::RefPtr<Gtk::TreeSelection> route_display_selection;
1686
1687         bool sync_track_view_list_and_routes ();
1688
1689         Gtk::VBox           list_vpacker;
1690
1691         /* autoscrolling */
1692
1693         bool autoscroll_active;
1694         int autoscroll_timeout_tag;
1695         int autoscroll_x;
1696         int autoscroll_y;
1697         int last_autoscroll_x;
1698         int last_autoscroll_y;
1699         uint32_t autoscroll_cnt;
1700         framecnt_t autoscroll_x_distance;
1701         double autoscroll_y_distance;
1702
1703         static gint _autoscroll_canvas (void *);
1704         bool autoscroll_canvas ();
1705         void start_canvas_autoscroll (int x, int y);
1706         void stop_canvas_autoscroll ();
1707
1708         /* trimming */
1709         void point_trim (GdkEvent *, framepos_t);
1710
1711         void trim_region_front();
1712         void trim_region_back();
1713         void trim_region (bool front);
1714
1715         void trim_region_to_loop ();
1716         void trim_region_to_punch ();
1717         void trim_region_to_location (const ARDOUR::Location&, const char* cmd);
1718
1719         void trim_to_region(bool forward);
1720         void trim_region_to_previous_region_end();
1721         void trim_region_to_next_region_start();
1722
1723         bool show_gain_after_trim;
1724
1725         /* Drag-n-Drop */
1726
1727         int convert_drop_to_paths (
1728                 std::vector<std::string>&           paths,
1729                 const Glib::RefPtr<Gdk::DragContext>& context,
1730                 gint                                  x,
1731                 gint                                  y,
1732                 const Gtk::SelectionData&             data,
1733                 guint                                 info,
1734                 guint                                 time);
1735         
1736         void track_canvas_drag_data_received (
1737                 const Glib::RefPtr<Gdk::DragContext>& context,
1738                 gint                                  x,
1739                 gint                                  y,
1740                 const Gtk::SelectionData&             data,
1741                 guint                                 info,
1742                 guint                                 time);
1743         
1744         void drop_paths (
1745                 const Glib::RefPtr<Gdk::DragContext>& context,
1746                 gint                                  x,
1747                 gint                                  y,
1748                 const Gtk::SelectionData&             data,
1749                 guint                                 info,
1750                 guint                                 time);
1751         
1752         void drop_regions (
1753                 const Glib::RefPtr<Gdk::DragContext>& context,
1754                 gint                                  x,
1755                 gint                                  y,
1756                 const Gtk::SelectionData&             data,
1757                 guint                                 info,
1758                 guint                                 time);
1759         
1760         void drop_routes (
1761                 const Glib::RefPtr<Gdk::DragContext>& context,
1762                 gint                x,
1763                 gint                y,
1764                 const Gtk::SelectionData& data,
1765                 guint               info,
1766                 guint               time);
1767         
1768         /* audio export */
1769
1770         int  write_region_selection(RegionSelection&);
1771         bool write_region (std::string path, boost::shared_ptr<ARDOUR::AudioRegion>);
1772         void bounce_region_selection ();
1773         void bounce_range_selection (bool replace, bool enable_processing);
1774         void external_edit_region ();
1775
1776         int write_audio_selection (TimeSelection&);
1777         bool write_audio_range (ARDOUR::AudioPlaylist&, const ARDOUR::ChanCount& channels, std::list<ARDOUR::AudioRange>&);
1778
1779         void write_selection ();
1780
1781         XMLNode *before; /* used in *_reversible_command */
1782
1783         void update_title ();
1784         void update_title_s (const std::string & snapshot_name);
1785
1786         struct State {
1787             Selection* selection;
1788             double frames_per_unit;
1789
1790             State (PublicEditor const * e);
1791             ~State ();
1792         };
1793
1794         void instant_save ();
1795
1796         boost::shared_ptr<ARDOUR::AudioRegion> last_audition_region;
1797
1798         /* freeze operations */
1799
1800         ARDOUR::InterThreadInfo freeze_status;
1801         static void* _freeze_thread (void*);
1802         void* freeze_thread ();
1803
1804         void freeze_route ();
1805         void unfreeze_route ();
1806
1807         /* duplication */
1808
1809         void duplicate_dialog (bool with_dialog);
1810
1811         framepos_t event_frame (GdkEvent const *, double* px = 0, double* py = 0) const;
1812
1813         /* returns false if mouse pointer is not in track or marker canvas
1814          */
1815         bool mouse_frame (framepos_t&, bool& in_track_canvas) const;
1816
1817         /* "whats mine is yours" */
1818
1819         TimeFXDialog* current_timefx;
1820
1821         static void* timefx_thread (void *arg);
1822         void do_timefx (TimeFXDialog&);
1823
1824         int time_stretch (RegionSelection&, float fraction);
1825         int pitch_shift (RegionSelection&, float cents);
1826         void pitch_shift_region ();
1827         int time_fx (RegionSelection&, float val, bool pitching);
1828
1829         /* editor-mixer strip */
1830
1831         MixerStrip *current_mixer_strip;
1832         bool show_editor_mixer_when_tracks_arrive;
1833         Gtk::VBox current_mixer_strip_vbox;
1834         void cms_new (boost::shared_ptr<ARDOUR::Route>);
1835         void current_mixer_strip_hidden ();
1836
1837         void detach_tearoff (Gtk::Box* b, Gtk::Window* w);
1838         void reattach_tearoff (Gtk::Box* b, Gtk::Window* w, int32_t n);
1839 #ifdef GTKOSX
1840         void ensure_all_elements_drawn ();
1841 #endif
1842         /* nudging tracks */
1843
1844         void nudge_track (bool use_edit_point, bool forwards);
1845
1846         /* xfades */
1847
1848         bool _xfade_visibility;
1849
1850 #ifdef WITH_CMT
1851         void handle_new_imageframe_time_axis_view(const std::string & track_name, void* src) ;
1852         void handle_new_imageframe_marker_time_axis_view(const std::string & track_name, TimeAxisView* marked_track) ;
1853
1854         void start_imageframe_grab(ArdourCanvas::Item*, GdkEvent*) ;
1855         void start_markerview_grab(ArdourCanvas::Item*, GdkEvent*) ;
1856
1857         void imageframe_drag_motion_callback(ArdourCanvas::Item*, GdkEvent*) ;
1858         void markerview_drag_motion_callback(ArdourCanvas::Item*, GdkEvent*) ;
1859         void timeaxis_item_drag_finished_callback(ArdourCanvas::Item*, GdkEvent*) ;
1860
1861         gint canvas_imageframe_item_view_event(ArdourCanvas::Item* item, GdkEvent* event, ImageFrameView* ifv);
1862         gint canvas_imageframe_view_event(ArdourCanvas::Item* item, GdkEvent* event, ImageFrameTimeAxis* ifta);
1863         gint canvas_imageframe_start_handle_event(ArdourCanvas::Item* item, GdkEvent* event, ImageFrameView* ifv);
1864         gint canvas_imageframe_end_handle_event(ArdourCanvas::Item* item, GdkEvent* event, ImageFrameView* ifv);
1865
1866         gint canvas_marker_time_axis_view_event(ArdourCanvas::Item* item, GdkEvent* event, MarkerTimeAxis* mta);
1867         gint canvas_markerview_item_view_event(ArdourCanvas::Item* item, GdkEvent* event, MarkerView* mv);
1868         gint canvas_markerview_start_handle_event(ArdourCanvas::Item* item, GdkEvent* event, MarkerView* mv);
1869         gint canvas_markerview_end_handle_event(ArdourCanvas::Item* item, GdkEvent* event, MarkerView* mv);
1870
1871         void imageframe_start_handle_op(ArdourCanvas::Item* item, GdkEvent* event) ;
1872         void imageframe_end_handle_op(ArdourCanvas::Item* item, GdkEvent* event) ;
1873         void imageframe_start_handle_trim_motion(ArdourCanvas::Item* item, GdkEvent* event) ;
1874         void imageframe_start_handle_end_trim(ArdourCanvas::Item* item, GdkEvent* event) ;
1875         void imageframe_end_handle_trim_motion(ArdourCanvas::Item* item, GdkEvent* event) ;
1876         void imageframe_end_handle_end_trim(ArdourCanvas::Item* item, GdkEvent* event) ;
1877
1878         void markerview_item_start_handle_op(ArdourCanvas::Item* item, GdkEvent* event) ;
1879         void markerview_item_end_handle_op(ArdourCanvas::Item* item, GdkEvent* event) ;
1880         void markerview_start_handle_trim_motion(ArdourCanvas::Item* item, GdkEvent* event) ;
1881         void markerview_start_handle_end_trim(ArdourCanvas::Item* item, GdkEvent* event) ;
1882         void markerview_end_handle_trim_motion(ArdourCanvas::Item* item, GdkEvent* event) ;
1883         void markerview_end_handle_end_trim(ArdourCanvas::Item* item, GdkEvent* event) ;
1884
1885         void popup_imageframe_edit_menu(int button, int32_t time, ArdourCanvas::Item* ifv, bool with_frame) ;
1886         void popup_marker_time_axis_edit_menu(int button, int32_t time, ArdourCanvas::Item* ifv, bool with_frame) ;
1887
1888         ImageFrameSocketHandler* image_socket_listener ;
1889 #endif
1890
1891         void toggle_xfade_active (boost::weak_ptr<ARDOUR::Crossfade>);
1892         void toggle_xfade_length (boost::weak_ptr<ARDOUR::Crossfade>);
1893         void edit_xfade (boost::weak_ptr<ARDOUR::Crossfade>);
1894         void xfade_edit_left_region ();
1895         void xfade_edit_right_region ();
1896
1897         static const int32_t default_width = 995;
1898         static const int32_t default_height = 765;
1899
1900         /* nudge */
1901
1902         Gtk::Button      nudge_forward_button;
1903         Gtk::Button      nudge_backward_button;
1904         Gtk::HBox        nudge_hbox;
1905         Gtk::VBox        nudge_vbox;
1906         AudioClock       nudge_clock;
1907
1908         bool nudge_forward_release (GdkEventButton*);
1909         bool nudge_backward_release (GdkEventButton*);
1910
1911         /* audio filters */
1912
1913         void apply_filter (ARDOUR::Filter&, std::string cmd, ProgressReporter* progress = 0);
1914
1915         Command* apply_midi_note_edit_op_to_region (ARDOUR::MidiOperator& op, MidiRegionView& mrv);
1916         void apply_midi_note_edit_op (ARDOUR::MidiOperator& op);
1917
1918         /* handling cleanup */
1919
1920         int playlist_deletion_dialog (boost::shared_ptr<ARDOUR::Playlist>);
1921
1922         PBD::ScopedConnectionList session_connections;
1923
1924         /* tracking step changes of track height */
1925
1926         TimeAxisView* current_stepping_trackview;
1927         ARDOUR::microseconds_t last_track_height_step_timestamp;
1928         gint track_height_step_timeout();
1929         sigc::connection step_timeout;
1930
1931         TimeAxisView* entered_track;
1932         /** If the mouse is over a RegionView or one of its child canvas items, this is set up
1933             to point to the RegionView.  Otherwise it is 0.
1934         */
1935         RegionView*   entered_regionview;
1936
1937
1938         void ensure_entered_track_selected (bool op_acts_on_objects = false);
1939         bool clear_entered_track;
1940         bool left_track_canvas (GdkEventCrossing*);
1941         bool entered_track_canvas (GdkEventCrossing*);
1942         void set_entered_track (TimeAxisView*);
1943         void set_entered_regionview (RegionView*);
1944         void ensure_track_visible (TimeAxisView*);
1945         gint left_automation_track ();
1946
1947         void reset_canvas_action_sensitivity (bool);
1948         void toggle_gain_envelope_visibility ();
1949         void toggle_gain_envelope_active ();
1950         void reset_region_gain_envelopes ();
1951
1952         bool on_key_press_event (GdkEventKey*);
1953         bool on_key_release_event (GdkEventKey*);
1954
1955         void session_state_saved (std::string);
1956
1957         Glib::RefPtr<Gtk::Action>              undo_action;
1958         Glib::RefPtr<Gtk::Action>              redo_action;
1959
1960         void history_changed ();
1961
1962         Gtk::HBox      status_bar_hpacker;
1963
1964         Editing::EditPoint _edit_point;
1965
1966         Gtk::ComboBoxText edit_point_selector;
1967
1968         void set_edit_point_preference (Editing::EditPoint ep, bool force = false);
1969         void cycle_edit_point (bool with_marker);
1970         void set_edit_point ();
1971         void edit_point_selection_done ();
1972         void edit_point_chosen (Editing::EditPoint);
1973         Glib::RefPtr<Gtk::RadioAction> edit_point_action (Editing::EditPoint);
1974         std::vector<std::string> edit_point_strings;
1975
1976         void selected_marker_moved (ARDOUR::Location*);
1977
1978         bool get_edit_op_range (framepos_t& start, framepos_t& end) const;
1979
1980         void get_regions_at (RegionSelection&, framepos_t where, const TrackViewList& ts) const;
1981         void get_regions_after (RegionSelection&, framepos_t where, const TrackViewList& ts) const;
1982
1983         RegionSelection get_regions_from_selection ();
1984         RegionSelection get_regions_from_selection_and_edit_point ();
1985         RegionSelection get_regions_from_selection_and_entered ();
1986         
1987         void start_updating_meters ();
1988         void stop_updating_meters ();
1989         bool meters_running;
1990
1991         void select_next_route ();
1992         void select_prev_route ();
1993
1994         void snap_to_internal (framepos_t& first, int32_t direction = 0, bool for_mark = false);
1995         void timecode_snap_to_internal (framepos_t& first, int32_t direction = 0, bool for_mark = false);
1996
1997         RhythmFerret* rhythm_ferret;
1998         BundleManager* _bundle_manager;
1999
2000         void fit_tracks (TrackViewList &);
2001         void fit_selected_tracks ();
2002         void set_track_height (Height);
2003
2004         void remove_tracks ();
2005         void toggle_tracks_active ();
2006
2007         bool _have_idled;
2008         int resize_idle_id;
2009         static gboolean _idle_resize (gpointer);
2010         bool idle_resize();
2011         int32_t _pending_resize_amount;
2012         TimeAxisView* _pending_resize_view;
2013
2014         void visible_order_range (int*, int*) const;
2015
2016         void located ();
2017         
2018         /** true if we've made a locate request that hasn't yet been processed */
2019         bool _pending_locate_request;
2020         
2021         /** if true, there is a pending Session locate which is the initial one when loading a session;
2022             we need to know this so that we don't (necessarily) set the viewport to show the playhead
2023             initially.
2024         */
2025         bool _pending_initial_locate;
2026
2027         Gtk::HBox _summary_hbox;
2028         EditorSummary* _summary;
2029
2030         void region_view_added (RegionView *);
2031         void region_view_removed ();
2032
2033         void update_canvas_now ();
2034
2035         EditorGroupTabs* _group_tabs;
2036         void fit_route_group (ARDOUR::RouteGroup *);
2037
2038         void step_edit_status_change (bool);
2039         void start_step_editing ();
2040         void stop_step_editing ();
2041         bool check_step_edit ();
2042         sigc::connection step_edit_connection;
2043
2044         double _last_motion_y;
2045
2046         RegionLayeringOrderEditor* layering_order_editor;
2047         void update_region_layering_order_editor ();
2048
2049         /** Track that was the source for the last cut/copy operation.  Used as a place
2050             to paste things iff there is no selected track.
2051         */
2052         TimeAxisView* _last_cut_copy_source_track;
2053
2054         /** true if a change in Selection->regions should change the selection in the region list.
2055             See EditorRegions::selection_changed.
2056         */
2057         bool _region_selection_change_updates_region_list;
2058
2059         void setup_fade_images ();
2060         std::map<ARDOUR::FadeShape, Gtk::Image*> _fade_in_images;
2061         std::map<ARDOUR::FadeShape, Gtk::Image*> _fade_out_images;
2062
2063         Gtk::MenuItem& action_menu_item (std::string const &);
2064         void action_pre_activated (Glib::RefPtr<Gtk::Action> const &);
2065
2066         void set_canvas_cursor_for_region_view (double, RegionView *);
2067
2068         MouseCursors* _cursors;
2069
2070         void resize_text_widgets ();
2071         
2072         friend class Drag;
2073         friend class RegionDrag;
2074         friend class RegionMoveDrag;
2075         friend class RegionSpliceDrag;
2076         friend class TrimDrag;
2077         friend class MeterMarkerDrag;
2078         friend class TempoMarkerDrag;
2079         friend class CursorDrag;
2080         friend class FadeInDrag;
2081         friend class FadeOutDrag;
2082         friend class MarkerDrag;
2083         friend class RegionGainDrag;
2084         friend class ControlPointDrag;
2085         friend class LineDrag;
2086         friend class RubberbandSelectDrag;
2087         friend class TimeFXDrag;
2088         friend class ScrubDrag;
2089         friend class SelectionDrag;
2090         friend class RangeMarkerBarDrag;
2091         friend class MouseZoomDrag;
2092         friend class RegionCreateDrag;
2093         friend class RegionMotionDrag;
2094         friend class RegionInsertDrag;
2095
2096         friend class EditorSummary;
2097         friend class EditorGroupTabs;
2098
2099         friend class EditorRoutes;
2100         friend class RhythmFerret;
2101 };
2102
2103 #endif /* __ardour_editor_h__ */