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