graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPCUS - Set Cursor Shape

GPCUS (wsid, ctype)

Purpose

Use GPCUS to select a cursor definition from the workstation's cursor shape table. The graPHIGS API uses this definition for the graphics cursor of the input devices which are controlled by a two-dimensional vector type physical input device. The cursor definition selected by this subroutine is used as a prompt of every input device which has a prompt that is the graphic cursor.

Optional cursor definitions include, full screen cross hair, disable (none), two color logical input, and user-defined. Only workstations which use the facilities of a window system (e.g., X-Windows) can specify none (-2 ) or two color cursor logical input (-3 ) A cursor definition of (-2) (none) allows the application to disable the graPHIGS API cursors and to use the cursor facilities of the window system instead.

The default cursor is a single color cursor with a shape type of zero. This is compatible with Version 1 of the graPHIGS API

Parameters

wsid -- specified by user, fullword integer

Workstation identifier.

ctype -- specified by user, fullword integer

Cursor definition. This parameter must contain one of the following values that are available on the workstation:

-3

Two color cursor logical input.

-2

None.

-1

Full screen cross hair cursor.

Logical input device dependent cursor.

>=1

User defined cursor shape. This value is used as an index to the workstation's cursor shape table and the cursor pointed to by this index is used as the graphical cursor.

Error Codes

25: SPECIFIED WORKSTATION DOES NOT EXIST
37: WORKSTATION IS NOT OF CATEGORY OUTIN
180: CURSOR SHAPE TYPE IS NOT SUPPORTED
182: CURSOR SHAPE TABLE INDEX NOT WITHIN WORKSTATION TABLE RANGE

Related Subroutines

GPCUR: Set Cursor Representation

RCP code

201344771 (X'0C004703')