glutSetCursor man page

glutSetCursor — Set the cursor image to be used for the current window

Library

OpenGLUT - window

Synopsis

#include <openglut.h>

void
glutSetCursor(int cursorID);

Parameters


cursorID


Name of desired cursor.

Description

For the


current window


, sets the mouse-cursor to one of a set of predefined images. The GLUT symbolic constant IDs are:


-


GLUT_CURSOR_RIGHT_ARROW


-


GLUT_CURSOR_LEFT_ARROW


-


GLUT_CURSOR_INFO


-


GLUT_CURSOR_DESTROY


-


GLUT_CURSOR_HELP


-


GLUT_CURSOR_CYCLE


-


GLUT_CURSOR_SPRAY


-


GLUT_CURSOR_WAIT


-


GLUT_CURSOR_TEXT


-


GLUT_CURSOR_CROSSHAIR


-


GLUT_CURSOR_UP_DOWN


-


GLUT_CURSOR_LEFT_RIGHT


-


GLUT_CURSOR_TOP_SIDE


-


GLUT_CURSOR_BOTTOM_SIDE


-


GLUT_CURSOR_LEFT_SIDE


-


GLUT_CURSOR_RIGHT_SIDE


-


GLUT_CURSOR_TOP_LEFT_CORNER


-


GLUT_CURSOR_TOP_RIGHT_CORNER


-


GLUT_CURSOR_BOTTOM_RIGHT_CORNER


-


GLUT_CURSOR_BOTTOM_LEFT_CORNER

Additionally, there are the following special cases:


GLUT_CURSOR_FULL_CROSSHAIR


This cursor, where supported, draws a crosshair the full width and height of the display. It may be mapped by OpenGLUT to the


GLUT_CURSOR_CROSSHAIR,

however.


GLUT_CURSOR_NONE


Turn the mouse cursor invisibile.


GLUT_CURSOR_INHERIT


Take the cursor that the parent window provides.

Caveats

The X branch of OpenGLUT does not do thorough error checking.

The X branch of OpenGLUT always converts


FULL_CROSSHAIR


to


CROSSHAIR.


This is acceptable, but if a host system supports a fullscreen crosshair, it would be nice to support that.

Out of range


cursorID


values generate warnings.

Has no visible effect if the


current window


is of type


GLUT_OFFSCREEN


.

Bugs

Some


cursorID


values are not yet supported on WIN32.

Referenced By

glutSetOption(3).