home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / NETWORK / netpbm_src.lzh / NETPBM / PPM / ppmtoxpm.1.orig < prev    next >
Text File  |  1996-11-18  |  3KB  |  70 lines
  1. .TH ppmtoxpm 1 "Tue Apr 9 1991"
  2. .SH NAME
  3. ppmtoxpm - convert a portable pixmap into an X11 pixmap
  4. .SH SYNOPSIS
  5. ppmtoxpm [-name <xpmname>] [-rgb <rgb-textfile>] [<ppmfile>]
  6. .SH DESCRIPTION
  7. Reads a portable pixmap as input.
  8. Produces X11 pixmap  (version 3) as output which
  9. can be loaded directly by the XPM library.
  10. .PP
  11. The \fB-name\fP option allows one to specify the prefix string which is printed
  12. in the resulting XPM output.  If not specified, will default to the
  13. filename (without extension) of the <ppmfile> argument.
  14. If \fB-name\fP is not specified and <ppmfile>
  15. is not specified (i.e. piped input), the prefix string will default to
  16. the string "noname".
  17. .PP
  18. The \fB-rgb\fP option allows one to specify an X11 rgb text file for the
  19. lookup of color name mnemonics.  This rgb text file is typically the
  20. /usr/lib/X11/rgb.txt of the MIT X11 distribution, but any file using the
  21. same format may be used.  When specified and
  22. a RGB value from the ppm input matches a RGB value from the <rgb-textfile>,
  23. then the corresponding color name mnemonic is printed in the XPM's colormap.
  24. If \fB-rgb\fP is not specified, or if the RGB values don't match, then the color
  25. will be printed with the #RGB, #RRGGBB, #RRRGGGBBB, or #RRRRGGGGBBBB
  26. hexadecimal format.
  27. .PP
  28. All flags can be abbreviated to their shortest unique prefix.
  29. .PP
  30. For example, to convert the file "dot" (found in /usr/include/X11/bitmaps),
  31. from xbm to xpm one could specify
  32. .IP
  33. xbmtopbm dot | ppmtoxpm -name dot
  34. .PP
  35. or, with a rgb text file (in the local directory)
  36. .IP
  37. xbmtopbm dot | ppmtoxpm -name dot -rgb rgb.txt
  38. .SH BUGS
  39. An option to match the closest (rather than exact) color name mnemonic
  40. from the rgb text would be a desirable enhancement.
  41. .PP
  42. Truncation of the least significant bits of a RGB value may result in
  43. nonexact matches when performing color name mnemonic lookups.
  44. .SH "SEE ALSO"
  45. ppm(5)
  46. .br
  47. XPM Manual by Arnaud Le Hors lehors@mirsa.inria.fr 
  48. .SH AUTHOR
  49. Copyright (C) 1990 by Mark W. Snitily.
  50.  
  51. Permission to use, copy, modify, and distribute this software and its
  52. documentation for any purpose and without fee is hereby granted, provided
  53. that the above copyright notice appear in all copies and that both that
  54. copyright notice and this permission notice appear in supporting
  55. documentation.  This software is provided "as is" without express or
  56. implied warranty.
  57.  
  58. This tool was developed for Schlumberger Technologies, ATE Division, and
  59. with their permission is being made available to the public with the above
  60. copyright notice and permission notice.
  61.  
  62. Upgraded to XPM2 by
  63.    Paul Breslaw, Mecasoft SA, Zurich, Switzerland (paul@mecazh.uu.ch)
  64.    Thu Nov  8 16:01:17 1990
  65.  
  66. Upgraded to XPM version 3 by
  67.    Arnaud Le Hors (lehors@mirsa.inria.fr)
  68.    Tue Apr 9 1991
  69.  
  70.