Add a subchapter on cue markers

[ardour-manual] / include / strip-silence-from-audio-regions.html

diff --git a/include/strip-silence-from-audio-regions.html b/include/strip-silence-from-audio-regions.html
index 641c546b5af3db533b8c4a603092a2c9df86198b..cf844d9f7c7d2ef1d980abaed572c6b6f5c6465f 100644 (file)
--- a/include/strip-silence-from-audio-regions.html
+++ b/include/strip-silence-from-audio-regions.html
@@ -1,18 +1,55 @@
+<figure>
+  <img src="/images/strip-silence-window.png" alt="The Strip Silence window">
+  <figcaption>
+    The Strip Silence window
+  </figcaption>
+</figure>
 
 <p>
-  From the region context menu, choose <kbd class="menu">Edit &gt; Strip
-  Silence</kbd> to detect silence (based on a user-chosen threshold in 
-  <abbr title="Decibels relative to Full Scale">dBFS</abbr>), split a 
-  region based on the boundaries of the silent segments, and remove the 
-  silence. You can also specify a minimum length for silence&mdash;useful
-  when editing very percussive material and just needing to 
-  automatically trim the ends of a region. The dialog looks like this:
+  The <dfn>Strip Silence</dfn> tool allows to remove the parts of one or multiple
+  regions that are below a user-defined silence threshold. It does <em>not</em>
+  destroy the underlying audio, but trims the regions according to the silence
+  threshold parameter. The edit applies to all selected regions, allowing batch
+  processing.
 </p>
-<img src="/images/a3_strip_silence.png" alt="strip silence dialog" />
+
+<p>
+  The window, accessible either through the <kbd class="menu">Region &gt; Edit &gt; Strip
+  Silence</kbd> menu or <kbd class="menu"><kbd class="mouse">right</kbd> click on a region
+  &gt; <em>Name_Of_The_Region</em> &gt; Edit &gt; Strip Silence</kbd>is made of:
+</p>
+
+<table class="dl">
+  <tr><th><dfn>Threshold</dfn></th>
+    <td>The audio level under which the audio is considered silent (in <abbr
+    title="Decibels relative to Full Scale">dBFS</abbr>)</td></tr>
+  <tr><th><dfn>Minimum length</dfn></th>
+    <td>A minimum number of samples for Ardour to create a split. Under this
+      number, the region won't be sliced</td></tr>
+  <tr><th><dfn>Fade length</dfn></th>
+    <td>Ardour adds fades, both in and out, to the trimmed regions, to the created
+      region (so the sliced regions are longer by both the in and out fades duration,
+      expressed in samples)</td></tr>
+  <tr><th>A progress bar</th>
+    <td>showing the time Ardour takes to compute the trimming based on the current
+      parameters</td></tr>
+</table>
+
 <p>
-  The edit applies to all selected regions, allowing batch processing. 
-  You can also see in the screenshot how the main editor window is used 
-  to show silent segments and report the number and durations of the 
-  shortest segments.
+  Changing any parameter in the window is reflected in the main editor: the silent
+  segments are highlighted and the number and durations of the shortest segments is
+  displayed, helping fine-tune the parameters.
+</p>
+
+<figure>
+  <img src="/images/strip-silence-audio.png" alt="strip silence: view of the audio">
+  <img src="/images/strip-silence-after.png" alt="strip silence: view of the audio after">
+  <figcaption>
+    Strip Silence : a view of the audio while changing the parameters, and after treatment
+  </figcaption>
+</figure>
+
+<p class="note">The minimum length for silence can be useful when editing very
+  percussive material and just needing to automatically trim the ends of a region.
 </p>