drawing_types.h

概述

文件中定义了用于绘制2d图形的数据类型，包括画布、画笔、画刷、位图和路径。

引用文件：

库： libnative_drawing.so

起始版本： 8

相关模块： Drawing

汇总

结构体

|名称|typedef关键字|描述| |–|–|–| |OH_Drawing_Point2D|OH_Drawing_Point2D|定义一个二维的坐标点。| |OH_Drawing_Point3D|OH_Drawing_Point3D|定义一个三维的坐标点。| |OH_Drawing_Image_Info|OH_Drawing_Image_Info|定义图片信息结构体。| |OH_Drawing_RectStyle_Info|OH_Drawing_RectStyle_Info|定义矩形框样式结构体。| |OH_Drawing_String|OH_Drawing_String|采用UTF-16编码的字符串信息结构体。| |OH_Drawing_Canvas|OH_Drawing_Canvas|定义为一块矩形的画布，可以结合画笔和画刷在上面绘制各种形状、图片和文字。| |OH_Drawing_Pen|OH_Drawing_Pen|定义为画笔，画笔用于描述绘制图形轮廓的样式和颜色。| |OH_Drawing_Region|OH_Drawing_Region|定义一个区域，用于表示画布上的封闭区域，实现更精确的图形控制。| |OH_Drawing_Brush|OH_Drawing_Brush|定义为画刷，画刷用于描述填充图形的样式和颜色。| |OH_Drawing_Path|OH_Drawing_Path|定义为路径，路径用于自定义各种形状。| |OH_Drawing_Bitmap|OH_Drawing_Bitmap|定义为位图，位图是一块内存，内存中包含了描述一张图片的像素数据。| |OH_Drawing_Point|OH_Drawing_Point|定义一个点，用于描述坐标点。| |OH_Drawing_PixelMap|OH_Drawing_PixelMap|定义像素图，用于包装图像框架支持的真实像素图。| |OH_Drawing_ColorSpace|OH_Drawing_ColorSpace|定义色彩空间，用于解释颜色信息。| |OH_Drawing_PathEffect|OH_Drawing_PathEffect|定义一个路径效果，用于影响描边路径。| |OH_Drawing_Rect|OH_Drawing_Rect|用于描述矩形。| |OH_Drawing_RoundRect|OH_Drawing_RoundRect|用于描述圆角矩形。| |OH_Drawing_Matrix|OH_Drawing_Matrix|定义一个矩阵，用于描述坐标变换。| |OH_Drawing_ShaderEffect|OH_Drawing_ShaderEffect|定义一个着色器，用于描述绘制内容的源颜色。| |OH_Drawing_ShadowLayer|OH_Drawing_ShadowLayer|定义一个阴影层，用于描述绘制内容的阴影层。| |OH_Drawing_Filter|OH_Drawing_Filter|定义一个滤波器，用于存储颜色滤波器，蒙版滤波器和图像滤波器。| |OH_Drawing_MaskFilter|OH_Drawing_MaskFilter|定义蒙版滤波器。| |OH_Drawing_ColorFilter|OH_Drawing_ColorFilter|定义颜色滤波器，传入一个颜色并返回一个新的颜色。| |OH_Drawing_Font|OH_Drawing_Font|用于描述字体。| |OH_Drawing_MemoryStream|OH_Drawing_MemoryStream|用于描述内存流。| |OH_Drawing_FontArguments|OH_Drawing_FontArguments|用于描述字型参数。| |OH_Drawing_Typeface|OH_Drawing_Typeface|用于描述字形。| |OH_Drawing_TextBlob|OH_Drawing_TextBlob|定义一个文本对象，表示将多个文本组合到一个不可变的容器中。每个文本行由字形和位置组成。| |OH_Drawing_Image|OH_Drawing_Image|定义一个用于描述绘制二维像素数组的图片。| |OH_Drawing_ImageFilter|OH_Drawing_ImageFilter|定义图像滤波器, 用于对构成图像像素的所有颜色位进行操作。| |OH_Drawing_SamplingOptions|OH_Drawing_SamplingOptions|定义一个采样选项，用于描述图片、位图等图像的采样方法。| |OH_Drawing_TextBlobBuilder|OH_Drawing_TextBlobBuilder|定义文本构建器，用于构建文本。| |OH_Drawing_GpuContext|OH_Drawing_GpuContext|定义图形处理器上下文，用于描述图形处理器后端上下文。| |OH_Drawing_Surface|OH_Drawing_Surface|定义surface，用于管理画布绘制的内容。| |OH_Drawing_FontMgr|OH_Drawing_FontMgr|定义字体管理类, 用于字体管理。| |OH_Drawing_FontStyleSet|OH_Drawing_FontStyleSet|定义字体样式集, 用于字体样式族匹配。| |OH_Drawing_RecordCmdUtils|OH_Drawing_RecordCmdUtils|定义指令录制工具，用于生成录制指令。| |OH_Drawing_RecordCmd|OH_Drawing_RecordCmd|定义录制指令类, 用于存储录制指令的集合。| |OH_Drawing_Array|OH_Drawing_Array|定义数组对象, 用于存储多个同类型对象。|

