Copyright © 2009 Zynga Game Networks. All .ttf files in this project are from http://www.webpagepublicity.com/free-fonts.html This project provides 4 classes and 2 categories which are used to render text in custom fonts. ZFont ----- ZFont is the equivalent of UIFont but for arbitrary fonts. Note that UIFont reports a larger ascender for some fonts (including Helvetica) than ZFont does. I do not know why this occurs. ZFont uses CoreGraphics to determine this information. FontManager ----------- FontManager is used to cache CGFontRef objects so you can look them up by name, the same way that UIFont caches its internal font objects by name. ### Usage: Call `-[FontManager loadFont:]` once for each font you care about, generally as part of your application startup. You then look up the ZFont objects later with `-[FontManager zFontWithName:]`. If you don't call `-loadFont:`, it will be called automatically for you when you call `-zFontWithName:`. NSString (FontLabelStringDrawing) --------------------------------- This category is modeled after NSString (UIStringDrawing) and provides the basic mechanism for drawing text in a given CGFontRef. It differs in three key areas from UIStringDrawing: * Wrapping of sized/drawn strings properly character-wraps really long words that cannot fit on a single line by themselves even when the lineBreakMode is UILineBreakModeWordWrap. UIStringDrawing appears to behave incorrectly under the same circumstances. * Only some line break modes are supported at the moment. Notably, Clip and Head/Middle truncation are not supported. * UIFont reports a larger ascender for the system font (Helvetica) than ZFont. I cannot figure out why this is. This means UIStringDrawing/UILabel will size any text rendered in Helvetica with a taller bounding box than FontLabelStringDrawing. Usage should be the same as the corresponding methods from UIStringDrawing. ZAttributedString/ZMutableAttributedString ------------------------------------------ ZAttributedString is an implementation of an attributed string, patterned after NSAttributedString from desktop Cocoa. The primary difference is ZMutableAttributedString does not offer a -mutableString method. ZAttributedString (ZAttributedStringDrawing) -------------------------------------------- This category mimics NSString (FontLabelStringDrawing) but provides drawing primitives for ZAttributedString instead. They should all work like their FontLabelStringDrawing counterparts. FontLabel --------- This is a subclass of UILabel that draws text using a ZFont instead of a UIFont. It uses FontLabelStringDrawing internally to do the heavy lifting. Wrapping, tail truncation, and `-sizeToFit` work, as do the standard `textAlignment`/`textColor` properties. A new `zAttributedText` property has been added that allows for attributed string rendering. The following properties are ignored: * enabled * font (use zFont instead) * shadowColor * shadowOffset ## TODO - support more properties from UILabel