2 Copyright (C) 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.
22 #include "pbd/error.h"
23 #include "pbd/stacktrace.h"
25 #include "ardour/types.h"
26 #include "ardour/ardour.h"
28 #include "gtkmm2ext/utils.h"
29 #include "gtkmm2ext/gui_thread.h"
31 #include "canvas/container.h"
32 #include "canvas/rectangle.h"
33 #include "canvas/debug.h"
34 #include "canvas/text.h"
35 #include "canvas/colors.h"
37 #include "ardour/profile.h"
39 #include "public_editor.h"
40 #include "time_axis_view_item.h"
41 #include "time_axis_view.h"
42 #include "ui_config.h"
44 #include "rgb_macros.h"
49 using namespace Editing;
52 using namespace ARDOUR;
53 using namespace ARDOUR_UI_UTILS;
54 using namespace Gtkmm2ext;
56 Pango::FontDescription TimeAxisViewItem::NAME_FONT;
57 const double TimeAxisViewItem::NAME_X_OFFSET = 15.0;
58 const double TimeAxisViewItem::GRAB_HANDLE_TOP = 0.0;
59 const double TimeAxisViewItem::GRAB_HANDLE_WIDTH = 10.0;
61 int TimeAxisViewItem::NAME_HEIGHT;
62 double TimeAxisViewItem::NAME_Y_OFFSET;
63 double TimeAxisViewItem::NAME_HIGHLIGHT_SIZE;
64 double TimeAxisViewItem::NAME_HIGHLIGHT_THRESH;
67 TimeAxisViewItem::set_constant_heights ()
69 NAME_FONT = Pango::FontDescription (UIConfiguration::instance().get_SmallFont());
75 Glib::RefPtr<Pango::Layout> layout = foo.create_pango_layout (X_("Hg")); /* ascender + descender */
79 layout->set_font_description (NAME_FONT);
80 get_pixel_size (layout, width, height);
82 layout = foo.create_pango_layout (X_("H")); /* just the ascender */
86 /* Config->get_show_name_highlight) == true:
87 Y_OFFSET is measured from bottom of the time axis view item.
88 Config->get_show_name_highlight) == false:
89 Y_OFFSET is measured from the top of the time axis view item.
92 if (UIConfiguration::instance().get_show_name_highlight()) {
93 NAME_Y_OFFSET = height + 1;
94 NAME_HIGHLIGHT_SIZE = height + 2;
97 NAME_HIGHLIGHT_SIZE = 0;
99 NAME_HIGHLIGHT_THRESH = NAME_HIGHLIGHT_SIZE * 3;
103 * Construct a new TimeAxisViewItem.
105 * @param it_name the unique name of this item
106 * @param parent the parent canvas group
107 * @param tv the TimeAxisView we are going to be added to
108 * @param spu samples per unit
110 * @param start the start point of this item
111 * @param duration the duration of this item
112 * @param recording true if this is a recording region view
113 * @param automation true if this is an automation region view
115 TimeAxisViewItem::TimeAxisViewItem(
116 const string & it_name, ArdourCanvas::Item& parent, TimeAxisView& tv, double spu, uint32_t base_color,
117 framepos_t start, framecnt_t duration, bool recording, bool automation, Visibility vis
120 , frame_position (-1)
121 , item_name (it_name)
122 , selection_frame (0)
124 , _recregion (recording)
125 , _automation (automation)
129 init (&parent, spu, base_color, start, duration, vis, true, true);
132 TimeAxisViewItem::TimeAxisViewItem (const TimeAxisViewItem& other)
135 , PBD::ScopedConnectionList()
136 , trackview (other.trackview)
137 , frame_position (-1)
138 , item_name (other.item_name)
139 , selection_frame (0)
141 , _recregion (other._recregion)
142 , _automation (other._automation)
143 , _dragging (other._dragging)
146 /* share the other's parent, but still create a new group */
148 ArdourCanvas::Item* parent = other.group->parent();
150 _selected = other._selected;
152 init (parent, other.samples_per_pixel, other.fill_color, other.frame_position,
153 other.item_duration, other.visibility, other.wide_enough_for_name, other.high_enough_for_name);
157 TimeAxisViewItem::init (ArdourCanvas::Item* parent, double fpp, uint32_t base_color,
158 framepos_t start, framepos_t duration, Visibility vis,
159 bool wide, bool high)
161 group = new ArdourCanvas::Container (parent);
162 CANVAS_DEBUG_NAME (group, string_compose ("TAVI group for %1", get_item_name()));
163 group->Event.connect (sigc::mem_fun (*this, &TimeAxisViewItem::canvas_group_event));
165 fill_color = base_color;
166 fill_color_name = "time axis view item base";
167 samples_per_pixel = fpp;
168 frame_position = start;
169 item_duration = duration;
170 name_connected = false;
171 position_locked = false;
172 max_item_duration = ARDOUR::max_framepos;
173 min_item_duration = 0;
174 show_vestigial = false;
179 wide_enough_for_name = wide;
180 high_enough_for_name = high;
184 warning << "Time Axis Item Duration == 0" << endl;
187 if (visibility & ShowFrame) {
188 frame = new ArdourCanvas::Rectangle (group,
189 ArdourCanvas::Rect (0.0, 0.0,
190 trackview.editor().sample_to_pixel(duration),
191 trackview.current_height()));
193 frame->set_outline_what (ArdourCanvas::Rectangle::What (ArdourCanvas::Rectangle::LEFT|ArdourCanvas::Rectangle::RIGHT));
196 CANVAS_DEBUG_NAME (frame, string_compose ("frame for %1", get_item_name()));
199 frame->set_outline_color (UIConfiguration::instance().color ("recording rect"));
201 frame->set_outline_color (UIConfiguration::instance().color ("time axis frame"));
205 if (UIConfiguration::instance().get_show_name_highlight() && (visibility & ShowNameHighlight)) {
207 /* rectangle size will be set in ::manage_name_highlight() */
208 name_highlight = new ArdourCanvas::Rectangle (group);
209 CANVAS_DEBUG_NAME (name_highlight, string_compose ("name highlight for %1", get_item_name()));
210 name_highlight->set_data ("timeaxisviewitem", this);
211 name_highlight->set_outline_what (ArdourCanvas::Rectangle::TOP);
212 name_highlight->set_outline_color (RGBA_TO_UINT (0,0,0,255)); // this should use a theme color
218 if (visibility & ShowNameText) {
219 name_text = new ArdourCanvas::Text (group);
220 CANVAS_DEBUG_NAME (name_text, string_compose ("name text for %1", get_item_name()));
221 if (UIConfiguration::instance().get_show_name_highlight()) {
222 name_text->set_position (ArdourCanvas::Duple (NAME_X_OFFSET, trackview.current_height() - NAME_Y_OFFSET));
224 name_text->set_position (ArdourCanvas::Duple (NAME_X_OFFSET, NAME_Y_OFFSET));
226 name_text->set_font_description (NAME_FONT);
227 name_text->set_ignore_events (true);
232 /* create our grab handles used for trimming/duration etc */
233 if (!_recregion && !_automation) {
234 double top = TimeAxisViewItem::GRAB_HANDLE_TOP;
235 double width = TimeAxisViewItem::GRAB_HANDLE_WIDTH;
237 frame_handle_start = new ArdourCanvas::Rectangle (group, ArdourCanvas::Rect (0.0, top, width, trackview.current_height()));
238 CANVAS_DEBUG_NAME (frame_handle_start, "TAVI frame handle start");
239 frame_handle_start->set_outline (false);
240 frame_handle_start->set_fill (false);
241 frame_handle_start->Event.connect (sigc::bind (sigc::mem_fun (*this, &TimeAxisViewItem::frame_handle_crossing), frame_handle_start));
243 frame_handle_end = new ArdourCanvas::Rectangle (group, ArdourCanvas::Rect (0.0, top, width, trackview.current_height()));
244 CANVAS_DEBUG_NAME (frame_handle_end, "TAVI frame handle end");
245 frame_handle_end->set_outline (false);
246 frame_handle_end->set_fill (false);
247 frame_handle_end->Event.connect (sigc::bind (sigc::mem_fun (*this, &TimeAxisViewItem::frame_handle_crossing), frame_handle_end));
249 frame_handle_start = frame_handle_end = 0;
252 set_color (base_color);
254 set_duration (item_duration, this);
255 set_position (start, this);
257 Config->ParameterChanged.connect (*this, invalidator (*this), boost::bind (&TimeAxisViewItem::parameter_changed, this, _1), gui_context ());
258 UIConfiguration::instance().ParameterChanged.connect (sigc::mem_fun (*this, &TimeAxisViewItem::parameter_changed));
261 TimeAxisViewItem::~TimeAxisViewItem()
267 TimeAxisViewItem::canvas_group_event (GdkEvent* /*ev*/)
273 * Set the position of this item on the timeline.
275 * @param pos the new position
276 * @param src the identity of the object that initiated the change
277 * @return true on success
281 TimeAxisViewItem::set_position(framepos_t pos, void* src, double* delta)
283 if (position_locked) {
287 frame_position = pos;
289 double new_unit_pos = trackview.editor().sample_to_pixel (pos);
292 (*delta) = new_unit_pos - group->position().x;
297 if (new_unit_pos == group->position().x) {
302 group->set_x_position (new_unit_pos);
303 PositionChanged (frame_position, src); /* EMIT_SIGNAL */
308 /** @return position of this item on the timeline */
310 TimeAxisViewItem::get_position() const
312 return frame_position;
316 * Set the duration of this item.
318 * @param dur the new duration of this item
319 * @param src the identity of the object that initiated the change
320 * @return true on success
324 TimeAxisViewItem::set_duration (framecnt_t dur, void* src)
326 if ((dur > max_item_duration) || (dur < min_item_duration)) {
327 warning << string_compose (
328 P_("new duration %1 frame is out of bounds for %2", "new duration of %1 frames is out of bounds for %2", dur),
329 get_item_name(), dur)
340 double end_pixel = trackview.editor().sample_to_pixel (frame_position + dur);
341 double first_pixel = trackview.editor().sample_to_pixel (frame_position);
343 reset_width_dependent_items (end_pixel - first_pixel);
345 DurationChanged (dur, src); /* EMIT_SIGNAL */
349 /** @return duration of this item */
351 TimeAxisViewItem::get_duration() const
353 return item_duration;
357 * Set the maximum duration that this item can have.
359 * @param dur the new maximum duration
360 * @param src the identity of the object that initiated the change
363 TimeAxisViewItem::set_max_duration(framecnt_t dur, void* src)
365 max_item_duration = dur;
366 MaxDurationChanged(max_item_duration, src); /* EMIT_SIGNAL */
369 /** @return the maximum duration that this item may have */
371 TimeAxisViewItem::get_max_duration() const
373 return max_item_duration;
377 * Set the minimum duration that this item may have.
379 * @param the minimum duration that this item may be set to
380 * @param src the identity of the object that initiated the change
383 TimeAxisViewItem::set_min_duration(framecnt_t dur, void* src)
385 min_item_duration = dur;
386 MinDurationChanged(max_item_duration, src); /* EMIT_SIGNAL */
389 /** @return the minimum duration that this item mey have */
391 TimeAxisViewItem::get_min_duration() const
393 return min_item_duration;
397 * Set whether this item is locked to its current position.
398 * Locked items cannot be moved until the item is unlocked again.
400 * @param yn true to lock this item to its current position
401 * @param src the identity of the object that initiated the change
404 TimeAxisViewItem::set_position_locked(bool yn, void* src)
406 position_locked = yn;
407 set_trim_handle_colors();
408 PositionLockChanged (position_locked, src); /* EMIT_SIGNAL */
411 /** @return true if this item is locked to its current position */
413 TimeAxisViewItem::get_position_locked() const
415 return position_locked;
419 * Set whether the maximum duration constraint is active.
421 * @param active set true to enforce the max duration constraint
422 * @param src the identity of the object that initiated the change
425 TimeAxisViewItem::set_max_duration_active (bool active, void* /*src*/)
427 max_duration_active = active;
430 /** @return true if the maximum duration constraint is active */
432 TimeAxisViewItem::get_max_duration_active() const
434 return max_duration_active;
438 * Set whether the minimum duration constraint is active.
440 * @param active set true to enforce the min duration constraint
441 * @param src the identity of the object that initiated the change
445 TimeAxisViewItem::set_min_duration_active (bool active, void* /*src*/)
447 min_duration_active = active;
450 /** @return true if the maximum duration constraint is active */
452 TimeAxisViewItem::get_min_duration_active() const
454 return min_duration_active;
458 * Set the name of this item.
460 * @param new_name the new name of this item
461 * @param src the identity of the object that initiated the change
465 TimeAxisViewItem::set_item_name(std::string new_name, void* src)
467 if (new_name != item_name) {
468 std::string temp_name = item_name;
469 item_name = new_name;
470 NameChanged (item_name, temp_name, src); /* EMIT_SIGNAL */
474 /** @return the name of this item */
476 TimeAxisViewItem::get_item_name() const
482 * Set selection status.
484 * @param yn true if this item is currently selected
487 TimeAxisViewItem::set_selected(bool yn)
489 if (_selected == yn) {
493 Selectable::set_selected (yn);
495 set_name_text_color ();
497 if (_selected && frame) {
498 if (!selection_frame) {
499 selection_frame = new ArdourCanvas::Rectangle (group);
500 selection_frame->set_fill (false);
501 selection_frame->set_outline_color (UIConfiguration::instance().color ("selected time axis frame"));
502 selection_frame->set_ignore_events (true);
504 selection_frame->set (frame->get().shrink (1.0));
505 selection_frame->show ();
507 if (selection_frame) {
508 selection_frame->hide ();
513 /** @return the TimeAxisView that this item is on */
515 TimeAxisViewItem::get_time_axis_view () const
521 * Set the displayed item text.
522 * This item is the visual text name displayed on the canvas item, this can be different to the name of the item.
524 * @param new_name the new name text to display
528 TimeAxisViewItem::set_name_text(const string& new_name)
534 name_text_width = pixel_width (new_name, NAME_FONT) + 2;
535 name_text->set (new_name);
541 * Set the height of this item.
543 * @param h new height
546 TimeAxisViewItem::set_height (double height)
550 manage_name_highlight ();
552 if (visibility & ShowNameText) {
553 if (UIConfiguration::instance().get_show_name_highlight()) {
554 name_text->set_y_position (height - NAME_Y_OFFSET);
556 name_text->set_y_position (NAME_Y_OFFSET);
563 frame->set_y1 (height);
565 if (frame_handle_start) {
566 frame_handle_start->set_y1 (height);
567 frame_handle_end->set_y1 (height);
570 if (selection_frame) {
571 selection_frame->set (frame->get().shrink (1.0));
575 if (vestigial_frame) {
576 vestigial_frame->set_y0 (0.0);
577 vestigial_frame->set_y1 (height);
584 TimeAxisViewItem::manage_name_highlight ()
586 if (!name_highlight) {
590 if (_height < NAME_HIGHLIGHT_THRESH) {
591 high_enough_for_name = false;
593 high_enough_for_name = true;
597 wide_enough_for_name = false;
599 wide_enough_for_name = true;
602 if (name_highlight && wide_enough_for_name && high_enough_for_name) {
604 name_highlight->show();
605 // name_highlight->set_x_position (1.0);
606 name_highlight->set (ArdourCanvas::Rect (0.0, (double) _height - NAME_HIGHLIGHT_SIZE, _width - 2.0, _height));
609 name_highlight->hide();
616 TimeAxisViewItem::set_color (uint32_t base_color)
618 fill_color = base_color;
623 TimeAxisViewItem::get_canvas_frame()
629 TimeAxisViewItem::get_canvas_group()
635 TimeAxisViewItem::get_name_highlight()
637 return name_highlight;
641 * Convenience method to set the various canvas item colors
644 TimeAxisViewItem::set_colors()
648 if (name_highlight) {
649 name_highlight->set_fill_color (fill_color);
652 set_name_text_color ();
653 set_trim_handle_colors();
657 TimeAxisViewItem::set_name_text_color ()
666 if (UIConfiguration::instance().get_show_name_highlight()) {
667 /* name text will always be on top of name highlight, which
668 will always use our fill color.
672 /* name text will be on top of the item, whose color
673 may vary depending on various conditions.
675 f = get_fill_color ();
678 name_text->set_color (ArdourCanvas::contrasting_text_color (f));
682 TimeAxisViewItem::get_fill_color () const
684 const std::string mod_name = (_dragging ? "dragging region" : fill_color_name);
687 return UIConfiguration::instance().color_mod ("selected region base", mod_name);
688 } else if (_recregion) {
689 return UIConfiguration::instance().color ("recording rect");
690 } else if ((!UIConfiguration::instance().get_show_name_highlight() || high_enough_for_name) &&
691 !UIConfiguration::instance().get_color_regions_using_track_color()) {
692 return UIConfiguration::instance().color_mod (fill_color_name, mod_name);
694 return UIConfiguration::instance().color_mod (fill_color, mod_name);
698 * Sets the frame color depending on whether this item is selected
701 TimeAxisViewItem::set_frame_color()
707 frame->set_fill_color (get_fill_color());
708 set_frame_gradient ();
711 frame->set_outline_color (UIConfiguration::instance().color ("time axis frame"));
716 TimeAxisViewItem::set_frame_gradient ()
718 if (UIConfiguration::instance().get_timeline_item_gradient_depth() == 0.0) {
719 frame->set_gradient (ArdourCanvas::Fill::StopList (), 0);
723 ArdourCanvas::Fill::StopList stops;
726 ArdourCanvas::Color f (get_fill_color());
728 /* need to get alpha value */
729 ArdourCanvas::color_to_rgba (f, r, g, b, a);
731 stops.push_back (std::make_pair (0.0, f));
733 /* now a darker version */
735 ArdourCanvas::color_to_hsv (f, h, s, v);
737 v = min (1.0, v * (1.0 - UIConfiguration::instance().get_timeline_item_gradient_depth()));
739 ArdourCanvas::Color darker = ArdourCanvas::hsva_to_color (h, s, v, a);
740 stops.push_back (std::make_pair (1.0, darker));
742 frame->set_gradient (stops, true);
746 * Set the colors of the start and end trim handle depending on object state
749 TimeAxisViewItem::set_trim_handle_colors()
752 /* Leave them transparent for now */
753 if (frame_handle_start) {
754 frame_handle_start->set_fill_color (0x00000000);
755 frame_handle_end->set_fill_color (0x00000000);
758 if (frame_handle_start) {
759 if (position_locked) {
760 frame_handle_start->set_fill_color (UIConfiguration::instance().get_TrimHandleLocked());
761 frame_handle_end->set_fill_color (UIConfiguration::instance().get_TrimHandleLocked());
763 frame_handle_start->set_fill_color (UIConfiguration::instance().get_TrimHandle());
764 frame_handle_end->set_fill_color (UIConfiguration::instance().get_TrimHandle());
771 TimeAxisViewItem::frame_handle_crossing (GdkEvent* ev, ArdourCanvas::Rectangle* item)
774 case GDK_LEAVE_NOTIFY:
775 /* always hide the handle whenever we leave, no matter what mode */
776 item->set_fill (false);
778 case GDK_ENTER_NOTIFY:
779 if (trackview.editor().effective_mouse_mode() == Editing::MouseObject) {
780 /* Never set this to be visible in other modes. Note, however,
781 that we do need to undo visibility (LEAVE_NOTIFY case above) no
782 matter what the mode is. */
783 item->set_fill (true);
792 /** @return the frames per pixel */
794 TimeAxisViewItem::get_samples_per_pixel () const
796 return samples_per_pixel;
799 /** Set the frames per pixel of this item.
800 * This item is used to determine the relative visual size and position of this item
801 * based upon its duration and start value.
803 * @param fpp the new frames per pixel
806 TimeAxisViewItem::set_samples_per_pixel (double fpp)
808 samples_per_pixel = fpp;
809 set_position (this->get_position(), this);
811 double end_pixel = trackview.editor().sample_to_pixel (frame_position + get_duration());
812 double first_pixel = trackview.editor().sample_to_pixel (frame_position);
814 reset_width_dependent_items (end_pixel - first_pixel);
818 TimeAxisViewItem::reset_width_dependent_items (double pixel_width)
820 _width = pixel_width;
822 manage_name_highlight ();
825 if (pixel_width < 2.0) {
827 if (show_vestigial) {
829 if (!vestigial_frame) {
830 vestigial_frame = new ArdourCanvas::Rectangle (group, ArdourCanvas::Rect (0.0, 0.0, 2.0, trackview.current_height()));
831 CANVAS_DEBUG_NAME (vestigial_frame, string_compose ("vestigial frame for %1", get_item_name()));
832 vestigial_frame->set_outline_color (UIConfiguration::instance().color ("vestigial frame"));
833 vestigial_frame->set_fill_color (UIConfiguration::instance().color ("vestigial frame"));
834 vestigial_frame->set_outline_what (ArdourCanvas::Rectangle::What (ArdourCanvas::Rectangle::LEFT|ArdourCanvas::Rectangle::RIGHT));
837 vestigial_frame->show();
841 frame->set_outline (false);
842 frame->set_x1 (std::max(1.0, pixel_width));
845 if (frame_handle_start) {
846 frame_handle_start->hide();
847 frame_handle_end->hide();
851 if (vestigial_frame) {
852 vestigial_frame->hide();
856 frame->set_outline (true);
857 /* Note: x0 is always zero - the position is defined by
858 * the position of the group, not the frame.
860 frame->set_x1 (pixel_width);
862 if (selection_frame) {
863 selection_frame->set (frame->get().shrink (1.0));
867 if (frame_handle_start) {
868 if (pixel_width < (3 * TimeAxisViewItem::GRAB_HANDLE_WIDTH)) {
870 * there's less than GRAB_HANDLE_WIDTH of the region between
871 * the right-hand end of frame_handle_start and the left-hand
872 * end of frame_handle_end, so disable the handles
875 frame_handle_start->hide();
876 frame_handle_end->hide();
878 frame_handle_start->show();
879 frame_handle_end->set_x0 (pixel_width - (TimeAxisViewItem::GRAB_HANDLE_WIDTH));
880 frame_handle_end->set_x1 (pixel_width);
881 frame_handle_end->show();
888 TimeAxisViewItem::manage_name_text ()
890 int visible_name_width;
896 if (!wide_enough_for_name || !high_enough_for_name) {
901 if (name_text->text().empty()) {
905 visible_name_width = name_text_width;
907 if (visible_name_width > _width - NAME_X_OFFSET) {
908 visible_name_width = _width - NAME_X_OFFSET;
911 if (visible_name_width < 1) {
914 name_text->clamp_width (visible_name_width);
920 * Callback used to remove this time axis item during the gtk idle loop.
921 * This is used to avoid deleting the obejct while inside the remove_this_item
924 * @param item the TimeAxisViewItem to remove.
925 * @param src the identity of the object that initiated the change.
928 TimeAxisViewItem::idle_remove_this_item(TimeAxisViewItem* item, void* src)
930 item->ItemRemoved (item->get_item_name(), src); /* EMIT_SIGNAL */
937 TimeAxisViewItem::set_y (double y)
939 group->set_y_position (y);
943 TimeAxisViewItem::parameter_changed (string p)
945 if (p == "color-regions-using-track-color") {
947 } else if (p == "timeline-item-gradient-depth") {
948 set_frame_gradient ();
953 TimeAxisViewItem::drag_start ()
960 TimeAxisViewItem::drag_end ()