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

## 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)
```SUBROUTINE CIRCFI(x, y, radius)
```SUBROUTINE CIRCFS(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

 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.

### 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

 /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.

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