[ Previous | Next | Contents | Glossary | Home | Search ]
GL3.2 for AIX: Graphics Library (GL) Technical Reference

circf Subroutine


Draws a filled circle.


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)


SUBROUTINE CIRCF(x, y, radius)
REAL x, y, radius
INTEGER*4 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.


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.


x Specifies the x coordinate of the center of the circle specified in modeling coordinates.
y Specifies the y coordinate of the center of the circle specified in modeling coordinates.
radius Specifies the length of the radius of the circle.


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.


/usr/include/gl/gl.h Contains C language constant and variable type definitions for GL.
/usr/include/gl/fgl.h Contains FORTRAN constant and variable type definitions for GL.

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.

[ Previous | Next | Contents | Glossary | Home | Search ]