add more controllable modifiers for region transparency
[ardour.git] / gtk2_ardour / region_view.cc
1 /*
2     Copyright (C) 2001-2006 Paul Davis
3
4     This program is free software; you can redistribute it and/or modify
5     it under the terms of the GNU General Public License as published by
6     the Free Software Foundation; either version 2 of the License, or
7     (at your option) any later version.
8
9     This program is distributed in the hope that it will be useful,
10     but WITHOUT ANY WARRANTY; without even the implied warranty of
11     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12     GNU General Public License for more details.
13
14     You should have received a copy of the GNU General Public License
15     along with this program; if not, write to the Free Software
16     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
17
18 */
19
20 #include <cmath>
21 #include <algorithm>
22
23 #include <gtkmm.h>
24
25 #include <gtkmm2ext/gtk_ui.h>
26
27 #include "ardour/playlist.h"
28 #include "ardour/session.h"
29
30 #include "canvas/polygon.h"
31 #include "canvas/debug.h"
32 #include "canvas/pixbuf.h"
33 #include "canvas/text.h"
34 #include "canvas/line.h"
35 #include "canvas/utils.h"
36 #include "canvas/colors.h"
37
38 #include "ardour_ui.h"
39 #include "global_signals.h"
40 #include "streamview.h"
41 #include "region_view.h"
42 #include "automation_region_view.h"
43 #include "route_time_axis.h"
44 #include "public_editor.h"
45 #include "region_editor.h"
46 #include "ghostregion.h"
47 #include "route_time_axis.h"
48 #include "ui_config.h"
49 #include "utils.h"
50 #include "rgb_macros.h"
51 #include "gui_thread.h"
52
53 #include "i18n.h"
54
55 using namespace std;
56 using namespace ARDOUR;
57 using namespace ARDOUR_UI_UTILS;
58 using namespace PBD;
59 using namespace Editing;
60 using namespace Gtk;
61 using namespace ArdourCanvas;
62
63 static const int32_t sync_mark_width = 9;
64
65 PBD::Signal1<void,RegionView*> RegionView::RegionViewGoingAway;
66
67 RegionView::RegionView (ArdourCanvas::Container*          parent,
68                         TimeAxisView&                     tv,
69                         boost::shared_ptr<ARDOUR::Region> r,
70                         double                            spu,
71                         uint32_t                          basic_color,
72                         bool                              automation)
73         : TimeAxisViewItem (r->name(), *parent, tv, spu, basic_color, r->position(), r->length(), false, automation,
74                             (automation ? TimeAxisViewItem::ShowFrame :
75                              TimeAxisViewItem::Visibility (TimeAxisViewItem::ShowNameText|
76                                                            TimeAxisViewItem::ShowNameHighlight| TimeAxisViewItem::ShowFrame)))
77         , _region (r)
78         , sync_mark(0)
79         , sync_line(0)
80         , editor(0)
81         , current_visible_sync_position(0.0)
82         , valid(false)
83         , _enable_display(false)
84         , _pixel_width(1.0)
85         , in_destructor(false)
86         , wait_for_data(false)
87         , _silence_text (0)
88 {
89         GhostRegion::CatchDeletion.connect (*this, invalidator (*this), boost::bind (&RegionView::remove_ghost, this, _1), gui_context());
90 }
91
92 RegionView::RegionView (const RegionView& other)
93         : sigc::trackable(other)
94         , TimeAxisViewItem (other)
95         , _silence_text (0)
96 {
97         /* derived concrete type will call init () */
98
99         _region = other._region;
100         current_visible_sync_position = other.current_visible_sync_position;
101         valid = false;
102         _pixel_width = other._pixel_width;
103
104         GhostRegion::CatchDeletion.connect (*this, invalidator (*this), boost::bind (&RegionView::remove_ghost, this, _1), gui_context());
105 }
106
107 RegionView::RegionView (const RegionView& other, boost::shared_ptr<Region> other_region)
108         : sigc::trackable(other)
109         , TimeAxisViewItem (other)
110         , _silence_text (0)
111 {
112         /* this is a pseudo-copy constructor used when dragging regions
113            around on the canvas.
114         */
115
116         /* derived concrete type will call init () */
117
118         _region = other_region;
119         current_visible_sync_position = other.current_visible_sync_position;
120         valid = false;
121         _pixel_width = other._pixel_width;
122
123         GhostRegion::CatchDeletion.connect (*this, invalidator (*this), boost::bind (&RegionView::remove_ghost, this, _1), gui_context());
124 }
125
126 RegionView::RegionView (ArdourCanvas::Container*          parent,
127                         TimeAxisView&                     tv,
128                         boost::shared_ptr<ARDOUR::Region> r,
129                         double                            spu,
130                         uint32_t                          basic_color,
131                         bool                              recording,
132                         TimeAxisViewItem::Visibility      visibility)
133         : TimeAxisViewItem (r->name(), *parent, tv, spu, basic_color, r->position(), r->length(), recording, false, visibility)
134         , _region (r)
135         , sync_mark(0)
136         , sync_line(0)
137         , editor(0)
138         , current_visible_sync_position(0.0)
139         , valid(false)
140         , _enable_display(false)
141         , _pixel_width(1.0)
142         , in_destructor(false)
143         , wait_for_data(false)
144         , _silence_text (0)
145 {
146 }
147
148 void
149 RegionView::init (bool wfd)
150 {
151         editor        = 0;
152         valid         = true;
153         in_destructor = false;
154         wait_for_data = wfd;
155         sync_mark     = 0;
156         sync_line     = 0;
157         sync_mark     = 0;
158         sync_line     = 0;
159
160         if (name_highlight) {
161                 name_highlight->set_data ("regionview", this);
162                 name_highlight->Event.connect (sigc::bind (sigc::mem_fun (PublicEditor::instance(), &PublicEditor::canvas_region_view_name_highlight_event), name_highlight, this));
163         }
164         
165         if (frame_handle_start) {
166                 frame_handle_start->set_data ("regionview", this);
167                 frame_handle_start->set_data ("isleft", (void*) 1);
168                 frame_handle_start->Event.connect (sigc::bind (sigc::mem_fun (PublicEditor::instance(), &PublicEditor::canvas_frame_handle_event), frame_handle_start, this));
169                 frame_handle_start->raise_to_top();
170         }
171         
172         if (frame_handle_end) {
173                 frame_handle_end->set_data ("regionview", this);
174                 frame_handle_end->set_data ("isleft", (void*) 0);
175                 frame_handle_end->Event.connect (sigc::bind (sigc::mem_fun (PublicEditor::instance(), &PublicEditor::canvas_frame_handle_event), frame_handle_end, this));
176                 frame_handle_end->raise_to_top();
177         }
178
179         if (name_text) {
180                 name_text->set_data ("regionview", this);
181                 name_text->Event.connect (sigc::bind (sigc::mem_fun (PublicEditor::instance(), &PublicEditor::canvas_region_view_name_event), name_text, this));
182         }
183
184         if (wfd) {
185                 _enable_display = true;
186         }
187
188         set_height (trackview.current_height());
189
190         _region->PropertyChanged.connect (*this, invalidator (*this), boost::bind (&RegionView::region_changed, this, _1), gui_context());
191
192         set_colors ();
193
194         ColorsChanged.connect (sigc::mem_fun (*this, &RegionView::color_handler));
195
196         /* XXX sync mark drag? */
197 }
198
199 RegionView::~RegionView ()
200 {
201         in_destructor = true;
202
203         for (vector<GhostRegion*>::iterator g = ghosts.begin(); g != ghosts.end(); ++g) {
204                 delete *g;
205         }
206
207         for (list<ArdourCanvas::Rectangle*>::iterator i = _coverage_frames.begin (); i != _coverage_frames.end (); ++i) {
208                 delete *i;
209         }
210
211         drop_silent_frames ();
212
213         delete editor;
214 }
215
216 bool
217 RegionView::canvas_group_event (GdkEvent* event)
218 {
219         if (!in_destructor) {
220                 return trackview.editor().canvas_region_view_event (event, group, this);
221         }
222         return false;
223 }
224
225 void
226 RegionView::set_silent_frames (const AudioIntervalResult& silences, double /*threshold*/)
227 {
228         framecnt_t shortest = max_framecnt;
229
230         /* remove old silent frames */
231         drop_silent_frames ();
232
233         if (silences.empty()) {
234                 return;
235         }
236
237         uint32_t const color = ARDOUR_UI::config()->color_mod ("silence", "silence");
238
239         for (AudioIntervalResult::const_iterator i = silences.begin(); i != silences.end(); ++i) {
240
241                 ArdourCanvas::Rectangle* cr = new ArdourCanvas::TimeRectangle (group);
242                 cr->set_ignore_events (true);
243                 _silent_frames.push_back (cr);
244
245                 /* coordinates for the rect are relative to the regionview origin */
246
247                 cr->set_x0 (trackview.editor().sample_to_pixel (i->first - _region->start()));
248                 cr->set_x1 (trackview.editor().sample_to_pixel (i->second - _region->start()));
249                 cr->set_y0 (1);
250                 cr->set_y1 (_height - 2);
251                 cr->set_outline (false);
252                 cr->set_fill_color (color);
253
254                 shortest = min (shortest, i->second - i->first);
255         }
256
257         /* Find shortest audible segment */
258         framecnt_t shortest_audible = max_framecnt;
259
260         framecnt_t s = _region->start();
261         for (AudioIntervalResult::const_iterator i = silences.begin(); i != silences.end(); ++i) {
262                 framecnt_t const dur = i->first - s;
263                 if (dur > 0) {
264                         shortest_audible = min (shortest_audible, dur);
265                 }
266
267                 s = i->second;
268         }
269
270         framecnt_t const dur = _region->start() + _region->length() - 1 - s;
271         if (dur > 0) {
272                 shortest_audible = min (shortest_audible, dur);
273         }
274
275         _silence_text = new ArdourCanvas::Text (group);
276         _silence_text->set_ignore_events (true);
277         _silence_text->set_font_description (get_font_for_style (N_("SilenceText")));
278         _silence_text->set_color (ARDOUR_UI::config()->color ("silence text"));
279
280         /* both positions are relative to the region start offset in source */
281
282         _silence_text->set_x_position (trackview.editor().sample_to_pixel (silences.front().first - _region->start()) + 10.0);
283         _silence_text->set_y_position (20.0);
284
285         double ms = (float) shortest/_region->session().frame_rate();
286
287         /* ms are now in seconds */
288
289         char const * sunits;
290
291         if (ms >= 60.0) {
292                 sunits = _("minutes");
293                 ms /= 60.0;
294         } else if (ms < 1.0) {
295                 sunits = _("msecs");
296                 ms *= 1000.0;
297         } else {
298                 sunits = _("secs");
299         }
300
301         string text = string_compose (ngettext ("%1 silent segment", "%1 silent segments", silences.size()), silences.size())
302                 + ", "
303                 + string_compose (_("shortest = %1 %2"), ms, sunits);
304
305         if (shortest_audible != max_framepos) {
306                 /* ms are now in seconds */
307                 double ma = (float) shortest_audible / _region->session().frame_rate();
308                 char const * aunits;
309
310                 if (ma >= 60.0) {
311                         aunits = _("minutes");
312                         ma /= 60.0;
313                 } else if (ma < 1.0) {
314                         aunits = _("msecs");
315                         ma *= 1000.0;
316                 } else {
317                         aunits = _("secs");
318                 }
319
320                 text += string_compose (_("\n  (shortest audible segment = %1 %2)"), ma, aunits);
321         }
322
323         _silence_text->set (text);
324 }
325
326 void
327 RegionView::hide_silent_frames ()
328 {
329         for (list<ArdourCanvas::Rectangle*>::iterator i = _silent_frames.begin (); i != _silent_frames.end (); ++i) {
330                 (*i)->hide ();
331         }
332         _silence_text->hide();
333 }
334
335 void
336 RegionView::drop_silent_frames ()
337 {
338         for (list<ArdourCanvas::Rectangle*>::iterator i = _silent_frames.begin (); i != _silent_frames.end (); ++i) {
339                 delete *i;
340         }
341         _silent_frames.clear ();
342
343         delete _silence_text;
344         _silence_text = 0;
345 }
346
347 gint
348 RegionView::_lock_toggle (ArdourCanvas::Item*, GdkEvent* ev, void* arg)
349 {
350         switch (ev->type) {
351         case GDK_BUTTON_RELEASE:
352                 static_cast<RegionView*>(arg)->lock_toggle ();
353                 return TRUE;
354                 break;
355         default:
356                 break;
357         }
358         return FALSE;
359 }
360
361 void
362 RegionView::lock_toggle ()
363 {
364         _region->set_locked (!_region->locked());
365 }
366
367 void
368 RegionView::region_changed (const PropertyChange& what_changed)
369 {
370         ENSURE_GUI_THREAD (*this, &RegionView::region_changed, what_changed);
371
372         if (what_changed.contains (ARDOUR::bounds_change)) {
373                 region_resized (what_changed);
374                 region_sync_changed ();
375         }
376         if (what_changed.contains (ARDOUR::Properties::muted)) {
377                 region_muted ();
378         }
379         if (what_changed.contains (ARDOUR::Properties::opaque)) {
380                 region_opacity ();
381         }
382         if (what_changed.contains (ARDOUR::Properties::name)) {
383                 region_renamed ();
384         }
385         if (what_changed.contains (ARDOUR::Properties::sync_position)) {
386                 region_sync_changed ();
387         }
388         if (what_changed.contains (ARDOUR::Properties::locked)) {
389                 region_locked ();
390         }
391         if (what_changed.contains (ARDOUR::Properties::locked)) {
392                 /* name will show locked status */
393                 region_renamed ();
394         }
395 }
396
397 void
398 RegionView::region_locked ()
399 {
400         /* name will show locked status */
401         region_renamed ();
402 }
403
404 void
405 RegionView::region_resized (const PropertyChange& what_changed)
406 {
407         double unit_length;
408
409         if (what_changed.contains (ARDOUR::Properties::position)) {
410                 set_position (_region->position(), 0);
411         }
412
413         PropertyChange s_and_l;
414         s_and_l.add (ARDOUR::Properties::start);
415         s_and_l.add (ARDOUR::Properties::length);
416
417         if (what_changed.contains (s_and_l)) {
418
419                 set_duration (_region->length(), 0);
420
421                 unit_length = _region->length() / samples_per_pixel;
422
423                 for (vector<GhostRegion*>::iterator i = ghosts.begin(); i != ghosts.end(); ++i) {
424
425                         (*i)->set_duration (unit_length);
426
427                 }
428         }
429 }
430
431 void
432 RegionView::reset_width_dependent_items (double pixel_width)
433 {
434         TimeAxisViewItem::reset_width_dependent_items (pixel_width);
435         _pixel_width = pixel_width;
436 }
437
438 void
439 RegionView::region_muted ()
440 {
441         set_frame_color ();
442         region_renamed ();
443 }
444
445 void
446 RegionView::region_opacity ()
447 {
448         set_frame_color ();
449 }
450
451 void
452 RegionView::raise_to_top ()
453 {
454         _region->raise_to_top ();
455 }
456
457 void
458 RegionView::lower_to_bottom ()
459 {
460         _region->lower_to_bottom ();
461 }
462
463 bool
464 RegionView::set_position (framepos_t pos, void* /*src*/, double* ignored)
465 {
466         double delta;
467         bool ret;
468
469         if (!(ret = TimeAxisViewItem::set_position (pos, this, &delta))) {
470                 return false;
471         }
472
473         if (ignored) {
474                 *ignored = delta;
475         }
476
477         if (delta) {
478                 for (vector<GhostRegion*>::iterator i = ghosts.begin(); i != ghosts.end(); ++i) {
479                         (*i)->group->move (ArdourCanvas::Duple (delta, 0.0));
480                 }
481         }
482
483         return ret;
484 }
485
486 void
487 RegionView::set_samples_per_pixel (double fpp)
488 {
489         TimeAxisViewItem::set_samples_per_pixel (fpp);
490
491         for (vector<GhostRegion*>::iterator i = ghosts.begin(); i != ghosts.end(); ++i) {
492                 (*i)->set_samples_per_pixel (fpp);
493                 (*i)->set_duration (_region->length() / fpp);
494         }
495
496         region_sync_changed ();
497 }
498
499 bool
500 RegionView::set_duration (framecnt_t frames, void *src)
501 {
502         if (!TimeAxisViewItem::set_duration (frames, src)) {
503                 return false;
504         }
505
506         for (vector<GhostRegion*>::iterator i = ghosts.begin(); i != ghosts.end(); ++i) {
507                 (*i)->set_duration (_region->length() / samples_per_pixel);
508         }
509
510         return true;
511 }
512
513 void
514 RegionView::set_colors ()
515 {
516         TimeAxisViewItem::set_colors ();
517
518         if (sync_mark) {
519                 /* XXX: make these colours themable */
520                 sync_mark->set_fill_color (ArdourCanvas::rgba_to_color (0, 1.0, 0, 1.0));
521                 sync_line->set_outline_color (ArdourCanvas::rgba_to_color (0, 1.0, 0, 1.0));
522         }
523 }
524
525 uint32_t
526 RegionView::get_fill_color () const
527 {
528         ArdourCanvas::Color f = TimeAxisViewItem::get_fill_color();
529         char const *modname;
530         
531         if (_region->opaque()) {
532                 modname = "opaque region base";
533         } else {
534                 modname = "transparent region base";
535         }
536
537         return HSV(f).mod (ARDOUR_UI::config()->modifier (modname)).color ();
538 }
539
540 void
541 RegionView::show_region_editor ()
542 {
543         if (editor == 0) {
544                 editor = new RegionEditor (trackview.session(), region());
545         }
546
547         editor->present ();
548         editor->show_all();
549 }
550
551 void
552 RegionView::hide_region_editor()
553 {
554         if (editor) {
555                 editor->hide_all ();
556         }
557 }
558
559 std::string
560 RegionView::make_name () const
561 {
562         std::string str;
563
564         // XXX nice to have some good icons for this
565
566         if (_region->locked()) {
567                 str += '>';
568                 str += _region->name();
569                 str += '<';
570         } else if (_region->position_locked()) {
571                 str += '{';
572                 str += _region->name();
573                 str += '}';
574         } else if (_region->video_locked()) {
575                 str += '[';
576                 str += _region->name();
577                 str += ']';
578         } else {
579                 str = _region->name();
580         }
581
582         if (_region->muted()) {
583                 str = string ("!") + str;
584         }
585
586         return str;
587 }
588
589 void
590 RegionView::region_renamed ()
591 {
592         std::string str = make_name ();
593
594         set_item_name (str, this);
595         set_name_text (str);
596         reset_width_dependent_items (_pixel_width);
597 }
598
599 void
600 RegionView::region_sync_changed ()
601 {
602         int sync_dir;
603         framecnt_t sync_offset;
604
605         sync_offset = _region->sync_offset (sync_dir);
606
607         if (sync_offset == 0) {
608                 /* no need for a sync mark */
609                 if (sync_mark) {
610                         sync_mark->hide();
611                         sync_line->hide ();
612                 }
613                 return;
614         }
615
616         if (!sync_mark) {
617
618                 /* points set below */
619
620                 sync_mark = new ArdourCanvas::Polygon (group);
621                 CANVAS_DEBUG_NAME (sync_mark, string_compose ("sync mark for %1", get_item_name()));
622                 sync_mark->set_fill_color (ArdourCanvas::rgba_to_color (0, 1.0, 0, 1.0));    // FIXME make a themeable colour
623
624                 sync_line = new ArdourCanvas::Line (group);
625                 CANVAS_DEBUG_NAME (sync_line, string_compose ("sync mark for %1", get_item_name()));
626                 sync_line->set_outline_color (ArdourCanvas::rgba_to_color (0, 1.0, 0, 1.0)); // FIXME make a themeable colour
627         }
628
629         /* this has to handle both a genuine change of position, a change of samples_per_pixel
630            and a change in the bounds of the _region->
631          */
632
633         if (sync_offset == 0) {
634
635                 /* no sync mark - its the start of the region */
636
637                 sync_mark->hide();
638                 sync_line->hide ();
639
640         } else {
641
642                 if ((sync_dir < 0) || ((sync_dir > 0) && (sync_offset > _region->length()))) {
643
644                         /* no sync mark - its out of the bounds of the region */
645
646                         sync_mark->hide();
647                         sync_line->hide ();
648
649                 } else {
650
651                         /* lets do it */
652
653                         Points points;
654
655                         //points = sync_mark->property_points().get_value();
656
657                         double offset = sync_offset / samples_per_pixel;
658                         points.push_back (ArdourCanvas::Duple (offset - ((sync_mark_width-1)/2), 1));
659                         points.push_back (ArdourCanvas::Duple (offset + ((sync_mark_width-1)/2), 1));
660                         points.push_back (ArdourCanvas::Duple (offset, sync_mark_width - 1));
661                         points.push_back (ArdourCanvas::Duple (offset - ((sync_mark_width-1)/2), 1));
662                         sync_mark->set (points);
663                         sync_mark->show ();
664
665                         sync_line->set (ArdourCanvas::Duple (offset, 0), ArdourCanvas::Duple (offset, trackview.current_height() - NAME_HIGHLIGHT_SIZE));
666                         sync_line->show ();
667                 }
668         }
669 }
670
671 void
672 RegionView::move (double x_delta, double y_delta)
673 {
674         if (!_region->can_move() || (x_delta == 0 && y_delta == 0)) {
675                 return;
676         }
677
678         /* items will not prevent Item::move() moving
679          * them to a negative x-axis coordinate, which
680          * is legal, but we don't want that here.
681          */
682
683         ArdourCanvas::Item *item = get_canvas_group ();
684         
685         if (item->position().x + x_delta < 0) {
686                 x_delta = -item->position().x; /* move it to zero */
687         }
688
689         item->move (ArdourCanvas::Duple (x_delta, y_delta));
690
691         /* note: ghosts never leave their tracks so y_delta for them is always zero */
692
693         for (vector<GhostRegion*>::iterator i = ghosts.begin(); i != ghosts.end(); ++i) {
694                 (*i)->group->move (ArdourCanvas::Duple (x_delta, 0.0));
695         }
696 }
697
698 void
699 RegionView::remove_ghost_in (TimeAxisView& tv)
700 {
701         for (vector<GhostRegion*>::iterator i = ghosts.begin(); i != ghosts.end(); ++i) {
702                 if (&(*i)->trackview == &tv) {
703                         delete *i;
704                         break;
705                 }
706         }
707 }
708
709 void
710 RegionView::remove_ghost (GhostRegion* ghost)
711 {
712         if (in_destructor) {
713                 return;
714         }
715
716         for (vector<GhostRegion*>::iterator i = ghosts.begin(); i != ghosts.end(); ++i) {
717                 if (*i == ghost) {
718                         ghosts.erase (i);
719                         break;
720                 }
721         }
722 }
723
724 void
725 RegionView::set_height (double h)
726 {
727         TimeAxisViewItem::set_height(h);
728
729         if (sync_line) {
730                 Points points;
731                 int sync_dir;
732                 framecnt_t sync_offset;
733                 sync_offset = _region->sync_offset (sync_dir);
734                 double offset = sync_offset / samples_per_pixel;
735
736                 sync_line->set (
737                         ArdourCanvas::Duple (offset, 0),
738                         ArdourCanvas::Duple (offset, h - NAME_HIGHLIGHT_SIZE)
739                         );
740         }
741
742         for (list<ArdourCanvas::Rectangle*>::iterator i = _coverage_frames.begin(); i != _coverage_frames.end(); ++i) {
743                 (*i)->set_y1 (h + 1);
744         }
745
746         for (list<ArdourCanvas::Rectangle*>::iterator i = _silent_frames.begin(); i != _silent_frames.end(); ++i) {
747                 (*i)->set_y1 (h + 1);
748         }
749
750 }
751
752 /** Remove old coverage frames and make new ones, if we're in a LayerDisplay mode
753  *  which uses them. */
754 void
755 RegionView::update_coverage_frames (LayerDisplay d)
756 {
757         /* remove old coverage frames */
758         for (list<ArdourCanvas::Rectangle*>::iterator i = _coverage_frames.begin (); i != _coverage_frames.end (); ++i) {
759                 delete *i;
760         }
761
762         _coverage_frames.clear ();
763
764         if (d != Stacked) {
765                 /* don't do coverage frames unless we're in stacked mode */
766                 return;
767         }
768
769         boost::shared_ptr<Playlist> pl (_region->playlist ());
770         if (!pl) {
771                 return;
772         }
773
774         framepos_t const position = _region->first_frame ();
775         framepos_t t = position;
776         framepos_t const end = _region->last_frame ();
777
778         ArdourCanvas::Rectangle* cr = 0;
779         bool me = false;
780
781         /* the color that will be used to show parts of regions that will not be heard */
782         uint32_t const non_playing_color = ARDOUR_UI::config()->color_mod ("covered region", "region base");
783
784         while (t < end) {
785
786                 t++;
787
788                 /* is this region is on top at time t? */
789                 bool const new_me = (pl->top_unmuted_region_at (t) == _region);
790
791                 /* finish off any old rect, if required */
792                 if (cr && me != new_me) {
793                         cr->set_x1 (trackview.editor().sample_to_pixel (t - position));
794                 }
795
796                 /* start off any new rect, if required */
797                 if (cr == 0 || me != new_me) {
798                         cr = new ArdourCanvas::TimeRectangle (group);
799                         _coverage_frames.push_back (cr);
800                         cr->set_x0 (trackview.editor().sample_to_pixel (t - position));
801                         cr->set_y0 (1);
802                         cr->set_y1 (_height + 1);
803                         cr->set_outline (false);
804                         cr->set_ignore_events (true);
805                         if (new_me) {
806                                 cr->set_fill_color (UINT_RGBA_CHANGE_A (non_playing_color, 0));
807                         } else {
808                                 cr->set_fill_color (non_playing_color);
809                         }
810                 }
811
812                 t = pl->find_next_region_boundary (t, 1);
813                 me = new_me;
814         }
815
816         if (cr) {
817                 /* finish off the last rectangle */
818                 cr->set_x1 (trackview.editor().sample_to_pixel (end - position));
819         }
820
821         if (frame_handle_start) {
822                 frame_handle_start->raise_to_top ();
823         }
824
825         if (frame_handle_end) {
826                 frame_handle_end->raise_to_top ();
827         }
828
829         if (name_highlight) {
830                 name_highlight->raise_to_top ();
831         }
832
833         if (name_text) {
834                 name_text->raise_to_top ();
835         }
836 }
837
838 bool
839 RegionView::trim_front (framepos_t new_bound, bool no_overlap)
840 {
841         if (_region->locked()) {
842                 return false;
843         }
844
845         RouteTimeAxisView& rtv = dynamic_cast<RouteTimeAxisView&> (trackview);
846         double const speed = rtv.track()->speed ();
847
848         framepos_t const pre_trim_first_frame = _region->first_frame();
849
850         _region->trim_front ((framepos_t) (new_bound * speed));
851
852         if (no_overlap) {
853                 // Get the next region on the left of this region and shrink/expand it.
854                 boost::shared_ptr<Playlist> playlist (_region->playlist());
855                 boost::shared_ptr<Region> region_left = playlist->find_next_region (pre_trim_first_frame, End, 0);
856
857                 bool regions_touching = false;
858
859                 if (region_left != 0 && (pre_trim_first_frame == region_left->last_frame() + 1)) {
860                         regions_touching = true;
861                 }
862
863                 // Only trim region on the left if the first frame has gone beyond the left region's last frame.
864                 if (region_left != 0 && (region_left->last_frame() > _region->first_frame() || regions_touching)) {
865                         region_left->trim_end (_region->first_frame() - 1);
866                 }
867         }
868
869         region_changed (ARDOUR::bounds_change);
870
871         return (pre_trim_first_frame != _region->first_frame());  //return true if we actually changed something
872 }
873
874 bool
875 RegionView::trim_end (framepos_t new_bound, bool no_overlap)
876 {
877         if (_region->locked()) {
878                 return false;
879         }
880
881         RouteTimeAxisView& rtv = dynamic_cast<RouteTimeAxisView&> (trackview);
882         double const speed = rtv.track()->speed ();
883
884         framepos_t const pre_trim_last_frame = _region->last_frame();
885
886         _region->trim_end ((framepos_t) (new_bound * speed));
887
888         if (no_overlap) {
889                 // Get the next region on the right of this region and shrink/expand it.
890                 boost::shared_ptr<Playlist> playlist (_region->playlist());
891                 boost::shared_ptr<Region> region_right = playlist->find_next_region (pre_trim_last_frame, Start, 1);
892
893                 bool regions_touching = false;
894
895                 if (region_right != 0 && (pre_trim_last_frame == region_right->first_frame() - 1)) {
896                         regions_touching = true;
897                 }
898
899                 // Only trim region on the right if the last frame has gone beyond the right region's first frame.
900                 if (region_right != 0 && (region_right->first_frame() < _region->last_frame() || regions_touching)) {
901                         region_right->trim_front (_region->last_frame() + 1);
902                 }
903
904                 region_changed (ARDOUR::bounds_change);
905
906         } else {
907                 region_changed (PropertyChange (ARDOUR::Properties::length));
908         }
909
910         return (pre_trim_last_frame != _region->last_frame());  //return true if we actually changed something
911 }
912
913
914 void
915 RegionView::thaw_after_trim ()
916 {
917         if (_region->locked()) {
918                 return;
919         }
920
921         _region->resume_property_changes ();
922 }
923
924
925 void
926 RegionView::move_contents (frameoffset_t distance)
927 {
928         if (_region->locked()) {
929                 return;
930         }
931         _region->move_start (distance);
932         region_changed (PropertyChange (ARDOUR::Properties::start));
933 }
934
935 /** Snap a frame offset within our region using the current snap settings.
936  *  @param x Frame offset from this region's position.
937  *  @return Snapped frame offset from this region's position.
938  */
939 frameoffset_t
940 RegionView::snap_frame_to_frame (frameoffset_t x) const
941 {
942         PublicEditor& editor = trackview.editor();
943
944         /* x is region relative, convert it to global absolute frames */
945         framepos_t const session_frame = x + _region->position();
946
947         /* try a snap in either direction */
948         framepos_t frame = session_frame;
949         editor.snap_to (frame, RoundNearest);
950
951         /* if we went off the beginning of the region, snap forwards */
952         if (frame < _region->position ()) {
953                 frame = session_frame;
954                 editor.snap_to (frame, RoundUpAlways);
955         }
956
957         /* back to region relative */
958         return frame - _region->position();
959 }