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.11extimer

这个例子展示了如何使用时钟中断
可能会有一点小痛(麻烦),因为你必须锁住所有在你的中断中使用的内存。
在例子的第1个部分展示了基本的计时函数rest()的用法(相当于delay();)
在例子的第2个部分展示了如何使用3个频率不同的用户时钟
 *    This program demonstrates how to use the timer routines.
 *    These can be a bit of a pain, because you have to be sure
 *    you lock all the memory that is used inside your interrupt
 *    handlers.  The first part of the example shows a basic use of
 *    timing using the blocking function rest(). The second part
 *    shows how to use three timers with different frequencies in
 *    a non blocking way.
 */

#include <allegro.h>

 

/* 这些变量应当用volatile声明，这样优化器就不会搞错了 */
volatile int x = 0;
volatile int y = 0;
volatile int z = 0;

 

/* 时钟中断句柄 */
void inc_x(void)
{
   x++;
}

END_OF_FUNCTION(inc_x)

 

/* 时钟中断句柄 */
void inc_y(void)
{
   y++;
}

END_OF_FUNCTION(inc_y)

 

/* 时钟中断句柄 */
void inc_z(void)
{
   z++;
}

END_OF_FUNCTION(inc_z)

 

int main(void)
{
   int c;

   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));

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

   /* 使用rest()来延迟给定的时间（毫秒级） */
   textprintf_centre_ex(screen, font, SCREEN_W/2, 48, makecol(0, 0, 0),
   makecol(255, 255, 255), "Timing five seconds:");

   for (c=1; c<=5; c++) {
      textprintf_centre_ex(screen, font, SCREEN_W/2, 62+c*10,
      makecol(0, 0, 0), makecol(255, 255, 255), "%d", c);
      rest(1000);
   }

   textprintf_centre_ex(screen, font, SCREEN_W/2, 142, makecol(0, 0, 0),
   makecol(255, 255, 255),
   "Press a key to set up interrupts");
   readkey();

   /* 所有在时钟中断中使用的变量和函数都应该锁起来 */
   LOCK_VARIABLE(x);
   LOCK_VARIABLE(y);
   LOCK_VARIABLE(z);
   LOCK_FUNCTION(inc_x);
   LOCK_FUNCTION(inc_y);
   LOCK_FUNCTION(inc_z);

   /* 速度可以由毫秒级的数字给定(在这里是1秒一次中断)*/
   install_int(inc_x, 1000);

   /* 或者使用每秒的节拍率（BPS） (在这里是每秒10拍) */
   install_int_ex(inc_y, BPS_TO_TIMER(10));

   /* 或者使用秒 (这里是10秒一个周期) */
   install_int_ex(inc_z, SECS_TO_TIMER(10));

   /* 这些中断在这里被激活... */
   while (!keypressed())
      textprintf_centre_ex(screen, font, SCREEN_W/2, 176, makecol(0, 0, 0),
      makecol(255, 255, 255), "x=%d, y=%d, z=%d", x, y, z);

   return 0;
}

END_OF_MAIN()
---------------------------------------------------------------------
1、volatile声明
一个定义为volatile的变量是说这变量可能会被意想不到地改变，这样，编译器就不会去假设这个变量的值了。精确地说就是，优化器在用到这个变量时必须每次都小心地重新读取这个变量的值(From Memory)，而不是使用保存在寄存器里的备份。下面是volatile变量的几个例子：
1) 并行设备的硬件寄存器（如：状态寄存器）
2) 一个中断服务子程序中会访问到的非自动变量(Non-automatic variables)
3) 多线程应用中被几个任务共享的变量
详细的可以访问http://blog.csdn.net/gaoteng1984/archive/2007/07/27/1711924.aspx
2、Allegro中的时钟中断
你的函数将被 Allegro 中断处理程序调用而不是被处理器直接调用, 所以它能够 按正常的 C 函数来写而不需要特别的包装. 然而, 你必须知道,它将在一个中断中 被调用,而这给你希望在函数中做的事增加了许多约束.它不能使用大数量的堆栈, 不能调用任何 DOS 例程和使用调用了 DOS 例程的 C 库函数, 而且它必须被很快 的执行.不要在时钟处理程序里写太多的复杂代码: 一个基本的规则是你应该设置 一些标志然后在你的主控制循环里来回应它们.

在象 djgpp 这样的保护模式环境里, 内存被虚拟化并可以向磁盘交换. 由于 DOS 的不可重入, 如果磁盘交换发生在中断处理程序内部,系统将痛苦的死机, 所以你 需要确认你锁住了所有时钟例程中触及的所有内存 (包括代码和数据). Allegro 将锁住它用的所有东西,但是你有责任锁住你自己处理程序的. 宏 LOCK_VARIABLE (变量), END_OF_FUNCTION(函数名), 和 LOCK_FUNCTION(函数名) 可以被用来简化 这项任务.例如, 你想用一个中断处理程序来增加一个记数变量, 就应该这样写:
      volatile int counter;
      void my_timer_handler()
      {
         counter++;
      }
      END_OF_FUNCTION(my_timer_handler);
在你的初始化代码里,应该锁住内存:
      LOCK_VARIABLE(counter);
      LOCK_FUNCTION(my_timer_handler);
很明显,如果你使用了复杂的数据结构并且在这个处理程序中调用了其它的 函数,这就显得很笨拙,所以你应该使你的中断处理程序尽量简洁.

3、设置时钟中断的频率
SECS_TO_TIMER(secs)  - 给出两次触发间的秒数
MSEC_TO_TIMER(msec)  - 给出两次触发间的万分之一秒数
BPS_TO_TIMER(bps)    - 给出每秒触发多少次
BPM_TO_TIMER(bpm)    - 给出每分钟触发多少次

4、/* 这些中断在这里被激活... */
Allegro的用户时钟中断貌似都在whlie(true)循环里起作用。如果你有写过“XX引擎”的话，应该对此有更深的体会。