Go to most recent revision | Details | Last modification | View Log | RSS feed
Rev | Author | Line No. | Line |
---|---|---|---|
4349 | Serge | 1 | /***************************************************************************/ |
2 | /* */ |
||
3 | /* cf2blues.h */ |
||
4 | /* */ |
||
5 | /* Adobe's code for handling Blue Zones (specification). */ |
||
6 | /* */ |
||
7 | /* Copyright 2009-2013 Adobe Systems Incorporated. */ |
||
8 | /* */ |
||
9 | /* This software, and all works of authorship, whether in source or */ |
||
10 | /* object code form as indicated by the copyright notice(s) included */ |
||
11 | /* herein (collectively, the "Work") is made available, and may only be */ |
||
12 | /* used, modified, and distributed under the FreeType Project License, */ |
||
13 | /* LICENSE.TXT. Additionally, subject to the terms and conditions of the */ |
||
14 | /* FreeType Project License, each contributor to the Work hereby grants */ |
||
15 | /* to any individual or legal entity exercising permissions granted by */ |
||
16 | /* the FreeType Project License and this section (hereafter, "You" or */ |
||
17 | /* "Your") a perpetual, worldwide, non-exclusive, no-charge, */ |
||
18 | /* royalty-free, irrevocable (except as stated in this section) patent */ |
||
19 | /* license to make, have made, use, offer to sell, sell, import, and */ |
||
20 | /* otherwise transfer the Work, where such license applies only to those */ |
||
21 | /* patent claims licensable by such contributor that are necessarily */ |
||
22 | /* infringed by their contribution(s) alone or by combination of their */ |
||
23 | /* contribution(s) with the Work to which such contribution(s) was */ |
||
24 | /* submitted. If You institute patent litigation against any entity */ |
||
25 | /* (including a cross-claim or counterclaim in a lawsuit) alleging that */ |
||
26 | /* the Work or a contribution incorporated within the Work constitutes */ |
||
27 | /* direct or contributory patent infringement, then any patent licenses */ |
||
28 | /* granted to You under this License for that Work shall terminate as of */ |
||
29 | /* the date such litigation is filed. */ |
||
30 | /* */ |
||
31 | /* By using, modifying, or distributing the Work you indicate that you */ |
||
32 | /* have read and understood the terms and conditions of the */ |
||
33 | /* FreeType Project License as well as those provided in this section, */ |
||
34 | /* and you accept them fully. */ |
||
35 | /* */ |
||
36 | /***************************************************************************/ |
||
37 | |||
38 | |||
39 | /* |
||
40 | * A `CF2_Blues' object stores the blue zones (horizontal alignment |
||
41 | * zones) of a font. These are specified in the CFF private dictionary |
||
42 | * by `BlueValues', `OtherBlues', `FamilyBlues', and `FamilyOtherBlues'. |
||
43 | * Each zone is defined by a top and bottom edge in character space. |
||
44 | * Further, each zone is either a top zone or a bottom zone, as recorded |
||
45 | * by `bottomZone'. |
||
46 | * |
||
47 | * The maximum number of `BlueValues' and `FamilyBlues' is 7 each. |
||
48 | * However, these are combined to produce a total of 7 zones. |
||
49 | * Similarly, the maximum number of `OtherBlues' and `FamilyOtherBlues' |
||
50 | * is 5 and these are combined to produce an additional 5 zones. |
||
51 | * |
||
52 | * Blue zones are used to `capture' hints and force them to a common |
||
53 | * alignment point. This alignment is recorded in device space in |
||
54 | * `dsFlatEdge'. Except for this value, a `CF2_Blues' object could be |
||
55 | * constructed independently of scaling. Construction may occur once |
||
56 | * the matrix is known. Other features implemented in the Capture |
||
57 | * method are overshoot suppression, overshoot enforcement, and Blue |
||
58 | * Boost. |
||
59 | * |
||
60 | * Capture is determined by `BlueValues' and `OtherBlues', but the |
||
61 | * alignment point may be adjusted to the scaled flat edge of |
||
62 | * `FamilyBlues' or `FamilyOtherBlues'. No alignment is done to the |
||
63 | * curved edge of a zone. |
||
64 | * |
||
65 | */ |
||
66 | |||
67 | |||
68 | #ifndef __CF2BLUES_H__ |
||
69 | #define __CF2BLUES_H__ |
||
70 | |||
71 | |||
72 | #include "cf2glue.h" |
||
73 | |||
74 | |||
75 | FT_BEGIN_HEADER |
||
76 | |||
77 | |||
78 | /* |
||
79 | * `CF2_Hint' is shared by `cf2hints.h' and |
||
80 | * `cf2blues.h', but `cf2blues.h' depends on |
||
81 | * `cf2hints.h', so define it here. Note: The typedef is in |
||
82 | * `cf2glue.h'. |
||
83 | * |
||
84 | */ |
||
85 | enum |
||
86 | { |
||
87 | CF2_GhostBottom = 0x1, /* a single bottom edge */ |
||
88 | CF2_GhostTop = 0x2, /* a single top edge */ |
||
89 | CF2_PairBottom = 0x4, /* the bottom edge of a stem hint */ |
||
90 | CF2_PairTop = 0x8, /* the top edge of a stem hint */ |
||
91 | CF2_Locked = 0x10, /* this edge has been aligned */ |
||
92 | /* by a blue zone */ |
||
93 | CF2_Synthetic = 0x20 /* this edge was synthesized */ |
||
94 | }; |
||
95 | |||
96 | |||
97 | /* |
||
98 | * Default value for OS/2 typoAscender/Descender when their difference |
||
99 | * is not equal to `unitsPerEm'. The default is based on -250 and 1100 |
||
100 | * in `CF2_Blues', assuming 1000 units per em here. |
||
101 | * |
||
102 | */ |
||
103 | enum |
||
104 | { |
||
105 | CF2_ICF_Top = cf2_intToFixed( 880 ), |
||
106 | CF2_ICF_Bottom = cf2_intToFixed( -120 ) |
||
107 | }; |
||
108 | |||
109 | |||
110 | /* |
||
111 | * Constant used for hint adjustment and for synthetic em box hint |
||
112 | * placement. |
||
113 | */ |
||
114 | #define CF2_MIN_COUNTER cf2_floatToFixed( 0.5 ) |
||
115 | |||
116 | |||
117 | /* shared typedef is in cf2glue.h */ |
||
118 | struct CF2_HintRec_ |
||
119 | { |
||
120 | CF2_UInt flags; /* attributes of the edge */ |
||
121 | size_t index; /* index in original stem hint array */ |
||
122 | /* (if not synthetic) */ |
||
123 | CF2_Fixed csCoord; |
||
124 | CF2_Fixed dsCoord; |
||
125 | CF2_Fixed scale; |
||
126 | }; |
||
127 | |||
128 | |||
129 | typedef struct CF2_BlueRec_ |
||
130 | { |
||
131 | CF2_Fixed csBottomEdge; |
||
132 | CF2_Fixed csTopEdge; |
||
133 | CF2_Fixed csFlatEdge; /* may be from either local or Family zones */ |
||
134 | CF2_Fixed dsFlatEdge; /* top edge of bottom zone or bottom edge */ |
||
135 | /* of top zone (rounded) */ |
||
136 | FT_Bool bottomZone; |
||
137 | |||
138 | } CF2_BlueRec; |
||
139 | |||
140 | |||
141 | /* max total blue zones is 12 */ |
||
142 | enum |
||
143 | { |
||
144 | CF2_MAX_BLUES = 7, |
||
145 | CF2_MAX_OTHERBLUES = 5 |
||
146 | }; |
||
147 | |||
148 | |||
149 | typedef struct CF2_BluesRec_ |
||
150 | { |
||
151 | CF2_Fixed scale; |
||
152 | CF2_UInt count; |
||
153 | FT_Bool suppressOvershoot; |
||
154 | FT_Bool doEmBoxHints; |
||
155 | |||
156 | CF2_Fixed blueScale; |
||
157 | CF2_Fixed blueShift; |
||
158 | CF2_Fixed blueFuzz; |
||
159 | |||
160 | CF2_Fixed boost; |
||
161 | |||
162 | CF2_HintRec emBoxTopEdge; |
||
163 | CF2_HintRec emBoxBottomEdge; |
||
164 | |||
165 | CF2_BlueRec zone[CF2_MAX_BLUES + CF2_MAX_OTHERBLUES]; |
||
166 | |||
167 | } CF2_BluesRec, *CF2_Blues; |
||
168 | |||
169 | |||
170 | FT_LOCAL( void ) |
||
171 | cf2_blues_init( CF2_Blues blues, |
||
172 | CF2_Font font ); |
||
173 | FT_LOCAL( FT_Bool ) |
||
174 | cf2_blues_capture( const CF2_Blues blues, |
||
175 | CF2_Hint bottomHintEdge, |
||
176 | CF2_Hint topHintEdge ); |
||
177 | |||
178 | |||
179 | FT_END_HEADER |
||
180 | |||
181 | |||
182 | #endif /* __CF2BLUES_H__ */ |
||
183 | |||
184 | |||
185 | /* END */ |