1Palmtopnm User Manual(0)                              Palmtopnm User Manual(0)
2
3
4

NAME

6       palmtopnm - convert a Palm Bitmap to a PNM image
7
8

SYNOPSIS

10       palmtopnm
11
12       [-verbose]
13
14       [-rendition N]
15
16       [-showhist]
17
18       [palmfile] palmtopnm
19
20       -transparent
21
22       [-verbose]
23
24       [palmfile]
25
26

DESCRIPTION

28       This program is part of Netpbm(1).
29
30       palmtopnm reads a Palm Bitmap as input, from Standard Input or palmfile
31       and produces a PPM image as output.
32
33       Alternatively (when you specify  -transparent),  palmtopnm  writes  the
34       value of the transparent color in the Palm Bitmap to Standard Output.
35
36       Palmtopnm  can  convert Palm Bitmaps with the following features.  This
37       does not mean that it doesn't handle other features.   These  are  just
38       the ones we found worth mentioning.
39
40
41       ·      Version 0
42
43       ·      Version 1
44
45       ·      Version 2
46
47       ·      Version 3 (new in Netpbm 10.27 (March 2005))
48
49       ·      Scanline compression
50
51       ·      RLE compression
52
53       ·      Packbits compression (new in Netpbm 10.27 (March 2005))
54
55
56

OPTIONS

58       In  addition  to  the options common to all programs based on libnetpbm
59       (most notably -quiet, see
60        Common Options ⟨index.html#commonoptions⟩ ), palmtopnm recognizes  the
61       following command line options:
62
63
64
65       -verbose
66              Display various interesting information about the input file and
67              process.
68
69
70       -transparent
71              If the Palm Bitmap has a transparent color set, palmtopnm writes
72              the value for that color to Standard Output in the form #RRGGBB,
73              where RR, GG, and BB are two-digit hexadecimal numbers  indicat‐
74              ing a value in the range 0 through 255.  If no transparent color
75              is set in the Bitmap, palmtopnm writes nothing.  palmtopnm  does
76              not generate any output image when you specify -transparent.
77
78
79       -rendition N
80              Palm  Bitmaps  may  contain  several different renditions of the
81              same image, with different depths.  By default, palmtopnm  oper‐
82              ates  on  the first rendition (rendition number 1) in the image.
83              This switch allows you to operate on a different rendition.  The
84              value  must  be  between  1  and the number of renditions in the
85              image, inclusive.
86
87
88       -showhist
89              This option causes palmtopnm to write a histogram of  colors  in
90              the input file to Standard Error.
91
92
93
94

SEE ALSO

96       pnmtopalm(1), pamtopdbimg(1), pnm(1),
97
98

LIMITATIONS

100       You cannot generate a transparency mask if the Palm Bitmap has a trans‐
101       parent color.  However, you can still do this with ppmcolormask with  a
102       Netpbm pipe similar to:
103
104       palmtopnm  bitmap.palm  |  ppmcolormask  `palmtopnm  -transparent  bit‐
105       map.palm`
106
107

HISTORY

109       Before Netpbm 10.23 (July 2004), there was a -forceplain  option.   But
110       that had been redundant for a long time, since the Netpbm common option
111       -plain does the same thing.
112
113

AUTHORS

115       This program was originally written as Tbmptopnm.c,  by  Ian  Goldberg.
116       It  was heavily modified by Bill Janssen to add color, compression, and
117       transparency function.
118
119       Copyright 1995-2001 by Ian Goldberg and Bill Janssen.
120

DOCUMENT SOURCE

122       This manual page was generated by the Netpbm tool 'makeman'  from  HTML
123       source.  The master documentation is at
124
125              http://netpbm.sourceforge.net/doc/palmtopnm.html
126
127netpbm documentation            26 January 2005       Palmtopnm User Manual(0)