Allegro 鼠标处理程序工作在 DOS int33 鼠标驱动程序之上,所以只有在 DOS 驱动程序 (通常是 mouse.com 或 mouse.exe) 激活后才能工作.它是一个有用的 int33 函数的简 单外壳,因为它可以在 SVGA 模式显示鼠标,而其它的基本驱动程序却不行.
int install_mouse();
加载 Allegro 鼠标处理程序.你必须在使用任何其它鼠标函数前调用它. 出错则返回
-1 (比如, 如果 int33 驱动程序没有载入), 否则返回鼠标的按键个数.
void remove_mouse();
卸载鼠标处理程序. 你不必明显的调用它,因为 allegro_exit() 将为你做这些.
extern volatile int mouse_x;
extern volatile int mouse_y;
extern volatile int mouse_b;
extern volatile int mouse_pos;
包含有当前鼠标位置和状态的全局变量. mouse_x 和 mouse_y 是表明鼠标位置
的整数, 范围从零到屏幕右下角. mouse_b 是一个指明每个键状态的位域变量:
位 0 是左键, 位 1 是右键, 位 2 是中键. 比如:
if (mouse_b & 1)
printf("左键被按下\n");
if (!(mouse_b & 2))
printf("右键没有被按下\n");
mouse_pos 变量高位存放着当前 X 轴值,低位存放 Y 轴值. 这个可能用在频繁
检测循环中,这时鼠标中断可能发生在你读两个坐标的过程之间,所以你可以只用
一条指令读出坐标然后自己随意的将变量分开.
void show_mouse(BITMAP *bmp);
告诉 Allegro 在屏幕上显示鼠标.这只在时钟模块加载了才工作.鼠标将被画在
指定的位图(bitmap)上, 这个位图通常是 'screen' (屏幕) (见后面有关位图的
信息). 调用 show_mouse(NULL) 可以隐藏鼠标. 警告: 如果你在鼠标可见时向
屏幕画任何东西, 鼠标移动中断可能发生在你绘画的过程中. 如果这发生在鼠标
缓冲刷新和 SVGA 页面切换时将造成混乱,是满屏留下 '鼠标拖动轨迹 (mouse
droppings)'为了避免这些,你必须在向屏幕作画时确认关掉的鼠标显示.
void scare_mouse();
帮助你在作画操作前隐藏鼠标.它将临时去掉鼠标, 但仅仅在真正需要时(即: 鼠
标可见, 并显示在物理屏幕而不是其它内存表面, 并且不是硬件光标). 先前的鼠
标状态被储存用在后来的 unscare_mouse() 调用.
void unscare_mouse();
取消前面 scare_mouse() 调用引起的变化, 恢复起初的鼠标状态.
extern int freeze_mouse_flag;
如果这个标志被设置,鼠标在移动后不会被移动.这避免了你每次作画时隐藏鼠标,
但是你要保证你作画的位置不要和当前鼠标的位置重叠.
void position_mouse(int x, int y);
将鼠标移动到屏幕的指定位置.即使鼠标现在正被显示,这个移动也是安全的.
void set_mouse_range(int x1, int y1, int x2, int y2);
设置鼠标能在屏幕上移动的区域. 传入左上角和右下角坐标(坐标点包括在内).
如果你没有调用过这个函数,范围则是 (0,0, SCREEN_W-1, SCREEN_H-1).
void set_mouse_speed(int xspeed, int yspeed);
设置鼠标速度. xspeed 和 yspeed 的值越大,鼠标的速度越慢:缺省值为 2.
void set_mouse_sprite(BITMAP *sprite);
你不喜欢我的鼠标图案? 没问题.使用这个函数可以支持你自己做的图案. 如果
你改变了图案然而又想再次用我做的可爱的箭头,调用 set_mouse_sprite(NULL).
void set_mouse_sprite_focus(int x, int y);
鼠标焦点(focus)是鼠标上起效果的那一点, 就是对应 (mouse_x,mouse_y) 的那
一点.缺省值是箭头的左上角,但是当你使用其它不同的鼠标图案时可能需要改变它.
void get_mouse_mickeys(int *mickeyx, int *mickeyy);
测量鼠标从上次调用这个函数以后移动了多远.即使鼠标到达了屏幕的边缘,函数依
然回继续统计移动的距离,所以这个值对需要鼠标拥有无限移动范围的游戏很有用.
extern void (*mouse_callback)(int flags);
无论是鼠标的移动或按键状态的改变,中断处理程序都会来调用它.这个函数必须在
被锁住的内存里,并且必须被狠快的执行! 它被传入事件标志然后被启动,
这个标志参数的位屏蔽标志有 MOUSE_FLAG_MOVE, MOUSE_FLAG_LEFT_DOWN,
MOUSE_FLAG_LEFT_UP, MOUSE_FLAG_RIGHT_DOWN, MOUSE_FLAG_RIGHT_UP,
MOUSE_FLAG_MIDDLE_DOWN, 和 MOUSE_FLAG_MIDDLE_UP.