circf Subroutine

Purpose

Draws a filled circle.

Libraries

Graphics Library

C (libgl.a)

FORTRAN (libfgl.a)

C Syntax

void circf(Coord x, Coord y, Coord radius)

void circfi(Icoord x, Icoord y, Icoord radius)

void circfs(Scoord x, Scoord y, Scoord radius)

FORTRAN Syntax

SUBROUTINE CIRCF(x, y, radius)
REAL x, y, radius

SUBROUTINE CIRCFI(x, y, radius)
INTEGER*4 x, y, radius

SUBROUTINE CIRCFS(x, y, radius)
INTEGER*2 x, y, radius

Note: For FORTRAN users, the INTEGER*2 version, the CIRCFS subroutine, should not be called with integer constant parameters. For example, 2 is an integer constant; JJ is an integer variable. The XL FORTRAN compiler, invoked by the xlf command, stores all integer constants as long integers (INTEGER*4), not as short integers (INTEGER*2). Invoking the short version of this subroutine with an integer constant will result in unexpected behavior.

Description

The circf subroutine draws a filled circle in the x-y plane (z = zero). The system draws the circle using the current area attributes: color, repeat factor, and writemask. To create a filled circle that does not lie in the x-y plane, draw the circle in the x-y plane, then rotate or translate the circle. Filled circles rotated outside the 2-D x-y plane appear as filled ellipses.

All of the routines listed in the syntax are functionally the same. They differ only in the type declarations for the coordinates.

Parameters

Example

The example C language program tpbig.c uses the circf subroutine to draw a scoop of cherry ice cream.

Implementation Specifics

This subroutine is part of GL in the AIXwindows Environment/6000 Version 1, Release 2 with AIXwindows/3D Feature.

Files

Related Information

Drawing a circular arc with the arc subroutine.

Drawing a filled circular arc with the arcf subroutine.

Drawing a circle with the circ subroutine.

Drawing a curve with the crv subroutine.

AIX Graphics Library Overview, Setting Drawing Attributes, and Drawing Rectangles, Circles, Arcs, and Polygons.