Allegro学习笔记十

http://wiki.allegro.cc/AllegroExamples 以上是英文例子站点。

by Shawn Hargreaves,allegro的作者

目录： 1 Allegro 例子

1.1 exhello
1.2 exmem
1.3 expat
1.4 expal
1.5 exflame
1.6 exbuf
1.7 exflip
1.8 exfixed
1.9 exfont
1.10exmouse

这个例子展示了如何处理鼠标输入。
在第1个部分，鼠标被隐藏了，但是相关的信息都显示在了屏幕上。
如果你按下任何键盘按键，基本的“箭头”图表就显示在屏幕上。
你并不是只能使用这个形状，当你再次按下键盘按键的时候，
默认的鼠标形状就变成了一组彩色的同心圆。
这些演示部分并不是组合在一起的，所以你可以通过显示在屏幕上的
信息来观察当你移动或按下鼠标的时候一些状态的改变。

#include <stdio.h>

#include <allegro.h>

 

static void print_all_buttons(void)
{
   int i;
   int fc = makecol(0, 0, 0);
   int bc = makecol(255, 255, 255);
   textprintf_right_ex(screen, font, 320, 50, fc, bc, "buttons");
   for (i = 0; i < 8; i++) {
      int x = 320;
      int y = 60 + i * 10;
      if (mouse_b & (1 << i))
         textprintf_right_ex(screen, font, x, y, fc, bc, "%2d", 1 + i);
      else
         textprintf_right_ex(screen, font, x, y, fc, bc, "  ");
   }
}

 

int main(void)
{
   int mickeyx = 0;
   int mickeyy = 0;
   BITMAP *custom_cursor;
   int c = 0;

   if (allegro_init() != 0)
      return 1;
   install_keyboard();
   install_timer();

   if (set_gfx_mode(GFX_AUTODETECT, 320, 200, 0, 0) != 0) {
      if (set_gfx_mode(GFX_SAFE, 320, 200, 0, 0) != 0) {
  set_gfx_mode(GFX_TEXT, 0, 0, 0, 0);
  allegro_message("Unable to set any graphic mode/n%s/n", allegro_error);
  return 1;
      }
   }

   set_palette(desktop_palette);
   clear_to_color(screen, makecol(255, 255, 255));

   /* Detect mouse presence */
   if (install_mouse() < 0) {
      textout_centre_ex(screen, font, "No mouse detected, but you need one!",
   SCREEN_W/2, SCREEN_H/2, makecol(0, 0, 0),
   makecol(255, 255, 255));
      readkey();
      return 0;
   }

   textprintf_centre_ex(screen, font, SCREEN_W/2, 8, makecol(0, 0, 0),
   makecol(255, 255, 255),
   "Driver: %s", mouse_driver->name);

   do {
      /* 在大多数平台（例如DOS）即使不调用这个函数，(鼠标)仍然工作的很好
       * 但是如果你想让自己的程序变得更加通用，调用它不失为一个非常好的
       * 主意,因为在一些平台上，你不调用的话说不定得不到任何鼠标输入
       */
      poll_mouse();

      acquire_screen();

      /* 鼠标的坐标信息已经被自动保存到变量mouse_x 和mouse_y */
      textprintf_ex(screen, font, 16, 48, makecol(0, 0, 0),
      makecol(255, 255, 255), "mouse_x = %-5d", mouse_x);
      textprintf_ex(screen, font, 16, 64, makecol(0, 0, 0),
      makecol(255, 255, 255), "mouse_y = %-5d", mouse_y);

      /* 或者你可以使用这个函数来测量鼠标的速度。
       * 注意我们每4个周期检测1次:所以你没必要降低这个数字(4),
       * 以便让你有时间去“阅读”它们当前的值。(就是说变的太快了)
       */
      c++;
      if ((c & 3) == 0)
  get_mouse_mickeys(&mickeyx, &mickeyy);

      textprintf_ex(screen, font, 16,  88, makecol(0, 0, 0),
      makecol(255, 255, 255), "mickey_x = %-7d", mickeyx);
      textprintf_ex(screen, font, 16, 104, makecol(0, 0, 0),
      makecol(255, 255, 255), "mickey_y = %-7d", mickeyy);

      /* 按键的状态信息被储存在了变量 mouse_b */
      if (mouse_b & 1)
  textout_ex(screen, font, "left button is pressed ", 16, 128,
      makecol(0, 0, 0), makecol(255, 255, 255));
      else
  textout_ex(screen, font, "left button not pressed", 16, 128,
      makecol(0, 0, 0), makecol(255, 255, 255));

      if (mouse_b & 2)
  textout_ex(screen, font, "right button is pressed ", 16, 144,
      makecol(0, 0, 0), makecol(255, 255, 255));
      else
  textout_ex(screen, font, "right button not pressed", 16, 144,
      makecol(0, 0, 0), makecol(255, 255, 255));

      if (mouse_b & 4)
  textout_ex(screen, font, "middle button is pressed ", 16, 160,
      makecol(0, 0, 0), makecol(255, 255, 255));
      else
  textout_ex(screen, font, "middle button not pressed", 16, 160,
      makecol(0, 0, 0), makecol(255, 255, 255));

      /* 滚轮的位置信息被储存在了变量 mouse_z */
      textprintf_ex(screen, font, 16, 184, makecol(0, 0, 0),
      makecol(255, 255, 255), "mouse_z = %-5d mouse_w = %-5d", mouse_z, mouse_w);

      print_all_buttons();

      release_screen();

      vsync();

   } while (!keypressed());

   clear_keybuf();

   /*  显示鼠标使用show_mouse().
    *  这里有一些事情是在你调用它之前应该做的.
    *  首先在响应鼠标之前必须调用install_timer()
    *  然后在绘制位图之前应该隐藏鼠标show_mouse(NULL);
    *  绘制完成了再显示出来
    */
   clear_to_color(screen, makecol(255, 255, 255));
   textout_centre_ex(screen, font, "Press a key to change cursor",
       SCREEN_W/2, SCREEN_H/2, makecol(0, 0, 0),
       makecol(255, 255, 255));
   show_mouse(screen);
   readkey();
   show_mouse(NULL);

   /* 创建一个自定义鼠标位图... */
   custom_cursor = create_bitmap(32, 32);
   clear_to_color(custom_cursor, bitmap_mask_color(screen));
   for (c=0; c<8; c++)
      circle(custom_cursor, 16, 16, c*2, palette_color[c]);

   /* 加载自定义鼠标位图，并且将鼠标焦点设置为位图的正中心 */
   set_mouse_sprite(custom_cursor);
   set_mouse_sprite_focus(16, 16);

   clear_to_color(screen, makecol(255, 255, 255));
   textout_centre_ex(screen, font, "Press a key to quit", SCREEN_W/2,
       SCREEN_H/2, makecol(0, 0, 0), makecol(255, 255, 255));
   show_mouse(screen);
   readkey();
   show_mouse(NULL);

   destroy_bitmap(custom_cursor);

   return 0;
}

