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
       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  mid-
       dle 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	 cali-
       brate_joystick()	 functions  to	measure	the exact range	of the inputs:
       see below.

SEE ALSO
       remove_joystick(3),  num_joysticks(3),	load_joystick_data(3),	 cali-
       brate_joystick(3),     calibrate_joystick_name(3),    poll_joystick(3),
       exjoy(3)

Allegro				 version 4.4.2		   install_joystick(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | SEE ALSO

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

home | help