Shamusworld >> Repos - ardour-manual/blob - include/using-the-mouse.html

   1
   2 <h2>Clicking</h2>
   3
   4 <p>
   5   Throughout this manual, the term <dfn>click</dfn> refers to the act of
   6   pressing and releasing the <kbd class="mouse">Left</kbd> mouse button. This
   7   action is used to select objects, activate buttons, turn choices on and off,
   8   pop up menus and so forth. On touch surfaces, it also corresponds to a
   9   single, one-finger tap on the GUI.
  10 </p>
  11
  12 <h2>Right Clicking</h2>
  13
  14 <p>
  15   The term <dfn>right-click</dfn> refers to the act of pressing and releasing
  16   the <kbd class="mouse">Right</kbd> mouse button. This action is used to pop
  17   up <dfn>context menus</dfn> (hence the term "context click", which will also
  18   be seen). It is also used by default in combination with the shift key to
  19   delete objects within the editor window.
  20 </p>
  21
  22 <p class="note mac">
  23   Some mice designed for use with Mac OS X may have only one button. By
  24   convention, pressing and holding the Control key while clicking is
  25   interpreted as a right-click by many applications.
  26 </p>
  27
  28 <h2>Middle Clicking</h2>
  29
  30 <p>
  31   A <dfn>middle-click</dfn> refers to the act of pressing and releasing the
  32   <kbd class="mouse">Middle</kbd> mouse button. Not all all mice have a middle
  33   click button (see the <a href="@@mouse">Mouse</a> chapter for details).
  34   Sometimes the scroll wheel acts as a clickable middle button. This action is
  35   used for time-constrained region copying and mapping MIDI bindings.
  36 </p>
  37
  38 <p class="note">
  39   Internally, your operating system may identify the mouse buttons as <kbd
  40   class="mouse">Button1</kbd>, <kbd class="mouse">Button2</kbd>, and <kbd
  41   class="mouse">Button3</kbd>, respectively. It may be possible to invert the
  42   order of buttons to accommodate left-handed users, or to re-assign them
  43   arbitrarily. This manual assumes the canonical order.
  44 </p>
  45
  46 <h2>Double Clicking</h2>
  47
  48 <p>
  49   A <dfn>double click</dfn> refers to two rapid press/release cycles on the
  50   leftmost mouse button. The time interval between the two actions that
  51   determines whether this is seen as two clicks or one double click is
  52   controlled by your system preferences, not by Ardour.
  53 </p>
  54
  55 <h2>Dragging</h2>
  56
  57 <p>
  58   A <dfn>drag</dfn> primarily refers to the act of pressing the leftmost mouse
  59   button, moving the mouse with the button held down, and then releasing the
  60   button. On touch surfaces, this term also corresponds to a single one-finger
  61   touch-move-release action.
  62 </p>
  63
  64 <p>
  65   Ardour also uses the middle mouse button for certain kinds of drags, which
  66   will be referred to as a <dfn>middle-drag</dfn>.
  67 </p>
  68
  69 <h2>Modifiers</h2>
  70
  71 <p>
  72   There are many actions in Ardour that can be carried out using a mouse button
  73   in combination with a <dfn>modifier key</dfn>. When the manual refers to <kbd
  74   class="mod1 mouse">Left</kbd>, it means that you should first press the <kbd
  75   class="mod1n"></kbd> key, carry out a left click while <kbd
  76   class="mod1n"></kbd> is held down, and then finally release the key.
  77 </p>
  78
  79 <p>
  80   Available modifiers depend on your platform:
  81 </p>
  82
  83 <h3>Linux Modifiers</h3>
  84
  85 <ul>
  86   <li><kbd>Ctrl</kbd> (Control)</li>
  87   <li><kbd>Shift</kbd></li>
  88   <li><kbd>Alt</kbd></li>
  89   <li><kbd>Mod2</kbd></li>
  90   <li><kbd>Mod3</kbd></li>
  91   <li><kbd>Mod4</kbd></li>
  92   <li><kbd>Mod5</kbd></li>
  93 </ul>
  94
  95 <p class=fixme>
  96   The following section is almost certainly wrong. Will need to be checked
  97   and rewritten asap.
  98 </p>
  99
 100 <p>
 101   Mod2 typically corresponds to the <kbd>NumLock</kbd> key on many systems.
 102   On most Linux systems, there are no keys that will function as modifiers
 103   Mod3, Mod4 or Mod5 by default, but they can be setup using
 104   <dfn>xmodmap(1)</dfn>. This can be rather useful.
 105 </p>
 106
 107 <h3>OS X Modifiers</h3>
 108
 109 <ul>
 110   <li><kbd>Cmd</kbd> (Command, "windmill")</li>
 111   <li><kbd>Ctrl</kbd> (Control)</li>
 112   <li><kbd>Alt</kbd>  (Option)</li>
 113   <li><kbd>Shift</kbd></li>
 114 </ul>
 115
 116 <h2>Scroll Wheel</h2>
 117
 118 <p>
 119   Ardour can make good use of a <dfn>scroll wheel</dfn> on the mouse (assuming
 120   it has one), which can be utilized for a variety of purposes. Scroll wheels
 121   generate vertical scroll events, <kbd class="mouse">&uArr;</kbd> (ScrollUp)
 122   and <kbd class="mouse">&dArr;</kbd> (ScrollDown). Some also emit horizontal
 123   events, <kbd class="mouse">&lArr;</kbd> (ScrollLeft) and <kbd
 124   class="mouse">&rArr;</kbd> (ScrollRight).
 125 </p>
 126
 127 <p>
 128   When appropriate, Ardour will differentiate between these two different
 129   scroll axes. Otherwise it will interpret ScrollDown and ScrollLeft as
 130   equivalent and similarly interpret ScrollUp and ScrollRight as equivalent.
 131 </p>
 132
 133 <p>
 134   Typically, scroll wheel input is used to adjust <dfn>continuous
 135   controls</dfn> such as faders and knobs, or to scroll vertically or
 136   horizontally inside a window.
 137 </p>
 138