palmtopnm

   Updated: 15 December 2000
   Table Of Contents

NAME

   palmtopnm - convert a Palm pixmap into a PNM image

SYNOPSIS

   palmtopnm [-verbose] [-rendition N] [-showhist]
   [palmfile]
   palmtopnm -transparent [-verbose] [palmfile]

DESCRIPTION

   This program is part of Netpbm.

   palmtopnm reads a Palm pixmap 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 pixmap to Standard Output.

OPTIONS

   -verbose
	  Display various interesting information about the input
file and
	  process.
   -transparent
	  If the Palm pixmap has a transparent color  set,  palm-
topnm writes the
	  value	 for  that  color  to Standard Output in the form
#RRGGBB, where
	  RR, GG, and BB are two-digit hexadecimal numbers  indi-
cating a value
	  in  the range 0 through 255. If no transparent color is
set in the
	  pixmap, palmtopnm writes nothing.  palmtopnm	does  not
generate any
	  output image when you specify -transparent.
   -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
	  This option causes palmtopnm to write	 a  histogram  of
colors in the
	  input file to Standard Error.



SEE ALSO

   pnmtopalm, pnm

LIMITATIONS

   An  additional  compression format, "packbits," has been added
with PalmOS
   4.0. This program does not handle it.

   You	currently  cannot generate an  alpha  mask  if	the  Palm
pixmap has a
   transparent color. However, you can still do this with ppmcol-
ormask with a
   Netpbm pipe similar to:

   palmtopnm pixmap.palm | ppmcolormask	 'palmtopnm  -transparent
pixmap.palm'

HISTORY

   Before  Netpbm  10.23 (July 2004), there was a -forceplain op-
tion. 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.
     _________________________________________________________________



Table Of Contents

     * NAME
     * SYNOPSIS
     * DESCRIPTION
     * OPTIONS
     * SEE ALSO
     * LIMITATIONS
     * HISTORY
     * AUTHORS

UNIX/Linux commands referenced on this page:

1. convert
2. as
3. file
4. pnmtopalm
5. time