
vbandspt3(1)                 Khoros                  vbandspt3(1)

PROGRAM
     vbandspt3 - Extract 3 data bands from a multiband image

SYNTAX
     vbandspt3

     -i             input image filename

     [-o1]          output image filename

     [-o2]          output image filename

     [-o3]          output image filename

     [-b]           Data band number to extract

     [-V]           Gives the version for vbandspt3

     [-U]           Gives the usage for vbandspt3

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     vbandspt3 extracts 3 bands from an image and creates new
     images containing only one band. The 3 bands extracted start
     with the band number Specified by the -b option. The band
     numbering scheme starts at zero.

     The map is 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 output files are optional arguments, if all or any out-
     put files names are not specified, vbandspt3 will use the
     input filename with a suffix appended to it as the output
     filenames.  The suffixes are determined by the color space
     model:

     NONE or GENERIC:
             input_filename.1
             input_filename.2
             input_filename.3

     ntscRGB or genericRGB or cieRGB:
             input_filename.R
             input_filename.G
             input_filename.B

     ntscYIQ:
             input_filename.Y
             input_filename.I
             input_filename.Q

     ntscCMY:
             input_filename.C
             input_filename.M
             input_filename.Y

     HLS:    input_filename.H
             input_filename.L
             input_filename.S

     HSV:    input_filename.H
             input_filename.S
             input_filename.V

     IHS:    input_filename.I
             input_filename.H
             input_filename.S

     cieUVW or cieucsUVW:
             input_filename.U
             input_filename.V
             input_filename.W

     cieucsSOW:
             input_filename.S
             input_filename.O
             input_filename.W

     cieucsLab:
             input_filename.L
             input_filename.a
             input_filename.b

     cieucsLuv:
             input_filename.L
             input_filename.u
             input_filename.v

     The -b option determines which data band to extract. The
     default is 1.

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

OPTIONAL ARGUMENTS
     -o1    type: outfile
            desc: output image filename

     -o2    type: outfile
            desc: output image filename

     -o3    type: outfile
            desc: output image filename

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

EXAMPLES
     vbandspt3 -i test

     The file test must contain at least 3 data bands, and if it
     had a color space model = HLS, the output files would be:
     test.H, test.L, and test.S. If it had no color space model,
     the output files would be: test.1, test.2 and test.3. In
     this case bands 0, 1, and 2 would be extracted.

     vbandspt3 -i test -o1 bee -o2 junk -o3 yy -b 3

     The image "bee" would be band number 3, "junk" would be band
     number 4 and "yy" would be band number 5. Thus, the image
     must contain at least 5 data bands.

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

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

Khoros                    Release: 1.0                          1

