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