home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 2 / crawlyvol2.bin / graphics / jpeg5 / source / doc / djpeg.man < prev    next >
Text File  |  1994-10-25  |  10KB  |  265 lines
  1.  
  2.  
  3.  
  4. DJPEG(1)                                                 DJPEG(1)
  5.  
  6.  
  7. N✓NA✓AM✓ME✓E
  8.        djpeg - decompress a JPEG file to an image file
  9.  
  10. S✓SY✓YN✓NO✓OP✓PS✓SI✓IS✓S
  11.        d✓dj✓jp✓pe✓eg✓g [ _✓o_✓p_✓t_✓i_✓o_✓n_✓s ] [ _✓f_✓i_✓l_✓e_✓n_✓a_✓m_✓e ]
  12.  
  13.  
  14. D✓DE✓ES✓SC✓CR✓RI✓IP✓PT✓TI✓IO✓ON✓N
  15.        d✓dj✓jp✓pe✓eg✓g  decompresses  the  named JPEG file, or the standard
  16.        input if no file is named, and produces an image  file  on
  17.        the  standard output.  PBMPLUS (PPM/PGM), BMP, GIF, Targa,
  18.        or  RLE  (Utah  Raster  Toolkit)  output  format  can   be
  19.        selected.   (RLE  is  supported only if the URT library is
  20.        available.)
  21.  
  22. O✓OP✓PT✓TI✓IO✓ON✓NS✓S
  23.        All  switch  names  may  be  abbreviated;   for   example,
  24.        -✓-g✓gr✓ra✓ay✓ys✓sc✓ca✓al✓le✓e  may  be  written  -✓-g✓gr✓ra✓ay✓y  or  -✓-g✓gr✓r.  Most of the
  25.        "basic" switches can be abbreviated to as  little  as  one
  26.        letter.  Upper and lower case are equivalent (thus -✓-G✓GI✓IF✓F is
  27.        the same as -✓-g✓gi✓if✓f).  British spellings  are  also  accepted
  28.        (e.g.,  -✓-g✓gr✓re✓ey✓ys✓sc✓ca✓al✓le✓e), though for brevity these are not men¡
  29.        tioned below.
  30.  
  31.        The basic switches are:
  32.  
  33.        -✓-c✓co✓ol✓lo✓or✓rs✓s _✓N
  34.               Reduce image to at most N colors.  This reduces the
  35.               number  of colors used in the output image, so that
  36.               it can be displayed on  a  colormapped  display  or
  37.               stored  in a colormapped file format.  For example,
  38.               if you have an 8-bit display, you'd need to  reduce
  39.               to 256 or fewer colors.
  40.  
  41.        -✓-q✓qu✓ua✓an✓nt✓ti✓iz✓ze✓e _✓N
  42.               Same  as -✓-c✓co✓ol✓lo✓or✓rs✓s.  -✓-c✓co✓ol✓lo✓or✓rs✓s is the recommended name,
  43.               -✓-q✓qu✓ua✓an✓nt✓ti✓iz✓ze✓e is provided only for  backwards  compati¡
  44.               bility.
  45.  
  46.        -✓-f✓fa✓as✓st✓t  Select recommended processing options for fast, low
  47.               quality output.  (The default  options  are  chosen
  48.               for  highest  quality  output.)  Currently, this is
  49.               equivalent to -✓-d✓dc✓ct✓t f✓fa✓as✓st✓t -✓-n✓no✓os✓sm✓mo✓oo✓ot✓th✓h -✓-o✓on✓ne✓ep✓pa✓as✓ss✓s  -✓-d✓di✓it✓th✓he✓er✓r
  50.               o✓or✓rd✓de✓er✓re✓ed✓d.
  51.  
  52.        -✓-g✓gr✓ra✓ay✓ys✓sc✓ca✓al✓le✓e
  53.               Force gray-scale output even if JPEG file is color.
  54.               Useful for viewing on  monochrome  displays;  also,
  55.               d✓dj✓jp✓pe✓eg✓g runs noticeably faster in this mode.
  56.  
  57.        -✓-s✓sc✓ca✓al✓le✓e _✓M_✓/_✓N
  58.               Scale  the output image by a factor M/N.  Currently
  59.               the scale factor must be 1/1,  1/2,  1/4,  or  1/8.
  60.               Scaling  is  handy if the image is larger than your
  61.  
  62.  
  63.  
  64.                           28 August 1994                        1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. DJPEG(1)                                                 DJPEG(1)
  71.  
  72.  
  73.               screen; also, d✓dj✓jp✓pe✓eg✓g runs much faster  when  scaling
  74.               down the output.
  75.  
  76.        -✓-b✓bm✓mp✓p   Select  BMP  output format (Windows flavor).  8-bit
  77.               colormapped  format  is  emitted  if   -✓-c✓co✓ol✓lo✓or✓rs✓s   or
  78.               -✓-g✓gr✓ra✓ay✓ys✓sc✓ca✓al✓le✓e  is  specified,  or  if the JPEG file is
  79.               gray-scale; otherwise, 24-bit full-color format  is
  80.               emitted.
  81.  
  82.        -✓-g✓gi✓if✓f   Select  GIF output format.  Since GIF does not sup¡
  83.               port more than 256 colors, -✓-c✓co✓ol✓lo✓or✓rs✓s 2✓25✓56✓6  is  assumed
  84.               (unless you specify a smaller number of colors).
  85.  
  86.        -✓-o✓os✓s2✓2   Select  BMP output format (OS/2 1.x flavor).  8-bit
  87.               colormapped  format  is  emitted  if   -✓-c✓co✓ol✓lo✓or✓rs✓s   or
  88.               -✓-g✓gr✓ra✓ay✓ys✓sc✓ca✓al✓le✓e  is  specified,  or  if the JPEG file is
  89.               gray-scale; otherwise, 24-bit full-color format  is
  90.               emitted.
  91.  
  92.        -✓-p✓pn✓nm✓m   Select PBMPLUS (PPM/PGM) output format (this is the
  93.               default format).  PGM is emitted if the  JPEG  file
  94.               is gray-scale or if -✓-g✓gr✓ra✓ay✓ys✓sc✓ca✓al✓le✓e is specified; other¡
  95.               wise PPM is emitted.
  96.  
  97.        -✓-r✓rl✓le✓e   Select RLE output format.  (Requires URT  library.)
  98.  
  99.        -✓-t✓ta✓ar✓rg✓ga✓a Select  Targa  output format.  Gray-scale format is
  100.               emitted if  the  JPEG  file  is  gray-scale  or  if
  101.               -✓-g✓gr✓ra✓ay✓ys✓sc✓ca✓al✓le✓e  is  specified;  otherwise,  colormapped
  102.               format is emitted if -✓-c✓co✓ol✓lo✓or✓rs✓s is  specified;  other¡
  103.               wise, 24-bit full-color format is emitted.
  104.  
  105.        Switches for advanced users:
  106.  
  107.        -✓-d✓dc✓ct✓t i✓in✓nt✓t
  108.               Use integer DCT method (default).
  109.  
  110.        -✓-d✓dc✓ct✓t f✓fa✓as✓st✓t
  111.               Use fast integer DCT (less accurate).
  112.  
  113.        -✓-d✓dc✓ct✓t f✓fl✓lo✓oa✓at✓t
  114.               Use  floating-point DCT method.  The floating-point
  115.               method is the most accurate, but will be the  slow¡
  116.               est  unless  your  machine  has very fast floating-
  117.               point hardware.  Also  note  that  results  of  the
  118.               floating-point  method  may  vary  slightly  across
  119.               machines, while the integer methods should give the
  120.               same  results  everywhere.  The fast integer method
  121.               is much less accurate than the other two.
  122.  
  123.        -✓-d✓di✓it✓th✓he✓er✓r f✓fs✓s
  124.               Use Floyd-Steinberg dithering  in  color  quantiza¡
  125.               tion.
  126.  
  127.  
  128.  
  129.  
  130.                           28 August 1994                        2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. DJPEG(1)                                                 DJPEG(1)
  137.  
  138.  
  139.        -✓-d✓di✓it✓th✓he✓er✓r o✓or✓rd✓de✓er✓re✓ed✓d
  140.               Use ordered dithering in color quantization.
  141.  
  142.        -✓-d✓di✓it✓th✓he✓er✓r n✓no✓on✓ne✓e
  143.               Do  not  use  dithering  in color quantization.  By
  144.               default, Floyd-Steinberg dithering is applied  when
  145.               quantizing  colors;  this  is slow but usually pro¡
  146.               duces the best results.  Ordered dither is  a  com¡
  147.               promise  between speed and quality; no dithering is
  148.               fast but usually  looks  awful.   Note  that  these
  149.               switches  have  no effect unless color quantization
  150.               is being done.  Ordered dither is only available in
  151.               -✓-o✓on✓ne✓ep✓pa✓as✓ss✓s mode.
  152.  
  153.        -✓-m✓ma✓ap✓p _✓f_✓i_✓l_✓e
  154.               Quantize  to the colors used in the specified image
  155.               file.  This is useful for producing multiple  files
  156.               with  identical color maps, or for forcing a prede¡
  157.               fined set of colors to be used.  The _✓f_✓i_✓l_✓e must be a
  158.               GIF  or PPM file. This option overrides -✓-c✓co✓ol✓lo✓or✓rs✓s and
  159.               -✓-o✓on✓ne✓ep✓pa✓as✓ss✓s.
  160.  
  161.        -✓-n✓no✓os✓sm✓mo✓oo✓ot✓th✓h
  162.               Use a faster, lower-quality upsampling routine.
  163.  
  164.        -✓-o✓on✓ne✓ep✓pa✓as✓ss✓s
  165.               Use one-pass instead of  two-pass  color  quantiza¡
  166.               tion.  The one-pass method is faster and needs less
  167.               memory, but  it  produces  a  lower-quality  image.
  168.               -✓-o✓on✓ne✓ep✓pa✓as✓ss✓s  is ignored unless you also say -✓-c✓co✓ol✓lo✓or✓rs✓s _✓N.
  169.               Also, the one-pass method is always used for  gray-
  170.               scale output (the two-pass method is no improvement
  171.               then).
  172.  
  173.        -✓-m✓ma✓ax✓xm✓me✓em✓mo✓or✓ry✓y _✓N
  174.               Set limit for amount of memory to use in processing
  175.               large  images.   Value is in thousands of bytes, or
  176.               millions of bytes if "M" is attached to the number.
  177.               For  example,  -✓-m✓ma✓ax✓x  4✓4m✓m  selects 4000000 bytes.  If
  178.               more space is needed, temporary files will be used.
  179.  
  180.        -✓-o✓ou✓ut✓tf✓fi✓il✓le✓e _✓n_✓a_✓m_✓e
  181.               Send  output  image to the named file, not to stan¡
  182.               dard output.
  183.  
  184.        -✓-v✓ve✓er✓rb✓bo✓os✓se✓e
  185.               Enable debug printout.  More -✓-v✓v's give more output.
  186.               Also, version information is printed at startup.
  187.  
  188.        -✓-d✓de✓eb✓bu✓ug✓g Same as -✓-v✓ve✓er✓rb✓bo✓os✓se✓e.
  189.  
  190. E✓EX✓XA✓AM✓MP✓PL✓LE✓ES✓S
  191.        This example decompresses the JPEG file foo.jpg, automati¡
  192.        cally quantizes to 256 colors, and saves the output in GIF
  193.  
  194.  
  195.  
  196.                           28 August 1994                        3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. DJPEG(1)                                                 DJPEG(1)
  203.  
  204.  
  205.        format in foo.gif:
  206.  
  207.               d✓dj✓jp✓pe✓eg✓g -✓-g✓gi✓if✓f _✓f_✓o_✓o_✓._✓j_✓p_✓g >✓> _✓f_✓o_✓o_✓._✓g_✓i_✓f
  208.  
  209. H✓HI✓IN✓NT✓TS✓S
  210.        To  get  a  quick  preview of an image, use the -✓-g✓gr✓ra✓ay✓ys✓sc✓ca✓al✓le✓e
  211.        and/or -✓-s✓sc✓ca✓al✓le✓e switches.   -✓-g✓gr✓ra✓ay✓ys✓sc✓ca✓al✓le✓e  -✓-s✓sc✓ca✓al✓le✓e  1✓1/✓/8✓8  is  the
  212.        fastest case.
  213.  
  214.        Several options are available that trade off image quality
  215.        to gain speed.  -✓-f✓fa✓as✓st✓t turns on the recommended settings.
  216.  
  217.        -✓-d✓dc✓ct✓t f✓fa✓as✓st✓t and/or -✓-n✓no✓os✓sm✓mo✓oo✓ot✓th✓h gain speed at a small sacrifice
  218.        in  quality.   When  producing  a  color-quantized  image,
  219.        -✓-o✓on✓ne✓ep✓pa✓as✓ss✓s -✓-d✓di✓it✓th✓he✓er✓r o✓or✓rd✓de✓er✓re✓ed✓d is fast but  much  lower  quality
  220.        than  the default behavior.  -✓-d✓di✓it✓th✓he✓er✓r n✓no✓on✓ne✓e may give accept¡
  221.        able results in two-pass mode, but is seldom tolerable  in
  222.        one-pass mode.
  223.  
  224.        If  you  are  fortunate  enough to have very fast floating
  225.        point hardware, -✓-d✓dc✓ct✓t f✓fl✓lo✓oa✓at✓t may be even  faster  than  -✓-d✓dc✓ct✓t
  226.        f✓fa✓as✓st✓t.
  227.  
  228. E✓EN✓NV✓VI✓IR✓RO✓ON✓NM✓ME✓EN✓NT✓T
  229.        J✓JP✓PE✓EG✓GM✓ME✓EM✓M
  230.               If  this  environment variable is set, its value is
  231.               the default memory limit.  The value  is  specified
  232.               as  described  for  the -✓-m✓ma✓ax✓xm✓me✓em✓mo✓or✓ry✓y switch.  J✓JP✓PE✓EG✓GM✓ME✓EM✓M
  233.               overrides the default value specified when the pro¡
  234.               gram  was  compiled, and itself is overridden by an
  235.               explicit -✓-m✓ma✓ax✓xm✓me✓em✓mo✓or✓ry✓y.
  236.  
  237. S✓SE✓EE✓E A✓AL✓LS✓SO✓O
  238.        c✓cj✓jp✓pe✓eg✓g(1), r✓rd✓dj✓jp✓pg✓gc✓co✓om✓m(1), w✓wr✓rj✓jp✓pg✓gc✓co✓om✓m(1)
  239.        p✓pp✓pm✓m(5), p✓pg✓gm✓m(5)
  240.        Wallace, Gregory K.  "The JPEG Still  Picture  Compression
  241.        Standard", Communications of the ACM, April 1991 (vol. 34,
  242.        no. 4), pp. 30-44.
  243.  
  244. A✓AU✓UT✓TH✓HO✓OR✓R
  245.        Independent JPEG Group
  246.  
  247. B✓BU✓UG✓GS✓S
  248.        Arithmetic coding is not supported for legal reasons.
  249.  
  250.        Still not as fast as we'd like.
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.                           28 August 1994                        4
  263.  
  264.  
  265.