NAME

       calibrate_joystick - Calibrates the specified joystick. Allegro game programming library.

SYNOPSIS

       #include <allegro.h>

       int calibrate_joystick(int n);

DESCRIPTION

       Most  joysticks need to be calibrated before they can provide full analogue input. This function performs
       the next operation in the calibration series for the specified stick, assuming that the joystick has been
       positioned in the manner described by a previous call to  calibrate_joystick_name(),  returning  zero  on
       success. For example, a simple routine to fully calibrate all the joysticks might look like:

          int i;

          for (i=0; i<;num_joysticks; i++) {
             while (joy[i].flags & JOYFLAG_CALIBRATE) {
                char *msg = calibrate_joystick_name(i);
                textprintf_ex(..., "%s, and press a key\n", msg);
                readkey();
                if (calibrate_joystick(i) != 0) {
                   textprintf_ex(..., "oops!\n");
                   readkey();
                   exit(1);
                }
             }
          }

RETURN VALUE

       Returns zero on success, non-zero if the calibration could not be performed successfully.

SEE ALSO

       install_joystick(3alleg4),    calibrate_joystick_name(3alleg4),   joy(3alleg4),   num_joysticks(3alleg4),
       exjoy(3alleg4)

Allegro                                           version 4.4.3                      calibrate_joystick(3alleg4)