pnmtov(1Vi)															       pnmtov(1Vi)

NAME

       pnmtov - convert portable anymap (PNM) image to Vista data file

SYNOPSIS

       pnmtov [-option ...] [infile] [outfile]

DESCRIPTION

       pnmtov converts an image from a portable anymap (PNM) file to a Vista data file. The following types of portable anymap may be converted:

	 o Portable  bitmap (PBM) and its ``rawbits'' variant. A PBM image is converted to a single-band Vista image with bit pixels. Pixel values
	   0 and 1 are swapped since, for PBM images, 0 denotes white and 1 denotes black.

	 o Portable graymap (PGM) and its ``rawbits'' variant. A PGM image is converted to a single-band Vista image with ubyte pixels.  The  full
	   range of PGM pixel values is mapped to [0,255] in the returned image.

	 o Portable pixmap (PPM) and its ``rawbits'' variant. A PPM image is converted to an RGB color image (nbands: 3, ncolors: 3, color_interp:
	   rgb) with ubyte pixels. The full range of PPM pixel values is mapped to [0,255] in the returned image.

       A wide range of filters are available for converting other image formats to PNM.

COMMAND LINE OPTIONS

       pnmtov accepts the following options:

       -help	      Prints a message describing options.

       -in infile     Specifies the input file, which is a PBM, PGM, or PPM file.

       -out outfile   Specifies the output file, which will be a Vista data file.

       -name name     Specifies the name to be given the converted image. Default: ``image''.

       Input and output files can be specified on the command line or allowed to default to the standard input and output streams.

SEE ALSO

       VImage(3Vi), Vfile(5Vi), Vista(7Vi),
       pnm(5), pbm(5), pgm(5), ppm(5)

AUTHOR

       Daniel Ko <ko@cs.ubc.ca>

Vista Version 1.12						   3 March 1994 						       pnmtov(1Vi)