glutdeviceget(3) [centos man page]

UNTITLED
							       LOCAL								  UNTITLED

NAME

     glutDeviceGet -- Allows you to get some device state/option variables.

LIBRARY

     OpenGLUT - inputstate

SYNOPSIS

     #include <openglut.h>

     int
     glutDeviceGet(GLenum eWhat);

PARAMETERS

      eWhat	Enumerated parameter ID.

DESCRIPTION

     Retrieves some system-specific information about attached devices.  Supported device queries are:

      -  GLUT_HAS_JOYSTICK
     Return non-zero if there is a joystick.

      -  GLUT_HAS_KEYBOARD
     Return non-zero if there is a keyboard.

      -  GLUT_HAS_MOUSE
     Return non-zero if there is a mouse.

      -  GLUT_HAS_SPACEBALL
     Return non-zero if there is a spaceball.

      -  GLUT_JOYSTICK_AXES
     Return the number of axes for the joystick.

      -  GLUT_JOYSTICK_POLL_RATE
     Return the rate (in GLUT timer ticks?) at which the joystick is polled.

      -  GLUT_NUM_MOUSE_BUTTONS
     Return the number of buttons that the user's mouse has.

      -  GLUT_OWNS_JOYSTICK
     Return non-zero if OpenGLUT believes that it has successfully acquired access to the joystick.

      -  GLUT_DEVICE_IGNORE_KEY_REPEAT
     Return non-zero if the  current window   is set to disable key repeating.

      -  GLUT_DEVICE_KEY_REPEAT
     Described as returning the key repeat rate in one place, but actually returns a key repeat mode.

      -  GLUT_HAS_DIAL_AND_BUTTON_BOX
     Return non-zero if a dials-and-buttons box is present.

      -  GLUT_HAS_TABLET
     Return non-zero if a tablet is present.

      -  GLUT_NUM_BUTTON_BOX_BUTTONS
     Return the number of buttons on a dials-and-buttons box, if any.

      -  GLUT_NUM_DIALS
     Return the number of dials on a dials-and-buttons box, if any.

      -  GLUT_NUM_SPACEBALL_BUTTONS
     Return the number of buttons on a spaceball, if any.

      -  GLUT_NUM_TABLET_BUTTONS
     Return the number of buttons on a tablet, if any.

TODO

     Only supports querying for one joystick.

     Consider moving to a table-based approach rather than a switch(), letting us move to modular functions.

BUGS

     Keyboards are optional, but OpenGLUT doesn't detect their absence.

     Mice are optional, but OpenGLUT is only able to check for them under WIN32.

     Mice can have a varying number of buttons, but OpenGLUT assumes exactly 3 on UNIX_X11.

     Not all joystick queries are implemented yet.

      GLUT_DEVICE_KEY_REPEAT  returns the key repeat mode, but the comment says it returns the	rate  .

     Some things, like joystick poll rates, seem to have insufficient context.	Which joystick?  Which window? Maybe we assume the  current window
       and the current joystick (or the first one)?

      GLUT_DEVICE_KEY_REPEAT  should probably return  ogState.KeyRepeat.

SEE ALSO

     glutSetOption(3) glutGet(3) glutGetModifiers(3) glutLayerGet(3)

								       Epoch

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)