Subversion Repositories Kolibri OS

Rev

Blame | Last modification | View Log | RSS feed

  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
  2. "http://www.w3.org/TR/html4/loose.dtd">
  3. <html>
  4. <head>
  5. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  6. <title>FreeType-2.5.0 API Reference</title>
  7. <style type="text/css">
  8.   body { font-family: Verdana, Geneva, Arial, Helvetica, serif;
  9.          color: #000000;
  10.          background: #FFFFFF; }
  11.  
  12.   p { text-align: justify; }
  13.   h1 { text-align: center; }
  14.   li { text-align: justify; }
  15.   td { padding: 0 0.5em 0 0.5em; }
  16.   td.left { padding: 0 0.5em 0 0.5em;
  17.             text-align: left; }
  18.  
  19.   a:link { color: #0000EF; }
  20.   a:visited { color: #51188E; }
  21.   a:hover { color: #FF0000; }
  22.  
  23.   span.keyword { font-family: monospace;
  24.                  text-align: left;
  25.                  white-space: pre;
  26.                  color: darkblue; }
  27.  
  28.   pre.colored { color: blue; }
  29.  
  30.   ul.empty { list-style-type: none; }
  31. </style>
  32. </head>
  33. <body>
  34.  
  35. <table align=center><tr><td><font size=-1>[<a href="ft2-index.html">Index</a>]</font></td>
  36. <td width="100%"></td>
  37. <td><font size=-1>[<a href="ft2-toc.html">TOC</a>]</font></td></tr></table>
  38. <center><h1>FreeType-2.5.0 API Reference</h1></center>
  39.  
  40. <center><h1>
  41. TrueType Tables
  42. </h1></center>
  43. <h2>Synopsis</h2>
  44. <table align=center cellspacing=5 cellpadding=0 border=0>
  45. <tr><td></td><td><a href="#TT_PLATFORM_XXX">TT_PLATFORM_XXX</a></td><td></td><td><a href="#TT_Postscript">TT_Postscript</a></td></tr>
  46. <tr><td></td><td><a href="#TT_APPLE_ID_XXX">TT_APPLE_ID_XXX</a></td><td></td><td><a href="#TT_PCLT">TT_PCLT</a></td></tr>
  47. <tr><td></td><td><a href="#TT_MAC_ID_XXX">TT_MAC_ID_XXX</a></td><td></td><td><a href="#TT_MaxProfile">TT_MaxProfile</a></td></tr>
  48. <tr><td></td><td><a href="#TT_ISO_ID_XXX">TT_ISO_ID_XXX</a></td><td></td><td><a href="#FT_Sfnt_Tag">FT_Sfnt_Tag</a></td></tr>
  49. <tr><td></td><td><a href="#TT_MS_ID_XXX">TT_MS_ID_XXX</a></td><td></td><td><a href="#FT_Get_Sfnt_Table">FT_Get_Sfnt_Table</a></td></tr>
  50. <tr><td></td><td><a href="#TT_ADOBE_ID_XXX">TT_ADOBE_ID_XXX</a></td><td></td><td><a href="#FT_Load_Sfnt_Table">FT_Load_Sfnt_Table</a></td></tr>
  51. <tr><td></td><td><a href="#TT_Header">TT_Header</a></td><td></td><td><a href="#FT_Sfnt_Table_Info">FT_Sfnt_Table_Info</a></td></tr>
  52. <tr><td></td><td><a href="#TT_HoriHeader">TT_HoriHeader</a></td><td></td><td><a href="#FT_Get_CMap_Language_ID">FT_Get_CMap_Language_ID</a></td></tr>
  53. <tr><td></td><td><a href="#TT_VertHeader">TT_VertHeader</a></td><td></td><td><a href="#FT_Get_CMap_Format">FT_Get_CMap_Format</a></td></tr>
  54. <tr><td></td><td><a href="#TT_OS2">TT_OS2</a></td><td></td><td><a href="#FT_PARAM_TAG_UNPATENTED_HINTING">FT_PARAM_TAG_UNPATENTED_HINTING</a></td></tr>
  55. </table><br><br>
  56.  
  57. <table align=center width="87%"><tr><td>
  58. <p>This section contains the definition of TrueType-specific tables as well as some routines used to access and process them.</p>
  59. </td></tr></table><br>
  60. <table align=center width="75%"><tr><td>
  61. <h4><a name="TT_PLATFORM_XXX">TT_PLATFORM_XXX</a></h4>
  62. <table align=center width="87%"><tr><td>
  63. Defined in FT_TRUETYPE_IDS_H (freetype/ttnameid.h).
  64. </td></tr></table><br>
  65. <table align=center width="87%"><tr bgcolor="#D6E8FF"><td><pre>
  66.  
  67. #define <a href="ft2-truetype_tables.html#TT_PLATFORM_XXX">TT_PLATFORM_APPLE_UNICODE</a>  0
  68. #define <a href="ft2-truetype_tables.html#TT_PLATFORM_XXX">TT_PLATFORM_MACINTOSH</a>      1
  69. #define <a href="ft2-truetype_tables.html#TT_PLATFORM_XXX">TT_PLATFORM_ISO</a>            2 /* deprecated */
  70. #define <a href="ft2-truetype_tables.html#TT_PLATFORM_XXX">TT_PLATFORM_MICROSOFT</a>      3
  71. #define <a href="ft2-truetype_tables.html#TT_PLATFORM_XXX">TT_PLATFORM_CUSTOM</a>         4
  72. #define <a href="ft2-truetype_tables.html#TT_PLATFORM_XXX">TT_PLATFORM_ADOBE</a>          7 /* artificial */
  73.  
  74. </pre></table><br>
  75. <table align=center width="87%"><tr><td>
  76. <p>A list of valid values for the &lsquo;platform_id&rsquo; identifier code in <a href="ft2-base_interface.html#FT_CharMapRec">FT_CharMapRec</a> and <a href="ft2-sfnt_names.html#FT_SfntName">FT_SfntName</a> structures.</p>
  77. </td></tr></table><br>
  78. <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>values</b></em></td></tr><tr><td>
  79. <p></p>
  80. <table cellpadding=3 border=0>
  81. <tr valign=top><td colspan=0><b>TT_PLATFORM_APPLE_UNICODE</b></td></tr>
  82. <tr valign=top><td></td><td>
  83. <p>Used by Apple to indicate a Unicode character map and/or name entry. See <a href="ft2-truetype_tables.html#TT_APPLE_ID_XXX">TT_APPLE_ID_XXX</a> for corresponding &lsquo;encoding_id&rsquo; values. Note that name entries in this format are coded as big-endian UCS-2 character codes <i>only</i>.</p>
  84. </td></tr>
  85. <tr valign=top><td><b>TT_PLATFORM_MACINTOSH</b></td><td>
  86. <p>Used by Apple to indicate a MacOS-specific charmap and/or name entry. See <a href="ft2-truetype_tables.html#TT_MAC_ID_XXX">TT_MAC_ID_XXX</a> for corresponding &lsquo;encoding_id&rsquo; values. Note that most TrueType fonts contain an Apple roman charmap to be usable on MacOS systems (even if they contain a Microsoft charmap as well).</p>
  87. </td></tr>
  88. <tr valign=top><td><b>TT_PLATFORM_ISO</b></td><td>
  89. <p>This value was used to specify ISO/IEC 10646 charmaps. It is however now deprecated. See <a href="ft2-truetype_tables.html#TT_ISO_ID_XXX">TT_ISO_ID_XXX</a> for a list of corresponding &lsquo;encoding_id&rsquo; values.</p>
  90. </td></tr>
  91. <tr valign=top><td><b>TT_PLATFORM_MICROSOFT</b></td><td>
  92. <p>Used by Microsoft to indicate Windows-specific charmaps. See <a href="ft2-truetype_tables.html#TT_MS_ID_XXX">TT_MS_ID_XXX</a> for a list of corresponding &lsquo;encoding_id&rsquo; values. Note that most fonts contain a Unicode charmap using (TT_PLATFORM_MICROSOFT, <a href="ft2-truetype_tables.html#TT_MS_ID_XXX">TT_MS_ID_UNICODE_CS</a>).</p>
  93. </td></tr>
  94. <tr valign=top><td><b>TT_PLATFORM_CUSTOM</b></td><td>
  95. <p>Used to indicate application-specific charmaps.</p>
  96. </td></tr>
  97. <tr valign=top><td><b>TT_PLATFORM_ADOBE</b></td><td>
  98. <p>This value isn't part of any font format specification, but is used by FreeType to report Adobe-specific charmaps in an <a href="ft2-base_interface.html#FT_CharMapRec">FT_CharMapRec</a> structure. See <a href="ft2-truetype_tables.html#TT_ADOBE_ID_XXX">TT_ADOBE_ID_XXX</a>.</p>
  99. </td></tr>
  100. </table>
  101. </td></tr></table>
  102. </td></tr></table>
  103. <hr width="75%">
  104. <table align=center width="75%"><tr><td><font size=-2>[<a href="ft2-index.html">Index</a>]</font></td>
  105. <td width="100%"></td>
  106. <td><font size=-2>[<a href="ft2-toc.html">TOC</a>]</font></td></tr></table>
  107.  
  108. <table align=center width="75%"><tr><td>
  109. <h4><a name="TT_APPLE_ID_XXX">TT_APPLE_ID_XXX</a></h4>
  110. <table align=center width="87%"><tr><td>
  111. Defined in FT_TRUETYPE_IDS_H (freetype/ttnameid.h).
  112. </td></tr></table><br>
  113. <table align=center width="87%"><tr bgcolor="#D6E8FF"><td><pre>
  114.  
  115. #define <a href="ft2-truetype_tables.html#TT_APPLE_ID_XXX">TT_APPLE_ID_DEFAULT</a>           0 /* Unicode 1.0 */
  116. #define <a href="ft2-truetype_tables.html#TT_APPLE_ID_XXX">TT_APPLE_ID_UNICODE_1_1</a>       1 /* specify Hangul at U+34xx */
  117. #define <a href="ft2-truetype_tables.html#TT_APPLE_ID_XXX">TT_APPLE_ID_ISO_10646</a>         2 /* deprecated */
  118. #define <a href="ft2-truetype_tables.html#TT_APPLE_ID_XXX">TT_APPLE_ID_UNICODE_2_0</a>       3 /* or later */
  119. #define <a href="ft2-truetype_tables.html#TT_APPLE_ID_XXX">TT_APPLE_ID_UNICODE_32</a>        4 /* 2.0 or later, full repertoire */
  120. #define <a href="ft2-truetype_tables.html#TT_APPLE_ID_XXX">TT_APPLE_ID_VARIANT_SELECTOR</a>  5 /* variation selector data */
  121.  
  122. </pre></table><br>
  123. <table align=center width="87%"><tr><td>
  124. <p>A list of valid values for the &lsquo;encoding_id&rsquo; for <a href="ft2-truetype_tables.html#TT_PLATFORM_XXX">TT_PLATFORM_APPLE_UNICODE</a> charmaps and name entries.</p>
  125. </td></tr></table><br>
  126. <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>values</b></em></td></tr><tr><td>
  127. <p></p>
  128. <table cellpadding=3 border=0>
  129. <tr valign=top><td><b>TT_APPLE_ID_DEFAULT</b></td><td>
  130. <p>Unicode version 1.0.</p>
  131. </td></tr>
  132. <tr valign=top><td colspan=0><b>TT_APPLE_ID_UNICODE_1_1</b></td></tr>
  133. <tr valign=top><td></td><td>
  134. <p>Unicode 1.1; specifies Hangul characters starting at U+34xx.</p>
  135. </td></tr>
  136. <tr valign=top><td><b>TT_APPLE_ID_ISO_10646</b></td><td>
  137. <p>Deprecated (identical to preceding).</p>
  138. </td></tr>
  139. <tr valign=top><td colspan=0><b>TT_APPLE_ID_UNICODE_2_0</b></td></tr>
  140. <tr valign=top><td></td><td>
  141. <p>Unicode 2.0 and beyond (UTF-16 BMP only).</p>
  142. </td></tr>
  143. <tr valign=top><td><b>TT_APPLE_ID_UNICODE_32</b></td><td>
  144. <p>Unicode 3.1 and beyond, using UTF-32.</p>
  145. </td></tr>
  146. <tr valign=top><td colspan=0><b>TT_APPLE_ID_VARIANT_SELECTOR</b></td></tr>
  147. <tr valign=top><td></td><td>
  148. <p>From Adobe, not Apple. Not a normal cmap. Specifies variations on a real cmap.</p>
  149. </td></tr>
  150. </table>
  151. </td></tr></table>
  152. </td></tr></table>
  153. <hr width="75%">
  154. <table align=center width="75%"><tr><td><font size=-2>[<a href="ft2-index.html">Index</a>]</font></td>
  155. <td width="100%"></td>
  156. <td><font size=-2>[<a href="ft2-toc.html">TOC</a>]</font></td></tr></table>
  157.  
  158. <table align=center width="75%"><tr><td>
  159. <h4><a name="TT_MAC_ID_XXX">TT_MAC_ID_XXX</a></h4>
  160. <table align=center width="87%"><tr><td>
  161. Defined in FT_TRUETYPE_IDS_H (freetype/ttnameid.h).
  162. </td></tr></table><br>
  163. <table align=center width="87%"><tr bgcolor="#D6E8FF"><td><pre>
  164.  
  165. #define <a href="ft2-truetype_tables.html#TT_MAC_ID_XXX">TT_MAC_ID_ROMAN</a>                 0
  166. #define <a href="ft2-truetype_tables.html#TT_MAC_ID_XXX">TT_MAC_ID_JAPANESE</a>              1
  167. #define <a href="ft2-truetype_tables.html#TT_MAC_ID_XXX">TT_MAC_ID_TRADITIONAL_CHINESE</a>   2
  168. #define <a href="ft2-truetype_tables.html#TT_MAC_ID_XXX">TT_MAC_ID_KOREAN</a>                3
  169. #define <a href="ft2-truetype_tables.html#TT_MAC_ID_XXX">TT_MAC_ID_ARABIC</a>                4
  170. #define <a href="ft2-truetype_tables.html#TT_MAC_ID_XXX">TT_MAC_ID_HEBREW</a>                5
  171. #define <a href="ft2-truetype_tables.html#TT_MAC_ID_XXX">TT_MAC_ID_GREEK</a>                 6
  172. #define <a href="ft2-truetype_tables.html#TT_MAC_ID_XXX">TT_MAC_ID_RUSSIAN</a>               7
  173. #define <a href="ft2-truetype_tables.html#TT_MAC_ID_XXX">TT_MAC_ID_RSYMBOL</a>               8
  174. #define <a href="ft2-truetype_tables.html#TT_MAC_ID_XXX">TT_MAC_ID_DEVANAGARI</a>            9
  175. #define <a href="ft2-truetype_tables.html#TT_MAC_ID_XXX">TT_MAC_ID_GURMUKHI</a>             10
  176. #define <a href="ft2-truetype_tables.html#TT_MAC_ID_XXX">TT_MAC_ID_GUJARATI</a>             11
  177. #define <a href="ft2-truetype_tables.html#TT_MAC_ID_XXX">TT_MAC_ID_ORIYA</a>                12
  178. #define <a href="ft2-truetype_tables.html#TT_MAC_ID_XXX">TT_MAC_ID_BENGALI</a>              13
  179. #define <a href="ft2-truetype_tables.html#TT_MAC_ID_XXX">TT_MAC_ID_TAMIL</a>                14
  180. #define <a href="ft2-truetype_tables.html#TT_MAC_ID_XXX">TT_MAC_ID_TELUGU</a>               15
  181. #define <a href="ft2-truetype_tables.html#TT_MAC_ID_XXX">TT_MAC_ID_KANNADA</a>              16
  182. #define <a href="ft2-truetype_tables.html#TT_MAC_ID_XXX">TT_MAC_ID_MALAYALAM</a>            17
  183. #define <a href="ft2-truetype_tables.html#TT_MAC_ID_XXX">TT_MAC_ID_SINHALESE</a>            18
  184. #define <a href="ft2-truetype_tables.html#TT_MAC_ID_XXX">TT_MAC_ID_BURMESE</a>              19
  185. #define <a href="ft2-truetype_tables.html#TT_MAC_ID_XXX">TT_MAC_ID_KHMER</a>                20
  186. #define <a href="ft2-truetype_tables.html#TT_MAC_ID_XXX">TT_MAC_ID_THAI</a>                 21
  187. #define <a href="ft2-truetype_tables.html#TT_MAC_ID_XXX">TT_MAC_ID_LAOTIAN</a>              22
  188. #define <a href="ft2-truetype_tables.html#TT_MAC_ID_XXX">TT_MAC_ID_GEORGIAN</a>             23
  189. #define <a href="ft2-truetype_tables.html#TT_MAC_ID_XXX">TT_MAC_ID_ARMENIAN</a>             24
  190. #define <a href="ft2-truetype_tables.html#TT_MAC_ID_XXX">TT_MAC_ID_MALDIVIAN</a>            25
  191. #define <a href="ft2-truetype_tables.html#TT_MAC_ID_XXX">TT_MAC_ID_SIMPLIFIED_CHINESE</a>   25
  192. #define <a href="ft2-truetype_tables.html#TT_MAC_ID_XXX">TT_MAC_ID_TIBETAN</a>              26
  193. #define <a href="ft2-truetype_tables.html#TT_MAC_ID_XXX">TT_MAC_ID_MONGOLIAN</a>            27
  194. #define <a href="ft2-truetype_tables.html#TT_MAC_ID_XXX">TT_MAC_ID_GEEZ</a>                 28
  195. #define <a href="ft2-truetype_tables.html#TT_MAC_ID_XXX">TT_MAC_ID_SLAVIC</a>               29
  196. #define <a href="ft2-truetype_tables.html#TT_MAC_ID_XXX">TT_MAC_ID_VIETNAMESE</a>           30
  197. #define <a href="ft2-truetype_tables.html#TT_MAC_ID_XXX">TT_MAC_ID_SINDHI</a>               31
  198. #define <a href="ft2-truetype_tables.html#TT_MAC_ID_XXX">TT_MAC_ID_UNINTERP</a>             32
  199.  
  200. </pre></table><br>
  201. <table align=center width="87%"><tr><td>
  202. <p>A list of valid values for the &lsquo;encoding_id&rsquo; for <a href="ft2-truetype_tables.html#TT_PLATFORM_XXX">TT_PLATFORM_MACINTOSH</a> charmaps and name entries.</p>
  203. </td></tr></table><br>
  204. <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>values</b></em></td></tr><tr><td>
  205. <p></p>
  206. <table cellpadding=3 border=0>
  207. <tr valign=top><td><b>TT_MAC_ID_ROMAN</b></td><td>
  208. <p></p>
  209. </td></tr>
  210. <tr valign=top><td><b>TT_MAC_ID_JAPANESE</b></td><td>
  211. <p></p>
  212. </td></tr>
  213. <tr valign=top><td colspan=0><b>TT_MAC_ID_TRADITIONAL_CHINESE</b></td></tr>
  214. <tr valign=top><td></td><td>
  215. <p></p>
  216. </td></tr>
  217. <tr valign=top><td><b>TT_MAC_ID_KOREAN</b></td><td>
  218. <p></p>
  219. </td></tr>
  220. <tr valign=top><td><b>TT_MAC_ID_ARABIC</b></td><td>
  221. <p></p>
  222. </td></tr>
  223. <tr valign=top><td><b>TT_MAC_ID_HEBREW</b></td><td>
  224. <p></p>
  225. </td></tr>
  226. <tr valign=top><td><b>TT_MAC_ID_GREEK</b></td><td>
  227. <p></p>
  228. </td></tr>
  229. <tr valign=top><td><b>TT_MAC_ID_RUSSIAN</b></td><td>
  230. <p></p>
  231. </td></tr>
  232. <tr valign=top><td><b>TT_MAC_ID_RSYMBOL</b></td><td>
  233. <p></p>
  234. </td></tr>
  235. <tr valign=top><td><b>TT_MAC_ID_DEVANAGARI</b></td><td>
  236. <p></p>
  237. </td></tr>
  238. <tr valign=top><td><b>TT_MAC_ID_GURMUKHI</b></td><td>
  239. <p></p>
  240. </td></tr>
  241. <tr valign=top><td><b>TT_MAC_ID_GUJARATI</b></td><td>
  242. <p></p>
  243. </td></tr>
  244. <tr valign=top><td><b>TT_MAC_ID_ORIYA</b></td><td>
  245. <p></p>
  246. </td></tr>
  247. <tr valign=top><td><b>TT_MAC_ID_BENGALI</b></td><td>
  248. <p></p>
  249. </td></tr>
  250. <tr valign=top><td><b>TT_MAC_ID_TAMIL</b></td><td>
  251. <p></p>
  252. </td></tr>
  253. <tr valign=top><td><b>TT_MAC_ID_TELUGU</b></td><td>
  254. <p></p>
  255. </td></tr>
  256. <tr valign=top><td><b>TT_MAC_ID_KANNADA</b></td><td>
  257. <p></p>
  258. </td></tr>
  259. <tr valign=top><td><b>TT_MAC_ID_MALAYALAM</b></td><td>
  260. <p></p>
  261. </td></tr>
  262. <tr valign=top><td><b>TT_MAC_ID_SINHALESE</b></td><td>
  263. <p></p>
  264. </td></tr>
  265. <tr valign=top><td><b>TT_MAC_ID_BURMESE</b></td><td>
  266. <p></p>
  267. </td></tr>
  268. <tr valign=top><td><b>TT_MAC_ID_KHMER</b></td><td>
  269. <p></p>
  270. </td></tr>
  271. <tr valign=top><td><b>TT_MAC_ID_THAI</b></td><td>
  272. <p></p>
  273. </td></tr>
  274. <tr valign=top><td><b>TT_MAC_ID_LAOTIAN</b></td><td>
  275. <p></p>
  276. </td></tr>
  277. <tr valign=top><td><b>TT_MAC_ID_GEORGIAN</b></td><td>
  278. <p></p>
  279. </td></tr>
  280. <tr valign=top><td><b>TT_MAC_ID_ARMENIAN</b></td><td>
  281. <p></p>
  282. </td></tr>
  283. <tr valign=top><td><b>TT_MAC_ID_MALDIVIAN</b></td><td>
  284. <p></p>
  285. </td></tr>
  286. <tr valign=top><td colspan=0><b>TT_MAC_ID_SIMPLIFIED_CHINESE</b></td></tr>
  287. <tr valign=top><td></td><td>
  288. <p></p>
  289. </td></tr>
  290. <tr valign=top><td><b>TT_MAC_ID_TIBETAN</b></td><td>
  291. <p></p>
  292. </td></tr>
  293. <tr valign=top><td><b>TT_MAC_ID_MONGOLIAN</b></td><td>
  294. <p></p>
  295. </td></tr>
  296. <tr valign=top><td><b>TT_MAC_ID_GEEZ</b></td><td>
  297. <p></p>
  298. </td></tr>
  299. <tr valign=top><td><b>TT_MAC_ID_SLAVIC</b></td><td>
  300. <p></p>
  301. </td></tr>
  302. <tr valign=top><td><b>TT_MAC_ID_VIETNAMESE</b></td><td>
  303. <p></p>
  304. </td></tr>
  305. <tr valign=top><td><b>TT_MAC_ID_SINDHI</b></td><td>
  306. <p></p>
  307. </td></tr>
  308. <tr valign=top><td><b>TT_MAC_ID_UNINTERP</b></td><td>
  309. <p></p>
  310. </td></tr>
  311. </table>
  312. </td></tr></table>
  313. </td></tr></table>
  314. <hr width="75%">
  315. <table align=center width="75%"><tr><td><font size=-2>[<a href="ft2-index.html">Index</a>]</font></td>
  316. <td width="100%"></td>
  317. <td><font size=-2>[<a href="ft2-toc.html">TOC</a>]</font></td></tr></table>
  318.  
  319. <table align=center width="75%"><tr><td>
  320. <h4><a name="TT_ISO_ID_XXX">TT_ISO_ID_XXX</a></h4>
  321. <table align=center width="87%"><tr><td>
  322. Defined in FT_TRUETYPE_IDS_H (freetype/ttnameid.h).
  323. </td></tr></table><br>
  324. <table align=center width="87%"><tr bgcolor="#D6E8FF"><td><pre>
  325.  
  326. #define <a href="ft2-truetype_tables.html#TT_ISO_ID_XXX">TT_ISO_ID_7BIT_ASCII</a>  0
  327. #define <a href="ft2-truetype_tables.html#TT_ISO_ID_XXX">TT_ISO_ID_10646</a>       1
  328. #define <a href="ft2-truetype_tables.html#TT_ISO_ID_XXX">TT_ISO_ID_8859_1</a>      2
  329.  
  330. </pre></table><br>
  331. <table align=center width="87%"><tr><td>
  332. <p>A list of valid values for the &lsquo;encoding_id&rsquo; for <a href="ft2-truetype_tables.html#TT_PLATFORM_XXX">TT_PLATFORM_ISO</a> charmaps and name entries.</p>
  333. <p>Their use is now deprecated.</p>
  334. </td></tr></table><br>
  335. <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>values</b></em></td></tr><tr><td>
  336. <p></p>
  337. <table cellpadding=3 border=0>
  338. <tr valign=top><td><b>TT_ISO_ID_7BIT_ASCII</b></td><td>
  339. <p>ASCII.</p>
  340. </td></tr>
  341. <tr valign=top><td><b>TT_ISO_ID_10646</b></td><td>
  342. <p>ISO/10646.</p>
  343. </td></tr>
  344. <tr valign=top><td><b>TT_ISO_ID_8859_1</b></td><td>
  345. <p>Also known as Latin-1.</p>
  346. </td></tr>
  347. </table>
  348. </td></tr></table>
  349. </td></tr></table>
  350. <hr width="75%">
  351. <table align=center width="75%"><tr><td><font size=-2>[<a href="ft2-index.html">Index</a>]</font></td>
  352. <td width="100%"></td>
  353. <td><font size=-2>[<a href="ft2-toc.html">TOC</a>]</font></td></tr></table>
  354.  
  355. <table align=center width="75%"><tr><td>
  356. <h4><a name="TT_MS_ID_XXX">TT_MS_ID_XXX</a></h4>
  357. <table align=center width="87%"><tr><td>
  358. Defined in FT_TRUETYPE_IDS_H (freetype/ttnameid.h).
  359. </td></tr></table><br>
  360. <table align=center width="87%"><tr bgcolor="#D6E8FF"><td><pre>
  361.  
  362. #define <a href="ft2-truetype_tables.html#TT_MS_ID_XXX">TT_MS_ID_SYMBOL_CS</a>    0
  363. #define <a href="ft2-truetype_tables.html#TT_MS_ID_XXX">TT_MS_ID_UNICODE_CS</a>   1
  364. #define <a href="ft2-truetype_tables.html#TT_MS_ID_XXX">TT_MS_ID_SJIS</a>         2
  365. #define <a href="ft2-truetype_tables.html#TT_MS_ID_XXX">TT_MS_ID_GB2312</a>       3
  366. #define <a href="ft2-truetype_tables.html#TT_MS_ID_XXX">TT_MS_ID_BIG_5</a>        4
  367. #define <a href="ft2-truetype_tables.html#TT_MS_ID_XXX">TT_MS_ID_WANSUNG</a>      5
  368. #define <a href="ft2-truetype_tables.html#TT_MS_ID_XXX">TT_MS_ID_JOHAB</a>        6
  369. #define <a href="ft2-truetype_tables.html#TT_MS_ID_XXX">TT_MS_ID_UCS_4</a>       10
  370.  
  371. </pre></table><br>
  372. <table align=center width="87%"><tr><td>
  373. <p>A list of valid values for the &lsquo;encoding_id&rsquo; for <a href="ft2-truetype_tables.html#TT_PLATFORM_XXX">TT_PLATFORM_MICROSOFT</a> charmaps and name entries.</p>
  374. </td></tr></table><br>
  375. <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>values</b></em></td></tr><tr><td>
  376. <p></p>
  377. <table cellpadding=3 border=0>
  378. <tr valign=top><td><b>TT_MS_ID_SYMBOL_CS</b></td><td>
  379. <p>Corresponds to Microsoft symbol encoding. See <a href="ft2-base_interface.html#FT_Encoding">FT_ENCODING_MS_SYMBOL</a>.</p>
  380. </td></tr>
  381. <tr valign=top><td><b>TT_MS_ID_UNICODE_CS</b></td><td>
  382. <p>Corresponds to a Microsoft WGL4 charmap, matching Unicode. See <a href="ft2-base_interface.html#FT_Encoding">FT_ENCODING_UNICODE</a>.</p>
  383. </td></tr>
  384. <tr valign=top><td><b>TT_MS_ID_SJIS</b></td><td>
  385. <p>Corresponds to SJIS Japanese encoding. See <a href="ft2-base_interface.html#FT_Encoding">FT_ENCODING_SJIS</a>.</p>
  386. </td></tr>
  387. <tr valign=top><td><b>TT_MS_ID_GB2312</b></td><td>
  388. <p>Corresponds to Simplified Chinese as used in Mainland China. See <a href="ft2-base_interface.html#FT_Encoding">FT_ENCODING_GB2312</a>.</p>
  389. </td></tr>
  390. <tr valign=top><td><b>TT_MS_ID_BIG_5</b></td><td>
  391. <p>Corresponds to Traditional Chinese as used in Taiwan and Hong Kong. See <a href="ft2-base_interface.html#FT_Encoding">FT_ENCODING_BIG5</a>.</p>
  392. </td></tr>
  393. <tr valign=top><td><b>TT_MS_ID_WANSUNG</b></td><td>
  394. <p>Corresponds to Korean Wansung encoding. See <a href="ft2-base_interface.html#FT_Encoding">FT_ENCODING_WANSUNG</a>.</p>
  395. </td></tr>
  396. <tr valign=top><td><b>TT_MS_ID_JOHAB</b></td><td>
  397. <p>Corresponds to Johab encoding. See <a href="ft2-base_interface.html#FT_Encoding">FT_ENCODING_JOHAB</a>.</p>
  398. </td></tr>
  399. <tr valign=top><td><b>TT_MS_ID_UCS_4</b></td><td>
  400. <p>Corresponds to UCS-4 or UTF-32 charmaps. This has been added to the OpenType specification version 1.4 (mid-2001.)</p>
  401. </td></tr>
  402. </table>
  403. </td></tr></table>
  404. </td></tr></table>
  405. <hr width="75%">
  406. <table align=center width="75%"><tr><td><font size=-2>[<a href="ft2-index.html">Index</a>]</font></td>
  407. <td width="100%"></td>
  408. <td><font size=-2>[<a href="ft2-toc.html">TOC</a>]</font></td></tr></table>
  409.  
  410. <table align=center width="75%"><tr><td>
  411. <h4><a name="TT_ADOBE_ID_XXX">TT_ADOBE_ID_XXX</a></h4>
  412. <table align=center width="87%"><tr><td>
  413. Defined in FT_TRUETYPE_IDS_H (freetype/ttnameid.h).
  414. </td></tr></table><br>
  415. <table align=center width="87%"><tr bgcolor="#D6E8FF"><td><pre>
  416.  
  417. #define <a href="ft2-truetype_tables.html#TT_ADOBE_ID_XXX">TT_ADOBE_ID_STANDARD</a>  0
  418. #define <a href="ft2-truetype_tables.html#TT_ADOBE_ID_XXX">TT_ADOBE_ID_EXPERT</a>    1
  419. #define <a href="ft2-truetype_tables.html#TT_ADOBE_ID_XXX">TT_ADOBE_ID_CUSTOM</a>    2
  420. #define <a href="ft2-truetype_tables.html#TT_ADOBE_ID_XXX">TT_ADOBE_ID_LATIN_1</a>   3
  421.  
  422. </pre></table><br>
  423. <table align=center width="87%"><tr><td>
  424. <p>A list of valid values for the &lsquo;encoding_id&rsquo; for <a href="ft2-truetype_tables.html#TT_PLATFORM_XXX">TT_PLATFORM_ADOBE</a> charmaps. This is a FreeType-specific extension!</p>
  425. </td></tr></table><br>
  426. <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>values</b></em></td></tr><tr><td>
  427. <p></p>
  428. <table cellpadding=3 border=0>
  429. <tr valign=top><td><b>TT_ADOBE_ID_STANDARD</b></td><td>
  430. <p>Adobe standard encoding.</p>
  431. </td></tr>
  432. <tr valign=top><td><b>TT_ADOBE_ID_EXPERT</b></td><td>
  433. <p>Adobe expert encoding.</p>
  434. </td></tr>
  435. <tr valign=top><td><b>TT_ADOBE_ID_CUSTOM</b></td><td>
  436. <p>Adobe custom encoding.</p>
  437. </td></tr>
  438. <tr valign=top><td><b>TT_ADOBE_ID_LATIN_1</b></td><td>
  439. <p>Adobe Latin&nbsp;1 encoding.</p>
  440. </td></tr>
  441. </table>
  442. </td></tr></table>
  443. </td></tr></table>
  444. <hr width="75%">
  445. <table align=center width="75%"><tr><td><font size=-2>[<a href="ft2-index.html">Index</a>]</font></td>
  446. <td width="100%"></td>
  447. <td><font size=-2>[<a href="ft2-toc.html">TOC</a>]</font></td></tr></table>
  448.  
  449. <table align=center width="75%"><tr><td>
  450. <h4><a name="TT_Header">TT_Header</a></h4>
  451. <table align=center width="87%"><tr><td>
  452. Defined in FT_TRUETYPE_TABLES_H (freetype/tttables.h).
  453. </td></tr></table><br>
  454. <table align=center width="87%"><tr bgcolor="#D6E8FF"><td><pre>
  455.  
  456.  <span class="keyword">typedef</span> <span class="keyword">struct</span>  TT_Header_
  457.  {
  458.    <a href="ft2-basic_types.html#FT_Fixed">FT_Fixed</a>   Table_Version;
  459.    <a href="ft2-basic_types.html#FT_Fixed">FT_Fixed</a>   Font_Revision;
  460.  
  461.    <a href="ft2-basic_types.html#FT_Long">FT_Long</a>    CheckSum_Adjust;
  462.    <a href="ft2-basic_types.html#FT_Long">FT_Long</a>    Magic_Number;
  463.  
  464.    <a href="ft2-basic_types.html#FT_UShort">FT_UShort</a>  Flags;
  465.    <a href="ft2-basic_types.html#FT_UShort">FT_UShort</a>  Units_Per_EM;
  466.  
  467.    <a href="ft2-basic_types.html#FT_Long">FT_Long</a>    Created [2];
  468.    <a href="ft2-basic_types.html#FT_Long">FT_Long</a>    Modified[2];
  469.  
  470.    <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   xMin;
  471.    <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   yMin;
  472.    <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   xMax;
  473.    <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   yMax;
  474.  
  475.    <a href="ft2-basic_types.html#FT_UShort">FT_UShort</a>  Mac_Style;
  476.    <a href="ft2-basic_types.html#FT_UShort">FT_UShort</a>  Lowest_Rec_PPEM;
  477.  
  478.    <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   Font_Direction;
  479.    <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   Index_To_Loc_Format;
  480.    <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   Glyph_Data_Format;
  481.  
  482.  } <b>TT_Header</b>;
  483.  
  484. </pre></table><br>
  485. <table align=center width="87%"><tr><td>
  486. <p>A structure used to model a TrueType font header table. All fields follow the TrueType specification.</p>
  487. </td></tr></table><br>
  488. </td></tr></table>
  489. <hr width="75%">
  490. <table align=center width="75%"><tr><td><font size=-2>[<a href="ft2-index.html">Index</a>]</font></td>
  491. <td width="100%"></td>
  492. <td><font size=-2>[<a href="ft2-toc.html">TOC</a>]</font></td></tr></table>
  493.  
  494. <table align=center width="75%"><tr><td>
  495. <h4><a name="TT_HoriHeader">TT_HoriHeader</a></h4>
  496. <table align=center width="87%"><tr><td>
  497. Defined in FT_TRUETYPE_TABLES_H (freetype/tttables.h).
  498. </td></tr></table><br>
  499. <table align=center width="87%"><tr bgcolor="#D6E8FF"><td><pre>
  500.  
  501.  <span class="keyword">typedef</span> <span class="keyword">struct</span>  TT_HoriHeader_
  502.  {
  503.    <a href="ft2-basic_types.html#FT_Fixed">FT_Fixed</a>   Version;
  504.    <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   Ascender;
  505.    <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   Descender;
  506.    <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   Line_Gap;
  507.  
  508.    <a href="ft2-basic_types.html#FT_UShort">FT_UShort</a>  advance_Width_Max;      /* advance width maximum */
  509.  
  510.    <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   min_Left_Side_Bearing;  /* minimum left-sb       */
  511.    <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   min_Right_Side_Bearing; /* minimum right-sb      */
  512.    <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   xMax_Extent;            /* xmax extents          */
  513.    <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   caret_Slope_Rise;
  514.    <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   caret_Slope_Run;
  515.    <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   caret_Offset;
  516.  
  517.    <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   Reserved[4];
  518.  
  519.    <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   metric_Data_Format;
  520.    <a href="ft2-basic_types.html#FT_UShort">FT_UShort</a>  number_Of_HMetrics;
  521.  
  522.    /* The following fields are not defined by the TrueType specification */
  523.    /* but they are used to connect the metrics header to the relevant    */
  524.    /* `HMTX' table.                                                      */
  525.  
  526.     <span class="keyword">void</span>*      long_metrics;
  527.     <span class="keyword">void</span>*      short_metrics;
  528.  
  529.   } <b>TT_HoriHeader</b>;
  530.  
  531. </pre></table><br>
  532. <table align=center width="87%"><tr><td>
  533. <p>A structure used to model a TrueType horizontal header, the &lsquo;hhea&rsquo; table, as well as the corresponding horizontal metrics table, i.e., the &lsquo;hmtx&rsquo; table.</p>
  534. </td></tr></table><br>
  535. <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>fields</b></em></td></tr><tr><td>
  536. <p></p>
  537. <table cellpadding=3 border=0>
  538. <tr valign=top><td><b>Version</b></td><td>
  539. <p>The table version.</p>
  540. </td></tr>
  541. <tr valign=top><td><b>Ascender</b></td><td>
  542. <p>The font's ascender, i.e., the distance from the baseline to the top-most of all glyph points found in the font.</p>
  543. <p>This value is invalid in many fonts, as it is usually set by the font designer, and often reflects only a portion of the glyphs found in the font (maybe ASCII).</p>
  544. <p>You should use the &lsquo;sTypoAscender&rsquo; field of the OS/2 table instead if you want the correct one.</p>
  545. </td></tr>
  546. <tr valign=top><td><b>Descender</b></td><td>
  547. <p>The font's descender, i.e., the distance from the baseline to the bottom-most of all glyph points found in the font. It is negative.</p>
  548. <p>This value is invalid in many fonts, as it is usually set by the font designer, and often reflects only a portion of the glyphs found in the font (maybe ASCII).</p>
  549. <p>You should use the &lsquo;sTypoDescender&rsquo; field of the OS/2 table instead if you want the correct one.</p>
  550. </td></tr>
  551. <tr valign=top><td><b>Line_Gap</b></td><td>
  552. <p>The font's line gap, i.e., the distance to add to the ascender and descender to get the BTB, i.e., the baseline-to-baseline distance for the font.</p>
  553. </td></tr>
  554. <tr valign=top><td><b>advance_Width_Max</b></td><td>
  555. <p>This field is the maximum of all advance widths found in the font. It can be used to compute the maximum width of an arbitrary string of text.</p>
  556. </td></tr>
  557. <tr valign=top><td><b>min_Left_Side_Bearing</b></td><td>
  558. <p>The minimum left side bearing of all glyphs within the font.</p>
  559. </td></tr>
  560. <tr valign=top><td><b>min_Right_Side_Bearing</b></td><td>
  561. <p>The minimum right side bearing of all glyphs within the font.</p>
  562. </td></tr>
  563. <tr valign=top><td><b>xMax_Extent</b></td><td>
  564. <p>The maximum horizontal extent (i.e., the &lsquo;width&rsquo; of a glyph's bounding box) for all glyphs in the font.</p>
  565. </td></tr>
  566. <tr valign=top><td><b>caret_Slope_Rise</b></td><td>
  567. <p>The rise coefficient of the cursor's slope of the cursor (slope=rise/run).</p>
  568. </td></tr>
  569. <tr valign=top><td><b>caret_Slope_Run</b></td><td>
  570. <p>The run coefficient of the cursor's slope.</p>
  571. </td></tr>
  572. <tr valign=top><td><b>Reserved</b></td><td>
  573. <p>8&nbsp;reserved bytes.</p>
  574. </td></tr>
  575. <tr valign=top><td><b>metric_Data_Format</b></td><td>
  576. <p>Always&nbsp;0.</p>
  577. </td></tr>
  578. <tr valign=top><td><b>number_Of_HMetrics</b></td><td>
  579. <p>Number of HMetrics entries in the &lsquo;hmtx&rsquo; table -- this value can be smaller than the total number of glyphs in the font.</p>
  580. </td></tr>
  581. <tr valign=top><td><b>long_metrics</b></td><td>
  582. <p>A pointer into the &lsquo;hmtx&rsquo; table.</p>
  583. </td></tr>
  584. <tr valign=top><td><b>short_metrics</b></td><td>
  585. <p>A pointer into the &lsquo;hmtx&rsquo; table.</p>
  586. </td></tr>
  587. </table>
  588. </td></tr></table>
  589. <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>note</b></em></td></tr><tr><td>
  590. <p>IMPORTANT: The TT_HoriHeader and TT_VertHeader structures should be identical except for the names of their fields which are different.</p>
  591. <p>This ensures that a single function in the &lsquo;ttload&rsquo; module is able to read both the horizontal and vertical headers.</p>
  592. </td></tr></table>
  593. </td></tr></table>
  594. <hr width="75%">
  595. <table align=center width="75%"><tr><td><font size=-2>[<a href="ft2-index.html">Index</a>]</font></td>
  596. <td width="100%"></td>
  597. <td><font size=-2>[<a href="ft2-toc.html">TOC</a>]</font></td></tr></table>
  598.  
  599. <table align=center width="75%"><tr><td>
  600. <h4><a name="TT_VertHeader">TT_VertHeader</a></h4>
  601. <table align=center width="87%"><tr><td>
  602. Defined in FT_TRUETYPE_TABLES_H (freetype/tttables.h).
  603. </td></tr></table><br>
  604. <table align=center width="87%"><tr bgcolor="#D6E8FF"><td><pre>
  605.  
  606.   <span class="keyword">typedef</span> <span class="keyword">struct</span>  TT_VertHeader_
  607.   {
  608.     <a href="ft2-basic_types.html#FT_Fixed">FT_Fixed</a>   Version;
  609.     <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   Ascender;
  610.     <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   Descender;
  611.     <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   Line_Gap;
  612.  
  613.     <a href="ft2-basic_types.html#FT_UShort">FT_UShort</a>  advance_Height_Max;      /* advance height maximum */
  614.  
  615.     <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   min_Top_Side_Bearing;    /* minimum left-sb or top-sb       */
  616.     <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   min_Bottom_Side_Bearing; /* minimum right-sb or bottom-sb   */
  617.     <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   yMax_Extent;             /* xmax or ymax extents            */
  618.     <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   caret_Slope_Rise;
  619.     <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   caret_Slope_Run;
  620.     <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   caret_Offset;
  621.  
  622.     <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   Reserved[4];
  623.  
  624.     <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   metric_Data_Format;
  625.     <a href="ft2-basic_types.html#FT_UShort">FT_UShort</a>  number_Of_VMetrics;
  626.  
  627.     /* The following fields are not defined by the TrueType specification */
  628.     /* but they're used to connect the metrics header to the relevant     */
  629.    /* `HMTX' or `VMTX' table.                                            */
  630.  
  631.    <span class="keyword">void</span>*      long_metrics;
  632.    <span class="keyword">void</span>*      short_metrics;
  633.  
  634.  } <b>TT_VertHeader</b>;
  635.  
  636. </pre></table><br>
  637. <table align=center width="87%"><tr><td>
  638. <p>A structure used to model a TrueType vertical header, the &lsquo;vhea&rsquo; table, as well as the corresponding vertical metrics table, i.e., the &lsquo;vmtx&rsquo; table.</p>
  639. </td></tr></table><br>
  640. <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>fields</b></em></td></tr><tr><td>
  641. <p></p>
  642. <table cellpadding=3 border=0>
  643. <tr valign=top><td><b>Version</b></td><td>
  644. <p>The table version.</p>
  645. </td></tr>
  646. <tr valign=top><td><b>Ascender</b></td><td>
  647. <p>The font's ascender, i.e., the distance from the baseline to the top-most of all glyph points found in the font.</p>
  648. <p>This value is invalid in many fonts, as it is usually set by the font designer, and often reflects only a portion of the glyphs found in the font (maybe ASCII).</p>
  649. <p>You should use the &lsquo;sTypoAscender&rsquo; field of the OS/2 table instead if you want the correct one.</p>
  650. </td></tr>
  651. <tr valign=top><td><b>Descender</b></td><td>
  652. <p>The font's descender, i.e., the distance from the baseline to the bottom-most of all glyph points found in the font. It is negative.</p>
  653. <p>This value is invalid in many fonts, as it is usually set by the font designer, and often reflects only a portion of the glyphs found in the font (maybe ASCII).</p>
  654. <p>You should use the &lsquo;sTypoDescender&rsquo; field of the OS/2 table instead if you want the correct one.</p>
  655. </td></tr>
  656. <tr valign=top><td><b>Line_Gap</b></td><td>
  657. <p>The font's line gap, i.e., the distance to add to the ascender and descender to get the BTB, i.e., the baseline-to-baseline distance for the font.</p>
  658. </td></tr>
  659. <tr valign=top><td><b>advance_Height_Max</b></td><td>
  660. <p>This field is the maximum of all advance heights found in the font. It can be used to compute the maximum height of an arbitrary string of text.</p>
  661. </td></tr>
  662. <tr valign=top><td><b>min_Top_Side_Bearing</b></td><td>
  663. <p>The minimum top side bearing of all glyphs within the font.</p>
  664. </td></tr>
  665. <tr valign=top><td colspan=0><b>min_Bottom_Side_Bearing</b></td></tr>
  666. <tr valign=top><td></td><td>
  667. <p>The minimum bottom side bearing of all glyphs within the font.</p>
  668. </td></tr>
  669. <tr valign=top><td><b>yMax_Extent</b></td><td>
  670. <p>The maximum vertical extent (i.e., the &lsquo;height&rsquo; of a glyph's bounding box) for all glyphs in the font.</p>
  671. </td></tr>
  672. <tr valign=top><td><b>caret_Slope_Rise</b></td><td>
  673. <p>The rise coefficient of the cursor's slope of the cursor (slope=rise/run).</p>
  674. </td></tr>
  675. <tr valign=top><td><b>caret_Slope_Run</b></td><td>
  676. <p>The run coefficient of the cursor's slope.</p>
  677. </td></tr>
  678. <tr valign=top><td><b>caret_Offset</b></td><td>
  679. <p>The cursor's offset for slanted fonts. This value is &lsquo;reserved&rsquo; in vmtx version 1.0.</p>
  680. </td></tr>
  681. <tr valign=top><td><b>Reserved</b></td><td>
  682. <p>8&nbsp;reserved bytes.</p>
  683. </td></tr>
  684. <tr valign=top><td><b>metric_Data_Format</b></td><td>
  685. <p>Always&nbsp;0.</p>
  686. </td></tr>
  687. <tr valign=top><td><b>number_Of_HMetrics</b></td><td>
  688. <p>Number of VMetrics entries in the &lsquo;vmtx&rsquo; table -- this value can be smaller than the total number of glyphs in the font.</p>
  689. </td></tr>
  690. <tr valign=top><td><b>long_metrics</b></td><td>
  691. <p>A pointer into the &lsquo;vmtx&rsquo; table.</p>
  692. </td></tr>
  693. <tr valign=top><td><b>short_metrics</b></td><td>
  694. <p>A pointer into the &lsquo;vmtx&rsquo; table.</p>
  695. </td></tr>
  696. </table>
  697. </td></tr></table>
  698. <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>note</b></em></td></tr><tr><td>
  699. <p>IMPORTANT: The TT_HoriHeader and TT_VertHeader structures should be identical except for the names of their fields which are different.</p>
  700. <p>This ensures that a single function in the &lsquo;ttload&rsquo; module is able to read both the horizontal and vertical headers.</p>
  701. </td></tr></table>
  702. </td></tr></table>
  703. <hr width="75%">
  704. <table align=center width="75%"><tr><td><font size=-2>[<a href="ft2-index.html">Index</a>]</font></td>
  705. <td width="100%"></td>
  706. <td><font size=-2>[<a href="ft2-toc.html">TOC</a>]</font></td></tr></table>
  707.  
  708. <table align=center width="75%"><tr><td>
  709. <h4><a name="TT_OS2">TT_OS2</a></h4>
  710. <table align=center width="87%"><tr><td>
  711. Defined in FT_TRUETYPE_TABLES_H (freetype/tttables.h).
  712. </td></tr></table><br>
  713. <table align=center width="87%"><tr bgcolor="#D6E8FF"><td><pre>
  714.  
  715.   <span class="keyword">typedef</span> <span class="keyword">struct</span>  TT_OS2_
  716.   {
  717.     <a href="ft2-basic_types.html#FT_UShort">FT_UShort</a>  version;                /* 0x0001 - more or 0xFFFF */
  718.     <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   xAvgCharWidth;
  719.     <a href="ft2-basic_types.html#FT_UShort">FT_UShort</a>  usWeightClass;
  720.     <a href="ft2-basic_types.html#FT_UShort">FT_UShort</a>  usWidthClass;
  721.     <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   fsType;
  722.     <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   ySubscriptXSize;
  723.     <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   ySubscriptYSize;
  724.     <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   ySubscriptXOffset;
  725.     <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   ySubscriptYOffset;
  726.     <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   ySuperscriptXSize;
  727.     <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   ySuperscriptYSize;
  728.     <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   ySuperscriptXOffset;
  729.     <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   ySuperscriptYOffset;
  730.     <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   yStrikeoutSize;
  731.     <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   yStrikeoutPosition;
  732.     <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   sFamilyClass;
  733.  
  734.     <a href="ft2-basic_types.html#FT_Byte">FT_Byte</a>    panose[10];
  735.  
  736.     <a href="ft2-basic_types.html#FT_ULong">FT_ULong</a>   ulUnicodeRange1;        /* Bits 0-31   */
  737.     <a href="ft2-basic_types.html#FT_ULong">FT_ULong</a>   ulUnicodeRange2;        /* Bits 32-63  */
  738.     <a href="ft2-basic_types.html#FT_ULong">FT_ULong</a>   ulUnicodeRange3;        /* Bits 64-95  */
  739.     <a href="ft2-basic_types.html#FT_ULong">FT_ULong</a>   ulUnicodeRange4;        /* Bits 96-127 */
  740.  
  741.     <a href="ft2-basic_types.html#FT_Char">FT_Char</a>    achVendID[4];
  742.  
  743.     <a href="ft2-basic_types.html#FT_UShort">FT_UShort</a>  fsSelection;
  744.     <a href="ft2-basic_types.html#FT_UShort">FT_UShort</a>  usFirstCharIndex;
  745.     <a href="ft2-basic_types.html#FT_UShort">FT_UShort</a>  usLastCharIndex;
  746.     <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   sTypoAscender;
  747.     <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   sTypoDescender;
  748.     <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   sTypoLineGap;
  749.     <a href="ft2-basic_types.html#FT_UShort">FT_UShort</a>  usWinAscent;
  750.     <a href="ft2-basic_types.html#FT_UShort">FT_UShort</a>  usWinDescent;
  751.  
  752.     /* only version 1 tables: */
  753.  
  754.     <a href="ft2-basic_types.html#FT_ULong">FT_ULong</a>   ulCodePageRange1;       /* Bits 0-31   */
  755.     <a href="ft2-basic_types.html#FT_ULong">FT_ULong</a>   ulCodePageRange2;       /* Bits 32-63  */
  756.  
  757.     /* only version 2 tables: */
  758.  
  759.     <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   sxHeight;
  760.     <a href="ft2-basic_types.html#FT_Short">FT_Short</a>   sCapHeight;
  761.     <a href="ft2-basic_types.html#FT_UShort">FT_UShort</a>  usDefaultChar;
  762.     <a href="ft2-basic_types.html#FT_UShort">FT_UShort</a>  usBreakChar;
  763.     <a href="ft2-basic_types.html#FT_UShort">FT_UShort</a>  usMaxContext;
  764.  
  765.   } <b>TT_OS2</b>;
  766.  
  767. </pre></table><br>
  768. <table align=center width="87%"><tr><td>
  769. <p>A structure used to model a TrueType OS/2 table. This is the long table version. All fields comply to the TrueType specification.</p>
  770. <p>Note that we now support old Mac fonts which do not include an OS/2 table. In this case, the &lsquo;version&rsquo; field is always set to 0xFFFF.</p>
  771. </td></tr></table><br>
  772. </td></tr></table>
  773. <hr width="75%">
  774. <table align=center width="75%"><tr><td><font size=-2>[<a href="ft2-index.html">Index</a>]</font></td>
  775. <td width="100%"></td>
  776. <td><font size=-2>[<a href="ft2-toc.html">TOC</a>]</font></td></tr></table>
  777.  
  778. <table align=center width="75%"><tr><td>
  779. <h4><a name="TT_Postscript">TT_Postscript</a></h4>
  780. <table align=center width="87%"><tr><td>
  781. Defined in FT_TRUETYPE_TABLES_H (freetype/tttables.h).
  782. </td></tr></table><br>
  783. <table align=center width="87%"><tr bgcolor="#D6E8FF"><td><pre>
  784.  
  785.   <span class="keyword">typedef</span> <span class="keyword">struct</span>  TT_Postscript_
  786.   {
  787.     <a href="ft2-basic_types.html#FT_Fixed">FT_Fixed</a>  FormatType;
  788.     <a href="ft2-basic_types.html#FT_Fixed">FT_Fixed</a>  italicAngle;
  789.     <a href="ft2-basic_types.html#FT_Short">FT_Short</a>  underlinePosition;
  790.     <a href="ft2-basic_types.html#FT_Short">FT_Short</a>  underlineThickness;
  791.     <a href="ft2-basic_types.html#FT_ULong">FT_ULong</a>  isFixedPitch;
  792.     <a href="ft2-basic_types.html#FT_ULong">FT_ULong</a>  minMemType42;
  793.     <a href="ft2-basic_types.html#FT_ULong">FT_ULong</a>  maxMemType42;
  794.     <a href="ft2-basic_types.html#FT_ULong">FT_ULong</a>  minMemType1;
  795.     <a href="ft2-basic_types.html#FT_ULong">FT_ULong</a>  maxMemType1;
  796.  
  797.     /* Glyph names follow in the file, but we don't   */
  798.    /* load them by default.  See the ttpost.c file.  */
  799.  
  800.  } <b>TT_Postscript</b>;
  801.  
  802. </pre></table><br>
  803. <table align=center width="87%"><tr><td>
  804. <p>A structure used to model a TrueType PostScript table. All fields comply to the TrueType specification. This structure does not reference the PostScript glyph names, which can be nevertheless accessed with the &lsquo;ttpost&rsquo; module.</p>
  805. </td></tr></table><br>
  806. </td></tr></table>
  807. <hr width="75%">
  808. <table align=center width="75%"><tr><td><font size=-2>[<a href="ft2-index.html">Index</a>]</font></td>
  809. <td width="100%"></td>
  810. <td><font size=-2>[<a href="ft2-toc.html">TOC</a>]</font></td></tr></table>
  811.  
  812. <table align=center width="75%"><tr><td>
  813. <h4><a name="TT_PCLT">TT_PCLT</a></h4>
  814. <table align=center width="87%"><tr><td>
  815. Defined in FT_TRUETYPE_TABLES_H (freetype/tttables.h).
  816. </td></tr></table><br>
  817. <table align=center width="87%"><tr bgcolor="#D6E8FF"><td><pre>
  818.  
  819.  <span class="keyword">typedef</span> <span class="keyword">struct</span>  TT_PCLT_
  820.  {
  821.    <a href="ft2-basic_types.html#FT_Fixed">FT_Fixed</a>   Version;
  822.    <a href="ft2-basic_types.html#FT_ULong">FT_ULong</a>   FontNumber;
  823.    <a href="ft2-basic_types.html#FT_UShort">FT_UShort</a>  Pitch;
  824.    <a href="ft2-basic_types.html#FT_UShort">FT_UShort</a>  xHeight;
  825.    <a href="ft2-basic_types.html#FT_UShort">FT_UShort</a>  Style;
  826.    <a href="ft2-basic_types.html#FT_UShort">FT_UShort</a>  TypeFamily;
  827.    <a href="ft2-basic_types.html#FT_UShort">FT_UShort</a>  CapHeight;
  828.    <a href="ft2-basic_types.html#FT_UShort">FT_UShort</a>  SymbolSet;
  829.    <a href="ft2-basic_types.html#FT_Char">FT_Char</a>    TypeFace[16];
  830.    <a href="ft2-basic_types.html#FT_Char">FT_Char</a>    CharacterComplement[8];
  831.    <a href="ft2-basic_types.html#FT_Char">FT_Char</a>    FileName[6];
  832.    <a href="ft2-basic_types.html#FT_Char">FT_Char</a>    StrokeWeight;
  833.    <a href="ft2-basic_types.html#FT_Char">FT_Char</a>    WidthType;
  834.    <a href="ft2-basic_types.html#FT_Byte">FT_Byte</a>    SerifStyle;
  835.    <a href="ft2-basic_types.html#FT_Byte">FT_Byte</a>    Reserved;
  836.  
  837.  } <b>TT_PCLT</b>;
  838.  
  839. </pre></table><br>
  840. <table align=center width="87%"><tr><td>
  841. <p>A structure used to model a TrueType PCLT table. All fields comply to the TrueType specification.</p>
  842. </td></tr></table><br>
  843. </td></tr></table>
  844. <hr width="75%">
  845. <table align=center width="75%"><tr><td><font size=-2>[<a href="ft2-index.html">Index</a>]</font></td>
  846. <td width="100%"></td>
  847. <td><font size=-2>[<a href="ft2-toc.html">TOC</a>]</font></td></tr></table>
  848.  
  849. <table align=center width="75%"><tr><td>
  850. <h4><a name="TT_MaxProfile">TT_MaxProfile</a></h4>
  851. <table align=center width="87%"><tr><td>
  852. Defined in FT_TRUETYPE_TABLES_H (freetype/tttables.h).
  853. </td></tr></table><br>
  854. <table align=center width="87%"><tr bgcolor="#D6E8FF"><td><pre>
  855.  
  856.  <span class="keyword">typedef</span> <span class="keyword">struct</span>  TT_MaxProfile_
  857.  {
  858.    <a href="ft2-basic_types.html#FT_Fixed">FT_Fixed</a>   version;
  859.    <a href="ft2-basic_types.html#FT_UShort">FT_UShort</a>  numGlyphs;
  860.    <a href="ft2-basic_types.html#FT_UShort">FT_UShort</a>  maxPoints;
  861.    <a href="ft2-basic_types.html#FT_UShort">FT_UShort</a>  maxContours;
  862.    <a href="ft2-basic_types.html#FT_UShort">FT_UShort</a>  maxCompositePoints;
  863.    <a href="ft2-basic_types.html#FT_UShort">FT_UShort</a>  maxCompositeContours;
  864.    <a href="ft2-basic_types.html#FT_UShort">FT_UShort</a>  maxZones;
  865.    <a href="ft2-basic_types.html#FT_UShort">FT_UShort</a>  maxTwilightPoints;
  866.    <a href="ft2-basic_types.html#FT_UShort">FT_UShort</a>  maxStorage;
  867.    <a href="ft2-basic_types.html#FT_UShort">FT_UShort</a>  maxFunctionDefs;
  868.    <a href="ft2-basic_types.html#FT_UShort">FT_UShort</a>  maxInstructionDefs;
  869.    <a href="ft2-basic_types.html#FT_UShort">FT_UShort</a>  maxStackElements;
  870.    <a href="ft2-basic_types.html#FT_UShort">FT_UShort</a>  maxSizeOfInstructions;
  871.    <a href="ft2-basic_types.html#FT_UShort">FT_UShort</a>  maxComponentElements;
  872.    <a href="ft2-basic_types.html#FT_UShort">FT_UShort</a>  maxComponentDepth;
  873.  
  874.  } <b>TT_MaxProfile</b>;
  875.  
  876. </pre></table><br>
  877. <table align=center width="87%"><tr><td>
  878. <p>The maximum profile is a table containing many max values which can be used to pre-allocate arrays. This ensures that no memory allocation occurs during a glyph load.</p>
  879. </td></tr></table><br>
  880. <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>fields</b></em></td></tr><tr><td>
  881. <p></p>
  882. <table cellpadding=3 border=0>
  883. <tr valign=top><td><b>version</b></td><td>
  884. <p>The version number.</p>
  885. </td></tr>
  886. <tr valign=top><td><b>numGlyphs</b></td><td>
  887. <p>The number of glyphs in this TrueType font.</p>
  888. </td></tr>
  889. <tr valign=top><td><b>maxPoints</b></td><td>
  890. <p>The maximum number of points in a non-composite TrueType glyph. See also the structure element &lsquo;maxCompositePoints&rsquo;.</p>
  891. </td></tr>
  892. <tr valign=top><td><b>maxContours</b></td><td>
  893. <p>The maximum number of contours in a non-composite TrueType glyph. See also the structure element &lsquo;maxCompositeContours&rsquo;.</p>
  894. </td></tr>
  895. <tr valign=top><td><b>maxCompositePoints</b></td><td>
  896. <p>The maximum number of points in a composite TrueType glyph. See also the structure element &lsquo;maxPoints&rsquo;.</p>
  897. </td></tr>
  898. <tr valign=top><td><b>maxCompositeContours</b></td><td>
  899. <p>The maximum number of contours in a composite TrueType glyph. See also the structure element &lsquo;maxContours&rsquo;.</p>
  900. </td></tr>
  901. <tr valign=top><td><b>maxZones</b></td><td>
  902. <p>The maximum number of zones used for glyph hinting.</p>
  903. </td></tr>
  904. <tr valign=top><td><b>maxTwilightPoints</b></td><td>
  905. <p>The maximum number of points in the twilight zone used for glyph hinting.</p>
  906. </td></tr>
  907. <tr valign=top><td><b>maxStorage</b></td><td>
  908. <p>The maximum number of elements in the storage area used for glyph hinting.</p>
  909. </td></tr>
  910. <tr valign=top><td><b>maxFunctionDefs</b></td><td>
  911. <p>The maximum number of function definitions in the TrueType bytecode for this font.</p>
  912. </td></tr>
  913. <tr valign=top><td><b>maxInstructionDefs</b></td><td>
  914. <p>The maximum number of instruction definitions in the TrueType bytecode for this font.</p>
  915. </td></tr>
  916. <tr valign=top><td><b>maxStackElements</b></td><td>
  917. <p>The maximum number of stack elements used during bytecode interpretation.</p>
  918. </td></tr>
  919. <tr valign=top><td><b>maxSizeOfInstructions</b></td><td>
  920. <p>The maximum number of TrueType opcodes used for glyph hinting.</p>
  921. </td></tr>
  922. <tr valign=top><td><b>maxComponentElements</b></td><td>
  923. <p>The maximum number of simple (i.e., non- composite) glyphs in a composite glyph.</p>
  924. </td></tr>
  925. <tr valign=top><td><b>maxComponentDepth</b></td><td>
  926. <p>The maximum nesting depth of composite glyphs.</p>
  927. </td></tr>
  928. </table>
  929. </td></tr></table>
  930. <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>note</b></em></td></tr><tr><td>
  931. <p>This structure is only used during font loading.</p>
  932. </td></tr></table>
  933. </td></tr></table>
  934. <hr width="75%">
  935. <table align=center width="75%"><tr><td><font size=-2>[<a href="ft2-index.html">Index</a>]</font></td>
  936. <td width="100%"></td>
  937. <td><font size=-2>[<a href="ft2-toc.html">TOC</a>]</font></td></tr></table>
  938.  
  939. <table align=center width="75%"><tr><td>
  940. <h4><a name="FT_Sfnt_Tag">FT_Sfnt_Tag</a></h4>
  941. <table align=center width="87%"><tr><td>
  942. Defined in FT_TRUETYPE_TABLES_H (freetype/tttables.h).
  943. </td></tr></table><br>
  944. <table align=center width="87%"><tr bgcolor="#D6E8FF"><td><pre>
  945.  
  946.  <span class="keyword">typedef</span> <span class="keyword">enum</span>  FT_Sfnt_Tag_
  947.  {
  948.    ft_sfnt_head = 0,    /* <a href="ft2-truetype_tables.html#TT_Header">TT_Header</a>     */
  949.    ft_sfnt_maxp = 1,    /* <a href="ft2-truetype_tables.html#TT_MaxProfile">TT_MaxProfile</a> */
  950.    ft_sfnt_os2  = 2,    /* <a href="ft2-truetype_tables.html#TT_OS2">TT_OS2</a>        */
  951.    ft_sfnt_hhea = 3,    /* <a href="ft2-truetype_tables.html#TT_HoriHeader">TT_HoriHeader</a> */
  952.    ft_sfnt_vhea = 4,    /* <a href="ft2-truetype_tables.html#TT_VertHeader">TT_VertHeader</a> */
  953.    ft_sfnt_post = 5,    /* <a href="ft2-truetype_tables.html#TT_Postscript">TT_Postscript</a> */
  954.    ft_sfnt_pclt = 6,    /* <a href="ft2-truetype_tables.html#TT_PCLT">TT_PCLT</a>       */
  955.  
  956.    sfnt_max   /* internal end mark */
  957.  
  958.  } <b>FT_Sfnt_Tag</b>;
  959.  
  960. </pre></table><br>
  961. <table align=center width="87%"><tr><td>
  962. <p>An enumeration used to specify the index of an SFNT table. Used in the <a href="ft2-truetype_tables.html#FT_Get_Sfnt_Table">FT_Get_Sfnt_Table</a> API function.</p>
  963. </td></tr></table><br>
  964. </td></tr></table>
  965. <hr width="75%">
  966. <table align=center width="75%"><tr><td><font size=-2>[<a href="ft2-index.html">Index</a>]</font></td>
  967. <td width="100%"></td>
  968. <td><font size=-2>[<a href="ft2-toc.html">TOC</a>]</font></td></tr></table>
  969.  
  970. <table align=center width="75%"><tr><td>
  971. <h4><a name="FT_Get_Sfnt_Table">FT_Get_Sfnt_Table</a></h4>
  972. <table align=center width="87%"><tr><td>
  973. Defined in FT_TRUETYPE_TABLES_H (freetype/tttables.h).
  974. </td></tr></table><br>
  975. <table align=center width="87%"><tr bgcolor="#D6E8FF"><td><pre>
  976.  
  977.  FT_EXPORT( <span class="keyword">void</span>* )
  978.  <b>FT_Get_Sfnt_Table</b>( <a href="ft2-base_interface.html#FT_Face">FT_Face</a>      face,
  979.                     <a href="ft2-truetype_tables.html#FT_Sfnt_Tag">FT_Sfnt_Tag</a>  tag );
  980.  
  981. </pre></table><br>
  982. <table align=center width="87%"><tr><td>
  983. <p>Return a pointer to a given SFNT table within a face.</p>
  984. </td></tr></table><br>
  985. <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>input</b></em></td></tr><tr><td>
  986. <p></p>
  987. <table cellpadding=3 border=0>
  988. <tr valign=top><td><b>face</b></td><td>
  989. <p>A handle to the source.</p>
  990. </td></tr>
  991. <tr valign=top><td><b>tag</b></td><td>
  992. <p>The index of the SFNT table.</p>
  993. </td></tr>
  994. </table>
  995. </td></tr></table>
  996. <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>return</b></em></td></tr><tr><td>
  997. <p>A type-less pointer to the table. This will be&nbsp;0 in case of error, or if the corresponding table was not found <b>OR</b> loaded from the file.</p>
  998. <p>Use a typecast according to &lsquo;tag&rsquo; to access the structure elements.</p>
  999. </td></tr></table>
  1000. <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>note</b></em></td></tr><tr><td>
  1001. <p>The table is owned by the face object and disappears with it.</p>
  1002. <p>This function is only useful to access SFNT tables that are loaded by the sfnt, truetype, and opentype drivers. See <a href="ft2-truetype_tables.html#FT_Sfnt_Tag">FT_Sfnt_Tag</a> for a list.</p>
  1003. <p>Here an example how to access the &lsquo;vhea&rsquo; table:</p>
  1004. <pre class="colored">
  1005.  TT_VertHeader*  vert_header;                                    
  1006.                                                                  
  1007.                                                                  
  1008.  vert_header =                                                    
  1009.    (TT_VertHeader*)FT_Get_Sfnt_Table( face, ft_sfnt_vhea );      
  1010. </pre>
  1011. </td></tr></table>
  1012. </td></tr></table>
  1013. <hr width="75%">
  1014. <table align=center width="75%"><tr><td><font size=-2>[<a href="ft2-index.html">Index</a>]</font></td>
  1015. <td width="100%"></td>
  1016. <td><font size=-2>[<a href="ft2-toc.html">TOC</a>]</font></td></tr></table>
  1017.  
  1018. <table align=center width="75%"><tr><td>
  1019. <h4><a name="FT_Load_Sfnt_Table">FT_Load_Sfnt_Table</a></h4>
  1020. <table align=center width="87%"><tr><td>
  1021. Defined in FT_TRUETYPE_TABLES_H (freetype/tttables.h).
  1022. </td></tr></table><br>
  1023. <table align=center width="87%"><tr bgcolor="#D6E8FF"><td><pre>
  1024.  
  1025.  FT_EXPORT( <a href="ft2-basic_types.html#FT_Error">FT_Error</a> )
  1026.  <b>FT_Load_Sfnt_Table</b>( <a href="ft2-base_interface.html#FT_Face">FT_Face</a>    face,
  1027.                      <a href="ft2-basic_types.html#FT_ULong">FT_ULong</a>   tag,
  1028.                      <a href="ft2-basic_types.html#FT_Long">FT_Long</a>    offset,
  1029.                      <a href="ft2-basic_types.html#FT_Byte">FT_Byte</a>*   buffer,
  1030.                      <a href="ft2-basic_types.html#FT_ULong">FT_ULong</a>*  length );
  1031.  
  1032. </pre></table><br>
  1033. <table align=center width="87%"><tr><td>
  1034. <p>Load any font table into client memory.</p>
  1035. </td></tr></table><br>
  1036. <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>input</b></em></td></tr><tr><td>
  1037. <p></p>
  1038. <table cellpadding=3 border=0>
  1039. <tr valign=top><td><b>face</b></td><td>
  1040. <p>A handle to the source face.</p>
  1041. </td></tr>
  1042. <tr valign=top><td><b>tag</b></td><td>
  1043. <p>The four-byte tag of the table to load. Use the value&nbsp;0 if you want to access the whole font file. Otherwise, you can use one of the definitions found in the <a href="ft2-header_file_macros.html#FT_TRUETYPE_TAGS_H">FT_TRUETYPE_TAGS_H</a> file, or forge a new one with <a href="ft2-basic_types.html#FT_MAKE_TAG">FT_MAKE_TAG</a>.</p>
  1044. </td></tr>
  1045. <tr valign=top><td><b>offset</b></td><td>
  1046. <p>The starting offset in the table (or file if tag == 0).</p>
  1047. </td></tr>
  1048. </table>
  1049. </td></tr></table>
  1050. <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>output</b></em></td></tr><tr><td>
  1051. <p></p>
  1052. <table cellpadding=3 border=0>
  1053. <tr valign=top><td><b>buffer</b></td><td>
  1054. <p>The target buffer address. The client must ensure that the memory array is big enough to hold the data.</p>
  1055. </td></tr>
  1056. </table>
  1057. </td></tr></table>
  1058. <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>inout</b></em></td></tr><tr><td>
  1059. <p></p>
  1060. <table cellpadding=3 border=0>
  1061. <tr valign=top><td><b>length</b></td><td>
  1062. <p>If the &lsquo;length&rsquo; parameter is NULL, then try to load the whole table. Return an error code if it fails.</p>
  1063. <p>Else, if &lsquo;*length&rsquo; is&nbsp;0, exit immediately while returning the table's (or file) full size in it.</p>
  1064. <p>Else the number of bytes to read from the table or file, from the starting offset.</p>
  1065. </td></tr>
  1066. </table>
  1067. </td></tr></table>
  1068. <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>return</b></em></td></tr><tr><td>
  1069. <p>FreeType error code. 0&nbsp;means success.</p>
  1070. </td></tr></table>
  1071. <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>note</b></em></td></tr><tr><td>
  1072. <p>If you need to determine the table's length you should first call this function with &lsquo;*length&rsquo; set to&nbsp;0, as in the following example:</p>
  1073. <pre class="colored">
  1074.  FT_ULong  length = 0;
  1075.  
  1076.  
  1077.  error = FT_Load_Sfnt_Table( face, tag, 0, NULL, &amp;length );
  1078.  if ( error ) { ... table does not exist ... }
  1079.  
  1080.  buffer = malloc( length );
  1081.  if ( buffer == NULL ) { ... not enough memory ... }
  1082.  
  1083.  error = FT_Load_Sfnt_Table( face, tag, 0, buffer, &amp;length );
  1084.  if ( error ) { ... could not load table ... }
  1085. </pre>
  1086. </td></tr></table>
  1087. </td></tr></table>
  1088. <hr width="75%">
  1089. <table align=center width="75%"><tr><td><font size=-2>[<a href="ft2-index.html">Index</a>]</font></td>
  1090. <td width="100%"></td>
  1091. <td><font size=-2>[<a href="ft2-toc.html">TOC</a>]</font></td></tr></table>
  1092.  
  1093. <table align=center width="75%"><tr><td>
  1094. <h4><a name="FT_Sfnt_Table_Info">FT_Sfnt_Table_Info</a></h4>
  1095. <table align=center width="87%"><tr><td>
  1096. Defined in FT_TRUETYPE_TABLES_H (freetype/tttables.h).
  1097. </td></tr></table><br>
  1098. <table align=center width="87%"><tr bgcolor="#D6E8FF"><td><pre>
  1099.  
  1100.  FT_EXPORT( <a href="ft2-basic_types.html#FT_Error">FT_Error</a> )
  1101.  <b>FT_Sfnt_Table_Info</b>( <a href="ft2-base_interface.html#FT_Face">FT_Face</a>    face,
  1102.                      <a href="ft2-basic_types.html#FT_UInt">FT_UInt</a>    table_index,
  1103.                      <a href="ft2-basic_types.html#FT_ULong">FT_ULong</a>  *tag,
  1104.                      <a href="ft2-basic_types.html#FT_ULong">FT_ULong</a>  *length );
  1105.  
  1106. </pre></table><br>
  1107. <table align=center width="87%"><tr><td>
  1108. <p>Return information on an SFNT table.</p>
  1109. </td></tr></table><br>
  1110. <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>input</b></em></td></tr><tr><td>
  1111. <p></p>
  1112. <table cellpadding=3 border=0>
  1113. <tr valign=top><td><b>face</b></td><td>
  1114. <p>A handle to the source face.</p>
  1115. </td></tr>
  1116. <tr valign=top><td><b>table_index</b></td><td>
  1117. <p>The index of an SFNT table. The function returns FT_Err_Table_Missing for an invalid value.</p>
  1118. </td></tr>
  1119. </table>
  1120. </td></tr></table>
  1121. <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>inout</b></em></td></tr><tr><td>
  1122. <p></p>
  1123. <table cellpadding=3 border=0>
  1124. <tr valign=top><td><b>tag</b></td><td>
  1125. <p>The name tag of the SFNT table. If the value is NULL, &lsquo;table_index&rsquo; is ignored, and &lsquo;length&rsquo; returns the number of SFNT tables in the font.</p>
  1126. </td></tr>
  1127. </table>
  1128. </td></tr></table>
  1129. <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>output</b></em></td></tr><tr><td>
  1130. <p></p>
  1131. <table cellpadding=3 border=0>
  1132. <tr valign=top><td><b>length</b></td><td>
  1133. <p>The length of the SFNT table (or the number of SFNT tables, depending on &lsquo;tag&rsquo;).</p>
  1134. </td></tr>
  1135. </table>
  1136. </td></tr></table>
  1137. <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>return</b></em></td></tr><tr><td>
  1138. <p>FreeType error code. 0&nbsp;means success.</p>
  1139. </td></tr></table>
  1140. <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>note</b></em></td></tr><tr><td>
  1141. <p>While parsing fonts, FreeType handles SFNT tables with length zero as missing.</p>
  1142. </td></tr></table>
  1143. </td></tr></table>
  1144. <hr width="75%">
  1145. <table align=center width="75%"><tr><td><font size=-2>[<a href="ft2-index.html">Index</a>]</font></td>
  1146. <td width="100%"></td>
  1147. <td><font size=-2>[<a href="ft2-toc.html">TOC</a>]</font></td></tr></table>
  1148.  
  1149. <table align=center width="75%"><tr><td>
  1150. <h4><a name="FT_Get_CMap_Language_ID">FT_Get_CMap_Language_ID</a></h4>
  1151. <table align=center width="87%"><tr><td>
  1152. Defined in FT_TRUETYPE_TABLES_H (freetype/tttables.h).
  1153. </td></tr></table><br>
  1154. <table align=center width="87%"><tr bgcolor="#D6E8FF"><td><pre>
  1155.  
  1156.  FT_EXPORT( <a href="ft2-basic_types.html#FT_ULong">FT_ULong</a> )
  1157.  <b>FT_Get_CMap_Language_ID</b>( <a href="ft2-base_interface.html#FT_CharMap">FT_CharMap</a>  charmap );
  1158.  
  1159. </pre></table><br>
  1160. <table align=center width="87%"><tr><td>
  1161. <p>Return TrueType/sfnt specific cmap language ID. Definitions of language ID values are in &lsquo;freetype/ttnameid.h&rsquo;.</p>
  1162. </td></tr></table><br>
  1163. <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>input</b></em></td></tr><tr><td>
  1164. <p></p>
  1165. <table cellpadding=3 border=0>
  1166. <tr valign=top><td><b>charmap</b></td><td>
  1167. <p>The target charmap.</p>
  1168. </td></tr>
  1169. </table>
  1170. </td></tr></table>
  1171. <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>return</b></em></td></tr><tr><td>
  1172. <p>The language ID of &lsquo;charmap&rsquo;. If &lsquo;charmap&rsquo; doesn't belong to a TrueType/sfnt face, just return&nbsp;0 as the default value.</p>
  1173. <p>For a format&nbsp;14 cmap (to access Unicode IVS), the return value is 0xFFFFFFFF.</p>
  1174. </td></tr></table>
  1175. </td></tr></table>
  1176. <hr width="75%">
  1177. <table align=center width="75%"><tr><td><font size=-2>[<a href="ft2-index.html">Index</a>]</font></td>
  1178. <td width="100%"></td>
  1179. <td><font size=-2>[<a href="ft2-toc.html">TOC</a>]</font></td></tr></table>
  1180.  
  1181. <table align=center width="75%"><tr><td>
  1182. <h4><a name="FT_Get_CMap_Format">FT_Get_CMap_Format</a></h4>
  1183. <table align=center width="87%"><tr><td>
  1184. Defined in FT_TRUETYPE_TABLES_H (freetype/tttables.h).
  1185. </td></tr></table><br>
  1186. <table align=center width="87%"><tr bgcolor="#D6E8FF"><td><pre>
  1187.  
  1188.   FT_EXPORT( <a href="ft2-basic_types.html#FT_Long">FT_Long</a> )
  1189.   <b>FT_Get_CMap_Format</b>( <a href="ft2-base_interface.html#FT_CharMap">FT_CharMap</a>  charmap );
  1190.  
  1191. </pre></table><br>
  1192. <table align=center width="87%"><tr><td>
  1193. <p>Return TrueType/sfnt specific cmap format.</p>
  1194. </td></tr></table><br>
  1195. <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>input</b></em></td></tr><tr><td>
  1196. <p></p>
  1197. <table cellpadding=3 border=0>
  1198. <tr valign=top><td><b>charmap</b></td><td>
  1199. <p>The target charmap.</p>
  1200. </td></tr>
  1201. </table>
  1202. </td></tr></table>
  1203. <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>return</b></em></td></tr><tr><td>
  1204. <p>The format of &lsquo;charmap&rsquo;. If &lsquo;charmap&rsquo; doesn't belong to a TrueType/sfnt face, return -1.</p>
  1205. </td></tr></table>
  1206. </td></tr></table>
  1207. <hr width="75%">
  1208. <table align=center width="75%"><tr><td><font size=-2>[<a href="ft2-index.html">Index</a>]</font></td>
  1209. <td width="100%"></td>
  1210. <td><font size=-2>[<a href="ft2-toc.html">TOC</a>]</font></td></tr></table>
  1211.  
  1212. <table align=center width="75%"><tr><td>
  1213. <h4><a name="FT_PARAM_TAG_UNPATENTED_HINTING">FT_PARAM_TAG_UNPATENTED_HINTING</a></h4>
  1214. <table align=center width="87%"><tr><td>
  1215. Defined in FT_UNPATENTED_HINTING_H (freetype/ttunpat.h).
  1216. </td></tr></table><br>
  1217. <table align=center width="87%"><tr bgcolor="#D6E8FF"><td><pre>
  1218.  
  1219. #define <b>FT_PARAM_TAG_UNPATENTED_HINTING</b>  <a href="ft2-basic_types.html#FT_MAKE_TAG">FT_MAKE_TAG</a>( 'u', 'n', 'p', 'a' )
  1220.  
  1221. </pre></table><br>
  1222. <table align=center width="87%"><tr><td>
  1223. <p>A constant used as the tag of an <a href="ft2-base_interface.html#FT_Parameter">FT_Parameter</a> structure to indicate that unpatented methods only should be used by the TrueType bytecode interpreter for a typeface opened by <a href="ft2-base_interface.html#FT_Open_Face">FT_Open_Face</a>.</p>
  1224. </td></tr></table><br>
  1225. </td></tr></table>
  1226. <hr width="75%">
  1227. <table align=center width="75%"><tr><td><font size=-2>[<a href="ft2-index.html">Index</a>]</font></td>
  1228. <td width="100%"></td>
  1229. <td><font size=-2>[<a href="ft2-toc.html">TOC</a>]</font></td></tr></table>
  1230.  
  1231. </body>
  1232. </html>
  1233.