GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  INSTALL_KEYBOARD (3)

NAME

install_keyboard - Installs the Allegro keyboard interrupt handler.

CONTENTS

Synopsis
Description
See Also

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 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 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 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), readkey(3), ureadkey(3), keyboard_callback(3), keyboard_ucallback(3), keyboard_lowlevel_callback(3), three_finger_flag(3), key_led_flag(3), set_leds(3), set_keyboard_rate(3), set_gfx_mode(3)
Search for    or go to Top of page |  Section 3 |  Main Index


Allegro INSTALL_KEYBOARD (3) version 4.4.2

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.