# man > palmtopnm(1)

> **TLDR:** Convert a Palm bitmap file to a PNM image.
>
- Convert a Palm bitmap to a PNM image:
  `palmtopnm {{path/to/file.palm}} > {{path/to/file.pnm}}`
- Display information about the input file:
  `palmtopnm {{-verb|-verbose}} {{path/to/file.palm}} > {{path/to/file.pnm}}`
- Convert the n'th rendition of the image contained in the input file:
  `palmtopnm {{-r|-rendition}} {{n}} {{path/to/file.palm}} > {{path/to/file.pnm}}`
- Write a histogram of the colors in the input file to `stdout`:
  `palmtopnm {{-s|-showhist}} {{path/to/file.palm}} > {{path/to/file.pnm}}`
- Output the transparent color of the input image if set:
  `palmtopnm {{-t|-transparent}} {{path/to/file.palm}}`

*Source: tldr-pages*

---

_Palmtopnm_ _User_ [_Manual_(1)](https://www.chedong.com/phpMan.php/man/Manual/1/markdown)               General Commands Manual              _Palmtopnm_ _User_ [_Manual_(1)](https://www.chedong.com/phpMan.php/man/Manual/1/markdown)

## NAME
       palmtopnm - convert a Palm Bitmap to a PNM image


## SYNOPSIS
### palmtopnm

       [**-verbose**]

       [**-rendition _**N_]

       [**-showhist**]

       [_palmfile_] **palmtopnm**

### -transparent

       [**-verbose**]

       [_palmfile_]


## DESCRIPTION
       This program is part of [**Netpbm**(1)](https://www.chedong.com/phpMan.php/man/Netpbm/1/markdown).

       **palmtopnm  **reads  a  Palm Bitmap as input, from Standard Input or _palmfile_ and produces a PPM
       image as output.

       Alternatively (when you specify **-transparent**), **palmtopnm **writes the value of the  transparent
       color in the Palm Bitmap to Standard Output.

       **Palmtopnm  **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.


       •      Version 0

       •      Version 1

       •      Version 2

       •      Version 3 (new in Netpbm 10.27 (March 2005))

       •      Scanline compression

       •      RLE compression

       •      Packbits compression (new in Netpbm 10.27 (March 2005))



## OPTIONS
       In addition to the options common to all programs based on libnetpbm  (most  notably  **-quiet**,
       see ]8;;index.html#commonoptions\ Common Options]8;;\ ), **palmtopnm **recognizes the following command line options:



### -verbose
              Display various interesting information about the input file and process.


### -transparent
              If  the  Palm  Bitmap has a transparent color set, **palmtopnm **writes the value for that
              color to Standard Output in the form #RRGGBB, where RR, GG, and BB are two-digit hexa‐
              decimal numbers indicating a value in the range 0  through  255.   If  no  transparent
              color is set in the Bitmap, **palmtopnm **writes nothing.  **palmtopnm **does not generate any
              output image when you specify **-transparent**.


### -rendition N
              Palm  Bitmaps may contain several different renditions of the same image, with differ‐
              ent depths.  By default, **palmtopnm  **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.


### -showhist
              This option causes **palmtopnm **to write a histogram of colors in the input file to Stan‐
              dard Error.




## SEE ALSO
       [**pnmtopalm**(1)](https://www.chedong.com/phpMan.php/man/pnmtopalm/1/markdown), [**pamtopdbimg**(1)](https://www.chedong.com/phpMan.php/man/pamtopdbimg/1/markdown), [**pnm**(1)](https://www.chedong.com/phpMan.php/man/pnm/1/markdown),


## LIMITATIONS
       You cannot generate a transparency mask if the Palm Bitmap has a transparent color.  However,
       you can still do this with **ppmcolormask **with a Netpbm pipe similar to:

### palmtopnm bitmap.palm | ppmcolormask `palmtopnm -transparent bitmap.palm`


## HISTORY
       Before Netpbm 10.23 (July 2004), there was a **-forceplain **option.  But that had been redundant
       for a long time, since the Netpbm common option **-plain **does the same thing.


## 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.

## DOCUMENT SOURCE
       This manual page was generated by the Netpbm tool 'makeman' from  HTML  source.   The  master
       documentation is at

              **<http://netpbm.sourceforge.net/doc/palmtopnm.html>**

netpbm documentation                       26 January 2005                  _Palmtopnm_ _User_ [_Manual_(1)](https://www.chedong.com/phpMan.php/man/Manual/1/markdown)