drawing_text_run.h

概述

提供字体渲染单元的相关接口，比如绘制功能、获取排版边界功能等。

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

库： libnative_drawing.so

起始版本： 18

相关模块：Drawing

汇总

函数

名称	描述
OH_Drawing_Array * OH_Drawing_GetRunStringIndices (OH_Drawing_Run *run, int64_t start, int64_t length)	获取渲染单元指定范围内字形的字符索引数组，该索引是相对于整个段落的偏移。
uint64_t OH_Drawing_GetRunStringIndicesByIndex (OH_Drawing_Array *stringIndices, size_t index)	获取字符索引数组中指定下标的字符索引值。
void OH_Drawing_DestroyRunStringIndices (OH_Drawing_Array *stringIndices)	释放字形的字符索引数组对象指针。
void OH_Drawing_GetRunStringRange (OH_Drawing_Run *run, uint64_t *location, uint64_t *length)	获取渲染单元生成字形的字符范围。
float OH_Drawing_GetRunTypographicBounds (OH_Drawing_Run *run, float *ascent, float *descent, float *leading)	获取渲染单元的排版边界。文本排版边界与字符本身无关，与排版字号和字体有关。
void OH_Drawing_RunPaint (OH_Drawing_Canvas *canvas, OH_Drawing_Run *run, double x, double y)	在画布上绘制渲染单元包含的文本。
OH_Drawing_Rect * OH_Drawing_GetRunImageBounds (OH_Drawing_Run *run)	获取渲染单元的图像边界，文本图像边界与字符本身有关，相当于视觉边界。
void OH_Drawing_DestroyRunImageBounds (OH_Drawing_Rect *rect)	释放渲染单元图像边界对象指针。
OH_Drawing_Array * OH_Drawing_GetRunGlyphs (OH_Drawing_Run *run, int64_t start, int64_t length)	获取渲染单元指定范围内的字形数组。
uint16_t OH_Drawing_GetRunGlyphsByIndex (OH_Drawing_Array *glyphs, size_t index)	根据索引获取渲染单元单个字形。
void OH_Drawing_DestroyRunGlyphs (OH_Drawing_Array *glyphs)	释放渲染单元字形数组对象指针。
OH_Drawing_Array * OH_Drawing_GetRunPositions (OH_Drawing_Run *run, int64_t start, int64_t length)	获取渲染单元指定范围内字形的位置。
OH_Drawing_Point * OH_Drawing_GetRunPositionsByIndex (OH_Drawing_Array *positions, size_t index)	根据索引获取渲染单元中单个字形位置。
void OH_Drawing_DestroyRunPositions (OH_Drawing_Array *positions)	释放渲染单元字形位置数组对象指针。
uint32_t OH_Drawing_GetRunGlyphCount (OH_Drawing_Run *run)	获取渲染单元字形数量。