X-Git-Url: http://git.xiph.org/?p=flac.git;a=blobdiff_plain;f=doc%2Fhtml%2Fdocumentation_tools_flac.html;h=8496aca909913af91e62de1f990bcbb5b8e6018e;hp=f6d1049292811faa2a058b0d0c9e0ac7272c9d1e;hb=5598543a9663a846a0b7e42f395207bc44381e41;hpb=6ed380943b4562217605d9964d2c756965727abf diff --git a/doc/html/documentation_tools_flac.html b/doc/html/documentation_tools_flac.html index f6d10492..8496aca9 100644 --- a/doc/html/documentation_tools_flac.html +++ b/doc/html/documentation_tools_flac.html @@ -1,11 +1,12 @@ - + + - + @@ -19,7 +20,7 @@
@@ -27,18 +28,10 @@ - -
-  english  | -  russian  +  more
@@ -362,29 +355,35 @@ - --skip={#|mm:ss.ss} + --skip={#|mm:ss.ss}
--skip={#|mm:ss,ss}
Skip over the first # of samples of the input. This works for both encoding and decoding, but not testing. The alternative form mm:ss.ss can be used to specify minutes, seconds, and fractions of a second.

+ Note that the use of either a dot or a comma depends on the locale used for the system.
+
Examples:

--skip=123 : skip the first 123 samples of the input
- --skip=1:23.45 : skip the first 1 minute and 23.45 seconds of the input + --skip=1:23.45 : skip the first 1 minute and 23.45 seconds of the input, with a locale using the point as decimal separator
+ --skip=1:23,45 : skip the first 1 minute and 23.45 seconds of the input, with a locale using the comma as decimal separator
- --until={#|[+|-]mm:ss.ss} + --until={#|[+|-]mm:ss.ss}
--until={#|[+|-]mm:ss,ss}
Stop at the given sample number for each input file. This works for both encoding and decoding, but not testing. The given sample number is not included in the decoded output. The alternative form mm:ss.ss can be used to specify minutes, seconds, and fractions of a second. If a + sign is at the beginning, the --until point is relative to the --skip point. If a - sign is at the beginning, the --until point is relative to end of the audio.

+ Note that the use of either a dot or a comma depends on the locale used for the system.
+
Examples:

--until=123 : decode only the first 123 samples of the input (samples 0-122, stopping at 123)
--until=1:23.45 : decode only the first 1 minute and 23.45 seconds of the input
+ --until=1:23,45 : decode only the first 1 minute and 23.45 seconds of the input, if your locale setting uses a comma as decimal separator
--skip=1:00 --until=+1:23.45 : decode 1:00.00 to 2:23.45
--until=-1:23.45 : decode everything except the last 1 minute and 23.45 seconds
--until=-0:00 : decode until the end of the input (the same as not specifying --until) @@ -539,7 +538,7 @@ -V, --verify - Verify the encoding process. With this option, flac will create a parallel decoder that decodes the output of the encoder and compares the result against the original. It will abort immediately with an error if a mismatch occurs. -V increases the total encoding time but is guaranteed to catch any unforseen bug in the encoding process. + Verify the encoding process. With this option, flac will create a parallel decoder that decodes the output of the encoder and compares the result against the original. It will abort immediately with an error if a mismatch occurs. -V increases the total encoding time but is guaranteed to catch any unforeseen bug in the encoding process. @@ -557,7 +556,7 @@ --replay-gain - Calculate
ReplayGain values and store them as FLAC tags, similar to VorbisGain. Title gains/peaks will be computed for each input file, and an album gain/peak will be computed for all files. All input files must have the same resolution, sample rate, and number of channels. Only mono and stereo files are allowed, and the sample rate must be one of 8, 11.025, 12, 16, 22.05, 24, 32, 44.1, or 48 kHz. Also note that this option may leave a few extra bytes in a PADDING block as the exact size of the tags is not known until all files are processed.
+ Calculate ReplayGain values and store them as FLAC tags, similar to VorbisGain. Title gains/peaks will be computed for each input file, and an album gain/peak will be computed for all files. All input files must have the same resolution, sample rate, and number of channels. Only mono and stereo files are allowed, and the sample rate must be one of 8, 11.025, 12, 16, 22.05, 24, 32, 44.1, or 48 kHz. Also note that this option may leave a few extra bytes in a PADDING block as the exact size of the tags is not known until all files are processed.

Note that this option cannot be used when encoding to standard output (stdout). @@ -613,7 +612,7 @@
DESCRIPTION is optional; the default is an empty string.

- The next part specfies the resolution and color information. If the MIME-TYPE is image/jpeg, image/png, or image/gif, you can usually leave this empty and they can be detected from the file. Otherwise, you must specify the width in pixels, height in pixels, and color depth in bits-per-pixel. If the image has indexed colors you should also specify the number of colors used. When manually specified, it is not checked against the file for accuracy.
+ The next part specifies the resolution and color information. If the MIME-TYPE is image/jpeg, image/png, or image/gif, you can usually leave this empty and they can be detected from the file. Otherwise, you must specify the width in pixels, height in pixels, and color depth in bits-per-pixel. If the image has indexed colors you should also specify the number of colors used. When manually specified, it is not checked against the file for accuracy.

FILE is the path to the picture file to be imported, or the URL if MIME type is -->

@@ -799,7 +798,7 @@ -6, --compression-level-6 - Synonymous with -l 8 -b 4096 -m -r 6 + Synonymous with -l 8 -b 4096 -m -r 6 -A tukey(0.5);partial_tukey(2) @@ -808,7 +807,7 @@ -7, --compression-level-7 - Synonymous with -l 8 -b 4096 -m -e -r 6 + Synonymous with -l 12 -b 4096 -m -r 6 -A tukey(0.5);partial_tukey(2) @@ -817,7 +816,7 @@ -8, --compression-level-8 - Synonymous with -l 12 -b 4096 -m -e -r 6 + Synonymous with -l 12 -b 4096 -m -r 6 -A tukey(0.5);partial_tukey(2);punchout_tukey(3) @@ -853,9 +852,11 @@ -A "function", --apodization="function" - Window audio data with given the apodization function. The functions are: bartlett, bartlett_hann, blackman, blackman_harris_4term_92db, connes, flattop, gauss(STDDEV), hamming, hann, kaiser_bessel, nuttall, rectangle, triangle, tukey(P), welch.
+ Window audio data with given the apodization function. The functions are: bartlett, bartlett_hann, blackman, blackman_harris_4term_92db, connes, flattop, gauss(STDDEV), hamming, hann, kaiser_bessel, nuttall, rectangle, triangle, tukey(P), partial_tukey(n[/ov[/P]]), punchout_tukey(n[/ov[/P]]), welch.
For gauss(STDDEV), STDDEV is the standard deviation (0<STDDEV<=0.5).
For tukey(P), P specifies the fraction of the window that is tapered (0<=P<=1; P=0 corresponds to "rectangle" and P=1 corresponds to "hann").
+ For partial_tukey(n) and punchout_tukey(n), n apodization functions are added that span different parts of each block. Values of 2 to 6 seem to yield sane results. If necessary, an overlap can be specified, as can be the taper parameter, for example partial_tukey(2/0.2) or partial_tukey(2/0.2/0.5). ov should be smaller than 1 and can be negative.
+ Please note that P, STDDEV and ov are locale specific, so a comma as decimal separator might be required instead of a dot.
More than one -A option (up to 32) may be used. Any function that is specified erroneously is silently dropped. The encoder chooses suitable defaults in the absence of any -A options; any -A option specified replaces the default(s).
When more than one function is specified, then for every subframe the encoder will try each of them separately and choose the window that results in the smallest compressed subframe. Multiple functions can greatly increase the encoding time.
@@ -895,7 +896,7 @@ Set the [min,]max residual partition order. The min value defaults to 0 if unspecified.

- By default the encoder uses a single Rice parameter for the subframe's entire residual. With this option, the residual is iteratively partitioned into 2^min# .. 2^max# pieces, each with its own Rice parameter. Higher values of max# yield diminishing returns. The most bang for the buck is usually with -r 2,2 (more for higher block sizes). This usually shaves off about 1.5%. The technique tends to peak out about when blocksize/(2^n)=128. Use -r 0,16 to force the highest degree of optimization. + By default the encoder uses a single Rice parameter for the subframe's entire residual. With this option, the residual is iteratively partitioned into 2^min# .. 2^max# pieces, each with its own Rice parameter. Higher values of max# yield diminishing returns. The most bang for the buck is usually with -r 2,2 (more for higher block sizes). This usually shaves off about 1.5%. The technique tends to peak out about when blocksize/(2^n)=128. Use -r 0,15 to force the highest degree of optimization. @@ -1025,6 +1026,7 @@ --no-mid-side
--no-ogg
--no-padding
+ --no-preserve-modtime
--no-qlp-coeff-prec-search
--no-residual-gnuplot
--no-residual-text
@@ -1175,16 +1177,9 @@ - - -
- Copyright (c) 2000,2001,2002,2003,2004,2005,2006,2007,2008,2009 Josh Coalson - - SourceForge.net Logo - - CAFE Logo
-
- Valid XHTML 1.0! + Copyright (c) 2000-2009 Josh Coalson +
+ Copyright (c) 2011-2016 Xiph.Org Foundation