source: trunk/poppler/freetype2/src/pshinter/pshalgo.c @ 182

Last change on this file since 182 was 182, checked in by Eugene Romanenko, 15 years ago

freetype update to version 2.3.0

File size: 60.1 KB
Line 
1/***************************************************************************/
2/*                                                                         */
3/*  pshalgo.c                                                              */
4/*                                                                         */
5/*    PostScript hinting algorithm (body).                                 */
6/*                                                                         */
7/*  Copyright 2001, 2002, 2003, 2004, 2005, 2006, 2007 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
19#include <ft2build.h>
20#include FT_INTERNAL_OBJECTS_H
21#include FT_INTERNAL_DEBUG_H
22#include FT_INTERNAL_CALC_H
23#include "pshalgo.h"
24
25#include "pshnterr.h"
26
27
28#undef  FT_COMPONENT
29#define FT_COMPONENT  trace_pshalgo2
30
31
32#ifdef DEBUG_HINTER
33  PSH_Hint_Table  ps_debug_hint_table = 0;
34  PSH_HintFunc    ps_debug_hint_func  = 0;
35  PSH_Glyph       ps_debug_glyph      = 0;
36#endif
37
38
39#define  COMPUTE_INFLEXS  /* compute inflection points to optimize `S' */
40                          /* and similar glyphs                        */
41#define  STRONGER         /* slightly increase the contrast of smooth  */
42                          /* hinting                                   */
43
44
45  /*************************************************************************/
46  /*************************************************************************/
47  /*****                                                               *****/
48  /*****                  BASIC HINTS RECORDINGS                       *****/
49  /*****                                                               *****/
50  /*************************************************************************/
51  /*************************************************************************/
52
53  /* return true if two stem hints overlap */
54  static FT_Int
55  psh_hint_overlap( PSH_Hint  hint1,
56                    PSH_Hint  hint2 )
57  {
58    return hint1->org_pos + hint1->org_len >= hint2->org_pos &&
59           hint2->org_pos + hint2->org_len >= hint1->org_pos;
60  }
61
62
63  /* destroy hints table */
64  static void
65  psh_hint_table_done( PSH_Hint_Table  table,
66                       FT_Memory       memory )
67  {
68    FT_FREE( table->zones );
69    table->num_zones = 0;
70    table->zone      = 0;
71
72    FT_FREE( table->sort );
73    FT_FREE( table->hints );
74    table->num_hints   = 0;
75    table->max_hints   = 0;
76    table->sort_global = 0;
77  }
78
79
80  /* deactivate all hints in a table */
81  static void
82  psh_hint_table_deactivate( PSH_Hint_Table  table )
83  {
84    FT_UInt   count = table->max_hints;
85    PSH_Hint  hint  = table->hints;
86
87
88    for ( ; count > 0; count--, hint++ )
89    {
90      psh_hint_deactivate( hint );
91      hint->order = -1;
92    }
93  }
94
95
96  /* internal function to record a new hint */
97  static void
98  psh_hint_table_record( PSH_Hint_Table  table,
99                         FT_UInt         idx )
100  {
101    PSH_Hint  hint = table->hints + idx;
102
103
104    if ( idx >= table->max_hints )
105    {
106      FT_ERROR(( "psh_hint_table_record: invalid hint index %d\n", idx ));
107      return;
108    }
109
110    /* ignore active hints */
111    if ( psh_hint_is_active( hint ) )
112      return;
113
114    psh_hint_activate( hint );
115
116    /* now scan the current active hint set to check */
117    /* whether `hint' overlaps with another hint     */
118    {
119      PSH_Hint*  sorted = table->sort_global;
120      FT_UInt    count  = table->num_hints;
121      PSH_Hint   hint2;
122
123
124      hint->parent = 0;
125      for ( ; count > 0; count--, sorted++ )
126      {
127        hint2 = sorted[0];
128
129        if ( psh_hint_overlap( hint, hint2 ) )
130        {
131          hint->parent = hint2;
132          break;
133        }
134      }
135    }
136
137    if ( table->num_hints < table->max_hints )
138      table->sort_global[table->num_hints++] = hint;
139    else
140      FT_ERROR(( "psh_hint_table_record: too many sorted hints!  BUG!\n" ));
141  }
142
143
144  static void
145  psh_hint_table_record_mask( PSH_Hint_Table  table,
146                              PS_Mask         hint_mask )
147  {
148    FT_Int    mask = 0, val = 0;
149    FT_Byte*  cursor = hint_mask->bytes;
150    FT_UInt   idx, limit;
151
152
153    limit = hint_mask->num_bits;
154
155    for ( idx = 0; idx < limit; idx++ )
156    {
157      if ( mask == 0 )
158      {
159        val  = *cursor++;
160        mask = 0x80;
161      }
162
163      if ( val & mask )
164        psh_hint_table_record( table, idx );
165
166      mask >>= 1;
167    }
168  }
169
170
171  /* create hints table */
172  static FT_Error
173  psh_hint_table_init( PSH_Hint_Table  table,
174                       PS_Hint_Table   hints,
175                       PS_Mask_Table   hint_masks,
176                       PS_Mask_Table   counter_masks,
177                       FT_Memory       memory )
178  {
179    FT_UInt   count;
180    FT_Error  error;
181
182    FT_UNUSED( counter_masks );
183
184
185    count = hints->num_hints;
186
187    /* allocate our tables */
188    if ( FT_NEW_ARRAY( table->sort,  2 * count     ) ||
189         FT_NEW_ARRAY( table->hints,     count     ) ||
190         FT_NEW_ARRAY( table->zones, 2 * count + 1 ) )
191      goto Exit;
192
193    table->max_hints   = count;
194    table->sort_global = table->sort + count;
195    table->num_hints   = 0;
196    table->num_zones   = 0;
197    table->zone        = 0;
198
199    /* initialize the `table->hints' array */
200    {
201      PSH_Hint  write = table->hints;
202      PS_Hint   read  = hints->hints;
203
204
205      for ( ; count > 0; count--, write++, read++ )
206      {
207        write->org_pos = read->pos;
208        write->org_len = read->len;
209        write->flags   = read->flags;
210      }
211    }
212
213    /* we now need to determine the initial `parent' stems; first  */
214    /* activate the hints that are given by the initial hint masks */
215    if ( hint_masks )
216    {
217      PS_Mask  mask = hint_masks->masks;
218
219
220      count             = hint_masks->num_masks;
221      table->hint_masks = hint_masks;
222
223      for ( ; count > 0; count--, mask++ )
224        psh_hint_table_record_mask( table, mask );
225    }
226
227    /* finally, do a linear parse in case some hints were left alone */
228    if ( table->num_hints != table->max_hints )
229    {
230      FT_UInt  idx;
231
232
233      FT_ERROR(( "psh_hint_table_init: missing/incorrect hint masks!\n" ));
234
235      count = table->max_hints;
236      for ( idx = 0; idx < count; idx++ )
237        psh_hint_table_record( table, idx );
238    }
239
240  Exit:
241    return error;
242  }
243
244
245  static void
246  psh_hint_table_activate_mask( PSH_Hint_Table  table,
247                                PS_Mask         hint_mask )
248  {
249    FT_Int    mask = 0, val = 0;
250    FT_Byte*  cursor = hint_mask->bytes;
251    FT_UInt   idx, limit, count;
252
253
254    limit = hint_mask->num_bits;
255    count = 0;
256
257    psh_hint_table_deactivate( table );
258
259    for ( idx = 0; idx < limit; idx++ )
260    {
261      if ( mask == 0 )
262      {
263        val  = *cursor++;
264        mask = 0x80;
265      }
266
267      if ( val & mask )
268      {
269        PSH_Hint  hint = &table->hints[idx];
270
271
272        if ( !psh_hint_is_active( hint ) )
273        {
274          FT_UInt     count2;
275
276#if 0
277          PSH_Hint*  sort = table->sort;
278          PSH_Hint   hint2;
279
280
281          for ( count2 = count; count2 > 0; count2--, sort++ )
282          {
283            hint2 = sort[0];
284            if ( psh_hint_overlap( hint, hint2 ) )
285              FT_ERROR(( "psh_hint_table_activate_mask:"
286                         " found overlapping hints\n" ))
287          }
288#else
289          count2 = 0;
290#endif
291
292          if ( count2 == 0 )
293          {
294            psh_hint_activate( hint );
295            if ( count < table->max_hints )
296              table->sort[count++] = hint;
297            else
298              FT_ERROR(( "psh_hint_tableactivate_mask:"
299                         " too many active hints\n" ));
300          }
301        }
302      }
303
304      mask >>= 1;
305    }
306    table->num_hints = count;
307
308    /* now, sort the hints; they are guaranteed to not overlap */
309    /* so we can compare their "org_pos" field directly        */
310    {
311      FT_Int     i1, i2;
312      PSH_Hint   hint1, hint2;
313      PSH_Hint*  sort = table->sort;
314
315
316      /* a simple bubble sort will do, since in 99% of cases, the hints */
317      /* will be already sorted -- and the sort will be linear          */
318      for ( i1 = 1; i1 < (FT_Int)count; i1++ )
319      {
320        hint1 = sort[i1];
321        for ( i2 = i1 - 1; i2 >= 0; i2-- )
322        {
323          hint2 = sort[i2];
324
325          if ( hint2->org_pos < hint1->org_pos )
326            break;
327
328          sort[i2 + 1] = hint2;
329          sort[i2]     = hint1;
330        }
331      }
332    }
333  }
334
335
336  /*************************************************************************/
337  /*************************************************************************/
338  /*****                                                               *****/
339  /*****               HINTS GRID-FITTING AND OPTIMIZATION             *****/
340  /*****                                                               *****/
341  /*************************************************************************/
342  /*************************************************************************/
343
344#if 1
345  static FT_Pos
346  psh_dimension_quantize_len( PSH_Dimension  dim,
347                              FT_Pos         len,
348                              FT_Bool        do_snapping )
349  {
350    if ( len <= 64 )
351      len = 64;
352    else
353    {
354      FT_Pos  delta = len - dim->stdw.widths[0].cur;
355
356
357      if ( delta < 0 )
358        delta = -delta;
359
360      if ( delta < 40 )
361      {
362        len = dim->stdw.widths[0].cur;
363        if ( len < 48 )
364          len = 48;
365      }
366
367      if ( len < 3 * 64 )
368      {
369        delta = ( len & 63 );
370        len  &= -64;
371
372        if ( delta < 10 )
373          len += delta;
374
375        else if ( delta < 32 )
376          len += 10;
377
378        else if ( delta < 54 )
379          len += 54;
380
381        else
382          len += delta;
383      }
384      else
385        len = FT_PIX_ROUND( len );
386    }
387
388    if ( do_snapping )
389      len = FT_PIX_ROUND( len );
390
391    return  len;
392  }
393#endif /* 0 */
394
395
396#ifdef DEBUG_HINTER
397
398  static void
399  ps_simple_scale( PSH_Hint_Table  table,
400                   FT_Fixed        scale,
401                   FT_Fixed        delta,
402                   FT_Int          dimension )
403  {
404    PSH_Hint  hint;
405    FT_UInt   count;
406
407
408    for ( count = 0; count < table->max_hints; count++ )
409    {
410      hint = table->hints + count;
411
412      hint->cur_pos = FT_MulFix( hint->org_pos, scale ) + delta;
413      hint->cur_len = FT_MulFix( hint->org_len, scale );
414
415      if ( ps_debug_hint_func )
416        ps_debug_hint_func( hint, dimension );
417    }
418  }
419
420#endif /* DEBUG_HINTER */
421
422
423  static FT_Fixed
424  psh_hint_snap_stem_side_delta( FT_Fixed  pos,
425                                 FT_Fixed  len )
426  {
427    FT_Fixed  delta1 = FT_PIX_ROUND( pos ) - pos;
428    FT_Fixed  delta2 = FT_PIX_ROUND( pos + len ) - pos - len;
429
430
431    if ( FT_ABS( delta1 ) <= FT_ABS( delta2 ) )
432      return delta1;
433    else
434      return delta2;
435  }
436
437
438  static void
439  psh_hint_align( PSH_Hint     hint,
440                  PSH_Globals  globals,
441                  FT_Int       dimension,
442                  PSH_Glyph    glyph )
443  {
444    PSH_Dimension  dim   = &globals->dimension[dimension];
445    FT_Fixed       scale = dim->scale_mult;
446    FT_Fixed       delta = dim->scale_delta;
447
448
449    if ( !psh_hint_is_fitted( hint ) )
450    {
451      FT_Pos  pos = FT_MulFix( hint->org_pos, scale ) + delta;
452      FT_Pos  len = FT_MulFix( hint->org_len, scale );
453
454      FT_Int            do_snapping;
455      FT_Pos            fit_len;
456      PSH_AlignmentRec  align;
457
458
459      /* ignore stem alignments when requested through the hint flags */
460      if ( ( dimension == 0 && !glyph->do_horz_hints ) ||
461           ( dimension == 1 && !glyph->do_vert_hints ) )
462      {
463        hint->cur_pos = pos;
464        hint->cur_len = len;
465
466        psh_hint_set_fitted( hint );
467        return;
468      }
469
470      /* perform stem snapping when requested - this is necessary
471       * for monochrome and LCD hinting modes only
472       */
473      do_snapping = ( dimension == 0 && glyph->do_horz_snapping ) ||
474                    ( dimension == 1 && glyph->do_vert_snapping );
475
476      hint->cur_len = fit_len = len;
477
478      /* check blue zones for horizontal stems */
479      align.align     = PSH_BLUE_ALIGN_NONE;
480      align.align_bot = align.align_top = 0;
481
482      if ( dimension == 1 )
483        psh_blues_snap_stem( &globals->blues,
484                             hint->org_pos + hint->org_len,
485                             hint->org_pos,
486                             &align );
487
488      switch ( align.align )
489      {
490      case PSH_BLUE_ALIGN_TOP:
491        /* the top of the stem is aligned against a blue zone */
492        hint->cur_pos = align.align_top - fit_len;
493        break;
494
495      case PSH_BLUE_ALIGN_BOT:
496        /* the bottom of the stem is aligned against a blue zone */
497        hint->cur_pos = align.align_bot;
498        break;
499
500      case PSH_BLUE_ALIGN_TOP | PSH_BLUE_ALIGN_BOT:
501        /* both edges of the stem are aligned against blue zones */
502        hint->cur_pos = align.align_bot;
503        hint->cur_len = align.align_top - align.align_bot;
504        break;
505
506      default:
507        {
508          PSH_Hint  parent = hint->parent;
509
510
511          if ( parent )
512          {
513            FT_Pos  par_org_center, par_cur_center;
514            FT_Pos  cur_org_center, cur_delta;
515
516
517            /* ensure that parent is already fitted */
518            if ( !psh_hint_is_fitted( parent ) )
519              psh_hint_align( parent, globals, dimension, glyph );
520
521            /* keep original relation between hints, this is, use the */
522            /* scaled distance between the centers of the hints to    */
523            /* compute the new position                               */
524            par_org_center = parent->org_pos + ( parent->org_len >> 1 );
525            par_cur_center = parent->cur_pos + ( parent->cur_len >> 1 );
526            cur_org_center = hint->org_pos   + ( hint->org_len   >> 1 );
527
528            cur_delta = FT_MulFix( cur_org_center - par_org_center, scale );
529            pos       = par_cur_center + cur_delta - ( len >> 1 );
530          }
531
532          hint->cur_pos = pos;
533          hint->cur_len = fit_len;
534
535          /* Stem adjustment tries to snap stem widths to standard
536           * ones.  This is important to prevent unpleasant rounding
537           * artefacts.
538           */
539          if ( glyph->do_stem_adjust )
540          {
541            if ( len <= 64 )
542            {
543              /* the stem is less than one pixel; we will center it
544               * around the nearest pixel center
545               */
546#if 1
547              pos = FT_PIX_FLOOR( pos + ( len >> 1 ) );
548#else
549             /* this seems to be a bug! */
550              pos = pos + FT_PIX_FLOOR( len >> 1 );
551#endif
552              len = 64;
553            }
554            else
555            {
556              len = psh_dimension_quantize_len( dim, len, 0 );
557            }
558          }
559
560          /* now that we have a good hinted stem width, try to position */
561          /* the stem along a pixel grid integer coordinate             */
562          hint->cur_pos = pos + psh_hint_snap_stem_side_delta( pos, len );
563          hint->cur_len = len;
564        }
565      }
566
567      if ( do_snapping )
568      {
569        pos = hint->cur_pos;
570        len = hint->cur_len;
571
572        if ( len < 64 )
573          len = 64;
574        else
575          len = FT_PIX_ROUND( len );
576
577        switch ( align.align )
578        {
579          case PSH_BLUE_ALIGN_TOP:
580            hint->cur_pos = align.align_top - len;
581            hint->cur_len = len;
582            break;
583
584          case PSH_BLUE_ALIGN_BOT:
585            hint->cur_len = len;
586            break;
587
588          case PSH_BLUE_ALIGN_BOT | PSH_BLUE_ALIGN_TOP:
589            /* don't touch */
590            break;
591
592
593          default:
594            hint->cur_len = len;
595            if ( len & 64 )
596              pos = FT_PIX_FLOOR( pos + ( len >> 1 ) ) + 32;
597            else
598              pos = FT_PIX_ROUND( pos + ( len >> 1 ) );
599
600            hint->cur_pos = pos - ( len >> 1 );
601            hint->cur_len = len;
602        }
603      }
604
605      psh_hint_set_fitted( hint );
606
607#ifdef DEBUG_HINTER
608      if ( ps_debug_hint_func )
609        ps_debug_hint_func( hint, dimension );
610#endif
611    }
612  }
613
614
615#if 0  /* not used for now, experimental */
616
617 /*
618  *  A variant to perform "light" hinting (i.e. FT_RENDER_MODE_LIGHT)
619  *  of stems
620  */
621  static void
622  psh_hint_align_light( PSH_Hint     hint,
623                        PSH_Globals  globals,
624                        FT_Int       dimension,
625                        PSH_Glyph    glyph )
626  {
627    PSH_Dimension  dim   = &globals->dimension[dimension];
628    FT_Fixed       scale = dim->scale_mult;
629    FT_Fixed       delta = dim->scale_delta;
630
631
632    if ( !psh_hint_is_fitted( hint ) )
633    {
634      FT_Pos  pos = FT_MulFix( hint->org_pos, scale ) + delta;
635      FT_Pos  len = FT_MulFix( hint->org_len, scale );
636
637      FT_Pos  fit_len;
638
639      PSH_AlignmentRec  align;
640
641
642      /* ignore stem alignments when requested through the hint flags */
643      if ( ( dimension == 0 && !glyph->do_horz_hints ) ||
644           ( dimension == 1 && !glyph->do_vert_hints ) )
645      {
646        hint->cur_pos = pos;
647        hint->cur_len = len;
648
649        psh_hint_set_fitted( hint );
650        return;
651      }
652
653      fit_len = len;
654
655      hint->cur_len = fit_len;
656
657      /* check blue zones for horizontal stems */
658      align.align = PSH_BLUE_ALIGN_NONE;
659      align.align_bot = align.align_top = 0;
660
661      if ( dimension == 1 )
662        psh_blues_snap_stem( &globals->blues,
663                             hint->org_pos + hint->org_len,
664                             hint->org_pos,
665                             &align );
666
667      switch ( align.align )
668      {
669      case PSH_BLUE_ALIGN_TOP:
670        /* the top of the stem is aligned against a blue zone */
671        hint->cur_pos = align.align_top - fit_len;
672        break;
673
674      case PSH_BLUE_ALIGN_BOT:
675        /* the bottom of the stem is aligned against a blue zone */
676        hint->cur_pos = align.align_bot;
677        break;
678
679      case PSH_BLUE_ALIGN_TOP | PSH_BLUE_ALIGN_BOT:
680        /* both edges of the stem are aligned against blue zones */
681        hint->cur_pos = align.align_bot;
682        hint->cur_len = align.align_top - align.align_bot;
683        break;
684
685      default:
686        {
687          PSH_Hint  parent = hint->parent;
688
689
690          if ( parent )
691          {
692            FT_Pos  par_org_center, par_cur_center;
693            FT_Pos  cur_org_center, cur_delta;
694
695
696            /* ensure that parent is already fitted */
697            if ( !psh_hint_is_fitted( parent ) )
698              psh_hint_align_light( parent, globals, dimension, glyph );
699
700            par_org_center = parent->org_pos + ( parent->org_len / 2 );
701            par_cur_center = parent->cur_pos + ( parent->cur_len / 2 );
702            cur_org_center = hint->org_pos   + ( hint->org_len   / 2 );
703
704            cur_delta = FT_MulFix( cur_org_center - par_org_center, scale );
705            pos       = par_cur_center + cur_delta - ( len >> 1 );
706          }
707
708          /* Stems less than one pixel wide are easy -- we want to
709           * make them as dark as possible, so they must fall within
710           * one pixel.  If the stem is split between two pixels
711           * then snap the edge that is nearer to the pixel boundary
712           * to the pixel boundary.
713           */
714          if ( len <= 64 )
715          {
716            if ( ( pos + len + 63 ) / 64  != pos / 64 + 1 )
717              pos += psh_hint_snap_stem_side_delta ( pos, len );
718          }
719
720          /* Position stems other to minimize the amount of mid-grays.
721           * There are, in general, two positions that do this,
722           * illustrated as A) and B) below.
723           *
724           *   +                   +                   +                   +
725           *
726           * A)             |--------------------------------|
727           * B)   |--------------------------------|
728           * C)       |--------------------------------|
729           *
730           * Position A) (split the excess stem equally) should be better
731           * for stems of width N + f where f < 0.5.
732           *
733           * Position B) (split the deficiency equally) should be better
734           * for stems of width N + f where f > 0.5.
735           *
736           * It turns out though that minimizing the total number of lit
737           * pixels is also important, so position C), with one edge
738           * aligned with a pixel boundary is actually preferable
739           * to A).  There are also more possibile positions for C) than
740           * for A) or B), so it involves less distortion of the overall
741           * character shape.
742           */
743          else /* len > 64 */
744          {
745            FT_Fixed  frac_len = len & 63;
746            FT_Fixed  center = pos + ( len >> 1 );
747            FT_Fixed  delta_a, delta_b;
748
749
750            if ( ( len / 64 ) & 1 )
751            {
752              delta_a = FT_PIX_FLOOR( center ) + 32 - center;
753              delta_b = FT_PIX_ROUND( center ) - center;
754            }
755            else
756            {
757              delta_a = FT_PIX_ROUND( center ) - center;
758              delta_b = FT_PIX_FLOOR( center ) + 32 - center;
759            }
760
761            /* We choose between B) and C) above based on the amount
762             * of fractinal stem width; for small amounts, choose
763             * C) always, for large amounts, B) always, and inbetween,
764             * pick whichever one involves less stem movement.
765             */
766            if ( frac_len < 32 )
767            {
768              pos += psh_hint_snap_stem_side_delta ( pos, len );
769            }
770            else if ( frac_len < 48 )
771            {
772              FT_Fixed  side_delta = psh_hint_snap_stem_side_delta ( pos,
773                                                                     len );
774
775              if ( FT_ABS( side_delta ) < FT_ABS( delta_b ) )
776                pos += side_delta;
777              else
778                pos += delta_b;
779            }
780            else
781            {
782              pos += delta_b;
783            }
784          }
785
786          hint->cur_pos = pos;
787        }
788      }  /* switch */
789
790      psh_hint_set_fitted( hint );
791
792#ifdef DEBUG_HINTER
793      if ( ps_debug_hint_func )
794        ps_debug_hint_func( hint, dimension );
795#endif
796    }
797  }
798
799#endif /* 0 */
800
801
802  static void
803  psh_hint_table_align_hints( PSH_Hint_Table  table,
804                              PSH_Globals     globals,
805                              FT_Int          dimension,
806                              PSH_Glyph       glyph )
807  {
808    PSH_Hint       hint;
809    FT_UInt        count;
810
811#ifdef DEBUG_HINTER
812
813    PSH_Dimension  dim   = &globals->dimension[dimension];
814    FT_Fixed       scale = dim->scale_mult;
815    FT_Fixed       delta = dim->scale_delta;
816
817
818    if ( ps_debug_no_vert_hints && dimension == 0 )
819    {
820      ps_simple_scale( table, scale, delta, dimension );
821      return;
822    }
823
824    if ( ps_debug_no_horz_hints && dimension == 1 )
825    {
826      ps_simple_scale( table, scale, delta, dimension );
827      return;
828    }
829
830#endif /* DEBUG_HINTER*/
831
832    hint  = table->hints;
833    count = table->max_hints;
834
835    for ( ; count > 0; count--, hint++ )
836      psh_hint_align( hint, globals, dimension, glyph );
837  }
838
839
840  /*************************************************************************/
841  /*************************************************************************/
842  /*****                                                               *****/
843  /*****                POINTS INTERPOLATION ROUTINES                  *****/
844  /*****                                                               *****/
845  /*************************************************************************/
846  /*************************************************************************/
847
848#define PSH_ZONE_MIN  -3200000L
849#define PSH_ZONE_MAX  +3200000L
850
851#define xxDEBUG_ZONES
852
853
854#ifdef DEBUG_ZONES
855
856#include <stdio.h>
857
858  static void
859  psh_print_zone( PSH_Zone  zone )
860  {
861    printf( "zone [scale,delta,min,max] = [%.3f,%.3f,%d,%d]\n",
862             zone->scale / 65536.0,
863             zone->delta / 64.0,
864             zone->min,
865             zone->max );
866  }
867
868#else
869
870#define psh_print_zone( x )  do { } while ( 0 )
871
872#endif /* DEBUG_ZONES */
873
874
875  /*************************************************************************/
876  /*************************************************************************/
877  /*****                                                               *****/
878  /*****                    HINTER GLYPH MANAGEMENT                    *****/
879  /*****                                                               *****/
880  /*************************************************************************/
881  /*************************************************************************/
882
883#if 1
884
885#define  psh_corner_is_flat      ft_corner_is_flat
886#define  psh_corner_orientation  ft_corner_orientation
887
888#else
889
890  FT_LOCAL_DEF( FT_Int )
891  psh_corner_is_flat( FT_Pos  x_in,
892                      FT_Pos  y_in,
893                      FT_Pos  x_out,
894                      FT_Pos  y_out )
895  {
896    FT_Pos  ax = x_in;
897    FT_Pos  ay = y_in;
898
899    FT_Pos  d_in, d_out, d_corner;
900
901
902    if ( ax < 0 )
903      ax = -ax;
904    if ( ay < 0 )
905      ay = -ay;
906    d_in = ax + ay;
907
908    ax = x_out;
909    if ( ax < 0 )
910      ax = -ax;
911    ay = y_out;
912    if ( ay < 0 )
913      ay = -ay;
914    d_out = ax + ay;
915
916    ax = x_out + x_in;
917    if ( ax < 0 )
918      ax = -ax;
919    ay = y_out + y_in;
920    if ( ay < 0 )
921      ay = -ay;
922    d_corner = ax + ay;
923
924    return ( d_in + d_out - d_corner ) < ( d_corner >> 4 );
925  }
926
927  static FT_Int
928  psh_corner_orientation( FT_Pos  in_x,
929                          FT_Pos  in_y,
930                          FT_Pos  out_x,
931                          FT_Pos  out_y )
932  {
933    FT_Int  result;
934
935
936    /* deal with the trivial cases quickly */
937    if ( in_y == 0 )
938    {
939      if ( in_x >= 0 )
940        result = out_y;
941      else
942        result = -out_y;
943    }
944    else if ( in_x == 0 )
945    {
946      if ( in_y >= 0 )
947        result = -out_x;
948      else
949        result = out_x;
950    }
951    else if ( out_y == 0 )
952    {
953      if ( out_x >= 0 )
954        result = in_y;
955      else
956        result = -in_y;
957    }
958    else if ( out_x == 0 )
959    {
960      if ( out_y >= 0 )
961        result = -in_x;
962      else
963        result =  in_x;
964    }
965    else /* general case */
966    {
967      long long  delta = (long long)in_x * out_y - (long long)in_y * out_x;
968
969      if ( delta == 0 )
970        result = 0;
971      else
972        result = 1 - 2 * ( delta < 0 );
973    }
974
975    return result;
976  }
977
978#endif /* !1 */
979
980
981#ifdef COMPUTE_INFLEXS
982
983  /* compute all inflex points in a given glyph */
984  static void
985  psh_glyph_compute_inflections( PSH_Glyph  glyph )
986  {
987    FT_UInt  n;
988
989
990    for ( n = 0; n < glyph->num_contours; n++ )
991    {
992      PSH_Point  first, start, end, before, after;
993      FT_Pos     in_x, in_y, out_x, out_y;
994      FT_Int     orient_prev, orient_cur;
995      FT_Int     finished = 0;
996
997
998      /* we need at least 4 points to create an inflection point */
999      if ( glyph->contours[n].count < 4 )
1000        continue;
1001
1002      /* compute first segment in contour */
1003      first = glyph->contours[n].start;
1004
1005      start = end = first;
1006      do
1007      {
1008        end = end->next;
1009        if ( end == first )
1010          goto Skip;
1011
1012        in_x = end->org_u - start->org_u;
1013        in_y = end->org_v - start->org_v;
1014
1015      } while ( in_x == 0 && in_y == 0 );
1016
1017      /* extend the segment start whenever possible */
1018      before = start;
1019      do
1020      {
1021        do
1022        {
1023          start  = before;
1024          before = before->prev;
1025          if ( before == first )
1026            goto Skip;
1027
1028          out_x = start->org_u - before->org_u;
1029          out_y = start->org_v - before->org_v;
1030
1031        } while ( out_x == 0 && out_y == 0 );
1032
1033        orient_prev = psh_corner_orientation( in_x, in_y, out_x, out_y );
1034
1035      } while ( orient_prev == 0 );
1036
1037      first = start;
1038      in_x  = out_x;
1039      in_y  = out_y;
1040
1041      /* now, process all segments in the contour */
1042      do
1043      {
1044        /* first, extend current segment's end whenever possible */
1045        after = end;
1046        do
1047        {
1048          do
1049          {
1050            end   = after;
1051            after = after->next;
1052            if ( after == first )
1053              finished = 1;
1054
1055            out_x = after->org_u - end->org_u;
1056            out_y = after->org_v - end->org_v;
1057
1058          } while ( out_x == 0 && out_y == 0 );
1059
1060          orient_cur = psh_corner_orientation( in_x, in_y, out_x, out_y );
1061
1062        } while ( orient_cur == 0 );
1063
1064        if ( ( orient_cur ^ orient_prev ) < 0 )
1065        {
1066          do
1067          {
1068            psh_point_set_inflex( start );
1069            start = start->next;
1070          }
1071          while ( start != end );
1072
1073          psh_point_set_inflex( start );
1074        }
1075
1076        start       = end;
1077        end         = after;
1078        orient_prev = orient_cur;
1079        in_x        = out_x;
1080        in_y        = out_y;
1081
1082      } while ( !finished );
1083
1084    Skip:
1085      ;
1086    }
1087  }
1088
1089#endif /* COMPUTE_INFLEXS */
1090
1091
1092  static void
1093  psh_glyph_done( PSH_Glyph  glyph )
1094  {
1095    FT_Memory  memory = glyph->memory;
1096
1097
1098    psh_hint_table_done( &glyph->hint_tables[1], memory );
1099    psh_hint_table_done( &glyph->hint_tables[0], memory );
1100
1101    FT_FREE( glyph->points );
1102    FT_FREE( glyph->contours );
1103
1104    glyph->num_points   = 0;
1105    glyph->num_contours = 0;
1106
1107    glyph->memory = 0;
1108  }
1109
1110
1111  static int
1112  psh_compute_dir( FT_Pos  dx,
1113                   FT_Pos  dy )
1114  {
1115    FT_Pos  ax, ay;
1116    int     result = PSH_DIR_NONE;
1117
1118
1119    ax = ( dx >= 0 ) ? dx : -dx;
1120    ay = ( dy >= 0 ) ? dy : -dy;
1121
1122    if ( ay * 12 < ax )
1123    {
1124      /* |dy| <<< |dx|  means a near-horizontal segment */
1125      result = ( dx >= 0 ) ? PSH_DIR_RIGHT : PSH_DIR_LEFT;
1126    }
1127    else if ( ax * 12 < ay )
1128    {
1129      /* |dx| <<< |dy|  means a near-vertical segment */
1130      result = ( dy >= 0 ) ? PSH_DIR_UP : PSH_DIR_DOWN;
1131    }
1132
1133    return result;
1134  }
1135
1136
1137  /* load outline point coordinates into hinter glyph */
1138  static void
1139  psh_glyph_load_points( PSH_Glyph  glyph,
1140                         FT_Int     dimension )
1141  {
1142    FT_Vector*  vec   = glyph->outline->points;
1143    PSH_Point   point = glyph->points;
1144    FT_UInt     count = glyph->num_points;
1145
1146
1147    for ( ; count > 0; count--, point++, vec++ )
1148    {
1149      point->flags2 = 0;
1150      point->hint   = NULL;
1151      if ( dimension == 0 )
1152      {
1153        point->org_u = vec->x;
1154        point->org_v = vec->y;
1155      }
1156      else
1157      {
1158        point->org_u = vec->y;
1159        point->org_v = vec->x;
1160      }
1161
1162#ifdef DEBUG_HINTER
1163      point->org_x = vec->x;
1164      point->org_y = vec->y;
1165#endif
1166
1167    }
1168  }
1169
1170
1171  /* save hinted point coordinates back to outline */
1172  static void
1173  psh_glyph_save_points( PSH_Glyph  glyph,
1174                         FT_Int     dimension )
1175  {
1176    FT_UInt     n;
1177    PSH_Point   point = glyph->points;
1178    FT_Vector*  vec   = glyph->outline->points;
1179    char*       tags  = glyph->outline->tags;
1180
1181
1182    for ( n = 0; n < glyph->num_points; n++ )
1183    {
1184      if ( dimension == 0 )
1185        vec[n].x = point->cur_u;
1186      else
1187        vec[n].y = point->cur_u;
1188
1189      if ( psh_point_is_strong( point ) )
1190        tags[n] |= (char)( ( dimension == 0 ) ? 32 : 64 );
1191
1192#ifdef DEBUG_HINTER
1193
1194      if ( dimension == 0 )
1195      {
1196        point->cur_x   = point->cur_u;
1197        point->flags_x = point->flags2 | point->flags;
1198      }
1199      else
1200      {
1201        point->cur_y   = point->cur_u;
1202        point->flags_y = point->flags2 | point->flags;
1203      }
1204
1205#endif
1206
1207      point++;
1208    }
1209  }
1210
1211
1212  static FT_Error
1213  psh_glyph_init( PSH_Glyph    glyph,
1214                  FT_Outline*  outline,
1215                  PS_Hints     ps_hints,
1216                  PSH_Globals  globals )
1217  {
1218    FT_Error   error;
1219    FT_Memory  memory;
1220
1221
1222    /* clear all fields */
1223    FT_MEM_ZERO( glyph, sizeof ( *glyph ) );
1224
1225    memory = glyph->memory = globals->memory;
1226
1227    /* allocate and setup points + contours arrays */
1228    if ( FT_NEW_ARRAY( glyph->points,   outline->n_points   ) ||
1229         FT_NEW_ARRAY( glyph->contours, outline->n_contours ) )
1230      goto Exit;
1231
1232    glyph->num_points   = outline->n_points;
1233    glyph->num_contours = outline->n_contours;
1234
1235    {
1236      FT_UInt      first = 0, next, n;
1237      PSH_Point    points  = glyph->points;
1238      PSH_Contour  contour = glyph->contours;
1239
1240
1241      for ( n = 0; n < glyph->num_contours; n++ )
1242      {
1243        FT_Int     count;
1244        PSH_Point  point;
1245
1246
1247        next  = outline->contours[n] + 1;
1248        count = next - first;
1249
1250        contour->start = points + first;
1251        contour->count = (FT_UInt)count;
1252
1253        if ( count > 0 )
1254        {
1255          point = points + first;
1256
1257          point->prev    = points + next - 1;
1258          point->contour = contour;
1259
1260          for ( ; count > 1; count-- )
1261          {
1262            point[0].next = point + 1;
1263            point[1].prev = point;
1264            point++;
1265            point->contour = contour;
1266          }
1267          point->next = points + first;
1268        }
1269
1270        contour++;
1271        first = next;
1272      }
1273    }
1274
1275    {
1276      PSH_Point   points = glyph->points;
1277      PSH_Point   point  = points;
1278      FT_Vector*  vec    = outline->points;
1279      FT_UInt     n;
1280
1281
1282      for ( n = 0; n < glyph->num_points; n++, point++ )
1283      {
1284        FT_Int  n_prev = (FT_Int)( point->prev - points );
1285        FT_Int  n_next = (FT_Int)( point->next - points );
1286        FT_Pos  dxi, dyi, dxo, dyo;
1287
1288
1289        if ( !( outline->tags[n] & FT_CURVE_TAG_ON ) )
1290          point->flags = PSH_POINT_OFF;
1291
1292        dxi = vec[n].x - vec[n_prev].x;
1293        dyi = vec[n].y - vec[n_prev].y;
1294
1295        point->dir_in = (FT_Char)psh_compute_dir( dxi, dyi );
1296
1297        dxo = vec[n_next].x - vec[n].x;
1298        dyo = vec[n_next].y - vec[n].y;
1299
1300        point->dir_out = (FT_Char)psh_compute_dir( dxo, dyo );
1301
1302        /* detect smooth points */
1303        if ( point->flags & PSH_POINT_OFF )
1304          point->flags |= PSH_POINT_SMOOTH;
1305
1306        else if ( point->dir_in == point->dir_out )
1307        {
1308          if ( point->dir_out != PSH_DIR_NONE           ||
1309               psh_corner_is_flat( dxi, dyi, dxo, dyo ) )
1310            point->flags |= PSH_POINT_SMOOTH;
1311        }
1312      }
1313    }
1314
1315    glyph->outline = outline;
1316    glyph->globals = globals;
1317
1318#ifdef COMPUTE_INFLEXS
1319    psh_glyph_load_points( glyph, 0 );
1320    psh_glyph_compute_inflections( glyph );
1321#endif /* COMPUTE_INFLEXS */
1322
1323    /* now deal with hints tables */
1324    error = psh_hint_table_init( &glyph->hint_tables [0],
1325                                 &ps_hints->dimension[0].hints,
1326                                 &ps_hints->dimension[0].masks,
1327                                 &ps_hints->dimension[0].counters,
1328                                 memory );
1329    if ( error )
1330      goto Exit;
1331
1332    error = psh_hint_table_init( &glyph->hint_tables [1],
1333                                 &ps_hints->dimension[1].hints,
1334                                 &ps_hints->dimension[1].masks,
1335                                 &ps_hints->dimension[1].counters,
1336                                 memory );
1337    if ( error )
1338      goto Exit;
1339
1340  Exit:
1341    return error;
1342  }
1343
1344
1345  /* compute all extrema in a glyph for a given dimension */
1346  static void
1347  psh_glyph_compute_extrema( PSH_Glyph  glyph )
1348  {
1349    FT_UInt  n;
1350
1351
1352    /* first of all, compute all local extrema */
1353    for ( n = 0; n < glyph->num_contours; n++ )
1354    {
1355      PSH_Point  first = glyph->contours[n].start;
1356      PSH_Point  point, before, after;
1357
1358
1359      if ( glyph->contours[n].count == 0 )
1360        continue;
1361
1362      point  = first;
1363      before = point;
1364      after  = point;
1365
1366      do
1367      {
1368        before = before->prev;
1369        if ( before == first )
1370          goto Skip;
1371
1372      } while ( before->org_u == point->org_u );
1373
1374      first = point = before->next;
1375
1376      for (;;)
1377      {
1378        after = point;
1379        do
1380        {
1381          after = after->next;
1382          if ( after == first )
1383            goto Next;
1384
1385        } while ( after->org_u == point->org_u );
1386
1387        if ( before->org_u < point->org_u )
1388        {
1389          if ( after->org_u < point->org_u )
1390          {
1391            /* local maximum */
1392            goto Extremum;
1393          }
1394        }
1395        else /* before->org_u > point->org_u */
1396        {
1397          if ( after->org_u > point->org_u )
1398          {
1399            /* local minimum */
1400          Extremum:
1401            do
1402            {
1403              psh_point_set_extremum( point );
1404              point = point->next;
1405
1406            } while ( point != after );
1407          }
1408        }
1409
1410        before = after->prev;
1411        point  = after;
1412
1413      } /* for  */
1414
1415    Next:
1416      ;
1417    }
1418
1419    /* for each extremum, determine its direction along the */
1420    /* orthogonal axis                                      */
1421    for ( n = 0; n < glyph->num_points; n++ )
1422    {
1423      PSH_Point  point, before, after;
1424
1425
1426      point  = &glyph->points[n];
1427      before = point;
1428      after  = point;
1429
1430      if ( psh_point_is_extremum( point ) )
1431      {
1432        do
1433        {
1434          before = before->prev;
1435          if ( before == point )
1436            goto Skip;
1437
1438        } while ( before->org_v == point->org_v );
1439
1440        do
1441        {
1442          after = after->next;
1443          if ( after == point )
1444            goto Skip;
1445
1446        } while ( after->org_v == point->org_v );
1447      }
1448
1449      if ( before->org_v < point->org_v &&
1450           after->org_v  > point->org_v )
1451      {
1452        psh_point_set_positive( point );
1453      }
1454      else if ( before->org_v > point->org_v &&
1455                after->org_v  < point->org_v )
1456      {
1457        psh_point_set_negative( point );
1458      }
1459
1460    Skip:
1461      ;
1462    }
1463  }
1464
1465
1466  /* major_dir is the direction for points on the bottom/left of the stem; */
1467  /* Points on the top/right of the stem will have a direction of          */
1468  /* -major_dir.                                                           */
1469
1470  static void
1471  psh_hint_table_find_strong_points( PSH_Hint_Table  table,
1472                                     PSH_Point       point,
1473                                     FT_UInt         count,
1474                                     FT_Int          threshold,
1475                                     FT_Int          major_dir )
1476  {
1477    PSH_Hint*  sort      = table->sort;
1478    FT_UInt    num_hints = table->num_hints;
1479
1480
1481    for ( ; count > 0; count--, point++ )
1482    {
1483      FT_Int  point_dir = 0;
1484      FT_Pos  org_u     = point->org_u;
1485
1486
1487      if ( psh_point_is_strong( point ) )
1488        continue;
1489
1490      if ( PSH_DIR_COMPARE( point->dir_in, major_dir ) )
1491        point_dir = point->dir_in;
1492
1493      else if ( PSH_DIR_COMPARE( point->dir_out, major_dir ) )
1494        point_dir = point->dir_out;
1495
1496      if ( point_dir )
1497      {
1498        if ( point_dir == major_dir )
1499        {
1500          FT_UInt  nn;
1501
1502
1503          for ( nn = 0; nn < num_hints; nn++ )
1504          {
1505            PSH_Hint  hint = sort[nn];
1506            FT_Pos    d    = org_u - hint->org_pos;
1507
1508
1509            if ( d < threshold && -d < threshold )
1510            {
1511              psh_point_set_strong( point );
1512              point->flags2 |= PSH_POINT_EDGE_MIN;
1513              point->hint    = hint;
1514              break;
1515            }
1516          }
1517        }
1518        else if ( point_dir == -major_dir )
1519        {
1520          FT_UInt  nn;
1521
1522
1523          for ( nn = 0; nn < num_hints; nn++ )
1524          {
1525            PSH_Hint  hint = sort[nn];
1526            FT_Pos    d    = org_u - hint->org_pos - hint->org_len;
1527
1528
1529            if ( d < threshold && -d < threshold )
1530            {
1531              psh_point_set_strong( point );
1532              point->flags2 |= PSH_POINT_EDGE_MAX;
1533              point->hint    = hint;
1534              break;
1535            }
1536          }
1537        }
1538      }
1539
1540#if 1
1541      else if ( psh_point_is_extremum( point ) )
1542      {
1543        /* treat extrema as special cases for stem edge alignment */
1544        FT_UInt  nn, min_flag, max_flag;
1545
1546
1547        if ( major_dir == PSH_DIR_HORIZONTAL )
1548        {
1549          min_flag = PSH_POINT_POSITIVE;
1550          max_flag = PSH_POINT_NEGATIVE;
1551        }
1552        else
1553        {
1554          min_flag = PSH_POINT_NEGATIVE;
1555          max_flag = PSH_POINT_POSITIVE;
1556        }
1557
1558        if ( point->flags2 & min_flag )
1559        {
1560          for ( nn = 0; nn < num_hints; nn++ )
1561          {
1562            PSH_Hint  hint = sort[nn];
1563            FT_Pos    d    = org_u - hint->org_pos;
1564
1565
1566            if ( d < threshold && -d < threshold )
1567            {
1568              point->flags2 |= PSH_POINT_EDGE_MIN;
1569              point->hint    = hint;
1570              psh_point_set_strong( point );
1571              break;
1572            }
1573          }
1574        }
1575        else if ( point->flags2 & max_flag )
1576        {
1577          for ( nn = 0; nn < num_hints; nn++ )
1578          {
1579            PSH_Hint  hint = sort[nn];
1580            FT_Pos    d    = org_u - hint->org_pos - hint->org_len;
1581
1582
1583            if ( d < threshold && -d < threshold )
1584            {
1585              point->flags2 |= PSH_POINT_EDGE_MAX;
1586              point->hint    = hint;
1587              psh_point_set_strong( point );
1588              break;
1589            }
1590          }
1591        }
1592
1593        if ( point->hint == NULL )
1594        {
1595          for ( nn = 0; nn < num_hints; nn++ )
1596          {
1597            PSH_Hint  hint = sort[nn];
1598
1599
1600            if ( org_u >= hint->org_pos                 &&
1601                org_u <= hint->org_pos + hint->org_len )
1602            {
1603              point->hint = hint;
1604              break;
1605            }
1606          }
1607        }
1608      }
1609
1610#endif /* 1 */
1611    }
1612  }
1613
1614
1615  /* the accepted shift for strong points in fractional pixels */
1616#define PSH_STRONG_THRESHOLD  32
1617
1618  /* the maximum shift value in font units */
1619#define PSH_STRONG_THRESHOLD_MAXIMUM  30
1620
1621
1622  /* find strong points in a glyph */
1623  static void
1624  psh_glyph_find_strong_points( PSH_Glyph  glyph,
1625                                FT_Int     dimension )
1626  {
1627    /* a point is `strong' if it is located on a stem edge and       */
1628    /* has an `in' or `out' tangent parallel to the hint's direction */
1629
1630    PSH_Hint_Table  table     = &glyph->hint_tables[dimension];
1631    PS_Mask         mask      = table->hint_masks->masks;
1632    FT_UInt         num_masks = table->hint_masks->num_masks;
1633    FT_UInt         first     = 0;
1634    FT_Int          major_dir = dimension == 0 ? PSH_DIR_VERTICAL
1635                                               : PSH_DIR_HORIZONTAL;
1636    PSH_Dimension   dim       = &glyph->globals->dimension[dimension];
1637    FT_Fixed        scale     = dim->scale_mult;
1638    FT_Int          threshold;
1639
1640
1641    threshold = (FT_Int)FT_DivFix( PSH_STRONG_THRESHOLD, scale );
1642    if ( threshold > PSH_STRONG_THRESHOLD_MAXIMUM )
1643      threshold = PSH_STRONG_THRESHOLD_MAXIMUM;
1644
1645    /* process secondary hints to `selected' points */
1646    if ( num_masks > 1 && glyph->num_points > 0 )
1647    {
1648      first = mask->end_point;
1649      mask++;
1650      for ( ; num_masks > 1; num_masks--, mask++ )
1651      {
1652        FT_UInt  next;
1653        FT_Int   count;
1654
1655
1656        next  = mask->end_point;
1657        count = next - first;
1658        if ( count > 0 )
1659        {
1660          PSH_Point  point = glyph->points + first;
1661
1662
1663          psh_hint_table_activate_mask( table, mask );
1664
1665          psh_hint_table_find_strong_points( table, point, count,
1666                                             threshold, major_dir );
1667        }
1668        first = next;
1669      }
1670    }
1671
1672    /* process primary hints for all points */
1673    if ( num_masks == 1 )
1674    {
1675      FT_UInt    count = glyph->num_points;
1676      PSH_Point  point = glyph->points;
1677
1678
1679      psh_hint_table_activate_mask( table, table->hint_masks->masks );
1680
1681      psh_hint_table_find_strong_points( table, point, count,
1682                                         threshold, major_dir );
1683    }
1684
1685    /* now, certain points may have been attached to a hint and */
1686    /* not marked as strong; update their flags then            */
1687    {
1688      FT_UInt    count = glyph->num_points;
1689      PSH_Point  point = glyph->points;
1690
1691
1692      for ( ; count > 0; count--, point++ )
1693        if ( point->hint && !psh_point_is_strong( point ) )
1694          psh_point_set_strong( point );
1695    }
1696  }
1697
1698
1699  /* find points in a glyph which are in a blue zone and have `in' or */
1700  /* `out' tangents parallel to the horizontal axis                   */
1701  static void
1702  psh_glyph_find_blue_points( PSH_Blues  blues,
1703                              PSH_Glyph  glyph )
1704  {
1705    PSH_Blue_Table  table;
1706    PSH_Blue_Zone   zone;
1707    FT_UInt         glyph_count = glyph->num_points;
1708    FT_UInt         blue_count;
1709    PSH_Point       point = glyph->points;
1710
1711
1712    for ( ; glyph_count > 0; glyph_count--, point++ )
1713    {
1714      FT_Pos  y;
1715
1716
1717      /* check tangents */
1718      if ( !PSH_DIR_COMPARE( point->dir_in,  PSH_DIR_HORIZONTAL ) &&
1719           !PSH_DIR_COMPARE( point->dir_out, PSH_DIR_HORIZONTAL ) )
1720        continue;
1721
1722      /* skip strong points */
1723      if ( psh_point_is_strong( point ) )
1724        continue;
1725
1726      y = point->org_u;
1727
1728      /* look up top zones */
1729      table      = &blues->normal_top;
1730      blue_count = table->count;
1731      zone       = table->zones;
1732
1733      for ( ; blue_count > 0; blue_count--, zone++ )
1734      {
1735        FT_Pos  delta = y - zone->org_bottom;
1736
1737
1738        if ( delta < -blues->blue_fuzz )
1739          break;
1740
1741        if ( y <= zone->org_top + blues->blue_fuzz )
1742          if ( blues->no_overshoots || delta <= blues->blue_threshold )
1743          {
1744            point->cur_u = zone->cur_bottom;
1745            psh_point_set_strong( point );
1746            psh_point_set_fitted( point );
1747          }
1748      }
1749
1750      /* look up bottom zones */
1751      table      = &blues->normal_bottom;
1752      blue_count = table->count;
1753      zone       = table->zones + blue_count - 1;
1754
1755      for ( ; blue_count > 0; blue_count--, zone-- )
1756      {
1757        FT_Pos  delta = zone->org_top - y;
1758
1759
1760        if ( delta < -blues->blue_fuzz )
1761          break;
1762
1763        if ( y >= zone->org_bottom - blues->blue_fuzz )
1764          if ( blues->no_overshoots || delta < blues->blue_threshold )
1765          {
1766            point->cur_u = zone->cur_top;
1767            psh_point_set_strong( point );
1768            psh_point_set_fitted( point );
1769          }
1770      }
1771    }
1772  }
1773
1774
1775  /* interpolate strong points with the help of hinted coordinates */
1776  static void
1777  psh_glyph_interpolate_strong_points( PSH_Glyph  glyph,
1778                                       FT_Int     dimension )
1779  {
1780    PSH_Dimension  dim   = &glyph->globals->dimension[dimension];
1781    FT_Fixed       scale = dim->scale_mult;
1782
1783    FT_UInt        count = glyph->num_points;
1784    PSH_Point      point = glyph->points;
1785
1786
1787    for ( ; count > 0; count--, point++ )
1788    {
1789      PSH_Hint  hint = point->hint;
1790
1791
1792      if ( hint )
1793      {
1794        FT_Pos  delta;
1795
1796
1797        if ( psh_point_is_edge_min( point ) )
1798          point->cur_u = hint->cur_pos;
1799
1800        else if ( psh_point_is_edge_max( point ) )
1801          point->cur_u = hint->cur_pos + hint->cur_len;
1802
1803        else
1804        {
1805          delta = point->org_u - hint->org_pos;
1806
1807          if ( delta <= 0 )
1808            point->cur_u = hint->cur_pos + FT_MulFix( delta, scale );
1809
1810          else if ( delta >= hint->org_len )
1811            point->cur_u = hint->cur_pos + hint->cur_len +
1812                             FT_MulFix( delta - hint->org_len, scale );
1813
1814          else if ( hint->org_len > 0 )
1815            point->cur_u = hint->cur_pos +
1816                             FT_MulDiv( delta, hint->cur_len,
1817                                        hint->org_len );
1818          else
1819            point->cur_u = hint->cur_pos;
1820        }
1821        psh_point_set_fitted( point );
1822      }
1823    }
1824  }
1825
1826
1827#define  PSH_MAX_STRONG_INTERNAL  16
1828
1829  static void
1830  psh_glyph_interpolate_normal_points( PSH_Glyph  glyph,
1831                                       FT_Int     dimension )
1832  {
1833
1834#if 1
1835    /* first technique: a point is strong if it is a local extremum */
1836
1837    PSH_Dimension  dim    = &glyph->globals->dimension[dimension];
1838    FT_Fixed       scale  = dim->scale_mult;
1839    FT_Memory      memory = glyph->memory;
1840
1841    PSH_Point*     strongs     = NULL;
1842    PSH_Point      strongs_0[PSH_MAX_STRONG_INTERNAL];
1843    FT_UInt        num_strongs = 0;
1844
1845    PSH_Point      points = glyph->points;
1846    PSH_Point      points_end = points + glyph->num_points;
1847    PSH_Point      point;
1848
1849
1850    /* first count the number of strong points */
1851    for ( point = points; point < points_end; point++ )
1852    {
1853      if ( psh_point_is_strong( point ) )
1854        num_strongs++;
1855    }
1856
1857    if ( num_strongs == 0 )  /* nothing to do here */
1858      return;
1859
1860    /* allocate an array to store a list of points, */
1861    /* stored in increasing org_u order             */
1862    if ( num_strongs <= PSH_MAX_STRONG_INTERNAL )
1863      strongs = strongs_0;
1864    else
1865    {
1866      FT_Error  error;
1867
1868
1869      if ( FT_NEW_ARRAY( strongs, num_strongs ) )
1870        return;
1871    }
1872
1873    num_strongs = 0;
1874    for ( point = points; point < points_end; point++ )
1875    {
1876      PSH_Point*  insert;
1877
1878
1879      if ( !psh_point_is_strong( point ) )
1880        continue;
1881
1882      for ( insert = strongs + num_strongs; insert > strongs; insert-- )
1883      {
1884        if ( insert[-1]->org_u <= point->org_u )
1885          break;
1886
1887        insert[0] = insert[-1];
1888      }
1889      insert[0] = point;
1890      num_strongs++;
1891    }
1892
1893    /* now try to interpolate all normal points */
1894    for ( point = points; point < points_end; point++ )
1895    {
1896      if ( psh_point_is_strong( point ) )
1897        continue;
1898
1899      /* sometimes, some local extrema are smooth points */
1900      if ( psh_point_is_smooth( point ) )
1901      {
1902        if ( point->dir_in == PSH_DIR_NONE   ||
1903             point->dir_in != point->dir_out )
1904          continue;
1905
1906        if ( !psh_point_is_extremum( point ) &&
1907             !psh_point_is_inflex( point )   )
1908          continue;
1909
1910        point->flags &= ~PSH_POINT_SMOOTH;
1911      }
1912
1913      /* find best enclosing point coordinates then interpolate */
1914      {
1915        PSH_Point   before, after;
1916        FT_UInt     nn;
1917
1918
1919        for ( nn = 0; nn < num_strongs; nn++ )
1920          if ( strongs[nn]->org_u > point->org_u )
1921            break;
1922
1923        if ( nn == 0 )  /* point before the first strong point */
1924        {
1925          after = strongs[0];
1926
1927          point->cur_u = after->cur_u +
1928                           FT_MulFix( point->org_u - after->org_u,
1929                                      scale );
1930        }
1931        else
1932        {
1933          before = strongs[nn - 1];
1934
1935          for ( nn = num_strongs; nn > 0; nn-- )
1936            if ( strongs[nn - 1]->org_u < point->org_u )
1937              break;
1938
1939          if ( nn == num_strongs )  /* point is after last strong point */
1940          {
1941            before = strongs[nn - 1];
1942
1943            point->cur_u = before->cur_u +
1944                             FT_MulFix( point->org_u - before->org_u,
1945                                        scale );
1946          }
1947          else
1948          {
1949            FT_Pos  u;
1950
1951
1952            after = strongs[nn];
1953
1954            /* now interpolate point between before and after */
1955            u = point->org_u;
1956
1957            if ( u == before->org_u )
1958              point->cur_u = before->cur_u;
1959
1960            else if ( u == after->org_u )
1961              point->cur_u = after->cur_u;
1962
1963            else
1964              point->cur_u = before->cur_u +
1965                               FT_MulDiv( u - before->org_u,
1966                                          after->cur_u - before->cur_u,
1967                                          after->org_u - before->org_u );
1968          }
1969        }
1970        psh_point_set_fitted( point );
1971      }
1972    }
1973
1974    if ( strongs != strongs_0 )
1975      FT_FREE( strongs );
1976
1977#endif /* 1 */
1978
1979  }
1980
1981
1982  /* interpolate other points */
1983  static void
1984  psh_glyph_interpolate_other_points( PSH_Glyph  glyph,
1985                                      FT_Int     dimension )
1986  {
1987    PSH_Dimension  dim          = &glyph->globals->dimension[dimension];
1988    FT_Fixed       scale        = dim->scale_mult;
1989    FT_Fixed       delta        = dim->scale_delta;
1990    PSH_Contour    contour      = glyph->contours;
1991    FT_UInt        num_contours = glyph->num_contours;
1992
1993
1994    for ( ; num_contours > 0; num_contours--, contour++ )
1995    {
1996      PSH_Point  start = contour->start;
1997      PSH_Point  first, next, point;
1998      FT_UInt    fit_count;
1999
2000
2001      /* count the number of strong points in this contour */
2002      next      = start + contour->count;
2003      fit_count = 0;
2004      first     = 0;
2005
2006      for ( point = start; point < next; point++ )
2007        if ( psh_point_is_fitted( point ) )
2008        {
2009          if ( !first )
2010            first = point;
2011
2012          fit_count++;
2013        }
2014
2015      /* if there are less than 2 fitted points in the contour, we */
2016      /* simply scale and eventually translate the contour points  */
2017      if ( fit_count < 2 )
2018      {
2019        if ( fit_count == 1 )
2020          delta = first->cur_u - FT_MulFix( first->org_u, scale );
2021
2022        for ( point = start; point < next; point++ )
2023          if ( point != first )
2024            point->cur_u = FT_MulFix( point->org_u, scale ) + delta;
2025
2026        goto Next_Contour;
2027      }
2028
2029      /* there are more than 2 strong points in this contour; we */
2030      /* need to interpolate weak points between them            */
2031      start = first;
2032      do
2033      {
2034        point = first;
2035
2036        /* skip consecutive fitted points */
2037        for (;;)
2038        {
2039          next = first->next;
2040          if ( next == start )
2041            goto Next_Contour;
2042
2043          if ( !psh_point_is_fitted( next ) )
2044            break;
2045
2046          first = next;
2047        }
2048
2049        /* find next fitted point after unfitted one */
2050        for (;;)
2051        {
2052          next = next->next;
2053          if ( psh_point_is_fitted( next ) )
2054            break;
2055        }
2056
2057        /* now interpolate between them */
2058        {
2059          FT_Pos    org_a, org_ab, cur_a, cur_ab;
2060          FT_Pos    org_c, org_ac, cur_c;
2061          FT_Fixed  scale_ab;
2062
2063
2064          if ( first->org_u <= next->org_u )
2065          {
2066            org_a  = first->org_u;
2067            cur_a  = first->cur_u;
2068            org_ab = next->org_u - org_a;
2069            cur_ab = next->cur_u - cur_a;
2070          }
2071          else
2072          {
2073            org_a  = next->org_u;
2074            cur_a  = next->cur_u;
2075            org_ab = first->org_u - org_a;
2076            cur_ab = first->cur_u - cur_a;
2077          }
2078
2079          scale_ab = 0x10000L;
2080          if ( org_ab > 0 )
2081            scale_ab = FT_DivFix( cur_ab, org_ab );
2082
2083          point = first->next;
2084          do
2085          {
2086            org_c  = point->org_u;
2087            org_ac = org_c - org_a;
2088
2089            if ( org_ac <= 0 )
2090            {
2091              /* on the left of the interpolation zone */
2092              cur_c = cur_a + FT_MulFix( org_ac, scale );
2093            }
2094            else if ( org_ac >= org_ab )
2095            {
2096              /* on the right on the interpolation zone */
2097              cur_c = cur_a + cur_ab + FT_MulFix( org_ac - org_ab, scale );
2098            }
2099            else
2100            {
2101              /* within the interpolation zone */
2102              cur_c = cur_a + FT_MulFix( org_ac, scale_ab );
2103            }
2104
2105            point->cur_u = cur_c;
2106
2107            point = point->next;
2108
2109          } while ( point != next );
2110        }
2111
2112        /* keep going until all points in the contours have been processed */
2113        first = next;
2114
2115      } while ( first != start );
2116
2117    Next_Contour:
2118      ;
2119    }
2120  }
2121
2122
2123  /*************************************************************************/
2124  /*************************************************************************/
2125  /*****                                                               *****/
2126  /*****                     HIGH-LEVEL INTERFACE                      *****/
2127  /*****                                                               *****/
2128  /*************************************************************************/
2129  /*************************************************************************/
2130
2131  FT_Error
2132  ps_hints_apply( PS_Hints        ps_hints,
2133                  FT_Outline*     outline,
2134                  PSH_Globals     globals,
2135                  FT_Render_Mode  hint_mode )
2136  {
2137    PSH_GlyphRec  glyphrec;
2138    PSH_Glyph     glyph = &glyphrec;
2139    FT_Error      error;
2140#ifdef DEBUG_HINTER
2141    FT_Memory     memory;
2142#endif
2143    FT_Int        dimension;
2144
2145
2146    /* something to do? */
2147    if ( outline->n_points == 0 || outline->n_contours == 0 )
2148      return PSH_Err_Ok;
2149
2150#ifdef DEBUG_HINTER
2151
2152    memory = globals->memory;
2153
2154    if ( ps_debug_glyph )
2155    {
2156      psh_glyph_done( ps_debug_glyph );
2157      FT_FREE( ps_debug_glyph );
2158    }
2159
2160    if ( FT_NEW( glyph ) )
2161      return error;
2162
2163    ps_debug_glyph = glyph;
2164
2165#endif /* DEBUG_HINTER */
2166
2167    error = psh_glyph_init( glyph, outline, ps_hints, globals );
2168    if ( error )
2169      goto Exit;
2170
2171    /* try to optimize the y_scale so that the top of non-capital letters
2172     * is aligned on a pixel boundary whenever possible
2173     */
2174    {
2175      PSH_Dimension  dim_x = &glyph->globals->dimension[0];
2176      PSH_Dimension  dim_y = &glyph->globals->dimension[1];
2177
2178      FT_Fixed x_scale = dim_x->scale_mult;
2179      FT_Fixed y_scale = dim_y->scale_mult;
2180
2181      FT_Fixed scaled;
2182      FT_Fixed fitted;
2183
2184
2185      scaled = FT_MulFix( globals->blues.normal_top.zones->org_ref, y_scale );
2186      fitted = FT_PIX_ROUND( scaled );
2187
2188      if ( fitted != 0 && scaled != fitted )
2189      {
2190        y_scale = FT_MulDiv( y_scale, fitted, scaled );
2191
2192        if ( fitted < scaled )
2193          x_scale -= x_scale / 50;
2194
2195        psh_globals_set_scale( glyph->globals, x_scale, y_scale, 0, 0 );
2196      }
2197    }
2198
2199    glyph->do_horz_hints = 1;
2200    glyph->do_vert_hints = 1;
2201
2202    glyph->do_horz_snapping = FT_BOOL( hint_mode == FT_RENDER_MODE_MONO ||
2203                                       hint_mode == FT_RENDER_MODE_LCD  );
2204
2205    glyph->do_vert_snapping = FT_BOOL( hint_mode == FT_RENDER_MODE_MONO  ||
2206                                       hint_mode == FT_RENDER_MODE_LCD_V );
2207
2208    glyph->do_stem_adjust   = FT_BOOL( hint_mode != FT_RENDER_MODE_LIGHT );
2209
2210    for ( dimension = 0; dimension < 2; dimension++ )
2211    {
2212      /* load outline coordinates into glyph */
2213      psh_glyph_load_points( glyph, dimension );
2214
2215      /* compute local extrema */
2216      psh_glyph_compute_extrema( glyph );
2217
2218      /* compute aligned stem/hints positions */
2219      psh_hint_table_align_hints( &glyph->hint_tables[dimension],
2220                                  glyph->globals,
2221                                  dimension,
2222                                  glyph );
2223
2224      /* find strong points, align them, then interpolate others */
2225      psh_glyph_find_strong_points( glyph, dimension );
2226      if ( dimension == 1 )
2227        psh_glyph_find_blue_points( &globals->blues, glyph );
2228      psh_glyph_interpolate_strong_points( glyph, dimension );
2229      psh_glyph_interpolate_normal_points( glyph, dimension );
2230      psh_glyph_interpolate_other_points( glyph, dimension );
2231
2232      /* save hinted coordinates back to outline */
2233      psh_glyph_save_points( glyph, dimension );
2234    }
2235
2236  Exit:
2237
2238#ifndef DEBUG_HINTER
2239    psh_glyph_done( glyph );
2240#endif
2241
2242    return error;
2243  }
2244
2245
2246/* END */
Note: See TracBrowser for help on using the repository browser.