joystick_sethandler(3) Svgalib User Manual joystick_sethandler(3)

NAME
       joystick_sethandler,  joystick_setdefaulthandler - set the
       joystick event handler.

SYNOPSIS
       #include <vgajoystick.h>
       typedef void (*__joystick_handler) (int event, int number,
       char value, int joydev);

       void  joystick_sethandler(int  joydev,  __joystick_handler
       jh);
       void joystick_setdefaulthandler(int joydev);

DESCRIPTION
       By default, each  call  to  joystick_init(3)  enables  the
       default  handler  for  the  opened  joystick. This handler
       maintains a state table which can  be  read  by  the  joy-
       stick_getaxis(3),   joystick_getbutton(3),   joystick_but-
       ton1|2|3|4(3), joystick_getb1|2|3|4(3),  joystick_x|y|z(3)
       and joystick_getx|y|z(3) functions.

       If you define an own handler, the following parameters are
       passed:

              event one of the following values:

                     JOY_EVENTBUTTONDOWN a button was pressed.

                     JOY_EVENTBUTTONUP a button was released.

                     JOY_EVENTAXIS  the  joystick  position   was
                             changed.

                     All  other  values  are  reserved for future
                     use.

              number identifies the button or axis to which  this
                     event belongs.

              value  for  axis  events  the new position in range
                     -128 .. 127.See joystick_getaxis(3) for fur-
                     ther comments on the range.

              joydev   identifies  the  joystick  affected  (this
                     allows to use  one  handler  for  many  joy-
                     sticks).

       joydev  =  -1  modifies the event handler of all currently
       open joystick devices.

CAVEATS
       This  function  is  only  available  in  ELF  versions  of
       svgalib.  Due  to backwards compatibility issues it cannot
       be used with shared a.out libs.

SEE ALSO
       svgalib(7),   vgagl(7),   libvga(5),    joytest(6),
       mjoytest(6),   joystick_init(3),  joystick_close(3),  joy-
       stick_update(3), joystick_getnumaxes(3),  joystick_getnum-
       buttons(3),   joystick_getaxis(3),  joystick_getbutton(3),
       joystick_button1(3),   joystick_getb1(3),   joystick_x(3),
       joystick_getx(3).

AUTHOR
       The  svgalib  joystick  handler  was mostly done by Daniel
       Engstr\"om <daniel.engstrom@riksnett.no>.   Multiple  joy-
       stick,  VC  switching  support  and  code  to glue it into
       svgalib by Michael Weller  <eowmob@exp-math.uni-essen.de>.
       Part  of  the  code  is  based  on  code from C. Smith and
       Vojtech Pavlik.

Svgalib 1.3.0             14 April 1998                         1