Function

CTRunGetStatus

Returns the run's status.

Declaration

CTRunStatus CTRunGetStatus(CTRunRef run);

Parameters

run

The run for which to return the status.

Return Value

The run's status.

Discussion

Runs have status that can be used to expedite certain operations. Knowing the direction and ordering of a run's glyphs can aid in string index analysis, whereas knowing whether the positions reference the identity text matrix can avoid expensive comparisons. This status is provided as a convenience, because this information is not strictly necessary but can be helpful in some circumstances.

See Also

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.

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.