Programming 版 (精华区)

发信人: lansh (沧海一粟), 信区: Programming
标  题: Allegro 游戏程序库 (鼠标例程)
发信站: 哈工大紫丁香 (2002年09月11日19:51:42 星期三), 站内信件

信人: cloudwu (云风), 信区: GAME_Designer
标  题: Allegro 游戏程序库 (鼠标例程)
发信站: BBS 水木清华站 (Tue May  5 09:14:44 1998)


     ______   ___    ___
    /\  _  \ /\_ \  /\_ \
    \ \ \L\ \\//\ \ \//\ \      __     __   _ __   ___
     \ \  __ \ \ \ \  \ \ \   /'__`\ /'_ `\/\`'__\/ __`\
      \ \ \/\ \ \_\ \_ \_\ \_/\  __//\ \L\ \ \ \//\ \L\ \
       \ \_\ \_\/\____\/\____\ \____\ \____ \ \_\\ \____/
        \/_/\/_/\/____/\/____/\/____/\/___L\ \/_/ \/___/
                                       /\____/
                                       \_/__/        3.0 版

                    一个游戏程序库
               By Shawn Hargreaves, 1994/97
                          云风 译
                          http://www.nease.net/~cloudwu
                          E-mail:cloudwu@nease.net

========================================
============    鼠标例程      ==========
========================================
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)'
   为了避免这些,你必须在向屏幕作画时确认关掉的鼠标显示.

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.


--
http://www.nease.net/~cloudwu
http://computer.igd.edu.cn/~cloud
E-mail: cloudwu@163.net


--
人生得意需尽欢，莫使金樽空对月。
天生我才必有用，千金散尽还复来。

※ 来源:·哈工大紫丁香 bbs.hit.edu.cn·[FROM: hitsat.hit.edu.cn]