# fstopgm(1) - man - phpman

> **TLDR:** Convert a Usenix FaceSaver file into a PGM image.
>
- Convert the specified Usenix FaceSaver file into a PGM image:
  `fstopgm {{path/to/input.fs}} > {{path/to/output.pgm}}`

*Source: tldr-pages*

---

[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, 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 pipe‐
       lines:
         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  en‐
       larging by more than 3 does not look good.

       FaceSaver is a registered trademark of Metron Computerware Ltd. of Oakland, 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)