Add an entities file and include it in the templates.
[ardour.git] / manual / xml / editing_concepts.xml
1 <?xml version="1.0" standalone="no"?>
2
3 <!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4
5 ]>
6
7 <section id="sn-editing-concepts">
8   <title>Editing Concepts</title>
9   <para>
10     In Ardour, "editing" describes the process of
11   </para>
12
13   <itemizedlist>
14     <listitem>
15       <para>
16         making modifications to playlists. Recall that
17         <glossterm linkend="gt-playlist">playlists</glossterm> are nothing
18         more than lists of
19         <glossterm linkend="gt-region">regions</glossterm> arranged over
20         time.
21       </para>
22     </listitem>
23
24     <listitem>
25       <para>
26         recording/modifying automation data
27       </para>
28     </listitem>
29   </itemizedlist>
30
31   <section id="editing-cut-copy-paste">
32     <title> Cut/Copy/Paste </title>
33     <para></para>
34   </section>
35
36   <section id="sn-snap-settings">
37     <title>Snap Settings</title>
38     <para>
39       By default, when you move objects around, they move freely. There
40       <emphasis>is</emphasis> a "granularity" to the motion, but it is a
41       single audio frame (so typically on the order of 1/48000'th or
42       1/96000'th of a second), and at most zoom levels it will not be
43       apparent in any way.
44     </para>
45
46     <para>
47       However, this is not always the way you want to move some kinds of
48       objects. If you are working with structured compositions that utilize
49       traditional concepts of bars, beats, rythmn and so forth, you will
50       often want to move regions so that that they always align to specific
51       periodic time points that correspond to the start of a bar, or a beat
52       etc. If you are working on a movie soundtrack, you may prefer to have
53       regions always align to SMPTE frames, or perhaps even to whole
54       seconds.
55     </para>
56
57     <para>
58       Ardour provides a wide variety of "snap" settings. If any but "None"
59       is selected, they define a grid of timepoints which will be used to
60       "snap" object positions as they are dragged. The grid can be regular
61       (as is the case if you choose "Beats", for example), or it can be
62       completely irregular (if you choose "Marks", for example). It can even
63       consist of a <emphasis>single</emphasis> timepoint (if you choose
64       "Edit cursor", for example).
65     </para>
66
67     <variablelist>
68       <title> Possible Snap Settings </title>
69       <varlistentry>
70         <term><guilabel>None</guilabel></term>
71         <listitem>
72           <para>
73             no alignment used at all
74           </para>
75         </listitem>
76       </varlistentry>
77
78       <varlistentry>
79         <term><guilabel> CD Frames</guilabel></term>
80         <listitem>
81           <para>
82             align to 1/75th of a second intervals, as defined by the
83             "Redbook" Audio CD standards
84           </para>
85         </listitem>
86       </varlistentry>
87
88       <varlistentry>
89         <term><guilabel> SMPTE Frames</guilabel></term>
90         <listitem>
91           <para>
92             align to whatever the current SMPTE frame interval is (defined
93             in the options editor)
94           </para>
95         </listitem>
96       </varlistentry>
97
98       <varlistentry>
99         <term><guilabel> SMPTE Seconds</guilabel></term>
100         <listitem>
101           <para>
102             align to whole seconds, adjusted to account for any SMPTE start
103             offset
104           </para>
105         </listitem>
106       </varlistentry>
107
108       <varlistentry>
109         <term><guilabel> SMPTE Minutes</guilabel></term>
110         <listitem>
111           <para>
112             align to whole minutes, adjust to account for any SMPTE start
113             offset
114           </para>
115         </listitem>
116       </varlistentry>
117
118       <varlistentry>
119         <term><guilabel> Seconds</guilabel></term>
120         <listitem>
121           <para>
122             align to whole seconds
123           </para>
124         </listitem>
125       </varlistentry>
126
127       <varlistentry>
128         <term><guilabel> Minutes</guilabel></term>
129         <listitem>
130           <para>
131             align to whole minutes
132           </para>
133         </listitem>
134       </varlistentry>
135
136       <varlistentry>
137         <term><guilabel> Beats/32</guilabel></term>
138         <listitem>
139           <para>
140             align to 1/32 divisions of the beat
141           </para>
142         </listitem>
143       </varlistentry>
144
145       <varlistentry>
146         <term><guilabel> Beats/16</guilabel></term>
147         <listitem>
148           <para>
149             align to 1/16 divisions of the beat
150           </para>
151         </listitem>
152       </varlistentry>
153
154       <varlistentry>
155         <term><guilabel> Beats/8</guilabel></term>
156         <listitem>
157           <para>
158             align to 1/8 divisions of the beat
159           </para>
160         </listitem>
161       </varlistentry>
162
163       <varlistentry>
164         <term><guilabel> Beats/4</guilabel></term>
165         <listitem>
166           <para>
167             align to 1/4 divisions of the beat
168           </para>
169         </listitem>
170       </varlistentry>
171
172       <varlistentry>
173         <term><guilabel> Beats/3</guilabel></term>
174         <listitem>
175           <para>
176             align to 1/3 divisions of the beat
177           </para>
178         </listitem>
179       </varlistentry>
180
181       <varlistentry>
182         <term><guilabel> Beats</guilabel></term>
183         <listitem>
184           <para>
185             align to beats
186           </para>
187         </listitem>
188       </varlistentry>
189
190       <varlistentry>
191         <term><guilabel> Bars</guilabel></term>
192         <listitem>
193           <para>
194             align to the start of bars
195           </para>
196         </listitem>
197       </varlistentry>
198
199       <varlistentry>
200         <term><guilabel> Marks</guilabel></term>
201         <listitem>
202           <para>
203             align to the nearest mark of some kind
204           </para>
205         </listitem>
206       </varlistentry>
207
208       <varlistentry>
209         <term><guilabel> Edit Cursor</guilabel></term>
210         <listitem>
211           <para>
212             align to the current position of the edit cursor
213           </para>
214         </listitem>
215       </varlistentry>
216
217       <varlistentry>
218         <term><guilabel> Region starts</guilabel></term>
219         <listitem>
220           <para>
221             align to the nearest start of a region in the (first) selected
222             track
223           </para>
224         </listitem>
225       </varlistentry>
226
227       <varlistentry>
228         <term><guilabel> Region ends</guilabel></term>
229         <listitem>
230           <para>
231             align to the nearest end of a region in the (first) selected
232             track
233           </para>
234         </listitem>
235       </varlistentry>
236
237       <varlistentry>
238         <term><guilabel> Region syncs</guilabel></term>
239         <listitem>
240           <para>
241             align to the nearest region sync point in the (first) selected
242             track
243           </para>
244         </listitem>
245       </varlistentry>
246
247       <varlistentry>
248         <term><guilabel> Region bounds </guilabel></term>
249         <listitem>
250           <para>
251             align to the nearest region start or end in the (first) selected
252             track
253           </para>
254         </listitem>
255       </varlistentry>
256     </variablelist>
257
258     <section id="changing-snap-settings">
259       <title> To change snap settings </title>
260       <para>
261         Move the mouse pointer to the toolbar panel of the editor window.
262         Click on the "expansion arrow" of the "Snap setting" chooser. This
263         will popup a list of available snap settings. If necessary, scroll
264         down to see your desired choice. Click on your choice in the list to
265         dismiss it and make Ardour switch to the new setting.
266       </para>
267
268       <note>
269         <para>
270           Changing snap settings has <emphasis>no</emphasis> effect on the
271           position of any existing region. Its effect is only on objects
272           being moved.
273         </para>
274       </note>
275       <tip>
276         <para>
277           The snap setting also affects moving the playhead, the edit
278           cursor, loop/punch and location markers, and dragging/moving range
279           selections.
280         </para>
281       </tip>
282     </section>
283
284     <section id="snap-mode">
285       <title> Snap Mode </title>
286       <para>
287         There are two subtly different ways in which the snap setting can
288         affect region motion:
289       </para>
290
291       <variablelist>
292         <title></title>
293         <varlistentry>
294           <term>normal snap mode</term>
295           <listitem>
296             <para>
297               regions can only be moved to positions defined by the snap
298               setting. It is not possible to move them to intermediate
299               positions.
300             </para>
301           </listitem>
302         </varlistentry>
303
304         <varlistentry>
305           <term>magnetic snap mode</term>
306           <listitem>
307             <para>
308               regions can still be moved to positions not defined by the
309               setting, but they "stick" to the timepoints that are when
310               dragged across them. Imagine that the timepoints and the
311               regions are magnetic - or just try it and see.
312             </para>
313           </listitem>
314         </varlistentry>
315       </variablelist>
316
317       <para>
318         However, you can press the <emphasis>snap modifier</emphasis> key
319         while dragging, and the snap setting will be ignored. By default,
320         this is the key on your keyboard that generates
321         <emphasis>Mod3</emphasis> , but you can modify this from the
322         <emphasis>Options Editor</emphasis> keyboard tab.
323       </para>
324     </section>
325
326     <section id="changing-snap-mode">
327       <title> To change snap mode </title>
328       <para>
329         Move the mouse pointer to the toolbar panel of the editor window.
330         Click on the "expansion arrow" of the "Snap mode" chooser. This will
331         popup a list of available snap settings. If necessary, scroll down
332         to see your desired choice. Click on your choice in the list to
333         dismiss it and make Ardour switch to the new setting.
334       </para>
335     </section>
336   </section>
337 <!--
338         <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
339                 href="Some_Subsection.xml" />
340         -->
341 </section>