summaryrefslogtreecommitdiffstats
path: root/upstream/debian-bookworm/man1/pbmreduce.1
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/debian-bookworm/man1/pbmreduce.1')
-rw-r--r--upstream/debian-bookworm/man1/pbmreduce.1109
1 files changed, 109 insertions, 0 deletions
diff --git a/upstream/debian-bookworm/man1/pbmreduce.1 b/upstream/debian-bookworm/man1/pbmreduce.1
new file mode 100644
index 00000000..22df851b
--- /dev/null
+++ b/upstream/debian-bookworm/man1/pbmreduce.1
@@ -0,0 +1,109 @@
+\
+.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
+.\" Do not hand-hack it! If you have bug fixes or improvements, please find
+.\" the corresponding HTML page on the Netpbm website, generate a patch
+.\" against that, and send it to the Netpbm maintainer.
+.TH "Pbmreduce User Manual" 1 "13 April 2016" "netpbm documentation"
+
+.SH NAME
+pbmreduce - read a PBM image and reduce it N times
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBpbmreduce\fP
+[\fB-floyd\fP|\fB-fs\fP|\fB-threshold\fP]
+[\fB-value\fP \fIval\fP]
+[\fB-randomseed=\fP\fIinteger\fP]
+\fIN\fP
+[\fIpbmfile\fP]
+.PP
+You can abbreviate any option to its shortest unique prefix.
+
+.UN description
+.SH DESCRIPTION
+.PP
+This program is part of
+.BR "Netpbm" (1)\c
+\&.
+.PP
+\fBpbmreduce\fP reads a PBM image as input and reduces it by a
+factor of \fIN\fP, producing a PBM image as output.
+.PP
+\fBpbmreduce\fP duplicates a lot of the functionality of
+\fBpamditherbw\fP; you could do something like \f(CWpamscale |
+pamditherbw\fP, but \fBpbmreduce\fP is a lot faster.
+.PP
+You can use \fBpbmreduce\fP to "re-halftone" an image.
+Let's say you have a scanner that only produces black&white, not
+grayscale, and it does a terrible job of halftoning (most b&w
+scanners fit this description). One way to fix the halftoning is to
+scan at the highest possible resolution, say 300 dpi, and then reduce
+by a factor of three or so using \fBpbmreduce\fP. You can even
+correct the brightness of an image, by using the \fB-value\fP option.
+
+.UN options
+.SH OPTIONS
+.PP
+In addition to the options common to all programs based on libnetpbm
+(most notably \fB-quiet\fP, see
+.UR index.html#commonoptions
+ Common Options
+.UE
+\&), \fBpbmreduce\fP recognizes the following
+command line options:
+
+
+
+.TP
+\fB-threshold\fP
+By default, \fBpbmreduce\fP does the halftoning after the reduction via
+boustrophedonic Floyd-Steinberg error diffusion; however, you can use this
+option to specify simple thresholding. This gives better results when
+reducing line drawings.
+
+.TP
+\fB-floyd\fP, \fB-fs\fP
+Specify the Floyd-Steinberg error diffusion method. This is the
+default.
+
+.TP
+\fB-value\fP
+.sp
+This option alters the thresholding value for all quantizations. It should
+be a real number between 0 and 1. Above 0.5 means darker images; below 0.5
+means lighter.
+
+.TP
+\fB-randomseed=\fP\fIinteger\fP
+This is the seed for the random number generator that controls the
+halftoning.
+.sp
+Use this to ensure you get the same image on separate invocations.
+.sp
+This option was new in Netpbm 10.75 (June 2016).
+
+
+
+
+.UN seealso
+.SH SEE ALSO
+.BR "pamenlarge" (1)\c
+\&,
+.BR "pamscale" (1)\c
+\&,
+.BR "pamditherbw" (1)\c
+\&,
+.BR "pbm" (1)\c
+\&
+
+.UN author
+.SH AUTHOR
+
+Copyright (C) 1988 by Jef Poskanzer.
+.SH DOCUMENT SOURCE
+This manual page was generated by the Netpbm tool 'makeman' from HTML
+source. The master documentation is at
+.IP
+.B http://netpbm.sourceforge.net/doc/pbmreduce.html
+.PP \ No newline at end of file