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



-------------------------------------------------------------------------------
gsearc



PURPOSE

Draws an elliptical arc between two points.

C SYNTAX

int gsearc_ (cx, cy, ma, mi, ang, bx, by, ex, ey, rot)

int *cx, *cy, *ma, *mi, *ang, *bx, *by, *ex, *ey, *rot;

FORTRAN SYNTAX

INTEGER function gsearc (cx, cy, ma, mi, ang, bx, by, ex, ey, rot)

INTEGER cx, cy, ma, mi, ang, bx, by, ex, ey, rot

PASCAL SYNTAX

FUNCTION gsearc_ (

VAR cx, cy, ma, mi, ang, bx, by, ex, ey, rot : INTEGER
): INTEGER [PUBLIC];

DESCRIPTION

The gsearc subroutine draws a counterclockwise elliptical arc of the specified
axes and angle from the beginning point to the ending point.  The axes are
expressed in number of pixels.

The angle specifications are given in tenths of degrees, from 0 to 3600.
Values outside this range cause the gsearc 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 ellipse.

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





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






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



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

ma, mi   Define half of the nonzero major and minor axes of the ellipse.

ang      Defines the angle between the major axis and the x-axis.  If ang is 0,
         the major axis is on the x-axis and the minor axis is on the y-axis.
         The angle is expressed in tenths of degrees, from 0 to 3600.

bx, by   Define the coordinates of the beginning point on the ellipse.

ex, ey   Define the coordinates of the ending point on the ellipse.

rot      Specifies whether the application must perform rotational
         transformation.  Possible setting are:

         0    The coordinates of the beginning and ending points passed by the
              application correspond to an arc of an orthogonal ellipse.  No
              rotational transformation is performed, thus improving
              performance.

         1    The beginning and ending points are transformed by the
              application and lie on the off-axis ellipse.

         All other values are reserved and must not be used, as they may
         produce unpredictable results.

If the beginning and ending points are identical, regardless of whether or not
they are on the ellipse, a full ellipse is drawn.

RETURN VALUE

GS_SUCC  Successful.
GS_CORD  Invalid coordinate.
GS_ELMM  Invalid major or minor axis.
GS_INAC  Virtual terminal inactive.
GS_ANGL  Invalid angle.
GS_NMEM  Insufficient resources.
GS_AEND  Invalid end point.
GS_ASTR  Invalid start point.















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