[ Next Article |
Previous Article |
Book Contents |
Library Home |
Legal |
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***)**
**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

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

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

[ Next Article |
Previous Article |
Book Contents |
Library Home |
Legal |
Search ]