summaryrefslogtreecommitdiff
path: root/manual/xml/automation.xml
blob: 81f5370b25f4ceb91e99a5f9d44f2ca2849f7d52 (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
<?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>