Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

glutjoystickfunc(3glut) [osx man page]

glutJoystickFunc(3GLUT) 					       GLUT						   glutJoystickFunc(3GLUT)

NAME

       glutJoystickFunc - sets the joystick callback for the current window.

SYNTAX

       #include <GLUT/glut.h>

       void glutJoystickFunc(void (*func)(unsigned int buttonMask,
			    int x, int y, int z), int pollInterval);

ARGUMENTS

       func	 The new joystick callback function.

       pollInterval
		 Joystick polling interval in milliseconds.

DESCRIPTION

       glutJoystickFunc sets the joystick callback for the current window.

       The joystick callback is called either due to polling of the joystick at the uniform timer interval specified by pollInterval (in millisec-
       onds) or in response to calling glutForceJoystickFunc.  If the pollInterval is non-positive, no joystick polling is performed and the  GLUT
       application must frequently (usually from an idle callback) call glutForceJoystickFunc.

       The  joystick  buttons are reported by the callback's buttonMask parameter.  The constants GLUT_JOYSTICK_BUTTON_A(0x1), GLUT_JOYSTICK_BUT-
       TON_B(0x2), GLUT_JOYSTICK_BUTTON_C(0x4), and GLUT_JOYSTICK_BUTTON_D(0x8) are provided for programming convience.

       The x, y, and z callback parameters report the X, Y, and Z axes of the joystick.  The joystick is centered at (0,0,0).  X,  Y,  and  Z  are
       scaled  to range between -1000 and 1000.  Moving the joystick left reports negative X; right reports positive X.  Pulling the stick towards
       you reports negative Y; push the stick away from you reports positive Y.  If the joystick has  a  third	axis  (rudder  or  up/down),  down
       reports negative Z; up reports positive Z.

       Passing	a NULL func to glutJoystickFunc disables the generation of joystick callbacks.	Without a joystick callback registered, glutForce-
       JoystickFunc does nothing.

       When a new window is created, no joystick callback is initially registered.

LIMITATIONS

       The GLUT joystick callback only reports the first 3 axes and 32 buttons.  GLUT supports only a single joystick.

GLUT IMPLEMENTATION NOTES FOR X11
       The GLUT 3.7 implementation of GLUT for X11 supports the joystick API, but not joystick input.  A future implementation of GLUT for X11 may
       add joystick support.

GLUT IMPLEMENTATION NOTES FOR WIN32
       The GLUT 3.7 implementation of GLUT for Win32 supports the joystick API and joystick input, but does so through the dated joySetCapture and
       joyGetPosEx Win32 Multimedia API.  The GLUT 3.7 joystick support for Win32 has all the limitations of the  Win32  Multimedia  API  joystick
       support.  A future implementation of GLUT for Win32 may use DirectInput.

SEE ALSO

       glutForceJoystickFunc,  glutMotionFunc,	glutMouseFunc, glutSpaceballButtonFunc, glutSpaceballMotionFunc, glutButtonBoxFunc, glutTabletBut-
       tonFunc, glutDeviceGet

AUTHOR

       Mark J. Kilgard (mjk@nvidia.com)

GLUT
									3.7						   glutJoystickFunc(3GLUT)

Check Out this Related Man Page

glutMouseFunc(3GLUT)						       GLUT						      glutMouseFunc(3GLUT)

NAME

       glutMouseFunc - sets the mouse callback for the current window.

SYNTAX

       #include <GLUT/glut.h>

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

ARGUMENTS

       func	 The new mouse callback function.

DESCRIPTION

       glutMouseFunc  sets the mouse callback for the current window. When a user presses and releases mouse buttons in the window, each press and
       each release generates a mouse callback. The button parameter is one of GLUT_LEFT_BUTTON,  GLUT_MIDDLE_BUTTON,  or  GLUT_RIGHT_BUTTON.  For
       systems	with  only two mouse buttons, it may not be possible to generate GLUT_MIDDLE_BUTTON callback. For systems with a single mouse but-
       ton, it may be possible to generate only a GLUT_LEFT_BUTTON callback. The state parameter is either GLUT_UP or GLUT_DOWN indicating whether
       the  callback was due to a release or press respectively. The x and y callback parameters indicate the window relative coordinates when the
       mouse button state changed. If a GLUT_DOWN callback for a specific button is triggered, the program can assume a GLUT_UP callback  for  the
       same  button  will  be  generated (assuming the window still has a mouse callback registered) when the mouse button is released even if the
       mouse has moved outside the window.

       If a menu is attached to a button for a window, mouse callbacks will not be generated for that button.

       During a mouse callback, glutGetModifiers may be called to determine the state of modifier keys when the mouse event generating	the  call-
       back occurred.

       Passing NULL to glutMouseFunc disables the generation of mouse callbacks.

SEE ALSO

       glutKeyboardFunc, glutMotionFunc, glutSpaceballButtonFunc, glutButtonBoxFunc, glutTabletButtonFunc, glutGetModifiers

AUTHOR

       Mark J. Kilgard (mjk@nvidia.com)

GLUT
									3.7						      glutMouseFunc(3GLUT)
Man Page