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