debian man page for pnmtov

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)