Futurebasic/Language/Reference/circle

statement
✔ Appearance ✔  Standard ✔ Console

Syntax
CIRCLE [ FILL ] x, y, radius [ { TO | PLOT} startAngle, angleSize]

Description
Draws a circle, an arc or a wedge in the current foreground color, pen pattern and pen size. If a circle or wedge is drawn using the  keyword, the circle or wedge will be filled with the current pen pattern. When used in combination with the  statement,   can be used to draw ellipses and elliptical arcs and wedges.

If the current  is set to 0,0 (the default), then   behaves as follows:

If only the,  , and   parameters are specified, then a complete circle is drawn, with its center at point  and having a radius of   pixels.

If the  keyword is specified, then a wedge (two radii plus an arc) is drawn. The first radius is drawn in the orientation specified by, which is measured in units of "brads" (see below). Angles are measured counterclockwise starting from the "3-o'clock" position, which corresponds to zero brads. The  parameter specifies the angular width of the wedge (also in brads); the wedge always extends counterclockwise from the   position. Note that the width of the "wedge" may be greater than a half-circle, in which case the "wedge" looks more like a Pac-Man.

If the  keyword is specified, then an arc is drawn without any radii. The position and size of the arc are the same as when the  keyword is specified. If both the  keyword and the   keyword are specified, then the   command does nothing.

"Brads" are an angular unit in which a full circle corresponds to 256 brads. A brad is therefore slightly larger than a degree (to be exact, it's 360/256 of a degree). A half circle therefore equals 128 brads, and a right angle equals 64 brads.

Example
CD Example: CIRCLE.BAS

"FB Lite" behavior: When you use the "FB Lite" runtime,  always switches to the Graphics Window before drawing. You can't use  to draw a circles and arcs in the Text Window, or on the printer; use the Toolbox procedures ,   or   instead. Alternatively, you can activate the graphics window and select Print from the File menu.

Note
If you use values outside the range 0..255 for  and/or , then values modulo 256 will be used.