]> Shamusworld >> Repos - ardour-manual/blob - include/select-regions.html
Update Lua doc for 7.1
[ardour-manual] / include / select-regions.html
1
2 <p>
3   Many editing operations in Ardour require to first <dfn>select one or more
4   regions</dfn> to change them in some way. A single region,
5   or multiple regions can be selected, including regions in different tracks. When
6   a region is selected, it will appear in a darker color than unselected regions.
7 </p>
8 <p>
9   If a track is a member of a group that is active and has the
10   <kbd class="option">Select</kbd> property enabled, then Ardour will attempt to
11   match whatever selections is made in one track across every other track of the
12   group. See <a href="@@corresponding-regions-selection">Corresponding
13   Regions Selection</a> for more information on precisely how selections will be
14   propagated to other tracks.
15 </p>
16
17 <h2>Track Selection</h2>
18 <p>
19   Tracks are <dfn>selected</dfn> by clicking on the Track header at the left
20   of the Editor window. Multiple tracks can be selected with <kbd class="mod1
21   mouse">Left</kbd> clicks, or a range of consecutive tracks with <kbd
22   class="mod3 mouse">Left</kbd>.
23 </p>
24
25 <h2>Region Selection</h2>
26 <p>
27   Using the <a href="@@toolbox">Grab Mode tool</a>, <kbd class="mouse">left</kbd>
28   clicking on a region selects it. If <a href="@@toolbox">Smart mode</a> is
29   enabled, the lower half of the region must be clicked.
30 </p>
31
32 <h2>Deselecting a Region</h2>
33 <p>
34   Still using the <a href="@@toolbox">Grab Mode tool</a>, <kbd class="mouse mod1">Left</kbd>-clicking the region deselects it. If
35   <a href="@@toolbox">Smart mode</a> is enabled, the lower half of the region must be clicked.
36 </p>
37 <p>
38   Note that a <kbd class="mouse mod1">left</kbd> click simply toggles the
39   selected status of an object, so it can be used to select unselected regions
40   too.
41 </p>
42
43 <h2>Selecting Multiple Regions in a Track</h2>
44 <p>This can be achieved in different ways:</p>
45 <ul>
46   <li><kbd class="mouse mod1">Left</kbd>-clicking each region.</li>
47   <li>Dragging a rubberband box from an empty point in a track before the first
48     region to select to a point within or after the last region to select. Using
49     <kbd class="mouse mod1">left</kbd>-drag allows doing it multiple times.</li>
50   <li>If the regions are all adjacent to one another, clicking the first region
51     to select, then <kbd class="mouse mod3">Left</kbd>-clicking the last one.
52   </li>
53 </ul>
54
55 <h2>Selecting All Regions in a Track</h2>
56 <p>
57   The <kbd class="menu">Select &gt; Select All In Track</kbd> option in the context menu
58   (<kbd class="mouse">Right</kbd> click on the track) selects all the regions in the track at once.
59 </p>
60 <p>
61   See the <a href="@@track-context-menu">Track Context Menu</a>
62   for more information on other per-track selection operations that are available.
63 </p>
64
65 <h2>Selecting Multiple Regions Across Different Tracks</h2>
66 <p>
67   This can be achieved by a <kbd class="mouse mod1">left</kbd>-click or <kbd class="mouse
68   mod3">Left</kbd>-click on the regions to select.
69 </p>
70
71 <h2>Selecting a Region From the Region List</h2>
72 <p>
73   Clicking the name of the region in the <a href="@@the-region-list">Region List</a>.
74   selects it. This will do nothing for whole-file regions, since they do not exist
75   anywhere in a playlist or track.
76 </p>
77