# phpman > info > fstopgm

[fstopgm(1)](https://www.chedong.com/phpMan.php/man/fstopgm/1/markdown)                  General Commands Manual                 [fstopgm(1)](https://www.chedong.com/phpMan.php/man/fstopgm/1/markdown)

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,  read-
       ing 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 Oak-
       land, CA.

SEE ALSO
       [pgmtofs(1)](https://www.chedong.com/phpMan.php/man/pgmtofs/1/markdown), [pgm(5)](https://www.chedong.com/phpMan.php/man/pgm/5/markdown), [pgmnorm(1)](https://www.chedong.com/phpMan.php/man/pgmnorm/1/markdown), [pnmenlarge(1)](https://www.chedong.com/phpMan.php/man/pnmenlarge/1/markdown), [pnmscale(1)](https://www.chedong.com/phpMan.php/man/pnmscale/1/markdown), [pgmtopbm(1)](https://www.chedong.com/phpMan.php/man/pgmtopbm/1/markdown)

AUTHOR
       Copyright (C) 1989 by Jef Poskanzer.

                                  06 April 89                       [fstopgm(1)](https://www.chedong.com/phpMan.php/man/fstopgm/1/markdown)
