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 circle 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.