X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=include%2Fexport-format-profiles.html;h=94c9b7d25c7a6657b15e9c8d30651d9e97e05a13;hb=54bca41fed4d8a2eae3818151273a94022c6511b;hp=2778546a4900adaca317805d8fd81d3fc9f716d2;hpb=2098e011e638b5c86c56e68df7757975fc4d728f;p=ardour-manual diff --git a/include/export-format-profiles.html b/include/export-format-profiles.html index 2778546..94c9b7d 100644 --- a/include/export-format-profiles.html +++ b/include/export-format-profiles.html @@ -2,132 +2,164 @@

Export Format Profiles

-An Export Format Profile specifies the file format in which Ardour will export -audio files, and also other audio file export options. + An Export Format Profile specifies the file format in which Ardour will export + audio files, and also other audio file export options.

-Export Format Profiles are edited via the 'Edit Export Format Profile' dialog. + Export Format Profiles are edited via the Edit Export Format + Profile dialog.

- -

+

+ The 'Edit Export Format Profile' dialog +
+ The 'Edit Export Format Profile' dialog +
+
+

Normalize

-If enabled, peak levels of exported files will be normalized to the level chosen here. + If enabled, levels of exported files will be normalized to the level chosen here. + The normalization can be either:

-

Trim/Add silence at start/end

-

+

+

Trim silence at start/end

+

+ These checkboxes allow to remove any part Ardour considers silent (0dB), + at the beginning or/and end of each exported track.

+

Add silence at start/end

+

+ These checkboxes allow to add silence at the beginning or/and end of each + exported track. The duration of the added silence can be manually fixed in the + adjacent 'timer' input fields. +

Compatibility/Quality/File format/Sample rate

+

Compatibility

-Selecting an item in the 'Compatibility' column will display options in the -other columns that are incompatible with that item in red. + Selecting an item in the 'Compatibility' emphasizes the settings in the other + columns that are compatible with the selected standard, by turning incompatible + options red. When an incompatible quality/format/sample rate is selected, the + compatibility column checkbox disappears.

Quality

-The appropriate item in the 'Quality' column will be highlighted when you -choose a file format. Clicking on items in the 'Quality' column currently -doesn't seem to do anything useful. + The appropriate item in the 'Quality' column will be highlighted when a file format + is chosen. At the moment, selecting a Quality setting does not show the + compatible File formats.

File format

-This column contains a list of Ardour's supported export file types. Click on -the format you want to use. + This column contains a list of Ardour's supported export file types. Selecting + one updates the options underneath it.

Sample rate

-You can explicitly choose the sample rate of your exported files here, or -choose 'Session rate' to export in the current session's sample rate, without -sample rate conversion. + A specific sample rate can be chosen for the exported files, or the current session's + sample rate (by choosing 'Session rate'), without sample rate conversion.

Sample rate conversion quality

-If your chosen sample rate does not match the current session's sample rate, -choose the sample rate conversion quality here. Better quality options are -slower. + In case the chosen sample rate does not match the current session's sample rate, + the sample rate conversion quality can be chosen here. Better quality options are + slower.

-

Options

-

-Options relevant to the chosen file format will appear here. -Categories of audio file format are: -

- +

Format Options

-Available options include a selection of the following:

+ Options relevant to the chosen file format will appear just under the + Compatibility/Quality/File format/Sample rate table. +

-

Sample Format

+

Tag with session's metadata

-Choose the bit depth of exported files. + If the exported file format supports metadata (e.g. FLAC, Ogg Vorbis), use data + entered in the Session Metadata window to tag the + exported files.

-

Dithering

+

Sample Format and Dithering

-If the exported files bit depth is less than Ardour's native bit depth, -choose the dithering algorithm to use. + The Sample Format is the bit depth of exported files, + i.e. the numbers of values a sample can have. Increasing the sample format + results in a better defined audio file at the cost of increasing the file size.

- -

Create CUE file/Create TOC file

-As well as exporting an audio file, create a file (in CUE or TOC format -respectively) containg CD track information, as defined in the -Ranges & Marks List. - + If the exported files bit depth is less than Ardour's native bit depth + (32 bits floating point by default), the dithering algorithm, that chooses how + to compute the conversion can be chosen in the Dithering + column. +

-

Tag with session's metadata

+

Options

-If the exported file format supports metadata, use data entered in the -Session Metadata -window to tag the exported files. + These options are presented whatever the chosen format is:

+

Create CUE/TOC/chapter mark file

+

+ As well as exporting an audio file, Ardour can create a file (in CUE, TOC or MP4ch format + respectively) containing CD track information, as defined in the + Ranges & Marks List. + Those files can then be used to either burn a CD or DVD, or to create "chapters" + inside a compatible mp4 video container.

Label

-The 'Label' field lets you choose the name which will be shown for this format -in the drop-down list of export formats in the 'File Formats' tab of the -Export dialog. + The Label field allows to choose the name which will be + shown for this format in the drop-down list of export formats in the + 'File Formats' tab of the Export dialog. +

Command to run post-export

-If this is not blank, it is considered as a command to be run after the export -of each file. Either the command must exist in $PATH, or you can specify an -absolute path to an executable file here. + If this is not blank, it is considered as a command to be run after the export + of each file. Either the command must exist in $PATH, or an absolute path to + an executable file can be specified here.

-Certain sequences are allowed here to stand for the exported file name and the -like. Currently these are: -

-
%f
-
Full path & filename of the exported audio file
-
%d
-
Directory containing the exported audio file (including trailing directory separator)
-
%b
-
Basename of the exported audio file (without extension)
-
%s
-
Path to the current session file
-
%n
-
Name of the current session file
-
%%
-
A literal percent sign
-
-

-Any part of the command-line enclosed in double-quotes (") will be used as-is. - -{% children %} + Certain sequences are allowed here to stand for the exported file name and + various parameters. Currently these are: + + + + + + + + + + + + + +
%fFull path and filename of the exported audio file
%dDirectory containing the exported audio file (including trailing directory separator)
%bBasename of the exported audio file (without extension)
%sPath to the current session file
%nName of the current session file
%%A literal percent sign
+ +

+ Any part of the command-line enclosed in double-quotes (") will be used as-is. +

+

+ For example, exporting an mp3 file can be done by inserting lame -b320 %f + which will convert the exported audio file ('%f') to a 320 kbs mp3 using the lame encoder + (provided lame is installed first on the system). +