Debian Codegraph @

upstream/debian-unstable/man1/fstopgm.1

raw
1 \
2 .\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
3 .\" Do not hand-hack it! If you have bug fixes or improvements, please find
4 .\" the corresponding HTML page on the Netpbm website, generate a patch
5 .\" against that, and send it to the Netpbm maintainer.
6 .TH "Fstopgm User Manual" 1 "06 April 89" "netpbm documentation"
7
8 .SH NAME
9 fstopgm - convert a Usenix FaceSaver(tm) file into a PGM image
10
11
12 .UN synopsis
13 .SH SYNOPSIS
14
15 \fBfstopgm\fP
16 [\fIfsfile\fP]
17
18 .UN description
19 .SH DESCRIPTION
20 .PP
21 This program is part of
22 .BR "Netpbm" (1)\c
23 \&.
24 .PP
25 \fBfstopgm\fP reads a Usenix FaceSaver(tm) file as input and
26 produces a PGM image as output.
27 .PP
28 FaceSaver(tm) files sometimes have rectangular pixels. While
29 \fBfstopgm\fP won't re-scale them into square pixels for you, it will
30 give you the precise \fBpamscale\fP command that will do the job.
31 Because of this, reading a FaceSaver(tm) image is a two-step process.
32 First you do:
33
34 .nf
35 fstopgm > /dev/null
36
37 .fi
38
39 This will tell you whether you need to use \fBpamscale.\fP
40
41 Then use one of the following pipelines:
42 .nf
43 fstopgm | pnmnorm
44 fstopgm | pamscale -whatever | pnmnorm
45
46 .fi
47
48 To go to PBM, you want something more like one of these:
49 .nf
50 fstopgm | pamenlarge 3 | pnmnorm | pamditherbw
51 fstopgm | pamenlarge 3 | pamscale <whatever> | pnmnorm | pamditherbw
52
53 .fi
54
55 You want to enlarge when going to a bitmap because otherwise you lose
56 information; but enlarging by more than 3 does not look good.
57 .PP
58 FaceSaver is a registered trademark of Metron Computerware Ltd. of
59 Oakland, CA.
60
61
62 .UN options
63 .SH OPTIONS
64 .PP
65 There are no command line options defined specifically
66 for \fBfstopgm\fP, but it recognizes the options common to all
67 programs based on libnetpbm (See
68 .UR index.html#commonoptions
69 Common Options
70 .UE
71 \&.)
72
73 .UN seealso
74 .SH SEE ALSO
75 .BR "pgmtofs" (1)\c
76 \&,
77 .BR "pgm" (1)\c
78 \&,
79 .BR "pnmnorm" (1)\c
80 \&,
81 .BR "pamenlarge" (1)\c
82 \&,
83 .BR "pamscale" (1)\c
84 \&,
85 .BR "pamditherbw" (1)\c
86 \&
87
88
89 .UN author
90 .SH AUTHOR
91
92 Copyright (C) 1989 by Jef Poskanzer.
93 .SH DOCUMENT SOURCE
94 This manual page was generated by the Netpbm tool 'makeman' from HTML
95 source. The master documentation is at
96 .IP
97 .B http://netpbm.sourceforge.net/doc/fstopgm.html
98 .PP