与图形有关的函数
GRAPHICS.H 库文件
bar
【功能】画出一条栏目。
【原型】void far bar(int left,int top,int right,int bottom)
【位置】graphics.hgraphics.h
【参见】bar3d,setfillstyle,rectangle
bar3d
【功能】画出一条3-D栏目。
【原型】void far bar3d(int left,int top,int right,int bottom,int depth,int topflag)
【位置】graphics.h
【参见】bar
circle
【功能】以(x,y)为圆心按照指定的半径画出一个圆。
【原型】void far circle(int x,int y,int radius)
【位置】graphics.h
【参见】arc
cleardevice
【功能】清除图形画面。
【原型】void far cleardevice(void)
【位置】graphics.h
【参见】clearviewport
clearviewport
【功能】清除当前可视区域。
【原型】clearviewport(void)
【位置】graphics.h
【参见】setviewport,cleardevice
closegraph
【功能】关闭图形系统。
【原型】void far closegraph(void)
【位置】graphics.h
【参见】initgraph
detecgraph
【功能】通过检查硬件确定使用的图形驱动程序和模式。
【原型】void far detectgraph(int far *graphdriver,int far *graphmode)
【位置】graphics.h
【参见】initgraph,graphresult
drawpoly
【功能】画出一个多边形的轮廓。
【原型】void far drawpoly(int numpoints,int far polypoints[])
【位置】graphics.h
【说明】polypoints中包括一共numpoints对数值。其中每一对都给出了多边形中一个顶点的x和y值。
【参见】fillpoly
ellipse
【功能】画出一条椭圆形的圆弧。
【原型】void far ellipse(int x,int y,int stangle,int endangle,int xradius,int yradius)
【位置】graphics.h
【说明】中心点在(x,y)，stangle和endangle表示一角度为单位的起始角和终止角。Xradius和yradius表示水平轴和垂直轴。
【参见】arc,circle,fillellipse
fillellipose
【功能】画出椭圆形圆弧，并填充。
【原型】void far fillllipse(int x,int y,int xradius,int yradius)
【位置】graphics.h
【说明】使用(x,y)作为中心点，然后使用当前的填充模式填充圆弧。Xradius和yradius表示水平轴和垂直轴。
【参见】arc,circle,ellipse,pieslice
fillpoly
【功能】画出一个多边形，并填充。
【原型】void far fillpoly(int numpoints,int far polypoints[])
【位置】graphics.h
【说明】polypoints中包含有numpoints对数值。其中每一对给出了多边形一个顶点的x值和y值。
【参见】drawpoly,fill_patterns,floodfill,graphresult,setfillstyle
floodfill
【功能】填充一个有界区域范围。
【原型】void far floodfill(int x,int y,int border)
【位置】graphics.h
【参见】drawpoly,fillpoly,fill_patterns,graphresult,setfillstyle
getarccoords
【功能】得到最后一次调用arc的坐标值。
【原型】void far getaerccoords(struct arccoordstype far *arccoords)
【位置】graphics.h
【参见】arc
getaspectratio
【功能】得到当前图形模式的纵横比。
【原型】void far getaspectratio(int far *xasp,int far *yasp)
【位置】graphics.h
【说明】are及类似函数使用纵横比令圆圈更加圆，而不会像椭圆。Yasp应当为10000。当象素为平方并且<10000时，xasp使用10000数值。
【参见】arc,setaspectratio
getbkcolor
【功能】返回当前背景颜色。
【原型】int far getbkcolor(void)
【位置】graphics.h
【参见】setbkcolor,getcolor,getpalette
getcolor
【功能】返回当前画笔的颜色。
【原型】int far getcolor(void)
【位置】graphics.h
【参见】getbkcolor,setcolor,getmaxcolor,getpalette
getdefaultpalette
【功能】返回调色板定义结构。
【原型】struct palettetype *far getdefaultpalette(void)
【位置】graphics.h
【说明】返回一个指针，指向调用initgraph初始化时，当前驱动程序的默认调色板结构。
【参见】getpalette,initgraph
getdrivername
【功能】返回一个指针，指向当前图形驱动程序的名称。
【原型】char *far getdrivername(void)
【位置】graphics.h
【说明】返回的指针指向标识当前驱动器程序的字符串，从而可以探测到硬件适配器。
【参见】initgraph
getfillpattern
【功能】将用户定义的填充模式复制到内存中。
【原型】void far getfillpattern(char far *pattern)
【位置】graphics.h
【参见】getfillsettings,setfillpattern,fill_patterns
getfillsettings
【功能】得到当前填充模式及其颜色的有关信息。
【原型】void far getfillsettings(struct fillsettingstype far *fillinfo)
【位置】graphics.h
【参见】floodfill, fillpoly, setfillstyple, pieslice, setfillpattern, bar3d, bar, getfillpattern
getgraphmode
【功能】返回当前图形模式。
【原型】int far getgraphmode(void)
【位置】graphics.h
【说明】必须先调用initgraph或者setgraphmode。
【参见】setmoderange,restorectrtmode
getimage
【功能】将制定区域的位图保存到内存中。
【原型】void far getimage(int left,int top,int right,int bottom,void far *bitmap)
【位置】graphics.h
【参见】imagesize,putimage
getlinesettings
【功能】得到当前的直线样式、模式和粗细。
【原型】void far getlinesettings(struct linesettingstype far *lineinfo)
【位置】graphics.h
【参见】setlinestyle
getmaxcolor
【功能】返回最大颜色值。
【原型】int far getmaxcolor(void)
【位置】graphics.h
【参见】getbcolor,getpalette,getcolor,setcolor
getmaxmode
【功能】返回当前驱动程序的最大图形模式号。
【原型】int far getmaxmode(void)
【位置】graphics.h
【说明】getmaxmode可以得到当前装载的图形驱动程序的最大模式号。适用于所有驱动程序—包括Borland驱动程序及其他驱动程序。
【参见】getmoderange
getmaxx
【功能】返回画面坐标的最大x值。
【原型】int far getmaxx(void)
【位置】graphics.h
【参见】getx
getmaxy
【功能】返回画面坐标的最大y值。
【原型】int far getmaxy(void)
【位置】graphics.h
【参见】getx
getmodename
【功能】返回指针，指向图形模式的名称。
【原型】char *far getmodename(int mode_number)
【位置】graphics.h
【说明】返回的指针指向mode_number指定模式的名称(字符串)。
【参见】getmaxmode,getmoderange
getmoderange
【功能】得到指定图形驱动器的模式范围。
【原型】void far getmoderange(int graphdriver,int far *lomode,int far *himode)
【位置】graphics.h
【参见】initgraph,getmaxmode,setgraphmode,getgraphmode.
getpalette
【功能】得到当前调色板的有关信息。
【原型】void far getpalette(struct palettetype far *palette)
【位置】graphics.h
【参见】setpalette,setallpalette,getbkcolor,getdefaultpalette,getcolor
getpalettesize
【功能】返回调色板表的大小。
【原型】int far getpalettesize(void)
【位置】graphics.h
【说明】getpalettesize返回当前图形驱动程序模式允许的调色板条目的数目。
【参见】setpalette,setallpalette
getpixel
【功能】得到某个指定向素的颜色。
【原型】unsigned far getpixel(int x,int y)
【位置】graphics.h
【参见】putpixel,getimage
gettextsettings
【功能】得到当前图形文字字体的有关信息。
【原型】void far gettextsettings(struct textsettingstype far *texttypeinfo)
【位置】graphics.h
【参见】outtext, outtextxy, textheight, textwidth, settextjustify, settextsyle, registerbgifont
getviewsettings
【功能】得到当前视窗的有关信息。
【原型】void far getviewsettings(struct viewporttype far *viewport)
【位置】graphics.h
【参见】setviewport,clearviewport
getx
【功能】返回当前位置的x坐标。
【原型】int far getx(void)
【位置】graphics.h
【说明】返回数值与视窗相关。
【参见】gety,moveto,getviewsettings
gety
【功能】返回当前位置的y坐标。
【原型】int far gety(void)
【位置】graphics.h
【说明】返回数值与视窗相关。
【参见】getx,moveto,getviewsettings
graphdefaults
【功能】将所有图形设置重值为默认值。
【原型】void far graphdefaults(void)
【位置】graphics.h
【参见】initgraph,setgraphmode
grapherrormsg
【功能】返回一个指针，指向错误消息字符串。
【原型】char *far grapherrormsg(int errorcode)
【位置】graphics.h
【说明】返回指针指向的字符串与graphresult返回值相关。
【参见】graphresult
_graphfreemem
【功能】用户申请重新分配图形内存。
【原型】void far _graphfreemem(void far *ptr,unsigned size)
【位置】graphics.h
【说明】图形函数库中的程序调用该函数来释放内存。可以自己使用_graphgetmem和_graphfreemem函数来控制内存分配。
【参见】_graphgetmem
_gaphetmem
【功能】用户申请重新分配图形内存。
【原型】void far *far _graphgetmem(unsigned size)
【位置】graphics.h
【说明】图形函数库中的程序调用该函数来释放内存。可以自己使用_graphgetmem和_graphfreemem函数来控制内存分配。
【参见】_graphfreemem
graphresult
【功能】返回最后一次失败图形操作的错误代码。
【原型】int far graphresult(void)
【位置】graphics.h
【说明】返回最后一次报告错误图形的错误代码，并且将错误等级重置为grOK。
【参见】grapherrormsg
imagesize
【功能】返回存储位图所需的字节数。
【原型】unsigned far imagesize(int left,int top,int right,int bottom)
【位置】graphics.h
【说明】如果选定图形所需的大小大于等于64k-1个字节，则返回0xFFFF。
【参见】getimage,putimage
initgraph
【功能】初始化图形系统。
【原型】void far initgraph ( int far *graphdriver, int far *graphmode, char far *pathtodriver)
【位置】graphics.h
【参见】getgraphmode , closegraph , detectgraph , _graphgetmem , getdrivername , restorecrtmode,setgraphbufsize,registerbgidriver,graphresult,installuserdriver
installuserdriver
【功能】按照设备驱动程序。
【原型】int far installuserdriver(char far *name,int huge(*detect)(void))
【位置】graphics.h
【说明】name表示设备驱动程序的文件名称(*.bgi)，detect指向initgraph使用autodetect选项调用的函数。
【参见】initgraph,registerbgidriver
installuserfont
【功能】装载一个字体文件。
【原型】int far installuserfont(char far *name)
【位置】graphics.h
【说明】name表示图形函数还没有识别的字体文件(扩展名为.chr)DOS文件名称。installuserfont返回一个字体ID号。选择新字体时，使用该ID号调用settextstyle。
【参见】settextstyle
line
【功能】在两个指定点之间画出一条直线。
【原型】lint(int x1,int y1,int x2,int y2)
【位置】graphics.h
【说明】使用当前颜色、线条样式和线条粗细从(x1,y1)画一条直线到(x2,y2)。
【参见】lineto,linerel,setcolor,getlinesettings
linerel
【功能】从当前位置(CP)画一条一直长度的直线。
【原型】linerel(int dx,int dy)
【位置】graphics.h
【说明】使用当前颜色、线条样式和线条粗细。
【参见】line,lineto,setcolor,getcolor,getlinesettings
lineto
【功能】从当前位置(CP)到(x,y)之间画一条直线。
【原型】void far lineto(int x,int y)
【位置】graphics.h
【参见】line,linerel,setcolor,getlinesettings,setwritemode
moverel
【功能】从当前位置(CP)移动一段距离。
【原型】moverel(int dx,int dy)
【位置】graphics.h
【参见】moveto
moveto
【功能】从当前位置(CP)移动到(x,y)点。
【原型】void far moveto(int x,int y)
【位置】graphics.h
【参见】moverel
outtext
【功能】在视窗中(图形模式)显示一个字符串。
【原型】void far outtext(char far *textstring)
【位置】graphics.h
【参见】gettextsettings,texthright,textwidth,outtextxy
outtextxy
【功能】在指定位置(图形模式)发送一个字符串。
【原型】void far outtextxy(int x,int y,char far *textstring)
【位置】graphics.h
【参见】gettextsettings,textherght,textwidth,outtext
pieslice
【功能】画出扇形区并加以填充。
【原型】void far pieslice(int x,int y,int stangle,int endangle,int radius)
【位置】graphics.h
【参见】setfillstyle,sector,fill_patterns,fillellipse,graphresult
putimage
【功能】在屏幕上输出一副位图。
【原型】void far putimage(int left,int top,void far *bitmap,int top)
【位置】graphics.h
【说明】bitmap指向一副位图，该位图通常由getimage函数创建。Op的数值说明如何在(left,top)点将图像与区域中的当前内容结合起来。
【参见】getimage
putpixel
【功能】在指定点上画一个像素。
【原型】void far putpixel(int x,int y,int pixelcolor)
【位置】graphics.h
【参见】getpixel,putimage
rectangle
【功能】画出一个矩形(图形模式)。
【原型】void far rectangle(int left,int top,int right,int bottom)
【位置】graphics.h
【说明】使用当前线条样式、线条粗细和颜色。
【参见】bar,setlinestyle,setcolor
registerbgidriver
【功能】注册链入的图形驱动程序。
【原型】int registerbgidriver(void(*driver)(void))
【位置】graphics.h
【说明】通知图形系统链接时设备驱动程序指向的参数和驱动程序。
【参见】initgraph,registerbgifont,installuserdriver
registerbgifont
【功能】注册链入的字体代码。
【原型】int registerbgifont(void(*font)(void))
【位置】graphics.h
【说明】通知图形系统连接时指向的字体。
【参见】initgraph,registerbgidriver
restorecrtmode
【功能】将屏幕模式恢复到前一次initgraph的设置。
【原型】void far restorecrtmode(void)
【位置】graphics.h
【参见】initgraph,setgraphmode
sector
【功能】画出椭圆形的扇形区并加以填充。
【原型】void far sector(int x,int y,int stangle,int endangle,int xradius,int yradius)
【位置】graphics.h
【说明】x和y定义出中心点，stangle和endangle则定义起始和终止角。Xradius和yradius表示水平和垂直半径。
【参见】pieslice,setfillstyle
setactivepage
【功能】为图形输出设置活动页面。
【原型】void far setactivepage(int page)
【位置】graphics.h
【说明】后续的图形输出就指向该显示页面。该页面可能不是实际显示的可视页面。
【参见】setvisualpage
setallpalette
【功能】将所有调色板的颜色改为指定颜色。
【原型】void far setallpalette(struct palettetype far *palette)
【位置】graphics.h
【参见】setpalette,getpalettesize,getpalette,setcolor,setbkcolor,graphresult
setaspectratio
【功能】设置图形模式的纵横比。
【原型】void far setaspectratio
【位置】graphics.h
【说明】are及类似函数使用纵横比令圆圈更加圆，而不会像椭圆。yasp应当为10000。当象素为平方并且<10000时，xasp使用10000数值。
【参见】getaspectratio
setbkcolor
【功能】使用调色板设置当前的背景颜色。
【原型】void far setbkcolor(int color)
【位置】graphics.h
【参见】setpalette,setcolor,getbkcolor
setcolor
【功能】设置当前画笔颜色。
【原型】void far setcolor(int color)
【位置】graphics.h
【参见】getcolor,setbkcolor,setpalette,graphresult
setfillpattern
【功能】选择一个用户自定义的填充模式。
【原型】void far setfillpattern(char far *upattern,int color)
【位置】graphics.h
【说明】upattern指向一个8字节的区域，其中定义了一个8*8位的模式。
【参见】fill_patterns,getfillpattern,getfillsettings,setfillstyle
setfillstyle
【功能】设置填充模式和颜色。
【原型】void far setfillstype(int pattern,int color)
【位置】dos.h
【参见】get,fillstype
setgraphbufsize
【功能】改变内部图形缓冲区的大小。
【原型】unsigned far setgraphbufsize(unsigned bufsize)
【位置】graphics.h
【说明】必须在调用initgraph之前调用该函数。
【参见】initgraph,_graphgetmem
setgraphmode
【功能】系统设置为图形模式，同时清屏。
【原型】void far setgraphmode(int mode)
【位置】graphics.h
【参见】initgraph,getgraphmode,restorecrtmode,graphresult
setlinestyle
【功能】设置当前的线条样式、宽度或者模式。
【原型】void far setlinestyle(int linestyle,unsigned upattern,int thickness)
【位置】graphics.h
【说明】可以设置使用line,lineto,tectangle,drawpoly,aec,circle,ellipse,pieslice等函数画的所有线条样式。
【参见】getlinesettings,graphresult
setpalette
【功能】改变一种调色板颜色。
【原型】void far setpalette(int colornum,int color)
【位置】graphics.h
【参见】getpalette, graphresult, setallpalette, getpalettesize, setcolor, setrgbcolor, setbkcolor
setrgbcolor
【功能】为VGA和IBM-8514驱动程序设置调色板条目。
【原型】void far setrgbcolor(int colornum,int red,int green,int blue)
【位置】graphics.h
【说明】colornum表示需要设置的调色板条目，red、green和blue用来定义颜色。
【参见】setpalette,setrgbpalette
setrgbpalette
【功能】为IBM-8514图形卡定义颜色
【原型】void far setrgbpalette(int colornum,int red,int green,int blue)
【位置】graphics.h
【说明】colornum表示需要载入的调色板条目，从0～255之间的数字，red、green和blue负责定义颜色。这些数值仅仅使用低位字节，而且只有最重要的6位载入调色板。
【参见】setrgbcolor,setpalette
settextjustify
【功能】设置图形模式下的文本对齐方式。
【原型】void far settextjustify(int horiz,int vert)
【位置】graphics.h
【说明】该函数影响outtext等函数输出的文本，是文本在水平和垂直方向对齐。
settextstyle
【功能】设置当前文本属性。
【原型】void far settextstyle(int font,int direction,int charsize)
【位置】graphics.h
【参见】settextjustify,installuserfont,gettextsettings,graphresult
setusercharsize
【功能】用户为渐入字符自定义的字符放大因子。
【原型】void far setuserchasize(int multix,int divx,int multy,int divy)
【位置】graphics.h
【参见】gettextsettings,graphresult
setviewport
【功能】设置图形输出的当前视口。
【原型】void far setviewport(int left,int top,int right,int bottom,int clip)
【位置】graphics.h
【参见】getviewsettings,graphresult
setvisualpage
【功能】设置可视图形页码。
【原型】void far setvisualpage(int page)
【位置】graphics.h
【说明】有些显示适配器存在多个内存页面，可视页面是真正在屏幕上显示的页面。图形输出函数将输出写入由setactivepage定义的活动页面中。
【参见】setactivepage,graphresult
setwritemode
【功能】设置图形画线模式。
【原型】void far setwritemode(int mode)
【位置】graphics.h
【说明】如果mode为0，则线条覆盖屏幕上当前的内容。如果mode为1，那么线条向素和已经在屏幕上的象素之间执行一个异域操作(XOR)。
【参见】lingto
textheight
【功能】以象素位单位，返回一个字符串的高度。
【原型】int far textheight(char far *textstring)
【位置】graphics.h
【说明】textwidth与图形函数一起使用，例如outtext
【参见】gettextsettings,textwidth,outtext
textwidth
【功能】以象素位单位，返回一个字符串的宽度。
【原型】int far textwidth(char far *textstring)
【位置】graphics.h
【说明】textwidth与图形函数一起使用，例如outtext
【参见】gettextsettings,textheight,outtext
