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