
vgcirc(1)                    Khoros                     vgcirc(1)

PROGRAM
     vgcirc - Creates an image of a filled circle

SYNTAX
     vgcirc

     -o             output image

     -t             Selects data type of output image:
                     'byte' (choose Byte data storage type),
                      or 'float' (choose Float data storage type)

     [-trigger]     trigger input

     [-r]           Desired number of rows in output image

     [-c]           Desired number of columns in output image

     [-d]           Diameter of circle (in pixels)

     [-x]           X coordinate of center of circle

     [-y]           Y coordinate of center of circle

     [-b]           Background level

     [-f]           Foreground level

     [-V]           Gives the version for vgcirc

     [-U]           Gives the usage for vgcirc

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     vgcirc creates an image of a filled circle. The background
     intensity is set by the -b argument. The foreground or cir-
     cle intensity is set by the -f argument.  The circle can be
     placed anywhere, and is NOT required to lie completely
     within the image boundaries.

     The position of the center of the circle and its diameter
     can all be specified as floating point numbers, allowing
     sub-pixel positioning of the circle.

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

REQUIRED ARGUMENTS
     -o     type: outfile
            desc: output image

     -t     type: string
            desc: Selects data type of output image
            allowed values:
             'byte' (choose Byte data storage type),
              or 'float' (choose Float data storage type)

OPTIONAL ARGUMENTS
     -trigger
            type: infile
            desc: trigger input

     -r     type: integer
            desc: Desired number of rows in output image
            default: 512
            bounds: value > 0

     -c     type: integer
            desc: Desired number of columns in output image
            default: 512
            bounds: value > 0

     -d     type: float
            desc: Diameter of circle (in pixels)
            default: 256
            bounds: value >= 0.0

     -x     type: float
            desc: X coordinate of center of circle
            default: 256
            bounds: no range checking

     -y     type: float
            desc: Y coordinate of center of circle
            default: 256
            bounds: no range checking

     -b     type: float
            desc: Background level
            default: 0
            bounds: no range checking

     -f     type: float
            desc: Foreground level
            default: 255
            bounds: no range checking

EXAMPLES
     vgcirc -r 32 -c 32 -b 3.5 -f 107.5 -x 32 -y 16 -d 32 -t
     float

     Creates a 32x32 image of type FLOAT, with the background
     level at 3.5 and the foreground at 107.5. The circle lies in
     this case halfway off the image to the right.  The diameter
     of the circle is 32 pixels.

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

RESTRICTIONS
     vgcirc will generate only BYTE or FLOAT images.

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

Khoros                    Release: 1.0                          1

