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