HarmonyOS API：Drawing

版本：v3.1 Beta

Drawing

OH_Drawing_BrushSetColor()

void OH_Drawing_BrushSetColor (OH_Drawing_Brush * , uint32_t color )

描述：

函数用于设置画刷的颜色属性，颜色属性描述了画刷填充图形时使用的颜色，用一个32位（ARGB）的变量表示

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_CanvasAttachBrush()

void OH_Drawing_CanvasAttachBrush (OH_Drawing_Canvas * , const OH_Drawing_Brush *  )

描述：

函数用于设置画刷给画布，画布将会使用设置的画刷样式和颜色去填充绘制的图形形状

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_CanvasAttachPen()

void OH_Drawing_CanvasAttachPen (OH_Drawing_Canvas * , const OH_Drawing_Pen *  )

描述：

函数用于设置画笔给画布，画布将会使用设置画笔的样式和颜色去绘制图形形状的轮廓

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_CanvasBind()

void OH_Drawing_CanvasBind (OH_Drawing_Canvas * , OH_Drawing_Bitmap *  )

描述：

函数用于将一个位图对象绑定到画布中，使得画布绘制的内容输出到位图中（即CPU渲染）

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_CanvasClear()

void OH_Drawing_CanvasClear (OH_Drawing_Canvas * , uint32_t color )

描述：

函数用于使用指定颜色去清空画布

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_CanvasCreate()

OH_Drawing_Canvas* OH_Drawing_CanvasCreate (void )

描述：

函数用于创建一个画布对象

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

返回：

函数会返回一个指针，指针指向创建的画布对象

起始版本：

8

OH_Drawing_CanvasDestroy()

void OH_Drawing_CanvasDestroy (OH_Drawing_Canvas * )

描述：

函数用于销毁画布对象并回收该对象占有的内存

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_CanvasDetachBrush()

void OH_Drawing_CanvasDetachBrush (OH_Drawing_Canvas * )

描述：

函数用于去除掉画布中的画刷，使用后画布将不去填充图形形状

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_CanvasDetachPen()

void OH_Drawing_CanvasDetachPen (OH_Drawing_Canvas * )

描述：

函数用于去除掉画布中的画笔，使用后画布将不去绘制图形形状的轮廓

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_CanvasDrawLine()

void OH_Drawing_CanvasDrawLine (OH_Drawing_Canvas * , float x1, float y1, float x2, float y2 )

描述：

函数用于画一条直线段

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_CanvasDrawPath()

void OH_Drawing_CanvasDrawPath (OH_Drawing_Canvas * , const OH_Drawing_Path *  )

描述：

函数用于画一个自定义路径

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_CanvasRestore()

void OH_Drawing_CanvasRestore (OH_Drawing_Canvas * )

描述：

函数用于恢复保存在栈顶的画布状态（画布矩阵）

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_CanvasSave()

void OH_Drawing_CanvasSave (OH_Drawing_Canvas * )

描述：

函数用于保存当前画布的状态（画布矩阵）到一个栈顶

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_ColorSetArgb()

uint32_t OH_Drawing_ColorSetArgb (uint32_t alpha, uint32_t red, uint32_t green, uint32_t blue )

描述：

函数用于将4个变量（分别描述透明度、红色、绿色和蓝色）转化为一个描述颜色的32位（ARGB）变量

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

返回：

函数返回一个描述颜色的32位（ARGB）变量

起始版本：

8

OH_Drawing_CreateFontCollection()

OH_Drawing_FontCollection* OH_Drawing_CreateFontCollection (void )

描述：

创建OH_Drawing_FontCollection

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

返回：

指向创建的OH_Drawing_FontCollection对象的指针

起始版本：

8

OH_Drawing_CreateTextStyle()

OH_Drawing_TextStyle* OH_Drawing_CreateTextStyle (void )

描述：

创建OH_Drawing_TextStyle

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

返回：

指向创建的OH_Drawing_TextStyle对象的指针

起始版本：

8

OH_Drawing_CreateTypography()

OH_Drawing_Typography* OH_Drawing_CreateTypography (OH_Drawing_TypographyCreate * )

描述：

创建OH_Drawing_Typography

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

返回：

指向OH_Drawing_Typography对象的指针

起始版本：

8

OH_Drawing_CreateTypographyHandler()

OH_Drawing_TypographyCreate* OH_Drawing_CreateTypographyHandler (OH_Drawing_TypographyStyle * , OH_Drawing_FontCollection *  )

