load_joystick_data(3alleg4) [debian man page]

load_joystick_data(3alleg4)					  Allegro manual				       load_joystick_data(3alleg4)

NAME

       load_joystick_data - Loads joystick calibration data. Allegro game programming library.

SYNOPSIS

       #include <allegro.h>

       int load_joystick_data(const char *filename);

DESCRIPTION

       Restores  calibration  data  previously stored by save_joystick_data() or the setup utility. This sets up all aspects of the joystick code:
       you don't even need to call install_joystick() if you are using this function. Pass a NULL filename to read the	data  from  the  currently
       selected configuration file.

RETURN VALUE

       Returns zero on success: if it fails the joystick state is undefined and you must reinitialise it from scratch.

SEE ALSO

       install_joystick(3alleg4), save_joystick_data(3alleg4), set_config_file(3alleg4)

Allegro 							   version 4.4.2				       load_joystick_data(3alleg4)

install_joystick(3alleg4)					  Allegro manual					 install_joystick(3alleg4)

NAME

       install_joystick - Initialises the joystick. Allegro game programming library.

SYNOPSIS

       #include <allegro.h>

       int install_joystick(int type);

DESCRIPTION

       Installs  Allegro's  joystick handler, and calibrates the centre position values. The type parameter should usually be JOY_TYPE_AUTODETECT,
       or see the platform specific documentation for a list of the available drivers.	You must call this routine before using any other joystick
       functions, and you should make sure that all joysticks are in the middle position at the time. Example:

	  textout_centre_ex(screen, font,
			    "Center the joystick and press a key",
			    SCREEN_W/2, SCREEN_H/2, red_color, -1);
	  readkey();
	  if (install_joystick(JOY_TYPE_AUTODETECT) != 0)
	     abort_on_error("Error initialising joystick!");

RETURN VALUE

       Returns	zero  on success. As soon as you have installed the joystick module, you will be able to read the button state and digital (on/off
       toggle) direction information, which may be enough for some games. If you want to get full analogue input, though, you need to use the cal-
       ibrate_joystick() functions to measure the exact range of the inputs: see below.

SEE ALSO

       remove_joystick(3alleg4),      num_joysticks(3alleg4),	  load_joystick_data(3alleg4),	   calibrate_joystick(3alleg4),     calibrate_joy-
       stick_name(3alleg4), poll_joystick(3alleg4), exjoy(3alleg4)

Allegro 							   version 4.4.2					 install_joystick(3alleg4)