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:
- byte (choose Byte data storage type),
- or float (choose Float data storage type)
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.