X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=include%2Floudness-analyzer.html;h=2e6302a8c4914a8d76713207339dd1cb388b572f;hb=a61fbacdfcb7a76fe425fada61f49fc85751e47a;hp=7939a0368ffb3da9f730e59cf3071d3c2929e171;hpb=a9518e1f3e8e0f359443963037c987e4f67158e8;p=ardour-manual

diff --git a/include/loudness-analyzer.html b/include/loudness-analyzer.html
index 7939a03..2e6302a 100644
--- a/include/loudness-analyzer.html
+++ b/include/loudness-analyzer.html
@@ -1,13 +1,24 @@
 <p>
-  The Loudness Analyzer &amp; Normalizer is a tool that is useful at the
+  The Loudness Analyzer and Normalizer is a tool that is useful at the
   end of the mixing process to make the final audio file comply with
   different specs regarding loudness.
 </p>
 
+<p class="note">
+  This is a rather advanced mode. When using the Loudness Analyzer &amp;
+  Normalizer (or <dfn>LAN</dfn>), one has to make sure than normalization
+  is disabled when exporting.
+  <br>
+  In general, it is recommended to just use <a href="@@export-format-profiles">
+  automatic export normalization</a>, in the <a href="@@export-dialog">Export
+  dialog</a>. This can also produce results for multiple targets at the
+  same time.
+</p>
+
 <p>
   It is enabled by checking
   <kbd class="option">Enable master-bus output gain control</kbd> in the 
-  <a href="@@preferences#preferences-mixer">Preferences</a>.
+  <a href="@@preferences#preferences-signal_flow">Preferences</a>.
   The <a href="@@master-bus-strip">Master Bus strip</a> then shows a <kbd class="menu">LAN</kbd>
   button to start the analysis, and a volume slider that is the global gain
   that can be set either manually or by the loudness normalizer.
@@ -47,6 +58,23 @@
   </figcaption>
 </figure>
 
+<h2>The Loudness Graph</h2>
+
+<p>
+	At the top of the window, a loudness graph visually represents the
+	analysis. The x-axis represents the time, and the y-axis represents
+	the perceived loudness in <abbr title="Loudness Units referenced to 
+	Full Scale">LUFS</abbr>:
+</p>
+
+<ul>
+	<li><span style="color:green;">Integrated loudness</span> averaging the loudness on the whole session</li>
+	<li><span style="color:red;">Short loudness</span> using a sliding time window of 3 seconds</li>
+	<li><span style="color:blue;">Momentary loudness</span> using a sliding time window of 400 ms.</li>
+</ul>
+
+<h2>Normalization Parameters</h2>
+
 <p>
 	As loudness is a perceived sonic energy, and depends on the level, frequency,
 	duration and nature of the sound, this window allows to base the calculation
@@ -87,11 +115,7 @@
 		hence the correction to apply</li>
 </ul>
 
-<p>
-	At the top of the window, a <kbd>Show Graphical Analysis</kbd> button
-	allows to visually represent the analysis with a graph in a very similar
-	window to the one in the Post-<a href="@@export-dialog">Export</a> analysis.
-</p>
+<h2>Presets</h2>
 
 <p>
 	A selection of presets is offered to simplify the normalization. These
@@ -103,14 +127,13 @@
 		<tr><th>Parameter name: </th><th>dbFS </th><th>dBTP </th><th>LUFS </th><th>short</th><th>mom. </th><th>FS</th><th>TP  </th><th>int</th><th>sht </th><th>mom</th><th>maxIntg</th><th>notes</th></tr>
 	</thead>
 	<tbody>
-		<tr><th>-Analysis Only-	</th><td>false</td><td>false</td><td>false</td><td>false</td><td>false</td><td> 0</td><td> 0.0</td><td>  0</td><td>  0</td><td>  0</td><td>  0.0</td><td>-200.0</td></tr>
 		<tr><th>EBU R128		</th><td>false</td><td> true</td><td> true</td><td>false</td><td>false</td><td> 0</td><td>-1.0</td><td>-23</td><td>  0</td><td>  0</td><td>-22.5</td><td> -23.5</td></tr>
 		<tr><th>EBU R128 S1		</th><td>false</td><td> true</td><td> true</td><td> true</td><td>false</td><td> 0</td><td>-1.0</td><td>-23</td><td>-18</td><td>  0</td><td>-22.5</td><td> -23.5</td></tr>
 		<tr><th>ATSC A/85		</th><td>false</td><td> true</td><td> true</td><td> true</td><td>false</td><td> 0</td><td>-2.0</td><td>-24</td><td>  0</td><td>  0</td><td>-22.0</td><td> -26.0</td></tr>
 		<tr><th>AES Streaming	</th><td>false</td><td> true</td><td> true</td><td>false</td><td>false</td><td> 0</td><td>-1.0</td><td>-18</td><td>  0</td><td>  0</td><td>-16.0</td><td> -20.0</td></tr>
 		<tr><th>ASWG-R001 HOME	</th><td>false</td><td> true</td><td> true</td><td> true</td><td>false</td><td> 0</td><td>-1.0</td><td>-24</td><td>  0</td><td>  0</td><td>-22.0</td><td> -26.0</td></tr>
 		<tr><th>Digital Peak	</th><td> true</td><td>false</td><td>false</td><td>false</td><td>false</td><td> 0</td><td> 0.0</td><td>  0</td><td>  0</td><td>  0</td><td>  0.0</td><td>-200.0</td></tr>
-		<tr><th>CD				</th><td> true</td><td> true</td><td> true</td><td>false</td><td>false</td><td> 0</td><td>-0.1</td><td> -9</td><td>  0</td><td>  0</td><td>  0.0</td><td>-200.0</td></tr>
+		<tr><th>CD/DVD			</th><td> true</td><td> true</td><td> true</td><td>false</td><td>false</td><td> 0</td><td>-0.1</td><td> -9</td><td>  0</td><td>  0</td><td>  0.0</td><td>-200.0</td></tr>
 
 		<tr><th>Amazon Music	</th><td>false</td><td> true</td><td> true</td><td>false</td><td>false</td><td> 0</td><td>-2.0</td><td>-14</td><td>  0</td><td>  0</td><td> -9.0</td><td> -19.0</td></tr>
 		<tr><th>Apple Music		</th><td>false</td><td> true</td><td> true</td><td>false</td><td>false</td><td> 0</td><td>-1.0</td><td>-16</td><td>  0</td><td>  0</td><td>-15.0</td><td> -17.0</td></tr>
@@ -123,9 +146,24 @@
 </table>
 
 <p>
-	At the lower end of the window is a <em>Conformity Analysis</em> folding
-	info panel that is opened by clicking its title, and indicating, for each
-	of the presets above, if the corrected gain would fit the required values:
+	New presets can be created at will and saved/removed using the <kbd>Save</kbd>
+	and <kbd>Remove</kbd> buttons next to the preset choice. The Standard
+	presets listed above can not be removed or edited.   
+</p>
+
+<p>
+	The <kbd>Analysis Report</kbd> button allows to visually represent
+	the analysis with a graph in a very similar	window to the one in the
+	Post-<a href="@@export-dialog">Export</a> analysis.
+</p>
+
+<h2>The Conformity Analysis Panel</h2>
+
+
+<p>
+	At the lower right end of the window is a <em>Conformity Analysis</em>
+	info panel indicating, for each	of the presets above, if the corrected
+	gain would fit the required values:
 </p>
 <ul>
 	<li><span style="color:red;">&#10006;</span>: the signal is too loud</li>