接口	描述
OH_Drawing_Brush* OH_Drawing_BrushCreate(void)	用于创建一个画刷对象。
void OH_Drawing_CanvasAttachBrush(OH_Drawing_Canvas* canvas, const OH_Drawing_Brush* brush)	用于设置画刷给画布，画布将使用设置的画刷样式和颜色填充绘制的图形形状。
void OH_Drawing_BrushSetColor(OH_Drawing_Brush* brush, uint32_t color)	用于设置画刷的颜色属性，颜色属性描述了画刷填充图形时使用的颜色，用一个32位（ARGB）的变量表示。
void OH_Drawing_BrushSetAntiAlias(OH_Drawing_Brush* brush, bool antiAlias)	用于设置画刷的抗锯齿属性，设置为true则画刷在绘制图形时会对图形的边缘像素进行半透明的模糊处理，以使图形边缘更加平滑。
void OH_Drawing_CanvasDetachBrush(OH_Drawing_Canvas* canvas)	用于去除画布中的画刷，执行后画布将不使用此前设置的画刷，恢复到默认的填充效果。
void OH_Drawing_BrushDestroy(OH_Drawing_Brush* brush)	用于销毁画刷对象并回收该对象占用的内存。

开发步骤

使用OH_Drawing_BrushCreate()接口创建画刷Brush对象。
收起
自动换行
深色代码主题
复制
```
// 创建画刷
OH_Drawing_Brush* brush = OH_Drawing_BrushCreate();
```
sample_graphics.cpp
使用画刷设置基础绘制效果（可选以下的一个或者多个效果）。
- 可使用OH_Drawing_BrushSetColor()接口设置填充颜色。
  收起
  自动换行
  深色代码主题
  复制
  // 设置填充颜色为红色
  uint32_t color = 0xffff0000;
  OH_Drawing_BrushSetColor(brush, color);
  sample_graphics.cpp
  color是一个32位（ARGB）的变量，例如0xffff0000。
- 可使用OH_Drawing_BrushSetAntiAlias()接口开启抗锯齿效果，以使图形边缘更加平滑。
  收起
  自动换行
  深色代码主题
  复制
  // 开启抗锯齿效果
  OH_Drawing_BrushSetAntiAlias(brush, true);
  sample_graphics.cpp
使用OH_Drawing_CanvasAttachBrush()接口给Canvas画布设置画刷。接口接受两个参数，一个是画布对象Canvas，请确保已创建或获取得到画布Canvas，具体可见画布的获取与绘制结果的显示（C/C++）；另一个是要设置的画刷对象。画布将会使用设置的画刷样式和颜色等填充图形。
收起
自动换行
深色代码主题
复制
```
// 设置画布的画刷
OH_Drawing_CanvasAttachBrush(canvas, brush);
```
sample_graphics.cpp
按需绘制图元，具体可见图元绘制一节。
当不需要填充效果时，可以使用OH_Drawing_CanvasDetachBrush()去除。入参为画布对象Canvas。
收起
自动换行
深色代码主题
复制
```
// 去除画布中的画刷
OH_Drawing_CanvasDetachBrush(canvas);
```
sample_graphics.cpp
当不再需要画刷进行效果填充时，请及时使用OH_Drawing_BrushDestroy()接口销毁Brush对象。
收起
自动换行
深色代码主题
复制
```
// 销毁各类对象
OH_Drawing_BrushDestroy(brush);
```
sample_graphics.cpp

描边效果

可以通过画笔设置基础的描边颜色，还可以通过画笔使用混合模式、路径效果、着色器效果、滤波器效果等实现更多复杂绘制效果，具体可见复杂绘制效果。

接口说明

使用画笔（Pen）设置绘制效果的常用接口如下表所示，详细的使用和参数请见drawing_pen和drawing_canvas。

展开

接口	描述
OH_Drawing_Pen* OH_Drawing_PenCreate(void)	用于创建一个画笔对象。
void OH_Drawing_CanvasAttachPen(OH_Drawing_Canvas* canvas, const OH_Drawing_Pen* pen)	用于设置画笔给画布，画布将会使用设置画笔的样式和颜色去绘制图形形状的轮廓。
void OH_Drawing_PenSetColor(OH_Drawing_Pen* pen, uint32_t color)	用于设置画笔的颜色属性，颜色属性描述了画笔绘制图形轮廓时使用的颜色，用一个32位（ARGB）的变量表示。
void OH_Drawing_PenSetWidth(OH_Drawing_Pen* pen, float width)	用于设置画笔的线宽。0线宽被视作特殊的极细线宽，在绘制时始终会被绘制为1像素，不随画布的缩放而改变；负数线宽在实际绘制时会被视作0线宽。
void OH_Drawing_PenSetAntiAlias(OH_Drawing_Pen* pen, bool antiAlias)	用于设置画笔的抗锯齿属性，设置为true则画笔在绘制图形时会对图形的边缘像素进行半透明的模糊处理。
void OH_Drawing_PenSetCap(OH_Drawing_Pen* pen, OH_Drawing_PenLineCapStyle capStyle)	用于设置画笔线帽样式。
void OH_Drawing_PenSetJoin(OH_Drawing_Pen* pen, OH_Drawing_PenLineJoinStyle joinStyle)	用于设置画笔绘制转角的样式。
void OH_Drawing_CanvasDetachPen(OH_Drawing_Canvas* canvas)	用于去除画布中的画笔，执行后画布将不去绘制图形形状的轮廓，恢复到默认的描边效果。
void OH_Drawing_PenDestroy(OH_Drawing_Pen* pen)	用于销毁画笔对象并回收该对象占用的内存。

