Updated the 'Metering in Ardour' page. Added a clearer to the template so that the...

[ardour-manual] / include / metering-in-ardour.html

diff --git a/include/metering-in-ardour.html b/include/metering-in-ardour.html
index 8dbe8c25e9fb7a17533252ed01083fe12f97a746..b5133afc4ed72cc650d7e574752e9dabc079de14 100644 (file)
--- a/include/metering-in-ardour.html
+++ b/include/metering-in-ardour.html
@@ -8,7 +8,7 @@
   at a single meter.
 </p>
 <p>
   at a single meter.
 </p>
 <p>

-  Yet, if you want to work in or with the broadcast industry, it is
+  Yet, in order to work in or with the broadcast industry, it is

   usually unavoidable to use meters.
 </p>
 <p>
   usually unavoidable to use meters.
 </p>
 <p>


@@ -19,7 +19,7 @@
   <li>When tracking, meters are used to ensure that the input
   signal does not <dfn>overload</dfn> and maintains reasonable
   <dfn>headroom</dfn>.</li>
   <li>When tracking, meters are used to ensure that the input
   signal does not <dfn>overload</dfn> and maintains reasonable
   <dfn>headroom</dfn>.</li>

-  <li>Meters offer a <dfn>quick visual indication</dfn> of a
+  <li>Meters offer a <dfn>quick visual indication</dfn> of an

   activity when working with a large number of tracks.</li>
   <li>During mixing, meters provide an rough estimate of the
   <dfn>loudness</dfn> of each track.</li>
   activity when working with a large number of tracks.</li>
   <li>During mixing, meters provide an rough estimate of the
   <dfn>loudness</dfn> of each track.</li>


@@ -46,9 +46,9 @@
   There are different metering standards, most of which are available in Ardour. In short:
 </p>
 
   There are different metering standards, most of which are available in Ardour. In short:
 </p>
 

-<dl>
-  <dt>Digital peak-meter</dt>
-  <dd>A <dfn>Digital Peak Meter</dfn> displays the absolute maximum signal
+<table class="dl">
+  <tr><th>Digital peak-meter</th>
+  <td>A <dfn>Digital Peak Meter</dfn> displays the absolute maximum signal

   of the raw audio PCM signal (for a given time). It is commonly used when
   tracking to make sure the recorded audio never clips. To that end, DPMs
   are always calibrated to 0&nbsp;<abbr title="DeciBel Full
   of the raw audio PCM signal (for a given time). It is commonly used when
   tracking to make sure the recorded audio never clips. To that end, DPMs
   are always calibrated to 0&nbsp;<abbr title="DeciBel Full


@@ -59,12 +59,12 @@
   exact specifications.
   <p>
   Various conventions for DPM fall-off times and dBFS line-up level can be
   exact specifications.
   <p>
   Various conventions for DPM fall-off times and dBFS line-up level can be

-  chosen in <kbd class="menu">Edit &gt; Preferences &gt; GUI</kbd>.
+  chosen in <kbd class="menu">Edit &gt; Preferences &gt; Metering</kbd>.

   </p>
   </p>

-  </dd>
+  </td></tr>

 
 

-  <dt>RMS meters</dt>
-  <dd>An <dfn><abbr title="Root Mean Square">RMS</abbr>-type meter</dfn>
+  <tr><th>RMS meters</th>
+  <td>An <dfn><abbr title="Root Mean Square">RMS</abbr>-type meter</dfn>

   is an averaging meter that looks at the energy in the signal. It
   provides a general indication of loudness as perceived by humans. Ardour
   features three RMS meters, all of which offer additonal peak indication.
   is an averaging meter that looks at the energy in the signal. It
   provides a general indication of loudness as perceived by humans. Ardour
   features three RMS meters, all of which offer additonal peak indication.


