Provided by: allegro4-doc_4.4.2-4_all bug

NAME

       install_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
       middle 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 calibrate_joystick() functions to measure the exact range of the inputs: see below.

SEE ALSO

       remove_joystick(3alleg4),       num_joysticks(3alleg4),       load_joystick_data(3alleg4),
       calibrate_joystick(3alleg4),   calibrate_joystick_name(3alleg4),   poll_joystick(3alleg4),
       exjoy(3alleg4)