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 oper-
     ates on either  the single-color cursor or  on the multi-
     color  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 multi-color cursor, the relevant attributes are:

     o   Color map
     o   Plane mask
     o   Multi-color cursor pattern
     o   Multi-color cursor mask
     o   Multi-color cursor foreground color
     o   Multi-color cursor background color
     o   Multi-color cursor origin
     o   Multi-color 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.  (See "gscatt"
     and "gsmcat.")

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