Debian Codegraph @

upstream/debian-unstable/man1/pgmtopbm.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 "Pgmtopbm User Manual" 1 "17 July 2020" "netpbm documentation"
7
8 .SH NAME
9
10 pgmtopbm - convert a PGM image to PBM
11
12 .UN synopsis
13 .SH SYNOPSIS
14
15 \fBpgmtopbm\fP
16
17 [\fB-floyd\fP | \fB-fs\fP | \fB-threshold\fP
18 | \fB-hilbert\fP
19 | \fB-dither8\fP | \fB-d8\fP | \fB-cluster3\fP
20 | \fB-c3\fP | \fB-cluster4\fP | \fB-c4\fP
21 | \fB-cluster8\fP | \fB-c8\fP]
22
23 [\fB-value\fP \fIval\fP]
24
25 [\fB-clump\fP \fIsize\fP]
26
27 [\fB-randomseed\fP \fIinteger\fP]
28
29 [\fIpgmfile\fP]
30
31 .UN description
32 .SH DESCRIPTION
33 .PP
34 This program is part of
35 .BR "Netpbm" (1)\c
36 \&.
37 .PP
38 This program is almost entirely obsolete since Netpbm 10.23 (July
39 2004). Use
40 .BR "\fBpamditherbw\fP" (1)\c
41 \& to do
42 what this program used to do.
43 .PP
44 \fBpgmtopbm\fP never was the simple converter it appeared to be.
45 It was a dithering program. Unfortunately, it didn't do the dithering
46 properly because it treated the PGM input samples as if they were
47 directly proportional to light intensity, but they are actually
48 gamma-adjusted.
49 .PP
50 \fBpamditherbw\fP is backward compatible with \fBpgmtopbm\fP
51 except that it
52
53 .IP \(bu
54 does the correct gamma adjustments.
55 .IP \(bu
56 produces PAM output instead of PBM. (Modern Netpbm programs that
57 accept PBM input also accept PAM input, but if you need actual PBM,
58 you can use \fBpamtopnm\fP with \fBpamditherbw\fP).
59
60 So use the manual for \fBpamditherbw\fP for \fBpgmtopbm\fP, except
61 ignore anything that says it was added after Netpbm Release 10.23
62 and ignore any options that are not shown in the synopsis above.
63 .PP
64 Although \fBpgmtopbm\fP is mostly obsolete, the simple threshold
65 method (specified by \fB-threshold\fP) is an exception. Unlike the
66 other conversion methods, gamma-adjustment is not an issue with
67 simple thresholding and \fBpgmtopbm\fP can produce PBM output
68 directly. Note that even in this basic mode of operation
69 \fBpgmtopbm\fP may produce output which is slightly different from
70 what \fBpamditherbw\fP does because of differences in internal
71 calculation.
72 .PP
73 If you just want to convert a PGM image with maxval 1 to PBM,
74 use
75 .BR "\fBpamtopnm\fP" (1)\c
76 \&.
77
78 .UN seealso
79 .SH SEE ALSO
80 .BR "pamditherbw" (1)\c
81 \&,
82 .BR "pamtopnm" (1)\c
83 \&,
84 .BR "pbmtopgm" (1)\c
85 \&,
86 .BR "pamthreshold" (1)\c
87 \&,
88 .BR "pbmreduce" (1)\c
89 \&,
90 .BR "pgm" (1)\c
91 \&,
92 .BR "pbm" (1)\c
93 \&
94
95 .UN author
96 .SH AUTHOR
97
98 Copyright (C) 1989 by Jef Poskanzer.
99 .SH DOCUMENT SOURCE
100 This manual page was generated by the Netpbm tool 'makeman' from HTML
101 source. The master documentation is at
102 .IP
103 .B http://netpbm.sourceforge.net/doc/pgmtopbm.html
104 .PP