harmony 鸿蒙drawing_register_font.h

  • 2025-06-12
  • 浏览 (114)

drawing_register_font.h

概述

定义绘制模块中字体管理器相关的函数。

引用文件:

库: libnative_drawing.so

起始版本: 11

相关模块: Drawing

汇总

函数

|名称|描述| |–|–| |uint32_t OH_Drawing_RegisterFont(OH_Drawing_FontCollection, const char fontFamily, const char* familySrc)|用于在字体管理器中注册自定义字体,支持的字体文件格式包含:ttf、otf。| |uint32_t OH_Drawing_RegisterFontBuffer(OH_Drawing_FontCollection, const char fontFamily, uint8_t* fontBuffer,size_t length)|用于在字体管理器中注册字体缓冲区。| |uint32_t OH_Drawing_UnregisterFont(OH_Drawing_FontCollection* fontCollection, const char* fontFamily)|通过字体家族名称取消注册自定义字体。
取消注册当前正在使用的字体可能导致文本渲染异常,包括乱码或字形缺失。
所有使用被取消注册的字体家族名称的排版对象都应该被销毁重建。|

函数说明

OH_Drawing_RegisterFont()

uint32_t OH_Drawing_RegisterFont(OH_Drawing_FontCollection*, const char* fontFamily, const char* familySrc)

描述

用于在字体管理器中注册自定义字体,支持的字体文件格式包含:ttf、otf。

系统能力: SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本: 11

参数:

|参数项|描述| |–|–| |OH_Drawing_FontCollection|指向OH_Drawing_FontCollection对象的指针。| |const char fontFamily|指需要注册的字体的字体名称。| |const char* familySrc|指需要注册的字体文件的路径。|

返回:

|类型|说明| |–|–| |uint32_t|返回错误代码,0为成功,1为文件不存在,2为打开文件失败,3为读取文件失败,4为寻找文件失败,5为获取大小失败,9文件损坏。|

OH_Drawing_RegisterFontBuffer()

uint32_t OH_Drawing_RegisterFontBuffer(OH_Drawing_FontCollection*, const char* fontFamily, uint8_t* fontBuffer,size_t length)

描述

用于在字体管理器中注册字体缓冲区。

系统能力: SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本: 11

参数:

|参数项|描述| |–|–| |OH_Drawing_FontCollection| 指向OH_Drawing_FontCollection对象的指针。| |const char fontFamily|指需要注册的字体的字体名称。| |uint8_t* fontBuffer|指需要注册的字体文件的缓冲区。| |size_t length|指需要注册的字体文件的长度。|

返回:

|类型|说明| |–|–| |uint32_t|返回错误代码,0为成功,6为缓冲区大小为零,7为字体集合为空,9文件损坏。|

OH_Drawing_UnregisterFont()

uint32_t OH_Drawing_UnregisterFont(OH_Drawing_FontCollection* fontCollection, const char* fontFamily)

描述

通过字体家族名称取消注册自定义字体。

取消注册当前正在使用的字体可能导致文本渲染异常,包括乱码或字形缺失。

所有使用被取消注册的字体家族名称的排版对象都应该被销毁重建。

系统能力: SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本: 20

参数:

|参数项|描述| |–|–| |OH_Drawing_FontCollection* fontCollection|指向OH_Drawing_FontCollection对象的指针。| |const char* fontFamily|需要取消注册的字体家族名称。|

返回:

|类型|说明| |–|–| |uint32_t|返回执行结果状态码,0为成功,8为入参不合法,1为取消注册失败。|

你可能感兴趣的鸿蒙文章

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

0  赞