From: Alexandre Prokoudine <alexandre.prokoudine@gmail.com>
Date: Sat, 24 Sep 2022 00:21:06 +0000 (+0300)
Subject: Add initial bbt markers documentation
X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?p=ardour-manual;a=commitdiff_plain;h=36b8e96cb6621e647f1cb813fd838bd34f9040ce

Add initial bbt markers documentation
---

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>
diff --git a/master-doc.txt b/master-doc.txt
index ee93653..e7e22cd 100644
--- a/master-doc.txt
+++ b/master-doc.txt
@@ -1652,6 +1652,12 @@ link: techniques-for-working-with-tempo-and-meter
 part: subchapter
 ---
 
+---
+title: BBT markers
+include: bbt-markers.html
+link: bbt-markers
+part: subchapter
+---
 
 ---
 title: Mixing
diff --git a/source/images/bbt-marker-resets-musical-time.png b/source/images/bbt-marker-resets-musical-time.png
new file mode 100644
index 0000000..03a02ba
Binary files /dev/null and b/source/images/bbt-marker-resets-musical-time.png differ
diff --git a/source/images/new-music-time.png b/source/images/new-music-time.png
new file mode 100644
index 0000000..f559c89
Binary files /dev/null and b/source/images/new-music-time.png differ