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