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



-------------------------------------------------------------------------------
gsmcur



PURPOSE

Moves the cursor and makes it visible.

C SYNTAX

int gsmcur_ (x, y)

int *x, *y;

FORTRAN SYNTAX

INTEGER function gsmcur (x, y)

INTEGER x, y

PASCAL SYNTAX

FUNCTION gsmcur_ (

VAR x, y: INTEGER
): INTEGER [PUBLIC];

DESCRIPTION

The gsmcur subroutine makes the cursor visible (if not already visible) and
positions the cursor origin at the point indicated by the parameters.  This
subroutine operates on either the single-color cursor or on the multicolor
cursor.  The relevant attributes are different, depending on which cursor style
is currently defined.

For the single-color cursor, the relevant attributes are:

  o Color map
  o Plane mask
  o Cursor pattern
  o Cursor color index
  o Cursor origin.

For the multicolor cursor, the relevant attributes are:

  o Color map
  o Plane mask
  o Multicolor cursor pattern
  o Multicolor cursor mask
  o Multicolor cursor foreground color
  o Multicolor cursor background color



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

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



  o Multicolor cursor origin
  o Multicolor cursor logical operation.

Parameters

x, y              Indicate the coordinates of the desired position of the
                  cursor origin.

The cursor attributes must be set with the gscatt or gsmcat subroutine before
calling gsmcur.

The cursor is non-destructive.  This is achieved in a device-dependent manner.

RETURN VALUE

GS_SUCC  Successful.
GS_CORD  Invalid coordinate.
GS_UCUR  Undefined cursor.
GS_INAC  Virtual terminal inactive.

RELATED INFORMATION

In this book:  "gscatt,"  "gsecur," and "gsmcat."
































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