fstopgm(1)                UNIX System V(06 April 89)                 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.





















10/89                                                                    Page 1