X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=include%2Fexport-format-profiles.html;h=5f43d26d640f48d0454d53eab8c317c90534d1c5;hb=a61fbacdfcb7a76fe425fada61f49fc85751e47a;hp=dd64a401046548df7e5972689eb4ef620e9cd2c9;hpb=cd424ba51a8cca029653ba7cb2b9496c046910b5;p=ardour-manual diff --git a/include/export-format-profiles.html b/include/export-format-profiles.html index dd64a40..5f43d26 100644 --- a/include/export-format-profiles.html +++ b/include/export-format-profiles.html @@ -1,131 +1,181 @@ -

Export Format Profiles

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

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

- -

-

Normalize

+

Label

-If enabled, peak levels of exported files will be normalized to the level chosen here. + 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.

-

Trim/Add silence at start/end

+

Pre Process

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

-

Compatibility/Quality/File format/Sample rate

-

Compatibility

+ + +

Trim silence at start/end

-Selecting an item in the 'Compatibility' column will display options in the -other columns that are incompatible with that item in red. + These checkboxes allow to remove any part Ardour considers silent (< −90dB), + at the beginning or/and end of each exported track.

-

Quality

+

Add silence at start/end

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

-

File format

+

Watermark

-This column contains a list of Ardour's supported export file types. Click on -the format you want to use. + This section adds watermarks to the exported audio (e.g. for limited/demo + distribution), by overwriting part of the audio with white noise in the + exported file.

- -

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. + Both the Mode (how often and how long) and Noise Level + (how loud) can be set.

-

Sample rate conversion quality

+

Format

+ +

Compatibility

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

-

Options

+

Quality

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

+ 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

-Available options include a selection of the following:

- -

Sample Format

+ This column contains a list of Ardour's supported export file types. Selecting + one updates the options underneath it. +

-Choose the bit depth of exported files. + 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.

-

Dithering

+

Sample rate

-If the exported files bit depth is less than Ardour's native bit depth, -choose the dithering algorithm to use. + 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.

-

Create CUE file/Create TOC file

+

Encoding

-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 and Marks List. + Options relevant to the chosen file format will appear just to the right of the + Compatibility/Quality/File format/Sample rate table. +

+

Sample rate conversion quality

+

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

-

Tag with session's metadata

+

Metadata

-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:

+

Tag file with session's metadata

+

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

-

Label

+

Create CUE/TOC/chapter mark file

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

Command to run post-export

+

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: - - - - - - - - - - - - - -
%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
+ Certain sequences are allowed here to stand for the exported file name and + various parameters. Currently these are: +

+ + +

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