DragonFly On-Line Manual Pages

al_reconfigure_joysticks(3)                        al_reconfigure_joysticks(3)

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(3).

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

       All ALLEGRO_JOYSTICK(3) handles remain valid, but handles for
       disconnected devices become inactive: their states will no longer
       update, and al_get_joystick(3) 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(3) when entering that screen.

SEE ALSO
       al_get_joystick_event_source(3), ALLEGRO_EVENT(3)

Allegro reference manual                           al_reconfigure_joysticks(3)