Add foldback strip documentation

include/foldback-strip.html

@@ -0,0 +1,181 @@
+
+<figure class="right">
+    <img src="/images/foldback-gui.png" alt="The Foldback strip">
+    <figcaption>
+      The Foldback strip
+    </figcaption>
+</figure>
+
+<p>
+  The <dfn>Foldback section</dfn> is an optional feature that provides stage monitoring mixes.
+  Many times the main mix is used for this purpose is a setup with only the control room. However,
+  for a separate studio and multiple monitor mixes for in ear use, a separate set of foldback
+  buses provides that flexability.
+</p>
+<p>
+	These foldback buses may be mono for a stage monitor wedge or stereo to allow
+	inear or headphones to have different mixes for each ear, such as one's self in one
+	ear and the rest of the music in the other.
+</p>
+<p>
+  A foldback mixer strip can be created on the fly by creating a Foldback Bus in the same manner
+  as any other bus is created, from the 
+  <kbd class="menu">Track &gt; Add Track, Bus or VCA</kbd> Window. Once at least one
+  Foldback bus has been created, the Foldback strip will appear in the mixer window
+</p>
+<p>
+  The <kbd class="menu">View &gt; Mixer: Show Foldback Strip</kbd> checkbox will determine if the
+  Foldback strip is visible. The Foldback strip appears Just to the left of the Master strip in the
+  Mixer window. It comprises:
+</p>
+<ol>
+  <li>Previous and Next buttons</li>
+  <!--li>Detach/attach control. This separates the Foldback strip into its own floating window</li-->
+  <li>Hide button</li>
+  <li>Foldback bus name button</li>
+  <li>Invert button</li>
+  <li>Show sends button</li>
+  <li>Send controls</li>
+  <li>Bus pan control</li>
+  <li>Processor box</li>
+  <li>Listen button</li>
+  <li>Foldback bus level control</li>
+  <li>Foldback bus output routing</li>
+  <li>Comments button</li>
+</ol>
+
+<h2>Previous and Next</h2>
+
+<p>
+	The Previous button shows the previous Foldback bus in the Foldback strip.
+	The Next button shows the next Foldback strip. The button will be disabled
+	if there are no nore Foldback buses in that direction.
+</p>
+
+<h2>Hide</h2>
+<p>
+	The hide button hides the Foldback strip when not being adjusted.
+	The Foldback strip can be shown again from the main menu
+	<kbd class="menu">View &gt; Mixer: Show Foldback Strip</kbd> item.
+</p>
+
+<h2>Name button</h2>
+<p>
+	The name button shows the name of the current Foldback bus. It has two
+	menus the Foldback bus selection menu, activated with a mouse button 1
+	click and the context menu, activated with a mouse button 3 click. The
+	context menu has these items in it:
+</p>
+<ul>
+  <li><kbd class="menu">Comments</kbd> is the same as the Comments button
+  at the bottom of the strip</li>
+  <li><kbd class="menu">Outputs</kbd> shows the output routing grid</li>
+  <li><kbd class="menu">Save as a template</kbd> opens the template save
+  dialog. The template saved has the same number of channels and the same
+  processors but does not have any sends selected.</li>
+  <li><kbd class="menu">Rename</kbd> shows a rename dialog that allows the Foldback
+  bus name to be renamed</li>
+  <li><kbd class="menu">Active</kbd> toggles The active status of the current
+  Foldback bus</li>
+  <li><kbd class="menu">Protect Against Denormals</kbd> turns on denormal
+  protection for the current Foldback bus</li>
+  <li><kbd class="menu">Remove</kbd> will remove the current Foldback bus</li>
+</ul>
+
+<h2>Invert Buttons</h2>
+<p>
+	The invert buttons (one for each channel) invert the audio signal. This
+	may be useful in some situations for controlling feedback. However,
+	proper microphone and monitor placement or the use of head phones
+	or in ear monitoring will be more effective.
+</p>
+
+<h2>Show Sends</h2>
+<p>
+	Show sends allows the send levels and pan to be controlled from the
+	originating track by using the main fader for the track. The fader and
+	pan controls will change color to indicate this mode and the show sends
+	button will flash to indicate this mode. Changing the current Foldback
+	bus will disable this mode.
+</p>
+
+<h2>The Send Box</h2>
+<p>
+	The send box shows controls for each send. There is a context menu available
+	by clicking mouse button 3 anywhere in the send box.
+</p>
+<ul>
+  <li><kbd class="menu">Assign Selected Tracks</kbd> creates foldback sends on each
+  selected track that feed the current Foldback bus</li>
+  <li><kbd class="menu">Assign Selected Tracks and Buses</kbd> creates foldback sends on each
+  selected track and bus that feed the current Foldback bus</li>
+  <li><kbd class="menu">Copy track/bus gains to sends</kbd> Sets the gain on the send to be the
+  same as the gain of the track or bus the send comes from for the current
+  Foldback bus</li>
+  <li><kbd class="menu">Set sends gain to -inf</kbd> sets the gain on all sends
+  for the current Foldback bus to -inf (the lowest gain possible)</li>
+  <li><kbd class="menu">Set sends gain to 0dB</kbd> sets the gain on all sends
+  for the current Foldback bus to 0dB</li>
+</ul>
+
+<h3>The Send Control Block</h3>
+<p>
+	<img src="/images/foldback-send.png" alt="The Foldback send">
+</p>
+<p>
+	There is a send control block for every send to the current Foldback
+	bus. The Send control block features three controls:
+</p>
+<ul>
+	<li>The button which shows the Foldback bus' name, has an active "LED"
+	indicator and has a context menu (mouse button  3) with items for that
+	send</li>
+	<li>The knob, only present on a stereo Foldback bus, which controls
+	the pan azimuth</li>
+	<li>The horizontal slider which control the level input from that channel</li>
+</ul>
+<p>
+	The button LED can be clicked to enable or disable that send, the button
+	context menu is similar to the send box above but only for this send. It
+	also has a remove option to remove this send from the current foldback mix.
+</p>
+
+<h2>The Pan Control</h2>
+<p>
+	This is just like every other track or bus strip and works the same way.
+</p>
+
+<h2>The Processor Box</h2>
+<p>
+	This processor box is the same as on the other tracks and buses and allows
+	for adding things like reverb to the foldback mix without writing it to the track.
+	It would also be possible to add in sound from a reverb bus instead.
+</p>
+
+<h2>The Listen Button</h2>
+<p>
+	This is only available in PFL or AFL mode as it uses the same code as
+	the solo on other tracks and buses. It allows the control room monitor
+	or headphones to hear what the performer will hear in their monitor.
+</p>
+
+<h2>The Foldback Level Knob</h2>
+<p>
+	This controls the output level being sent to the stage monitor.
+</p>
+
+<h2>The Output Port Selector</h2>
+<p>
+	This is similar to the output selectors on the tracks and buses. It
+	differs in only a few ways. First it is never automatically connected.
+	A Foldback bus is always meant to be directly connected to an output
+	device and never to master or the monitor bus. The choices shown
+	Therefore reflect this.
+</p>
+<h2>The Comment Button</h2>
+<p>
+	Just like the track and bus comment button, this allows opening a
+	window to type in notes about the current foldback bus for future
+	reference.
+</p>
+

