source: trunk/poppler/freetype-2.1.10/src/autofit/aflatin.c @ 2

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

First import

File size: 55.2 KB
Line 
1/***************************************************************************/
2/*                                                                         */
3/*  aflatin.c                                                              */
4/*                                                                         */
5/*    Auto-fitter hinting routines for latin script (body).                */
6/*                                                                         */
7/*  Copyright 2003, 2004, 2005 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 "aflatin.h"
20#include "aferrors.h"
21
22
23  /*************************************************************************/
24  /*************************************************************************/
25  /*****                                                               *****/
26  /*****            L A T I N   G L O B A L   M E T R I C S            *****/
27  /*****                                                               *****/
28  /*************************************************************************/
29  /*************************************************************************/
30
31  static void
32  af_latin_metrics_init_widths( AF_LatinMetrics  metrics,
33                                FT_Face          face )
34  {
35    /* scan the array of segments in each direction */
36    AF_GlyphHintsRec  hints[1];
37
38
39    af_glyph_hints_init( hints, face->memory );
40
41    metrics->axis[AF_DIMENSION_HORZ].width_count = 0;
42    metrics->axis[AF_DIMENSION_VERT].width_count = 0;
43
44    /* For now, compute the standard width and height from the `o'. */
45    {
46      FT_Error             error;
47      FT_UInt              glyph_index;
48      int                  dim;
49      AF_ScriptMetricsRec  dummy[1];
50      AF_Scaler            scaler = &dummy->scaler;
51
52
53      glyph_index = FT_Get_Char_Index( face, 'o' );
54      if ( glyph_index == 0 )
55        goto Exit;
56
57      error = FT_Load_Glyph( face, glyph_index, FT_LOAD_NO_SCALE );
58      if ( error || face->glyph->outline.n_points <= 0 )
59        goto Exit;
60
61      FT_ZERO( dummy );
62
63      scaler->x_scale     = scaler->y_scale = 0x10000L;
64      scaler->x_delta     = scaler->y_delta = 0;
65      scaler->face        = face;
66      scaler->render_mode = FT_RENDER_MODE_NORMAL;
67      scaler->flags       = 0;
68
69      af_glyph_hints_rescale( hints, dummy );
70
71      error = af_glyph_hints_reload( hints, &face->glyph->outline );
72      if ( error )
73        goto Exit;
74
75      for ( dim = 0; dim < AF_DIMENSION_MAX; dim++ )
76      {
77        AF_LatinAxis  axis    = &metrics->axis[dim];
78        AF_AxisHints  axhints = &hints->axis[dim];
79        AF_Segment    seg, limit, link;
80
81        FT_UInt       num_widths              = 0;
82        FT_Pos        edge_distance_threshold = 32000;
83
84
85        error = af_latin_hints_compute_segments( hints,
86                                                 (AF_Dimension)dim );
87        if ( error )
88          goto Exit;
89
90        af_latin_hints_link_segments( hints,
91                                      (AF_Dimension)dim );
92
93        seg   = axhints->segments;
94        limit = seg + axhints->num_segments;
95
96        for ( ; seg < limit; seg++ )
97        {
98          link = seg->link;
99
100          /* we only consider stem segments there! */
101          if ( link && link->link == seg && link > seg )
102          {
103            FT_Pos  dist;
104
105
106            dist = seg->pos - link->pos;
107            if ( dist < 0 )
108              dist = -dist;
109
110            if ( num_widths < AF_LATIN_MAX_WIDTHS )
111              axis->widths[ num_widths++ ].org = dist;
112          }
113        }
114
115        af_sort_widths( num_widths, axis->widths );
116        axis->width_count = num_widths;
117
118        /* we will now try to find the smallest width */
119        if ( num_widths > 0 && axis->widths[0].org < edge_distance_threshold )
120          edge_distance_threshold = axis->widths[0].org;
121
122        /* Now, compute the edge distance threshold as a fraction of the */
123        /* smallest width in the font.  Set it in `hinter->glyph' too!   */
124        if ( edge_distance_threshold == 32000 )
125          edge_distance_threshold = 50;
126
127        /* let's try 20% */
128        axis->edge_distance_threshold = edge_distance_threshold / 5;
129      }
130    }
131
132  Exit:
133    af_glyph_hints_done( hints );
134  }
135
136
137
138#define AF_LATIN_MAX_TEST_CHARACTERS  12
139
140
141  static const char* const  af_latin_blue_chars[AF_LATIN_MAX_BLUES] =
142  {
143    "THEZOCQS",
144    "HEZLOCUS",
145    "fijkdbh",
146    "xzroesc",
147    "xzroesc",
148    "pqgjy"
149  };
150
151
152  static void
153  af_latin_metrics_init_blues( AF_LatinMetrics  metrics,
154                               FT_Face          face )
155  {
156    FT_Pos        flats [AF_LATIN_MAX_TEST_CHARACTERS];
157    FT_Pos        rounds[AF_LATIN_MAX_TEST_CHARACTERS];
158    FT_Int        num_flats;
159    FT_Int        num_rounds;
160    FT_Int        bb;
161    AF_LatinBlue  blue;
162    FT_Error      error;
163    AF_LatinAxis  axis  = &metrics->axis[AF_DIMENSION_VERT];
164    FT_GlyphSlot  glyph = face->glyph;
165
166
167    /* we compute the blues simply by loading each character from the    */
168    /* 'af_latin_blue_chars[blues]' string, then compute its top-most or */
169    /* bottom-most points (depending on `AF_IS_TOP_BLUE')                */
170
171    AF_LOG(( "blue zones computation\n" ));
172    AF_LOG(( "------------------------------------------------\n" ));
173
174    for ( bb = 0; bb < AF_LATIN_BLUE_MAX; bb++ )
175    {
176      const char*  p     = af_latin_blue_chars[bb];
177      const char*  limit = p + AF_LATIN_MAX_TEST_CHARACTERS;
178      FT_Pos*      blue_ref;
179      FT_Pos*      blue_shoot;
180
181
182      AF_LOG(( "blue %3d: ", bb ));
183
184      num_flats  = 0;
185      num_rounds = 0;
186
187      for ( ; p < limit && *p; p++ )
188      {
189        FT_UInt     glyph_index;
190        FT_Vector*  extremum;
191        FT_Vector*  points;
192        FT_Vector*  point_limit;
193        FT_Vector*  point;
194        FT_Bool     round;
195
196
197        AF_LOG(( "'%c'", *p ));
198
199        /* load the character in the face -- skip unknown or empty ones */
200        glyph_index = FT_Get_Char_Index( face, (FT_UInt)*p );
201        if ( glyph_index == 0 )
202          continue;
203
204        error = FT_Load_Glyph( face, glyph_index, FT_LOAD_NO_SCALE );
205        if ( error || glyph->outline.n_points <= 0 )
206          continue;
207
208        /* now compute min or max point indices and coordinates */
209        points      = glyph->outline.points;
210        point_limit = points + glyph->outline.n_points;
211        point       = points;
212        extremum    = point;
213        point++;
214
215        if ( AF_LATIN_IS_TOP_BLUE( bb ) )
216        {
217          for ( ; point < point_limit; point++ )
218            if ( point->y > extremum->y )
219              extremum = point;
220        }
221        else
222        {
223          for ( ; point < point_limit; point++ )
224            if ( point->y < extremum->y )
225              extremum = point;
226        }
227
228        AF_LOG(( "%5d", (int)extremum->y ));
229
230        /* now, check whether the point belongs to a straight or round  */
231        /* segment; we first need to find in which contour the extremum */
232        /* lies, then see its previous and next points                  */
233        {
234          FT_Int  idx = (FT_Int)( extremum - points );
235          FT_Int  n;
236          FT_Int  first, last, prev, next, end;
237          FT_Pos  dist;
238
239
240          last  = -1;
241          first = 0;
242
243          for ( n = 0; n < glyph->outline.n_contours; n++ )
244          {
245            end = glyph->outline.contours[n];
246            if ( end >= idx )
247            {
248              last = end;
249              break;
250            }
251            first = end + 1;
252          }
253
254          /* XXX: should never happen! */
255          if ( last < 0 )
256            continue;
257
258          /* now look for the previous and next points that are not on the */
259          /* same Y coordinate.  Threshold the `closeness'...              */
260
261          prev = idx;
262          next = prev;
263
264          do
265          {
266            if ( prev > first )
267              prev--;
268            else
269              prev = last;
270
271            dist = points[prev].y - extremum->y;
272            if ( dist < -5 || dist > 5 )
273              break;
274
275          } while ( prev != idx );
276
277          do
278          {
279            if ( next < last )
280              next++;
281            else
282              next = first;
283
284            dist = points[next].y - extremum->y;
285            if ( dist < -5 || dist > 5 )
286              break;
287
288          } while ( next != idx );
289
290          /* now, set the `round' flag depending on the segment's kind */
291          round = FT_BOOL(
292            FT_CURVE_TAG( glyph->outline.tags[prev] ) != FT_CURVE_TAG_ON ||
293            FT_CURVE_TAG( glyph->outline.tags[next] ) != FT_CURVE_TAG_ON );
294
295          AF_LOG(( "%c ", round ? 'r' : 'f' ));
296        }
297
298        if ( round )
299          rounds[num_rounds++] = extremum->y;
300        else
301          flats[num_flats++] = extremum->y;
302      }
303
304      AF_LOG(( "\n" ));
305
306      if ( num_flats == 0 && num_rounds == 0 )
307      {
308        /*
309         *  we couldn't find a single glyph to compute this blue zone,
310         *  we will simply ignore it then
311         */
312        AF_LOG(( "empty!\n" ));
313        continue;
314      }
315
316      /* we have computed the contents of the `rounds' and `flats' tables, */
317      /* now determine the reference and overshoot position of the blue -- */
318      /* we simply take the median value after a simple sort               */
319      af_sort_pos( num_rounds, rounds );
320      af_sort_pos( num_flats,  flats );
321
322      blue       = & axis->blues[axis->blue_count];
323      blue_ref   = & blue->ref.org;
324      blue_shoot = & blue->shoot.org;
325
326      axis->blue_count++;
327
328      if ( num_flats == 0 )
329      {
330        *blue_ref   =
331        *blue_shoot = rounds[num_rounds / 2];
332      }
333      else if ( num_rounds == 0 )
334      {
335        *blue_ref   =
336        *blue_shoot = flats[num_flats / 2];
337      }
338      else
339      {
340        *blue_ref   = flats[num_flats / 2];
341        *blue_shoot = rounds[num_rounds / 2];
342      }
343
344      /* there are sometimes problems: if the overshoot position of top     */
345      /* zones is under its reference position, or the opposite for bottom  */
346      /* zones.  We must thus check everything there and correct the errors */
347      if ( *blue_shoot != *blue_ref )
348      {
349        FT_Pos   ref      = *blue_ref;
350        FT_Pos   shoot    = *blue_shoot;
351        FT_Bool  over_ref = FT_BOOL( shoot > ref );
352
353
354        if ( AF_LATIN_IS_TOP_BLUE( bb ) ^ over_ref )
355          *blue_shoot = *blue_ref = ( shoot + ref ) / 2;
356      }
357
358      blue->flags = 0;
359      if ( AF_LATIN_IS_TOP_BLUE( bb ) )
360        blue->flags |= AF_LATIN_BLUE_TOP;
361
362      /*
363       * The following flags is used later to adjust the y and x scales
364       * in order to optimize the pixel grid alignment of the top of small
365       * letters.
366       */
367      if ( bb == AF_LATIN_BLUE_SMALL_TOP )
368        blue->flags |= AF_LATIN_BLUE_ADJUSTMENT;
369
370      AF_LOG(( "-- ref = %ld, shoot = %ld\n", *blue_ref, *blue_shoot ));
371    }
372
373    return;
374  }
375
376
377  FT_LOCAL_DEF( FT_Error )
378  af_latin_metrics_init( AF_LatinMetrics  metrics,
379                         FT_Face          face )
380  {
381    FT_Error    error = AF_Err_Ok;
382    FT_CharMap  oldmap = face->charmap;
383    FT_UInt     ee;
384
385    static const FT_Encoding  latin_encodings[] =
386    {
387      FT_ENCODING_UNICODE,
388      FT_ENCODING_APPLE_ROMAN,
389      FT_ENCODING_ADOBE_STANDARD,
390      FT_ENCODING_ADOBE_LATIN_1,
391      FT_ENCODING_NONE  /* end of list */
392    };
393
394
395    metrics->units_per_em = face->units_per_EM;
396
397    /* do we have a latin charmap in there? */
398    for ( ee = 0; latin_encodings[ee] != FT_ENCODING_NONE; ee++ )
399    {
400      error = FT_Select_Charmap( face, latin_encodings[ee] );
401      if ( !error )
402        break;
403    }
404
405    if ( !error )
406    {
407      af_latin_metrics_init_widths( metrics, face );
408      af_latin_metrics_init_blues( metrics, face );
409    }
410
411    FT_Set_Charmap( face, oldmap );
412    return AF_Err_Ok;
413  }
414
415
416  static void
417  af_latin_metrics_scale_dim( AF_LatinMetrics  metrics,
418                              AF_Scaler        scaler,
419                              AF_Dimension     dim )
420  {
421    FT_Fixed      scale;
422    FT_Pos        delta;
423    AF_LatinAxis  axis;
424    FT_UInt       nn;
425
426
427    if ( dim == AF_DIMENSION_HORZ )
428    {
429      scale = scaler->x_scale;
430      delta = scaler->x_delta;
431    }
432    else
433    {
434      scale = scaler->y_scale;
435      delta = scaler->y_delta;
436    }
437
438    axis = &metrics->axis[dim];
439
440    if ( axis->org_scale == scale && axis->org_delta == delta )
441      return;
442
443    axis->org_scale = scale;
444    axis->org_delta = delta;
445
446    /*
447     * correct X and Y scale to optimize the alignment of the top of small
448     * letters to the pixel grid
449     */
450    {
451      AF_LatinAxis  Axis = &metrics->axis[AF_DIMENSION_VERT];
452      AF_LatinBlue  blue = NULL;
453
454
455      for ( nn = 0; nn < Axis->blue_count; nn++ )
456      {
457        if ( Axis->blues[nn].flags & AF_LATIN_BLUE_ADJUSTMENT )
458        {
459          blue = &Axis->blues[nn];
460          break;
461        }
462      }
463
464      if ( blue )
465      {
466        FT_Pos  scaled = FT_MulFix( blue->shoot.org, scaler->y_scale );
467        FT_Pos  fitted = FT_PIX_ROUND( scaled );
468
469
470        if ( scaled != fitted )
471        {
472          if ( dim == AF_DIMENSION_HORZ )
473          {
474            if ( fitted < scaled )
475              scale -= scale/50;  /* x_scale = x_scale*0.98 */
476          }
477          else
478          {
479            scale = FT_MulDiv( scale, fitted, scaled );
480          }
481        }
482      }
483    }
484
485    axis->scale = scale;
486    axis->delta = delta;
487
488    if ( dim == AF_DIMENSION_HORZ )
489    {
490      metrics->root.scaler.x_scale = scale;
491      metrics->root.scaler.x_delta = delta;
492    }
493    else
494    {
495      metrics->root.scaler.y_scale = scale;
496      metrics->root.scaler.y_delta = delta;
497    }
498
499    /* scale the standard widths */
500    for ( nn = 0; nn < axis->width_count; nn++ )
501    {
502      AF_Width  width = axis->widths + nn;
503
504
505      width->cur = FT_MulFix( width->org, scale );
506      width->fit = width->cur;
507    }
508
509    if ( dim == AF_DIMENSION_VERT )
510    {
511      /* scale the blue zones */
512      for ( nn = 0; nn < axis->blue_count; nn++ )
513      {
514        AF_LatinBlue  blue = &axis->blues[nn];
515        FT_Pos        dist;
516
517
518        blue->ref.cur   = FT_MulFix( blue->ref.org, scale ) + delta;
519        blue->ref.fit   = blue->ref.cur;
520        blue->shoot.cur = FT_MulFix( blue->shoot.org, scale ) + delta;
521        blue->shoot.fit = blue->shoot.cur;
522        blue->flags    &= ~AF_LATIN_BLUE_ACTIVE;
523
524        /* a blue zone is only active if it is less than 3/4 pixels tall */
525        dist = FT_MulFix( blue->ref.org - blue->shoot.org, scale );
526        if ( dist <= 48 && dist >= -48 )
527        {
528          FT_Pos  delta1, delta2;
529
530
531          delta1 = blue->shoot.org - blue->ref.org;
532          delta2 = delta1;
533          if ( delta1 < 0 )
534            delta2 = -delta2;
535
536          delta2 = FT_MulFix( delta2, scale );
537
538          if ( delta2 < 32 )
539            delta2 = 0;
540          else if ( delta2 < 64 )
541            delta2 = 32 + ( ( ( delta2 - 32 ) + 16 ) & ~31 );
542          else
543            delta2 = FT_PIX_ROUND( delta2 );
544
545          if ( delta1 < 0 )
546            delta2 = -delta2;
547
548          blue->ref.fit   = FT_PIX_ROUND( blue->ref.cur );
549          blue->shoot.fit = blue->ref.fit + delta2;
550
551          blue->flags |= AF_LATIN_BLUE_ACTIVE;
552        }
553      }
554    }
555  }
556
557
558  FT_LOCAL_DEF( void )
559  af_latin_metrics_scale( AF_LatinMetrics  metrics,
560                          AF_Scaler        scaler )
561  {
562    af_latin_metrics_scale_dim( metrics, scaler, AF_DIMENSION_HORZ );
563    af_latin_metrics_scale_dim( metrics, scaler, AF_DIMENSION_VERT );
564  }
565
566
567  /*************************************************************************/
568  /*************************************************************************/
569  /*****                                                               *****/
570  /*****           L A T I N   G L Y P H   A N A L Y S I S             *****/
571  /*****                                                               *****/
572  /*************************************************************************/
573  /*************************************************************************/
574
575  FT_LOCAL_DEF( FT_Error )
576  af_latin_hints_compute_segments( AF_GlyphHints  hints,
577                                   AF_Dimension   dim )
578  {
579    AF_AxisHints  axis          = &hints->axis[dim];
580    FT_Memory     memory        = hints->memory;
581    FT_Error      error         = AF_Err_Ok;
582    AF_Segment    segment       = NULL;
583    AF_Point*     contour       = hints->contours;
584    AF_Point*     contour_limit = contour + hints->num_contours;
585    AF_Direction  major_dir, segment_dir;
586
587#ifdef AF_HINT_METRICS
588    AF_Point  min_point =  0;
589    AF_Point  max_point =  0;
590    FT_Pos    min_coord =  32000;
591    FT_Pos    max_coord = -32000;
592#endif
593
594    major_dir   = (AF_Direction)FT_ABS( axis->major_dir );
595    segment_dir = major_dir;
596
597    axis->num_segments = 0;
598
599    /* set up (u,v) in each point */
600    if ( dim == AF_DIMENSION_HORZ )
601    {
602      AF_Point  point = hints->points;
603      AF_Point  limit = point + hints->num_points;
604
605
606      for ( ; point < limit; point++ )
607      {
608        point->u = point->fx;
609        point->v = point->fy;
610      }
611    }
612    else
613    {
614      AF_Point  point = hints->points;
615      AF_Point  limit = point + hints->num_points;
616
617
618      for ( ; point < limit; point++ )
619      {
620        point->u = point->fy;
621        point->v = point->fx;
622      }
623    }
624
625    /* do each contour separately */
626    for ( ; contour < contour_limit; contour++ )
627    {
628      AF_Point  point   =  contour[0];
629      AF_Point  last    =  point->prev;
630      int       on_edge =  0;
631      FT_Pos    min_pos =  32000;  /* minimum segment pos != min_coord */
632      FT_Pos    max_pos = -32000;  /* maximum segment pos != max_coord */
633      FT_Bool   passed;
634
635
636#ifdef AF_HINT_METRICS
637      if ( point->u < min_coord )
638      {
639        min_coord = point->u;
640        min_point = point;
641      }
642      if ( point->u > max_coord )
643      {
644        max_coord = point->u;
645        max_point = point;
646      }
647#endif
648
649      if ( point == last )  /* skip singletons -- just in case */
650        continue;
651
652      if ( FT_ABS( last->out_dir )  == major_dir &&
653           FT_ABS( point->out_dir ) == major_dir )
654      {
655        /* we are already on an edge, try to locate its start */
656        last = point;
657
658        for (;;)
659        {
660          point = point->prev;
661          if ( FT_ABS( point->out_dir ) != major_dir )
662          {
663            point = point->next;
664            break;
665          }
666          if ( point == last )
667            break;
668        }
669      }
670
671      last   = point;
672      passed = 0;
673
674      for (;;)
675      {
676        FT_Pos  u, v;
677
678
679        if ( on_edge )
680        {
681          u = point->u;
682          if ( u < min_pos )
683            min_pos = u;
684          if ( u > max_pos )
685            max_pos = u;
686
687          if ( point->out_dir != segment_dir || point == last )
688          {
689            /* we are just leaving an edge; record a new segment! */
690            segment->last = point;
691            segment->pos  = (FT_Short)( ( min_pos + max_pos ) >> 1 );
692
693            /* a segment is round if either its first or last point */
694            /* is a control point                                   */
695            if ( ( segment->first->flags | point->flags ) &
696                   AF_FLAG_CONTROL                        )
697              segment->flags |= AF_EDGE_ROUND;
698
699            /* compute segment size */
700            min_pos = max_pos = point->v;
701
702            v = segment->first->v;
703            if ( v < min_pos )
704              min_pos = v;
705            if ( v > max_pos )
706              max_pos = v;
707
708            segment->min_coord = (FT_Short)min_pos;
709            segment->max_coord = (FT_Short)max_pos;
710
711            on_edge = 0;
712            segment = NULL;
713            /* fallthrough */
714          }
715        }
716
717        /* now exit if we are at the start/end point */
718        if ( point == last )
719        {
720          if ( passed )
721            break;
722          passed = 1;
723        }
724
725        if ( !on_edge && FT_ABS( point->out_dir ) == major_dir )
726        {
727          /* this is the start of a new segment! */
728          segment_dir = (AF_Direction)point->out_dir;
729
730          /* clear all segment fields */
731          error = af_axis_hints_new_segment( axis, memory, &segment );
732          if ( error )
733            goto Exit;
734
735          segment->dir      = (FT_Char)segment_dir;
736          segment->flags    = AF_EDGE_NORMAL;
737          min_pos = max_pos = point->u;
738          segment->first    = point;
739          segment->last     = point;
740          segment->contour  = contour;
741          segment->score    = 32000;
742          segment->link     = NULL;
743          on_edge           = 1;
744
745#ifdef AF_HINT_METRICS
746          if ( point == max_point )
747            max_point = 0;
748
749          if ( point == min_point )
750            min_point = 0;
751#endif
752        }
753
754        point = point->next;
755      }
756
757    } /* contours */
758
759#ifdef AF_HINT_METRICS
760    /* we need to ensure that there are edges on the left-most and  */
761    /* right-most points of the glyph in order to hint the metrics; */
762    /* we do this by inserting fake segments when needed            */
763
764    if ( dim == AF_DIMENSION_HORZ )
765    {
766      AF_Point  point       = hints->points;
767      AF_Point  point_limit = point + hints->num_points;
768
769      FT_Pos    min_pos =  32000;
770      FT_Pos    max_pos = -32000;
771
772
773      min_point = 0;
774      max_point = 0;
775
776      /* compute minimum and maximum points */
777      for ( ; point < point_limit; point++ )
778      {
779        FT_Pos  x = point->fx;
780
781
782        if ( x < min_pos )
783        {
784          min_pos   = x;
785          min_point = point;
786        }
787        if ( x > max_pos )
788        {
789          max_pos   = x;
790          max_point = point;
791        }
792      }
793
794      /* insert minimum segment */
795      if ( min_point )
796      {
797        /* clear all segment fields */
798        error = af_axis_hints_new_segment( axis, memory, &segment );
799        if ( error )
800          goto Exit;
801
802        segment->dir   = segment_dir;
803        segment->flags = AF_EDGE_NORMAL;
804        segment->first = min_point;
805        segment->last  = min_point;
806        segment->pos   = min_pos;
807        segment->score = 32000;
808        segment->link  = NULL;
809
810        segment = NULL;
811      }
812
813      /* insert maximum segment */
814      if ( max_point )
815      {
816        /* clear all segment fields */
817        error = af_axis_hints_new_segment( axis, memory, &segment );
818        if ( error )
819          goto Exit;
820
821        segment->dir   = segment_dir;
822        segment->flags = AF_EDGE_NORMAL;
823        segment->first = max_point;
824        segment->last  = max_point;
825        segment->pos   = max_pos;
826        segment->score = 32000;
827        segment->link  = NULL;
828
829        segment = NULL;
830      }
831    }
832#endif /* AF_HINT_METRICS */
833
834  Exit:
835    return error;
836  }
837
838
839  FT_LOCAL_DEF( void )
840  af_latin_hints_link_segments( AF_GlyphHints  hints,
841                                AF_Dimension   dim )
842  {
843    AF_AxisHints  axis          = &hints->axis[dim];
844    AF_Segment    segments      = axis->segments;
845    AF_Segment    segment_limit = segments + axis->num_segments;
846    AF_Direction  major_dir     = axis->major_dir;
847    AF_Segment    seg1, seg2;
848
849 
850    /* now compare each segment to the others */
851    for ( seg1 = segments; seg1 < segment_limit; seg1++ )
852    {
853      /* the fake segments are introduced to hint the metrics -- */
854      /* we must never link them to anything                     */
855      if ( seg1->first == seg1->last || seg1->dir != major_dir )
856        continue;
857
858      for ( seg2 = segments; seg2 < segment_limit; seg2++ )
859        if ( seg2 != seg1 && seg1->dir + seg2->dir == 0 )
860        {
861          FT_Pos  pos1 = seg1->pos;
862          FT_Pos  pos2 = seg2->pos;
863          FT_Pos  dist = pos2 - pos1;
864
865
866          if ( dist < 0 )
867            continue;
868
869          {
870            FT_Pos  min = seg1->min_coord;
871            FT_Pos  max = seg1->max_coord;
872            FT_Pos  len, score;
873
874
875            if ( min < seg2->min_coord )
876              min = seg2->min_coord;
877
878            if ( max > seg2->max_coord )
879              max = seg2->max_coord;
880
881            len = max - min;
882            if ( len >= 8 )
883            {
884              score = dist + 3000 / len;
885
886              if ( score < seg1->score )
887              {
888                seg1->score = score;
889                seg1->link  = seg2;
890              }
891
892              if ( score < seg2->score )
893              {
894                seg2->score = score;
895                seg2->link  = seg1;
896              }
897            }
898          }
899        }
900    }
901
902    /* now, compute the `serif' segments */
903    for ( seg1 = segments; seg1 < segment_limit; seg1++ )
904    {
905      seg2 = seg1->link;
906
907      if ( seg2 )
908      {
909        seg2->num_linked++;
910        if ( seg2->link != seg1 )
911        {
912          seg1->link  = 0;
913          seg1->serif = seg2->link;
914        }
915      }
916    }
917  }
918
919
920  FT_LOCAL_DEF( FT_Error )
921  af_latin_hints_compute_edges( AF_GlyphHints  hints,
922                                AF_Dimension   dim )
923  {
924    AF_AxisHints  axis   = &hints->axis[dim];
925    FT_Error      error  = AF_Err_Ok;
926    FT_Memory     memory = hints->memory;
927    AF_LatinAxis  laxis  = &((AF_LatinMetrics)hints->metrics)->axis[dim];
928
929    AF_Segment    segments      = axis->segments;
930    AF_Segment    segment_limit = segments + axis->num_segments;
931    AF_Segment    seg;
932
933    AF_Direction  up_dir;
934    FT_Fixed      scale;
935    FT_Pos        edge_distance_threshold;
936
937
938    axis->num_edges = 0;
939
940    scale = ( dim == AF_DIMENSION_HORZ ) ? hints->x_scale
941                                         : hints->y_scale;
942
943    up_dir = ( dim == AF_DIMENSION_HORZ ) ? AF_DIR_UP
944                                          : AF_DIR_RIGHT;
945
946    /*********************************************************************/
947    /*                                                                   */
948    /* We will begin by generating a sorted table of edges for the       */
949    /* current direction.  To do so, we simply scan each segment and try */
950    /* to find an edge in our table that corresponds to its position.    */
951    /*                                                                   */
952    /* If no edge is found, we create and insert a new edge in the       */
953    /* sorted table.  Otherwise, we simply add the segment to the edge's */
954    /* list which will be processed in the second step to compute the    */
955    /* edge's properties.                                                */
956    /*                                                                   */
957    /* Note that the edges table is sorted along the segment/edge        */
958    /* position.                                                         */
959    /*                                                                   */
960    /*********************************************************************/
961
962    edge_distance_threshold = FT_MulFix( laxis->edge_distance_threshold,
963                                         scale );
964    if ( edge_distance_threshold > 64 / 4 )
965      edge_distance_threshold = 64 / 4;
966
967    edge_distance_threshold = FT_DivFix( edge_distance_threshold,
968                                         scale );
969
970    for ( seg = segments; seg < segment_limit; seg++ )
971    {
972      AF_Edge  found = 0;
973      FT_Int   ee;
974
975
976      /* look for an edge corresponding to the segment */
977      for ( ee = 0; ee < axis->num_edges; ee++ )
978      {
979        AF_Edge  edge = axis->edges + ee;
980        FT_Pos   dist;
981
982
983        dist = seg->pos - edge->fpos;
984        if ( dist < 0 )
985          dist = -dist;
986
987        if ( dist < edge_distance_threshold )
988        {
989          found = edge;
990          break;
991        }
992      }
993
994      if ( !found )
995      {
996        AF_Edge   edge;
997
998
999        /* insert a new edge in the list and */
1000        /* sort according to the position    */
1001        error = af_axis_hints_new_edge( axis, seg->pos, memory, &edge );
1002        if ( error )
1003          goto Exit;
1004
1005        /* add the segment to the new edge's list */
1006        FT_ZERO( edge );
1007
1008        edge->first    = seg;
1009        edge->last     = seg;
1010        edge->fpos     = seg->pos;
1011        edge->opos     = edge->pos = FT_MulFix( seg->pos, scale );
1012        seg->edge_next = seg;
1013      }
1014      else
1015      {
1016        /* if an edge was found, simply add the segment to the edge's */
1017        /* list                                                       */
1018        seg->edge_next         = found->first;
1019        found->last->edge_next = seg;
1020        found->last            = seg;
1021      }
1022    }
1023
1024
1025    /*********************************************************************/
1026    /*                                                                   */
1027    /* Good, we will now compute each edge's properties according to     */
1028    /* segments found on its position.  Basically, these are:            */
1029    /*                                                                   */
1030    /*  - edge's main direction                                          */
1031    /*  - stem edge, serif edge or both (which defaults to stem then)    */
1032    /*  - rounded edge, straight or both (which defaults to straight)    */
1033    /*  - link for edge                                                  */
1034    /*                                                                   */
1035    /*********************************************************************/
1036
1037    /* first of all, set the `edge' field in each segment -- this is */
1038    /* required in order to compute edge links                       */
1039
1040    /*
1041     * Note that removing this loop and setting the `edge' field of each
1042     * segment directly in the code above slows down execution speed for
1043     * some reasons on platforms like the Sun.
1044     */
1045    {
1046      AF_Edge  edges      = axis->edges;
1047      AF_Edge  edge_limit = edges + axis->num_edges;
1048      AF_Edge  edge;
1049
1050
1051      for ( edge = edges; edge < edge_limit; edge++ )
1052      {
1053        seg = edge->first;
1054        if ( seg )
1055          do
1056          {
1057            seg->edge = edge;
1058            seg       = seg->edge_next;
1059
1060          } while ( seg != edge->first );
1061      }
1062
1063      /* now, compute each edge properties */
1064      for ( edge = edges; edge < edge_limit; edge++ )
1065      {
1066        FT_Int  is_round    = 0;  /* does it contain round segments?    */
1067        FT_Int  is_straight = 0;  /* does it contain straight segments? */
1068        FT_Pos  ups         = 0;  /* number of upwards segments         */
1069        FT_Pos  downs       = 0;  /* number of downwards segments       */
1070
1071
1072        seg = edge->first;
1073
1074        do
1075        {
1076          FT_Bool  is_serif;
1077
1078
1079          /* check for roundness of segment */
1080          if ( seg->flags & AF_EDGE_ROUND )
1081            is_round++;
1082          else
1083            is_straight++;
1084
1085          /* check for segment direction */
1086          if ( seg->dir == up_dir )
1087            ups   += seg->max_coord-seg->min_coord;
1088          else
1089            downs += seg->max_coord-seg->min_coord;
1090
1091          /* check for links -- if seg->serif is set, then seg->link must */
1092          /* be ignored                                                   */
1093          is_serif = (FT_Bool)( seg->serif && seg->serif->edge != edge );
1094
1095          if ( seg->link || is_serif )
1096          {
1097            AF_Edge     edge2;
1098            AF_Segment  seg2;
1099
1100
1101            edge2 = edge->link;
1102            seg2  = seg->link;
1103
1104            if ( is_serif )
1105            {
1106              seg2  = seg->serif;
1107              edge2 = edge->serif;
1108            }
1109
1110            if ( edge2 )
1111            {
1112              FT_Pos  edge_delta;
1113              FT_Pos  seg_delta;
1114
1115
1116              edge_delta = edge->fpos - edge2->fpos;
1117              if ( edge_delta < 0 )
1118                edge_delta = -edge_delta;
1119
1120              seg_delta = seg->pos - seg2->pos;
1121              if ( seg_delta < 0 )
1122                seg_delta = -seg_delta;
1123
1124              if ( seg_delta < edge_delta )
1125                edge2 = seg2->edge;
1126            }
1127            else
1128              edge2 = seg2->edge;
1129
1130            if ( is_serif )
1131            {
1132              edge->serif   = edge2;
1133              edge2->flags |= AF_EDGE_SERIF;
1134            }
1135            else
1136              edge->link  = edge2;
1137          }
1138
1139          seg = seg->edge_next;
1140
1141        } while ( seg != edge->first );
1142
1143        /* set the round/straight flags */
1144        edge->flags = AF_EDGE_NORMAL;
1145
1146        if ( is_round > 0 && is_round >= is_straight )
1147          edge->flags |= AF_EDGE_ROUND;
1148
1149        /* set the edge's main direction */
1150        edge->dir = AF_DIR_NONE;
1151
1152        if ( ups > downs )
1153          edge->dir = (FT_Char)up_dir;
1154
1155        else if ( ups < downs )
1156          edge->dir = (FT_Char)-up_dir;
1157
1158        else if ( ups == downs )
1159          edge->dir = 0;  /* both up and down! */
1160
1161        /* gets rid of serifs if link is set                */
1162        /* XXX: This gets rid of many unpleasant artefacts! */
1163        /*      Example: the `c' in cour.pfa at size 13     */
1164
1165        if ( edge->serif && edge->link )
1166          edge->serif = 0;
1167      }
1168    }
1169
1170  Exit:
1171    return error;
1172  }
1173
1174
1175  FT_LOCAL_DEF( FT_Error )
1176  af_latin_hints_detect_features( AF_GlyphHints  hints,
1177                                  AF_Dimension   dim )
1178  {
1179    FT_Error  error;
1180
1181
1182    error = af_latin_hints_compute_segments( hints, dim );
1183    if ( !error )
1184    {
1185      af_latin_hints_link_segments( hints, dim );
1186
1187      error = af_latin_hints_compute_edges( hints, dim );
1188    }
1189    return error;
1190  }
1191
1192
1193  FT_LOCAL_DEF( void )
1194  af_latin_hints_compute_blue_edges( AF_GlyphHints    hints,
1195                                     AF_LatinMetrics  metrics )
1196  {
1197    AF_AxisHints  axis       = &hints->axis[ AF_DIMENSION_VERT ];
1198    AF_Edge       edge       = axis->edges;
1199    AF_Edge       edge_limit = edge + axis->num_edges;
1200    AF_LatinAxis  latin      = &metrics->axis[ AF_DIMENSION_VERT ];
1201    FT_Fixed      scale      = latin->scale;
1202
1203
1204    /* compute which blue zones are active, i.e. have their scaled */
1205    /* size < 3/4 pixels                                           */
1206
1207    /* for each horizontal edge search the blue zone which is closest */
1208    for ( ; edge < edge_limit; edge++ )
1209    {
1210      FT_Int    bb;
1211      AF_Width  best_blue = NULL;
1212      FT_Pos    best_dist;  /* initial threshold */
1213
1214
1215      /* compute the initial threshold as a fraction of the EM size */
1216      best_dist = FT_MulFix( metrics->units_per_em / 40, scale );
1217
1218      if ( best_dist > 64 / 2 )
1219        best_dist = 64 / 2;
1220
1221      for ( bb = 0; bb < AF_LATIN_BLUE_MAX; bb++ )
1222      {
1223        AF_LatinBlue  blue = latin->blues + bb;
1224        FT_Bool       is_top_blue, is_major_dir;
1225
1226
1227        /* skip inactive blue zones (i.e., those that are too small) */
1228        if ( !( blue->flags & AF_LATIN_BLUE_ACTIVE ) )
1229          continue;
1230
1231        /* if it is a top zone, check for right edges -- if it is a bottom */
1232        /* zone, check for left edges                                      */
1233        /*                                                                 */
1234        /* of course, that's for TrueType                                  */
1235        is_top_blue  = (FT_Byte)( ( blue->flags & AF_LATIN_BLUE_TOP ) != 0 );
1236        is_major_dir = FT_BOOL( edge->dir == axis->major_dir );
1237
1238        /* if it is a top zone, the edge must be against the major    */
1239        /* direction; if it is a bottom zone, it must be in the major */
1240        /* direction                                                  */
1241        if ( is_top_blue ^ is_major_dir )
1242        {
1243          FT_Pos  dist;
1244
1245
1246          /* first of all, compare it to the reference position */
1247          dist = edge->fpos - blue->ref.org;
1248          if ( dist < 0 )
1249            dist = -dist;
1250
1251          dist = FT_MulFix( dist, scale );
1252          if ( dist < best_dist )
1253          {
1254            best_dist = dist;
1255            best_blue = & blue->ref;
1256          }
1257
1258          /* now, compare it to the overshoot position if the edge is     */
1259          /* rounded, and if the edge is over the reference position of a */
1260          /* top zone, or under the reference position of a bottom zone   */
1261          if ( edge->flags & AF_EDGE_ROUND && dist != 0 )
1262          {
1263            FT_Bool  is_under_ref = FT_BOOL( edge->fpos < blue->ref.org );
1264
1265
1266            if ( is_top_blue ^ is_under_ref )
1267            {
1268              blue = latin->blues + bb;
1269              dist = edge->fpos - blue->shoot.org;
1270              if ( dist < 0 )
1271                dist = -dist;
1272
1273              dist = FT_MulFix( dist, scale );
1274              if ( dist < best_dist )
1275              {
1276                best_dist = dist;
1277                best_blue = & blue->shoot;
1278              }
1279            }
1280          }
1281        }
1282      }
1283
1284      if ( best_blue )
1285        edge->blue_edge = best_blue;
1286    }
1287  }
1288
1289
1290  static FT_Error
1291  af_latin_hints_init( AF_GlyphHints    hints,
1292                       AF_LatinMetrics  metrics )
1293  {
1294    FT_Render_Mode  mode;
1295
1296
1297    af_glyph_hints_rescale( hints, (AF_ScriptMetrics)metrics );
1298
1299    /*
1300     *  correct x_scale and y_scale when needed, since they may have
1301     *  been modified af_latin_scale_dim above
1302     */
1303    hints->x_scale = metrics->axis[AF_DIMENSION_HORZ].scale;
1304    hints->x_delta = metrics->axis[AF_DIMENSION_HORZ].delta;
1305    hints->y_scale = metrics->axis[AF_DIMENSION_VERT].scale;
1306    hints->y_delta = metrics->axis[AF_DIMENSION_VERT].delta;
1307
1308    /* compute flags depending on render mode, etc... */
1309
1310    mode = metrics->root.scaler.render_mode;
1311
1312    /*
1313     *  We snap the width of vertical stems for the monochrome and
1314     *  horizontal LCD rendering targets only.
1315     */
1316    if ( mode == FT_RENDER_MODE_MONO || mode == FT_RENDER_MODE_LCD )
1317      hints->other_flags |= AF_LATIN_HINTS_HORZ_SNAP;
1318
1319    /*
1320     *  We snap the width of horizontal stems for the monochrome and
1321     *  vertical LCD rendering targets only.
1322     */
1323    if ( mode == FT_RENDER_MODE_MONO || mode == FT_RENDER_MODE_LCD_V )
1324      hints->other_flags |= AF_LATIN_HINTS_VERT_SNAP;
1325
1326    /*
1327     *  We adjust stems to full pixels only if we don't use the `light' mode.
1328     */
1329    if ( mode != FT_RENDER_MODE_LIGHT )
1330      hints->other_flags |= AF_LATIN_HINTS_STEM_ADJUST;
1331
1332    if ( mode == FT_RENDER_MODE_MONO )
1333      hints->other_flags |= AF_LATIN_HINTS_MONO;
1334
1335    return 0;
1336  }
1337
1338
1339  /*************************************************************************/
1340  /*************************************************************************/
1341  /*****                                                               *****/
1342  /*****        L A T I N   G L Y P H   G R I D - F I T T I N G        *****/
1343  /*****                                                               *****/
1344  /*************************************************************************/
1345  /*************************************************************************/
1346
1347  /* snap a given width in scaled coordinates to one of the */
1348  /* current standard widths                                */
1349
1350  static FT_Pos
1351  af_latin_snap_width( AF_Width  widths,
1352                       FT_Int    count,
1353                       FT_Pos    width )
1354  {
1355    int     n;
1356    FT_Pos  best      = 64 + 32 + 2;
1357    FT_Pos  reference = width;
1358    FT_Pos  scaled;
1359
1360
1361    for ( n = 0; n < count; n++ )
1362    {
1363      FT_Pos  w;
1364      FT_Pos  dist;
1365
1366
1367      w = widths[n].cur;
1368      dist = width - w;
1369      if ( dist < 0 )
1370        dist = -dist;
1371      if ( dist < best )
1372      {
1373        best      = dist;
1374        reference = w;
1375      }
1376    }
1377
1378    scaled = FT_PIX_ROUND( reference );
1379
1380    if ( width >= reference )
1381    {
1382      if ( width < scaled + 48 )
1383        width = reference;
1384    }
1385    else
1386    {
1387      if ( width > scaled - 48 )
1388        width = reference;
1389    }
1390
1391    return width;
1392  }
1393
1394
1395  /* compute the snapped width of a given stem */
1396
1397  static FT_Pos
1398  af_latin_compute_stem_width( AF_GlyphHints  hints,
1399                               AF_Dimension   dim,
1400                               FT_Pos         width,
1401                               AF_Edge_Flags  base_flags,
1402                               AF_Edge_Flags  stem_flags )
1403  {
1404    AF_LatinMetrics  metrics  = (AF_LatinMetrics) hints->metrics;
1405    AF_LatinAxis     axis     = & metrics->axis[dim];
1406    FT_Pos           dist     = width;
1407    FT_Int           sign     = 0;
1408    FT_Int           vertical = AF_HINTS_DO_VERTICAL( hints );
1409
1410
1411    if ( !AF_LATIN_HINTS_DO_STEM_ADJUST( hints ) )
1412      return width;
1413
1414    if ( dist < 0 )
1415    {
1416      dist = -width;
1417      sign = 1;
1418    }
1419
1420    if ( (  vertical && !AF_LATIN_HINTS_DO_VERT_SNAP( hints ) ) ||
1421         ( !vertical && !AF_LATIN_HINTS_DO_HORZ_SNAP( hints ) ) )
1422    {
1423      /* smooth hinting process: very lightly quantize the stem width */
1424
1425      /* leave the widths of serifs alone */
1426
1427      if ( ( stem_flags & AF_EDGE_SERIF ) && vertical && ( dist < 3 * 64 ) )
1428        goto Done_Width;
1429
1430      else if ( ( base_flags & AF_EDGE_ROUND ) )
1431      {
1432        if ( dist < 80 )
1433          dist = 64;
1434      }
1435      else if ( dist < 56 )
1436        dist = 56;
1437
1438      if ( axis->width_count > 0 )
1439      {
1440        FT_Pos  delta;
1441
1442
1443        /* compare to standard width */
1444        if ( axis->width_count > 0 )
1445        {
1446          delta = dist - axis->widths[0].cur;
1447
1448          if ( delta < 0 )
1449            delta = -delta;
1450
1451          if ( delta < 40 )
1452          {
1453            dist = axis->widths[0].cur;
1454            if ( dist < 48 )
1455              dist = 48;
1456
1457            goto Done_Width;
1458          }
1459        }
1460
1461        if ( dist < 3 * 64 )
1462        {
1463          delta  = dist & 63;
1464          dist  &= -64;
1465
1466          if ( delta < 10 )
1467            dist += delta;
1468
1469          else if ( delta < 32 )
1470            dist += 10;
1471
1472          else if ( delta < 54 )
1473            dist += 54;
1474
1475          else
1476            dist += delta;
1477        }
1478        else
1479          dist = ( dist + 32 ) & ~63;
1480      }
1481    }
1482    else
1483    {
1484      /* strong hinting process: snap the stem width to integer pixels */
1485
1486      dist = af_latin_snap_width( axis->widths, axis->width_count, dist );
1487
1488      if ( vertical )
1489      {
1490        /* in the case of vertical hinting, always round */
1491        /* the stem heights to integer pixels            */
1492
1493        if ( dist >= 64 )
1494          dist = ( dist + 16 ) & ~63;
1495        else
1496          dist = 64;
1497      }
1498      else
1499      {
1500        if ( AF_LATIN_HINTS_DO_MONO( hints ) )
1501        {
1502          /* monochrome horizontal hinting: snap widths to integer pixels */
1503          /* with a different threshold                                   */
1504
1505          if ( dist < 64 )
1506            dist = 64;
1507          else
1508            dist = ( dist + 32 ) & ~63;
1509        }
1510        else
1511        {
1512          /* for horizontal anti-aliased hinting, we adopt a more subtle */
1513          /* approach: we strengthen small stems, round stems whose size */
1514          /* is between 1 and 2 pixels to an integer, otherwise nothing  */
1515
1516          if ( dist < 48 )
1517            dist = ( dist + 64 ) >> 1;
1518
1519          else if ( dist < 128 )
1520            dist = ( dist + 22 ) & ~63;
1521          else
1522            /* round otherwise to prevent color fringes in LCD mode */
1523            dist = ( dist + 32 ) & ~63;
1524        }
1525      }
1526    }
1527
1528  Done_Width:
1529    if ( sign )
1530      dist = -dist;
1531
1532    return dist;
1533  }
1534
1535
1536  /* align one stem edge relative to the previous stem edge */
1537
1538  static void
1539  af_latin_align_linked_edge( AF_GlyphHints  hints,
1540                              AF_Dimension   dim,
1541                              AF_Edge        base_edge,
1542                              AF_Edge        stem_edge )
1543  {
1544    FT_Pos  dist = stem_edge->opos - base_edge->opos;
1545
1546    FT_Pos  fitted_width = af_latin_compute_stem_width(
1547                             hints, dim, dist,
1548                             (AF_Edge_Flags)base_edge->flags,
1549                             (AF_Edge_Flags)stem_edge->flags );
1550
1551
1552    stem_edge->pos = base_edge->pos + fitted_width;
1553  }
1554
1555
1556  static void
1557  af_latin_align_serif_edge( AF_GlyphHints  hints,
1558                             AF_Edge        base,
1559                             AF_Edge        serif )
1560  {
1561    FT_UNUSED( hints );
1562
1563    serif->pos = base->pos + (serif->opos - base->opos);
1564  }
1565
1566
1567  /*************************************************************************/
1568  /*************************************************************************/
1569  /*************************************************************************/
1570  /****                                                                 ****/
1571  /****                    E D G E   H I N T I N G                      ****/
1572  /****                                                                 ****/
1573  /*************************************************************************/
1574  /*************************************************************************/
1575  /*************************************************************************/
1576
1577
1578  FT_LOCAL_DEF( void )
1579  af_latin_hint_edges( AF_GlyphHints  hints,
1580                       AF_Dimension   dim )
1581  {
1582    AF_AxisHints  axis       = &hints->axis[dim];
1583    AF_Edge       edges      = axis->edges;
1584    AF_Edge       edge_limit = edges + axis->num_edges;
1585    FT_Int        n_edges;
1586    AF_Edge       edge;
1587    AF_Edge       anchor     = 0;
1588    FT_Int        has_serifs = 0;
1589
1590
1591    /* we begin by aligning all stems relative to the blue zone */
1592    /* if needed -- that's only for horizontal edges            */
1593
1594    if ( dim == AF_DIMENSION_VERT )
1595    {
1596      for ( edge = edges; edge < edge_limit; edge++ )
1597      {
1598        AF_Width  blue;
1599        AF_Edge   edge1, edge2;
1600
1601
1602        if ( edge->flags & AF_EDGE_DONE )
1603          continue;
1604
1605        blue  = edge->blue_edge;
1606        edge1 = NULL;
1607        edge2 = edge->link;
1608
1609        if ( blue )
1610        {
1611          edge1 = edge;
1612        }
1613        else if ( edge2 && edge2->blue_edge )
1614        {
1615          blue  = edge2->blue_edge;
1616          edge1 = edge2;
1617          edge2 = edge;
1618        }
1619
1620        if ( !edge1 )
1621          continue;
1622
1623        edge1->pos    = blue->fit;
1624        edge1->flags |= AF_EDGE_DONE;
1625
1626        if ( edge2 && !edge2->blue_edge )
1627        {
1628          af_latin_align_linked_edge( hints, dim, edge1, edge2 );
1629          edge2->flags |= AF_EDGE_DONE;
1630        }
1631
1632        if ( !anchor )
1633          anchor = edge;
1634      }
1635    }
1636
1637    /* now we will align all stem edges, trying to maintain the */
1638    /* relative order of stems in the glyph                     */
1639    for ( edge = edges; edge < edge_limit; edge++ )
1640    {
1641      AF_Edge  edge2;
1642
1643
1644      if ( edge->flags & AF_EDGE_DONE )
1645        continue;
1646
1647      /* skip all non-stem edges */
1648      edge2 = edge->link;
1649      if ( !edge2 )
1650      {
1651        has_serifs++;
1652        continue;
1653      }
1654
1655      /* now align the stem */
1656
1657      /* this should not happen, but it's better to be safe */
1658      if ( edge2->blue_edge || edge2 < edge )
1659      {
1660        af_latin_align_linked_edge( hints, dim, edge2, edge );
1661        edge->flags |= AF_EDGE_DONE;
1662        continue;
1663      }
1664
1665      if ( !anchor )
1666      {
1667        FT_Pos  org_len, org_center, cur_len;
1668        FT_Pos  cur_pos1, error1, error2, u_off, d_off;
1669
1670
1671        org_len = edge2->opos - edge->opos;
1672        cur_len = af_latin_compute_stem_width(
1673                    hints, dim, org_len,
1674                    (AF_Edge_Flags)edge->flags,
1675                    (AF_Edge_Flags)edge2->flags );
1676        if ( cur_len <= 64 )
1677          u_off = d_off = 32;
1678        else
1679        {
1680          u_off = 38;
1681          d_off = 26;
1682        }
1683
1684        if ( cur_len < 96 )
1685        {
1686          org_center = edge->opos + ( org_len >> 1 );
1687
1688          cur_pos1   = FT_PIX_ROUND( org_center );
1689
1690          error1 = org_center - ( cur_pos1 - u_off );
1691          if ( error1 < 0 )
1692            error1 = -error1;
1693
1694          error2 = org_center - ( cur_pos1 + d_off );
1695          if ( error2 < 0 )
1696            error2 = -error2;
1697
1698          if ( error1 < error2 )
1699            cur_pos1 -= u_off;
1700          else
1701            cur_pos1 += d_off;
1702
1703          edge->pos  = cur_pos1 - cur_len / 2;
1704          edge2->pos = cur_pos1 + cur_len / 2;
1705
1706        }
1707        else
1708          edge->pos = FT_PIX_ROUND( edge->opos );
1709
1710        anchor = edge;
1711
1712        edge->flags |= AF_EDGE_DONE;
1713
1714        af_latin_align_linked_edge( hints, dim, edge, edge2 );
1715      }
1716      else
1717      {
1718        FT_Pos  org_pos, org_len, org_center, cur_len;
1719        FT_Pos  cur_pos1, cur_pos2, delta1, delta2;
1720
1721
1722        org_pos    = anchor->pos + ( edge->opos - anchor->opos );
1723        org_len    = edge2->opos - edge->opos;
1724        org_center = org_pos + ( org_len >> 1 );
1725
1726        cur_len = af_latin_compute_stem_width(
1727                   hints, dim, org_len,
1728                   (AF_Edge_Flags)edge->flags,
1729                   (AF_Edge_Flags)edge2->flags );
1730
1731        if ( cur_len < 96 )
1732        {
1733          FT_Pos  u_off, d_off;
1734
1735
1736          cur_pos1 = FT_PIX_ROUND( org_center );
1737
1738          if (cur_len <= 64 )
1739            u_off = d_off = 32;
1740          else
1741          {
1742            u_off = 38;
1743            d_off = 26;
1744          }
1745
1746          delta1 = org_center - ( cur_pos1 - u_off );
1747          if ( delta1 < 0 )
1748            delta1 = -delta1;
1749
1750          delta2 = org_center - ( cur_pos1 + d_off );
1751          if ( delta2 < 0 )
1752            delta2 = -delta2;
1753
1754          if ( delta1 < delta2 )
1755            cur_pos1 -= u_off;
1756          else
1757            cur_pos1 += d_off;
1758
1759          edge->pos  = cur_pos1 - cur_len / 2;
1760          edge2->pos = cur_pos1 + cur_len / 2;
1761        }
1762        else
1763        {
1764          org_pos    = anchor->pos + ( edge->opos - anchor->opos );
1765          org_len    = edge2->opos - edge->opos;
1766          org_center = org_pos + ( org_len >> 1 );
1767
1768          cur_len    = af_latin_compute_stem_width(
1769                         hints, dim, org_len,
1770                         (AF_Edge_Flags)edge->flags,
1771                         (AF_Edge_Flags)edge2->flags );
1772
1773          cur_pos1   = FT_PIX_ROUND( org_pos );
1774          delta1     = cur_pos1 + ( cur_len >> 1 ) - org_center;
1775          if ( delta1 < 0 )
1776            delta1 = -delta1;
1777
1778          cur_pos2   = FT_PIX_ROUND( org_pos + org_len ) - cur_len;
1779          delta2     = cur_pos2 + ( cur_len >> 1 ) - org_center;
1780          if ( delta2 < 0 )
1781            delta2 = -delta2;
1782
1783          edge->pos  = ( delta1 < delta2 ) ? cur_pos1 : cur_pos2;
1784          edge2->pos = edge->pos + cur_len;
1785        }
1786
1787        edge->flags  |= AF_EDGE_DONE;
1788        edge2->flags |= AF_EDGE_DONE;
1789
1790        if ( edge > edges && edge->pos < edge[-1].pos )
1791          edge->pos = edge[-1].pos;
1792      }
1793    }
1794
1795    /* make sure that lowercase m's maintain their symmetry */
1796
1797    /* In general, lowercase m's have six vertical edges if they are sans */
1798    /* serif, or twelve if they are with serifs.  This implementation is  */
1799    /* based on that assumption, and seems to work very well with most    */
1800    /* faces.  However, if for a certain face this assumption is not      */
1801    /* true, the m is just rendered like before.  In addition, any stem   */
1802    /* correction will only be applied to symmetrical glyphs (even if the */
1803    /* glyph is not an m), so the potential for unwanted distortion is    */
1804    /* relatively low.                                                    */
1805
1806    /* We don't handle horizontal edges since we can't easily assure that */
1807    /* the third (lowest) stem aligns with the base line; it might end up */
1808    /* one pixel higher or lower.                                         */
1809
1810    n_edges = edge_limit - edges;
1811    if ( dim == AF_DIMENSION_HORZ && ( n_edges == 6 || n_edges == 12 ) )
1812    {
1813      AF_Edge  edge1, edge2, edge3;
1814      FT_Pos   dist1, dist2, span, delta;
1815
1816
1817      if ( n_edges == 6 )
1818      {
1819        edge1 = edges;
1820        edge2 = edges + 2;
1821        edge3 = edges + 4;
1822      }
1823      else
1824      {
1825        edge1 = edges + 1;
1826        edge2 = edges + 5;
1827        edge3 = edges + 9;
1828      }
1829
1830      dist1 = edge2->opos - edge1->opos;
1831      dist2 = edge3->opos - edge2->opos;
1832
1833      span = dist1 - dist2;
1834      if ( span < 0 )
1835        span = -span;
1836
1837      if ( span < 8 )
1838      {
1839        delta = edge3->pos - ( 2 * edge2->pos - edge1->pos );
1840        edge3->pos -= delta;
1841        if ( edge3->link )
1842          edge3->link->pos -= delta;
1843
1844        /* move the serifs along with the stem */
1845        if ( n_edges == 12 )
1846        {
1847          ( edges + 8 )->pos -= delta;
1848          ( edges + 11 )->pos -= delta;
1849        }
1850
1851        edge3->flags |= AF_EDGE_DONE;
1852        if ( edge3->link )
1853          edge3->link->flags |= AF_EDGE_DONE;
1854      }
1855    }
1856
1857    if ( has_serifs || !anchor )
1858    {
1859      /*
1860       *  now hint the remaining edges (serifs and single) in order
1861       *  to complete our processing
1862       */
1863      for ( edge = edges; edge < edge_limit; edge++ )
1864      {
1865        if ( edge->flags & AF_EDGE_DONE )
1866          continue;
1867
1868        if ( edge->serif )
1869          af_latin_align_serif_edge( hints, edge->serif, edge );
1870        else if ( !anchor )
1871        {
1872          edge->pos = FT_PIX_ROUND( edge->opos );
1873          anchor    = edge;
1874        }
1875        else
1876          edge->pos = anchor->pos +
1877                      FT_PIX_ROUND( edge->opos - anchor->opos );
1878
1879        edge->flags |= AF_EDGE_DONE;
1880
1881        if ( edge > edges && edge->pos < edge[-1].pos )
1882          edge->pos = edge[-1].pos;
1883
1884        if ( edge + 1 < edge_limit        &&
1885             edge[1].flags & AF_EDGE_DONE &&
1886             edge->pos > edge[1].pos      )
1887          edge->pos = edge[1].pos;
1888      }
1889    }
1890  }
1891
1892
1893  static FT_Error
1894  af_latin_hints_apply( AF_GlyphHints    hints,
1895                        FT_Outline*      outline,
1896                        AF_LatinMetrics  metrics )
1897  {
1898    FT_Error  error;
1899    int       dim;
1900
1901
1902    error = af_glyph_hints_reload( hints, outline );
1903    if ( error )
1904      goto Exit;
1905
1906    /* analyze glyph outline */
1907    if ( AF_HINTS_DO_HORIZONTAL( hints ) )
1908    {
1909      error = af_latin_hints_detect_features( hints, AF_DIMENSION_HORZ );
1910      if ( error )
1911        goto Exit;
1912    }
1913
1914    if ( AF_HINTS_DO_VERTICAL( hints ) )
1915    {
1916      error = af_latin_hints_detect_features( hints, AF_DIMENSION_VERT );
1917      if ( error )
1918        goto Exit;
1919
1920      af_latin_hints_compute_blue_edges( hints, metrics );
1921    }
1922
1923    /* grid-fit the outline */
1924    for ( dim = 0; dim < AF_DIMENSION_MAX; dim++ )
1925    {
1926      if ( ( dim == AF_DIMENSION_HORZ && AF_HINTS_DO_HORIZONTAL( hints ) ) ||
1927           ( dim == AF_DIMENSION_VERT && AF_HINTS_DO_VERTICAL( hints ) )   )
1928      {
1929        af_latin_hint_edges( hints, (AF_Dimension)dim );
1930        af_glyph_hints_align_edge_points( hints, (AF_Dimension)dim );
1931        af_glyph_hints_align_strong_points( hints, (AF_Dimension)dim );
1932        af_glyph_hints_align_weak_points( hints, (AF_Dimension)dim );
1933      }
1934    }
1935    af_glyph_hints_save( hints, outline );
1936
1937  Exit:
1938    return error;
1939  }
1940
1941
1942  /*************************************************************************/
1943  /*************************************************************************/
1944  /*****                                                               *****/
1945  /*****              L A T I N   S C R I P T   C L A S S              *****/
1946  /*****                                                               *****/
1947  /*************************************************************************/
1948  /*************************************************************************/
1949
1950
1951  static const AF_Script_UniRangeRec  af_latin_uniranges[] =
1952  {
1953    { 32,  127 },    /* XXX: TODO: Add new Unicode ranges here! */
1954    { 160, 255 },
1955    { 0,   0 }
1956  };
1957
1958
1959  FT_CALLBACK_TABLE_DEF const AF_ScriptClassRec
1960  af_latin_script_class =
1961  {
1962    AF_SCRIPT_LATIN,
1963    af_latin_uniranges,
1964
1965    sizeof( AF_LatinMetricsRec ),
1966
1967    (AF_Script_InitMetricsFunc) af_latin_metrics_init,
1968    (AF_Script_ScaleMetricsFunc)af_latin_metrics_scale,
1969    (AF_Script_DoneMetricsFunc) NULL,
1970
1971    (AF_Script_InitHintsFunc)   af_latin_hints_init,
1972    (AF_Script_ApplyHintsFunc)  af_latin_hints_apply
1973  };
1974
1975
1976/* END */
Note: See TracBrowser for help on using the repository browser.