END_OF_MAIN()
---------------------------------------------------------------------
小节10：
1、if (mouse_b & (1 << i)); i = 0~7;
mouse_b & (1 << i)  = BUTTONDOWN;鼠标按键是否被按下(而不是点击click)
allegro一次提取全部的鼠标按键信息，使用者必须手动拆分。
关于1 << i：
1   00000001  左键
2   00000010  右键
4   00000100  中键
8   00001000  不知道
16  00010000  不知道
32  00100000  不知道
64  01000000  不知道
128 10000000  不知道

这样设计的目的是保证一些特定的值对应特定的按键状态组合，如3=左+右,6=右+中。但是mouse_b只提供一个
2、poll_mouse();
这是一个4.22新加入的函数，为的是在某些平台上更好的支持鼠标，是Allegro为自身跨平台性的一个扩展。只需要在处理鼠标输入信息之前调用就可以了。

3、变量mouse_x 和mouse_y;
还有许多其他类似变量，这些变量在发生系统时钟中断（或Allegro时钟中断）的时候被更新。
PS:我认为可能存在这些标志信息与实际的按键/状态有偏差，导致这种偏差的原因是代码执行需要花费时间，而如果判断一组标志量的代码跨时间片执行的话，可能就会出现这个问题。但是实际使用中发生这个问题的可能性非常小，并且我坚信Shawn Hargreaves设计Allegro的时候就解决这个问题：要么在我不知道的地方Allegro正做着处理，要么Shawn Hargreaves证明了在他这个架构下，是不会出现我说的那种问题。只是我现在还没有发现...所以现在只需要把mouse_b中的信息当成实时信息就可以了(看成消息吧~)。

4、c++;
   if ((c & 3) == 0)
事实上这两句话与Allegro关系不是很大，但是它给我提供了一种新的节奏控制思路~
5、clear_to_color(custom_cursor, bitmap_mask_color(screen));
int bitmap_mask_color(BITMAP *bmp);
返回指定位图的掩色 (这个色彩值将在画精灵时被忽略). 在 256 色位图里是零, 在真彩位图里是亮粉红色 (红和蓝值最大, 绿值为零).

6、   set_mouse_sprite(custom_cursor);
   set_mouse_sprite_focus(16, 16);
没什么好说的..新出现的知识点。