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 / fstopgm.1 < prev    next >
Text File  |  1996-11-18  |  2KB  |  52 lines
  1. .TH fstopgm 1 "06 April 89"
  2. .IX fstopgm
  3. .SH NAME
  4. fstopgm - convert a Usenix FaceSaver(tm) file into a portable graymap
  5. .SH SYNOPSIS
  6. .B fstopgm
  7. .RI [ fsfile ]
  8. .SH DESCRIPTION
  9. Reads a Usenix FaceSaver(tm) file as input.
  10. .IX FaceSaver
  11. Produces a portable graymap as output.
  12. .PP
  13. FaceSaver(tm) files sometimes have rectangular pixels.
  14. While
  15. .I fstopgm
  16. won't re-scale them into square pixels for you,
  17. it will give you the precise
  18. .I pnmscale
  19. command that will do the job.
  20. Because of this, reading a FaceSaver(tm) image is a two-step process.
  21. First you do:
  22. .nf
  23.   fstopgm > /dev/null
  24. .fi
  25. This will tell you whether you need to use
  26. .I pnmscale.
  27. Then use one of the following pipelines:
  28. .nf
  29.   fstopgm | pgmnorm
  30.   fstopgm | pnmscale -whatever | pgmnorm
  31. .fi
  32. To go to PBM, you want something more like one of these:
  33. .nf
  34.   fstopgm | pnmenlarge 3 | pgmnorm | pgmtopbm
  35.   fstopgm | pnmenlarge 3 | pnmscale <whatever> | pgmnorm | pgmtopbm
  36. .fi
  37. You want to enlarge when going to a bitmap because otherwise you lose
  38. information; but enlarging by more than 3 does not look good.
  39. .PP
  40. FaceSaver is a registered trademark of Metron Computerware Ltd. of
  41. Oakland, CA.
  42. .SH "SEE ALSO"
  43. pgmtofs(1), pgm(5), pgmnorm(1), pnmenlarge(1), pnmscale(1), pgmtopbm(1)
  44. .SH AUTHOR
  45. Copyright (C) 1989 by Jef Poskanzer.
  46. .\" Permission to use, copy, modify, and distribute this software and its
  47. .\" documentation for any purpose and without fee is hereby granted, provided
  48. .\" that the above copyright notice appear in all copies and that both that
  49. .\" copyright notice and this permission notice appear in supporting
  50. .\" documentation.  This software is provided "as is" without express or
  51. .\" implied warranty.
  52.