1 /***************************************************************************/ 2 /* */ 3 /* cf2font.c */ 4 /* */ 5 /* Adobe's code for font instances (body). */ 6 /* */ 7 /* Copyright 2007-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 #include "cf2ft.h" 40 41 #include "cf2glue.h" 42 #include "cf2font.h" 43 #include "cf2error.h" 44 #include "cf2intrp.h" 45 46 47 /* Compute a stem darkening amount in character space. */ 48 static void cf2_computeDarkening(CF2_Fixed emRatio,CF2_Fixed ppem,CF2_Fixed stemWidth,CF2_Fixed * darkenAmount,CF2_Fixed boldenAmount,FT_Bool stemDarkened)49 cf2_computeDarkening( CF2_Fixed emRatio, 50 CF2_Fixed ppem, 51 CF2_Fixed stemWidth, 52 CF2_Fixed* darkenAmount, 53 CF2_Fixed boldenAmount, 54 FT_Bool stemDarkened ) 55 { 56 /* Internal calculations are done in units per thousand for */ 57 /* convenience. */ 58 CF2_Fixed stemWidthPer1000, scaledStem; 59 60 61 *darkenAmount = 0; 62 63 if ( boldenAmount == 0 && !stemDarkened ) 64 return; 65 66 /* protect against range problems and divide by zero */ 67 if ( emRatio < cf2_floatToFixed( .01 ) ) 68 return; 69 70 if ( stemDarkened ) 71 { 72 /* convert from true character space to 1000 unit character space; */ 73 /* add synthetic emboldening effect */ 74 75 /* we have to assure that the computation of `scaledStem' */ 76 /* and `stemWidthPer1000' don't overflow */ 77 78 stemWidthPer1000 = FT_MulFix( stemWidth + boldenAmount, emRatio ); 79 80 if ( emRatio > CF2_FIXED_ONE && 81 stemWidthPer1000 <= ( stemWidth + boldenAmount ) ) 82 { 83 stemWidthPer1000 = 0; /* to pacify compiler */ 84 scaledStem = cf2_intToFixed( 2333 ); 85 } 86 else 87 { 88 scaledStem = FT_MulFix( stemWidthPer1000, ppem ); 89 90 if ( ppem > CF2_FIXED_ONE && 91 scaledStem <= stemWidthPer1000 ) 92 scaledStem = cf2_intToFixed( 2333 ); 93 } 94 95 /* 96 * Total darkening amount is computed in 1000 unit character space 97 * using the modified 5 part curve as Avalon rasterizer. 98 * The darkening amount is smaller for thicker stems. 99 * It becomes zero when the stem is thicker than 2.333 pixels. 100 * 101 * In Avalon rasterizer, 102 * 103 * darkenAmount = 0.5 pixels if scaledStem <= 0.5 pixels, 104 * darkenAmount = 0.333 pixels if 1 <= scaledStem <= 1.667 pixels, 105 * darkenAmount = 0 pixel if scaledStem >= 2.333 pixels, 106 * 107 * and piecewise linear in-between. 108 * 109 */ 110 if ( scaledStem < cf2_intToFixed( 500 ) ) 111 *darkenAmount = FT_DivFix( cf2_intToFixed( 400 ), ppem ); 112 113 else if ( scaledStem < cf2_intToFixed( 1000 ) ) 114 *darkenAmount = FT_DivFix( cf2_intToFixed( 525 ), ppem ) - 115 FT_MulFix( stemWidthPer1000, 116 cf2_floatToFixed( .25 ) ); 117 118 else if ( scaledStem < cf2_intToFixed( 1667 ) ) 119 *darkenAmount = FT_DivFix( cf2_intToFixed( 275 ), ppem ); 120 121 else if ( scaledStem < cf2_intToFixed( 2333 ) ) 122 *darkenAmount = FT_DivFix( cf2_intToFixed( 963 ), ppem ) - 123 FT_MulFix( stemWidthPer1000, 124 cf2_floatToFixed( .413 ) ); 125 126 /* use half the amount on each side and convert back to true */ 127 /* character space */ 128 *darkenAmount = FT_DivFix( *darkenAmount, 2 * emRatio ); 129 } 130 131 /* add synthetic emboldening effect in character space */ 132 *darkenAmount += boldenAmount / 2; 133 } 134 135 136 /* set up values for the current FontDict and matrix */ 137 138 /* caller's transform is adjusted for subpixel positioning */ 139 static void cf2_font_setup(CF2_Font font,const CF2_Matrix * transform)140 cf2_font_setup( CF2_Font font, 141 const CF2_Matrix* transform ) 142 { 143 /* pointer to parsed font object */ 144 CFF_Decoder* decoder = font->decoder; 145 146 FT_Bool needExtraSetup; 147 148 /* character space units */ 149 CF2_Fixed boldenX = font->syntheticEmboldeningAmountX; 150 CF2_Fixed boldenY = font->syntheticEmboldeningAmountY; 151 152 CF2_Fixed ppem; 153 154 155 /* clear previous error */ 156 font->error = FT_Err_Ok; 157 158 /* if a CID fontDict has changed, we need to recompute some cached */ 159 /* data */ 160 needExtraSetup = font->lastSubfont != cf2_getSubfont( decoder ); 161 162 /* if ppem has changed, we need to recompute some cached data */ 163 /* note: because of CID font matrix concatenation, ppem and transform */ 164 /* do not necessarily track. */ 165 ppem = cf2_getPpemY( decoder ); 166 if ( font->ppem != ppem ) 167 { 168 font->ppem = ppem; 169 needExtraSetup = TRUE; 170 } 171 172 /* copy hinted flag on each call */ 173 font->hinted = font->renderingFlags & CF2_FlagsHinted; 174 175 /* determine if transform has changed; */ 176 /* include Fontmatrix but ignore translation */ 177 if ( ft_memcmp( transform, 178 &font->currentTransform, 179 4 * sizeof ( CF2_Fixed ) ) != 0 ) 180 { 181 /* save `key' information for `cache of one' matrix data; */ 182 /* save client transform, without the translation */ 183 font->currentTransform = *transform; 184 font->currentTransform.tx = 185 font->currentTransform.ty = cf2_intToFixed( 0 ); 186 187 /* TODO: FreeType transform is simple scalar; for now, use identity */ 188 /* for outer */ 189 font->innerTransform = *transform; 190 font->outerTransform.a = 191 font->outerTransform.d = cf2_intToFixed( 1 ); 192 font->outerTransform.b = 193 font->outerTransform.c = cf2_intToFixed( 0 ); 194 195 needExtraSetup = TRUE; 196 } 197 198 /* 199 * font->darkened is set to true if there is a stem darkening request or 200 * the font is synthetic emboldened. 201 * font->darkened controls whether to adjust blue zones, winding order, 202 * and hinting. 203 * 204 */ 205 if ( font->stemDarkened != ( font->renderingFlags & CF2_FlagsDarkened ) ) 206 { 207 font->stemDarkened = font->renderingFlags & CF2_FlagsDarkened; 208 209 /* blue zones depend on darkened flag */ 210 needExtraSetup = TRUE; 211 } 212 213 /* recompute variables that are dependent on transform or FontDict or */ 214 /* darken flag */ 215 if ( needExtraSetup ) 216 { 217 /* StdVW is found in the private dictionary; */ 218 /* recompute darkening amounts whenever private dictionary or */ 219 /* transform change */ 220 /* Note: a rendering flag turns darkening on or off, so we want to */ 221 /* store the `on' amounts; */ 222 /* darkening amount is computed in character space */ 223 /* TODO: testing size-dependent darkening here; */ 224 /* what to do for rotations? */ 225 226 CF2_Fixed emRatio; 227 CF2_Fixed stdHW; 228 CF2_Int unitsPerEm = font->unitsPerEm; 229 230 231 if ( unitsPerEm == 0 ) 232 unitsPerEm = 1000; 233 234 ppem = FT_MAX( cf2_intToFixed( 4 ), 235 font->ppem ); /* use minimum ppem of 4 */ 236 237 #if 0 238 /* since vstem is measured in the x-direction, we use the `a' member */ 239 /* of the fontMatrix */ 240 emRatio = cf2_fixedFracMul( cf2_intToFixed( 1000 ), fontMatrix->a ); 241 #endif 242 243 /* Freetype does not preserve the fontMatrix when parsing; use */ 244 /* unitsPerEm instead. */ 245 /* TODO: check precision of this */ 246 emRatio = cf2_intToFixed( 1000 ) / unitsPerEm; 247 font->stdVW = cf2_getStdVW( decoder ); 248 249 if ( font->stdVW <= 0 ) 250 font->stdVW = FT_DivFix( cf2_intToFixed( 75 ), emRatio ); 251 252 if ( boldenX > 0 ) 253 { 254 /* Ensure that boldenX is at least 1 pixel for synthetic bold font */ 255 /* (similar to what Avalon does) */ 256 boldenX = FT_MAX( boldenX, 257 FT_DivFix( cf2_intToFixed( unitsPerEm ), ppem ) ); 258 259 /* Synthetic emboldening adds at least 1 pixel to darkenX, while */ 260 /* stem darkening adds at most half pixel. Since the purpose of */ 261 /* stem darkening (readability at small sizes) is met with */ 262 /* synthetic emboldening, no need to add stem darkening for a */ 263 /* synthetic bold font. */ 264 cf2_computeDarkening( emRatio, 265 ppem, 266 font->stdVW, 267 &font->darkenX, 268 boldenX, 269 FALSE ); 270 } 271 else 272 cf2_computeDarkening( emRatio, 273 ppem, 274 font->stdVW, 275 &font->darkenX, 276 0, 277 font->stemDarkened ); 278 279 #if 0 280 /* since hstem is measured in the y-direction, we use the `d' member */ 281 /* of the fontMatrix */ 282 /* TODO: use the same units per em as above; check this */ 283 emRatio = cf2_fixedFracMul( cf2_intToFixed( 1000 ), fontMatrix->d ); 284 #endif 285 286 /* set the default stem width, because it must be the same for all */ 287 /* family members; */ 288 /* choose a constant for StdHW that depends on font contrast */ 289 stdHW = cf2_getStdHW( decoder ); 290 291 if ( stdHW > 0 && font->stdVW > 2 * stdHW ) 292 font->stdHW = FT_DivFix( cf2_intToFixed( 75 ), emRatio ); 293 else 294 { 295 /* low contrast font gets less hstem darkening */ 296 font->stdHW = FT_DivFix( cf2_intToFixed( 110 ), emRatio ); 297 } 298 299 cf2_computeDarkening( emRatio, 300 ppem, 301 font->stdHW, 302 &font->darkenY, 303 boldenY, 304 font->stemDarkened ); 305 306 if ( font->darkenX != 0 || font->darkenY != 0 ) 307 font->darkened = TRUE; 308 else 309 font->darkened = FALSE; 310 311 font->reverseWinding = FALSE; /* initial expectation is CCW */ 312 313 /* compute blue zones for this instance */ 314 cf2_blues_init( &font->blues, font ); 315 } 316 } 317 318 319 /* equivalent to AdobeGetOutline */ 320 FT_LOCAL_DEF( FT_Error ) cf2_getGlyphOutline(CF2_Font font,CF2_Buffer charstring,const CF2_Matrix * transform,CF2_F16Dot16 * glyphWidth)321 cf2_getGlyphOutline( CF2_Font font, 322 CF2_Buffer charstring, 323 const CF2_Matrix* transform, 324 CF2_F16Dot16* glyphWidth ) 325 { 326 FT_Error lastError = FT_Err_Ok; 327 328 FT_Vector translation; 329 330 #if 0 331 FT_Vector advancePoint; 332 #endif 333 334 CF2_Fixed advWidth = 0; 335 FT_Bool needWinding; 336 337 338 /* Note: use both integer and fraction for outlines. This allows bbox */ 339 /* to come out directly. */ 340 341 translation.x = transform->tx; 342 translation.y = transform->ty; 343 344 /* set up values based on transform */ 345 cf2_font_setup( font, transform ); 346 if ( font->error ) 347 goto exit; /* setup encountered an error */ 348 349 /* reset darken direction */ 350 font->reverseWinding = FALSE; 351 352 /* winding order only affects darkening */ 353 needWinding = font->darkened; 354 355 while ( 1 ) 356 { 357 /* reset output buffer */ 358 cf2_outline_reset( &font->outline ); 359 360 /* build the outline, passing the full translation */ 361 cf2_interpT2CharString( font, 362 charstring, 363 (CF2_OutlineCallbacks)&font->outline, 364 &translation, 365 FALSE, 366 0, 367 0, 368 &advWidth ); 369 370 if ( font->error ) 371 goto exit; 372 373 if ( !needWinding ) 374 break; 375 376 /* check winding order */ 377 if ( font->outline.root.windingMomentum >= 0 ) /* CFF is CCW */ 378 break; 379 380 /* invert darkening and render again */ 381 /* TODO: this should be a parameter to getOutline-computeOffset */ 382 font->reverseWinding = TRUE; 383 384 needWinding = FALSE; /* exit after next iteration */ 385 } 386 387 /* finish storing client outline */ 388 cf2_outline_close( &font->outline ); 389 390 exit: 391 /* FreeType just wants the advance width; there is no translation */ 392 *glyphWidth = advWidth; 393 394 /* free resources and collect errors from objects we've used */ 395 cf2_setError( &font->error, lastError ); 396 397 return font->error; 398 } 399 400 401 /* END */ 402