glutMouseFunc - Man Page

Sets the mouse-button callback for the current window.

Library

OpenGLUT - input

Synopsis

#include <openglut.h>

void
glutMouseFunc(void( *callback )( int button, int state, int x, int y ));

Parameters


callback

Client hook for mouse-buttons.

Description

Whenever a mouse button is pressed or released in an OpenGLUT window, OpenGLUT checks if that window has a mouse-button (Mouse) callback registered. If so, OpenGLUT gives the event to the handler.


button

is the button number, starting from 0.


state

is


GLUT_UP

or


GLUT_DOWN

to indicate the button's new state. The other parameters are the mouse coordinates.

Mouse wheel motion can be reported as buttons. If you do not request otherwise, a wheel spun forward will act like a button clicking down, immediately followed by clicking up. Spinning the same wheel backward will act like a different button clicking. Mouse wheel pseudo-buttons are added after all real buttons.

While the button is held and the mouse is dragged, you receive mouse-motion events (glutMotionFunc()), even if the mouse is dragged out of the window.

This callback is bound to the


current window

.

Caveats

Reporting the wheel as buttons is actually inherited from X. freeglut added code to support this on WIN32. OpenGLUT inherited that support from freeglut.

Old GLUT defines the symbols


GLUT_LEFT_BUTTON,

GLUT_RIGHT_BUTTON,

and


GLUT_MIDDLE_BUTTON.

However, mice can have more than 3 buttons, so these symbols are deprecated.

Windows created via glutCreateMenuWindow() always cascade keyboard and mouse events to their parent.

See Also

glutMotionFunc(3) glutPassiveMotionFunc(3) glutMouseWheelFunc(3)

Referenced By

glutCreateMenuWindow(3), glutMotionFunc(3), glutMouseWheelFunc(3), glutPassiveMotionFunc(3), glutTabletButtonFunc(3), glutTabletMotionFunc(3).