Function

CTFontGetAdvancesForGlyphs

Calculates the advances for an array of glyphs and returns the summed advance.

Declaration

double CTFontGetAdvancesForGlyphs(CTFontRef font, CTFontOrientation orientation, const CGGlyph *glyphs, CGSize *advances, CFIndex count);

Parameters

font

The font reference.

orientation

The intended drawing orientation of the glyphs. Used to determined which glyph metrics to return.

glyphs

An array of count number of glyphs.

advances

An array of count number of CGSize objects to receive the computed glyph advances. If NULL, only the overall advance is calculated.

count

The capacity of the glyphs and advances buffers.

Return Value

The summed glyph advance of an array of glyphs.

Discussion

Individual glyph advances are passed back via the advances parameter. These are the ideal metrics for each glyph scaled and transformed in font space.

See Also

Getting Glyph Data

CTFontCreatePathForGlyph

Creates a path for the specified glyph.

CTFontGetGlyphWithName

Returns the CGGlyph value for the specified glyph name in the given font.

CTFontGetBoundingRectsForGlyphs

Calculates the bounding rects for an array of glyphs and returns the overall bounding rectangle for the glyph run.

CTFontGetOpticalBoundsForGlyphs

Calculates the optical bounds for an array of glyphs and returns the overall optical bounds for the run.

CTFontGetVerticalTranslationsForGlyphs

Calculates the offset from the default (horizontal) origin to the vertical origin for an array of glyphs.