
vgconst(1)                   Khoros                    vgconst(1)

PROGRAM
     vgconst - Creates an image with constant pixel values.

SYNTAX
     vgconst

     -o             resulting image

     [-trigger]     trigger input

     [-r]           Number of rows

     [-c]           Number of columns

     [-b]           Number of data bands

     [-l]           image constant level

     [-m]           image imaginary constant level

     [-t]           lets user choose data type of image:
                     'bit' (choose bit data type),
                     'byte' (choose byte data type),
                     'short' (choose short data type),
                     'int' (choose integer data type),
                     'float' (choose float data type),
                     'double' (choose double data type),
                     'complex' (choose complex data type),
                      or 'dcomplex' (choose dcomplex data type)
                       [default = float]

     [-V]           Gives the version for vgconst

     [-U]           Gives the usage for vgconst

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     vgconst :  creates an image of dimension rows * columns *
     bands. The image pixel values are constant. The user can
     specify the constant value (level).

     This routine will create multiband images and works with
     data types BIT, BYTE, SHORT, INT, FLOAT, DOUBLE, COMPLEX and
     DCOMPLEX.

     If the level value specified by user is greater than 255,
     the level value will be scaled down to 255. If the level
     specified by user is less than 0, the level value will by
     scaled up to 0.

     The resulting images may be of type byte, short, int or
     float, or complex.

     The trigger input can be used to cause vgconst to re-execute
     when used inside cantata. No image is read from this input.

REQUIRED ARGUMENTS
     -o     type: outfile
            desc: resulting image

OPTIONAL ARGUMENTS
     -trigger
            type: infile
            desc: trigger input

     -r     type: integer
            desc: Number of rows
            default: 512
            bounds: value > 0

     -c     type: integer
            desc: Number of columns
            default: 512
            bounds: value > 0

     -b     type: integer
            desc: Number of data bands
            default: 1
            bounds: value > 0

     -l     type: float
            desc: image constant level
            default: 0
            bounds: no range checking

     -m     type: float
            desc: image imaginary constant level
            default: 0
            bounds: no range checking

     -t     type: string
            desc: lets user choose data type of image
            allowed values:
             'bit' (choose bit data type),
             'byte' (choose byte data type),
             'short' (choose short data type),
             'int' (choose integer data type),
             'float' (choose float data type),
             'double' (choose double data type),
             'complex' (choose complex data type),
              or 'dcomplex' (choose dcomplex data type)

EXAMPLES
     vgconst -o const -r 256 -c 256 -b 3 -t int -l 10

     Creates an image called const of size 256x256 with 3 data
     bands of data storage type INT. The constant level is 10.

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

RESTRICTIONS
     does not support transformed images.

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

Khoros                    Release: 1.0                          1

