1/***************************************************************************/
2/*                                                                         */
3/*  ttsubpix.c                                                             */
4/*                                                                         */
5/*    TrueType Subpixel Hinting.                                           */
6/*                                                                         */
7/*  Copyright 2010-2013 by                                                 */
8/*  David Turner, Robert Wilhelm, and Werner Lemberg.                      */
9/*                                                                         */
10/*  This file is part of the FreeType project, and may only be used,       */
11/*  modified, and distributed under the terms of the FreeType project      */
12/*  license, LICENSE.TXT.  By continuing to use, modify, or distribute     */
13/*  this file you indicate that you have read the license and              */
14/*  understand and accept it fully.                                        */
15/*                                                                         */
16/***************************************************************************/
17
18#include <ft2build.h>
19#include FT_INTERNAL_DEBUG_H
20#include FT_INTERNAL_CALC_H
21#include FT_INTERNAL_STREAM_H
22#include FT_INTERNAL_SFNT_H
23#include FT_TRUETYPE_TAGS_H
24#include FT_OUTLINE_H
25#include FT_TRUETYPE_DRIVER_H
26
27#include "ttsubpix.h"
28
29
30#ifdef TT_CONFIG_OPTION_SUBPIXEL_HINTING
31
32  /*************************************************************************/
33  /*                                                                       */
34  /* These rules affect how the TT Interpreter does hinting, with the      */
35  /* goal of doing subpixel hinting by (in general) ignoring x moves.      */
36  /* Some of these rules are fixes that go above and beyond the            */
37  /* stated techniques in the MS whitepaper on Cleartype, due to           */
38  /* artifacts in many glyphs.  So, these rules make some glyphs render    */
39  /* better than they do in the MS rasterizer.                             */
40  /*                                                                       */
41  /* "" string or 0 int/char indicates to apply to all glyphs.             */
42  /* "-" used as dummy placeholders, but any non-matching string works.    */
43  /*                                                                       */
44  /* Some of this could arguably be implemented in fontconfig, however:    */
45  /*                                                                       */
46  /*  - Fontconfig can't set things on a glyph-by-glyph basis.             */
47  /*  - The tweaks that happen here are very low-level, from an average    */
48  /*    user's point of view and are best implemented in the hinter.       */
49  /*                                                                       */
50  /* The goal is to make the subpixel hinting techniques as generalized    */
51  /* as possible across all fonts to prevent the need for extra rules such */
52  /* as these.                                                             */
53  /*                                                                       */
54  /* The rule structure is designed so that entirely new rules can easily  */
55  /* be added when a new compatibility feature is discovered.              */
56  /*                                                                       */
57  /* The rule structures could also use some enhancement to handle ranges. */
58  /*                                                                       */
59  /*     ****************** WORK IN PROGRESS *******************           */
60  /*                                                                       */
61
62  /* These are `classes' of fonts that can be grouped together and used in */
63  /* rules below.  A blank entry "" is required at the end of these!       */
64#define FAMILY_CLASS_RULES_SIZE  7
65
66  static const SPH_Font_Class FAMILY_CLASS_Rules
67                              [FAMILY_CLASS_RULES_SIZE] =
68  {
69    { "MS Legacy Fonts",
70      { "Aharoni",
71        "Andale Mono",
72        "Andalus",
73        "Angsana New",
74        "AngsanaUPC",
75        "Arabic Transparent",
76        "Arial Black",
77        "Arial Narrow",
78        "Arial Unicode MS",
79        "Arial",
80        "Batang",
81        "Browallia New",
82        "BrowalliaUPC",
83        "Comic Sans MS",
84        "Cordia New",
85        "CordiaUPC",
86        "Courier New",
87        "DFKai-SB",
88        "David Transparent",
89        "David",
90        "DilleniaUPC",
91        "Estrangelo Edessa",
92        "EucrosiaUPC",
93        "FangSong_GB2312",
94        "Fixed Miriam Transparent",
95        "FrankRuehl",
96        "Franklin Gothic Medium",
97        "FreesiaUPC",
98        "Garamond",
99        "Gautami",
100        "Georgia",
101        "Gulim",
102        "Impact",
103        "IrisUPC",
104        "JasmineUPC",
105        "KaiTi_GB2312",
106        "KodchiangUPC",
107        "Latha",
108        "Levenim MT",
109        "LilyUPC",
110        "Lucida Console",
111        "Lucida Sans Unicode",
112        "MS Gothic",
113        "MS Mincho",
114        "MV Boli",
115        "Mangal",
116        "Marlett",
117        "Microsoft Sans Serif",
118        "Mingliu",
119        "Miriam Fixed",
120        "Miriam Transparent",
121        "Miriam",
122        "Narkisim",
123        "Palatino Linotype",
124        "Raavi",
125        "Rod Transparent",
126        "Rod",
127        "Shruti",
128        "SimHei",
129        "Simplified Arabic Fixed",
130        "Simplified Arabic",
131        "Simsun",
132        "Sylfaen",
133        "Symbol",
134        "Tahoma",
135        "Times New Roman",
136        "Traditional Arabic",
137        "Trebuchet MS",
138        "Tunga",
139        "Verdana",
140        "Webdings",
141        "Wingdings",
142        "",
143      },
144    },
145    { "Core MS Legacy Fonts",
146      { "Arial Black",
147        "Arial Narrow",
148        "Arial Unicode MS",
149        "Arial",
150        "Comic Sans MS",
151        "Courier New",
152        "Garamond",
153        "Georgia",
154        "Impact",
155        "Lucida Console",
156        "Lucida Sans Unicode",
157        "Microsoft Sans Serif",
158        "Palatino Linotype",
159        "Tahoma",
160        "Times New Roman",
161        "Trebuchet MS",
162        "Verdana",
163        "",
164      },
165    },
166    { "Apple Legacy Fonts",
167      { "Geneva",
168        "Times",
169        "Monaco",
170        "Century",
171        "Chalkboard",
172        "Lobster",
173        "Century Gothic",
174        "Optima",
175        "Lucida Grande",
176        "Gill Sans",
177        "Baskerville",
178        "Helvetica",
179        "Helvetica Neue",
180        "",
181      },
182    },
183    { "Legacy Sans Fonts",
184      { "Andale Mono",
185        "Arial Unicode MS",
186        "Arial",
187        "Century Gothic",
188        "Comic Sans MS",
189        "Franklin Gothic Medium",
190        "Geneva",
191        "Lucida Console",
192        "Lucida Grande",
193        "Lucida Sans Unicode",
194        "Lucida Sans Typewriter",
195        "Microsoft Sans Serif",
196        "Monaco",
197        "Tahoma",
198        "Trebuchet MS",
199        "Verdana",
200        "",
201      },
202    },
203
204    { "Misc Legacy Fonts",
205      { "Dark Courier", "", }, },
206    { "Verdana Clones",
207      { "DejaVu Sans",
208        "Bitstream Vera Sans", "", }, },
209    { "Verdana and Clones",
210      { "DejaVu Sans",
211        "Bitstream Vera Sans",
212        "Verdana", "", }, },
213  };
214
215
216  /* Define this to force natural (i.e. not bitmap-compatible) widths.     */
217  /* The default leans strongly towards natural widths except for a few    */
218  /* legacy fonts where a selective combination produces nicer results.    */
219/* #define FORCE_NATURAL_WIDTHS   */
220
221
222  /* Define `classes' of styles that can be grouped together and used in   */
223  /* rules below.  A blank entry "" is required at the end of these!       */
224#define STYLE_CLASS_RULES_SIZE  5
225
226  const SPH_Font_Class STYLE_CLASS_Rules
227                       [STYLE_CLASS_RULES_SIZE] =
228  {
229    { "Regular Class",
230      { "Regular",
231        "Book",
232        "Medium",
233        "Roman",
234        "Normal",
235        "",
236      },
237    },
238    { "Regular/Italic Class",
239      { "Regular",
240        "Book",
241        "Medium",
242        "Italic",
243        "Oblique",
244        "Roman",
245        "Normal",
246        "",
247      },
248    },
249    { "Bold/BoldItalic Class",
250      { "Bold",
251        "Bold Italic",
252        "Black",
253        "",
254      },
255    },
256    { "Bold/Italic/BoldItalic Class",
257      { "Bold",
258        "Bold Italic",
259        "Black",
260        "Italic",
261        "Oblique",
262        "",
263      },
264    },
265    { "Regular/Bold Class",
266      { "Regular",
267        "Book",
268        "Medium",
269        "Normal",
270        "Roman",
271        "Bold",
272        "Black",
273        "",
274      },
275    },
276  };
277
278
279  /* Force special legacy fixes for fonts.                                 */
280#define COMPATIBILITY_MODE_RULES_SIZE  1
281
282  const SPH_TweakRule  COMPATIBILITY_MODE_Rules
283                       [COMPATIBILITY_MODE_RULES_SIZE] =
284  {
285    { "-", 0, "", 0 },
286  };
287
288
289  /* Don't do subpixel (ignore_x_mode) hinting; do normal hinting.         */
290#define PIXEL_HINTING_RULES_SIZE  2
291
292  const SPH_TweakRule  PIXEL_HINTING_Rules
293                       [PIXEL_HINTING_RULES_SIZE] =
294  {
295    /* these characters are almost always safe */
296    { "Courier New", 12, "Italic", 'z' },
297    { "Courier New", 11, "Italic", 'z' },
298  };
299
300
301  /* Subpixel hinting ignores SHPIX rules on X.  Force SHPIX for these.    */
302#define DO_SHPIX_RULES_SIZE  1
303
304  const SPH_TweakRule  DO_SHPIX_Rules
305                       [DO_SHPIX_RULES_SIZE] =
306  {
307    { "-", 0, "", 0 },
308  };
309
310
311  /* Skip Y moves that start with a point that is not on a Y pixel         */
312  /* boundary and don't move that point to a Y pixel boundary.             */
313#define SKIP_NONPIXEL_Y_MOVES_RULES_SIZE  4
314
315  const SPH_TweakRule  SKIP_NONPIXEL_Y_MOVES_Rules
316                       [SKIP_NONPIXEL_Y_MOVES_RULES_SIZE] =
317  {
318    /* fix vwxyz thinness*/
319    { "Consolas", 0, "", 0 },
320    /* Fix thin middle stems */
321    { "Core MS Legacy Fonts", 0, "Regular", 0 },
322    /* Cyrillic small letter I */
323    { "Legacy Sans Fonts", 0, "", 0 },
324    /* Fix artifacts with some Regular & Bold */
325    { "Verdana Clones", 0, "", 0 },
326  };
327
328
329#define SKIP_NONPIXEL_Y_MOVES_RULES_EXCEPTIONS_SIZE  1
330
331  const SPH_TweakRule  SKIP_NONPIXEL_Y_MOVES_Rules_Exceptions
332                       [SKIP_NONPIXEL_Y_MOVES_RULES_EXCEPTIONS_SIZE] =
333  {
334    /* Fixes < and > */
335    { "Courier New", 0, "Regular", 0 },
336  };
337
338
339  /* Skip Y moves that start with a point that is not on a Y pixel         */
340  /* boundary and don't move that point to a Y pixel boundary.             */
341#define SKIP_NONPIXEL_Y_MOVES_DELTAP_RULES_SIZE  2
342
343  const SPH_TweakRule  SKIP_NONPIXEL_Y_MOVES_DELTAP_Rules
344                       [SKIP_NONPIXEL_Y_MOVES_DELTAP_RULES_SIZE] =
345  {
346    /* Maintain thickness of diagonal in 'N' */
347    { "Times New Roman", 0, "Regular/Bold Class", 'N' },
348    { "Georgia", 0, "Regular/Bold Class", 'N' },
349  };
350
351
352  /* Skip Y moves that move a point off a Y pixel boundary.                */
353#define SKIP_OFFPIXEL_Y_MOVES_RULES_SIZE  1
354
355  const SPH_TweakRule  SKIP_OFFPIXEL_Y_MOVES_Rules
356                       [SKIP_OFFPIXEL_Y_MOVES_RULES_SIZE] =
357  {
358    { "-", 0, "", 0 },
359  };
360
361
362#define SKIP_OFFPIXEL_Y_MOVES_RULES_EXCEPTIONS_SIZE  1
363
364  const SPH_TweakRule  SKIP_OFFPIXEL_Y_MOVES_Rules_Exceptions
365                       [SKIP_OFFPIXEL_Y_MOVES_RULES_EXCEPTIONS_SIZE] =
366  {
367    { "-", 0, "", 0 },
368  };
369
370
371  /* Round moves that don't move a point to a Y pixel boundary.            */
372#define ROUND_NONPIXEL_Y_MOVES_RULES_SIZE  2
373
374  const SPH_TweakRule  ROUND_NONPIXEL_Y_MOVES_Rules
375                       [ROUND_NONPIXEL_Y_MOVES_RULES_SIZE] =
376  {
377    /* Droid font instructions don't snap Y to pixels */
378    { "Droid Sans", 0, "Regular/Italic Class", 0 },
379    { "Droid Sans Mono", 0, "", 0 },
380  };
381
382
383#define ROUND_NONPIXEL_Y_MOVES_RULES_EXCEPTIONS_SIZE  1
384
385  const SPH_TweakRule  ROUND_NONPIXEL_Y_MOVES_Rules_Exceptions
386                       [ROUND_NONPIXEL_Y_MOVES_RULES_EXCEPTIONS_SIZE] =
387  {
388    { "-", 0, "", 0 },
389  };
390
391
392  /* Allow a Direct_Move along X freedom vector if matched.                */
393#define ALLOW_X_DMOVE_RULES_SIZE  1
394
395  const SPH_TweakRule  ALLOW_X_DMOVE_Rules
396                       [ALLOW_X_DMOVE_RULES_SIZE] =
397  {
398    /* Fixes vanishing diagonal in 4 */
399    { "Verdana", 0, "Regular", '4' },
400  };
401
402
403  /* Return MS rasterizer version 35 if matched.                           */
404#define RASTERIZER_35_RULES_SIZE  8
405
406  const SPH_TweakRule  RASTERIZER_35_Rules
407                       [RASTERIZER_35_RULES_SIZE] =
408  {
409    /* This seems to be the only way to make these look good */
410    { "Times New Roman", 0, "Regular", 'i' },
411    { "Times New Roman", 0, "Regular", 'j' },
412    { "Times New Roman", 0, "Regular", 'm' },
413    { "Times New Roman", 0, "Regular", 'r' },
414    { "Times New Roman", 0, "Regular", 'a' },
415    { "Times New Roman", 0, "Regular", 'n' },
416    { "Times New Roman", 0, "Regular", 'p' },
417    { "Times", 0, "", 0 },
418  };
419
420
421  /* Don't round to the subpixel grid.  Round to pixel grid.               */
422#define NORMAL_ROUND_RULES_SIZE  1
423
424  const SPH_TweakRule  NORMAL_ROUND_Rules
425                       [NORMAL_ROUND_RULES_SIZE] =
426  {
427    /* Fix serif thickness for certain ppems */
428    /* Can probably be generalized somehow   */
429    { "Courier New", 0, "", 0 },
430  };
431
432
433  /* Skip IUP instructions if matched.                                     */
434#define SKIP_IUP_RULES_SIZE  1
435
436  const SPH_TweakRule  SKIP_IUP_Rules
437                       [SKIP_IUP_RULES_SIZE] =
438  {
439    { "Arial", 13, "Regular", 'a' },
440  };
441
442
443  /* Skip MIAP Twilight hack if matched.                                   */
444#define MIAP_HACK_RULES_SIZE  1
445
446  const SPH_TweakRule  MIAP_HACK_Rules
447                       [MIAP_HACK_RULES_SIZE] =
448  {
449    { "Geneva", 12, "", 0 },
450  };
451
452
453  /* Skip DELTAP instructions if matched.                                  */
454#define ALWAYS_SKIP_DELTAP_RULES_SIZE  23
455
456  const SPH_TweakRule  ALWAYS_SKIP_DELTAP_Rules
457                       [ALWAYS_SKIP_DELTAP_RULES_SIZE] =
458  {
459    { "Georgia", 0, "Regular", 'k' },
460    /* fix various problems with e in different versions */
461    { "Trebuchet MS", 14, "Regular", 'e' },
462    { "Trebuchet MS", 13, "Regular", 'e' },
463    { "Trebuchet MS", 15, "Regular", 'e' },
464    { "Trebuchet MS", 0, "Italic", 'v' },
465    { "Trebuchet MS", 0, "Italic", 'w' },
466    { "Trebuchet MS", 0, "Regular", 'Y' },
467    { "Arial", 11, "Regular", 's' },
468    /* prevent problems with '3' and others */
469    { "Verdana", 10, "Regular", 0 },
470    { "Verdana", 9, "Regular", 0 },
471    /* Cyrillic small letter short I */
472    { "Legacy Sans Fonts", 0, "", 0x438 },
473    { "Legacy Sans Fonts", 0, "", 0x439 },
474    { "Arial", 10, "Regular", '6' },
475    { "Arial", 0, "Bold/BoldItalic Class", 'a' },
476    /* Make horizontal stems consistent with the rest */
477    { "Arial", 24, "Bold", 'a' },
478    { "Arial", 25, "Bold", 'a' },
479    { "Arial", 24, "Bold", 's' },
480    { "Arial", 25, "Bold", 's' },
481    { "Arial", 34, "Bold", 's' },
482    { "Arial", 35, "Bold", 's' },
483    { "Arial", 36, "Bold", 's' },
484    { "Arial", 25, "Regular", 's' },
485    { "Arial", 26, "Regular", 's' },
486  };
487
488
489  /* Always do DELTAP instructions if matched.                             */
490#define ALWAYS_DO_DELTAP_RULES_SIZE  1
491
492  const SPH_TweakRule  ALWAYS_DO_DELTAP_Rules
493                       [ALWAYS_DO_DELTAP_RULES_SIZE] =
494  {
495    { "-", 0, "", 0 },
496  };
497
498
499  /* Don't allow ALIGNRP after IUP.                                        */
500#define NO_ALIGNRP_AFTER_IUP_RULES_SIZE  1
501
502  static const SPH_TweakRule  NO_ALIGNRP_AFTER_IUP_Rules
503                              [NO_ALIGNRP_AFTER_IUP_RULES_SIZE] =
504  {
505    /* Prevent creation of dents in outline */
506    { "-", 0, "", 0 },
507  };
508
509
510  /* Don't allow DELTAP after IUP.                                         */
511#define NO_DELTAP_AFTER_IUP_RULES_SIZE  1
512
513  static const SPH_TweakRule  NO_DELTAP_AFTER_IUP_Rules
514                              [NO_DELTAP_AFTER_IUP_RULES_SIZE] =
515  {
516    { "-", 0, "", 0 },
517  };
518
519
520  /* Don't allow CALL after IUP.                                           */
521#define NO_CALL_AFTER_IUP_RULES_SIZE  1
522
523  static const SPH_TweakRule  NO_CALL_AFTER_IUP_Rules
524                              [NO_CALL_AFTER_IUP_RULES_SIZE] =
525  {
526    /* Prevent creation of dents in outline */
527    { "-", 0, "", 0 },
528  };
529
530
531  /* De-embolden these glyphs slightly.                                    */
532#define DEEMBOLDEN_RULES_SIZE  9
533
534  static const SPH_TweakRule  DEEMBOLDEN_Rules
535                              [DEEMBOLDEN_RULES_SIZE] =
536  {
537    { "Courier New", 0, "Bold", 'A' },
538    { "Courier New", 0, "Bold", 'W' },
539    { "Courier New", 0, "Bold", 'w' },
540    { "Courier New", 0, "Bold", 'M' },
541    { "Courier New", 0, "Bold", 'X' },
542    { "Courier New", 0, "Bold", 'K' },
543    { "Courier New", 0, "Bold", 'x' },
544    { "Courier New", 0, "Bold", 'z' },
545    { "Courier New", 0, "Bold", 'v' },
546  };
547
548
549  /* Embolden these glyphs slightly.                                       */
550#define EMBOLDEN_RULES_SIZE  2
551
552  static const SPH_TweakRule  EMBOLDEN_Rules
553                              [EMBOLDEN_RULES_SIZE] =
554  {
555    { "Courier New", 0, "Regular", 0 },
556    { "Courier New", 0, "Italic", 0 },
557  };
558
559
560  /* This is a CVT hack that makes thick horizontal stems on 2, 5, 7       */
561  /* similar to Windows XP.                                                */
562#define TIMES_NEW_ROMAN_HACK_RULES_SIZE  12
563
564  static const SPH_TweakRule  TIMES_NEW_ROMAN_HACK_Rules
565                              [TIMES_NEW_ROMAN_HACK_RULES_SIZE] =
566  {
567    { "Times New Roman", 16, "Italic", '2' },
568    { "Times New Roman", 16, "Italic", '5' },
569    { "Times New Roman", 16, "Italic", '7' },
570    { "Times New Roman", 16, "Regular", '2' },
571    { "Times New Roman", 16, "Regular", '5' },
572    { "Times New Roman", 16, "Regular", '7' },
573    { "Times New Roman", 17, "Italic", '2' },
574    { "Times New Roman", 17, "Italic", '5' },
575    { "Times New Roman", 17, "Italic", '7' },
576    { "Times New Roman", 17, "Regular", '2' },
577    { "Times New Roman", 17, "Regular", '5' },
578    { "Times New Roman", 17, "Regular", '7' },
579  };
580
581
582  /* This fudges distance on 2 to get rid of the vanishing stem issue.     */
583  /* A real solution to this is certainly welcome.                         */
584#define COURIER_NEW_2_HACK_RULES_SIZE  15
585
586  static const SPH_TweakRule  COURIER_NEW_2_HACK_Rules
587                              [COURIER_NEW_2_HACK_RULES_SIZE] =
588  {
589    { "Courier New", 10, "Regular", '2' },
590    { "Courier New", 11, "Regular", '2' },
591    { "Courier New", 12, "Regular", '2' },
592    { "Courier New", 13, "Regular", '2' },
593    { "Courier New", 14, "Regular", '2' },
594    { "Courier New", 15, "Regular", '2' },
595    { "Courier New", 16, "Regular", '2' },
596    { "Courier New", 17, "Regular", '2' },
597    { "Courier New", 18, "Regular", '2' },
598    { "Courier New", 19, "Regular", '2' },
599    { "Courier New", 20, "Regular", '2' },
600    { "Courier New", 21, "Regular", '2' },
601    { "Courier New", 22, "Regular", '2' },
602    { "Courier New", 23, "Regular", '2' },
603    { "Courier New", 24, "Regular", '2' },
604  };
605
606
607#ifndef FORCE_NATURAL_WIDTHS
608
609  /* Use compatible widths with these glyphs.  Compatible widths is always */
610  /* on when doing B/W TrueType instructing, but is used selectively here, */
611  /* typically on glyphs with 3 or more vertical stems.                    */
612#define COMPATIBLE_WIDTHS_RULES_SIZE  38
613
614  static const SPH_TweakRule  COMPATIBLE_WIDTHS_Rules
615                              [COMPATIBLE_WIDTHS_RULES_SIZE] =
616  {
617    { "Arial Unicode MS", 12, "Regular Class", 'm' },
618    { "Arial Unicode MS", 14, "Regular Class", 'm' },
619    /* Cyrillic small letter sha */
620    { "Arial", 10, "Regular Class", 0x448 },
621    { "Arial", 11, "Regular Class", 'm' },
622    { "Arial", 12, "Regular Class", 'm' },
623    /* Cyrillic small letter sha */
624    { "Arial", 12, "Regular Class", 0x448 },
625    { "Arial", 13, "Regular Class", 0x448 },
626    { "Arial", 14, "Regular Class", 'm' },
627    /* Cyrillic small letter sha */
628    { "Arial", 14, "Regular Class", 0x448 },
629    { "Arial", 15, "Regular Class", 0x448 },
630    { "Arial", 17, "Regular Class", 'm' },
631    { "DejaVu Sans", 15, "Regular Class", 0 },
632    { "Microsoft Sans Serif", 11, "Regular Class", 0 },
633    { "Microsoft Sans Serif", 12, "Regular Class", 0 },
634    { "Segoe UI", 11, "Regular Class", 0 },
635    { "Monaco", 0, "Regular Class", 0 },
636    { "Segoe UI", 12, "Regular Class", 'm' },
637    { "Segoe UI", 14, "Regular Class", 'm' },
638    { "Tahoma", 11, "Regular Class", 0 },
639    { "Times New Roman", 16, "Regular Class", 'c' },
640    { "Times New Roman", 16, "Regular Class", 'm' },
641    { "Times New Roman", 16, "Regular Class", 'o' },
642    { "Times New Roman", 16, "Regular Class", 'w' },
643    { "Trebuchet MS", 11, "Regular Class", 0 },
644    { "Trebuchet MS", 12, "Regular Class", 0 },
645    { "Trebuchet MS", 14, "Regular Class", 0 },
646    { "Trebuchet MS", 15, "Regular Class", 0 },
647    { "Ubuntu", 12, "Regular Class", 'm' },
648    /* Cyrillic small letter sha */
649    { "Verdana", 10, "Regular Class", 0x448 },
650    { "Verdana", 11, "Regular Class", 0x448 },
651    { "Verdana and Clones", 12, "Regular Class", 'i' },
652    { "Verdana and Clones", 12, "Regular Class", 'j' },
653    { "Verdana and Clones", 12, "Regular Class", 'l' },
654    { "Verdana and Clones", 12, "Regular Class", 'm' },
655    { "Verdana and Clones", 13, "Regular Class", 'i' },
656    { "Verdana and Clones", 13, "Regular Class", 'j' },
657    { "Verdana and Clones", 13, "Regular Class", 'l' },
658    { "Verdana and Clones", 14, "Regular Class", 'm' },
659  };
660
661
662  /* Scaling slightly in the x-direction prior to hinting results in       */
663  /* more visually pleasing glyphs in certain cases.                       */
664  /* This sometimes needs to be coordinated with compatible width rules.   */
665  /* A value of 1000 corresponds to a scaled value of 1.0.                 */
666
667#define X_SCALING_RULES_SIZE  50
668
669  static const SPH_ScaleRule  X_SCALING_Rules[X_SCALING_RULES_SIZE] =
670  {
671    { "DejaVu Sans", 12, "Regular Class", 'm', 950 },
672    { "Verdana and Clones", 12, "Regular Class", 'a', 1100 },
673    { "Verdana and Clones", 13, "Regular Class", 'a', 1050 },
674    { "Arial", 11, "Regular Class", 'm', 975 },
675    { "Arial", 12, "Regular Class", 'm', 1050 },
676    /* Cyrillic small letter el */
677    { "Arial", 13, "Regular Class", 0x43B, 950 },
678    { "Arial", 13, "Regular Class", 'o', 950 },
679    { "Arial", 13, "Regular Class", 'e', 950 },
680    { "Arial", 14, "Regular Class", 'm', 950 },
681    /* Cyrillic small letter el */
682    { "Arial", 15, "Regular Class", 0x43B, 925 },
683    { "Bitstream Vera Sans", 10, "Regular/Italic Class", 0, 1100 },
684    { "Bitstream Vera Sans", 12, "Regular/Italic Class", 0, 1050 },
685    { "Bitstream Vera Sans", 16, "Regular Class", 0, 1050 },
686    { "Bitstream Vera Sans", 9, "Regular/Italic Class", 0, 1050 },
687    { "DejaVu Sans", 12, "Regular Class", 'l', 975 },
688    { "DejaVu Sans", 12, "Regular Class", 'i', 975 },
689    { "DejaVu Sans", 12, "Regular Class", 'j', 975 },
690    { "DejaVu Sans", 13, "Regular Class", 'l', 950 },
691    { "DejaVu Sans", 13, "Regular Class", 'i', 950 },
692    { "DejaVu Sans", 13, "Regular Class", 'j', 950 },
693    { "DejaVu Sans", 10, "Regular/Italic Class", 0, 1100 },
694    { "DejaVu Sans", 12, "Regular/Italic Class", 0, 1050 },
695    { "Georgia", 10, "", 0, 1050 },
696    { "Georgia", 11, "", 0, 1100 },
697    { "Georgia", 12, "", 0, 1025 },
698    { "Georgia", 13, "", 0, 1050 },
699    { "Georgia", 16, "", 0, 1050 },
700    { "Georgia", 17, "", 0, 1030 },
701    { "Liberation Sans", 12, "Regular Class", 'm', 1100 },
702    { "Lucida Grande", 11, "Regular Class", 'm', 1100 },
703    { "Microsoft Sans Serif", 11, "Regular Class", 'm', 950 },
704    { "Microsoft Sans Serif", 12, "Regular Class", 'm', 1050 },
705    { "Segoe UI", 12, "Regular Class", 'H', 1050 },
706    { "Segoe UI", 12, "Regular Class", 'm', 1050 },
707    { "Segoe UI", 14, "Regular Class", 'm', 1050 },
708    { "Tahoma", 11, "Regular Class", 'i', 975 },
709    { "Tahoma", 11, "Regular Class", 'l', 975 },
710    { "Tahoma", 11, "Regular Class", 'j', 900 },
711    { "Tahoma", 11, "Regular Class", 'm', 918 },
712    { "Verdana", 10, "Regular/Italic Class", 0, 1100 },
713    { "Verdana", 12, "Regular Class", 'm', 975 },
714    { "Verdana", 12, "Regular/Italic Class", 0, 1050 },
715    { "Verdana", 13, "Regular/Italic Class", 'i', 950 },
716    { "Verdana", 13, "Regular/Italic Class", 'j', 950 },
717    { "Verdana", 13, "Regular/Italic Class", 'l', 950 },
718    { "Verdana", 16, "Regular Class", 0, 1050 },
719    { "Verdana", 9, "Regular/Italic Class", 0, 1050 },
720    { "Times New Roman", 16, "Regular Class", 'm', 918 },
721    { "Trebuchet MS", 11, "Regular Class", 'm', 800 },
722    { "Trebuchet MS", 12, "Regular Class", 'm', 800 },
723  };
724
725#else
726
727#define COMPATIBLE_WIDTHS_RULES_SIZE  1
728
729  static const SPH_TweakRule  COMPATIBLE_WIDTHS_Rules
730                              [COMPATIBLE_WIDTHS_RULES_SIZE] =
731  {
732    { "-", 0, "", 0 },
733  };
734
735
736#define X_SCALING_RULES_SIZE  1
737
738  static const SPH_ScaleRule  X_SCALING_Rules
739                              [X_SCALING_RULES_SIZE] =
740  {
741    { "-", 0, "", 0, 1000 },
742  };
743
744#endif /* FORCE_NATURAL_WIDTHS */
745
746
747  FT_LOCAL_DEF( FT_Bool )
748  is_member_of_family_class( const FT_String*  detected_font_name,
749                             const FT_String*  rule_font_name )
750  {
751    FT_UInt  i, j;
752
753
754    /* Does font name match rule family? */
755    if ( strcmp( detected_font_name, rule_font_name ) == 0 )
756      return TRUE;
757
758    /* Is font name a wildcard ""? */
759    if ( strcmp( rule_font_name, "" ) == 0 )
760      return TRUE;
761
762    /* Is font name contained in a class list? */
763    for ( i = 0; i < FAMILY_CLASS_RULES_SIZE; i++ )
764    {
765      if ( strcmp( FAMILY_CLASS_Rules[i].name, rule_font_name ) == 0 )
766      {
767        for ( j = 0; j < SPH_MAX_CLASS_MEMBERS; j++ )
768        {
769          if ( strcmp( FAMILY_CLASS_Rules[i].member[j], "" ) == 0 )
770            continue;
771          if ( strcmp( FAMILY_CLASS_Rules[i].member[j],
772                       detected_font_name ) == 0 )
773            return TRUE;
774        }
775      }
776    }
777
778    return FALSE;
779  }
780
781
782  FT_LOCAL_DEF( FT_Bool )
783  is_member_of_style_class( const FT_String*  detected_font_style,
784                            const FT_String*  rule_font_style )
785  {
786    FT_UInt  i, j;
787
788
789    /* Does font style match rule style? */
790    if ( strcmp( detected_font_style, rule_font_style ) == 0 )
791      return TRUE;
792
793    /* Is font style a wildcard ""? */
794    if ( strcmp( rule_font_style, "" ) == 0 )
795      return TRUE;
796
797    /* Is font style contained in a class list? */
798    for ( i = 0; i < STYLE_CLASS_RULES_SIZE; i++ )
799    {
800      if ( strcmp( STYLE_CLASS_Rules[i].name, rule_font_style ) == 0 )
801      {
802        for ( j = 0; j < SPH_MAX_CLASS_MEMBERS; j++ )
803        {
804          if ( strcmp( STYLE_CLASS_Rules[i].member[j], "" ) == 0 )
805            continue;
806          if ( strcmp( STYLE_CLASS_Rules[i].member[j],
807                       detected_font_style ) == 0 )
808            return TRUE;
809        }
810      }
811    }
812
813    return FALSE;
814  }
815
816
817  FT_LOCAL_DEF( FT_Bool )
818  sph_test_tweak( TT_Face               face,
819                  const FT_String*      family,
820                  FT_UInt               ppem,
821                  const FT_String*      style,
822                  FT_UInt               glyph_index,
823                  const SPH_TweakRule*  rule,
824                  FT_UInt               num_rules )
825  {
826    FT_UInt  i;
827
828
829    /* rule checks may be able to be optimized further */
830    for ( i = 0; i < num_rules; i++ )
831    {
832      if ( family                                                   &&
833           ( is_member_of_family_class ( family, rule[i].family ) ) )
834        if ( rule[i].ppem == 0    ||
835             rule[i].ppem == ppem )
836          if ( style                                             &&
837               is_member_of_style_class ( style, rule[i].style ) )
838            if ( rule[i].glyph == 0                                ||
839                 FT_Get_Char_Index( (FT_Face)face,
840                                    rule[i].glyph ) == glyph_index )
841        return TRUE;
842    }
843
844    return FALSE;
845  }
846
847
848  static FT_UInt
849  scale_test_tweak( TT_Face               face,
850                    const FT_String*      family,
851                    FT_UInt               ppem,
852                    const FT_String*      style,
853                    FT_UInt               glyph_index,
854                    const SPH_ScaleRule*  rule,
855                    FT_UInt               num_rules )
856  {
857    FT_UInt  i;
858
859
860    /* rule checks may be able to be optimized further */
861    for ( i = 0; i < num_rules; i++ )
862    {
863      if ( family                                                   &&
864           ( is_member_of_family_class ( family, rule[i].family ) ) )
865        if ( rule[i].ppem == 0    ||
866             rule[i].ppem == ppem )
867          if ( style                                            &&
868               is_member_of_style_class( style, rule[i].style ) )
869            if ( rule[i].glyph == 0                                ||
870                 FT_Get_Char_Index( (FT_Face)face,
871                                    rule[i].glyph ) == glyph_index )
872        return rule[i].scale;
873    }
874
875    return 1000;
876  }
877
878
879  FT_LOCAL_DEF( FT_UInt )
880  sph_test_tweak_x_scaling( TT_Face           face,
881                            const FT_String*  family,
882                            FT_UInt           ppem,
883                            const FT_String*  style,
884                            FT_UInt           glyph_index )
885  {
886    return scale_test_tweak( face, family, ppem, style, glyph_index,
887                             X_SCALING_Rules, X_SCALING_RULES_SIZE );
888  }
889
890
891#define TWEAK_RULES( x )                                       \
892  if ( sph_test_tweak( face, family, ppem, style, glyph_index, \
893                       x##_Rules, x##_RULES_SIZE ) )           \
894    loader->exec->sph_tweak_flags |= SPH_TWEAK_##x;
895
896#define TWEAK_RULES_EXCEPTIONS( x )                                        \
897  if ( sph_test_tweak( face, family, ppem, style, glyph_index,             \
898                       x##_Rules_Exceptions, x##_RULES_EXCEPTIONS_SIZE ) ) \
899    loader->exec->sph_tweak_flags &= ~SPH_TWEAK_##x;
900
901
902  FT_LOCAL_DEF( void )
903  sph_set_tweaks( TT_Loader  loader,
904                  FT_UInt    glyph_index )
905  {
906    TT_Face     face   = (TT_Face)loader->face;
907    FT_String*  family = face->root.family_name;
908    int         ppem   = loader->size->metrics.x_ppem;
909    FT_String*  style  = face->root.style_name;
910
911
912    /* don't apply rules if style isn't set */
913    if ( !face->root.style_name )
914      return;
915
916#ifdef SPH_DEBUG_MORE_VERBOSE
917    printf( "%s,%d,%s,%c=%d ",
918            family, ppem, style, glyph_index, glyph_index );
919#endif
920
921    TWEAK_RULES( PIXEL_HINTING );
922
923    if ( loader->exec->sph_tweak_flags & SPH_TWEAK_PIXEL_HINTING )
924    {
925      loader->exec->ignore_x_mode = FALSE;
926      return;
927    }
928
929    TWEAK_RULES( ALLOW_X_DMOVE );
930    TWEAK_RULES( ALWAYS_DO_DELTAP );
931    TWEAK_RULES( ALWAYS_SKIP_DELTAP );
932    TWEAK_RULES( DEEMBOLDEN );
933    TWEAK_RULES( DO_SHPIX );
934    TWEAK_RULES( EMBOLDEN );
935    TWEAK_RULES( MIAP_HACK );
936    TWEAK_RULES( NORMAL_ROUND );
937    TWEAK_RULES( NO_ALIGNRP_AFTER_IUP );
938    TWEAK_RULES( NO_CALL_AFTER_IUP );
939    TWEAK_RULES( NO_DELTAP_AFTER_IUP );
940    TWEAK_RULES( RASTERIZER_35 );
941    TWEAK_RULES( SKIP_IUP );
942
943    TWEAK_RULES( SKIP_OFFPIXEL_Y_MOVES );
944    TWEAK_RULES_EXCEPTIONS( SKIP_OFFPIXEL_Y_MOVES );
945
946    TWEAK_RULES( SKIP_NONPIXEL_Y_MOVES_DELTAP );
947
948    TWEAK_RULES( SKIP_NONPIXEL_Y_MOVES );
949    TWEAK_RULES_EXCEPTIONS( SKIP_NONPIXEL_Y_MOVES );
950
951    TWEAK_RULES( ROUND_NONPIXEL_Y_MOVES );
952    TWEAK_RULES_EXCEPTIONS( ROUND_NONPIXEL_Y_MOVES );
953
954    if ( loader->exec->sph_tweak_flags & SPH_TWEAK_RASTERIZER_35 )
955    {
956      if ( loader->exec->rasterizer_version != TT_INTERPRETER_VERSION_35 )
957      {
958        loader->exec->rasterizer_version = TT_INTERPRETER_VERSION_35;
959        loader->exec->size->cvt_ready    = FALSE;
960
961        tt_size_ready_bytecode(
962          loader->exec->size,
963          FT_BOOL( loader->load_flags & FT_LOAD_PEDANTIC ) );
964      }
965      else
966        loader->exec->rasterizer_version = TT_INTERPRETER_VERSION_35;
967    }
968    else
969    {
970      if ( loader->exec->rasterizer_version  !=
971           SPH_OPTION_SET_RASTERIZER_VERSION )
972      {
973        loader->exec->rasterizer_version = SPH_OPTION_SET_RASTERIZER_VERSION;
974        loader->exec->size->cvt_ready    = FALSE;
975
976        tt_size_ready_bytecode(
977          loader->exec->size,
978          FT_BOOL( loader->load_flags & FT_LOAD_PEDANTIC ) );
979      }
980      else
981        loader->exec->rasterizer_version = SPH_OPTION_SET_RASTERIZER_VERSION;
982    }
983
984    if ( IS_HINTED( loader->load_flags ) )
985    {
986      TWEAK_RULES( TIMES_NEW_ROMAN_HACK );
987      TWEAK_RULES( COURIER_NEW_2_HACK );
988    }
989
990    if ( sph_test_tweak( face, family, ppem, style, glyph_index,
991           COMPATIBILITY_MODE_Rules, COMPATIBILITY_MODE_RULES_SIZE ) )
992      loader->exec->face->sph_compatibility_mode = TRUE;
993
994
995    if ( IS_HINTED( loader->load_flags ) )
996    {
997      if ( sph_test_tweak( face, family, ppem, style, glyph_index,
998             COMPATIBLE_WIDTHS_Rules, COMPATIBLE_WIDTHS_RULES_SIZE ) )
999        loader->exec->compatible_widths |= TRUE;
1000    }
1001  }
1002
1003#else /* !TT_CONFIG_OPTION_SUBPIXEL_HINTING */
1004
1005  /* ANSI C doesn't like empty source files */
1006  typedef int  _tt_subpix_dummy;
1007
1008#endif /* !TT_CONFIG_OPTION_SUBPIXEL_HINTING */
1009
1010
1011/* END */
1012