palmtopnm(1) [debian man page]
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
pnmhistmap(1) General Commands Manual pnmhistmap(1) NAME
pnmhistmap - draw a histogram for a PGM or PPM file SYNOPSIS
pnmhistmap [-black] [-white] [-max N] [-verbose] [pnmfile] DESCRIPTION
Reads a portable anymap as input, although bitmap (PBM) input produces an error message and no image. Produces an image showing a his- togram of the color (or gray) values in the input. A graymap (PGM) input produces a bitmap output. A pixmap (PPM) input produces pixmap output with three overlaid histograms: a red one for the red input, a green one for the green input, and a blue one for the blue input. The output is fixed in size: 256 pixels wide by 200 pixels high. OPTIONS
-black Ignores the count of black pixels when scaling the histogram. -white Ignores the count of white pixels when scaling the histogram. The -black and -white options, which can be used seperately or together, are useful for images with a large percentage of pixels whose value is zero or 255, which can cause the remaining histogram data to become unreadbaly small. Note that, for pixmap inputs, these options apply to all colors; if, for example, the input has a large number of bright-red areas, you will probably want to use the -white option. -max N Force the scaling of the histogram to use N as the largest-count value. This is useful for inputs with a large percentage of sin- gle-color pixels which are not black or white. -verbose Report the progress of making the histogram, including the largest-count value used to scale the output. All flags can be abbreviated to their shortest unique prefix. BUGS
Assumes maxval is always 255. Images with a smaller maxval will only use the lower-value side of the histogram. This can be overcome either by piping the input through "pnmdepth 255" or by cutting and scaling the lower-value side of the histogram. Neither is a particu- larly elegant solution. Should allow the output size to be specified. SEE ALSO
pgmhist(1), ppmhist(1), pgm(5), ppm(5) AUTHOR
Wilson H. Bent. Jr. (whb@usc.edu). 25 October 1993 pnmhistmap(1)