Core Text
Apple application programming interface
Core Text is a Core Foundation style API in macOS, first introduced in Mac OS X 10.4 Tiger, made public in Mac OS X 10.5 Leopard, and introduced for the iPad with iPhone SDK 3.2. Exposing a C API, it replaces the text rendering abilities of the now-deprecated QuickDraw and ATSUI frameworks in previous versions of Mac OS X. According to Apple, Core Text is "designed for high performance and ease of use" and its layout API is "simple, consistent, and tightly integrated with Core Foundation, Core Graphics, and Cocoa."
01Features
Core Text provides the following opaque types:
- CTFramesetter - creates CTFrame objects from given attributed string object and CGPath object using CTTypesetter.
- CTTypesetter - performs line layouts; e.g., line breaking
- CTFrame - represents an array of lines (i.e., CTLine objects).
- CTLine - represents an array of glyph runs.
- CTRun - an ordered collection of glyphs sharing the same attribute.
- CTFont - represents a font.
02Example
The following code displays the text "Hello, World!" to the given graphics context in Objective-C.
// Prepare font CTFontRef font = CTFontCreateWithName(CFSTR("Times"), 48, NULL); // Create an attributed string CFStringRef keys[] = { kCTFontAttributeName }; CFTypeRef values[] = { font }; CFDictionaryRef attr = CFDictionaryCreate(NULL, (const void **)&keys, (const void **)&values, sizeof(keys) / sizeof(keys[0]), &kCFTypeDictionaryKeyCallBacks, &kCFTypeDictionaryValueCallBacks); CFAttributedStringRef attrString = CFAttributedStringCreate(NULL, CFSTR("Hello, World!"), attr); CFRelease(attr); // Draw the string CTLineRef line = CTLineCreateWithAttributedString(attrString); CGContextSetTextMatrix(context, CGAffineTransformIdentity); //Use this one when using standard view coordinates //CGContextSetTextMatrix(context, CGAffineTransformMakeScale(1.0, -1.0)); //Use this one if the view's coordinates are flipped CGContextSetTextPosition(context, 10, 20); CTLineDraw(line, context); // Clean up CFRelease(line); CFRelease(attrString); CFRelease(font);Sources and credits
This article is adapted from the Wikipedia article “Core Text”, written by its contributors and licensed under CC BY-SA 4.0. Fathomly has changed the layout, removed citation markers, navigation and maintenance notices, and adjusted punctuation. This adapted version is shared under the same license. For references, see the original article.
Fathomly is not affiliated with or endorsed by the Wikimedia Foundation. Spotted a problem? Tell us.