record AL_JOYSTICK_INFO

Unit

Allegro

Declaration

type AL_JOYSTICK_INFO = record

Description

information about an entire joystick.

Each joystick will provide one or more stick inputs, of varying types. These can be digital controls which snap to specific positions (eg. a gamepad controller, the coolie hat on a Flightstick Pro or Wingman Extreme, or a normal joystick which hasn't yet been calibrated), or they can be full analogue inputs with a smooth range of motion. Sticks may also have different numbers of axes, for example a normal directional control has two, but the Flightstick Pro throttle is only a single axis, and it is possible that the system could be extended in the future to support full 3d controllers.

The joystick flags field may contain any combination of the bit flags:

AL_JOYFLAG_DIGITAL

This control is currently providing digital input.

AL_JOYFLAG_ANALOGUE

This control is currently providing analogue input.

AL_JOYFLAG_CALIB_DIGITAL

This control will be capable of providing digital input once it has been calibrated, but is not doing this at the moment.

AL_JOYFLAG_CALIB_ANALOGUE

This control will be capable of providing analogue input once it has been calibrated, but is not doing this at the moment.

AL_JOYFLAG_CALIBRATE

Indicates that this control needs to be calibrated. Many devices require multiple calibration steps, so you should call the al_calibrate_joystick function from a loop until this flag is cleared.

AL_JOYFLAG_SIGNED

Indicates that the analogue axis position is in signed format, ranging from -128 to 128. This is the case for all 2d directional controls.

AL_JOYFLAG_UNSIGNED

Indicates that the analogue axis position is in unsigned format, ranging from 0 to 255. This is the case for all 1d throttle controls.

See also

al_joy

Global array of joystick state information, which is updated by the al_poll_joystick function.

Overview

Fields

Description

Fields