Penguin
Recent Changes
Blame: pnmtopalm(1)
EditPageHistoryDiffInfoLikePages
Annotated edit history of pnmtopalm(1) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 pnmtopalm
2 !!!pnmtopalm
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 SEE ALSO
8 NOTES
9 AUTHORS
10 ----
11 !!NAME
12
13
14 pnmtopalm - convert a portable anymap into a Palm pixmap
15 !!SYNOPSIS
16
17
18 __pnmtopalm__ [[__-verbose__] [[__-depth__ ''N'']
19 [[__-maxdepth__ ''N''] [[__-colormap__]
20 [[__-transparent__ ''color''] [[__-offset__]
21 [[__-rle-compression__|__-scanline-compression__]
22 [[''pnmfile'']
23 !!DESCRIPTION
24
25
26 Reads a PNM image as input, from stdin or ''pnmfile''.
27 Produces a Palm pixmap as output.
28
29
30 Palm pixmap files are either greyscale files 1, 2, or 4 bits
31 wide, or color files 8 bits wide, so __pnmtopalm__
32 automatically scales colors to have an appropriate maxval,
33 unless you specify a depth or max depth. Input files must
34 have an appropriate number and set of colors for the
35 selected output constraints. This often means that you
36 should run the PNM image through __ppmquant__ before you
37 pass it to __pnmtopalm__. Netpbm comes with several
38 colormap files you can use with __ppmquant__ for this
39 purpose. They are __palmgray2.map__ (4 shades of gray for
40 a depth of 2), __palmgray4.map__ (16 shades of gray for a
41 depth of 4), and __palmcolor8.map__ (232 colors in
42 default Palm colormap).
43 !!OPTIONS
44
45
46 __-verbose__
47
48
49 Display the format of the output file.
50
51
52 __-depth__ ''N''
53
54
55 Produce a file of depth ''N'', where ''N'' must be
56 either 1, 2, 4, 8, or 16. Any depth greater than 1 will
57 produce a version 1 or 2 bitmap. Because the default Palm
58 8-bit colormap is not grayscale, if the input is a grayscale
59 or monochrome pixmap, the output will never be more than 4
60 bits deep, regardless of the specified depth. Note that
61 8-bit color works only in PalmOS 3.5 (and higher), and
62 16-bit direct color works only in PalmOS 4.0 (and higher).
63 However, the 16-bit direct color format is also compatible
64 with the various PalmOS 3.x versions used in the Handspring
65 Visor, so these images may also work in that
66 device.
67
68
69 __-maxdepth__ ''N''
70
71
72 Produce a file of minimal depth, but in any case less than
73 ''N'' bits wide. If you specify 16-bit, the output will
74 always be 16-bit direct color.
75
76
77 __-offset__
78
79
80 Fill in the __nextDepthOffset__ field in the file header,
81 to provide for multiple renditions of the pixmap in the same
82 file.
83
84
85 __-colormap__
86
87
88 Build a custom colormap and include it in the output file.
89 This is not recommended by Palm, for efficiency reasons.
90 Otherwise, __pnmtopalm__ uses the default Palm colormap
91 for color output.
92
93
94 __-transparent__ ''color''
95
96
97 Marks ''one'' particular color as fully transparent. The
98 format to specify the color is either (when for example
99 orange)
100 ''
101
102
103 __-rle-compression__
104
105
106 Specifies that the output Palm bitmap will use the Palm RLE
107 compression scheme, and will be a version 2 bitmap. RLE
108 compression works only with Palm OS 3.5 and
109 higher.
110
111
112 __-scanline-compression__
113
114
115 Specifies that the output Palm bitmap will use the Palm
116 scanline compression scheme, and will be a version 2 bitmap.
117 Scanline compression works only in Palm OS 2.0 and
118 higher.
119 !!SEE ALSO
120
121
122 palmtopnm(1), ppmquant(1),
123 pnm(5)
124 !!NOTES
125
126
127 An additional compression format, __packbits__, was added
128 with PalmOS 4.0. This package should be updated to be able
129 to generate that.
130
131
132 Palm pixmaps may contains multiple renditions of the same
133 pixmap, in different depths. To construct an
134 N-multiple-rendition Palm pixmap with __pnmtopalm__,
135 first construct renditions 1 through N-1 using the
136 __-offset__ option, then construct the Nth pixmap without
137 the __-offset__ option. Then concatenate the individual
138 renditions together in a single file using
139 __cat__.
140 !!AUTHORS
141
142
143 This program was originally written as ppmtoTbmp.c, by Ian
144 Goldberg and George Caswell. It was completely re-written by
145 Bill Janssen to add color, compression, and transparency
146 function.
147 Copyright 1995-2001 by Ian Goldberg, George Caswell, and
148 Bill Janssen.
149 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.