RETRO commands


PROGRAM NAME

vgcirc - Create Image of a Filled Circle (K1)

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

OPTIONAL ARGUMENTS

-trigger
type: infile
desc: trigger input
default: {none}
-r
type: integer
desc: Number of rows in output image
default: 512
bounds: value > 0
-c
type: integer
desc: 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
-t
type: string toggle
desc: Selects data type of output image
default: byte
allowed values:

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

RESTRICTIONS

vgcirc will generate only BYTE or FLOAT images.

REFERENCES

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.