install_joystick(3) Allegro manual install_joystick(3)NAMEinstall_joystick - Initialises the joystick. Allegro game programming
library.
SYNOPSIS
#include <allegro.h>
int install_joystick(int type);
DESCRIPTION
Installs Allegro's joystick handler, and calibrates the centre position
values. The type parameter should usually be JOY_TYPE_AUTODETECT, or
see the platform specific documentation for a list of the available
drivers. You must call this routine before using any other joystick
functions, and you should make sure that all joysticks are in the mid‐
dle position at the time. Example:
textout_centre_ex(screen, font,
"Center the joystick and press a key",
SCREEN_W/2, SCREEN_H/2, red_color, -1);
readkey();
if (install_joystick(JOY_TYPE_AUTODETECT) != 0)
abort_on_error("Error initialising joystick!");
RETURN VALUE
Returns zero on success. As soon as you have installed the joystick
module, you will be able to read the button state and digital (on/off
toggle) direction information, which may be enough for some games. If
you want to get full analogue input, though, you need to use the cali‐
brate_joystick() functions to measure the exact range of the inputs:
see below.
SEE ALSOremove_joystick(3), num_joysticks(3), load_joystick_data(3), cali‐
brate_joystick(3), calibrate_joystick_name(3), poll_joystick(3),
exjoy(3)Allegro version 4.4.2 install_joystick(3)
