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.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+14.3.quarterly>

home | help