Shamusworld >> Repos - ardour-manual/blob - include/which-regions-are-affected.html

   1
   2 <p>
   3   This section explains the rules used to decide which regions are affected
   4   by editing operations. They don't really have to be understood&mdash;hopefully
   5   things will Just Work&mdash;but it may be useful eventually.
   6 </p>
   7 <p>
   8   Editing operations in Ardour either operate on a single point in time
   9   (<kbd class="menu">Split</kbd> being the obvious example) or on two
  10   points (which can also be considered to be a range of sorts), <kbd
  11   class="menu">Separate</kbd> is a good example of this.
  12 </p>
  13 <p>
  14   Most operations will operate on the currently selected region(s), but if
  15   no regions are selected, the region that the mouse is in will be used
  16   instead. Single-point operations will generally pick a set of regions to
  17   use based on the following rules:
  18 </p>
  19 <ul>
  20   <li> If the <a href="@@edit-point-control">Edit Point</a> is <kbd class="menu">mouse</kbd>, then
  21     <ul>
  22      <li>if the mouse is over a selected region, or no region, use all selected
  23      regions, or</li>
  24      <li>if the mouse is over an unselected region, use just that region.</li>
  25     </ul>
  26   </li>
  27   <li> For all other Edit Points
  28     <ul>
  29       <li>
  30         use the selected regions <em>and</em> those that are both
  31         under the edit position <em>and</em> on a selected track,
  32         or on a track which is in the same active edit-enabled route group
  33         as a selected region.
  34       </li>
  35     </ul>
  36   </li>
  37 </ul>
  38 <p>
  39   The rationale here for the two different rules is that the mouse Edit Point
  40   is special in that its position indicates both a time and a track; the other
  41   edit points (<kbd class="menu">Playhead</kbd>,<kbd class="menu">Marker</kbd>)
  42   indicate a time only.
  43 </p>
  44