home *** CD-ROM | disk | FTP | other *** search
/ Mega A/V / mega_av.zip / mega_av / GRAPHUTL / PBMPLUS.ZIP / PBMMASK.MAN < prev    next >
Text File  |  1991-08-11  |  3KB  |  67 lines
  1.  
  2.  
  3. pbmmask(1)                 Unix Programmer's Manual                 pbmmask(1)
  4.  
  5.  
  6. NNNAAAMMMEEE
  7.      pbmmask - create a mask bitmap from a regular bitmap
  8.  
  9. SSSYYYNNNOOOPPPSSSIIISSS
  10.      pppbbbmmmmmmaaassskkk [-eeexxxpppaaannnddd] [_p_b_m_f_i_l_e]
  11.  
  12. DDDEEESSSCCCRRRIIIPPPTTTIIIOOONNN
  13.      Reads a portable bitmap as input.  Creates a  corresponding  mask  bitmap
  14.      and writes it out.
  15.  
  16.      The color to be interpreted as "background" is determined  automatically.
  17.      Regardless of which color is background, the mask will be white where the
  18.      background is and black where the figure is.
  19.  
  20.      This lets you do a masked paste like  this,  for  objects  with  a  black
  21.      background:
  22.          pbmmask obj > objmask
  23.          pbmpaste < dest -and objmask <x> <y> | pbmpaste -or obj <x> <y>
  24.      For objects with a white background, you can either invert them or add  a
  25.      step:
  26.          pbmmask obj > objmask
  27.          pnminvert objmask | pbmpaste -and obj 0 0 > blackback
  28.          pbmpaste < dest -and objmask <x> <y> | pbmpaste -or blackback <x> <y>
  29.      Note  that  this  three-step  version  works  for  objects   with   black
  30.      backgrounds too, if you don't care about the wasted time.
  31.  
  32.      You can also use masks with graymaps  and  pixmaps,  using  the  _p_n_m_a_r_i_t_h
  33.      tool.  For instance:
  34.          ppmtopgm obj.ppm | pgmtopbm -threshold | pbmmask > objmask.pbm
  35.          pnmarith -multiply dest.ppm objmask.pbm > t1.ppm
  36.          pnminvert objmask.pbm | pnmarith -multiply obj.ppm - > t2.ppm
  37.          pnmarith -add t1.ppm t2.ppm
  38.      An interesting variation  on  this  is  to  pipe  the  mask  through  the
  39.      _p_n_m_s_m_o_o_t_h  script  before  using it.  This makes the boundary between the
  40.      two images less sharp.
  41.  
  42.      ---eeexxxpppaaannnddd
  43.           Expands the mask by one pixel out from the image.  This is useful if
  44.           you  want  a  little  white  border  around  your  image.  (A better
  45.           solution might be to turn the _p_b_m_l_i_f_e tool into a  general  cellular
  46.           automaton tool...)
  47.  
  48. SSSEEEEEE AAALLLSSSOOO
  49.      pbmpaste(1), pnminvert(1), pbm(5), pnmarith(1), pnmsmooth(1)
  50.  
  51. AAAUUUTTTHHHOOORRR
  52.      Copyright (C) 1988 by Jef Poskanzer.
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.                                08 August 1989                                1
  65.  
  66.  
  67.