枚举

|名称|typedef关键字|描述| |–|–|–| |OH_Drawing_ColorFormat|OH_Drawing_ColorFormat|用于描述位图像素的存储格式。| |OH_Drawing_AlphaFormat|OH_Drawing_AlphaFormat|用于描述位图像素的透明度分量。| |OH_Drawing_BlendMode|OH_Drawing_BlendMode|混合模式枚举。混合模式的操作会为两种颜色（源色、目标色）生成一种新的颜色。
这些操作在红、绿、蓝3个颜色通道上是相同的（透明度有另外的处理规则）。
对于这些，我们使用透明度通道作为示例，而不是单独命名每个通道。为简洁起见，我们使用以下缩写：
s : source，源的缩写。
d : destination，目标的缩写。
sa : source alpha，源透明度的缩写。
da : destination alpha，目标透明度的缩写。
计算结果用如下缩写表示：
r : 如果4个通道的计算方式相同，用r表示。
ra : 如果只操作透明度通道，用ra表示。
rc : 如果操作3个颜色通道，用rc表示。| |OH_Drawing_TextEncoding|OH_Drawing_TextEncoding|文本编码类型枚举。|

枚举类型说明

OH_Drawing_ColorFormat

enum OH_Drawing_ColorFormat

描述

用于描述位图像素的存储格式。

起始版本： 8

|枚举项|描述| |–|–| |COLOR_FORMAT_UNKNOWN|未知格式。.| |COLOR_FORMAT_ALPHA_8|每个像素用一个8位的量表示，8个位比特位表示透明度。| |COLOR_FORMAT_RGB_565|每个像素用一个16位的量表示，高位到低位依次是5个比特位表示红，6个比特位表示绿，5个比特位表示蓝。| |COLOR_FORMAT_ARGB_4444|每个像素用一个16位的量表示，高位到低位依次是4个比特位表示透明度，4个比特位表示红，4个比特位表示绿，4个比特位表示蓝。| |COLOR_FORMAT_RGBA_8888|每个像素用一个32位的量表示，高位到低位依次是8个比特位表示透明度，8个比特位表示红，8个比特位表示绿，8个比特位表示蓝。| |COLOR_FORMAT_BGRA_8888|每个像素用一个32位的量表示，高位到低位依次是8个比特位表示蓝，8个比特位表示绿，8个比特位表示红，8个比特位表示透明度。|

OH_Drawing_AlphaFormat

enum OH_Drawing_AlphaFormat

描述

用于描述位图像素的透明度分量。

起始版本： 8

|枚举项|描述| |–|–| |ALPHA_FORMAT_UNKNOWN|未知格式。| |ALPHA_FORMAT_OPAQUE|位图无透明度。| |ALPHA_FORMAT_PREMUL|每个像素的颜色组件由透明度分量预先乘以。| |ALPHA_FORMAT_UNPREMUL|每个像素的颜色组件未由透明度分量预先乘以。|

OH_Drawing_BlendMode

enum OH_Drawing_BlendMode

描述

