2 Copyright (C) 2000-2003 Paul Davis
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.
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.
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.
20 #ifndef __ardour_editor_h__
21 #define __ardour_editor_h__
32 #include <boost/optional.hpp>
34 #include <gtkmm/comboboxtext.h>
35 #include <gtkmm/layout.h>
37 #include "gtkmm2ext/bindings.h"
38 #include "gtkmm2ext/click_box.h"
39 #include "gtkmm2ext/dndtreeview.h"
40 #include "gtkmm2ext/pane.h"
41 #include "gtkmm2ext/selector.h"
42 #include "gtkmm2ext/stateful_button.h"
44 #include "pbd/stateful.h"
45 #include "pbd/signals.h"
47 #include "ardour/import_status.h"
48 #include "ardour/tempo.h"
49 #include "ardour/location.h"
50 #include "ardour/types.h"
52 #include "canvas/fwd.h"
53 #include "canvas/ruler.h"
55 #include "ardour_button.h"
56 #include "ardour_dialog.h"
57 #include "ardour_dropdown.h"
58 #include "public_editor.h"
61 #include "editor_items.h"
62 #include "region_selection.h"
63 #include "selection_memento.h"
64 #include "tempo_curve.h"
98 class AudioRegionView;
99 class AudioStreamView;
100 class AudioTimeAxisView;
101 class AutomationLine;
102 class AutomationSelection;
103 class AutomationTimeAxisView;
109 class EditNoteDialog;
111 class EditorGroupTabs;
112 class EditorLocations;
115 class EditorRouteGroups;
116 class EditorSnapshots;
118 class GroupedButtons;
119 class GUIObjectState;
121 class MidiRegionView;
122 class MidiExportDialog;
126 class PlaylistSelector;
127 class PluginSelector;
128 class ProgressReporter;
129 class QuantizeDialog;
133 class SoundFileOmega;
140 class RegionLayeringOrderEditor;
143 class Editor : public PublicEditor, public PBD::ScopedConnectionList, public ARDOUR::SessionHandlePtr
149 void set_session (ARDOUR::Session *);
150 ARDOUR::Session* session() const { return _session; }
152 Gtk::Window* use_own_window (bool and_fill_it);
155 virtual bool have_idled () const { return _have_idled; }
157 framepos_t leftmost_sample() const { return leftmost_frame; }
159 framecnt_t current_page_samples() const {
160 return (framecnt_t) _visible_canvas_width * samples_per_pixel;
163 double visible_canvas_height () const {
164 return _visible_canvas_height;
166 double trackviews_height () const;
168 void cycle_snap_mode ();
169 void next_snap_choice ();
170 void next_snap_choice_music_only ();
171 void next_snap_choice_music_and_time ();
172 void prev_snap_choice ();
173 void prev_snap_choice_music_only ();
174 void prev_snap_choice_music_and_time ();
175 void set_snap_to (Editing::SnapType);
176 void set_snap_mode (Editing::SnapMode);
177 void set_snap_threshold (double pixel_distance) {snap_threshold = pixel_distance;}
179 Editing::SnapMode snap_mode () const;
180 Editing::SnapType snap_type () const;
181 bool snap_musical () const;
183 void undo (uint32_t n = 1);
184 void redo (uint32_t n = 1);
186 XMLNode& get_state ();
187 int set_state (const XMLNode&, int version);
189 void set_mouse_mode (Editing::MouseMode, bool force=true);
190 void step_mouse_mode (bool next);
191 Editing::MouseMode current_mouse_mode () const { return mouse_mode; }
192 Editing::MidiEditMode current_midi_edit_mode () const;
193 void remove_midi_note (ArdourCanvas::Item *, GdkEvent *);
195 bool internal_editing() const;
197 void foreach_time_axis_view (sigc::slot<void,TimeAxisView&>);
198 void add_to_idle_resize (TimeAxisView*, int32_t);
200 RouteTimeAxisView* get_route_view_by_route_id (const PBD::ID& id) const;
202 void consider_auditioning (boost::shared_ptr<ARDOUR::Region>);
203 void hide_a_region (boost::shared_ptr<ARDOUR::Region>);
204 void show_a_region (boost::shared_ptr<ARDOUR::Region>);
206 #ifdef USE_RUBBERBAND
207 std::vector<std::string> rb_opt_strings;
211 /* things that need to be public to be used in the main menubar */
213 void new_region_from_selection ();
214 void separate_regions_between (const TimeSelection&);
215 void separate_region_from_selection ();
216 void separate_under_selected_regions ();
217 void separate_region_from_punch ();
218 void separate_region_from_loop ();
219 void separate_regions_using_location (ARDOUR::Location&);
220 void transition_to_rolling (bool forward);
222 /* NOTE: these functions assume that the "pixel" coordinate is
223 in canvas coordinates. These coordinates already take into
224 account any scrolling offsets.
227 framepos_t pixel_to_sample_from_event (double pixel) const {
229 /* pixel can be less than zero when motion events
230 are processed. since we've already run the world->canvas
231 affine, that means that the location *really* is "off
232 to the right" and thus really is "before the start".
236 return pixel * samples_per_pixel;
242 framepos_t pixel_to_sample (double pixel) const {
243 return pixel * samples_per_pixel;
246 double sample_to_pixel (framepos_t sample) const {
247 return round (sample / (double) samples_per_pixel);
250 double sample_to_pixel_unrounded (framepos_t sample) const {
251 return sample / (double) samples_per_pixel;
256 Selection& get_selection() const { return *selection; }
257 bool get_selection_extents (framepos_t &start, framepos_t &end) const; // the time extents of the current selection, whether Range, Region(s), Control Points, or Notes
258 Selection& get_cut_buffer() const { return *cut_buffer; }
259 void track_mixer_selection ();
261 bool extend_selection_to_track (TimeAxisView&);
263 void play_selection ();
264 framepos_t get_preroll ();
265 void maybe_locate_with_edit_preroll (framepos_t);
266 void play_with_preroll ();
267 void select_all_in_track (Selection::Operation op);
268 void select_all_objects (Selection::Operation op);
269 void invert_selection_in_track ();
270 void invert_selection ();
271 void deselect_all ();
272 long select_range (framepos_t, framepos_t);
274 void set_selected_regionview_from_region_list (boost::shared_ptr<ARDOUR::Region> region, Selection::Operation op = Selection::Set);
276 void remove_tracks ();
280 void set_show_measures (bool yn);
281 bool show_measures () const { return _show_measures; }
283 /* analysis window */
285 void loudness_analyze_region_selection();
286 void loudness_analyze_range_selection();
288 void spectral_analyze_region_selection();
289 void spectral_analyze_range_selection();
293 void export_audio ();
295 void export_selection ();
296 void export_range ();
297 void export_region ();
299 bool process_midi_export_dialog (MidiExportDialog& dialog, boost::shared_ptr<ARDOUR::MidiRegion> midi_region);
301 void set_zoom_focus (Editing::ZoomFocus);
302 Editing::ZoomFocus get_zoom_focus () const { return zoom_focus; }
303 framecnt_t get_current_zoom () const { return samples_per_pixel; }
304 void cycle_zoom_focus ();
305 void temporal_zoom_step (bool zoom_out);
306 void temporal_zoom_step_scale (bool zoom_out, double scale);
307 void temporal_zoom_step_mouse_focus (bool zoom_out);
308 void temporal_zoom_step_mouse_focus_scale (bool zoom_out, double scale);
309 void ensure_time_axis_view_is_visible (TimeAxisView const & tav, bool at_top);
310 void tav_zoom_step (bool coarser);
311 void tav_zoom_smooth (bool coarser, bool force_all);
313 /* stuff that AudioTimeAxisView and related classes use */
315 PlaylistSelector& playlist_selector() const;
316 void clear_playlist (boost::shared_ptr<ARDOUR::Playlist>);
318 void new_playlists (TimeAxisView* v);
319 void copy_playlists (TimeAxisView* v);
320 void clear_playlists (TimeAxisView* v);
322 void get_onscreen_tracks (TrackViewList&);
324 Width editor_mixer_strip_width;
325 void maybe_add_mixer_strip_width (XMLNode&);
326 void show_editor_mixer (bool yn);
327 void create_editor_mixer ();
328 void show_editor_list (bool yn);
329 void set_selected_mixer_strip (TimeAxisView&);
330 void mixer_strip_width_changed ();
331 void hide_track_in_display (TimeAxisView* tv, bool apply_to_selection = false);
333 /* nudge is initiated by transport controls owned by ARDOUR_UI */
335 framecnt_t get_nudge_distance (framepos_t pos, framecnt_t& next);
336 framecnt_t get_paste_offset (framepos_t pos, unsigned paste_count, framecnt_t duration);
337 unsigned get_grid_beat_divisions(framepos_t position);
338 Evoral::Beats get_grid_type_as_beats (bool& success, framepos_t position);
340 int32_t get_grid_music_divisions (uint32_t event_state);
342 void nudge_forward (bool next, bool force_playhead);
343 void nudge_backward (bool next, bool force_playhead);
345 /* nudge initiated from context menu */
347 void nudge_forward_capture_offset ();
348 void nudge_backward_capture_offset ();
350 void sequence_regions ();
352 /* playhead/screen stuff */
354 void set_stationary_playhead (bool yn);
355 void toggle_stationary_playhead ();
356 bool stationary_playhead() const { return _stationary_playhead; }
358 void set_follow_playhead (bool yn, bool catch_up = true);
359 void toggle_follow_playhead ();
360 bool follow_playhead() const { return _follow_playhead; }
361 bool dragging_playhead () const { return _dragging_playhead; }
363 void toggle_zero_line_visibility ();
365 void set_group_tabs ();
366 void toggle_measure_visibility ();
370 void toggle_region_fades (int dir);
371 void update_region_fade_visibility ();
373 /* redirect shared ops menu. caller must free returned menu */
375 Gtk::Menu* redirect_menu ();
377 /* floating windows/transient */
379 void ensure_float (Gtk::Window&);
381 void scroll_tracks_down_line ();
382 void scroll_tracks_up_line ();
384 bool scroll_up_one_track (bool skip_child_views = false);
385 bool scroll_down_one_track (bool skip_child_views = false);
387 void scroll_left_step ();
388 void scroll_right_step ();
390 void scroll_left_half_page ();
391 void scroll_right_half_page ();
393 void prepare_for_cleanup ();
394 void finish_cleanup ();
396 void maximise_editing_space();
397 void restore_editing_space();
399 double get_y_origin () const;
400 void reset_x_origin (framepos_t);
401 void reset_x_origin_to_follow_playhead ();
402 void reset_y_origin (double);
403 void reset_zoom (framecnt_t);
404 void reposition_and_zoom (framepos_t, double);
406 framepos_t get_preferred_edit_position (Editing::EditIgnoreOption = Editing::EDIT_IGNORE_NONE,
407 bool use_context_click = false,
408 bool from_outside_canvas = false);
410 bool update_mouse_speed ();
411 bool decelerate_mouse_speed ();
413 void toggle_meter_updating();
415 void show_rhythm_ferret();
417 void goto_visual_state (uint32_t);
418 void save_visual_state (uint32_t);
420 void queue_draw_resize_line (int at);
421 void start_resize_line_ops ();
422 void end_resize_line_ops ();
424 TrackViewList const & get_track_views () {
428 int get_regionview_count_from_region_list (boost::shared_ptr<ARDOUR::Region>);
430 void do_ptimport(std::string path, ARDOUR::SrcQuality quality);
432 void do_import (std::vector<std::string> paths,
433 Editing::ImportDisposition disposition,
434 Editing::ImportMode mode,
435 ARDOUR::SrcQuality quality,
436 ARDOUR::MidiTrackNameSource mts,
437 ARDOUR::MidiTempoMapDisposition mtd,
439 boost::shared_ptr<ARDOUR::PluginInfo> instrument = boost::shared_ptr<ARDOUR::PluginInfo>());
441 void do_embed (std::vector<std::string> paths,
442 Editing::ImportDisposition disposition,
443 Editing::ImportMode mode,
445 boost::shared_ptr<ARDOUR::PluginInfo> instrument = boost::shared_ptr<ARDOUR::PluginInfo>());
447 void get_regions_corresponding_to (boost::shared_ptr<ARDOUR::Region> region, std::vector<RegionView*>& regions, bool src_comparison);
449 void get_regionviews_by_id (PBD::ID const id, RegionSelection & regions) const;
450 void get_per_region_note_selection (std::list<std::pair<PBD::ID, std::set<boost::shared_ptr<Evoral::Note<Evoral::Beats> > > > >&) const;
452 void center_screen (framepos_t);
454 TrackViewList axis_views_from_routes (boost::shared_ptr<ARDOUR::RouteList>) const;
456 void snap_to (framepos_t& first,
457 ARDOUR::RoundMode direction = ARDOUR::RoundNearest,
458 bool for_mark = false,
459 bool ensure_snap = false);
461 void snap_to_with_modifier (framepos_t& first,
463 ARDOUR::RoundMode direction = ARDOUR::RoundNearest,
464 bool for_mark = false);
466 void snap_to (framepos_t& first,
468 ARDOUR::RoundMode direction = ARDOUR::RoundNearest,
469 bool for_mark = false);
471 void begin_selection_op_history ();
472 void begin_reversible_selection_op (std::string cmd_name);
473 void commit_reversible_selection_op ();
474 void undo_selection_op ();
475 void redo_selection_op ();
476 void begin_reversible_command (std::string cmd_name);
477 void begin_reversible_command (GQuark);
478 void abort_reversible_command ();
479 void commit_reversible_command ();
481 DragManager* drags () const {
485 void maybe_autoscroll (bool, bool, bool);
486 bool autoscroll_active() const;
488 Gdk::Cursor* get_canvas_cursor () const;
490 void set_current_trimmable (boost::shared_ptr<ARDOUR::Trimmable>);
491 void set_current_movable (boost::shared_ptr<ARDOUR::Movable>);
493 MouseCursors const * cursors () const {
497 VerboseCursor* verbose_cursor () const {
498 return _verbose_cursor;
501 double clamp_verbose_cursor_x (double);
502 double clamp_verbose_cursor_y (double);
504 void get_pointer_position (double &, double &) const;
506 /** Context for mouse entry (stored in a stack). */
507 struct EnterContext {
509 boost::shared_ptr<CursorContext> cursor_ctx;
512 /** Get the topmost enter context for the given item type.
514 * This is used to change the cursor associated with a given enter context,
515 * which may not be on the top of the stack.
517 EnterContext* get_enter_context(ItemType type);
519 TimeAxisView* stepping_axis_view () {
520 return _stepping_axis_view;
523 void set_stepping_axis_view (TimeAxisView* v) {
524 _stepping_axis_view = v;
527 ArdourCanvas::Container* get_trackview_group () const { return _trackview_group; }
528 ArdourCanvas::Container* get_noscroll_group () const { return no_scroll_group; }
529 ArdourCanvas::ScrollGroup* get_hscroll_group () const { return h_scroll_group; }
530 ArdourCanvas::ScrollGroup* get_hvscroll_group () const { return hv_scroll_group; }
531 ArdourCanvas::ScrollGroup* get_cursor_scroll_group () const { return cursor_scroll_group; }
533 ArdourCanvas::GtkCanvasViewport* get_track_canvas () const;
535 void override_visible_track_count ();
537 /* Ruler metrics methods */
539 void metric_get_timecode (std::vector<ArdourCanvas::Ruler::Mark>&, gdouble, gdouble, gint);
540 void metric_get_bbt (std::vector<ArdourCanvas::Ruler::Mark>&, gdouble, gdouble, gint);
541 void metric_get_samples (std::vector<ArdourCanvas::Ruler::Mark>&, gdouble, gdouble, gint);
542 void metric_get_minsec (std::vector<ArdourCanvas::Ruler::Mark>&, gdouble, gdouble, gint);
544 /* editing operations that need to be public */
545 void mouse_add_new_marker (framepos_t where, bool is_cd=false);
546 void split_regions_at (framepos_t, RegionSelection&, const int32_t sub_num, bool snap = true);
547 void split_region_at_points (boost::shared_ptr<ARDOUR::Region>, ARDOUR::AnalysisFeatureList&, bool can_ferret, bool select_new = false);
548 RegionSelection get_regions_from_selection_and_mouse (framepos_t);
550 void mouse_add_new_tempo_event (framepos_t where);
551 void mouse_add_new_meter_event (framepos_t where);
552 void edit_tempo_section (ARDOUR::TempoSection*);
553 void edit_meter_section (ARDOUR::MeterSection*);
556 void map_transport_state ();
557 void map_position_change (framepos_t);
561 void suspend_route_redisplay ();
562 void resume_route_redisplay ();
566 void color_handler ();
570 // to keep track of the playhead position for control_scroll
571 boost::optional<framepos_t> _control_scroll_target;
573 PlaylistSelector* _playlist_selector;
575 TimeInfoBox* _time_info_box;
577 typedef std::pair<TimeAxisView*,XMLNode*> TAVState;
580 VisualState (bool with_tracks);
583 framecnt_t samples_per_pixel;
584 framepos_t leftmost_frame;
585 Editing::ZoomFocus zoom_focus;
586 GUIObjectState* gui_state;
589 std::list<VisualState*> undo_visual_stack;
590 std::list<VisualState*> redo_visual_stack;
591 VisualState* current_visual_state (bool with_tracks = true);
592 void undo_visual_state ();
593 void redo_visual_state ();
594 void use_visual_state (VisualState&);
596 void swap_visual_state ();
598 std::vector<VisualState*> visual_states;
599 void start_visual_state_op (uint32_t n);
600 void cancel_visual_state_op (uint32_t n);
602 framepos_t leftmost_frame;
603 framecnt_t samples_per_pixel;
604 Editing::ZoomFocus zoom_focus;
606 void set_samples_per_pixel (framecnt_t);
608 Editing::MouseMode mouse_mode;
609 Editing::SnapType pre_internal_snap_type;
610 Editing::SnapMode pre_internal_snap_mode;
611 Editing::SnapType internal_snap_type;
612 Editing::SnapMode internal_snap_mode;
613 Editing::MouseMode effective_mouse_mode () const;
615 enum JoinObjectRangeState {
616 JOIN_OBJECT_RANGE_NONE,
617 /** `join object/range' mode is active and the mouse is over a place where object mode should happen */
618 JOIN_OBJECT_RANGE_OBJECT,
619 /** `join object/range' mode is active and the mouse is over a place where range mode should happen */
620 JOIN_OBJECT_RANGE_RANGE
623 JoinObjectRangeState _join_object_range_state;
625 void update_join_object_range_location (double);
627 boost::optional<float> pre_notebook_shrink_pane_width;
629 Gtk::Notebook _the_notebook;
630 bool _notebook_shrunk;
631 void add_notebook_page (std::string const &, Gtk::Widget &);
632 bool notebook_tab_clicked (GdkEventButton *, Gtk::Widget *);
634 Gtkmm2ext::HPane edit_pane;
635 Gtkmm2ext::VPane editor_summary_pane;
637 Gtk::EventBox meter_base;
639 Gtk::EventBox marker_base;
640 Gtk::HBox marker_box;
641 Gtk::VBox scrollers_rulers_markers_box;
643 void location_changed (ARDOUR::Location *);
644 void location_flags_changed (ARDOUR::Location *);
645 void refresh_location_display ();
646 void refresh_location_display_internal (const ARDOUR::Locations::LocationList&);
647 void add_new_location (ARDOUR::Location *);
648 ArdourCanvas::Container* add_new_location_internal (ARDOUR::Location *);
649 void location_gone (ARDOUR::Location *);
650 void remove_marker (ArdourCanvas::Item&, GdkEvent*);
651 gint really_remove_marker (ARDOUR::Location* loc);
652 void goto_nth_marker (int nth);
653 void trigger_script (int nth);
654 void toggle_marker_lines ();
655 void set_marker_line_visibility (bool);
657 uint32_t location_marker_color;
658 uint32_t location_range_color;
659 uint32_t location_loop_color;
660 uint32_t location_punch_color;
661 uint32_t location_cd_marker_color;
663 struct LocationMarkers {
668 LocationMarkers () : start(0), end(0), valid (true) {}
675 void set_show_lines (bool);
676 void set_selected (bool);
677 void canvas_height_set (double);
680 void set_name (const std::string&);
681 void set_position (framepos_t start, framepos_t end = 0);
682 void set_color_rgba (uint32_t);
685 LocationMarkers *find_location_markers (ARDOUR::Location *) const;
686 ARDOUR::Location* find_location_from_marker (ArdourMarker *, bool& is_start) const;
687 ArdourMarker* find_marker_from_location_id (PBD::ID const &, bool) const;
688 ArdourMarker* entered_marker;
689 bool _show_marker_lines;
691 typedef std::map<ARDOUR::Location*,LocationMarkers *> LocationMarkerMap;
692 LocationMarkerMap location_markers;
694 void update_marker_labels ();
695 void update_marker_labels (ArdourCanvas::Container *);
696 void check_marker_label (ArdourMarker *);
698 /** A set of lists of Markers that are in each of the canvas groups
699 * for the marker sections at the top of the editor. These lists
700 * are kept sorted in time order between marker movements, so that after
701 * a marker has moved we can decide whether we need to update the labels
702 * for all markers or for just a few.
704 std::map<ArdourCanvas::Container *, std::list<ArdourMarker *> > _sorted_marker_lists;
705 void remove_sorted_marker (ArdourMarker *);
707 void hide_marker (ArdourCanvas::Item*, GdkEvent*);
708 void clear_marker_display ();
709 void mouse_add_new_range (framepos_t);
710 void mouse_add_new_loop (framepos_t);
711 void mouse_add_new_punch (framepos_t);
712 bool choose_new_marker_name(std::string &name);
713 void update_cd_marker_display ();
714 void ensure_cd_marker_updated (LocationMarkers * lam, ARDOUR::Location * location);
716 TimeAxisView* clicked_axisview;
717 RouteTimeAxisView* clicked_routeview;
718 /** The last RegionView that was clicked on, or 0 if the last click was not
719 * on a RegionView. This is set up by the canvas event handlers in
720 * editor_canvas_events.cc
722 RegionView* clicked_regionview;
723 RegionSelection latest_regionviews;
724 uint32_t clicked_selection;
725 ControlPoint* clicked_control_point;
727 void sort_track_selection (TrackViewList&);
729 void get_equivalent_regions (RegionView* rv, std::vector<RegionView*> &, PBD::PropertyID) const;
730 RegionSelection get_equivalent_regions (RegionSelection &, PBD::PropertyID) const;
731 void mapover_tracks (sigc::slot<void,RouteTimeAxisView&,uint32_t> sl, TimeAxisView*, PBD::PropertyID) const;
732 void mapover_tracks_with_unique_playlists (sigc::slot<void,RouteTimeAxisView&,uint32_t> sl, TimeAxisView*, PBD::PropertyID) const;
734 /* functions to be passed to mapover_tracks(), possibly with sigc::bind()-supplied arguments */
735 void mapped_get_equivalent_regions (RouteTimeAxisView&, uint32_t, RegionView *, std::vector<RegionView*>*) const;
736 void mapped_use_new_playlist (RouteTimeAxisView&, uint32_t, std::vector<boost::shared_ptr<ARDOUR::Playlist> > const &);
737 void mapped_use_copy_playlist (RouteTimeAxisView&, uint32_t, std::vector<boost::shared_ptr<ARDOUR::Playlist> > const &);
738 void mapped_clear_playlist (RouteTimeAxisView&, uint32_t);
740 void button_selection (ArdourCanvas::Item* item, GdkEvent* event, ItemType item_type);
741 bool button_release_can_deselect;
742 bool _mouse_changed_selection;
744 void catch_vanishing_regionview (RegionView *);
746 void set_selected_track (TimeAxisView&, Selection::Operation op = Selection::Set, bool no_remove=false);
747 void select_all_tracks ();
748 bool select_all_internal_edit (Selection::Operation);
750 bool set_selected_control_point_from_click (bool press, Selection::Operation op = Selection::Set);
751 void set_selected_track_from_click (bool press, Selection::Operation op = Selection::Set, bool no_remove=false);
752 void set_selected_track_as_side_effect (Selection::Operation op);
753 bool set_selected_regionview_from_click (bool press, Selection::Operation op = Selection::Set);
755 bool set_selected_regionview_from_map_event (GdkEventAny*, StreamView*, boost::weak_ptr<ARDOUR::Region>);
756 void collect_new_region_view (RegionView *);
757 void collect_and_select_new_region_view (RegionView *);
759 Gtk::Menu track_context_menu;
760 Gtk::Menu track_region_context_menu;
761 Gtk::Menu track_selection_context_menu;
763 Gtk::MenuItem* region_edit_menu_split_item;
764 Gtk::MenuItem* region_edit_menu_split_multichannel_item;
765 Gtk::Menu * track_region_edit_playlist_menu;
766 Gtk::Menu * track_edit_playlist_submenu;
767 Gtk::Menu * track_selection_edit_playlist_submenu;
769 GdkEvent context_click_event;
771 void popup_track_context_menu (int, int, ItemType, bool);
772 Gtk::Menu* build_track_context_menu ();
773 Gtk::Menu* build_track_bus_context_menu ();
774 Gtk::Menu* build_track_region_context_menu ();
775 Gtk::Menu* build_track_selection_context_menu ();
776 void add_dstream_context_items (Gtk::Menu_Helpers::MenuList&);
777 void add_bus_context_items (Gtk::Menu_Helpers::MenuList&);
778 void add_region_context_items (Gtk::Menu_Helpers::MenuList&, boost::shared_ptr<ARDOUR::Track>);
779 void add_selection_context_items (Gtk::Menu_Helpers::MenuList&);
780 Gtk::MenuItem* _popup_region_menu_item;
782 void popup_control_point_context_menu (ArdourCanvas::Item *, GdkEvent *);
783 Gtk::Menu _control_point_context_menu;
785 void popup_note_context_menu (ArdourCanvas::Item *, GdkEvent *);
786 Gtk::Menu _note_context_menu;
788 void add_stripables (ARDOUR::StripableList&);
789 void add_routes (ARDOUR::RouteList&);
790 void timeaxisview_deleted (TimeAxisView *);
791 void add_vcas (ARDOUR::VCAList&);
793 Gtk::HBox global_hpacker;
794 Gtk::VBox global_vpacker;
796 /* Cursor stuff. Do not use directly, use via CursorContext. */
797 friend class CursorContext;
798 std::vector<Gdk::Cursor*> _cursor_stack;
799 void set_canvas_cursor (Gdk::Cursor*);
800 size_t push_canvas_cursor (Gdk::Cursor*);
801 void pop_canvas_cursor ();
803 Gdk::Cursor* which_grabber_cursor () const;
804 Gdk::Cursor* which_track_cursor () const;
805 Gdk::Cursor* which_mode_cursor () const;
806 Gdk::Cursor* which_trim_cursor (bool left_side) const;
807 Gdk::Cursor* which_canvas_cursor (ItemType type) const;
809 /** Push the appropriate enter/cursor context on item entry. */
810 void choose_canvas_cursor_on_entry (ItemType);
812 /** Update all enter cursors based on current settings. */
813 void update_all_enter_cursors ();
815 ArdourCanvas::GtkCanvas* _track_canvas;
816 ArdourCanvas::GtkCanvasViewport* _track_canvas_viewport;
818 bool within_track_canvas;
820 friend class VerboseCursor;
821 VerboseCursor* _verbose_cursor;
823 void parameter_changed (std::string);
824 void ui_parameter_changed (std::string);
826 Gtk::EventBox time_bars_event_box;
827 Gtk::VBox time_bars_vbox;
829 ArdourCanvas::Container *tempo_group;
830 ArdourCanvas::Container *meter_group;
831 ArdourCanvas::Container *marker_group;
832 ArdourCanvas::Container *range_marker_group;
833 ArdourCanvas::Container *transport_marker_group;
834 ArdourCanvas::Container* cd_marker_group;
836 /* parent for groups which themselves contain time markers */
837 ArdourCanvas::Container* _time_markers_group;
839 /* The group containing all other groups that are scrolled vertically
842 ArdourCanvas::ScrollGroup* hv_scroll_group;
844 /* The group containing all other groups that are scrolled horizontally ONLY
846 ArdourCanvas::ScrollGroup* h_scroll_group;
848 /* Scroll group for cursors, scrolled horizontally, above everything else
850 ArdourCanvas::ScrollGroup* cursor_scroll_group;
852 /* The group containing all trackviews. */
853 ArdourCanvas::Container* no_scroll_group;
855 /* The group containing all trackviews. */
856 ArdourCanvas::Container* _trackview_group;
858 /* The group holding things (mostly regions) while dragging so they
859 * are on top of everything else
861 ArdourCanvas::Container* _drag_motion_group;
863 /* a rect that sits at the bottom of all tracks to act as a drag-no-drop/clickable
866 ArdourCanvas::Rectangle* _canvas_drop_zone;
867 bool canvas_drop_zone_event (GdkEvent* event);
870 ruler_metric_timecode = 0,
871 ruler_metric_bbt = 1,
872 ruler_metric_samples = 2,
873 ruler_metric_minsec = 3,
875 ruler_time_tempo = 4,
876 ruler_time_meter = 5,
877 ruler_time_marker = 6,
878 ruler_time_range_marker = 7,
879 ruler_time_transport_marker = 8,
880 ruler_time_cd_marker = 9,
881 ruler_video_timeline = 10,
884 Glib::RefPtr<Gtk::ToggleAction> ruler_timecode_action;
885 Glib::RefPtr<Gtk::ToggleAction> ruler_bbt_action;
886 Glib::RefPtr<Gtk::ToggleAction> ruler_samples_action;
887 Glib::RefPtr<Gtk::ToggleAction> ruler_minsec_action;
888 Glib::RefPtr<Gtk::ToggleAction> ruler_tempo_action;
889 Glib::RefPtr<Gtk::ToggleAction> ruler_meter_action;
890 Glib::RefPtr<Gtk::ToggleAction> ruler_marker_action;
891 Glib::RefPtr<Gtk::ToggleAction> ruler_range_action;
892 Glib::RefPtr<Gtk::ToggleAction> ruler_loop_punch_action;
893 Glib::RefPtr<Gtk::ToggleAction> ruler_cd_marker_action;
894 bool no_ruler_shown_update;
896 Gtk::Widget * ruler_grabbed_widget;
898 RulerDialog* ruler_dialog;
900 void initialize_rulers ();
901 void update_just_timecode ();
902 void compute_fixed_ruler_scale (); //calculates the RulerScale of the fixed rulers
903 void update_fixed_rulers ();
904 void update_tempo_based_rulers ();
905 void popup_ruler_menu (framepos_t where = 0, ItemType type = RegionItem);
906 void update_ruler_visibility ();
907 void set_ruler_visible (RulerType, bool);
908 void toggle_ruler_visibility (RulerType rt);
909 void ruler_toggled (int);
910 bool ruler_label_button_release (GdkEventButton*);
911 void store_ruler_visibility ();
912 void restore_ruler_visibility ();
916 enum MinsecRulerScale {
921 minsec_show_many_hours
924 MinsecRulerScale minsec_ruler_scale;
926 framecnt_t minsec_mark_interval;
927 gint minsec_mark_modulo;
929 void set_minsec_ruler_scale (framepos_t, framepos_t);
931 enum TimecodeRulerScale {
933 timecode_show_frames,
934 timecode_show_seconds,
935 timecode_show_minutes,
937 timecode_show_many_hours
940 TimecodeRulerScale timecode_ruler_scale;
942 gint timecode_mark_modulo;
943 gint timecode_nmarks;
944 void set_timecode_ruler_scale (framepos_t, framepos_t);
946 framecnt_t _samples_ruler_interval;
947 void set_samples_ruler_scale (framepos_t, framepos_t);
957 bbt_show_ticks_detail,
958 bbt_show_ticks_super_detail
961 BBTRulerScale bbt_ruler_scale;
965 uint32_t bbt_bar_helper_on;
966 uint32_t bbt_accent_modulo;
967 void compute_bbt_ruler_scale (framepos_t lower, framepos_t upper);
969 ArdourCanvas::Ruler* timecode_ruler;
970 ArdourCanvas::Ruler* bbt_ruler;
971 ArdourCanvas::Ruler* samples_ruler;
972 ArdourCanvas::Ruler* minsec_ruler;
974 static double timebar_height;
975 guint32 visible_timebars;
976 Gtk::Menu *editor_ruler_menu;
978 ArdourCanvas::Rectangle* tempo_bar;
979 ArdourCanvas::Rectangle* meter_bar;
980 ArdourCanvas::Rectangle* marker_bar;
981 ArdourCanvas::Rectangle* range_marker_bar;
982 ArdourCanvas::Rectangle* transport_marker_bar;
983 ArdourCanvas::Rectangle* cd_marker_bar;
985 Gtk::Label minsec_label;
986 Gtk::Label bbt_label;
987 Gtk::Label timecode_label;
988 Gtk::Label samples_label;
989 Gtk::Label tempo_label;
990 Gtk::Label meter_label;
991 Gtk::Label mark_label;
992 Gtk::Label range_mark_label;
993 Gtk::Label transport_mark_label;
994 Gtk::Label cd_mark_label;
996 /* videtimline related actions */
997 Gtk::Label videotl_label;
998 ArdourCanvas::Container* videotl_group;
999 Glib::RefPtr<Gtk::ToggleAction> ruler_video_action;
1000 Glib::RefPtr<Gtk::ToggleAction> xjadeo_proc_action;
1001 Glib::RefPtr<Gtk::ToggleAction> xjadeo_ontop_action;
1002 Glib::RefPtr<Gtk::ToggleAction> xjadeo_timecode_action;
1003 Glib::RefPtr<Gtk::ToggleAction> xjadeo_frame_action;
1004 Glib::RefPtr<Gtk::ToggleAction> xjadeo_osdbg_action;
1005 Glib::RefPtr<Gtk::ToggleAction> xjadeo_fullscreen_action;
1006 Glib::RefPtr<Gtk::ToggleAction> xjadeo_letterbox_action;
1007 Glib::RefPtr<Gtk::Action> xjadeo_zoom_100;
1008 void set_xjadeo_proc ();
1009 void toggle_xjadeo_proc (int state=-1);
1010 void set_close_video_sensitive (bool onoff);
1011 void set_xjadeo_sensitive (bool onoff);
1012 void set_xjadeo_viewoption (int);
1013 void toggle_xjadeo_viewoption (int what, int state=-1);
1014 void toggle_ruler_video (bool onoff) {ruler_video_action->set_active(onoff);}
1015 int videotl_bar_height; /* in units of timebar_height; default: 4 */
1016 int get_videotl_bar_height () const { return videotl_bar_height; }
1017 void toggle_region_video_lock ();
1019 friend class EditorCursor;
1021 EditorCursor* playhead_cursor;
1022 framepos_t playhead_cursor_sample () const;
1024 framepos_t get_region_boundary (framepos_t pos, int32_t dir, bool with_selection, bool only_onscreen);
1026 void cursor_to_region_boundary (bool with_selection, int32_t dir);
1027 void cursor_to_next_region_boundary (bool with_selection);
1028 void cursor_to_previous_region_boundary (bool with_selection);
1029 void cursor_to_next_region_point (EditorCursor*, ARDOUR::RegionPoint);
1030 void cursor_to_previous_region_point (EditorCursor*, ARDOUR::RegionPoint);
1031 void cursor_to_region_point (EditorCursor*, ARDOUR::RegionPoint, int32_t dir);
1032 void cursor_to_selection_start (EditorCursor *);
1033 void cursor_to_selection_end (EditorCursor *);
1035 void selected_marker_to_region_boundary (bool with_selection, int32_t dir);
1036 void selected_marker_to_next_region_boundary (bool with_selection);
1037 void selected_marker_to_previous_region_boundary (bool with_selection);
1038 void selected_marker_to_next_region_point (ARDOUR::RegionPoint);
1039 void selected_marker_to_previous_region_point (ARDOUR::RegionPoint);
1040 void selected_marker_to_region_point (ARDOUR::RegionPoint, int32_t dir);
1041 void selected_marker_to_selection_start ();
1042 void selected_marker_to_selection_end ();
1044 void select_all_selectables_using_cursor (EditorCursor *, bool);
1045 void select_all_selectables_using_edit (bool, bool);
1046 void select_all_selectables_between (bool within);
1047 void select_range_between ();
1049 boost::shared_ptr<ARDOUR::Region> find_next_region (ARDOUR::framepos_t, ARDOUR::RegionPoint, int32_t dir, TrackViewList&, TimeAxisView ** = 0);
1050 ARDOUR::framepos_t find_next_region_boundary (ARDOUR::framepos_t, int32_t dir, const TrackViewList&);
1052 std::vector<ARDOUR::framepos_t> region_boundary_cache;
1053 void build_region_boundary_cache ();
1055 Gtk::HBox toplevel_hpacker;
1057 Gtk::HBox bottom_hbox;
1059 Gtk::Table edit_packer;
1061 /** the adjustment that controls the overall editor vertical scroll position */
1062 Gtk::Adjustment vertical_adjustment;
1063 Gtk::Adjustment horizontal_adjustment;
1065 Gtk::Adjustment unused_adjustment; // yes, really; Gtk::Layout constructor requires refs
1066 Gtk::Layout controls_layout;
1067 bool control_layout_scroll (GdkEventScroll* ev);
1068 void reset_controls_layout_width ();
1069 void reset_controls_layout_height (int32_t height);
1078 bool scroll_press (Direction);
1079 void scroll_release ();
1080 sigc::connection _scroll_connection;
1081 int _scroll_callbacks;
1083 double _visible_canvas_width;
1084 double _visible_canvas_height; ///< height of the visible area of the track canvas
1085 double _full_canvas_height; ///< full height of the canvas
1087 bool track_canvas_map_handler (GdkEventAny*);
1089 bool edit_controls_button_release (GdkEventButton*);
1090 Gtk::Menu *edit_controls_left_menu;
1091 Gtk::Menu *edit_controls_right_menu;
1093 Gtk::VBox track_canvas_vbox;
1094 Gtk::VBox edit_controls_vbox;
1095 Gtk::HBox edit_controls_hbox;
1097 void control_vertical_zoom_in_all ();
1098 void control_vertical_zoom_out_all ();
1099 void control_vertical_zoom_in_selected ();
1100 void control_vertical_zoom_out_selected ();
1101 void control_step_tracks_up ();
1102 void control_step_tracks_down ();
1103 void control_view (uint32_t);
1104 void control_scroll (float);
1105 void control_select (boost::shared_ptr<ARDOUR::Stripable>, Selection::Operation);
1106 void control_unselect ();
1107 void access_action (std::string,std::string);
1108 bool deferred_control_scroll (framepos_t);
1109 sigc::connection control_scroll_connection;
1111 void tie_vertical_scrolling ();
1112 void set_horizontal_position (double);
1113 double horizontal_position () const;
1115 struct VisualChange {
1123 framepos_t time_origin;
1124 framecnt_t samples_per_pixel;
1127 int idle_handler_id;
1128 /** true if we are currently in the idle handler */
1131 VisualChange() : pending ((VisualChange::Type) 0), time_origin (0), samples_per_pixel (0), idle_handler_id (-1), being_handled (false) {}
1133 pending = Type (pending | t);
1137 VisualChange pending_visual_change;
1139 static int _idle_visual_changer (void *arg);
1140 int idle_visual_changer ();
1141 void visual_changer (const VisualChange&);
1142 void ensure_visual_change_idle_handler ();
1145 TrackViewList track_views;
1146 std::pair<TimeAxisView*, double> trackview_by_y_position (double, bool trackview_relative_offset = true) const;
1147 TimeAxisView* axis_view_from_stripable (boost::shared_ptr<ARDOUR::Stripable>) const;
1149 TrackViewList get_tracks_for_range_action () const;
1151 sigc::connection super_rapid_screen_update_connection;
1152 framepos_t last_update_frame;
1153 void center_screen_internal (framepos_t, float);
1155 void super_rapid_screen_update ();
1157 void session_going_away ();
1159 framepos_t cut_buffer_start;
1160 framecnt_t cut_buffer_length;
1162 boost::shared_ptr<CursorContext> _press_cursor_ctx; ///< Button press cursor context
1164 boost::weak_ptr<ARDOUR::Trimmable> _trimmable;
1165 boost::weak_ptr<ARDOUR::Movable> _movable;
1167 bool typed_event (ArdourCanvas::Item*, GdkEvent*, ItemType);
1168 bool button_press_handler (ArdourCanvas::Item*, GdkEvent*, ItemType);
1169 bool button_press_handler_1 (ArdourCanvas::Item *, GdkEvent *, ItemType);
1170 bool button_press_handler_2 (ArdourCanvas::Item *, GdkEvent *, ItemType);
1171 bool button_release_handler (ArdourCanvas::Item*, GdkEvent*, ItemType);
1172 bool button_double_click_handler (ArdourCanvas::Item*, GdkEvent*, ItemType);
1173 bool button_press_dispatch (GdkEventButton*);
1174 bool button_release_dispatch (GdkEventButton*);
1175 bool motion_handler (ArdourCanvas::Item*, GdkEvent*, bool from_autoscroll = false);
1176 bool enter_handler (ArdourCanvas::Item*, GdkEvent*, ItemType);
1177 bool leave_handler (ArdourCanvas::Item*, GdkEvent*, ItemType);
1178 bool key_press_handler (ArdourCanvas::Item*, GdkEvent*, ItemType);
1179 bool key_release_handler (ArdourCanvas::Item*, GdkEvent*, ItemType);
1181 Gtkmm2ext::Bindings* button_bindings;
1182 XMLNode* button_settings () const;
1184 /* KEYMAP HANDLING */
1186 void register_actions ();
1187 void register_region_actions ();
1189 void load_bindings ();
1191 /* CUT/COPY/PASTE */
1193 framepos_t last_paste_pos;
1194 unsigned paste_count;
1196 void cut_copy (Editing::CutCopyOp);
1197 bool can_cut_copy () const;
1198 void cut_copy_points (Editing::CutCopyOp, Evoral::Beats earliest=Evoral::Beats(), bool midi=false);
1199 void cut_copy_regions (Editing::CutCopyOp, RegionSelection&);
1200 void cut_copy_ranges (Editing::CutCopyOp);
1201 void cut_copy_midi (Editing::CutCopyOp);
1203 void mouse_paste ();
1204 void paste_internal (framepos_t position, float times, const int32_t sub_num);
1206 /* EDITING OPERATIONS */
1208 void reset_point_selection ();
1209 void toggle_region_lock ();
1210 void toggle_opaque_region ();
1211 void toggle_record_enable ();
1212 void toggle_solo ();
1213 void toggle_solo_isolate ();
1214 void toggle_mute ();
1215 void toggle_region_lock_style ();
1217 enum LayerOperation {
1224 void do_layer_operation (LayerOperation);
1225 void raise_region ();
1226 void raise_region_to_top ();
1227 void change_region_layering_order (bool from_context_menu);
1228 void lower_region ();
1229 void lower_region_to_bottom ();
1230 void split_region_at_transients ();
1231 void crop_region_to_selection ();
1232 void crop_region_to (framepos_t start, framepos_t end);
1233 void set_sync_point (framepos_t, const RegionSelection&);
1234 void set_region_sync_position ();
1235 void remove_region_sync();
1236 void align_regions (ARDOUR::RegionPoint);
1237 void align_regions_relative (ARDOUR::RegionPoint point);
1238 void align_region (boost::shared_ptr<ARDOUR::Region>, ARDOUR::RegionPoint point, framepos_t position);
1239 void align_region_internal (boost::shared_ptr<ARDOUR::Region>, ARDOUR::RegionPoint point, framepos_t position);
1240 void remove_selected_regions ();
1241 void remove_clicked_region ();
1242 void show_region_properties ();
1243 void show_midi_list_editor ();
1244 void rename_region ();
1245 void duplicate_some_regions (RegionSelection&, float times);
1246 void duplicate_selection (float times);
1247 void region_fill_selection ();
1248 void combine_regions ();
1249 void uncombine_regions ();
1251 void region_fill_track ();
1252 void audition_playlist_region_standalone (boost::shared_ptr<ARDOUR::Region>);
1253 void split_multichannel_region();
1254 void reverse_region ();
1255 void strip_region_silence ();
1256 void normalize_region ();
1257 void reset_region_scale_amplitude ();
1258 void adjust_region_gain (bool up);
1259 void quantize_region ();
1260 void quantize_regions (const RegionSelection& rs);
1261 void legatize_region (bool shrink_only);
1262 void legatize_regions (const RegionSelection& rs, bool shrink_only);
1263 void transform_region ();
1264 void transform_regions (const RegionSelection& rs);
1265 void transpose_region ();
1266 void transpose_regions (const RegionSelection& rs);
1267 void insert_patch_change (bool from_context);
1268 void fork_region ();
1270 void do_insert_time ();
1271 void insert_time (framepos_t, framecnt_t, Editing::InsertTimeOption, bool, bool, bool, bool, bool, bool);
1273 void do_remove_time ();
1274 void remove_time (framepos_t pos, framecnt_t distance, Editing::InsertTimeOption opt, bool ignore_music_glue, bool markers_too,
1275 bool glued_markers_too, bool locked_markers_too, bool tempo_too);
1277 void tab_to_transient (bool forward);
1279 void set_tempo_from_region ();
1280 void use_range_as_bar ();
1282 void define_one_bar (framepos_t start, framepos_t end);
1284 void audition_region_from_region_list ();
1285 void hide_region_from_region_list ();
1286 void show_region_in_region_list ();
1288 void naturalize_region ();
1290 void split_region ();
1295 void paste (float times, bool from_context_menu);
1297 void place_transient ();
1298 void remove_transient (ArdourCanvas::Item* item);
1299 void snap_regions_to_grid ();
1300 void close_region_gaps ();
1302 void keyboard_paste ();
1304 void region_from_selection ();
1305 void create_region_from_selection (std::vector<boost::shared_ptr<ARDOUR::Region> >&);
1307 void play_from_start ();
1308 void play_from_edit_point ();
1309 void play_from_edit_point_and_return ();
1310 void play_selected_region ();
1311 void play_edit_range ();
1312 void play_location (ARDOUR::Location&);
1313 void loop_location (ARDOUR::Location&);
1315 void calc_extra_zoom_edges(framepos_t &start, framepos_t &end);
1316 void temporal_zoom_selection (Editing::ZoomAxis);
1317 void temporal_zoom_session ();
1318 void temporal_zoom (framecnt_t samples_per_pixel);
1319 void temporal_zoom_by_frame (framepos_t start, framepos_t end);
1320 void temporal_zoom_to_frame (bool coarser, framepos_t frame);
1322 void insert_region_list_selection (float times);
1325 void external_pt_dialog ();
1326 typedef struct ptflookup {
1331 bool operator ==(const struct ptflookup& other) {
1332 return (this->index1 == other.index1);
1336 /* import & embed */
1338 void add_external_audio_action (Editing::ImportMode);
1339 void external_audio_dialog ();
1340 void session_import_dialog ();
1342 int check_whether_and_how_to_import(std::string, bool all_or_nothing = true);
1343 bool check_multichannel_status (const std::vector<std::string>& paths);
1345 SoundFileOmega* sfbrowser;
1347 void bring_in_external_audio (Editing::ImportMode mode, framepos_t& pos);
1349 bool idle_drop_paths (std::vector<std::string> paths, framepos_t frame, double ypos, bool copy);
1350 void drop_paths_part_two (const std::vector<std::string>& paths, framepos_t frame, double ypos, bool copy);
1352 int import_sndfiles (std::vector<std::string> paths,
1353 Editing::ImportDisposition disposition,
1354 Editing::ImportMode mode,
1355 ARDOUR::SrcQuality quality,
1359 boost::shared_ptr<ARDOUR::Track>& track,
1361 boost::shared_ptr<ARDOUR::PluginInfo> instrument = boost::shared_ptr<ARDOUR::PluginInfo>());
1363 int embed_sndfiles (std::vector<std::string> paths,
1364 bool multiple_files,
1365 bool& check_sample_rate,
1366 Editing::ImportDisposition disposition,
1367 Editing::ImportMode mode,
1371 boost::shared_ptr<ARDOUR::Track>& track,
1372 boost::shared_ptr<ARDOUR::PluginInfo> instrument = boost::shared_ptr<ARDOUR::PluginInfo>());
1374 int add_sources (std::vector<std::string> paths,
1375 ARDOUR::SourceList& sources,
1377 Editing::ImportDisposition disposition,
1378 Editing::ImportMode mode,
1381 boost::shared_ptr<ARDOUR::Track>& track,
1382 bool add_channel_suffix,
1383 boost::shared_ptr<ARDOUR::PluginInfo> instrument = boost::shared_ptr<ARDOUR::PluginInfo>());
1385 int finish_bringing_in_material (boost::shared_ptr<ARDOUR::Region> region,
1389 Editing::ImportMode mode,
1390 boost::shared_ptr<ARDOUR::Track>& existing_track,
1391 const std::string& new_track_name,
1392 boost::shared_ptr<ARDOUR::PluginInfo> instrument);
1394 boost::shared_ptr<ARDOUR::AudioTrack> get_nth_selected_audio_track (int nth) const;
1395 boost::shared_ptr<ARDOUR::MidiTrack> get_nth_selected_midi_track (int nth) const;
1397 void toggle_midi_input_active (bool flip_others);
1399 ARDOUR::InterThreadInfo* current_interthread_info;
1401 AnalysisWindow* analysis_window;
1403 /* import specific info */
1405 struct EditorImportStatus : public ARDOUR::ImportStatus {
1406 Editing::ImportMode mode;
1410 boost::shared_ptr<ARDOUR::Track> track;
1414 EditorImportStatus import_status;
1415 static void *_import_thread (void *);
1416 void* import_thread ();
1417 void finish_import ();
1419 /* to support this ... */
1421 void import_audio (bool as_tracks);
1422 void do_import (std::vector<std::string> paths, bool split, bool as_tracks);
1423 void import_smf_tempo_map (Evoral::SMF const &);
1424 void move_to_start ();
1425 void move_to_end ();
1426 void center_playhead ();
1427 void center_edit_point ();
1428 void playhead_forward_to_grid ();
1429 void playhead_backward_to_grid ();
1430 void scroll_playhead (bool forward);
1431 void scroll_backward (float pages=0.8f);
1432 void scroll_forward (float pages=0.8f);
1433 void scroll_tracks_down ();
1434 void scroll_tracks_up ();
1436 void clear_markers ();
1437 void clear_ranges ();
1438 void clear_locations ();
1439 void unhide_markers ();
1440 void unhide_ranges ();
1441 void jump_forward_to_mark ();
1442 void jump_backward_to_mark ();
1443 void cursor_align (bool playhead_to_edit);
1444 void toggle_skip_playback ();
1446 void remove_last_capture ();
1447 void select_all_selectables_using_time_selection ();
1448 void select_all_selectables_using_loop();
1449 void select_all_selectables_using_punch();
1450 void set_selection_from_range (ARDOUR::Location&);
1451 void set_selection_from_punch ();
1452 void set_selection_from_loop ();
1453 void set_selection_from_region ();
1455 void add_location_mark (framepos_t where);
1456 void add_location_from_region ();
1457 void add_locations_from_region ();
1458 void add_location_from_selection ();
1459 void set_loop_from_selection (bool play);
1460 void set_punch_from_selection ();
1461 void set_punch_from_region ();
1462 void set_auto_punch_range();
1464 void set_session_start_from_playhead ();
1465 void set_session_end_from_playhead ();
1466 void set_session_extents_from_selection ();
1468 void set_loop_from_region (bool play);
1470 void set_loop_range (framepos_t start, framepos_t end, std::string cmd);
1471 void set_punch_range (framepos_t start, framepos_t end, std::string cmd);
1473 void toggle_location_at_playhead_cursor ();
1474 void add_location_from_playhead_cursor ();
1475 bool do_remove_location_at_playhead_cursor ();
1476 void remove_location_at_playhead_cursor ();
1477 bool select_new_marker;
1479 void reverse_selection ();
1480 void edit_envelope ();
1482 double last_scrub_x;
1483 int scrubbing_direction;
1484 int scrub_reversals;
1485 int scrub_reverse_distance;
1486 void scrub (framepos_t, double);
1488 void set_punch_start_from_edit_point ();
1489 void set_punch_end_from_edit_point ();
1490 void set_loop_start_from_edit_point ();
1491 void set_loop_end_from_edit_point ();
1493 void keyboard_selection_begin ( Editing::EditIgnoreOption = Editing::EDIT_IGNORE_NONE );
1494 void keyboard_selection_finish (bool add, Editing::EditIgnoreOption = Editing::EDIT_IGNORE_NONE);
1495 bool have_pending_keyboard_selection;
1496 framepos_t pending_keyboard_selection_start;
1498 void move_range_selection_start_or_end_to_region_boundary (bool, bool);
1500 Editing::SnapType _snap_type;
1501 Editing::SnapMode _snap_mode;
1503 /// Snap threshold in pixels
1504 double snap_threshold;
1506 bool ignore_gui_changes;
1508 DragManager* _drags;
1513 Gtk::Dialog* lock_dialog;
1515 struct timeval last_event_time;
1516 bool generic_event_handler (GdkEvent*);
1517 bool lock_timeout_callback ();
1518 void start_lock_event_timing ();
1520 Gtk::Menu fade_context_menu;
1522 Gtk::Menu xfade_in_context_menu;
1523 Gtk::Menu xfade_out_context_menu;
1524 void popup_xfade_in_context_menu (int, int, ArdourCanvas::Item*, ItemType);
1525 void popup_xfade_out_context_menu (int, int, ArdourCanvas::Item*, ItemType);
1526 void fill_xfade_menu (Gtk::Menu_Helpers::MenuList& items, bool start);
1528 void set_fade_in_shape (ARDOUR::FadeShape);
1529 void set_fade_out_shape (ARDOUR::FadeShape);
1531 void set_fade_length (bool in);
1532 void set_fade_in_active (bool);
1533 void set_fade_out_active (bool);
1537 std::set<boost::shared_ptr<ARDOUR::Playlist> > motion_frozen_playlists;
1539 bool _dragging_playhead;
1540 bool _dragging_edit_point;
1542 void marker_drag_motion_callback (GdkEvent*);
1543 void marker_drag_finished_callback (GdkEvent*);
1545 gint mouse_rename_region (ArdourCanvas::Item*, GdkEvent*);
1547 void add_region_drag (ArdourCanvas::Item*, GdkEvent*, RegionView*);
1548 void start_create_region_grab (ArdourCanvas::Item*, GdkEvent*);
1549 void add_region_copy_drag (ArdourCanvas::Item*, GdkEvent*, RegionView*);
1550 void add_region_brush_drag (ArdourCanvas::Item*, GdkEvent*, RegionView*);
1551 void start_selection_grab (ArdourCanvas::Item*, GdkEvent*);
1553 void region_view_item_click (AudioRegionView&, GdkEventButton*);
1555 bool can_remove_control_point (ArdourCanvas::Item *);
1556 void remove_control_point (ArdourCanvas::Item *);
1558 void mouse_brush_insert_region (RegionView*, framepos_t pos);
1560 /* Canvas event handlers */
1562 bool canvas_scroll_event (GdkEventScroll* event, bool from_canvas);
1563 bool canvas_control_point_event (GdkEvent* event,ArdourCanvas::Item*, ControlPoint*);
1564 bool canvas_line_event (GdkEvent* event,ArdourCanvas::Item*, AutomationLine*);
1565 bool canvas_selection_rect_event (GdkEvent* event,ArdourCanvas::Item*, SelectionRect*);
1566 bool canvas_selection_start_trim_event (GdkEvent* event,ArdourCanvas::Item*, SelectionRect*);
1567 bool canvas_selection_end_trim_event (GdkEvent* event,ArdourCanvas::Item*, SelectionRect*);
1568 bool canvas_start_xfade_event (GdkEvent* event,ArdourCanvas::Item*, AudioRegionView*);
1569 bool canvas_end_xfade_event (GdkEvent* event,ArdourCanvas::Item*, AudioRegionView*);
1570 bool canvas_fade_in_event (GdkEvent* event,ArdourCanvas::Item*, AudioRegionView*);
1571 bool canvas_fade_in_handle_event (GdkEvent* event,ArdourCanvas::Item*, AudioRegionView*, bool trim = false);
1572 bool canvas_fade_out_event (GdkEvent* event,ArdourCanvas::Item*, AudioRegionView*);
1573 bool canvas_fade_out_handle_event (GdkEvent* event,ArdourCanvas::Item*, AudioRegionView*, bool trim = false);
1574 bool canvas_region_view_event (GdkEvent* event,ArdourCanvas::Item*, RegionView*);
1575 bool canvas_wave_view_event (GdkEvent* event,ArdourCanvas::Item*, RegionView*);
1576 bool canvas_frame_handle_event (GdkEvent* event,ArdourCanvas::Item*, RegionView*);
1577 bool canvas_region_view_name_highlight_event (GdkEvent* event,ArdourCanvas::Item*, RegionView*);
1578 bool canvas_region_view_name_event (GdkEvent* event,ArdourCanvas::Item*, RegionView*);
1579 bool canvas_feature_line_event (GdkEvent* event, ArdourCanvas::Item*, RegionView*);
1580 bool canvas_stream_view_event (GdkEvent* event,ArdourCanvas::Item*, RouteTimeAxisView*);
1581 bool canvas_marker_event (GdkEvent* event,ArdourCanvas::Item*, ArdourMarker*);
1582 bool canvas_tempo_marker_event (GdkEvent* event,ArdourCanvas::Item*, TempoMarker*);
1583 bool canvas_tempo_curve_event (GdkEvent* event,ArdourCanvas::Item*, TempoCurve*);
1584 bool canvas_meter_marker_event (GdkEvent* event,ArdourCanvas::Item*, MeterMarker*);
1585 bool canvas_automation_track_event(GdkEvent* event, ArdourCanvas::Item*, AutomationTimeAxisView*);
1586 bool canvas_note_event (GdkEvent* event, ArdourCanvas::Item *);
1588 bool canvas_ruler_event (GdkEvent* event, ArdourCanvas::Item *, ItemType);
1589 bool canvas_tempo_bar_event (GdkEvent* event, ArdourCanvas::Item*);
1590 bool canvas_meter_bar_event (GdkEvent* event, ArdourCanvas::Item*);
1591 bool canvas_marker_bar_event (GdkEvent* event, ArdourCanvas::Item*);
1592 bool canvas_range_marker_bar_event (GdkEvent* event, ArdourCanvas::Item*);
1593 bool canvas_transport_marker_bar_event (GdkEvent* event, ArdourCanvas::Item*);
1594 bool canvas_cd_marker_bar_event (GdkEvent* event, ArdourCanvas::Item*);
1596 bool canvas_videotl_bar_event (GdkEvent* event, ArdourCanvas::Item*);
1597 void update_video_timeline (bool flush = false);
1598 void set_video_timeline_height (const int);
1599 bool is_video_timeline_locked ();
1600 void toggle_video_timeline_locked ();
1601 void set_video_timeline_locked (const bool);
1602 void queue_visual_videotimeline_update ();
1603 void embed_audio_from_video (std::string, framepos_t n = 0, bool lock_position_to_video = true);
1605 PBD::Signal0<void> EditorFreeze;
1606 PBD::Signal0<void> EditorThaw;
1609 friend class DragManager;
1610 friend class EditorRouteGroups;
1611 friend class EditorRegions;
1613 /* non-public event handlers */
1615 bool canvas_playhead_cursor_event (GdkEvent* event, ArdourCanvas::Item*);
1616 bool track_canvas_scroll (GdkEventScroll* event);
1618 bool track_canvas_button_press_event (GdkEventButton* event);
1619 bool track_canvas_button_release_event (GdkEventButton* event);
1620 bool track_canvas_motion_notify_event (GdkEventMotion* event);
1622 Gtk::Allocation _canvas_viewport_allocation;
1623 void track_canvas_viewport_allocate (Gtk::Allocation alloc);
1624 void track_canvas_viewport_size_allocated ();
1625 bool track_canvas_drag_motion (Glib::RefPtr<Gdk::DragContext> const &, int, int, guint);
1626 bool track_canvas_key_press (GdkEventKey *);
1627 bool track_canvas_key_release (GdkEventKey *);
1629 void set_playhead_cursor ();
1631 void toggle_region_mute ();
1633 void initialize_canvas ();
1635 void set_script_action_name (int i, const std::string&);
1637 /* display control */
1639 bool _show_measures;
1640 /// true if the editor should follow the playhead, otherwise false
1641 bool _follow_playhead;
1642 /// true if we scroll the tracks rather than the playhead
1643 bool _stationary_playhead;
1644 /// true if we are in fullscreen mode
1647 TempoLines* tempo_lines;
1649 ArdourCanvas::Container* global_rect_group;
1650 ArdourCanvas::Container* time_line_group;
1652 void hide_measures ();
1653 void draw_measures (std::vector<ARDOUR::TempoMap::BBTPoint>&);
1655 void new_tempo_section ();
1658 void remove_tempo_marker (ArdourCanvas::Item*);
1659 void remove_meter_marker (ArdourCanvas::Item*);
1660 gint real_remove_tempo_marker (ARDOUR::TempoSection*);
1661 gint real_remove_meter_marker (ARDOUR::MeterSection*);
1663 void edit_tempo_marker (TempoMarker&);
1664 void edit_meter_marker (MeterMarker&);
1665 void edit_control_point (ArdourCanvas::Item*);
1666 void edit_notes (MidiRegionView*);
1667 void edit_region (RegionView*);
1669 void edit_current_meter ();
1670 void edit_current_tempo ();
1672 void marker_menu_edit ();
1673 void marker_menu_remove ();
1674 void marker_menu_rename ();
1675 void rename_marker (ArdourMarker *marker);
1676 void toggle_marker_lock_style ();
1677 void toggle_tempo_type ();
1678 void toggle_marker_menu_lock ();
1679 void toggle_marker_menu_glue ();
1680 void marker_menu_hide ();
1681 void marker_menu_loop_range ();
1682 void marker_menu_select_all_selectables_using_range ();
1683 void marker_menu_select_using_range ();
1684 void marker_menu_separate_regions_using_location ();
1685 void marker_menu_play_from ();
1686 void marker_menu_play_range ();
1687 void marker_menu_set_playhead ();
1688 void marker_menu_set_from_playhead ();
1689 void marker_menu_set_from_selection (bool force_regions);
1690 void marker_menu_range_to_next ();
1691 void marker_menu_zoom_to_range ();
1692 void new_transport_marker_menu_set_loop ();
1693 void new_transport_marker_menu_set_punch ();
1694 void update_loop_range_view ();
1695 void update_punch_range_view ();
1696 void new_transport_marker_menu_popdown ();
1697 void marker_context_menu (GdkEventButton*, ArdourCanvas::Item*);
1698 void tempo_or_meter_marker_context_menu (GdkEventButton*, ArdourCanvas::Item*);
1699 void new_transport_marker_context_menu (GdkEventButton*, ArdourCanvas::Item*);
1700 void build_range_marker_menu (bool, bool);
1701 void build_marker_menu (ARDOUR::Location *);
1702 void build_tempo_marker_menu (TempoMarker *, bool);
1703 void build_meter_marker_menu (MeterMarker *, bool);
1704 void build_new_transport_marker_menu ();
1705 void dynamic_cast_marker_object (void*, MeterMarker**, TempoMarker**) const;
1707 Gtk::Menu* tempo_marker_menu;
1708 Gtk::Menu* meter_marker_menu;
1709 Gtk::Menu* marker_menu;
1710 Gtk::Menu* range_marker_menu;
1711 Gtk::Menu* transport_marker_menu;
1712 Gtk::Menu* new_transport_marker_menu;
1713 Gtk::Menu* cd_marker_menu;
1714 ArdourCanvas::Item* marker_menu_item;
1716 typedef std::list<ArdourMarker*> Marks;
1719 typedef std::list<TempoCurve*> Curves;
1720 Curves tempo_curves;
1722 void remove_metric_marks ();
1723 void draw_metric_marks (const ARDOUR::Metrics& metrics);
1725 void compute_current_bbt_points (std::vector<ARDOUR::TempoMap::BBTPoint>& grid, framepos_t left, framepos_t right);
1727 void tempo_map_changed (const PBD::PropertyChange&);
1728 void marker_position_changed ();
1729 void redisplay_tempo (bool immediate_redraw);
1731 uint32_t bbt_beat_subdivision;
1735 Gtk::ToggleButton editor_mixer_button;
1736 Gtk::ToggleButton editor_list_button;
1737 void editor_mixer_button_toggled ();
1738 void editor_list_button_toggled ();
1740 ArdourButton zoom_in_button;
1741 ArdourButton zoom_out_button;
1742 ArdourButton zoom_out_full_button;
1744 ArdourButton tav_expand_button;
1745 ArdourButton tav_shrink_button;
1746 ArdourDropdown visible_tracks_selector;
1747 ArdourDropdown zoom_preset_selector;
1749 int32_t _visible_track_count;
1750 void build_track_count_menu ();
1751 void set_visible_track_count (int32_t);
1753 void set_zoom_preset(int64_t);
1755 Gtk::VBox toolbar_clock_vbox;
1756 Gtk::VBox toolbar_selection_clock_vbox;
1757 Gtk::Table toolbar_selection_clock_table;
1758 Gtk::Label toolbar_selection_cursor_label;
1760 ArdourButton mouse_select_button;
1761 ArdourButton mouse_draw_button;
1762 ArdourButton mouse_move_button;
1763 ArdourButton mouse_timefx_button;
1764 ArdourButton mouse_content_button;
1765 ArdourButton mouse_audition_button;
1766 ArdourButton mouse_cut_button;
1768 ArdourButton smart_mode_button;
1769 Glib::RefPtr<Gtk::ToggleAction> smart_mode_action;
1771 void mouse_mode_toggled (Editing::MouseMode m);
1772 void mouse_mode_object_range_toggled ();
1773 bool ignore_mouse_mode_toggle;
1775 bool mouse_select_button_release (GdkEventButton*);
1777 Gtk::VBox automation_box;
1778 Gtk::Button automation_mode_button;
1780 //edit mode menu stuff
1781 ArdourDropdown edit_mode_selector;
1782 void edit_mode_selection_done ( ARDOUR::EditMode m );
1783 void build_edit_mode_menu ();
1784 Gtk::VBox edit_mode_box;
1786 void set_edit_mode (ARDOUR::EditMode);
1787 void cycle_edit_mode ();
1789 ArdourDropdown snap_type_selector;
1790 void build_snap_type_menu ();
1792 ArdourDropdown snap_mode_selector;
1793 void build_snap_mode_menu ();
1796 std::vector<std::string> snap_type_strings;
1797 std::vector<std::string> snap_mode_strings;
1799 void snap_type_selection_done (Editing::SnapType);
1800 void snap_mode_selection_done (Editing::SnapMode);
1801 void snap_mode_chosen (Editing::SnapMode);
1802 void snap_type_chosen (Editing::SnapType);
1804 Glib::RefPtr<Gtk::RadioAction> snap_type_action (Editing::SnapType);
1805 Glib::RefPtr<Gtk::RadioAction> snap_mode_action (Editing::SnapMode);
1807 //zoom focus meu stuff
1808 ArdourDropdown zoom_focus_selector;
1809 void zoom_focus_selection_done ( Editing::ZoomFocus f );
1810 void build_zoom_focus_menu ();
1811 std::vector<std::string> zoom_focus_strings;
1813 void zoom_focus_chosen (Editing::ZoomFocus);
1815 Glib::RefPtr<Gtk::RadioAction> zoom_focus_action (Editing::ZoomFocus);
1817 Gtk::HBox _track_box;
1819 Gtk::HBox _zoom_box;
1820 void zoom_adjustment_changed();
1822 void setup_toolbar ();
1824 void setup_tooltips ();
1826 Gtk::HBox toolbar_hbox;
1828 void setup_midi_toolbar ();
1830 /* selection process */
1832 Selection* selection;
1833 Selection* cut_buffer;
1834 SelectionMemento* _selection_memento;
1836 void time_selection_changed ();
1837 void update_time_selection_display ();
1838 void track_selection_changed ();
1839 void region_selection_changed ();
1840 sigc::connection editor_regions_selection_changed_connection;
1841 void sensitize_all_region_actions (bool);
1842 void sensitize_the_right_region_actions ();
1843 bool _all_region_actions_sensitized;
1844 /** Flag to block region action handlers from doing what they normally do;
1845 * I tried Gtk::Action::block_activate() but this doesn't work (ie it doesn't
1846 * block) when setting a ToggleAction's active state.
1848 bool _ignore_region_action;
1849 bool _last_region_menu_was_main;
1850 void point_selection_changed ();
1851 void marker_selection_changed ();
1853 void cancel_selection ();
1854 void cancel_time_selection ();
1856 bool get_smart_mode() const;
1858 bool audio_region_selection_covers (framepos_t where);
1860 /* transport range select process */
1862 ArdourCanvas::Rectangle* cd_marker_bar_drag_rect;
1863 ArdourCanvas::Rectangle* range_bar_drag_rect;
1864 ArdourCanvas::Rectangle* transport_bar_drag_rect;
1865 ArdourCanvas::Rectangle *transport_bar_range_rect;
1866 ArdourCanvas::Rectangle *transport_bar_preroll_rect;
1867 ArdourCanvas::Rectangle *transport_bar_postroll_rect;
1868 ArdourCanvas::Rectangle *transport_loop_range_rect;
1869 ArdourCanvas::Rectangle *transport_punch_range_rect;
1870 ArdourCanvas::Line *transport_punchin_line;
1871 ArdourCanvas::Line *transport_punchout_line;
1872 ArdourCanvas::Rectangle *transport_preroll_rect;
1873 ArdourCanvas::Rectangle *transport_postroll_rect;
1875 ARDOUR::Location* transport_loop_location();
1876 ARDOUR::Location* transport_punch_location();
1878 ARDOUR::Location *temp_location;
1880 /* object rubberband select process */
1882 void select_all_within (framepos_t, framepos_t, double, double, TrackViewList const &, Selection::Operation, bool);
1884 ArdourCanvas::Rectangle *rubberband_rect;
1886 EditorRouteGroups* _route_groups;
1887 EditorRoutes* _routes;
1888 EditorRegions* _regions;
1889 EditorSnapshots* _snapshots;
1890 EditorLocations* _locations;
1892 /* diskstream/route display management */
1893 Glib::RefPtr<Gdk::Pixbuf> rec_enabled_icon;
1894 Glib::RefPtr<Gdk::Pixbuf> rec_disabled_icon;
1896 Glib::RefPtr<Gtk::TreeSelection> route_display_selection;
1898 bool sync_track_view_list_and_routes ();
1900 Gtk::VBox list_vpacker;
1904 sigc::connection autoscroll_connection;
1905 bool autoscroll_horizontal_allowed;
1906 bool autoscroll_vertical_allowed;
1907 uint32_t autoscroll_cnt;
1908 Gtk::Widget* autoscroll_widget;
1909 ArdourCanvas::Rect autoscroll_boundary;
1911 bool autoscroll_canvas ();
1912 void start_canvas_autoscroll (bool allow_horiz, bool allow_vert, const ArdourCanvas::Rect& boundary);
1913 void stop_canvas_autoscroll ();
1916 void point_trim (GdkEvent *, framepos_t);
1918 void trim_region_front();
1919 void trim_region_back();
1920 void trim_region (bool front);
1922 void trim_region_to_loop ();
1923 void trim_region_to_punch ();
1924 void trim_region_to_location (const ARDOUR::Location&, const char* cmd);
1926 void trim_to_region(bool forward);
1927 void trim_region_to_previous_region_end();
1928 void trim_region_to_next_region_start();
1930 bool show_gain_after_trim;
1934 int convert_drop_to_paths (
1935 std::vector<std::string>& paths,
1936 const Glib::RefPtr<Gdk::DragContext>& context,
1939 const Gtk::SelectionData& data,
1943 void track_canvas_drag_data_received (
1944 const Glib::RefPtr<Gdk::DragContext>& context,
1947 const Gtk::SelectionData& data,
1952 const Glib::RefPtr<Gdk::DragContext>& context,
1955 const Gtk::SelectionData& data,
1960 const Glib::RefPtr<Gdk::DragContext>& context,
1963 const Gtk::SelectionData& data,
1968 const Glib::RefPtr<Gdk::DragContext>& context,
1971 const Gtk::SelectionData& data,
1977 int write_region_selection(RegionSelection&);
1978 bool write_region (std::string path, boost::shared_ptr<ARDOUR::AudioRegion>);
1979 void bounce_region_selection (bool with_processing);
1980 void bounce_range_selection (bool replace, bool enable_processing);
1981 void external_edit_region ();
1983 int write_audio_selection (TimeSelection&);
1984 bool write_audio_range (ARDOUR::AudioPlaylist&, const ARDOUR::ChanCount& channels, std::list<ARDOUR::AudioRange>&);
1986 void write_selection ();
1988 uint32_t selection_op_cmd_depth;
1989 uint32_t selection_op_history_it;
1991 std::list<XMLNode *> selection_op_history; /* used in *_reversible_selection_op */
1992 std::list<XMLNode *> before; /* used in *_reversible_command */
1994 void update_title ();
1995 void update_title_s (const std::string & snapshot_name);
1997 void instant_save ();
1998 bool no_save_instant;
2000 boost::shared_ptr<ARDOUR::AudioRegion> last_audition_region;
2002 /* freeze operations */
2004 ARDOUR::InterThreadInfo freeze_status;
2005 static void* _freeze_thread (void*);
2006 void* freeze_thread ();
2008 void freeze_route ();
2009 void unfreeze_route ();
2013 void duplicate_range (bool with_dialog);
2014 void duplicate_regions (float times);
2016 /** computes the timeline frame (sample) of an event whose coordinates
2017 * are in canvas units (pixels, scroll offset included).
2019 framepos_t canvas_event_sample (GdkEvent const *, double* px = 0, double* py = 0) const;
2021 /** computes the timeline frame (sample) of an event whose coordinates
2022 * are in window units (pixels, no scroll offset).
2024 framepos_t window_event_sample (GdkEvent const *, double* px = 0, double* py = 0) const;
2026 /* returns false if mouse pointer is not in track or marker canvas
2028 bool mouse_frame (framepos_t&, bool& in_track_canvas) const;
2030 TimeFXDialog* current_timefx;
2031 static void* timefx_thread (void *arg);
2034 int time_stretch (RegionSelection&, float fraction);
2035 int pitch_shift (RegionSelection&, float cents);
2036 void pitch_shift_region ();
2038 /* editor-mixer strip */
2040 MixerStrip *current_mixer_strip;
2041 bool show_editor_mixer_when_tracks_arrive;
2042 Gtk::VBox current_mixer_strip_vbox;
2043 void cms_new (boost::shared_ptr<ARDOUR::Route>);
2044 void current_mixer_strip_hidden ();
2047 void ensure_all_elements_drawn ();
2049 /* nudging tracks */
2051 void nudge_track (bool use_edit_point, bool forwards);
2053 static const int32_t default_width = 995;
2054 static const int32_t default_height = 765;
2058 ArdourButton nudge_forward_button;
2059 ArdourButton nudge_backward_button;
2060 Gtk::HBox nudge_hbox;
2061 Gtk::VBox nudge_vbox;
2062 AudioClock* nudge_clock;
2064 bool nudge_forward_release (GdkEventButton*);
2065 bool nudge_backward_release (GdkEventButton*);
2069 void apply_filter (ARDOUR::Filter&, std::string cmd, ProgressReporter* progress = 0);
2071 Command* apply_midi_note_edit_op_to_region (ARDOUR::MidiOperator& op, MidiRegionView& mrv);
2072 void apply_midi_note_edit_op (ARDOUR::MidiOperator& op, const RegionSelection& rs);
2074 /* handling cleanup */
2076 int playlist_deletion_dialog (boost::shared_ptr<ARDOUR::Playlist>);
2078 PBD::ScopedConnectionList session_connections;
2080 /* tracking step changes of track height */
2082 TimeAxisView* current_stepping_trackview;
2083 ARDOUR::microseconds_t last_track_height_step_timestamp;
2084 gint track_height_step_timeout();
2085 sigc::connection step_timeout;
2087 TimeAxisView* entered_track;
2088 /** If the mouse is over a RegionView or one of its child canvas items, this is set up
2089 to point to the RegionView. Otherwise it is 0.
2091 RegionView* entered_regionview;
2093 std::vector<EnterContext> _enter_stack;
2095 bool clear_entered_track;
2096 bool left_track_canvas (GdkEventCrossing*);
2097 bool entered_track_canvas (GdkEventCrossing*);
2098 void set_entered_track (TimeAxisView*);
2099 void set_entered_regionview (RegionView*);
2100 gint left_automation_track ();
2102 void reset_canvas_action_sensitivity (bool);
2103 void set_gain_envelope_visibility ();
2104 void set_region_gain_visibility (RegionView*);
2105 void toggle_gain_envelope_active ();
2106 void reset_region_gain_envelopes ();
2108 void session_state_saved (std::string);
2110 Glib::RefPtr<Gtk::Action> undo_action;
2111 Glib::RefPtr<Gtk::Action> redo_action;
2112 Glib::RefPtr<Gtk::Action> alternate_redo_action;
2113 Glib::RefPtr<Gtk::Action> alternate_alternate_redo_action;
2114 Glib::RefPtr<Gtk::Action> selection_undo_action;
2115 Glib::RefPtr<Gtk::Action> selection_redo_action;
2117 void history_changed ();
2119 Editing::EditPoint _edit_point;
2121 ArdourDropdown edit_point_selector;
2122 void build_edit_point_menu();
2124 void set_edit_point_preference (Editing::EditPoint ep, bool force = false);
2125 void cycle_edit_point (bool with_marker);
2126 void set_edit_point ();
2127 void edit_point_selection_done (Editing::EditPoint);
2128 void edit_point_chosen (Editing::EditPoint);
2129 Glib::RefPtr<Gtk::RadioAction> edit_point_action (Editing::EditPoint);
2130 std::vector<std::string> edit_point_strings;
2131 std::vector<std::string> edit_mode_strings;
2133 void selected_marker_moved (ARDOUR::Location*);
2135 bool get_edit_op_range (framepos_t& start, framepos_t& end) const;
2137 void get_regions_at (RegionSelection&, framepos_t where, const TrackViewList& ts) const;
2138 void get_regions_after (RegionSelection&, framepos_t where, const TrackViewList& ts) const;
2140 RegionSelection get_regions_from_selection_and_edit_point ();
2141 RegionSelection get_regions_from_selection_and_entered () const;
2143 void start_updating_meters ();
2144 void stop_updating_meters ();
2145 bool meters_running;
2147 void select_next_route ();
2148 void select_prev_route ();
2150 void snap_to_internal (framepos_t& first,
2151 ARDOUR::RoundMode direction = ARDOUR::RoundNearest,
2152 bool for_mark = false,
2153 bool ensure_snap = false);
2155 void timecode_snap_to_internal (framepos_t& first,
2156 ARDOUR::RoundMode direction = ARDOUR::RoundNearest,
2157 bool for_mark = false);
2159 RhythmFerret* rhythm_ferret;
2161 void fit_tracks (TrackViewList &);
2162 void fit_selection ();
2163 void set_track_height (Height);
2165 void _remove_tracks ();
2166 bool idle_remove_tracks ();
2167 void toggle_tracks_active ();
2171 static gboolean _idle_resize (gpointer);
2173 int32_t _pending_resize_amount;
2174 TimeAxisView* _pending_resize_view;
2176 void visible_order_range (int*, int*) const;
2180 /** true if we've made a locate request that hasn't yet been processed */
2181 bool _pending_locate_request;
2183 /** if true, there is a pending Session locate which is the initial one when loading a session;
2184 we need to know this so that we don't (necessarily) set the viewport to show the playhead
2187 bool _pending_initial_locate;
2189 Gtk::HBox _summary_hbox;
2190 EditorSummary* _summary;
2192 void region_view_added (RegionView *);
2193 void region_view_removed ();
2195 EditorGroupTabs* _group_tabs;
2196 void fit_route_group (ARDOUR::RouteGroup *);
2198 void step_edit_status_change (bool);
2199 void start_step_editing ();
2200 void stop_step_editing ();
2201 bool check_step_edit ();
2202 sigc::connection step_edit_connection;
2204 double _last_motion_y;
2206 RegionLayeringOrderEditor* layering_order_editor;
2207 void update_region_layering_order_editor ();
2209 /** Track that was the source for the last cut/copy operation. Used as a place
2210 to paste things iff there is no selected track.
2212 TimeAxisView* _last_cut_copy_source_track;
2214 /** true if a change in Selection->regions should change the selection in the region list.
2215 See EditorRegions::selection_changed.
2217 bool _region_selection_change_updates_region_list;
2219 void setup_fade_images ();
2220 std::map<ARDOUR::FadeShape, Gtk::Image*> _fade_in_images;
2221 std::map<ARDOUR::FadeShape, Gtk::Image*> _fade_out_images;
2222 std::map<ARDOUR::FadeShape, Gtk::Image*> _xfade_in_images;
2223 std::map<ARDOUR::FadeShape, Gtk::Image*> _xfade_out_images;
2225 Gtk::MenuItem& action_menu_item (std::string const &);
2226 void action_pre_activated (Glib::RefPtr<Gtk::Action> const &);
2228 MouseCursors* _cursors;
2230 void follow_mixer_selection ();
2231 bool _following_mixer_selection;
2233 int time_fx (ARDOUR::RegionList&, float val, bool pitching);
2234 void note_edit_done (int, EditNoteDialog*);
2235 void toggle_sound_midi_notes ();
2237 /** Flag for a bit of a hack wrt control point selection; see set_selected_control_point_from_click */
2238 bool _control_point_toggled_on_press;
2240 /** This is used by TimeAxisView to keep a track of the TimeAxisView that is currently being
2241 stepped in height using ScrollZoomVerticalModifier+Scrollwheel. When a scroll event
2242 occurs, we do the step on this _stepping_axis_view if it is non-0 (and we set up this
2243 _stepping_axis_view with the TimeAxisView underneath the mouse if it is 0). Then Editor
2244 resets _stepping_axis_view when the modifier key is released. In this (hacky) way,
2245 pushing the modifier key and moving the scroll wheel will operate on the same track
2246 until the key is released (rather than skipping about to whatever happens to be
2247 underneath the mouse at the time).
2249 TimeAxisView* _stepping_axis_view;
2250 void zoom_vertical_modifier_released();
2252 void bring_in_callback (Gtk::Label*, uint32_t n, uint32_t total, std::string name);
2253 void update_bring_in_message (Gtk::Label* label, uint32_t n, uint32_t total, std::string name);
2254 void bring_all_sources_into_session ();
2256 QuantizeDialog* quantize_dialog;
2257 MainMenuDisabler* _main_menu_disabler;
2259 /* private helper functions to help with registering axis */
2261 Glib::RefPtr<Gtk::Action> reg_sens (Glib::RefPtr<Gtk::ActionGroup> group, char const * name, char const * label, sigc::slot<void> slot);
2262 void toggle_reg_sens (Glib::RefPtr<Gtk::ActionGroup> group, char const * name, char const * label, sigc::slot<void> slot);
2263 void radio_reg_sens (Glib::RefPtr<Gtk::ActionGroup> action_group, Gtk::RadioAction::Group& radio_group, char const * name, char const * label, sigc::slot<void> slot);
2265 Gtkmm2ext::ActionMap myactions;
2268 friend class RegionCutDrag;
2269 friend class RegionDrag;
2270 friend class RegionMoveDrag;
2271 friend class RegionSpliceDrag;
2272 friend class RegionRippleDrag;
2273 friend class TrimDrag;
2274 friend class BBTRulerDrag;
2275 friend class MeterMarkerDrag;
2276 friend class TempoMarkerDrag;
2277 friend class CursorDrag;
2278 friend class FadeInDrag;
2279 friend class FadeOutDrag;
2280 friend class MarkerDrag;
2281 friend class RegionGainDrag;
2282 friend class ControlPointDrag;
2283 friend class LineDrag;
2284 friend class RubberbandSelectDrag;
2285 friend class RulerZoomDrag;
2286 friend class EditorRubberbandSelectDrag;
2287 friend class TimeFXDrag;
2288 friend class ScrubDrag;
2289 friend class SelectionDrag;
2290 friend class RangeMarkerBarDrag;
2291 friend class MouseZoomDrag;
2292 friend class RegionCreateDrag;
2293 friend class RegionMotionDrag;
2294 friend class RegionInsertDrag;
2295 friend class VideoTimeLineDrag;
2297 friend class EditorSummary;
2298 friend class EditorGroupTabs;
2300 friend class EditorRoutes;
2301 friend class RhythmFerret;
2304 #endif /* __ardour_editor_h__ */