summaryrefslogtreecommitdiff
path: root/manual/xml/automation.xml
blob: 0f19d0720ecd33102cbd14d5898cff7cd0af5470 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
<?xml version="1.0" standalone="no"?>

<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [

]>

<section id="sn-automation">
  <title>Automation</title>
  <para>
    This chapter will explain how to use Ardour's automation facilities to
    make editing and mixing your sessions more productive.
  </para>

  <section id="what-is-automation">
    <title> What is automation? </title>
    <para>
      Automation refers to Ardour's ability to remember changes you made to
      various parameters in the session, and at what point along the
      timeline playback had reached when you made them. Later, Ardour can
      make these changes happen automatically at the same point on the
      timeline, thus leaving your hands free to do something else. A typical
      practice when using automation is to work on one or two tracks while
      leaving others alone, recording the edits/changes. Once satisfied with
      the track(s), you can move on to adjust other tracks. As the overall
      mix changes, you can return to earlier tracks and adjust their
      existing automation.
    </para>
  </section>

  <section id="what-can-be-automated">
    <title> What can be automated? </title>
    <para>
      You can automate all changes to track/bus gain control, panning
      (currently only for stereo output) and all plugin parameters. Future
      versions of Ardour will allow automation of mute/solo controls,
      non-stereo panning, and send gain levels.
    </para>
  </section>

  <section id="automation-modes">
    <title> Automation Modes </title>
    <para>
      Each parameter that can be automated has a button available to control
      its state of automation. Each button can be used to put the parameter
      into one of 4 possible automation states:
    </para>

    <variablelist>
      <title></title>
      <varlistentry>
        <term>Off</term>
        <listitem>
          <para>
            No changes to the parameter are recorded, and any existing
            automation for the parameter is ignored. This is the default.
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>Play</term>
        <listitem>
          <para>
            Existing automation data controls the value of the parameter,
            and graphical/hardware editing of the value is disabled.
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>Write</term>
        <listitem>
          <para>
            All changes to the parameter are recorded as new automation
            data, overwriting any existing data for that point in time.
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>Touch</term>
        <listitem>
          <para>
            Existing automation data controls the value of the parameter,
            but new changes to the parameter are recorded, overwriting any
            existing data for that point in time.
          </para>
        </listitem>
      </varlistentry>
    </variablelist>
  </section>

  <section id="basic-automation-recording">
    <title> Basic Automation Recording </title>
    <section id="automation-recording-gain-and-pan">
      <title> Gain and Pan </title>
      <para>
        Each track/bus has two automation control buttons for gain and pan
        in its mixer strip. For each track/bus that you wish to automate,
        click on the relevant automation button. From the popup menu that
        appears (showing all automation states) choose
        <guibutton>Record</guibutton> . As long as the automation state
        remains in "Record", then any changes you make to gain or pan for
        that track/bus will be recorded.
      </para>
    </section>

    <section id="automation-recording-plugin-parameters">
      <title> Plugin Parameters </title>
      <para>
        Many plugins have many parameters that you might wish to play while
        recording gain automation, so Ardour offers independent control of
        recording changes to these parameters. You can access the controls
        in either of two ways:
      </para>

      <itemizedlist>
        <listitem>
          <para>
            open the plugin's editor window, and click on the appropriate
            automation control button. From the menu that pops up, choose
            <guibutton>Record</guibutton>
          </para>
        </listitem>

        <listitem>
          <para>
            make the automation track for this parameter visible (see
            plugin_automation_tracks on how to do this), and click on the
            automation control button in the track controls. From the menu
            that pops up, choose <guibutton>Record</guibutton> .
          </para>
        </listitem>
      </itemizedlist>

      <para>
        To record edits to the parameter, click on the appropriate
        <guibutton>arec</guibutton> button. As long as the button stays
        pressed, all edits to that parameter will be recorded.
      </para>
    </section>
  </section>

  <section id="basic-automation-playback">
    <title> Basic Automation Playback </title>
    <section id="automation-playback-gain-and-pan">
      <title> Gain and Pan </title>
      <para>
        Each track/bus has two automation control buttons for gain and pan
        in its mixer strip. For each track/bus where you want existing
        automation data to control gain and/or panning, click on the
        relevant automation button. From the popup menu that appears
        (showing all automation states) choose
        <guimenuitem>Play</guimenuitem>. As long as the automation state
        remains in <guimenuitem>Play</guimenuitem>, you can no longer
        control the gain and/or panning from the graphical user interface or
        an external hardware control surface.
      </para>
    </section>

    <section id="automation-playback-plugin-parameters">
      <title> Plugin Parameters </title>
      <para>
        For each plugin parameter you want controlled by automation data,
        you need to activate automation playback which can be done in one of
        two ways:
      </para>

      <itemizedlist>
        <listitem>
          <para>
            open the plugin's editor window, and click on the appropriate
            automation control button, and choose
            <guimenuitem>Play</guimenuitem> from the menu that pops up.
          </para>
        </listitem>

        <listitem>
          <para>
            make the automation track for this parameter visible (see
            plugin_automation_tracks on how to do this), and click on the
            automation control button in the track controls. Choose
            <guimenuitem>Play</guimenuitem> from the menu that pops up.
          </para>
        </listitem>
      </itemizedlist>

      <para>
        You also need to enable automation playback for the plugin itself.
        This needs to be done in the plugin's editor window by clicking on
        the automation button in the upper right corner. Without this step,
        the individual parameter buttons will not enable automation
        playback.
      </para>

      <para>
        The plugin automation button also allows you to globally disable
        automation control of all parameters by unsetting it (clicking it so
        that it is no longer "pressed"). This leaves the individual
        automation control buttons in whatever state they were already in,
        but it stops the use of automation data for all parameters. This can
        be useful if you have a hardware control surface, and have
        automation-playback-enabled several parameters. You can override the
        automation playback settings and manually control parameter values
        from the control surface without having to click on each parameter's
        automation control button individually.
      </para>
    </section>
  </section>

  <section id="editing-automation-data">
    <title> Editing Automation Data </title>
    <para>
      The editor window can display all automation data for a track. Each
      type of automation data is shown in its own "track" to make it easy to
      see the data, and to edit it.
    </para>
  </section>
<!--
	<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
		href="Some_Subsection.xml" />
	-->
</section>