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

FreeBSD Manual Pages

  
 
  

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

NAME
       install_keyboard	- Installs the Allegro keyboard	interrupt handler.

SYNOPSIS
       #include	<allegro.h>

       int install_keyboard();

DESCRIPTION
       Installs	the Allegro keyboard interrupt handler.	You must call this be-
       fore using any of the keyboard input routines. Once you have set	up the
       Allegro	handler, you can no longer use operating system	calls or C li-
       brary functions to access the keyboard.

       Note that on some platforms the keyboard	won't work unless you have set
       a  graphics  mode, even if this function	returns	a success value	before
       calling set_gfx_mode. This can happen in	environments with graphic win-
       dowed  modes,  since  Allegro  usually  reads  the keyboard through the
       graphical window	(which appears after the set_gfx_mode call). Example:

	  allegro_init();
	  install_timer();
	  install_keyboard();
	  /* We	are not	100% sure we can read the keyboard yet!	*/
	  if (set_gfx_mode(GFX_AUTODETECT, 640,	480, 0,	0) != 0)
	     abort_on_error("Couldn't set graphic mode!");

	  /* Now we are	guaranteed to be able to read the keyboard. */
	  readkey();

RETURN VALUE
       Returns zero on success,	or a negative number on	failure	(but  you  may
       decide  not to check the	return value as	this function is very unlikely
       to fail).

SEE ALSO
       remove_keyboard(3),  poll_keyboard(3),  key(3),	keypressed(3),	 read-
       key(3),	ureadkey(3), keyboard_callback(3), keyboard_ucallback(3), key-
       board_lowlevel_callback(3),   three_finger_flag(3),    key_led_flag(3),
       set_leds(3), set_keyboard_rate(3), set_gfx_mode(3)

Allegro				 version 4.4.2		   install_keyboard(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_keyboard&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help