home *** CD-ROM | disk | FTP | other *** search
/ Mega A/V / mega_av.zip / mega_av / GRAPHUTL / PBMPLUS.ZIP / PPMQUANT.MAN < prev    next >
Text File  |  1991-08-11  |  2KB  |  67 lines
  1.  
  2.  
  3. ppmquant(1)                Unix Programmer's Manual                ppmquant(1)
  4.  
  5.  
  6. NNNAAAMMMEEE
  7.      ppmquant - quantize the colors in a portable pixmap down to  a  specified
  8.      number
  9.  
  10. SSSYYYNNNOOOPPPSSSIIISSS
  11.      ppppppmmmqqquuuaaannnttt [-fffllloooyyyddd|-fffsss] _n_c_o_l_o_r_s [_p_p_m_f_i_l_e]
  12.      ppppppmmmqqquuuaaannnttt [-fffllloooyyyddd|-fffsss] ---mmmaaappp _m_a_p_f_i_l_e [_p_p_m_f_i_l_e]
  13.  
  14. DDDEEESSSCCCRRRIIIPPPTTTIIIOOONNN
  15.      Reads a portable  pixmap  as  input.   Chooses  _n_c_o_l_o_r_s  colors  to  best
  16.      represent the image, maps the existing colors to the new ones, and writes
  17.      a portable pixmap as output.
  18.  
  19.      The quantization method is Heckbert's "median cut".
  20.  
  21.      Alternately, you can skip the color-choosing step by specifying your  own
  22.      set of colors with the ---mmmaaappp flag.  The _m_a_p_f_i_l_e is just a _p_p_m file; it can
  23.      be any shape, all that matters is the colors in  it.   For  instance,  to
  24.      quantize down to the 8-color IBM TTL color set, you might use:
  25.          P3
  26.          8 1
  27.          255
  28.            0   0   0
  29.          255   0   0
  30.            0 255   0
  31.            0   0 255
  32.          255 255   0
  33.          255   0 255
  34.            0 255 255
  35.          255 255 255
  36.  
  37.      The ---fffllloooyyyddd/-fffsss flag  enables  a  Floyd-Steinberg  error  diffusion  step.
  38.      Floyd-Steinberg   gives   vastly  better  results  on  images  where  the
  39.      unmodified quantization has banding or other artifacts,  especially  when
  40.      going to a small number of colors such as the above IBM set.  However, it
  41.      does take substantially more CPU time, so the default is off.
  42.  
  43.      All flags can be abbreviated to their shortest unique prefix.
  44.  
  45. RRREEEFFFEEERRREEENNNCCCEEESSS
  46.      "Color Image Quantization for Frame Buffer  Display"  by  Paul  Heckbert,
  47.      SIGGRAPH '82 Proceedings, page 297.
  48.  
  49. SSSEEEEEE AAALLLSSSOOO
  50.      pnmdepth(1), ppmquantall(1), ppm(5)
  51.  
  52. AAAUUUTTTHHHOOORRR
  53.      Copyright (C) 1989, 1991 by Jef Poskanzer.
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.                                12 January 1991                               1
  65.  
  66.  
  67.