CTRun

A glyph run.

Overview

A glyph run is a set of consecutive glyphs sharing the same attributes and direction.

The typesetter creates glyph runs as it produces lines from character strings, attributes, and font objects. That is, a line is constructed of one or more glyphs runs. Glyph runs can draw themselves into a graphic context, if desired, although most users have no need to interact directly with glyph runs.

Topics

Getting Glyph Run Data

CTRunGetGlyphCount

Gets the glyph count for the run.

CTRunGetAttributes

Returns the attribute dictionary that was used to create the glyph run.

CTRunGetStatus

Returns the run's status.

CTRunGetGlyphsPtr

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

CTRunGetGlyphs

Copies a range of glyphs into a user-provided buffer.

CTRunGetPositionsPtr

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

CTRunGetPositions

Copies a range of glyph positions into a user-provided buffer.

CTRunGetAdvancesPtr

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

CTRunGetAdvances

Copies a range of glyph advances into a user-provided buffer.

CTRunGetStringIndicesPtr

Returns a direct pointer for the string indices stored in the run.

CTRunGetStringIndices

Copies a range of string indices into a user-provided buffer.

CTRunGetStringRange

Gets the range of characters that originally spawned the glyphs in the run.

Measuring the Glyph Run

CTLineGetBoundsWithOptions

Calculates the bounds for a line.

CTRunGetTypographicBounds

Gets the typographic bounds of the run.

CTRunGetImageBounds

Calculates the image bounds for a glyph range.

CTRunGetBaseAdvancesAndOrigins

Copies a range of base advances and origins into user-provided buffers.

Drawing the Glyph Run

CTRunDraw

Draws a complete run or part of one.

CTRunGetTextMatrix

Returns the text matrix needed to draw this run.

Getting the Type Identifier

CTRunGetTypeID

Returns the Core Foundation type identifier of the run object.

Data Types

CTRunRef

A reference to a run object.

Constants

CTRunStatus

A bitfield passed back by the CTRunGetStatus function that is used to indicate the disposition of the run.

See Also

Opaque Types

CTFont

A font object.

CTFramesetter

Generate text frames.

CTGlyphInfo

Override a font's specified mapping from Unicode to the glyph ID.

CTLine

A line of text.

CTParagraphStyle

Paragraph or ruler attributes in an attributed string.

CTTextTab

A tab in a paragraph style, storing an alignment type and location.

CTTypesetter

A typesetter which performs line layout.