From: Alexandre Prokoudine <alexandre.prokoudine@gmail.com>
Date: Wed, 27 Jul 2022 15:49:35 +0000 (+0300)
Subject: Meterbridge: add initital documentation
X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?p=ardour-manual;a=commitdiff_plain;h=b4372d815d3b8ed2506d3beb88f1604a1d3d38f0

Meterbridge: add initital documentation
---

diff --git a/include/meterbridge.html b/include/meterbridge.html
new file mode 100644
index 0000000..81ac0d3
--- /dev/null
+++ b/include/meterbridge.html
@@ -0,0 +1,62 @@
+<p>
+	Meterbridge is a compact view of all meters in a session. It is designed
+	to assist for large recording sessions, particularly live recording where
+	the amount of mics is too large to get a good overview of the entire session
+	in either the <kbd class="window">Mixer</kbd> or the
+	<kbd class="window">Recorder</kbd> window.
+</p>
+
+<figure>
+  <img style="width:50%;" src="/images/meterbridge.png" alt="Meterbridge window">
+  <figcaption>
+    Meterbridge window
+  </figcaption>
+</figure>
+
+<p>
+	By default, the Meterbridge window displays a meter per each track with
+	the track's name at the bottom and allows resetting the meter's peak
+	as well as arm a track for recording.
+</p>
+
+<p>
+	Each meter has a right-click menu to select the type of the meter.
+	Just like in the mixer channel view, tracks and regular audio busses default
+	to <kbd class="option">Peak (+6&nbsp;dBFS)</kbd> and the master bus defaults
+	to <kbd class="option">K14 (RMS)</kbd>. It's also possible to set the same
+	meter type to all same-type tracks.
+</p>	
+<p>
+	Additionally, it's possible to select the height of the track name panel
+	by right-clicking above it and selecting one of the options going from
+	Short to Venti (which is a coffee cup size reference).
+</p>
+
+<p>
+	Just like in the usual mixer channel view,
+	the <kbd class="button">Arm for Recording</kbd> button has a right-click
+	menu to enable rec-safe mode to avoid accidental recording to a track
+	of choice.
+</p>
+
+<p>
+	The set of readily available controls can be customized per each session
+	on the <kbd class="window">Meterbridge</kbd> page of the
+	<kbd class="window">Session Properties</kbd> dialog.
+</p>
+
+<p>
+	Additional controls include:
+</p>
+
+<ul>
+	<li>Mute button</li>
+	<li>Solo button</li>
+	<li>Monitor buttons</li>
+	<li>Fader as a gain knob</li>
+</ul>
+
+<p>
+	It's also possible to toggle visibility of MIDI tracks, busses,
+	and the master bus.
+</p>
\ No newline at end of file
diff --git a/master-doc.txt b/master-doc.txt
index 5d9678a..0cb91cc 100644
--- a/master-doc.txt
+++ b/master-doc.txt
@@ -1658,6 +1658,14 @@ uri: meters
 part: subchapter
 ---
 
+---
+title: Meterbridge
+include: meterbridge.html
+link: meterbridge
+uri: meterbridge
+part: subchapter
+---
+
 ---
 title: Signal Routing
 include: signal-routing.html
diff --git a/source/images/meterbridge.png b/source/images/meterbridge.png
new file mode 100644
index 0000000..ceaa2ed
Binary files /dev/null and b/source/images/meterbridge.png differ