Section 1: user commands and tools
NAME pamstretch-gen – use pamstretch and pnmscale to scale by non-integer values SYNOPSIS pamstretch-gen N [pnmfile] DESCRIPTION pamstretch-gen is a program which uses pamstretch(1), pnmfile(1), and pnmscale(1) to smoothly scale up a PNM file by any ratio; it’s like a more general version of pamstretch (hence the name). But other than the `any ratio’ bit,…
NAME pnmindex – build a visual index of a bunch of anymaps SYNOPSIS pnmindex [-size N] [-across N] [-colors N] [-black] [-title T] [-quant|-noquant] pnmfile … DESCRIPTION pnmindex creates an index image containing thumbnail (small) versions of a bunch of PNM files you supply. pnmindex labels each thumbnail and, optionally, contains a title. OPTIONS -size…
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 histogram of the color (or gray) values in the input. A graymap…
NAME pnmhisteq – histogram equalise a portable anymap SYNOPSIS pnmhisteq [-gray] [-rmap pgmfile] [-wmap pgmfile] [-verbose] [pnmfile] DESCRIPTION pnmhisteq increases the contrast of a portable graymap or pixmap through the technique of histogram equalisation[1]. A histogram of the luminance of pixels in the map is computed, from which a transfer function is calculated which…
NAME pnmgamma – perform gamma correction on a portable anymap SYNOPSIS pnmgamma [-ungamma] [-cieramp|-srgbramp] [value [pnmfile]] pnmgamma [-ungamma] [-cieramp|-srgbramp] redgamma greengamma bluegamma [pnmfile] DESCRIPTION Performs gamma correction on pseudo-PNM images. The PPM format specification specify that certain sample values in a file represent certain light intensities in an image. In particular, they specify that the…
NAME pnmflip – perform one or more flip operations on a portable anymap SYNOPSIS pnmflip [-leftright|-lr] [-topbottom|-tb] [-transpose|-xy] [-rotate90|-r90|-ccw ] [-rotate270|-r270|-cw ] [-rotate180|-r180] [pnmfile] DESCRIPTION Reads a portable anymap as input. Performs one or more flip operations, in the order specified, and writes out a portable anymap. OPTIONS The flip operations available are: left for…
NAME pnmfile – describe a portable anymap SYNOPSIS pnmfile [-allimages] [pnmfile …] DESCRIPTION Reads one or more Netpbm files as input. Writes out short descriptions of the image type, size, etc. This is mostly for use in shell scripts, so the format is not particularly pretty. OPTIONS -allimages Describe every image in each input file….
NAME pnmenlarge – read a portable anymap and enlarge it N times SYNOPSIS pnmenlarge N [pnmfile] DESCRIPTION Reads a portable anymap as input. Replicates its pixels N times, and produces a portable anymap as output. pnmenlarge can only enlarge by integer factors. The slower but more general pnmscale can enlarge or reduce by arbitrary factors,…
NAME pnmdepth – change the maxval in a portable anymap SYNOPSIS pnmdepth newmaxval [pnmfile] DESCRIPTION Reads a portable anymap as input. Scales all the pixel values, and writes out the image with the new maxval. Scaling the colors down to a smaller maxval will result in some loss of information. Be careful of off-by-one errors…
NAME pnmcut – cut a rectangle out of a portable anymap SYNOPSIS pnmcut [-left leftcol] [-right rightcol] [-top toprow] [-bottom bottomrow] [-width width] [-height height] [-pad] [-verbose] [ left top width height ] [pnmfile] All options may be abbreviated to the shortest unique prefix. DESCRIPTION Reads a PBM, PGM, or PPM image as input. Extracts…
NAME pnmcrop – crop a portable anymap SYNOPSIS pnmcrop [-white|-black|-sides] [-left] [-right] [-top] [-bottom] [pnmfile] All options may be abbreviated to their shortest unique prefix or specified with double hyphens. DESCRIPTION Reads a PBM, PGM, or PPM image as input. Removes borders that are the background color, and produces the same type of image as…
NAME pnmconvol – general MxN convolution on a portable anymap SYNOPSIS pnmconvol convolutionfile [pnmfile] DESCRIPTION Reads two portable anymaps as input. Convolves the second using the first, and writes a portable anymap as output. Convolution means replacing each pixel with a weighted average of the nearby pixels. The weights and the area to average are…
NAME pnmcomp – composite (overlay) two portable anymap files together SYNOPSIS pnmcomp [-xoff=X | -align={left,center,right}] [-yoff=Y | -valign={top,middle,bottom}] [-alpha=alpha-pgmfile] [-invert] overlay [pnm-input] [pnm-output] Minimum unique abbreviations are acceptable. DESCRIPTION pnmcomp reads two images and produces a composite image with one of the images overlayed on top of the other. The images need not be the…
NAME pnmcolormap – create quantization color map for a portable anymap SYNOPSIS pnmcolormap [-center|-meancolor|-meanpixel] [-spreadbrightness|-spreadluminosity] [-sort] [-square] ncolors|all [pnmfile] All options can be abbreviated to their shortest unique prefix. You may use two hyphens instead of one to designate an option. You may use either white space or an equals sign between an option name…
NAME pnmcat – concatenate portable anymaps SYNOPSIS pnmcat [-white|-black] -leftright|-lr [-jtop|-jbottom] pnmfile pnmfile … pnmcat [-white|-black] -topbottom|-tb [-jleft|-jright] pnmfile pnmfile … DESCRIPTION Reads portable anymaps as input. Concatenates them either left to right or top to bottom, and produces a portable anymap as output. pamdice splits an image up into smaller ones. pnmtile concatenates a…
NAME pnmarith – perform arithmetic on two portable anymaps SYNOPSIS pnmarith -add|-subtract|-multiply|-difference|-minimum|-maximum. pnmfile1 pnmfile2 DESCRIPTION Reads two portable anymaps as input. Performs the specified arithmetic operation, and produces a portable anymap as output. The two input anymaps must be the same width and height. The arithmetic is performed between corresponding pixels in the two anymaps,…
NAME pnmalias – antialias a portable anyumap. SYNOPSIS pnmalias [-bgcolor color] [-fgcolor color] [-bonly] [-fonly] [-balias] [-falias] [-weight w] [pnmfile] DESCRIPTION Reads a portable anymap as input, and applies anti-aliasing to background and foreground pixels. If the input file is a portable bitmap, the output anti-aliased image is promoted to a graymap, and a message…
NAME pnm2ppa – convert portable anymap (PNM) images to HP’s PPA printer format. SYNOPSIS pnm2ppa [options] [ -i infile ] [ -o outfile ] DESCRIPTION Reads portable anymap (PNM) format as input. Binary PNM formats pnmraw = {ppmraw (color pixmap), pgmraw (graymap), and pbmraw (black-and-white bitmap)} are strongly preferred. Output stream can be locally processed…
NAME pngtopnm – convert a Portable Network Graphics file into portable anymap SYNOPSIS pngtopnm [-verbose] [-alpha | -mix] [-background color] [-gamma value] [-text file] [-time] [pngfile] DESCRIPTION Reads a Portable Network Graphics as input. Produces a portable anymap as output. The type of the output file depends on the input file – if it’s black…
NAME pngtopam – convert a PNG image into a Netpbm image SYNOPSIS pngtopam [-verbose] [-alphapam | -alpha | -mix] [-background=color] [-gamma=value] [-text=filename] [-time] [-byrow] [pngfile] Minimum unique abbreviation of option is acceptable. You may use double hyphens instead of single hyphen to denote options. You may use white space in place of the equals sign…