Added chapter on gain envelopes.

include/automation.html

@@ -1,3 +1,220 @@
 
-<p class="fixme">Add content</p>
+<p class="fixme">This section requires some significant rework to fit as manaul content.</p>
+
+
+<p>
+  <strong>Automation</strong> is a way of dynamically changing audio processing parameters over time.
+</p>
+
+<p>
+  Up to now, we have used fixed values for various parameters of our Tracks (for example, a Track Fader set to -3.0 dB; or a Mono Panner set to 100% Left; etc.) These fixed values would apply for the entire Track throughout the whole Session.
+</p>
+
+<p>
+  But what if you would like these values to change over time in a pre-determined way? For example, you may want to have the Gain of a Track to gradually decrease over twenty seconds. Or you may want to make a sound move from Left to Right over two seconds.
+</p>
+
+<p>
+  This is accomplished with <strong>Automation</strong>. The Fader, Panning, and any of the parameters of the Plugins used in that Track can be automated. An automated parameter is displayed underneath the parent track in its own <strong>Automation Track</strong>. Automation data is visually represented as an <strong>Automation Line</strong>, made up of a number of <strong>Automation Points</strong>. Here’s how a track with Automation looks like:
+</p>
+
+<p><img src="/images/Ardour4_Automation_Fader_1.png" alt="automation1"></p>
+
+<p>
+  In the image above, the Automation Track called “<em>Fader</em>” is associated to the parent Track called “<em>Audio 1</em>”. The Automation Line controls Fader (volume) changes over time.
+</p>
+
+<h2>Creating a Fader Automation Line</h2>
+
+<p>
+  Let’s create a simple Fader Automation. Click the “<em>A</em>” button of a chosen track. A menu will appear, where you can select the parameter you would like to Automate. Choose “<em>Fader</em>”.
+</p>
+
+<p><img src="/images/Ardour4_Automation_Button.png" alt="automation2"></p>
+
+<p>
+  An Automation Track will then appear. Select the Draw Mode (shortcut “<em>D</em>”):
+</p>
+
+<p><img src="/images/Ardour4_EditModes_D.png" alt="automation3"></p>
+
+<p>
+  Now you can create Automation Points by clicking anywhere in the Automation Track. An Automation Line joins the Automation Points you add. The yellow number (-15.3 decibels in the image below) indicates the Gain level for the selected Automation Point.
+</p>
+
+<p><img src="/images/Ardour4_Automation_Fader_2.png" alt="automation3"></p>
+
+<h3>Automation States</h3>
+
+<p>
+  The Automation Curve will not play, however, until you set the Automation State to “<em>Play</em>”.
+</p>
+
+<p><img src="/images/Ardour4_Automation_Fader_3.png" alt="automation state"></p>
+
+<p>
+  <strong>Manual</strong>: When set to “<em>Manual</em>”, the Track will ignore any Automation data. It will just play with whatever volume is the Fader is set to. In this mode, you are able to move the Track Fader by hand to set a new fixed level. That’s the default behavior of a Track when it’s first created.
+</p>
+
+<p>
+  <strong>Play</strong>: When set to “<em>Play</em>”, the Track will automatically change the Gain levels following the Automation Curve drawn in the Automation Track. You will no longer be able to move the Track Fader by hand. During playback, you will see the Track Fader moving up and down according to the curve.
+</p>
+
+<p>
+  <strong>Write</strong> mode will continuously record user changes to the Automated parameter as the Transport plays, creating an Automation Line. For instance, you may start playback and then make real-time changes in gain using the Fader of your Track. All the changes you make will be written (recorded) as an Automation Line, which then you can play back later by switching the Automation Mode back to Play
+</p>
+
+<p>
+  <strong>Touch</strong> mode is similar to Write mode. Unlike Write mode though, Touch mode won’t record over existing Automation data unless the parameter is being changed.
+</p>
+
+<p>
+  If these concepts are new to you, focus now on just the first two modes (<em>Manual</em> and <em>Play</em>), and practice creating automation by drawing Automation Curves by hand.
+</p>
+
+<h2>Creating a Plugin for Automation</h2>
+
+<p>
+  You may add Automation to any Plugin which has already been added to a Track. In the example below, we have a “<strong>AM pitchshifter</strong>” Plugin added to a track.
+</p>
+
+<p><img src="/images/Ardour4_Automation_Plugin1.png" alt="pluginautomation1"></p>
+
+<p>
+  In order to select a Plugin parameter for Automation, click the button on the Track marked “<em>a</em>”. The menu will appear. Under “<em>Processor Automation</em>” you will find a listing of the Plugins you have added for that Track.
+</p>
+
+<p><img src="/images/Ardour4_Automation_Plugin2.png" alt="pluginautomation2"></p>
+
+<p>
+  Within each listed Plugin, you may choose which parameter you want to Automate from a list. In the example, we chose the parameter “<em>Pitch shift</em>” of the Plugin “<em>AM pitchshifter</em>”. An Automation Track for that parameter appears. Note that as you open several Automation Tracks, they will appear one after the other below the main parent Track.
+</p>
+
+<p>
+  Draw an automation curve for that parameter. Don’t forget to set the Automation State to “<em>Play</em>”.
+</p>
+
+<p><img src="/images/Ardour4_Automation_Plugin3.png" alt="pluginautomation3"></p>
+
+<p>
+  In the image above, the pitch shift of the sound is now changing over time, controlled by the curve.
+</p>
+
+<blockquote>
+  <p>TIP: You can hide an Automation Track by clicking on the “X” at the upper
+left corner of the Automation Track. Note that a hidden Automation Track
+continues to function even when it is not visible.</p>
+</blockquote>
+
+<h2>Adding Better Visual Resolution to Automation</h2>
+
+<p>
+  You can achieve a greater amount of vertical precision by increasing the height of the Automation Track. Move your cursor near the lower edge of the Automation Track. The pointer turns into a vertical double arrow. Drag it down to increase the height of the Automation Track. Notice that the parent Track and the Automation Track heights are independent, so while working in your Automation Curves you might set them up like this:
+</p>
+
+<p><img src="/images/Ardour4_Automation_Plugin4.png" alt="pluginautomation5"></p>
+
+<blockquote>
+  <p>TIP: Remember you can also Zoom In and Out to increase resolution in the horizontal axis.</p>
+</blockquote>
+
+<h2>Working with Automation Points</h2>
+
+<p>
+  There are several ways ways of adjusting Automation Points, depending on the editing mode you are in:
+</p>
+
+<ul>
+  <li>An Automation Point can be dragged in any direction with the mouse (works in Grab, Draw, and Edit modes).</li>
+  <li>To remove an Automation Point, hold down the “<em>Shift</em>” key while Right-Clicking on it (works in Grab, Draw, and Edit modes).</li>
+  <li>“<em>Control</em>” + <em>click</em> + <em>drag</em> moves the current point in any direction, and also all subsequent points horizontally only (works in Grab, Draw, and Edit modes).</li>
+  <li>Edit Mode only: any segment of the Automation Line between Automation Points may be dragged vertically, affecting both end points at once, without affecting their horizontal position. Simply click somewhere on the line between two points, and drag up and down.</li>
+  <li>How to delete multiple Automation Points at once (Grab Mode and Edit Mode only): select multiple Automation Points by dragging a box starting on the track background around the points. Then the selected points may be deleted by hitting “<em>Delete</em>” (<em>not</em> “<em>Backspace</em>”). If you are on a Mac and do not have a true “<em>Delete</em>” key, try “<em>Function</em>” + “<em>Backspace</em>”).</li>
+</ul>
+
+<p>
+  After an Automation Curve ends, its value will stay at that level for all subsequent regions, whether or not you have drawn a continuation of the curve.
+</p>
+
+<p><img src="/images/Ardour4_Automation_Fader_End.png" alt="end point"></p>
+
+<p>In the example above, the last point of the curve is at -23 decibels.
+ That same level will be kept for the remainder of the Track, even 
+though the line is not drawn until the end.</p>
+
+<h2>Moving Automation</h2>
+
+<p>
+  Moving a Region to a new location will automatically move the Automation data that might be aligned with it, as we can see in the following screen shots.
+</p>
+
+<p>Before moving:
+<img src="/images/Ardour4_Automation_Moving_1.png" alt="mv1"></p>
+
+<p>After moving:
+<img src="/images/Ardour4_Automation_Moving_2.png" alt="mv2"></p>
+
+<p>
+  You can change this behaviour if you like. In other words, if you want automation curves to <em>stay where they are</em> even when you move Regions around, go to Edit &gt; Preferences &gt; Editor and uncheck “Move relevant automation when audio regions are moved.”
+</p>
+
+<h2>Region-specific Gain Automation</h2>
+
+<p>
+  There is a way to create a gain automation directly bound to a Region. When you select Draw Mode, you should see a flat line on the top half of each Region rectangle:
+</p>
+
+<p><img src="/images/Ardour4_Automation_Region_Specific_1.png" alt="gain-automation"></p>
+
+<p>
+  Click directly on that line to create Automation points. These will be drawn directly on the Region itself, unlike Fader Automation which is drawn or recorded in the Automation track. Region Gain Automation is separate from, and in addition to, Fader Automation.
+</p>
+
+<p><img src="/images/Ardour4_Automation_Region_Specific_2.png" alt="gain-automation2"></p>
+
+<p>
+  As with the Automation Tracks, a <strong>Gain Automation Point</strong> can be dragged in any direction with the mouse. To remove a Gain Automation Point, hold down the “<em>Shift</em>” key while Right-Clicking on it.
+</p>
+
+<h3>Deactivating and Removing Gain Automation</h3>
+
+<p>
+  Gain Automation can be reset or deactivated from the Region context menu, which is reached by Right-Clicking on the Region.
+</p>
+
+<p><img src="/images/Ardour4_Automation_Gain_Tool_Reset.png" alt="gain-automation3"></p>
+
+<p>
+  Here, the Gain Automation is referred to as the <strong>Envelope</strong>.
+</p>
+
+<p>
+  “<em>Reset Envelope</em>” removes the Gain Automation Points you have drawn in the Region.
+</p>
+
+<p>
+  “<em>Envelope Active</em>” toggles the Gain Automation Envelope on and off.
+</p>
+
+<h3>When should I use Region Gain Automation or Track Fader Automation?</h3>
+
+<p>
+  As seen above, both are very similar. With practice you will notice situations in which one is more convenient than the other. Here are two examples:
+</p>
+
+<ul>
+  <li>If all you need to do is a little touch up (cut or boost gain) in a specific portion of a Region, and you are otherwise happy with the level for the Rest of the passage or entire track, use the Region-specific Automation.</li>
+</ul>
+
+<p><img src="/images/Ardour4_Automation_Region_Specific_2.png" alt="gain-example1"></p>
+
+<ul>
+  <li>If you have a more complex Track with crossfades over Regions, and/or need to shape a longer dynamic curve across several Regions on the same Track, use Fader Automation.</li>
+</ul>
+
+<p><img src="/images/Ardour4_Automation_Gain_Comparison.png" alt="gain-automation2"></p>
+
+<p>
+  The screenshot above shows a simple gradual fade starting from the first Region in the track, and ending at the last Region. It’s very straightforward to do this with Fader Automation, but but it would be much harder to do it using region-specific automation.
+</p>
 

