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.
22 #include FT_FREETYPE_H
23 #include FT_TRUETYPE_TABLES_H
24 #include FT_TRUETYPE_TAGS_H
26 #include <ttfautohint.h>
28 #include <numberset.h>
36 #define TTFAUTOHINT_GLYPH ".ttfautohint"
37 #define TTFAUTOHINT_GLYPH_FIRST_BYTE "\x0C" /* first byte is string length */
38 #define TTFAUTOHINT_GLYPH_LEN 13
41 /* these macros convert 16bit and 32bit numbers into single bytes */
42 /* using the byte order needed within SFNT files */
44 #define HIGH(x) (FT_Byte)(((x) & 0xFF00) >> 8)
45 #define LOW(x) ((x) & 0x00FF)
47 #define BYTE1(x) (FT_Byte)(((FT_ULong)(x) & 0xFF000000UL) >> 24);
48 #define BYTE2(x) (FT_Byte)(((FT_ULong)(x) & 0x00FF0000UL) >> 16);
49 #define BYTE3(x) (FT_Byte)(((FT_ULong)(x) & 0x0000FF00UL) >> 8);
50 #define BYTE4(x) ((FT_ULong)(x) & 0x000000FFUL);
52 /* utility macros to get data from a pointer (with auto-increment) */
54 #define NEXT_USHORT(buffer) \
55 ((FT_UShort)(buffer += 2, (FT_UShort)buffer[-2] << 8 \
56 | (FT_UShort)buffer[-1]))
57 #define NEXT_ULONG(buffer) \
58 ((FT_ULong)(buffer += 4, (FT_ULong)buffer[-4] << 24 \
59 | (FT_ULong)buffer[-3] << 16 \
60 | (FT_ULong)buffer[-2] << 8 \
61 | (FT_ULong)buffer[-1]))
64 /* an SFNT tag for our information table */
65 #define TTAG_TTFA FT_MAKE_TAG('T', 'T', 'F', 'A')
67 /* the length of a dummy `DSIG' table */
70 /* the length of our `gasp' table */
73 /* an empty slot in the table info array */
76 /* the offset to the loca table format in the `head' table */
77 #define LOCA_FORMAT_OFFSET 51
79 /* various offsets within the `maxp' table */
80 #define MAXP_NUM_GLYPHS 4
81 #define MAXP_MAX_COMPOSITE_POINTS 10
82 #define MAXP_MAX_COMPOSITE_CONTOURS 12
83 #define MAXP_MAX_ZONES_OFFSET 14
84 #define MAXP_MAX_TWILIGHT_POINTS_OFFSET 16
85 #define MAXP_MAX_STORAGE_OFFSET 18
86 #define MAXP_MAX_FUNCTION_DEFS_OFFSET 20
87 #define MAXP_MAX_INSTRUCTION_DEFS_OFFSET 22
88 #define MAXP_MAX_STACK_ELEMENTS_OFFSET 24
89 #define MAXP_MAX_INSTRUCTIONS_OFFSET 26
90 #define MAXP_MAX_COMPONENTS_OFFSET 28
94 /* the offset of the type flags field in the `OS/2' table */
95 #define OS2_FSTYPE_OFFSET 8
98 /* flags in composite glyph records */
99 #define ARGS_ARE_WORDS 0x0001
100 #define ARGS_ARE_XY_VALUES 0x0002
101 #define WE_HAVE_A_SCALE 0x0008
102 #define MORE_COMPONENTS 0x0020
103 #define WE_HAVE_AN_XY_SCALE 0x0040
104 #define WE_HAVE_A_2X2 0x0080
105 #define WE_HAVE_INSTR 0x0100
107 /* flags in simple glyph records */
108 #define ON_CURVE 0x01
109 #define X_SHORT_VECTOR 0x02
110 #define Y_SHORT_VECTOR 0x04
117 typedef struct GLYPH_
119 FT_ULong len1
; /* number of bytes before instruction related data */
120 FT_ULong len2
; /* number of bytes after instruction related data; */
121 /* if zero, this indicates a composite glyph */
122 FT_Byte
* buf
; /* extracted glyph data (without instruction related data) */
123 FT_ULong flags_offset
; /* offset to last flag in a composite glyph */
125 FT_Byte ins_extra_len
; /* number of extra instructions */
126 FT_Byte
* ins_extra_buf
; /* extra instructions data */
127 FT_ULong ins_len
; /* number of new instructions */
128 FT_Byte
* ins_buf
; /* new instruction data */
130 FT_Short num_contours
; /* >= 0 for simple glyphs */
131 FT_UShort num_points
; /* number of points in a simple glyph */
133 FT_UShort num_components
;
134 FT_UShort
* components
; /* the subglyph indices of a composite glyph */
136 FT_UShort num_pointsums
;
137 FT_UShort
* pointsums
; /* the pointsums of all composite elements */
138 /* (after walking recursively over all subglyphs) */
140 FT_UShort num_composite_contours
; /* after recursion */
143 /* a representation of the data in the `glyf' table */
144 typedef struct glyf_Data_
146 FT_UShort num_glyphs
;
149 /* this field gives the `master' globals for a `glyf' table; */
150 /* see function `TA_sfnt_handle_coverage' */
151 TA_FaceGlobals master_globals
;
152 /* for coverage bookkeeping */
155 /* if a `glyf' table gets used in more than one subfont, */
156 /* so do `cvt', `fpgm', and `prep' tables: */
157 /* these four tables are always handled in parallel */
162 /* styles present in a font get a running number; */
163 /* unavailable styles get value 0xFFFF */
164 FT_UInt style_ids
[TA_STYLE_MAX
];
165 FT_UInt num_used_styles
;
167 /* we have separate CVT data for each style */
168 FT_UInt cvt_offsets
[TA_STYLE_MAX
];
169 FT_UInt cvt_horz_width_sizes
[TA_STYLE_MAX
];
170 FT_UInt cvt_vert_width_sizes
[TA_STYLE_MAX
];
171 FT_UInt cvt_blue_zone_sizes
[TA_STYLE_MAX
];
172 FT_UInt cvt_blue_adjustment_offsets
[TA_STYLE_MAX
];
176 typedef struct SFNT_Table_
180 FT_Byte
* buf
; /* the table data */
181 FT_ULong offset
; /* from beginning of file */
183 void* data
; /* used e.g. for `glyf' table data */
187 /* we use indices into the SFNT table array to */
188 /* represent table info records of the TTF header */
189 typedef FT_ULong SFNT_Table_Info
;
191 /* this structure is used to model a TTF or a subfont within a TTC */
196 SFNT_Table_Info
* table_infos
;
197 FT_ULong num_table_infos
;
199 /* various SFNT table indices */
210 /* values necessary to update the `maxp' table */
211 FT_UShort max_composite_points
;
212 FT_UShort max_composite_contours
;
213 FT_UShort max_storage
;
214 FT_UShort max_stack_elements
;
215 FT_UShort max_twilight_points
;
216 FT_UShort max_instructions
;
217 FT_UShort max_components
;
220 typedef struct Control_ Control
;
222 /* our font object; the `FONT' typedef is in `taloader.h' */
236 FT_Byte
* reference_buf
;
237 size_t reference_len
;
240 FT_Long reference_index
;
241 const char* reference_name
;
251 /* we have a single `gasp' table for all subfonts */
254 /* the control instructions */
257 /* two generic pointers into the control instructions tree */
258 void* control_data_head
;
259 void* control_data_cur
;
261 /* two fields for handling one-point segment directions */
262 /* of the current glyph */
263 void* control_segment_dirs_head
;
264 void* control_segment_dirs_cur
;
266 TA_LoaderRec loader
[1]; /* the interface to the autohinter */
268 /* configuration options */
269 TA_Progress_Func progress
;
272 TA_Info_Post_Func info_post
;
274 TA_Alloc_Func allocate
;
275 TA_Free_Func deallocate
;
276 FT_UInt hinting_range_min
;
277 FT_UInt hinting_range_max
;
278 FT_UInt hinting_limit
;
279 FT_UInt increase_x_height
;
280 number_range
* x_height_snapping_exceptions
;
281 FT_UInt fallback_stem_width
;
282 FT_Int gray_stem_width_mode
;
283 FT_Int gdi_cleartype_stem_width_mode
;
284 FT_Int dw_cleartype_stem_width_mode
;
285 FT_Bool windows_compatibility
;
286 FT_Bool adjust_subglyphs
;
287 FT_Bool hint_composites
;
288 FT_Bool ignore_restrictions
;
289 TA_Style fallback_style
;
290 FT_Bool fallback_scaling
;
291 TA_Script default_script
;
296 unsigned long long epoch
;
300 #include "tatables.h"
301 #include "tabytecode.h"
302 #include "tacontrol.h"
305 /* in file `tascript.c' */
306 extern const char* script_names
[];
307 extern size_t script_names_size
;
311 TA_get_error_message(FT_Error error
);
314 TA_font_dump_parameters(FONT
* font
,
318 TA_get_current_time(FONT
* font
,
323 TA_build_push(FT_Byte
* bufp
,
330 TA_font_init(FONT
* font
);
332 TA_font_unload(FONT
* font
,
335 const char* control_buf
,
336 const char* reference_buf
);
339 TA_font_file_read(FILE* file
,
343 TA_font_file_write(FONT
* font
,
346 TA_control_file_read(FONT
* font
,
350 TA_sfnt_build_glyph_instructions(SFNT
* sfnt
,
355 TA_sfnt_split_into_SFNT_tables(SFNT
* sfnt
,
359 TA_sfnt_build_cvt_table(SFNT
* sfnt
,
363 TA_table_build_TTFA(FT_Byte
** TTFA
,
368 TA_table_build_DSIG(FT_Byte
** DSIG
);
371 TA_sfnt_build_fpgm_table(SFNT
* sfnt
,
375 TA_sfnt_build_gasp_table(SFNT
* sfnt
,
379 TA_sfnt_split_glyf_table(SFNT
* sfnt
,
382 TA_sfnt_build_glyf_table(SFNT
* sfnt
,
385 TA_sfnt_create_glyf_data(SFNT
* sfnt
,
388 TA_sfnt_handle_coverage(SFNT
* sfnt
,
391 TA_sfnt_adjust_coverage(SFNT
* sfnt
,
395 TA_sfnt_copy_master_coverage(SFNT
* sfnt
,
400 TA_sfnt_update_GPOS_table(SFNT
* sfnt
,
404 TA_sfnt_update_hmtx_table(SFNT
* sfnt
,
408 TA_sfnt_build_loca_table(SFNT
* sfnt
,
412 TA_sfnt_update_maxp_table(SFNT
* sfnt
,
416 TA_sfnt_update_post_table(SFNT
* sfnt
,
420 TA_sfnt_update_name_table(SFNT
* sfnt
,
424 TA_sfnt_build_prep_table(SFNT
* sfnt
,
428 TA_sfnt_build_TTF_header(SFNT
* sfnt
,
430 FT_Byte
** header_buf
,
431 FT_ULong
* header_len
,
434 TA_font_build_TTF(FONT
* font
);
437 TA_font_build_TTC(FONT
* font
);