MAN page from SuSE 8.X flac-1.0.2-2.i386.rpm

FLAC

Section: (1)
Updated: 03 December 2001
Index

NAME

flac - Free Lossless Audio Codec

SYNOPSIS

flac [ OPTION] infile ...

DESCRIPTION

This manual page documents briefly theflac command.

This manual page was written for the Debian GNU/Linuxdistribution because the original program does not have amanual page. Instead, it has documentation in HTMLformat; see below.

OPTIONS

A summary of options is included below. For a completedescription, see the HTML documentation.

GENERIC OPTIONS

-H: Show detailed help screen
-d: Decode (default behavior is encode)
-c: Encode from standard input, or decode tostandard output
-t: Test a flac encoded file (same as -dexcept no decoded file is written)
-a: Analyze a flac encoded file (same as -dexcept an analysis file is written)
-s: Silent mode (do not write runtimeencode/decode statistics to stdout)
-o filename: Force the output file name (usually flac justchanges the extension). May only be used whenencoding a single file. May not be used inconjunction with --output-prefix.
--output-prefix string: Prefix each output file name with the givenstring. This can be useful for encoding/decodingfiles to a different directory. Make sure if yourstring is a path name that it ends with a trailing`/' (slash).
--delete-input-file: Automatically delete the input file after asuccessful encode or decode. If there was anerror (including a verify error) the input fileis left intact.
--skip samples: Skip the specified number of samples at thebeginning of the input file (can be used for bothencoding and decoding)

ANALYSIS OPTIONS

--a-rtext: Includes the residual signal in the analysisfile. This will make the file very big, muchlarger than even the decoded file.
--a-rgp: Generates a gnuplot file for every subframe;each file will contain the residual distributionof the subframe. This will create a lot offiles.

ENCODING OPTIONS

--ogg

When encoding, generate Ogg-FLAC output insteadof native-FLAC. Ogg-FLAC streams are FLAC streamswrapped in an Ogg transport layer. The resultingfile should have an '.ogg' extension and will stillbe decodable by flac.

When decoding, force the input to be treated asOgg-FLAC. This is useful when piping input fromstdin or when the filename does not end in '.ogg'.

--lax

Allow encoder to generate non-Subsetfiles.

--sector-align

Align encoding of multiple CD format WAVEfiles on sector boundaries. See the HTMLdocumentation for more information.

-S { # | X | #x }

Include a point or points in a SEEKTABLE. Using #,a seek point at that sample number is added. UsingX, a placeholder point is added at the end of a thetable. Using #x, # evenly spaced seek points willbe added, the first being at sample 0. You may usemany -S options; the resulting SEEKTABLE will be theunique-ified union of all such values. With no -Soptions, flac defaults to '-S 100x'. Use -S- forno SEEKTABLE. Note: '-S #x' will not work if theencoder can't determine the input size beforestarting. Note: if you use '-S #' and # is >=samples in the input, there will be either no seekpoint entered (if the input size is determinablebefore encoding starts) or a placeholder point (ifinput size is not determinable).

-P bytes

Tell the encoder to write a PADDING metadatablock of the given length (in bytes) after theSTREAMINFO block. -P 0 implies no PADDING block,which is the default. This is useful if you planto tag the file later with an APPLICATION block;instead of having to rewrite the entire file laterjust to insert your block, you can write directlyover the PADDING block.

-b blocksize

Default is 1152 for -l 0, else 4608; must be192/576/1152/2304/4608/256/512/1024/2048/4096/8192/16384/32768(unless --lax is used)

-m

Try mid-side coding for each frame (stereoinput only)

-M

Loose mid-side coding for all frames (stereoinput only)

-0..-8

Fastest compression..highest compression(default is -5). These are synonyms for otheroptions:

-0: Synonymous with -l 0 -b 1152 -r 2,2
-1: Synonymous with -l 0 -b 1152 -M -r 2,2
-2: Synonymous with -l 0 -b 1152 -m -r 3
-3: Synonymous with -l 6 -b 4608 -r 3,3
-4: Synonymous with -l 8 -b 4608 -M -r 3,3
-5: Synonymous with -l 8 -b 4608 -m -r 3,3
-6: Synonymous with -l 8 -b 4608 -m -r 4
-7: Synonymous with -l 8 -b 4608 -m -e -r 6
-8: Synonymous with -l 12 -b 4608 -m -e -r 6

-e

Do exhaustive model search(expensive!)

-E

Do escape coding in the entropy coder. Thiscauses the encoder to use an unencoded representationof the residual in a partition if it is smaller. Itincreases the runtime and usually results in animprovement of less than 1%.

-l max_lpc_order

0 => use only fixed predictors

-p

Do exhaustive search of LP coefficientquantization (expensive!). Overrides -q,does nothing if using -l 0

-q bits

Precision of the quantized linear-predictorcoefficients, 0 => let encoder decide (min is 5,default is 0)

-r [level,]level

Set the [min,]max residual partition order(0..16). min defaults to 0 if unspecified. Defaultis -r 3,3.

-R #

Set the Rice parameter search distance.Default is 0.

-V

Verify a correct encoding by decoding theoutput in parallel and comparing to theoriginal

-S- -m- -M- -e- -E- -p- -V- --delete-input-file- --lax- --ogg-

These flags can be used to invert the senseof the corresponding normal option.

FORMAT OPTIONS

-fb: Big-endian byte order
-fl: Little-endian byte order
-fc channels: Set number of channels.
-fp bits_per_sample: Set bits per sample.
-fs sample_rate: Set sample rate (in Hz).
-fu: Unsigned samples (default is signed)
-fr: Force to raw format (even if filename endsin .wav).

AUTHOR

This manual page was written by Matt Zimmerman <mdzAATTdebian.org> forthe Debian GNU/Linux system (but may be used by others).

SEE ALSO

AUTHOR

This document was created byman2html,using the manual pages.