home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / NETWORK / netpbm_docs.lzh / NETPBM / DOCS / ppmdist.1 < prev    next >
Text File  |  1996-11-18  |  2KB  |  44 lines
  1. .TH ppmdist 1 "22 July 1992"
  2. .IX ppmdist
  3. .SH NAME
  4. ppmdist - simplistic grayscale assignment for machine generated, color images
  5. .SH SYNOPSIS
  6. .B ppmdist
  7. .RB [ -intensity | -frequency ]
  8. .RI [ ppmfile ]
  9. .SH DESCRIPTION
  10. Reads a portable pixmap as input, performs a simplistic grayscale
  11. assignment intended for use with grayscale or bitmap printers.
  12.  
  13. Often conversion from ppm to pgm will yield an image with contrast too
  14. low for good printer output.  The program maximizes contrast between
  15. the gray levels output.
  16.  
  17. A ppm input of n colors is read, and a pgm of n gray levels is written.
  18. The gray levels take on the values 0..n-1, while maxval takes on n-1.
  19.  
  20. The mapping from color to stepped grayscale can be performed in order
  21. of input pixel intensity, or input pixel frequency (number of repetitions).
  22. .SH OPTIONS
  23. .TP 14
  24. .TP 14
  25. .BI -frequency
  26. Sort input colors by the number of times a color appears in the input,
  27. before mapping to evenly distributed graylevels of output.
  28. .BI -intensity
  29. Sort input colors by their grayscale intensity, before mapping to evenly
  30. distributed graylevels of output.  This is the default.
  31. .SH BUGS
  32. Helpful only for images with a very small number of colors.
  33. Perhaps should have been an option to ppmtopgm(1).
  34. .SH "SEE ALSO"
  35. ppmtopgm(1), ppmhist(1), ppm(5)
  36. .SH AUTHOR
  37. Copyright (C) 1993 by Dan Stromberg.
  38. .\" Permission to use, copy, modify, and distribute this software and its
  39. .\" documentation for any purpose and without fee is hereby granted, provided
  40. .\" that the above copyright notice appear in all copies and that both that
  41. .\" copyright notice and this permission notice appear in supporting
  42. .\" documentation.  This software is provided "as is" without express or
  43. .\" implied warranty.
  44.