警告: 当使用真彩图片时, 你必须在载入任何位图数据前 设置图形模式! 否则点格式 (RGB 或 BGR) 将无法得知, 因此文件可能转换错误.
BITMAP *load_bitmap(char *filename, RGB *pal);
从一个文件里装入位图, 返回一个位图指针并且将
调色板数据存到指定的位置, 调色板是 256 个 RGB 结构的数组.
你有责任在你使用完它以后释放掉位图.
如果出错则返回 NULL. 目前这个函数
支持 BMP, LBM, PCX, 和 TGA 文件, 以文件的后缀来决定类型.
如果文件包含一个真彩图片, 你必须设置显示模式
或者在装载图片前调用 set_color_conversion().
BITMAP *load_bmp(char *filename, RGB *pal);
调入一个 Windows 或 OS/2 的 256 色或 24 位真彩 BMP 文件.
BITMAP *load_lbm(char *filename, RGB *pal);
调入一个 256 色 IFF ILBM/PBM 文件.
BITMAP *load_pcx(char *filename, RGB *pal);
调入一个 256 色或 24 位真彩 PCX 文件.
BITMAP *load_tga(char *filename, RGB *pal);
调入一个 256 色, 15 位高彩, 或 24 位真彩 TGA 文件.
int save_bitmap(char *filename, BITMAP *bmp, RGB *pal);
将位图写入文件, 使用指定的调色板, 就是 256 个 RGB 结构的调色板.
如果出错则返回非零值. 输出
格式从文件的后缀检测到: 目前这个
函数支持 BMP, PCX 和 TGA 格式. 一件需要提防的事:
如果你使用这个来将屏幕拷入文件,可能得到一个
比你希望的大的多的图片, 因为 Allegro 经常创建
比可见屏幕大的多的虚拟屏幕. 你能通过
使用一个子位图来指定屏幕的一部分来避免这个问题而保存屏幕, 比如:
BITMAP *bmp;
PALETTE pal;
get_palette(pal);
bmp = create_sub_bitmap(screen, 0, 0, SCREEN_W, SCREEN_H);
save_bitmap("dump.pcx", bmp, pal);
destroy_bitmap(bmp);
int save_bmp(char *filename, BITMAP *bmp, RGB *pal);
int save_pcx(char *filename, BITMAP *bmp, RGB *pal);
将位图写到 256 色或 24 位真彩 PCX 文件.
int save_tga(char *filename, BITMAP *bmp, RGB *pal);
将位图写到 256 色, 15 位高彩, 或 24 位真彩 TGA 文件.
void register_bitmap_file_type(char *ext,
BITMAP *(*load)(char *filename, RGB *pal),
int (*save)(char *filename, BITMAP *bmp, RGB *pal));
告之 load_bitmap() 和 save_bitmap() 函数一个新的文件类型,
提供例程用来读写这种图片格式 (其中某个函数可以为 NULL).
void set_color_conversion(int mode);
指定当从外部位图文件或数据文件里读取图片时,怎样在
有效的颜色深度之间转换. mode 是一个
指定允许何种转换类型的位掩码. 如果
合适的位被设置, 数据将被转换到当前的点
格式 (由调用 set_color_depth() 函数来选择), 否则它将
保留为磁盘文件中的同一格式, 把
它在显示之前的转换工作留给你. 缺省模式是
全部格式转换, 以便于所有的图片将以合适的
格式被载入来适应当前的显示模式. 有效的位标志有:
COLORCONV_EXPAND_256 // 扩展 256 色到真彩
COLORCONV_REDUCE_TO_256 // 将真彩减少到 256 色
COLORCONV_EXPAND_15_TO_16 // 扩展 15 位高彩到 16 位
COLORCONV_REDUCE_16_TO_15 // 将 16 位高彩减少到 15 位
COLORCONV_EXPAND_HI_TO_TRUE // 扩展 15/16 位到 24/32 位
COLORCONV_REDUCE_TRUE_TO_HI // 减少 24/32 位到 15/16 位
COLORCONV_24_EQUALS_32 // 在 24 和 32 位之间转换
COLORCONV_DITHER // 当减少到高彩时抖动
下面这些宏可以用来选择常用的标志组合:
COLORCONV_NONE // 关闭所有的格式转换
COLORCONV_TOTAL // 转换所有的格式到当前的格式
COLORCONV_PARTIAL // 转换 15 <-> 16 和 24 <-> 32 位
COLORCONV_MOST // 打开所有的转换,除了真彩 <-> 256 之间的转换
如果你设置了 COLORCONV_DITHER 标志, 将在真彩转换到高彩时使用抖动,
包括 blit() 函数. 这能够产生相当好的效果, 但是比直接转换要慢的多.