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  -  KEYBOARD_GETSTATE (3)

NAME

keyboard_getstate - get a pointer to a buffer holding the state of all keys in raw keyboard mode

CONTENTS

Synopsis
Description
See Also
Author

SYNOPSIS

#include <vgakeyboard.h>

char *keyboard_getstate(void);

DESCRIPTION

When in raw keyboard mode this routine returns a pointer buffer to a static buffer. If the value in buffer[scancode] is KEY_PRESSED or KEY_NOTPRESSED the key with that scancode is pressed or not. Actually KEY_PRESSED is 1 and KEY_NOTPRESSED is 0, s.t. you can use constructs like:

if(buffer[SCANCODE_ENTER]) {
/* do something */
}

This is more efficient than calling keyboard_keypressed(3) if you want to check for many different keys.

Please note that keyboard events will only be processed when you occasionally call keyboard_update(3) or keyboard_waitforupdate(3).

keyboard_translatekeys(3) allows certain remap operations which make certain keys (digits, enter) which might have several physical keys show up under the same scancodes.

Here are the supported scancodes. The names of the #defines originate from the US keyboard layout, for other countries, they’ll refer to the key in the same physical location, but the keycap will have a different inscription. For the list below, add SCANCODE_ in front of the names to get the right name for your C source. That means, if it lists BACKSLASH below, you shall use SCANCODE_BACKSLASH as symbol in your program. In addition to the names below we also have SCANCODE_0 - SCANCODE_9, SCANCODE_KEYPAD0 - SCANCODE_KEYPAD9, SCANCODE_A - SCANCODE_Z, and SCANCODE_F1 - SCANCODE_F12.

The other key names are ESCAPE, MINUS, EQUAL, BACKSPACE, TAB, BRACKET_LEFT, BRACKET_RIGHT, ENTER, LEFTCONTROL, SEMICOLON, APOSTROPHE, GRAVE, LEFTSHIFT, BACKSLASH, COMMA, PERIOD, SLASH, RIGHTSHIFT, KEYPADMULTIPLY, LEFTALT, SPACE, CAPSLOCK, NUMLOCK, SCROLLLOCK, CURSORUPLEFT, CURSORUP, CURSORUPRIGHT, KEYPADMINUS, CURSORLEFT, CURSORRIGHT, KEYPADPLUS, CURSORDOWNLEFT, CURSORDOWN, CURSORDOWNRIGHT, KEYPADPERIOD, LESS, KEYPADENTER, RIGHTCONTROL, CONTROL, KEYPADDIVIDE, PRINTSCREEN, RIGHTALT, BREAK, BREAK_ALTERNATIVE, HOME, CURSORBLOCKUP, PAGEUP, CURSORBLOCKLEFT, CURSORBLOCKRIGHT, END, CURSORBLOCKDOWN, PAGEDOWN, INSERT, and REMOVE.

SEE ALSO

svgalib(7), vgagl(7), libvga.config(5), keytest(6), eventtest(6), keyboard_seteventhandler(3), keyboard_init(3), keyboard_init_return_fd(3), keyboard_close(3), keyboard_setdefaulteventhandler(3), keyboard_getstate(3), keyboard_clearstate(3), keyboard_translatekeys(3), keyboard_update(3), keyboard_waitforupdate(3), vga_waitevent(3)

AUTHOR

This manual page was edited by Michael Weller <eowmob@exp-math.uni-essen.de>. The exact source of the referenced function as well as of the original documentation is unknown.

It is very likely that both are at least to some extent are due to Harm Hanemaayer <H.Hanemaayer@inter.nl.net>.

Occasionally this might be wrong. I hereby asked to be excused by the original author and will happily accept any additions or corrections to this first version of the svgalib manual.

Search for    or go to Top of page |  Section 3 |  Main Index


Svgalib (>= 1.2.11) KEYBOARD_GETSTATE (3) 29 July 1997

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