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.