使用 Allegro



请先阅读 readme.txt 里的一般介绍,版权条款,和有关如何编译 Allegro 的信息.


所有的 Allegro 函数,变量,数据结构都定义在 allegro.h 里. 你必须在你的程序 里包含(include)这个文件, 并且连接(link) liballeg.a 为了做到这些,你必须:


- 将下面这行写到所有使用了 Allegro 的 C 或 C++ 文件的开始:


#include <allegro.h>

- 如果你在命令行下或利用 makefile 编译程序, 将 '-lalleg' 加到 gcc 命 令行的末尾,比如:

gcc foo.c -o foo.exe -lalleg

- 如果你在使用 Rhide, 选择 Options/Libraries 菜单,在空位敲入 'alleg', 然后将前面的选择窗选上.

- 如果你不想使用某部分 Allegro 函数,你可以在包含 allegro.h 前定义下面 的任何预处理标志来稍微的减少你的一点编译时间:


alleg_mouse_unused
alleg_timer_unused
alleg_keyboard_unused
alleg_joystick_unused
alleg_gfx_driver_unused
alleg_palette_unused
alleg_graphics_unused
alleg_vidmem_unused
alleg_flic_unused
alleg_sound_unused
alleg_file_unused
alleg_datafile_unused
alleg_math_unused
alleg_gui_unused

请注意, 这些定义不会对你的执行文件的大小产生影响! 请看这个文件的最后部分关于怎样在链接阶段卸载不使用的代码.


int allegro_init();
初始化 Allegro 库. 它除了设置一个全局变量,锁住一些内存, 将 allegro_exit() 加载到 atexit() 例程上以外没有做更多的事,但是你必须在做其它事之前调用它. 成功者返回 0 (它不可能调用失败,所以没有更多的返回值).



void allegro_exit();
关闭 Allegro 系统. 这包括将系统返回到文本模式, 卸载装载过的鼠标,键盘, 时钟例程. 一般你不必去明显的去调用它, 因为 allegro_init() 将它作为 atexit() 例程加载了, 所以它将在你的程序退出时自动被调用.



extern char allegro_id[];
一个包含有库的日期和版本信息的字符串, 也许你在某些地方会用到这些.


extern char allegro_error[];
一个被 set_gfx_mode() 和 install_sound() 用来报告错误信息的字符串. 如果这些函数调用失败而你想告诉用户是为什么,在这里能找到有关问题的描述.


extern int os_type;
由 allegro_init() 设置成以下值中的一个: 

      OSTYPE_UNKNOWN    - 未知, 或常规的 MSDOS
      OSTYPE_WIN3       - Windows 3.1 或更早的版本
      OSTYPE_WIN95      - Windows 95
      OSTYPE_WIN98      - Windows 98
      OSTYPE_WINNT      - Windows NT
      OSTYPE_OS2        - OS/2
      OSTYPE_WARP       - OS/2 Warp 3
      OSTYPE_DOSEMU     - Linux DOSEMU
      OSTYPE_OPENDOS    - Caldera OpenDOS
extern int windows_version, windows_sub_version;
由 allegro_init() 设置, 使用 int 0x2F, ax=0x1600 来检测当前的 Microsoft Windows. 在 windows 3.1 下, windows_version 将被设为 3, 在 win95 下则是 4, 在 NT 在将是 0x100, 如果没有运行在 windows 下则为 0. 在 Linux DOSEMU 下, 两个变量都将被设为 -1.


void check_cpu();
检测 CPU 型号, 设置以下的全局变量:

extern char cpu_vendor[];
如果可能,由 check_cpu() 设置成 CPU 厂商的名字.

extern int cpu_family;
由 check_cpu() 设置成 CPU 型号: 3=386, 4=486, 5=Pentium, 6=PPro, 等等.

extern int cpu_model;
由 check_cpu() 设置成 CPU 子类型. 如果是 386 (cpu_family=3), 0 表示 DX 芯片, 2 表示 SX, 4 表示 SL, 15 表示未知. 如果是 486 (cpu_family=4), 0 或 1 表示 DX 芯片, 2 表示 SX, 3 表示 487 (SX) 或 486 DX, 4 表示 SL, 5 表示 SX2, 7 表示 DX2 write-back enhanced, 8 表示 DX4 或 DX4 overdrive, 14 表示 Cyrix, 15 表示未知. 如果是奔腾芯片(cpu_family==5), 1 表示 Pentium (510\66,567\66), 2 表示 Pentium P54C, 3 表示 Pentium overdrive processor, 5 表示 Pentium overdrive for InterDX4, 14 表示 Cyrix, 15 表示未知.


extern int cpu_fpu;
由 check_cpu() 设置成 TRUE 或 FALSE, 这个值依赖于有无一个浮点运算器 能够被利用.

extern int cpu_mmx;
由 check_cpu() 设置成 TRUE 或 FALSE, 这个值依赖于是否有 MMX 指令可以被利用.


extern int cpu_3dnow;
由 check_cpu() 设置成 TRUE 或 FALSE, 这个值依赖于是否有 3DNow! 指令集可以被利用.

extern int cpu_cpuid;
由 check_cpu() 设置成 TRUE 或 FALSE, 这个值取决于 "cpuid" 指令是否能被利用. (如果它被设置, 其它的 CPU 变量 100% 可信, 否则某些地方可能出了问题).




返回