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 before
     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 library func-
     tions 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 windowed 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 de-
     cide 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), readkey(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.3 	     install_keyboard(3)

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

home | help