fstopgm(1)                                            General Commands Manual                                            fstopgm(1)

NAME
       fstopgm - convert a Usenix FaceSaver(tm) file into a portable graymap

SYNOPSIS
       fstopgm [fsfile]

DESCRIPTION
       Reads a Usenix FaceSaver(tm) file as input.  Produces a portable graymap as output.

       FaceSaver(tm)  files  sometimes  have  rectangular pixels.  While fstopgm won't re-scale them into square pixels for you, it
       will give you the precise pnmscale command that will do the job.  Because of this, reading a FaceSaver(tm) image is  a  two-
       step process.  First you do:
         fstopgm > /dev/null
       This will tell you whether you need to use pnmscale.  Then use one of the following pipelines:
         fstopgm | pgmnorm
         fstopgm | pnmscale -whatever | pgmnorm
       To go to PBM, you want something more like one of these:
         fstopgm | pnmenlarge 3 | pgmnorm | pgmtopbm
         fstopgm | pnmenlarge 3 | pnmscale <whatever> | pgmnorm | pgmtopbm
       You  want  to  enlarge  when going to a bitmap because otherwise you lose information; but enlarging by more than 3 does not
       look good.

       FaceSaver is a registered trademark of Metron Computerware Ltd. of Oakland, CA.

SEE ALSO
       pgmtofs(1), pgm(5), pgmnorm(1), pnmenlarge(1), pnmscale(1), pgmtopbm(1)

AUTHOR
       Copyright (C) 1989 by Jef Poskanzer.

                                                            06 April 89                                                  fstopgm(1)

fstopgm: Use 'man fstopgm' for help.