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