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 / pgmtoppm.1 < prev    next >
Text File  |  1996-11-18  |  2KB  |  72 lines
  1. .TH pgmtoppm 1 "11 January 1991"
  2. .IX pgmtoppm
  3. .SH NAME
  4. pgmtoppm - colorize a portable graymap into a portable pixmap
  5. .SH SYNOPSIS
  6. .B pgmtoppm
  7. .I colorspec
  8. .RI [ pgmfile ]
  9. .br
  10. .B pgmtoppm
  11. .IB colorspec1 - colorspec2
  12. .RI [ pgmfile ]
  13. .br
  14. .B pgmtoppm -map
  15. .I mapfile
  16. .RI [ pgmfile ]
  17. .SH DESCRIPTION
  18. Reads a portable graymap as input.
  19. Colorizes it by multiplying the the gray values by specified color or colors,
  20. and produces a portable pixmap as output.
  21. .IX colorization
  22. .PP
  23. If only one color is specified, black in the pgm file stays black and
  24. white in the pgm file turns into the specified color in the ppm file.
  25. If two colors (separated by a dash) are specified, then black gets mapped
  26. to the first color and white gets mapped to the second.
  27. .PP
  28. The color can be specified in five ways:
  29. .IX "specifying colors"
  30. .TP 
  31. o
  32. A name, assuming
  33. that a pointer to an X11-style color names file was compiled in.
  34. .TP 
  35. o
  36. An X11-style hexadecimal specifier: rgb:r/g/b, where r g and b are
  37. each 1- to 4-digit hexadecimal numbers.
  38. .TP 
  39. o
  40. An X11-style decimal specifier: rgbi:r/g/b, where r g and b are
  41. floating point numbers between 0 and 1.
  42. .TP 
  43. o
  44. For backwards compatibility, an old-X11-style hexadecimal
  45. number: #rgb, #rrggbb, #rrrgggbbb, or #rrrrggggbbbb.
  46. .TP 
  47. o
  48. For backwards compatibility, a triplet of numbers
  49. separated by commas: r,g,b, where r g and b are
  50. floating point numbers between 0 and 1.
  51. (This style was added before MIT came up with the similar rgbi style.)
  52. .PP
  53. Also, the
  54. .B -map
  55. flag lets you specify an entire colormap to be used.
  56. The mapfile is just a
  57. .I ppm
  58. file; it can be any shape, all that matters
  59. is the colors in it and their order.
  60. In this case, black gets mapped into the first
  61. color in the map file, and white gets mapped to the last.
  62. .SH "SEE ALSO"
  63. rgb3toppm(1), ppmtopgm(1), ppmtorgb3(1), ppm(5), pgm(5)
  64. .SH AUTHOR
  65. Copyright (C) 1991 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.