HMI绘图函数说明文档.doc

HMI绘图函数说明 为了便于用户在HMI上绘制常规图形（直线、圆和多边形等等），特在HMI的宏操作中提供了一组绘图函数，用户可以在宏的MacroEntry函数中调用绘图函数。 绘图函数使用的是屏幕直角坐标系：原点在左上角，x轴向右增长，y轴向下增加。 一、结构体定义 新增加3个结构体：PenParam、BrushParam和Point。 1、画笔结构PenParam typedef struct penparam { short type; short width; int color; }PenParam; PenParam主要设定画笔的类型、宽度和颜色属性。他们的取值范围见下表： 参数名称 值 说明 画笔类型：Type PS_NULL 无画笔 PS_SOLID 平滑直线() PS_DASH 划线() PS_DOT 点线(.) PS_DASHDOT 点划线() PS_DASHDOTDOT 点点划线() 画笔宽度：width 1~8（单位：像素） 如果输入的值小于最小值1，系统自动设定为最小值；如果输入的值大于最大值8，系统自动设定为最大值8 画笔颜色：color 0~65535 建议使用使用宏RGB(r, g, b)设定颜色，其中r、g和b的取值范围是0~255。系统会根据HMI的屏的颜色参数将RGB(r, g, b)的值进行转换。 2、画刷结构BrushParam typedef struct brushparam { int type; int backColor; int foreColor; }BrushParam; BrushParam主要设定画刷的类型，前景色和背景色。画刷类型主要设定画刷使用的填充模式：图形填充和渐变填充。它们的取值范围见下表： 参数名称 值 说明 画刷类型：Type BFS_NOBRUSH 不填充 BFS_SOLID BFS_DENSE1 BFS_DENSE2 BFS_DENSE3 BFS_DENSE4 BFS_DENSE5 BFS_DENSE6 BFS_DENSE7 BFS_DENSE8 BFS_DENSE9 BFS_DENSE10 BFS_DENSE11 BFS_DENSE12 BFS_FDIAG1 BFS_BDIAG1 BFS_FDIAG2 BFS_BDIAG2 BFS_FDIAG3 BFS_BDIAG3 BFS_VER1 BFS_HOR1 BFS_VER2 BFS_HOR2 BFS_VER3 BFS_HOR3 BFS_DIAGCROSS BFS_CROSS BFS_HORGRDT_FTTD BFS_HORGRDT_FDTT BFS_HORGRDT_FETC BFS_HORGRDT_FCTE BFS_VERGRDT_FLTR BFS_VERGRDT_FRTL BFS_VERGRDT_FETC BFS_VERGRDT_FCTE BFS_OUPGRDT_FLTTRD BFS_OUPGRDT_FRDTLT BFS_OUPGRDT_FETC BFS_OUPGRDT_FCTE BFS_ODWNGRDT_FRTTLD BFS_ODWNGRDT_FLDTRT BFS_ODWNGRDT_FETC BFS_ODWNGRDT_FCTE BFS_CONGRDT_FLTTRD BFS_CONGRDT_FRTTLD BFS_CONGRDT_FRDTLT BFS_CONGRDT_FLDTRT BFS_CENGRDT_FETC BFS_CENGRDT_FCTE 背景色：backColor 0~65535 建议使用使用宏RGB(r, g, b)设定颜色，其中r、g和b的取值范围是0~255。系统会根据HMI的屏的颜色参数将RGB(r, g, b)的值进行转换。 前景色：foreColor 0~65535 建议使用使用宏RGB(r, g, b)设定颜色，其中r、g和b的取值范围是0~255。系统会根据HMI的屏的颜色参数将RGB(r, g, b)的值进行转换。 3、点结构体Point 点结构的参数比较简单：x——点的x轴坐标；y——点的y轴坐标。 二、绘图函数 1、矩形DrawRect(x, y, w, h, pen, brh) 参数说明如下表所示： 参数 类型 说明 x 整型 矩