EasyX指导手册..docxVIP

EasyX指导手册制作人：jianxiawzx一、基本概念1.1颜色EasyX使用24bit真彩色，不再支持调色板模式。表示颜色有以下几种办法：1.用预定义颜色常量，如下：常量值颜色常量值颜色BLACK0黑DARKGRAY0x545454深灰BLUE0xA80000蓝LIGHTBLUE0xFC5454亮蓝GREEN0x00A800绿LIGHTGREEN0x54FC54亮绿CYAN0xA8A800青LIGHTCYAN0xFCFC54亮青RED0x0000A8红LIGHTRED0x5454FC亮红MAGENTA0xA800A8紫LIGHTMAGENTA0xFC54FC亮紫BROWN0x0054A8棕YELLOW0x54FCFC黄LIGHTGRAY0xA8A8A8浅灰WHITE0xFCFCFC白2.用16进制的颜色表示，形式为：0xbbggrr(bb=蓝，gg=绿，rr=红)3.用RGB宏合成颜色。详见RGB。4.用HSLtoRGB、HSVtoRGB转换其他色彩模型到RGB颜色。详见HSLtoRGB、HSVtoRGB。示例：以下是部分设置前景色的方法：setcolor(0xff0000);setcolor(BLUE);setcolor(RGB(0,0,255));setcolor(HSLtoRGB(240,1,0.5));1.2坐标在EasyX中，坐标分两种：逻辑坐标和物理坐标。逻辑坐标逻辑坐标是在程序中用于绘图的坐标体系。坐标默认的原点在屏幕的左上角，X轴向右为正，Y轴向下为正，度量单位是象素。坐标原点可以通过setorigin()函数修改；坐标轴方向可以通过setaspectratio()函数修改；缩放比例可以通过setaspectratio()函数修改。在本手册中，凡是没有注明的坐标，均指逻辑坐标。物理坐标物理坐标是描述设备的坐标体系。坐标原点在屏幕的左上角，X轴向右为正，Y轴向下为正，度量单位是象素。坐标原点、坐标轴方向、缩放比例都不能改变。1.3设备所谓“设备”，简单来说，就是绘图表面。在EasyX中，设备分两种，一种是默认的绘图窗口，另一种是IMAGE对象。通过SetWorkingImage()函数可以设置当前用于绘图的设备。设置当前用于绘图的设备后，所有的绘图函数都会绘制在该设备上。二、绘图函2.1.1clearcliprgn这个函数用于清空裁剪区的屏幕内容。voidclearcliprgn();2.1.2cleardevice这个函数用于清除屏幕内容。具体的，是用当前背景色清空屏幕，并将当前点移至(0,0)。voidcleardevice();2.1.3closegraph这个函数用于关闭图形环境。voidclosegraph();2.1.4getaspectratio这个函数用于获取当前缩放因子。voidgetaspectratio(float*pxasp,float*pyasp);参数：pxasp返回x方向上的缩放因子。pyasp返回y方向上的缩放因子。2.1.5GetHWnd这个函数用于获取绘图窗口句柄。HWNDGetHWnd();在Windows下，句柄是一个窗口的标识，得到句柄后，可以使用WindowsSDK中的各种命令实现对窗口的控制。示例：//获得窗口句柄HWNDhWnd=GetHWnd();//使用API函数修改窗口名称SetWindowText(hWnd,Hello!);2.1.6graphdefaults这个函数用于重置视图、当前点、绘图色、背景色、线形、填充类型、字体为默认值。voidgraphdefaults();2.1.7initgraph这个函数用于初始化绘图环境。HWNDinitgraph(intWidth,intHeight,intFlag=NULL);参数：Width绘图环境的宽度。Height绘图环境的高度。Style绘图环境的样式，默认为NULL。可为以下值：值含义SHOWCONSOLE表示可以保留原控制台窗口。2.1.8setaspectratio这个函数用于设置当前缩放因子。voidsetaspectratio(floatxasp,floatyasp);参数：Xaspx方向上的缩放因子。例如绘制宽度为100的矩形，实际的绘制宽度为100*xasp。Yaspy方向上的缩放因子。例如绘制高度为100的矩形，实际的绘制高度为100*yasp。说明：如果缩放因子为负，可以实现坐标轴的翻转。例如，执行setaspectratio(1,-1);后，可使y轴向上为正。2.1.9setcliprgn这个函数用于设置当前绘图设备的裁剪区。voidsetcliprgn(HRGNhrgn);参数：hrgn区域的句柄。创建区域所使用的坐标为物理坐标。如果该值为NULL，表示取消之前设置的裁剪区