-
-
-
<!doctype html>
<html lang="en" class="no-js">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
- <meta http-equiv="x-ua-compatible" content="ie=edge">
- <meta name="description" content="API Reference Documentation for FreeType-2.10.4">
+ <meta name="description" content="API Reference Documentation for FreeType-2.13.2">
<meta name="author" content="FreeType Contributors">
- <meta name="lang:clipboard.copy" content="Copy to clipboard">
-
- <meta name="lang:clipboard.copied" content="Copied to clipboard">
-
- <meta name="lang:search.language" content="en">
-
- <meta name="lang:search.pipeline.stopwords" content="True">
-
- <meta name="lang:search.pipeline.trimmer" content="True">
-
- <meta name="lang:search.result.none" content="No matching documents">
-
- <meta name="lang:search.result.one" content="1 matching document">
-
- <meta name="lang:search.result.other" content="# matching documents">
-
- <meta name="lang:search.tokenizer" content="[\s\-]+">
-
- <link rel="shortcut icon" href="images/favico.ico">
- <meta name="generator" content="mkdocs-1.1, mkdocs-material-4.6.3">
+ <link rel="icon" href="images/favico.ico">
+ <meta name="generator" content="mkdocs-1.4.3, mkdocs-material-7.1.9">
- <title>Basic Data Types - FreeType-2.10.4 API Reference</title>
+ <title>Basic Data Types - FreeType-2.13.2 API Reference</title>
- <link rel="stylesheet" href="assets/stylesheets/application.adb8469c.css">
-
- <link rel="stylesheet" href="assets/stylesheets/application-palette.a8b3c06d.css">
-
+ <link rel="stylesheet" href="assets/stylesheets/main.ca7ac06f.min.css">
+ <link rel="stylesheet" href="assets/stylesheets/palette.f1a3b89f.min.css">
+
+
+
+ <meta name="theme-color" content="#4cae4f">
- <meta name="theme-color" content="#4caf50">
- <script src="assets/javascripts/modernizr.86422ebf.js"></script>
-
- <link href="https://fonts.gstatic.com" rel="preconnect" crossorigin>
+
+ <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Noto+Serif:300,400,400i,700%7CRoboto+Mono&display=fallback">
- <style>body,input{font-family:"Noto Serif","Helvetica Neue",Helvetica,Arial,sans-serif}code,kbd,pre{font-family:"Roboto Mono","Courier New",Courier,monospace}</style>
+ <style>:root{--md-text-font-family:"Noto Serif";--md-code-font-family:"Roboto Mono"}</style>
- <link rel="stylesheet" href="assets/fonts/material-icons.css">
<link rel="stylesheet" href="stylesheets/extra.css">
+
+
</head>
+
+
+
- <body dir="ltr" data-md-color-primary="green" data-md-color-accent="green">
+
+ <body dir="ltr" data-md-color-scheme="" data-md-color-primary="green" data-md-color-accent="green">
- <svg class="md-svg">
- <defs>
-
-
- </defs>
- </svg>
- <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
- <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
- <label class="md-overlay" data-md-component="overlay" for="__drawer"></label>
- <a href="#basic-data-types" tabindex="0" class="md-skip">
- Skip to content
- </a>
+ <script>function __prefix(e){return new URL(".",location).pathname+"."+e}function __get(e,t=localStorage){return JSON.parse(t.getItem(__prefix(e)))}</script>
+ <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
+ <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
+ <label class="md-overlay" for="__drawer"></label>
+ <div data-md-component="skip">
+
+
+ <a href="#basic-data-types" class="md-skip">
+ Skip to content
+ </a>
+
+ </div>
+ <div data-md-component="announce">
+
+ </div>
<header class="md-header" data-md-component="header">
- <nav class="md-header-nav md-grid">
- <div class="md-flex">
- <div class="md-flex__cell md-flex__cell--shrink">
- <a href="." title="FreeType-2.10.4 API Reference" aria-label="FreeType-2.10.4 API Reference" class="md-header-nav__button md-logo">
-
- <img alt="logo" src="images/favico.ico" width="24" height="24">
-
- </a>
- </div>
- <div class="md-flex__cell md-flex__cell--shrink">
- <label class="md-icon md-icon--menu md-header-nav__button" for="__drawer"></label>
- </div>
- <div class="md-flex__cell md-flex__cell--stretch">
- <div class="md-flex__ellipsis md-header-nav__title" data-md-component="title">
-
- <span class="md-header-nav__topic">
- FreeType-2.10.4 API Reference
- </span>
- <span class="md-header-nav__topic">
-
- Basic Data Types
-
- </span>
-
+ <nav class="md-header__inner md-grid" aria-label="Header">
+ <a href="index.html" title="FreeType-2.13.2 API Reference" class="md-header__button md-logo" aria-label="FreeType-2.13.2 API Reference" data-md-component="logo">
+
+ <img src="images/favico.ico" alt="logo">
+
+ </a>
+ <label class="md-header__button md-icon" for="__drawer">
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2z"/></svg>
+ </label>
+ <div class="md-header__title" data-md-component="header-title">
+ <div class="md-header__ellipsis">
+ <div class="md-header__topic">
+ <span class="md-ellipsis">
+ FreeType-2.13.2 API Reference
+ </span>
+ </div>
+ <div class="md-header__topic" data-md-component="header-topic">
+ <span class="md-ellipsis">
+
+ Basic Data Types
+
+ </span>
</div>
</div>
- <div class="md-flex__cell md-flex__cell--shrink">
-
- <label class="md-icon md-icon--search md-header-nav__button" for="__search"></label>
-
+ </div>
+
+
+
+ <label class="md-header__button md-icon" for="__search">
+ <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>
+ </label>
+
<div class="md-search" data-md-component="search" role="dialog">
<label class="md-search__overlay" for="__search"></label>
<div class="md-search__inner" role="search">
<form class="md-search__form" name="search">
- <input type="text" class="md-search__input" aria-label="search" name="query" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="query" data-md-state="active">
- <label class="md-icon md-search__icon" for="__search"></label>
- <button type="reset" class="md-icon md-search__icon" data-md-component="reset" tabindex="-1">
- 
+ <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>
+ <label class="md-search__icon md-icon" for="__search">
+ <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>
+ <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>
+ </label>
+ <button type="reset" class="md-search__icon md-icon" aria-label="Clear" tabindex="-1">
+ <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>
</button>
</form>
<div class="md-search__output">
<div class="md-search__scrollwrap" data-md-scrollfix>
- <div class="md-search-result" data-md-component="result">
+ <div class="md-search-result" data-md-component="search-result">
<div class="md-search-result__meta">
- Type to start searching
+ Initializing search
</div>
<ol class="md-search-result__list"></ol>
</div>
</div>
</div>
</div>
-
- </div>
-
- </div>
+
+
</nav>
</header>
- <div class="md-container">
+ <div class="md-container" data-md-component="container">
-
+
- <main class="md-main" role="main">
- <div class="md-main__inner md-grid" data-md-component="container">
+ <main class="md-main" data-md-component="main">
+ <div class="md-main__inner md-grid">
- <div class="md-sidebar md-sidebar--primary" data-md-component="navigation">
+
+ <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
<div class="md-sidebar__scrollwrap">
<div class="md-sidebar__inner">
- <nav class="md-nav md-nav--primary" data-md-level="0">
- <label class="md-nav__title md-nav__title--site" for="__drawer">
- <a href="." title="FreeType-2.10.4 API Reference" class="md-nav__button md-logo">
-
- <img alt="logo" src="images/favico.ico" width="48" height="48">
+
+
+
+<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
+ <label class="md-nav__title" for="__drawer">
+ <a href="index.html" title="FreeType-2.13.2 API Reference" class="md-nav__button md-logo" aria-label="FreeType-2.13.2 API Reference" data-md-component="logo">
+ <img src="images/favico.ico" alt="logo">
+
</a>
- FreeType-2.10.4 API Reference
+ FreeType-2.13.2 API Reference
</label>
<ul class="md-nav__list" data-md-scrollfix>
-
- <li class="md-nav__item">
- <a href="index.html" title="TOC" class="md-nav__link">
- TOC
- </a>
- </li>
+
+
+
+ <li class="md-nav__item">
+ <a href="index.html" class="md-nav__link">
+ TOC
+ </a>
+ </li>
+
-
- <li class="md-nav__item">
- <a href="ft2-index.html" title="Index" class="md-nav__link">
- Index
- </a>
- </li>
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-index.html" class="md-nav__link">
+ Index
+ </a>
+ </li>
+
-
- <li class="md-nav__item md-nav__item--nested">
-
- <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3" type="checkbox" id="nav-3">
+
+
+
- <label class="md-nav__link" for="nav-3">
- General Remarks
- </label>
- <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
- <label class="md-nav__title" for="nav-3">
+ <li class="md-nav__item md-nav__item--nested">
+
+
+ <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_3" type="checkbox" id="__nav_3" >
+
+ <label class="md-nav__link" for="__nav_3">
General Remarks
+ <span class="md-nav__icon md-icon"></span>
</label>
- <ul class="md-nav__list" data-md-scrollfix>
-
-
-
+ <nav class="md-nav" aria-label="General Remarks" data-md-level="1">
+ <label class="md-nav__title" for="__nav_3">
+ <span class="md-nav__icon md-icon"></span>
+ General Remarks
+ </label>
+ <ul class="md-nav__list" data-md-scrollfix>
-
-
-
- <li class="md-nav__item">
- <a href="ft2-header_inclusion.html" title="FreeType's header inclusion scheme" class="md-nav__link">
- FreeType's header inclusion scheme
- </a>
- </li>
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-preamble.html" class="md-nav__link">
+ Preamble
+ </a>
+ </li>
+
-
-
-
-
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-header_inclusion.html" class="md-nav__link">
+ FreeType's header inclusion scheme
+ </a>
+ </li>
+
- <li class="md-nav__item">
- <a href="ft2-user_allocation.html" title="User allocation" class="md-nav__link">
- User allocation
- </a>
- </li>
+
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-user_allocation.html" class="md-nav__link">
+ User allocation
+ </a>
+ </li>
+
-
- </ul>
- </nav>
- </li>
+
+ </ul>
+ </nav>
+ </li>
+
-
-
- <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+
- <input class="md-toggle md-nav__toggle" data-md-toggle="nav-4" type="checkbox" id="nav-4" checked>
+
+
- <label class="md-nav__link" for="nav-4">
- Core API
- </label>
- <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
- <label class="md-nav__title" for="nav-4">
+ <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+
+
+ <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_4" type="checkbox" id="__nav_4" checked>
+
+ <label class="md-nav__link" for="__nav_4">
Core API
+ <span class="md-nav__icon md-icon"></span>
</label>
- <ul class="md-nav__list" data-md-scrollfix>
-
-
-
-
-
-
-
- <li class="md-nav__item">
- <a href="ft2-version.html" title="FreeType Version" class="md-nav__link">
- FreeType Version
- </a>
- </li>
-
-
+ <nav class="md-nav" aria-label="Core API" data-md-level="1">
+ <label class="md-nav__title" for="__nav_4">
+ <span class="md-nav__icon md-icon"></span>
+ Core API
+ </label>
+ <ul class="md-nav__list" data-md-scrollfix>
-
-
-
+
+
-
-
- <li class="md-nav__item md-nav__item--active">
-
- <input class="md-toggle md-nav__toggle" data-md-toggle="toc" type="checkbox" id="__toc">
+
+
+ <li class="md-nav__item md-nav__item--active">
-
-
- <label class="md-nav__link md-nav__link--active" for="__toc">
+ <input class="md-nav__toggle md-toggle" data-md-toggle="toc" type="checkbox" id="__toc">
+
+
+
+
+
+ <label class="md-nav__link md-nav__link--active" for="__toc">
+ Basic Data Types
+ <span class="md-nav__icon md-icon"></span>
+ </label>
+
+ <a href="ft2-basic_types.html" class="md-nav__link md-nav__link--active">
Basic Data Types
- </label>
-
- <a href="ft2-basic_types.html" title="Basic Data Types" class="md-nav__link md-nav__link--active">
- Basic Data Types
- </a>
-
+ </a>
-<nav class="md-nav md-nav--secondary">
+
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+
- <label class="md-nav__title" for="__toc">Table of contents</label>
- <ul class="md-nav__list" data-md-scrollfix>
+ <label class="md-nav__title" for="__toc">
+ <span class="md-nav__icon md-icon"></span>
+ Table of contents
+ </label>
+ <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
<li class="md-nav__item">
<a href="#synopsis" class="md-nav__link">
</li>
-
-
-
-
</ul>
</nav>
-
- </li>
+
+ </li>
+
-
-
-
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-library_setup.html" class="md-nav__link">
+ Library Setup
+ </a>
+ </li>
+
-
- <li class="md-nav__item">
- <a href="ft2-base_interface.html" title="Base Interface" class="md-nav__link">
- Base Interface
- </a>
- </li>
-
-
-
-
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-face_creation.html" class="md-nav__link">
+ Face Creation
+ </a>
+ </li>
+
-
- <li class="md-nav__item">
- <a href="ft2-glyph_variants.html" title="Unicode Variation Sequences" class="md-nav__link">
- Unicode Variation Sequences
- </a>
- </li>
-
-
-
-
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-font_testing_macros.html" class="md-nav__link">
+ Font Testing Macros
+ </a>
+ </li>
+
-
- <li class="md-nav__item">
- <a href="ft2-color_management.html" title="Glyph Color Management" class="md-nav__link">
- Glyph Color Management
- </a>
- </li>
-
-
-
-
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-sizing_and_scaling.html" class="md-nav__link">
+ Sizing and Scaling
+ </a>
+ </li>
+
-
- <li class="md-nav__item">
- <a href="ft2-layer_management.html" title="Glyph Layer Management" class="md-nav__link">
- Glyph Layer Management
- </a>
- </li>
-
-
-
-
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-glyph_retrieval.html" class="md-nav__link">
+ Glyph Retrieval
+ </a>
+ </li>
+
+
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-character_mapping.html" class="md-nav__link">
+ Character Mapping
+ </a>
+ </li>
+
- <li class="md-nav__item">
- <a href="ft2-glyph_management.html" title="Glyph Management" class="md-nav__link">
- Glyph Management
- </a>
- </li>
-
-
-
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-information_retrieval.html" class="md-nav__link">
+ Information Retrieval
+ </a>
+ </li>
+
+
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-other_api_data.html" class="md-nav__link">
+ Other API Data
+ </a>
+ </li>
+
+
+ </ul>
+ </nav>
+ </li>
+
- <li class="md-nav__item">
- <a href="ft2-mac_specific.html" title="Mac Specific Interface" class="md-nav__link">
- Mac Specific Interface
- </a>
- </li>
+
+
+
+
-
-
-
+
+
+
+
+ <li class="md-nav__item md-nav__item--nested">
+
+
+ <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_5" type="checkbox" id="__nav_5" >
+
+ <label class="md-nav__link" for="__nav_5">
+ Extended API
+ <span class="md-nav__icon md-icon"></span>
+ </label>
+ <nav class="md-nav" aria-label="Extended API" data-md-level="1">
+ <label class="md-nav__title" for="__nav_5">
+ <span class="md-nav__icon md-icon"></span>
+ Extended API
+ </label>
+ <ul class="md-nav__list" data-md-scrollfix>
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-glyph_variants.html" class="md-nav__link">
+ Unicode Variation Sequences
+ </a>
+ </li>
+
+
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-color_management.html" class="md-nav__link">
+ Glyph Color Management
+ </a>
+ </li>
+
- <li class="md-nav__item">
- <a href="ft2-sizes_management.html" title="Size Management" class="md-nav__link">
- Size Management
- </a>
- </li>
-
-
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-layer_management.html" class="md-nav__link">
+ Glyph Layer Management
+ </a>
+ </li>
+
+
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-glyph_management.html" class="md-nav__link">
+ Glyph Management
+ </a>
+ </li>
+
+
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-mac_specific.html" class="md-nav__link">
+ Mac Specific Interface
+ </a>
+ </li>
+
+
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-sizes_management.html" class="md-nav__link">
+ Size Management
+ </a>
+ </li>
+
- <li class="md-nav__item">
- <a href="ft2-header_file_macros.html" title="Header File Macros" class="md-nav__link">
- Header File Macros
- </a>
- </li>
+
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-header_file_macros.html" class="md-nav__link">
+ Header File Macros
+ </a>
+ </li>
+
-
- </ul>
- </nav>
- </li>
+
+ </ul>
+ </nav>
+ </li>
+
-
- <li class="md-nav__item md-nav__item--nested">
-
- <input class="md-toggle md-nav__toggle" data-md-toggle="nav-5" type="checkbox" id="nav-5">
+
+
+
- <label class="md-nav__link" for="nav-5">
- Format-Specific API
- </label>
- <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
- <label class="md-nav__title" for="nav-5">
+ <li class="md-nav__item md-nav__item--nested">
+
+
+ <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_6" type="checkbox" id="__nav_6" >
+
+ <label class="md-nav__link" for="__nav_6">
Format-Specific API
+ <span class="md-nav__icon md-icon"></span>
</label>
- <ul class="md-nav__list" data-md-scrollfix>
-
-
+ <nav class="md-nav" aria-label="Format-Specific API" data-md-level="1">
+ <label class="md-nav__title" for="__nav_6">
+ <span class="md-nav__icon md-icon"></span>
+ Format-Specific API
+ </label>
+ <ul class="md-nav__list" data-md-scrollfix>
-
-
-
-
- <li class="md-nav__item">
- <a href="ft2-multiple_masters.html" title="Multiple Masters" class="md-nav__link">
- Multiple Masters
- </a>
- </li>
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-multiple_masters.html" class="md-nav__link">
+ Multiple Masters
+ </a>
+ </li>
+
-
-
-
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-truetype_tables.html" class="md-nav__link">
+ TrueType Tables
+ </a>
+ </li>
+
-
- <li class="md-nav__item">
- <a href="ft2-truetype_tables.html" title="TrueType Tables" class="md-nav__link">
- TrueType Tables
- </a>
- </li>
-
-
-
-
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-type1_tables.html" class="md-nav__link">
+ Type 1 Tables
+ </a>
+ </li>
+
-
- <li class="md-nav__item">
- <a href="ft2-type1_tables.html" title="Type 1 Tables" class="md-nav__link">
- Type 1 Tables
- </a>
- </li>
-
-
-
-
-
-
- <li class="md-nav__item">
- <a href="ft2-sfnt_names.html" title="SFNT Names" class="md-nav__link">
- SFNT Names
- </a>
- </li>
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-sfnt_names.html" class="md-nav__link">
+ SFNT Names
+ </a>
+ </li>
+
-
-
-
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-bdf_fonts.html" class="md-nav__link">
+ BDF and PCF Files
+ </a>
+ </li>
+
-
- <li class="md-nav__item">
- <a href="ft2-bdf_fonts.html" title="BDF and PCF Files" class="md-nav__link">
- BDF and PCF Files
- </a>
- </li>
-
-
-
-
-
-
- <li class="md-nav__item">
- <a href="ft2-cid_fonts.html" title="CID Fonts" class="md-nav__link">
- CID Fonts
- </a>
- </li>
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-cid_fonts.html" class="md-nav__link">
+ CID Fonts
+ </a>
+ </li>
+
-
-
-
-
-
- <li class="md-nav__item">
- <a href="ft2-pfr_fonts.html" title="PFR Fonts" class="md-nav__link">
- PFR Fonts
- </a>
- </li>
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-pfr_fonts.html" class="md-nav__link">
+ PFR Fonts
+ </a>
+ </li>
+
-
-
-
-
-
- <li class="md-nav__item">
- <a href="ft2-winfnt_fonts.html" title="Window FNT Files" class="md-nav__link">
- Window FNT Files
- </a>
- </li>
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-winfnt_fonts.html" class="md-nav__link">
+ Window FNT Files
+ </a>
+ </li>
+
-
-
-
-
-
- <li class="md-nav__item">
- <a href="ft2-font_formats.html" title="Font Formats" class="md-nav__link">
- Font Formats
- </a>
- </li>
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-svg_fonts.html" class="md-nav__link">
+ OpenType SVG Fonts
+ </a>
+ </li>
+
-
-
-
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-font_formats.html" class="md-nav__link">
+ Font Formats
+ </a>
+ </li>
+
+
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-gasp_table.html" class="md-nav__link">
+ Gasp Table
+ </a>
+ </li>
+
- <li class="md-nav__item">
- <a href="ft2-gasp_table.html" title="Gasp Table" class="md-nav__link">
- Gasp Table
- </a>
- </li>
-
-
- </ul>
- </nav>
- </li>
+
+ </ul>
+ </nav>
+ </li>
+
-
- <li class="md-nav__item md-nav__item--nested">
-
- <input class="md-toggle md-nav__toggle" data-md-toggle="nav-6" type="checkbox" id="nav-6">
+
+
+
- <label class="md-nav__link" for="nav-6">
- Controlling FreeType Modules
- </label>
- <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
- <label class="md-nav__title" for="nav-6">
+ <li class="md-nav__item md-nav__item--nested">
+
+
+ <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_7" type="checkbox" id="__nav_7" >
+
+ <label class="md-nav__link" for="__nav_7">
Controlling FreeType Modules
+ <span class="md-nav__icon md-icon"></span>
</label>
- <ul class="md-nav__list" data-md-scrollfix>
-
-
-
+ <nav class="md-nav" aria-label="Controlling FreeType Modules" data-md-level="1">
+ <label class="md-nav__title" for="__nav_7">
+ <span class="md-nav__icon md-icon"></span>
+ Controlling FreeType Modules
+ </label>
+ <ul class="md-nav__list" data-md-scrollfix>
-
-
-
- <li class="md-nav__item">
- <a href="ft2-auto_hinter.html" title="The auto-hinter" class="md-nav__link">
- The auto-hinter
- </a>
- </li>
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-auto_hinter.html" class="md-nav__link">
+ The auto-hinter
+ </a>
+ </li>
+
-
-
-
-
-
- <li class="md-nav__item">
- <a href="ft2-cff_driver.html" title="The CFF driver" class="md-nav__link">
- The CFF driver
- </a>
- </li>
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-cff_driver.html" class="md-nav__link">
+ The CFF driver
+ </a>
+ </li>
+
-
-
-
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-t1_cid_driver.html" class="md-nav__link">
+ The Type 1 and CID drivers
+ </a>
+ </li>
+
-
- <li class="md-nav__item">
- <a href="ft2-t1_cid_driver.html" title="The Type 1 and CID drivers" class="md-nav__link">
- The Type 1 and CID drivers
- </a>
- </li>
-
-
-
-
-
-
- <li class="md-nav__item">
- <a href="ft2-tt_driver.html" title="The TrueType driver" class="md-nav__link">
- The TrueType driver
- </a>
- </li>
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-tt_driver.html" class="md-nav__link">
+ The TrueType driver
+ </a>
+ </li>
+
-
-
-
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-pcf_driver.html" class="md-nav__link">
+ The PCF driver
+ </a>
+ </li>
+
-
- <li class="md-nav__item">
- <a href="ft2-pcf_driver.html" title="The PCF driver" class="md-nav__link">
- The PCF driver
- </a>
- </li>
-
-
-
-
-
-
- <li class="md-nav__item">
- <a href="ft2-properties.html" title="Driver properties" class="md-nav__link">
- Driver properties
- </a>
- </li>
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-ot_svg_driver.html" class="md-nav__link">
+ The SVG driver
+ </a>
+ </li>
+
-
-
-
-
-
- <li class="md-nav__item">
- <a href="ft2-parameter_tags.html" title="Parameter Tags" class="md-nav__link">
- Parameter Tags
- </a>
- </li>
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-properties.html" class="md-nav__link">
+ Driver properties
+ </a>
+ </li>
+
-
-
-
-
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-parameter_tags.html" class="md-nav__link">
+ Parameter Tags
+ </a>
+ </li>
+
- <li class="md-nav__item">
- <a href="ft2-lcd_rendering.html" title="Subpixel Rendering" class="md-nav__link">
- Subpixel Rendering
- </a>
- </li>
+
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-lcd_rendering.html" class="md-nav__link">
+ Subpixel Rendering
+ </a>
+ </li>
+
-
- </ul>
- </nav>
- </li>
+
+ </ul>
+ </nav>
+ </li>
+
-
- <li class="md-nav__item md-nav__item--nested">
-
- <input class="md-toggle md-nav__toggle" data-md-toggle="nav-7" type="checkbox" id="nav-7">
+
+
+
- <label class="md-nav__link" for="nav-7">
- Cache Sub-System
- </label>
- <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
- <label class="md-nav__title" for="nav-7">
+ <li class="md-nav__item md-nav__item--nested">
+
+
+ <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_8" type="checkbox" id="__nav_8" >
+
+ <label class="md-nav__link" for="__nav_8">
Cache Sub-System
+ <span class="md-nav__icon md-icon"></span>
</label>
- <ul class="md-nav__list" data-md-scrollfix>
-
-
-
+ <nav class="md-nav" aria-label="Cache Sub-System" data-md-level="1">
+ <label class="md-nav__title" for="__nav_8">
+ <span class="md-nav__icon md-icon"></span>
+ Cache Sub-System
+ </label>
+ <ul class="md-nav__list" data-md-scrollfix>
-
-
-
- <li class="md-nav__item">
- <a href="ft2-cache_subsystem.html" title="Cache Sub-System" class="md-nav__link">
- Cache Sub-System
- </a>
- </li>
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-cache_subsystem.html" class="md-nav__link">
+ Cache Sub-System
+ </a>
+ </li>
+
-
- </ul>
- </nav>
- </li>
+
+ </ul>
+ </nav>
+ </li>
+
-
- <li class="md-nav__item md-nav__item--nested">
-
- <input class="md-toggle md-nav__toggle" data-md-toggle="nav-8" type="checkbox" id="nav-8">
+
+
+
- <label class="md-nav__link" for="nav-8">
- Support API
- </label>
- <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
- <label class="md-nav__title" for="nav-8">
+ <li class="md-nav__item md-nav__item--nested">
+
+
+ <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_9" type="checkbox" id="__nav_9" >
+
+ <label class="md-nav__link" for="__nav_9">
Support API
- </label>
- <ul class="md-nav__list" data-md-scrollfix>
-
-
-
-
-
-
-
- <li class="md-nav__item">
- <a href="ft2-computations.html" title="Computations" class="md-nav__link">
- Computations
- </a>
- </li>
-
-
-
-
-
-
-
- <li class="md-nav__item">
- <a href="ft2-list_processing.html" title="List Processing" class="md-nav__link">
- List Processing
- </a>
- </li>
-
-
-
-
-
-
-
- <li class="md-nav__item">
- <a href="ft2-outline_processing.html" title="Outline Processing" class="md-nav__link">
- Outline Processing
- </a>
- </li>
-
-
-
-
-
-
-
- <li class="md-nav__item">
- <a href="ft2-quick_advance.html" title="Quick retrieval of advance values" class="md-nav__link">
- Quick retrieval of advance values
- </a>
- </li>
-
-
-
-
-
-
-
- <li class="md-nav__item">
- <a href="ft2-bitmap_handling.html" title="Bitmap Handling" class="md-nav__link">
- Bitmap Handling
- </a>
- </li>
-
-
-
-
-
-
-
- <li class="md-nav__item">
- <a href="ft2-raster.html" title="Scanline Converter" class="md-nav__link">
- Scanline Converter
- </a>
- </li>
-
-
-
-
-
-
-
- <li class="md-nav__item">
- <a href="ft2-glyph_stroker.html" title="Glyph Stroker" class="md-nav__link">
- Glyph Stroker
- </a>
- </li>
-
-
-
-
-
-
-
- <li class="md-nav__item">
- <a href="ft2-system_interface.html" title="System Interface" class="md-nav__link">
- System Interface
- </a>
- </li>
-
-
-
-
+ <span class="md-nav__icon md-icon"></span>
+ </label>
+ <nav class="md-nav" aria-label="Support API" data-md-level="1">
+ <label class="md-nav__title" for="__nav_9">
+ <span class="md-nav__icon md-icon"></span>
+ Support API
+ </label>
+ <ul class="md-nav__list" data-md-scrollfix>
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-computations.html" class="md-nav__link">
+ Computations
+ </a>
+ </li>
+
-
- <li class="md-nav__item">
- <a href="ft2-module_management.html" title="Module Management" class="md-nav__link">
- Module Management
- </a>
- </li>
-
-
-
-
-
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-list_processing.html" class="md-nav__link">
+ List Processing
+ </a>
+ </li>
+
- <li class="md-nav__item">
- <a href="ft2-gzip.html" title="GZIP Streams" class="md-nav__link">
- GZIP Streams
- </a>
- </li>
+
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-outline_processing.html" class="md-nav__link">
+ Outline Processing
+ </a>
+ </li>
+
-
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-quick_advance.html" class="md-nav__link">
+ Quick retrieval of advance values
+ </a>
+ </li>
+
+
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-bitmap_handling.html" class="md-nav__link">
+ Bitmap Handling
+ </a>
+ </li>
+
+
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-raster.html" class="md-nav__link">
+ Scanline Converter
+ </a>
+ </li>
+
+
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-glyph_stroker.html" class="md-nav__link">
+ Glyph Stroker
+ </a>
+ </li>
+
- <li class="md-nav__item">
- <a href="ft2-lzw.html" title="LZW Streams" class="md-nav__link">
- LZW Streams
- </a>
- </li>
+
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-system_interface.html" class="md-nav__link">
+ System Interface
+ </a>
+ </li>
+
-
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-module_management.html" class="md-nav__link">
+ Module Management
+ </a>
+ </li>
+
+
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-gzip.html" class="md-nav__link">
+ GZIP Streams
+ </a>
+ </li>
+
+
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-lzw.html" class="md-nav__link">
+ LZW Streams
+ </a>
+ </li>
+
+
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-bzip2.html" class="md-nav__link">
+ BZIP2 Streams
+ </a>
+ </li>
+
- <li class="md-nav__item">
- <a href="ft2-bzip2.html" title="BZIP2 Streams" class="md-nav__link">
- BZIP2 Streams
- </a>
- </li>
+
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-debugging_apis.html" class="md-nav__link">
+ External Debugging APIs
+ </a>
+ </li>
+
-
- </ul>
- </nav>
- </li>
+
+ </ul>
+ </nav>
+ </li>
+
-
- <li class="md-nav__item md-nav__item--nested">
-
- <input class="md-toggle md-nav__toggle" data-md-toggle="nav-9" type="checkbox" id="nav-9">
+
+
+
- <label class="md-nav__link" for="nav-9">
- Error Codes
- </label>
- <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
- <label class="md-nav__title" for="nav-9">
+ <li class="md-nav__item md-nav__item--nested">
+
+
+ <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_10" type="checkbox" id="__nav_10" >
+
+ <label class="md-nav__link" for="__nav_10">
Error Codes
+ <span class="md-nav__icon md-icon"></span>
</label>
- <ul class="md-nav__list" data-md-scrollfix>
-
-
+ <nav class="md-nav" aria-label="Error Codes" data-md-level="1">
+ <label class="md-nav__title" for="__nav_10">
+ <span class="md-nav__icon md-icon"></span>
+ Error Codes
+ </label>
+ <ul class="md-nav__list" data-md-scrollfix>
-
-
-
-
- <li class="md-nav__item">
- <a href="ft2-error_enumerations.html" title="Error Enumerations" class="md-nav__link">
- Error Enumerations
- </a>
- </li>
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-error_enumerations.html" class="md-nav__link">
+ Error Enumerations
+ </a>
+ </li>
+
-
-
-
-
-
- <li class="md-nav__item">
- <a href="ft2-error_code_values.html" title="Error Code Values" class="md-nav__link">
- Error Code Values
- </a>
- </li>
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-error_code_values.html" class="md-nav__link">
+ Error Code Values
+ </a>
+ </li>
+
-
- </ul>
- </nav>
- </li>
+
+ </ul>
+ </nav>
+ </li>
+
-
- <li class="md-nav__item md-nav__item--nested">
-
- <input class="md-toggle md-nav__toggle" data-md-toggle="nav-10" type="checkbox" id="nav-10">
+
+
+
- <label class="md-nav__link" for="nav-10">
- Miscellaneous
- </label>
- <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
- <label class="md-nav__title" for="nav-10">
+ <li class="md-nav__item md-nav__item--nested">
+
+
+ <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_11" type="checkbox" id="__nav_11" >
+
+ <label class="md-nav__link" for="__nav_11">
Miscellaneous
+ <span class="md-nav__icon md-icon"></span>
</label>
- <ul class="md-nav__list" data-md-scrollfix>
-
-
-
+ <nav class="md-nav" aria-label="Miscellaneous" data-md-level="1">
+ <label class="md-nav__title" for="__nav_11">
+ <span class="md-nav__icon md-icon"></span>
+ Miscellaneous
+ </label>
+ <ul class="md-nav__list" data-md-scrollfix>
-
-
-
- <li class="md-nav__item">
- <a href="ft2-gx_validation.html" title="TrueTypeGX/AAT Validation" class="md-nav__link">
- TrueTypeGX/AAT Validation
- </a>
- </li>
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-gx_validation.html" class="md-nav__link">
+ TrueTypeGX/AAT Validation
+ </a>
+ </li>
+
-
-
-
-
-
- <li class="md-nav__item">
- <a href="ft2-incremental.html" title="Incremental Loading" class="md-nav__link">
- Incremental Loading
- </a>
- </li>
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-incremental.html" class="md-nav__link">
+ Incremental Loading
+ </a>
+ </li>
+
-
-
-
-
-
- <li class="md-nav__item">
- <a href="ft2-truetype_engine.html" title="The TrueType Engine" class="md-nav__link">
- The TrueType Engine
- </a>
- </li>
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-truetype_engine.html" class="md-nav__link">
+ The TrueType Engine
+ </a>
+ </li>
+
-
-
-
-
-
- <li class="md-nav__item">
- <a href="ft2-ot_validation.html" title="OpenType Validation" class="md-nav__link">
- OpenType Validation
- </a>
- </li>
+
+
+
+
+ <li class="md-nav__item">
+ <a href="ft2-ot_validation.html" class="md-nav__link">
+ OpenType Validation
+ </a>
+ </li>
+
-
- </ul>
- </nav>
- </li>
+
+ </ul>
+ </nav>
+ </li>
+
</ul>
</div>
- <div class="md-sidebar md-sidebar--secondary" data-md-component="toc">
+
+ <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
<div class="md-sidebar__scrollwrap">
<div class="md-sidebar__inner">
-<nav class="md-nav md-nav--secondary">
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+
- <label class="md-nav__title" for="__toc">Table of contents</label>
- <ul class="md-nav__list" data-md-scrollfix>
+ <label class="md-nav__title" for="__toc">
+ <span class="md-nav__icon md-icon"></span>
+ Table of contents
+ </label>
+ <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
<li class="md-nav__item">
<a href="#synopsis" class="md-nav__link">
</li>
-
-
-
-
</ul>
</nav>
</div>
- <div class="md-content">
+ <div class="md-content" data-md-component="content">
<article class="md-content__inner md-typeset">
<hr />
<h1 id="basic-data-types">Basic Data Types<a class="headerlink" href="#basic-data-types" title="Permanent link">¶</a></h1>
<h2 id="synopsis">Synopsis<a class="headerlink" href="#synopsis" title="Permanent link">¶</a></h2>
-<p>This section contains the basic data types defined by FreeType 2, ranging from simple scalar types to bitmap descriptors. More font-specific structures are defined in a different section.</p>
+<p>This section contains the basic data types defined by FreeType 2, ranging from simple scalar types to bitmap descriptors. More font-specific structures are defined in a different section. Note that FreeType does not use floating-point data types. Fractional values are represented by fixed-point integers, with lower bits storing the fractional part.</p>
<h2 id="ft_byte">FT_Byte<a class="headerlink" href="#ft_byte" title="Permanent link">¶</a></h2>
<p>Defined in FT_TYPES_H (freetype/fttypes.h).</p>
<div class = "codehilite"><pre><code> <span class="keyword">typedef</span> <span class="keyword">unsigned</span> <span class="keyword">char</span> <b>FT_Byte</b>;
<h2 id="ft_uint32">FT_UInt32<a class="headerlink" href="#ft_uint32" title="Permanent link">¶</a></h2>
<div class = "codehilite"><pre><code> <span class="keyword">typedef</span> <span class="keyword">unsigned</span> XXX <b>FT_UInt32</b>;
</code></pre></div>
-
<hr>
<h2 id="ft_int64">FT_Int64<a class="headerlink" href="#ft_int64" title="Permanent link">¶</a></h2>
<div class = "codehilite"><pre><code> <span class="keyword">typedef</span> <span class="keyword">signed</span> XXX <b>FT_Int64</b>;
</code></pre></div>
-
<hr>
<h2 id="ft_uint64">FT_UInt64<a class="headerlink" href="#ft_uint64" title="Permanent link">¶</a></h2>
<div class = "codehilite"><pre><code> <span class="keyword">typedef</span> <span class="keyword">unsigned</span> XXX <b>FT_UInt64</b>;
</code></pre></div>
-
<hr>
<h2 id="ft_short">FT_Short<a class="headerlink" href="#ft_short" title="Permanent link">¶</a></h2>
<p>A simple structure used to store a 2D vector; coordinates are of the FT_Pos type.</p>
<h4>fields</h4>
-
<table class="fields">
<tr><td class="val" id="x">x</td><td class="desc">
<p>The horizontal coordinate.</p>
<p>A structure used to hold an outline's bounding box, i.e., the coordinates of its extrema in the horizontal and vertical directions.</p>
<h4>fields</h4>
-
<table class="fields">
<tr><td class="val" id="xmin">xMin</td><td class="desc">
<p>The horizontal minimum (left-most).</p>
y' = x*yx + y*yy
</code></pre></div></p>
<h4>fields</h4>
-
<table class="fields">
<tr><td class="val" id="xx">xx</td><td class="desc">
<p>Matrix coefficient.</p>
<p>A simple structure used to store a 2D vector unit vector. Uses FT_F2Dot14 types.</p>
<h4>fields</h4>
-
<table class="fields">
<tr><td class="val" id="x">x</td><td class="desc">
<p>Horizontal coordinate.</p>
<div class = "codehilite"><pre><code> <span class="keyword">typedef</span> <span class="keyword">struct</span> FT_Data_
{
<span class="keyword">const</span> <a href="ft2-basic_types.html#ft_byte">FT_Byte</a>* pointer;
- <a href="ft2-basic_types.html#ft_int">FT_Int</a> length;
+ <a href="ft2-basic_types.html#ft_uint">FT_UInt</a> length;
} <b>FT_Data</b>;
</code></pre></div>
<p>Read-only binary data represented as a pointer and a length.</p>
<h4>fields</h4>
-
<table class="fields">
<tr><td class="val" id="pointer">pointer</td><td class="desc">
<p>The data.</p>
<h2 id="ft_make_tag">FT_MAKE_TAG<a class="headerlink" href="#ft_make_tag" title="Permanent link">¶</a></h2>
<p>Defined in FT_TYPES_H (freetype/fttypes.h).</p>
-<div class = "codehilite"><pre><code>#<span class="keyword">define</span> <b>FT_MAKE_TAG</b>( _x1, _x2, _x3, _x4 ) \
- (<a href="ft2-basic_types.html#ft_tag">FT_Tag</a>) \
- ( ( (<a href="ft2-basic_types.html#ft_ulong">FT_ULong</a>)_x1 << 24 ) | \
- ( (<a href="ft2-basic_types.html#ft_ulong">FT_ULong</a>)_x2 << 16 ) | \
- ( (<a href="ft2-basic_types.html#ft_ulong">FT_ULong</a>)_x3 << 8 ) | \
- (<a href="ft2-basic_types.html#ft_ulong">FT_ULong</a>)_x4 )
+<div class = "codehilite"><pre><code>#<span class="keyword">define</span> <b>FT_MAKE_TAG</b>( _x1, _x2, _x3, _x4 ) \
+ ( ( FT_STATIC_BYTE_CAST( <a href="ft2-basic_types.html#ft_tag">FT_Tag</a>, _x1 ) << 24 ) | \
+ ( FT_STATIC_BYTE_CAST( <a href="ft2-basic_types.html#ft_tag">FT_Tag</a>, _x2 ) << 16 ) | \
+ ( FT_STATIC_BYTE_CAST( <a href="ft2-basic_types.html#ft_tag">FT_Tag</a>, _x3 ) << 8 ) | \
+ FT_STATIC_BYTE_CAST( <a href="ft2-basic_types.html#ft_tag">FT_Tag</a>, _x4 ) )
</code></pre></div>
-<p>This macro converts four-letter tags that are used to label TrueType tables into an unsigned long, to be used within FreeType.</p>
+<p>This macro converts four-letter tags that are used to label TrueType tables into an <code>FT_Tag</code> type, to be used within FreeType.</p>
<h4>note</h4>
<p>The produced values <strong>must</strong> be 32-bit integers. Don't redefine this macro.</p>
<p>Some FreeType object contains a <code>generic</code> field, of type <code>FT_Generic</code>, which usage is left to client applications and font servers.</p>
<p>It can be used to store a pointer to client-specific data, as well as the address of a ‘finalizer’ function, which will be called by FreeType when the object is destroyed (for example, the previous client example would put the address of the glyph cache destructor in the <code>finalizer</code> field).</p>
<h4>fields</h4>
-
<table class="fields">
<tr><td class="val" id="data">data</td><td class="desc">
<p>A typeless pointer to any client-specified data. This field is completely ignored by the FreeType library.</p>
<p>A structure used to describe a bitmap or pixmap to the raster. Note that we now manage pixmaps of various depths through the <code>pixel_mode</code> field.</p>
<h4>fields</h4>
-
<table class="fields">
<tr><td class="val" id="rows">rows</td><td class="desc">
<p>The number of bitmap rows.</p>
</td></tr>
</table>
+<h4>note</h4>
+
+<p><code>width</code> and <code>rows</code> refer to the <em>physical</em> size of the bitmap, not the <em>logical</em> one. For example, if <code><a href="ft2-basic_types.html#ft_pixel_mode">FT_Pixel_Mode</a></code> is set to <code>FT_PIXEL_MODE_LCD</code>, the logical width is a just a third of the physical one.</p>
<hr>
<h2 id="ft_pixel_mode">FT_Pixel_Mode<a class="headerlink" href="#ft_pixel_mode" title="Permanent link">¶</a></h2>
<p>An enumeration type used to describe the format of pixels in a given bitmap. Note that additional formats may be added in the future.</p>
<h4>values</h4>
-
<table class="fields">
<tr><td class="val" id="ft_pixel_mode_none">FT_PIXEL_MODE_NONE</td><td class="desc">
<p>Value 0 is reserved.</p>
<p>A 4-bit per pixel bitmap, representing embedded anti-aliased bitmaps in font files according to the OpenType specification. We haven't found a single font using this format, however.</p>
</td></tr>
<tr><td class="val" id="ft_pixel_mode_lcd">FT_PIXEL_MODE_LCD</td><td class="desc">
-<p>An 8-bit bitmap, representing RGB or BGR decimated glyph images used for display on LCD displays; the bitmap is three times wider than the original glyph image. See also <code><a href="ft2-base_interface.html#ft_render_mode">FT_RENDER_MODE_LCD</a></code>.</p>
+<p>An 8-bit bitmap, representing RGB or BGR decimated glyph images used for display on LCD displays; the bitmap is three times wider than the original glyph image. See also <code><a href="ft2-glyph_retrieval.html#ft_render_mode">FT_RENDER_MODE_LCD</a></code>.</p>
</td></tr>
<tr><td class="val" id="ft_pixel_mode_lcd_v">FT_PIXEL_MODE_LCD_V</td><td class="desc">
-<p>An 8-bit bitmap, representing RGB or BGR decimated glyph images used for display on rotated LCD displays; the bitmap is three times taller than the original glyph image. See also <code><a href="ft2-base_interface.html#ft_render_mode">FT_RENDER_MODE_LCD_V</a></code>.</p>
+<p>An 8-bit bitmap, representing RGB or BGR decimated glyph images used for display on rotated LCD displays; the bitmap is three times taller than the original glyph image. See also <code><a href="ft2-glyph_retrieval.html#ft_render_mode">FT_RENDER_MODE_LCD_V</a></code>.</p>
</td></tr>
<tr><td class="val" id="ft_pixel_mode_bgra">FT_PIXEL_MODE_BGRA</td><td class="desc">
-<p>[Since 2.5] An image with four 8-bit channels per pixel, representing a color image (such as emoticons) with alpha channel. For each pixel, the format is BGRA, which means, the blue channel comes first in memory. The color channels are pre-multiplied and in the sRGB colorspace. For example, full red at half-translucent opacity will be represented as ‘00,00,80,80’, not ‘00,00,FF,80’. See also <code><a href="ft2-base_interface.html#ft_load_xxx">FT_LOAD_COLOR</a></code>.</p>
+<p>[Since 2.5] An image with four 8-bit channels per pixel, representing a color image (such as emoticons) with alpha channel. For each pixel, the format is BGRA, which means, the blue channel comes first in memory. The color channels are pre-multiplied and in the sRGB colorspace. For example, full red at half-translucent opacity will be represented as ‘00,00,80,80’, not ‘00,00,FF,80’. See also <code><a href="ft2-glyph_retrieval.html#ft_load_xxx">FT_LOAD_COLOR</a></code>.</p>
</td></tr>
</table>
<a href="ft2-basic_types.html#ft_image_tag">FT_IMAGE_TAG</a>( <a href="ft2-basic_types.html#ft_glyph_format_composite">FT_GLYPH_FORMAT_COMPOSITE</a>, 'c', 'o', 'm', 'p' ),
<a href="ft2-basic_types.html#ft_image_tag">FT_IMAGE_TAG</a>( <a href="ft2-basic_types.html#ft_glyph_format_bitmap">FT_GLYPH_FORMAT_BITMAP</a>, 'b', 'i', 't', 's' ),
<a href="ft2-basic_types.html#ft_image_tag">FT_IMAGE_TAG</a>( <a href="ft2-basic_types.html#ft_glyph_format_outline">FT_GLYPH_FORMAT_OUTLINE</a>, 'o', 'u', 't', 'l' ),
- <a href="ft2-basic_types.html#ft_image_tag">FT_IMAGE_TAG</a>( <a href="ft2-basic_types.html#ft_glyph_format_plotter">FT_GLYPH_FORMAT_PLOTTER</a>, 'p', 'l', 'o', 't' )
+ <a href="ft2-basic_types.html#ft_image_tag">FT_IMAGE_TAG</a>( <a href="ft2-basic_types.html#ft_glyph_format_plotter">FT_GLYPH_FORMAT_PLOTTER</a>, 'p', 'l', 'o', 't' ),
+ <a href="ft2-basic_types.html#ft_image_tag">FT_IMAGE_TAG</a>( <a href="ft2-basic_types.html#ft_glyph_format_svg">FT_GLYPH_FORMAT_SVG</a>, 'S', 'V', 'G', ' ' )
} <b>FT_Glyph_Format</b>;
<p>An enumeration type used to describe the format of a given glyph image. Note that this version of FreeType only supports two image formats, even though future font drivers will be able to register their own format.</p>
<h4>values</h4>
-
<table class="fields">
<tr><td class="val" id="ft_glyph_format_none">FT_GLYPH_FORMAT_NONE</td><td class="desc">
<p>The value 0 is reserved.</p>
</td></tr>
<tr><td class="val" id="ft_glyph_format_composite">FT_GLYPH_FORMAT_COMPOSITE</td><td class="desc">
-<p>The glyph image is a composite of several other images. This format is <em>only</em> used with <code><a href="ft2-base_interface.html#ft_load_xxx">FT_LOAD_NO_RECURSE</a></code>, and is used to report compound glyphs (like accented characters).</p>
+<p>The glyph image is a composite of several other images. This format is <em>only</em> used with <code><a href="ft2-glyph_retrieval.html#ft_load_xxx">FT_LOAD_NO_RECURSE</a></code>, and is used to report compound glyphs (like accented characters).</p>
</td></tr>
<tr><td class="val" id="ft_glyph_format_bitmap">FT_GLYPH_FORMAT_BITMAP</td><td class="desc">
-<p>The glyph image is a bitmap, and can be described as an <code><a href="ft2-basic_types.html#ft_bitmap">FT_Bitmap</a></code>. You generally need to access the <code>bitmap</code> field of the <code><a href="ft2-base_interface.html#ft_glyphslotrec">FT_GlyphSlotRec</a></code> structure to read it.</p>
+<p>The glyph image is a bitmap, and can be described as an <code><a href="ft2-basic_types.html#ft_bitmap">FT_Bitmap</a></code>. You generally need to access the <code>bitmap</code> field of the <code><a href="ft2-glyph_retrieval.html#ft_glyphslotrec">FT_GlyphSlotRec</a></code> structure to read it.</p>
</td></tr>
<tr><td class="val" id="ft_glyph_format_outline">FT_GLYPH_FORMAT_OUTLINE</td><td class="desc">
-<p>The glyph image is a vectorial outline made of line segments and Bezier arcs; it can be described as an <code><a href="ft2-outline_processing.html#ft_outline">FT_Outline</a></code>; you generally want to access the <code>outline</code> field of the <code><a href="ft2-base_interface.html#ft_glyphslotrec">FT_GlyphSlotRec</a></code> structure to read it.</p>
+<p>The glyph image is a vectorial outline made of line segments and Bezier arcs; it can be described as an <code><a href="ft2-outline_processing.html#ft_outline">FT_Outline</a></code>; you generally want to access the <code>outline</code> field of the <code><a href="ft2-glyph_retrieval.html#ft_glyphslotrec">FT_GlyphSlotRec</a></code> structure to read it.</p>
</td></tr>
<tr><td class="val" id="ft_glyph_format_plotter">FT_GLYPH_FORMAT_PLOTTER</td><td class="desc">
<p>The glyph image is a vectorial path with no inside and outside contours. Some Type 1 fonts, like those in the Hershey family, contain glyphs in this format. These are described as <code><a href="ft2-outline_processing.html#ft_outline">FT_Outline</a></code>, but FreeType isn't currently capable of rendering them correctly.</p>
</td></tr>
+<tr><td class="val" id="ft_glyph_format_svg">FT_GLYPH_FORMAT_SVG</td><td class="desc">
+<p>[Since 2.12] The glyph is represented by an SVG document in the ‘SVG ’ table.</p>
+</td></tr>
</table>
<hr>
<h2 id="ft_image_tag">FT_IMAGE_TAG<a class="headerlink" href="#ft_image_tag" title="Permanent link">¶</a></h2>
<p>Defined in FT_IMAGE_H (freetype/ftimage.h).</p>
<div class = "codehilite"><pre><code>#<span class="keyword">ifndef</span> <b>FT_IMAGE_TAG</b>
-#<span class="keyword">define</span> <b>FT_IMAGE_TAG</b>( value, _x1, _x2, _x3, _x4 ) \
- value = ( ( (<span class="keyword">unsigned</span> <span class="keyword">long</span>)_x1 << 24 ) | \
- ( (<span class="keyword">unsigned</span> <span class="keyword">long</span>)_x2 << 16 ) | \
- ( (<span class="keyword">unsigned</span> <span class="keyword">long</span>)_x3 << 8 ) | \
- (<span class="keyword">unsigned</span> <span class="keyword">long</span>)_x4 )
+
+#<span class="keyword">define</span> <b>FT_IMAGE_TAG</b>( value, _x1, _x2, _x3, _x4 ) \
+ value = ( ( FT_STATIC_BYTE_CAST( <span class="keyword">unsigned</span> <span class="keyword">long</span>, _x1 ) << 24 ) | \
+ ( FT_STATIC_BYTE_CAST( <span class="keyword">unsigned</span> <span class="keyword">long</span>, _x2 ) << 16 ) | \
+ ( FT_STATIC_BYTE_CAST( <span class="keyword">unsigned</span> <span class="keyword">long</span>, _x3 ) << 8 ) | \
+ FT_STATIC_BYTE_CAST( <span class="keyword">unsigned</span> <span class="keyword">long</span>, _x4 ) )
+
#<span class="keyword">endif</span> /* <b>FT_IMAGE_TAG</b> */
</code></pre></div>
<p>to get a simple enumeration without assigning special numbers.</p>
<hr>
-
-
-
</article>
</div>
</div>
+
</main>
<footer class="md-footer">
- <div class="md-footer-nav">
- <nav class="md-footer-nav__inner md-grid">
+ <nav class="md-footer__inner md-grid" aria-label="Footer">
+
- <a href="ft2-version.html" title="FreeType Version" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev">
- <div class="md-flex__cell md-flex__cell--shrink">
- <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i>
- </div>
- <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
- <span class="md-flex__ellipsis">
- <span class="md-footer-nav__direction">
- Previous
- </span>
- FreeType Version
+ <a href="ft2-user_allocation.html" class="md-footer__link md-footer__link--prev" aria-label="Previous: User allocation" rel="prev">
+ <div class="md-footer__button md-icon">
+ <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>
+ </div>
+ <div class="md-footer__title">
+ <div class="md-ellipsis">
+ <span class="md-footer__direction">
+ Previous
</span>
+ User allocation
</div>
- </a>
-
+ </div>
+ </a>
+
+
- <a href="ft2-base_interface.html" title="Base Interface" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next">
- <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
- <span class="md-flex__ellipsis">
- <span class="md-footer-nav__direction">
- Next
- </span>
- Base Interface
+ <a href="ft2-library_setup.html" class="md-footer__link md-footer__link--next" aria-label="Next: Library Setup" rel="next">
+ <div class="md-footer__title">
+ <div class="md-ellipsis">
+ <span class="md-footer__direction">
+ Next
</span>
+ Library Setup
</div>
- <div class="md-flex__cell md-flex__cell--shrink">
- <i class="md-icon md-icon--arrow-forward md-footer-nav__button"></i>
- </div>
- </a>
-
- </nav>
- </div>
+ </div>
+ <div class="md-footer__button md-icon">
+ <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>
+ </div>
+ </a>
+
+ </nav>
<div class="md-footer-meta md-typeset">
<div class="md-footer-meta__inner md-grid">
<div class="md-footer-copyright">
<div class="md-footer-copyright__highlight">
- Copyright 2020 <a href = "https://www.freetype.org/license.html">The FreeType Project</a>.
+ Copyright 2023 <a href = "https://www.freetype.org/license.html">The FreeType Project</a>.
</div>
- powered by
- <a href="https://www.mkdocs.org" target="_blank" rel="noopener">MkDocs</a>
- and
+ Made with
<a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
- Material for MkDocs</a>
+ Material for MkDocs
+ </a>
+
</div>
</div>
</footer>
</div>
+ <div class="md-dialog" data-md-component="dialog">
+ <div class="md-dialog__inner md-typeset"></div>
+ </div>
+ <script id="__config" type="application/json">{"base": ".", "features": [], "search": "assets/javascripts/workers/search.477d984a.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.config.lang": "en", "search.config.pipeline": "trimmer, stopWordFilter", "search.config.separator": "[\\s\\-]+", "search.placeholder": "Search", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version.title": "Select version"}, "version": null}</script>
- <script src="assets/javascripts/application.c33a9706.js"></script>
-
- <script>app.initialize({version:"1.1",url:{base:"."}})</script>
+
+ <script src="assets/javascripts/bundle.82b56eb2.min.js"></script>
<script src="javascripts/extra.js"></script>