开发步骤

使用OH_Drawing_PenCreate()接口创建画笔Pen对象。
收起
自动换行
深色代码主题
复制
```
// 创建画笔
OH_Drawing_Pen* pen = OH_Drawing_PenCreate();
```
sample_graphics.cpp

使用画笔设置具体的描边效果（可选以下的一个或者多个效果）。

可使用OH_Drawing_PenSetColor()接口设置画笔颜色，对应为绘制图形轮廓时使用的颜色。
收起
自动换行
深色代码主题
复制
```
// 设置画笔颜色为红色
uint32_t color = 0xffff0000;
OH_Drawing_PenSetColor(pen, color);
```
sample_graphics.cpp
color是一个32位（ARGB）的变量，例如0xffff0000。
可使用OH_Drawing_PenSetWidth()接口设置画笔的线宽。
收起
自动换行
深色代码主题
复制
```
// 设置画笔的线宽为50像素
float width = 50.0;
OH_Drawing_PenSetWidth(pen, width);
```
sample_graphics.cpp
width表示线宽的像素值。
可使用OH_Drawing_PenSetAntiAlias()接口设置画笔抗锯齿，以使图形绘制边缘更平滑。
收起
自动换行
深色代码主题
复制
```
// 设置画笔抗锯齿
OH_Drawing_PenSetAntiAlias(pen, true);
```
sample_graphics.cpp

可使用OH_Drawing_PenSetCap()接口设置画笔线帽样式。

收起
自动换行
深色代码主题
复制

// 设置画笔线帽样式
OH_Drawing_PenSetCap(pen, LINE_ROUND_CAP);

sample_graphics.cpp

OH_Drawing_PenLineCapStyle线帽样式可选分类对应如下：

展开

线帽样式	说明	示意图
LINE_FLAT_CAP	没有线帽样式，线条头尾端点处横切。
LINE_SQUARE_CAP	线帽的样式为方框，线条的头尾端点处多出一个方框，方框宽度和线段一样宽，高度是线段宽度的一半。
LINE_ROUND_CAP	线帽的样式为圆弧，线条的头尾端点处多出一个半圆弧，半圆的直径与线段宽度一致。

可使用OH_Drawing_PenSetJoin()接口设置画笔转角样式。

收起
自动换行
深色代码主题
复制

// 设置画笔转角样式
OH_Drawing_PenSetJoin(pen, LINE_BEVEL_JOIN);

sample_graphics.cpp

OH_Drawing_PenLineJoinStyle转角样式可选分类对应如下：

展开

转角样式	说明	示意图
LINE_MITER_JOIN	转角类型为尖角
LINE_ROUND_JOIN	转角类型为圆角
LINE_BEVEL_JOIN	转角类型为平角

使用OH_Drawing_CanvasAttachPen()接口给Canvas画布设置画笔。接口接受两个参数，一个是画布对象Canvas，请确保已创建或获取得到画布Canvas，具体可见画布的获取与绘制结果的显示（C/C++）；另一个是要设置的画笔对象。画布将会使用设置的画笔样式和颜色等绘制图形轮廓。
收起
自动换行
深色代码主题
复制
```
// 设置画布的画笔
OH_Drawing_CanvasAttachPen(canvas, pen);
```
sample_graphics.cpp
按需绘制图元，具体可见图元绘制一节。
当不需要描边效果时，可以使用OH_Drawing_CanvasDetachPen()去除。入参为画布对象Canvas，请确保已创建或获取得到画布Canvas，具体可见画布的获取与绘制结果的显示（C/C++）。
收起
自动换行
深色代码主题
复制
```
// 去除掉画布中的画笔
OH_Drawing_CanvasDetachPen(canvas);
```
sample_graphics.cpp
当不再需要画笔进行描边时，请及时使用OH_Drawing_PenDestroy()接口销毁Pen对象。
收起
自动换行
深色代码主题
复制
```
// 销毁各类对象
OH_Drawing_PenDestroy(pen);
```
sample_graphics.cpp

示例代码

图形绘制（C/C++）

复杂绘制效果（ArkTS）

复杂绘制效果（C/C++）

意见反馈

以上内容对您是否有帮助？

意见反馈

如果您有其他疑问，您也可以通过开发者社区问答频道来和我们联系探讨。

社区提问智能客服提问