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     <para>
  68       Regions are a somewhat special case in that they may contain <emphasis>
  69       sync points</emphasis>. If a region contains a sync point, the region start
  70       position is ignored and the sync point is aligned to the grid. This allows
  71       you to align a 'hit point' to the desitred grid.
  72     </para>
  73
  74     <variablelist>
  75       <title> Possible Snap Settings </title>
  76       <varlistentry>
  77         <term><guilabel>None</guilabel></term>
  78         <listitem>
  79           <para>
  80             no alignment used at all
  81           </para>
  82         </listitem>
  83       </varlistentry>
  84
  85       <varlistentry>
  86         <term><guilabel> CD Frames</guilabel></term>
  87         <listitem>
  88           <para>
  89             align to 1/75th of a second intervals, as defined by the
  90             "Redbook" Audio CD standards
  91           </para>
  92         </listitem>
  93       </varlistentry>
  94
  95       <varlistentry>
  96         <term><guilabel> SMPTE Frames</guilabel></term>
  97         <listitem>
  98           <para>
  99             align to whatever the current SMPTE frame interval is (defined
 100             in the options editor)
 101           </para>
 102         </listitem>
 103       </varlistentry>
 104
 105       <varlistentry>
 106         <term><guilabel> SMPTE Seconds</guilabel></term>
 107         <listitem>
 108           <para>
 109             align to whole seconds, adjusted to account for any SMPTE start
 110             offset
 111           </para>
 112         </listitem>
 113       </varlistentry>
 114
 115       <varlistentry>
 116         <term><guilabel> SMPTE Minutes</guilabel></term>
 117         <listitem>
 118           <para>
 119             align to whole minutes, adjust to account for any SMPTE start
 120             offset
 121           </para>
 122         </listitem>
 123       </varlistentry>
 124
 125       <varlistentry>
 126         <term><guilabel> Seconds</guilabel></term>
 127         <listitem>
 128           <para>
 129             align to whole seconds
 130           </para>
 131         </listitem>
 132       </varlistentry>
 133
 134       <varlistentry>
 135         <term><guilabel> Minutes</guilabel></term>
 136         <listitem>
 137           <para>
 138             align to whole minutes
 139           </para>
 140         </listitem>
 141       </varlistentry>
 142
 143       <varlistentry>
 144         <term><guilabel> Beats/32</guilabel></term>
 145         <listitem>
 146           <para>
 147             align to 1/32 divisions of the beat
 148           </para>
 149         </listitem>
 150       </varlistentry>
 151
 152       <varlistentry>
 153         <term><guilabel> Beats/16</guilabel></term>
 154         <listitem>
 155           <para>
 156             align to 1/16 divisions of the beat
 157           </para>
 158         </listitem>
 159       </varlistentry>
 160
 161       <varlistentry>
 162         <term><guilabel> Beats/8</guilabel></term>
 163         <listitem>
 164           <para>
 165             align to 1/8 divisions of the beat
 166           </para>
 167         </listitem>
 168       </varlistentry>
 169
 170       <varlistentry>
 171         <term><guilabel> Beats/4</guilabel></term>
 172         <listitem>
 173           <para>
 174             align to 1/4 divisions of the beat
 175           </para>
 176         </listitem>
 177       </varlistentry>
 178
 179       <varlistentry>
 180         <term><guilabel> Beats/3</guilabel></term>
 181         <listitem>
 182           <para>
 183             align to 1/3 divisions of the beat
 184           </para>
 185         </listitem>
 186       </varlistentry>
 187
 188       <varlistentry>
 189         <term><guilabel> Beats</guilabel></term>
 190         <listitem>
 191           <para>
 192             align to beats
 193           </para>
 194         </listitem>
 195       </varlistentry>
 196
 197       <varlistentry>
 198         <term><guilabel> Bars</guilabel></term>
 199         <listitem>
 200           <para>
 201             align to the start of bars
 202           </para>
 203         </listitem>
 204       </varlistentry>
 205
 206       <varlistentry>
 207         <term><guilabel> Marks</guilabel></term>
 208         <listitem>
 209           <para>
 210             align to the nearest mark of some kind
 211           </para>
 212         </listitem>
 213       </varlistentry>
 214
 215       <varlistentry>
 216         <term><guilabel> Edit Cursor</guilabel></term>
 217         <listitem>
 218           <para>
 219             align to the current position of the edit cursor
 220           </para>
 221         </listitem>
 222       </varlistentry>
 223
 224       <varlistentry>
 225         <term><guilabel> Region starts</guilabel></term>
 226         <listitem>
 227           <para>
 228             align to the nearest start of a region in the (first) selected
 229             track
 230           </para>
 231         </listitem>
 232       </varlistentry>
 233
 234       <varlistentry>
 235         <term><guilabel> Region ends</guilabel></term>
 236         <listitem>
 237           <para>
 238             align to the nearest end of a region in the (first) selected
 239             track
 240           </para>
 241         </listitem>
 242       </varlistentry>
 243
 244       <varlistentry>
 245         <term><guilabel> Region syncs</guilabel></term>
 246         <listitem>
 247           <para>
 248             align to the nearest region sync point in the (first) selected
 249             track
 250           </para>
 251         </listitem>
 252       </varlistentry>
 253
 254       <varlistentry>
 255         <term><guilabel> Region bounds </guilabel></term>
 256         <listitem>
 257           <para>
 258             align to the nearest region start or end in the (first) selected
 259             track
 260           </para>
 261         </listitem>
 262       </varlistentry>
 263     </variablelist>
 264
 265     <section id="changing-snap-settings">
 266       <title> To change snap settings </title>
 267       <para>
 268         Move the mouse pointer to the toolbar panel of the editor window.
 269         Click on the "expansion arrow" of the "Snap setting" chooser. This
 270         will popup a list of available snap settings. If necessary, scroll
 271         down to see your desired choice. Click on your choice in the list to
 272         dismiss it and make Ardour switch to the new setting.
 273       </para>
 274
 275       <note>
 276         <para>
 277           Changing snap settings has <emphasis>no</emphasis> effect on the
 278           position of any existing region. Its effect is only on objects
 279           being moved.
 280         </para>
 281       </note>
 282       <tip>
 283         <para>
 284           The snap setting also affects moving the playhead, the edit
 285           cursor, loop/punch and location markers, and dragging/moving range
 286           selections.
 287         </para>
 288       </tip>
 289     </section>
 290
 291     <section id="snap-mode">
 292       <title> Snap Mode </title>
 293       <para>
 294         There are two subtly different ways in which the snap setting can
 295         affect region motion:
 296       </para>
 297
 298       <variablelist>
 299         <title></title>
 300         <varlistentry>
 301           <term>normal snap mode</term>
 302           <listitem>
 303             <para>
 304               regions can only be moved to positions defined by the snap
 305               setting. It is not possible to move them to intermediate
 306               positions.
 307             </para>
 308           </listitem>
 309         </varlistentry>
 310
 311         <varlistentry>
 312           <term>magnetic snap mode</term>
 313           <listitem>
 314             <para>
 315               regions can still be moved to positions not defined by the
 316               setting, but they "stick" to the timepoints that are when
 317               dragged across them. Imagine that the timepoints and the
 318               regions are magnetic - or just try it and see.
 319             </para>
 320           </listitem>
 321         </varlistentry>
 322       </variablelist>
 323
 324       <para>
 325         However, you can press the <emphasis>snap modifier</emphasis> key
 326         while dragging, and the snap setting will be ignored. By default,
 327         this is the key on your keyboard that generates
 328         <emphasis>Mod3</emphasis> , but you can modify this from the
 329         <emphasis>Options Editor</emphasis> keyboard tab.
 330       </para>
 331     </section>
 332
 333     <section id="changing-snap-mode">
 334       <title> To change snap mode </title>
 335       <para>
 336         Move the mouse pointer to the toolbar panel of the editor window.
 337         Click on the "expansion arrow" of the "Snap mode" chooser. This will
 338         popup a list of available snap settings. If necessary, scroll down
 339         to see your desired choice. Click on your choice in the list to
 340         dismiss it and make Ardour switch to the new setting.
 341       </para>
 342     </section>
 343   </section>
 344 <!--
 345         <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
 346                 href="Some_Subsection.xml" />
 347         -->
 348 </section>