Debian Codegraph @

upstream/debian-unstable/man1/pbmreduce.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 "Pbmreduce User Manual" 1 "13 April 2016" "netpbm documentation"
7
8 .SH NAME
9 pbmreduce - read a PBM image and reduce it N times
10
11 .UN synopsis
12 .SH SYNOPSIS
13
14 \fBpbmreduce\fP
15 [\fB-floyd\fP|\fB-fs\fP|\fB-threshold\fP]
16 [\fB-value\fP \fIval\fP]
17 [\fB-randomseed=\fP\fIinteger\fP]
18 \fIN\fP
19 [\fIpbmfile\fP]
20 .PP
21 You can abbreviate any option to its shortest unique prefix.
22
23 .UN description
24 .SH DESCRIPTION
25 .PP
26 This program is part of
27 .BR "Netpbm" (1)\c
28 \&.
29 .PP
30 \fBpbmreduce\fP reads a PBM image as input and reduces it by a
31 factor of \fIN\fP, producing a PBM image as output.
32 .PP
33 \fBpbmreduce\fP duplicates a lot of the functionality of
34 \fBpamditherbw\fP; you could do something like \f(CWpamscale |
35 pamditherbw\fP, but \fBpbmreduce\fP is a lot faster.
36 .PP
37 You can use \fBpbmreduce\fP to "re-halftone" an image.
38 Let's say you have a scanner that only produces black&white, not
39 grayscale, and it does a terrible job of halftoning (most b&w
40 scanners fit this description). One way to fix the halftoning is to
41 scan at the highest possible resolution, say 300 dpi, and then reduce
42 by a factor of three or so using \fBpbmreduce\fP. You can even
43 correct the brightness of an image, by using the \fB-value\fP option.
44
45 .UN options
46 .SH OPTIONS
47 .PP
48 In addition to the options common to all programs based on libnetpbm
49 (most notably \fB-quiet\fP, see
50 .UR index.html#commonoptions
51 Common Options
52 .UE
53 \&), \fBpbmreduce\fP recognizes the following
54 command line options:
55
56
57
58 .TP
59 \fB-threshold\fP
60 By default, \fBpbmreduce\fP does the halftoning after the reduction via
61 boustrophedonic Floyd-Steinberg error diffusion; however, you can use this
62 option to specify simple thresholding. This gives better results when
63 reducing line drawings.
64
65 .TP
66 \fB-floyd\fP, \fB-fs\fP
67 Specify the Floyd-Steinberg error diffusion method. This is the
68 default.
69
70 .TP
71 \fB-value\fP
72 .sp
73 This option alters the thresholding value for all quantizations. It should
74 be a real number between 0 and 1. Above 0.5 means darker images; below 0.5
75 means lighter.
76
77 .TP
78 \fB-randomseed=\fP\fIinteger\fP
79 This is the seed for the random number generator that controls the
80 halftoning.
81 .sp
82 Use this to ensure you get the same image on separate invocations.
83 .sp
84 This option was new in Netpbm 10.75 (June 2016).
85
86
87
88
89 .UN seealso
90 .SH SEE ALSO
91 .BR "pamenlarge" (1)\c
92 \&,
93 .BR "pamscale" (1)\c
94 \&,
95 .BR "pamditherbw" (1)\c
96 \&,
97 .BR "pbm" (1)\c
98 \&
99
100 .UN author
101 .SH AUTHOR
102
103 Copyright (C) 1988 by Jef Poskanzer.
104 .SH DOCUMENT SOURCE
105 This manual page was generated by the Netpbm tool 'makeman' from HTML
106 source. The master documentation is at
107 .IP
108 .B http://netpbm.sourceforge.net/doc/pbmreduce.html
109 .PP