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.