Debian Codegraph @

upstream/debian-unstable/man1/palmtopnm.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 "Palmtopnm User Manual" 1 "26 January 2005" "netpbm documentation"
7
8 .SH NAME
9 palmtopnm - convert a Palm Bitmap to a PNM image
10
11 .UN synopsis
12 .SH SYNOPSIS
13
14 \fBpalmtopnm\fP
15
16 [\fB-verbose\fP]
17
18 [\fB-rendition\fP \fIN\fP]
19
20 [\fB-showhist\fP]
21
22 [\fIpalmfile\fP]
23 \fBpalmtopnm\fP
24
25 \fB-transparent\fP
26
27 [\fB-verbose\fP]
28
29 [\fIpalmfile\fP]
30
31 .UN description
32 .SH DESCRIPTION
33 .PP
34 This program is part of
35 .BR "Netpbm" (1)\c
36 \&.
37 .PP
38 \fBpalmtopnm\fP reads a Palm Bitmap as input, from Standard Input or
39 \fIpalmfile\fP and produces a PPM image as output.
40 .PP
41 Alternatively (when you specify \fB-transparent\fP),
42 \fBpalmtopnm\fP writes the value of the transparent color in the Palm
43 Bitmap to Standard Output.
44 .PP
45 \fBPalmtopnm\fP can convert Palm Bitmaps with the following features.
46 This does not mean that it doesn't handle other features. These are just
47 the ones we found worth mentioning.
48
49 .IP \(bu
50 Version 0
51 .IP \(bu
52 Version 1
53 .IP \(bu
54 Version 2
55 .IP \(bu
56 Version 3 (new in Netpbm 10.27 (March 2005))
57 .IP \(bu
58 Scanline compression
59 .IP \(bu
60 RLE compression
61 .IP \(bu
62 Packbits compression (new in Netpbm 10.27 (March 2005))
63
64
65 .UN options
66 .SH OPTIONS
67 .PP
68 In addition to the options common to all programs based on libnetpbm
69 (most notably \fB-quiet\fP, see
70 .UR index.html#commonoptions
71 Common Options
72 .UE
73 \&), \fBpalmtopnm\fP recognizes the following
74 command line options:
75
76
77 .TP
78 \fB-verbose\fP
79 Display various interesting information about the input file and process.
80
81 .TP
82 \fB-transparent\fP
83 If the Palm Bitmap has a transparent color set,
84 \fBpalmtopnm\fP writes the value for that
85 color to Standard Output in the form #RRGGBB, where
86 RR, GG, and BB are two-digit hexadecimal numbers
87 indicating a value in the range 0 through 255. If no transparent color is set
88 in the Bitmap, \fBpalmtopnm\fP writes nothing. \fBpalmtopnm\fP does not
89 generate any output image when you specify \fB-transparent\fP.
90
91 .TP
92 \fB-rendition N\fP
93 Palm Bitmaps may contain several different renditions of the same
94 image, with different depths. By default, \fBpalmtopnm \fP operates
95 on the first rendition (rendition number 1) in the image. This
96 switch allows you to operate on a different rendition. The value must
97 be between 1 and the number of renditions in the image, inclusive.
98
99 .TP
100 \fB-showhist\fP
101 This option causes \fBpalmtopnm\fP to
102 write a histogram of colors in the input file to Standard Error.
103
104
105
106 .UN seealso
107 .SH SEE ALSO
108 .BR "pnmtopalm" (1)\c
109 \&,
110 .BR "pamtopdbimg" (1)\c
111 \&,
112 .BR "pnm" (1)\c
113 \&,
114
115 .UN limitations
116 .SH LIMITATIONS
117 .PP
118 You cannot generate a transparency mask if the Palm Bitmap has a
119 transparent color. However, you can still do this with
120 \fBppmcolormask\fP with a Netpbm pipe similar to:
121 .PP
122 \fBpalmtopnm bitmap.palm |
123 ppmcolormask `palmtopnm -transparent bitmap.palm`\fP
124
125 .UN history
126 .SH HISTORY
127 .PP
128 Before Netpbm 10.23 (July 2004), there was a \fB-forceplain\fP
129 option. But that had been redundant for a long time, since the Netpbm
130 common option \fB-plain\fP does the same thing.
131
132 .UN authors
133 .SH AUTHORS
134
135 This program was originally written as Tbmptopnm.c, by Ian Goldberg.
136 It was heavily modified by Bill Janssen to add color, compression, and
137 transparency function.
138 .PP
139 Copyright 1995-2001 by Ian Goldberg and Bill Janssen.
140 .SH DOCUMENT SOURCE
141 This manual page was generated by the Netpbm tool 'makeman' from HTML
142 source. The master documentation is at
143 .IP
144 .B http://netpbm.sourceforge.net/doc/palmtopnm.html
145 .PP