home *** CD-ROM | disk | FTP | other *** search
/ Chip 2004 November / Chip_2004-11_cd1.bin / software / optipng / USAGE.txt < prev   
Text File  |  2004-05-31  |  3KB  |  59 lines
  1. OptiPNG 0.4.5: Advanced PNG optimizer.
  2. Copyright (C) 2001-2004 Cosmin Truta.
  3.  
  4. This program is open-source software. See LICENSE for more details.
  5. Compiled with libpng version 1.0.15-cos2 and zlib version 1.2.1.f-cos2
  6.  
  7. Usage:
  8.     optipng [options] files.png ...
  9. Basic options:
  10.     -h, -help        show this help
  11.     -v            verbose mode / show copyright, version and build info
  12.     -o  <level>        optimization level (0-7)        default 2
  13.     -i  <type>        interlace type (0-1)            default <input>
  14.     -k, -keep        keep a backup of the input files
  15.     -log        log messages to "optipng.log"
  16.     -q, -quiet        quiet mode
  17. Advanced options:
  18.     -zc <levels>    zlib compression levels (1-9)        default 9
  19.     -zm <levels>    zlib memory levels (1-9)        default 8
  20.     -zs <strategies>    zlib compression strategies (0-3)    default 0-3
  21.     -zw <window size>    zlib window size (32k,16k,8k,4k,2k,1k,512)
  22.     -f  <filters>    PNG delta filters (0-5)            default 0,5
  23.     -nb            no bit depth reduction
  24.     -nc            no color type reduction
  25.     -no            no output (simulation mode)
  26.     -np            no palette reduction
  27.     -nz            no IDAT recompression (also disable reductions)
  28.     -fix        enable error recovery
  29.     -force        write a new output even if it is larger than the input
  30.     -preserve        preserve file attributes if possible
  31.     --            stop option switch parsing
  32. Optimization level presets:
  33.     -o0  <=>  -nz
  34.     -o1  <=>  [apply libpng heuristics]        (1 trial)
  35.     -o2  <=>  -zc9 -zm8 -zs0-3 -f0,5        (8 trials)
  36.     -o3  <=>  -zc9 -zm8-9 -zs0-3 -f0,5        (16 trials)
  37.     -o4  <=>  -zc9 -zm8 -zs0-3 -f0-5        (24 trials)
  38.     -o5  <=>  -zc9 -zm8-9 -zs0-3 -f0-5        (48 trials)
  39.     -o6  <=>  -zc1-9 -zm8 -zs0-3 -f0-5        (120 trials)
  40.     -o7  <=>  -zc1-9 -zm8-9 -zs0-3 -f0-5    (240 trials)
  41. Examples:
  42.     optipng -o5 file.png            (moderately slow)
  43.     optipng -o7 file.png            (very slow)
  44.     optipng -i1 -zc4,9 -zs0-2 -f0-2,4-5 file1.png file2.png
  45. Notes:
  46.   - The options are cummulative; e.g.
  47.     -f0 -f5  <=>  -f0,5
  48.     -zs0 -zs1 -zs2  <=>  -zs0,1,2  <=>  -zs0-2
  49.   - The option letters are case-insensitive.
  50.   - The libpng heuristics consist of:
  51.     -o1  <=>  -zc9 -zm8 -zs0 -f0        (if PLTE is present)
  52.     -o1  <=>  -zc9 -zm8 -zs1 -f5        (if PLTE is not present)
  53.   - The zlib window size is set to a minimum that does not affect
  54.     the compression ratio.
  55.   - The output file will have all IDAT in a single chunk, even if
  56.     no recompression is performed.
  57.   - The most exhaustive search  -zc1-9 -zm1-9 -zs0-3 -f0-5  (1080 trials)
  58.     is offered only as an advanced option, and it is not recommended.
  59.