Add a subchapter on cue markers

[ardour-manual] / include / vbap-panner.html

diff --git a/include/vbap-panner.html b/include/vbap-panner.html
index 909ded59b44f69ca30eb37c0dc1f71387b91cd10..1d89a43f3c92b725ac5726c9518944f75eb1fae7 100644 (file)
--- a/include/vbap-panner.html
+++ b/include/vbap-panner.html
@@ -1,8 +1,10 @@
 
 <p class="warning">
   Ardour's VBAP panner is currently in development, and its semantics may
-  change in the near future, possibly affecting your mixes. Please do not
-  rely on it for important production work while the dust settles.
+  change in the near future, possibly affecting mixes using it. It is advised not
+  to rely on it for important production work while the dust settles.<br/>
+  The Panner only works in fixed static mode, it does not support
+  automation playback.
 </p>
 <p>
   <dfn><abbr title="Vector-base Amplitude Panning">VBAP</abbr></dfn>
@@ -13,7 +15,7 @@
 
 <h2>Basic concepts</h2>
 <p>
-  VBAP was developed by Ville Pulkki at Aalto University, Helsinki, in 2001.
+  VBAP was developed by Ville Pulkki at Aalto University, Helsinki, in 1997.
   It works by distributing the signal to the speakers nearest to the desired
   direction with appropriate weightings, aiming to create a maximally sharp
   phantom source by using as few speakers as possible:
@@ -26,15 +28,15 @@
   <li>and three speakers in the general 3D case.</li>
 </ul>
 <p>
-  Thus, if you move the panner onto a speaker, you can be sure that only
-  this speaker will get any signal. This is handy when you need precise
-  1:1 routing.<br>
+  Thus, if the panner is moved onto a speaker, only this speaker will get any
+  signal. This is handy when precise 1:1 routing is needed.
+</p>
+<p>
   The drawback of VBAP is that a moving source will constantly change its
-  apparent sharpness, as it transitions between the three states mentioned
-  above.
+  apparent sharpness, as it transitions between the three states mentioned above.
 </p>
 <p>
-  A <dfn>horizontal</dfn> VBAP panner has one parameter, the <dfn>azimuth
+  An <dfn>horizontal</dfn> VBAP panner has one parameter, the <dfn>azimuth
   angle</dfn>. A <dfn>full-sphere</dfn> panner offers an additional
   <dfn>elevation angle</dfn> control.
 </p>
@@ -47,6 +49,14 @@
 </p>
 
 <h2>Speaker layout</h2>
+
+<figure class="right">
+  <img class="mini" src="/images/VBAP-panner-5.png" alt="The VBAP panner with 5 outputs">
+  <figcaption>
+    The VBAP panner with 5 outputs
+  </figcaption>
+</figure>
+
 <p>
   Each VBAP panner is specific to its <dfn>speaker layout</dfn>&mdash;the
   panner has
@@ -54,17 +64,24 @@
   implementation must therefore include the possibility to define this
   layout.
 </p>
-<a href="/images/VBAP-panner-5.png"><img src="/images/VBAP-panner-5.png" class="right" style="width:150px;" alt="The VBAP panner with 5 outputs"></a>
+
 <p>
   Ardour currently uses a simplified approach: if a track or bus has more
-  than two output channels (which implies stereo), it assumes that you
-  have N speakers distributed in a regular N-gon. That means that for
-  irregular layouts such as 5.1 or 7.1, the direction you dial in will
-  differ a bit from the actual auditory result, but you can still achieve
-  any desired spatialisation.
+  than two output channels (which implies stereo), it assumes that there are
+  N speakers distributed in a regular N-gon. That means that for
+  irregular layouts such as 5.1 or 7.1, the direction dialed in will
+  differ a bit from the actual auditory result, but any desired spatialisation
+  can still be achieved.
 </p>
-<h3>Experimental 3D VBAP</h3>
-<a href="/images/VBAP-panner-10.png"><img src="/images/VBAP-panner-10.png" class="right" style="width:150px;" alt="The VBAP panner with 10 outputs, in experimental 3D mode"></a>
+
+<h3 class="clear">Experimental 3D VBAP</h3>
+<figure class="right">
+  <img class="mini" src="/images/VBAP-panner-10.png" alt="The VBAP panner with 10 outputs, in experimental 3D mode">
+  <figcaption>
+    The VBAP panner with 10 outputs, in experimental 3D mode
+  </figcaption>
+</figure>
+
 <p>
   For tracks with 10 outputs, Ardour will currently assume a 3-dimensional
   speaker layout corresponding to Auro-3D 10.1, which is a horizontal 5.1
@@ -72,12 +89,18 @@
   "voice-of-god" speaker at the zenith.
 </p>
 
-<h2>N:M panning</h2>
-<a href="/images/VBAP-panner-4in5.png"><img src="/images/VBAP-panner-4in5.png" class="right" style="width:150px;" alt="The VBAP panner in 4 in, 5 out mode"></a>
+<h2 class="clear">N:M panning</h2>
+
+<figure class="right">
+  <img class="mini" src="/images/VBAP-panner-4in5.png" alt="The VBAP panner in 4 in, 5 out mode">
+  <figcaption>
+    The VBAP panner in 4 in, 5 out mode
+  </figcaption>
+</figure>
+
 <p>
   For tracks and busses with more than one input, Ardour will (for now) assume that
-  you wish to distribute the inputs symmetrically along the latitude around
+  the inputs are distributed symmetrically along the latitude around
   the panner direction. The width parameter controls the opening angle of
   the distribution sector.
 </p>
-