diff options
author | Erik de Castro Lopo <erikd@mega-nerd.com> | 2013-04-28 15:48:41 +1000 |
---|---|---|
committer | Erik de Castro Lopo <erikd@mega-nerd.com> | 2013-04-28 19:00:30 +1000 |
commit | 6ed380943b4562217605d9964d2c756965727abf (patch) | |
tree | 4338c6ef210cb9be41b1e7a0541b7592613629f8 /man | |
parent | 03b9d5dd0dbf73b0140d205955cd5f3e33d417e2 (diff) | |
download | flac-6ed380943b4562217605d9964d2c756965727abf.tar.gz |
Document --apply-replaygain-which-is-not-lossless command line option.
Diffstat (limited to 'man')
-rw-r--r-- | man/flac.1 | 31 | ||||
-rw-r--r-- | man/flac.sgml | 46 |
2 files changed, 77 insertions, 0 deletions
@@ -101,6 +101,37 @@ Set the beginning and ending cuepoints to decode. The optional first #.# is the .TP \fB-F, --decode-through-errors \fR By default flac stops decoding with an error and removes the partially decoded file if it encounters a bitstream error. With -F, errors are still printed but flac will continue decoding to completion. Note that errors may cause the decoded audio to be missing some samples or have silent sections. +.TP +\fB--apply-replaygain-which-is-not-lossless[=<specification>] \fR +Applies ReplayGain values while decoding. + +WARNING: THIS IS NOT LOSSLESS. DECODED AUDIO WILL NOT BE IDENTICAL TO THE ORIGINAL WITH THIS OPTION. + +The equals sign and <specification> is optional. If omitted, the default is 0aLn1. + +The <specification> is a shorthand notation for describing how to apply ReplayGain. All components are optional but order is important. '[]' means 'optional'. '|' means 'or'. '{}' means required. The format is: + +[<preamp>][a|t][l|L][n{0|1|2|3}] +.RS +.TP +\fBpreamp\fR +A floating point number in dB. This is added to the existing gain value. +.TP +\fBa|t\fR +Specify 'a' to use the album gain, or 't' to use the track gain. If tags for the preferred kind (album/track) do not exist but tags for the other (track/album) do, those will be used instead. +.TP +\fBl|L\fR +Specify 'l' to peak-limit the output, so that the ReplayGain peak value is full-scale. Specify 'L' to use a 6dB hard limiter that kicks in when the signal approaches full-scale. +.TP +\fBn{0|1|2|3}\fR +Specify the amount of noise shaping. ReplayGain synthesis happens in floating point; the result is dithered before converting back to integer. This quantization adds noise. Noise shaping tries to move the noise where you won't hear it as much. 0 means no noise shaping, 1 means 'low', 2 means 'medium', 3 means 'high'. +.RE + +For example, the default of 0aLn1 means 0dB preamp, use album gain, 6dB hard limit, low noise shaping. + +--apply-replaygain-which-is-not-lossless=3 means 3dB preamp, use album gain, no limiting, no noise shaping. + +flac uses the ReplayGain tags for the calculation. If a stream does not have the required tags or they can't be parsed, decoding will continue with a warning, and no ReplayGain is applied to that stream. .SS "ENCODING OPTIONS" .TP \fB-V, --verify\fR diff --git a/man/flac.sgml b/man/flac.sgml index 240c5fd5..7c846404 100644 --- a/man/flac.sgml +++ b/man/flac.sgml @@ -298,6 +298,52 @@ </listitem> </varlistentry> + <varlistentry> + <term><option>--apply-replaygain-which-is-not-lossless[=<specification>]</option> + </term> + <listitem> + <para>Applies ReplayGain values while decoding.</para> + <para>WARNING: THIS IS NOT LOSSLESS. DECODED AUDIO WILL NOT BE IDENTICAL TO THE ORIGINAL WITH THIS OPTION.</para> + <para>The equals sign and <specification> is optional. If omitted, the default is 0aLn1.</para> + <para>The <specification> is a shorthand notation for describing how to apply ReplayGain. All components are optional but order is important. '[]' means 'optional'. '|' means 'or'. '{}' means required. The format is:</para> + <para>[<preamp>][a|t][l|L][n{0|1|2|3}]</para> + + <variablelist> + <varlistentry> + <term><option>preamp</option></term> + <listitem> + <para>A floating point number in dB. This is added to the existing gain value.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>a|t</option></term> + <listitem> + <para>Specify 'a' to use the album gain, or 't' to use the track gain. If tags for the preferred kind (album/track) do not exist but tags for the other (track/album) do, those will be used instead.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>l|L</option></term> + <listitem> + <para>Specify 'l' to peak-limit the output, so that the ReplayGain peak value is full-scale. Specify 'L' to use a 6dB hard limiter that kicks in when the signal approaches full-scale.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>n{0|1|2|3}</option></term> + <listitem> + <para>Specify the amount of noise shaping. ReplayGain synthesis happens in floating point; the result is dithered before converting back to integer. This quantization adds noise. Noise shaping tries to move the noise where you won't hear it as much. 0 means no noise shaping, 1 means 'low', 2 means 'medium', 3 means 'high'.</para> + </listitem> + </varlistentry> + + </variablelist> + + <para>For example, the default of 0aLn1 means 0dB preamp, use album gain, 6dB hard limit, low noise shaping.</para> + <para>--apply-replaygain-which-is-not-lossless=3 means 3dB preamp, use album gain, no limiting, no noise shaping.</para> + <para>flac uses the ReplayGain tags for the calculation. If a stream does not have the required tags or they can't be parsed, decoding will continue with a warning, and no ReplayGain is applied to that stream.</para> + </listitem> + </varlistentry> </variablelist> </refsect2> |