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

115 lines
2.7 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of pbmtopgm</TITLE>
</HEAD><BODY>
<H1>pbmtopgm</H1>
Section: User Commands (1)<BR>Updated: 03 Sep 2001<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
pbmtopgm - convert portable bitmap to portable graymap by averaging areas
<P>
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>pbmtopgm </B>
<I>width</I>
<I>height</I>
[<I>pbmfile</I>]
<P>
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<B>pbmtopgm</B>
reads a portable bitmap as input. It outputs a portable graymap
in which each pixel's gray level is the average the surrounding black
and white input pixels. The surrounding area is a rectangle of
<I>width</I>
by
<I>height</I>
pixels.
<P>
In other words, this is a convolution.
<B>pbmtopgm </B>
is similar to a special case of
<B>pnmconvol</B>.
<P>
You may need a
<B>ppmsmooth</B>
step after
<B>pbmtopgm</B>.
<P>
<B>pbmtopgm </B>
has the effect of anti-aliasing bitmaps which contain distinct line
features.
<P>
<B>pbmtopgm </B>
works best with odd sample width and heights.
<P>
You don't need
<B>pbmtopgm</B>
just to use a PGM program on a PBM image. Any PGM program (assuming it uses
the Netpbm libraries to read the PGM input) takes PBM input as if it were
PGM, with only the mininum and maximum gray levels. So unless your convolution
rectangle is bigger than one pixel, you're not gaining anything with a
<B>pbmtopgm</B>
step.
<P>
<A NAME="lbAE">&nbsp;</A>
<H2>SEE ALSO</H2>
<B><A HREF="/cgi-bin/man/man2html?1+netpbm">netpbm</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?1+pgmtopbm">pgmtopbm</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?5+pbm">pbm</A></B>(5)
<P>
<A NAME="lbAF">&nbsp;</A>
<H2>AUTHOR</H2>
Copyright (C) 1990 by Angus Duggan
Copyright (C) 1989 by Jef Poskanzer.
<P>
Permission to use, copy, modify, and distribute this software and its
documentation for any purpose and without fee is hereby granted, provided
that the above copyright notice appear in all copies and that both that
copyright notice and this permission notice appear in supporting
documentation. This software is provided &quot;as is&quot; without express or
implied warranty.
<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">SEE ALSO</A><DD>
<DT id="5"><A HREF="#lbAF">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>