几何形状绘制的常用接口如下表所示,详细的使用和参数说明请见drawing_canvas.h、drawing_point.h、drawing_rect.h、drawing_path.h、drawing_region.h和drawing_round_rect.h。
| 接口 | 描述 |
|---|---|
| OH_Drawing_Point* OH_Drawing_PointCreate(float x, float y) | 用于创建一个坐标点对象。 |
| OH_Drawing_ErrorCode OH_Drawing_CanvasDrawPoint(OH_Drawing_Canvas *canvas, const OH_Drawing_Point2D *point) | 用于画一个点。 |
| OH_Drawing_Rect* OH_Drawing_RectCreate(float left, float top, float right, float bottom) | 用于创建一个矩形对象。 |
| void OH_Drawing_CanvasDrawArc(OH_Drawing_Canvas *canvas, const OH_Drawing_Rect *rect, float startAngle, float sweepAngle) | 用于画一个圆弧。 |
| void OH_Drawing_CanvasDrawCircle(OH_Drawing_Canvas *canvas, const OH_Drawing_Point *point, float radius) | 用于画一个圆形。 |
| OH_Drawing_Path* OH_Drawing_PathCreate(void) | 用于创建一个路径对象。 |
| void OH_Drawing_CanvasDrawPath(OH_Drawing_Canvas *canvas, const OH_Drawing_Path *path) | 用于画一个自定义路径。 |
| OH_Drawing_Region* OH_Drawing_RegionCreate(void) | 用于创建一个区域对象。 |
| void OH_Drawing_CanvasDrawRegion(OH_Drawing_Canvas *canvas, const OH_Drawing_Region *region) | 用于画一块区域。 |
| void OH_Drawing_CanvasDrawRect(OH_Drawing_Canvas *canvas, const OH_Drawing_Rect *rect) | 用于画一个矩形。 |
| OH_Drawing_RoundRect* OH_Drawing_RoundRectCreate(const OH_Drawing_Rect *rect, float xRad, float yRad) | 用于创建一个圆角矩形对象。 |
| void OH_Drawing_CanvasDrawRoundRect(OH_Drawing_Canvas *canvas, const OH_Drawing_RoundRect *roundRect) | 用于画一个圆角矩形。 |
点只能基于画笔在画布上进行绘制,通过使用OH_Drawing_CanvasDrawPoint()接口绘制点。接口接受两个参数,一个是画布对象Canvas,请确保已创建或获取得到画布Canvas,具体可见画布的获取与绘制结果的显示(C/C++);另一个是要绘制的点的指针。
简单示例如下:
// 创建画笔对象
OH_Drawing_Pen* pen = OH_Drawing_PenCreate();
// 设置画笔颜色
OH_Drawing_PenSetColor(pen, OH_Drawing_ColorSetArgb(RGBA_MAX, RGBA_MAX, RGBA_MIN, RGBA_MIN));
// 设置画笔线宽为40
OH_Drawing_PenSetWidth(pen, 40);
// 设置画布的画笔
OH_Drawing_CanvasAttachPen(canvas, pen);
// 绘制5个点
OH_Drawing_Point2D point1 = {value200_, value200_};
OH_Drawing_CanvasDrawPoint(canvas, &point1);
OH_Drawing_Point2D point2 = {value400_, value400_};
OH_Drawing_CanvasDrawPoint(canvas, &point2);
OH_Drawing_Point2D point3 = {value600_, value600_};
OH_Drawing_CanvasDrawPoint(canvas, &point3);
OH_Drawing_Point2D point4 = {value800_, value800_};
OH_Drawing_CanvasDrawPoint(canvas, &point4);
OH_Drawing_Point2D point5 = {value1000_, value1000_};
OH_Drawing_CanvasDrawPoint(canvas, &point5);
// 去除掉画布中的画笔
OH_Drawing_CanvasDetachPen(canvas);
// 销毁各类对象
OH_Drawing_PenDestroy(pen); 效果如下:

可以使用画笔或画刷在画布上进行圆弧的绘制,通过使用OH_Drawing_CanvasDrawArc()接口绘制圆弧。使用接口需要传入4个参数,分别如下:
需要画布对象Canvas,请确保已创建或获取得到画布Canvas,具体可见画布的获取与绘制结果的显示(C/C++)。
绘制圆弧还需要一个矩形,会以矩形的边为轮廓进行绘制。
需要一个浮点参数,表示弧形的起始角度。
需要另一个浮点参数,表示弧形的扫描角度。
此处以使用画笔绘制圆弧为例,简单示例如下:
// 创建画笔对象 OH_Drawing_Pen* pen = OH_Drawing_PenCreate(); // 设置画笔描边颜色 OH_Drawing_PenSetColor(pen, OH_Drawing_ColorSetArgb(RGBA_MAX, RGBA_MAX, RGBA_MIN, RGBA_MIN)); // 设置画笔线宽为20 OH_Drawing_PenSetWidth(pen, 20); // 设置画布的画笔 OH_Drawing_CanvasAttachPen(canvas, pen); // 创建矩形对象,左上坐标为(100,200)右下坐标为(500,300) OH_Drawing_Rect* rect = OH_Drawing_RectCreate(100, 200, 500, 300); // 基于矩形对象绘制圆弧,起始角度10°,扫描角度200° OH_Drawing_CanvasDrawArc(canvas, rect, 10, 200); // 去除掉画布中的画笔 OH_Drawing_CanvasDetachPen(canvas); // 销毁各类对象 OH_Drawing_PenDestroy(pen); OH_Drawing_RectDestroy(rect);
效果如下:

