vtopgm(1Vi)															       vtopgm(1Vi)

NAME

       vtopgm - convert image from Vista data file to portable graymap

SYNOPSIS

       vtopgm [-option ...] [infile] [outfile]

DESCRIPTION

       vtopgm  converts one band of an image to a portable graymap (PGM) file. A wide range of filters are available to convert PGM files to other
       formats.

       This program only produces portable graymaps whose pixel values are in the range 0 to 255. Any type of Vista image  is  accepted,  but  the
       image is first converted to have ubyte pixels if necessary. This conversion is performed by VConvertImageRange(3Vi).

COMMAND LINE OPTIONS

       vtopgm accepts the following options:

       -help	      Prints a message describing options.

       -in infile     Specifies  a  Vista data file containing the image to be converted. If the file contains more than one image, only the first
		      is used.

       -out outfile   Specifies the file to contain the portable graymap.

       -band band     Specifies the image band to be converted. Default: 0.

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

SEE ALSO

       pgm(5), VImage(3Vi), Vista(7Vi)

AUTHOR

       David Lowe <lowe@cs.ubc.ca>

Vista Version 1.12						   24 April 1993						       vtopgm(1Vi)