Function

CTFontDrawGlyphs

Renders the given glyphs of a font at the specified positions in the supplied graphics context.

Declaration

void CTFontDrawGlyphs(CTFontRef font, const CGGlyph *glyphs, const CGPoint *positions, size_t count, CGContextRef context);

Parameters

font

The font with glyphs to render. If the font has a size or matrix attribute, context is set with these values.

glyphs

The glyphs to be rendered. The glyphs should be the result of proper Unicode text layout operations (such as with CTLine). Functions such as CTFontGetGlyphsForCharacters do not perform any Unicode text layout.

positions

The positions (origins) for each glyph in glyphs. The positions are in user space. The number of positions passed in must match the number of glyphs (in glyphs).

count

The number of glyphs to be rendered from the glyphs array.

context

The graphics context used to render the glyphs.

Discussion

This function modifies graphics state including font, text size, and text matrix if these attributes are specified in font. These attributes are not restored.

See Also

Working with Glyphs

CTFontGetGlyphsForCharacters

Provides basic Unicode encoding for the given font, returning by reference an array of CGGlyph values corresponding to a given array of Unicode characters for the given font.

CTFontGetLigatureCaretPositions

Returns caret positions within a glyph.