include/fades-and-crossfades.html

@@ -1,2 +0,0 @@
-
-

include/gain-envelopes.html

@@ -0,0 +1,28 @@
+
+<figure class=right>
+<img src="/images/gain-envelope1.png" alt="Default gain envelope">
+<figcaption class=center>A typical gain envelope (green line).</figcaption>
+</figure>
+
+<p>
+  In Ardour, every <dfn>region</dfn> has a <dfn>gain envelope</dfn>, which is normally hidden. Clicking on the Draw tool will cause all the gain envelopes on all regions to show themselves; these will appear as green lines with square dots (<dfn>control points</dfn>) at the beginning and end of each region. The vertical axis represents gain, with the top of the region representing +6dB and the bottom representing approximately -170dB. By default, the line starts and ends at 0dB; the control points can be moved up and down to change the amount of gain at that point.
+</p>
+
+<p>
+  Gain follows the line between control points continuously during playback, and adjusts the gain for that region accordingly. It is completely automatic, unlike channel <a href="@@automation">automation</a>.
+</p>
+
+<h2 style="clear: both">Manipulating Gain Envelopes</h2>
+
+<p>
+  The default gain curve, by itself, is not very useful; in order to have more control over the shape of the gain envelope it is necessary to add extra control points. To add a control point to the envelope, click anywhere in the region where there are no existing control points; it will appear <em>on the line</em> at the X-axis of the mouse's current position in the region.
+</p>
+
+<figure class=center>
+<img src="/images/gain-envelope2.png" alt="Complex gain envelope">
+<figcaption class=center>A more complex gain envelope.</figcaption>
+</figure>
+
+<p>
+  Once added, a control point can be <kbd class=mouse>Left</kbd> clicked and dragged to the desired location. Hovering over a control point will show its current level in dB. To remove a control point, <kbd class=mouse>Left</kbd> click it and press <kbd>Delete</kbd>.
+</p>

include/mini-timeline.html

@@ -1,5 +1,5 @@
 
-<figure class=center>
+<figure class=right>
 <img src="/images/mini-timeline.png" alt="The Mini-Timeline">
 <figcaption class=center>The Mini-Timeline.</figcaption>
 </figure>

master-doc.txt

@@ -1508,17 +1508,17 @@ part: subchapter
 
 ---
 title: Fades and Crossfades
-link: fades-and-crossfades
-include: fades-and-crossfades.html
+link: create-region-fades-and-crossfades
+include: create-region-fades-and-crossfades.html
+uri: editing-and-arranging/create-region-fades-and-crossfades
 part: chapter
 ---
 
 ---
-title: Create Region Fades and Crossfades
-link: create-region-fades-and-crossfades
-include: create-region-fades-and-crossfades.html
-uri: editing-and-arranging/create-region-fades-and-crossfades
-part: subchapter
+title: Gain Envelopes
+link: gain-envelopes
+include: gain-envelopes.html
+part: chapter
 ---
 
 ---