calibrate_joystick(3alleg4)					  Allegro manual				       calibrate_joystick(3alleg4)

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 calibra-
       tion series for the specified stick, assuming that the joystick has been positioned in the manner described by a  previous  call  to  cali-
       brate_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
", msg);
		readkey();
		if (calibrate_joystick(i) != 0) {
		   textprintf_ex(..., "oops!
");
		   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.2				       calibrate_joystick(3alleg4)