manual/include/which-regions-are-affected.html

45 lines
1.6 KiB
HTML
Raw Normal View History

<p>
2014-02-18 14:12:28 -05:00
This section explains the rules used to decide which regions are affected
2017-06-30 07:12:01 -04:00
by editing operations. They don't really have to be understood&mdash;hopefully
things will Just Work&mdash;but it may be useful eventually.
</p>
<p>
Editing operations in Ardour either operate on a single point in time
(<kbd class="menu">Split</kbd> being the obvious example) or on two
2014-02-18 14:12:28 -05:00
points (which can also be considered to be a range of sorts), <kbd
class="menu">Separate</kbd> is a good example of this.
</p>
<p>
Most operations will operate on the currently selected region(s), but if
no regions are selected, the region that the mouse is in will be used
instead. Single-point operations will generally pick a set of regions to
2014-02-18 14:12:28 -05:00
use based on the following rules:
</p>
<ul>
2017-06-30 07:12:01 -04:00
<li> If the <a href="@@edit-point-control">Edit Point</a> is <kbd class="menu">mouse</kbd>, then
<ul>
2014-02-18 14:12:28 -05:00
<li>if the mouse is over a selected region, or no region, use all selected
regions, or</li>
<li>if the mouse is over an unselected region, use just that region.</li>
</ul>
</li>
2017-06-30 07:12:01 -04:00
<li> For all other Edit Points
<ul>
<li>
2014-02-18 14:12:28 -05:00
use the selected regions <em>and</em> those that are both
under the edit position <em>and</em> on a selected track,
or on a track which is in the same active edit-enabled route group
as a selected region.
</li>
</ul>
</li>
2014-02-18 14:12:28 -05:00
</ul>
<p>
2017-06-30 07:12:01 -04:00
The rationale here for the two different rules is that the mouse Edit Point
is special in that its position indicates both a time and a track; the other
2017-06-30 07:12:01 -04:00
edit points (<kbd class="menu">Playhead</kbd>,<kbd class="menu">Marker</kbd>)
indicate a time only.
2014-02-18 14:12:28 -05:00
</p>