include/monitoring.html

@@ -8,4 +8,7 @@
   the input signal of all tracks that are armed for recording, and playing
   back the unarmed tracks.
 </p>
-
+<p>
+	Ardour also includes a <a href="@@foldback-strip">Foldback section</a>
+	to provide separate monitor mixes for each performer.
+</p>

include/the-view-menu.html

@@ -71,11 +71,13 @@
 
 	<tr><th>[] Show Editor Mixer</th><td>When checked, the selected tracks' mixer strip is displayed on the left of the editor window, allowing for a quick access to e.g. effects and routing</td></tr>
 	<tr><th>[] Show Editor List</th><td>In the Editor window, shows the <a href="@@editor-lists">Editor List</a>, giving access to a number of handy lists (regions, tracks, &hellip;)</td></tr>
-	<tr><th>[] Toggle Mixer List</th><td>In the Mixer view, shows the Mixer list, giving access to some handy lists (<a href="@@favorite-plugins-window">Favorite plugins</a>, <a href="@@strips-list">The Strip list</a>,&hellip;)</td></tr>
-	<tr><th>[] Toggle Monitor Section Visibility</th><td>If the <kbd class="option">Use monitoring section on this session</kbd> has been checked in the <a href="@@session-properties#properties-monitoring">Session Properties window</a>, shows or hides the Monitor Section in the Mixer</td></tr>
-	<tr><th>[] Show Measure Lines</th><td>If checked, in the Editor, shows a vertical white line at each measure start</td></tr>
 	<tr><th>[] Show Summary</th><td>If checked, in the Editor, shows the <a href="@@summary">Summary</a>, allowing a faster navigation in the session</td></tr>
 	<tr><th>[] Show Group Tabs</th><td>If checked, makes the groups visible as tabs on the left in the Editor, and on the top in the mixer</td></tr>
+	<!--tr><th>[] Show Measure Lines</th><td>If checked, in the Editor, shows a vertical white line at each measure start</td></tr-->
 	<tr><th>[] Show Marker Lines</th><td>If checked, each marker is extended across all the tracks in the editor with a line of the same color</td></tr>
+	<tr><th>[] Mixer: Show Mixer List</th><td>In the Mixer view, shows the Mixer list, giving access to some handy lists (<a href="@@favorite-plugins-window">Favorite plugins</a>, <a href="@@strips-list">The Strip list</a>,&hellip;)</td></tr>
+	<tr><th>[] Mixer: Show VCAs</th><td>In the Mixer view, shows the VCA Strips if there are any</td></tr>
+	<tr><th>[] Mixer: Show Monitor Section</th><td>If the <kbd class="option">Use monitoring section on this session</kbd> has been checked in the <a href="@@session-properties#properties-monitoring">Session Properties window</a>, shows or hides the Monitor Section in the Mixer</td></tr>
+	<tr><th>[] Mixer: Show Foldback Strip</th><td>In the Mixer view, shows the Foldback Strip if there are any</td></tr>
 </table>
 

master-doc.txt

@@ -622,6 +622,14 @@ uri: ardours-interface/the-master-bus-strip
 part: subchapter
 ---
 
+---
+title: Foldback Section
+include: foldback-strip.html
+link: foldback-strip
+uri: ardours-interface/foldback-strip
+part: chapter
+---
+
 ---
 title: Editor Tracks
 link: track-controls