X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=include%2Fworking-with-ardour-built-plugin-editors.html;h=811b627d2d3089b1a2e471773a330aff00b1a3d3;hb=081e7af0b6f6dec0ca685d3a538eacf20394c2cc;hp=57ad9ba33274249685e61cdbc62b63ee954852ec;hpb=2098e011e638b5c86c56e68df7757975fc4d728f;p=ardour-manual

diff --git a/include/working-with-ardour-built-plugin-editors.html b/include/working-with-ardour-built-plugin-editors.html
index 57ad9ba..811b627 100644
--- a/include/working-with-ardour-built-plugin-editors.html
+++ b/include/working-with-ardour-built-plugin-editors.html
@@ -1,26 +1,76 @@
 
 <p>
-  To view a plugin editor, double-click on the plugin within the 
-  <a href="/working-with-plugins/processor-box/">processor box</a>. 
+  The plugin editor can be shown by double-clicking on the plugin within the
+  <a href="@@processor-box">processor box</a>.
   A new window will appear showing the editor/GUI for the plugin.
-</p>  
+</p>
+
+<figure class="right">
+  <img class="mini" style="width:400px;" src="/images/exemple-plugin.png" alt="A generic plugin Editor (A-Eq)">
+  <figcaption>
+    A generic plugin Editor (A-Eq)
+    <ol>
+      <li>Parameters</li>
+      <li>Description</li>
+      <li>Analysis graph</li>
+    </ol>
+  </figcaption>
+</figure>
+
+<h2>Generic Plugin Editor</h2>
+
 <p>
   If a plugin does not have its own GUI, Ardour will construct a
-  <dfn>generic plugin editor</dfn> from a small set of common control 
-  elements. Ardour will do this even for plugins that have their 
-  own, if you disable <kbd class="menu">Edit &gt; Preferences &gt; 
-  GUI &gt; Use Plugins' own interface instead of Ardour's</kbd>
+  <dfn>generic plugin editor</dfn> from a small set of common control
+  elements. Ardour will do this even for plugins that have their
+  own, if <kbd class="menu">Edit &gt; Preferences &gt;
+  GUI &gt; Use Plugins' own interface instead of Ardour's</kbd> is disabled.
+</p>
+
+<p>
+  The generic UI can be temporarily switched to by <kbd class="mouse">right</kbd> clicking on
+  a processor and selecting <kbd class="menu">Edit with generic controls</kbd>.
+  This is necessary in order to access the <a href="@@automation">plugin
+  automation controls</a>.
+</p>
+
+<p>
+  In the generic UI, any controller can be reset to its default state by
+  <kbd class=mod3n></kbd><kbd class=mouse>Left</kbd>-clicking on it.
 </p>
+
+<h2>Analysis Graph</h2>
+
 <p>
-  You can temporarily switch to the generic UI by context-clicking on 
-  a processor and selecting <kbd
-  class="menu">Edit with generic controls</kbd>. This will be necessary to
-  access the <a href="/automation/">plugin automation controls</a>.
+  At the bottom of the generic plugin editor, clicking the arrow displays the
+  <dfn>Analysis Graph</dfn>.
 </p>
 <p>
-  In the generic UI, you can re-set any controller to its default by
-  <kbd class="mod3 mouse">Left</kbd>-clicking on it.
+  This graph displays:
 </p>
+<ul>
+  <li>the <span style="background-color:black; color:white;">transfer function</span> in white,</li>
+  <li>the <span style="background-color:black; color:red;">phase response</span> in red (optionnal),</li>
+  <li>the <span style="background-color:black; color:green;">post effect spectrum</span> in green.</li>
+</ul>
 
-  
+<p>
+  The <dfn>transfer function</dfn> plots the output amplitude of the plugin (considered
+  as a "black box") against its input amplitude, along the audio spectrum.
+</p>
+<p>
+  The <dfn>phase response</dfn>, that can be switched on or off using the
+  <kbd class="option">Show phase</kbd> checkbox, plots the phase of the
+  plugins output against its input phase, along the audio spectrum. The scale is
+  shown in <span style="background-color:black; color:yellow;">yellow</span> on
+  the right.
+</p>
+<p>
+  The green spectrum plots the <dfn>output signal spectrum</dfn>, after the plugin
+  (for tracks that have a signal on).
+</p>
+<p>
+  The <kbd class="menu">dB scale</kbd> selector in the bottom left allows to
+  change the vertical scale of the graphs.
+</p>