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

93 lines
2.4 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of asciitopgm</TITLE>
</HEAD><BODY>
<H1>asciitopgm</H1>
Section: User Commands (1)<BR>Updated: 26 December 1994<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>
asciitopgm - convert ASCII graphics into a portable graymap
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>asciitopgm</B>
<I>[</I>-d
divisor<I>]</I>
<I>height width</I>
[<I>asciifile</I>]
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
Reads ASCII data as input.
Produces a portable graymap with pixel values which are an approximation
of the &quot;brightness&quot; of the ASCII characters,
assuming black-on-white printing.
In other words, a capital M is very dark, a period is ver light,
and a space is white.
Input lines which are fewer than
<I>width</I>
characters are automatically padded with spaces.
<P>
The
<I>divisor</I>
argument is a floating-point number by which the output pixels are
divided; the default value is 1.0.
This can be used to adjust the brightness of the graymap:
for example, if the image is too dim, reduce the divisor.
<P>
In keeping with (I believe) Fortran line-printer conventions,
input lines beginning with a + (plus) character are assumed
to &quot;overstrike&quot; the previous line, allowing a larger range of gray values.
<P>
This tool contradicts the message in the
<I>pbmtoascii</I>
manual: &quot;Note that there is no asciitopbm tool - this
transformation is one-way.&quot;
<A NAME="lbAE">&nbsp;</A>
<H2>BUGS</H2>
The table of ASCII-to-grey values is subject to interpretation,
and, of course, depends on the typeface intended for the input.
<A NAME="lbAF">&nbsp;</A>
<H2>SEE ALSO</H2>
<A HREF="/cgi-bin/man/man2html?1+pbmtoascii">pbmtoascii</A>(1), <A HREF="/cgi-bin/man/man2html?5+pgm">pgm</A>(5)
<A NAME="lbAG">&nbsp;</A>
<H2>AUTHOR</H2>
Wilson H. Bent. Jr. (<A HREF="mailto:whb@usc.edu">whb@usc.edu</A>)
<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">BUGS</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:07 GMT, March 31, 2021
</BODY>
</HTML>