drawing_pen.h

概述

文件中定义了与画笔相关的功能函数。

引用文件:<native_drawing/drawing_pen.h>

库: libnative_drawing.so

起始版本: 8

相关模块:Drawing

汇总

枚举

名称 描述
OH_Drawing_PenLineCapStyle {
LINE_FLAT_CAP, LINE_SQUARE_CAP, LINE_ROUND_CAP
}
枚举集合定义了画笔笔帽的样式,即画笔在绘制线段时,在线段头尾端点的样式。
OH_Drawing_PenLineJoinStyle {
LINE_MITER_JOIN, LINE_ROUND_JOIN, LINE_BEVEL_JOIN
}
枚举集合定义了线条转角的样式,即画笔在绘制折线段时,在折线转角处的样式。

函数

名称 描述
OH_Drawing_Pen * OH_Drawing_PenCreate (void) 用于创建一个画笔对象。
void OH_Drawing_PenDestroy (OH_Drawing_Pen *) 用于销毁画笔对象并回收该对象占有的内存。
bool OH_Drawing_PenIsAntiAlias (const OH_Drawing_Pen *) 用于获取画笔是否设置抗锯齿属性,如果为真则说明画笔会启用抗锯齿功能,在绘制图形时会对图形的边缘像素进行半透明的模糊处理。
void OH_Drawing_PenSetAntiAlias (OH_Drawing_Pen *, bool) 用于设置画笔的抗锯齿属性,设置为真则画笔在绘制图形时会对图形的边缘像素进行半透明的模糊处理。
uint32_t OH_Drawing_PenGetColor (const OH_Drawing_Pen *) 用于获取画笔的颜色属性,颜色属性描述了画笔绘制图形轮廓时使用的颜色,用一个32位(ARGB)的变量表示。
void OH_Drawing_PenSetColor (OH_Drawing_Pen *, uint32_t color) 用于设置画笔的颜色属性,颜色属性描述了画笔绘制图形轮廓时使用的颜色,用一个32位(ARGB)的变量表示。
uint8_t OH_Drawing_PenGetAlpha (const OH_Drawing_Pen *) 获取画笔的透明度值。画笔在勾勒图形时透明通道会使用该值。
void OH_Drawing_PenSetAlpha (OH_Drawing_Pen *, uint8_t alpha) 为画笔设置透明度值。画笔在勾勒图形时透明通道会使用该值。
float OH_Drawing_PenGetWidth (const OH_Drawing_Pen *) 用于获取画笔的厚度属性,厚度属性描述了画笔绘制图形轮廓的宽度。
void OH_Drawing_PenSetWidth (OH_Drawing_Pen *, float width) 用于设置画笔的厚度属性,厚度属性描述了画笔绘制图形轮廓的宽度。
float OH_Drawing_PenGetMiterLimit (const OH_Drawing_Pen *) 用于获取折线尖角的限制值,当画笔绘制一条折线,转角类型设置为尖角时,那么此时该属性用于限制出现尖角的长度范围,如果超出则平角显示,不超出依然为尖角。
void OH_Drawing_PenSetMiterLimit (OH_Drawing_Pen *, float miter) 用于设置折线尖角的限制值,当画笔绘制一条折线,转角类型设置为尖角时,那么此时该属性用于限制出现尖角的长度范围,如果超出则平角显示,不超出依然为尖角。
OH_Drawing_PenLineCapStyleOH_Drawing_PenGetCap (const OH_Drawing_Pen *) 用于获取画笔笔帽的样式。
void OH_Drawing_PenSetCap (OH_Drawing_Pen *, OH_Drawing_PenLineCapStyle) 用于设置画笔笔帽样式。
OH_Drawing_PenLineJoinStyleOH_Drawing_PenGetJoin (const OH_Drawing_Pen *) 用于获取画笔绘制折线转角的样式。
void OH_Drawing_PenSetJoin (OH_Drawing_Pen *, OH_Drawing_PenLineJoinStyle) 用于设置画笔绘制转角的样式。
void OH_Drawing_PenSetShaderEffect (OH_Drawing_Pen *, OH_Drawing_ShaderEffect *) 设置画笔着色器效果。
void OH_Drawing_PenSetFilter (OH_Drawing_Pen *, OH_Drawing_Filter *) 设置画笔滤波器。