Shamusworld >> Repos - ardour-manual/blob - include/playlist-operations.html

   1
   2 <p>
   3   In the <a href="@@audio-track-controls">track header</a> (editor window, left pane) is a button labelled <kbd
   4   class="menu">p</kbd> (for "Playlist"). A click on this button displays the
   5   following menu:
   6 </p>
   7
   8 <table class="dl">
   9   <tr>
  10         <th><i>(Local Playlists)</i></th>
  11         <td>Shows all of the playlists associated with this track, and indicates
  12         the currently selected playlist</td>
  13   </tr>
  14   <tr>
  15         <th>Select&hellip;</th>
  16         <td>Allows switching playlists, either for this track or multiple ones (more about that later)</td>
  17   </tr>
  18   <tr>
  19     <th>Rename&hellip;</th>
  20     <td>Displays a dialog to rename the current playlist</td></tr>
  21   <tr>
  22         <th>New Playlist&hellip;</th>
  23         <td>Creates a new empty playlist, and the track switches to the new playlist</td>
  24   </tr>
  25   <tr>
  26         <th>Copy Playlist&hellip;</th>
  27     <td>Creates a new playlist that is an independent copy of the current playlist; the track switches to the new playlist</td>
  28   </tr>
  29   <tr>
  30         <th>Clear Current</th>
  31     <td>Removes all regions from the current playlist</td>
  32   </tr>
  33   <tr>
  34         <th>Advanced</th><td></td></tr>
  35         <tr>
  36           <th class="sub1">Copy from &hellip;</th>
  37           <td>Creates a new playlist that is an independent copy of a playlist from this track or another one; the track switches to the new playlist</td>
  38         </tr>
  39         <tr>
  40           <th class="sub1">Share with &hellip;</th>
  41           <td>Uses a playlist from this track or another one; any edit to this playlist will be reflected on the other track(s) that use this playlist</td>
  42         </tr>
  43         <tr>
  44           <th class="sub1">Steal from &hellip;</th>
  45           <td>Uses a playlist from this track or another one and removes it from the local playlists in the "robbed" track. Otherwise, behaves like "Share with &hellip;"</td>
  46         </tr>
  47 </table>
  48
  49 <p class="note">
  50   When <em>Stealing</em> a playlist, it does not remove the playlist from the
  51   robbed track. The playlist now belongs to the current track, and the robbed track
  52   uses the playlist as a shared playlist with the new owner. Hence, this playlist
  53   won't be in the <i>(Local Playlists)</i> list from the robbed track anymore, but
  54   will now appear in the current track's local playlists.
  55 </p>
  56
  57 <h2>Sharing vs copying Playlists</h2>
  58 <p>
  59   It is entirely possible to <dfn>share playlists</dfn> between tracks. The only
  60   slightly unusual thing that should be noted when sharing is that edits to the
  61   playlist made in one track will magically appear in the other. It is an
  62   obvious consequence of sharing. One application of this attribute is parallel
  63   processing, described in <a href="@@playlist-usecases">Playlist Use Cases</a>.
  64 </p>
  65 <p>
  66   To avoid this kind of behaviour, and nevertheless use the same (or substantially
  67   the same) playlist on two tracks, the desired playlist must be copied and not shared.
  68   This generates an <dfn>independent copy</dfn> of it for that track, which can
  69   then be edited without affecting the original.
  70 </p>
  71
  72 <h2>Select menu</h2>
  73
  74 <figure>
  75         <img src="/images/playlist_select.png" alt="The Select playlist menu"/>
  76         <figcaption>The Select playlist menu.</figcaption>
  77 </figure>
  78
  79 <p>
  80   In its most basic use, the <kbd class="menu">Select &hellip;</kbd>
  81   menu allows:
  82 </p>
  83 <ul>
  84         <li>
  85                 to switch from one playlist to another (with the added benefit,
  86                 compared to switching directly from the <i>Local Playlists</i>
  87                 list, to see the creation date and time),
  88         </li>
  89         <li>
  90                 to create a new, empty playlist, with the <kbd class="menu">New
  91                 Playlist(s)</kbd> button,
  92         </li>
  93         <li>
  94                 or to create an independent copy of the current one, with the
  95                 <kbd class="menu">Copy Playlist(s)</kbd> button.
  96         </li>
  97 </ul>
  98 <p>
  99   When used for <kbd class="option">Only this track/group</kbd>, in the
 100   selector below, it is the same as using the <kbd class="menu">New
 101   Playlist &hellip;</kbd> and <kbd class="menu">Copy Playlist &hellip;</kbd> from the
 102   Playlist menu.
 103 </p>
 104 <p>
 105   But the selector also allows to apply these operation (changing
 106   playlist, creating an empty new one or creating an independent copy)
 107   for <kbd class="option">Rec-armed tracks</kbd> or <kbd
 108   class="option">ALL tracks</kbd>. This can be useful in a recording
 109   situation with many microphones and multiple takes to deal with.
 110 </p>
 111 <p>
 112   These playlist operations, on multiple tracks, are also available
 113   directly on the secondary toolbar in <a
 114   href="@@recorder">Recorder</a> mode.
 115 </p>