manual/include/bbt-markers.html

<p>
  <dfn>BBT markers</dfn> allow resetting the timeline to a particular bar and
  beat. Most of the time a BBT marker will reset it to 1|1|0 (the very first
  beat of the very first bar) so that for each song in a multi-song session
  there would be a musical time origin. However it's entirely possible to reset
  to an arbitrary value such as 7|3|0.
</p>

<p>
  To create a new BBT marker, <kbd class="mod1n"></kbd>-click on the
  Bars:Beats ruler. This will open a dialog titled <kbd class="window">New Music
  Time</kbd> where you can name the marker and define what bar (left field) and
  beat (right field) this marker should reset the time to.
</p>

<figure>
  <img class="hdimage" src="/images/new-music-time.png" alt="New Music Time dialog">
  <figcaption>New Music Time dialog</figcaption>
</figure>

<p>
  The timeline grid and the ruler will be updated accordingly:
</p>

<figure>
  <img class="hdimage" src="/images/bbt-marker-resets-musical-time.png" alt="The BBT marker resets the musical time">
  <figcaption>The BBT marker resets the musical time</figcaption>
</figure>

<p>
  Dragging a BBT marker rigth or left will reset the musical time at a different
  position on the timeline.
</p>

<p>
  Right-clicking on a BBT marker opens a menu with two options:
  <kbd class="menu">Edit…</kbd> and <kbd class="menu">Remove</kbd>.
</p>

<p>
  Choosing <kbd class="menu">Edit…</kbd> opens the
  <kbd class="menu">Edit Musical Time</kbd> dialog where it's possible to rename
  the marker and set a different bar and/or beat to reset the musical time to:
</p>

<figure>
  <img class="hdimage" src="/images/edit-bbt-marker.png" alt="Edit Musical Time">
  <figcaption>The Edit Musical Time dialog</figcaption>
</figure>

<p>
  Choosing <kbd class="menu">Remove</kbd> deletes the marker.
</p>