A call to gSetCursorPos() defines the start position for the graphics pointer or cursor on non-windowing devices and defines the start position for cursor actions (rubber band etc.) on windowing devices. If cursor positioning is supported by the device (see Appendix B), the pointer/cursor will appear at (x,y) when gGetCursorEvent() or gAddEventType() is next called.
The default for the pointer/cursor start position is the centre of the device limits. The cursor start position is reset to the default after any call to gNewDrawing(). If a call to gGetCursorEvent() is successful, the cursor start position may be set to the position returned by gGetCursorEvent() depending on the device.
The position (x,y) should be specified to be within the device limits. If it is outside these, a warning message is output and the cursor start position defaults to the centre of the device limits.
The routine gSetMousePos() can be used to set the position (in pixels) of the graphics pointer on windowing devices.
