drawing_pen.h

概述

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

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

库： libnative_drawing.so

起始版本： 8

相关模块：Drawing

汇总

类型定义

名称	描述
typedef enum OH_Drawing_PenLineCapStyle OH_Drawing_PenLineCapStyle	枚举集合定义了画笔笔帽的样式，即画笔在绘制线段时，在线段头尾端点的样式。
typedef enum OH_Drawing_PenLineJoinStyle OH_Drawing_PenLineJoinStyle	枚举集合定义了线条转角的样式，即画笔在绘制折线段时，在折线转角处的样式。

枚举

名称	描述
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)	用于创建一个画笔对象。
OH_Drawing_Pen * OH_Drawing_PenCopy (OH_Drawing_Pen *pen)	创建一个画笔对象副本OH_Drawing_Pen，用于拷贝一个已有画笔对象。
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)	用于设置画笔的线宽。0线宽被视作特殊的极细线宽，在绘制时始终会被绘制为1像素，不随画布的缩放而改变；负数线宽在实际绘制时会被视作0线宽。
float OH_Drawing_PenGetMiterLimit (const OH_Drawing_Pen *)	用于获取折线尖角的限制值，当画笔绘制一条折线，转角类型设置为尖角时，那么此时该属性用于限制出现尖角的长度范围，如果超出则平角显示，不超出依然为尖角。
void OH_Drawing_PenSetMiterLimit (OH_Drawing_Pen *, float miter)	用于设置折线尖角的限制值，当画笔绘制一条折线，转角类型设置为尖角时，那么此时该属性用于限制出现尖角的长度范围，如果超出则平角显示，不超出依然为尖角。
OH_Drawing_PenLineCapStyle OH_Drawing_PenGetCap (const OH_Drawing_Pen *)	用于获取画笔笔帽的样式。
void OH_Drawing_PenSetCap (OH_Drawing_Pen *, OH_Drawing_PenLineCapStyle)	用于设置画笔笔帽样式。
OH_Drawing_PenLineJoinStyle OH_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_PenSetShadowLayer (OH_Drawing_Pen *, OH_Drawing_ShadowLayer *)	设置画笔阴影层效果，设置的阴影层效果当前仅在绘制文字时生效。
void OH_Drawing_PenSetPathEffect (OH_Drawing_Pen *, OH_Drawing_PathEffect *)	设置画笔路径效果。
void OH_Drawing_PenSetFilter (OH_Drawing_Pen *, OH_Drawing_Filter *)	设置画笔滤波器。
void OH_Drawing_PenGetFilter (OH_Drawing_Pen *, OH_Drawing_Filter *)	从画笔获取滤波器OH_Drawing_Filter。滤波器是一个容器，可以承载蒙版滤波器和颜色滤波器。
void OH_Drawing_PenSetBlendMode (OH_Drawing_Pen *, OH_Drawing_BlendMode)	为画笔设置一个混合器，该混合器实现了指定的混合模式枚举。
bool OH_Drawing_PenGetFillPath (OH_Drawing_Pen *, const OH_Drawing_Path *src, OH_Drawing_Path *dst, const OH_Drawing_Rect *, const OH_Drawing_Matrix *)	获取使用画笔绘制的源路径轮廓，并用目标路径表示。
void OH_Drawing_PenReset (OH_Drawing_Pen *)	将画笔重置至初始值。