palmtopnm(1) General Commands Manual palmtopnm(1)NAME
palmtopnm - convert a Palm pixmap into a portable anymap
SYNOPSIS
palmtopnm [-verbose] [-rendition N] [-showhist]
[-forceplain] [pnmfile]
palmtopnm -transparent [-verbose] [pnmfile]
DESCRIPTION
Reads a Palm pixmap as input, from stdin or pnmfile. Produces either a portable pixmap as output, or writes the value of the transparent
color in the Palm pixmap to stdout.
OPTIONS -verbose
Display various interesting information about the input file and process.
-transparent
If the Palm pixmap has a transparent color set, the RGB value for that color will be written to stdout as in the form #RRGGBB, where
RR, GG, and BB are two-digit hexadecimal numbers indicating a value between 0 and 255. If no transparent color is set in the bit-
map, nothing will be output. No additional output will be generated; no anymap will be output.
-rendition N
Palm pixmaps may contain several different renditions of the same pixmap, with different depths. By default, palmtopnm operates on
the first rendition (rendition number 1) in the pixmap. This switch allows you to operate on a different rendition. The value must
be between 1 and the number of renditions in the pixmap, inclusive.
-showhist
Writes a histogram of colors in the input file to stderr.
-forceplain
Force the output anymap to be in ASCII 'plain' netpbm format.
SEE ALSO pnmtopalm(1), pnm(5)BUGS
An additional compression format, "packbits," has been added with PalmOS 4.0. This package should be updated to handle it.
You currently cannot generate an alpha mask if the Palm pixmap has a transparent color. However, you can still do this with ppmcolormask
with a Netpbm pipe similar to:
palmtopnm pixmap.palm | ppmcolormask `palmtopnm -transparent pixmap.palm`
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.
Copyright 1995-2001 by Ian Goldberg and Bill Janssen.
15 December 2000 palmtopnm(1)
Check Out this Related Man Page
pnmtopalm(1) General Commands Manual pnmtopalm(1)NAME
pnmtopalm - convert a portable anymap into a Palm pixmap
SYNOPSIS
pnmtopalm [-verbose] [-depth N] [-maxdepth N] [-colormap] [-transparent color] [-offset]
[-rle-compression|-scanline-compression] [pnmfile]
DESCRIPTION
Reads a PNM image as input, from stdin or pnmfile. Produces a Palm pixmap as output.
Palm pixmap files are either greyscale files 1, 2, or 4 bits wide, or color files 8 bits wide, so pnmtopalm automatically scales colors to
have an appropriate maxval, unless you specify a depth or max depth. Input files must have an appropriate number and set of colors for the
selected output constraints. This often means that you should run the PNM image through ppmquant before you pass it to pnmtopalm. Netpbm
comes with several colormap files you can use with ppmquant for this purpose. They are palmgray2.map (4 shades of gray for a depth of 2),
palmgray4.map (16 shades of gray for a depth of 4), and palmcolor8.map (232 colors in default Palm colormap).
OPTIONS -verbose
Display the format of the output file.
-depth N
Produce a file of depth N, where N must be either 1, 2, 4, 8, or 16. Any depth greater than 1 will produce a version 1 or 2 bitmap.
Because the default Palm 8-bit colormap is not grayscale, if the input is a grayscale or monochrome pixmap, the output will never be
more than 4 bits deep, regardless of the specified depth. Note that 8-bit color works only in PalmOS 3.5 (and higher), and 16-bit
direct color works only in PalmOS 4.0 (and higher). However, the 16-bit direct color format is also compatible with the various
PalmOS 3.x versions used in the Handspring Visor, so these images may also work in that device.
-maxdepth N
Produce a file of minimal depth, but in any case less than N bits wide. If you specify 16-bit, the output will always be 16-bit
direct color.
-offset
Fill in the nextDepthOffset field in the file header, to provide for multiple renditions of the pixmap in the same file.
-colormap
Build a custom colormap and include it in the output file. This is not recommended by Palm, for efficiency reasons. Otherwise,
pnmtopalm uses the default Palm colormap for color output.
-transparent color
Marks one particular color as fully transparent. The format to specify the color is either (when for example orange) "1.0,0.5,0.0",
where the values are floats between zero and one, or with the syntax "#RGB", "#RRGGBB" or "#RRRRGGGGBBBB" where R, G and B are hexa-
decimal numbers. This also makes the output bitmap a version 2 bitmap. Transparency works only on Palm OS 3.5 and higher.
-rle-compression
Specifies that the output Palm bitmap will use the Palm RLE compression scheme, and will be a version 2 bitmap. RLE compression
works only with Palm OS 3.5 and higher.
-scanline-compression
Specifies that the output Palm bitmap will use the Palm scanline compression scheme, and will be a version 2 bitmap. Scanline com-
pression works only in Palm OS 2.0 and higher.
SEE ALSO palmtopnm(1), ppmquant(1), pnm(5)NOTES
An additional compression format, packbits, was added with PalmOS 4.0. This package should be updated to be able to generate that.
Palm pixmaps may contains multiple renditions of the same pixmap, in different depths. To construct an N-multiple-rendition Palm pixmap
with pnmtopalm, first construct renditions 1 through N-1 using the -offset option, then construct the Nth pixmap without the -offset
option. Then concatenate the individual renditions together in a single file using cat.
AUTHORS
This program was originally written as ppmtoTbmp.c, by Ian Goldberg and George Caswell. It was completely re-written by Bill Janssen to
add color, compression, and transparency function.
Copyright 1995-2001 by Ian Goldberg, George Caswell, and Bill Janssen.
7 December 2000 pnmtopalm(1)