Manual: fstopgm

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  | 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 Oakland, CA.

OPTIONS
       There  are no command line options defined specifically for fstopgm, but it recognizes the options common to all pro‐
       grams based on libnetpbm (See  Common Options .)

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)