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 / ppmtosixel.1 < prev    next >
Text File  |  1996-11-18  |  2KB  |  62 lines
  1. .TH ppmtosixel 1 "26 April 1991"
  2. .IX ppmtosixel
  3. .SH NAME
  4. ppmtosixel - convert a portable pixmap into DEC sixel format
  5. .SH SYNOPSIS
  6. .B ppmtosixel
  7. .RB [ -raw ]
  8. .RB [ -margin ]
  9. .RI [ ppmfile ]
  10. .SH DESCRIPTION
  11. Reads a portable pixmap as input.
  12. Produces sixel commands (SIX) as output.
  13. The output is formatted for color printing, e.g. for a DEC LJ250 color
  14. inkjet printer. 
  15. .PP
  16. If RGB values from the PPM file do not have maxval=100,
  17. the RGB values are rescaled.
  18. A printer control header and a color assignment table begin the SIX file.
  19. Image data is written in a compressed format by default.
  20. A printer control footer ends the image file.
  21. .SH OPTIONS
  22. .TP
  23. .B -raw
  24. If specified, each pixel will be explicitly described in the image file.
  25. If
  26. .B -raw
  27. is not specified, output will default to compressed format in which
  28. identical adjacent pixels are replaced by "repeat pixel" commands.
  29. A raw file is often an order of magnitude larger than a compressed
  30. file and prints much slower.
  31. .TP
  32. .B -margin
  33. If
  34. .B -margin
  35. is not specified, the image will be start at the left margin
  36. (of the window, paper, or whatever).
  37. If
  38. .B -margin
  39. is specified, a 1.5 inch left margin will offset the image.
  40. .SH PRINTING
  41. Generally, sixel files must reach the printer unfiltered.
  42. Use the lpr -x option or cat filename > /dev/tty0?.
  43. .SH BUGS
  44. Upon rescaling, truncation of the least significant bits of RGB values
  45. may result in poor color conversion.
  46. If the original PPM maxval was greater than 100, rescaling also
  47. reduces the image depth.
  48. While the actual RGB values from the ppm file are more or less
  49. retained, the color palette of the LJ250 may not match the colors
  50. on your screen.
  51. This seems to be a printer limitation.
  52. .SH "SEE ALSO"
  53. ppm(5)
  54. .SH AUTHOR
  55. Copyright (C) 1991 by Rick Vinci.
  56. .\" Permission to use, copy, modify, and distribute this software and its
  57. .\" documentation for any purpose and without fee is hereby granted, provided
  58. .\" that the above copyright notice appear in all copies and that both that
  59. .\" copyright notice and this permission notice appear in supporting
  60. .\" documentation.  This software is provided "as is" without express or
  61. .\" implied warranty.
  62.