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 / rawtopgm.1 < prev    next >
Text File  |  1996-11-18  |  2KB  |  64 lines
  1. .TH rawtopgm 1 "15 June 1993"
  2. .IX rawtopgm
  3. .SH NAME
  4. rawtopgm - convert raw grayscale bytes into a portable graymap
  5. .SH SYNOPSIS
  6. .B rawtopgm
  7. .RB [ -headerskip
  8. .IR N ]
  9. .RB [ -rowskip
  10. .IR N ]
  11. .RB [ -tb | -topbottom ]
  12. .RI [ width
  13. .IR height ]
  14. .RI [ imagedata ]
  15. .SH DESCRIPTION
  16. Reads raw grayscale bytes as input.
  17. .IX "raw grayscale"
  18. Produces a portable graymap as output.
  19. The input file is just grayscale bytes.
  20. If you don't specify the width and height on the command line,
  21. the program will check the size of the image and try to make
  22. a quadratic image of it. It is an error to supply a non
  23. quadratic image without specifying width and height.
  24. The maxval is assumed to be 255.
  25. .SH OPTIONS
  26. .TP
  27. .B -headerskip
  28. If the file has a header, you can use this flag to
  29. skip over it.
  30. .TP
  31. .B -rowskip
  32. If there is padding at the ends of the rows, you can skip it with this flag.
  33. Note that rowskip can be a real number.
  34. Amazingly, I once had an image with 0.376 bytes of padding per row.
  35. This turned out to be due to a file-transfer problem, but I was still
  36. able to read the image.
  37. .TP
  38. .B -tb -topbottom
  39. Flips the image upside down.
  40. The first pixel in a pgm file is in the lower left corner of the image.
  41. For conversion from images with the first pixel in the upper left corner
  42. (e.g. the Molecular Dynamics and Leica confocal formats) this flips the
  43. image right.
  44. This is equivalent to
  45. .B "rawtopgm [file] | pnmflip -tb" .
  46. .SH "BUGS"
  47. If you don't specify the image width and height, the program will
  48. try to read the entire image to a memory buffer. If you get a
  49. message that states that you are out of memory, try to specify the width
  50. and height on the command line. Also, the -tb option consumes much
  51. memory.
  52. .SH "SEE ALSO"
  53. pgm(5), rawtoppm(1), pnmflip(1)
  54. .SH AUTHORS
  55. Copyright (C) 1989 by Jef Poskanzer.
  56. .br
  57. Modified June 1993 by Oliver Trepte, oliver@fysik4.kth.se
  58. .\" Permission to use, copy, modify, and distribute this software and its
  59. .\" documentation for any purpose and without fee is hereby granted, provided
  60. .\" that the above copyright notice appear in all copies and that both that
  61. .\" copyright notice and this permission notice appear in supporting
  62. .\" documentation.  This software is provided "as is" without express or
  63. .\" implied warranty.
  64.