Shamusworld >> Repos - ardour-manual/blob - include/basic-gui-operations.html

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