logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

install_joystick - Initialises the joystick. Allegro game programming library.

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!");

Name

       install_joystick - Initialises the joystick. Allegro game programming library.

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)

Allegro                                           version 4.4.3                        install_joystick(3alleg4)

Synopsis

#include<allegro.h>intinstall_joystick(inttype);

See Also