C 语言图形编程
二 图形显示
一、确定显示卡 二、选择显示模式 三、图形显示
20. detectgraph() 显示卡检测函数 21. initgraph() 图形初始化函数 22. getdrivername() 获取图形驱动程序名的指针 23. getgraphmode() 获取图形模式函数 24. getmoderange()获取模式值范围函数 25. getmaxmode()获取最大显示模式函数 26. getmodename()获取显示模式名函数 27. graphdefaults()图形设置复位缺省值函数 28. setgraphmode() 设置图形模式函数 29. restorecrtmode() 恢复文本显示模式函数 30. graphresult() 图形操作结果函数 31. grpaherrormsg() 图形错误信息函数 32. setgraphbufsize()设置图形缓冲区大小函数 33. setactivepage() 设置可输出显示页函数 34. setvisualpage() 设置可见显示页数 35. closegraph()关闭图形模式函数 一、确定显示卡 微机系统显示部分由显示器(monitor)和显示卡(adapter)两部分组成。显示器是独立于主机 的一种外部设备，显示卡或称显示适配卡，也有的称图形卡，是插在主机上的一块电路板。 但也有的显示卡与主机板设计在一起。显示卡包括寄存器组、存储器和控制电路三大部分。 其中存储器又包括显示 RAM 和 ROM BIOS 两部分，微机对显示屏幕的所有操作都是通过 显示卡来实现的。因此要进行图形显示 ，首先要确定计算机上安装的是何种显示卡。一种 方法是询问计算机或终端使用者，确定将要使用的显示卡类型。这种方法很难，因为甚至专 业程序员也不总是能确定他正在使用什么样的硬件。另一种方法是用软件查询硬件以识别当 前的配置。如果有一些识别硬件的标准，这就很简单了。在 Borland C 中对现在所使用的各 种显示卡提供了支持，这只要调用 detectgraph()函数就可以了，该函数为程序员确定计算机 上使用的显示卡类型。 二、选择显示模式 显示模式是指显示卡支持的分辨率与相应的颜色配置。每台计算机都配置了某种类型显示 卡，可以为该显示卡指定显示模式。 三、图形显示 进行图形显示首先要确定显示卡，然后选择其显示模式。这些工作都可以调用图形功能 函数来完成，其实就是把适合于显示卡的图形驱动程序装入内存。如果图形驱动程序未装入 内存，那么图形函数就不能操作。 20. detectgraph() 显示卡检测函数 功能： 函数 detectgraph()在计算机上安装有显示卡的情况下，测定其显示卡的类型。 用法： 此函数调用方式为 void detectgraph(int *driver,int *mode); 说明： 函数把 driver 所指向的整型变量设置为图形驱动程序的代码，把 mode 所指向的整 型变量设置为显示卡支持的最高有效模式(即该显示卡能支持的最高分辨率)。
1
C 语言图形编程
该函数相应的头文件为 graphics.h 返回值： 返回适合于该显示卡的图形驱动程序的代码(也称等价值)，并存放在 driver 指向 的变量中。若计算机系统中无图形硬件，则由 driver 指向的变量设置为-2。 例： 检测计算机是否装有显示卡：
int driver,mode;
detectgraph(&driver,&mode);
if(driver==-2)
{
printf("no graphics adapter in the computer");
exit(1);
}
21. initgraph() 图形初始化函数
功能： 函数 initgraph()用于初始化图形系统，把适合的图形驱动程序装入内存，设置图形函
数所用的显示模式。
用法： 该函数调用方式为 void initgraph(int *driver,int *mode,char *path);
说明： 1) 函数中参数 driver 指向图形驱动程序(或者等价值)。
在头部文件 graphics.h 中定义了图形驱动程序的宏名与其等价 ，如下：
宏名
等价值
DETECT
0
CGA
1
MCGA
2
EGA
3
EGA64
4
EGAMONO 5
IBM8514
6
HERCMONO 7
ATT400
8
VGA
9
PC3270
10
注：在现在的计算机中，上表中的许多显示卡已经过时，不再使用。
这样就不必担心图形驱动程序的准确名字，而只要用其等价值即可，若使用 detect(即等价值 0)时，initgraph()函数自动检测当前计算机中装有的显示卡类型，并且选用最大分辨率的显 示模式。 2)参数 mode 指向显示模式或用等价值(风表 1-5),mode 所指的值必须是有效模式之一。 3)参数 path 指向图形驱动程序所在的路径，例如 path="C:\TC\BG1".若没有指定路径，就在 当前目录下寻找。
一般图形驱动程序包含在.BGI 文件中，这些文件是系统可以得到的。这个函数对应的头 文件是 graphics.h。 返回值： 无
例： 调用 initgraph()自动检测硬件图形系统，并选用最大分辨率显示模式。
init drver,mode;
driver=DETECT;
mode=0;
initgraph(&driver,&mode,""); 22. getdrivername() 获取图形驱动程序名的指针 功能： 函数 getdrivername()返回指向当前图形驱动程序名的指针。 用法： 此函数调用方式为 char *getdrivername(void); 说明： 本函数可以用来检测显示卡，但只能在 initgraph()设置图形驱动程序和显示模式之后 调用。
该函数相应的头文件为 graphics.h 返回值： 返回一指针，指向含有当前图形驱动程序名的字符串。 例： 显示当前图形驱动程序名：
2
C 语言图形编程
#include
#include
void main()
{
int graphdriver=DETECT,graphmode;
char *s;
initgraph(&graphdriver,&graphmode,"");
s=getdrivername();
outtext("Using driver:");
outtext(s);
getch();
closegraph();
} 23. getgraphmode() 获取图形模式函数 功能： 函数 getgrapgmode()返回当前图形模式。 用法： 该函数调用方式为 int getgraphmode(void); 说明： getgraphmode()函数无参数调用。
这个函数对应的头文件是 graphics.h 返回值： 返回 initgraph()或 setgraphmode()所设置的当前图形模式值。 例： 显示当前图形模式的代码：
printf("graphics mode is %d",getgraphmode()); 24. getmoderange()获取模式值范围函数 功能： 函数 getmoderange()返回指定的图形驱动程序能够支持的最低和最高模式值。 用法： 函数调用方式为 void getmoderange(int driver,int *lowmode,int himode); 说明： 参数 driver 是用来调用此函数时，指定图形驱动程序等价值或宏名。
其有效值如下：
宏名
等价值
DETECT
0
CGA
1
MCGA
2
EGA
3
EGA64
4
EGAMONO 5
IBM8514
6
HERCMONO 7
ATT400
8
VGA
9
PC3270
10
注：上表中的许多显示卡在现在的计算机上已经过时，仅作参考。
该函数想应的头文件为 graphics.h 返回值： 返回的最小和最大有效值存放在参数指针 lowmode 和 himode 分别指向的整型变 量中。
例： 显示当前图形硬件的显示模式的范围值：
#include"graphics.h"
void main()
{
int driver,mode;
int low,high;
mode=0;
initgraph(&driver,&mode,"");
getmoderange(driver,&low,&high);
printf("mode range:%d--%d,low,high);
3
C 语言图形编程
getch(); rstorecrtmode(); } 25. getmaxmode()获取最大显示模式函数 功能： 函数 getmaxmode()返回当前加载的图形驱动程序所支持的最大有效显示模式。 用法： 函数调用方式为 int getmaxmode(void); 说明：本函数无参数调用，返回图形驱动程序所支持的最大显示模式，所有图形驱动程序支 持从 0 到 getmaxmode()函数返回值中的任一整 数值(对应的显示模式)。 这个函数对应的头文件是 graphics.h 返回值：返回图形驱动程序所支持的显示模式最大值。 例： 显示当前最大显示模式： printf("The maxmode of this driver is %d\n",getmaxmode()); 26. getmodename()获取显示模式名函数 功能： 函数 getmodename()可获取当前图形驱动程序支持的指定显示模式的名字。 用法： 此函数调用方式为 char *getmodename(int modecode); 说明： 参数 modecode 为整型值。用以指定一显示模式值调用该函数。 这个函数对应的头文件 graphics.h 返回值： 返回指定模式值的显示模式名。 例： 显示当前最大显示模式名： #include
4
C 语言图形编程
28. setgraphmode() 设置图形模式函数 功能： 函数 setgraphmode()用当前图形驱动程序有效的图形模式调用，一旦被调用，
setgraphmode()选择一个新的图形模式。注意，图形显示模式必须事先由 initgraph()初始化。 用法： 该函数调用方式为 void setgraphmode(int mode); 说明： 参数 mode 调用时为指定的模式值。
此函数相应的头部文件是 graphics.h 返回值： 无 例： 把 VGA 图形卡设置为 VGAMED 模式：
setgraphmode(VGAMED); // 图形系统已经初始化 29. restorecrtmode() 恢复文本显示模式函数 功能： 函数 restrecrtmode()将显示模式恢复到调用 initgraph()时检测出的初始文本模式。 用法： 这个函数调用方式为 void restorecrtmode(void); 说明： 函数 restorecrtmode()和 setgraphmode()函数一起使用，可以实现文本与图形显示之间 的切换。
此函数对应的头文件为 graphics.h 返回值： 无 例： 恢复显示模式为初始文本模式：
restorecrtmode(); 30. graphresult() 图形操作结果函数 功能： 函数 graphresult()函数返回最后一次图形操作的代码。 用法： 此函数调用方式为 int graphresult(void); 说明： C 为图形设置了代码，它们是从-15 到 0 的整数值。其含义见表 1-6。
调用该函数时，出错状态被复位为 0，所以返回值(代码)最好存于变量中，以供需要时检 测，
进行下一步图形操作。
图形操作信息名称 代码 含 义
grOK grNoInitGraph grNoDetected grFileNoFound grInvalidDriver grNoLoadMem grNoScanMem grNoFloadMem grFontNotFound grNoFontMem grInvalidMode
0 成功 -1 没有图形初始化 -2 没有检测到图形硬件 -3 没有找到图形驱动文件 -4 无效图形驱动程序 -5 没有足够内存装入图形驱动程序 -6 Scan 填 充内存不足 -7 Flood 填 充内存不足 -8 没有找到字体文件 -9 没有足够内存用于装字体文件 -10 无效图形模式
5
C 语言图形编程
grError
-11 一般图形错误
grIOerror
-12 输入输出错误
grInvalidFont
-13 无效字体文件
grInvalidDeviceNum -14 无效字体号
-15 无效设备号
这个函数对应的头部文件是 graphics.h 返回值： 返回最后一次图形操作结果相应的代码。 例： 调用 graphresult()函数的实例见下面 grapherrormsg()函数的例子。 31. grpaherrormsg() 图形错误信息函数 功能： 函数 grapherrormsg()返回指向出错代码相应的错误信息字符串的指针。 用法： 此函数调用方式为 char *grapherrormsg(int errcode); 说明： 参数 errcode 值，即出错代码由调用函数 graphresult()获得。这里所有出错代码及相 应的错误信息如表 1-6 中所述。
该函数相应的头文件是 grpahics.h 返回值： 返回一个指向该出错代码相应的错误信息字符串的指针。 例： 用文字形式显示有关出错代码相应的错误信息：
int errorcode;
errorcode=graphresult();
printf(%s",grapherrormsg(errcode)); 32. setgraphbufsize()设置图形缓冲区大小函数 功能： 函数 setgraphbufsize()用来设置有的图形函数(如 floodfill 等)所要用到的内存缓冲区 大小。 用法： 函数调用方式为 unsigned setgraphbufsize(unsigned bufsize); 说明： 这里无符号参数 bufsize 为所设置的缓冲区大小。
一般不需要用到该函数，仅使用由 initgraph()函数产生的内存缓冲区就够了，缓冲区大 小缺省时为 4KB(即 4096 个字节)，足以用来填 充一个大约有 650 个顶点的多边形，但是为 了节省内存，用户可以减少缓冲区的大小，或者由于需要更多的缓冲区内存，这时可用函数 setgraphbufsize()来增加缓冲区大小。注意，使用 setgraphbufsize()函数必须在调用 initgraph() 之前。 返回值： 返回先前定义的图形缓冲区字节数。 例： 调用此函数设置图形缓冲区为 8KB 字节：
setgraphbufsize(0x2000); 33. setactivepage() 设置可输出显示页函数 功能： 函数 setactiveage()设置用作图形输出的显示页。 用法： 这个函数调用方式为 void setactivepage(int pagenum); 说明： 参数 pagenum 为选择的显示页号，如果调用成功，那么后续图形输出就写到选定的 输出页上。缺省时是以 0 页作为当前输出页。该函数只在图形驱动程序及其显示模式支持多 个显示页时才起作用。
此函数相应的头文件为 graphics.h 返回值： 无 例： 设置 1 页为输出显示页：
6
C 语言图形编程
setactivepage(1); 34. setvisualpage() 设置可见显示页数 功能： 函数 setvisualpage()设置屏幕上可见的显示页。 用法： 函数调用方式为 void setvisualpage(int pagenum); 说明： 参数 pagenum 为设置的显示页号。缺省时是以 0 页作为当前可见页。调用这个函数 和调用 setactivepage()一样，仅在图形驱动程序及其显示模式支持多个显示页时才有效。用 户可以用系统所支持的任何显示页，在它们之间切换，当然一次只能有一个显示页在屏幕上 可见，有时需要在一页上建立后备图形葨图像，它在当时不显示，一旦需要时，可以马上切 换到该页，如要实现动画效果，只需切换显示页号即可。用 setvisualpage()函数选 定实际显 示在屏幕上的可见页，用 setactivepage()函数选择当前图形输出页，从而实现图形页之间的 显示切换，通常这两个函数都是缺省的，这时输出页就是可见页。若不绘制动画就不需要用 到这两个函数。
这两个函数对应的头文件是 graphics.h 返回值： 无 例： 设置可见页为第 1 页：
setvisualpage(1); 35. closegraph()关闭图形模式函数 功能： 函数 closegraph()将系统图形模式关闭，，复位到 initgraph()初始文本模式，并且释放 图形驱动程序、字体和内部缓冲区所占用的系统内存。 用法： 这个函数调用方式为 void closegraph(void); 说明： 当用户的程序既用到图形输出又用到非图形输出时，应该调用此函数。特别是程序 多次调用 initgraph()函数的情况，要相应地调用 closegraph 函数,释放调用 initgraph()所占用 的内存，否则内存很快就满了，程序无法运行，如果程序结束，也可以用 restorecrtmode() 函数代替该函数，这样任何分配的内存都将释放。
此函数对应的头文件是 graphics.h 返回值： 无 例： 关闭图形系统：
closegraph();
7