Fstopgm User Manual(1) General Commands Manual Fstopgm User Manual(1)
NAME
fstopgm - convert a Usenix FaceSaver(tm) file into a PGM image
SYNOPSIS
fstopgm [fsfile]
DESCRIPTION
This program is part of Netpbm(1).
fstopgm reads a Usenix FaceSaver(tm) file as input and produces a PGM
image 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 pamscale 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 pamscale.
Then use one of the following pipelines:
fstopgm | pnmnorm
fstopgm | pamscale -whatever | pnmnorm
To go to PBM, you want something more like one of these:
fstopgm | pamenlarge 3 | pnmnorm | pamditherbw
fstopgm | pamenlarge 3 | pamscale <whatever> | pnmnorm | pamditherbw
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.
OPTIONS
There are no command line options defined specifically for fstopgm, but
it recognizes the options common to all programs based on libnetpbm (See
]8;;index.html#commonoptions\ Common Options]8;;\ .)
SEE ALSO
pgmtofs(1), pgm(1), pnmnorm(1), pamenlarge(1), pamscale(1),
pamditherbw(1)
AUTHOR
Copyright (C) 1989 by Jef Poskanzer.
DOCUMENT SOURCE
This manual page was generated by the Netpbm tool 'makeman' from HTML
source. The master documentation is at
http://netpbm.sourceforge.net/doc/fstopgm.html
netpbm documentation 06 April 89 Fstopgm User Manual(1)
Generated by dwww version 1.16 on Tue Dec 16 05:57:04 CET 2025.