Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
install_joystick(3)		 Allegro manual 	     install_joystick(3)

NAME
     install_joystick  -  Initialises the joystick. Allegro game programming li-
     brary.

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) di-
     rection information, which may be enough for some games. If you want to get
     full analogue input, though, you need to use the calibrate_joystick() func-
     tions to measure the exact range of the inputs: see below.

SEE ALSO
     remove_joystick(3), num_joysticks(3), load_joystick_data(3), calibrate_joy-
     stick(3), calibrate_joystick_name(3), poll_joystick(3), exjoy(3)

Allegro 			  version 4.4.3 	     install_joystick(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=install_joystick&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help