X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;ds=inline;f=include%2Fbbt-markers.html;fp=include%2Fbbt-markers.html;h=1340010d8cfe80b96772ec8c5703815eb5848108;hb=36b8e96cb6621e647f1cb813fd838bd34f9040ce;hp=0000000000000000000000000000000000000000;hpb=9b274008fab5f841e2d529630e36f1e90304b030;p=ardour-manual

diff --git a/include/bbt-markers.html b/include/bbt-markers.html
new file mode 100644
index 0000000..1340010
--- /dev/null
+++ b/include/bbt-markers.html
@@ -0,0 +1,28 @@
+<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 'New Music Time' 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 style="width:50%;" width="50%" 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 style="width:50%;" width="50%" 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>