Syntax

[C/C++:]
void gSetCursorType(int type, int forcol, int bakcol);

[F90:]
subroutine gSetCursorType(type, forcol, bakcol)
integer, intent(in) :: type,forcol,bakcol

Arguments

type
Cursor Type

= GDEFAULT,

Default

= GSMALLCROSS,

Small cross

= GMEDIUMCROSS,

Medium cross

= GLARGECROSS or GCROSSHAIR,

Crosshair cursor(full screen/window if available)

= GX,

Small X

= GLARGEX,

Large X

= GPOINTER,

Pointer

= GEXIT,

GINO stop icon

= GHOURGLASS,

Hourglass icon

= 5-79,

X-Windows specific cursor types (see Appendix B)

forcol
Colour index for software (XOR) cursor types (e.g. GCROSSHAIR)

bakcol
Colour index for software (XOR) cursor actions shapes

Description

The routine gSetCursorType() sets the shape/form of the current cursor or pointer.

When type = GDEFAULT, a default hardware cursor is defined. This may be a cross or pointer.

If type is outside the range of cursor types available on the current device (see gEnqDeviceState()) the default hardware cursor shape is used.

The arguments forcol and bakcol are used to define the colour index used when drawing some cursors or the cursor action shape respectively. They are only used where the cursor or action shapes are drawn using the XOR drawing method and therefore the colour seen will be the result of XORing the colour requested and the background over which it is drawn.

For older (non Windows) devices, the shape of the cursor is only changed either when the routine gGetCursorEvent() is called or when any event types are enabled with gAddEventType(). When GINO returns from gGetCursorEvent() or all event types are disabled (with gRemoveEventType()) the cursor is removed from the screen or its shape reverts to some default shape.

Some devices can define a polyline cursor of up to 200 vertices. The routine gSetCursorAction() is used for this option.

See Also

gSetCursorType Usage
Device Drivers
gAddEventType
gGetCursorEvent
gEnqDeviceState
gSetCursorAction
gWaitForEvent

---