1# drawing_text_run.h 2<!--Kit: ArkGraphics 2D--> 3<!--Subsystem: Graphics--> 4<!--Owner: @oh_wangxk; @gmiao522; @Lem0nC--> 5<!--Designer: @liumingxiang--> 6<!--Tester: @yhl0101--> 7<!--Adviser: @ge-yafang--> 8## 概述 9 10提供字体渲染单元的相关接口，比如绘制功能、获取排版边界功能等。 11 12**引用文件：** <native_drawing/drawing_text_run.h> 13 14**库：** libnative_drawing.so 15 16**起始版本：** 18 17 18**相关模块：** [Drawing](capi-drawing.md) 19 20## 汇总 21 22### 函数 23 24| 名称 | 描述 | 25| -- | -- | 26| [OH_Drawing_Array* OH_Drawing_GetRunStringIndices(OH_Drawing_Run* run, int64_t start, int64_t length)](#oh_drawing_getrunstringindices) | 获取渲染单元指定范围内字形的字符索引数组，该索引是相对于整个段落的偏移。 | 27| [uint64_t OH_Drawing_GetRunStringIndicesByIndex(OH_Drawing_Array* stringIndices, size_t index)](#oh_drawing_getrunstringindicesbyindex) | 获取字符索引数组中指定下标的字符索引值。 | 28| [void OH_Drawing_DestroyRunStringIndices(OH_Drawing_Array* stringIndices)](#oh_drawing_destroyrunstringindices) | 释放字形的字符索引数组对象指针。 | 29| [void OH_Drawing_GetRunStringRange(OH_Drawing_Run* run, uint64_t* location, uint64_t* length)](#oh_drawing_getrunstringrange) | 获取渲染单元生成字形的字符范围。 | 30| [float OH_Drawing_GetRunTypographicBounds(OH_Drawing_Run* run, float* ascent, float* descent, float* leading)](#oh_drawing_getruntypographicbounds) | 获取渲染单元的排版边界。文本排版边界与字符本身无关，与排版字号和字体有关。 | 31| [void OH_Drawing_RunPaint(OH_Drawing_Canvas* canvas, OH_Drawing_Run* run, double x, double y)](#oh_drawing_runpaint) | 在画布上绘制渲染单元包含的文本。 | 32| [OH_Drawing_Rect* OH_Drawing_GetRunImageBounds(OH_Drawing_Run* run)](#oh_drawing_getrunimagebounds) | 获取渲染单元的图像边界，文本图像边界与字符本身有关，相当于视觉边界。 | 33| [void OH_Drawing_DestroyRunImageBounds(OH_Drawing_Rect* rect)](#oh_drawing_destroyrunimagebounds) | 释放渲染单元图像边界对象指针。 | 34| [OH_Drawing_Array* OH_Drawing_GetRunGlyphs(OH_Drawing_Run* run, int64_t start, int64_t length)](#oh_drawing_getrunglyphs) | 获取渲染单元指定范围内的字形数组。 | 35| [uint16_t OH_Drawing_GetRunGlyphsByIndex(OH_Drawing_Array* glyphs, size_t index)](#oh_drawing_getrunglyphsbyindex) | 根据索引获取渲染单元单个字形。 | 36| [void OH_Drawing_DestroyRunGlyphs(OH_Drawing_Array* glyphs)](#oh_drawing_destroyrunglyphs) | 释放渲染单元字形数组对象指针。 | 37| [OH_Drawing_Array* OH_Drawing_GetRunPositions(OH_Drawing_Run* run, int64_t start, int64_t length)](#oh_drawing_getrunpositions) | 获取渲染单元指定范围内字形的位置。 | 38| [OH_Drawing_Point* OH_Drawing_GetRunPositionsByIndex(OH_Drawing_Array* positions, size_t index)](#oh_drawing_getrunpositionsbyindex) | 根据索引获取渲染单元中单个字形位置。 | 39| [void OH_Drawing_DestroyRunPositions(OH_Drawing_Array* positions)](#oh_drawing_destroyrunpositions) | 释放渲染单元字形位置数组对象指针。 | 40| [uint32_t OH_Drawing_GetRunGlyphCount(OH_Drawing_Run* run)](#oh_drawing_getrunglyphcount) | 获取渲染单元字形数量。 | 41| [OH_Drawing_Font* OH_Drawing_GetRunFont(OH_Drawing_Run* run)](#oh_drawing_getrunfont) | 获取渲染单元字体对象。 | 42| [OH_Drawing_TextDirection OH_Drawing_GetRunTextDirection(OH_Drawing_Run* run)](#oh_drawing_getruntextdirection) | 获取渲染单元文本方向。 | 43| [OH_Drawing_Array* OH_Drawing_GetRunGlyphAdvances(OH_Drawing_Run* run, uint32_t start, uint32_t length)](#oh_drawing_getrunglyphadvances) | 获取渲染单元字体宽度数组。 | 44| [OH_Drawing_Point* OH_Drawing_GetRunGlyphAdvanceByIndex(OH_Drawing_Array* advances, size_t index)](#oh_drawing_getrunglyphadvancebyindex) | 根据索引获取渲染单元中单个字形宽度。 | 45| [void OH_Drawing_DestroyRunGlyphAdvances(OH_Drawing_Array* advances)](#oh_drawing_destroyrunglyphadvances) | 释放渲染单元字形宽度数组对象的指针。 | 46 47## 函数说明 48 49### OH_Drawing_GetRunStringIndices() 50 51``` 52OH_Drawing_Array* OH_Drawing_GetRunStringIndices(OH_Drawing_Run* run, int64_t start, int64_t length) 53``` 54 55**描述** 56 57获取渲染单元指定范围内字形的字符索引数组，该索引是相对于整个段落的偏移。 58 59**系统能力：** SystemCapability.Graphic.Graphic2D.NativeDrawing 60 61**起始版本：** 18 62 63 64**参数：** 65 66| 参数项 | 描述 | 67| -- | -- | 68| [OH_Drawing_Run](capi-drawing-oh-drawing-run.md)* run | 指向渲染单元[OH_Drawing_Run](capi-drawing-oh-drawing-run.md)对象的指针。 | 69| int64_t start | 渲染单元内指定的开始位置，传入负数时该方法返回空指针。 | 70| int64_t length | 渲染单元内指定的长度，length为0时获取渲染单元的所有字符索引数组，length小于0时该方法返回空指针。 | 71 72**返回：** 73 74| 类型 | 说明 | 75| -- | -- | 76| [OH_Drawing_Array](capi-drawing-oh-drawing-array.md)* | 返回字形的字符索引数组，不再需要[OH_Drawing_Array](capi-drawing-oh-drawing-array.md)时，请使用[OH_Drawing_DestroyRunStringIndices](capi-drawing-text-run-h.md#oh_drawing_destroyrunstringindices)接口释放该对象的指针。 | 77 78### OH_Drawing_GetRunStringIndicesByIndex() 79 80``` 81uint64_t OH_Drawing_GetRunStringIndicesByIndex(OH_Drawing_Array* stringIndices, size_t index) 82``` 83 84**描述** 85 86获取字符索引数组中指定下标的字符索引值。 87 88**系统能力：** SystemCapability.Graphic.Graphic2D.NativeDrawing 89 90**起始版本：** 18 91 92 93**参数：** 94 95| 参数项 | 描述 | 96| -- | -- | 97| [OH_Drawing_Array](capi-drawing-oh-drawing-array.md)* stringIndices | 字符索引数组。 | 98| size_t index | 渲染单元字形的字符索引数组下标。 | 99 100**返回：** 101 102| 类型 | 说明 | 103| -- | -- | 104| uint64_t | 返回渲染单元单个字形的字符索引。 | 105 106### OH_Drawing_DestroyRunStringIndices() 107 108``` 109void OH_Drawing_DestroyRunStringIndices(OH_Drawing_Array* stringIndices) 110``` 111 112**描述** 113 114释放字形的字符索引数组对象指针。 115 116**系统能力：** SystemCapability.Graphic.Graphic2D.NativeDrawing 117 118**起始版本：** 18 119 120 121**参数：** 122 123| 参数项 | 描述 | 124| -- | -- | 125| [OH_Drawing_Array](capi-drawing-oh-drawing-array.md)* stringIndices | 字符索引数组。 | 126 127### OH_Drawing_GetRunStringRange() 128 129``` 130void OH_Drawing_GetRunStringRange(OH_Drawing_Run* run, uint64_t* location, uint64_t* length) 131``` 132 133**描述** 134 135获取渲染单元生成字形的字符范围。 136 137**系统能力：** SystemCapability.Graphic.Graphic2D.NativeDrawing 138 139**起始版本：** 18 140 141 142**参数：** 143 144| 参数项 | 描述 | 145| -- | -- | 146| [OH_Drawing_Run](capi-drawing-oh-drawing-run.md)* run | 指向渲染单元[OH_Drawing_Run](capi-drawing-oh-drawing-run.md)对象的指针。 | 147| uint64_t* location | 表示渲染单元字形的字符范围的开始位置，该位置是相对于整个段落的偏移。 | 148| uint64_t* length | 表示渲染单元字符范围的长度。 | 149 150### OH_Drawing_GetRunTypographicBounds() 151 152``` 153float OH_Drawing_GetRunTypographicBounds(OH_Drawing_Run* run, float* ascent, float* descent, float* leading) 154``` 155 156**描述** 157 158获取渲染单元的排版边界。文本排版边界与字符本身无关，与排版字号和字体有关。 159 160**系统能力：** SystemCapability.Graphic.Graphic2D.NativeDrawing 161 162**起始版本：** 18 163 164 165**参数：** 166 167| 参数项 | 描述 | 168| -- | -- | 169| [OH_Drawing_Run](capi-drawing-oh-drawing-run.md)* run | 指向渲染单元[OH_Drawing_Run](capi-drawing-oh-drawing-run.md)对象的指针。 | 170| float* ascent | 渲染单元中最高字符到基准线的距离。 | 171| float* descent | 渲染单元中最低字符到基准线的距离。 | 172| float* leading | 渲染单元行间距。 | 173 174**返回：** 175 176| 类型 | 说明 | 177| -- | -- | 178| float | 返回渲染单元排版宽度。 | 179 180### OH_Drawing_RunPaint() 181 182``` 183void OH_Drawing_RunPaint(OH_Drawing_Canvas* canvas, OH_Drawing_Run* run, double x, double y) 184``` 185 186**描述** 187 188在画布上绘制渲染单元包含的文本。 189 190**系统能力：** SystemCapability.Graphic.Graphic2D.NativeDrawing 191 192**起始版本：** 18 193 194 195**参数：** 196 197| 参数项 | 描述 | 198| -- | -- | 199| [OH_Drawing_Canvas](capi-drawing-oh-drawing-canvas.md)* canvas | 指向画布[OH_Drawing_Canvas](capi-drawing-oh-drawing-canvas.md)对象的指针。 | 200| [OH_Drawing_Run](capi-drawing-oh-drawing-run.md)* run | 指向渲染单元[OH_Drawing_Run](capi-drawing-oh-drawing-run.md)对象的指针。 | 201| double x | 渲染单元x坐标。 | 202| double y | 渲染单元y坐标。 | 203 204### OH_Drawing_GetRunImageBounds() 205 206``` 207OH_Drawing_Rect* OH_Drawing_GetRunImageBounds(OH_Drawing_Run* run) 208``` 209 210**描述** 211 212获取渲染单元的图像边界，文本图像边界与字符本身有关，相当于视觉边界。 213 214**系统能力：** SystemCapability.Graphic.Graphic2D.NativeDrawing 215 216**起始版本：** 18 217 218 219**参数：** 220 221| 参数项 | 描述 | 222| -- | -- | 223| [OH_Drawing_Run](capi-drawing-oh-drawing-run.md)* run | 指向渲染单元[OH_Drawing_Run](capi-drawing-oh-drawing-run.md)对象的指针。 | 224 225**返回：** 226 227| 类型 | 说明 | 228| -- | -- | 229| [OH_Drawing_Rect](capi-drawing-oh-drawing-rect.md)* | 返回指向渲染单元图像边界[OH_Drawing_Rect](capi-drawing-oh-drawing-rect.md)对象的指针，不再需要[OH_Drawing_Rect](capi-drawing-oh-drawing-rect.md)时，请使用[OH_Drawing_DestroyRunImageBounds](capi-drawing-text-run-h.md#oh_drawing_destroyrunimagebounds)接口释放该对象的指针。 | 230 231### OH_Drawing_DestroyRunImageBounds() 232 233``` 234void OH_Drawing_DestroyRunImageBounds(OH_Drawing_Rect* rect) 235``` 236 237**描述** 238 239释放渲染单元图像边界对象指针。 240 241**系统能力：** SystemCapability.Graphic.Graphic2D.NativeDrawing 242 243**起始版本：** 18 244 245 246**参数：** 247 248| 参数项 | 描述 | 249| -- | -- | 250| [OH_Drawing_Rect](capi-drawing-oh-drawing-rect.md)* rect | 指向渲染单元图像边界[OH_Drawing_Rect](capi-drawing-oh-drawing-rect.md)对象的指针。 | 251 252### OH_Drawing_GetRunGlyphs() 253 254``` 255OH_Drawing_Array* OH_Drawing_GetRunGlyphs(OH_Drawing_Run* run, int64_t start, int64_t length) 256``` 257 258**描述** 259 260获取渲染单元指定范围内的字形数组。 261 262**系统能力：** SystemCapability.Graphic.Graphic2D.NativeDrawing 263 264**起始版本：** 18 265 266 267**参数：** 268 269| 参数项 | 描述 | 270| -- | -- | 271| [OH_Drawing_Run](capi-drawing-oh-drawing-run.md)* run | 指向渲染单元[OH_Drawing_Run](capi-drawing-oh-drawing-run.md)对象的指针。 | 272| int64_t start | 渲染单元内指定的开始位置，传入负数时该方法返回空指针。 | 273| int64_t length | 渲染单元内指定的长度，length为0时获取渲染单元的所有字符索引，length小于0时该方法返回空指针。 | 274 275**返回：** 276 277| 类型 | 说明 | 278| -- | -- | 279| [OH_Drawing_Array](capi-drawing-oh-drawing-array.md)* | 返回指向渲染单元字形数组[OH_Drawing_Array](capi-drawing-oh-drawing-array.md)对象的指针，不再需要[OH_Drawing_Array](capi-drawing-oh-drawing-array.md)时，请使用[OH_Drawing_DestroyRunGlyphs](capi-drawing-text-run-h.md#oh_drawing_destroyrunglyphs)接口释放该对象的指针。 | 280 281### OH_Drawing_GetRunGlyphsByIndex() 282 283``` 284uint16_t OH_Drawing_GetRunGlyphsByIndex(OH_Drawing_Array* glyphs, size_t index) 285``` 286 287**描述** 288 289根据索引获取渲染单元单个字形。 290 291**系统能力：** SystemCapability.Graphic.Graphic2D.NativeDrawing 292 293**起始版本：** 18 294 295 296**参数：** 297 298| 参数项 | 描述 | 299| -- | -- | 300| [OH_Drawing_Array](capi-drawing-oh-drawing-array.md)* glyphs | 指向渲染单元字形数组[OH_Drawing_Array](capi-drawing-oh-drawing-array.md)对象的指针。 | 301| size_t index | 渲染单元字形数组下标。 | 302 303**返回：** 304 305| 类型 | 说明 | 306| -- | -- | 307| uint16_t | 渲染单元单个字形。 | 308 309### OH_Drawing_DestroyRunGlyphs() 310 311``` 312void OH_Drawing_DestroyRunGlyphs(OH_Drawing_Array* glyphs) 313``` 314 315**描述** 316 317释放渲染单元字形数组对象指针。 318 319**系统能力：** SystemCapability.Graphic.Graphic2D.NativeDrawing 320 321**起始版本：** 18 322 323 324**参数：** 325 326| 参数项 | 描述 | 327| -- | -- | 328| [OH_Drawing_Array](capi-drawing-oh-drawing-array.md)* glyphs | 指向渲染单元字形数组[OH_Drawing_Array](capi-drawing-oh-drawing-array.md)对象的指针。 | 329 330### OH_Drawing_GetRunPositions() 331 332``` 333OH_Drawing_Array* OH_Drawing_GetRunPositions(OH_Drawing_Run* run, int64_t start, int64_t length) 334``` 335 336**描述** 337 338获取渲染单元指定范围内字形的位置。 339 340**系统能力：** SystemCapability.Graphic.Graphic2D.NativeDrawing 341 342**起始版本：** 18 343 344 345**参数：** 346 347| 参数项 | 描述 | 348| -- | -- | 349| [OH_Drawing_Run](capi-drawing-oh-drawing-run.md)* run | 指向渲染单元[OH_Drawing_Run](capi-drawing-oh-drawing-run.md)对象的指针。 | 350| int64_t start | 渲染单元内指定的开始位置，传入负数时该方法返回空指针。 | 351| int64_t length | 渲染单元内指定的长度，length为0时获取渲染单元的所有字符索引，length小于0时该方法返回空指针。 | 352 353**返回：** 354 355| 类型 | 说明 | 356| -- | -- | 357| [OH_Drawing_Array](capi-drawing-oh-drawing-array.md)* | 返回指向渲染单元字形位置数组[OH_Drawing_Array](capi-drawing-oh-drawing-array.md)对象的指针，不再需要[OH_Drawing_Array](capi-drawing-oh-drawing-array.md)时，请使用[OH_Drawing_DestroyRunPositions](capi-drawing-text-run-h.md#oh_drawing_destroyrunpositions)接口释放该对象的指针。 | 358 359### OH_Drawing_GetRunPositionsByIndex() 360 361``` 362OH_Drawing_Point* OH_Drawing_GetRunPositionsByIndex(OH_Drawing_Array* positions, size_t index) 363``` 364 365**描述** 366 367根据索引获取渲染单元中单个字形位置。 368 369**系统能力：** SystemCapability.Graphic.Graphic2D.NativeDrawing 370 371**起始版本：** 18 372 373 374**参数：** 375 376| 参数项 | 描述 | 377| -- | -- | 378| [OH_Drawing_Array](capi-drawing-oh-drawing-array.md)* positions | 指向渲染单元字形位置数组[OH_Drawing_Array](capi-drawing-oh-drawing-array.md)对象的指针。 | 379| size_t index | 渲染单元字形位置数组下标。 | 380 381**返回：** 382 383| 类型 | 说明 | 384| -- | -- | 385| [OH_Drawing_Point](capi-drawing-oh-drawing-point.md)* | 返回指向渲染单元单个字形位置[OH_Drawing_Point](capi-drawing-oh-drawing-point.md)对象的指针。 | 386 387### OH_Drawing_DestroyRunPositions() 388 389``` 390void OH_Drawing_DestroyRunPositions(OH_Drawing_Array* positions) 391``` 392 393**描述** 394 395释放渲染单元字形位置数组对象指针。 396 397**系统能力：** SystemCapability.Graphic.Graphic2D.NativeDrawing 398 399**起始版本：** 18 400 401 402**参数：** 403 404| 参数项 | 描述 | 405| -- | -- | 406| [OH_Drawing_Array](capi-drawing-oh-drawing-array.md)* positions | 指向渲染单元字形位置数组[OH_Drawing_Array](capi-drawing-oh-drawing-array.md)对象的指针。 | 407 408### OH_Drawing_GetRunGlyphCount() 409 410``` 411uint32_t OH_Drawing_GetRunGlyphCount(OH_Drawing_Run* run) 412``` 413 414**描述** 415 416获取渲染单元字形数量。 417 418**系统能力：** SystemCapability.Graphic.Graphic2D.NativeDrawing 419 420**起始版本：** 18 421 422 423**参数：** 424 425| 参数项 | 描述 | 426| -- | -- | 427| [OH_Drawing_Run](capi-drawing-oh-drawing-run.md)* run | 指向渲染单元[OH_Drawing_Run](capi-drawing-oh-drawing-run.md)对象的指针。 | 428 429**返回：** 430 431| 类型 | 说明 | 432| -- | -- | 433| uint32_t | 返回渲染单元字形数量。 | 434 435### OH_Drawing_GetRunFont() 436 437``` 438OH_Drawing_Font* OH_Drawing_GetRunFont(OH_Drawing_Run* run) 439``` 440 441**描述** 442 443获取渲染单元字体对象。 444 445**系统能力：** SystemCapability.Graphic.Graphic2D.NativeDrawing 446 447**起始版本：** 20 448 449**参数：** 450 451| 参数项 | 描述 | 452| -- | -- | 453| [OH_Drawing_Run](capi-drawing-oh-drawing-run.md)* run | 指向渲染单元[OH_Drawing_Run](capi-drawing-oh-drawing-run.md)对象的指针。 | 454 455**返回：** 456 457| 类型 | 说明 | 458| -- | -- | 459| [OH_Drawing_Font](capi-drawing-oh-drawing-font.md)* | 返回指向渲染单元字体[OH_Drawing_Font](capi-drawing-oh-drawing-font.md)对象的指针，不再需要[OH_Drawing_Font](capi-drawing-oh-drawing-font.md)时，请使用[OH_Drawing_FontDestroy](capi-drawing-font-h.md#oh_drawing_fontdestroy)接口释放该对象的指针。 | 460 461### OH_Drawing_GetRunTextDirection() 462 463``` 464OH_Drawing_TextDirection OH_Drawing_GetRunTextDirection(OH_Drawing_Run* run) 465``` 466 467**描述** 468 469获取渲染单元文本方向。 470 471**系统能力：** SystemCapability.Graphic.Graphic2D.NativeDrawing 472 473**起始版本：** 20 474 475**参数：** 476 477| 参数项 | 描述 | 478| -- | -- | 479| [OH_Drawing_Run](capi-drawing-oh-drawing-run.md)* run | 指向渲染单元[OH_Drawing_Run](capi-drawing-oh-drawing-run.md)对象的指针。 | 480 481**返回：** 482 483| 类型 | 说明 | 484| -- | -- | 485| [OH_Drawing_TextDirection](capi-drawing-text-typography-h.md#oh_drawing_textdirection) | 返回渲染单元的文本方向。0为TEXT_DIRECTION_RTL，方向为从右到左；1为TEXT_DIRECTION_LTR，方向为从左到右，具体可见[OH_Drawing_TextDirection](capi-drawing-text-typography-h.md#oh_drawing_textdirection)枚举。 | 486 487### OH_Drawing_GetRunGlyphAdvances() 488 489``` 490OH_Drawing_Array* OH_Drawing_GetRunGlyphAdvances(OH_Drawing_Run* run, uint32_t start, uint32_t length) 491``` 492 493**描述** 494 495获取渲染单元字体宽度数组。 496 497**系统能力：** SystemCapability.Graphic.Graphic2D.NativeDrawing 498 499**起始版本：** 20 500 501 502**参数：** 503 504| 参数项 | 描述 | 505| -- | -- | 506| [OH_Drawing_Run](capi-drawing-oh-drawing-run.md)* run | 指向渲染单元[OH_Drawing_Run](capi-drawing-oh-drawing-run.md)对象的指针。 | 507| uint32_t start | 渲染单元内指定的开始位置，传入负数时该方法返回空指针。 | 508| uint32_t length | 渲染单元内指定的长度，如果length是0表示从start开始获取到渲染块结束，length小于0时该方法返回空指针。 | 509 510**返回：** 511 512| 类型 | 说明 | 513| -- | -- | 514| [OH_Drawing_Array](capi-drawing-oh-drawing-array.md)* | 返回指向渲染单元字形位置数组[OH_Drawing_Array](capi-drawing-oh-drawing-array.md)对象的指针，不再需要[OH_Drawing_Array](capi-drawing-oh-drawing-array.md)时，请使用[OH_Drawing_DestroyRunGlyphAdvances](capi-drawing-text-run-h.md#oh_drawing_destroyrunglyphadvances)接口释放该对象的指针。 | 515 516 517### OH_Drawing_GetRunGlyphAdvanceByIndex() 518 519``` 520OH_Drawing_Point* OH_Drawing_GetRunGlyphAdvanceByIndex(OH_Drawing_Array* advances, size_t index) 521``` 522 523**描述** 524 525根据索引获取渲染单元中单个字形宽度。 526 527**系统能力：** SystemCapability.Graphic.Graphic2D.NativeDrawing 528 529**起始版本：** 20 530 531 532**参数：** 533 534| 参数项 | 描述 | 535| -- | -- | 536| [OH_Drawing_Array](capi-drawing-oh-drawing-array.md)* advances | 指向渲染单元字形宽度数组[OH_Drawing_Array](capi-drawing-oh-drawing-array.md)对象的指针。 | 537| size_t index | 渲染单元字形宽度数组的下标。 | 538 539**返回：** 540 541| 类型 | 说明 | 542| -- | -- | 543| [OH_Drawing_Point](capi-drawing-oh-drawing-point.md)* | 返回指向渲染单元单个字形宽度[OH_Drawing_Point](capi-drawing-oh-drawing-point.md)对象的指针。其中，[OH_Drawing_Point](capi-drawing-oh-drawing-point.md)对象的x值代表渲染单元单个字形宽度，y值为保留字段，默认返回0。 | 544 545### OH_Drawing_DestroyRunGlyphAdvances() 546 547``` 548void OH_Drawing_DestroyRunGlyphAdvances(OH_Drawing_Array* advances) 549``` 550 551**描述** 552 553释放渲染单元字形宽度数组对象的指针。 554 555**系统能力：** SystemCapability.Graphic.Graphic2D.NativeDrawing 556 557**起始版本：** 20 558 559 560**参数：** 561 562| 参数项 | 描述 | 563| -- | -- | 564| [OH_Drawing_Array](capi-drawing-oh-drawing-array.md)* advances | 指向渲染单元字形宽度数组[OH_Drawing_Array](capi-drawing-oh-drawing-array.md)对象的指针。 | 565 566 567