在WINDOWS里使用ALLEGRO

关注

原创最新推荐文章于 2026-08-21 09:35:52 发布 1.7k 阅读 AI 写同款· GEO 优化 ›

AI权益加码！Claude Code、Cursor等20+工具免费用！购周边限时加赠Coding Plan Lite，畅享主流AI工具！学习进阶更高效！阅读详情

在WINDOWS里使用ALLEGRO

     在WINDOWS里使用ALLEGRO，如果不要MFC且使用ALLEGRO封装好的API就用ALLEGRO.H，如果要使用没有封装过的API就调用winalleg.h，但如果你要使用MFC，你可以在代用这些之前定义ALLEGRO_AND_MFC这个宏，而在这种情况下，ALLEGRO的ASSERT()和 TRACE()由于和WINDOWS 的宏冲突所以就改为AL_ASSERT() and AL_TRACE().
    在WIN32程序中使用WINMAIN做入口点，而ALLEGRO可以让main做入口点，不过你得把在main函数之后加END_OF_MAIN() 以便让ALLEGRO知道主函数结束，如过你嫌麻烦，那么就直接写一个WINMAIN做入口点{请先包含winalleg.h}，省你麻烦。但是用main做入口点的小把戏在你直接调用未封装的API时，就会发生冲突，因为那些API只认WINMAIN();那么就请你在使用未封装的API时，使用WINMAIN做入口，但同时要定义ALLEGRO_NO_MAGIC_MAIN这个宏。
    如果你写的是个控制台程序，那么就在调用头文件之前定义宏ALLEGRO_USE_CONSOLE ，这样的话，前面提到的用main做入口的小把戏就没用了，这个宏可以让ALLEGRO知道该怎么做。
    WIN的程序有图标，ALLEGRO默认IDI_APPLICATION作为自身图标，如果你要改变你所写的程序的图标，可以使用tools/win目录里的wfixicon这个程序创建一个名为allegro_icon的图标资源。
    DIRECT X要求你的系统支持视频位图（包括屏幕）。也就是说在你操作时，必须能锁住这些位图。这项工作将被ALLEGRO自动完成，不过吗，有时换是需要你手动操作的，所以查看acquire_bitmap()相关的内容了解更详细的知识。
    由于DirectX本身设计的特点，可能你在用WIN键或别的方法切出你的程序后，屏幕的内容以及一些视频位图（video bitmap）的内容将丢失，你可以使用set_display_switch_callback()这个API来找回你要的东西。
    在WINDOWS里，desktop_color_depth()将只能返回 8, 16, 24 和 32.那么就是说无法区分15和16位色深，这两中色深被报告出相同的结果16，
    (2003.10.31 14:14)WINDOWS的GFX_*驱动相关：
    ALLEGRO的set_gfx_mode()函数在WINDOWS下支持以下参数：
    GFX_TEXT这个参数将关闭在此之前用set_gfx_mode打开的其他图形模式。
    GFX_AUTODETECT 让ALLEGRO自己挑选一个合适的图形驱动。
    GFX_AUTODETECT_FULLSCREEN自动检测图形驱动，但只使用全屏模式的驱动，如果当前使用的操作系统不支持，就返回失败信息。
    GFX_AUTODETECT_WINDOWED同上，但只使用窗口模式的驱动。
    GFX_SAFE当你不关心当前使用的色深和分辨率是，这个特殊的图形驱动将很适合你，查看set_gfx_mode() 文档可以得到更多的介绍。
    GFX_DIRECTX是GFX_DIRECTX_ACCEL的别名。
    GFX_DIRECTX_ACCEL通用的全屏幕DirectX驱动,在硬件加速可用时使用这一参数。
    GFX_DIRECTX_SOFT是DirectX的全屏驱动，只使用软件绘制而不是调用硬件加速的特性。
    GFX_DIRECTX_SAFE是DirectX简化全屏的驱动，不支持任何硬件加速，视频和系统位图等等。
    GFX_DIRECTX_WIN是通用的窗口模式DirectX驱动,当选用的色深不匹配WINDOWS桌面的色深时，运行在模拟色深（color conversion）模式， Color conversion不直接绘制而且不支持15-bit 和 16-bit 色深.
    这个限制是desktop_color_depth()所导致的。但它允许选择直接绘制模式， 16-bit色深设置方法:
    if (desktop_color_depth() == 16)
    {
       set_color_depth(16);
       if (set_gfx_mode(GFX_DIRECTX_WIN, 640, 480, 0, 0)!= 0)
          {
          set_color_depth(15);
       if (set_gfx_mode(GFX_DIRECTX_WIN, 640, 480, 0, 0)!= 0)
          {
       /* 640x480 direct drawing mode not supported */
       goto Error;
       }
    }
    /* ok, we are in direct drawing mode */
    } 要注意的是，由于某些原因，驱动要求屏幕的宽度是4的倍数。 GFX_DIRECTX_OVL是DirectX overlay 驱动. 他使用特殊的硬件特性运行你的程序在窗口模式：他不能在所有硬件上通用，但在支持它的硬件上，他跑的很好，他要求你采用与屏幕相同的色深，这也是 desktop_color_depth() 造成的限制之一,以下的方法可以设置overlay 驱动，并且是16-bit色深:
    if (desktop_color_depth() == 16)
       {
       set_color_depth(16);
       if (set_gfx_mode(GFX_DIRECTX_OVL, 640, 480, 0, 0)!= 0)
          {
             set_color_depth(15);
             if (set_gfx_mode(GFX_DIRECTX_OVL, 640, 480, 0, 0)!= 0)
             {
             /* 640x480 overlay driver not supported */
             goto Error;
             }
          }
       /* ok, the 640x480 overlay driver is running */
       }
    GFX_GDI是窗口 GDI 驱动. 它非常慢，但可以运行在所有的硬件上，所以当你不关心你做的程序的速度，效果等诸多表现，且你希望运行在窗口模式时，这个参数将帮助你达成愿望，需要注意的是这个驱动使用硬件鼠标指针，目的是加快默写基本的鼠标操作，比如GUI操作。参看: set_gfx_mode.
    WINDOWS的DIGI_*驱动：
    Windows 声音函数支持以下数字声卡：
    DIGI_AUTODETECT可以让Allegro自选一个声卡驱动
    DIGI_NONE代表不支持数字声音
    DIGI_DIRECTX(n)使用DirectSound设备#n (zero-based)with direct mixing
    DIGI_DIRECTAMX(n)使用DirectSound设备#n (zero-based)with Allegro mixing
    DIGI_WAVOUTID(n) - high (n=0) 或 low (n=1) quality WaveOut device
    查看: detect_digi_driver, install_sound,install_sound_input.
     MIDI_*/Windows 驱动
    Windows声卡驱动支持以下MIDI声卡:
    MIDI_AUTODETECT让 Allegro选择合适的 MIDI 声卡驱动
    MIDI_NONE - 无MIDI声音
    MIDI_WIN32MAPPER - 使用win32 MIDI mapper
    MIDI_WIN32(n) - 使用win32 设备 #n (zero-based)
    MIDI_DIGMID - sample-based software wavetable player
    以下的函数提供特殊接口让ALLEGRO可以为Win32程序工作.为了使用以下函数，你必须在其他的头文件之后包含winalleg.h.
    查看: detect_midi_driver, install_sound,install_sound_input.
    HWND win_get_window(void); 提取一个窗口句柄给 Allegro使用. 需要注意的是ALLEGRO使用underlying window 即使你不设置图形模式,除非你安装了 neutral 系统驱动(SYSTEM_NONE).
    void win_set_window(HWND wnd); 注册一个用户创建的窗口给ALLEGRO使用，这个函数在你调用 allegro_init()初始化图形库之前，或是安装自动探测系统驱动之前(SYSTEM_AUTODETECT). 这可以让ALLEGRO工作在已经存在的窗口而不是她自己创建的窗口，这样可以让你完全的控制窗口；在特殊情况下你要负责时间的处理。(Allegro 将自动控制一部分，但不对他们进行过滤). 你可以使用库里的没一个组件(graphics, mouse, keyboard, sound, timers 等待), 某些应当引起你的注意(比如 readkey() 如果键盘缓冲是空的，他将一直等待接收按键，所谓的BLOCKING就会发生)因此，在窗口线程中谨慎使用这些函数。然而在库被初始化后的非图形模式里你是可以调用它的。这中情况下keyboard, mouse, joystick, sound 和声音记录模块将被重新打开如果一贯用户创建的窗口被注册，传送NULL指令可以让ALLEGRO使用它自己的内建窗口。或是调用一个新的窗口句柄{如果内建窗口已经在使用}
    void win_set_wnd_create_proc(HWND (*proc)(WNDPROC));
    在ALLEGRO创建自己的窗口时注册一个用户定义的过程给ALLEGRO使用。这个函数必须在用allegro_init()初始化库之前被调用或是安装自动探测系统驱动(SYSTEM_AUTODETECT).它可以让你调整Allegro的窗口，不过只在创建后有效：不象win_set_window(), 因为它让你在窗口创建之后没有窗口的控制权(好处是你不必操心事件的运行).这个注册的函数将传递一个窗口过程 (WNDPROC object) 你必须为新窗口写一个返回新窗口的句柄的函数，然后你就可以象以前一样使用ALLEGRO的所有特性。
    HDC win_get_dc(BITMAP *bmp);
    提取DirectX 的视频位图和系统位图句柄。
    void win_release_dc(BITMAP *bmp, HDC dc);
    释放你在此之前用win_get_dc()得到的位图句柄。
    GDI routines
    下面的这些GDI函数在WINDOWS的设备上下文里绘制ALLEGRO内存位图有平台针对性，当你使用他们时，你将被迫安装 neutral system driver (SYSTEM_NONE) 或是 attach Allegro to an external window with win_set_window().
    有两种方法在Windows GDI上绘制ALLEGRO内存位图. 当你使用的是静态位图{static bitmaps} (比如从datafile调用的一些图片),你可以用convert_bitmap_to_hbitmap()把他们转换成 DDB (device-dependent bitmaps即设备依赖位图) 然后用Win32的BitBlt()绘制这些图.
    当你使用的是{dynamic bitmaps}(for example some things which react to user input),最好使用set_palette_to_hdc()和blit_to_hdc()函数,他们使用 DIB (device-independent bitmaps即非设备依赖位图).
    当然，也有把设备上下文里的位图BLIT到Allegro BITMAP的方法,这样的话，你就可以做打印屏幕位图等类似的事.
    所有的绘图和转换函数是用当前调色版作为颜色转换表。你可以使用 set_palette_to_hdc() 或select_palette() 函数来变换这个表. 警告: 当 GDI系统调色版被改变以后, (比如被另一个程序修改) 当前的 Allegro 不会跟着更新。使用这些函数，你必须在ALLEGRO头文件之后包含winalleg.h
    void set_gdi_color_format(void);
    告诉Allegro让truecolor images使用GDI color层.这是可选项，但着可以让图形转换更快的完成。如果你打算用这个，你必须在初始化Allegro之后创建任何图形之前使用它.
    void set_palette_to_hdc(HDC dc, PALETTE pal);
    在特殊设备上下文里选择一个Allegro调色板.
    HPALETTE convert_palette_to_hpalette(PALETTE pal);
    将Allegro调色板转换成Windows调色板并返回一个句柄，在你不需要他的时候，你应该调用DeleteObject().
    查看: convert_hpalette_to_palette.
    void convert_hpalette_to_palette(HPALETTE hpal, PALETTE pal);
    转换一个Windows调色板成为Allegro调色板. 查看: convert_palette_to_hpalette.
    HBITMAP convert_bitmap_to_hbitmap(BITMAP *bitmap);
    把Allegro内存位图转换成Windows DDB并返回一个句柄. 这个位图使用自己的内存,所以你可以把原位图销毁而不会影响到转换成的那个。当你不再用它时，请调用DeleteObject().
    查看: convert_hbitmap_to_bitmap.
    BITMAP *convert_hbitmap_to_bitmap(HBITMAP bitmap);
    从Windows DDB创建一个Allegro 内存位图。
    查看: convert_bitmap_to_hbitmap.
    void draw_to_hdc(HDC dc, BITMAP *bitmap, int x, int y);
    把整个 Allegro位图绘制到Windows设备上下文,使用与draw_sprite()函数一样的参数.
    查看: blit_to_hdc, stretch_blit_to_hdc, draw_sprite.
    void blit_to_hdc(BITMAP *bitmap, HDC dc, int sx, sy, dx, dy, w, h);
    把一个Allegro内存位图BLIT到Windows设备上下文,使用与blit() 函数相同的参数.
    : draw_to_hdc, stretch_blit_to_hdc, blit_from_hdc, blit.
    void stretch_blit_to_hdc(BITMAP *bitmap, HDC dc, int sx, sy, sw, sh, int dx, dy, dw, dh);
    把 Allegro内存位图BLIT到Windows设备上下文,使用与stretch_blit()函数相同的参数.
    查看: draw_to_hdc, blit_to_hdc, stretch_blit_from_hdc, stretch_blit.
    void blit_from_hdc(HDC hdc, BITMAP *bitmap, int sx, sy, dx, dy, w, h);
    把Windows设备上下文BLIT到Allegro内存位图,使用与blit() 函数相同的参数. 详情参看 stretch_blit_from_hdc() .
    查看: stretch_blit_from_hdc, blit_to_hdc, blit.
    void stretch_blit_from_hdc(HDC hcd, BITMAP *bitmap, int sx, sy, sw, sh, int dx, dy, dw, dh);
    把Windows设备上下文BLIT到Allegro内存位图，使用与stretch_blit()函数相同的参数. 它使用当前的 Allegro调色板转换到目的调色板，不考虑当前的 DC调色板 .所以如果你blitting from 8-bit模式,你应该先用set_palette_to_hdc()函数设置DC调色板.
    查看: blit_from_hdc, stretch_blit_to_hdc, stretch_blit.

　　翻译作者：vrix.ipona

收录于