\
.\" 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 "Pgmtolispm User Manual" 1 "06 March 1990" "netpbm documentation"

.SH NAME

pgmtolispm - convert a PGM image to Lisp Machine format

.UN synopsis
.SH SYNOPSIS

\fBpgmtolispm\fP

[\fIpgmfile\fP]

.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR "Netpbm" (1)\c
\&.
.PP
\fBpgmtolispm\fP reads a PGM image as input and produces a Lisp
Machine bitmap as output.
.PP
This is the file format read by the tv:read-bit-array-file function
on TI Explorer and Symbolics lisp machines.
.PP
Given a PGM (instead of a PBM), \fBpgmtolispm\fP outputs a
multi-plane image.  This is probably not useful unless you have a
color lisp machine.
.PP
Multi-plane bitmaps on lisp machines are color; but the lispm image
file format does not include a color map, so we must treat it as a
graymap instead.  This is unfortunate.

.UN options
.SH OPTIONS
.PP
There are no command line options defined specifically
for \fBpgmtolispm\fP, but it recognizes the options common to all
programs based on libnetpbm (See 
.UR index.html#commonoptions
 Common Options
.UE
\&.)

.UN seealso
.SH SEE ALSO
.BR "lispmtopgm" (1)\c
\&,
.BR "pgm" (1)\c
\&

.UN limitations
.SH LIMITATIONS
.PP
Output width is always rounded up to the nearest multiple of 32;
this might not always be what you want, but it probably is (arrays
which are not modulo 32 cannot be passed to the Lispm BITBLT function,
and thus cannot easily be displayed on the screen).
.PP
No color.

.UN author
.SH AUTHOR

Copyright (C) 1991 by Jamie Zawinski and 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/pgmtolispm.html
.PP