🛠️🐜 Antkeeper superbuild with dependencies included https://antkeeper.com
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

1463 lines
39 KiB

  1. <!doctype html>
  2. <html lang="en" class="no-js">
  3. <head>
  4. <meta charset="utf-8">
  5. <meta name="viewport" content="width=device-width,initial-scale=1">
  6. <meta name="description" content="API Reference Documentation for FreeType-2.11.0">
  7. <meta name="author" content="FreeType Contributors">
  8. <link rel="icon" href="images/favico.ico">
  9. <meta name="generator" content="mkdocs-1.2.1, mkdocs-material-7.1.9">
  10. <title>Window FNT Files - FreeType-2.11.0 API Reference</title>
  11. <link rel="stylesheet" href="assets/stylesheets/main.ca7ac06f.min.css">
  12. <link rel="stylesheet" href="assets/stylesheets/palette.f1a3b89f.min.css">
  13. <meta name="theme-color" content="#4cae4f">
  14. <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
  15. <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Noto+Serif:300,400,400i,700%7CRoboto+Mono&display=fallback">
  16. <style>:root{--md-text-font-family:"Noto Serif";--md-code-font-family:"Roboto Mono"}</style>
  17. <link rel="stylesheet" href="stylesheets/extra.css">
  18. </head>
  19. <body dir="ltr" data-md-color-scheme="" data-md-color-primary="green" data-md-color-accent="green">
  20. <script>function __prefix(e){return new URL(".",location).pathname+"."+e}function __get(e,t=localStorage){return JSON.parse(t.getItem(__prefix(e)))}</script>
  21. <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
  22. <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
  23. <label class="md-overlay" for="__drawer"></label>
  24. <div data-md-component="skip">
  25. <a href="#window-fnt-files" class="md-skip">
  26. Skip to content
  27. </a>
  28. </div>
  29. <div data-md-component="announce">
  30. </div>
  31. <header class="md-header" data-md-component="header">
  32. <nav class="md-header__inner md-grid" aria-label="Header">
  33. <a href="index.html" title="FreeType-2.11.0 API Reference" class="md-header__button md-logo" aria-label="FreeType-2.11.0 API Reference" data-md-component="logo">
  34. <img src="images/favico.ico" alt="logo">
  35. </a>
  36. <label class="md-header__button md-icon" for="__drawer">
  37. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2z"/></svg>
  38. </label>
  39. <div class="md-header__title" data-md-component="header-title">
  40. <div class="md-header__ellipsis">
  41. <div class="md-header__topic">
  42. <span class="md-ellipsis">
  43. FreeType-2.11.0 API Reference
  44. </span>
  45. </div>
  46. <div class="md-header__topic" data-md-component="header-topic">
  47. <span class="md-ellipsis">
  48. Window FNT Files
  49. </span>
  50. </div>
  51. </div>
  52. </div>
  53. <label class="md-header__button md-icon" for="__search">
  54. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5z"/></svg>
  55. </label>
  56. <div class="md-search" data-md-component="search" role="dialog">
  57. <label class="md-search__overlay" for="__search"></label>
  58. <div class="md-search__inner" role="search">
  59. <form class="md-search__form" name="search">
  60. <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" data-md-state="active" required>
  61. <label class="md-search__icon md-icon" for="__search">
  62. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5z"/></svg>
  63. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12z"/></svg>
  64. </label>
  65. <button type="reset" class="md-search__icon md-icon" aria-label="Clear" tabindex="-1">
  66. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41z"/></svg>
  67. </button>
  68. </form>
  69. <div class="md-search__output">
  70. <div class="md-search__scrollwrap" data-md-scrollfix>
  71. <div class="md-search-result" data-md-component="search-result">
  72. <div class="md-search-result__meta">
  73. Initializing search
  74. </div>
  75. <ol class="md-search-result__list"></ol>
  76. </div>
  77. </div>
  78. </div>
  79. </div>
  80. </div>
  81. </nav>
  82. </header>
  83. <div class="md-container" data-md-component="container">
  84. <main class="md-main" data-md-component="main">
  85. <div class="md-main__inner md-grid">
  86. <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
  87. <div class="md-sidebar__scrollwrap">
  88. <div class="md-sidebar__inner">
  89. <nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
  90. <label class="md-nav__title" for="__drawer">
  91. <a href="index.html" title="FreeType-2.11.0 API Reference" class="md-nav__button md-logo" aria-label="FreeType-2.11.0 API Reference" data-md-component="logo">
  92. <img src="images/favico.ico" alt="logo">
  93. </a>
  94. FreeType-2.11.0 API Reference
  95. </label>
  96. <ul class="md-nav__list" data-md-scrollfix>
  97. <li class="md-nav__item">
  98. <a href="index.html" class="md-nav__link">
  99. TOC
  100. </a>
  101. </li>
  102. <li class="md-nav__item">
  103. <a href="ft2-index.html" class="md-nav__link">
  104. Index
  105. </a>
  106. </li>
  107. <li class="md-nav__item md-nav__item--nested">
  108. <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_3" type="checkbox" id="__nav_3" >
  109. <label class="md-nav__link" for="__nav_3">
  110. General Remarks
  111. <span class="md-nav__icon md-icon"></span>
  112. </label>
  113. <nav class="md-nav" aria-label="General Remarks" data-md-level="1">
  114. <label class="md-nav__title" for="__nav_3">
  115. <span class="md-nav__icon md-icon"></span>
  116. General Remarks
  117. </label>
  118. <ul class="md-nav__list" data-md-scrollfix>
  119. <li class="md-nav__item">
  120. <a href="ft2-preamble.html" class="md-nav__link">
  121. Preamble
  122. </a>
  123. </li>
  124. <li class="md-nav__item">
  125. <a href="ft2-header_inclusion.html" class="md-nav__link">
  126. FreeType's header inclusion scheme
  127. </a>
  128. </li>
  129. <li class="md-nav__item">
  130. <a href="ft2-user_allocation.html" class="md-nav__link">
  131. User allocation
  132. </a>
  133. </li>
  134. </ul>
  135. </nav>
  136. </li>
  137. <li class="md-nav__item md-nav__item--nested">
  138. <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_4" type="checkbox" id="__nav_4" >
  139. <label class="md-nav__link" for="__nav_4">
  140. Core API
  141. <span class="md-nav__icon md-icon"></span>
  142. </label>
  143. <nav class="md-nav" aria-label="Core API" data-md-level="1">
  144. <label class="md-nav__title" for="__nav_4">
  145. <span class="md-nav__icon md-icon"></span>
  146. Core API
  147. </label>
  148. <ul class="md-nav__list" data-md-scrollfix>
  149. <li class="md-nav__item">
  150. <a href="ft2-version.html" class="md-nav__link">
  151. FreeType Version
  152. </a>
  153. </li>
  154. <li class="md-nav__item">
  155. <a href="ft2-basic_types.html" class="md-nav__link">
  156. Basic Data Types
  157. </a>
  158. </li>
  159. <li class="md-nav__item">
  160. <a href="ft2-base_interface.html" class="md-nav__link">
  161. Base Interface
  162. </a>
  163. </li>
  164. <li class="md-nav__item">
  165. <a href="ft2-glyph_variants.html" class="md-nav__link">
  166. Unicode Variation Sequences
  167. </a>
  168. </li>
  169. <li class="md-nav__item">
  170. <a href="ft2-color_management.html" class="md-nav__link">
  171. Glyph Color Management
  172. </a>
  173. </li>
  174. <li class="md-nav__item">
  175. <a href="ft2-layer_management.html" class="md-nav__link">
  176. Glyph Layer Management
  177. </a>
  178. </li>
  179. <li class="md-nav__item">
  180. <a href="ft2-glyph_management.html" class="md-nav__link">
  181. Glyph Management
  182. </a>
  183. </li>
  184. <li class="md-nav__item">
  185. <a href="ft2-mac_specific.html" class="md-nav__link">
  186. Mac Specific Interface
  187. </a>
  188. </li>
  189. <li class="md-nav__item">
  190. <a href="ft2-sizes_management.html" class="md-nav__link">
  191. Size Management
  192. </a>
  193. </li>
  194. <li class="md-nav__item">
  195. <a href="ft2-header_file_macros.html" class="md-nav__link">
  196. Header File Macros
  197. </a>
  198. </li>
  199. </ul>
  200. </nav>
  201. </li>
  202. <li class="md-nav__item md-nav__item--active md-nav__item--nested">
  203. <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_5" type="checkbox" id="__nav_5" checked>
  204. <label class="md-nav__link" for="__nav_5">
  205. Format-Specific API
  206. <span class="md-nav__icon md-icon"></span>
  207. </label>
  208. <nav class="md-nav" aria-label="Format-Specific API" data-md-level="1">
  209. <label class="md-nav__title" for="__nav_5">
  210. <span class="md-nav__icon md-icon"></span>
  211. Format-Specific API
  212. </label>
  213. <ul class="md-nav__list" data-md-scrollfix>
  214. <li class="md-nav__item">
  215. <a href="ft2-multiple_masters.html" class="md-nav__link">
  216. Multiple Masters
  217. </a>
  218. </li>
  219. <li class="md-nav__item">
  220. <a href="ft2-truetype_tables.html" class="md-nav__link">
  221. TrueType Tables
  222. </a>
  223. </li>
  224. <li class="md-nav__item">
  225. <a href="ft2-type1_tables.html" class="md-nav__link">
  226. Type 1 Tables
  227. </a>
  228. </li>
  229. <li class="md-nav__item">
  230. <a href="ft2-sfnt_names.html" class="md-nav__link">
  231. SFNT Names
  232. </a>
  233. </li>
  234. <li class="md-nav__item">
  235. <a href="ft2-bdf_fonts.html" class="md-nav__link">
  236. BDF and PCF Files
  237. </a>
  238. </li>
  239. <li class="md-nav__item">
  240. <a href="ft2-cid_fonts.html" class="md-nav__link">
  241. CID Fonts
  242. </a>
  243. </li>
  244. <li class="md-nav__item">
  245. <a href="ft2-pfr_fonts.html" class="md-nav__link">
  246. PFR Fonts
  247. </a>
  248. </li>
  249. <li class="md-nav__item md-nav__item--active">
  250. <input class="md-nav__toggle md-toggle" data-md-toggle="toc" type="checkbox" id="__toc">
  251. <label class="md-nav__link md-nav__link--active" for="__toc">
  252. Window FNT Files
  253. <span class="md-nav__icon md-icon"></span>
  254. </label>
  255. <a href="ft2-winfnt_fonts.html" class="md-nav__link md-nav__link--active">
  256. Window FNT Files
  257. </a>
  258. <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
  259. <label class="md-nav__title" for="__toc">
  260. <span class="md-nav__icon md-icon"></span>
  261. Table of contents
  262. </label>
  263. <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
  264. <li class="md-nav__item">
  265. <a href="#synopsis" class="md-nav__link">
  266. Synopsis
  267. </a>
  268. </li>
  269. <li class="md-nav__item">
  270. <a href="#ft_winfnt_id_xxx" class="md-nav__link">
  271. FT_WinFNT_ID_XXX
  272. </a>
  273. </li>
  274. <li class="md-nav__item">
  275. <a href="#ft_winfnt_headerrec" class="md-nav__link">
  276. FT_WinFNT_HeaderRec
  277. </a>
  278. </li>
  279. <li class="md-nav__item">
  280. <a href="#ft_winfnt_header" class="md-nav__link">
  281. FT_WinFNT_Header
  282. </a>
  283. </li>
  284. <li class="md-nav__item">
  285. <a href="#ft_get_winfnt_header" class="md-nav__link">
  286. FT_Get_WinFNT_Header
  287. </a>
  288. </li>
  289. </ul>
  290. </nav>
  291. </li>
  292. <li class="md-nav__item">
  293. <a href="ft2-font_formats.html" class="md-nav__link">
  294. Font Formats
  295. </a>
  296. </li>
  297. <li class="md-nav__item">
  298. <a href="ft2-gasp_table.html" class="md-nav__link">
  299. Gasp Table
  300. </a>
  301. </li>
  302. </ul>
  303. </nav>
  304. </li>
  305. <li class="md-nav__item md-nav__item--nested">
  306. <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_6" type="checkbox" id="__nav_6" >
  307. <label class="md-nav__link" for="__nav_6">
  308. Controlling FreeType Modules
  309. <span class="md-nav__icon md-icon"></span>
  310. </label>
  311. <nav class="md-nav" aria-label="Controlling FreeType Modules" data-md-level="1">
  312. <label class="md-nav__title" for="__nav_6">
  313. <span class="md-nav__icon md-icon"></span>
  314. Controlling FreeType Modules
  315. </label>
  316. <ul class="md-nav__list" data-md-scrollfix>
  317. <li class="md-nav__item">
  318. <a href="ft2-auto_hinter.html" class="md-nav__link">
  319. The auto-hinter
  320. </a>
  321. </li>
  322. <li class="md-nav__item">
  323. <a href="ft2-cff_driver.html" class="md-nav__link">
  324. The CFF driver
  325. </a>
  326. </li>
  327. <li class="md-nav__item">
  328. <a href="ft2-t1_cid_driver.html" class="md-nav__link">
  329. The Type 1 and CID drivers
  330. </a>
  331. </li>
  332. <li class="md-nav__item">
  333. <a href="ft2-tt_driver.html" class="md-nav__link">
  334. The TrueType driver
  335. </a>
  336. </li>
  337. <li class="md-nav__item">
  338. <a href="ft2-pcf_driver.html" class="md-nav__link">
  339. The PCF driver
  340. </a>
  341. </li>
  342. <li class="md-nav__item">
  343. <a href="ft2-properties.html" class="md-nav__link">
  344. Driver properties
  345. </a>
  346. </li>
  347. <li class="md-nav__item">
  348. <a href="ft2-parameter_tags.html" class="md-nav__link">
  349. Parameter Tags
  350. </a>
  351. </li>
  352. <li class="md-nav__item">
  353. <a href="ft2-lcd_rendering.html" class="md-nav__link">
  354. Subpixel Rendering
  355. </a>
  356. </li>
  357. </ul>
  358. </nav>
  359. </li>
  360. <li class="md-nav__item md-nav__item--nested">
  361. <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_7" type="checkbox" id="__nav_7" >
  362. <label class="md-nav__link" for="__nav_7">
  363. Cache Sub-System
  364. <span class="md-nav__icon md-icon"></span>
  365. </label>
  366. <nav class="md-nav" aria-label="Cache Sub-System" data-md-level="1">
  367. <label class="md-nav__title" for="__nav_7">
  368. <span class="md-nav__icon md-icon"></span>
  369. Cache Sub-System
  370. </label>
  371. <ul class="md-nav__list" data-md-scrollfix>
  372. <li class="md-nav__item">
  373. <a href="ft2-cache_subsystem.html" class="md-nav__link">
  374. Cache Sub-System
  375. </a>
  376. </li>
  377. </ul>
  378. </nav>
  379. </li>
  380. <li class="md-nav__item md-nav__item--nested">
  381. <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_8" type="checkbox" id="__nav_8" >
  382. <label class="md-nav__link" for="__nav_8">
  383. Support API
  384. <span class="md-nav__icon md-icon"></span>
  385. </label>
  386. <nav class="md-nav" aria-label="Support API" data-md-level="1">
  387. <label class="md-nav__title" for="__nav_8">
  388. <span class="md-nav__icon md-icon"></span>
  389. Support API
  390. </label>
  391. <ul class="md-nav__list" data-md-scrollfix>
  392. <li class="md-nav__item">
  393. <a href="ft2-computations.html" class="md-nav__link">
  394. Computations
  395. </a>
  396. </li>
  397. <li class="md-nav__item">
  398. <a href="ft2-list_processing.html" class="md-nav__link">
  399. List Processing
  400. </a>
  401. </li>
  402. <li class="md-nav__item">
  403. <a href="ft2-outline_processing.html" class="md-nav__link">
  404. Outline Processing
  405. </a>
  406. </li>
  407. <li class="md-nav__item">
  408. <a href="ft2-quick_advance.html" class="md-nav__link">
  409. Quick retrieval of advance values
  410. </a>
  411. </li>
  412. <li class="md-nav__item">
  413. <a href="ft2-bitmap_handling.html" class="md-nav__link">
  414. Bitmap Handling
  415. </a>
  416. </li>
  417. <li class="md-nav__item">
  418. <a href="ft2-raster.html" class="md-nav__link">
  419. Scanline Converter
  420. </a>
  421. </li>
  422. <li class="md-nav__item">
  423. <a href="ft2-glyph_stroker.html" class="md-nav__link">
  424. Glyph Stroker
  425. </a>
  426. </li>
  427. <li class="md-nav__item">
  428. <a href="ft2-system_interface.html" class="md-nav__link">
  429. System Interface
  430. </a>
  431. </li>
  432. <li class="md-nav__item">
  433. <a href="ft2-module_management.html" class="md-nav__link">
  434. Module Management
  435. </a>
  436. </li>
  437. <li class="md-nav__item">
  438. <a href="ft2-gzip.html" class="md-nav__link">
  439. GZIP Streams
  440. </a>
  441. </li>
  442. <li class="md-nav__item">
  443. <a href="ft2-lzw.html" class="md-nav__link">
  444. LZW Streams
  445. </a>
  446. </li>
  447. <li class="md-nav__item">
  448. <a href="ft2-bzip2.html" class="md-nav__link">
  449. BZIP2 Streams
  450. </a>
  451. </li>
  452. <li class="md-nav__item">
  453. <a href="ft2-debugging_apis.html" class="md-nav__link">
  454. External Debugging APIs
  455. </a>
  456. </li>
  457. </ul>
  458. </nav>
  459. </li>
  460. <li class="md-nav__item md-nav__item--nested">
  461. <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_9" type="checkbox" id="__nav_9" >
  462. <label class="md-nav__link" for="__nav_9">
  463. Error Codes
  464. <span class="md-nav__icon md-icon"></span>
  465. </label>
  466. <nav class="md-nav" aria-label="Error Codes" data-md-level="1">
  467. <label class="md-nav__title" for="__nav_9">
  468. <span class="md-nav__icon md-icon"></span>
  469. Error Codes
  470. </label>
  471. <ul class="md-nav__list" data-md-scrollfix>
  472. <li class="md-nav__item">
  473. <a href="ft2-error_enumerations.html" class="md-nav__link">
  474. Error Enumerations
  475. </a>
  476. </li>
  477. <li class="md-nav__item">
  478. <a href="ft2-error_code_values.html" class="md-nav__link">
  479. Error Code Values
  480. </a>
  481. </li>
  482. </ul>
  483. </nav>
  484. </li>
  485. <li class="md-nav__item md-nav__item--nested">
  486. <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_10" type="checkbox" id="__nav_10" >
  487. <label class="md-nav__link" for="__nav_10">
  488. Miscellaneous
  489. <span class="md-nav__icon md-icon"></span>
  490. </label>
  491. <nav class="md-nav" aria-label="Miscellaneous" data-md-level="1">
  492. <label class="md-nav__title" for="__nav_10">
  493. <span class="md-nav__icon md-icon"></span>
  494. Miscellaneous
  495. </label>
  496. <ul class="md-nav__list" data-md-scrollfix>
  497. <li class="md-nav__item">
  498. <a href="ft2-gx_validation.html" class="md-nav__link">
  499. TrueTypeGX/AAT Validation
  500. </a>
  501. </li>
  502. <li class="md-nav__item">
  503. <a href="ft2-incremental.html" class="md-nav__link">
  504. Incremental Loading
  505. </a>
  506. </li>
  507. <li class="md-nav__item">
  508. <a href="ft2-truetype_engine.html" class="md-nav__link">
  509. The TrueType Engine
  510. </a>
  511. </li>
  512. <li class="md-nav__item">
  513. <a href="ft2-ot_validation.html" class="md-nav__link">
  514. OpenType Validation
  515. </a>
  516. </li>
  517. </ul>
  518. </nav>
  519. </li>
  520. </ul>
  521. </nav>
  522. </div>
  523. </div>
  524. </div>
  525. <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
  526. <div class="md-sidebar__scrollwrap">
  527. <div class="md-sidebar__inner">
  528. <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
  529. <label class="md-nav__title" for="__toc">
  530. <span class="md-nav__icon md-icon"></span>
  531. Table of contents
  532. </label>
  533. <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
  534. <li class="md-nav__item">
  535. <a href="#synopsis" class="md-nav__link">
  536. Synopsis
  537. </a>
  538. </li>
  539. <li class="md-nav__item">
  540. <a href="#ft_winfnt_id_xxx" class="md-nav__link">
  541. FT_WinFNT_ID_XXX
  542. </a>
  543. </li>
  544. <li class="md-nav__item">
  545. <a href="#ft_winfnt_headerrec" class="md-nav__link">
  546. FT_WinFNT_HeaderRec
  547. </a>
  548. </li>
  549. <li class="md-nav__item">
  550. <a href="#ft_winfnt_header" class="md-nav__link">
  551. FT_WinFNT_Header
  552. </a>
  553. </li>
  554. <li class="md-nav__item">
  555. <a href="#ft_get_winfnt_header" class="md-nav__link">
  556. FT_Get_WinFNT_Header
  557. </a>
  558. </li>
  559. </ul>
  560. </nav>
  561. </div>
  562. </div>
  563. </div>
  564. <div class="md-content" data-md-component="content">
  565. <article class="md-content__inner md-typeset">
  566. <p><a href="https://www.freetype.org">FreeType</a> &raquo; <a href="../">Docs</a> &raquo; <a href="index.html#format-specific-api">Format-Specific API</a> &raquo; Window FNT Files</p>
  567. <hr />
  568. <h1 id="window-fnt-files">Window FNT Files<a class="headerlink" href="#window-fnt-files" title="Permanent link">&para;</a></h1>
  569. <h2 id="synopsis">Synopsis<a class="headerlink" href="#synopsis" title="Permanent link">&para;</a></h2>
  570. <p>This section contains the declaration of Windows FNT-specific functions.</p>
  571. <h2 id="ft_winfnt_id_xxx">FT_WinFNT_ID_XXX<a class="headerlink" href="#ft_winfnt_id_xxx" title="Permanent link">&para;</a></h2>
  572. <p>Defined in FT_WINFONTS_H (freetype/ftwinfnt.h).</p>
  573. <div class = "codehilite"><pre><code>#<span class="keyword">define</span> <a href="ft2-winfnt_fonts.html#ft_winfnt_id_cp1252">FT_WinFNT_ID_CP1252</a> 0
  574. #<span class="keyword">define</span> <a href="ft2-winfnt_fonts.html#ft_winfnt_id_default">FT_WinFNT_ID_DEFAULT</a> 1
  575. #<span class="keyword">define</span> <a href="ft2-winfnt_fonts.html#ft_winfnt_id_symbol">FT_WinFNT_ID_SYMBOL</a> 2
  576. #<span class="keyword">define</span> <a href="ft2-winfnt_fonts.html#ft_winfnt_id_mac">FT_WinFNT_ID_MAC</a> 77
  577. #<span class="keyword">define</span> <a href="ft2-winfnt_fonts.html#ft_winfnt_id_cp932">FT_WinFNT_ID_CP932</a> 128
  578. #<span class="keyword">define</span> <a href="ft2-winfnt_fonts.html#ft_winfnt_id_cp949">FT_WinFNT_ID_CP949</a> 129
  579. #<span class="keyword">define</span> <a href="ft2-winfnt_fonts.html#ft_winfnt_id_cp1361">FT_WinFNT_ID_CP1361</a> 130
  580. #<span class="keyword">define</span> <a href="ft2-winfnt_fonts.html#ft_winfnt_id_cp936">FT_WinFNT_ID_CP936</a> 134
  581. #<span class="keyword">define</span> <a href="ft2-winfnt_fonts.html#ft_winfnt_id_cp950">FT_WinFNT_ID_CP950</a> 136
  582. #<span class="keyword">define</span> <a href="ft2-winfnt_fonts.html#ft_winfnt_id_cp1253">FT_WinFNT_ID_CP1253</a> 161
  583. #<span class="keyword">define</span> <a href="ft2-winfnt_fonts.html#ft_winfnt_id_cp1254">FT_WinFNT_ID_CP1254</a> 162
  584. #<span class="keyword">define</span> <a href="ft2-winfnt_fonts.html#ft_winfnt_id_cp1258">FT_WinFNT_ID_CP1258</a> 163
  585. #<span class="keyword">define</span> <a href="ft2-winfnt_fonts.html#ft_winfnt_id_cp1255">FT_WinFNT_ID_CP1255</a> 177
  586. #<span class="keyword">define</span> <a href="ft2-winfnt_fonts.html#ft_winfnt_id_cp1256">FT_WinFNT_ID_CP1256</a> 178
  587. #<span class="keyword">define</span> <a href="ft2-winfnt_fonts.html#ft_winfnt_id_cp1257">FT_WinFNT_ID_CP1257</a> 186
  588. #<span class="keyword">define</span> <a href="ft2-winfnt_fonts.html#ft_winfnt_id_cp1251">FT_WinFNT_ID_CP1251</a> 204
  589. #<span class="keyword">define</span> <a href="ft2-winfnt_fonts.html#ft_winfnt_id_cp874">FT_WinFNT_ID_CP874</a> 222
  590. #<span class="keyword">define</span> <a href="ft2-winfnt_fonts.html#ft_winfnt_id_cp1250">FT_WinFNT_ID_CP1250</a> 238
  591. #<span class="keyword">define</span> <a href="ft2-winfnt_fonts.html#ft_winfnt_id_oem">FT_WinFNT_ID_OEM</a> 255
  592. </code></pre></div>
  593. <p>A list of valid values for the <code>charset</code> byte in <code><a href="ft2-winfnt_fonts.html#ft_winfnt_headerrec">FT_WinFNT_HeaderRec</a></code>. Exact mapping tables for the various &lsquo;cpXXXX&rsquo; encodings (except for &lsquo;cp1361&rsquo;) can be found at &lsquo;<a href="ftp://ftp.unicode.org/Public/">ftp://ftp.unicode.org/Public/</a>&rsquo; in the <code>MAPPINGS/VENDORS/MICSFT/WINDOWS</code> subdirectory. &lsquo;cp1361&rsquo; is roughly a superset of <code>MAPPINGS/OBSOLETE/EASTASIA/KSC/JOHAB.TXT</code>.</p>
  594. <h4>values</h4>
  595. <table class="fields">
  596. <tr><td class="val" id="ft_winfnt_id_default">FT_WinFNT_ID_DEFAULT</td><td class="desc">
  597. <p>This is used for font enumeration and font creation as a &lsquo;don't care&rsquo; value. Valid font files don't contain this value. When querying for information about the character set of the font that is currently selected into a specified device context, this return value (of the related Windows API) simply denotes failure.</p>
  598. </td></tr>
  599. <tr><td class="val" id="ft_winfnt_id_symbol">FT_WinFNT_ID_SYMBOL</td><td class="desc">
  600. <p>There is no known mapping table available.</p>
  601. </td></tr>
  602. <tr><td class="val" id="ft_winfnt_id_mac">FT_WinFNT_ID_MAC</td><td class="desc">
  603. <p>Mac Roman encoding.</p>
  604. </td></tr>
  605. <tr><td class="val" id="ft_winfnt_id_oem">FT_WinFNT_ID_OEM</td><td class="desc">
  606. <p>From Michael Poettgen &lt;michael@poettgen.de&gt;:</p>
  607. <p>The &lsquo;Windows Font Mapping&rsquo; article says that <code>FT_WinFNT_ID_OEM</code> is used for the charset of vector fonts, like <code>modern.fon</code>, <code>roman.fon</code>, and <code>script.fon</code> on Windows.</p>
  608. <p>The &lsquo;CreateFont&rsquo; documentation says: The <code>FT_WinFNT_ID_OEM</code> value specifies a character set that is operating-system dependent.</p>
  609. <p>The &lsquo;IFIMETRICS&rsquo; documentation from the &lsquo;Windows Driver Development Kit&rsquo; says: This font supports an OEM-specific character set. The OEM character set is system dependent.</p>
  610. <p>In general OEM, as opposed to ANSI (i.e., &lsquo;cp1252&rsquo;), denotes the second default codepage that most international versions of Windows have. It is one of the OEM codepages from</p>
  611. <p><a href="https://docs.microsoft.com/en-us/windows/desktop/intl/code-page-identifiers">https://docs.microsoft.com/en-us/windows/desktop/intl/code-page-identifiers</a> ,</p>
  612. <p>and is used for the &lsquo;DOS boxes&rsquo;, to support legacy applications. A German Windows version for example usually uses ANSI codepage 1252 and OEM codepage 850.</p>
  613. </td></tr>
  614. <tr><td class="val" id="ft_winfnt_id_cp874">FT_WinFNT_ID_CP874</td><td class="desc">
  615. <p>A superset of Thai TIS 620 and ISO 8859-11.</p>
  616. </td></tr>
  617. <tr><td class="val" id="ft_winfnt_id_cp932">FT_WinFNT_ID_CP932</td><td class="desc">
  618. <p>A superset of Japanese Shift-JIS (with minor deviations).</p>
  619. </td></tr>
  620. <tr><td class="val" id="ft_winfnt_id_cp936">FT_WinFNT_ID_CP936</td><td class="desc">
  621. <p>A superset of simplified Chinese GB 2312-1980 (with different ordering and minor deviations).</p>
  622. </td></tr>
  623. <tr><td class="val" id="ft_winfnt_id_cp949">FT_WinFNT_ID_CP949</td><td class="desc">
  624. <p>A superset of Korean Hangul KS&nbsp;C 5601-1987 (with different ordering and minor deviations).</p>
  625. </td></tr>
  626. <tr><td class="val" id="ft_winfnt_id_cp950">FT_WinFNT_ID_CP950</td><td class="desc">
  627. <p>A superset of traditional Chinese Big&nbsp;5 ETen (with different ordering and minor deviations).</p>
  628. </td></tr>
  629. <tr><td class="val" id="ft_winfnt_id_cp1250">FT_WinFNT_ID_CP1250</td><td class="desc">
  630. <p>A superset of East European ISO 8859-2 (with slightly different ordering).</p>
  631. </td></tr>
  632. <tr><td class="val" id="ft_winfnt_id_cp1251">FT_WinFNT_ID_CP1251</td><td class="desc">
  633. <p>A superset of Russian ISO 8859-5 (with different ordering).</p>
  634. </td></tr>
  635. <tr><td class="val" id="ft_winfnt_id_cp1252">FT_WinFNT_ID_CP1252</td><td class="desc">
  636. <p>ANSI encoding. A superset of ISO 8859-1.</p>
  637. </td></tr>
  638. <tr><td class="val" id="ft_winfnt_id_cp1253">FT_WinFNT_ID_CP1253</td><td class="desc">
  639. <p>A superset of Greek ISO 8859-7 (with minor modifications).</p>
  640. </td></tr>
  641. <tr><td class="val" id="ft_winfnt_id_cp1254">FT_WinFNT_ID_CP1254</td><td class="desc">
  642. <p>A superset of Turkish ISO 8859-9.</p>
  643. </td></tr>
  644. <tr><td class="val" id="ft_winfnt_id_cp1255">FT_WinFNT_ID_CP1255</td><td class="desc">
  645. <p>A superset of Hebrew ISO 8859-8 (with some modifications).</p>
  646. </td></tr>
  647. <tr><td class="val" id="ft_winfnt_id_cp1256">FT_WinFNT_ID_CP1256</td><td class="desc">
  648. <p>A superset of Arabic ISO 8859-6 (with different ordering).</p>
  649. </td></tr>
  650. <tr><td class="val" id="ft_winfnt_id_cp1257">FT_WinFNT_ID_CP1257</td><td class="desc">
  651. <p>A superset of Baltic ISO 8859-13 (with some deviations).</p>
  652. </td></tr>
  653. <tr><td class="val" id="ft_winfnt_id_cp1258">FT_WinFNT_ID_CP1258</td><td class="desc">
  654. <p>For Vietnamese. This encoding doesn't cover all necessary characters.</p>
  655. </td></tr>
  656. <tr><td class="val" id="ft_winfnt_id_cp1361">FT_WinFNT_ID_CP1361</td><td class="desc">
  657. <p>Korean (Johab).</p>
  658. </td></tr>
  659. </table>
  660. <hr>
  661. <h2 id="ft_winfnt_headerrec">FT_WinFNT_HeaderRec<a class="headerlink" href="#ft_winfnt_headerrec" title="Permanent link">&para;</a></h2>
  662. <p>Defined in FT_WINFONTS_H (freetype/ftwinfnt.h).</p>
  663. <div class = "codehilite"><pre><code> <span class="keyword">typedef</span> <span class="keyword">struct</span> FT_WinFNT_HeaderRec_
  664. {
  665. <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a> version;
  666. <a href="ft2-basic_types.html#ft_ulong">FT_ULong</a> file_size;
  667. <a href="ft2-basic_types.html#ft_byte">FT_Byte</a> copyright[60];
  668. <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a> file_type;
  669. <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a> nominal_point_size;
  670. <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a> vertical_resolution;
  671. <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a> horizontal_resolution;
  672. <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a> ascent;
  673. <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a> internal_leading;
  674. <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a> external_leading;
  675. <a href="ft2-basic_types.html#ft_byte">FT_Byte</a> italic;
  676. <a href="ft2-basic_types.html#ft_byte">FT_Byte</a> underline;
  677. <a href="ft2-basic_types.html#ft_byte">FT_Byte</a> strike_out;
  678. <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a> weight;
  679. <a href="ft2-basic_types.html#ft_byte">FT_Byte</a> charset;
  680. <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a> pixel_width;
  681. <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a> pixel_height;
  682. <a href="ft2-basic_types.html#ft_byte">FT_Byte</a> pitch_and_family;
  683. <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a> avg_width;
  684. <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a> max_width;
  685. <a href="ft2-basic_types.html#ft_byte">FT_Byte</a> first_char;
  686. <a href="ft2-basic_types.html#ft_byte">FT_Byte</a> last_char;
  687. <a href="ft2-basic_types.html#ft_byte">FT_Byte</a> default_char;
  688. <a href="ft2-basic_types.html#ft_byte">FT_Byte</a> break_char;
  689. <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a> bytes_per_row;
  690. <a href="ft2-basic_types.html#ft_ulong">FT_ULong</a> device_offset;
  691. <a href="ft2-basic_types.html#ft_ulong">FT_ULong</a> face_name_offset;
  692. <a href="ft2-basic_types.html#ft_ulong">FT_ULong</a> bits_pointer;
  693. <a href="ft2-basic_types.html#ft_ulong">FT_ULong</a> bits_offset;
  694. <a href="ft2-basic_types.html#ft_byte">FT_Byte</a> reserved;
  695. <a href="ft2-basic_types.html#ft_ulong">FT_ULong</a> flags;
  696. <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a> A_space;
  697. <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a> B_space;
  698. <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a> C_space;
  699. <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a> color_table_offset;
  700. <a href="ft2-basic_types.html#ft_ulong">FT_ULong</a> reserved1[4];
  701. } <b>FT_WinFNT_HeaderRec</b>;
  702. </code></pre></div>
  703. <p>Windows FNT Header info.</p>
  704. <hr>
  705. <h2 id="ft_winfnt_header">FT_WinFNT_Header<a class="headerlink" href="#ft_winfnt_header" title="Permanent link">&para;</a></h2>
  706. <p>Defined in FT_WINFONTS_H (freetype/ftwinfnt.h).</p>
  707. <div class = "codehilite"><pre><code> <span class="keyword">typedef</span> <span class="keyword">struct</span> FT_WinFNT_HeaderRec_* <b>FT_WinFNT_Header</b>;
  708. </code></pre></div>
  709. <p>A handle to an <code><a href="ft2-winfnt_fonts.html#ft_winfnt_headerrec">FT_WinFNT_HeaderRec</a></code> structure.</p>
  710. <hr>
  711. <h2 id="ft_get_winfnt_header">FT_Get_WinFNT_Header<a class="headerlink" href="#ft_get_winfnt_header" title="Permanent link">&para;</a></h2>
  712. <p>Defined in FT_WINFONTS_H (freetype/ftwinfnt.h).</p>
  713. <div class = "codehilite"><pre><code> FT_EXPORT( <a href="ft2-basic_types.html#ft_error">FT_Error</a> )
  714. <b>FT_Get_WinFNT_Header</b>( <a href="ft2-base_interface.html#ft_face">FT_Face</a> face,
  715. <a href="ft2-winfnt_fonts.html#ft_winfnt_headerrec">FT_WinFNT_HeaderRec</a> *aheader );
  716. </code></pre></div>
  717. <p>Retrieve a Windows FNT font info header.</p>
  718. <h4>input</h4>
  719. <table class="fields">
  720. <tr><td class="val" id="face">face</td><td class="desc">
  721. <p>A handle to the input face.</p>
  722. </td></tr>
  723. </table>
  724. <h4>output</h4>
  725. <table class="fields">
  726. <tr><td class="val" id="aheader">aheader</td><td class="desc">
  727. <p>The WinFNT header.</p>
  728. </td></tr>
  729. </table>
  730. <h4>return</h4>
  731. <p>FreeType error code. 0&nbsp;means success.</p>
  732. <h4>note</h4>
  733. <p>This function only works with Windows FNT faces, returning an error otherwise.</p>
  734. <hr>
  735. </article>
  736. </div>
  737. </div>
  738. </main>
  739. <footer class="md-footer">
  740. <nav class="md-footer__inner md-grid" aria-label="Footer">
  741. <a href="ft2-pfr_fonts.html" class="md-footer__link md-footer__link--prev" aria-label="Previous: PFR Fonts" rel="prev">
  742. <div class="md-footer__button md-icon">
  743. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12z"/></svg>
  744. </div>
  745. <div class="md-footer__title">
  746. <div class="md-ellipsis">
  747. <span class="md-footer__direction">
  748. Previous
  749. </span>
  750. PFR Fonts
  751. </div>
  752. </div>
  753. </a>
  754. <a href="ft2-font_formats.html" class="md-footer__link md-footer__link--next" aria-label="Next: Font Formats" rel="next">
  755. <div class="md-footer__title">
  756. <div class="md-ellipsis">
  757. <span class="md-footer__direction">
  758. Next
  759. </span>
  760. Font Formats
  761. </div>
  762. </div>
  763. <div class="md-footer__button md-icon">
  764. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11H4z"/></svg>
  765. </div>
  766. </a>
  767. </nav>
  768. <div class="md-footer-meta md-typeset">
  769. <div class="md-footer-meta__inner md-grid">
  770. <div class="md-footer-copyright">
  771. <div class="md-footer-copyright__highlight">
  772. Copyright 2021 <a href = "https://www.freetype.org/license.html">The FreeType Project</a>.
  773. </div>
  774. Made with
  775. <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
  776. Material for MkDocs
  777. </a>
  778. </div>
  779. </div>
  780. </div>
  781. </footer>
  782. </div>
  783. <div class="md-dialog" data-md-component="dialog">
  784. <div class="md-dialog__inner md-typeset"></div>
  785. </div>
  786. <script id="__config" type="application/json">{"base": ".", "features": [], "translations": {"clipboard.copy": "Copy to clipboard", "clipboard.copied": "Copied to clipboard", "search.config.lang": "en", "search.config.pipeline": "trimmer, stopWordFilter", "search.config.separator": "[\\s\\-]+", "search.placeholder": "Search", "search.result.placeholder": "Type to start searching", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.term.missing": "Missing", "select.version.title": "Select version"}, "search": "assets/javascripts/workers/search.477d984a.min.js", "version": null}</script>
  787. <script src="assets/javascripts/bundle.82b56eb2.min.js"></script>
  788. <script src="javascripts/extra.js"></script>
  789. </body>
  790. </html>