Rev 1882 | Go to most recent revision | Show entire file | Regard whitespace | Details | Blame | Last modification | View Log | RSS feed
Rev 1882 | Rev 4744 | ||
---|---|---|---|
Line 1... | Line 1... | ||
1 | /******************************************************************* |
1 | /***************************************************************************/ |
2 | * |
- | |
- | 2 | /* */ |
|
3 | * tttables.h 1.1 |
3 | /* tttables.h */ |
4 | * |
- | |
- | 4 | /* */ |
|
5 | * TrueType Tables structures and handling (specification). |
5 | /* Basic SFNT/TrueType tables definitions and interface */ |
6 | * |
- | |
- | 6 | /* (specification only). */ |
|
- | 7 | /* */ |
|
7 | * Copyright 1996-1999 by |
8 | /* Copyright 1996-2001, 2002, 2003, 2004, 2005, 2008, 2009, 2010 by */ |
8 | * David Turner, Robert Wilhelm, and Werner Lemberg. |
9 | /* David Turner, Robert Wilhelm, and Werner Lemberg. */ |
9 | * |
- | |
- | 10 | /* */ |
|
10 | * This file is part of the FreeType project, and may only be used |
11 | /* 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 | /* modified, and distributed under the terms of the FreeType project */ |
12 | * license, LICENSE.TXT. By continuing to use, modify, or distribute |
13 | /* license, LICENSE.TXT. By continuing to use, modify, or distribute */ |
13 | * this file you indicate that you have read the license and |
14 | /* this file you indicate that you have read the license and */ |
14 | * understand and accept it fully. |
15 | /* understand and accept it fully. */ |
15 | * |
- | |
- | 16 | /* */ |
|
16 | ******************************************************************/ |
17 | /***************************************************************************/ |
- | 18 | ||
Line 17... | Line 19... | ||
17 | 19 | ||
18 | #ifndef TTTABLES_H |
20 | #ifndef __TTTABLES_H__ |
Line 19... | Line -... | ||
19 | #define TTTABLES_H |
- | |
20 | - | ||
Line 21... | Line 21... | ||
21 | #include "ttconfig.h" |
21 | #define __TTTABLES_H__ |
- | 22 | ||
- | 23 | ||
22 | #include "tttypes.h" |
24 | #include |
- | 25 | #include FT_FREETYPE_H |
|
- | 26 | ||
- | 27 | #ifdef FREETYPE_H |
|
23 | 28 | #error "freetype.h of FreeType 1 has been loaded!" |
|
Line -... | Line 29... | ||
- | 29 | #error "Please fix the directory search order for header files" |
|
- | 30 | #error "so that freetype.h of FreeType 2 is found first." |
|
- | 31 | #endif |
|
24 | #ifdef __cplusplus |
32 | |
- | 33 | ||
- | 34 | FT_BEGIN_HEADER |
|
- | 35 | ||
- | 36 | /*************************************************************************/ |
|
- | 37 | /* */ |
|
- | 38 | /* |
|
25 | extern "C" { |
39 | /* truetype_tables */ |
26 | #endif |
40 | /* */ |
- | 41 | /* |
|
27 | 42 | /* TrueType Tables */ |
|
- | 43 | /* */ |
|
- | 44 | /* |
|
- | 45 | /* TrueType specific table types and functions. */ |
|
- | 46 | /* */ |
|
28 | /***********************************************************************/ |
47 | /* |
Line 29... | Line -... | ||
29 | /* */ |
- | |
Line -... | Line 48... | ||
- | 48 | /* This section contains the definition of TrueType-specific tables */ |
|
- | 49 | /* as well as some routines used to access and process them. */ |
|
- | 50 | /* */ |
|
- | 51 | /*************************************************************************/ |
|
- | 52 | ||
- | 53 | ||
- | 54 | /*************************************************************************/ |
|
- | 55 | /* */ |
|
- | 56 | /* |
|
30 | /* TrueType Table Types */ |
57 | /* TT_Header */ |
31 | /* */ |
58 | /* */ |
32 | /***********************************************************************/ |
- | |
33 | 59 | /* |
|
34 | /* TrueType Collection Header */ |
- | |
35 | 60 | /* A structure used to model a TrueType font header table. All */ |
|
36 | struct TTTCHeader_ |
- | |
Line 37... | Line 61... | ||
37 | { |
61 | /* fields follow the TrueType specification. */ |
38 | ULong Tag; |
62 | /* */ |
Line -... | Line 63... | ||
- | 63 | typedef struct TT_Header_ |
|
- | 64 | { |
|
Line 39... | Line 65... | ||
39 | TT_Fixed version; |
65 | FT_Fixed Table_Version; |
- | 66 | FT_Fixed Font_Revision; |
|
Line 40... | Line 67... | ||
40 | ULong DirCount; |
67 | |
41 | PULong TableDirectory; |
68 | FT_Long CheckSum_Adjust; |
42 | }; |
69 | FT_Long Magic_Number; |
43 | 70 | ||
Line 44... | Line -... | ||
44 | typedef struct TTTCHeader_ TTTCHeader; |
- | |
45 | typedef TTTCHeader* PTTCHeader; |
71 | FT_UShort Flags; |
46 | 72 | FT_UShort Units_Per_EM; |
|
47 | - | ||
Line -... | Line 73... | ||
- | 73 | ||
48 | /* TrueType Table Directory type */ |
74 | FT_Long Created [2]; |
49 | 75 | FT_Long Modified[2]; |
|
Line -... | Line 76... | ||
- | 76 | ||
Line 50... | Line -... | ||
50 | struct TTableDir_ |
- | |
Line -... | Line 77... | ||
- | 77 | FT_Short xMin; |
|
- | 78 | FT_Short yMin; |
|
- | 79 | FT_Short xMax; |
|
- | 80 | FT_Short yMax; |
|
- | 81 | ||
- | 82 | FT_UShort Mac_Style; |
|
- | 83 | FT_UShort Lowest_Rec_PPEM; |
|
- | 84 | ||
- | 85 | FT_Short Font_Direction; |
|
- | 86 | FT_Short Index_To_Loc_Format; |
|
- | 87 | FT_Short Glyph_Data_Format; |
|
- | 88 | ||
- | 89 | } TT_Header; |
|
- | 90 | ||
- | 91 | ||
- | 92 | /*************************************************************************/ |
|
- | 93 | /* */ |
|
- | 94 | /* |
|
- | 95 | /* TT_HoriHeader */ |
|
- | 96 | /* */ |
|
- | 97 | /* |
|
- | 98 | /* A structure used to model a TrueType horizontal header, the `hhea' */ |
|
- | 99 | /* table, as well as the corresponding horizontal metrics table, */ |
|
- | 100 | /* i.e., the `hmtx' table. */ |
|
- | 101 | /* */ |
|
- | 102 | /* |
|
- | 103 | /* Version :: The table version. */ |
|
- | 104 | /* */ |
|
- | 105 | /* Ascender :: The font's ascender, i.e., the distance */ |
|
- | 106 | /* from the baseline to the top-most of all */ |
|
- | 107 | /* glyph points found in the font. */ |
|
- | 108 | /* */ |
|
- | 109 | /* This value is invalid in many fonts, as */ |
|
- | 110 | /* it is usually set by the font designer, */ |
|
- | 111 | /* and often reflects only a portion of the */ |
|
- | 112 | /* glyphs found in the font (maybe ASCII). */ |
|
- | 113 | /* */ |
|
- | 114 | /* You should use the `sTypoAscender' field */ |
|
- | 115 | /* of the OS/2 table instead if you want */ |
|
- | 116 | /* the correct one. */ |
|
- | 117 | /* */ |
|
- | 118 | /* Descender :: The font's descender, i.e., the distance */ |
|
- | 119 | /* from the baseline to the bottom-most of */ |
|
- | 120 | /* all glyph points found in the font. It */ |
|
- | 121 | /* is negative. */ |
|
- | 122 | /* */ |
|
- | 123 | /* This value is invalid in many fonts, as */ |
|
- | 124 | /* it is usually set by the font designer, */ |
|
- | 125 | /* and often reflects only a portion of the */ |
|
- | 126 | /* glyphs found in the font (maybe ASCII). */ |
|
- | 127 | /* */ |
|
- | 128 | /* You should use the `sTypoDescender' */ |
|
- | 129 | /* field of the OS/2 table instead if you */ |
|
- | 130 | /* want the correct one. */ |
|
- | 131 | /* */ |
|
- | 132 | /* Line_Gap :: The font's line gap, i.e., the distance */ |
|
- | 133 | /* to add to the ascender and descender to */ |
|
- | 134 | /* get the BTB, i.e., the */ |
|
- | 135 | /* baseline-to-baseline distance for the */ |
|
- | 136 | /* font. */ |
|
- | 137 | /* */ |
|
- | 138 | /* advance_Width_Max :: This field is the maximum of all advance */ |
|
- | 139 | /* widths found in the font. It can be */ |
|
- | 140 | /* used to compute the maximum width of an */ |
|
- | 141 | /* arbitrary string of text. */ |
|
- | 142 | /* */ |
|
- | 143 | /* min_Left_Side_Bearing :: The minimum left side bearing of all */ |
|
- | 144 | /* glyphs within the font. */ |
|
- | 145 | /* */ |
|
- | 146 | /* min_Right_Side_Bearing :: The minimum right side bearing of all */ |
|
- | 147 | /* glyphs within the font. */ |
|
- | 148 | /* */ |
|
- | 149 | /* xMax_Extent :: The maximum horizontal extent (i.e., the */ |
|
- | 150 | /* `width' of a glyph's bounding box) for */ |
|
- | 151 | /* all glyphs in the font. */ |
|
- | 152 | /* */ |
|
- | 153 | /* caret_Slope_Rise :: The rise coefficient of the cursor's */ |
|
- | 154 | /* slope of the cursor (slope=rise/run). */ |
|
- | 155 | /* */ |
|
- | 156 | /* caret_Slope_Run :: The run coefficient of the cursor's */ |
|
- | 157 | /* slope. */ |
|
- | 158 | /* */ |
|
- | 159 | /* Reserved :: 8~reserved bytes. */ |
|
- | 160 | /* */ |
|
- | 161 | /* metric_Data_Format :: Always~0. */ |
|
- | 162 | /* */ |
|
- | 163 | /* number_Of_HMetrics :: Number of HMetrics entries in the `hmtx' */ |
|
- | 164 | /* table -- this value can be smaller than */ |
|
51 | { |
165 | /* the total number of glyphs in the font. */ |
52 | TT_Fixed version; /* should be 0x10000 */ |
166 | /* */ |
53 | UShort numTables; /* number of tables */ |
167 | /* long_metrics :: A pointer into the `hmtx' table. */ |
54 | 168 | /* */ |
|
55 | UShort searchRange; /* These parameters are only used */ |
169 | /* short_metrics :: A pointer into the `hmtx' table. */ |
56 | UShort entrySelector; /* for a dichotomy search in the */ |
170 | /* */ |
57 | UShort rangeShift; /* directory. We ignore them. */ |
- | |
Line 58... | Line -... | ||
58 | }; |
- | |
59 | 171 | /* |
|
Line -... | Line 172... | ||
- | 172 | /* IMPORTANT: The TT_HoriHeader and TT_VertHeader structures should */ |
|
- | 173 | /* be identical except for the names of their fields which */ |
|
- | 174 | /* are different. */ |
|
- | 175 | /* */ |
|
- | 176 | /* This ensures that a single function in the `ttload' */ |
|
- | 177 | /* module is able to read both the horizontal and vertical */ |
|
Line 60... | Line 178... | ||
60 | typedef struct TTableDir_ TTableDir; |
178 | /* headers. */ |
Line 61... | Line -... | ||
61 | typedef TTableDir* PTableDir; |
- | |
62 | - | ||
63 | 179 | /* */ |
|
64 | /* The 'TableDir' is followed by 'numTables' TableDirEntries */ |
180 | typedef struct TT_HoriHeader_ |
65 | 181 | { |
|
- | 182 | FT_Fixed Version; |
|
- | 183 | FT_Short Ascender; |
|
- | 184 | FT_Short Descender; |
|
Line 66... | Line 185... | ||
66 | struct TTableDirEntry_ |
185 | FT_Short Line_Gap; |
67 | { |
186 | |
Line -... | Line 187... | ||
- | 187 | FT_UShort advance_Width_Max; /* advance width maximum */ |
|
- | 188 | ||
- | 189 | FT_Short min_Left_Side_Bearing; /* minimum left-sb */ |
|
- | 190 | FT_Short min_Right_Side_Bearing; /* minimum right-sb */ |
|
- | 191 | FT_Short xMax_Extent; /* xmax extents */ |
|
- | 192 | FT_Short caret_Slope_Rise; |
|
- | 193 | FT_Short caret_Slope_Run; |
|
- | 194 | FT_Short caret_Offset; |
|
- | 195 | ||
- | 196 | FT_Short Reserved[4]; |
|
- | 197 | ||
- | 198 | FT_Short metric_Data_Format; |
|
- | 199 | FT_UShort number_Of_HMetrics; |
|
- | 200 | ||
- | 201 | /* The following fields are not defined by the TrueType specification */ |
|
- | 202 | /* but they are used to connect the metrics header to the relevant */ |
|
- | 203 | /* `HMTX' table. */ |
|
- | 204 | ||
- | 205 | void* long_metrics; |
|
- | 206 | void* short_metrics; |
|
- | 207 | ||
- | 208 | } TT_HoriHeader; |
|
- | 209 | ||
- | 210 | ||
- | 211 | /*************************************************************************/ |
|
- | 212 | /* */ |
|
- | 213 | /* |
|
- | 214 | /* TT_VertHeader */ |
|
- | 215 | /* */ |
|
- | 216 | /* |
|
- | 217 | /* A structure used to model a TrueType vertical header, the `vhea' */ |
|
- | 218 | /* table, as well as the corresponding vertical metrics table, i.e., */ |
|
- | 219 | /* the `vmtx' table. */ |
|
- | 220 | /* */ |
|
- | 221 | /* |
|
- | 222 | /* Version :: The table version. */ |
|
- | 223 | /* */ |
|
- | 224 | /* Ascender :: The font's ascender, i.e., the distance */ |
|
- | 225 | /* from the baseline to the top-most of */ |
|
- | 226 | /* all glyph points found in the font. */ |
|
- | 227 | /* */ |
|
- | 228 | /* This value is invalid in many fonts, as */ |
|
- | 229 | /* it is usually set by the font designer, */ |
|
- | 230 | /* and often reflects only a portion of */ |
|
- | 231 | /* the glyphs found in the font (maybe */ |
|
- | 232 | /* ASCII). */ |
|
- | 233 | /* */ |
|
- | 234 | /* You should use the `sTypoAscender' */ |
|
- | 235 | /* field of the OS/2 table instead if you */ |
|
- | 236 | /* want the correct one. */ |
|
- | 237 | /* */ |
|
- | 238 | /* Descender :: The font's descender, i.e., the */ |
|
- | 239 | /* distance from the baseline to the */ |
|
- | 240 | /* bottom-most of all glyph points found */ |
|
- | 241 | /* in the font. It is negative. */ |
|
- | 242 | /* */ |
|
- | 243 | /* This value is invalid in many fonts, as */ |
|
- | 244 | /* it is usually set by the font designer, */ |
|
- | 245 | /* and often reflects only a portion of */ |
|
- | 246 | /* the glyphs found in the font (maybe */ |
|
- | 247 | /* ASCII). */ |
|
- | 248 | /* */ |
|
- | 249 | /* You should use the `sTypoDescender' */ |
|
- | 250 | /* field of the OS/2 table instead if you */ |
|
- | 251 | /* want the correct one. */ |
|
- | 252 | /* */ |
|
- | 253 | /* Line_Gap :: The font's line gap, i.e., the distance */ |
|
- | 254 | /* to add to the ascender and descender to */ |
|
- | 255 | /* get the BTB, i.e., the */ |
|
- | 256 | /* baseline-to-baseline distance for the */ |
|
- | 257 | /* font. */ |
|
- | 258 | /* */ |
|
- | 259 | /* advance_Height_Max :: This field is the maximum of all */ |
|
- | 260 | /* advance heights found in the font. It */ |
|
- | 261 | /* can be used to compute the maximum */ |
|
- | 262 | /* height of an arbitrary string of text. */ |
|
- | 263 | /* */ |
|
- | 264 | /* min_Top_Side_Bearing :: The minimum top side bearing of all */ |
|
- | 265 | /* glyphs within the font. */ |
|
- | 266 | /* */ |
|
- | 267 | /* min_Bottom_Side_Bearing :: The minimum bottom side bearing of all */ |
|
- | 268 | /* glyphs within the font. */ |
|
- | 269 | /* */ |
|
- | 270 | /* yMax_Extent :: The maximum vertical extent (i.e., the */ |
|
- | 271 | /* `height' of a glyph's bounding box) for */ |
|
- | 272 | /* all glyphs in the font. */ |
|
- | 273 | /* */ |
|
- | 274 | /* caret_Slope_Rise :: The rise coefficient of the cursor's */ |
|
- | 275 | /* slope of the cursor (slope=rise/run). */ |
|
- | 276 | /* */ |
|
- | 277 | /* caret_Slope_Run :: The run coefficient of the cursor's */ |
|
- | 278 | /* slope. */ |
|
- | 279 | /* */ |
|
- | 280 | /* caret_Offset :: The cursor's offset for slanted fonts. */ |
|
- | 281 | /* This value is `reserved' in vmtx */ |
|
- | 282 | /* version 1.0. */ |
|
- | 283 | /* */ |
|
- | 284 | /* Reserved :: 8~reserved bytes. */ |
|
68 | ULong Tag; /* table type */ |
285 | /* */ |
69 | ULong CheckSum; /* table checksum */ |
286 | /* metric_Data_Format :: Always~0. */ |
70 | ULong Offset; /* table file offset */ |
287 | /* */ |
71 | ULong Length; /* table length */ |
288 | /* number_Of_HMetrics :: Number of VMetrics entries in the */ |
72 | }; |
289 | /* `vmtx' table -- this value can be */ |
73 | 290 | /* smaller than the total number of glyphs */ |
|
Line 74... | Line -... | ||
74 | typedef struct TTableDirEntry_ TTableDirEntry; |
- | |
75 | typedef TTableDirEntry* PTableDirEntry; |
291 | /* in the font. */ |
Line -... | Line 292... | ||
- | 292 | /* */ |
|
- | 293 | /* long_metrics :: A pointer into the `vmtx' table. */ |
|
- | 294 | /* */ |
|
- | 295 | /* short_metrics :: A pointer into the `vmtx' table. */ |
|
- | 296 | /* */ |
|
- | 297 | /* |
|
Line 76... | Line 298... | ||
76 | 298 | /* IMPORTANT: The TT_HoriHeader and TT_VertHeader structures should */ |
|
Line 77... | Line -... | ||
77 | - | ||
78 | /* 'cmap' tables */ |
- | |
79 | 299 | /* be identical except for the names of their fields which */ |
|
80 | struct TCMapDir_ |
300 | /* are different. */ |
81 | { |
- | |
82 | UShort tableVersionNumber; |
- | |
83 | UShort numCMaps; |
- | |
84 | }; |
- | |
85 | - | ||
86 | typedef struct TCMapDir_ TCMapDir; |
- | |
87 | typedef TCMapDir* PCMapDir; |
- | |
88 | - | ||
89 | struct TCMapDirEntry_ |
- | |
90 | { |
- | |
91 | UShort platformID; |
- | |
92 | UShort platformEncodingID; |
- | |
93 | Long offset; |
- | |
94 | }; |
- | |
Line -... | Line 301... | ||
- | 301 | /* */ |
|
95 | 302 | /* This ensures that a single function in the `ttload' */ |
|
96 | typedef struct TCMapDirEntry_ TCMapDirEntry; |
303 | /* module is able to read both the horizontal and vertical */ |
Line -... | Line 304... | ||
- | 304 | /* headers. */ |
|
- | 305 | /* */ |
|
Line 97... | Line 306... | ||
97 | typedef TCMapDirEntry* PCMapDirEntries; |
306 | typedef struct TT_VertHeader_ |
Line 98... | Line -... | ||
98 | - | ||
99 | - | ||
Line -... | Line 307... | ||
- | 307 | { |
|
- | 308 | FT_Fixed Version; |
|
- | 309 | FT_Short Ascender; |
|
- | 310 | FT_Short Descender; |
|
- | 311 | FT_Short Line_Gap; |
|
- | 312 | ||
- | 313 | FT_UShort advance_Height_Max; /* advance height maximum */ |
|
- | 314 | ||
- | 315 | FT_Short min_Top_Side_Bearing; /* minimum left-sb or top-sb */ |
|
- | 316 | FT_Short min_Bottom_Side_Bearing; /* minimum right-sb or bottom-sb */ |
|
- | 317 | FT_Short yMax_Extent; /* xmax or ymax extents */ |
|
- | 318 | FT_Short caret_Slope_Rise; |
|
- | 319 | FT_Short caret_Slope_Run; |
|
100 | /* 'maxp' Maximum Profiles table */ |
320 | FT_Short caret_Offset; |
101 | 321 | ||
- | 322 | FT_Short Reserved[4]; |
|
- | 323 | ||
- | 324 | FT_Short metric_Data_Format; |
|
- | 325 | FT_UShort number_Of_VMetrics; |
|
102 | struct TMaxProfile_ |
326 | |
- | 327 | /* The following fields are not defined by the TrueType specification */ |
|
- | 328 | /* but they're used to connect the metrics header to the relevant */ |
|
- | 329 | /* `HMTX' or `VMTX' table. */ |
|
- | 330 | ||
- | 331 | void* long_metrics; |
|
- | 332 | void* short_metrics; |
|
- | 333 | ||
- | 334 | } TT_VertHeader; |
|
- | 335 | ||
- | 336 | ||
103 | { |
337 | /*************************************************************************/ |
- | 338 | /* */ |
|
- | 339 | /* |
|
- | 340 | /* TT_OS2 */ |
|
- | 341 | /* */ |
|
- | 342 | /* |
|
- | 343 | /* A structure used to model a TrueType OS/2 table. This is the long */ |
|
- | 344 | /* table version. All fields comply to the TrueType specification. */ |
|
- | 345 | /* */ |
|
- | 346 | /* Note that we now support old Mac fonts which do not include an */ |
|
- | 347 | /* OS/2 table. In this case, the `version' field is always set to */ |
|
- | 348 | /* 0xFFFF. */ |
|
- | 349 | /* */ |
|
- | 350 | typedef struct TT_OS2_ |
|
- | 351 | { |
|
- | 352 | FT_UShort version; /* 0x0001 - more or 0xFFFF */ |
|
- | 353 | FT_Short xAvgCharWidth; |
|
- | 354 | FT_UShort usWeightClass; |
|
- | 355 | FT_UShort usWidthClass; |
|
- | 356 | FT_Short fsType; |
|
- | 357 | FT_Short ySubscriptXSize; |
|
- | 358 | FT_Short ySubscriptYSize; |
|
- | 359 | FT_Short ySubscriptXOffset; |
|
- | 360 | FT_Short ySubscriptYOffset; |
|
- | 361 | FT_Short ySuperscriptXSize; |
|
- | 362 | FT_Short ySuperscriptYSize; |
|
104 | TT_Fixed version; |
363 | FT_Short ySuperscriptXOffset; |
- | 364 | FT_Short ySuperscriptYOffset; |
|
- | 365 | FT_Short yStrikeoutSize; |
|
- | 366 | FT_Short yStrikeoutPosition; |
|
- | 367 | FT_Short sFamilyClass; |
|
- | 368 | ||
Line 105... | Line 369... | ||
105 | UShort numGlyphs, |
369 | FT_Byte panose[10]; |
Line -... | Line 370... | ||
- | 370 | ||
- | 371 | FT_ULong ulUnicodeRange1; /* Bits 0-31 */ |
|
- | 372 | FT_ULong ulUnicodeRange2; /* Bits 32-63 */ |
|
- | 373 | FT_ULong ulUnicodeRange3; /* Bits 64-95 */ |
|
- | 374 | FT_ULong ulUnicodeRange4; /* Bits 96-127 */ |
|
- | 375 | ||
- | 376 | FT_Char achVendID[4]; |
|
- | 377 | ||
- | 378 | FT_UShort fsSelection; |
|
- | 379 | FT_UShort usFirstCharIndex; |
|
- | 380 | FT_UShort usLastCharIndex; |
|
106 | maxPoints, |
381 | FT_Short sTypoAscender; |
107 | maxContours, |
382 | FT_Short sTypoDescender; |
- | 383 | FT_Short sTypoLineGap; |
|
- | 384 | FT_UShort usWinAscent; |
|
108 | maxCompositePoints, |
385 | FT_UShort usWinDescent; |
109 | maxCompositeContours, |
386 | |
- | 387 | /* only version 1 tables: */ |
|
- | 388 | ||
110 | maxZones, |
389 | FT_ULong ulCodePageRange1; /* Bits 0-31 */ |
- | 390 | FT_ULong ulCodePageRange2; /* Bits 32-63 */ |
|
111 | maxTwilightPoints, |
391 | |
Line -... | Line 392... | ||
- | 392 | /* only version 2 tables: */ |
|
112 | maxStorage, |
393 | |
Line -... | Line 394... | ||
- | 394 | FT_Short sxHeight; |
|
Line 113... | Line -... | ||
113 | maxFunctionDefs, |
- | |
114 | maxInstructionDefs, |
- | |
Line -... | Line 395... | ||
- | 395 | FT_Short sCapHeight; |
|
- | 396 | FT_UShort usDefaultChar; |
|
- | 397 | FT_UShort usBreakChar; |
|
- | 398 | FT_UShort usMaxContext; |
|
- | 399 | ||
- | 400 | } TT_OS2; |
|
- | 401 | ||
- | 402 | ||
- | 403 | /*************************************************************************/ |
|
- | 404 | /* */ |
|
- | 405 | /* |
|
- | 406 | /* TT_Postscript */ |
|
- | 407 | /* */ |
|
- | 408 | /* |
|
- | 409 | /* A structure used to model a TrueType PostScript table. All fields */ |
|
- | 410 | /* comply to the TrueType specification. This structure does not */ |
|
- | 411 | /* reference the PostScript glyph names, which can be nevertheless */ |
|
- | 412 | /* accessed with the `ttpost' module. */ |
|
- | 413 | /* */ |
|
- | 414 | typedef struct TT_Postscript_ |
|
- | 415 | { |
|
- | 416 | FT_Fixed FormatType; |
|
- | 417 | FT_Fixed italicAngle; |
|
- | 418 | FT_Short underlinePosition; |
|
- | 419 | FT_Short underlineThickness; |
|
- | 420 | FT_ULong isFixedPitch; |
|
Line 115... | Line 421... | ||
115 | maxStackElements, |
421 | FT_ULong minMemType42; |
Line 116... | Line -... | ||
116 | maxSizeOfInstructions, |
- | |
117 | maxComponentElements, |
- | |
118 | maxComponentDepth; |
- | |
119 | }; |
- | |
120 | - | ||
Line -... | Line 422... | ||
- | 422 | FT_ULong maxMemType42; |
|
- | 423 | FT_ULong minMemType1; |
|
- | 424 | FT_ULong maxMemType1; |
|
- | 425 | ||
- | 426 | /* Glyph names follow in the file, but we don't */ |
|
- | 427 | /* load them by default. See the ttpost.c file. */ |
|
- | 428 | ||
- | 429 | } TT_Postscript; |
|
- | 430 | ||
- | 431 | ||
- | 432 | /*************************************************************************/ |
|
- | 433 | /* */ |
|
- | 434 | /* |
|
- | 435 | /* TT_PCLT */ |
|
- | 436 | /* */ |
|
- | 437 | /* |
|
- | 438 | /* A structure used to model a TrueType PCLT table. All fields */ |
|
- | 439 | /* comply to the TrueType specification. */ |
|
- | 440 | /* */ |
|
- | 441 | typedef struct TT_PCLT_ |
|
- | 442 | { |
|
- | 443 | FT_Fixed Version; |
|
- | 444 | FT_ULong FontNumber; |
|
- | 445 | FT_UShort Pitch; |
|
- | 446 | FT_UShort xHeight; |
|
- | 447 | FT_UShort Style; |
|
- | 448 | FT_UShort TypeFamily; |
|
- | 449 | FT_UShort CapHeight; |
|
- | 450 | FT_UShort SymbolSet; |
|
- | 451 | FT_Char TypeFace[16]; |
|
- | 452 | FT_Char CharacterComplement[8]; |
|
- | 453 | FT_Char FileName[6]; |
|
- | 454 | FT_Char StrokeWeight; |
|
- | 455 | FT_Char WidthType; |
|
- | 456 | FT_Byte SerifStyle; |
|
- | 457 | FT_Byte Reserved; |
|
- | 458 | ||
- | 459 | } TT_PCLT; |
|
- | 460 | ||
- | 461 | ||
- | 462 | /*************************************************************************/ |
|
- | 463 | /* */ |
|
- | 464 | /* |
|
- | 465 | /* TT_MaxProfile */ |
|
- | 466 | /* */ |
|
- | 467 | /* |
|
- | 468 | /* The maximum profile is a table containing many max values which */ |
|
- | 469 | /* can be used to pre-allocate arrays. This ensures that no memory */ |
|
- | 470 | /* allocation occurs during a glyph load. */ |
|
- | 471 | /* */ |
|
- | 472 | /* |
|
- | 473 | /* version :: The version number. */ |
|
- | 474 | /* */ |
|
- | 475 | /* numGlyphs :: The number of glyphs in this TrueType */ |
|
- | 476 | /* font. */ |
|
- | 477 | /* */ |
|
- | 478 | /* maxPoints :: The maximum number of points in a */ |
|
- | 479 | /* non-composite TrueType glyph. See also */ |
|
- | 480 | /* the structure element */ |
|
- | 481 | /* `maxCompositePoints'. */ |
|
- | 482 | /* */ |
|
- | 483 | /* maxContours :: The maximum number of contours in a */ |
|
- | 484 | /* non-composite TrueType glyph. See also */ |
|
- | 485 | /* the structure element */ |
|
- | 486 | /* `maxCompositeContours'. */ |
|
- | 487 | /* */ |
|
121 | typedef struct TMaxProfile_ TMaxProfile; |
488 | /* maxCompositePoints :: The maximum number of points in a */ |
- | 489 | /* composite TrueType glyph. See also the */ |
|
- | 490 | /* structure element `maxPoints'. */ |
|
- | 491 | /* */ |
|
- | 492 | /* maxCompositeContours :: The maximum number of contours in a */ |
|
- | 493 | /* composite TrueType glyph. See also the */ |
|
- | 494 | /* structure element `maxContours'. */ |
|
- | 495 | /* */ |
|
- | 496 | /* maxZones :: The maximum number of zones used for */ |
|
- | 497 | /* glyph hinting. */ |
|
- | 498 | /* */ |
|
- | 499 | /* maxTwilightPoints :: The maximum number of points in the */ |
|
- | 500 | /* twilight zone used for glyph hinting. */ |
|
- | 501 | /* */ |
|
- | 502 | /* maxStorage :: The maximum number of elements in the */ |
|
- | 503 | /* storage area used for glyph hinting. */ |
|
- | 504 | /* */ |
|
Line 122... | Line 505... | ||
122 | typedef TMaxProfile* PMaxProfile; |
505 | /* maxFunctionDefs :: The maximum number of function */ |
Line 123... | Line -... | ||
123 | - | ||
Line -... | Line 506... | ||
- | 506 | /* definitions in the TrueType bytecode for */ |
|
- | 507 | /* this font. */ |
|
- | 508 | /* */ |
|
- | 509 | /* maxInstructionDefs :: The maximum number of instruction */ |
|
- | 510 | /* definitions in the TrueType bytecode for */ |
|
- | 511 | /* this font. */ |
|
- | 512 | /* */ |
|
- | 513 | /* maxStackElements :: The maximum number of stack elements used */ |
|
- | 514 | /* during bytecode interpretation. */ |
|
124 | 515 | /* */ |
|
125 | /* table "gasp" */ |
516 | /* maxSizeOfInstructions :: The maximum number of TrueType opcodes */ |
126 | 517 | /* used for glyph hinting. */ |
|
127 | #define GASP_GRIDFIT 0x01 |
518 | /* */ |
128 | #define GASP_DOGRAY 0x02 |
- | |
- | 519 | /* maxComponentElements :: The maximum number of simple (i.e., non- */ |
|
- | 520 | /* composite) glyphs in a composite glyph. */ |
|
- | 521 | /* */ |
|
- | 522 | /* maxComponentDepth :: The maximum nesting depth of composite */ |
|
- | 523 | /* glyphs. */ |
|
Line 129... | Line 524... | ||
129 | 524 | /* */ |
|
Line -... | Line 525... | ||
- | 525 | /* |
|
Line 130... | Line 526... | ||
130 | struct GaspRange_ |
526 | /* This structure is only used during font loading. */ |
Line 131... | Line -... | ||
131 | { |
- | |
132 | UShort maxPPEM; |
- | |
133 | UShort gaspFlag; |
- | |
134 | }; |
- | |
135 | - | ||
136 | typedef struct GaspRange_ GaspRange; |
- | |
137 | - | ||
138 | - | ||
Line -... | Line 527... | ||
- | 527 | /* */ |
|
- | 528 | typedef struct TT_MaxProfile_ |
|
- | 529 | { |
|
- | 530 | FT_Fixed version; |
|
- | 531 | FT_UShort numGlyphs; |
|
- | 532 | FT_UShort maxPoints; |
|
- | 533 | FT_UShort maxContours; |
|
- | 534 | FT_UShort maxCompositePoints; |
|
- | 535 | FT_UShort maxCompositeContours; |
|
- | 536 | FT_UShort maxZones; |
|
- | 537 | FT_UShort maxTwilightPoints; |
|
- | 538 | FT_UShort maxStorage; |
|
- | 539 | FT_UShort maxFunctionDefs; |
|
- | 540 | FT_UShort maxInstructionDefs; |
|
139 | struct TGasp_ |
541 | FT_UShort maxStackElements; |
- | 542 | FT_UShort maxSizeOfInstructions; |
|
- | 543 | FT_UShort maxComponentElements; |
|
- | 544 | FT_UShort maxComponentDepth; |
|
- | 545 | ||
- | 546 | } TT_MaxProfile; |
|
- | 547 | ||
- | 548 | ||
140 | { |
549 | /*************************************************************************/ |
- | 550 | /* */ |
|
- | 551 | /* |
|
- | 552 | /* FT_Sfnt_Tag */ |
|
- | 553 | /* */ |
|
- | 554 | /* |
|
- | 555 | /* An enumeration used to specify the index of an SFNT table. */ |
|
- | 556 | /* Used in the @FT_Get_Sfnt_Table API function. */ |
|
- | 557 | /* */ |
|
Line 141... | Line -... | ||
141 | UShort version; |
- | |
142 | UShort numRanges; |
- | |
Line -... | Line 558... | ||
- | 558 | typedef enum FT_Sfnt_Tag_ |
|
- | 559 | { |
|
- | 560 | ft_sfnt_head = 0, /* TT_Header */ |
|
- | 561 | ft_sfnt_maxp = 1, /* TT_MaxProfile */ |
|
- | 562 | ft_sfnt_os2 = 2, /* TT_OS2 */ |
|
- | 563 | ft_sfnt_hhea = 3, /* TT_HoriHeader */ |
|
- | 564 | ft_sfnt_vhea = 4, /* TT_VertHeader */ |
|
- | 565 | ft_sfnt_post = 5, /* TT_Postscript */ |
|
- | 566 | ft_sfnt_pclt = 6, /* TT_PCLT */ |
|
- | 567 | ||
- | 568 | sfnt_max /* internal end mark */ |
|
- | 569 | ||
- | 570 | } FT_Sfnt_Tag; |
|
- | 571 | ||
- | 572 | /* */ |
|
- | 573 | ||
- | 574 | ||
- | 575 | /*************************************************************************/ |
|
- | 576 | /* */ |
|
- | 577 | /* |
|
- | 578 | /* FT_Get_Sfnt_Table */ |
|
- | 579 | /* */ |
|
- | 580 | /* |
|
- | 581 | /* Return a pointer to a given SFNT table within a face. */ |
|
- | 582 | /* */ |
|
- | 583 | /* */ |
|
- | 584 | /* face :: A handle to the source. */ |
|
- | 585 | /* */ |
|
- | 586 | /* tag :: The index of the SFNT table. */ |
|
- | 587 | /* */ |
|
- | 588 | /* |
|
- | 589 | /* A type-less pointer to the table. This will be~0 in case of */ |
|
- | 590 | /* error, or if the corresponding table was not found *OR* loaded */ |
|
- | 591 | /* from the file. */ |
|
- | 592 | /* */ |
|
- | 593 | /* Use a typecast according to `tag' to access the structure */ |
|
- | 594 | /* elements. */ |
|
- | 595 | /* */ |
|
- | 596 | /* |
|
- | 597 | /* The table is owned by the face object and disappears with it. */ |
|
- | 598 | /* */ |
|
- | 599 | /* This function is only useful to access SFNT tables that are loaded */ |
|
- | 600 | /* by the sfnt, truetype, and opentype drivers. See @FT_Sfnt_Tag for */ |
|
- | 601 | /* a list. */ |
|
- | 602 | /* */ |
|
- | 603 | FT_EXPORT( void* ) |
|
- | 604 | FT_Get_Sfnt_Table( FT_Face face, |
|
- | 605 | FT_Sfnt_Tag tag ); |
|
- | 606 | ||
- | 607 | ||
- | 608 | /************************************************************************** |
|
143 | GaspRange* gaspRanges; |
609 | * |
- | 610 | * @function: |
|
- | 611 | * FT_Load_Sfnt_Table |
|
- | 612 | * |
|
- | 613 | * @description: |
|
- | 614 | * Load any font table into client memory. |
|
- | 615 | * |
|
- | 616 | * @input: |
|
- | 617 | * face :: |
|
- | 618 | * A handle to the source face. |
|
- | 619 | * |
|
- | 620 | * tag :: |
|
- | 621 | * The four-byte tag of the table to load. Use the value~0 if you want |
|
Line -... | Line 622... | ||
- | 622 | * to access the whole font file. Otherwise, you can use one of the |
|
- | 623 | * definitions found in the @FT_TRUETYPE_TAGS_H file, or forge a new |
|
- | 624 | * one with @FT_MAKE_TAG. |
|
144 | }; |
625 | * |
145 | 626 | * offset :: |
|
146 | typedef struct TGasp_ TGasp; |
627 | * The starting offset in the table (or file if tag == 0). |
147 | 628 | * |
|
- | 629 | * @output: |
|
- | 630 | * buffer :: |
|
- | 631 | * The target buffer address. The client must ensure that the memory |
|
148 | 632 | * array is big enough to hold the data. |
|
- | 633 | * |
|
149 | /* table "head" - now defined in freetype.h */ |
634 | * @inout: |
- | 635 | * length :: |
|
- | 636 | * If the `length' parameter is NULL, then try to load the whole table. |
|
- | 637 | * Return an error code if it fails. |
|
- | 638 | * |
|
- | 639 | * Else, if `*length' is~0, exit immediately while returning the |
|
- | 640 | * table's (or file) full size in it. |
|
- | 641 | * |
|
150 | /* table "hhea" - now defined in freetype.h */ |
642 | * Else the number of bytes to read from the table or file, from the |
- | 643 | * starting offset. |
|
- | 644 | * |
|
- | 645 | * @return: |
|
- | 646 | * FreeType error code. 0~means success. |
|
- | 647 | * |
|
- | 648 | * @note: |
|
- | 649 | * If you need to determine the table's length you should first call this |
|
- | 650 | * function with `*length' set to~0, as in the following example: |
|
151 | 651 | * |
|
- | 652 | * { |
|
- | 653 | * FT_ULong length = 0; |
|
- | 654 | * |
|
- | 655 | * |
|
- | 656 | * error = FT_Load_Sfnt_Table( face, tag, 0, NULL, &length ); |
|
Line 152... | Line -... | ||
152 | - | ||
Line -... | Line 657... | ||
- | 657 | * if ( error ) { ... table does not exist ... } |
|
- | 658 | * |
|
- | 659 | * buffer = malloc( length ); |
|
- | 660 | * if ( buffer == NULL ) { ... not enough memory ... } |
|
- | 661 | * |
|
- | 662 | * error = FT_Load_Sfnt_Table( face, tag, 0, buffer, &length ); |
|
- | 663 | * if ( error ) { ... could not load table ... } |
|
- | 664 | * } |
|
- | 665 | */ |
|
- | 666 | FT_EXPORT( FT_Error ) |
|
- | 667 | FT_Load_Sfnt_Table( FT_Face face, |
|
- | 668 | FT_ULong tag, |
|
- | 669 | FT_Long offset, |
|
- | 670 | FT_Byte* buffer, |
|
- | 671 | FT_ULong* length ); |
|
- | 672 | ||
- | 673 | ||
- | 674 | /************************************************************************** |
|
- | 675 | * |
|
Line 153... | Line -... | ||
153 | /* tables "HMTX" and "VMTX" */ |
- | |
154 | - | ||
155 | struct TLongMetrics_ |
- | |
Line -... | Line 676... | ||
- | 676 | * @function: |
|
- | 677 | * FT_Sfnt_Table_Info |
|
- | 678 | * |
|
- | 679 | * @description: |
|
- | 680 | * Return information on an SFNT table. |
|
- | 681 | * |
|
- | 682 | * @input: |
|
- | 683 | * face :: |
|
- | 684 | * A handle to the source face. |
|
- | 685 | * |
|
- | 686 | * table_index :: |
|
- | 687 | * The index of an SFNT table. The function returns |
|
- | 688 | * FT_Err_Table_Missing for an invalid value. |
|
- | 689 | * |
|
- | 690 | * @output: |
|
- | 691 | * tag :: |
|
- | 692 | * The name tag of the SFNT table. |
|
- | 693 | * |
|
- | 694 | * length :: |
|
- | 695 | * The length of the SFNT table. |
|
- | 696 | * |
|
- | 697 | * @return: |
|
- | 698 | * FreeType error code. 0~means success. |
|
- | 699 | * |
|
156 | { |
700 | * @note: |
Line 157... | Line 701... | ||
157 | UShort advance; |
701 | * SFNT tables with length zero are treated as missing. |