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

   1
   2 <h2>Region properties</h2>
   3
   4 <figure>
   5   <img src="/images/region-properties.png" alt="The Region Propeties window">
   6   <figcaption>
   7     The Region Properties window
   8   </figcaption>
   9 </figure>
  10
  11 <p>
  12   The <dfn>Region properties</dfn> window brings information about the selected
  13   regions, and allows to fine tune its sequencing. It is accessed through the
  14   <kbd class="menu">Region &gt; Properties&hellip;</kbd> menu, or by
  15   <kbd class="mouse">right</kbd> clicking the region,
  16   <kbd class="menu"><i>Name_of_the_Region</i> &gt; Properties&hellip;</kbd>.
  17 </p>
  18 <p>
  19   This window also allows to manually set the different values.
  20 </p>
  21
  22 <table class="dl">
  23   <thead>
  24     <tr>
  25       <th>Field</th>
  26       <td>Meaning</td>
  27       <td>Editable</td>
  28     </tr>
  29   </thead>
  30   <tbody>
  31   <tr>
  32     <th>Name:</th>
  33     <td>The <a href="@@region-naming">name of the region</a> in the editor</td>
  34     <td>X</td>
  35   </tr>
  36   <tr>
  37     <th><kbd class="menu">Audition</kbd></th>
  38     <td>This button allows to listen to the region and only the region, dry (with
  39       no effects, regardless of the processors applied to the track). For MIDI,
  40       the default MIDI synth, set in the <a href="@@preferences#preferences-midi">Preferences</a>,
  41       is used to audition the region.</td>
  42     <td></td>
  43   </tr>
  44   <tr>
  45     <th>Position:</th>
  46     <td>Position in time of the left-hand side of the region</td>
  47     <td>X</td>
  48   </tr>
  49   <tr>
  50     <th>End:</th>
  51     <td>Position in time of the right-hand side of the region</td>
  52     <td>X</td>
  53   </tr>
  54   <tr>
  55     <th>Length:</th>
  56     <td>Duration of the region (&equals;End&minus;Position)</td>
  57     <td>X</td>
  58   </tr>
  59   <tr>
  60     <th>Sync point (relative to region):</th>
  61     <td>Position in time of the <a href="@@grid-controls">Sync Point</a>, relative
  62        to the beginning of the region. No manual sync point means the sync point is
  63        the beginning of the region (&equals;Position), so will show as "0" in time
  64        and <code>001|01|0000</code> in Bars:Beats notation.</td>
  65     <td>X</td>
  66   </tr>
  67   <tr>
  68     <th>Sync point (absolute):</th>
  69     <td>Position in time of the <a href="@@grid-controls">Sync Point</a>, relative
  70        to the beginning of the session. No manual sync point means the sync point
  71        is the beginning of the region, and will be equal to the Position.</td>
  72     <td>X</td>
  73   </tr>
  74   <tr>
  75     <th>File start:</th>
  76     <td>Position in time of the beginning of the region relative to the source
  77         file start. If the region has not been trimmed on the left, then the regions
  78         start is the file start and this value is 0.</td>
  79     <td></td>
  80   </tr>
  81   <tr>
  82     <th>Source:</th>
  83     <td>Name of the source audio/MIDI file the region is extracted from.
  84       A region can be a part of or a whole audio/MIDI file, and multiple regions can
  85       be based on the same source file.
  86     </td>
  87     <td>X</td>
  88   </tr>
  89   <tr>
  90     <th>Region gain:</th>
  91     <td><em>(Audio files only)</em> Manual gain, in dB, applied constantly to the whole region,
  92       regardless of the global track's gain, automation, etc&hellip;</td>
  93     <td>X</td>
  94   </tr>
  95   <tr>
  96     <th>Peak amplitude:</th>
  97     <td><em>(Audio files only)</em> Maximum level the signal reaches inside the region.
  98       Expressed in dBFS (Full Scale), where 0 is the numeric maximum a signal can
  99       reach.</td>
 100     <td></td>
 101   </tr>
 102   </tbody>
 103 </table>
 104
 105 <p>
 106   All the fields marked as "editable" in the table above allow the user to manually
 107   enter a value in the field, to manually set this value.
 108 </p>
 109
 110 <p>
 111   <kbd class="mouse">Right</kbd>-clicking on a field allow to switch between the
 112   different <a href="@@editing-clocks">clock modes</a>.
 113 </p>
 114
 115 <p>
 116   The context menu that pops up also allows the relevant fields (Position, End,
 117   and both Sync points) to be set from the playhead location, which can be used to
 118   e.g. trim a region to the playhead or place a sync point exactly on a beat.
 119 </p>