3 title: Trimming Regions
6 <p class="fixme">Add images, description of mouse cursor changes that signal this type of editing</p>
8 Changing the <dfn>length</dfn> of a region is a very common editing
9 operation, often known as <dfn>trimming</dfn>. There are several ways
10 to accomplish this with Ardour, and some very useful specialized trimming
14 <h2>Drag-Trimming With the Mouse</h2>
16 In object mode, move the pointer near the beginning or end of the region.
17 The cursor will change to indicate that trimming is possible, and you then
18 <kbd class="mouse">Left</kbd>-drag the edge of the region.
21 Trimming will obey <a href="/editing-and-arranging/snap-to-the-grid/">Snap settings</a>.
24 <h2>Click Trimming With the Mouse</h2>
26 <kbd class="mouse">Left</kbd>-click in the colored bar at the bottom of a region.
27 If you are nearer to the start of a region, this will trim the start time to the
28 position of the pointer. If you are nearer to the end of a region, it will trim the
32 <h2>Keyboard Shortcuts for Trimming</h2>
34 There are several commands for region trimming. Some use the
35 <a href="/editing-and-arranging/edit-point">edit point</a> to determine where
36 to trim to. Some are not bound to any keys by default (but could be via the
40 <dl class="wide-table">
41 <dt><kbd class="menu">Region/trim-front</kbd> <kbd>j</kbd></dt>
42 <dd>Trim selected region(s) start to edit point.</dd>
43 <dt><kbd class="menu">Region/trim-end</kbd> <kbd>k</kbd></dt>
44 <dd>Trim selected region(s) end to edit point.</dd>
47 <h2 id="trimtonextprevious">Trim to Next/Previous Region</h2>
49 Sometimes you just want to extend the start or end of region so that it reaches
50 the end or start of an adjacent region. There is now an operation accessible
51 from the region context menu, under <kbd class="menu">Edit >Trim > Trim to
52 Next</kbd> or <kbd class="menu">Edit > Trim > Trim to Previous</kbd>. This
53 will extend the selected regions so they directly adjoin their neighbours, unless
54 their source files are not long enough, in which case they will be extended to the
55 maximum possible. Trim to Next will extend the end of the selected regions to the
56 start of the next region; Trim to Previous will extend the start of the selected
57 regions to the end of the previous region.
59 <dl class="wide-table">
60 <dt><kbd class="menu">Region/trim-to-previous-region</kbd> <kbd class="mod1">j</kbd></dt>
61 <dd>Trim the start of selected region(s) to the end of the previous
63 <dt><kbd class="menu">Region/trim-to-next-region</kbd> <kbd class="mod1">k</kbd></dt>
64 <dd>Trim the end of selected region(s) to the start of the following
68 <h2>Other Possible Commands for Trimming</h2>
70 These are not bound to any keys by default, but could be via the Keybindings
71 Editor. They can also be sent via OSC or other control protocols.
73 <dl class="wide-table">
74 <dt><kbd class="menu">Region/trim-region-to-loop</kbd></dt>
75 <dd>Trim region to match the current loop range.</dd>
76 <dt><kbd class="menu">Region/trim-region-to-punch</kbd></dt>
77 <dd>Trim region to match the current punch range.</dd>