Debian Codegraph @

upstream/debian-unstable/man1/lispmtopgm.1

raw
1 \
2 .\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
3 .\" Do not hand-hack it! If you have bug fixes or improvements, please find
4 .\" the corresponding HTML page on the Netpbm website, generate a patch
5 .\" against that, and send it to the Netpbm maintainer.
6 .TH "Lispmtopgm User Manual" 1 "06 March 1990" "netpbm documentation"
7
8 .SH NAME
9 lispmtopgm - convert a Lisp Machine bitmap file to PGM
10
11 .UN synopsis
12 .SH SYNOPSIS
13
14 \fBlispmtopgm\fP
15 [\fIlispmfile\fP]
16
17 .UN description
18 .SH DESCRIPTION
19 .PP
20 This program is part of
21 .BR "Netpbm" (1)\c
22 \&.
23 .PP
24 \fBlistpmfile\fP reads a Lisp Machine bitmap as input and
25 produces a PGM image as output.
26 .PP
27 This is the file format written by the tv:write-bit-array-file
28 function on TI Explorer and Symbolics lisp machines.
29 .PP
30 Multi-plane bitmaps on lisp machines are color; but the Lispm image
31 file format does not include a color map, so we must treat it as a
32 monochrome instead and produce PGM. This is unfortunate.
33
34 .UN options
35 .SH OPTIONS
36 .PP
37 There are no command line options defined specifically
38 for \fBlispmtopgm\fP, but it recognizes the options common to all
39 programs based on libnetpbm (See
40 .UR index.html#commonoptions
41 Common Options
42 .UE
43 \&.)
44
45 .UN seealso
46 .SH SEE ALSO
47 .BR "pgmtolispm" (1)\c
48 \&,
49 .BR "pgm" (1)\c
50 \&
51
52 .UN limitations
53 .SH LIMITATIONS
54
55 The Lispm bitmap file format is a bit quirky; Usually the image in the file
56 has its width rounded up to the next higher multiple of 32, but not always.
57 If the width is not a multiple of 32, we don't deal with it properly, but
58 because of the Lispm microcode, such arrays are probably not image data
59 anyway.
60 .PP
61 Also, the Lispm code for saving bitmaps has a bug, in that if you
62 are writing a bitmap which is not mod32 across, the file may be up to
63 7 bits too short! They round down instead of up, and we don't handle
64 this bug gracefully.
65
66 .UN author
67 .SH AUTHOR
68 .PP
69 Copyright (C) 1991 by Jamie Zawinski and Jef Poskanzer.
70 .SH DOCUMENT SOURCE
71 This manual page was generated by the Netpbm tool 'makeman' from HTML
72 source. The master documentation is at
73 .IP
74 .B http://netpbm.sourceforge.net/doc/lispmtopgm.html
75 .PP