Provided by: allegro5-doc_5.2.8.0+dfsg-1_all bug

NAME

       al_reconfigure_joysticks - Allegro 5 API

SYNOPSIS

              #include <allegro5/allegro.h>

              bool al_reconfigure_joysticks(void)

DESCRIPTION

       Allegro  is  able  to cope with users connecting and disconnected joystick devices on-the-
       fly.  On existing platforms, the joystick event source will  generate  an  event  of  type
       ALLEGRO_EVENT_JOYSTICK_CONFIGURATION  when  a  device  is  plugged  in  or  unplugged.  In
       response, you should call al_reconfigure_joysticks(3alleg5).

       Afterwards, the number returned by al_get_num_joysticks(3alleg5) may be different, and the
       handles returned by al_get_joystick(3alleg5) may be different or be ordered differently.

       All  ALLEGRO_JOYSTICK(3alleg5)  handles remain valid, but handles for disconnected devices
       become inactive: their states will no longer update, and al_get_joystick(3alleg5) will not
       return  the handle.  Handles for devices which remain connected will continue to represent
       the same devices.  Previously inactive handles may become active again,  being  reused  to
       represent newly connected devices.

       Returns true if the joystick configuration changed, otherwise returns false.

       It   is   possible   that   on   some   systems,   Allegro   won’t  be  able  to  generate
       ALLEGRO_EVENT_JOYSTICK_CONFIGURATION events.  If your  game  has  an  input  configuration
       screen  or  similar,  you may wish to call al_reconfigure_joysticks(3alleg5) when entering
       that screen.

SEE ALSO

       al_get_joystick_event_source(3alleg5), ALLEGRO_EVENT(3alleg5)