Manual: palmtopnm

Palmtopnm User Manual(1)			   General Commands Manual			    Palmtopnm User Manual(1)

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

       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 fea‐
       tures.  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  Common Options ),
       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 hexadecimal 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 gen‐
	      erate any output image when you specify -transparent.

       -rendition N
	      Palm Bitmaps may contain several different renditions of the same image, with different depths.	By  default,
	      palmtopnm	 operates on the first rendition (rendition number 1) in the image.  This switch allows you to oper‐
	      ate  on  a different rendition.  The value must be between 1 and the number of renditions in the image, inclu‐
	      sive.

       -showhist
	      This option causes palmtopnm to write a histogram of colors in the input file to Standard Error.

SEE ALSO
       pnmtopalm(1), pamtopdbimg(1), pnm(1),

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)