- printf(" -P # : write a PADDING block of length # (goes after SEEKTABLE)\n");
- printf(" (# must be >= 0; default is -P-). Note that the overall size in bytes\n");
- printf(" of the PADDING block will be # + 4 because of the metadata header.\n");
- printf(" -b # : specify blocksize in samples; default is 1152 for -l 0, else 4608;\n");
- printf(" must be 192/576/1152/2304/4608/256/512/1024/2048/4096/8192/16384/32768\n");
- printf(" (unless --lax is used)\n");
- printf(" -m : try mid-side coding for each frame (stereo input only)\n");
- printf(" -M : adaptive mid-side coding for all frames (stereo input only)\n");
- printf(" -0 .. -8 : fastest compression .. highest compression, default is -5\n");
- printf(" these are synonyms for other options:\n");
- printf(" -0 : synonymous with -l 0 -b 1152 -r 2,2\n");
- printf(" -1 : synonymous with -l 0 -b 1152 -M -r 2,2\n");
- printf(" -2 : synonymous with -l 0 -b 1152 -m -r 3\n");
- printf(" -3 : synonymous with -l 6 -b 4608 -r 3,3\n");
- printf(" -4 : synonymous with -l 8 -b 4608 -M -r 3,3\n");
- printf(" -5 : synonymous with -l 8 -b 4608 -m -r 3,3\n");
- printf(" -6 : synonymous with -l 8 -b 4608 -m -r 4\n");
- printf(" -7 : synonymous with -l 8 -b 4608 -m -e -r 6\n");
- printf(" -8 : synonymous with -l 12 -b 4608 -m -e -r 6\n");
- printf(" --fast, --best : synonymous with -0 and -8 respectively\n");
- printf(" -e : do exhaustive model search (expensive!)\n");
- printf(" -E : include escape coding in the entropy coder\n");
- printf(" -l # : specify max LPC order; 0 => use only fixed predictors\n");
- printf(" -p : do exhaustive search of LP coefficient quantization (expensive!);\n");
- printf(" overrides -q, does nothing if using -l 0\n");
- printf(" -q # : specify precision in bits of quantized linear-predictor coefficients;\n");
- printf(" 0 => let encoder decide (min is %u, default is -q 0)\n", FLAC__MIN_QLP_COEFF_PRECISION);
- printf(" -r [#,]# : [min,]max residual partition order (# is 0..16; min defaults to 0;\n");
- printf(" default is -r 0; above 4 doesn't usually help much)\n");
-#if 0
-@@@ removed because it doesnt work yet and is too dangerous for users
- printf(" -R # : Rice parameter search distance (# is 0..32; above 2 doesn't help much)\n");
+ printf(" -P, --padding=# Tell the encoder to write a PADDING metadata\n");
+ printf(" block of the given length (in bytes) after the\n");
+ printf(" STREAMINFO block. This is useful if you plan\n");
+ printf(" to tag the file later with an APPLICATION\n");
+ printf(" block; instead of having to rewrite the entire\n");
+ printf(" file later just to insert your block, you can\n");
+ printf(" write directly over the PADDING block. Note\n");
+ printf(" that the total length of the PADDING block will\n");
+ printf(" be 4 bytes longer than the length given because\n");
+ printf(" of the 4 metadata block header bytes. You can\n");
+ printf(" force no PADDING block at all to be written with\n");
+ printf(" --no-padding. The encoder writes a PADDING\n");
+ printf(" block of 8192 bytes by default, or 65536 bytes\n");
+ printf(" if the input audio is more than 20 minutes long.\n");
+ printf(" -b, --blocksize=# Specify the blocksize in samples; the default is\n");
+ printf(" 1152 for -l 0, else 4096; must be one of 192,\n");
+ printf(" 576, 1152, 2304, 4608, 256, 512, 1024, 2048,\n");
+ printf(" 4096 (and 8192 or 16384 if the sample rate is\n");
+ printf(" >48kHz) for Subset streams.\n");
+ printf(" -0, --compression-level-0, --fast Synonymous with -l 0 -b 1152 -r 3\n");
+ printf(" -1, --compression-level-1 Synonymous with -l 0 -b 1152 -M -r 3\n");
+ printf(" -2, --compression-level-2 Synonymous with -l 0 -b 1152 -m -r 3\n");
+ printf(" -3, --compression-level-3 Synonymous with -l 6 -b 4096 -r 4\n");
+ printf(" -4, --compression-level-4 Synonymous with -l 8 -b 4096 -M -r 4\n");
+ printf(" -5, --compression-level-5 Synonymous with -l 8 -b 4096 -m -r 5\n");
+ printf(" -5 is the default setting\n");
+ printf(" -6, --compression-level-6 Synonymous with -l 8 -b 4096 -m -r 6\n");
+ printf(" -7, --compression-level-7 Synonymous with -l 8 -b 4096 -m -e -r 6\n");
+ printf(" -8, --compression-level-8, --best Synonymous with -l 12 -b 4096 -m -e -r 6\n");
+ printf(" -m, --mid-side Try mid-side coding for each frame\n");
+ printf(" (stereo only)\n");
+ printf(" -M, --adaptive-mid-side Adaptive mid-side coding for all frames\n");
+ printf(" (stereo only)\n");
+ printf(" -e, --exhaustive-model-search Do exhaustive model search (expensive!)\n");
+ printf(" -A, --apodization=\"function\" Window audio data with given the function.\n");
+ printf(" The functions are: bartlett, bartlett_hann,\n");
+ printf(" blackman, blackman_harris_4term_92db,\n");
+ printf(" connes, flattop, gauss(STDDEV), hamming,\n");
+ printf(" hann, kaiser_bessel, nuttall, rectangle,\n");
+ printf(" triangle, tukey(P), welch. More than one\n");
+ printf(" may be specified but encoding time is a\n");
+ printf(" multiple of the number of functions since\n");
+ printf(" they are each tried in turn. The encoder\n");
+ printf(" chooses suitable defaults in the absence\n");
+ printf(" of any -A options.\n");
+ printf(" -l, --max-lpc-order=# Max LPC order; 0 => only fixed predictors.\n");
+ printf(" Must be <= 12 for Subset streams if sample\n");
+ printf(" rate is <=48kHz.\n");
+ printf(" -p, --qlp-coeff-precision-search Do exhaustive search of LP coefficient\n");
+ printf(" quantization (expensive!); overrides -q;\n");
+ printf(" does nothing if using -l 0\n");
+ printf(" -q, --qlp-coeff-precision=# Specify precision in bits of quantized\n");
+ printf(" linear-predictor coefficients; 0 => let\n");
+ printf(" encoder decide (the minimun is %u, the\n", FLAC__MIN_QLP_COEFF_PRECISION);
+ printf(" default is -q 0)\n");
+ printf(" -r, --rice-partition-order=[#,]# Set [min,]max residual partition order\n");
+ printf(" (# is 0..16; min defaults to 0; the\n");
+ printf(" default is -r 0; above 4 doesn't usually\n");
+ printf(" help much)\n");
+ printf("format options:\n");
+ printf(" --endian={big|little} Set byte order for samples\n");
+ printf(" --channels=# Number of channels\n");
+ printf(" --bps=# Number of bits per sample\n");
+ printf(" --sample-rate=# Sample rate in Hz\n");
+ printf(" --sign={signed|unsigned} Sign of samples (the default is signed)\n");
+ printf(" --input-size=# Size of the raw input in bytes. If you are\n");
+ printf(" encoding raw samples from stdin, you must set\n");
+ printf(" this option in order to be able to use --skip,\n");
+ printf(" --until, --cuesheet, or other options that need\n");
+ printf(" to know the size of the input beforehand. If\n");
+ printf(" the size given is greater than what is found in\n");
+ printf(" the input stream, the encoder will complain\n");
+ printf(" about an unexpected end-of-file. If the size\n");
+ printf(" given is less, samples will be truncated.\n");
+ printf(" --force-raw-format Force input (when encoding) or output (when\n");
+ printf(" decoding) to be treated as raw samples\n");
+ printf(" --force-aiff-format Force the decoder to output AIFF format. This\n");
+ printf(" option is not needed if the output filename (as\n");
+ printf(" set by -o) ends with .aif or .aiff; this option\n");
+ printf(" has no effect when encoding since input AIFF is\n");
+ printf(" auto-detected.\n");
+ printf(" --force-rf64-format Force the decoder to output RF64 format. This\n");
+ printf(" option is not needed if the output filename (as\n");
+ printf(" set by -o) ends with .rf64; this option\n");
+ printf(" has no effect when encoding since input RF64 is\n");
+ printf(" auto-detected.\n");
+ printf(" --force-wave64-format Force the decoder to output Wave64 format. This\n");
+ printf(" option is not needed if the output filename (as\n");
+ printf(" set by -o) ends with .w64; this option\n");
+ printf(" has no effect when encoding since input Wave64 is\n");
+ printf(" auto-detected.\n");
+ printf("negative options:\n");
+ printf(" --no-adaptive-mid-side\n");
+ printf(" --no-cued-seekpoints\n");
+ printf(" --no-decode-through-errors\n");
+ printf(" --no-delete-input-file\n");
+ printf(" --no-preserve-modtime\n");
+ printf(" --no-keep-foreign-metadata\n");
+ printf(" --no-exhaustive-model-search\n");
+ printf(" --no-lax\n");
+ printf(" --no-mid-side\n");
+#if FLAC__HAS_OGG
+ printf(" --no-ogg\n");