glutButtonBoxFunc

sets the dial & button box button callback for the current window.

Signature

glutButtonBoxFunc( )-> void
glutButtonBoxFunc( function )
Specify handler for GLUT 'ButtonBox' events
    def handler( (int) button, (int) state ):
        return None

Parameters

VariablesDescription
func
The new button box callback function.

Description

glutButtonBoxFunc sets the dial & button box button callback for the current window. The dial & button box button callback for a window is called when the window has dial & button box input focus (normally, when the mouse is in the window) and the user generates dial & button box button presses. The button parameter will be the button number (starting at one). The number of available dial & button box buttons can be determined with glutDeviceGet( GLUT_NUM_BUTTON_BOX_BUTTONS ). The state is either GLUT_UP or GLUT_DOWN indicating whether the callback was due to a release or press respectively.
Registering a dial & button box button callback when a dial & button box device is not available is ineffectual and not an error. In this case, no dial & button box button callbacks will be generated.
Passing NULL to glutButtonBoxFunc disables the generation of dial & button box button callbacks. When a new window is created, no dial & button box button callback is initially registered.

See Also

glutDialsFunc glutDeviceGet glutSpaceballButtonFunc glutTabletButtonFunc