public
Description: A project that includes a module for drawing arbitrary .ttf fonts for iPhone.
Homepage: http://zynga.com/
Clone URL: git://github.com/zynga/FontLabel.git
FontLabel / README
100644 77 lines (54 sloc) 3.027 kb
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
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