Shamusworld >> Repos - ardour-manual/blob - include/export-format-profiles.html

   1
   2 <figure class="right">
   3   <img src="/images/edit-export-format-profile.png" alt="The 'Edit Export Format Profile' dialog">
   4   <figcaption>
   5     The 'Edit Export Format Profile' dialog
   6   </figcaption>
   7 </figure>
   8
   9 <p>
  10   An Export Format Profile specifies the file format in which Ardour will export
  11   audio files, and also other audio file export options.
  12 </p>
  13 <p>
  14   Export Format Profiles are edited via the <kbd class="menu">Edit Export Format
  15   Profile</kbd> dialog.
  16 </p>
  17
  18 <h2>Label</h2>
  19 <p>
  20   The <kbd class="menu">Label</kbd> field allows to choose the name which will be
  21   shown for this format in the drop-down list of export formats in the
  22   'File Formats' tab of the <a href="@@export-dialog">Export dialog</a>.
  23 </p>
  24
  25 <h2>Pre Process</h2>
  26 <p>
  27   If enabled, levels of exported files will be normalized to the level chosen here.
  28   The normalization can be either:
  29 </p>
  30
  31 <ul>
  32   <li>Peak, which adjusts the gain to bring the highest signal peak to the
  33     chosen level (in <acronym title="decibels relative to full scale">dBFS</acronym>),
  34   </li>
  35   <li>Loudness, which adjusts the gain to bring the average amplitude to the
  36     chosen level (in <acronym title="loudness units relative to full scale">LUFS</acronym>),
  37     without exceeding the chosen true-peak value (in
  38     <acronym title="decibels true peak">dBTP</acronym>).
  39     EBU R128 is only available for mono or stereo sounds while true-peak works
  40     for any channel layout.
  41   </li>
  42 </ul>
  43
  44 <h3>Trim silence at start/end</h3>
  45 <p>
  46   These checkboxes allow to remove any part Ardour considers silent (&lt; &minus;90dB),
  47   at the beginning or/and end of each exported track.
  48 </p>
  49
  50 <h3>Add silence at start/end</h3>
  51 <p>
  52   These checkboxes allow to add silence at the beginning or/and end of each
  53   exported track. The duration of the added silence can be manually fixed in the
  54   adjacent 'timer' input fields.
  55 </p>
  56
  57 <h2>Watermark</h2>
  58 <p>
  59   This section adds watermarks to the exported audio (e.g. for limited/demo
  60   distribution), by overwriting part of the audio with white noise in the
  61   exported file.
  62 </p>
  63 <p>
  64   Both the <dfn>Mode</dfn> (how often and how long) and <dfn>Noise Level</dfn>
  65   (how loud) can be set.
  66 </p>
  67
  68 <h2>Format</h2>
  69
  70 <h3>Compatibility</h3>
  71 <p>
  72   Selecting an item in the 'Compatibility' emphasizes the settings in the other
  73   columns that are compatible with the selected standard, by turning incompatible
  74   options red. When an incompatible quality/format/sample rate is selected, the
  75   compatibility column checkbox disappears.
  76 </p>
  77
  78 <h3>Quality</h3>
  79 <p>
  80   The appropriate item in the 'Quality' column will be highlighted when a file format
  81   is chosen. At the moment, selecting a Quality setting does not show the
  82   compatible File formats.
  83 </p>
  84
  85 <h3>File format</h3>
  86 <p>
  87   This column contains a list of Ardour's supported export file types. Selecting
  88   one updates the options underneath it.
  89 </p>
  90 <p>
  91         Note: For mp3 export ardour relies on ffmpeg to encode the file. This comes bundled
  92         with the video-tools (and is always available when you install the official Ardour
  93         binary.
  94 </p>
  95
  96 <h3>Sample rate</h3>
  97 <p>
  98   A specific sample rate can be chosen for the exported files, or the current session's
  99   sample rate (by choosing 'Session rate'), without sample rate conversion.
 100 </p>
 101
 102 <h2>Encoding</h2>
 103 <p>
 104   Options relevant to the chosen file format will appear just to the right of the
 105   Compatibility/Quality/File format/Sample rate table.
 106 </p>
 107
 108 <h3>Sample rate conversion quality</h3>
 109 <p>
 110   In case the chosen sample rate does not match the current session's sample rate,
 111   the sample rate conversion quality can be chosen here. Better quality options are
 112   slower.
 113 </p>
 114
 115 <h2>Metadata</h2>
 116 <p>
 117   These options are presented whatever the chosen format is:
 118 </p>
 119
 120 <h3>Tag file with session's metadata</h3>
 121 <p>
 122   If the exported file format supports metadata (e.g. FLAC, Ogg Vorbis), use data
 123   entered in the <a href="@@metadata">Session Metadata</a> window to tag the
 124   exported files.
 125 </p>
 126
 127 <h3>Create CUE/TOC/chapter mark file</h3>
 128 <p>
 129   As well as exporting an audio file, Ardour can create a file (in CUE, TOC or MP4ch format
 130   respectively) containing CD track information, as defined in the
 131   <a href="@@the-ranges-and-marks-lists">Ranges &amp; Marks List</a>.
 132   Those files can then be used to either burn a CD or DVD, or to create "chapters"
 133   inside a compatible mp4 video container.
 134
 135 <h2>Post Export</h2>
 136 <p>
 137   If this is not blank, it is considered as a command to be run after the export
 138   of each file. Either the command must exist in $PATH, or an absolute path to
 139   an executable file can be specified here.
 140 </p>
 141
 142 <p>
 143   Certain sequences are allowed here to stand for the exported file name and
 144   various parameters. Currently these are:
 145 </p>
 146
 147 <ul>
 148         <li><dfn>%a</dfn>: Artist name</li>
 149         <li><dfn>%b</dfn>: File's base-name</li>
 150         <li><dfn>%c</dfn>: Copyright</li>
 151         <li><dfn>%d</dfn>: File's directory</li>
 152         <li><dfn>%f</dfn>: File's full absolute path</li>
 153         <li><dfn>%l</dfn>: Lyricist</li>
 154         <li><dfn>%n</dfn>: Session name</li>
 155         <li><dfn>%o</dfn>: Conductor</li>
 156         <li><dfn>%t</dfn>: Title</li>
 157         <li><dfn>%z</dfn>: Organization</li>
 158         <li><dfn>%A</dfn>: Album</li>
 159         <li><dfn>%C</dfn>: Comment</li>
 160         <li><dfn>%E</dfn>: Engineer</li>
 161         <li><dfn>%G</dfn>: Genre</li>
 162         <li><dfn>%L</dfn>: Total track count</li>
 163         <li><dfn>%M</dfn>: Mixer</li>
 164         <li><dfn>%N</dfn>: Timespan name</li>
 165         <li><dfn>%O</dfn>: Composer</li>
 166         <li><dfn>%P</dfn>: Producer</li>
 167         <li><dfn>%S</dfn>: Disc subtitle</li>
 168         <li><dfn>%T</dfn>: Track number</li>
 169         <li><dfn>%Y</dfn>: Year</li>
 170         <li><dfn>%Z</dfn>: Country</li>
 171 </ul>
 172
 173 <p>
 174   Any part of the command-line enclosed in double-quotes (") will be used as-is.
 175 </p>
 176
 177 <p>
 178   For example, exporting an mp3 file can be done by inserting <code>lame -b320 %f</code>
 179   which will convert the exported audio file ('%f') to a 320 kbs mp3 using the lame encoder
 180   (provided lame is installed first on the system).
 181 </p>