home *** CD-ROM | disk | FTP | other *** search
/ Mega A/V / mega_av.zip / mega_av / GRAPHUTL / PBMPLUS.ZIP / PGMTOPBM.MAN < prev    next >
Text File  |  1991-08-11  |  2KB  |  67 lines
  1.  
  2.  
  3. pgmtopbm(1)                Unix Programmer's Manual                pgmtopbm(1)
  4.  
  5.  
  6. NNNAAAMMMEEE
  7.      pgmtopbm - convert a portable graymap into a portable bitmap
  8.  
  9. SSSYYYNNNOOOPPPSSSIIISSS
  10.      pppgggmmmtttooopppbbbmmm [-fffllloooyyyddd|-fffsss|-ttthhhrrreeessshhhooolllddd|-dddiiittthhheeerrr888| [-vvvaaallluuueee _v_a_l] [_p_g_m_f_i_l_e]
  11.  
  12. DDDEEESSSCCCRRRIIIPPPTTTIIIOOONNN
  13.      Reads a portable graymap as input.  Produces a portable bitmap as output.
  14.  
  15.      Note that there is no pbmtopgm converter, because  any  pgm  program  can
  16.      read pbm files automagically.
  17.  
  18. OOOPPPTTTIIIOOONNNSSS
  19.  
  20.      The default quantization method is boustrophedonic Floyd-Steinberg  error
  21.      diffusion (-fffllloooyyyddd).  Also available are simple thresholding (-ttthhhrrreeessshhhooolllddd);
  22.      Bayer's  ordered  dither  (-dddiiittthhheeerrr888)  with  a  16x16  matrix;  and  three
  23.      different  sizes of 45-degree clustered-dot dither (-cccllluuusssttteeerrr333, ---cccllluuusssttteeerrr444,
  24.      ---cccllluuusssttteeerrr888).
  25.  
  26.      Floyd-Steinberg  will  almost  always  give  the  best  looking  results;
  27.      however,  looking  good  is  not  always  what  you  want.  For instance,
  28.      thresholding can be used in a pipeline with the _p_n_m_c_o_n_v_o_l tool, for tasks
  29.      like  edge  and  peak  detection.   And  clustered-dot  dithering gives a
  30.      newspaper-ish look, a useful special effect.
  31.  
  32.      The ---vvvaaallluuueee flag alters the thresholding  value  for  Floyd-Steinberg  and
  33.      simple  thresholding.  It should be a real number between 0 and 1.  Above
  34.      0.5 means darker images; below 0.5 means lighter.
  35.  
  36.      All flags can be abbreviated to their shortest unique prefix.
  37.  
  38. RRREEEFFFEEERRREEENNNCCCEEESSS
  39.      The only reference you need for this stuff  is  "Digital  Halftoning"  by
  40.      Robert Ulichney, MIT Press, ISBN 0-262-21009-6.
  41.  
  42. SSSEEEEEE AAALLLSSSOOO
  43.      pbmreduce(1), pgm(5), pbm(5), pnmconvol(1)
  44.  
  45. AAAUUUTTTHHHOOORRR
  46.      Copyright (C) 1989 by Jef Poskanzer.
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.                                 26 July 1988                                 1
  65.  
  66.  
  67.