man-pages/man1/pbmreduce.1.html
2021-03-31 01:06:50 +01:00

132 lines
2.9 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of pbmreduce</TITLE>
</HEAD><BODY>
<H1>pbmreduce</H1>
Section: User Commands (1)<BR>Updated: 02 August 1989<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="ixAAB"></A>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
pbmreduce - read a portable bitmap and reduce it N times
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>pbmreduce</B>
[<B>-floyd</B>|<B>-fs</B>|<B>-threshold</B>
]
[<B>-value</B>
<I>val</I>]
<I>N</I>
[<I>pbmfile</I>]
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
Reads a portable bitmap as input.
Reduces it by a factor of
<I>N</I>,
and produces a portable bitmap as output.
<A NAME="ixAAC"></A>
<P>
<I>pbmreduce</I>
duplicates a lot of the functionality of
<I>pgmtopbm;</I>
<A NAME="ixAAD"></A>
you could do something like
<B>pnmscale | pgmtopbm,</B>
<A NAME="ixAAE"></A>
but
<I>pbmreduce</I>
is a lot faster.
<P>
<I>pbmreduce</I>
can be used to &quot;re-halftone&quot; an image.
<A NAME="ixAAF"></A>
Let's say you have a scanner that only produces black&amp;white, not
grayscale, and it does a terrible job of halftoning (most b&amp;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
<I>pbmreduce</I>.
You can even correct the brightness of an image, by using the
<B>-value</B>
flag.
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>
<P>
By default, the halftoning after the reduction is done via
boustrophedonic Floyd-Steinberg error diffusion; however, the
<A NAME="ixAAG"></A>
<A NAME="ixAAH"></A>
<B>-threshold</B>
flag can be used to specify simple thresholding. This gives better
<A NAME="ixAAI"></A>
results when reducing line drawings.
<P>
The
<B>-value</B>
flag 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.
<P>
All flags can be abbreviated to their shortest unique prefix.
<A NAME="lbAF">&nbsp;</A>
<H2>SEE ALSO</H2>
<A HREF="/cgi-bin/man/man2html?1+pnmenlarge">pnmenlarge</A>(1), <A HREF="/cgi-bin/man/man2html?1+pnmscale">pnmscale</A>(1), <A HREF="/cgi-bin/man/man2html?1+pgmtopbm">pgmtopbm</A>(1), <A HREF="/cgi-bin/man/man2html?5+pbm">pbm</A>(5)
<A NAME="lbAG">&nbsp;</A>
<H2>AUTHOR</H2>
Copyright (C) 1988 by Jef Poskanzer.
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="1"><A HREF="#lbAB">NAME</A><DD>
<DT id="2"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="3"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="4"><A HREF="#lbAE">OPTIONS</A><DD>
<DT id="5"><A HREF="#lbAF">SEE ALSO</A><DD>
<DT id="6"><A HREF="#lbAG">AUTHOR</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:21 GMT, March 31, 2021
</BODY>
</HTML>