精华区文章阅读

发信人: bell (花开时是冷冷月光), 信区: Pcgame
标  题:  Allegro 中文文档(键盘例程)
发信站: 紫丁香 (Tue May  4 14:06:40 1999), 转信

键盘例程

      install_keyboard
      remove_keyboard
      install_keyboard_hooks
      key
      key_shifts
      keypressed
      readkey
      simulate_keypress
      keyboard_callback
      set_leds
      clear_keybuf
      three_finger_flag
      key_led_flag

如果你想检测同时按下的多个按键, 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() 将返回的值.

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 的状态被改变.
--

--
※ 来源:．紫丁香 bbs.hit.edu.cn．[FROM: jxjd.hit.edu.cn]

Pcgame 版 (精华区)