Manpages

Manpage of joystick_sethandler

joystick_sethandler

Section: Svgalib User Manual (3)
Updated: 14 April 1998
Index
Return to Main Contents
 

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 joystick_getaxis(3), joystick_getbutton(3), joystick_button1|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 further comments on the range.

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

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.config(5), joytest(6), mjoytest(6), joystick_init(3), joystick_close(3), joystick_update(3), joystick_getnumaxes(3), joystick_getnumbuttons(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 joystick, 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.


 

Index

NAME
SYNOPSIS
DESCRIPTION
CAVEATS
SEE ALSO
AUTHOR

This document was created by man2html, using the manual pages.
Time: 11:18:52 GMT, March 29, 2024