DragonFly On-Line Manual Pages
al_reconfigure_joysticks - Allegro 5 API
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
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
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.
Allegro reference manual al_reconfigure_joysticks(3)