summaryrefslogtreecommitdiff
path: root/manual/xml/editing_concepts.xml
blob: 354ef8db956c8fea0c2b5076a9e770dee57eb239 (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
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
<?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-editing-concepts">
	<title>Editing Concepts</title>
	<para>
		In Ardour, "editing" describes the process of
	</para>

	<itemizedlist>
		<listitem>
			<para>
				making modifications to playlists. Recall that
				<glossterm linkend="gt-playlist">playlists</glossterm> are nothing more
				than lists of <glossterm linkend="gt-region">regions</glossterm> arranged
				over time.
			</para>
		</listitem>
		<listitem>
			<para>
				recording/modifying automation data
			</para>
		</listitem>
	</itemizedlist>

	<section id="editing-cut-copy-paste">
		<title> Cut/Copy/Paste </title>
		<para></para>
	</section>

	<section id="sn-snap-settings">
		<title>Snap Settings</title>
		<para>
			By default, when you move objects around, they move freely. There
			<emphasis>is</emphasis> a "granularity" to the motion, but it is a single
			audio frame (so typically on the order of 1/48000'th or 1/96000'th of a
			second), and at most zoom levels it will not be apparent in any way.
		</para>

		<para>
			However, this is not always the way you want to move some kinds of objects.
			If you are working with structured compositions that utilize traditional
			concepts of bars, beats, rythmn and so forth, you will often want to move
			regions so that that they always align to specific periodic time points
			that correspond to the start of a bar, or a beat etc. If you are working on
			a movie soundtrack, you may prefer to have regions always align to SMPTE
			frames, or perhaps even to whole seconds.
		</para>

		<para>
			Ardour provides a wide variety of "snap" settings. If any but "None" is
			selected, they define a grid of timepoints which will be used to "snap"
			object positions as they are dragged. The grid can be regular (as is the
			case if you choose "Beats", for example), or it can be completely irregular
			(if you choose "Marks", for example). It can even consist of a
			<emphasis>single</emphasis> timepoint (if you choose "Edit cursor", for
			example).
		</para>

		<variablelist>
			<title> Possible Snap Settings </title>
			<varlistentry>
				<term><guilabel>None</guilabel></term>
				<listitem>
					<para>
						no alignment used at all
					</para>
				</listitem>
			</varlistentry>

			<varlistentry>
				<term><guilabel> CD Frames</guilabel></term>
				<listitem>
					<para>
						align to 1/75th of a second intervals, as defined by the "Redbook" Audio
						CD standards
					</para>
				</listitem>
			</varlistentry>

			<varlistentry>
				<term><guilabel> SMPTE Frames</guilabel></term>
				<listitem>
					<para>
						align to whatever the current SMPTE frame interval is (defined in the
						options editor)
					</para>
				</listitem>
			</varlistentry>

			<varlistentry>
				<term><guilabel> SMPTE Seconds</guilabel></term>
				<listitem>
					<para>
						align to whole seconds, adjusted to account for any SMPTE start offset
					</para>
				</listitem>
			</varlistentry>

			<varlistentry>
				<term><guilabel> SMPTE Minutes</guilabel></term>
				<listitem>
					<para>
						align to whole minutes, adjust to account for any SMPTE start offset
					</para>
				</listitem>
			</varlistentry>

			<varlistentry>
				<term><guilabel> Seconds</guilabel></term>
				<listitem>
					<para>
						align to whole seconds
					</para>
				</listitem>
			</varlistentry>

			<varlistentry>
				<term><guilabel> Minutes</guilabel></term>
				<listitem>
					<para>
						align to whole minutes
					</para>
				</listitem>
			</varlistentry>

			<varlistentry>
				<term><guilabel> Beats/32</guilabel></term>
				<listitem>
					<para>
						align to 1/32 divisions of the beat
					</para>
				</listitem>
			</varlistentry>

			<varlistentry>
				<term><guilabel> Beats/16</guilabel></term>
				<listitem>
					<para>
						align to 1/16 divisions of the beat
					</para>
				</listitem>
			</varlistentry>

			<varlistentry>
				<term><guilabel> Beats/8</guilabel></term>
				<listitem>
					<para>
						align to 1/8 divisions of the beat
					</para>
				</listitem>
			</varlistentry>

			<varlistentry>
				<term><guilabel> Beats/4</guilabel></term>
				<listitem>
					<para>
						align to 1/4 divisions of the beat
					</para>
				</listitem>
			</varlistentry>

			<varlistentry>
				<term><guilabel> Beats/3</guilabel></term>
				<listitem>
					<para>
						align to 1/3 divisions of the beat
					</para>
				</listitem>
			</varlistentry>

			<varlistentry>
				<term><guilabel> Beats</guilabel></term>
				<listitem>
					<para>
						align to beats
					</para>
				</listitem>
			</varlistentry>

			<varlistentry>
				<term><guilabel> Bars</guilabel></term>
				<listitem>
					<para>
						align to the start of bars
					</para>
				</listitem>
			</varlistentry>

			<varlistentry>
				<term><guilabel> Marks</guilabel></term>
				<listitem>
					<para>
						align to the nearest mark of some kind
					</para>
				</listitem>
			</varlistentry>

			<varlistentry>
				<term><guilabel> Edit Cursor</guilabel></term>
				<listitem>
					<para>
						align to the current position of the edit cursor
					</para>
				</listitem>
			</varlistentry>

			<varlistentry>
				<term><guilabel> Region starts</guilabel></term>
				<listitem>
					<para>
						align to the nearest start of a region in the (first) selected track
					</para>
				</listitem>
			</varlistentry>

			<varlistentry>
				<term><guilabel> Region ends</guilabel></term>
				<listitem>
					<para>
						align to the nearest end of a region in the (first) selected track
					</para>
				</listitem>
			</varlistentry>

			<varlistentry>
				<term><guilabel> Region syncs</guilabel></term>
				<listitem>
					<para>
						align to the nearest region sync point in the (first) selected track
					</para>
				</listitem>
			</varlistentry>

			<varlistentry>
				<term><guilabel> Region bounds </guilabel></term>
				<listitem>
					<para>
						align to the nearest region start or end in the (first) selected track
					</para>
				</listitem>
			</varlistentry>
		</variablelist>

		<section id="changing-snap-settings">
			<title> To change snap settings </title>
			<para>
				Move the mouse pointer to the toolbar panel of the editor window. Click on
				the "expansion arrow" of the "Snap setting" chooser. This will popup a
				list of available snap settings. If necessary, scroll down to see your
				desired choice. Click on your choice in the list to dismiss it and make
				Ardour switch to the new setting.
			</para>

			<note>
				<para>
					Changing snap settings has <emphasis>no</emphasis> effect on the position
					of any existing region. Its effect is only on objects being moved.
				</para>
			</note>
			<tip>
				<para>
					The snap setting also affects moving the playhead, the edit cursor,
					loop/punch and location markers, and dragging/moving range selections.
				</para>
			</tip>
		</section>

		<section id="snap-mode">
			<title> Snap Mode </title>
			<para>
				There are two subtly different ways in which the snap setting can affect
				region motion:
			</para>

			<variablelist>
				<title></title>
				<varlistentry>
					<term>normal snap mode</term>
					<listitem>
						<para>
							regions can only be moved to positions defined by the snap setting. It
							is not possible to move them to intermediate positions.
						</para>
					</listitem>
				</varlistentry>

				<varlistentry>
					<term>magnetic snap mode</term>
					<listitem>
						<para>
							regions can still be moved to positions not defined by the setting, but
							they "stick" to the timepoints that are when dragged across them.
							Imagine that the timepoints and the regions are magnetic - or just try
							it and see.
						</para>
					</listitem>
				</varlistentry>
			</variablelist>

			<para>
				However, you can press the <emphasis>snap modifier</emphasis> key while
				dragging, and the snap setting will be ignored. By default, this is the
				key on your keyboard that generates <emphasis>Mod3</emphasis> , but you
				can modify this from the <emphasis>Options Editor</emphasis> keyboard tab.
			</para>
		</section>

		<section id="changing-snap-mode">
			<title> To change snap mode </title>
			<para>
				Move the mouse pointer to the toolbar panel of the editor window. Click on
				the "expansion arrow" of the "Snap mode" chooser. This will popup a list
				of available snap settings. If necessary, scroll down to see your desired
				choice. Click on your choice in the list to dismiss it and make Ardour
				switch to the new setting.
			</para>
		</section>
	</section>
<!--
	<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
		href="Some_Subsection.xml" />
	-->
</section>