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

   1
   2 <h2>Export Format Profiles</h2>
   3
   4 <p>
   5 An Export Format Profile specifies the file format in which Ardour will export
   6 audio files, and also other audio file export options.
   7 </p>
   8
   9 <p>
  10 Export Format Profiles are edited via the 'Edit Export Format Profile' dialog.
  11 </p>
  12
  13 <img src="/images/edit-export-format-profile.png" />
  14 <p>
  15 <h3>Normalize</h3>
  16 <p>
  17 If enabled, peak levels of exported files will be normalized to the level chosen here.
  18 </p>
  19
  20 <h3>Trim/Add silence at start/end</h3>
  21 <p>
  22
  23 </p>
  24
  25 <h3>Compatibility/Quality/File format/Sample rate</h3>
  26 <h4>Compatibility</h4>
  27 <p>
  28 Selecting an item in the 'Compatibility' column will display options in the
  29 other columns that are incompatible with that item in red.
  30 </p>
  31
  32 <h4>Quality</h4>
  33 <p>
  34 The appropriate item in the 'Quality' column will be highlighted when you
  35 choose a file format. Clicking on items in the 'Quality' column currently
  36 doesn't seem to do anything useful.
  37 </p>
  38
  39 <h4>File format</h4>
  40 <p>
  41 This column contains a list of Ardour's supported export file types. Click on
  42 the format you want to use.
  43 </p>
  44
  45 <h4>Sample rate</h4>
  46 <p>
  47 You can explicitly choose the sample rate of your exported files here, or
  48 choose 'Session rate' to export in the current session's sample rate, without
  49 sample rate conversion.
  50 </p>
  51
  52 <h4>Sample rate conversion quality</h4>
  53 <p>
  54 If your chosen sample rate does not match the current session's sample rate,
  55 choose the sample rate conversion quality here. Better quality options are
  56 slower.
  57 </p>
  58
  59 <h3>Options</h3>
  60 <p>
  61 Options relevant to the chosen file format will appear here.
  62 Categories of audio file format are:
  63 <ul>
  64 <li>Linear encoding</li>
  65 <li>Broadcast Wave</li>
  66 <li>Ogg Vorbis</li>
  67 <li>FLAC</li>
  68 </ul>
  69
  70 <p>
  71 Available options include a selection of the following:</p>
  72
  73 <h4>Sample Format</h4>
  74 <p>
  75 Choose the bit depth of exported files.
  76 </p>
  77
  78 <h4>Dithering</h4>
  79 <p>
  80 If the exported files bit depth is less than Ardour's native bit depth,
  81 choose the dithering algorithm to use.
  82 </p>
  83
  84 <h4>Create CUE file/Create TOC file</h4>
  85 <p>
  86 As well as exporting an audio file, create a file (in CUE or TOC format
  87 respectively) containg CD track information, as defined in the
  88 <a href="@@the-ranges-and-marks-lists">Ranges &amp; Marks List</a>.
  89
  90
  91 <h4>Tag with session's metadata</h4>
  92 <p>
  93 If the exported file format supports metadata, use data entered in the
  94 <a href="@@metadata">Session Metadata</a>
  95 window to tag the exported files.
  96 </p>
  97
  98
  99 <h3>Label</h3>
 100 <p>
 101 The 'Label' field lets you choose the name which will be shown for this format
 102 in the drop-down list of export formats in the 'File Formats' tab of the
 103 <a href="@@export-dialog">Export dialog</a>.
 104
 105 <h3>Command to run post-export</h3>
 106 <p>
 107 If this is not blank, it is considered as a command to be run after the export
 108 of each file. Either the command must exist in $PATH, or you can specify an
 109 absolute path to an executable file here.
 110 </p>
 111
 112 <p>
 113 Certain sequences are allowed here to stand for the exported file name and the
 114 like. Currently these are:
 115 <dl>
 116 <dt><code>%f</code></dt>
 117 <dd>Full path &amp; filename of the exported audio file</dd>
 118 <dt><code>%d</code></dt>
 119 <dd>Directory containing the exported audio file (including trailing directory separator)</dd>
 120 <dt><code>%b</code></dt>
 121 <dd>Basename of the exported audio file (without extension)</dd>
 122 <dt><code>%s</code></dt>
 123 <dd>Path to the current session file</dd>
 124 <dt><code>%n</code></dt>
 125 <dd>Name of the current session file</dd>
 126 <dt><code>%%</code></dt>
 127 <dd>A literal percent sign</dd>
 128 </dl>
 129 <p>
 130 Any part of the command-line enclosed in double-quotes (") will be used as-is.
 131