gscrca(3g) — AIX PS/2 1.2.1



GSCRCA(3g,L)                AIX Technical Reference                GSCRCA(3g,L)



-------------------------------------------------------------------------------
gscrca



PURPOSE

Draws a circular arc between two angles.

C SYNTAX

int gscrca_ (cx, cy, cr, ba, ea)

int *cx, *cy, *cr, *ba, *ea;

FORTRAN SYNTAX

INTEGER function gscrca (cx, cy, cr, ba, ea)

INTEGER cx, cy, cr, ba, ea

PASCAL SYNTAX

FUNCTION gscrca_ (

VAR cx, cy, cr, ba, ea : INTEGER
): INTEGER [PUBLIC];

DESCRIPTION

The gscrca subroutine draws a counterclockwise circular arc of the specified
radius from the beginning point as defined by an angle specification to the
ending point as defined by an angle specification.

The angle specifications are given in tenths of degrees, from 0 to 3600.
Values outside this range cause the gscrca subroutine to fail.

The relevant attributes are:

  o Color map
  o Plane mask
  o Line color index
  o Line style
  o Logical operation.

Parameters

cx, cy   Define the coordinates of the center of the circle.

         For displays, the center is restricted to -2048 to 2048.





Processed November 7, 1990       GSCRCA(3g,L)                                 1



GSCRCA(3g,L)                AIX Technical Reference                GSCRCA(3g,L)



         For printers and plotters, the center is restricted to screen
         coordinates.

cr       Defines the radius of the circle in device coordinates.

ba       Defines the start point of the circular arc as an angle in tenths of
         degrees, from 0 to 3600.

ea       Defines the end point of the circular arc as an angle in tenths of
         degrees, from 0 to 3600.

If the beginning and ending angles are identical, a full circle is drawn.

RETURN VALUE

GS_SUCC  Successful.
GS_ANGL  Invalid angle.
GS_RDUS  Invalid radius specification.
GS_CORD  Invalid coordinate.
GS_INAC  Virtual terminal inactive.



































Processed November 7, 1990       GSCRCA(3g,L)                                 2

Museum