X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=include%2Fexport-format-profiles.html;h=09580a90f081f2f870ec69d2f477f1edc6892c5c;hb=a9518e1f3e8e0f359443963037c987e4f67158e8;hp=732b36556203a2b5d2e9f9305f8ba9a4afa9202d;hpb=88d6f39b5f8b0f791b6833bb1512aa774b59d4f8;p=ardour-manual diff --git a/include/export-format-profiles.html b/include/export-format-profiles.html index 732b365..09580a9 100644 --- a/include/export-format-profiles.html +++ b/include/export-format-profiles.html @@ -2,116 +2,148 @@

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. +

+

+ Note: For mp3 export ardour relies on ffmpeg to encode the file. This comes bundled + with the video-tools (and is always available when you install the official Ardour + binary.

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

+

Format Options

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

- -

-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) containing 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: + Certain sequences are allowed here to stand for the exported file name and + various parameters. Currently these are: @@ -126,6 +158,13 @@ like. Currently these are:
%f Full path and filename of the exported audio file
%% A literal percent sign
+

-Any part of the command-line enclosed in double-quotes (") will be used as-is. + 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). +