
vbandspt1(1)                 Khoros                  vbandspt1(1)

PROGRAM
     vbandspt1 - Extract a specified data band from a multiband
     image

SYNTAX
     vbandspt1

     -i             input image filename

     -o             output image filename

     [-b]           Data band number to extract

     [-V]           Gives the version for vbandspt1

     [-U]           Gives the usage for vbandspt1

     [-P]           Prompts for command line options

     [-A [file1]]   Creates the answer file called vbandspt1.ans
                    or file1

     [-a [file1]]   Uses vbandspt1.ans or file1 as the answer
                    file

DESCRIPTION
     vbandspt1 extracts a specified band from an image and
     creates a new image containing only that band. The map is
     also carried along with the new image, the map scheme will
     become ONEPERBAND regardless of the input image's map
     scheme.  The comment field of the new image will read the
     same as the comment field of the input image, except it is
     append with the band number and the filename from which the
     band was taken.

     The -b option determines which data band to extract. NOTE:
     band numbering begins with 0.

REQUIRED ARGUMENTS
     -i     type: infile
            desc: input image filename

     -o     type: outfile
            desc: output image filename

OPTIONAL ARGUMENTS
     -b     type: integer
            desc: Data band number to extract
            default: 0
            bounds: value >= 0

EXAMPLES
     vbandspt1 -i ball.rgb.xv -o ball.b.xv -b 2

     This will extract the third band  (the band representing
     blue), from the 3 band rgb input image.  The result is a 1
     band image stored as ball.b.xv.

SEE ALSO
     intro(1), verror(3), vgparms(3), vutils(3) vbandspt3(1)

RESTRICTIONS
COPYRIGHT
     Copyright 1991, University of New Mexico.  All rights
     reserved.

Khoros                    Release: 1.0                          1

