fstopgm

 

---

 fstopgm(1)                                             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  other­
        wise  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),  pnm­
        scale(1), pgmtopbm(1)
 
AUTHOR
        Copyright (C) 1989 by Jef Poskanzer.
 
 
 
                            06 April 89                 fstopgm(1)

---