如果你想检测同时按下的多个按键, 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");extern volatile int key_shifts;if (key[KEY_ENTER] & KB_EXTENDED) printf("Enter (on the numeric keypad) is pressed\n");
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");void simulate_keypress(int key);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");
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() 调用.