libs/ardour/tempo.cc

   1 /*
   2     Copyright (C) 2000-2002 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 <algorithm>
  21 #include <stdexcept>
  22 #include <cmath>
  23
  24 #include <unistd.h>
  25
  26 #include <glibmm/threads.h>
  27
  28 #include "pbd/enumwriter.h"
  29 #include "pbd/xml++.h"
  30 #include "evoral/Beats.hpp"
  31
  32 #include "ardour/debug.h"
  33 #include "ardour/lmath.h"
  34 #include "ardour/tempo.h"
  35
  36 #include "i18n.h"
  37 #include <locale.h>
  38
  39 using namespace std;
  40 using namespace ARDOUR;
  41 using namespace PBD;
  42
  43 using Timecode::BBT_Time;
  44
  45 /* _default tempo is 4/4 qtr=120 */
  46
  47 Meter    TempoMap::_default_meter (4.0, 4.0);
  48 Tempo    TempoMap::_default_tempo (120.0);
  49
  50 /***********************************************************************/
  51
  52 double
  53 Meter::frames_per_grid (const Tempo& tempo, framecnt_t sr) const
  54 {
  55         /* This is tempo- and meter-sensitive. The number it returns
  56            is based on the interval between any two lines in the
  57            grid that is constructed from tempo and meter sections.
  58
  59            The return value IS NOT interpretable in terms of "beats".
  60         */
  61
  62         return (60.0 * sr) / (tempo.beats_per_minute() * (_note_type/tempo.note_type()));
  63 }
  64
  65 double
  66 Meter::frames_per_bar (const Tempo& tempo, framecnt_t sr) const
  67 {
  68         return frames_per_grid (tempo, sr) * _divisions_per_bar;
  69 }
  70
  71 /***********************************************************************/
  72
  73 const string TempoSection::xml_state_node_name = "Tempo";
  74
  75 TempoSection::TempoSection (const XMLNode& node)
  76         : MetricSection (0.0)
  77         , Tempo (TempoMap::default_tempo())
  78         , _c_func (0.0)
  79         , _active (true)
  80         , _locked_to_meter (false)
  81 {
  82         const XMLProperty *prop;
  83         LocaleGuard lg;
  84         BBT_Time bbt;
  85         double pulse;
  86         uint32_t frame;
  87
  88         _legacy_bbt = BBT_Time (0, 0, 0);
  89
  90         if ((prop = node.property ("start")) != 0) {
  91                 if (sscanf (prop->value().c_str(), "%" PRIu32 "|%" PRIu32 "|%" PRIu32,
  92                             &bbt.bars,
  93                             &bbt.beats,
  94                             &bbt.ticks) == 3) {
  95                         /* legacy session - start used to be in bbt*/
  96                         _legacy_bbt = bbt;
  97                         pulse = -1.0;
  98                         info << _("Legacy session detected. TempoSection XML node will be altered.") << endmsg;
  99                 }
 100         }
 101
 102         if ((prop = node.property ("pulse")) != 0) {
 103                 if (sscanf (prop->value().c_str(), "%lf", &pulse) != 1) {
 104                         error << _("TempoSection XML node has an illegal \"pulse\" value") << endmsg;
 105                 }
 106         }
 107
 108         set_pulse (pulse);
 109
 110         if ((prop = node.property ("frame")) != 0) {
 111                 if (sscanf (prop->value().c_str(), "%" PRIu32, &frame) != 1) {
 112                         error << _("TempoSection XML node has an illegal \"frame\" value") << endmsg;
 113                 } else {
 114                         set_frame (frame);
 115                 }
 116         }
 117
 118         if ((prop = node.property ("beats-per-minute")) == 0) {
 119                 error << _("TempoSection XML node has no \"beats-per-minute\" property") << endmsg;
 120                 throw failed_constructor();
 121         }
 122
 123         if (sscanf (prop->value().c_str(), "%lf", &_beats_per_minute) != 1 || _beats_per_minute < 0.0) {
 124                 error << _("TempoSection XML node has an illegal \"beats_per_minute\" value") << endmsg;
 125                 throw failed_constructor();
 126         }
 127
 128         if ((prop = node.property ("note-type")) == 0) {
 129                 /* older session, make note type be quarter by default */
 130                 _note_type = 4.0;
 131         } else {
 132                 if (sscanf (prop->value().c_str(), "%lf", &_note_type) != 1 || _note_type < 1.0) {
 133                         error << _("TempoSection XML node has an illegal \"note-type\" value") << endmsg;
 134                         throw failed_constructor();
 135                 }
 136         }
 137
 138         if ((prop = node.property ("movable")) == 0) {
 139                 error << _("TempoSection XML node has no \"movable\" property") << endmsg;
 140                 throw failed_constructor();
 141         }
 142
 143         set_movable (string_is_affirmative (prop->value()));
 144
 145         if ((prop = node.property ("active")) == 0) {
 146                 warning << _("TempoSection XML node has no \"active\" property") << endmsg;
 147                 set_active(true);
 148         } else {
 149                 set_active (string_is_affirmative (prop->value()));
 150         }
 151
 152         if ((prop = node.property ("tempo-type")) == 0) {
 153                 _type = Constant;
 154         } else {
 155                 _type = Type (string_2_enum (prop->value(), _type));
 156         }
 157
 158         if ((prop = node.property ("lock-style")) == 0) {
 159                 if (movable()) {
 160                         set_position_lock_style (MusicTime);
 161                 } else {
 162                         set_position_lock_style (AudioTime);
 163                 }
 164         } else {
 165                 set_position_lock_style (PositionLockStyle (string_2_enum (prop->value(), position_lock_style())));
 166         }
 167
 168         if ((prop = node.property ("locked-to-meter")) == 0) {
 169                 set_locked_to_meter (false);
 170         } else {
 171                 set_locked_to_meter (string_is_affirmative (prop->value()));
 172         }
 173 }
 174
 175 XMLNode&
 176 TempoSection::get_state() const
 177 {
 178         XMLNode *root = new XMLNode (xml_state_node_name);
 179         char buf[256];
 180         LocaleGuard lg;
 181
 182         snprintf (buf, sizeof (buf), "%f", pulse());
 183         root->add_property ("pulse", buf);
 184         snprintf (buf, sizeof (buf), "%li", frame());
 185         root->add_property ("frame", buf);
 186         snprintf (buf, sizeof (buf), "%f", _beats_per_minute);
 187         root->add_property ("beats-per-minute", buf);
 188         snprintf (buf, sizeof (buf), "%f", _note_type);
 189         root->add_property ("note-type", buf);
 190         snprintf (buf, sizeof (buf), "%s", movable()?"yes":"no");
 191         root->add_property ("movable", buf);
 192         snprintf (buf, sizeof (buf), "%s", active()?"yes":"no");
 193         root->add_property ("active", buf);
 194         root->add_property ("tempo-type", enum_2_string (_type));
 195         root->add_property ("lock-style", enum_2_string (position_lock_style()));
 196         root->add_property ("locked-to-meter", locked_to_meter()?"yes":"no");
 197
 198         return *root;
 199 }
 200
 201 void
 202 TempoSection::set_type (Type type)
 203 {
 204         _type = type;
 205 }
 206
 207 /** returns the tempo in whole pulses per minute at the zero-based (relative to session) frame.
 208 */
 209 double
 210 TempoSection::tempo_at_frame (const frameoffset_t& f, const framecnt_t& frame_rate) const
 211 {
 212
 213         if (_type == Constant || _c_func == 0.0) {
 214                 return pulses_per_minute();
 215         }
 216
 217         return pulse_tempo_at_time (frame_to_minute (f - (frameoffset_t) frame(), frame_rate));
 218 }
 219
 220 /** returns the zero-based frame (relative to session)
 221    where the tempo in whole pulses per minute occurs in this section.
 222    beat b is only used for constant tempos.
 223    note that the tempo map may have multiple such values.
 224 */
 225 frameoffset_t
 226 TempoSection::frame_at_tempo (const double& ppm, const double& b, const framecnt_t& frame_rate) const
 227 {
 228         if (_type == Constant || _c_func == 0.0) {
 229                 return ((b - pulse())  * frames_per_pulse (frame_rate))  + frame();
 230         }
 231
 232         return minute_to_frame (time_at_pulse_tempo (ppm), frame_rate) + frame();
 233 }
 234 /** returns the tempo in pulses per minute at the zero-based (relative to session) beat.
 235 */
 236 double
 237 TempoSection::tempo_at_pulse (const double& p) const
 238 {
 239
 240         if (_type == Constant || _c_func == 0.0) {
 241                 return pulses_per_minute();
 242         }
 243         double const ppm = pulse_tempo_at_pulse (p - pulse());
 244         return ppm;
 245 }
 246
 247 /** returns the zero-based beat (relative to session)
 248    where the tempo in whole pulses per minute occurs given frame f. frame f is only used for constant tempos.
 249    note that the session tempo map may have multiple beats at a given tempo.
 250 */
 251 double
 252 TempoSection::pulse_at_tempo (const double& ppm, const framepos_t& f, const framecnt_t& frame_rate) const
 253 {
 254         if (_type == Constant || _c_func == 0.0) {
 255                 double const pulses = ((f - frame()) / frames_per_pulse (frame_rate)) + pulse();
 256                 return  pulses;
 257         }
 258         return pulse_at_pulse_tempo (ppm) + pulse();
 259 }
 260
 261 /** returns the zero-based pulse (relative to session origin)
 262    where the zero-based frame (relative to session)
 263    lies.
 264 */
 265 double
 266 TempoSection::pulse_at_frame (const framepos_t& f, const framecnt_t& frame_rate) const
 267 {
 268         if (_type == Constant || _c_func == 0.0) {
 269                 return ((f - frame()) / frames_per_pulse (frame_rate)) + pulse();
 270         }
 271
 272         return pulse_at_time (frame_to_minute (f - frame(), frame_rate)) + pulse();
 273 }
 274
 275 /** returns the zero-based frame (relative to session start frame)
 276    where the zero-based pulse (relative to session start)
 277    falls.
 278 */
 279
 280 frameoffset_t
 281 TempoSection::frame_at_pulse (const double& p, const framecnt_t& frame_rate) const
 282 {
 283         if (_type == Constant || _c_func == 0.0) {
 284                 return (frameoffset_t) floor ((p - pulse()) * frames_per_pulse (frame_rate)) + frame();
 285         }
 286
 287         return minute_to_frame (time_at_pulse (p - pulse()), frame_rate) + frame();
 288 }
 289
 290 /*
 291 Ramp Overview
 292
 293       |                     *
 294 Tempo |                   *
 295 Tt----|-----------------*|
 296 Ta----|--------------|*  |
 297       |            * |   |
 298       |         *    |   |
 299       |     *        |   |
 300 T0----|*             |   |
 301   *   |              |   |
 302       _______________|___|____
 303       time           a   t (next tempo)
 304       [        c         ] defines c
 305
 306 Duration in beats at time a is the integral of some Tempo function.
 307 In our case, the Tempo function (Tempo at time t) is
 308 T(t) = T0(e^(ct))
 309
 310 with function constant
 311 c = log(Ta/T0)/a
 312 so
 313 a = log(Ta/T0)/c
 314
 315 The integral over t of our Tempo function (the beat function, which is the duration in beats at some time t) is:
 316 b(t) = T0(e^(ct) - 1) / c
 317
 318 To find the time t at beat duration b, we use the inverse function of the beat function (the time function) which can be shown to be:
 319 t(b) = log((c.b / T0) + 1) / c
 320
 321 The time t at which Tempo T occurs is a as above:
 322 t(T) = log(T / T0) / c
 323
 324 The beat at which a Tempo T occurs is:
 325 b(T) = (T - T0) / c
 326
 327 The Tempo at which beat b occurs is:
 328 T(b) = b.c + T0
 329
 330 We define c for this tempo ramp by placing a new tempo section at some time t after this one.
 331 Our problem is that we usually don't know t.
 332 We almost always know the duration in beats between this and the new section, so we need to find c in terms of the beat function.
 333 Where a = t (i.e. when a is equal to the time of the next tempo section), the beat function reveals:
 334 t = b log (Ta / T0) / (T0 (e^(log (Ta / T0)) - 1))
 335
 336 By substituting our expanded t as a in the c function above, our problem is reduced to:
 337 c = T0 (e^(log (Ta / T0)) - 1) / b
 338
 339 Of course the word 'beat' has been left loosely defined above.
 340 In music, a beat is defined by the musical pulse (which comes from the tempo)
 341 and the meter in use at a particular time (how many  pulse divisions there are in one bar).
 342 It would be more accurate to substitute the work 'pulse' for 'beat' above.
 343
 344 Anyway ...
 345
 346 We can now store c for future time calculations.
 347 If the following tempo section (the one that defines c in conjunction with this one)
 348 is changed or moved, c is no longer valid.
 349
 350 The public methods are session-relative.
 351
 352 Most of this stuff is taken from this paper:
 353
 354 WHERE’S THE BEAT?
 355 TOOLS FOR DYNAMIC TEMPO CALCULATIONS
 356 Jan C. Schacher
 357 Martin Neukom
 358 Zurich University of Arts
 359 Institute for Computer Music and Sound Technology
 360
 361 https://www.zhdk.ch/fileadmin/data_subsites/data_icst/Downloads/Timegrid/ICST_Tempopolyphony_ICMC07.pdf
 362
 363 */
 364
 365 /*
 366   compute this ramp's function constant using the end tempo (in whole pulses per minute)
 367   and duration (pulses into global start) of some later tempo section.
 368 */
 369 double
 370 TempoSection::compute_c_func_pulse (const double& end_bpm, const double& end_pulse, const framecnt_t& frame_rate)
 371 {
 372         double const log_tempo_ratio = log (end_bpm / pulses_per_minute());
 373         return pulses_per_minute() *  (expm1 (log_tempo_ratio)) / (end_pulse - pulse());
 374 }
 375
 376 /* compute the function constant from some later tempo section, given tempo (whole pulses/min.) and distance (in frames) from session origin */
 377 double
 378 TempoSection::compute_c_func_frame (const double& end_bpm, const framepos_t& end_frame, const framecnt_t& frame_rate) const
 379 {
 380         return c_func (end_bpm, frame_to_minute (end_frame - frame(), frame_rate));
 381 }
 382
 383 frameoffset_t
 384 TempoSection::minute_to_frame (const double& time, const framecnt_t& frame_rate) const
 385 {
 386         return (frameoffset_t) floor ((time * 60.0 * (frameoffset_t) frame_rate) + 0.5);
 387 }
 388
 389 double
 390 TempoSection::frame_to_minute (const frameoffset_t& frame, const framecnt_t& frame_rate) const
 391 {
 392         return (frame / (double) frame_rate) / 60.0;
 393 }
 394
 395 /* position function */
 396 double
 397 TempoSection::a_func (double end_ppm, double c_func) const
 398 {
 399         return log (end_ppm / pulses_per_minute()) /  c_func;
 400 }
 401
 402 /*function constant*/
 403 double
 404 TempoSection::c_func (double end_ppm, double end_time) const
 405 {
 406         return log (end_ppm / pulses_per_minute()) /  end_time;
 407 }
 408
 409 /* tempo in ppm at time in minutes */
 410 double
 411 TempoSection::pulse_tempo_at_time (const double& time) const
 412 {
 413         return exp (_c_func * time) * pulses_per_minute();
 414 }
 415
 416 /* time in minutes at tempo in ppm */
 417 double
 418 TempoSection::time_at_pulse_tempo (const double& pulse_tempo) const
 419 {
 420         return log (pulse_tempo / pulses_per_minute()) / _c_func;
 421 }
 422
 423 /* tick at tempo in ppm */
 424 double
 425 TempoSection::pulse_at_pulse_tempo (const double& pulse_tempo) const
 426 {
 427         return (pulse_tempo - pulses_per_minute()) / _c_func;
 428 }
 429
 430 /* tempo in ppm at tick */
 431 double
 432 TempoSection::pulse_tempo_at_pulse (const double& pulse) const
 433 {
 434         return (pulse * _c_func) + pulses_per_minute();
 435 }
 436
 437 /* pulse at time in minutes */
 438 double
 439 TempoSection::pulse_at_time (const double& time) const
 440 {
 441         return expm1 (_c_func * time) * (pulses_per_minute() / _c_func);
 442 }
 443
 444 /* time in minutes at pulse */
 445 double
 446 TempoSection::time_at_pulse (const double& pulse) const
 447 {
 448         return log1p ((_c_func * pulse) / pulses_per_minute()) / _c_func;
 449 }
 450
 451 /***********************************************************************/
 452
 453 const string MeterSection::xml_state_node_name = "Meter";
 454
 455 MeterSection::MeterSection (const XMLNode& node)
 456         : MetricSection (0.0), Meter (TempoMap::default_meter())
 457 {
 458         XMLProperty const * prop;
 459         BBT_Time start;
 460         LocaleGuard lg;
 461         const XMLProperty *prop;
 462         BBT_Time bbt;
 463         double pulse = 0.0;
 464         double beat = 0.0;
 465         framepos_t frame = 0;
 466         pair<double, BBT_Time> start;
 467
 468         if ((prop = node.property ("start")) != 0) {
 469                 if (sscanf (prop->value().c_str(), "%" PRIu32 "|%" PRIu32 "|%" PRIu32,
 470                     &bbt.bars,
 471                     &bbt.beats,
 472                     &bbt.ticks) < 3) {
 473                         error << _("MeterSection XML node has an illegal \"start\" value") << endmsg;
 474                 } else {
 475                         /* legacy session - start used to be in bbt*/
 476                         info << _("Legacy session detected - MeterSection XML node will be altered.") << endmsg;
 477                         pulse = -1.0;
 478                 }
 479         }
 480
 481         if ((prop = node.property ("pulse")) != 0) {
 482                 if (sscanf (prop->value().c_str(), "%lf", &pulse) != 1) {
 483                         error << _("MeterSection XML node has an illegal \"pulse\" value") << endmsg;
 484                 }
 485         }
 486         set_pulse (pulse);
 487
 488         if ((prop = node.property ("beat")) != 0) {
 489                 if (sscanf (prop->value().c_str(), "%lf", &beat) != 1) {
 490                         error << _("MeterSection XML node has an illegal \"beat\" value") << endmsg;
 491                 }
 492         }
 493
 494         start.first = beat;
 495
 496         if ((prop = node.property ("bbt")) == 0) {
 497                 warning << _("MeterSection XML node has no \"bbt\" property") << endmsg;
 498         } else if (sscanf (prop->value().c_str(), "%" PRIu32 "|%" PRIu32 "|%" PRIu32,
 499                     &bbt.bars,
 500                     &bbt.beats,
 501                     &bbt.ticks) < 3) {
 502                 error << _("MeterSection XML node has an illegal \"bbt\" value") << endmsg;
 503                 throw failed_constructor();
 504         }
 505
 506         start.second = bbt;
 507         set_beat (start);
 508
 509         if ((prop = node.property ("frame")) != 0) {
 510                 if (sscanf (prop->value().c_str(), "%li", &frame) != 1) {
 511                         error << _("MeterSection XML node has an illegal \"frame\" value") << endmsg;
 512                 } else {
 513                         set_frame (frame);
 514                 }
 515         }
 516
 517         /* beats-per-bar is old; divisions-per-bar is new */
 518
 519         if ((prop = node.property ("divisions-per-bar")) == 0) {
 520                 if ((prop = node.property ("beats-per-bar")) == 0) {
 521                         error << _("MeterSection XML node has no \"beats-per-bar\" or \"divisions-per-bar\" property") << endmsg;
 522                         throw failed_constructor();
 523                 }
 524         }
 525         if (sscanf (prop->value().c_str(), "%lf", &_divisions_per_bar) != 1 || _divisions_per_bar < 0.0) {
 526                 error << _("MeterSection XML node has an illegal \"divisions-per-bar\" value") << endmsg;
 527                 throw failed_constructor();
 528         }
 529
 530         if ((prop = node.property ("note-type")) == 0) {
 531                 error << _("MeterSection XML node has no \"note-type\" property") << endmsg;
 532                 throw failed_constructor();
 533         }
 534         if (sscanf (prop->value().c_str(), "%lf", &_note_type) != 1 || _note_type < 0.0) {
 535                 error << _("MeterSection XML node has an illegal \"note-type\" value") << endmsg;
 536                 throw failed_constructor();
 537         }
 538
 539         if ((prop = node.property ("movable")) == 0) {
 540                 error << _("MeterSection XML node has no \"movable\" property") << endmsg;
 541                 throw failed_constructor();
 542         }
 543
 544         set_movable (string_is_affirmative (prop->value()));
 545
 546         if ((prop = node.property ("lock-style")) == 0) {
 547                 warning << _("MeterSection XML node has no \"lock-style\" property") << endmsg;
 548                 if (movable()) {
 549                         set_position_lock_style (MusicTime);
 550                 } else {
 551                         set_position_lock_style (AudioTime);
 552                 }
 553         } else {
 554                 set_position_lock_style (PositionLockStyle (string_2_enum (prop->value(), position_lock_style())));
 555         }
 556 }
 557
 558 XMLNode&
 559 MeterSection::get_state() const
 560 {
 561         XMLNode *root = new XMLNode (xml_state_node_name);
 562         char buf[256];
 563         LocaleGuard lg;
 564
 565         snprintf (buf, sizeof (buf), "%lf", pulse());
 566         root->add_property ("pulse", buf);
 567         snprintf (buf, sizeof (buf), "%" PRIu32 "|%" PRIu32 "|%" PRIu32,
 568                   bbt().bars,
 569                   bbt().beats,
 570                   bbt().ticks);
 571         root->add_property ("bbt", buf);
 572         snprintf (buf, sizeof (buf), "%lf", beat());
 573         root->add_property ("beat", buf);
 574         snprintf (buf, sizeof (buf), "%f", _note_type);
 575         root->add_property ("note-type", buf);
 576         snprintf (buf, sizeof (buf), "%li", frame());
 577         root->add_property ("frame", buf);
 578         root->add_property ("lock-style", enum_2_string (position_lock_style()));
 579         snprintf (buf, sizeof (buf), "%f", _divisions_per_bar);
 580         root->add_property ("divisions-per-bar", buf);
 581         snprintf (buf, sizeof (buf), "%s", movable()?"yes":"no");
 582         root->add_property ("movable", buf);
 583
 584         return *root;
 585 }
 586
 587 /***********************************************************************/
 588 /*
 589   Tempo Map Overview
 590
 591   Tempo can be thought of as a source of the musical pulse.
 592   Meters divide that pulse into measures and beats.
 593   Tempo pulses can be divided to be in sympathy with the meter, but this does not affect the beat
 594   at any particular time.
 595   Note that Tempo::beats_per_minute() has nothing to do with musical beats.
 596   It should rather be thought of as tempo note divisions per minute.
 597
 598   TempoSections, which are nice to think of in whole pulses per minute,
 599   and MeterSecions which divide tempo pulses into measures (via divisions_per_bar)
 600   and beats (via note_divisor) are used to form a tempo map.
 601   TempoSections and MeterSections may be locked to either audio or music (position lock style).
 602   We construct the tempo map by first using the frame or pulse position (depending on position lock style) of each tempo.
 603   We then use this pulse/frame layout to find the beat & pulse or frame position of each meter (again depending on lock style).
 604
 605   Having done this, we can now find any one of tempo, beat, frame or pulse if a beat, frame, pulse or tempo is known.
 606
 607   The first tempo and first meter are special. they must move together, and must be locked to audio.
 608   Audio locked tempos which lie before the first meter are made inactive.
 609   They will be re-activated if the first meter is again placed before them.
 610
 611   Both tempos and meters have a pulse position and a frame position.
 612   Meters also have a beat position, which is always 0.0 for the first meter.
 613
 614   A tempo locked to music is locked to musical pulses.
 615   A meter locked to music is locked to beats.
 616
 617   Recomputing the tempo map is the process where the 'missing' position
 618   (tempo pulse or meter pulse & beat in the case of AudioTime, frame for MusicTime) is calculated.
 619
 620   It is important to keep the _metrics in an order that makes sense.
 621   Because ramped MusicTime and AudioTime tempos can interact with each other,
 622   reordering is frequent. Care must be taken to keep _metrics in a solved state.
 623   Solved means ordered by frame or pulse with frame-accurate precision (see check_solved()).
 624 */
 625 struct MetricSectionSorter {
 626     bool operator() (const MetricSection* a, const MetricSection* b) {
 627             return a->pulse() < b->pulse();
 628     }
 629 };
 630
 631 struct MetricSectionFrameSorter {
 632     bool operator() (const MetricSection* a, const MetricSection* b) {
 633             return a->frame() < b->frame();
 634     }
 635 };
 636
 637 TempoMap::TempoMap (framecnt_t fr)
 638 {
 639         _frame_rate = fr;
 640         BBT_Time start (1, 1, 0);
 641
 642         TempoSection *t = new TempoSection ((framepos_t) 0, _default_tempo.beats_per_minute(), _default_tempo.note_type(), TempoSection::Constant);
 643         MeterSection *m = new MeterSection ((framepos_t) 0, 0.0, start, _default_meter.divisions_per_bar(), _default_meter.note_divisor());
 644
 645         t->set_movable (false);
 646         m->set_movable (false);
 647
 648         /* note: frame time is correct (zero) for both of these */
 649
 650         _metrics.push_back (t);
 651         _metrics.push_back (m);
 652
 653 }
 654
 655 TempoMap::~TempoMap ()
 656 {
 657 }
 658
 659 void
 660 TempoMap::remove_tempo (const TempoSection& tempo, bool complete_operation)
 661 {
 662         bool removed = false;
 663
 664         {
 665                 Glib::Threads::RWLock::WriterLock lm (lock);
 666                 if ((removed = remove_tempo_locked (tempo))) {
 667                         if (complete_operation) {
 668                                 recompute_map (_metrics);
 669                         }
 670                 }
 671         }
 672
 673         if (removed && complete_operation) {
 674                 PropertyChanged (PropertyChange ());
 675         }
 676 }
 677
 678 bool
 679 TempoMap::remove_tempo_locked (const TempoSection& tempo)
 680 {
 681         Metrics::iterator i;
 682
 683         for (i = _metrics.begin(); i != _metrics.end(); ++i) {
 684                 if (dynamic_cast<TempoSection*> (*i) != 0) {
 685                         if (tempo.frame() == (*i)->frame()) {
 686                                 if ((*i)->movable()) {
 687                                         delete (*i);
 688                                         _metrics.erase (i);
 689                                         return true;
 690                                 }
 691                         }
 692                 }
 693         }
 694
 695         return false;
 696 }
 697
 698 void
 699 TempoMap::remove_meter (const MeterSection& tempo, bool complete_operation)
 700 {
 701         bool removed = false;
 702
 703         {
 704                 Glib::Threads::RWLock::WriterLock lm (lock);
 705                 if ((removed = remove_meter_locked (tempo))) {
 706                         if (complete_operation) {
 707                                 recompute_map (_metrics);
 708                         }
 709                 }
 710         }
 711
 712         if (removed && complete_operation) {
 713                 PropertyChanged (PropertyChange ());
 714         }
 715 }
 716
 717 bool
 718 TempoMap::remove_meter_locked (const MeterSection& meter)
 719 {
 720         Metrics::iterator i;
 721
 722         for (i = _metrics.begin(); i != _metrics.end(); ++i) {
 723                 TempoSection* t = 0;
 724                 if ((t = dynamic_cast<TempoSection*> (*i)) != 0) {
 725                         if (meter.frame() == (*i)->frame()) {
 726                                 if (t->locked_to_meter()) {
 727                                         delete (*i);
 728                                         _metrics.erase (i);
 729                                         break;
 730                                 }
 731                         }
 732                 }
 733         }
 734
 735         for (i = _metrics.begin(); i != _metrics.end(); ++i) {
 736                 if (dynamic_cast<MeterSection*> (*i) != 0) {
 737                         if (meter.frame() == (*i)->frame()) {
 738                                 if ((*i)->movable()) {
 739                                         delete (*i);
 740                                         _metrics.erase (i);
 741                                         return true;
 742                                 }
 743                         }
 744                 }
 745         }
 746
 747         return false;
 748 }
 749
 750 void
 751 TempoMap::do_insert (MetricSection* section)
 752 {
 753         bool need_add = true;
 754         /* we only allow new meters to be inserted on beat 1 of an existing
 755          * measure.
 756          */
 757         MeterSection* m = 0;
 758         if ((m = dynamic_cast<MeterSection*>(section)) != 0) {
 759                 //assert (m->bbt().ticks == 0);
 760
 761                 if ((m->bbt().beats != 1) || (m->bbt().ticks != 0)) {
 762
 763                         pair<double, BBT_Time> corrected = make_pair (m->pulse(), m->bbt());
 764                         corrected.second.beats = 1;
 765                         corrected.second.ticks = 0;
 766                         corrected.first = bbt_to_beats_locked (_metrics, corrected.second);
 767                         warning << string_compose (_("Meter changes can only be positioned on the first beat of a bar. Moving from %1 to %2"),
 768                                                    m->bbt(), corrected.second) << endmsg;
 769                         //m->set_pulse (corrected);
 770                 }
 771         }
 772
 773         /* Look for any existing MetricSection that is of the same type and
 774            in the same bar as the new one, and remove it before adding
 775            the new one. Note that this means that if we find a matching,
 776            existing section, we can break out of the loop since we're
 777            guaranteed that there is only one such match.
 778         */
 779
 780         for (Metrics::iterator i = _metrics.begin(); i != _metrics.end(); ++i) {
 781
 782                 TempoSection* const tempo = dynamic_cast<TempoSection*> (*i);
 783                 TempoSection* const insert_tempo = dynamic_cast<TempoSection*> (section);
 784                 MeterSection* const meter = dynamic_cast<MeterSection*> (*i);
 785                 MeterSection* const insert_meter = dynamic_cast<MeterSection*> (section);
 786
 787                 if (tempo && insert_tempo) {
 788
 789                         /* Tempo sections */
 790                         bool const ipm = insert_tempo->position_lock_style() == MusicTime;
 791                         if ((ipm && tempo->pulse() == insert_tempo->pulse()) || (!ipm && tempo->frame() == insert_tempo->frame())) {
 792
 793                                 if (!tempo->movable()) {
 794
 795                                         /* can't (re)move this section, so overwrite
 796                                          * its data content (but not its properties as
 797                                          * a section).
 798                                          */
 799
 800                                         *(dynamic_cast<Tempo*>(*i)) = *(dynamic_cast<Tempo*>(insert_tempo));
 801                                         (*i)->set_position_lock_style (AudioTime);
 802                                         TempoSection* t;
 803                                         if ((t = dynamic_cast<TempoSection*>(*i)) != 0) {
 804                                                 t->set_type (insert_tempo->type());
 805                                         }
 806                                         need_add = false;
 807                                 } else {
 808                                         delete (*i);
 809                                         _metrics.erase (i);
 810                                 }
 811                                 break;
 812                         }
 813
 814                 } else if (meter && insert_meter) {
 815
 816                         /* Meter Sections */
 817
 818                         bool const ipm = insert_meter->position_lock_style() == MusicTime;
 819
 820                         if ((ipm && meter->beat() == insert_meter->beat()) || (!ipm && meter->frame() == insert_meter->frame())) {
 821
 822                                 if (!meter->movable()) {
 823
 824                                         /* can't (re)move this section, so overwrite
 825                                          * its data content (but not its properties as
 826                                          * a section
 827                                          */
 828
 829                                         *(dynamic_cast<Meter*>(*i)) = *(dynamic_cast<Meter*>(insert_meter));
 830                                         (*i)->set_position_lock_style (AudioTime);
 831                                         need_add = false;
 832                                 } else {
 833                                         delete (*i);
 834                                         _metrics.erase (i);
 835                                 }
 836
 837                                 break;
 838                         }
 839                 } else {
 840                         /* non-matching types, so we don't care */
 841                 }
 842         }
 843
 844         /* Add the given MetricSection, if we didn't just reset an existing
 845          * one above
 846          */
 847
 848         if (need_add) {
 849                 MeterSection* const insert_meter = dynamic_cast<MeterSection*> (section);
 850                 TempoSection* const insert_tempo = dynamic_cast<TempoSection*> (section);
 851                 Metrics::iterator i;
 852                 if (insert_meter) {
 853                         for (i = _metrics.begin(); i != _metrics.end(); ++i) {
 854                                 MeterSection* const meter = dynamic_cast<MeterSection*> (*i);
 855
 856                                 if (meter) {
 857                                         bool const ipm = insert_meter->position_lock_style() == MusicTime;
 858                                         if ((ipm && meter->beat() > insert_meter->beat()) || (!ipm && meter->frame() > insert_meter->frame())) {
 859                                                 break;
 860                                         }
 861                                 }
 862                         }
 863                 } else if (insert_tempo) {
 864                         for (i = _metrics.begin(); i != _metrics.end(); ++i) {
 865                                 TempoSection* const tempo = dynamic_cast<TempoSection*> (*i);
 866
 867                                 if (tempo) {
 868                                         bool const ipm = insert_tempo->position_lock_style() == MusicTime;
 869                                         if ((ipm && tempo->pulse() > insert_tempo->pulse()) || (!ipm && tempo->frame() > insert_tempo->frame())) {
 870                                                 break;
 871                                         }
 872                                 }
 873                         }
 874                 }
 875
 876                 _metrics.insert (i, section);
 877                 //dump (_metrics, std::cerr);
 878         }
 879 }
 880
 881 void
 882 TempoMap::replace_tempo (const TempoSection& ts, const Tempo& tempo, const double& pulse, TempoSection::Type type)
 883 {
 884         {
 885                 Glib::Threads::RWLock::WriterLock lm (lock);
 886                 TempoSection& first (first_tempo());
 887                 if (ts.pulse() != first.pulse()) {
 888                         remove_tempo_locked (ts);
 889                         add_tempo_locked (tempo, pulse, true, type);
 890                 } else {
 891                         first.set_type (type);
 892                         {
 893                                 /* cannot move the first tempo section */
 894                                 *static_cast<Tempo*>(&first) = tempo;
 895                                 recompute_map (_metrics);
 896                         }
 897                 }
 898         }
 899
 900         PropertyChanged (PropertyChange ());
 901 }
 902
 903 void
 904 TempoMap::replace_tempo (const TempoSection& ts, const Tempo& tempo, const framepos_t& frame, TempoSection::Type type)
 905 {
 906         {
 907                 Glib::Threads::RWLock::WriterLock lm (lock);
 908                 TempoSection& first (first_tempo());
 909                 if (ts.frame() != first.frame()) {
 910                         remove_tempo_locked (ts);
 911                         add_tempo_locked (tempo, frame, true, type);
 912                 } else {
 913                         first.set_type (type);
 914                         first.set_pulse (0.0);
 915                         first.set_position_lock_style (AudioTime);
 916                         {
 917                                 /* cannot move the first tempo section */
 918                                 *static_cast<Tempo*>(&first) = tempo;
 919                                 recompute_map (_metrics);
 920                         }
 921                 }
 922         }
 923
 924         PropertyChanged (PropertyChange ());
 925 }
 926
 927 TempoSection*
 928 TempoMap::add_tempo (const Tempo& tempo, const double& pulse, ARDOUR::TempoSection::Type type)
 929 {
 930         TempoSection* ts = 0;
 931         {
 932                 Glib::Threads::RWLock::WriterLock lm (lock);
 933                 ts = add_tempo_locked (tempo, pulse, true, type);
 934         }
 935
 936         PropertyChanged (PropertyChange ());
 937
 938         return ts;
 939 }
 940
 941 TempoSection*
 942 TempoMap::add_tempo (const Tempo& tempo, const framepos_t& frame, ARDOUR::TempoSection::Type type)
 943 {
 944         TempoSection* ts = 0;
 945         {
 946                 Glib::Threads::RWLock::WriterLock lm (lock);
 947                 ts = add_tempo_locked (tempo, frame, true, type);
 948         }
 949
 950
 951         PropertyChanged (PropertyChange ());
 952
 953         return ts;
 954 }
 955
 956 TempoSection*
 957 TempoMap::add_tempo_locked (const Tempo& tempo, double pulse, bool recompute, ARDOUR::TempoSection::Type type)
 958 {
 959         TempoSection* t = new TempoSection (pulse, tempo.beats_per_minute(), tempo.note_type(), type);
 960
 961         do_insert (t);
 962
 963         if (recompute) {
 964                 solve_map (_metrics, t, t->pulse());
 965                 recompute_meters (_metrics);
 966         }
 967
 968         return t;
 969 }
 970
 971 TempoSection*
 972 TempoMap::add_tempo_locked (const Tempo& tempo, framepos_t frame, bool recompute, ARDOUR::TempoSection::Type type)
 973 {
 974         TempoSection* t = new TempoSection (frame, tempo.beats_per_minute(), tempo.note_type(), type);
 975
 976         do_insert (t);
 977
 978         if (recompute) {
 979                 solve_map (_metrics, t, t->frame());
 980                 recompute_meters (_metrics);
 981         }
 982
 983         return t;
 984 }
 985
 986 void
 987 TempoMap::replace_meter (const MeterSection& ms, const Meter& meter, const BBT_Time& where)
 988 {
 989         {
 990                 Glib::Threads::RWLock::WriterLock lm (lock);
 991
 992                 if (ms.movable()) {
 993                         remove_meter_locked (ms);
 994                         add_meter_locked (meter, bbt_to_beats_locked (_metrics, where), where, true);
 995                 } else {
 996                         MeterSection& first (first_meter());
 997                         /* cannot move the first meter section */
 998                         *static_cast<Meter*>(&first) = meter;
 999                         first.set_position_lock_style (AudioTime);
1000                 }
1001                 recompute_map (_metrics);
1002         }
1003
1004         PropertyChanged (PropertyChange ());
1005 }
1006
1007 void
1008 TempoMap::replace_meter (const MeterSection& ms, const Meter& meter, const framepos_t& frame)
1009 {
1010         {
1011                 Glib::Threads::RWLock::WriterLock lm (lock);
1012
1013                 const double beat = ms.beat();
1014                 const BBT_Time bbt = ms.bbt();
1015
1016                 if (ms.movable()) {
1017                         remove_meter_locked (ms);
1018                         add_meter_locked (meter, frame, beat, bbt, true);
1019                 } else {
1020                         MeterSection& first (first_meter());
1021                         TempoSection& first_t (first_tempo());
1022                         /* cannot move the first meter section */
1023                         *static_cast<Meter*>(&first) = meter;
1024                         first.set_position_lock_style (AudioTime);
1025                         first.set_pulse (0.0);
1026                         first.set_frame (frame);
1027                         pair<double, BBT_Time> beat = make_pair (0.0, BBT_Time (1, 1, 0));
1028                         first.set_beat (beat);
1029                         first_t.set_frame (first.frame());
1030                         first_t.set_pulse (0.0);
1031                         first_t.set_position_lock_style (AudioTime);
1032                 }
1033                 recompute_map (_metrics);
1034         }
1035         PropertyChanged (PropertyChange ());
1036 }
1037
1038
1039 MeterSection*
1040 TempoMap::add_meter (const Meter& meter, const double& beat, const BBT_Time& where)
1041 {
1042         MeterSection* m = 0;
1043         {
1044                 Glib::Threads::RWLock::WriterLock lm (lock);
1045                 m = add_meter_locked (meter, beat, where, true);
1046         }
1047
1048
1049 #ifndef NDEBUG
1050         if (DEBUG_ENABLED(DEBUG::TempoMap)) {
1051                 dump (_metrics, std::cerr);
1052         }
1053 #endif
1054
1055         PropertyChanged (PropertyChange ());
1056
1057         return m;
1058 }
1059
1060 MeterSection*
1061 TempoMap::add_meter (const Meter& meter, const framepos_t& frame, const double& beat, const Timecode::BBT_Time& where)
1062 {
1063         MeterSection* m = 0;
1064         {
1065                 Glib::Threads::RWLock::WriterLock lm (lock);
1066                 m = add_meter_locked (meter, frame, beat, where, true);
1067         }
1068
1069
1070 #ifndef NDEBUG
1071         if (DEBUG_ENABLED(DEBUG::TempoMap)) {
1072                 dump (_metrics, std::cerr);
1073         }
1074 #endif
1075
1076         PropertyChanged (PropertyChange ());
1077
1078         return m;
1079 }
1080
1081 MeterSection*
1082 TempoMap::add_meter_locked (const Meter& meter, double beat, BBT_Time where, bool recompute)
1083 {
1084         /* a new meter always starts a new bar on the first beat. so
1085            round the start time appropriately. remember that
1086            `where' is based on the existing tempo map, not
1087            the result after we insert the new meter.
1088
1089         */
1090
1091         if (where.beats != 1) {
1092                 where.beats = 1;
1093                 where.bars++;
1094         }
1095         /* new meters *always* start on a beat. */
1096         where.ticks = 0;
1097         const double pulse = pulse_at_beat_locked (_metrics, beat);
1098         MeterSection* new_meter = new MeterSection (pulse, beat, where, meter.divisions_per_bar(), meter.note_divisor());
1099         do_insert (new_meter);
1100
1101         if (recompute) {
1102                 solve_map (_metrics, new_meter, pulse);
1103         }
1104
1105         return new_meter;
1106 }
1107
1108 MeterSection*
1109 TempoMap::add_meter_locked (const Meter& meter, framepos_t frame, double beat, Timecode::BBT_Time where, bool recompute)
1110 {
1111         MeterSection* new_meter = new MeterSection (frame, beat, where, meter.divisions_per_bar(), meter.note_divisor());
1112         TempoSection* t = 0;
1113         double pulse = pulse_at_frame_locked (_metrics, frame);
1114         new_meter->set_pulse (pulse);
1115
1116         do_insert (new_meter);
1117
1118         /* add meter-locked tempo */
1119         t = add_tempo_locked (tempo_at_locked (_metrics, frame), frame, true, TempoSection::Ramp);
1120         t->set_locked_to_meter (true);
1121
1122         if (recompute) {
1123                 solve_map (_metrics, new_meter, frame);
1124         }
1125
1126         return new_meter;
1127 }
1128
1129 void
1130 TempoMap::change_initial_tempo (double beats_per_minute, double note_type)
1131 {
1132         Tempo newtempo (beats_per_minute, note_type);
1133         TempoSection* t;
1134
1135         for (Metrics::iterator i = _metrics.begin(); i != _metrics.end(); ++i) {
1136                 if ((t = dynamic_cast<TempoSection*> (*i)) != 0) {
1137                         if (!t->active()) {
1138                                 continue;
1139                         }
1140                         {
1141                                 Glib::Threads::RWLock::WriterLock lm (lock);
1142                                 *((Tempo*) t) = newtempo;
1143                                 recompute_map (_metrics);
1144                         }
1145                         PropertyChanged (PropertyChange ());
1146                         break;
1147                 }
1148         }
1149 }
1150
1151 void
1152 TempoMap::change_existing_tempo_at (framepos_t where, double beats_per_minute, double note_type)
1153 {
1154         Tempo newtempo (beats_per_minute, note_type);
1155
1156         TempoSection* prev;
1157         TempoSection* first;
1158         Metrics::iterator i;
1159
1160         /* find the TempoSection immediately preceding "where"
1161          */
1162
1163         for (first = 0, i = _metrics.begin(), prev = 0; i != _metrics.end(); ++i) {
1164
1165                 if ((*i)->frame() > where) {
1166                         break;
1167                 }
1168
1169                 TempoSection* t;
1170
1171                 if ((t = dynamic_cast<TempoSection*>(*i)) != 0) {
1172                         if (!t->active()) {
1173                                 continue;
1174                         }
1175                         if (!first) {
1176                                 first = t;
1177                         }
1178                         prev = t;
1179                 }
1180         }
1181
1182         if (!prev) {
1183                 if (!first) {
1184                         error << string_compose (_("no tempo sections defined in tempo map - cannot change tempo @ %1"), where) << endmsg;
1185                         return;
1186                 }
1187
1188                 prev = first;
1189         }
1190
1191         /* reset */
1192
1193         {
1194                 Glib::Threads::RWLock::WriterLock lm (lock);
1195                 /* cannot move the first tempo section */
1196                 *((Tempo*)prev) = newtempo;
1197                 recompute_map (_metrics);
1198         }
1199
1200         PropertyChanged (PropertyChange ());
1201 }
1202
1203 const MeterSection&
1204 TempoMap::first_meter () const
1205 {
1206         const MeterSection *m = 0;
1207
1208         for (Metrics::const_iterator i = _metrics.begin(); i != _metrics.end(); ++i) {
1209                 if ((m = dynamic_cast<const MeterSection *> (*i)) != 0) {
1210                         return *m;
1211                 }
1212         }
1213
1214         fatal << _("programming error: no meter section in tempo map!") << endmsg;
1215         abort(); /*NOTREACHED*/
1216         return *m;
1217 }
1218
1219 MeterSection&
1220 TempoMap::first_meter ()
1221 {
1222         MeterSection *m = 0;
1223
1224         /* CALLER MUST HOLD LOCK */
1225
1226         for (Metrics::iterator i = _metrics.begin(); i != _metrics.end(); ++i) {
1227                 if ((m = dynamic_cast<MeterSection *> (*i)) != 0) {
1228                         return *m;
1229                 }
1230         }
1231
1232         fatal << _("programming error: no tempo section in tempo map!") << endmsg;
1233         abort(); /*NOTREACHED*/
1234         return *m;
1235 }
1236
1237 const TempoSection&
1238 TempoMap::first_tempo () const
1239 {
1240         const TempoSection *t = 0;
1241
1242         /* CALLER MUST HOLD LOCK */
1243
1244         for (Metrics::const_iterator i = _metrics.begin(); i != _metrics.end(); ++i) {
1245                 if ((t = dynamic_cast<const TempoSection *> (*i)) != 0) {
1246                         if (!t->active()) {
1247                                 continue;
1248                         }
1249                         if (!t->movable()) {
1250                                 return *t;
1251                         }
1252                 }
1253         }
1254
1255         fatal << _("programming error: no tempo section in tempo map!") << endmsg;
1256         abort(); /*NOTREACHED*/
1257         return *t;
1258 }
1259
1260 TempoSection&
1261 TempoMap::first_tempo ()
1262 {
1263         TempoSection *t = 0;
1264
1265         for (Metrics::const_iterator i = _metrics.begin(); i != _metrics.end(); ++i) {
1266                 if ((t = dynamic_cast<TempoSection *> (*i)) != 0) {
1267                         if (!t->active()) {
1268                                 continue;
1269                         }
1270                         if (!t->movable()) {
1271                                 return *t;
1272                         }
1273                 }
1274         }
1275
1276         fatal << _("programming error: no tempo section in tempo map!") << endmsg;
1277         abort(); /*NOTREACHED*/
1278         return *t;
1279 }
1280 void
1281 TempoMap::recompute_tempos (Metrics& metrics)
1282 {
1283         TempoSection* prev_t = 0;
1284
1285         for (Metrics::const_iterator i = metrics.begin(); i != metrics.end(); ++i) {
1286                 TempoSection* t;
1287
1288                 if ((t = dynamic_cast<TempoSection*> (*i)) != 0) {
1289                         if (!t->active()) {
1290                                 continue;
1291                         }
1292                         if (!t->movable()) {
1293                                 if (!prev_t) {
1294                                         t->set_pulse (0.0);
1295                                         prev_t = t;
1296                                         continue;
1297                                 }
1298                         }
1299                         if (prev_t) {
1300                                 if (t->position_lock_style() == AudioTime) {
1301                                         prev_t->set_c_func (prev_t->compute_c_func_frame (t->pulses_per_minute(), t->frame(), _frame_rate));
1302                                         if (!t->locked_to_meter()) {
1303                                                 t->set_pulse (prev_t->pulse_at_tempo (t->pulses_per_minute(), t->frame(), _frame_rate));
1304                                         }
1305
1306                                 } else {
1307                                         prev_t->set_c_func (prev_t->compute_c_func_pulse (t->pulses_per_minute(), t->pulse(), _frame_rate));
1308                                         t->set_frame (prev_t->frame_at_tempo (t->pulses_per_minute(), t->pulse(), _frame_rate));
1309
1310                                 }
1311                         }
1312                         prev_t = t;
1313                 }
1314         }
1315         prev_t->set_c_func (0.0);
1316 }
1317
1318 /* tempos must be positioned correctly */
1319 void
1320 TempoMap::recompute_meters (Metrics& metrics)
1321 {
1322         MeterSection* meter = 0;
1323         MeterSection* prev_m = 0;
1324
1325         for (Metrics::const_iterator mi = metrics.begin(); mi != metrics.end(); ++mi) {
1326                 if ((meter = dynamic_cast<MeterSection*> (*mi)) != 0) {
1327                         if (meter->position_lock_style() == AudioTime) {
1328                                 double pulse = 0.0;
1329                                 pair<double, BBT_Time> b_bbt;
1330                                 if (meter->movable()) {
1331                                         b_bbt = make_pair (meter->beat(), meter->bbt());
1332                                         pulse = pulse_at_frame_locked (metrics, meter->frame());
1333                                 } else {
1334                                         b_bbt = make_pair (0.0, BBT_Time (1, 1, 0));
1335                                 }
1336                                 meter->set_beat (b_bbt);
1337                                 meter->set_pulse (pulse);
1338                         } else {
1339                                 double pulse = 0.0;
1340                                 pair<double, BBT_Time> new_beat;
1341                                 if (prev_m) {
1342                                         pulse = prev_m->pulse() + ((meter->bbt().bars - prev_m->bbt().bars) *  prev_m->divisions_per_bar() / prev_m->note_divisor());
1343                                         //new_beat = make_pair (((pulse - prev_m->pulse()) * prev_m->note_divisor()) + prev_m->beat(), meter->bbt());
1344                                 } else {
1345                                         /* shouldn't happen - the first is audio-locked */
1346                                         pulse = pulse_at_beat_locked (metrics, meter->beat());
1347                                         new_beat = make_pair (meter->beat(), meter->bbt());
1348                                 }
1349
1350                                 //meter->set_beat (new_beat);
1351                                 meter->set_frame (frame_at_pulse_locked (metrics, pulse));
1352                                 meter->set_pulse (pulse);
1353                         }
1354
1355                         prev_m = meter;
1356                 }
1357         }
1358         //dump (_metrics, std::cerr;
1359 }
1360
1361 void
1362 TempoMap::recompute_map (Metrics& metrics, framepos_t end)
1363 {
1364         /* CALLER MUST HOLD WRITE LOCK */
1365
1366         if (end < 0) {
1367
1368                 /* we will actually stop once we hit
1369                    the last metric.
1370                 */
1371                 end = max_framepos;
1372
1373         }
1374
1375         DEBUG_TRACE (DEBUG::TempoMath, string_compose ("recomputing tempo map, zero to %1\n", end));
1376
1377         if (end == 0) {
1378                 /* silly call from Session::process() during startup
1379                  */
1380                 return;
1381         }
1382
1383         recompute_tempos (metrics);
1384         recompute_meters (metrics);
1385 }
1386
1387 TempoMetric
1388 TempoMap::metric_at (framepos_t frame, Metrics::const_iterator* last) const
1389 {
1390         Glib::Threads::RWLock::ReaderLock lm (lock);
1391         TempoMetric m (first_meter(), first_tempo());
1392
1393         /* at this point, we are *guaranteed* to have m.meter and m.tempo pointing
1394            at something, because we insert the default tempo and meter during
1395            TempoMap construction.
1396
1397            now see if we can find better candidates.
1398         */
1399
1400         for (Metrics::const_iterator i = _metrics.begin(); i != _metrics.end(); ++i) {
1401
1402                 if ((*i)->frame() > frame) {
1403                         break;
1404                 }
1405
1406                 m.set_metric(*i);
1407
1408                 if (last) {
1409                         *last = i;
1410                 }
1411         }
1412
1413         return m;
1414 }
1415
1416 /* XX meters only */
1417 TempoMetric
1418 TempoMap::metric_at (BBT_Time bbt) const
1419 {
1420         Glib::Threads::RWLock::ReaderLock lm (lock);
1421         TempoMetric m (first_meter(), first_tempo());
1422
1423         /* at this point, we are *guaranteed* to have m.meter and m.tempo pointing
1424            at something, because we insert the default tempo and meter during
1425            TempoMap construction.
1426
1427            now see if we can find better candidates.
1428         */
1429
1430         for (Metrics::const_iterator i = _metrics.begin(); i != _metrics.end(); ++i) {
1431                 MeterSection* mw;
1432                 if ((mw = dynamic_cast<MeterSection*> (*i)) != 0) {
1433                         BBT_Time section_start (mw->bbt());
1434
1435                         if (section_start.bars > bbt.bars || (section_start.bars == bbt.bars && section_start.beats > bbt.beats)) {
1436                                 break;
1437                         }
1438
1439                         m.set_metric (*i);
1440                 }
1441         }
1442
1443         return m;
1444 }
1445
1446 double
1447 TempoMap::pulse_at_beat_locked (const Metrics& metrics, const double& beat) const
1448 {
1449         MeterSection* prev_m = 0;
1450
1451         for (Metrics::const_iterator i = metrics.begin(); i != metrics.end(); ++i) {
1452                 MeterSection* m;
1453                 if ((m = dynamic_cast<MeterSection*> (*i)) != 0) {
1454                         if (prev_m && m->beat() > beat) {
1455                                 break;
1456                         }
1457                         prev_m = m;
1458                 }
1459
1460         }
1461         double const ret = prev_m->pulse() + ((beat - prev_m->beat()) / prev_m->note_divisor());
1462         return ret;
1463 }
1464
1465 double
1466 TempoMap::pulse_at_beat (const double& beat) const
1467 {
1468         Glib::Threads::RWLock::ReaderLock lm (lock);
1469         return pulse_at_beat_locked (_metrics, beat);
1470 }
1471
1472 double
1473 TempoMap::beat_at_pulse_locked (const Metrics& metrics, const double& pulse) const
1474 {
1475         MeterSection* prev_m = 0;
1476
1477         for (Metrics::const_iterator i = metrics.begin(); i != metrics.end(); ++i) {
1478                 MeterSection* m;
1479                 if ((m = dynamic_cast<MeterSection*> (*i)) != 0) {
1480                         if (prev_m && m->pulse() > pulse) {
1481                                 if (((pulse - prev_m->pulse()) * prev_m->note_divisor()) + prev_m->beat() > m->beat()) {
1482                                         break;
1483                                 }
1484                         }
1485                         prev_m = m;
1486                 }
1487         }
1488
1489         double const ret = ((pulse - prev_m->pulse()) * prev_m->note_divisor()) + prev_m->beat();
1490         return ret;
1491 }
1492
1493 double
1494 TempoMap::beat_at_pulse (const double& pulse) const
1495 {
1496         Glib::Threads::RWLock::ReaderLock lm (lock);
1497         return beat_at_pulse_locked (_metrics, pulse);
1498 }
1499
1500 /* tempo section based */
1501 double
1502 TempoMap::pulse_at_frame_locked (const Metrics& metrics, const framecnt_t& frame) const
1503 {
1504         /* HOLD (at least) THE READER LOCK */
1505         TempoSection* prev_t = 0;
1506
1507         for (Metrics::const_iterator i = metrics.begin(); i != metrics.end(); ++i) {
1508                 TempoSection* t;
1509                 if ((t = dynamic_cast<TempoSection*> (*i)) != 0) {
1510                         if (!t->active()) {
1511                                 continue;
1512                         }
1513                         if (prev_t && t->frame() > frame) {
1514                                 /*the previous ts is the one containing the frame */
1515                                 const double ret = prev_t->pulse_at_frame (frame, _frame_rate);
1516                                 return ret;
1517                         }
1518                         prev_t = t;
1519                 }
1520         }
1521
1522         /* treated as constant for this ts */
1523         const double pulses_in_section = (frame - prev_t->frame()) / prev_t->frames_per_pulse (_frame_rate);
1524
1525         return pulses_in_section + prev_t->pulse();
1526 }
1527
1528 double
1529 TempoMap::pulse_at_frame (const framecnt_t& frame) const
1530 {
1531         Glib::Threads::RWLock::ReaderLock lm (lock);
1532         return pulse_at_frame_locked (_metrics, frame);
1533 }
1534
1535 /* tempo section based */
1536 framecnt_t
1537 TempoMap::frame_at_pulse_locked (const Metrics& metrics, const double& pulse) const
1538 {
1539         /* HOLD THE READER LOCK */
1540
1541         const TempoSection* prev_t = 0;
1542
1543         for (Metrics::const_iterator i = metrics.begin(); i != metrics.end(); ++i) {
1544                 TempoSection* t;
1545
1546                 if ((t = dynamic_cast<TempoSection*> (*i)) != 0) {
1547                         if (!t->active()) {
1548                                 continue;
1549                         }
1550                         if (prev_t && t->pulse() > pulse) {
1551                                 return prev_t->frame_at_pulse (pulse, _frame_rate);
1552                         }
1553
1554                         prev_t = t;
1555                 }
1556         }
1557         /* must be treated as constant, irrespective of _type */
1558         double const pulses_in_section = pulse - prev_t->pulse();
1559         double const dtime = pulses_in_section * prev_t->frames_per_pulse (_frame_rate);
1560
1561         framecnt_t const ret = (framecnt_t) floor (dtime) + prev_t->frame();
1562
1563         return ret;
1564 }
1565
1566 framecnt_t
1567 TempoMap::frame_at_pulse (const double& pulse) const
1568 {
1569         Glib::Threads::RWLock::ReaderLock lm (lock);
1570         return frame_at_pulse_locked (_metrics, pulse);
1571 }
1572
1573 /* meter section based */
1574 double
1575 TempoMap::beat_at_frame_locked (const Metrics& metrics, const framecnt_t& frame) const
1576 {
1577         const TempoSection& ts = tempo_section_at_locked (metrics, frame);
1578         MeterSection* prev_m = 0;
1579         MeterSection* next_m = 0;
1580
1581         for (Metrics::const_iterator i = metrics.begin(); i != metrics.end(); ++i) {
1582                 MeterSection* m;
1583                 if ((m = dynamic_cast<MeterSection*> (*i)) != 0) {
1584                         if (prev_m && m->frame() > frame) {
1585                                 next_m = m;
1586                                 break;
1587                         }
1588                         prev_m = m;
1589                 }
1590         }
1591         if (frame < prev_m->frame()) {
1592                 return 0.0;
1593         }
1594         const double beat = prev_m->beat() + (ts.pulse_at_frame (frame, _frame_rate) - prev_m->pulse()) * prev_m->note_divisor();
1595
1596         if (next_m && next_m->beat() < beat) {
1597                 return next_m->beat();
1598         }
1599
1600         return beat;
1601 }
1602
1603 double
1604 TempoMap::beat_at_frame (const framecnt_t& frame) const
1605 {
1606         Glib::Threads::RWLock::ReaderLock lm (lock);
1607         return beat_at_frame_locked (_metrics, frame);
1608 }
1609
1610 /* meter section based */
1611 framecnt_t
1612 TempoMap::frame_at_beat_locked (const Metrics& metrics, const double& beat) const
1613 {
1614         const TempoSection& prev_t = tempo_section_at_beat_locked (metrics, beat);
1615         MeterSection* prev_m = 0;
1616
1617         for (Metrics::const_iterator i = metrics.begin(); i != metrics.end(); ++i) {
1618                 MeterSection* m;
1619                 if ((m = dynamic_cast<MeterSection*> (*i)) != 0) {
1620                         if (prev_m && m->beat() > beat) {
1621                                 break;
1622                         }
1623                         prev_m = m;
1624                 }
1625         }
1626
1627         return prev_t.frame_at_pulse (((beat - prev_m->beat()) / prev_m->note_divisor()) + prev_m->pulse(), _frame_rate);
1628 }
1629
1630 framecnt_t
1631 TempoMap::frame_at_beat (const double& beat) const
1632 {
1633         Glib::Threads::RWLock::ReaderLock lm (lock);
1634         return frame_at_beat_locked (_metrics, beat);
1635 }
1636
1637 double
1638 TempoMap::bbt_to_beats_locked (const Metrics& metrics, const Timecode::BBT_Time& bbt) const
1639 {
1640         /* CALLER HOLDS READ LOCK */
1641
1642         MeterSection* prev_m = 0;
1643
1644         /* because audio-locked meters have 'fake' integral beats,
1645            there is no pulse offset here.
1646         */
1647         for (Metrics::const_iterator i = metrics.begin(); i != metrics.end(); ++i) {
1648                 MeterSection* m;
1649                 if ((m = dynamic_cast<MeterSection*> (*i)) != 0) {
1650                         if (prev_m) {
1651                                 const double bars_to_m = (m->beat() - prev_m->beat()) / prev_m->divisions_per_bar();
1652                                 if ((bars_to_m + (prev_m->bbt().bars - 1)) > (bbt.bars - 1)) {
1653                                         break;
1654                                 }
1655                         }
1656                         prev_m = m;
1657                 }
1658         }
1659
1660         const double remaining_bars = bbt.bars - prev_m->bbt().bars;
1661         const double remaining_bars_in_beats = remaining_bars * prev_m->divisions_per_bar();
1662         const double ret = remaining_bars_in_beats + prev_m->beat() + (bbt.beats - 1) + (bbt.ticks / BBT_Time::ticks_per_beat);
1663
1664         return ret;
1665 }
1666
1667 double
1668 TempoMap::bbt_to_beats (const Timecode::BBT_Time& bbt)
1669 {
1670         Glib::Threads::RWLock::ReaderLock lm (lock);
1671         return bbt_to_beats_locked (_metrics, bbt);
1672 }
1673
1674 Timecode::BBT_Time
1675 TempoMap::beats_to_bbt_locked (const Metrics& metrics, const double& b) const
1676 {
1677         /* CALLER HOLDS READ LOCK */
1678         MeterSection* prev_m = 0;
1679         const double beats = (b < 0.0) ? 0.0 : b;
1680
1681         for (Metrics::const_iterator i = metrics.begin(); i != metrics.end(); ++i) {
1682                 MeterSection* m = 0;
1683
1684                 if ((m = dynamic_cast<MeterSection*> (*i)) != 0) {
1685                         if (prev_m) {
1686                                 if (m->beat() > beats) {
1687                                         /* this is the meter after the one our beat is on*/
1688                                         break;
1689                                 }
1690                         }
1691
1692                         prev_m = m;
1693                 }
1694         }
1695
1696         const double beats_in_ms = beats - prev_m->beat();
1697         const uint32_t bars_in_ms = (uint32_t) floor (beats_in_ms / prev_m->divisions_per_bar());
1698         const uint32_t total_bars = bars_in_ms + (prev_m->bbt().bars - 1);
1699         const double remaining_beats = beats_in_ms - (bars_in_ms * prev_m->divisions_per_bar());
1700         const double remaining_ticks = (remaining_beats - floor (remaining_beats)) * BBT_Time::ticks_per_beat;
1701
1702         BBT_Time ret;
1703
1704         ret.ticks = (uint32_t) floor (remaining_ticks + 0.5);
1705         ret.beats = (uint32_t) floor (remaining_beats);
1706         ret.bars = total_bars;
1707
1708         /* 0 0 0 to 1 1 0 - based mapping*/
1709         ++ret.bars;
1710         ++ret.beats;
1711
1712         if (ret.ticks >= BBT_Time::ticks_per_beat) {
1713                 ++ret.beats;
1714                 ret.ticks -= BBT_Time::ticks_per_beat;
1715         }
1716
1717         if (ret.beats >= prev_m->divisions_per_bar() + 1) {
1718                 ++ret.bars;
1719                 ret.beats = 1;
1720         }
1721
1722         return ret;
1723 }
1724
1725 Timecode::BBT_Time
1726 TempoMap::beats_to_bbt (const double& beats)
1727 {
1728         Glib::Threads::RWLock::ReaderLock lm (lock);
1729         return beats_to_bbt_locked (_metrics, beats);
1730 }
1731
1732 Timecode::BBT_Time
1733 TempoMap::pulse_to_bbt (const double& pulse)
1734 {
1735         Glib::Threads::RWLock::ReaderLock lm (lock);
1736         MeterSection* prev_m = 0;
1737
1738         for (Metrics::const_iterator i = _metrics.begin(); i != _metrics.end(); ++i) {
1739                 MeterSection* m = 0;
1740
1741                 if ((m = dynamic_cast<MeterSection*> (*i)) != 0) {
1742
1743                         if (prev_m) {
1744                                 double const pulses_to_m = m->pulse() - prev_m->pulse();
1745                                 if (prev_m->pulse() + pulses_to_m > pulse) {
1746                                         /* this is the meter after the one our beat is on*/
1747                                         break;
1748                                 }
1749                         }
1750
1751                         prev_m = m;
1752                 }
1753         }
1754
1755         const double beats_in_ms = (pulse - prev_m->pulse()) * prev_m->note_divisor();
1756         const uint32_t bars_in_ms = (uint32_t) floor (beats_in_ms / prev_m->divisions_per_bar());
1757         const uint32_t total_bars = bars_in_ms + (prev_m->bbt().bars - 1);
1758         const double remaining_beats = beats_in_ms - (bars_in_ms * prev_m->divisions_per_bar());
1759         const double remaining_ticks = (remaining_beats - floor (remaining_beats)) * BBT_Time::ticks_per_beat;
1760
1761         BBT_Time ret;
1762
1763         ret.ticks = (uint32_t) floor (remaining_ticks + 0.5);
1764         ret.beats = (uint32_t) floor (remaining_beats);
1765         ret.bars = total_bars;
1766
1767         /* 0 0 0 to 1 1 0 mapping*/
1768         ++ret.bars;
1769         ++ret.beats;
1770
1771         if (ret.ticks >= BBT_Time::ticks_per_beat) {
1772                 ++ret.beats;
1773                 ret.ticks -= BBT_Time::ticks_per_beat;
1774         }
1775
1776         if (ret.beats >= prev_m->divisions_per_bar() + 1) {
1777                 ++ret.bars;
1778                 ret.beats = 1;
1779         }
1780
1781         return ret;
1782 }
1783
1784 void
1785 TempoMap::bbt_time (framepos_t frame, BBT_Time& bbt)
1786 {
1787
1788         if (frame < 0) {
1789                 bbt.bars = 1;
1790                 bbt.beats = 1;
1791                 bbt.ticks = 0;
1792                 warning << string_compose (_("tempo map asked for BBT time at frame %1\n"), frame) << endmsg;
1793                 return;
1794         }
1795         Glib::Threads::RWLock::ReaderLock lm (lock);
1796         const double beat = beat_at_frame_locked (_metrics, frame);
1797
1798         bbt = beats_to_bbt_locked (_metrics, beat);
1799 }
1800
1801 /* meter section based */
1802 framepos_t
1803 TempoMap::frame_time_locked (const Metrics& metrics, const BBT_Time& bbt) const
1804 {
1805         /* HOLD THE READER LOCK */
1806
1807         const framepos_t ret = frame_at_beat_locked (metrics, bbt_to_beats_locked (metrics, bbt));
1808         return ret;
1809 }
1810
1811 framepos_t
1812 TempoMap::frame_time (const BBT_Time& bbt)
1813 {
1814         if (bbt.bars < 1) {
1815                 warning << string_compose (_("tempo map asked for frame time at bar < 1  (%1)\n"), bbt) << endmsg;
1816                 return 0;
1817         }
1818
1819         if (bbt.beats < 1) {
1820                 throw std::logic_error ("beats are counted from one");
1821         }
1822         Glib::Threads::RWLock::ReaderLock lm (lock);
1823
1824         return frame_time_locked (_metrics, bbt);
1825 }
1826
1827 bool
1828 TempoMap::check_solved (const Metrics& metrics, bool by_frame) const
1829 {
1830         TempoSection* prev_t = 0;
1831         MeterSection* prev_m = 0;
1832
1833         for (Metrics::const_iterator i = metrics.begin(); i != metrics.end(); ++i) {
1834                 TempoSection* t;
1835                 MeterSection* m;
1836                 if ((t = dynamic_cast<TempoSection*> (*i)) != 0) {
1837                         if (!t->active()) {
1838                                 continue;
1839                         }
1840                         if (prev_t) {
1841                                 if ((by_frame && t->frame() < prev_t->frame()) || (!by_frame && t->pulse() < prev_t->pulse())) {
1842                                         return false;
1843                                 }
1844
1845                                 if (t->frame() == prev_t->frame()) {
1846                                         return false;
1847                                 }
1848
1849                                 /* precision check ensures pulses and frames align.*/
1850                                 if (t->frame() != prev_t->frame_at_pulse (t->pulse(), _frame_rate)) {
1851                                         if (!t->locked_to_meter()) {
1852                                                 return false;
1853                                         }
1854                                 }
1855                         }
1856                         prev_t = t;
1857                 }
1858
1859                 if ((m = dynamic_cast<MeterSection*> (*i)) != 0) {
1860                         if (prev_m && m->position_lock_style() == AudioTime) {
1861                                 TempoSection* t = const_cast<TempoSection*>(&tempo_section_at_locked (metrics, m->frame() - 1));
1862                                 const double nascent_m_pulse = ((m->beat() - prev_m->beat()) / prev_m->note_divisor()) + prev_m->pulse();
1863                                 const frameoffset_t nascent_m_frame = t->frame_at_pulse (nascent_m_pulse, _frame_rate);
1864                                 if (t && (nascent_m_frame > m->frame() || nascent_m_frame < 0)) {
1865                                         return false;
1866                                 }
1867                         }
1868
1869                         prev_m = m;
1870                 }
1871
1872         }
1873
1874         return true;
1875 }
1876
1877 bool
1878 TempoMap::set_active_tempos (const Metrics& metrics, const framepos_t& frame)
1879 {
1880         for (Metrics::const_iterator i = metrics.begin(); i != metrics.end(); ++i) {
1881                 TempoSection* t;
1882                 if ((t = dynamic_cast<TempoSection*> (*i)) != 0) {
1883                         if (!t->movable()) {
1884                                 t->set_active (true);
1885                                 continue;
1886                         }
1887                         if (t->movable() && t->active () && t->position_lock_style() == AudioTime && t->frame() < frame) {
1888                                 t->set_active (false);
1889                                 t->set_pulse (0.0);
1890                         } else if (t->movable() && t->position_lock_style() == AudioTime && t->frame() > frame) {
1891                                 t->set_active (true);
1892                         } else if (t->movable() && t->position_lock_style() == AudioTime && t->frame() == frame) {
1893                                 return false;
1894                         }
1895                 }
1896         }
1897         return true;
1898 }
1899
1900 bool
1901 TempoMap::solve_map (Metrics& imaginary, TempoSection* section, const framepos_t& frame)
1902 {
1903         TempoSection* prev_t = 0;
1904         TempoSection* section_prev = 0;
1905         framepos_t first_m_frame = 0;
1906
1907         for (Metrics::iterator i = imaginary.begin(); i != imaginary.end(); ++i) {
1908                 MeterSection* m;
1909                 if ((m = dynamic_cast<MeterSection*> (*i)) != 0) {
1910                         if (!m->movable()) {
1911                                 first_m_frame = m->frame();
1912                                 break;
1913                         }
1914                 }
1915         }
1916         if (section->movable() && frame <= first_m_frame) {
1917                 return false;
1918         }
1919
1920         section->set_active (true);
1921         section->set_frame (frame);
1922
1923         for (Metrics::iterator i = imaginary.begin(); i != imaginary.end(); ++i) {
1924                 TempoSection* t;
1925                 if ((t = dynamic_cast<TempoSection*> (*i)) != 0) {
1926
1927                         if (!t->active()) {
1928                                 continue;
1929                         }
1930                         if (prev_t) {
1931                                 if (t == section) {
1932                                         section_prev = prev_t;
1933                                         continue;
1934                                 }
1935                                 if (t->position_lock_style() == MusicTime) {
1936                                         prev_t->set_c_func (prev_t->compute_c_func_pulse (t->pulses_per_minute(), t->pulse(), _frame_rate));
1937                                         t->set_frame (prev_t->frame_at_pulse (t->pulse(), _frame_rate));
1938                                 } else {
1939                                         prev_t->set_c_func (prev_t->compute_c_func_frame (t->pulses_per_minute(), t->frame(), _frame_rate));
1940                                         if (!t->locked_to_meter()) {
1941                                                 t->set_pulse (prev_t->pulse_at_frame (t->frame(), _frame_rate));
1942                                         }
1943                                 }
1944                         }
1945                         prev_t = t;
1946                 }
1947         }
1948
1949         if (section_prev) {
1950                 section_prev->set_c_func (section_prev->compute_c_func_frame (section->pulses_per_minute(), frame, _frame_rate));
1951                 if (!section->locked_to_meter()) {
1952                         section->set_pulse (section_prev->pulse_at_frame (frame, _frame_rate));
1953                 }
1954         }
1955
1956         if (section->position_lock_style() == MusicTime) {
1957                 /* we're setting the frame */
1958                 section->set_position_lock_style (AudioTime);
1959                 recompute_tempos (imaginary);
1960                 section->set_position_lock_style (MusicTime);
1961         } else {
1962                 recompute_tempos (imaginary);
1963         }
1964
1965         recompute_meters (imaginary);
1966         if (check_solved (imaginary, true)) {
1967                 return true;
1968         }
1969
1970         MetricSectionFrameSorter fcmp;
1971         imaginary.sort (fcmp);
1972         if (section->position_lock_style() == MusicTime) {
1973                 /* we're setting the frame */
1974                 section->set_position_lock_style (AudioTime);
1975                 recompute_tempos (imaginary);
1976                 section->set_position_lock_style (MusicTime);
1977         } else {
1978                 recompute_tempos (imaginary);
1979         }
1980
1981         recompute_meters (imaginary);
1982         if (check_solved (imaginary, true)) {
1983                 return true;
1984         }
1985
1986         //dump (imaginary, std::cerr);
1987
1988         return false;
1989 }
1990
1991 bool
1992 TempoMap::solve_map (Metrics& imaginary, TempoSection* section, const double& pulse)
1993 {
1994         TempoSection* prev_t = 0;
1995         TempoSection* section_prev = 0;
1996
1997         section->set_pulse (pulse);
1998
1999         for (Metrics::iterator i = imaginary.begin(); i != imaginary.end(); ++i) {
2000                 TempoSection* t;
2001                 if ((t = dynamic_cast<TempoSection*> (*i)) != 0) {
2002                         if (!t->active()) {
2003                                 continue;
2004                         }
2005                         if (!t->movable()) {
2006                                 t->set_pulse (0.0);
2007                                 prev_t = t;
2008                                 continue;
2009                         }
2010                         if (prev_t) {
2011                                 if (t == section) {
2012                                         section_prev = prev_t;
2013                                         continue;
2014                                 }
2015                                 if (t->position_lock_style() == MusicTime) {
2016                                         prev_t->set_c_func (prev_t->compute_c_func_pulse (t->pulses_per_minute(), t->pulse(), _frame_rate));
2017                                         t->set_frame (prev_t->frame_at_pulse (t->pulse(), _frame_rate));
2018                                 } else {
2019                                         prev_t->set_c_func (prev_t->compute_c_func_frame (t->pulses_per_minute(), t->frame(), _frame_rate));
2020                                         if (!t->locked_to_meter()) {
2021                                                 t->set_pulse (prev_t->pulse_at_frame (t->frame(), _frame_rate));
2022                                         }
2023                                 }
2024                         }
2025                         prev_t = t;
2026                 }
2027         }
2028         if (section_prev) {
2029                 section_prev->set_c_func (section_prev->compute_c_func_pulse (section->pulses_per_minute(), pulse, _frame_rate));
2030                 section->set_frame (section_prev->frame_at_pulse (pulse, _frame_rate));
2031         }
2032
2033         if (section->position_lock_style() == AudioTime) {
2034                 /* we're setting the pulse */
2035                 section->set_position_lock_style (MusicTime);
2036                 recompute_tempos (imaginary);
2037                 section->set_position_lock_style (AudioTime);
2038         } else {
2039                 recompute_tempos (imaginary);
2040         }
2041
2042         recompute_meters (imaginary);
2043         if (check_solved (imaginary, false)) {
2044                 return true;
2045         }
2046
2047         MetricSectionSorter cmp;
2048         imaginary.sort (cmp);
2049         if (section->position_lock_style() == AudioTime) {
2050                 /* we're setting the pulse */
2051                 section->set_position_lock_style (MusicTime);
2052                 recompute_tempos (imaginary);
2053                 section->set_position_lock_style (AudioTime);
2054         } else {
2055                 recompute_tempos (imaginary);
2056         }
2057
2058         recompute_meters (imaginary);
2059         if (check_solved (imaginary, false)) {
2060                 return true;
2061         }
2062
2063         //dump (imaginary, std::cerr);
2064
2065         return false;
2066 }
2067
2068 bool
2069 TempoMap::solve_map (Metrics& imaginary, MeterSection* section, const framepos_t& frame)
2070 {
2071         /* disallow moving first meter past any subsequent one, and any movable meter before the first one */
2072         const MeterSection* other =  &meter_section_at_locked (imaginary, frame);
2073         if ((!section->movable() && other->movable()) || (!other->movable() && section->movable() && other->frame() >= frame)) {
2074                 return false;
2075         }
2076
2077         if (!section->movable()) {
2078                 /* lock the first tempo to our first meter */
2079                 if (!set_active_tempos (imaginary, frame)) {
2080                         return false;
2081                 }
2082         }
2083
2084         TempoSection* meter_locked_tempo = 0;
2085         for (Metrics::const_iterator i = imaginary.begin(); i != imaginary.end(); ++i) {
2086                 TempoSection* t;
2087                 if ((t = dynamic_cast<TempoSection*> (*i)) != 0) {
2088                         if ((t->locked_to_meter() || !t->movable()) && t->frame() == section->frame()) {
2089                                 if (t->frame() == section->frame()) {
2090                                         meter_locked_tempo = t;
2091                                         break;
2092                                 }
2093                         }
2094                 }
2095         }
2096
2097         MeterSection* prev_m = 0;
2098
2099         for (Metrics::iterator i = imaginary.begin(); i != imaginary.end(); ++i) {
2100                 MeterSection* m;
2101                 if ((m = dynamic_cast<MeterSection*> (*i)) != 0) {
2102                         if (m == section){
2103                                 if (prev_m && section->movable()) {
2104                                         const double beats = (pulse_at_frame_locked (imaginary, frame) - prev_m->pulse()) * prev_m->note_divisor();
2105                                         if (beats + prev_m->beat() < section->beat()) {
2106                                                 /* disallow position change if it will alter our beat
2107                                                    we allow tempo changes to do this in recompute_meters().
2108                                                    blocking this is an option, but i'm not convinced that
2109                                                    this is what the user would actually want.
2110                                                    here we set the frame/pulse corresponding to its musical position.
2111                                                 */
2112
2113                                                 if (meter_locked_tempo) {
2114                                                         Metrics future_map;
2115                                                         TempoSection* new_section = copy_metrics_and_point (imaginary, future_map, meter_locked_tempo);
2116                                                         if (!new_section) {
2117                                                                 return false;
2118                                                         }
2119                                                         const double new_pulse = ((section->beat() - prev_m->beat())
2120                                                                                   / prev_m->note_divisor()) + prev_m->pulse();
2121
2122                                                         if (solve_map (future_map, new_section, section->frame())) {
2123                                                                 meter_locked_tempo->set_pulse (new_pulse);
2124                                                                 solve_map (imaginary, meter_locked_tempo, section->frame());
2125                                                                 section->set_frame (frame_at_pulse_locked (imaginary, new_pulse));
2126                                                                 section->set_pulse (new_pulse);
2127                                                         } else {
2128                                                                 return false;
2129                                                         }
2130                                                 }
2131                                                 return false;
2132                                         } else {
2133                                                 if (meter_locked_tempo) {
2134                                                         Metrics future_map;
2135                                                         TempoSection* new_section = copy_metrics_and_point (imaginary, future_map, meter_locked_tempo);
2136                                                         if (!new_section) {
2137                                                                 return false;
2138                                                         }
2139                                                         new_section->set_active (true);
2140
2141                                                         if (solve_map (future_map, new_section, frame)) {
2142                                                                 meter_locked_tempo->set_pulse (((section->beat() - prev_m->beat())
2143                                                                                                 / prev_m->note_divisor()) + prev_m->pulse());
2144                                                                 solve_map (imaginary, meter_locked_tempo, frame);
2145                                                         } else {
2146                                                                 return false;
2147                                                         }
2148                                                 }
2149                                         }
2150                                 } else {
2151                                         if (meter_locked_tempo) {
2152                                                 Metrics future_map;
2153                                                 TempoSection* new_section = copy_metrics_and_point (imaginary, future_map, meter_locked_tempo);
2154                                                 if (!new_section) {
2155                                                         return false;
2156                                                 }
2157                                                 new_section->set_frame (frame);
2158                                                 new_section->set_pulse (0.0);
2159                                                 new_section->set_active (true);
2160
2161                                                 if (solve_map (future_map, new_section, frame)) {
2162                                                         meter_locked_tempo->set_frame (frame);
2163                                                         meter_locked_tempo->set_pulse (0.0);
2164                                                         meter_locked_tempo->set_active (true);
2165                                                         solve_map (imaginary, meter_locked_tempo, frame);
2166                                                 } else {
2167                                                         return false;
2168                                                 }
2169                                         } else {
2170                                                 return false;
2171                                         }
2172                                         pair<double, BBT_Time> b_bbt = make_pair (0.0, BBT_Time (1, 1, 0));
2173                                         section->set_beat (b_bbt);
2174                                         section->set_pulse (0.0);
2175
2176                                 }
2177                                 section->set_frame (frame);
2178                                 break;
2179                         }
2180
2181                         prev_m = m;
2182                 }
2183         }
2184
2185         MetricSectionFrameSorter fcmp;
2186         imaginary.sort (fcmp);
2187         if (section->position_lock_style() == MusicTime) {
2188                 /* we're setting the frame */
2189                 section->set_position_lock_style (AudioTime);
2190                 recompute_meters (imaginary);
2191                 section->set_position_lock_style (MusicTime);
2192         } else {
2193                 recompute_meters (imaginary);
2194         }
2195         //dump (imaginary, std::cerr);
2196         return true;
2197 }
2198
2199 bool
2200 TempoMap::solve_map (Metrics& imaginary, MeterSection* section, const double& pulse)
2201 {
2202         MeterSection* prev_m = 0;
2203
2204         section->set_pulse (pulse);
2205
2206         for (Metrics::iterator i = imaginary.begin(); i != imaginary.end(); ++i) {
2207                 MeterSection* m;
2208                 if ((m = dynamic_cast<MeterSection*> (*i)) != 0) {
2209                         double new_pulse = 0.0;
2210                         pair<double, BBT_Time> b_bbt;
2211
2212                         if (prev_m && m == section){
2213                                 /* the first meter is always audio-locked, so prev_m should exist.
2214                                    should we allow setting audio locked meters by pulse?
2215                                 */
2216                                 const double beats = floor (((pulse - prev_m->pulse()) * prev_m->note_divisor()) + 0.5);
2217                                 const int32_t bars = (beats) / prev_m->divisions_per_bar();
2218                                 pair<double, BBT_Time> b_bbt = make_pair (beats + prev_m->beat(), BBT_Time (bars + prev_m->bbt().bars, 1, 0));
2219                                 section->set_beat (b_bbt);
2220                                 section->set_frame (frame_at_pulse_locked (imaginary, pulse));
2221                                 prev_m = m;
2222                                 continue;
2223                         }
2224                         if (m->position_lock_style() == AudioTime) {
2225                                 if (m->movable()) {
2226                                         const double beats = ((m->bbt().bars - prev_m->bbt().bars) * prev_m->divisions_per_bar());
2227                                         if (beats + prev_m->beat() != m->beat()) {
2228                                                 /* tempo/ meter change caused a change in beat (bar). */
2229                                                 const double floor_beats = beats - fmod (beats, prev_m->divisions_per_bar());
2230                                                 b_bbt = make_pair (beats + prev_m->beat()
2231                                                                    , BBT_Time ((beats / prev_m->divisions_per_bar()) + prev_m->bbt().bars, 1, 0));
2232                                                 new_pulse = prev_m->pulse() + (beats / prev_m->note_divisor());
2233                                         } else {
2234                                                 b_bbt = make_pair (m->beat(), m->bbt());
2235                                                 new_pulse = pulse_at_frame_locked (imaginary, m->frame());
2236                                         }
2237                                 } else {
2238                                         b_bbt = make_pair (0.0, BBT_Time (1, 1, 0));
2239                                 }
2240                         } else {
2241                                 new_pulse = prev_m->pulse() + ((m->bbt().bars - prev_m->bbt().bars) *  prev_m->divisions_per_bar() / prev_m->note_divisor());
2242                                 b_bbt = make_pair (((new_pulse - prev_m->pulse()) * prev_m->note_divisor()) + prev_m->beat(), m->bbt());
2243                         }
2244                         m->set_beat (b_bbt);
2245                         m->set_pulse (new_pulse);
2246                         prev_m = m;
2247                 }
2248         }
2249
2250         MetricSectionSorter cmp;
2251         imaginary.sort (cmp);
2252         if (section->position_lock_style() == AudioTime) {
2253                 /* we're setting the pulse */
2254                 section->set_position_lock_style (MusicTime);
2255                 recompute_meters (imaginary);
2256                 section->set_position_lock_style (AudioTime);
2257         } else {
2258                 recompute_meters (imaginary);
2259         }
2260         return true;
2261 }
2262
2263 /** places a copy of _metrics into copy and returns a pointer
2264  *  to section's equivalent in copy.
2265  */
2266 TempoSection*
2267 TempoMap::copy_metrics_and_point (const Metrics& metrics, Metrics& copy, TempoSection* section)
2268 {
2269         TempoSection* ret = 0;
2270
2271         for (Metrics::const_iterator i = metrics.begin(); i != metrics.end(); ++i) {
2272                 TempoSection* t;
2273                 MeterSection* m;
2274                 if ((t = dynamic_cast<TempoSection*> (*i)) != 0) {
2275                         if (t == section) {
2276                                 ret = new TempoSection (*t);
2277                                 copy.push_back (ret);
2278                                 continue;
2279                         }
2280
2281                         TempoSection* cp = new TempoSection (*t);
2282                         copy.push_back (cp);
2283                 }
2284                 if ((m = dynamic_cast<MeterSection *> (*i)) != 0) {
2285                         MeterSection* cp = new MeterSection (*m);
2286                         copy.push_back (cp);
2287                 }
2288         }
2289
2290         return ret;
2291 }
2292
2293 MeterSection*
2294 TempoMap::copy_metrics_and_point (const Metrics& metrics, Metrics& copy, MeterSection* section)
2295 {
2296         MeterSection* ret = 0;
2297
2298         for (Metrics::const_iterator i = metrics.begin(); i != metrics.end(); ++i) {
2299                 TempoSection* t;
2300                 MeterSection* m;
2301                 if ((t = dynamic_cast<TempoSection*> (*i)) != 0) {
2302                         TempoSection* cp = new TempoSection (*t);
2303                         copy.push_back (cp);
2304                 }
2305
2306                 if ((m = dynamic_cast<MeterSection *> (*i)) != 0) {
2307                         if (m == section) {
2308                                 ret = new MeterSection (*m);
2309                                 copy.push_back (ret);
2310                                 continue;
2311                         }
2312                         MeterSection* cp = new MeterSection (*m);
2313                         copy.push_back (cp);
2314                 }
2315         }
2316
2317         return ret;
2318 }
2319
2320 bool
2321 TempoMap::can_solve_bbt (TempoSection* ts, const BBT_Time& bbt)
2322 {
2323         Metrics copy;
2324         TempoSection* new_section = 0;
2325
2326         {
2327                 Glib::Threads::RWLock::ReaderLock lm (lock);
2328                 new_section = copy_metrics_and_point (_metrics, copy, ts);
2329                 if (!new_section) {
2330                         return false;
2331                 }
2332         }
2333
2334         const double beat = bbt_to_beats_locked (copy, bbt);
2335         const bool ret = solve_map (copy, new_section, pulse_at_beat_locked (copy, beat));
2336
2337         Metrics::const_iterator d = copy.begin();
2338         while (d != copy.end()) {
2339                 delete (*d);
2340                 ++d;
2341         }
2342
2343         return ret;
2344 }
2345
2346 /**
2347 * This is for a gui that needs to know the frame of a tempo section if it were to be moved to some bbt time,
2348 * taking any possible reordering as a consequence of this into account.
2349 * @param section - the section to be altered
2350 * @param bpm - the new Tempo
2351 * @param bbt - the bbt where the altered tempo will fall
2352 * @return returns - the position in frames where the new tempo section will lie.
2353 */
2354 framepos_t
2355 TempoMap::predict_tempo_frame (TempoSection* section, const BBT_Time& bbt)
2356 {
2357         Glib::Threads::RWLock::ReaderLock lm (lock);
2358         Metrics future_map;
2359         framepos_t ret = 0;
2360         TempoSection* new_section = copy_metrics_and_point (_metrics, future_map, section);
2361         if (!new_section) {
2362                 return 0;
2363         }
2364         const double beat = bbt_to_beats_locked (future_map, bbt);
2365
2366         if (solve_map (future_map, new_section, pulse_at_beat_locked (future_map, beat))) {
2367                 ret = new_section->frame();
2368         } else {
2369                 ret = frame_at_beat_locked (_metrics, beat);
2370         }
2371
2372         Metrics::const_iterator d = future_map.begin();
2373         while (d != future_map.end()) {
2374                 delete (*d);
2375                 ++d;
2376         }
2377         return ret;
2378 }
2379
2380 double
2381 TempoMap::predict_tempo_pulse (TempoSection* section, const framepos_t& frame)
2382 {
2383         Glib::Threads::RWLock::ReaderLock lm (lock);
2384         Metrics future_map;
2385         double ret = 0.0;
2386         TempoSection* new_section = copy_metrics_and_point (_metrics, future_map, section);
2387
2388         if (solve_map (future_map, new_section, frame)) {
2389                 ret = new_section->pulse();
2390         } else {
2391                 ret = pulse_at_frame_locked (_metrics, frame);
2392         }
2393
2394         Metrics::const_iterator d = future_map.begin();
2395         while (d != future_map.end()) {
2396                 delete (*d);
2397                 ++d;
2398         }
2399         return ret;
2400 }
2401
2402 void
2403 TempoMap::gui_move_tempo_frame (TempoSection* ts, const framepos_t& frame)
2404 {
2405         Metrics future_map;
2406         {
2407                 Glib::Threads::RWLock::WriterLock lm (lock);
2408                 TempoSection* new_section = copy_metrics_and_point (_metrics, future_map, ts);
2409                 if (solve_map (future_map, new_section, frame)) {
2410                         solve_map (_metrics, ts, frame);
2411                         recompute_meters (_metrics);
2412                 }
2413         }
2414
2415         Metrics::const_iterator d = future_map.begin();
2416         while (d != future_map.end()) {
2417                 delete (*d);
2418                 ++d;
2419         }
2420
2421         MetricPositionChanged (); // Emit Signal
2422 }
2423
2424 void
2425 TempoMap::gui_move_tempo_beat (TempoSection* ts, const double& beat)
2426 {
2427         Metrics future_map;
2428         {
2429                 Glib::Threads::RWLock::WriterLock lm (lock);
2430                 TempoSection* new_section = copy_metrics_and_point (_metrics, future_map, ts);
2431                 if (solve_map (future_map, new_section, pulse_at_beat_locked (future_map, beat))) {
2432                         solve_map (_metrics, ts, pulse_at_beat_locked (_metrics, beat));
2433                         recompute_meters (_metrics);
2434                 }
2435         }
2436
2437         Metrics::const_iterator d = future_map.begin();
2438         while (d != future_map.end()) {
2439                 delete (*d);
2440                 ++d;
2441         }
2442
2443         MetricPositionChanged (); // Emit Signal
2444 }
2445
2446 void
2447 TempoMap::gui_move_meter (MeterSection* ms, const framepos_t&  frame)
2448 {
2449         Metrics future_map;
2450         {
2451                 Glib::Threads::RWLock::WriterLock lm (lock);
2452                 MeterSection* copy = copy_metrics_and_point (_metrics, future_map, ms);
2453                 if (solve_map (future_map, copy, frame)) {
2454                         solve_map (_metrics, ms, frame);
2455                 }
2456         }
2457
2458         MetricPositionChanged (); // Emit Signal
2459 }
2460
2461 void
2462 TempoMap::gui_move_meter (MeterSection* ms, const double& pulse)
2463 {
2464         {
2465                 Glib::Threads::RWLock::WriterLock lm (lock);
2466                 solve_map (_metrics, ms, pulse);
2467         }
2468
2469         MetricPositionChanged (); // Emit Signal
2470 }
2471
2472 bool
2473 TempoMap::gui_change_tempo (TempoSection* ts, const Tempo& bpm)
2474 {
2475         Metrics future_map;
2476         bool can_solve = false;
2477         {
2478                 Glib::Threads::RWLock::WriterLock lm (lock);
2479                 TempoSection* new_section = copy_metrics_and_point (_metrics, future_map, ts);
2480                 new_section->set_beats_per_minute (bpm.beats_per_minute());
2481                 recompute_tempos (future_map);
2482
2483                 if (check_solved (future_map, true)) {
2484                         ts->set_beats_per_minute (bpm.beats_per_minute());
2485                         recompute_map (_metrics);
2486                         can_solve = true;
2487                 }
2488         }
2489
2490         Metrics::const_iterator d = future_map.begin();
2491         while (d != future_map.end()) {
2492                 delete (*d);
2493                 ++d;
2494         }
2495         if (can_solve) {
2496                 MetricPositionChanged (); // Emit Signal
2497         }
2498         return can_solve;
2499 }
2500
2501 void
2502 TempoMap::gui_dilate_tempo (MeterSection* ms, const framepos_t& frame)
2503 {
2504         Metrics future_map;
2505         TempoSection* ts = 0;
2506
2507         if (ms->position_lock_style() == AudioTime) {
2508                 /* disabled for now due to faked tempo locked to meter pulse */
2509                 return;
2510         }
2511         {
2512                 Glib::Threads::RWLock::WriterLock lm (lock);
2513                 ts = const_cast<TempoSection*>(&tempo_section_at_locked (_metrics, ms->frame() - 1));
2514                 if (!ts) {
2515                         return;
2516                 }
2517                 TempoSection* prev_t = copy_metrics_and_point (_metrics, future_map, ts);
2518                 TempoSection* prev_to_prev_t = 0;
2519                 const frameoffset_t fr_off = frame - ms->frame();
2520                 double new_bpm = 0.0;
2521
2522                 if (prev_t) {
2523                         prev_to_prev_t = const_cast<TempoSection*>(&tempo_section_at_locked (future_map, prev_t->frame() - 1));
2524                 }
2525
2526                 /* the change in frames is the result of changing the slope of at most 2 previous tempo sections.
2527                    constant to constant is straightforward, as the tempo prev to prev_t has constant slope.
2528                 */
2529                 double contribution = 0.0;
2530                 frameoffset_t frame_contribution = 0.0;
2531                 frameoffset_t prev_t_frame_contribution = 0.0;
2532
2533                 if (prev_to_prev_t && prev_to_prev_t->type() == TempoSection::Ramp) {
2534                         /* prev to prev_t's position will remain constant in terms of frame and pulse. lets use frames. */
2535                         contribution = (prev_t->frame() - prev_to_prev_t->frame()) / (double) (ms->frame() - prev_to_prev_t->frame());
2536                         frame_contribution = contribution * (double) fr_off;
2537                         prev_t_frame_contribution = fr_off - frame_contribution;
2538                 }
2539
2540                 if (prev_t->type() == TempoSection::Constant || prev_t->c_func() == 0.0) {
2541
2542                         if (prev_t->position_lock_style() == MusicTime) {
2543                                 if (prev_to_prev_t && prev_to_prev_t->type() == TempoSection::Ramp) {
2544                                         new_bpm = prev_t->beats_per_minute() * ((ms->frame() - prev_t->frame())
2545                                                                                 / (double) (ms->frame() + prev_t_frame_contribution - prev_t->frame()));
2546
2547                                 } else {
2548                                         /* prev to prev is irrelevant */
2549                                         const double meter_pulse = prev_t->pulse_at_frame (ms->frame(), _frame_rate);
2550                                         const double frame_pulse = prev_t->pulse_at_frame (frame, _frame_rate);
2551
2552                                         if (frame_pulse != prev_t->pulse()) {
2553                                                 new_bpm = prev_t->beats_per_minute() * ((meter_pulse - prev_t->pulse()) / (frame_pulse - prev_t->pulse()));
2554                                         } else {
2555                                                 new_bpm = prev_t->beats_per_minute();
2556                                         }
2557                                 }
2558                         } else {
2559                                 /* AudioTime */
2560                                 if (prev_to_prev_t && prev_to_prev_t->type() == TempoSection::Ramp) {
2561                                         new_bpm = prev_t->beats_per_minute() * ((ms->frame() - prev_t->frame())
2562                                                                                 / (double) (ms->frame() + prev_t_frame_contribution - prev_t->frame()));
2563                                 } else {
2564                                         /* prev_to_prev_t is irrelevant */
2565
2566                                         if (frame != prev_t->frame()) {
2567                                                 new_bpm = prev_t->beats_per_minute() * ((ms->frame() - prev_t->frame()) / (double) (frame - prev_t->frame()));
2568                                         } else {
2569                                                 new_bpm = prev_t->beats_per_minute();
2570                                         }
2571                                 }
2572                         }
2573                 } else if (prev_t->c_func() < 0.0) {
2574                         if (prev_to_prev_t && prev_to_prev_t->type() == TempoSection::Ramp) {
2575                                 new_bpm = prev_t->tempo_at_frame (prev_t->frame() + frame_contribution, _frame_rate) * (double) prev_t->note_type();
2576                         } else {
2577                                 /* prev_to_prev_t is irrelevant */
2578                                 new_bpm = prev_t->tempo_at_frame (prev_t->frame() + fr_off, _frame_rate) * (double) prev_t->note_type();
2579                         }
2580
2581                         const double diff = (prev_t->tempo_at_frame (frame, _frame_rate) * prev_t->note_type()) - prev_t->beats_per_minute();
2582                         if (diff > -0.1 && diff  < 0.1) {
2583                                 new_bpm = prev_t->beats_per_minute() * ((ms->frame() - prev_t->frame())
2584                                                                         / (double) ((ms->frame() + prev_t_frame_contribution) - prev_t->frame()));
2585                         }
2586
2587                 } else if (prev_t->c_func() > 0.0) {
2588                         if (prev_to_prev_t && prev_to_prev_t->type() == TempoSection::Ramp) {
2589                                 new_bpm = prev_t->tempo_at_frame (prev_t->frame() - frame_contribution, _frame_rate) * (double) prev_t->note_type();
2590                         } else {
2591                                 /* prev_to_prev_t is irrelevant */
2592                                 new_bpm = prev_t->tempo_at_frame (prev_t->frame() - fr_off, _frame_rate) * (double) prev_t->note_type();
2593                         }
2594
2595                         /* limits - a bit clunky, but meh */
2596                         const double diff = (prev_t->tempo_at_frame (frame, _frame_rate) * prev_t->note_type()) - prev_t->beats_per_minute();
2597                         if (diff > -0.1 && diff  < 0.1) {
2598                                 new_bpm = prev_t->beats_per_minute() * ((ms->frame() - prev_t->frame())
2599                                                                         / (double) ((ms->frame() + prev_t_frame_contribution) - prev_t->frame()));
2600                         }
2601                 }
2602
2603                 prev_t->set_beats_per_minute (new_bpm);
2604                 recompute_tempos (future_map);
2605                 recompute_meters (future_map);
2606
2607                 if (check_solved (future_map, true)) {
2608
2609                         prev_t = const_cast<TempoSection*>(&tempo_section_at_locked (_metrics, ms->frame() - 1));
2610                         prev_t->set_beats_per_minute (new_bpm);
2611                         recompute_tempos (_metrics);
2612
2613                         if (ms->position_lock_style() == AudioTime) {
2614                                 ms->set_frame (frame);
2615                         }
2616
2617                         recompute_meters (_metrics);
2618                 }
2619         }
2620
2621         Metrics::const_iterator d = future_map.begin();
2622         while (d != future_map.end()) {
2623                 delete (*d);
2624                 ++d;
2625         }
2626
2627         MetricPositionChanged (); // Emit Signal
2628         return;
2629 }
2630
2631 framecnt_t
2632 TempoMap::bbt_duration_at (framepos_t pos, const BBT_Time& bbt, int dir)
2633 {
2634         Glib::Threads::RWLock::ReaderLock lm (lock);
2635
2636         const double tick_at_time = beat_at_frame_locked (_metrics, pos) * BBT_Time::ticks_per_beat;
2637         const double bbt_ticks = bbt.ticks + (bbt.beats * BBT_Time::ticks_per_beat);
2638         const double total_beats = (tick_at_time + bbt_ticks) / BBT_Time::ticks_per_beat;
2639
2640         return frame_at_beat_locked (_metrics, total_beats);
2641 }
2642
2643 framepos_t
2644 TempoMap::round_to_bar (framepos_t fr, RoundMode dir)
2645 {
2646         return round_to_type (fr, dir, Bar);
2647 }
2648
2649 framepos_t
2650 TempoMap::round_to_beat (framepos_t fr, RoundMode dir)
2651 {
2652         return round_to_type (fr, dir, Beat);
2653 }
2654
2655 framepos_t
2656 TempoMap::round_to_beat_subdivision (framepos_t fr, int sub_num, RoundMode dir)
2657 {
2658         Glib::Threads::RWLock::ReaderLock lm (lock);
2659         uint32_t ticks = (uint32_t) floor (beat_at_frame_locked (_metrics, fr) * BBT_Time::ticks_per_beat);
2660         uint32_t beats = (uint32_t) floor (ticks / BBT_Time::ticks_per_beat);
2661         uint32_t ticks_one_subdivisions_worth = (uint32_t) BBT_Time::ticks_per_beat / sub_num;
2662
2663         ticks -= beats * BBT_Time::ticks_per_beat;
2664
2665         if (dir > 0) {
2666                 /* round to next (or same iff dir == RoundUpMaybe) */
2667
2668                 uint32_t mod = ticks % ticks_one_subdivisions_worth;
2669
2670                 if (mod == 0 && dir == RoundUpMaybe) {
2671                         /* right on the subdivision, which is fine, so do nothing */
2672
2673                 } else if (mod == 0) {
2674                         /* right on the subdivision, so the difference is just the subdivision ticks */
2675                         ticks += ticks_one_subdivisions_worth;
2676
2677                 } else {
2678                         /* not on subdivision, compute distance to next subdivision */
2679
2680                         ticks += ticks_one_subdivisions_worth - mod;
2681                 }
2682
2683                 if (ticks >= BBT_Time::ticks_per_beat) {
2684                         ticks -= BBT_Time::ticks_per_beat;
2685                 }
2686         } else if (dir < 0) {
2687
2688                 /* round to previous (or same iff dir == RoundDownMaybe) */
2689
2690                 uint32_t difference = ticks % ticks_one_subdivisions_worth;
2691
2692                 if (difference == 0 && dir == RoundDownAlways) {
2693                         /* right on the subdivision, but force-rounding down,
2694                            so the difference is just the subdivision ticks */
2695                         difference = ticks_one_subdivisions_worth;
2696                 }
2697
2698                 if (ticks < difference) {
2699                         ticks = BBT_Time::ticks_per_beat - ticks;
2700                 } else {
2701                         ticks -= difference;
2702                 }
2703
2704         } else {
2705                 /* round to nearest */
2706                 double rem;
2707
2708                 /* compute the distance to the previous and next subdivision */
2709
2710                 if ((rem = fmod ((double) ticks, (double) ticks_one_subdivisions_worth)) > ticks_one_subdivisions_worth/2.0) {
2711
2712                         /* closer to the next subdivision, so shift forward */
2713
2714                         ticks = lrint (ticks + (ticks_one_subdivisions_worth - rem));
2715
2716                         DEBUG_TRACE (DEBUG::SnapBBT, string_compose ("moved forward to %1\n", ticks));
2717
2718                         if (ticks > BBT_Time::ticks_per_beat) {
2719                                 ++beats;
2720                                 ticks -= BBT_Time::ticks_per_beat;
2721                                 DEBUG_TRACE (DEBUG::SnapBBT, string_compose ("fold beat to %1\n", beats));
2722                         }
2723
2724                 } else if (rem > 0) {
2725
2726                         /* closer to previous subdivision, so shift backward */
2727
2728                         if (rem > ticks) {
2729                                 if (beats == 0) {
2730                                         /* can't go backwards past zero, so ... */
2731                                         return 0;
2732                                 }
2733                                 /* step back to previous beat */
2734                                 --beats;
2735                                 ticks = lrint (BBT_Time::ticks_per_beat - rem);
2736                                 DEBUG_TRACE (DEBUG::SnapBBT, string_compose ("step back beat to %1\n", beats));
2737                         } else {
2738                                 ticks = lrint (ticks - rem);
2739                                 DEBUG_TRACE (DEBUG::SnapBBT, string_compose ("moved backward to %1\n", ticks));
2740                         }
2741                 } else {
2742                         /* on the subdivision, do nothing */
2743                 }
2744         }
2745
2746         const framepos_t ret_frame = frame_at_beat_locked (_metrics, beats + (ticks / BBT_Time::ticks_per_beat));
2747
2748         return ret_frame;
2749 }
2750
2751 void
2752 TempoMap::round_bbt (BBT_Time& when, const int32_t& sub_num)
2753 {
2754         if (sub_num == -1) {
2755                 const double bpb = meter_section_at_beat (bbt_to_beats_locked (_metrics, when)).divisions_per_bar();
2756                 if ((double) when.beats > bpb / 2.0) {
2757                         ++when.bars;
2758                 }
2759                 when.beats = 1;
2760                 when.ticks = 0;
2761                 return;
2762         } else if (sub_num == 0) {
2763                 const double bpb = meter_section_at_beat (bbt_to_beats_locked (_metrics, when)).divisions_per_bar();
2764                 if ((double) when.ticks > BBT_Time::ticks_per_beat / 2.0) {
2765                         ++when.beats;
2766                         while ((double) when.beats > bpb) {
2767                                 ++when.bars;
2768                                 when.beats -= (uint32_t) floor (bpb);
2769                         }
2770                 }
2771                 when.ticks = 0;
2772                 return;
2773         }
2774         const uint32_t ticks_one_subdivisions_worth = BBT_Time::ticks_per_beat / sub_num;
2775         double rem;
2776         if ((rem = fmod ((double) when.ticks, (double) ticks_one_subdivisions_worth)) > (ticks_one_subdivisions_worth / 2.0)) {
2777                 /* closer to the next subdivision, so shift forward */
2778
2779                 when.ticks = when.ticks + (ticks_one_subdivisions_worth - rem);
2780
2781                 if (when.ticks > Timecode::BBT_Time::ticks_per_beat) {
2782                         ++when.beats;
2783                         when.ticks -= Timecode::BBT_Time::ticks_per_beat;
2784                 }
2785
2786         } else if (rem > 0) {
2787                 /* closer to previous subdivision, so shift backward */
2788
2789                 if (rem > when.ticks) {
2790                         if (when.beats == 0) {
2791                                 /* can't go backwards past zero, so ... */
2792                         }
2793                         /* step back to previous beat */
2794                         --when.beats;
2795                         when.ticks = Timecode::BBT_Time::ticks_per_beat - rem;
2796                 } else {
2797                         when.ticks = when.ticks - rem;
2798                 }
2799         }
2800 }
2801
2802 framepos_t
2803 TempoMap::round_to_type (framepos_t frame, RoundMode dir, BBTPointType type)
2804 {
2805         Glib::Threads::RWLock::ReaderLock lm (lock);
2806
2807         const double beat_at_framepos = beat_at_frame_locked (_metrics, frame);
2808         BBT_Time bbt (beats_to_bbt_locked (_metrics, beat_at_framepos));
2809
2810         switch (type) {
2811         case Bar:
2812                 if (dir < 0) {
2813                         /* find bar previous to 'frame' */
2814                         bbt.beats = 1;
2815                         bbt.ticks = 0;
2816                         return frame_time_locked (_metrics, bbt);
2817
2818                 } else if (dir > 0) {
2819                         /* find bar following 'frame' */
2820                         ++bbt.bars;
2821                         bbt.beats = 1;
2822                         bbt.ticks = 0;
2823                         return frame_time_locked (_metrics, bbt);
2824                 } else {
2825                         /* true rounding: find nearest bar */
2826                         framepos_t raw_ft = frame_time_locked (_metrics, bbt);
2827                         bbt.beats = 1;
2828                         bbt.ticks = 0;
2829                         framepos_t prev_ft = frame_time_locked (_metrics, bbt);
2830                         ++bbt.bars;
2831                         framepos_t next_ft = frame_time_locked (_metrics, bbt);
2832
2833                         if ((raw_ft - prev_ft) > (next_ft - prev_ft) / 2) {
2834                                 return next_ft;
2835                         } else {
2836                                 return prev_ft;
2837                         }
2838                 }
2839
2840                 break;
2841
2842         case Beat:
2843                 if (dir < 0) {
2844                         return frame_at_beat_locked (_metrics, floor (beat_at_framepos));
2845                 } else if (dir > 0) {
2846                         return frame_at_beat_locked (_metrics, ceil (beat_at_framepos));
2847                 } else {
2848                         return frame_at_beat_locked (_metrics, floor (beat_at_framepos + 0.5));
2849                 }
2850                 break;
2851         }
2852
2853         return 0;
2854 }
2855
2856 void
2857 TempoMap::get_grid (vector<TempoMap::BBTPoint>& points,
2858                     framepos_t lower, framepos_t upper)
2859 {
2860         Glib::Threads::RWLock::ReaderLock lm (lock);
2861         int32_t cnt = ceil (beat_at_frame_locked (_metrics, lower));
2862         framecnt_t pos = 0;
2863         /* although the map handles negative beats, bbt doesn't. */
2864         if (cnt < 0.0) {
2865                 cnt = 0.0;
2866         }
2867         while (pos < upper) {
2868                 pos = frame_at_beat_locked (_metrics, cnt);
2869                 const TempoSection tempo = tempo_section_at_locked (_metrics, pos);
2870                 const MeterSection meter = meter_section_at_locked (_metrics, pos);
2871                 const BBT_Time bbt = beats_to_bbt (cnt);
2872                 points.push_back (BBTPoint (meter, tempo_at_locked (_metrics, pos), pos, bbt.bars, bbt.beats, tempo.c_func()));
2873                 ++cnt;
2874         }
2875 }
2876
2877 const TempoSection&
2878 TempoMap::tempo_section_at (framepos_t frame) const
2879 {
2880         Glib::Threads::RWLock::ReaderLock lm (lock);
2881         return tempo_section_at_locked (_metrics, frame);
2882 }
2883
2884 const TempoSection&
2885 TempoMap::tempo_section_at_locked (const Metrics& metrics, framepos_t frame) const
2886 {
2887         Metrics::const_iterator i;
2888         TempoSection* prev = 0;
2889
2890         for (i = metrics.begin(); i != metrics.end(); ++i) {
2891                 TempoSection* t;
2892
2893                 if ((t = dynamic_cast<TempoSection*> (*i)) != 0) {
2894                         if (!t->active()) {
2895                                 continue;
2896                         }
2897                         if (prev && t->frame() > frame) {
2898                                 break;
2899                         }
2900
2901                         prev = t;
2902                 }
2903         }
2904
2905         if (prev == 0) {
2906                 fatal << endmsg;
2907                 abort(); /*NOTREACHED*/
2908         }
2909
2910         return *prev;
2911 }
2912
2913 const TempoSection&
2914 TempoMap::tempo_section_at_beat_locked (const Metrics& metrics, const double& beat) const
2915 {
2916         TempoSection* prev_t = 0;
2917         const MeterSection* prev_m = &meter_section_at_beat_locked (metrics, beat);
2918
2919         for (Metrics::const_iterator i = metrics.begin(); i != metrics.end(); ++i) {
2920                 TempoSection* t;
2921                 if ((t = dynamic_cast<TempoSection*> (*i)) != 0) {
2922                         if (prev_t && ((t->pulse() - prev_m->pulse()) * prev_m->note_divisor()) + prev_m->beat() > beat) {
2923                                 break;
2924                         }
2925                         prev_t = t;
2926                 }
2927
2928         }
2929         return *prev_t;
2930 }
2931
2932 const TempoSection&
2933 TempoMap::tempo_section_at_pulse_locked (const Metrics& metrics, const double& pulse) const
2934 {
2935         TempoSection* prev_t = 0;
2936
2937         for (Metrics::const_iterator i = metrics.begin(); i != metrics.end(); ++i) {
2938                 TempoSection* t;
2939                 if ((t = dynamic_cast<TempoSection*> (*i)) != 0) {
2940                         if (prev_t && t->pulse() > pulse) {
2941                                 break;
2942                         }
2943                         prev_t = t;
2944                 }
2945
2946         }
2947         return *prev_t;
2948 }
2949
2950 /* don't use this to calculate length (the tempo is only correct for this frame).
2951    do that stuff based on the beat_at_frame and frame_at_beat api
2952 */
2953 double
2954 TempoMap::frames_per_beat_at (const framepos_t& frame, const framecnt_t& sr) const
2955 {
2956         Glib::Threads::RWLock::ReaderLock lm (lock);
2957
2958         const TempoSection* ts_at = &tempo_section_at_locked (_metrics, frame);
2959         const TempoSection* ts_after = 0;
2960         Metrics::const_iterator i;
2961
2962         for (i = _metrics.begin(); i != _metrics.end(); ++i) {
2963                 TempoSection* t;
2964
2965                 if ((t = dynamic_cast<TempoSection*> (*i)) != 0) {
2966                         if (!t->active()) {
2967                                 continue;
2968                         }
2969                         if ((*i)->frame() > frame) {
2970                                 ts_after = t;
2971                                 break;
2972                         }
2973                 }
2974         }
2975
2976         if (ts_after) {
2977                 return  (60.0 * _frame_rate) / (ts_at->tempo_at_frame (frame, _frame_rate));
2978         }
2979         /* must be treated as constant tempo */
2980         return ts_at->frames_per_beat (_frame_rate);
2981 }
2982
2983 const Tempo
2984 TempoMap::tempo_at_locked (const Metrics& metrics, const framepos_t& frame) const
2985 {
2986         TempoSection* prev_t = 0;
2987
2988         Metrics::const_iterator i;
2989
2990         for (i = _metrics.begin(); i != _metrics.end(); ++i) {
2991                 TempoSection* t;
2992                 if ((t = dynamic_cast<TempoSection*> (*i)) != 0) {
2993                         if (!t->active()) {
2994                                 continue;
2995                         }
2996                         if ((prev_t) && t->frame() > frame) {
2997                                 /* t is the section past frame */
2998                                 const double ret_bpm = prev_t->tempo_at_frame (frame, _frame_rate) * prev_t->note_type();
2999                                 const Tempo ret_tempo (ret_bpm, prev_t->note_type());
3000                                 return ret_tempo;
3001                         }
3002                         prev_t = t;
3003                 }
3004         }
3005
3006         const double ret = prev_t->beats_per_minute();
3007         const Tempo ret_tempo (ret, prev_t->note_type ());
3008
3009         return ret_tempo;
3010 }
3011
3012 const Tempo
3013 TempoMap::tempo_at (const framepos_t& frame) const
3014 {
3015         Glib::Threads::RWLock::ReaderLock lm (lock);
3016         return tempo_at_locked (_metrics, frame);
3017 }
3018
3019 const MeterSection&
3020 TempoMap::meter_section_at_locked (const Metrics& metrics, framepos_t frame) const
3021 {
3022         Metrics::const_iterator i;
3023         MeterSection* prev = 0;
3024
3025         for (i = metrics.begin(); i != metrics.end(); ++i) {
3026                 MeterSection* m;
3027
3028                 if ((m = dynamic_cast<MeterSection*> (*i)) != 0) {
3029
3030                         if (prev && (*i)->frame() > frame) {
3031                                 break;
3032                         }
3033
3034                         prev = m;
3035                 }
3036         }
3037
3038         if (prev == 0) {
3039                 fatal << endmsg;
3040                 abort(); /*NOTREACHED*/
3041         }
3042
3043         return *prev;
3044 }
3045
3046
3047 const MeterSection&
3048 TempoMap::meter_section_at (framepos_t frame) const
3049 {
3050         Glib::Threads::RWLock::ReaderLock lm (lock);
3051         return meter_section_at_locked (_metrics, frame);
3052 }
3053
3054 const MeterSection&
3055 TempoMap::meter_section_at_beat_locked (const Metrics& metrics, const double& beat) const
3056 {
3057         MeterSection* prev_m = 0;
3058
3059         for (Metrics::const_iterator i = metrics.begin(); i != metrics.end(); ++i) {
3060                 MeterSection* m;
3061                 if ((m = dynamic_cast<MeterSection*> (*i)) != 0) {
3062                         if (prev_m && m->beat() > beat) {
3063                                 break;
3064                         }
3065                         prev_m = m;
3066                 }
3067
3068         }
3069         return *prev_m;
3070 }
3071
3072 const MeterSection&
3073 TempoMap::meter_section_at_beat (double beat) const
3074 {
3075         Glib::Threads::RWLock::ReaderLock lm (lock);
3076         return meter_section_at_beat_locked (_metrics, beat);
3077 }
3078
3079 const Meter&
3080 TempoMap::meter_at (framepos_t frame) const
3081 {
3082         TempoMetric m (metric_at (frame));
3083         return m.meter();
3084 }
3085
3086 void
3087 TempoMap::fix_legacy_session ()
3088 {
3089         MeterSection* prev_m = 0;
3090         TempoSection* prev_t = 0;
3091
3092         for (Metrics::iterator i = _metrics.begin(); i != _metrics.end(); ++i) {
3093                 MeterSection* m;
3094                 TempoSection* t;
3095
3096                 if ((m = dynamic_cast<MeterSection*>(*i)) != 0) {
3097                         if (!m->movable()) {
3098                                 pair<double, BBT_Time> bbt = make_pair (0.0, BBT_Time (1, 1, 0));
3099                                 m->set_beat (bbt);
3100                                 m->set_pulse (0.0);
3101                                 m->set_frame (0);
3102                                 m->set_position_lock_style (AudioTime);
3103                                 prev_m = m;
3104                                 continue;
3105                         }
3106                         if (prev_m) {
3107                                 pair<double, BBT_Time> start = make_pair (((m->bbt().bars - 1) * prev_m->note_divisor())
3108                                                                           + (m->bbt().beats - 1)
3109                                                                           + (m->bbt().ticks / BBT_Time::ticks_per_beat)
3110                                                                           , m->bbt());
3111                                 m->set_beat (start);
3112                                 const double start_beat = ((m->bbt().bars - 1) * prev_m->note_divisor())
3113                                         + (m->bbt().beats - 1)
3114                                         + (m->bbt().ticks / BBT_Time::ticks_per_beat);
3115                                 m->set_pulse (start_beat / prev_m->note_divisor());
3116                         }
3117                         prev_m = m;
3118                 } else if ((t = dynamic_cast<TempoSection*>(*i)) != 0) {
3119
3120                         if (!t->active()) {
3121                                 continue;
3122                         }
3123
3124                         if (!t->movable()) {
3125                                 t->set_pulse (0.0);
3126                                 t->set_frame (0);
3127                                 t->set_position_lock_style (AudioTime);
3128                                 prev_t = t;
3129                                 continue;
3130                         }
3131
3132                         if (prev_t) {
3133                                 const double beat = ((t->legacy_bbt().bars - 1) * ((prev_m) ? prev_m->note_divisor() : 4.0))
3134                                         + (t->legacy_bbt().beats - 1)
3135                                         + (t->legacy_bbt().ticks / BBT_Time::ticks_per_beat);
3136                                 if (prev_m) {
3137                                         t->set_pulse (beat / prev_m->note_divisor());
3138                                 } else {
3139                                         /* really shouldn't happen but.. */
3140                                         t->set_pulse (beat / 4.0);
3141                                 }
3142                         }
3143                         prev_t = t;
3144                 }
3145         }
3146 }
3147
3148 XMLNode&
3149 TempoMap::get_state ()
3150 {
3151         Metrics::const_iterator i;
3152         XMLNode *root = new XMLNode ("TempoMap");
3153
3154         {
3155                 Glib::Threads::RWLock::ReaderLock lm (lock);
3156                 for (i = _metrics.begin(); i != _metrics.end(); ++i) {
3157                         root->add_child_nocopy ((*i)->get_state());
3158                 }
3159         }
3160
3161         return *root;
3162 }
3163
3164 int
3165 TempoMap::set_state (const XMLNode& node, int /*version*/)
3166 {
3167         {
3168                 Glib::Threads::RWLock::WriterLock lm (lock);
3169
3170                 XMLNodeList nlist;
3171                 XMLNodeConstIterator niter;
3172                 Metrics old_metrics (_metrics);
3173                 _metrics.clear();
3174
3175                 nlist = node.children();
3176
3177                 for (niter = nlist.begin(); niter != nlist.end(); ++niter) {
3178                         XMLNode* child = *niter;
3179
3180                         if (child->name() == TempoSection::xml_state_node_name) {
3181
3182                                 try {
3183                                         TempoSection* ts = new TempoSection (*child);
3184                                         _metrics.push_back (ts);
3185                                 }
3186
3187                                 catch (failed_constructor& err){
3188                                         error << _("Tempo map: could not set new state, restoring old one.") << endmsg;
3189                                         _metrics = old_metrics;
3190                                         break;
3191                                 }
3192
3193                         } else if (child->name() == MeterSection::xml_state_node_name) {
3194
3195                                 try {
3196                                         MeterSection* ms = new MeterSection (*child);
3197                                         _metrics.push_back (ms);
3198                                 }
3199
3200                                 catch (failed_constructor& err) {
3201                                         error << _("Tempo map: could not set new state, restoring old one.") << endmsg;
3202                                         _metrics = old_metrics;
3203                                         break;
3204                                 }
3205                         }
3206                 }
3207
3208                 if (niter == nlist.end()) {
3209                         MetricSectionSorter cmp;
3210                         _metrics.sort (cmp);
3211                 }
3212
3213                 /* check for legacy sessions where bbt was the base musical unit for tempo */
3214                 for (Metrics::const_iterator i = _metrics.begin(); i != _metrics.end(); ++i) {
3215                         TempoSection* t;
3216                         if ((t = dynamic_cast<TempoSection*> (*i)) != 0) {
3217                                 if (t->legacy_bbt().bars != 0) {
3218                                         fix_legacy_session();
3219                                         break;
3220                                 }
3221                                 break;
3222                         }
3223                 }
3224
3225                 /* check for multiple tempo/meters at the same location, which
3226                    ardour2 somehow allowed.
3227                 */
3228
3229                 Metrics::iterator prev = _metrics.end();
3230                 for (Metrics::iterator i = _metrics.begin(); i != _metrics.end(); ++i) {
3231                         if (prev != _metrics.end()) {
3232                                 MeterSection* ms;
3233                                 MeterSection* prev_m;
3234                                 TempoSection* ts;
3235                                 TempoSection* prev_t;
3236                                 if ((prev_m = dynamic_cast<MeterSection*>(*prev)) != 0 && (ms = dynamic_cast<MeterSection*>(*i)) != 0) {
3237                                         if (prev_m->pulse() == ms->pulse()) {
3238                                                 cerr << string_compose (_("Multiple meter definitions found at %1"), prev_m->pulse()) << endmsg;
3239                                                 error << string_compose (_("Multiple meter definitions found at %1"), prev_m->pulse()) << endmsg;
3240                                                 return -1;
3241                                         }
3242                                 } else if ((prev_t = dynamic_cast<TempoSection*>(*prev)) != 0 && (ts = dynamic_cast<TempoSection*>(*i)) != 0) {
3243                                         if (prev_t->pulse() == ts->pulse()) {
3244                                                 cerr << string_compose (_("Multiple tempo definitions found at %1"), prev_t->pulse()) << endmsg;
3245                                                 error << string_compose (_("Multiple tempo definitions found at %1"), prev_t->pulse()) << endmsg;
3246                                                 return -1;
3247                                         }
3248                                 }
3249                         }
3250                         prev = i;
3251                 }
3252
3253                 recompute_map (_metrics);
3254         }
3255
3256         PropertyChanged (PropertyChange ());
3257
3258         return 0;
3259 }
3260
3261 void
3262 TempoMap::dump (const Metrics& metrics, std::ostream& o) const
3263 {
3264         Glib::Threads::RWLock::ReaderLock lm (lock, Glib::Threads::TRY_LOCK);
3265         const MeterSection* m;
3266         const TempoSection* t;
3267         const TempoSection* prev_t = 0;
3268
3269         for (Metrics::const_iterator i = metrics.begin(); i != metrics.end(); ++i) {
3270
3271                 if ((t = dynamic_cast<const TempoSection*>(*i)) != 0) {
3272                         o << "Tempo @ " << *i << t->beats_per_minute() << " BPM (pulse = 1/" << t->note_type() << ") at " << t->pulse() << " frame= " << t->frame() << " (movable? "
3273                           << t->movable() << ')' << " pos lock: " << enum_2_string (t->position_lock_style()) << std::endl;
3274                         o << "current      : " << t->beats_per_minute() << " | " << t->pulse() << " | " << t->frame() << std::endl;
3275                         if (prev_t) {
3276                                 o << "previous     : " << prev_t->beats_per_minute() << " | " << prev_t->pulse() << " | " << prev_t->frame() << std::endl;
3277                                 o << "calculated   : " << prev_t->tempo_at_pulse (t->pulse()) *  prev_t->note_type() << " | " << prev_t->pulse_at_tempo (t->pulses_per_minute(), t->frame(), _frame_rate) <<  " | " << prev_t->frame_at_tempo (t->pulses_per_minute(), t->pulse(), _frame_rate) << std::endl;
3278                         }
3279                         prev_t = t;
3280                 } else if ((m = dynamic_cast<const MeterSection*>(*i)) != 0) {
3281                         o << "Meter @ " << *i << ' ' << m->divisions_per_bar() << '/' << m->note_divisor() << " at " << m->bbt() << " frame= " << m->frame()
3282                           << " pulse: " << m->pulse() <<  " beat : " << m->beat() << " pos lock: " << enum_2_string (m->position_lock_style()) << " (movable? " << m->movable() << ')' << endl;
3283                 }
3284         }
3285         o << "------" << std::endl;
3286 }
3287
3288 int
3289 TempoMap::n_tempos() const
3290 {
3291         Glib::Threads::RWLock::ReaderLock lm (lock);
3292         int cnt = 0;
3293
3294         for (Metrics::const_iterator i = _metrics.begin(); i != _metrics.end(); ++i) {
3295                 if (dynamic_cast<const TempoSection*>(*i) != 0) {
3296                         cnt++;
3297                 }
3298         }
3299
3300         return cnt;
3301 }
3302
3303 int
3304 TempoMap::n_meters() const
3305 {
3306         Glib::Threads::RWLock::ReaderLock lm (lock);
3307         int cnt = 0;
3308
3309         for (Metrics::const_iterator i = _metrics.begin(); i != _metrics.end(); ++i) {
3310                 if (dynamic_cast<const MeterSection*>(*i) != 0) {
3311                         cnt++;
3312                 }
3313         }
3314
3315         return cnt;
3316 }
3317
3318 void
3319 TempoMap::insert_time (framepos_t where, framecnt_t amount)
3320 {
3321         {
3322                 Glib::Threads::RWLock::WriterLock lm (lock);
3323                 for (Metrics::iterator i = _metrics.begin(); i != _metrics.end(); ++i) {
3324                         if ((*i)->frame() >= where && (*i)->movable ()) {
3325                                 (*i)->set_frame ((*i)->frame() + amount);
3326                         }
3327                 }
3328
3329                 /* now reset the BBT time of all metrics, based on their new
3330                  * audio time. This is the only place where we do this reverse
3331                  * timestamp.
3332                  */
3333
3334                 Metrics::iterator i;
3335                 const MeterSection* meter;
3336                 const TempoSection* tempo;
3337                 MeterSection *m;
3338                 TempoSection *t;
3339
3340                 meter = &first_meter ();
3341                 tempo = &first_tempo ();
3342
3343                 BBT_Time start;
3344                 BBT_Time end;
3345
3346                 // cerr << "\n###################### TIMESTAMP via AUDIO ##############\n" << endl;
3347
3348                 bool first = true;
3349                 MetricSection* prev = 0;
3350
3351                 for (i = _metrics.begin(); i != _metrics.end(); ++i) {
3352
3353                         BBT_Time bbt;
3354                         //TempoMetric metric (*meter, *tempo);
3355                         MeterSection* ms = const_cast<MeterSection*>(meter);
3356                         TempoSection* ts = const_cast<TempoSection*>(tempo);
3357                         if (prev) {
3358                                 if (ts){
3359                                         if ((t = dynamic_cast<TempoSection*>(prev)) != 0) {
3360                                                 if (!t->active()) {
3361                                                         continue;
3362                                                 }
3363                                                 ts->set_pulse (t->pulse());
3364                                         }
3365                                         if ((m = dynamic_cast<MeterSection*>(prev)) != 0) {
3366                                                 ts->set_pulse (m->pulse());
3367                                         }
3368                                         ts->set_frame (prev->frame());
3369
3370                                 }
3371                                 if (ms) {
3372                                         if ((m = dynamic_cast<MeterSection*>(prev)) != 0) {
3373                                                 pair<double, BBT_Time> start = make_pair (m->beat(), m->bbt());
3374                                                 ms->set_beat (start);
3375                                                 ms->set_pulse (m->pulse());
3376                                         }
3377                                         if ((t = dynamic_cast<TempoSection*>(prev)) != 0) {
3378                                                 if (!t->active()) {
3379                                                         continue;
3380                                                 }
3381                                                 const double beat = beat_at_pulse_locked (_metrics, t->pulse());
3382                                                 pair<double, BBT_Time> start = make_pair (beat, beats_to_bbt_locked (_metrics, beat));
3383                                                 ms->set_beat (start);
3384                                                 ms->set_pulse (t->pulse());
3385                                         }
3386                                         ms->set_frame (prev->frame());
3387                                 }
3388
3389                         } else {
3390                                 // metric will be at frames=0 bbt=1|1|0 by default
3391                                 // which is correct for our purpose
3392                         }
3393
3394                         // cerr << bbt << endl;
3395
3396                         if ((t = dynamic_cast<TempoSection*>(*i)) != 0) {
3397                                 if (!t->active()) {
3398                                         continue;
3399                                 }
3400                                 t->set_pulse (pulse_at_frame_locked (_metrics, m->frame()));
3401                                 tempo = t;
3402                                 // cerr << "NEW TEMPO, frame = " << (*i)->frame() << " beat = " << (*i)->pulse() <<endl;
3403                         } else if ((m = dynamic_cast<MeterSection*>(*i)) != 0) {
3404                                 bbt_time (m->frame(), bbt);
3405
3406                                 // cerr << "timestamp @ " << (*i)->frame() << " with " << bbt.bars << "|" << bbt.beats << "|" << bbt.ticks << " => ";
3407
3408                                 if (first) {
3409                                         first = false;
3410                                 } else {
3411
3412                                         if (bbt.ticks > BBT_Time::ticks_per_beat/2) {
3413                                                 /* round up to next beat */
3414                                                 bbt.beats += 1;
3415                                         }
3416
3417                                         bbt.ticks = 0;
3418
3419                                         if (bbt.beats != 1) {
3420                                                 /* round up to next bar */
3421                                                 bbt.bars += 1;
3422                                                 bbt.beats = 1;
3423                                         }
3424                                 }
3425                                 pair<double, BBT_Time> start = make_pair (beat_at_frame_locked (_metrics, m->frame()), bbt);
3426                                 m->set_beat (start);
3427                                 m->set_pulse (pulse_at_frame_locked (_metrics, m->frame()));
3428                                 meter = m;
3429                                 // cerr << "NEW METER, frame = " << (*i)->frame() << " beat = " << (*i)->pulse() <<endl;
3430                         } else {
3431                                 fatal << _("programming error: unhandled MetricSection type") << endmsg;
3432                                 abort(); /*NOTREACHED*/
3433                         }
3434
3435                         prev = (*i);
3436                 }
3437
3438                 recompute_map (_metrics);
3439         }
3440
3441
3442         PropertyChanged (PropertyChange ());
3443 }
3444 bool
3445 TempoMap::remove_time (framepos_t where, framecnt_t amount)
3446 {
3447         bool moved = false;
3448
3449         std::list<MetricSection*> metric_kill_list;
3450
3451         TempoSection* last_tempo = NULL;
3452         MeterSection* last_meter = NULL;
3453         bool tempo_after = false; // is there a tempo marker at the first sample after the removed range?
3454         bool meter_after = false; // is there a meter marker likewise?
3455         {
3456                 Glib::Threads::RWLock::WriterLock lm (lock);
3457                 for (Metrics::iterator i = _metrics.begin(); i != _metrics.end(); ++i) {
3458                         if ((*i)->frame() >= where && (*i)->frame() < where+amount) {
3459                                 metric_kill_list.push_back(*i);
3460                                 TempoSection *lt = dynamic_cast<TempoSection*> (*i);
3461                                 if (lt)
3462                                         last_tempo = lt;
3463                                 MeterSection *lm = dynamic_cast<MeterSection*> (*i);
3464                                 if (lm)
3465                                         last_meter = lm;
3466                         }
3467                         else if ((*i)->frame() >= where) {
3468                                 // TODO: make sure that moved tempo/meter markers are rounded to beat/bar boundaries
3469                                 (*i)->set_frame ((*i)->frame() - amount);
3470                                 if ((*i)->frame() == where) {
3471                                         // marker was immediately after end of range
3472                                         tempo_after = dynamic_cast<TempoSection*> (*i);
3473                                         meter_after = dynamic_cast<MeterSection*> (*i);
3474                                 }
3475                                 moved = true;
3476                         }
3477                 }
3478
3479                 //find the last TEMPO and METER metric (if any) and move it to the cut point so future stuff is correct
3480                 if (last_tempo && !tempo_after) {
3481                         metric_kill_list.remove(last_tempo);
3482                         last_tempo->set_frame(where);
3483                         moved = true;
3484                 }
3485                 if (last_meter && !meter_after) {
3486                         metric_kill_list.remove(last_meter);
3487                         last_meter->set_frame(where);
3488                         moved = true;
3489                 }
3490
3491                 //remove all the remaining metrics
3492                 for (std::list<MetricSection*>::iterator i = metric_kill_list.begin(); i != metric_kill_list.end(); ++i) {
3493                         _metrics.remove(*i);
3494                         moved = true;
3495                 }
3496
3497                 if (moved) {
3498                         recompute_map (_metrics);
3499                 }
3500         }
3501         PropertyChanged (PropertyChange ());
3502         return moved;
3503 }
3504
3505 /** Add some (fractional) beats to a session frame position, and return the result in frames.
3506  *  pos can be -ve, if required.
3507  */
3508 framepos_t
3509 TempoMap::framepos_plus_beats (framepos_t pos, Evoral::Beats beats) const
3510 {
3511         return frame_at_beat (beat_at_frame (pos) + beats.to_double());
3512 }
3513
3514 /** Subtract some (fractional) beats from a frame position, and return the result in frames */
3515 framepos_t
3516 TempoMap::framepos_minus_beats (framepos_t pos, Evoral::Beats beats) const
3517 {
3518         return frame_at_beat (beat_at_frame (pos) - beats.to_double());
3519 }
3520
3521 /** Add the BBT interval op to pos and return the result */
3522 framepos_t
3523 TempoMap::framepos_plus_bbt (framepos_t pos, BBT_Time op) const
3524 {
3525         Glib::Threads::RWLock::ReaderLock lm (lock);
3526
3527         BBT_Time pos_bbt = beats_to_bbt_locked (_metrics, beat_at_frame_locked (_metrics, pos));
3528         pos_bbt.ticks += op.ticks;
3529         if (pos_bbt.ticks >= BBT_Time::ticks_per_beat) {
3530                 ++pos_bbt.beats;
3531                 pos_bbt.ticks -= BBT_Time::ticks_per_beat;
3532         }
3533         pos_bbt.beats += op.beats;
3534         /* the meter in effect will start on the bar */
3535         double divisions_per_bar = meter_section_at_beat (bbt_to_beats_locked (_metrics, BBT_Time (pos_bbt.bars + op.bars, 1, 0))).divisions_per_bar();
3536         while (pos_bbt.beats >= divisions_per_bar + 1) {
3537                 ++pos_bbt.bars;
3538                 divisions_per_bar = meter_section_at_beat (bbt_to_beats_locked (_metrics, BBT_Time (pos_bbt.bars + op.bars, 1, 0))).divisions_per_bar();
3539                 pos_bbt.beats -= divisions_per_bar;
3540         }
3541         pos_bbt.bars += op.bars;
3542
3543         return frame_time_locked (_metrics, pos_bbt);
3544 }
3545
3546 /** Count the number of beats that are equivalent to distance when going forward,
3547     starting at pos.
3548 */
3549 Evoral::Beats
3550 TempoMap::framewalk_to_beats (framepos_t pos, framecnt_t distance) const
3551 {
3552         return Evoral::Beats (beat_at_frame (pos + distance) - beat_at_frame (pos));
3553 }
3554
3555 struct bbtcmp {
3556     bool operator() (const BBT_Time& a, const BBT_Time& b) {
3557             return a < b;
3558     }
3559 };
3560
3561 std::ostream&
3562 operator<< (std::ostream& o, const Meter& m) {
3563         return o << m.divisions_per_bar() << '/' << m.note_divisor();
3564 }
3565
3566 std::ostream&
3567 operator<< (std::ostream& o, const Tempo& t) {
3568         return o << t.beats_per_minute() << " 1/" << t.note_type() << "'s per minute";
3569 }
3570
3571 std::ostream&
3572 operator<< (std::ostream& o, const MetricSection& section) {
3573
3574         o << "MetricSection @ " << section.frame() << ' ';
3575
3576         const TempoSection* ts;
3577         const MeterSection* ms;
3578
3579         if ((ts = dynamic_cast<const TempoSection*> (&section)) != 0) {
3580                 o << *((const Tempo*) ts);
3581         } else if ((ms = dynamic_cast<const MeterSection*> (&section)) != 0) {
3582                 o << *((const Meter*) ms);
3583         }
3584
3585         return o;
3586 }