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.
20 #include "pbd/error.h"
21 #include "pbd/stacktrace.h"
23 #include "ardour/types.h"
24 #include "ardour/ardour.h"
26 #include "gtkmm2ext/utils.h"
27 #include "gtkmm2ext/gui_thread.h"
29 #include "ardour_ui.h"
31 * ardour_ui.h was moved up in the include list
32 * due to a conflicting definition of 'Rect' between
33 * Apple's MacTypes.h file and GTK
36 #include "public_editor.h"
37 #include "time_axis_view_item.h"
38 #include "time_axis_view.h"
39 #include "simplerect.h"
41 #include "canvas_impl.h"
42 #include "rgb_macros.h"
47 using namespace Editing
;
50 using namespace ARDOUR
;
51 using namespace Gtkmm2ext
;
53 Pango::FontDescription
TimeAxisViewItem::NAME_FONT
;
54 const double TimeAxisViewItem::NAME_X_OFFSET
= 15.0;
55 const double TimeAxisViewItem::GRAB_HANDLE_LENGTH
= 6;
57 int TimeAxisViewItem::NAME_HEIGHT
;
58 double TimeAxisViewItem::NAME_Y_OFFSET
;
59 double TimeAxisViewItem::NAME_HIGHLIGHT_SIZE
;
60 double TimeAxisViewItem::NAME_HIGHLIGHT_THRESH
;
63 TimeAxisViewItem::set_constant_heights ()
65 NAME_FONT
= get_font_for_style (X_("TimeAxisViewItemName"));
71 Glib::RefPtr
<Pango::Layout
> layout
= foo
.create_pango_layout (X_("Hg")); /* ascender + descender */
75 layout
->set_font_description (NAME_FONT
);
76 Gtkmm2ext::get_ink_pixel_size (layout
, width
, height
);
79 NAME_Y_OFFSET
= height
+ 3;
80 NAME_HIGHLIGHT_SIZE
= height
+ 2;
81 NAME_HIGHLIGHT_THRESH
= NAME_HIGHLIGHT_SIZE
* 3;
85 * Construct a new TimeAxisViewItem.
87 * @param it_name the unique name of this item
88 * @param parent the parent canvas group
89 * @param tv the TimeAxisView we are going to be added to
90 * @param spu samples per unit
92 * @param start the start point of this item
93 * @param duration the duration of this item
94 * @param recording true if this is a recording region view
95 * @param automation true if this is an automation region view
97 TimeAxisViewItem::TimeAxisViewItem(
98 const string
& it_name
, ArdourCanvas::Group
& parent
, TimeAxisView
& tv
, double spu
, Gdk::Color
const & base_color
,
99 framepos_t start
, framecnt_t duration
, bool recording
, bool automation
, Visibility vis
103 , _recregion (recording
)
104 , _automation (automation
)
106 group
= new ArdourCanvas::Group (parent
);
108 init (it_name
, spu
, base_color
, start
, duration
, vis
, true, true);
111 TimeAxisViewItem::TimeAxisViewItem (const TimeAxisViewItem
& other
)
112 : sigc::trackable(other
)
113 , PBD::ScopedConnectionList()
114 , trackview (other
.trackview
)
115 , _recregion (other
._recregion
)
116 , _automation (other
._automation
)
122 UINT_TO_RGBA (other
.fill_color
, &r
, &g
, &b
, &a
);
123 c
.set_rgb_p (r
/255.0, g
/255.0, b
/255.0);
125 /* share the other's parent, but still create a new group */
127 Gnome::Canvas::Group
* parent
= other
.group
->property_parent();
129 group
= new ArdourCanvas::Group (*parent
);
131 _selected
= other
._selected
;
134 other
.item_name
, other
.samples_per_unit
, c
, other
.frame_position
,
135 other
.item_duration
, other
.visibility
, other
.wide_enough_for_name
, other
.high_enough_for_name
140 TimeAxisViewItem::init (
141 const string
& it_name
, double spu
, Gdk::Color
const & base_color
, framepos_t start
, framepos_t duration
, Visibility vis
, bool wide
, bool high
)
144 samples_per_unit
= spu
;
145 frame_position
= start
;
146 item_duration
= duration
;
147 name_connected
= false;
149 position_locked
= false;
150 max_item_duration
= ARDOUR::max_framepos
;
151 min_item_duration
= 0;
152 show_vestigial
= true;
155 name_pixbuf_width
= 0;
157 wide_enough_for_name
= wide
;
158 high_enough_for_name
= high
;
162 warning
<< "Time Axis Item Duration == 0" << endl
;
165 vestigial_frame
= new ArdourCanvas::SimpleRect (*group
, 0.0, 1.0, 2.0, trackview
.current_height());
166 vestigial_frame
->hide ();
167 vestigial_frame
->property_outline_what() = 0xF;
168 vestigial_frame
->property_outline_color_rgba() = ARDOUR_UI::config()->canvasvar_VestigialFrame
.get();
169 vestigial_frame
->property_fill_color_rgba() = ARDOUR_UI::config()->canvasvar_VestigialFrame
.get();
171 if (visibility
& ShowFrame
) {
172 frame
= new ArdourCanvas::SimpleRect (*group
, 0.0, 1.0, trackview
.editor().frame_to_pixel(duration
), trackview
.current_height());
174 frame
->property_outline_pixels() = 1;
175 frame
->property_outline_what() = 0xF;
178 frame
->property_outline_color_rgba() = ARDOUR_UI::config()->canvasvar_RecordingRect
.get();
180 frame
->property_outline_color_rgba() = ARDOUR_UI::config()->canvasvar_TimeAxisFrame
.get();
183 frame
->property_outline_what() = 0x1|0x2|0x4|0x8;
189 if (visibility
& ShowNameHighlight
) {
191 if (visibility
& FullWidthNameHighlight
) {
192 name_highlight
= new ArdourCanvas::SimpleRect (*group
, 0.0, trackview
.editor().frame_to_pixel(item_duration
), trackview
.current_height() - TimeAxisViewItem::NAME_HIGHLIGHT_SIZE
, trackview
.current_height());
194 name_highlight
= new ArdourCanvas::SimpleRect (*group
, 1.0, trackview
.editor().frame_to_pixel(item_duration
) - 1, trackview
.current_height() - TimeAxisViewItem::NAME_HIGHLIGHT_SIZE
, trackview
.current_height());
197 name_highlight
->set_data ("timeaxisviewitem", this);
198 name_highlight
->property_outline_what() = 0x4;
199 /* we should really use a canvas color property here */
200 name_highlight
->property_outline_color_rgba() = RGBA_TO_UINT (0,0,0,255);
206 if (visibility
& ShowNameText
) {
207 name_pixbuf
= new ArdourCanvas::Pixbuf(*group
);
208 name_pixbuf
->property_x() = NAME_X_OFFSET
;
209 name_pixbuf
->property_y() = trackview
.current_height() + 1 - NAME_Y_OFFSET
;
215 /* create our grab handles used for trimming/duration etc */
216 if (!_recregion
&& !_automation
) {
217 frame_handle_start
= new ArdourCanvas::SimpleRect (*group
, 0.0, TimeAxisViewItem::GRAB_HANDLE_LENGTH
, 5.0, trackview
.current_height());
218 frame_handle_start
->property_outline_what() = 0x0;
219 frame_handle_end
= new ArdourCanvas::SimpleRect (*group
, 0.0, TimeAxisViewItem::GRAB_HANDLE_LENGTH
, 5.0, trackview
.current_height());
220 frame_handle_end
->property_outline_what() = 0x0;
222 frame_handle_start
= frame_handle_end
= 0;
225 set_color (base_color
);
227 set_duration (item_duration
, this);
228 set_position (start
, this);
230 Config
->ParameterChanged
.connect (*this, invalidator (*this), ui_bind (&TimeAxisViewItem::parameter_changed
, this, _1
), gui_context ());
233 TimeAxisViewItem::~TimeAxisViewItem()
239 TimeAxisViewItem::hide_rect ()
241 rect_visible
= false;
244 if (name_highlight
) {
245 name_highlight
->property_outline_what() = 0x0;
246 name_highlight
->property_fill_color_rgba() = UINT_RGBA_CHANGE_A(fill_color
,64);
251 TimeAxisViewItem::show_rect ()
256 if (name_highlight
) {
257 name_highlight
->property_outline_what() = 0x4;
258 name_highlight
->property_fill_color_rgba() = fill_color
;
264 * Set the position of this item on the timeline.
266 * @param pos the new position
267 * @param src the identity of the object that initiated the change
268 * @return true on success
272 TimeAxisViewItem::set_position(framepos_t pos
, void* src
, double* delta
)
274 if (position_locked
) {
278 frame_position
= pos
;
280 /* This sucks. The GnomeCanvas version I am using
281 doesn't correctly implement gnome_canvas_group_set_arg(),
282 so that simply setting the "x" arg of the group
283 fails to move the group. Instead, we have to
284 use gnome_canvas_item_move(), which does the right
285 thing. I see that in GNOME CVS, the current (Sept 2001)
286 version of GNOME Canvas rectifies this issue cleanly.
290 double new_unit_pos
= pos
/ samples_per_unit
;
292 old_unit_pos
= group
->property_x();
294 if (new_unit_pos
!= old_unit_pos
) {
295 group
->move (new_unit_pos
- old_unit_pos
, 0.0);
299 (*delta
) = new_unit_pos
- old_unit_pos
;
302 PositionChanged (frame_position
, src
); /* EMIT_SIGNAL */
307 /** @return position of this item on the timeline */
309 TimeAxisViewItem::get_position() const
311 return frame_position
;
315 * Set the duration of this item.
317 * @param dur the new duration of this item
318 * @param src the identity of the object that initiated the change
319 * @return true on success
323 TimeAxisViewItem::set_duration (framepos_t dur
, void* src
)
325 if ((dur
> max_item_duration
) || (dur
< min_item_duration
)) {
326 warning
<< string_compose (_("new duration %1 frames is out of bounds for %2"), get_item_name(), dur
)
337 reset_width_dependent_items (trackview
.editor().frame_to_pixel (dur
));
339 DurationChanged (dur
, src
); /* EMIT_SIGNAL */
343 /** @return duration of this item */
345 TimeAxisViewItem::get_duration() const
347 return item_duration
;
351 * Set the maximum duration that this item can have.
353 * @param dur the new maximum duration
354 * @param src the identity of the object that initiated the change
357 TimeAxisViewItem::set_max_duration(framecnt_t dur
, void* src
)
359 max_item_duration
= dur
;
360 MaxDurationChanged(max_item_duration
, src
); /* EMIT_SIGNAL */
363 /** @return the maximum duration that this item may have */
365 TimeAxisViewItem::get_max_duration() const
367 return max_item_duration
;
371 * Set the minimum duration that this item may have.
373 * @param the minimum duration that this item may be set to
374 * @param src the identity of the object that initiated the change
377 TimeAxisViewItem::set_min_duration(framecnt_t dur
, void* src
)
379 min_item_duration
= dur
;
380 MinDurationChanged(max_item_duration
, src
); /* EMIT_SIGNAL */
383 /** @return the minimum duration that this item mey have */
385 TimeAxisViewItem::get_min_duration() const
387 return min_item_duration
;
391 * Set whether this item is locked to its current position.
392 * Locked items cannot be moved until the item is unlocked again.
394 * @param yn true to lock this item to its current position
395 * @param src the identity of the object that initiated the change
398 TimeAxisViewItem::set_position_locked(bool yn
, void* src
)
400 position_locked
= yn
;
401 set_trim_handle_colors();
402 PositionLockChanged (position_locked
, src
); /* EMIT_SIGNAL */
405 /** @return true if this item is locked to its current position */
407 TimeAxisViewItem::get_position_locked() const
409 return position_locked
;
413 * Set whether the maximum duration constraint is active.
415 * @param active set true to enforce the max duration constraint
416 * @param src the identity of the object that initiated the change
419 TimeAxisViewItem::set_max_duration_active (bool active
, void* /*src*/)
421 max_duration_active
= active
;
424 /** @return true if the maximum duration constraint is active */
426 TimeAxisViewItem::get_max_duration_active() const
428 return max_duration_active
;
432 * Set whether the minimum duration constraint is active.
434 * @param active set true to enforce the min duration constraint
435 * @param src the identity of the object that initiated the change
439 TimeAxisViewItem::set_min_duration_active (bool active
, void* /*src*/)
441 min_duration_active
= active
;
444 /** @return true if the maximum duration constraint is active */
446 TimeAxisViewItem::get_min_duration_active() const
448 return min_duration_active
;
452 * Set the name of this item.
454 * @param new_name the new name of this item
455 * @param src the identity of the object that initiated the change
459 TimeAxisViewItem::set_item_name(std::string new_name
, void* src
)
461 if (new_name
!= item_name
) {
462 std::string temp_name
= item_name
;
463 item_name
= new_name
;
464 NameChanged (item_name
, temp_name
, src
); /* EMIT_SIGNAL */
468 /** @return the name of this item */
470 TimeAxisViewItem::get_item_name() const
476 * Set selection status.
478 * @param yn true if this item is currently selected
481 TimeAxisViewItem::set_selected(bool yn
)
483 if (_selected
!= yn
) {
484 Selectable::set_selected (yn
);
489 /** @return the TimeAxisView that this item is on */
491 TimeAxisViewItem::get_time_axis_view () const
497 * Set the displayed item text.
498 * This item is the visual text name displayed on the canvas item, this can be different to the name of the item.
500 * @param new_name the new name text to display
504 TimeAxisViewItem::set_name_text(const string
& new_name
)
510 last_item_width
= trackview
.editor().frame_to_pixel(item_duration
);
511 name_pixbuf_width
= pixel_width (new_name
, NAME_FONT
) + 2;
512 name_pixbuf
->property_pixbuf() = pixbuf_from_string(new_name
, NAME_FONT
, name_pixbuf_width
, NAME_HEIGHT
, Gdk::Color ("#000000"));
517 * Set the height of this item.
519 * @param h new height
522 TimeAxisViewItem::set_height (double height
)
526 if (name_highlight
) {
527 if (height
< NAME_HIGHLIGHT_THRESH
) {
528 name_highlight
->hide ();
529 high_enough_for_name
= false;
532 name_highlight
->show();
533 high_enough_for_name
= true;
536 if (height
> NAME_HIGHLIGHT_SIZE
) {
537 name_highlight
->property_y1() = (double) height
- 1 - NAME_HIGHLIGHT_SIZE
;
538 name_highlight
->property_y2() = (double) height
- 1;
541 /* it gets hidden now anyway */
542 name_highlight
->property_y1() = (double) 1.0;
543 name_highlight
->property_y2() = (double) height
;
547 if (visibility
& ShowNameText
) {
548 name_pixbuf
->property_y() = height
+ 1 - NAME_Y_OFFSET
;
552 frame
->property_y2() = height
- 1;
553 if (frame_handle_start
) {
554 frame_handle_start
->property_y2() = height
- 1;
555 frame_handle_end
->property_y2() = height
- 1;
559 vestigial_frame
->property_y2() = height
- 1;
561 update_name_pixbuf_visibility ();
566 TimeAxisViewItem::set_color (Gdk::Color
const & base_color
)
568 compute_colors (base_color
);
573 TimeAxisViewItem::get_canvas_frame()
579 TimeAxisViewItem::get_canvas_group()
585 TimeAxisViewItem::get_name_highlight()
587 return name_highlight
;
590 ArdourCanvas::Pixbuf
*
591 TimeAxisViewItem::get_name_pixbuf()
597 * Calculate some contrasting color for displaying various parts of this item, based upon the base color.
599 * @param color the base color of the item
602 TimeAxisViewItem::compute_colors (Gdk::Color
const & base_color
)
604 unsigned char radius
;
609 /* FILL: this is simple */
610 r
= base_color
.get_red()/256;
611 g
= base_color
.get_green()/256;
612 b
= base_color
.get_blue()/256;
613 fill_color
= RGBA_TO_UINT(r
,g
,b
,160);
616 if the overall saturation is strong, make the minor colors light.
617 if its weak, make them dark.
619 we do this by moving an equal distance to the other side of the
620 central circle in the color wheel from where we started.
623 radius
= (unsigned char) rint (floor (sqrt (static_cast<double>(r
*r
+ g
*g
+ b
+b
))/3.0f
));
624 minor_shift
= 125 - radius
;
626 /* LABEL: rotate around color wheel by 120 degrees anti-clockwise */
628 r
= base_color
.get_red()/256;
629 g
= base_color
.get_green()/256;
630 b
= base_color
.get_blue()/256;
636 /* red sector => green */
641 /* green sector => blue */
649 /* blue sector => red */
654 /* green sector => blue */
663 label_color
= RGBA_TO_UINT(r
,g
,b
,255);
664 r
= (base_color
.get_red()/256) + 127;
665 g
= (base_color
.get_green()/256) + 127;
666 b
= (base_color
.get_blue()/256) + 127;
668 label_color
= RGBA_TO_UINT(r
,g
,b
,255);
670 /* XXX can we do better than this ? */
674 //frame_color_r = 192;
675 //frame_color_g = 192;
676 //frame_color_b = 194;
678 //selected_frame_color_r = 182;
679 //selected_frame_color_g = 145;
680 //selected_frame_color_b = 168;
682 //handle_color_r = 25;
683 //handle_color_g = 0;
684 //handle_color_b = 255;
685 //lock_handle_color_r = 235;
686 //lock_handle_color_g = 16;
687 //lock_handle_color_b = 16;
691 * Convenience method to set the various canvas item colors
694 TimeAxisViewItem::set_colors()
698 if (name_highlight
) {
699 name_highlight
->property_fill_color_rgba() = fill_color
;
701 set_trim_handle_colors();
705 * Sets the frame color depending on whether this item is selected
708 TimeAxisViewItem::set_frame_color()
718 f
= ARDOUR_UI::config()->canvasvar_SelectedFrameBase
.get();
721 f
= UINT_RGBA_CHANGE_A (f
, fill_opacity
);
725 f
= UINT_RGBA_CHANGE_A (f
, 0);
731 f
= ARDOUR_UI::config()->canvasvar_RecordingRect
.get();
734 if (high_enough_for_name
&& !Config
->get_color_regions_using_track_color()) {
735 f
= ARDOUR_UI::config()->canvasvar_FrameBase
.get();
741 f
= UINT_RGBA_CHANGE_A (f
, fill_opacity
);
745 f
= UINT_RGBA_CHANGE_A (f
, 0);
750 frame
->property_fill_color_rgba() = f
;
754 f
= ARDOUR_UI::config()->canvasvar_SelectedTimeAxisFrame
.get();
756 f
= ARDOUR_UI::config()->canvasvar_TimeAxisFrame
.get();
760 f
= UINT_RGBA_CHANGE_A (f
, 64);
763 frame
->property_outline_color_rgba() = f
;
768 * Set the colors of the start and end trim handle depending on object state
771 TimeAxisViewItem::set_trim_handle_colors()
773 if (frame_handle_start
) {
774 if (position_locked
) {
775 frame_handle_start
->property_fill_color_rgba() = ARDOUR_UI::config()->canvasvar_TrimHandleLocked
.get();
776 frame_handle_end
->property_fill_color_rgba() = ARDOUR_UI::config()->canvasvar_TrimHandleLocked
.get();
778 frame_handle_start
->property_fill_color_rgba() = RGBA_TO_UINT(1, 1, 1, 0); //ARDOUR_UI::config()->canvasvar_TrimHandle.get();
779 frame_handle_end
->property_fill_color_rgba() = RGBA_TO_UINT(1, 1, 1, 0); //ARDOUR_UI::config()->canvasvar_TrimHandle.get();
784 /** @return the samples per unit of this item */
786 TimeAxisViewItem::get_samples_per_unit()
788 return samples_per_unit
;
792 * Set the samples per unit of this item.
793 * This item is used to determine the relative visual size and position of this item
794 * based upon its duration and start value.
796 * @param spu the new samples per unit value
799 TimeAxisViewItem::set_samples_per_unit (double spu
)
801 samples_per_unit
= spu
;
802 set_position (this->get_position(), this);
803 reset_width_dependent_items ((double)get_duration() / samples_per_unit
);
807 TimeAxisViewItem::reset_width_dependent_items (double pixel_width
)
809 if (pixel_width
< GRAB_HANDLE_LENGTH
* 2) {
811 if (frame_handle_start
) {
812 frame_handle_start
->hide();
813 frame_handle_end
->hide();
818 if (pixel_width
< 2.0) {
820 if (show_vestigial
) {
821 vestigial_frame
->show();
824 if (name_highlight
) {
825 name_highlight
->hide();
832 if (frame_handle_start
) {
833 frame_handle_start
->hide();
834 frame_handle_end
->hide();
837 wide_enough_for_name
= false;
840 vestigial_frame
->hide();
842 if (name_highlight
) {
844 if (_height
< NAME_HIGHLIGHT_THRESH
) {
845 name_highlight
->hide();
846 high_enough_for_name
= false;
848 name_highlight
->show();
849 if (!get_item_name().empty()) {
850 reset_name_width (pixel_width
);
852 high_enough_for_name
= true;
855 name_highlight
->property_x2() = pixel_width
;
860 frame
->property_x2() = pixel_width
;
863 if (frame_handle_start
) {
864 if (pixel_width
< (2*TimeAxisViewItem::GRAB_HANDLE_LENGTH
)) {
865 frame_handle_start
->hide();
866 frame_handle_end
->hide();
868 frame_handle_start
->show();
869 frame_handle_end
->property_x1() = pixel_width
- (TimeAxisViewItem::GRAB_HANDLE_LENGTH
);
870 frame_handle_end
->show();
871 frame_handle_end
->property_x2() = pixel_width
;
874 wide_enough_for_name
= true;
877 update_name_pixbuf_visibility ();
881 TimeAxisViewItem::reset_name_width (double /*pixel_width*/)
885 bool pixbuf_holds_full_name
;
891 it_width
= trackview
.editor().frame_to_pixel(item_duration
);
892 pb_width
= name_pixbuf_width
;
894 pixbuf_holds_full_name
= last_item_width
> pb_width
+ NAME_X_OFFSET
;
895 last_item_width
= it_width
;
897 if (pixbuf_holds_full_name
&& (it_width
>= pb_width
+ NAME_X_OFFSET
)) {
899 we've previously had the full name length showing
900 and its still showing.
905 if (pb_width
> it_width
- NAME_X_OFFSET
) {
906 pb_width
= it_width
- NAME_X_OFFSET
;
909 if (it_width
<= NAME_X_OFFSET
) {
910 wide_enough_for_name
= false;
912 wide_enough_for_name
= true;
915 update_name_pixbuf_visibility ();
917 name_pixbuf
->property_pixbuf() = pixbuf_from_string(item_name
, NAME_FONT
, pb_width
, NAME_HEIGHT
, Gdk::Color ("#000000"));
922 * Callback used to remove this time axis item during the gtk idle loop.
923 * This is used to avoid deleting the obejct while inside the remove_this_item
926 * @param item the TimeAxisViewItem to remove.
927 * @param src the identity of the object that initiated the change.
930 TimeAxisViewItem::idle_remove_this_item(TimeAxisViewItem
* item
, void* src
)
932 item
->ItemRemoved (item
->get_item_name(), src
); /* EMIT_SIGNAL */
939 TimeAxisViewItem::set_y (double y
)
941 double const old
= group
->property_y ();
943 group
->move (0, y
- old
);
948 TimeAxisViewItem::update_name_pixbuf_visibility ()
954 if (wide_enough_for_name
&& high_enough_for_name
) {
955 name_pixbuf
->show ();
957 name_pixbuf
->hide ();
962 TimeAxisViewItem::parameter_changed (string p
)
964 if (p
== "color-regions-using-track-color") {