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 / pbmreduce.1 < prev    next >
Text File  |  1996-11-18  |  2KB  |  72 lines
  1. .TH pbmreduce 1 "02 August 1989"
  2. .IX pbmreduce
  3. .SH NAME
  4. pbmreduce - read a portable bitmap and reduce it N times
  5. .SH SYNOPSIS
  6. .B pbmreduce
  7. .RB [ -floyd | -fs | -threshold
  8. .RB ]
  9. .RB [ -value
  10. .IR val ]
  11. .I N
  12. .RI [ pbmfile ]
  13. .SH DESCRIPTION
  14. Reads a portable bitmap as input.
  15. Reduces it by a factor of
  16. .IR N ,
  17. and produces a portable bitmap as output.
  18. .IX shrinking
  19. .PP
  20. .I pbmreduce
  21. duplicates a lot of the functionality of
  22. .I pgmtopbm;
  23. .IX pgmtopbm
  24. you could do something like
  25. .B pnmscale | pgmtopbm,
  26. .IX pnmscale
  27. but
  28. .I pbmreduce
  29. is a lot faster.
  30. .PP
  31. .I pbmreduce
  32. can be used to "re-halftone" an image.
  33. .IX halftoning
  34. Let's say you have a scanner that only produces black&white, not
  35. grayscale, and it does a terrible job of halftoning (most b&w scanners
  36. fit this description).
  37. One way to fix the halftoning is to scan at the highest possible
  38. resolution, say 300 dpi, and then reduce by a factor of three or
  39. so using
  40. .IR pbmreduce .
  41. You can even correct the brightness of an image, by using the
  42. .B -value
  43. flag.
  44. .SH OPTIONS
  45. .PP
  46. By default, the halftoning after the reduction is done via
  47. boustrophedonic Floyd-Steinberg error diffusion; however, the
  48. .IX Floyd-Steinberg
  49. .IX "error diffusion"
  50. .B -threshold
  51. flag can be used to specify simple thresholding.  This gives better
  52. .IX thresholding
  53. results when reducing line drawings.
  54. .PP
  55. The
  56. .B -value
  57. flag alters the thresholding value for all quantizations.
  58. It should be a real number between 0 and 1.
  59. Above 0.5 means darker images; below 0.5 means lighter.
  60. .PP
  61. All flags can be abbreviated to their shortest unique prefix.
  62. .SH "SEE ALSO"
  63. pnmenlarge(1), pnmscale(1), pgmtopbm(1), pbm(5)
  64. .SH AUTHOR
  65. Copyright (C) 1988 by Jef Poskanzer.
  66. .\" Permission to use, copy, modify, and distribute this software and its
  67. .\" documentation for any purpose and without fee is hereby granted, provided
  68. .\" that the above copyright notice appear in all copies and that both that
  69. .\" copyright notice and this permission notice appear in supporting
  70. .\" documentation.  This software is provided "as is" without express or
  71. .\" implied warranty.
  72.