OLD | NEW |
(Empty) | |
| 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 */ |
OLD | NEW |