| | 1 | /***************************************************************************/ |
| | 2 | /* */ |
| | 3 | /* ahtypes.h */ |
| | 4 | /* */ |
| | 5 | /* General types and definitions for the auto-hint module */ |
| | 6 | /* (specification only). */ |
| | 7 | /* */ |
| | 8 | /* Copyright 2000 Catharon Productions Inc. */ |
| | 9 | /* Author: David Turner */ |
| | 10 | /* */ |
| | 11 | /* This file is part of the Catharon Typography Project and shall only */ |
| | 12 | /* be used, modified, and distributed under the terms of the Catharon */ |
| | 13 | /* Open Source License that should come with this file under the name */ |
| | 14 | /* `CatharonLicense.txt'. By continuing to use, modify, or distribute */ |
| | 15 | /* this file you indicate that you have read the license and */ |
| | 16 | /* understand and accept it fully. */ |
| | 17 | /* */ |
| | 18 | /* Note that this license is compatible with the FreeType license. */ |
| | 19 | /* */ |
| | 20 | /***************************************************************************/ |
| | 21 | |
| | 22 | |
| | 23 | #ifndef AHTYPES_H |
| | 24 | #define AHTYPES_H |
| | 25 | |
| | 26 | |
| | 27 | #include <freetype/internal/ftobjs.h> /* for freetype.h + LOCAL_DEF etc. */ |
| | 28 | |
| | 29 | |
| | 30 | #ifdef FT_FLAT_COMPILE |
| | 31 | |
| | 32 | #include "ahloader.h" |
| | 33 | |
| | 34 | #else |
| | 35 | |
| | 36 | #include <autohint/ahloader.h> |
| | 37 | |
| | 38 | #endif |
| | 39 | |
| | 40 | |
| | 41 | #define xxAH_DEBUG |
| | 42 | |
| | 43 | |
| | 44 | #ifdef AH_DEBUG |
| | 45 | |
| | 46 | #include <stdio.h> |
| | 47 | |
| | 48 | #define AH_LOG( x ) printf##x |
| | 49 | |
| | 50 | #else |
| | 51 | |
| | 52 | #define AH_LOG( x ) do ; while ( 0 ) /* nothing */ |
| | 53 | |
| | 54 | #endif |
| | 55 | |
| | 56 | |
| | 57 | /*************************************************************************/ |
| | 58 | /*************************************************************************/ |
| | 59 | /*************************************************************************/ |
| | 60 | /**** ****/ |
| | 61 | /**** COMPILE-TIME BUILD OPTIONS ****/ |
| | 62 | /**** ****/ |
| | 63 | /**** Toggle these configuration macros to experiment with `features' ****/ |
| | 64 | /**** of the auto-hinter. ****/ |
| | 65 | /**** ****/ |
| | 66 | /*************************************************************************/ |
| | 67 | /*************************************************************************/ |
| | 68 | /*************************************************************************/ |
| | 69 | |
| | 70 | |
| | 71 | /*************************************************************************/ |
| | 72 | /* */ |
| | 73 | /* If this option is defined, only strong interpolation will be used to */ |
| | 74 | /* place the points between edges. Otherwise, `smooth' points are */ |
| | 75 | /* detected and later hinted through weak interpolation to correct some */ |
| | 76 | /* unpleasant artefacts. */ |
| | 77 | /* */ |
| | 78 | #undef AH_OPTION_NO_WEAK_INTERPOLATION |
| | 79 | |
| | 80 | |
| | 81 | /*************************************************************************/ |
| | 82 | /* */ |
| | 83 | /* If this option is defined, only weak interpolation will be used to */ |
| | 84 | /* place the points between edges. Otherwise, `strong' points are */ |
| | 85 | /* detected and later hinted through strong interpolation to correct */ |
| | 86 | /* some unpleasant artefacts. */ |
| | 87 | /* */ |
| | 88 | #undef AH_OPTION_NO_STRONG_INTERPOLATION |
| | 89 | |
| | 90 | |
| | 91 | /*************************************************************************/ |
| | 92 | /* */ |
| | 93 | /* Undefine this macro if you don't want to hint the metrics. There is */ |
| | 94 | /* no reason to do this (at least for non-CJK scripts), except for */ |
| | 95 | /* experimentation. */ |
| | 96 | /* */ |
| | 97 | #define AH_HINT_METRICS |
| | 98 | |
| | 99 | |
| | 100 | /*************************************************************************/ |
| | 101 | /* */ |
| | 102 | /* Define this macro if you do not want to insert extra edges at a */ |
| | 103 | /* glyph's x and y extremum (if there isn't one already available). */ |
| | 104 | /* This helps to reduce a number of artefacts and allows hinting of */ |
| | 105 | /* metrics. */ |
| | 106 | /* */ |
| | 107 | #undef AH_OPTION_NO_EXTREMUM_EDGES |
| | 108 | |
| | 109 | |
| | 110 | /* don't touch for now */ |
| | 111 | #define AH_MAX_WIDTHS 12 |
| | 112 | #define AH_MAX_HEIGHTS 12 |
| | 113 | |
| | 114 | |
| | 115 | /*************************************************************************/ |
| | 116 | /*************************************************************************/ |
| | 117 | /*************************************************************************/ |
| | 118 | /**** ****/ |
| | 119 | /**** TYPE DEFINITIONS ****/ |
| | 120 | /**** ****/ |
| | 121 | /*************************************************************************/ |
| | 122 | /*************************************************************************/ |
| | 123 | /*************************************************************************/ |
| | 124 | |
| | 125 | |
| | 126 | /* see agangles.h */ |
| | 127 | typedef FT_Int AH_Angle; |
| | 128 | |
| | 129 | |
| | 130 | /* hint flags */ |
| | 131 | #define ah_flah_none 0 |
| | 132 | |
| | 133 | /* bezier control points flags */ |
| | 134 | #define ah_flah_conic 1 |
| | 135 | #define ah_flah_cubic 2 |
| | 136 | #define ah_flah_control ( ah_flah_conic | ah_flah_cubic ) |
| | 137 | |
| | 138 | /* extrema flags */ |
| | 139 | #define ah_flah_extrema_x 4 |
| | 140 | #define ah_flah_extrema_y 8 |
| | 141 | |
| | 142 | /* roundness */ |
| | 143 | #define ah_flah_round_x 16 |
| | 144 | #define ah_flah_round_y 32 |
| | 145 | |
| | 146 | /* touched */ |
| | 147 | #define ah_flah_touch_x 64 |
| | 148 | #define ah_flah_touch_y 128 |
| | 149 | |
| | 150 | /* weak interpolation */ |
| | 151 | #define ah_flah_weak_interpolation 256 |
| | 152 | |
| | 153 | typedef FT_Int AH_Flags; |
| | 154 | |
| | 155 | |
| | 156 | /* edge hint flags */ |
| | 157 | #define ah_edge_normal 0 |
| | 158 | #define ah_edge_round 1 |
| | 159 | #define ah_edge_serif 2 |
| | 160 | #define ah_edge_done 4 |
| | 161 | |
| | 162 | typedef FT_Int AH_Edge_Flags; |
| | 163 | |
| | 164 | |
| | 165 | /* hint directions -- the values are computed so that two vectors are */ |
| | 166 | /* in opposite directions iff `dir1+dir2 == 0' */ |
| | 167 | #define ah_dir_none 4 |
| | 168 | #define ah_dir_right 1 |
| | 169 | #define ah_dir_left -1 |
| | 170 | #define ah_dir_up 2 |
| | 171 | #define ah_dir_down -2 |
| | 172 | |
| | 173 | typedef FT_Int AH_Direction; |
| | 174 | |
| | 175 | |
| | 176 | typedef struct AH_Point AH_Point; |
| | 177 | typedef struct AH_Segment AH_Segment; |
| | 178 | typedef struct AH_Edge AH_Edge; |
| | 179 | |
| | 180 | |
| | 181 | /*************************************************************************/ |
| | 182 | /* */ |
| | 183 | /* <Struct> */ |
| | 184 | /* AH_Point */ |
| | 185 | /* */ |
| | 186 | /* <Description> */ |
| | 187 | /* A structure used to model an outline point to the AH_Outline type. */ |
| | 188 | /* */ |
| | 189 | /* <Fields> */ |
| | 190 | /* flags :: The current point hint flags. */ |
| | 191 | /* */ |
| | 192 | /* ox, oy :: The current original scaled coordinates. */ |
| | 193 | /* */ |
| | 194 | /* fx, fy :: The current coordinates in font units. */ |
| | 195 | /* */ |
| | 196 | /* x, y :: The current hinter coordinates. */ |
| | 197 | /* */ |
| | 198 | /* u, v :: Point coordinates -- meaning varies with context. */ |
| | 199 | /* */ |
| | 200 | /* in_dir :: The direction of the inwards vector (prev->point). */ |
| | 201 | /* */ |
| | 202 | /* out_dir :: The direction of the outwards vector (point->next). */ |
| | 203 | /* */ |
| | 204 | /* in_angle :: The angle of the inwards vector. */ |
| | 205 | /* */ |
| | 206 | /* out_angle :: The angle of the outwards vector. */ |
| | 207 | /* */ |
| | 208 | /* next :: The next point in same contour. */ |
| | 209 | /* */ |
| | 210 | /* prev :: The previous point in same contour. */ |
| | 211 | /* */ |
| | 212 | struct AH_Point |
| | 213 | { |
| | 214 | AH_Flags flags; /* point flags used by hinter */ |
| | 215 | FT_Pos ox, oy; |
| | 216 | FT_Pos fx, fy; |
| | 217 | FT_Pos x, y; |
| | 218 | FT_Pos u, v; |
| | 219 | |
| | 220 | AH_Direction in_dir; /* direction of inwards vector */ |
| | 221 | AH_Direction out_dir; /* direction of outwards vector */ |
| | 222 | |
| | 223 | AH_Angle in_angle; |
| | 224 | AH_Angle out_angle; |
| | 225 | |
| | 226 | AH_Point* next; /* next point in contour */ |
| | 227 | AH_Point* prev; /* previous point in contour */ |
| | 228 | }; |
| | 229 | |
| | 230 | |
| | 231 | /*************************************************************************/ |
| | 232 | /* */ |
| | 233 | /* <Struct> */ |
| | 234 | /* AH_Segment */ |
| | 235 | /* */ |
| | 236 | /* <Description> */ |
| | 237 | /* A structure used to describe an edge segment to the auto-hinter. */ |
| | 238 | /* A segment is simply a sequence of successive points located on the */ |
| | 239 | /* same horizontal or vertical `position', in a given direction. */ |
| | 240 | /* */ |
| | 241 | /* <Fields> */ |
| | 242 | /* flags :: The segment edge flags (straight, rounded, etc.). */ |
| | 243 | /* */ |
| | 244 | /* dir :: The segment direction. */ |
| | 245 | /* */ |
| | 246 | /* first :: The first point in the segment. */ |
| | 247 | /* */ |
| | 248 | /* last :: The last point in the segment. */ |
| | 249 | /* */ |
| | 250 | /* contour :: A pointer to the first point of the segment's */ |
| | 251 | /* contour. */ |
| | 252 | /* */ |
| | 253 | /* pos :: The segment position in font units. */ |
| | 254 | /* */ |
| | 255 | /* size :: The segment size. */ |
| | 256 | /* */ |
| | 257 | /* edge :: The edge of the current segment. */ |
| | 258 | /* */ |
| | 259 | /* edge_next :: The next segment on the same edge. */ |
| | 260 | /* */ |
| | 261 | /* link :: The pairing segment for this edge. */ |
| | 262 | /* */ |
| | 263 | /* serif :: The primary segment for serifs. */ |
| | 264 | /* */ |
| | 265 | /* num_linked :: The number of other segments that link to this one. */ |
| | 266 | /* */ |
| | 267 | /* score :: Used to score the segment when selecting them. */ |
| | 268 | /* */ |
| | 269 | struct AH_Segment |
| | 270 | { |
| | 271 | AH_Edge_Flags flags; |
| | 272 | AH_Direction dir; |
| | 273 | |
| | 274 | AH_Point* first; /* first point in edge segment */ |
| | 275 | AH_Point* last; /* last point in edge segment */ |
| | 276 | AH_Point** contour; /* ptr to first point of segment's contour */ |
| | 277 | |
| | 278 | FT_Pos pos; /* position of segment */ |
| | 279 | FT_Pos min_coord; /* minimum coordinate of segment */ |
| | 280 | FT_Pos max_coord; /* maximum coordinate of segment */ |
| | 281 | |
| | 282 | AH_Edge* edge; |
| | 283 | AH_Segment* edge_next; |
| | 284 | |
| | 285 | AH_Segment* link; /* link segment */ |
| | 286 | AH_Segment* serif; /* primary segment for serifs */ |
| | 287 | FT_Pos num_linked; /* number of linked segments */ |
| | 288 | FT_Int score; |
| | 289 | }; |
| | 290 | |
| | 291 | |
| | 292 | /*************************************************************************/ |
| | 293 | /* */ |
| | 294 | /* <Struct> */ |
| | 295 | /* AH_Edge */ |
| | 296 | /* */ |
| | 297 | /* <Description> */ |
| | 298 | /* A structure used to describe an edge, which really is a horizontal */ |
| | 299 | /* or vertical coordinate to be hinted depending on the segments */ |
| | 300 | /* located on it. */ |
| | 301 | /* */ |
| | 302 | /* <Fields> */ |
| | 303 | /* flags :: The segment edge flags (straight, rounded, etc.). */ |
| | 304 | /* */ |
| | 305 | /* dir :: The main segment direction on this edge. */ |
| | 306 | /* */ |
| | 307 | /* first :: The first edge segment. */ |
| | 308 | /* */ |
| | 309 | /* last :: The last edge segment. */ |
| | 310 | /* */ |
| | 311 | /* fpos :: The original edge position in font units. */ |
| | 312 | /* */ |
| | 313 | /* opos :: The original scaled edge position. */ |
| | 314 | /* */ |
| | 315 | /* pos :: The hinted edge position. */ |
| | 316 | /* */ |
| | 317 | /* link :: The linked edge. */ |
| | 318 | /* */ |
| | 319 | /* serif :: The serif edge. */ |
| | 320 | /* */ |
| | 321 | /* num_paired :: The number of other edges that pair to this one. */ |
| | 322 | /* */ |
| | 323 | /* score :: Used to score the edge when selecting them. */ |
| | 324 | /* */ |
| | 325 | /* blue_edge :: Indicate the blue zone edge this edge is related to. */ |
| | 326 | /* Only set for some of the horizontal edges in a Latin */ |
| | 327 | /* font. */ |
| | 328 | /* */ |
| | 329 | struct AH_Edge |
| | 330 | { |
| | 331 | AH_Edge_Flags flags; |
| | 332 | AH_Direction dir; |
| | 333 | |
| | 334 | AH_Segment* first; |
| | 335 | AH_Segment* last; |
| | 336 | |
| | 337 | FT_Pos fpos; |
| | 338 | FT_Pos opos; |
| | 339 | FT_Pos pos; |
| | 340 | |
| | 341 | AH_Edge* link; |
| | 342 | AH_Edge* serif; |
| | 343 | FT_Int num_linked; |
| | 344 | |
| | 345 | FT_Int score; |
| | 346 | FT_Pos* blue_edge; |
| | 347 | }; |
| | 348 | |
| | 349 | |
| | 350 | /* an outline as seen by the hinter */ |
| | 351 | typedef struct AH_Outline_ |
| | 352 | { |
| | 353 | FT_Memory memory; |
| | 354 | |
| | 355 | AH_Direction vert_major_dir; /* vertical major direction */ |
| | 356 | AH_Direction horz_major_dir; /* horizontal major direction */ |
| | 357 | |
| | 358 | FT_Fixed x_scale; |
| | 359 | FT_Fixed y_scale; |
| | 360 | FT_Pos edge_distance_threshold; |
| | 361 | |
| | 362 | FT_Int max_points; |
| | 363 | FT_Int num_points; |
| | 364 | AH_Point* points; |
| | 365 | |
| | 366 | FT_Int max_contours; |
| | 367 | FT_Int num_contours; |
| | 368 | AH_Point** contours; |
| | 369 | |
| | 370 | FT_Int num_hedges; |
| | 371 | AH_Edge* horz_edges; |
| | 372 | |
| | 373 | FT_Int num_vedges; |
| | 374 | AH_Edge* vert_edges; |
| | 375 | |
| | 376 | FT_Int num_hsegments; |
| | 377 | AH_Segment* horz_segments; |
| | 378 | |
| | 379 | FT_Int num_vsegments; |
| | 380 | AH_Segment* vert_segments; |
| | 381 | |
| | 382 | } AH_Outline; |
| | 383 | |
| | 384 | |
| | 385 | #define ah_blue_capital_top 0 /* THEZOCQS */ |
| | 386 | #define ah_blue_capital_bottom ( ah_blue_capital_top + 1 ) /* HEZLOCUS */ |
| | 387 | #define ah_blue_small_top ( ah_blue_capital_bottom + 1 ) /* xzroesc */ |
| | 388 | #define ah_blue_small_bottom ( ah_blue_small_top + 1 ) /* xzroesc */ |
| | 389 | #define ah_blue_small_minor ( ah_blue_small_bottom + 1 ) /* pqgjy */ |
| | 390 | #define ah_blue_max ( ah_blue_small_minor + 1 ) |
| | 391 | |
| | 392 | typedef FT_Int AH_Blue; |
| | 393 | |
| | 394 | |
| | 395 | #define ah_hinter_monochrome 1 |
| | 396 | #define ah_hinter_optimize 2 |
| | 397 | |
| | 398 | typedef FT_Int AH_Hinter_Flags; |
| | 399 | |
| | 400 | |
| | 401 | /*************************************************************************/ |
| | 402 | /* */ |
| | 403 | /* <Struct> */ |
| | 404 | /* AH_Globals */ |
| | 405 | /* */ |
| | 406 | /* <Description> */ |
| | 407 | /* Holds the global metrics for a given font face (be it in design */ |
| | 408 | /* units or scaled pixel values). */ |
| | 409 | /* */ |
| | 410 | /* <Fields> */ |
| | 411 | /* num_widths :: The number of widths. */ |
| | 412 | /* */ |
| | 413 | /* num_heights :: The number of heights. */ |
| | 414 | /* */ |
| | 415 | /* widths :: Snap widths, including standard one. */ |
| | 416 | /* */ |
| | 417 | /* heights :: Snap height, including standard one. */ |
| | 418 | /* */ |
| | 419 | /* blue_refs :: The reference positions of blue zones. */ |
| | 420 | /* */ |
| | 421 | /* blue_shoots :: The overshoot positions of blue zones. */ |
| | 422 | /* */ |
| | 423 | typedef struct AH_Globals_ |
| | 424 | { |
| | 425 | FT_Int num_widths; |
| | 426 | FT_Int num_heights; |
| | 427 | |
| | 428 | FT_Pos widths [AH_MAX_WIDTHS]; |
| | 429 | FT_Pos heights[AH_MAX_HEIGHTS]; |
| | 430 | |
| | 431 | FT_Pos blue_refs [ah_blue_max]; |
| | 432 | FT_Pos blue_shoots[ah_blue_max]; |
| | 433 | |
| | 434 | } AH_Globals; |
| | 435 | |
| | 436 | |
| | 437 | /*************************************************************************/ |
| | 438 | /* */ |
| | 439 | /* <Struct> */ |
| | 440 | /* AH_Face_Globals */ |
| | 441 | /* */ |
| | 442 | /* <Description> */ |
| | 443 | /* Holds the complete global metrics for a given font face (i.e., the */ |
| | 444 | /* design units version + a scaled version + the current scales */ |
| | 445 | /* used). */ |
| | 446 | /* */ |
| | 447 | /* <Fields> */ |
| | 448 | /* face :: A handle to the source face object */ |
| | 449 | /* */ |
| | 450 | /* design :: The globals in font design units. */ |
| | 451 | /* */ |
| | 452 | /* scaled :: Scaled globals in sub-pixel values. */ |
| | 453 | /* */ |
| | 454 | /* x_scale :: The current horizontal scale. */ |
| | 455 | /* */ |
| | 456 | /* y_scale :: The current vertical scale. */ |
| | 457 | /* */ |
| | 458 | typedef struct AH_Face_Globals_ |
| | 459 | { |
| | 460 | FT_Face face; |
| | 461 | AH_Globals design; |
| | 462 | AH_Globals scaled; |
| | 463 | FT_Fixed x_scale; |
| | 464 | FT_Fixed y_scale; |
| | 465 | FT_Bool control_overshoot; |
| | 466 | |
| | 467 | } AH_Face_Globals; |
| | 468 | |
| | 469 | |
| | 470 | typedef struct AH_Hinter |
| | 471 | { |
| | 472 | FT_Memory memory; |
| | 473 | AH_Hinter_Flags flags; |
| | 474 | |
| | 475 | FT_Int algorithm; |
| | 476 | FT_Face face; |
| | 477 | |
| | 478 | AH_Face_Globals* globals; |
| | 479 | |
| | 480 | AH_Outline* glyph; |
| | 481 | |
| | 482 | AH_Loader* loader; |
| | 483 | FT_Vector pp1; |
| | 484 | FT_Vector pp2; |
| | 485 | |
| | 486 | } AH_Hinter; |
| | 487 | |
| | 488 | |
| | 489 | #endif /* AHTYPES_H */ |
| | 490 | |
| | 491 | |
| | 492 | /* END */ |
projects / wxWidgets.git / blame_incremental