《EasyX帮助文档》由会员分享，可在线阅读，更多相关《EasyX帮助文档（51页珍藏版）》请在金锄头文库上搜索。
1、EasyX指导手册制作人：jianxiawzx一、基本概念1.1 颜色EasyX 使用 24bit 真彩色，不再支持调色板模式。表示颜色有以下几种办法：1. 用预定义颜色常量，如下：常量值颜色常量值颜色BLACK0黑DARKGRAY0x545454深灰BLUE0xA80000蓝LIGHTBLUE0xFC5454亮蓝GREEN0x00A800绿LIGHTGREEN0x54FC54亮绿CYAN0xA8A800青LIGHTCYAN0xFCFC54亮青RED0x0000A8红LIGHTRED0x5454FC亮红MAGENTA0xA800A8紫LIGHTMAGENTA0xFC54FC亮紫BROWN0x0
2、054A8棕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 坐标在 Easy
3、X 中，坐标分两种：逻辑坐标和物理坐标。逻辑坐标逻辑坐标是在程序中用于绘图的坐标体系。坐标默认的原点在屏幕的左上角，X 轴向右为正，Y 轴向下为正，度量单位是象素。坐标原点可以通过 setorigin() 函数修改；坐标轴方向可以通过 setaspectratio() 函数修改；缩放比例可以通过 setaspectratio() 函数修改。在本手册中，凡是没有注明的坐标，均指逻辑坐标。物理坐标物理坐标是描述设备的坐标体系。坐标原点在屏幕的左上角，X 轴向右为正，Y 轴向下为正，度量单位是象素。坐标原点、坐标轴方向、缩放比例都不能改变。1.3 设备所谓“设备”，简单来说，就是绘图表面。在 Eas
4、yX 中，设备分两种，一种是默认的绘图窗口，另一种是 IMAGE 对象。通过 SetWorkingImage() 函数可以设置当前用于绘图的设备。设置当前用于绘图的设备后，所有的绘图函数都会绘制在该设备上。二、绘图函数2.1 绘图环境相关函数相关函数和数据如下：函数或数据描述cleardevice清除屏幕内容。initgraph初始化绘图窗口。closegraph关闭图形窗口。getaspectratio获取当前缩放因子。setaspectratio设置当前缩放因子。graphdefaults恢复绘图环境为默认值。setorigin设置坐标原点。setcliprgn设置当前绘图设备的裁剪区。c
5、learcliprgn清除裁剪区的屏幕内容。GetHWnd获取绘图窗口句柄。2.1.1 clearcliprgn这个函数用于清空裁剪区的屏幕内容。void clearcliprgn();2.1.2 cleardevice这个函数用于清除屏幕内容。具体的，是用当前背景色清空屏幕，并将当前点移至 (0, 0)。void cleardevice();2.1.3 closegraph这个函数用于关闭图形环境。void closegraph();2.1.4 getaspectratio这个函数用于获取当前缩放因子。void getaspectratio(float *pxasp,float *pyasp
6、);参数：pxasp返回 x 方向上的缩放因子。pyasp返回 y 方向上的缩放因子。2.1.5 GetHWnd这个函数用于获取绘图窗口句柄。HWND GetHWnd();在 Windows 下，句柄是一个窗口的标识，得到句柄后，可以使用 Windows SDK 中的各种命令实现对窗口的控制。示例：/ 获得窗口句柄HWND hWnd = GetHWnd();/ 使用 API 函数修改窗口名称SetWindowText(hWnd, Hello!);2.1.6 graphdefaults这个函数用于重置视图、当前点、绘图色、背景色、线形、填充类型、字体为默认值。void graphdefaults
7、();2.1.7initgraph这个函数用于初始化绘图环境。HWND initgraph(int Width,int Height,int Flag = NULL);参数：Width绘图环境的宽度。Height绘图环境的高度。Style绘图环境的样式，默认为 NULL。可为以下值：值含义SHOWCONSOLE表示可以保留原控制台窗口。2.1.8 setaspectratio这个函数用于设置当前缩放因子。void setaspectratio(float xasp,float yasp);参数：Xasp x 方向上的缩放因子。例如绘制宽度为 100 的矩形，实际的绘制宽度为 100 * xas
8、p。Yasp y 方向上的缩放因子。例如绘制高度为 100 的矩形，实际的绘制高度为 100 * yasp。说明：如果缩放因子为负，可以实现坐标轴的翻转。例如，执行 setaspectratio(1, -1); 后，可使 y 轴向上为正。2.1.9 setcliprgn这个函数用于设置当前绘图设备的裁剪区。void setcliprgn(HRGN hrgn);参数：hrgn区域的句柄。创建区域所使用的坐标为物理坐标。如果该值为 NULL，表示取消之前设置的裁剪区。说明：HRGN 是 Windows 定义的表示区域的句柄。将该区域设置为裁剪区后，任何区域外的绘图都将无效（但仍然可以通过操作显存在
9、裁剪区外绘图）。可以使用 Windows GDI 函数创建一个区域。例如，创建矩形区域可以使用函数：HRGN CreateRectRgn(int left, int top, int right, int bottom);此外，还可以使用函数 CreateEllipticRgn 创建椭圆形的区域，使用 CreatePolygonRgn 创建多边形的区域等等。还可以使用 CombineRgn 组合区域。更多关于区域的 GDI 函数，请参考 MSDN 中的 Region Functions。注意：创建区域后，如果不再使用，请执行 DeleteObject(HRGN hrgn) 以释放该区域对应的系
10、统资源。示例：以下代码用于创建一个矩形裁剪区，并在该裁剪区内画圆，请观察裁剪效果：#include #include void main() / 初始化绘图窗口 initgraph(640, 480); / 创建一个矩形区域 HRGN rgn = CreateRectRgn(100, 100, 200, 200); / 将该矩形区域设置为裁剪区 setcliprgn(rgn); / 不再使用 rgn，清理 rgn 占用的系统资源 DeleteObject(rgn); / 画圆，受裁剪区影响，只显示出四段圆弧 circle(150, 150, 55); / 取消之前设置的裁剪区 setclipr
11、gn(NULL); / 画圆，不再受裁剪区影响，显示出一个完整的圆 circle(150, 150, 60); / 按任意键退出 getch(); closegraph();2.1.10setorigin这个函数用于设置坐标原点。void setorigin(int x, int y);x原点的 x 坐标（使用物理坐标）。y原点的 y 坐标（使用物理坐标）。2.2 颜色表示及相关函数2.2.1 相关函数和数据如下：函数或数据描述getbkcolor获取当前绘图背景色。getcolor获取当前绘图前景色GetBValue返回指定颜色中的蓝色值。GetGValue返回指定颜色中的绿色值。GetRV
12、alue返回指定颜色中的红色值。HSLtoRGB转换 HSL 颜色为 RGB 颜色。HSVtoRGB转换 HSV 颜色为 RGB 颜色。RGB通过红、绿、蓝颜色分量合成颜色。RGBtoGRAY转换 RGB 颜色为 灰度颜色。RGBtoHSL转换 RGB 颜色为 HSL 颜色。RGBtoHSV转换 RGB 颜色为 HSV 颜色。setbkcolor设置当前绘图背景色。setcolor设置当前绘图前景色。BGR交换颜色中的红色和蓝色。2.2.2 BGRBGR 宏用于交换颜色中的红色和蓝色。COLORREF BGR(COLORREF color);参数：color需要交换红色和蓝色的颜色。返回值：返
13、回交换红色和蓝色后的颜色。说明：颜色在内存中的表示形式为：0xbbggrr (bb=蓝，gg=绿，rr=红)，但是显存中的颜色表现形式为 0xrrggbb。注意，两者的红色和蓝色是相反的。直接操作显存时，可以通过 BGR 宏交换颜色的红色和蓝色部分。2.2.3 getbkcolor这个函数用于获取当前绘图背景色。COLORREF getbkcolor();2.2.4 GetBValueGetBValue 宏用于返回指定颜色中的蓝色值。BYTE GetBValue(COLORREF rgb);参数：rgb指定的颜色。返回值：指定颜色中的蓝色值，值的范围 0255。说明：GetBValue 宏在
14、Windows SDK 中定义。2.2.5 getcolor这个函数用于获取当前绘图前景色COLORREF getcolor();2.2.6 GetGValueGetGValue 宏用于返回指定颜色中的绿色值。BYTE GetGValue(COLORREF rgb);参数：rgb指定的颜色。返回值：指定颜色中的绿色值，值的范围 0255。说明：GetGValue 宏在 Windows SDK 中定义。2.2.7 GetRValueGetRValue 宏用于返回指定颜色中的红色值。BYTE GetRValue(COLORREF rgb);参数：rgb指定的颜色。返回值：指定颜色中的红色值，值的范围 0255。说明：GetRValue 宏在 Windows SDK 中定义。2.2.8 HSLtoRGB该函数用于转换 HSL 颜色为 RGB 颜色。COLORREF HSLtoRGB(float H,float S,float L);参数：H原 HSL 颜色模型
