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 / pnmhistmap.1 < prev    next >
Text File  |  1996-11-18  |  2KB  |  64 lines
  1. .TH pnmhistmap 1 "25 October 1993"
  2. .IX pnmhistmap
  3. .SH NAME
  4. pnmhistmap - draw a histogram for a PGM or PPM file
  5. .SH SYNOPSIS
  6. .B pnmhistmap
  7. .RB [ -black ]
  8. .RB [ -white ]
  9. .RB [ -max
  10. .IR N ]
  11. .RB [ -verbose ]
  12. .RI [ pnmfile ]
  13. .SH DESCRIPTION
  14. Reads a portable anymap as input,
  15. although bitmap (PBM) input produces an error message and no image.
  16. Produces an image showing a histogram of the color (or gray) values
  17. in the input.
  18. A graymap (PGM) input produces a bitmap output.
  19. A pixmap (PPM) input produces pixmap output with three overlaid histograms:
  20. a red one for the red input,
  21. a green one for the green input,
  22. and a blue one for the blue input.
  23. The output is fixed in size: 256 pixels wide by 200 pixels high.
  24. .SH OPTIONS
  25. .TP
  26. .B -black 
  27. Ignores the count of black pixels when scaling the histogram.
  28. .TP
  29. .B -white
  30. Ignores the count of white pixels when scaling the histogram.
  31. .PP
  32. The -black and -white options, which can be used seperately or together,
  33. are useful for images with a large percentage of pixels whose value is
  34. zero or 255, which can cause the remaining histogram data to become
  35. unreadbaly small.
  36. Note that, for pixmap inputs, these options apply to all colors;
  37. if, for example, the input has a large number of bright-red areas,
  38. you will probably want to use the -white option.
  39. .TP
  40. .B -max N
  41. Force the scaling of the histogram to use N as the largest-count value.
  42. This is useful for inputs with a large percentage of single-color pixels
  43. which are not black or white.
  44. .TP
  45. .B -verbose
  46. Report the progress of making the histogram, including the largest-count
  47. value used to scale the output.
  48. .PP
  49. All flags can be abbreviated to their shortest unique prefix.
  50. .SH BUGS
  51. .PP
  52. Assumes maxval is always 255.
  53. Images with a smaller maxval will only use the lower-value side of the
  54. histogram.
  55. This can be overcome either by piping the input through "pnmdepth 255"
  56. or by cutting and scaling the lower-value side of the histogram.
  57. Neither is a particularly elegant solution.
  58. .PP
  59. Should allow the output size to be specified.
  60. .SH "SEE ALSO"
  61. pgmhist(1), ppmhist(1), pgm(5), ppm(5)
  62. .SH AUTHOR
  63. Wilson H. Bent. Jr. (whb@usc.edu).
  64.