Provided by: allegro5-doc_5.2.3.0-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)