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
)
329 TA_LOG((" index hedge hseg flags"
330 " xorg yorg xscale yscale xfit yfit"));
332 TA_LOG((" (none)\n"));
334 for (point
= points
; point
< limit
; point
++)
336 int point_idx
= TA_INDEX_NUM(point
, points
);
337 int segment_idx_1
= ta_get_segment_index(hints
, point_idx
, 1);
339 char buf1
[16], buf2
[16];
342 /* insert extra newline at the beginning of a contour */
343 if (contour
< climit
&& *contour
== point
)
349 /* we don't show vertical edges since they are never used */
350 TA_LOG((" %5d %5s %5s %s "
351 " %5d %5d %7.2f %7.2f %7.2f %7.2f\n",
354 ta_get_edge_index(hints
, segment_idx_1
, 1)),
355 ta_print_idx(buf2
, segment_idx_1
),
356 (point
->flags
& TA_FLAG_WEAK_INTERPOLATION
) ? "weak" : " -- ",
370 ta_edge_flags_to_string(FT_Byte flags
)
372 static char temp
[32];
376 if (flags
& TA_EDGE_ROUND
)
378 memcpy(temp
+ pos
, "round", 5);
381 if (flags
& TA_EDGE_SERIF
)
385 memcpy(temp
+ pos
, "serif", 5);
397 /* dump the array of linked segments */
400 ta_glyph_hints_dump_segments(TA_GlyphHints hints
)
405 for (dimension
= TA_DEBUG_STARTDIM
;
406 dimension
>= TA_DEBUG_ENDDIM
;
409 TA_AxisHints axis
= &hints
->axis
[dimension
];
410 TA_Point points
= hints
->points
;
411 TA_Edge edges
= axis
->edges
;
412 TA_Segment segments
= axis
->segments
;
413 TA_Segment limit
= segments
+ axis
->num_segments
;
416 char buf1
[16], buf2
[16], buf3
[16];
419 TA_LOG(("Table of %s segments:\n",
420 dimension
== TA_DIMENSION_HORZ
? "vertical"
422 if (axis
->num_segments
)
423 TA_LOG((" index pos delta dir from to"
425 " height extra flags\n"));
427 TA_LOG((" (none)\n"));
429 for (seg
= segments
; seg
< limit
; seg
++)
430 TA_LOG((" %5d %5d %5d %5s %4d %4d"
433 TA_INDEX_NUM(seg
, segments
),
436 ta_dir_str((TA_Direction
)seg
->dir
),
437 TA_INDEX_NUM(seg
->first
, points
),
438 TA_INDEX_NUM(seg
->last
, points
),
440 ta_print_idx(buf1
, TA_INDEX_NUM(seg
->link
, segments
)),
441 ta_print_idx(buf2
, TA_INDEX_NUM(seg
->serif
, segments
)),
442 ta_print_idx(buf3
, TA_INDEX_NUM(seg
->edge
, edges
)),
445 seg
->height
- (seg
->max_coord
- seg
->min_coord
),
446 ta_edge_flags_to_string(seg
->flags
)));
452 /* dump the array of linked edges */
455 ta_glyph_hints_dump_edges(TA_GlyphHints hints
)
460 for (dimension
= TA_DEBUG_STARTDIM
;
461 dimension
>= TA_DEBUG_ENDDIM
;
464 TA_AxisHints axis
= &hints
->axis
[dimension
];
465 TA_Edge edges
= axis
->edges
;
466 TA_Edge limit
= edges
+ axis
->num_edges
;
469 char buf1
[16], buf2
[16];
472 /* note that TA_DIMENSION_HORZ corresponds to _vertical_ edges */
473 /* since they have a constant X coordinate */
474 if (dimension
== TA_DIMENSION_HORZ
)
475 TA_LOG(("Table of %s edges (1px=%.2fu, 10u=%.2fpx):\n",
477 65536.0 * 64.0 / hints
->x_scale
,
478 10.0 * hints
->x_scale
/ 65536.0 / 64.0));
480 TA_LOG(("Table of %s edges (1px=%.2fu, 10u=%.2fpx):\n",
482 65536.0 * 64.0 / hints
->y_scale
,
483 10.0 * hints
->y_scale
/ 65536.0 / 64.0));
486 TA_LOG((" index pos dir link serif"
487 " blue opos pos flags\n"));
489 TA_LOG((" (none)\n"));
491 for (edge
= edges
; edge
< limit
; edge
++)
492 TA_LOG((" %5d %7.2f %5s %4s %5s"
493 " %c %7.2f %7.2f %11s\n",
494 TA_INDEX_NUM(edge
, edges
),
495 (int)edge
->opos
/ 64.0,
496 ta_dir_str((TA_Direction
)edge
->dir
),
497 ta_print_idx(buf1
, TA_INDEX_NUM(edge
->link
, edges
)),
498 ta_print_idx(buf2
, TA_INDEX_NUM(edge
->serif
, edges
)),
500 edge
->blue_edge
? 'y' : 'n',
503 ta_edge_flags_to_string(edge
->flags
)));
508 #endif /* TA_DEBUG */
511 /* compute the direction value of a given vector */
514 ta_direction_compute(FT_Pos dx
,
517 FT_Pos ll
, ss
; /* long and short arm lengths */
518 TA_Direction dir
; /* candidate direction */
552 /* return no direction if arm lengths do not differ enough */
553 /* (value 14 is heuristic, corresponding to approx. 4.1 degrees); */
554 /* the long arm is never negative */
555 if (ll
<= 14 * TA_ABS(ss
))
563 ta_glyph_hints_init(TA_GlyphHints hints
)
565 /* no need to initialize the embedded items */
566 memset(hints
, 0, sizeof (*hints
) - sizeof (hints
->embedded
));
571 ta_glyph_hints_done(TA_GlyphHints hints
)
579 /* we don't need to free the segment and edge buffers */
580 /* since they are really within the hints->points array */
581 for (dim
= 0; dim
< TA_DIMENSION_MAX
; dim
++)
583 TA_AxisHints axis
= &hints
->axis
[dim
];
586 axis
->num_segments
= 0;
587 axis
->max_segments
= 0;
588 if (axis
->segments
!= axis
->embedded
.segments
)
590 free(axis
->segments
);
591 axis
->segments
= NULL
;
596 if (axis
->edges
!= axis
->embedded
.edges
)
603 if (hints
->contours
!= hints
->embedded
.contours
)
605 free(hints
->contours
);
606 hints
->contours
= NULL
;
608 hints
->max_contours
= 0;
609 hints
->num_contours
= 0;
611 if (hints
->points
!= hints
->embedded
.points
)
614 hints
->points
= NULL
;
616 hints
->max_points
= 0;
617 hints
->num_points
= 0;
624 ta_glyph_hints_rescale(TA_GlyphHints hints
,
625 TA_StyleMetrics metrics
)
627 hints
->metrics
= metrics
;
628 hints
->scaler_flags
= metrics
->scaler
.flags
;
632 /* from FreeType's ftcalc.c */
635 ta_corner_is_flat(FT_Pos in_x
,
643 FT_Pos d_in
, d_out
, d_corner
;
668 return (d_in
+ d_out
- d_corner
) < (d_corner
>> 4);
672 /* recompute all TA_Point in TA_GlyphHints */
673 /* from the definitions in a source outline */
676 ta_glyph_hints_reload(TA_GlyphHints hints
,
679 FT_Error error
= FT_Err_Ok
;
681 FT_UInt old_max
, new_max
;
683 FT_Fixed x_scale
= hints
->x_scale
;
684 FT_Fixed y_scale
= hints
->y_scale
;
685 FT_Pos x_delta
= hints
->x_delta
;
686 FT_Pos y_delta
= hints
->y_delta
;
689 hints
->num_points
= 0;
690 hints
->num_contours
= 0;
692 hints
->axis
[0].num_segments
= 0;
693 hints
->axis
[0].num_edges
= 0;
694 hints
->axis
[1].num_segments
= 0;
695 hints
->axis
[1].num_edges
= 0;
697 /* first of all, reallocate the contours array if necessary */
698 new_max
= (FT_UInt
)outline
->n_contours
;
699 old_max
= (FT_UInt
)hints
->max_contours
;
701 if (new_max
<= TA_CONTOURS_EMBEDDED
)
703 if (!hints
->contours
)
705 hints
->contours
= hints
->embedded
.contours
;
706 hints
->max_contours
= TA_CONTOURS_EMBEDDED
;
709 else if (new_max
> old_max
)
711 TA_Point
* contours_new
;
714 if (hints
->contours
== hints
->embedded
.contours
)
715 hints
->contours
= NULL
;
717 new_max
= (new_max
+ 3) & ~3U; /* round up to a multiple of 4 */
719 contours_new
= (TA_Point
*)realloc(hints
->contours
,
720 new_max
* sizeof (TA_Point
));
722 return FT_Err_Out_Of_Memory
;
724 hints
->contours
= contours_new
;
725 hints
->max_contours
= (FT_Int
)new_max
;
728 /* reallocate the points arrays if necessary -- we reserve */
729 /* two additional point positions, used to hint metrics appropriately */
730 new_max
= (FT_UInt
)(outline
->n_points
+ 2);
731 old_max
= (FT_UInt
)hints
->max_points
;
733 if (new_max
<= TA_POINTS_EMBEDDED
)
737 hints
->points
= hints
->embedded
.points
;
738 hints
->max_points
= TA_POINTS_EMBEDDED
;
741 else if (new_max
> old_max
)
746 if (hints
->points
== hints
->embedded
.points
)
747 hints
->points
= NULL
;
749 new_max
= (new_max
+ 2 + 7) & ~7U; /* round up to a multiple of 8 */
751 points_new
= (TA_Point
)realloc(hints
->points
,
752 new_max
* sizeof (TA_PointRec
));
754 return FT_Err_Out_Of_Memory
;
756 hints
->points
= points_new
;
757 hints
->max_points
= (FT_Int
)new_max
;
760 hints
->num_points
= outline
->n_points
;
761 hints
->num_contours
= outline
->n_contours
;
763 /* we can't rely on the value of `FT_Outline.flags' to know the fill */
764 /* direction used for a glyph, given that some fonts are broken */
765 /* (e.g. the Arphic ones); we thus recompute it each time we need to */
767 hints
->axis
[TA_DIMENSION_HORZ
].major_dir
= TA_DIR_UP
;
768 hints
->axis
[TA_DIMENSION_VERT
].major_dir
= TA_DIR_LEFT
;
770 if (FT_Outline_Get_Orientation(outline
) == FT_ORIENTATION_POSTSCRIPT
)
772 hints
->axis
[TA_DIMENSION_HORZ
].major_dir
= TA_DIR_DOWN
;
773 hints
->axis
[TA_DIMENSION_VERT
].major_dir
= TA_DIR_RIGHT
;
776 hints
->x_scale
= x_scale
;
777 hints
->y_scale
= y_scale
;
778 hints
->x_delta
= x_delta
;
779 hints
->y_delta
= y_delta
;
781 hints
->xmin_delta
= 0;
782 hints
->xmax_delta
= 0;
784 points
= hints
->points
;
785 if (hints
->num_points
== 0)
790 TA_Point point_limit
= points
+ hints
->num_points
;
793 /* compute coordinates & Bezier flags, next and prev */
795 FT_Vector
* vec
= outline
->points
;
796 char* tag
= outline
->tags
;
798 TA_Point end
= points
+ outline
->contours
[0];
801 FT_Int contour_index
= 0;
804 for (point
= points
; point
< point_limit
; point
++, vec
++, tag
++)
806 point
->in_dir
= (FT_Char
)TA_DIR_NONE
;
807 point
->out_dir
= (FT_Char
)TA_DIR_NONE
;
809 point
->fx
= (FT_Short
)vec
->x
;
810 point
->fy
= (FT_Short
)vec
->y
;
811 point
->ox
= point
->x
= FT_MulFix(vec
->x
, x_scale
) + x_delta
;
812 point
->oy
= point
->y
= FT_MulFix(vec
->y
, y_scale
) + y_delta
;
814 switch (FT_CURVE_TAG(*tag
))
816 case FT_CURVE_TAG_CONIC
:
817 point
->flags
= TA_FLAG_CONIC
;
819 case FT_CURVE_TAG_CUBIC
:
820 point
->flags
= TA_FLAG_CUBIC
;
823 point
->flags
= TA_FLAG_NONE
;
832 if (++contour_index
< outline
->n_contours
)
834 end
= points
+ outline
->contours
[contour_index
];
841 /* set up the contours array */
843 TA_Point
* contour
= hints
->contours
;
844 TA_Point
* contour_limit
= contour
+ hints
->num_contours
;
846 short* end
= outline
->contours
;
850 for (; contour
< contour_limit
; contour
++, end
++)
852 contour
[0] = points
+ idx
;
853 idx
= (short)(end
[0] + 1);
859 * Compute directions of `in' and `out' vectors.
861 * Note that distances between points that are very near to each
862 * other are accumulated. In other words, the auto-hinter
863 * prepends the small vectors between near points to the first
864 * non-near vector. All intermediate points are tagged as
865 * weak; the directions are adjusted also to be equal to the
869 /* value 20 in `near_limit' is heuristic */
870 FT_UInt units_per_em
= hints
->metrics
->scaler
.face
->units_per_EM
;
871 FT_Int near_limit
= 20 * units_per_em
/ 2048;
872 FT_Int near_limit2
= 2 * near_limit
- 1;
875 TA_Point
* contour_limit
= hints
->contours
+ hints
->num_contours
;
878 for (contour
= hints
->contours
; contour
< contour_limit
; contour
++)
880 TA_Point first
= *contour
;
881 TA_Point next
, prev
, curr
;
886 /* since the first point of a contour could be part of a */
887 /* series of near points, go backwards to find the first */
888 /* non-near point and adjust `first' */
893 while (prev
!= first
)
895 out_x
= point
->fx
- prev
->fx
;
896 out_y
= point
->fy
- prev
->fy
;
899 * We use Taxicab metrics to measure the vector length.
901 * Note that the accumulated distances so far could have the
902 * opposite direction of the distance measured here. For this
903 * reason we use `near_limit2' for the comparison to get a
904 * non-near point even in the worst case.
906 if (TA_ABS(out_x
) + TA_ABS(out_y
) >= near_limit2
)
913 /* adjust first point */
916 /* now loop over all points of the contour to get */
917 /* `in' and `out' vector directions */
922 * We abuse the `u' and `v' fields to store index deltas to the
923 * next and previous non-near point, respectively.
925 * To avoid problems with not having non-near points, we point to
926 * `first' by default as the next non-near point.
928 curr
->u
= (FT_Pos
)(first
- curr
);
937 TA_Direction out_dir
;
943 out_x
+= next
->fx
- point
->fx
;
944 out_y
+= next
->fy
- point
->fy
;
946 if (TA_ABS(out_x
) + TA_ABS(out_y
) < near_limit
)
948 next
->flags
|= TA_FLAG_WEAK_INTERPOLATION
;
952 curr
->u
= (FT_Pos
)(next
- curr
);
955 out_dir
= ta_direction_compute(out_x
, out_y
);
957 /* adjust directions for all points inbetween; */
958 /* the loop also updates position of `curr' */
959 curr
->out_dir
= (FT_Char
)out_dir
;
960 for (curr
= curr
->next
; curr
!= next
; curr
= curr
->next
)
962 curr
->in_dir
= (FT_Char
)out_dir
;
963 curr
->out_dir
= (FT_Char
)out_dir
;
965 next
->in_dir
= (FT_Char
)out_dir
;
967 curr
->u
= (FT_Pos
)(first
- curr
);
973 } while (next
!= first
);
977 * The next step is to `simplify' an outline's topology so that we
978 * can identify local extrema more reliably: A series of
979 * non-horizontal or non-vertical vectors pointing into the same
980 * quadrant are handled as a single, long vector. From a
981 * topological point of the view, the intermediate points are of no
982 * interest and thus tagged as weak.
985 for (point
= points
; point
< point_limit
; point
++)
987 if (point
->flags
& TA_FLAG_WEAK_INTERPOLATION
)
990 if (point
->in_dir
== TA_DIR_NONE
991 && point
->out_dir
== TA_DIR_NONE
)
993 /* check whether both vectors point into the same quadrant */
998 TA_Point next_u
= point
+ point
->u
;
999 TA_Point prev_v
= point
+ point
->v
;
1002 in_x
= point
->fx
- prev_v
->fx
;
1003 in_y
= point
->fy
- prev_v
->fy
;
1005 out_x
= next_u
->fx
- point
->fx
;
1006 out_y
= next_u
->fy
- point
->fy
;
1008 if ((in_x
^ out_x
) >= 0 && (in_y
^ out_y
) >= 0)
1010 /* yes, so tag current point as weak */
1011 /* and update index deltas */
1013 point
->flags
|= TA_FLAG_WEAK_INTERPOLATION
;
1015 prev_v
->u
= (FT_Pos
)(next_u
- prev_v
);
1016 next_u
->v
= -prev_v
->u
;
1022 * Finally, check for remaining weak points. Everything else not
1023 * collected in edges so far is then implicitly classified as strong
1027 for (point
= points
; point
< point_limit
; point
++)
1029 if (point
->flags
& TA_FLAG_WEAK_INTERPOLATION
)
1032 if (point
->flags
& TA_FLAG_CONTROL
)
1034 /* control points are always weak */
1036 point
->flags
|= TA_FLAG_WEAK_INTERPOLATION
;
1038 else if (point
->out_dir
== point
->in_dir
)
1040 if (point
->out_dir
!= TA_DIR_NONE
)
1042 /* current point lies on a horizontal or */
1043 /* vertical segment (but doesn't start or end it) */
1048 TA_Point next_u
= point
+ point
->u
;
1049 TA_Point prev_v
= point
+ point
->v
;
1052 if (ta_corner_is_flat(point
->fx
- prev_v
->fx
,
1053 point
->fy
- prev_v
->fy
,
1054 next_u
->fx
- point
->fx
,
1055 next_u
->fy
- point
->fy
))
1057 /* either the `in' or the `out' vector is much more */
1058 /* dominant than the other one, so tag current point */
1059 /* as weak and update index deltas */
1061 prev_v
->u
= (FT_Pos
)(next_u
- prev_v
);
1062 next_u
->v
= -prev_v
->u
;
1068 else if (point
->in_dir
== -point
->out_dir
)
1070 /* current point forms a spike */
1077 /* change some directions at the user's request */
1078 /* to make ttfautohint insert one-point segments */
1079 /* or remove points from segments */
1088 /* `globals' is not set up while initializing metrics, */
1089 /* so exit early in this case */
1090 if (!hints
->metrics
->globals
)
1093 font
= hints
->metrics
->globals
->font
;
1095 /* start conditions are set with `TA_control_segment_dir_collect' */
1096 while (TA_control_segment_dir_get_next(font
, &idx
, &dir
,
1097 &left_offset
, &right_offset
))
1099 TA_Point point
= &points
[idx
];
1102 point
->out_dir
= dir
;
1103 if (dir
== TA_DIR_NONE
)
1104 point
->flags
|= TA_FLAG_WEAK_INTERPOLATION
;
1106 point
->flags
&= ~TA_FLAG_WEAK_INTERPOLATION
;
1107 point
->left_offset
= (FT_Short
)left_offset
;
1108 point
->right_offset
= (FT_Short
)right_offset
;
1117 /* store the hinted outline in an FT_Outline structure */
1120 ta_glyph_hints_save(TA_GlyphHints hints
,
1121 FT_Outline
* outline
)
1123 TA_Point point
= hints
->points
;
1124 TA_Point limit
= point
+ hints
->num_points
;
1126 FT_Vector
* vec
= outline
->points
;
1127 char* tag
= outline
->tags
;
1130 for (; point
< limit
; point
++, vec
++, tag
++)
1135 if (point
->flags
& TA_FLAG_CONIC
)
1136 tag
[0] = FT_CURVE_TAG_CONIC
;
1137 else if (point
->flags
& TA_FLAG_CUBIC
)
1138 tag
[0] = FT_CURVE_TAG_CUBIC
;
1140 tag
[0] = FT_CURVE_TAG_ON
;
1145 /****************************************************************
1147 * EDGE POINT GRID-FITTING
1149 ****************************************************************/
1152 /* align all points of an edge to the same coordinate value, */
1153 /* either horizontally or vertically */
1156 ta_glyph_hints_align_edge_points(TA_GlyphHints hints
,
1159 TA_AxisHints axis
= &hints
->axis
[dim
];
1160 TA_Segment segments
= axis
->segments
;
1161 TA_Segment segment_limit
= segments
+ axis
->num_segments
;
1165 if (dim
== TA_DIMENSION_HORZ
)
1167 for (seg
= segments
; seg
< segment_limit
; seg
++)
1169 TA_Edge edge
= seg
->edge
;
1170 TA_Point point
, first
, last
;
1181 point
->x
= edge
->pos
;
1182 point
->flags
|= TA_FLAG_TOUCH_X
;
1187 point
= point
->next
;
1193 for (seg
= segments
; seg
< segment_limit
; seg
++)
1195 TA_Edge edge
= seg
->edge
;
1196 TA_Point point
, first
, last
;
1207 point
->y
= edge
->pos
;
1208 point
->flags
|= TA_FLAG_TOUCH_Y
;
1213 point
= point
->next
;
1220 /****************************************************************
1222 * STRONG POINT INTERPOLATION
1224 ****************************************************************/
1227 /* hint the strong points -- */
1228 /* this is equivalent to the TrueType `IP' hinting instruction */
1231 ta_glyph_hints_align_strong_points(TA_GlyphHints hints
,
1234 TA_Point points
= hints
->points
;
1235 TA_Point point_limit
= points
+ hints
->num_points
;
1237 TA_AxisHints axis
= &hints
->axis
[dim
];
1239 TA_Edge edges
= axis
->edges
;
1240 TA_Edge edge_limit
= edges
+ axis
->num_edges
;
1242 FT_UShort touch_flag
;
1245 if (dim
== TA_DIMENSION_HORZ
)
1246 touch_flag
= TA_FLAG_TOUCH_X
;
1248 touch_flag
= TA_FLAG_TOUCH_Y
;
1250 if (edges
< edge_limit
)
1256 for (point
= points
; point
< point_limit
; point
++)
1258 FT_Pos u
, ou
, fu
; /* point position */
1262 if (point
->flags
& touch_flag
)
1265 /* if this point is candidate to weak interpolation, we */
1266 /* interpolate it after all strong points have been processed */
1268 if ((point
->flags
& TA_FLAG_WEAK_INTERPOLATION
))
1271 if (dim
== TA_DIMENSION_VERT
)
1284 /* is the point before the first edge? */
1286 delta
= edge
->fpos
- u
;
1289 u
= edge
->pos
- (edge
->opos
- ou
);
1291 if (hints
->recorder
)
1292 hints
->recorder(ta_ip_before
, hints
, dim
,
1293 point
, NULL
, NULL
, NULL
, NULL
);
1298 /* is the point after the last edge? */
1299 edge
= edge_limit
- 1;
1300 delta
= u
- edge
->fpos
;
1303 u
= edge
->pos
+ (ou
- edge
->opos
);
1305 if (hints
->recorder
)
1306 hints
->recorder(ta_ip_after
, hints
, dim
,
1307 point
, NULL
, NULL
, NULL
, NULL
);
1313 FT_PtrDist min
, max
, mid
;
1317 /* find enclosing edges */
1319 max
= edge_limit
- edges
;
1321 /* for a small number of edges, a linear search is better */
1327 for (nn
= 0; nn
< max
; nn
++)
1328 if (edges
[nn
].fpos
>= u
)
1331 if (edges
[nn
].fpos
== u
)
1335 if (hints
->recorder
)
1336 hints
->recorder(ta_ip_on
, hints
, dim
,
1337 point
, &edges
[nn
], NULL
, NULL
, NULL
);
1346 mid
= (max
+ min
) >> 1;
1356 /* we are on the edge */
1359 if (hints
->recorder
)
1360 hints
->recorder(ta_ip_on
, hints
, dim
,
1361 point
, edge
, NULL
, NULL
, NULL
);
1367 /* point is not on an edge */
1369 TA_Edge before
= edges
+ min
- 1;
1370 TA_Edge after
= edges
+ min
+ 0;
1373 /* assert(before && after && before != after) */
1374 if (before
->scale
== 0)
1375 before
->scale
= FT_DivFix(after
->pos
- before
->pos
,
1376 after
->fpos
- before
->fpos
);
1378 u
= before
->pos
+ FT_MulFix(fu
- before
->fpos
,
1381 if (hints
->recorder
)
1382 hints
->recorder(ta_ip_between
, hints
, dim
,
1383 point
, before
, after
, NULL
, NULL
);
1388 /* save the point position */
1389 if (dim
== TA_DIMENSION_HORZ
)
1394 point
->flags
|= touch_flag
;
1400 /****************************************************************
1402 * WEAK POINT INTERPOLATION
1404 ****************************************************************/
1407 /* shift the original coordinates of all points between `p1' and */
1408 /* `p2' to get hinted coordinates, using the same difference as */
1409 /* given by `ref' */
1412 ta_iup_shift(TA_Point p1
,
1417 FT_Pos delta
= ref
->u
- ref
->v
;
1423 for (p
= p1
; p
< ref
; p
++)
1424 p
->u
= p
->v
+ delta
;
1426 for (p
= ref
+ 1; p
<= p2
; p
++)
1427 p
->u
= p
->v
+ delta
;
1431 /* interpolate the original coordinates of all points between `p1' and */
1432 /* `p2' to get hinted coordinates, using `ref1' and `ref2' as the */
1433 /* reference points; the `u' and `v' members are the current and */
1434 /* original coordinate values, respectively. */
1436 /* details can be found in the TrueType bytecode specification */
1439 ta_iup_interp(TA_Point p1
,
1445 FT_Pos u
, v1
, v2
, u1
, u2
, d1
, d2
;
1451 if (ref1
->v
> ref2
->v
)
1465 if (u1
== u2
|| v1
== v2
)
1467 for (p
= p1
; p
<= p2
; p
++)
1483 FT_Fixed scale
= FT_DivFix(u2
- u1
, v2
- v1
);
1486 for (p
= p1
; p
<= p2
; p
++)
1495 u
= u1
+ FT_MulFix(u
- v1
, scale
);
1503 /* hint the weak points -- */
1504 /* this is equivalent to the TrueType `IUP' hinting instruction */
1507 ta_glyph_hints_align_weak_points(TA_GlyphHints hints
,
1510 TA_Point points
= hints
->points
;
1511 TA_Point point_limit
= points
+ hints
->num_points
;
1513 TA_Point
* contour
= hints
->contours
;
1514 TA_Point
* contour_limit
= contour
+ hints
->num_contours
;
1516 FT_UShort touch_flag
;
1519 TA_Point first_point
;
1522 /* pass 1: move segment points to edge positions */
1524 if (dim
== TA_DIMENSION_HORZ
)
1526 touch_flag
= TA_FLAG_TOUCH_X
;
1528 for (point
= points
; point
< point_limit
; point
++)
1530 point
->u
= point
->x
;
1531 point
->v
= point
->ox
;
1536 touch_flag
= TA_FLAG_TOUCH_Y
;
1538 for (point
= points
; point
< point_limit
; point
++)
1540 point
->u
= point
->y
;
1541 point
->v
= point
->oy
;
1545 for (; contour
< contour_limit
; contour
++)
1547 TA_Point first_touched
, last_touched
;
1551 end_point
= point
->prev
;
1552 first_point
= point
;
1554 /* find first touched point */
1557 if (point
> end_point
) /* no touched point in contour */
1560 if (point
->flags
& touch_flag
)
1566 first_touched
= point
;
1570 /* skip any touched neighbours */
1571 while (point
< end_point
1572 && (point
[1].flags
& touch_flag
) != 0)
1575 last_touched
= point
;
1577 /* find the next touched point, if any */
1581 if (point
> end_point
)
1584 if ((point
->flags
& touch_flag
) != 0)
1590 /* interpolate between last_touched and point */
1591 ta_iup_interp(last_touched
+ 1, point
- 1,
1592 last_touched
, point
);
1596 /* special case: only one point was touched */
1597 if (last_touched
== first_touched
)
1598 ta_iup_shift(first_point
, end_point
, first_touched
);
1600 else /* interpolate the last part */
1602 if (last_touched
< end_point
)
1603 ta_iup_interp(last_touched
+ 1, end_point
,
1604 last_touched
, first_touched
);
1606 if (first_touched
> points
)
1607 ta_iup_interp(first_point
, first_touched
- 1,
1608 last_touched
, first_touched
);
1615 /* now save the interpolated values back to x/y */
1616 if (dim
== TA_DIMENSION_HORZ
)
1618 for (point
= points
; point
< point_limit
; point
++)
1619 point
->x
= point
->u
;
1623 for (point
= points
; point
< point_limit
; point
++)
1624 point
->y
= point
->u
;
1629 #ifdef TA_CONFIG_OPTION_USE_WARPER
1631 /* apply (small) warp scale and warp delta for given dimension */
1634 ta_glyph_hints_scale_dim(TA_GlyphHints hints
,
1639 TA_Point points
= hints
->points
;
1640 TA_Point points_limit
= points
+ hints
->num_points
;
1644 if (dim
== TA_DIMENSION_HORZ
)
1646 for (point
= points
; point
< points_limit
; point
++)
1647 point
->x
= FT_MulFix(point
->fx
, scale
) + delta
;
1651 for (point
= points
; point
< points_limit
; point
++)
1652 point
->y
= FT_MulFix(point
->fy
, scale
) + delta
;
1656 #endif /* TA_CONFIG_OPTION_USE_WARPER */
1658 /* end of tahints.c */