GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  AL_RECONFIGURE_JOYSTICKS (3)

NAME

al_reconfigure_joysticks - Allegro 5 API

CONTENTS

Synopsis
Description
See Also

SYNOPSIS

C]
#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 C]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[aq]t be able to generate C]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)

Search for    or go to Top of page |  Section 3 |  Main Index


Allegro reference manual AL_RECONFIGURE_JOYSTICKS (3)

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.