manual/xml/mouse_operations_object_mode.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-mouse-operations-object-mode">
   8   <title>Object Mode</title>
   9   <section id="sn-object-mode-region-operations">
  10     <title>Region Operations</title>
  11     <para>
  12       A region has several areas in its on-screen representation:
  13     </para>
  14
  15     <itemizedlist>
  16       <listitem>
  17         <para>
  18           the waveform (the majority of the region's display area, normally)
  19         </para>
  20       </listitem>
  21
  22       <listitem>
  23         <para>
  24           the trim bar (the colored bar below the waveform)
  25         </para>
  26       </listitem>
  27
  28       <listitem>
  29         <para>
  30           the name (in the trim bar, text)
  31         </para>
  32       </listitem>
  33
  34       <listitem>
  35         <para>
  36           the fade handles (small squares that default to the upper left +
  37           right corners)
  38         </para>
  39       </listitem>
  40
  41       <listitem>
  42         <para>
  43           the fade shape (filled or empty curves representing fade in + fade
  44           out)
  45         </para>
  46       </listitem>
  47
  48       <listitem>
  49         <para>
  50           the gain envelope (hidden by default)
  51         </para>
  52       </listitem>
  53     </itemizedlist>
  54
  55     <para>
  56       Mouse operations on each area will do different things.
  57     </para>
  58
  59     <table id="tbl-object-mode-region-operations">
  60       <title>Region Operations</title>
  61       <tgroup cols = "2">
  62         <colspec colnum="1" colname="Mouse Action" colwidth="1"/>
  63         <colspec colnum="2" colname="Result" colwidth= "2"/>
  64         <thead>
  65           <row>
  66             <entry>
  67               Mouse Action
  68             </entry>
  69
  70             <entry>
  71               Result
  72             </entry>
  73           </row>
  74         </thead>
  75         <tbody>
  76           <row>
  77             <entry>
  78               Button1 click on waveform
  79             </entry>
  80
  81             <entry>
  82               select region
  83             </entry>
  84           </row>
  85
  86           <row>
  87             <entry>
  88               <keycombo><keycap>Shift</keycap>
  89               <mousebutton>Button1</mousebutton> </keycombo> click
  90             </entry>
  91
  92             <entry>
  93               add region to selection, or deselect it if selected
  94             </entry>
  95           </row>
  96
  97           <row>
  98             <entry>
  99               <mousebutton>Button1</mousebutton> drag on "empty space"
 100             </entry>
 101
 102             <entry>
 103               rubber-band selection of regions
 104             </entry>
 105           </row>
 106
 107           <row>
 108             <entry>
 109               <keycombo><keycap>Ctrl</keycap><keycap>Alt</keycap>
 110               <mousebutton>Button1</mousebutton> </keycombo> drag on region
 111             </entry>
 112
 113             <entry>
 114               rubber-band selection of regions
 115             </entry>
 116           </row>
 117
 118           <row>
 119             <entry>
 120               <mousebutton>Button1</mousebutton> click in trim bar
 121             </entry>
 122
 123             <entry>
 124               set start of region
 125             </entry>
 126           </row>
 127
 128           <row>
 129             <entry>
 130               <mousebutton>Button2</mousebutton> click in trim bar
 131             </entry>
 132
 133             <entry>
 134               set end of region
 135             </entry>
 136           </row>
 137
 138           <row>
 139             <entry>
 140               <mousebutton>Button1</mousebutton> drag near ends of trim bar
 141             </entry>
 142
 143             <entry>
 144               adjust start/end of region
 145             </entry>
 146           </row>
 147
 148           <row>
 149             <entry>
 150               <keycombo><keycap>Ctrl</keycap>
 151               <mousebutton>Button1</mousebutton> </keycombo> drag in trim
 152               bar
 153             </entry>
 154
 155             <entry>
 156               move audio inside region
 157             </entry>
 158           </row>
 159
 160           <row>
 161             <entry>
 162               <mousebutton>Button1</mousebutton> drag
 163             </entry>
 164
 165             <entry>
 166               move region
 167             </entry>
 168           </row>
 169
 170           <row>
 171             <entry>
 172               <keycombo><keycap>Ctrl</keycap>
 173               <mousebutton>Button1</mousebutton> </keycombo> drag
 174             </entry>
 175
 176             <entry>
 177               copy region and move copy
 178             </entry>
 179           </row>
 180
 181           <row>
 182             <entry>
 183               <mousebutton>Button2</mousebutton> drag
 184             </entry>
 185
 186             <entry>
 187               fixed time move (for transfer to other tracks)
 188             </entry>
 189           </row>
 190
 191           <row>
 192             <entry>
 193               <keycombo><keycap>Ctrl</keycap>
 194               <mousebutton>Button2</mousebutton> </keycombo> drag
 195             </entry>
 196
 197             <entry>
 198               fixed time copy+move
 199             </entry>
 200           </row>
 201
 202           <row>
 203             <entry>
 204               <keycombo><keycap>Shift</keycap>
 205               <mousebutton>Button2</mousebutton> </keycombo> click
 206             </entry>
 207
 208             <entry>
 209               raise region
 210             </entry>
 211           </row>
 212
 213           <row>
 214             <entry>
 215               <keycombo><keycap>Alt</keycap><keycap>Shift</keycap>
 216               <mousebutton>Button2</mousebutton> </keycombo> click
 217             </entry>
 218
 219             <entry>
 220               lower region
 221             </entry>
 222           </row>
 223         </tbody>
 224       </tgroup>
 225     </table>
 226   </section>
 227
 228   <section id="object-mode-automation-operations">
 229     <title>Automation Operations</title>
 230     <para>
 231       In general Button2-drag will do a constrained drag: control points
 232       will stay at the same position in time if dragged up and down and they
 233       will stay at the same value if dragged sideways.
 234     </para>
 235
 236     <table id="tbl-object-mode-automation-operations">
 237       <title>Region Operations</title>
 238       <tgroup cols = "2">
 239         <colspec colnum="1" colname="Mouse Action" colwidth="1"/>
 240         <colspec colnum="2" colname="Result" colwidth= "2"/>
 241         <thead>
 242           <row>
 243             <entry>
 244               Mouse Action
 245             </entry>
 246
 247             <entry>
 248               Result
 249             </entry>
 250           </row>
 251         </thead>
 252         <tbody>
 253           <row>
 254             <entry>
 255               <mousebutton>Button1</mousebutton> click in automation track
 256             </entry>
 257
 258             <entry>
 259               add a new control point to the line
 260             </entry>
 261           </row>
 262
 263           <row>
 264             <entry>
 265               <mousebutton>Button1</mousebutton> drag in an automation track
 266             </entry>
 267
 268             <entry>
 269               rubber-band select control points
 270             </entry>
 271           </row>
 272
 273           <row>
 274             <entry>
 275               <mousebutton>Button1</mousebutton> drag on control point
 276             </entry>
 277
 278             <entry>
 279               move control point
 280             </entry>
 281           </row>
 282
 283           <row>
 284             <entry>
 285               <mousebutton>Button1</mousebutton> drag on line
 286             </entry>
 287
 288             <entry>
 289               move line segment vertically
 290             </entry>
 291           </row>
 292
 293           <row>
 294             <entry>
 295               <mousebutton>Button2</mousebutton> drag on control-point
 296             </entry>
 297
 298             <entry>
 299               constrained adjustment
 300             </entry>
 301           </row>
 302
 303           <row>
 304             <entry>
 305               <keycombo><keycap>Ctrl</keycap><mousebutton>Button1</mousebutton></keycombo>
 306               drag on control point
 307             </entry>
 308
 309             <entry>
 310               move control point+all later points move with the same time
 311               displacement
 312             </entry>
 313           </row>
 314
 315           <row>
 316             <entry>
 317               <keycombo><keycap>Ctrl</keycap><mousebutton>Button2</mousebutton></keycombo>
 318               drag on control point
 319             </entry>
 320
 321             <entry>
 322               constrained move control point + move all later points with
 323               the same time displacement
 324             </entry>
 325           </row>
 326         </tbody>
 327       </tgroup>
 328     </table>
 329   </section>
 330 <!--
 331         <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
 332                 href="Some_Subsection.xml" />
 333         -->
 334 </section>