NAME

glutSetCursor - changes the cursor image of the current window.

SYNTAX

#include <GLUT/glut.h>

void glutSetCursor(int cursor);

ARGUMENTS

cursor: Name of cursor image to change to. Possible values follow:

GLUT_CURSOR_RIGHT_ARROW: Arrow pointing up and to the right.
GLUT_CURSOR_LEFT_ARROW: Arrow pointing up and to the left.
GLUT_CURSOR_INFO: Pointing hand.
GLUT_CURSOR_DESTROY: Skull & cross bones.
GLUT_CURSOR_HELP: Question mark.
GLUT_CURSOR_CYCLE: Arrows rotating in a circle.
GLUT_CURSOR_SPRAY: Spray can.
GLUT_CURSOR_WAIT: Wrist watch.
GLUT_CURSOR_TEXT: Insertion point cursor for text.
GLUT_CURSOR_CROSSHAIR: Simple cross-hair.
GLUT_CURSOR_UP_DOWN: Bi-directional pointing up & down.
GLUT_CURSOR_LEFT_RIGHT: Bi-directional pointing left & right.
GLUT_CURSOR_TOP_SIDE: Arrow pointing to top side.
GLUT_CURSOR_BOTTOM_SIDE: Arrow pointing to bottom side.
GLUT_CURSOR_LEFT_SIDE: Arrow pointing to left side.
GLUT_CURSOR_RIGHT_SIDE: Arrow pointing to right side.
GLUT_CURSOR_TOP_LEFT_CORNER: Arrow pointing to top-left corner.
GLUT_CURSOR_TOP_RIGHT_CORNER: Arrow pointing to top-right corner.
GLUT_CURSOR_BOTTOM_RIGHT_CORNER: Arrow pointing to bottom-left corner.
GLUT_CURSOR_BOTTOM_LEFT_CORNER: Arrow pointing to bottom-right corner.
GLUT_CURSOR_FULL_CROSSHAIR: Full-screen cross-hair cursor (if possible, otherwise GLUT_CURSOR_CROSSHAIR).
GLUT_CURSOR_NONE: Invisible cursor.
GLUT_CURSOR_INHERIT: Use parent's cursor.

DESCRIPTION

glutSetCursor changes the cursor image of the current window. Each call requests the window system change the cursor appropriately. The cursor image when a window is created is GLUT_CURSOR_INHERIT. The exact cursor images used are implementation dependent. The intent is for the image to convey the meaning of the cursor name. For a top-level window, GLUT_CURSOR_INHERIT uses the default window system cursor.

X IMPLEMENTATION NOTES

GLUT for X uses SGI's _SGI_CROSSHAIR_CURSOR convention to access a full-screen cross-hair cursor if possible.

AUTHOR