Shamusworld >> Repos - ardour-manual/blob - include/region-naming.html

   1
   2 <p><dfn>Region names</dfn> are initially derived from either</p>
   3 <ul>
   4   <li>the name of the playlist for which they were recorded,</li>
   5   <li>the name of the track for which they were recorded, or</li>
   6   <li>the name of the embedded/imported file they represent.</li>
   7 </ul>
   8 <p class="fixme">
   9   It appears that recorded regions are always named after the track, not the
  10   active playlist in that track.
  11 </p>
  12
  13 <h2>Whole File Region Names</h2>
  14 <p>
  15   These are not audio files, but regions that represent the full extent of an
  16   audio file. Every time a new recording is done, or a new file is imported
  17   to the session, a new region is created that represents the <dfn>entire audio
  18   file</dfn>. This region will have the name of the track/playlist/original file,
  19   followed by a "-", then a number plus a dot and then a number.
  20 </p>
  21 <p>
  22   For <dfn>recorded regions</dfn>, the number will increase each time a new recording
  23   is made. So, for example, if there is a playlist called
  24   <samp>Didgeridoo</samp>, the
  25   first recorded whole file region for that playlist will be called
  26   <samp>Digderidoo-1</samp>. The next one will be <samp>Digeridoo-2</samp> and so on.
  27 </p>
  28 <p>
  29   For <dfn>imported regions</dfn>, the region name will be based on the original file
  30   name, but with any final suffix (e.g. ".wav" or ".aiff") removed.
  31 </p>
  32 <p>
  33   Normally, whole file regions are not inserted into tracks or playlists,
  34   but regions derived from them are. The whole-file versions live in the
  35   editor region list where they act as an organizing mechanism for regions
  36   that are derived from them.
  37 </p>
  38
  39 <h2>Normal Region Names</h2>
  40 <p>
  41   When a region is inserted into a track and playlist, its initial name will
  42   end in a <dfn>version number</dfn>, such as <samp>.1</samp>. For a recorded region,
  43   if the whole file region was <samp>Hang drum-1</samp>, then the region in
  44   the track will appear with the name <samp>Hang drum-1.1</samp>. For an
  45   imported region, if the whole file region was <samp>Bach:Invention3</samp>,
  46   then the region in the track will appear with the name
  47   <samp>Bach:Invention3.1</samp>.
  48 </p>
  49
  50 <h2>Copied Region Names</h2>
  51 <p>
  52   If you <dfn>copy a region</dfn>, it initially shares the same name as the original.
  53   When you perform an operation modifies one of the copies, Ardour will
  54   increment the version number on the particular copy that changed.
  55 </p>
  56
  57 <h2>Renaming Regions</h2>
  58 <p>
  59   You can <dfn>rename a region</dfn> at any time. Use the region context menu to
  60   pop up the <kbd class="menu">Rename</kbd> dialog. The new name does not need to
  61   have a version number in it (in fact, it probably should not). Ardour will add a
  62   version number in the future if needed (e.g. if you copy or split the region).
  63 </p>
  64