键盘例程



如果你想检测同时按下的多个按键, BIOS 键盘例程就没什么用了. Allegro 能加载 一个键盘处理程序的替代品,它提供了缓冲输入和标记集合两种方式来储存每个键的 状态.注意,由于 PC 键盘本身的设计,它不可能正确的检测到每种按键的组合,同时 按下两到三个键将工作的很好,但是如果你同时按下更多的键,多余的部分将被忽略 (准确的说得到的键的组合随着每一个键盘而不同).




int install_keyboard();
加载 Allegro 键盘中断处理程序.你必须在使用任何键盘输入例程前调用它.一旦 你设置了 Allegro 处理程序,就不再需要使用 DOS/BIOS 调用或者 C 库函数 来控制键盘了.


void remove_keyboard();
卸载键盘处理程序,将控制权交回 BIOS. 正常的情况你不必自己调用它,因为 allegro_exit() 将为你做这些.


void install_keyboard_hooks(int (*keypressed)(), int (*readkey)());
只有在你 *不需要* 使用键盘处理程序的其它部分时才使用这个函数. 它应该在 install_keyboard() 的地方被调用, 让你提供一个检测和读取键盘的回调例程, 这个例程将被 keypressed() 和 readkey() 调用. 如果你想使用 Allegro 的 GUI 代码和自己配制的键盘处理程序时这就很有用, 因为它提供了用你自己代码为 GUI 控制键盘输入的一个方案. 如果你想使用 BIOS 键盘例程, libc 函数 _bios_keybrd(_KEYBRD_READ) 将以正确形式返回键击.


extern volatile char key[128];
以扫描码的顺序描述每个按键状态的标志数组. 扫描码以一串 KEY_* 形式的常量定义在 allegro.h 里. 比如,你可以这样写:

      if (key[KEY_SPACE])
         printf("Space is pressed\n");

每个值都可以以在某些位上包含标志 KB_NORMAL 和 KB_EXTENDED, 这使得你可以检测出具有相同扫描码的键 中具体按下的是哪一个.例如, 你可以这样写:

      if (key[KEY_ENTER] & KB_NORMAL)
         printf("Enter (next to the right shift key) is pressed\n");

if (key[KEY_ENTER] & KB_EXTENDED) printf("Enter (on the numeric keypad) is pressed\n");

extern volatile int key_shifts;
这个位屏蔽变量包含了当前的 shift/ctrl/alt 状态, 特别的 Windows 键,和 accent escape 字符. 可以含有以下标志:


KB_SHIFT_FLAG
KB_CTRL_FLAG
KB_ALT_FLAG
KB_LWIN_FLAG
KB_RWIN_FLAG
KB_MENU_FLAG
KB_SCROLOCK_FLAG
KB_NUMLOCK_FLAG
KB_CAPSLOCK_FLAG
KB_INALTSEQ_FLAG
KB_ACCENT1_FLAG
KB_ACCENT1_S_FLAG
KB_ACCENT2_FLAG
KB_ACCENT2_S_FLAG

int keypressed();
如果在输入缓冲中有键击则返回 TRUE. 相当于 libc kbhit() 函数.

int readkey();
返回键盘缓冲里的下一个字符.如果缓冲是空的, 则等待下一次键击.返回值的低字节 是键的 ASCII 码,高字节为扫描码. 扫描码无论在何种 shift, ctrl 和 alt 状态下都保持一致. ASCII 码以正常的方式被 shift 和 ctrl 的状态影响. (shift 改变大小写, ctrl+字母则给出字母在字母表中的位置, 即 ctrl+A = 1, ctrl+B = 2, 等等). 按下 alt+key 只返回扫描码, 而低字节为零. 比如:

      if ((readkey() & 0xff) == 'd')         // 检查 ASCII 码
         printf("You pressed 'd'\n");

if ((readkey() >> 8) == KEY_SPACE) // 检查扫描码 printf("You pressed Space\n");

if ((readkey() & 0xff) == 3) // ctrl+字母 printf("You pressed Control+C\n");

if (readkey() == (KEY_X << 8)) // alt+字母 printf("You pressed Alt+X\n");

void simulate_keypress(int key);
向键盘缓冲塞入一个键,就象用户亲自敲过一样. 参数和 readkey() 的返回值的格式相同.

extern int (*keyboard_callback)(int key);
如果被设置, 键盘处理程序在反应每次键击时都调用这个函数. 将即将加入输入缓冲的值传入这个函数, 然后你可以不加改变的将这个值返回,也可以 返回零使得按键被忽略,或者返回一个修改的值来改变 readkey() 将返回的值.


extern void (*keyboard_lowlevel_callback)(int key);
如果设置了, 这个函数被键盘处理程序调用来回应每次键盘事件, 包括按下和放开. 它将被传入一个为处理的键盘扫描码字节, 如果见被按下将被高位清零, 或是在释放键时高位设置. 这个例程在相关中断中运行,所以一定要存在于锁定的内存中.


void set_leds(int leds);
设置键盘 LED 指示器的状态. 参数是一个 可以包含 KB_SCROLOCK_FLAG, KB_NUMLOCK_FLAG, 和 KB_CAPSLOCK_FLAG 这些值 的位掩值 (bitmask), 或者传入 -1 来恢复缺省状态.

void clear_keybuf();
清空键盘缓冲.

extern int three_finger_flag;
Allegro 键盘处理程序提供了一个 '紧急出口' 的序列,可以用来 杀掉你的程序. 如果你正在 DOS 下运行, 这是 三个手指的活, ctrl+alt+del. 所有的多任务 OS 都会 在 Allegro 处理之前捕捉这个组合, 所以 你可以使用改变的键组 ctrl+alt+end. 如果你想在 你的程序的发行版中关掉这个行为, 将这个标志设为 FALSE.


extern int key_led_flag;
缺省状态下, capslock, numlock, 和 scroll-lock 键在它们被触动时 联系着键盘 LED 指示器. 如果你在你的游戏中使用了这些做输入键 (比如. capslock 为开火键) 这个就不那么 称心如意了, 因此你可以清除这个标志来阻止 LED 的状态被改变.

extern int switch_standard_kb_key;
extern int switch_standard_kb_flags;
extern int switch_custom_kb_key;
extern int switch_custom_kb_flags;
扫描码和移位标志组合用来配置基本的键盘映射开关. 缺省时, 按 ctrl+alt+F1 将选择基本的 US 布局, 而 ctrl+alt+F2 选择用户映射. 这些值允许你改变热键, 或者你可以将它们设置成 0 来屏蔽掉切换.


void set_standard_keyboard();
强制 Allegro 使用基本 US 键盘映射, 而无论现在 是何种用户键盘布局被加载.

void set_custom_keyboard();
强制切换到当前的用户键盘布局, 取消前面所有的 set_standard_keyboard() 调用.




返回