debian man page for poll_joystick

poll_joystick(3alleg4)						  Allegro manual					    poll_joystick(3alleg4)

NAME
       poll_joystick - Polls the joystick. Allegro game programming library.

SYNOPSIS
       #include <allegro.h>

       int poll_joystick();

DESCRIPTION
       The  joystick  handler is not interrupt driven, so you need to call this function every now and again to update the global position values.
       Example:

	  do {
	     /* Get joystick input */
	     poll_joystick();

	     /* Process input for the first joystick */
	     if (joy[0].button[0].b)
		first_button_pressed();

	     if (joy[0].button[1].b)
		second_button_pressed();
	     ...
	  } while(!done);

RETURN VALUE
       Returns zero on success or a negative number on failure (usually because no joystick driver was installed).

SEE ALSO
       install_joystick(3alleg4), joy(3alleg4), num_joysticks(3alleg4), exjoy(3alleg4)

Allegro 							   version 4.4.2					    poll_joystick(3alleg4)