HMI绘图函数(说明文档).doc

HMI绘图函数说明为了便于用户在HMI上绘制常规图形（直线、圆和多边形等等），特在HMI的宏操作中提供了一组绘图函数，用户可以在宏的MacroEntry函数中调用绘图函数。绘图函数使用的是屏幕直角坐标系：原点在左上角，x轴向右增长，y轴向下增加。一、结构体定义新增加3个结构体：PenParam、BrushParam和Point。1、画笔结构PenParamtypedef struct penparam short type; short width; int color;PenParam;PenParam主要设定画笔的类型、宽度和颜色属性。他们的取值范围见下表：参数名称值说明画笔类型：TypePS_NULL无画笔PS_SOLID平滑直线()PS_DASH 划线()PS_DOT 点线(.)PS_DASHDOT点划线()PS_DASHDOTDOT点点划线()画笔宽度：width18（单位：像素）如果输入的值小于最小值1，系统自动设定为最小值；如果输入的值大于最大值8，系统自动设定为最大值8画笔颜色：color065535建议使用使用宏RGB(r, g, b)设定颜色，其中r、g和b的取值范围是0255。系统会根据HMI的屏的颜色参数将RGB(r, g, b)的值进行转换。2、画刷结构BrushParamtypedef struct brushparam int type; int backColor; int foreColor;BrushParam;BrushParam主要设定画刷的类型，前景色和背景色。画刷类型主要设定画刷使用的填充模式：图形填充和渐变填充。它们的取值范围见下表：参数名称值说明画刷类型：TypeBFS_NOBRUSH不填充BFS_SOLIDBFS_DENSE1BFS_DENSE2BFS_DENSE3BFS_DENSE4BFS_DENSE5BFS_DENSE6BFS_DENSE7BFS_DENSE8BFS_DENSE9BFS_DENSE10BFS_DENSE11BFS_DENSE12BFS_FDIAG1BFS_BDIAG1BFS_FDIAG2BFS_BDIAG2BFS_FDIAG3BFS_BDIAG3BFS_VER1BFS_HOR1BFS_VER2BFS_HOR2BFS_VER3BFS_HOR3BFS_DIAGCROSSBFS_CROSSBFS_HORGRDT_FTTDBFS_HORGRDT_FDTTBFS_HORGRDT_FETC BFS_HORGRDT_FCTEBFS_VERGRDT_FLTRBFS_VERGRDT_FRTLBFS_VERGRDT_FETCBFS_VERGRDT_FCTEBFS_OUPGRDT_FLTTRDBFS_OUPGRDT_FRDTLTBFS_OUPGRDT_FETCBFS_OUPGRDT_FCTEBFS_ODWNGRDT_FRTTLDBFS_ODWNGRDT_FLDTRTBFS_ODWNGRDT_FETCBFS_ODWNGRDT_FCTEBFS_CONGRDT_FLTTRDBFS_CONGRDT_FRTTLDBFS_CONGRDT_FRDTLTBFS_CONGRDT_FLDTRTBFS_CENGRDT_FETCBFS_CENGRDT_FCTE背景色：backColor065535建议使用使用宏RGB(r, g, b)设定颜色，其中r、g和b的取值范围是0255。系统会根据HMI的屏的颜色参数将RGB(r, g, b)的值进行转换。前景色：foreColor065535建议使用使用宏RGB(r, g, b)设定颜色，其中r、g和b的取值范围是0255。系统会根据HMI的屏的颜色参数将RGB(r, g, b)的值进行转换。3、点结构体Point点结构的参数比较简单：x点的x轴坐标；y点的y轴坐标。二、绘图函数1、矩形DrawRect(x, y, w, h, pen, brh)参数说明如下表所示：参数类型说明x整型矩形左上角x轴坐标（单位：像素）y整型矩形左上角y轴坐标（单位：像素）w整型矩形宽度（单位：像素）h整型矩形高度（单位：像素）penPenParam矩形边框画笔brhBrushParam矩形填充画刷2、圆角矩形DrawRndRect(x, y, w, h, radius, pen, brh)参数说明如下表所示：参数类型说明x整型矩形左上角x轴坐标（单位：像素）y整型矩形左上角y轴坐标（单位：像素）w整型矩形宽度（单位：像素）h整型矩形高度（单位：像素）radius整型圆角半径（单位：像素）penPenParam圆角矩形边框画笔brhBrushParam圆角矩形填充画刷3、椭圆DrawEclips(x, y, w, h, pen, brh)参数说明如下表所示：参数类型说明x整型椭圆外框矩形左上角x轴坐标（单位：像素）y整型椭圆外框矩形左上角y轴坐标（单位：像素）w整型椭圆外框矩形宽度（单位：像素）h整型椭圆外框矩形高度（单位：像素）penPenParam椭圆边框画笔brhBrushParam椭圆填充画刷4、直线DrawLine(x1, y1, x2, y2, pen)参数说明如下表所示：参数类型说明x1整型直线起点x轴坐标（单位：像素）y1整型直线起点y轴坐标（单位：像素）x2整型直线终点x轴坐标（单位：像素）y2整型直线终点y轴坐标（单位：像素）penPenParam直线画笔5、多边形DrawPolyg(pts, n, pen, brh)参数说明如下表所示：参数类型说明ptsPoint *多边形的顶点坐标数据的首地址n整型多边形顶点数据penPenParam多边形边框画笔brhBrushParam多边形填充画刷6、圆弧DrawArc(x, y, w, h, start, end, pen)参数说明如下表所示：参数类型说明x整型圆外框矩形左上角x轴坐标（单位：像素）y整型圆外框矩形左上角y轴坐标（单位：像素）w整型圆外框矩形宽度（单位：像素）h整型圆外框矩形高度（单位：像素）start整型扇形起始角度（单位：度）end整型扇形终点角度（单位：度）penPenParam圆边框画笔7、扇形DrawPie(x, y, w, h, start, end, pen, brh)参数说明如下表所示：参数类型说明x整型扇形外框矩形左上角x轴坐标