混合模式枚举。混合模式的操作会为两种颜色（源色、目标色）生成一种新的颜色。
这些操作在红、绿、蓝3个颜色通道上是相同的（透明度有另外的处理规则）。
对于这些，我们使用透明度通道作为示例，而不是单独命名每个通道。为简洁起见，我们使用以下缩写：
s : source，源的缩写。
d : destination，目标的缩写。
sa : source alpha，源透明度的缩写。
da : destination alpha，目标透明度的缩写。
计算结果用如下缩写表示：
r : 如果4个通道的计算方式相同，用r表示。
ra : 如果只操作透明度通道，用ra表示。
rc : 如果操作3个颜色通道，用rc表示。

起始版本： 11

|枚举项|描述| |–|–| |BLEND_MODE_CLEAR|清除模式，r = 0。| |BLEND_MODE_SRC|r = s（result的4个通道，都等于source的4个通道，即结果等于源。）| |BLEND_MODE_DST|r = d（result的4个通道，都等于destination的4个通道，即结果等于目标。）| |BLEND_MODE_SRC_OVER|r = s + (1 - sa) * d。| |BLEND_MODE_DST_OVER|r = d + (1 - da) * s。| |BLEND_MODE_SRC_IN|r = s * da。| |BLEND_MODE_DST_IN|r = d * sa。| |BLEND_MODE_SRC_OUT|r = s * (1 - da)。| |BLEND_MODE_DST_OUT|r = d * (1 - sa)。| |BLEND_MODE_SRC_ATOP|r = s * da + d * (1 - sa)。| |BLEND_MODE_DST_ATOP|r = d * sa + s * (1 - da)。| |BLEND_MODE_XOR|r = s * (1 - da) + d * (1 - sa)。| |BLEND_MODE_PLUS|r = min(s + d, 1)。| |BLEND_MODE_MODULATE|r = s * d。| |BLEND_MODE_SCREEN|滤色模式，r = s + d - s * d。| |BLEND_MODE_OVERLAY|叠加模式。| |BLEND_MODE_DARKEN|变暗模式，rc = s + d - max(s * da, d * sa), ra = s + (1 - sa) * d。| |BLEND_MODE_LIGHTEN|变亮模式，rc = s + d - min(s * da, d * sa), ra = s + (1 - sa) * d。| |BLEND_MODE_COLOR_DODGE|颜色减淡模式。| |BLEND_MODE_COLOR_BURN|颜色加深模式。| |BLEND_MODE_HARD_LIGHT|强光模式。| |BLEND_MODE_SOFT_LIGHT|柔光模式。| |BLEND_MODE_DIFFERENCE|差值模式，rc = s + d - 2 * (min(s * da, d * sa)), ra = s + (1 - sa) * d。| |BLEND_MODE_EXCLUSION|排除模式，rc = s + d - two(s * d), ra = s + (1 - sa) * d。| |BLEND_MODE_MULTIPLY|正片叠底，r = s * (1 - da) + d * (1 - sa) + s * d。| |BLEND_MODE_HUE|色相模式。| |BLEND_MODE_SATURATION|饱和度模式。| |BLEND_MODE_COLOR|颜色模式。| |BLEND_MODE_LUMINOSITY|亮度模式。|

OH_Drawing_TextEncoding

enum OH_Drawing_TextEncoding

描述

文本编码类型枚举。

起始版本： 12

|枚举项|描述| |–|–| |TEXT_ENCODING_UTF8|单字节，表示UTF-8或ASCII。| |TEXT_ENCODING_UTF16|双字节，表示大部分Unicode。| |TEXT_ENCODING_UTF32|四字节，表示所有Unicode。| |TEXT_ENCODING_GLYPH_ID|双字节，表示字形索引。|

你可能感兴趣的鸿蒙文章

harmony 鸿蒙ArkGraphics 2D（方舟2D图形服务）

harmony 鸿蒙buffer_common.h

harmony 鸿蒙buffer_handle.h

harmony 鸿蒙BufferHandle

harmony 鸿蒙ColorSpacePrimaries

harmony 鸿蒙DisplaySoloist_ExpectedRateRange

harmony 鸿蒙drawing_bitmap.h

harmony 鸿蒙drawing_brush.h

harmony 鸿蒙drawing_canvas.h

harmony 鸿蒙drawing_color_filter.h