2024年4月30日发(作者：)

EasyX指导手册

制作人：jianxiawzx

一、基本概念

1.1颜色

EasyX使用24bit真彩色，不再支持调色板模式。

表示颜色有以下几种办法：

1.用预定义颜色常量，如下：

常量

BLACK

BLUE

GREEN

CYAN

RED

MAGENTA

BROWN

0

0xA80000

0x00A800

0xA8A800

0x0000A8

0xA800A8

0x0054A8

值 颜色

黑

蓝

绿

青

红

紫

棕

常量

DARKGRAY

LIGHTBLUE

LIGHTGREEN

LIGHTCYAN

LIGHTRED

值

0x545454

0xFC5454

0x54FC54

0xFCFC54

0x5454FC

颜色

深灰

亮蓝

亮绿

亮青

亮红

亮紫

黄

白

LIGHTMAGENTA 0xFC54FC

YELLOW 0x54FCFC

0xFCFCFC LIGHTGRAY 0xA8A8A8 浅灰 WHITE

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);