]> Shamusworld >> Repos - ardour-manual/blob - include/working-with-ardour-built-plugin-editors.html
Meh, capitalization
[ardour-manual] / include / working-with-ardour-built-plugin-editors.html
1
2 <p>
3   The plugin editor can be shown by double-clicking on the plugin within the
4   <a href="@@processor-box">processor box</a>.
5   A new window will appear showing the editor/GUI for the plugin.
6 </p>
7
8 <figure class="right">
9   <img class="mini" style="width:400px;" src="/images/exemple-plugin.png" alt="A generic plugin Editor (A-Eq)">
10   <figcaption>
11     A generic plugin Editor (A-Eq)
12     <ol>
13       <li>Parameters</li>
14       <li>Description</li>
15       <li>Analysis graph</li>
16     </ol>
17   </figcaption>
18 </figure>
19
20 <h2>Generic Plugin Editor</h2>
21
22 <p>
23   If a plugin does not have its own GUI, Ardour will construct a
24   <dfn>generic plugin editor</dfn> from a small set of common control
25   elements. Ardour will do this even for plugins that have their
26   own, if <kbd class="menu">Edit &gt; Preferences &gt;
27   GUI &gt; Use Plugins' own interface instead of Ardour's</kbd> is disabled.
28 </p>
29
30 <p>
31   The generic UI can be temporarily switched to by <kbd class="mouse">right</kbd> clicking on
32   a processor and selecting <kbd class="menu">Edit with generic controls</kbd>.
33   This is necessary in order to access the <a href="@@automation">plugin
34   automation controls</a>.
35 </p>
36
37 <p>
38   In the generic UI, any controller can be reset to its default state by
39   <kbd class=mod3n></kbd><kbd class=mouse>Left</kbd>-clicking on it.
40 </p>
41
42 <h2>Analysis Graph</h2>
43
44 <p>
45   At the bottom of the generic plugin editor, clicking the arrow displays the
46   <dfn>Analysis Graph</dfn>.
47 </p>
48 <p>
49   This graph displays:
50 </p>
51 <ul>
52   <li>the <span style="background-color:black; color:white;">transfer function</span> in white,</li>
53   <li>the <span style="background-color:black; color:red;">phase response</span> in red (optional),</li>
54   <li>the <span style="background-color:black; color:green;">post effect spectrum</span> in green.</li>
55 </ul>
56
57 <p>
58   The <dfn>transfer function</dfn> plots the output amplitude of the plugin (considered
59   as a "black box") against its input amplitude, along the audio spectrum.
60 </p>
61 <p>
62   The <dfn>phase response</dfn>, that can be switched on or off using the
63   <kbd class="option">Show phase</kbd> checkbox, plots the phase of the
64   plugins output against its input phase, along the audio spectrum. The scale is
65   shown in <span style="background-color:black; color:yellow;">yellow</span> on
66   the right.
67 </p>
68 <p>
69   The green spectrum plots the <dfn>output signal spectrum</dfn>, after the plugin
70   (for tracks that have a signal on).
71 </p>
72 <p>
73   The <kbd class="menu">dB scale</kbd> selector in the bottom left allows to
74   change the vertical scale of the graphs.
75 </p>
76
77 <h2>MIDI instruments specificities</h2>
78
79 <figure>
80   <img src="/images/instrument_plugins-keyboard.png" alt="The MIDI keyboard in instruments plugins">
81   <figcaption>
82     The MIDI keyboard in instruments plugins
83   </figcaption>
84 </figure>
85
86 <p>
87   The generic UI provides, for all MIDI instruments plugins, a keyboard, that can
88   be used either with the mouse, or by using a QWERTY keyboard as a piano. Both the
89   channel and the velocity can be set above the keyboard.
90 </p>