# pnmtopalm(1) - man - phpman > **TLDR:** Convert a PNM image to a Palm bitmap. > - Convert a PNM image to a Palm bitmap: `pnmtopalm {{path/to/file.pnm}} > {{path/to/file.palm}}` - Specify the color depth of the resulting bitmap: `pnmtopalm {{-dep|-depth}} {{1|2|4|8|16}} {{path/to/file.pnm}} > {{path/to/file.palm}}` - Choose a compression method for the resulting bitmap: `pnmtopalm -{{scanline_compression|rle_compression|packbits_compression}} {{path/to/file.pnm}} > {{path/to/file.palm}}` - Build a custom colormap and include it in the resulting bitmap: `pnmtopalm {{-c|-colormap}} {{path/to/file.pnm}} > {{path/to/file.palm}}` - Specify the bitmap's density: `pnmtopalm {{-den|-density}} {{72|108|144|216|288}} {{path/to/file.pnm}} > {{path/to/file.palm}}` *Source: tldr-pages* --- [pnmtopalm(1)](https://www.chedong.com/phpMan.php/man/pnmtopalm/1/markdown) General Commands Manual [pnmtopalm(1)](https://www.chedong.com/phpMan.php/man/pnmtopalm/1/markdown) ## 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 col‐ ors in default Palm colormap). ## OPTIONS ### -verbose Display the format of the output file. ### -depth 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 out‐ put 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 compati‐ ble with the various PalmOS 3.x versions used in the Handspring Visor, so these images may also work in that device. ### -maxdepth Produce a file of minimal depth, but in any case less than _N_ bits wide. If you spec‐ ify 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 rendi‐ tions 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 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 hexadecimal 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 compression works only in Palm OS 2.0 and higher. ## SEE ALSO [**palmtopnm**(1)](https://www.chedong.com/phpMan.php/man/palmtopnm/1/markdown), [**ppmquant**(1)](https://www.chedong.com/phpMan.php/man/ppmquant/1/markdown), [**pnm**(5)](https://www.chedong.com/phpMan.php/man/pnm/5/markdown) ## 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** op‐ tion. 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 func‐ tion. Copyright 1995-2001 by Ian Goldberg, George Caswell, and Bill Janssen. 7 December 2000 [pnmtopalm(1)](https://www.chedong.com/phpMan.php/man/pnmtopalm/1/markdown)