描述：

创建指向OH_Drawing_TypographyCreate对象的指针

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

返回：

指向新创建的OH_Drawing_TypographyCreate对象的指针

起始版本：

8

OH_Drawing_CreateTypographyStyle()

OH_Drawing_TypographyStyle* OH_Drawing_CreateTypographyStyle (void )

描述：

创建OH_Drawing_TypographyStyle

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

返回：

指向创建的OH_Drawing_TypographyStyle对象的指针

起始版本：

8

OH_Drawing_DestroyFontCollection()

void OH_Drawing_DestroyFontCollection (OH_Drawing_FontCollection * )

描述：

释放被OH_Drawing_FontCollection对象占据的内存

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_DestroyTextStyle()

void OH_Drawing_DestroyTextStyle (OH_Drawing_TextStyle * )

描述：

释放被OH_Drawing_TextStyle对象占据的内存

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_DestroyTypography()

void OH_Drawing_DestroyTypography (OH_Drawing_Typography * )

描述：

释放OH_Drawing_Typography对象占据的内存

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_DestroyTypographyHandler()

void OH_Drawing_DestroyTypographyHandler (OH_Drawing_TypographyCreate * )

描述：

释放被OH_Drawing_TypographyCreate对象占据的内存

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_DestroyTypographyStyle()

void OH_Drawing_DestroyTypographyStyle (OH_Drawing_TypographyStyle * )

描述：

释放被OH_Drawing_TypographyStyle对象占据的内存

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_PathArcTo()

void OH_Drawing_PathArcTo (OH_Drawing_Path * , float x1, float y1, float x2, float y2, float startDeg, float sweepDeg )

描述：

函数用于给路径添加一段弧线，绘制弧线的方式为角度弧，该方式首先会指定一个矩形边框，矩形边框会包裹椭圆， 然后会指定一个起始角度和扫描度数，从起始角度扫描截取的椭圆周长一部分即为绘制的弧线。另外会默认添加一条从路径的最后点位置到弧线起始点位置的线段

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_PathClose()

void OH_Drawing_PathClose (OH_Drawing_Path * )

描述：

函数用于闭合路径，会添加一条从路径起点位置到最后点位置的线段

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_PathCreate()

OH_Drawing_Path* OH_Drawing_PathCreate (void )

描述：

函数用于创建一个路径对象

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

返回：

函数会返回一个指针，指针指向创建的路径对象

起始版本：

8

OH_Drawing_PathCubicTo()

void OH_Drawing_PathCubicTo (OH_Drawing_Path * , float ctrlX1, float ctrlY1, float ctrlX2, float ctrlY2, float endX, float endY )

描述：

函数用于添加一条从路径最后点位置到目标点位置的三阶贝塞尔圆滑曲线

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_PathDestroy()

void OH_Drawing_PathDestroy (OH_Drawing_Path * )

描述：

函数用于销毁路径对象并回收该对象占有的内存

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_PathLineTo()

void OH_Drawing_PathLineTo (OH_Drawing_Path * , float x, float y )

描述：

函数用于添加一条从路径的最后点位置到目标点位置的线段

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_PathMoveTo()

void OH_Drawing_PathMoveTo (OH_Drawing_Path * , float x, float y )

描述：

函数用于设置自定义路径的起始点位置

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_PathQuadTo()

void OH_Drawing_PathQuadTo (OH_Drawing_Path * , float ctrlX, float ctrlY, float endX, float endY )

描述：

函数用于添加一条从路径最后点位置到目标点位置的二阶贝塞尔圆滑曲线

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_PathReset()

void OH_Drawing_PathReset (OH_Drawing_Path * )

描述：

函数用于重置自定义路径数据

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_PenCreate()

OH_Drawing_Pen* OH_Drawing_PenCreate (void )

描述：

函数用于创建一个画笔对象

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

返回：

函数会返回一个指针，指针指向创建的画笔对象

起始版本：

8

OH_Drawing_PenDestroy()

void OH_Drawing_PenDestroy (OH_Drawing_Pen * )

描述：

函数用于销毁画笔对象并回收该对象占有的内存

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_PenGetCap()

OH_Drawing_PenLineCapStyle OH_Drawing_PenGetCap (const OH_Drawing_Pen * )

描述：

函数用于获取画笔笔帽的样式

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

返回：

