1# 自定义字体的注册和使用（C/C++） 2 3 4## 场景介绍 5 6自定义字体是指开发者根据应用需求创建或选择的字体，通常用于实现特定的文字风格或满足独特的设计要求。当应用需要使用特定的文本样式和字符集时，可以注册并使用自定义字体进行文本渲染。 7 8 9## 实现流程 10 11**自定义字体的注册**是指将字体文件（如ttf、otf文件等）从应用资源注册到系统中，使得应用能够使用这些字体进行文本渲染。注册过程通常指将字体文件通过字体管理接口注册到系统字体库中，以便在应用中进行调用。 12 13**自定义字体的使用**是指在应用中显式指定使用已注册的自定义字体进行文本绘制。开发者可以根据需要选择特定的文本样式（如常规、粗体、斜体等），并将其应用到UI元素、文本控件或其他文本展示区域，以确保符合设计要求并提供一致的视觉效果。 14 15 16## 接口说明 17 18注册使用自定义字体的相关接口如下所示，详细接口说明请参考[Drawing](../reference/apis-arkgraphics2d/_drawing.md)。 19 20| 接口名 | 描述 | 21| -------- | -------- | 22| OH_Drawing_CreateSharedFontCollection (void) | 创建可共享的字体集对象OH_Drawing_FontCollection。 | 23| OH_Drawing_RegisterFont (OH_Drawing_FontCollection\* , const char\* fontFamily, const char\* familySrc ) | 用于在字体管理器中注册自定义字体，支持的字体文件格式包含：ttf、otf。 | 24| OH_Drawing_CreateTextStyle(void) | 创建指向OH_Drawing_TextStyle对象的指针，用于设置文本样式。 | 25| OH_Drawing_SetTextStyleFontFamilies (OH_Drawing_TextStyle \*, int, const char \*fontFamilies[]) | 设置字体类型。 | 26 27 28## 开发步骤 29 301. 导入依赖的相关头文件。 31 32 ```c++ 33 #include <native_drawing/drawing_font_collection.h> 34 #include <native_drawing/drawing_text_typography.h> 35 #include <native_drawing/drawing_register_font.h> 36 #include <hilog/log.h> 37 ``` 38 392. 创建字体管理器，建议优先使用OH_Drawing_CreateSharedFontCollection()创建可共享的字体集对象。 40 41 > **说明：** 42 > 43 > 使用OH_Drawing_CreateFontCollection()和OH_Drawing_CreateSharedFontCollection()均可创建字体管理器OH_Drawing_FontCollection对象，但前者创建的字体集指针对象只能被一个段落生成器OH_Drawing_TypographyCreate对象使用，无法被多个段落生成器OH_Drawing_TypographyCreate对象共享使用。如需在多个段落生成器OH_Drawing_TypographyCreate对象间共享使用，请使用后者创建可共享的字体集对象。 44 45 ```c++ 46 OH_Drawing_FontCollection *fontCollection = OH_Drawing_CreateSharedFontCollection(); 47 ``` 48 493. 设置自定义字体的字体家族名和字体文件所在的沙箱路径。 50 51 > **说明：** 52 > 53 > 确保需注册的可用自定义字体文件已正确放置在应用设备的/system/fonts/myFontFile.ttf路径下。 54 55 ```c++ 56 // 后续使用自定义字体时，需使用到该字体家族名 57 const char* fontFamily = "myFamilyName"; 58 // 该路径是待注册的自定义字体文件在应用设备下的路径，确保该自定义字体文件已正确放置在该路径下 59 const char* fontPath = "/system/fonts/myFontFile.ttf"; 60 ``` 61 624. 在字体管理器中使用OH_Drawing_RegisterFont()注册自定义字体。 63 64 可通过接口返回结果，查看具体情况，确认注册成功与否。 65 66 OH_Drawing_RegisterFont接口返回结果的几种情况及含义如下所示： 67 68 0表示注册成功，1表示文件不存在，2表示打开文件失败，3表示读取文件失败，4表示寻找文件失败，5表示获取大小失败，9表示文件损坏。 69 70 ```c++ 71 // 返回0为成功，1为文件不存在，2为打开文件失败，3为读取文件失败，4为寻找文件失败，5为获取大小失败，9文件损坏 72 int errorCode = OH_Drawing_RegisterFont(fontCollection, fontFamily, fontPath); 73 ``` 74 755. 确保自定义字体注册成功后，使用OH_Drawing_CreateTextStyle()接口创建文本样式对象，并使用OH_Drawing_SetTextStyleFontFamilies()接口加入自定义字体。 76 77 ```c++ 78 OH_Drawing_TextStyle* textStyle = OH_Drawing_CreateTextStyle(); 79 // 如果已经注册成功自定义字体，填入自定义字体的字体家族名 80 const char* myFontFamilies[] = {"myFamilyName"}; 81 // 加入可使用的自定义字体 82 OH_Drawing_SetTextStyleFontFamilies(textStyle, 1, myFontFamilies); 83 ``` 84 856. 生成最终段落文本，使用自定义字体，以便实现最终的文本绘制和显示。 86 87 ```c++ 88 // 设置其他文本样式 89 OH_Drawing_SetTextStyleColor(textStyle , OH_Drawing_ColorSetArgb(0xFF, 0x00, 0x00, 0x00)); 90 OH_Drawing_SetTextStyleFontSize(textStyle , 70.0); 91 // 创建一个段落样式对象，以设置排版风格 92 OH_Drawing_TypographyStyle *typographyStyle = OH_Drawing_CreateTypographyStyle(); 93 OH_Drawing_SetTypographyTextAlign(typographyStyle, TEXT_ALIGN_LEFT); // 设置段落样式为左对齐 94 // 创建一个段落生成器 95 OH_Drawing_TypographyCreate* handler = OH_Drawing_CreateTypographyHandler(typographyStyle, fontCollection); 96 // 在段落生成器中设置文本样式 97 OH_Drawing_TypographyHandlerPushTextStyle(handler, textStyle); 98 // 在段落生成器中设置文本内容 99 const char* text = "Hello World. 你好世界。\n以上文字使用了主题字体"; 100 OH_Drawing_TypographyHandlerAddText(handler, text); 101 // 通过段落生成器生成段落 102 OH_Drawing_Typography* typography = OH_Drawing_CreateTypography(handler); 103 ``` 104