libs/ardour/audioregion.cc

   1 /*
   2     Copyright (C) 2000-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     $Id$
  19 */
  20
  21 #include <cmath>
  22 #include <climits>
  23 #include <cfloat>
  24
  25 #include <set>
  26
  27 #include <sigc++/bind.h>
  28 #include <sigc++/class_slot.h>
  29
  30 #include <glibmm/thread.h>
  31
  32 #include <pbd/basename.h>
  33 #include <pbd/xml++.h>
  34 #include <pbd/stacktrace.h>
  35
  36 #include <ardour/audioregion.h>
  37 #include <ardour/session.h>
  38 #include <ardour/gain.h>
  39 #include <ardour/dB.h>
  40 #include <ardour/playlist.h>
  41 #include <ardour/audiofilter.h>
  42 #include <ardour/audiofilesource.h>
  43 #include <ardour/destructive_filesource.h>
  44
  45 #include "i18n.h"
  46 #include <locale.h>
  47
  48 using namespace std;
  49 using namespace ARDOUR;
  50
  51 /* a Session will reset these to its chosen defaults by calling AudioRegion::set_default_fade() */
  52
  53 Change AudioRegion::FadeInChanged         = ARDOUR::new_change();
  54 Change AudioRegion::FadeOutChanged        = ARDOUR::new_change();
  55 Change AudioRegion::FadeInActiveChanged   = ARDOUR::new_change();
  56 Change AudioRegion::FadeOutActiveChanged  = ARDOUR::new_change();
  57 Change AudioRegion::EnvelopeActiveChanged = ARDOUR::new_change();
  58 Change AudioRegion::ScaleAmplitudeChanged = ARDOUR::new_change();
  59 Change AudioRegion::EnvelopeChanged       = ARDOUR::new_change();
  60
  61 /** Basic AudioRegion constructor (one channel) */
  62 AudioRegion::AudioRegion (boost::shared_ptr<AudioSource> src, nframes_t start, nframes_t length)
  63         : Region (src, start, length, PBD::basename_nosuffix(src->name()), DataType::AUDIO, 0,  Region::Flag(Region::DefaultFlags|Region::External)),
  64           _fade_in (0.0, 2.0, 1.0, false),
  65           _fade_out (0.0, 2.0, 1.0, false),
  66           _envelope (0.0, 2.0, 1.0, false)
  67 {
  68         boost::shared_ptr<AudioFileSource> afs = boost::dynamic_pointer_cast<AudioFileSource> (src);
  69         if (afs) {
  70                 afs->HeaderPositionOffsetChanged.connect (mem_fun (*this, &AudioRegion::source_offset_changed));
  71         }
  72
  73         _scale_amplitude = 1.0;
  74
  75         set_default_fades ();
  76         set_default_envelope ();
  77
  78         _envelope.StateChanged.connect (mem_fun (*this, &AudioRegion::envelope_changed));
  79 }
  80
  81 /* Basic AudioRegion constructor (one channel) */
  82 AudioRegion::AudioRegion (boost::shared_ptr<AudioSource> src, nframes_t start, nframes_t length, const string& name, layer_t layer, Flag flags)
  83         : Region (src, start, length, name, DataType::AUDIO, layer, flags)
  84         , _fade_in (0.0, 2.0, 1.0, false)
  85         , _fade_out (0.0, 2.0, 1.0, false)
  86         , _envelope (0.0, 2.0, 1.0, false)
  87 {
  88         boost::shared_ptr<AudioFileSource> afs = boost::dynamic_pointer_cast<AudioFileSource> (src);
  89         if (afs) {
  90                 afs->HeaderPositionOffsetChanged.connect (mem_fun (*this, &AudioRegion::source_offset_changed));
  91         }
  92
  93         _scale_amplitude = 1.0;
  94
  95         set_default_fades ();
  96         set_default_envelope ();
  97
  98         _envelope.StateChanged.connect (mem_fun (*this, &AudioRegion::envelope_changed));
  99 }
 100
 101 /* Basic AudioRegion constructor (many channels) */
 102 AudioRegion::AudioRegion (SourceList& srcs, nframes_t start, nframes_t length, const string& name, layer_t layer, Flag flags)
 103         : Region (srcs, start, length, name, DataType::AUDIO, layer, flags)
 104         , _fade_in (0.0, 2.0, 1.0, false)
 105         , _fade_out (0.0, 2.0, 1.0, false)
 106         , _envelope (0.0, 2.0, 1.0, false)
 107 {
 108         _scale_amplitude = 1.0;
 109
 110         set_default_fades ();
 111         set_default_envelope ();
 112
 113         _envelope.StateChanged.connect (mem_fun (*this, &AudioRegion::envelope_changed));
 114 }
 115
 116
 117 /** Create a new AudioRegion, that is part of an existing one */
 118 AudioRegion::AudioRegion (boost::shared_ptr<const AudioRegion> other, nframes_t offset, nframes_t length, const string& name, layer_t layer, Flag flags)
 119         : Region (other, offset, length, name, layer, flags),
 120           _fade_in (other->_fade_in),
 121           _fade_out (other->_fade_out),
 122           _envelope (other->_envelope, (double) offset, (double) offset + length)
 123 {
 124         /* return to default fades if the existing ones are too long */
 125         _fade_in_disabled = 0;
 126         _fade_out_disabled = 0;
 127
 128
 129         if (_flags & LeftOfSplit) {
 130                 if (_fade_in.back()->when >= _length) {
 131                         set_default_fade_in ();
 132                 } else {
 133                         _fade_in_disabled = other->_fade_in_disabled;
 134                 }
 135                 set_default_fade_out ();
 136                 _flags = Flag (_flags & ~Region::LeftOfSplit);
 137         }
 138
 139         if (_flags & RightOfSplit) {
 140                 if (_fade_out.back()->when >= _length) {
 141                         set_default_fade_out ();
 142                 } else {
 143                         _fade_out_disabled = other->_fade_out_disabled;
 144                 }
 145                 set_default_fade_in ();
 146                 _flags = Flag (_flags & ~Region::RightOfSplit);
 147         }
 148
 149         _scale_amplitude = other->_scale_amplitude;
 150
 151         _envelope.StateChanged.connect (mem_fun (*this, &AudioRegion::envelope_changed));
 152
 153         assert(_type == DataType::AUDIO);
 154 }
 155
 156 AudioRegion::AudioRegion (boost::shared_ptr<const AudioRegion> other)
 157         : Region (other),
 158           _fade_in (other->_fade_in),
 159           _fade_out (other->_fade_out),
 160           _envelope (other->_envelope)
 161 {
 162         _scale_amplitude = other->_scale_amplitude;
 163         _envelope = other->_envelope;
 164
 165         _fade_in_disabled = 0;
 166         _fade_out_disabled = 0;
 167
 168         _envelope.StateChanged.connect (mem_fun (*this, &AudioRegion::envelope_changed));
 169
 170         assert(_type == DataType::AUDIO);
 171 }
 172
 173 AudioRegion::AudioRegion (boost::shared_ptr<AudioSource> src, const XMLNode& node)
 174         : Region (src, node)
 175         , _fade_in (0.0, 2.0, 1.0, false)
 176         , _fade_out (0.0, 2.0, 1.0, false)
 177         , _envelope (0.0, 2.0, 1.0, false)
 178 {
 179         boost::shared_ptr<AudioFileSource> afs = boost::dynamic_pointer_cast<AudioFileSource> (src);
 180         if (afs) {
 181                 afs->HeaderPositionOffsetChanged.connect (mem_fun (*this, &AudioRegion::source_offset_changed));
 182         }
 183
 184         set_default_fades ();
 185
 186         if (set_state (node)) {
 187                 throw failed_constructor();
 188         }
 189
 190         _envelope.StateChanged.connect (mem_fun (*this, &AudioRegion::envelope_changed));
 191
 192         assert(_type == DataType::AUDIO);
 193 }
 194
 195 AudioRegion::AudioRegion (SourceList& srcs, const XMLNode& node)
 196         : Region (srcs, node),
 197           _fade_in (0.0, 2.0, 1.0, false),
 198           _fade_out (0.0, 2.0, 1.0, false),
 199           _envelope (0.0, 2.0, 1.0, false)
 200 {
 201         set_default_fades ();
 202         _scale_amplitude = 1.0;
 203
 204         if (set_state (node)) {
 205                 throw failed_constructor();
 206         }
 207
 208         _envelope.StateChanged.connect (mem_fun (*this, &AudioRegion::envelope_changed));
 209
 210         assert(_type == DataType::AUDIO);
 211 }
 212
 213 AudioRegion::~AudioRegion ()
 214 {
 215         cerr << "====== " << _name << " DESTRUCTOR @ " << this << endl;
 216         notify_callbacks ();
 217         GoingAway (); /* EMIT SIGNAL */
 218 }
 219
 220 void
 221 AudioRegion::set_envelope_active (bool yn)
 222 {
 223         if (envelope_active() != yn) {
 224                 char buf[64];
 225                 if (yn) {
 226                         snprintf (buf, sizeof (buf), "envelope active");
 227                         _flags = Flag (_flags|EnvelopeActive);
 228                 } else {
 229                         snprintf (buf, sizeof (buf), "envelope off");
 230                         _flags = Flag (_flags & ~EnvelopeActive);
 231                 }
 232                 send_change (EnvelopeActiveChanged);
 233         }
 234 }
 235
 236 ARDOUR::nframes_t
 237 AudioRegion::read_peaks (PeakData *buf, nframes_t npeaks, nframes_t offset, nframes_t cnt, uint32_t chan_n, double samples_per_unit) const
 238 {
 239         if (chan_n >= _sources.size()) {
 240                 return 0;
 241         }
 242
 243         if (audio_source(chan_n)->read_peaks (buf, npeaks, offset, cnt, samples_per_unit)) {
 244                 return 0;
 245         } else {
 246                 if (_scale_amplitude != 1.0) {
 247                         for (nframes_t n = 0; n < npeaks; ++n) {
 248                                 buf[n].max *= _scale_amplitude;
 249                                 buf[n].min *= _scale_amplitude;
 250                         }
 251                 }
 252                 return cnt;
 253         }
 254 }
 255
 256 ARDOUR::nframes_t
 257 AudioRegion::read_at (Sample *buf, Sample *mixdown_buffer, float *gain_buffer, nframes_t position,
 258                       nframes_t cnt,
 259                       uint32_t chan_n, nframes_t read_frames, nframes_t skip_frames) const
 260 {
 261         return _read_at (_sources, buf, mixdown_buffer, gain_buffer, position, cnt, chan_n, read_frames, skip_frames);
 262 }
 263
 264 ARDOUR::nframes_t
 265 AudioRegion::master_read_at (Sample *buf, Sample *mixdown_buffer, float *gain_buffer, nframes_t position,
 266                              nframes_t cnt, uint32_t chan_n) const
 267 {
 268         return _read_at (_master_sources, buf, mixdown_buffer, gain_buffer, position, cnt, chan_n, 0, 0);
 269 }
 270
 271 ARDOUR::nframes_t
 272 AudioRegion::_read_at (const SourceList& srcs, Sample *buf, Sample *mixdown_buffer, float *gain_buffer,
 273                        nframes_t position, nframes_t cnt,
 274                        uint32_t chan_n, nframes_t read_frames, nframes_t skip_frames) const
 275 {
 276         //cerr << _name << "._read_at(" << position << ") - " << _position << endl;
 277
 278         nframes_t internal_offset;
 279         nframes_t buf_offset;
 280         nframes_t to_read;
 281
 282         /* precondition: caller has verified that we cover the desired section */
 283
 284         if (chan_n >= _sources.size()) {
 285                 return 0; /* read nothing */
 286         }
 287
 288         if (position < _position) {
 289                 internal_offset = 0;
 290                 buf_offset = _position - position;
 291                 cnt -= buf_offset;
 292         } else {
 293                 internal_offset = position - _position;
 294                 buf_offset = 0;
 295         }
 296
 297         if (internal_offset >= _length) {
 298                 return 0; /* read nothing */
 299         }
 300
 301         if ((to_read = min (cnt, _length - internal_offset)) == 0) {
 302                 return 0; /* read nothing */
 303         }
 304
 305         if (opaque()) {
 306                 /* overwrite whatever is there */
 307                 mixdown_buffer = buf + buf_offset;
 308         } else {
 309                 mixdown_buffer += buf_offset;
 310         }
 311
 312         if (muted()) {
 313                 return 0; /* read nothing */
 314         }
 315
 316         _read_data_count = 0;
 317
 318         boost::shared_ptr<AudioSource> src = audio_source(chan_n);
 319         if (src->read (mixdown_buffer, _start + internal_offset, to_read) != to_read) {
 320                 return 0; /* "read nothing" */
 321         }
 322
 323         _read_data_count += src->read_data_count();
 324
 325         /* fade in */
 326
 327         if (_flags & FadeIn) {
 328
 329                 nframes_t fade_in_length = (nframes_t) _fade_in.back()->when;
 330
 331                 /* see if this read is within the fade in */
 332
 333                 if (internal_offset < fade_in_length) {
 334
 335                         nframes_t limit;
 336
 337                         limit = min (to_read, fade_in_length - internal_offset);
 338
 339                         _fade_in.get_vector (internal_offset, internal_offset+limit, gain_buffer, limit);
 340
 341                         for (nframes_t n = 0; n < limit; ++n) {
 342                                 mixdown_buffer[n] *= gain_buffer[n];
 343                         }
 344                 }
 345         }
 346
 347         /* fade out */
 348
 349         if (_flags & FadeOut) {
 350
 351                 /* see if some part of this read is within the fade out */
 352
 353                 /* .................        >|            REGION
 354                                             _length
 355
 356                                  {           }            FADE
 357                                              fade_out_length
 358                                  ^
 359                                _length - fade_out_length
 360                         |--------------|
 361                         ^internal_offset
 362                                        ^internal_offset + to_read
 363
 364                   we need the intersection of [internal_offset,internal_offset+to_read] with
 365                   [_length - fade_out_length, _length]
 366
 367                 */
 368
 369
 370                 nframes_t fade_out_length = (nframes_t) _fade_out.back()->when;
 371                 nframes_t fade_interval_start = max(internal_offset, _length-fade_out_length);
 372                 nframes_t fade_interval_end   = min(internal_offset + to_read, _length);
 373
 374                 if (fade_interval_end > fade_interval_start) {
 375                         /* (part of the) the fade out is  in this buffer */
 376
 377                         nframes_t limit = fade_interval_end - fade_interval_start;
 378                         nframes_t curve_offset = fade_interval_start - (_length-fade_out_length);
 379                         nframes_t fade_offset = fade_interval_start - internal_offset;
 380
 381                         _fade_out.get_vector (curve_offset,curve_offset+limit, gain_buffer, limit);
 382
 383                         for (nframes_t n = 0, m = fade_offset; n < limit; ++n, ++m) {
 384                                 mixdown_buffer[m] *= gain_buffer[n];
 385                         }
 386                 }
 387
 388         }
 389
 390         /* Regular gain curves */
 391
 392         if (envelope_active())  {
 393                 _envelope.get_vector (internal_offset, internal_offset + to_read, gain_buffer, to_read);
 394
 395                 if (_scale_amplitude != 1.0f) {
 396                         for (nframes_t n = 0; n < to_read; ++n) {
 397                                 mixdown_buffer[n] *= gain_buffer[n] * _scale_amplitude;
 398                         }
 399                 } else {
 400                         for (nframes_t n = 0; n < to_read; ++n) {
 401                                 mixdown_buffer[n] *= gain_buffer[n];
 402                         }
 403                 }
 404         } else if (_scale_amplitude != 1.0f) {
 405                 Session::apply_gain_to_buffer (mixdown_buffer, to_read, _scale_amplitude);
 406         }
 407
 408         if (!opaque()) {
 409
 410                 /* gack. the things we do for users.
 411                  */
 412
 413                 buf += buf_offset;
 414
 415                 for (nframes_t n = 0; n < to_read; ++n) {
 416                         buf[n] += mixdown_buffer[n];
 417                 }
 418         }
 419
 420         return to_read;
 421 }
 422
 423 XMLNode&
 424 AudioRegion::state (bool full)
 425 {
 426         XMLNode& node (Region::state (full));
 427         XMLNode *child;
 428         char buf[64];
 429         char buf2[64];
 430         LocaleGuard lg (X_("POSIX"));
 431
 432         snprintf (buf, sizeof (buf), "0x%x", (int) _flags);
 433         node.add_property ("flags", buf);
 434         snprintf (buf, sizeof(buf), "%.12g", _scale_amplitude);
 435         node.add_property ("scale-gain", buf);
 436
 437         for (uint32_t n=0; n < _sources.size(); ++n) {
 438                 snprintf (buf2, sizeof(buf2), "source-%d", n);
 439                 _sources[n]->id().print (buf, sizeof (buf));
 440                 node.add_property (buf2, buf);
 441         }
 442
 443         snprintf (buf, sizeof (buf), "%u", (uint32_t) _sources.size());
 444         node.add_property ("channels", buf);
 445
 446         if (full) {
 447
 448                 child = node.add_child (X_("FadeIn"));
 449
 450                 if ((_flags & DefaultFadeIn)) {
 451                         child->add_property (X_("default"), X_("yes"));
 452                 } else {
 453                         _fade_in.store_state (*child);
 454                 }
 455
 456                 child->add_property (X_("active"), _fade_in_disabled ? X_("no") : X_("yes"));
 457
 458                 child = node.add_child (X_("FadeOut"));
 459
 460                 if ((_flags & DefaultFadeOut)) {
 461                         child->add_property (X_("default"), X_("yes"));
 462                 } else {
 463                         _fade_out.store_state (*child);
 464                 }
 465
 466                 child->add_property (X_("active"), _fade_out_disabled ? X_("no") : X_("yes"));
 467         }
 468
 469         child = node.add_child ("Envelope");
 470
 471         if (full) {
 472                 bool default_env = false;
 473
 474                 // If there are only two points, the points are in the start of the region and the end of the region
 475                 // so, if they are both at 1.0f, that means the default region.
 476                 if (_envelope.size() == 2 &&
 477                     _envelope.front()->value == 1.0f &&
 478                     _envelope.back()->value==1.0f) {
 479                         if (_envelope.front()->when == 0 && _envelope.back()->when == _length) {
 480                                 default_env = true;
 481                         }
 482                 }
 483
 484                 if (default_env) {
 485                         child->add_property ("default", "yes");
 486                 } else {
 487                         _envelope.store_state (*child);
 488                 }
 489
 490         } else {
 491                 child->add_property ("default", "yes");
 492         }
 493
 494         if (full && _extra_xml) {
 495                 node.add_child_copy (*_extra_xml);
 496         }
 497
 498         return node;
 499 }
 500
 501 int
 502 AudioRegion::set_live_state (const XMLNode& node, Change& what_changed, bool send)
 503 {
 504         const XMLNodeList& nlist = node.children();
 505         const XMLProperty *prop;
 506         LocaleGuard lg (X_("POSIX"));
 507
 508         Region::set_live_state (node, what_changed, false);
 509
 510         uint32_t old_flags = _flags;
 511
 512         if ((prop = node.property ("flags")) != 0) {
 513                 _flags = Flag (strtol (prop->value().c_str(), (char **) 0, 16));
 514
 515                 _flags = Flag (_flags & ~Region::LeftOfSplit);
 516                 _flags = Flag (_flags & ~Region::RightOfSplit);
 517         }
 518
 519         if ((old_flags ^ _flags) & Muted) {
 520                 what_changed = Change (what_changed|MuteChanged);
 521         }
 522         if ((old_flags ^ _flags) & Opaque) {
 523                 what_changed = Change (what_changed|OpacityChanged);
 524         }
 525         if ((old_flags ^ _flags) & Locked) {
 526                 what_changed = Change (what_changed|LockChanged);
 527         }
 528
 529         if ((prop = node.property ("scale-gain")) != 0) {
 530                 _scale_amplitude = atof (prop->value().c_str());
 531         } else {
 532                 _scale_amplitude = 1.0;
 533         }
 534
 535         /* Now find envelope description and other misc child items */
 536
 537         for (XMLNodeConstIterator niter = nlist.begin(); niter != nlist.end(); ++niter) {
 538
 539                 XMLNode *child;
 540                 XMLProperty *prop;
 541
 542                 child = (*niter);
 543
 544                 if (child->name() == "Envelope") {
 545
 546                         _envelope.clear ();
 547
 548                         if ((prop = child->property ("default")) != 0) {
 549                                 set_default_envelope ();
 550                         } else {
 551                                 _envelope.load_state (*child);
 552                         }
 553
 554                         _envelope.set_max_xval (_length);
 555                         _envelope.truncate_end (_length);
 556
 557                 } else if (child->name() == "FadeIn") {
 558
 559                         _fade_in.clear ();
 560
 561                         if ((prop = child->property ("default")) != 0 || (prop = child->property ("steepness")) != 0) {
 562                                 set_default_fade_in ();
 563                         } else {
 564                                 _fade_in.load_state (*child);
 565                         }
 566
 567                 } else if (child->name() == "FadeOut") {
 568
 569                         _fade_out.clear ();
 570
 571                         if ((prop = child->property ("default")) != 0 || (prop = child->property ("steepness")) != 0) {
 572                                 set_default_fade_out ();
 573                         } else {
 574                                 _fade_out.load_state (*child);
 575                         }
 576                 }
 577         }
 578
 579         if (send) {
 580                 send_change (what_changed);
 581         }
 582
 583         return 0;
 584 }
 585
 586 int
 587 AudioRegion::set_state (const XMLNode& node)
 588 {
 589         /* Region::set_state() calls the virtual set_live_state(),
 590            which will get us back to AudioRegion::set_live_state()
 591            to handle the relevant stuff.
 592         */
 593
 594         return Region::set_state (node);
 595 }
 596
 597 void
 598 AudioRegion::set_fade_in_shape (FadeShape shape)
 599 {
 600         set_fade_in (shape, (nframes_t) _fade_in.back()->when);
 601 }
 602
 603 void
 604 AudioRegion::set_fade_out_shape (FadeShape shape)
 605 {
 606         set_fade_out (shape, (nframes_t) _fade_out.back()->when);
 607 }
 608
 609 void
 610 AudioRegion::set_fade_in (FadeShape shape, nframes_t len)
 611 {
 612         _fade_in.freeze ();
 613         _fade_in.clear ();
 614
 615         switch (shape) {
 616         case Linear:
 617                 _fade_in.add (0.0, 0.0);
 618                 _fade_in.add (len, 1.0);
 619                 break;
 620
 621         case Fast:
 622                 _fade_in.add (0, 0);
 623                 _fade_in.add (len * 0.389401, 0.0333333);
 624                 _fade_in.add (len * 0.629032, 0.0861111);
 625                 _fade_in.add (len * 0.829493, 0.233333);
 626                 _fade_in.add (len * 0.9447, 0.483333);
 627                 _fade_in.add (len * 0.976959, 0.697222);
 628                 _fade_in.add (len, 1);
 629                 break;
 630
 631         case Slow:
 632                 _fade_in.add (0, 0);
 633                 _fade_in.add (len * 0.0207373, 0.197222);
 634                 _fade_in.add (len * 0.0645161, 0.525);
 635                 _fade_in.add (len * 0.152074, 0.802778);
 636                 _fade_in.add (len * 0.276498, 0.919444);
 637                 _fade_in.add (len * 0.481567, 0.980556);
 638                 _fade_in.add (len * 0.767281, 1);
 639                 _fade_in.add (len, 1);
 640                 break;
 641
 642         case LogA:
 643                 _fade_in.add (0, 0);
 644                 _fade_in.add (len * 0.0737327, 0.308333);
 645                 _fade_in.add (len * 0.246544, 0.658333);
 646                 _fade_in.add (len * 0.470046, 0.886111);
 647                 _fade_in.add (len * 0.652074, 0.972222);
 648                 _fade_in.add (len * 0.771889, 0.988889);
 649                 _fade_in.add (len, 1);
 650                 break;
 651
 652         case LogB:
 653                 _fade_in.add (0, 0);
 654                 _fade_in.add (len * 0.304147, 0.0694444);
 655                 _fade_in.add (len * 0.529954, 0.152778);
 656                 _fade_in.add (len * 0.725806, 0.333333);
 657                 _fade_in.add (len * 0.847926, 0.558333);
 658                 _fade_in.add (len * 0.919355, 0.730556);
 659                 _fade_in.add (len, 1);
 660                 break;
 661         }
 662
 663         _fade_in.thaw ();
 664         _fade_in_shape = shape;
 665
 666         send_change (FadeInChanged);
 667 }
 668
 669 void
 670 AudioRegion::set_fade_out (FadeShape shape, nframes_t len)
 671 {
 672         _fade_out.freeze ();
 673         _fade_out.clear ();
 674
 675         switch (shape) {
 676         case Fast:
 677                 _fade_out.add (len * 0, 1);
 678                 _fade_out.add (len * 0.023041, 0.697222);
 679                 _fade_out.add (len * 0.0553,   0.483333);
 680                 _fade_out.add (len * 0.170507, 0.233333);
 681                 _fade_out.add (len * 0.370968, 0.0861111);
 682                 _fade_out.add (len * 0.610599, 0.0333333);
 683                 _fade_out.add (len * 1, 0);
 684                 break;
 685
 686         case LogA:
 687                 _fade_out.add (len * 0, 1);
 688                 _fade_out.add (len * 0.228111, 0.988889);
 689                 _fade_out.add (len * 0.347926, 0.972222);
 690                 _fade_out.add (len * 0.529954, 0.886111);
 691                 _fade_out.add (len * 0.753456, 0.658333);
 692                 _fade_out.add (len * 0.9262673, 0.308333);
 693                 _fade_out.add (len * 1, 0);
 694                 break;
 695
 696         case Slow:
 697                 _fade_out.add (len * 0, 1);
 698                 _fade_out.add (len * 0.305556, 1);
 699                 _fade_out.add (len * 0.548611, 0.991736);
 700                 _fade_out.add (len * 0.759259, 0.931129);
 701                 _fade_out.add (len * 0.918981, 0.68595);
 702                 _fade_out.add (len * 0.976852, 0.22865);
 703                 _fade_out.add (len * 1, 0);
 704                 break;
 705
 706         case LogB:
 707                 _fade_out.add (len * 0, 1);
 708                 _fade_out.add (len * 0.080645, 0.730556);
 709                 _fade_out.add (len * 0.277778, 0.289256);
 710                 _fade_out.add (len * 0.470046, 0.152778);
 711                 _fade_out.add (len * 0.695853, 0.0694444);
 712                 _fade_out.add (len * 1, 0);
 713                 break;
 714
 715         case Linear:
 716                 _fade_out.add (len * 0, 1);
 717                 _fade_out.add (len * 1, 0);
 718                 break;
 719         }
 720
 721         _fade_out.thaw ();
 722         _fade_out_shape = shape;
 723
 724         send_change (FadeOutChanged);
 725 }
 726
 727 void
 728 AudioRegion::set_fade_in_length (nframes_t len)
 729 {
 730         bool changed = _fade_in.extend_to (len);
 731
 732         if (changed) {
 733                 _flags = Flag (_flags & ~DefaultFadeIn);
 734                 send_change (FadeInChanged);
 735         }
 736 }
 737
 738 void
 739 AudioRegion::set_fade_out_length (nframes_t len)
 740 {
 741         bool changed =  _fade_out.extend_to (len);
 742
 743         if (changed) {
 744                 _flags = Flag (_flags & ~DefaultFadeOut);
 745         }
 746
 747         send_change (FadeOutChanged);
 748 }
 749
 750 void
 751 AudioRegion::set_fade_in_active (bool yn)
 752 {
 753         if (yn == (_flags & FadeIn)) {
 754                 return;
 755         }
 756         if (yn) {
 757                 _flags = Flag (_flags|FadeIn);
 758         } else {
 759                 _flags = Flag (_flags & ~FadeIn);
 760         }
 761
 762         send_change (FadeInActiveChanged);
 763 }
 764
 765 void
 766 AudioRegion::set_fade_out_active (bool yn)
 767 {
 768         if (yn == (_flags & FadeOut)) {
 769                 return;
 770         }
 771         if (yn) {
 772                 _flags = Flag (_flags | FadeOut);
 773         } else {
 774                 _flags = Flag (_flags & ~FadeOut);
 775         }
 776
 777         send_change (FadeOutActiveChanged);
 778 }
 779
 780 void
 781 AudioRegion::set_default_fade_in ()
 782 {
 783         set_fade_in (Linear, 64);
 784 }
 785
 786 void
 787 AudioRegion::set_default_fade_out ()
 788 {
 789         set_fade_out (Linear, 64);
 790 }
 791
 792 void
 793 AudioRegion::set_default_fades ()
 794 {
 795         _fade_in_disabled = 0;
 796         _fade_out_disabled = 0;
 797         set_default_fade_in ();
 798         set_default_fade_out ();
 799 }
 800
 801 void
 802 AudioRegion::set_default_envelope ()
 803 {
 804         _envelope.freeze ();
 805         _envelope.clear ();
 806         _envelope.add (0, 1.0f);
 807         _envelope.add (_length, 1.0f);
 808         _envelope.thaw ();
 809 }
 810
 811 void
 812 AudioRegion::recompute_at_end ()
 813 {
 814         /* our length has changed. recompute a new final point by interpolating
 815            based on the the existing curve.
 816         */
 817
 818         _envelope.freeze ();
 819         _envelope.truncate_end (_length);
 820         _envelope.set_max_xval (_length);
 821         _envelope.thaw ();
 822
 823         if (_fade_in.back()->when > _length) {
 824                 _fade_in.extend_to (_length);
 825                 send_change (FadeInChanged);
 826         }
 827
 828         if (_fade_out.back()->when > _length) {
 829                 _fade_out.extend_to (_length);
 830                 send_change (FadeOutChanged);
 831         }
 832 }
 833
 834 void
 835 AudioRegion::recompute_at_start ()
 836 {
 837         /* as above, but the shift was from the front */
 838
 839         _envelope.truncate_start (_length);
 840
 841         if (_fade_in.back()->when > _length) {
 842                 _fade_in.extend_to (_length);
 843                 send_change (FadeInChanged);
 844         }
 845
 846         if (_fade_out.back()->when > _length) {
 847                 _fade_out.extend_to (_length);
 848                 send_change (FadeOutChanged);
 849         }
 850 }
 851
 852 int
 853 AudioRegion::separate_by_channel (Session& session, vector<AudioRegion*>& v) const
 854 {
 855         SourceList srcs;
 856         string new_name;
 857
 858         for (SourceList::const_iterator i = _master_sources.begin(); i != _master_sources.end(); ++i) {
 859
 860                 srcs.clear ();
 861                 srcs.push_back (*i);
 862
 863                 /* generate a new name */
 864
 865                 if (session.region_name (new_name, _name)) {
 866                         return -1;
 867                 }
 868
 869                 /* create a copy with just one source */
 870
 871                 v.push_back (new AudioRegion (srcs, _start, _length, new_name, _layer, _flags));
 872         }
 873
 874         return 0;
 875 }
 876
 877 int
 878 AudioRegion::apply (AudioFilter& filter)
 879 {
 880         boost::shared_ptr<AudioRegion> ar = boost::dynamic_pointer_cast<AudioRegion> (shared_from_this());
 881         return filter.run (ar);
 882 }
 883
 884 int
 885 AudioRegion::exportme (Session& session, AudioExportSpecification& spec)
 886 {
 887         const nframes_t blocksize = 4096;
 888         nframes_t to_read;
 889         int status = -1;
 890
 891         spec.channels = _sources.size();
 892
 893         if (spec.prepare (blocksize, session.frame_rate())) {
 894                 goto out;
 895         }
 896
 897         spec.pos = 0;
 898         spec.total_frames = _length;
 899
 900         while (spec.pos < _length && !spec.stop) {
 901
 902
 903                 /* step 1: interleave */
 904
 905                 to_read = min (_length - spec.pos, blocksize);
 906
 907                 if (spec.channels == 1) {
 908
 909                         if (audio_source()->read (spec.dataF, _start + spec.pos, to_read) != to_read) {
 910                                 goto out;
 911                         }
 912
 913                 } else {
 914
 915                         Sample buf[blocksize];
 916
 917                         for (uint32_t chan = 0; chan < spec.channels; ++chan) {
 918
 919                                 if (audio_source(chan)->read (buf, _start + spec.pos, to_read) != to_read) {
 920                                         goto out;
 921                                 }
 922
 923                                 for (nframes_t x = 0; x < to_read; ++x) {
 924                                         spec.dataF[chan+(x*spec.channels)] = buf[x];
 925                                 }
 926                         }
 927                 }
 928
 929                 if (spec.process (to_read)) {
 930                         goto out;
 931                 }
 932
 933                 spec.pos += to_read;
 934                 spec.progress = (double) spec.pos /_length;
 935
 936         }
 937
 938         status = 0;
 939
 940   out:
 941         spec.running = false;
 942         spec.status = status;
 943         spec.clear();
 944
 945         return status;
 946 }
 947
 948 void
 949 AudioRegion::set_scale_amplitude (gain_t g)
 950 {
 951         _scale_amplitude = g;
 952
 953         /* tell the diskstream we're in */
 954
 955         if (_playlist) {
 956                 _playlist->Modified();
 957         }
 958
 959         /* tell everybody else */
 960
 961         send_change (ScaleAmplitudeChanged);
 962 }
 963
 964 void
 965 AudioRegion::normalize_to (float target_dB)
 966 {
 967         const nframes_t blocksize = 64 * 1024;
 968         Sample buf[blocksize];
 969         nframes_t fpos;
 970         nframes_t fend;
 971         nframes_t to_read;
 972         double maxamp = 0;
 973         gain_t target = dB_to_coefficient (target_dB);
 974
 975         if (target == 1.0f) {
 976                 /* do not normalize to precisely 1.0 (0 dBFS), to avoid making it appear
 977                    that we may have clipped.
 978                 */
 979                 target -= FLT_EPSILON;
 980         }
 981
 982         fpos = _start;
 983         fend = _start + _length;
 984
 985         /* first pass: find max amplitude */
 986
 987         while (fpos < fend) {
 988
 989                 uint32_t n;
 990
 991                 to_read = min (fend - fpos, blocksize);
 992
 993                 for (n = 0; n < n_channels(); ++n) {
 994
 995                         /* read it in */
 996
 997                         if (audio_source (n)->read (buf, fpos, to_read) != to_read) {
 998                                 return;
 999                         }
1000
1001                         maxamp = Session::compute_peak (buf, to_read, maxamp);
1002                 }
1003
1004                 fpos += to_read;
1005         };
1006
1007         if (maxamp == 0.0f) {
1008                 /* don't even try */
1009                 return;
1010         }
1011
1012         if (maxamp == target) {
1013                 /* we can't do anything useful */
1014                 return;
1015         }
1016
1017         /* compute scale factor */
1018
1019         _scale_amplitude = target/maxamp;
1020
1021         /* tell the diskstream we're in */
1022
1023         if (_playlist) {
1024                 _playlist->Modified();
1025         }
1026
1027         /* tell everybody else */
1028
1029         send_change (ScaleAmplitudeChanged);
1030 }
1031
1032 void
1033 AudioRegion::envelope_changed (Change ignored)
1034 {
1035         send_change (EnvelopeChanged);
1036 }
1037
1038 void
1039 AudioRegion::suspend_fade_in ()
1040 {
1041         if (++_fade_in_disabled == 1) {
1042                 set_fade_in_active (false);
1043         }
1044 }
1045
1046 void
1047 AudioRegion::resume_fade_in ()
1048 {
1049         if (_fade_in_disabled && --_fade_in_disabled == 0) {
1050                 set_fade_in_active (true);
1051         }
1052 }
1053
1054 void
1055 AudioRegion::suspend_fade_out ()
1056 {
1057         if (++_fade_out_disabled == 1) {
1058                 set_fade_out_active (false);
1059         }
1060 }
1061
1062 void
1063 AudioRegion::resume_fade_out ()
1064 {
1065         if (_fade_out_disabled && --_fade_out_disabled == 0) {
1066                 set_fade_out_active (true);
1067         }
1068 }
1069
1070 bool
1071 AudioRegion::speed_mismatch (float sr) const
1072 {
1073         if (_sources.empty()) {
1074                 /* impossible, but ... */
1075                 return false;
1076         }
1077
1078         float fsr = audio_source()->sample_rate();
1079
1080         return fsr != sr;
1081 }
1082
1083 void
1084 AudioRegion::source_offset_changed ()
1085 {
1086         if (boost::dynamic_pointer_cast<DestructiveFileSource>(_sources.front())) {
1087                 set_start (source()->natural_position(), this);
1088                 set_position (source()->natural_position(), this);
1089         }
1090 }
1091
1092 boost::shared_ptr<AudioSource>
1093 AudioRegion::audio_source (uint32_t n) const
1094 {
1095         // Guaranteed to succeed (use a static cast?)
1096         return boost::dynamic_pointer_cast<AudioSource>(source(n));
1097 }
1098
1099 extern "C" {
1100
1101         int region_read_peaks_from_c (void *arg, uint32_t npeaks, uint32_t start, uint32_t cnt, intptr_t data, uint32_t n_chan, double samples_per_unit)
1102 {
1103         return ((AudioRegion *) arg)->read_peaks ((PeakData *) data, (nframes_t) npeaks, (nframes_t) start, (nframes_t) cnt, n_chan,samples_per_unit);
1104 }
1105
1106 uint32_t region_length_from_c (void *arg)
1107 {
1108
1109         return ((AudioRegion *) arg)->length();
1110 }
1111
1112 uint32_t sourcefile_length_from_c (void *arg, double zoom_factor)
1113 {
1114         return ( (AudioRegion *) arg)->audio_source()->available_peaks (zoom_factor) ;
1115 }
1116
1117 } /* extern "C" */