Contents

CTRunGetAdvancesPtr(_:)

Returns a direct pointer for the glyph advance array stored in the run.

Declaration

func CTRunGetAdvancesPtr(_ run: CTRun) -> UnsafePointer<CGSize>?

Parameters

  • run:

    The run whose advances you wish to access.

Return Value

A valid pointer to an array of CGSize structures representing the glyph advance array or NULL.

Discussion

The advance array will have a length equal to the value returned by CTRunGetGlyphCount(_:). The caller should be prepared for this function to return NULL even if there are glyphs in the stream. Should this function return NULL, the caller needs allocate its own buffer and call CTRunGetAdvances(_:_:_:) to fetch the advances. Note that advances alone are not sufficient for correctly positioning glyphs in a line, as a run may have a non-identity matrix or the initial glyph in a line may have a non-zero origin; callers should consider using positions instead.

See Also

Getting Glyph Run Data