]> Shamusworld >> Repos - ardour-manual/blob - include/basic-gui-operations.html
Update Patchbay docs for 7.1
[ardour-manual] / include / basic-gui-operations.html
1
2 <p>
3   By default, Ardour will show helpful <dfn>tooltips</dfn> about the purpose
4   and use of each <abbr title="Graphical User Interface">GUI</abbr> element if
5   the pointer is positioned over it and hovered there for a short while. These
6   little pop-up messages can be a good way to discover the purpose of many
7   aspects of the GUI.
8 </p>
9
10 <p>
11   Pop-ups can also be distracting for experienced users, who may wish to
12   disable them via <kbd class="optoff">Edit &gt; Preferences &gt; GUI &gt; Show
13   tooltip if mouse hovers over a control</kbd>.
14 </p>
15
16 <h2>Selection Techniques</h2>
17
18 <p>
19   Ardour follows the conventions used by most other computer software
20   (including other DAWs) for <dfn>selecting objects</dfn> in the <abbr
21   title="Graphical User Interface">GUI</abbr>.
22 </p>
23
24 <h3>Selecting individual objects</h3>
25
26 <p>
27   Clicking on an object (sometimes on a particular part of its on-screen
28   representation) will select the object, and deselect other similar objects.
29 </p>
30
31 <h3>Selecting multiple (similar) objects</h3>
32
33 <p>
34   A <kbd class="mod1 mouse">left</kbd>-click on an object toggles its selected
35   status, so using <kbd class="mod1 mouse">left</kbd> on a series of objects
36   will select (or deselect) each one of them. A completely arbitrary set of
37   selections can be constructed with this technique.
38 </p>
39
40 <h3>Selecting a range of objects</h3>
41
42 <p>
43   In cases where the idea of "select all objects between this one and that one"
44   makes sense, select one object and then <kbd class="mod3
45   mouse">left</kbd>-click on another to select both of them as well as all objects in between.
46 </p>
47
48 <h3>Time range selection</h3>
49
50 <p>
51   To select a time <dfn>range</dfn> in the Editor, <kbd
52   class="mouse">Left</kbd>-click and drag the mouse. A <kbd class="mod1
53   mouse">Left</kbd> drag then lets you create other ranges and a <kbd
54   class="mod3 mouse">left</kbd>-click extends a range to cover a wider area.
55 </p>
56
57 <h3>Selection Undo</h3>
58
59 <p>
60   The set of objects (including time range) that are selected at any one time
61   is known as the selection. Each time an object is selected or deselected, the
62   new selection is stored in an undo/redo stack. This stack is cleared each
63   time the content of the timeline changes.
64 </p>
65
66 <p>
67   If a complex selection has been built up and then accidentally cleared it,
68   choosing <kbd class="menu">Edit &gt; Undo Selection Change</kbd> will restore
69   the previous selection. If a selection is undone and a return to the state
70   before the undo is desired, choosing <kbd class="menu">Edit &gt; Redo
71   Selection Change</kbd> will take the selection back to where it was before
72   <kbd class="menu">Edit &gt; Undo Selection Change</kbd> was chosen.
73 </p>
74
75 <h2>Cut and Paste Operations</h2>
76
77 <p>
78   The <dfn>clipboard</dfn> is a holder for various kinds of objects (regions,
79   control events, plugins) that is used during <dfn>cut-and-paste
80   operations</dfn>.
81 </p>
82
83 <h3>Cut</h3>
84
85 <p>
86   A <dfn>cut</dfn> operation removes selected objects and places them in the
87   clipboard. The existing contents of the clipboard are overwritten. The default
88   key binding is <kbd class="mod1">x</kbd>.
89 </p>
90
91 <h3>Copy</h3>
92
93 <p>
94   A <dfn>copy</dfn> of the selected objects are placed in clipboard. There is
95   no effect on the selected objects themselves. The existing contents of the
96   clipboard are overwritten. The default key binding is <kbd
97   class="mod1">c</kbd>.
98 </p>
99
100 <h3>Paste</h3>
101
102 <p>
103   The current contents of the clipboard are <dfn>paste</dfn>d (inserted) into
104   the session, using the current <dfn>edit point</dfn> as the destination. The
105   contents of the clipboard remain unchanged&mdash;the same item can be pasted
106   multiple times. The default key binding is <kbd class="mod1">v</kbd>.
107 </p>
108
109 <h2>Deleting Objects</h2>
110
111 <p>
112   Within the Editor window (and to some extent within the Mixer window too),
113   there are several techniques for <dfn>deleting</dfn> objects (regions,
114   control points, and more).
115 </p>
116
117 <h3>Using the mouse and keyboard</h3>
118
119 <p>
120   Select the object(s) to be deleted and then press the <kbd>Del</kbd> key.
121   This does <strong>not</strong> put the deleted object(s) in the clipboard, so
122   they cannot be pasted elsewhere.
123 </p>
124
125 <h3>Using normal cut and paste shortcuts</h3>
126
127 <p>
128   Select the object(s) and then press <kbd class="mod1">x</kbd>. This puts the
129   deleted object(s) in the clipboard so that they can be pasted elsewhere.
130 </p>
131
132 <h3>Using just the mouse</h3>
133
134 <p>
135   By default, <kbd class="mouse">Shift Right</kbd> will delete the clicked-upon
136   object. Like the <kbd>Del</kbd> key, this does <strong>not</strong> put the
137   deleted object(s) in the clipboard.
138 </p>
139
140 <p class="note">
141   The modifier and mouse button used for this can be controlled via <kbd
142   class="menu">Edit &gt; Preferences &gt; User Interaction &gt; Delete using
143   &hellip;</kbd>. Any modifier and mouse button combination can be used.
144 </p>
145
146 <h2>Undo/Redo for Editing</h2>
147
148 <p>
149   While editing, it sometimes happens that an unintended change is made, or a
150   choice is made that is later decided to be wrong. All changes to the
151   arrangement of session components (regions, control points) along the
152   timeline can be <dfn>undone</dfn> (and <dfn>redone</dfn> if necessary).
153 </p>
154
155 <p>
156   The default keybindings are <kbd class="mod1">Z</kbd> for Undo and <kbd
157   class="mod1">R</kbd> for Redo. These match the conventions of most other
158   applications that provide undo/redo.
159 </p>
160
161 <p>
162   Changes are also saved to the <dfn>session history</dfn> file, so that
163   undo/redo is possible even if the session is closed and reopened later, even
164   if Ardour is exited in between.
165 </p>
166
167 <p>
168   The maximum number of changes that can be undone can be configured under <kbd
169   class="menu">Edit &gt; Preferences &gt; Misc &gt; Undo</kbd>. The maximum
170   number of changes stored in the history file is a separate parameter, and can
171   also be set in the same place.
172 </p>
173
174 <p class="note">
175   In addition to the normal undo (which works only on actions that change the
176   timeline), there is a <dfn>visual undo</dfn> which will revert any command
177   that affects the display of the editor window. Its shortcut is <kbd
178   class="mod3">Z</kbd>. There is also an undo for selection; see "Selection
179   Techniques" above.
180 </p>
181