创建或获取Canvas画布之后,可以基于画布进一步地进行图形操作和状态处理。画布操作属于可选操作,开发者可以根据场景需要进行。需要先进行画布操作,再进行后续绘制,只有这样画布操作才有效果。
常见的画布操作如下:
裁剪。
矩阵变换,如平移、缩放、旋转等。
状态保存与恢复。
裁剪是图形处理中的常见操作,裁剪针对的是画布本身,可以用于限制绘图区域,只在指定的区域内进行绘制。需要先进行裁剪操作,再进行绘制,才会有对应效果。
当前支持的裁剪操作主要如下:
裁剪矩形。
裁剪圆角矩形。
裁剪自定义路径。
裁剪一个区域。
裁剪操作常用接口如下表所示,详细的使用和参数说明请见drawing_canvas.h。
| 接口 | 描述 |
|---|---|
| void OH_Drawing_CanvasClipRect(OH_Drawing_Canvas *canvas, const OH_Drawing_Rect *rect, OH_Drawing_CanvasClipOp clipOp, bool doAntiAlias) | 用于裁剪一个矩形。 |
| void OH_Drawing_CanvasClipRoundRect(OH_Drawing_Canvas *canvas, const OH_Drawing_RoundRect *roundRect, OH_Drawing_CanvasClipOp clipOp, bool doAntiAlias) | 用于裁剪一个圆角矩形。 |
| void OH_Drawing_CanvasClipPath(OH_Drawing_Canvas *canvas, const OH_Drawing_Path *path, OH_Drawing_CanvasClipOp clipOp, bool doAntiAlias) | 用于裁剪一个自定义路径。 |
| OH_Drawing_ErrorCode OH_Drawing_CanvasClipRegion(OH_Drawing_Canvas *canvas, const OH_Drawing_Region *region, OH_Drawing_CanvasClipOp clipOp) | 用于裁剪一个区域。 |
此处以在画布上裁剪矩形为例给出示例和效果图,其他裁剪操作的逻辑基本相同,注意调用对应的接口并确保要裁剪的数据类型对应准确即可,此处不再一一展开。详细的使用和参数说明请见drawing_canvas.h。
使用OH_Drawing_CanvasClipRect接口裁剪矩形。有以下四个入参:
第一个参数是画布Canvas,裁剪操作将在这个画布上进行。请确保已创建或获取得到画布Canvas,具体可见画布的获取与绘制结果的显示(C/C++)。
第二个参数是要裁剪的矩形区域。
第三个参数是裁剪的操作类型,包括交集(INTERSECT)和差集(DIFFERENCE)。
第四个参数表示是否需要进行抗锯齿处理。
// 创建画刷对象 OH_Drawing_Brush *brush = OH_Drawing_BrushCreate(); // 设置画刷填充颜色为蓝色 OH_Drawing_BrushSetColor(brush, 0xff0000ff); // 在画布中设置画刷 OH_Drawing_CanvasAttachBrush(canvas, brush); OH_Drawing_Rect *rect = OH_Drawing_RectCreate(value400_, value400_, value1200_, value1200_); // 裁剪矩形区域 OH_Drawing_CanvasClipRect(canvas, rect, INTERSECT, true); OH_Drawing_Point *point = OH_Drawing_PointCreate(value600_, value600_); // 绘制圆形 OH_Drawing_CanvasDrawCircle(canvas, point, value600_); // 去除画布中的画刷 OH_Drawing_CanvasDetachBrush(canvas); // 销毁画刷对象并收回其占的内存 OH_Drawing_BrushDestroy(brush); OH_Drawing_PointDestroy(point); OH_Drawing_RectDestroy(rect);
| 原始图 | 裁剪后的图 |
|---|---|
![]() | ![]() |
矩阵变换操作常用接口如下表所示,详细的使用和参数说明请见drawing_canvas.h。
| 接口 | 描述 |
|---|---|
| void OH_Drawing_CanvasTranslate(OH_Drawing_Canvas *canvas, float dx, float dy) | 用于平移画布一段距离。 |
| void OH_Drawing_CanvasScale(OH_Drawing_Canvas *canvas, float sx, float sy) | 用于画布缩放。 |
| void OH_Drawing_CanvasRotate(OH_Drawing_Canvas *canvas, float degrees, float px, float py) | 用于画布旋转一定的角度,正数表示顺时针旋转,负数反之。 |
| void OH_Drawing_CanvasSkew(OH_Drawing_Canvas *canvas, float sx, float sy) | 用于画布倾斜变换。等同于将当前画布矩阵左乘(premultiply)倾斜变换矩阵,并应用到画布上。其中倾斜变换矩阵为:|1 sx 0| |sy 1 0| |0 0 1|。 |
使用OH_Drawing_MatrixCreateTranslation()接口实现画布平移。接口接受2个参数,分别为水平方向和垂直方向的平移量,单位为px。
简单示例和示意图如下所示:
// 创建画刷对象 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); // 创建在水平和垂直方向分别平移300px的矩阵对象 OH_Drawing_Matrix *matrix = OH_Drawing_MatrixCreateTranslation(value300_, value300_); // 对Canvas进行矩阵变换 OH_Drawing_CanvasConcatMatrix(canvas, matrix); // 绘制矩形 OH_Drawing_Rect *rect = OH_Drawing_RectCreate(value200_, value300_, value700_, value600_); OH_Drawing_CanvasDrawRect(canvas, rect); // 去除画布中的画刷 OH_Drawing_CanvasDetachBrush(canvas); OH_Drawing_RectDestroy(rect); OH_Drawing_MatrixDestroy(matrix); OH_Drawing_BrushDestroy(brush);
| 原始图 | 平移后的效果图 |
|---|---|
![]() | ![]() |
使用OH_Drawing_MatrixCreateRotation()接口实现画布旋转,接口接受3个参数,分别为:旋转角度、旋转中心的x坐标和y坐标。
简单示例和示意图如下所示:
// 创建画刷对象 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); // 创建旋转的矩阵对象,三个参数分别是旋转角度和旋转中心坐标 OH_Drawing_Matrix* matrix = OH_Drawing_MatrixCreateRotation(45, value200_, value300_); // 对Canvas进行矩阵变换 OH_Drawing_CanvasConcatMatrix(canvas, matrix); // 绘制矩形 OH_Drawing_Rect *rect = OH_Drawing_RectCreate(value200_, value300_, value700_, value600_); OH_Drawing_CanvasDrawRect(canvas, rect); // 去除画布中的画刷 OH_Drawing_CanvasDetachBrush(canvas); OH_Drawing_RectDestroy(rect); OH_Drawing_MatrixDestroy(matrix); OH_Drawing_BrushDestroy(brush);
| 原始图 | 旋转后的效果图 |
|---|---|
![]() | ![]() |
使用OH_Drawing_MatrixCreateScale()接口进行画布缩放,接口接受4个参数,分别为沿x轴和y轴的缩放因子、缩放中心的x轴和y轴坐标。
简单示例和示意图如下所示:
// 创建画刷对象 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); // 创建缩放的矩阵对象,4个参数分别是水平垂直方向的缩放因子和缩放中心坐标 OH_Drawing_Matrix* matrix = OH_Drawing_MatrixCreateScale(2, 2, value200_, value300_); // 对Canvas进行矩阵变换 OH_Drawing_CanvasConcatMatrix(canvas, matrix); // 绘制矩形 OH_Drawing_Rect *rect = OH_Drawing_RectCreate(value200_, value300_, value700_, value600_); OH_Drawing_CanvasDrawRect(canvas, rect); // 去除画布中的画刷 OH_Drawing_CanvasDetachBrush(canvas); OH_Drawing_RectDestroy(rect); OH_Drawing_MatrixDestroy(matrix); OH_Drawing_BrushDestroy(brush);
| 原始图 | 放大后的效果图 |
|---|---|
![]() | ![]() |
画布状态保存与恢复使用的接口如下表所示,详细的使用和参数说明请见drawing_canvas.h。
| 接口 | 描述 |
|---|---|
| void OH_Drawing_CanvasSave(OH_Drawing_Canvas *canvas) | 用于保存当前画布的状态(画布矩阵)到一个栈顶。 |
| void OH_Drawing_CanvasRestore(OH_Drawing_Canvas *canvas) | 用于恢复保存在栈顶的画布状态(画布矩阵)。 |
| void OH_Drawing_CanvasRestoreToCount(OH_Drawing_Canvas *canvas, uint32_t saveCount) | 用于恢复到指定数量的画布状态(画布矩阵)。 |
// 创建画笔对象 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_CanvasSave(canvas); OH_Drawing_Matrix *matrix = OH_Drawing_MatrixCreateScale(2, 2, 2, 2); // 放大画布 OH_Drawing_CanvasConcatMatrix(canvas, matrix); OH_Drawing_Point* point = OH_Drawing_PointCreate(value300_, value300_); // 绘制圆形,因为执行过放大操作,所以此时绘制的是大圆 OH_Drawing_CanvasDrawCircle(canvas, point, value200_); // 恢复操作,将恢复到没有放大的原始状态 OH_Drawing_CanvasRestore(canvas); // 绘制圆形,因为已经恢复没有放大的原始状态,所以此时绘制的小圆 OH_Drawing_CanvasDrawCircle(canvas, point, value200_); // 去除画布中的画笔 OH_Drawing_CanvasDetachPen(canvas); // 销毁画笔对象并收回其占的内存 OH_Drawing_PenDestroy(pen); OH_Drawing_PointDestroy(point); OH_Drawing_MatrixDestroy(matrix);