@@ -75,12 +75,12 @@
     <li><dfn>K14</dfn>: Same as K20 with scale aligned to -14&nbsp;dBFS.</li>
     <li><dfn>K12</dfn>: Same as K20 with scale aligned to -12&nbsp;dBFS (since 3.5.143).</li>
     <li><dfn>Peak + RMS</dfn>: standard RMS, customizable via
     <li><dfn>K14</dfn>: Same as K20 with scale aligned to -14&nbsp;dBFS.</li>
     <li><dfn>K12</dfn>: Same as K20 with scale aligned to -12&nbsp;dBFS (since 3.5.143).</li>
     <li><dfn>Peak + RMS</dfn>: standard RMS, customizable via

-    <kbd class="menu">Edit &gt; Preferences &gt; GUI &gt; Metering</kbd></li>
+    <kbd class="menu">Edit &gt; Preferences &gt; Metering</kbd></li>

   </ul>
   </ul>

-  </dd>
+  </td></tr>

 
 

-  <dt>IEC PPMs</dt>
-  <dd><dfn><abbr title="International Electrontechnical Commission">IEC</abbr>-type
+  <tr><th>IEC PPMs</th>
+  <td><dfn><abbr title="International Electrontechnical Commission">IEC</abbr>-type

   <abbr title="Peak Programme Meters">PPM</abbr>s</dfn> are a mix between DPMs and
   RMS meters, created mainly for the purpose of
   interoperability. Many national and institutional varieties exist (<abbr
   <abbr title="Peak Programme Meters">PPM</abbr>s</dfn> are a mix between DPMs and
   RMS meters, created mainly for the purpose of
   interoperability. Many national and institutional varieties exist (<abbr


@@ -103,23 +103,29 @@
   Their specification is very exact, and consquently, there are no
   customizable parameters.
   </p>
   Their specification is very exact, and consquently, there are no
   customizable parameters.
   </p>

-  </dd>
+  </td></tr>

 
 

-  <dt>VU meters</dt>
-  <dd><dfn><abbr title="Volume Unit">VU</abbr> meters</dfn> are the dinosaurs (1939)
+  <tr><th>VU meters</th>
+  <td><dfn><abbr title="Volume Unit">VU</abbr> meters</dfn> are the dinosaurs (1939)

   amongst the meters. They react very slowly, averaging out peaks.
   Their specification is very strict (300ms rise-time, 1&ndash;1.5% overshoot,
   flat frequency response). Ardour's VU meter adheres to that spec, but for
   visual consistency it is displayed as a bar-graph rather than needle-style
   (more below).
   amongst the meters. They react very slowly, averaging out peaks.
   Their specification is very strict (300ms rise-time, 1&ndash;1.5% overshoot,
   flat frequency response). Ardour's VU meter adheres to that spec, but for
   visual consistency it is displayed as a bar-graph rather than needle-style
   (more below).

-  </dd>
-</dl>
+  </td></tr>
+</table>

 
 <h2>Ardour Specifics</h2>
 
 
 <h2>Ardour Specifics</h2>
 

-<img class="right" src="/images/mixer-meter-context-menu.png" alt="mixer strip meter context menu" />
+<figure class="right">
+    <img src="/images/mixer-meter-context-menu.png" alt="mixer strip meter context menu">
+    <figcaption>
+      Mixer strip meter context menu
+    </figcaption>
+</figure>
+

 <p>
 <p>

-  Meters are available in various places in ardour:
+  Meters are available in various places in Ardour:

 </p>
 <ul>
   <li>The mixer window features fixed height meters for each <dfn>channel strip</dfn>.</li>
 </p>
 <ul>
   <li>The mixer window features fixed height meters for each <dfn>channel strip</dfn>.</li>


@@ -132,44 +138,52 @@
   They all share the same configuration and color-theme which is available in
   preferences and the theme-manager. Settings for the Peak and RMS+Peak meters
   as well as VU meter standards are found in
   They all share the same configuration and color-theme which is available in
   preferences and the theme-manager. Settings for the Peak and RMS+Peak meters
   as well as VU meter standards are found in

-  <kbd class="menu">Edit &gt; Preferences &gt; GUI &gt; Metering</kbd>.
+  <kbd class="menu">Edit &gt; Preferences &gt; Metering</kbd>.

 </p>
 </p>

+

 <p>
   The type of meter and the <dfn>metering point</dfn> (the place in the signal chain
   where the meter taps the signal) are configurable in the context menu of each meter.
 <p>
   The type of meter and the <dfn>metering point</dfn> (the place in the signal chain
   where the meter taps the signal) are configurable in the context menu of each meter.

-  Depending on the <kbd class="menu">Edit &gt; Preferences &gt; GUI &gt; Mixer
-  Strip</kbd> settings, the metering point is also accessible via a button in
-  each Mixer strip.
+  Depending on the <kbd class="menu">Edit &gt; Preferences &gt; Mixer</kbd> settings,
+  the metering point is also accessible via a button in each Mixer strip.

 </p>
 </p>

-<img class="right" src="/images/meter-preferences.png" alt="" />
+

 <p>
   Regardless of meter type and standard the meter display will highlight red if
   the signal on the given channel exceeds the configured peak threshold.
 </p>
 <p>
 <p>
   Regardless of meter type and standard the meter display will highlight red if
   the signal on the given channel exceeds the configured peak threshold.
 </p>
 <p>

-  <kbd class="mouse">Left</kbd> on the peak-indicator button resets the
+  <kbd class="mouse">Left</kbd> clicking on the peak-indicator button resets the

   <dfn>peak-hold indicator</dfn> of a single channel.<br>
   <dfn>peak-hold indicator</dfn> of a single channel.<br>

-  <kbd class="mod1 mouse">Left</kbd> resets a whole <dfn>group</dfn>, and<br/>
-  <kbd class="mod13 mouse">Left</kbd> resets all meters.
+  <kbd class="mod1 mouse">Left</kbd> clicking resets a whole <dfn>group</dfn>, and<br/>
+  <kbd class="mod13 mouse">Left</kbd> clicking resets all meters.

 </p>
 
 <h2>Overview of meter types</h2>
 
 </p>
 
 <h2>Overview of meter types</h2>
 

+<figure class="left">
+  <img class="mini" src="/images/meter-types-18.png" alt="Bar-graph meters in Ardour">
+  <figcaption>
+    Bar-graph meters in Ardour
+  </figcaption>
+</figure>
+
+<figure class="right">
+  <img class="mini" src="/images/needle-meters-18.png" alt="Needle-style meters as external LV2 plugins">
+  <figcaption>
+    Needle-style meters as external LV2 plugins
+  </figcaption>
+</figure>
+

 <p>
   The figure on the left shows all available meter-types in Ardour 3.4 when fed with a
   -18&nbsp;dBFS 1&nbsp;kHz sine wave.
 </p>
 
 <p>
   The figure on the left shows all available meter-types in Ardour 3.4 when fed with a
   -18&nbsp;dBFS 1&nbsp;kHz sine wave.
 </p>
 

-<img class="right" style="max-width:45%;height:400px;" src="/images/needle-meters-18.png"
-alt="Needle-style meters as external LV2 plugins" />
-<img style="max-width:45%; height:400px" src="/images/meter-types-18.png"
-alt="Bar-graph meters in Ardour" />
-

 <p>
 <p>

-  Due to layout concerns and consistent look&amp;feel all meters available in
+  Due to layout concerns and consistent look and feel all meters available in

   Ardour itself are bar-graph type meters. Corresponding needle-style
   meters&mdash;which take up more visual screen space&mdash;are available as
   LV2 plugins (see image on the right):
   <a href="https://github.com/x42/meters.lv2/">meters.lv2</a>.
 </p>
   Ardour itself are bar-graph type meters. Corresponding needle-style
   meters&mdash;which take up more visual screen space&mdash;are available as
   LV2 plugins (see image on the right):
   <a href="https://github.com/x42/meters.lv2/">meters.lv2</a>.
 </p>

-