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 track for which they were recorded, or</li>
   5   <li>the name of the embedded/imported file they represent.</li>
   6 </ul>
   7
   8 <h2>Whole File Region Names</h2>
   9 <p>
  10   These are not audio files, but regions that represent the full extent of an
  11   audio file. Every time a new recording is done, or a new file is imported
  12   to the session, a new region is created that represents the <dfn>entire audio
  13   file</dfn>. This region will have the name of the track/playlist/original file,
  14   followed by a "-", then a number plus a dot and then a number.
  15 </p>
  16 <p>
  17   For <dfn>recorded regions</dfn>, the number will increase each time a new recording
  18   is made. So, for example, if there is a track called
  19   <samp>Didgeridoo</samp>, the
  20   first recorded whole file region for that playlist will be called
  21   <samp>Didgeridoo-1</samp>. The next one will be <samp>Didgeridoo-2</samp> and so on.
  22 </p>
  23 <p>
  24   For <dfn>imported regions</dfn>, the region name will be based on the original file
  25   name, but with any final suffix (e.g. ".wav" or ".aiff") removed.
  26 </p>
  27 <p>
  28   Normally, whole file regions are not inserted into tracks or playlists,
  29   but regions derived from them are. The whole-file versions live in the
  30   <a href="@@the-region-list">Editor's region list</a> where they act as an
  31   organizing mechanism for regions that are derived from them.
  32 </p>
  33
  34 <h2>Normal Region Names</h2>
  35 <p>
  36   When a region is inserted into a track and playlist, its initial name will
  37   end in a <dfn>version number</dfn>, such as <samp>.1</samp>. For a recorded region,
  38   if the whole file region was <samp>Hang drum-1</samp>, then the region in
  39   the track will appear with the name <samp>Hang drum-1.1</samp>. For an
  40   imported region, if the whole file region was <samp>Bach:Invention3</samp>,
  41   then the region in the track will appear with the name
  42   <samp>Bach:Invention3.1</samp>.
  43 </p>
  44
  45 <h2>Copied Region Names</h2>
  46 <p>
  47   Duplicating or splitting a region creates new region(s) that
  48   are based on the same original files. Hence, they share the same base name (in the
  49   example above, <samp>Hang drum-1</samp>), but their version number will be incremented
  50   each time. Duplicating <samp>Hang drum-1.4</samp> by <kbd class="mod1 mouse">left</kbd>
  51   dragging it will create a new region called <samp>Hang drum-1.5</samp>. Splitting
  52   <samp>Hang drum-1.5</samp> by hitting the <kbd>S</kbd> key will remove the
  53   <samp>Hang drum-1.5</samp> region and create two shorter regions named
  54   <samp>Hang drum-1.6</samp> and <samp>Hang drum-1.7</samp>.
  55 </p>
  56
  57 <h2>Renaming Regions</h2>
  58 <p>
  59   Regions can be renamed at any time using the region context menu : <kbd class="menu">
  60   <kbd class="mouse">right</kbd> click &gt; <em>name_of_the_region</em> &gt; Rename... </kbd>.
  61   The new name does not need to have a version number in it (in fact, it probably
  62   should not). Ardour will add a version number in the future if needed (e.g.
  63   if the region is copied or sliced).
  64 </p>
  65