可以使用画笔或画刷在画布上进行圆的绘制,通过使用OH_Drawing_CanvasDrawCircle()接口绘制圆。使用接口需要传入3个参数,分别如下:
需要画布对象Canvas,请确保已创建或获取得到画布Canvas,具体可见画布的获取与绘制结果的显示(C/C++)。
绘制圆还需要一个指向圆心点对象的指针,会以此点为圆心进行绘制。
最后需要一个浮点参数,表示圆的半径。
此处以使用画笔绘制圆为例,简单示例如下:
// 创建画笔对象 OH_Drawing_Pen* pen = OH_Drawing_PenCreate(); // 设置画笔描边颜色 OH_Drawing_PenSetColor(pen, OH_Drawing_ColorSetArgb(RGBA_MAX, RGBA_MAX, RGBA_MIN, RGBA_MIN)); // 设置画笔线宽为20 OH_Drawing_PenSetWidth(pen, 20); // 设置画布的画笔 OH_Drawing_CanvasAttachPen(canvas, pen); // 创建圆心点 OH_Drawing_Point *point = OH_Drawing_PointCreate(value700_, value700_); // 基于圆心点和半径在画布上绘制圆 OH_Drawing_CanvasDrawCircle(canvas, point, value600_); // 去除掉画布中的画笔 OH_Drawing_CanvasDetachPen(canvas); // 销毁各类对象 OH_Drawing_PenDestroy(pen); OH_Drawing_PointDestroy(point);
效果如下:

可以使用画笔或画刷在画布上进行路径的绘制,路径具体可以用于绘制直线、弧线、贝塞尔曲线等,也可以通过路径组合的方式组成其他复杂的形状。
绘制路径的相关接口和实现如下,详细的使用和参数说明请见drawing_path。常用的接口如下:
使用OH_Drawing_PathCreate()接口可以创建一个路径对象。
使用OH_Drawing_PathMoveTo()接口可以设置自定义路径的起始点位置。
使用OH_Drawing_PathLineTo()接口可以添加一条从起始点或路径的最后点位置(若路径没有内容则默认为(0,0))到目标点位置的线段。
此处以使用画笔和画刷绘制五角星为例,示例如下:
// 创建画笔对象 OH_Drawing_Pen* pen = OH_Drawing_PenCreate(); // 设置画笔描边颜色 OH_Drawing_PenSetColor(pen, OH_Drawing_ColorSetArgb(RGBA_MAX, RGBA_MAX, RGBA_MIN, RGBA_MIN)); // 设置画笔线宽为10 OH_Drawing_PenSetWidth(pen, 10); // 设置 画笔转角样式 OH_Drawing_PenSetJoin(pen, LINE_ROUND_JOIN); // 设置画布中的画笔 OH_Drawing_CanvasAttachPen(canvas, pen); // 创建画刷,此例对闭合路径进行了颜色填充,所以需要使用画刷 OH_Drawing_Brush *brush = OH_Drawing_BrushCreate(); OH_Drawing_BrushSetColor(brush, OH_Drawing_ColorSetArgb(RGBA_MAX, RGBA_MIN, RGBA_MAX, RGBA_MIN)); // 设置画布中的画刷 OH_Drawing_CanvasAttachBrush(canvas, brush); int len = value551_; float aX = value630_; float aY = value551_; float dX = aX - len * std::sin(18.0f); float dY = aY + len * std::cos(18.0f); float cX = aX + len * std::sin(18.0f); float cY = dY; float bX = aX + (len / 2.0); float bY = aY + std::sqrt((cX - dX) * (cX - dX) + (len / 2.0) * (len / 2.0)); float eX = aX - (len / 2.0); float eY = bY; // 创建路径 OH_Drawing_Path* path = OH_Drawing_PathCreate(); // 到起始点 OH_Drawing_PathMoveTo(path, aX, aY); // 绘制直线 OH_Drawing_PathLineTo(path, bX, bY); OH_Drawing_PathLineTo(path, cX, cY); OH_Drawing_PathLineTo(path, dX, dY); OH_Drawing_PathLineTo(path, eX, eY); // 直线闭合,形成五角星 OH_Drawing_PathClose(path); // 绘制闭合路径 OH_Drawing_CanvasDrawPath(canvas, path); // 去除掉画布中的画笔和画刷 OH_Drawing_CanvasDetachPen(canvas); OH_Drawing_CanvasDetachBrush(canvas); // 销毁各类对象 OH_Drawing_PenDestroy(pen); OH_Drawing_BrushDestroy(brush); OH_Drawing_PathDestroy(path);
效果如下:

区域不是一个特定的形状,可以设置为指定的矩形或路径,也可以对两个区域进行组合操作。可以使用画笔或画刷在画布上进行区域的绘制。详细的API说明请参考drawing_region.h。
目前支持设置矩形区域和路径区域,分别通过OH_Drawing_RegionSetRect()接口和OH_Drawing_RegionSetPath()接口来设置。
此处以使用画刷绘制矩形的组合区域为例,示例如下:
// 创建画刷对象 OH_Drawing_Brush* brush = OH_Drawing_BrushCreate(); // 设置画刷填充颜色 OH_Drawing_BrushSetColor(brush, OH_Drawing_ColorSetArgb(RGBA_MAX, RGBA_MAX, RGBA_MIN, RGBA_MIN)); // 设置画布的画刷 OH_Drawing_CanvasAttachBrush(canvas, brush); // 矩形区域1 OH_Drawing_Region *region1 = OH_Drawing_RegionCreate(); OH_Drawing_Rect *rect1 = OH_Drawing_RectCreate(value100_, value100_, value600_, value600_); OH_Drawing_RegionSetRect(region1, rect1); // 矩形区域2 OH_Drawing_Region *region2 = OH_Drawing_RegionCreate(); OH_Drawing_Rect *rect2 = OH_Drawing_RectCreate(value300_, value300_, value900_, value900_); OH_Drawing_RegionSetRect(region2, rect2); // 两个矩形区域组合 OH_Drawing_RegionOp(region1, region2, REGION_OP_MODE_XOR); OH_Drawing_CanvasDrawRegion(canvas, region1); // 去除掉画布中的画刷 OH_Drawing_CanvasDetachBrush(canvas); // 销毁各类对象 OH_Drawing_BrushDestroy(brush); OH_Drawing_RegionDestroy(region1); OH_Drawing_RegionDestroy(region2); OH_Drawing_RectDestroy(rect1); OH_Drawing_RectDestroy(rect2);
效果如下:

可以使用画笔或画刷在画布上进行矩形的绘制。使用OH_Drawing_RectCreate()接口创建矩形。接口需要传入四个浮点数,分别表示矩形的左、上、右、下四个位置的坐标,连接这4个坐标形成一个矩形。
简单示例如下:
// 创建画刷对象 OH_Drawing_Brush *brush = OH_Drawing_BrushCreate(); // 设置画刷的填充颜色 OH_Drawing_BrushSetColor(brush, 0xffff0000); // 设置画布的画刷 OH_Drawing_CanvasAttachBrush(canvas, brush); OH_Drawing_Rect* rect = OH_Drawing_RectCreate(0, 0, value800_, value800_); // 绘制矩形 OH_Drawing_CanvasDrawRect(canvas, rect); // 去除画布中的画刷 OH_Drawing_CanvasDetachBrush(canvas); // 销毁各类对象 OH_Drawing_BrushDestroy(brush); OH_Drawing_RectDestroy(rect);
效果如下:

可以使用画笔或画刷在画布上进行圆角矩形的绘制。使用OH_Drawing_RoundRectCreate()接口创建圆角矩形。接口需要传入3个参数,分别如下:
需要传入指向OH_Drawing_Rect矩形对象的指针,用于在此矩形的基础上切圆角进行绘制。
需要一个浮点参数,表示x轴上的圆角半径。
还需要一个浮点参数,表示y轴上的圆角半径。
简单示例如下:
// 创建画刷对象 OH_Drawing_Brush *brush = OH_Drawing_BrushCreate(); // 设置画刷的填充颜色 OH_Drawing_BrushSetColor(brush, 0xffff0000); // 设置画布的画刷 OH_Drawing_CanvasAttachBrush(canvas, brush); // 创建矩形 OH_Drawing_Rect* rect = OH_Drawing_RectCreate(value100_, value100_, value900_, value600_); // 创建圆角矩形 OH_Drawing_RoundRect* roundRect = OH_Drawing_RoundRectCreate(rect, 30, 30); // 绘制圆角矩形 OH_Drawing_CanvasDrawRoundRect(canvas, roundRect); // 去除掉画布中的画刷 OH_Drawing_CanvasDetachBrush(canvas); // 销毁各类对象 OH_Drawing_BrushDestroy(brush); OH_Drawing_RectDestroy(rect); OH_Drawing_RoundRectDestroy(roundRect);
效果如下:
