
varviff(1)                   Khoros                    varviff(1)

PROGRAM
     varviff - Extracts a single data value from a viff structure
     for the cantata parser.

SYNTAX
     varviff

     -i1            input file

     -x             x location

     -y             y location

     -b             band number

     -v             variable

     [-i2]          input file that is passed to output unmodi-
                    fied (used to gate operation)

     [-o]           connecting file

     [-V]           Gives the version for varviff

     [-U]           Gives the usage for varviff

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     varviff takes as input a viff data structure and extracts a
     single data value (pixel) based upon the user indicated
     location (X, Y, and band number).  The extracted data value
     is returned to the cantata parser to be assigned to the user
     specified "variable name".  The data thus extracted can then
     be referenced (by useing the specified variable name) in any
     valid Cantata expression.

     The optional input is used to gate when varviff runs.  If
     this optional input is used and the optional output is used,
     then the gating input is passed to the output unchanged.

     Note that band and location numbering begins at zero (0).

REQUIRED ARGUMENTS
     -i1    type: infile
            desc: input file

     -x     type: integer
            desc: x location

     -y     type: integer
            desc: y location

     -b     type: integer
            desc: band number

     -v     type: string
            desc: variable

OPTIONAL ARGUMENTS
     -i2    type: infile
            desc: input file that is passed to output unmodified
            (used to gate operation)

     -o     type: outfile
            desc: connecting file

EXAMPLES
     varviff -i image.xv -x 10 -y 3 -b 1  -v mean

SEE ALSO
     intro(1), verror(3), vgparms(3), vutils(3), lvarviff(3)
     Documentation on viff file format and data structure.

RESTRICTIONS
     varviff Does not work on data types: VFF_TYP_BIT,
     VFF_TYP_COMPLEX.

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

Khoros                    Release: 1.0                          1

