4 * Copyright (C) 2011-2017 by Werner Lemberg.
6 * This file is part of the ttfautohint library, and may only be used,
7 * modified, and distributed under the terms given in `COPYING'. By
8 * continuing to use, modify, or distribute this file you indicate that you
9 * have read `COPYING' and understand and accept it fully.
11 * The file `COPYING' mentioned in the previous paragraph is distributed
12 * with the ttfautohint library.
16 /* originally file `afhints.c' (2011-Mar-28) from FreeType */
18 /* heavily modified 2011 by Werner Lemberg <wl@gnu.org> */
27 /* get new segment for given axis */
30 ta_axis_hints_new_segment(TA_AxisHints axis
,
33 FT_Error error
= FT_Err_Ok
;
34 TA_Segment segment
= NULL
;
37 if (axis
->num_segments
< TA_SEGMENTS_EMBEDDED
)
41 axis
->segments
= axis
->embedded
.segments
;
42 axis
->max_segments
= TA_SEGMENTS_EMBEDDED
;
45 else if (axis
->num_segments
>= axis
->max_segments
)
47 TA_Segment segments_new
;
49 FT_Int old_max
= axis
->max_segments
;
50 FT_Int new_max
= old_max
;
51 FT_Int big_max
= (FT_Int
)(FT_INT_MAX
/ sizeof (*segment
));
54 if (old_max
>= big_max
)
56 error
= FT_Err_Out_Of_Memory
;
60 new_max
+= (new_max
>> 2) + 4;
65 if (axis
->segments
== axis
->embedded
.segments
)
67 axis
->segments
= (TA_Segment
)malloc(
68 (size_t)new_max
* sizeof (TA_SegmentRec
));
70 return FT_Err_Out_Of_Memory
;
72 memcpy(axis
->segments
, axis
->embedded
.segments
,
73 sizeof (axis
->embedded
.segments
));
77 segments_new
= (TA_Segment
)realloc(
79 (size_t)new_max
* sizeof (TA_SegmentRec
));
81 return FT_Err_Out_Of_Memory
;
82 axis
->segments
= segments_new
;
85 axis
->max_segments
= new_max
;
88 segment
= axis
->segments
+ axis
->num_segments
++;
96 /* get new edge for given axis, direction, and position, */
97 /* without initializing the edge itself */
100 ta_axis_hints_new_edge(TA_AxisHints axis
,
103 FT_Bool top_to_bottom_hinting
,
106 FT_Error error
= FT_Err_Ok
;
111 if (axis
->num_edges
< TA_EDGES_EMBEDDED
)
115 axis
->edges
= axis
->embedded
.edges
;
116 axis
->max_edges
= TA_EDGES_EMBEDDED
;
119 else if (axis
->num_edges
>= axis
->max_edges
)
123 FT_Int old_max
= axis
->max_edges
;
124 FT_Int new_max
= old_max
;
125 FT_Int big_max
= (FT_Int
)(FT_INT_MAX
/ sizeof (*edge
));
128 if (old_max
>= big_max
)
130 error
= FT_Err_Out_Of_Memory
;
134 new_max
+= (new_max
>> 2) + 4;
135 if (new_max
< old_max
136 || new_max
> big_max
)
139 if (axis
->edges
== axis
->embedded
.edges
)
141 axis
->edges
= (TA_Edge
)malloc((size_t)new_max
* sizeof (TA_EdgeRec
));
143 return FT_Err_Out_Of_Memory
;
145 memcpy(axis
->edges
, axis
->embedded
.edges
,
146 sizeof (axis
->embedded
.edges
));
150 edges_new
= (TA_Edge
)realloc(axis
->edges
,
151 (size_t)new_max
* sizeof (TA_EdgeRec
));
153 return FT_Err_Out_Of_Memory
;
154 axis
->edges
= edges_new
;
157 axis
->max_edges
= new_max
;
161 edge
= edges
+ axis
->num_edges
;
165 if (top_to_bottom_hinting
? (edge
[-1].fpos
> fpos
)
166 : (edge
[-1].fpos
< fpos
))
169 /* we want the edge with same position and minor direction */
170 /* to appear before those in the major one in the list */
171 if (edge
[-1].fpos
== fpos
172 && dir
== axis
->major_dir
)
195 _ta_message(const char* format
,
201 va_start(ap
, format
);
202 vfprintf(stderr
, format
, ap
);
208 ta_dir_str(TA_Direction dir
)
235 #define TA_INDEX_NUM(ptr, base) \
236 (int)((ptr) ? ((ptr) - (base)) \
241 ta_print_idx(char* p
,
251 sprintf(p
, "%d", idx
);
258 ta_get_segment_index(TA_GlyphHints hints
,
262 TA_AxisHints axis
= &hints
->axis
[dimension
];
263 TA_Point point
= hints
->points
+ point_idx
;
264 TA_Segment segments
= axis
->segments
;
265 TA_Segment limit
= segments
+ axis
->num_segments
;
269 for (segment
= segments
; segment
< limit
; segment
++)
271 if (segment
->first
<= segment
->last
)
273 if (point
>= segment
->first
&& point
<= segment
->last
)
278 TA_Point p
= segment
->first
;
286 if (p
== segment
->last
)
295 if (segment
== limit
)
298 return (int)(segment
- segments
);
303 ta_get_edge_index(TA_GlyphHints hints
,
307 TA_AxisHints axis
= &hints
->axis
[dimension
];
308 TA_Edge edges
= axis
->edges
;
309 TA_Segment segment
= axis
->segments
+ segment_idx
;
312 return segment_idx
== -1 ? -1 : TA_INDEX_NUM(segment
->edge
, edges
);
317 ta_glyph_hints_dump_points(TA_GlyphHints hints
)
319 TA_Point points
= hints
->points
;
320 TA_Point limit
= points
+ hints
->num_points
;
321 TA_Point
* contour
= hints
->contours
;
322 TA_Point
* climit
= contour
+ hints
->num_contours
;
326 TA_LOG(("Table of points:\n"));
328 if (hints
->num_points
)
330 TA_LOG((" index hedge hseg flags"
331 /* " XXXXX XXXXX XXXXX XXXX" */
332 " xorg yorg xscale yscale xfit yfit"));
333 /* " XXXXX XXXXX XXXX.XX XXXX.XX XXXX.XX XXXX.XX" */
336 TA_LOG((" (none)\n"));
338 for (point
= points
; point
< limit
; point
++)
340 int point_idx
= TA_INDEX_NUM(point
, points
);
341 int segment_idx_1
= ta_get_segment_index(hints
, point_idx
, 1);
343 char buf1
[16], buf2
[16];
346 /* insert extra newline at the beginning of a contour */
347 if (contour
< climit
&& *contour
== point
)
353 /* we don't show vertical edges since they are never used */
354 TA_LOG((" %5d %5s %5s %4s"
355 " %5d %5d %7.2f %7.2f %7.2f %7.2f\n",
358 ta_get_edge_index(hints
, segment_idx_1
, 1)),
359 ta_print_idx(buf2
, segment_idx_1
),
360 (point
->flags
& TA_FLAG_WEAK_INTERPOLATION
) ? "weak" : " -- ",
374 ta_edge_flags_to_string(FT_Byte flags
)
376 static char temp
[32];
380 if (flags
& TA_EDGE_ROUND
)
382 memcpy(temp
+ pos
, "round", 5);
385 if (flags
& TA_EDGE_SERIF
)
389 memcpy(temp
+ pos
, "serif", 5);
401 /* dump the array of linked segments */
404 ta_glyph_hints_dump_segments(TA_GlyphHints hints
)
409 for (dimension
= TA_DEBUG_STARTDIM
;
410 dimension
>= TA_DEBUG_ENDDIM
;
413 TA_AxisHints axis
= &hints
->axis
[dimension
];
414 TA_Point points
= hints
->points
;
415 TA_Edge edges
= axis
->edges
;
416 TA_Segment segments
= axis
->segments
;
417 TA_Segment limit
= segments
+ axis
->num_segments
;
420 char buf1
[16], buf2
[16], buf3
[16];
423 TA_LOG(("Table of %s segments:\n",
424 dimension
== TA_DIMENSION_HORZ
? "vertical"
426 if (axis
->num_segments
)
428 TA_LOG((" index pos delta dir from to "
429 /* " XXXXX XXXXX XXXXX XXXXX XXXX XXXX" */
431 /* " XXXX XXXXX XXXX" */
432 " height extra flags\n"));
433 /* " XXXXXX XXXXX XXXXXXXXXXX" */
436 TA_LOG((" (none)\n"));
438 for (seg
= segments
; seg
< limit
; seg
++)
439 TA_LOG((" %5d %5d %5d %5s %4d %4d"
442 TA_INDEX_NUM(seg
, segments
),
445 ta_dir_str((TA_Direction
)seg
->dir
),
446 TA_INDEX_NUM(seg
->first
, points
),
447 TA_INDEX_NUM(seg
->last
, points
),
449 ta_print_idx(buf1
, TA_INDEX_NUM(seg
->link
, segments
)),
450 ta_print_idx(buf2
, TA_INDEX_NUM(seg
->serif
, segments
)),
451 ta_print_idx(buf3
, TA_INDEX_NUM(seg
->edge
, edges
)),
454 seg
->height
- (seg
->max_coord
- seg
->min_coord
),
455 ta_edge_flags_to_string(seg
->flags
)));
461 /* dump the array of linked edges */
464 ta_glyph_hints_dump_edges(TA_GlyphHints hints
)
469 for (dimension
= TA_DEBUG_STARTDIM
;
470 dimension
>= TA_DEBUG_ENDDIM
;
473 TA_AxisHints axis
= &hints
->axis
[dimension
];
474 TA_Edge edges
= axis
->edges
;
475 TA_Edge limit
= edges
+ axis
->num_edges
;
478 char buf1
[16], buf2
[16];
481 /* note that TA_DIMENSION_HORZ corresponds to _vertical_ edges */
482 /* since they have a constant X coordinate */
483 if (dimension
== TA_DIMENSION_HORZ
)
484 TA_LOG(("Table of %s edges (1px=%.2fu, 10u=%.2fpx):\n",
486 65536.0 * 64.0 / hints
->x_scale
,
487 10.0 * hints
->x_scale
/ 65536.0 / 64.0));
489 TA_LOG(("Table of %s edges (1px=%.2fu, 10u=%.2fpx):\n",
491 65536.0 * 64.0 / hints
->y_scale
,
492 10.0 * hints
->y_scale
/ 65536.0 / 64.0));
496 TA_LOG((" index pos dir link serif"
497 /* " XXXXX XXXX.XX XXXXX XXXX XXXXX" */
498 " blue opos pos flags\n"));
499 /* " X XXXX.XX XXXX.XX XXXXXXXXXXX" */
502 TA_LOG((" (none)\n"));
504 for (edge
= edges
; edge
< limit
; edge
++)
505 TA_LOG((" %5d %7.2f %5s %4s %5s"
506 " %c %7.2f %7.2f %11s\n",
507 TA_INDEX_NUM(edge
, edges
),
508 (int)edge
->opos
/ 64.0,
509 ta_dir_str((TA_Direction
)edge
->dir
),
510 ta_print_idx(buf1
, TA_INDEX_NUM(edge
->link
, edges
)),
511 ta_print_idx(buf2
, TA_INDEX_NUM(edge
->serif
, edges
)),
513 edge
->blue_edge
? 'y' : 'n',
516 ta_edge_flags_to_string(edge
->flags
)));
521 #endif /* TA_DEBUG */
524 /* compute the direction value of a given vector */
527 ta_direction_compute(FT_Pos dx
,
530 FT_Pos ll
, ss
; /* long and short arm lengths */
531 TA_Direction dir
; /* candidate direction */
565 /* return no direction if arm lengths do not differ enough */
566 /* (value 14 is heuristic, corresponding to approx. 4.1 degrees); */
567 /* the long arm is never negative */
568 if (ll
<= 14 * TA_ABS(ss
))
576 ta_glyph_hints_init(TA_GlyphHints hints
)
578 /* no need to initialize the embedded items */
579 memset(hints
, 0, sizeof (*hints
) - sizeof (hints
->embedded
));
584 ta_glyph_hints_done(TA_GlyphHints hints
)
592 /* we don't need to free the segment and edge buffers */
593 /* since they are really within the hints->points array */
594 for (dim
= 0; dim
< TA_DIMENSION_MAX
; dim
++)
596 TA_AxisHints axis
= &hints
->axis
[dim
];
599 axis
->num_segments
= 0;
600 axis
->max_segments
= 0;
601 if (axis
->segments
!= axis
->embedded
.segments
)
603 free(axis
->segments
);
604 axis
->segments
= NULL
;
609 if (axis
->edges
!= axis
->embedded
.edges
)
616 if (hints
->contours
!= hints
->embedded
.contours
)
618 free(hints
->contours
);
619 hints
->contours
= NULL
;
621 hints
->max_contours
= 0;
622 hints
->num_contours
= 0;
624 if (hints
->points
!= hints
->embedded
.points
)
627 hints
->points
= NULL
;
629 hints
->max_points
= 0;
630 hints
->num_points
= 0;
637 ta_glyph_hints_rescale(TA_GlyphHints hints
,
638 TA_StyleMetrics metrics
)
640 hints
->metrics
= metrics
;
641 hints
->scaler_flags
= metrics
->scaler
.flags
;
645 /* from FreeType's ftcalc.c */
648 ta_corner_is_flat(FT_Pos in_x
,
656 FT_Pos d_in
, d_out
, d_corner
;
681 return (d_in
+ d_out
- d_corner
) < (d_corner
>> 4);
685 /* recompute all TA_Point in TA_GlyphHints */
686 /* from the definitions in a source outline */
689 ta_glyph_hints_reload(TA_GlyphHints hints
,
692 FT_Error error
= FT_Err_Ok
;
694 FT_UInt old_max
, new_max
;
696 FT_Fixed x_scale
= hints
->x_scale
;
697 FT_Fixed y_scale
= hints
->y_scale
;
698 FT_Pos x_delta
= hints
->x_delta
;
699 FT_Pos y_delta
= hints
->y_delta
;
702 hints
->num_points
= 0;
703 hints
->num_contours
= 0;
705 hints
->axis
[0].num_segments
= 0;
706 hints
->axis
[0].num_edges
= 0;
707 hints
->axis
[1].num_segments
= 0;
708 hints
->axis
[1].num_edges
= 0;
710 /* first of all, reallocate the contours array if necessary */
711 new_max
= (FT_UInt
)outline
->n_contours
;
712 old_max
= (FT_UInt
)hints
->max_contours
;
714 if (new_max
<= TA_CONTOURS_EMBEDDED
)
716 if (!hints
->contours
)
718 hints
->contours
= hints
->embedded
.contours
;
719 hints
->max_contours
= TA_CONTOURS_EMBEDDED
;
722 else if (new_max
> old_max
)
724 TA_Point
* contours_new
;
727 if (hints
->contours
== hints
->embedded
.contours
)
728 hints
->contours
= NULL
;
730 new_max
= (new_max
+ 3) & ~3U; /* round up to a multiple of 4 */
732 contours_new
= (TA_Point
*)realloc(hints
->contours
,
733 new_max
* sizeof (TA_Point
));
735 return FT_Err_Out_Of_Memory
;
737 hints
->contours
= contours_new
;
738 hints
->max_contours
= (FT_Int
)new_max
;
741 /* reallocate the points arrays if necessary -- we reserve */
742 /* two additional point positions, used to hint metrics appropriately */
743 new_max
= (FT_UInt
)(outline
->n_points
+ 2);
744 old_max
= (FT_UInt
)hints
->max_points
;
746 if (new_max
<= TA_POINTS_EMBEDDED
)
750 hints
->points
= hints
->embedded
.points
;
751 hints
->max_points
= TA_POINTS_EMBEDDED
;
754 else if (new_max
> old_max
)
759 if (hints
->points
== hints
->embedded
.points
)
760 hints
->points
= NULL
;
762 new_max
= (new_max
+ 2 + 7) & ~7U; /* round up to a multiple of 8 */
764 points_new
= (TA_Point
)realloc(hints
->points
,
765 new_max
* sizeof (TA_PointRec
));
767 return FT_Err_Out_Of_Memory
;
769 hints
->points
= points_new
;
770 hints
->max_points
= (FT_Int
)new_max
;
773 hints
->num_points
= outline
->n_points
;
774 hints
->num_contours
= outline
->n_contours
;
776 /* we can't rely on the value of `FT_Outline.flags' to know the fill */
777 /* direction used for a glyph, given that some fonts are broken */
778 /* (e.g. the Arphic ones); we thus recompute it each time we need to */
780 hints
->axis
[TA_DIMENSION_HORZ
].major_dir
= TA_DIR_UP
;
781 hints
->axis
[TA_DIMENSION_VERT
].major_dir
= TA_DIR_LEFT
;
783 if (FT_Outline_Get_Orientation(outline
) == FT_ORIENTATION_POSTSCRIPT
)
785 hints
->axis
[TA_DIMENSION_HORZ
].major_dir
= TA_DIR_DOWN
;
786 hints
->axis
[TA_DIMENSION_VERT
].major_dir
= TA_DIR_RIGHT
;
789 hints
->x_scale
= x_scale
;
790 hints
->y_scale
= y_scale
;
791 hints
->x_delta
= x_delta
;
792 hints
->y_delta
= y_delta
;
794 hints
->xmin_delta
= 0;
795 hints
->xmax_delta
= 0;
797 points
= hints
->points
;
798 if (hints
->num_points
== 0)
803 TA_Point point_limit
= points
+ hints
->num_points
;
806 /* compute coordinates & Bezier flags, next and prev */
808 FT_Vector
* vec
= outline
->points
;
809 char* tag
= outline
->tags
;
811 TA_Point end
= points
+ outline
->contours
[0];
814 FT_Int contour_index
= 0;
817 for (point
= points
; point
< point_limit
; point
++, vec
++, tag
++)
819 point
->in_dir
= (FT_Char
)TA_DIR_NONE
;
820 point
->out_dir
= (FT_Char
)TA_DIR_NONE
;
822 point
->fx
= (FT_Short
)vec
->x
;
823 point
->fy
= (FT_Short
)vec
->y
;
824 point
->ox
= point
->x
= FT_MulFix(vec
->x
, x_scale
) + x_delta
;
825 point
->oy
= point
->y
= FT_MulFix(vec
->y
, y_scale
) + y_delta
;
827 switch (FT_CURVE_TAG(*tag
))
829 case FT_CURVE_TAG_CONIC
:
830 point
->flags
= TA_FLAG_CONIC
;
832 case FT_CURVE_TAG_CUBIC
:
833 point
->flags
= TA_FLAG_CUBIC
;
836 point
->flags
= TA_FLAG_NONE
;
845 if (++contour_index
< outline
->n_contours
)
847 end
= points
+ outline
->contours
[contour_index
];
854 /* set up the contours array */
856 TA_Point
* contour
= hints
->contours
;
857 TA_Point
* contour_limit
= contour
+ hints
->num_contours
;
859 short* end
= outline
->contours
;
863 for (; contour
< contour_limit
; contour
++, end
++)
865 contour
[0] = points
+ idx
;
866 idx
= (short)(end
[0] + 1);
872 * Compute directions of `in' and `out' vectors.
874 * Note that distances between points that are very near to each
875 * other are accumulated. In other words, the auto-hinter
876 * prepends the small vectors between near points to the first
877 * non-near vector. All intermediate points are tagged as
878 * weak; the directions are adjusted also to be equal to the
882 /* value 20 in `near_limit' is heuristic */
883 FT_UInt units_per_em
= hints
->metrics
->scaler
.face
->units_per_EM
;
884 FT_Int near_limit
= 20 * units_per_em
/ 2048;
885 FT_Int near_limit2
= 2 * near_limit
- 1;
888 TA_Point
* contour_limit
= hints
->contours
+ hints
->num_contours
;
891 for (contour
= hints
->contours
; contour
< contour_limit
; contour
++)
893 TA_Point first
= *contour
;
894 TA_Point next
, prev
, curr
;
899 /* since the first point of a contour could be part of a */
900 /* series of near points, go backwards to find the first */
901 /* non-near point and adjust `first' */
906 while (prev
!= first
)
908 out_x
= point
->fx
- prev
->fx
;
909 out_y
= point
->fy
- prev
->fy
;
912 * We use Taxicab metrics to measure the vector length.
914 * Note that the accumulated distances so far could have the
915 * opposite direction of the distance measured here. For this
916 * reason we use `near_limit2' for the comparison to get a
917 * non-near point even in the worst case.
919 if (TA_ABS(out_x
) + TA_ABS(out_y
) >= near_limit2
)
926 /* adjust first point */
929 /* now loop over all points of the contour to get */
930 /* `in' and `out' vector directions */
935 * We abuse the `u' and `v' fields to store index deltas to the
936 * next and previous non-near point, respectively.
938 * To avoid problems with not having non-near points, we point to
939 * `first' by default as the next non-near point.
941 curr
->u
= (FT_Pos
)(first
- curr
);
950 TA_Direction out_dir
;
956 out_x
+= next
->fx
- point
->fx
;
957 out_y
+= next
->fy
- point
->fy
;
959 if (TA_ABS(out_x
) + TA_ABS(out_y
) < near_limit
)
961 next
->flags
|= TA_FLAG_WEAK_INTERPOLATION
;
965 curr
->u
= (FT_Pos
)(next
- curr
);
968 out_dir
= ta_direction_compute(out_x
, out_y
);
970 /* adjust directions for all points inbetween; */
971 /* the loop also updates position of `curr' */
972 curr
->out_dir
= (FT_Char
)out_dir
;
973 for (curr
= curr
->next
; curr
!= next
; curr
= curr
->next
)
975 curr
->in_dir
= (FT_Char
)out_dir
;
976 curr
->out_dir
= (FT_Char
)out_dir
;
978 next
->in_dir
= (FT_Char
)out_dir
;
980 curr
->u
= (FT_Pos
)(first
- curr
);
986 } while (next
!= first
);
990 * The next step is to `simplify' an outline's topology so that we
991 * can identify local extrema more reliably: A series of
992 * non-horizontal or non-vertical vectors pointing into the same
993 * quadrant are handled as a single, long vector. From a
994 * topological point of the view, the intermediate points are of no
995 * interest and thus tagged as weak.
998 for (point
= points
; point
< point_limit
; point
++)
1000 if (point
->flags
& TA_FLAG_WEAK_INTERPOLATION
)
1003 if (point
->in_dir
== TA_DIR_NONE
1004 && point
->out_dir
== TA_DIR_NONE
)
1006 /* check whether both vectors point into the same quadrant */
1009 FT_Pos out_x
, out_y
;
1011 TA_Point next_u
= point
+ point
->u
;
1012 TA_Point prev_v
= point
+ point
->v
;
1015 in_x
= point
->fx
- prev_v
->fx
;
1016 in_y
= point
->fy
- prev_v
->fy
;
1018 out_x
= next_u
->fx
- point
->fx
;
1019 out_y
= next_u
->fy
- point
->fy
;
1021 if ((in_x
^ out_x
) >= 0 && (in_y
^ out_y
) >= 0)
1023 /* yes, so tag current point as weak */
1024 /* and update index deltas */
1026 point
->flags
|= TA_FLAG_WEAK_INTERPOLATION
;
1028 prev_v
->u
= (FT_Pos
)(next_u
- prev_v
);
1029 next_u
->v
= -prev_v
->u
;
1035 * Finally, check for remaining weak points. Everything else not
1036 * collected in edges so far is then implicitly classified as strong
1040 for (point
= points
; point
< point_limit
; point
++)
1042 if (point
->flags
& TA_FLAG_WEAK_INTERPOLATION
)
1045 if (point
->flags
& TA_FLAG_CONTROL
)
1047 /* control points are always weak */
1049 point
->flags
|= TA_FLAG_WEAK_INTERPOLATION
;
1051 else if (point
->out_dir
== point
->in_dir
)
1053 if (point
->out_dir
!= TA_DIR_NONE
)
1055 /* current point lies on a horizontal or */
1056 /* vertical segment (but doesn't start or end it) */
1061 TA_Point next_u
= point
+ point
->u
;
1062 TA_Point prev_v
= point
+ point
->v
;
1065 if (ta_corner_is_flat(point
->fx
- prev_v
->fx
,
1066 point
->fy
- prev_v
->fy
,
1067 next_u
->fx
- point
->fx
,
1068 next_u
->fy
- point
->fy
))
1070 /* either the `in' or the `out' vector is much more */
1071 /* dominant than the other one, so tag current point */
1072 /* as weak and update index deltas */
1074 prev_v
->u
= (FT_Pos
)(next_u
- prev_v
);
1075 next_u
->v
= -prev_v
->u
;
1081 else if (point
->in_dir
== -point
->out_dir
)
1083 /* current point forms a spike */
1090 /* change some directions at the user's request */
1091 /* to make ttfautohint insert one-point segments */
1092 /* or remove points from segments */
1101 /* `globals' is not set up while initializing metrics, */
1102 /* so exit early in this case */
1103 if (!hints
->metrics
->globals
)
1106 font
= hints
->metrics
->globals
->font
;
1108 /* start conditions are set with `TA_control_segment_dir_collect' */
1109 while (TA_control_segment_dir_get_next(font
, &idx
, &dir
,
1110 &left_offset
, &right_offset
))
1112 TA_Point point
= &points
[idx
];
1115 point
->out_dir
= dir
;
1116 if (dir
== TA_DIR_NONE
)
1117 point
->flags
|= TA_FLAG_WEAK_INTERPOLATION
;
1119 point
->flags
&= ~TA_FLAG_WEAK_INTERPOLATION
;
1120 point
->left_offset
= (FT_Short
)left_offset
;
1121 point
->right_offset
= (FT_Short
)right_offset
;
1130 /* store the hinted outline in an FT_Outline structure */
1133 ta_glyph_hints_save(TA_GlyphHints hints
,
1134 FT_Outline
* outline
)
1136 TA_Point point
= hints
->points
;
1137 TA_Point limit
= point
+ hints
->num_points
;
1139 FT_Vector
* vec
= outline
->points
;
1140 char* tag
= outline
->tags
;
1143 for (; point
< limit
; point
++, vec
++, tag
++)
1148 if (point
->flags
& TA_FLAG_CONIC
)
1149 tag
[0] = FT_CURVE_TAG_CONIC
;
1150 else if (point
->flags
& TA_FLAG_CUBIC
)
1151 tag
[0] = FT_CURVE_TAG_CUBIC
;
1153 tag
[0] = FT_CURVE_TAG_ON
;
1158 /****************************************************************
1160 * EDGE POINT GRID-FITTING
1162 ****************************************************************/
1165 /* align all points of an edge to the same coordinate value, */
1166 /* either horizontally or vertically */
1169 ta_glyph_hints_align_edge_points(TA_GlyphHints hints
,
1172 TA_AxisHints axis
= &hints
->axis
[dim
];
1173 TA_Segment segments
= axis
->segments
;
1174 TA_Segment segment_limit
= segments
+ axis
->num_segments
;
1178 if (dim
== TA_DIMENSION_HORZ
)
1180 for (seg
= segments
; seg
< segment_limit
; seg
++)
1182 TA_Edge edge
= seg
->edge
;
1183 TA_Point point
, first
, last
;
1194 point
->x
= edge
->pos
;
1195 point
->flags
|= TA_FLAG_TOUCH_X
;
1200 point
= point
->next
;
1206 for (seg
= segments
; seg
< segment_limit
; seg
++)
1208 TA_Edge edge
= seg
->edge
;
1209 TA_Point point
, first
, last
;
1220 point
->y
= edge
->pos
;
1221 point
->flags
|= TA_FLAG_TOUCH_Y
;
1226 point
= point
->next
;
1233 /****************************************************************
1235 * STRONG POINT INTERPOLATION
1237 ****************************************************************/
1240 /* hint the strong points -- */
1241 /* this is equivalent to the TrueType `IP' hinting instruction */
1244 ta_glyph_hints_align_strong_points(TA_GlyphHints hints
,
1247 TA_Point points
= hints
->points
;
1248 TA_Point point_limit
= points
+ hints
->num_points
;
1250 TA_AxisHints axis
= &hints
->axis
[dim
];
1252 TA_Edge edges
= axis
->edges
;
1253 TA_Edge edge_limit
= edges
+ axis
->num_edges
;
1255 FT_UShort touch_flag
;
1258 if (dim
== TA_DIMENSION_HORZ
)
1259 touch_flag
= TA_FLAG_TOUCH_X
;
1261 touch_flag
= TA_FLAG_TOUCH_Y
;
1263 if (edges
< edge_limit
)
1269 for (point
= points
; point
< point_limit
; point
++)
1271 FT_Pos u
, ou
, fu
; /* point position */
1275 if (point
->flags
& touch_flag
)
1278 /* if this point is candidate to weak interpolation, we */
1279 /* interpolate it after all strong points have been processed */
1281 if ((point
->flags
& TA_FLAG_WEAK_INTERPOLATION
))
1284 if (dim
== TA_DIMENSION_VERT
)
1297 /* is the point before the first edge? */
1299 delta
= edge
->fpos
- u
;
1302 u
= edge
->pos
- (edge
->opos
- ou
);
1304 if (hints
->recorder
)
1305 hints
->recorder(ta_ip_before
, hints
, dim
,
1306 point
, NULL
, NULL
, NULL
, NULL
);
1311 /* is the point after the last edge? */
1312 edge
= edge_limit
- 1;
1313 delta
= u
- edge
->fpos
;
1316 u
= edge
->pos
+ (ou
- edge
->opos
);
1318 if (hints
->recorder
)
1319 hints
->recorder(ta_ip_after
, hints
, dim
,
1320 point
, NULL
, NULL
, NULL
, NULL
);
1326 FT_PtrDist min
, max
, mid
;
1330 /* find enclosing edges */
1332 max
= edge_limit
- edges
;
1334 /* for a small number of edges, a linear search is better */
1340 for (nn
= 0; nn
< max
; nn
++)
1341 if (edges
[nn
].fpos
>= u
)
1344 if (edges
[nn
].fpos
== u
)
1348 if (hints
->recorder
)
1349 hints
->recorder(ta_ip_on
, hints
, dim
,
1350 point
, &edges
[nn
], NULL
, NULL
, NULL
);
1359 mid
= (max
+ min
) >> 1;
1369 /* we are on the edge */
1372 if (hints
->recorder
)
1373 hints
->recorder(ta_ip_on
, hints
, dim
,
1374 point
, edge
, NULL
, NULL
, NULL
);
1380 /* point is not on an edge */
1382 TA_Edge before
= edges
+ min
- 1;
1383 TA_Edge after
= edges
+ min
+ 0;
1386 /* assert(before && after && before != after) */
1387 if (before
->scale
== 0)
1388 before
->scale
= FT_DivFix(after
->pos
- before
->pos
,
1389 after
->fpos
- before
->fpos
);
1391 u
= before
->pos
+ FT_MulFix(fu
- before
->fpos
,
1394 if (hints
->recorder
)
1395 hints
->recorder(ta_ip_between
, hints
, dim
,
1396 point
, before
, after
, NULL
, NULL
);
1401 /* save the point position */
1402 if (dim
== TA_DIMENSION_HORZ
)
1407 point
->flags
|= touch_flag
;
1413 /****************************************************************
1415 * WEAK POINT INTERPOLATION
1417 ****************************************************************/
1420 /* shift the original coordinates of all points between `p1' and */
1421 /* `p2' to get hinted coordinates, using the same difference as */
1422 /* given by `ref' */
1425 ta_iup_shift(TA_Point p1
,
1430 FT_Pos delta
= ref
->u
- ref
->v
;
1436 for (p
= p1
; p
< ref
; p
++)
1437 p
->u
= p
->v
+ delta
;
1439 for (p
= ref
+ 1; p
<= p2
; p
++)
1440 p
->u
= p
->v
+ delta
;
1444 /* interpolate the original coordinates of all points between `p1' and */
1445 /* `p2' to get hinted coordinates, using `ref1' and `ref2' as the */
1446 /* reference points; the `u' and `v' members are the current and */
1447 /* original coordinate values, respectively. */
1449 /* details can be found in the TrueType bytecode specification */
1452 ta_iup_interp(TA_Point p1
,
1458 FT_Pos u
, v1
, v2
, u1
, u2
, d1
, d2
;
1464 if (ref1
->v
> ref2
->v
)
1478 if (u1
== u2
|| v1
== v2
)
1480 for (p
= p1
; p
<= p2
; p
++)
1496 FT_Fixed scale
= FT_DivFix(u2
- u1
, v2
- v1
);
1499 for (p
= p1
; p
<= p2
; p
++)
1508 u
= u1
+ FT_MulFix(u
- v1
, scale
);
1516 /* hint the weak points -- */
1517 /* this is equivalent to the TrueType `IUP' hinting instruction */
1520 ta_glyph_hints_align_weak_points(TA_GlyphHints hints
,
1523 TA_Point points
= hints
->points
;
1524 TA_Point point_limit
= points
+ hints
->num_points
;
1526 TA_Point
* contour
= hints
->contours
;
1527 TA_Point
* contour_limit
= contour
+ hints
->num_contours
;
1529 FT_UShort touch_flag
;
1532 TA_Point first_point
;
1535 /* pass 1: move segment points to edge positions */
1537 if (dim
== TA_DIMENSION_HORZ
)
1539 touch_flag
= TA_FLAG_TOUCH_X
;
1541 for (point
= points
; point
< point_limit
; point
++)
1543 point
->u
= point
->x
;
1544 point
->v
= point
->ox
;
1549 touch_flag
= TA_FLAG_TOUCH_Y
;
1551 for (point
= points
; point
< point_limit
; point
++)
1553 point
->u
= point
->y
;
1554 point
->v
= point
->oy
;
1558 for (; contour
< contour_limit
; contour
++)
1560 TA_Point first_touched
, last_touched
;
1564 end_point
= point
->prev
;
1565 first_point
= point
;
1567 /* find first touched point */
1570 if (point
> end_point
) /* no touched point in contour */
1573 if (point
->flags
& touch_flag
)
1579 first_touched
= point
;
1583 /* skip any touched neighbours */
1584 while (point
< end_point
1585 && (point
[1].flags
& touch_flag
) != 0)
1588 last_touched
= point
;
1590 /* find the next touched point, if any */
1594 if (point
> end_point
)
1597 if ((point
->flags
& touch_flag
) != 0)
1603 /* interpolate between last_touched and point */
1604 ta_iup_interp(last_touched
+ 1, point
- 1,
1605 last_touched
, point
);
1609 /* special case: only one point was touched */
1610 if (last_touched
== first_touched
)
1611 ta_iup_shift(first_point
, end_point
, first_touched
);
1613 else /* interpolate the last part */
1615 if (last_touched
< end_point
)
1616 ta_iup_interp(last_touched
+ 1, end_point
,
1617 last_touched
, first_touched
);
1619 if (first_touched
> points
)
1620 ta_iup_interp(first_point
, first_touched
- 1,
1621 last_touched
, first_touched
);
1628 /* now save the interpolated values back to x/y */
1629 if (dim
== TA_DIMENSION_HORZ
)
1631 for (point
= points
; point
< point_limit
; point
++)
1632 point
->x
= point
->u
;
1636 for (point
= points
; point
< point_limit
; point
++)
1637 point
->y
= point
->u
;
1642 #ifdef TA_CONFIG_OPTION_USE_WARPER
1644 /* apply (small) warp scale and warp delta for given dimension */
1647 ta_glyph_hints_scale_dim(TA_GlyphHints hints
,
1652 TA_Point points
= hints
->points
;
1653 TA_Point points_limit
= points
+ hints
->num_points
;
1657 if (dim
== TA_DIMENSION_HORZ
)
1659 for (point
= points
; point
< points_limit
; point
++)
1660 point
->x
= FT_MulFix(point
->fx
, scale
) + delta
;
1664 for (point
= points
; point
< points_limit
; point
++)
1665 point
->y
= FT_MulFix(point
->fy
, scale
) + delta
;
1669 #endif /* TA_CONFIG_OPTION_USE_WARPER */
1671 /* end of tahints.c */