函数返回画笔笔帽样式

起始版本：

8

OH_Drawing_PenGetColor()

uint32_t OH_Drawing_PenGetColor (const OH_Drawing_Pen * )

描述：

函数用于获取画笔的颜色属性，颜色属性描述了画笔绘制图形轮廓时使用的颜色，用一个32位（ARGB）的变量表示

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

返回：

函数返回一个描述颜色的32位（ARGB）变量

起始版本：

8

OH_Drawing_PenGetJoin()

OH_Drawing_PenLineJoinStyle OH_Drawing_PenGetJoin (const OH_Drawing_Pen * )

描述：

函数用于获取画笔绘制折线转角的样式

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

返回：

函数返回折线转角的样式

起始版本：

8

OH_Drawing_PenGetMiterLimit()

float OH_Drawing_PenGetMiterLimit (const OH_Drawing_Pen * )

描述：

函数用于获取折线尖角的限制值，当画笔绘制一条折线，转角类型设置为尖角时，那么此时该属性用于限制出现尖角的长度范围，如果超出则平角显示，不超出依然为尖角

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

返回：

函数返回尖角的限制值

起始版本：

8

OH_Drawing_PenGetWidth()

float OH_Drawing_PenGetWidth (const OH_Drawing_Pen * )

描述：

函数用于获取画笔的厚度属性，厚度属性描述了画笔绘制图形轮廓的宽度

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

返回：

函数返回画笔的厚度

起始版本：

8

OH_Drawing_PenIsAntiAlias()

bool OH_Drawing_PenIsAntiAlias (const OH_Drawing_Pen * )

描述：

函数用于获取画笔是否设置抗锯齿属性，如果为真则说明画笔会启用抗锯齿功能，在绘制图形时会对图形的边缘像素进行半透明的模糊处理

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

返回：

函数返回画笔对象是否设置抗锯齿属性，返回真则设置了抗锯齿，返回假则没有设置抗锯齿

起始版本：

8

OH_Drawing_PenSetAntiAlias()

void OH_Drawing_PenSetAntiAlias (OH_Drawing_Pen * , bool  )

描述：

函数用于设置画笔的抗锯齿属性，设置为真则画笔在绘制图形时会对图形的边缘像素进行半透明的模糊处理

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_PenSetCap()

void OH_Drawing_PenSetCap (OH_Drawing_Pen * , OH_Drawing_PenLineCapStyle  )

描述：

函数用于设置画笔笔帽样式

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_PenSetColor()

void OH_Drawing_PenSetColor (OH_Drawing_Pen * , uint32_t color )

描述：

函数用于设置画笔的颜色属性，颜色属性描述了画笔绘制图形轮廓时使用的颜色，用一个32位（ARGB）的变量表示

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_PenSetJoin()

void OH_Drawing_PenSetJoin (OH_Drawing_Pen * , OH_Drawing_PenLineJoinStyle  )

描述：

函数用于设置画笔绘制转角的样式

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_PenSetMiterLimit()

void OH_Drawing_PenSetMiterLimit (OH_Drawing_Pen * , float miter )

描述：

函数用于设置折线尖角的限制值，当画笔绘制一条折线，转角类型设置为尖角时，那么此时该属性用于限制出现尖角的长度范围，如果超出则平角显示，不超出依然为尖角

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_PenSetWidth()

void OH_Drawing_PenSetWidth (OH_Drawing_Pen * , float width )

描述：

函数用于设置画笔的厚度属性，厚度属性描述了画笔绘制图形轮廓的宽度

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_SetTextStyleBaseLine()

void OH_Drawing_SetTextStyleBaseLine (OH_Drawing_TextStyle * , int  )

描述：

设置字体基线位置

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_SetTextStyleColor()

void OH_Drawing_SetTextStyleColor (OH_Drawing_TextStyle * , uint32_t  )

描述：

设置文本颜色

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_SetTextStyleDecoration()

void OH_Drawing_SetTextStyleDecoration (OH_Drawing_TextStyle * , int  )

描述：

设置装饰

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_SetTextStyleDecorationColor()

void OH_Drawing_SetTextStyleDecorationColor (OH_Drawing_TextStyle * , uint32_t  )

描述：

设置装饰颜色

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_SetTextStyleFontFamilies()

void OH_Drawing_SetTextStyleFontFamilies (OH_Drawing_TextStyle * , int , const char * fontFamilies[] )

描述：

