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.
12 <h2>Right Clicking</h2>
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.
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.
28 <h2>Middle Clicking</h2>
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 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.
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.
46 <h2>Double Clicking</h2>
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.
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.
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>.
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.
80 Available modifiers depend on your platform:
83 <h3>Linux Modifiers</h3>
86 <li><kbd>Ctrl</kbd> (Control)</li>
87 <li><kbd>Shift</kbd></li>
88 <li><kbd>Alt</kbd></li>
89 <li><kbd>Win</kbd> (Super/Windows)</li>
92 <h3>OS X Modifiers</h3>
95 <li><kbd>Cmd</kbd> (Command, "windmill")</li>
96 <li><kbd>Ctrl</kbd> (Control)</li>
97 <li><kbd>Alt</kbd> (Option)</li>
98 <li><kbd>Shift</kbd></li>
101 <h2>Scroll Wheel</h2>
104 Ardour can make good use of a <dfn>scroll wheel</dfn> on the mouse (assuming
105 it has one), which can be utilized for a variety of purposes. Scroll wheels
106 generate vertical scroll events, <kbd class="mouse">⇑</kbd> (ScrollUp)
107 and <kbd class="mouse">⇓</kbd> (ScrollDown). Some also emit horizontal
108 events, <kbd class="mouse">⇐</kbd> (ScrollLeft) and <kbd
109 class="mouse">⇒</kbd> (ScrollRight).
113 When appropriate, Ardour will differentiate between these two different
114 scroll axes. Otherwise it will interpret ScrollDown and ScrollLeft as
115 equivalent and similarly interpret ScrollUp and ScrollRight as equivalent.
119 Typically, scroll wheel input is used to adjust <dfn>continuous
120 controls</dfn> such as faders and knobs, or to scroll vertically or
121 horizontally inside a window. In most <dfn>continuous control</dfn>
122 cases, holding down the <kbd>Ctrl</kbd> key while scrolling will use
123 "fine" mode and the scroll wheel increments will then be 10% of normal.