设置字体类型

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_SetTextStyleFontHeight()

void OH_Drawing_SetTextStyleFontHeight (OH_Drawing_TextStyle * , double  )

描述：

设置字体高度

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_SetTextStyleFontSize()

void OH_Drawing_SetTextStyleFontSize (OH_Drawing_TextStyle * , double  )

描述：

设置字号

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_SetTextStyleFontStyle()

void OH_Drawing_SetTextStyleFontStyle (OH_Drawing_TextStyle * , int  )

描述：

设置字体风格

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_SetTextStyleFontWeight()

void OH_Drawing_SetTextStyleFontWeight (OH_Drawing_TextStyle * , int  )

描述：

设置字重

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_SetTextStyleLocale()

void OH_Drawing_SetTextStyleLocale (OH_Drawing_TextStyle * , const char *  )

描述：

设置语言区域

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_SetTypographyTextAlign()

void OH_Drawing_SetTypographyTextAlign (OH_Drawing_TypographyStyle * , int  )

描述：

设置文本对齐方式

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_SetTypographyTextDirection()

void OH_Drawing_SetTypographyTextDirection (OH_Drawing_TypographyStyle * , int  )

描述：

设置文本方向

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_SetTypographyTextMaxLines()

void OH_Drawing_SetTypographyTextMaxLines (OH_Drawing_TypographyStyle * , int  )

描述：

设置文本最大行数

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_TypographyGetAlphabeticBaseline()

double OH_Drawing_TypographyGetAlphabeticBaseline (OH_Drawing_Typography * )

描述:

获取字母文字基线

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数:

返回:

返回字母文字基线

起始版本：

9

OH_Drawing_TypographyGetHeight()

double OH_Drawing_TypographyGetHeight (OH_Drawing_Typography * )

描述:

获取高度

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数:

返回:

返回高度

起始版本：

9

OH_Drawing_TypographyGetIdeographicBaseline()

double OH_Drawing_TypographyGetIdeographicBaseline (OH_Drawing_Typography * )

描述:

获取表意文字基线

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数:

返回:

返回表意文字基线

起始版本：

9

OH_Drawing_TypographyGetLongestLine()

double OH_Drawing_TypographyGetLongestLine (OH_Drawing_Typography * )

描述:

获取最长行

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数:

返回:

返回最长行

起始版本：

9

OH_Drawing_TypographyGetMaxIntrinsicWidth()

double OH_Drawing_TypographyGetMaxIntrinsicWidth (OH_Drawing_Typography * )

描述:

获取最大固有宽度

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数:

返回:

返回最大固有宽度

起始版本：

9

OH_Drawing_TypographyGetMaxWidth()

double OH_Drawing_TypographyGetMaxWidth (OH_Drawing_Typography * )

描述:

获取最大宽度

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数:

返回:

返回最大宽度

起始版本：

9

OH_Drawing_TypographyGetMinIntrinsicWidth()

double OH_Drawing_TypographyGetMinIntrinsicWidth (OH_Drawing_Typography * )

描述:

获取最小固有宽度

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数:

返回:

返回最小固有宽度

起始版本：

9

OH_Drawing_TypographyHandlerAddText()

void OH_Drawing_TypographyHandlerAddText (OH_Drawing_TypographyCreate * , const char *  )

描述：

设置文本内容

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_TypographyHandlerPopTextStyle()

void OH_Drawing_TypographyHandlerPopTextStyle (OH_Drawing_TypographyCreate * )

描述：

排版弹出

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_TypographyHandlerPushTextStyle()

void OH_Drawing_TypographyHandlerPushTextStyle (OH_Drawing_TypographyCreate * , OH_Drawing_TextStyle *  )

描述：

设置排版风格

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_TypographyLayout()

void OH_Drawing_TypographyLayout (OH_Drawing_Typography * , double  )

描述：

排版布局

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

OH_Drawing_TypographyPaint()

void OH_Drawing_TypographyPaint (OH_Drawing_Typography * , OH_Drawing_Canvas * , double , double  )

描述：

显示文本

@syscap SystemCapability.Graphic.Graphic2D.NativeDrawing

参数：

起始版本：

8

文章转载自：​​https://developer.harmonyos.com/cn/docs/documentation/doc-references-V3/_drawing-0000001497130329-V3?catalogVersion=V3#ZH-CN_TOPIC_0000001497130329__ohdrawingtypographypaint​​