docs/html/index.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <html>
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   5 <title>HarfBuzz Manual: HarfBuzz Manual</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
   7 <meta name="description" content="HarfBuzz  HarfBuzz is an OpenType text shaping engine. Using the HarfBuzz library allows programs to convert a sequence of Unicode input into properly formatted and positioned glyph output—for any writing system and language. The canonical source-code tree is available at github.com/harfbuzz/harfbuzz and is also available at cgit.freedesktop.org/harfbuzz. See for release tarballs.">
   8 <link rel="home" href="index.html" title="HarfBuzz Manual">
   9 <link rel="next" href="pt01.html" title="Part I. User's manual">
  10 <meta name="generator" content="GTK-Doc V1.29 (XML mode)">
  11 <link rel="stylesheet" href="style.css" type="text/css">
  12 </head>
  13 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  14 <div class="book">
  15 <div class="titlepage">
  16 <div>
  17 <div><table class="navigation" id="top" width="100%" cellpadding="2" cellspacing="0"><tr><th valign="middle"><p class="title">HarfBuzz Manual</p></th></tr></table></div>
  18 <div><div class="abstract">
  19 <p class="title"><b>HarfBuzz</b></p>
  20 <div align="center"><img src="HarfBuzz.png" align="middle"></div>
  21 <p>
  22         HarfBuzz is an <a class="ulink" href="http://www.microsoft.com/typography/otspec/" target="_top">OpenType</a>
  23         text shaping engine. Using the HarfBuzz library allows
  24         programs to convert a sequence of Unicode input into
  25         properly formatted and positioned glyph output—for any writing
  26         system and language.
  27       </p>
  28 <p>
  29         The canonical source-code tree is available at
  30         <a class="ulink" href="https://github.com/harfbuzz/harfbuzz" target="_top">github.com/harfbuzz/harfbuzz</a>
  31         and is also available at
  32         <a class="ulink" href="http://cgit.freedesktop.org/harfbuzz/" target="_top">cgit.freedesktop.org/harfbuzz</a>.
  33         See <a class="xref" href="install-harfbuzz.html#download" title="Downloading HarfBuzz">Downloading HarfBuzz</a> for
  34         release tarballs.
  35       </p>
  36 </div></div>
  37 </div>
  38 <hr>
  39 </div>
  40 <div class="toc"><dl class="toc">
  41 <dt><span class="part"><a href="pt01.html">I. User's manual</a></span></dt>
  42 <dd><dl>
  43 <dt><span class="chapter"><a href="what-is-harfbuzz.html">What is HarfBuzz?</a></span></dt>
  44 <dd><dl>
  45 <dt><span class="section"><a href="what-is-harfbuzz.html#what-is-text-shaping">What is text shaping?</a></span></dt>
  46 <dt><span class="section"><a href="why-do-i-need-a-shaping-engine.html">Why do I need a shaping engine?</a></span></dt>
  47 <dt><span class="section"><a href="ch01s03.html">What does HarfBuzz do?</a></span></dt>
  48 <dt><span class="section"><a href="what-harfbuzz-doesnt-do.html">What HarfBuzz doesn't do</a></span></dt>
  49 <dt><span class="section"><a href="why-is-it-called-harfbuzz.html">Why is it called HarfBuzz?</a></span></dt>
  50 </dl></dd>
  51 <dt><span class="chapter"><a href="install-harfbuzz.html">Installing HarfBuzz</a></span></dt>
  52 <dd><dl>
  53 <dt><span class="section"><a href="install-harfbuzz.html#download">Downloading HarfBuzz</a></span></dt>
  54 <dt><span class="section"><a href="building.html">Building HarfBuzz</a></span></dt>
  55 <dd><dl>
  56 <dt><span class="section"><a href="building.html#building.linux">Building on Linux</a></span></dt>
  57 <dt><span class="section"><a href="building.html#building.windows">Building on Windows</a></span></dt>
  58 <dt><span class="section"><a href="building.html#building.macos">Building on macOS</a></span></dt>
  59 <dt><span class="section"><a href="building.html#configuration">Configuration options</a></span></dt>
  60 </dl></dd>
  61 </dl></dd>
  62 <dt><span class="chapter"><a href="getting-started.html">Getting started with HarfBuzz</a></span></dt>
  63 <dd><dl>
  64 <dt><span class="section"><a href="getting-started.html#id-1.2.4.2">An overview of the HarfBuzz shaping API</a></span></dt>
  65 <dt><span class="section"><a href="ch03s02.html">Terminology</a></span></dt>
  66 <dt><span class="section"><a href="ch03s03.html">A simple shaping example</a></span></dt>
  67 </dl></dd>
  68 <dt><span class="chapter"><a href="shaping-concepts.html">Shaping concepts</a></span></dt>
  69 <dd><dl>
  70 <dt><span class="section"><a href="shaping-concepts.html#text-shaping-concepts">Text shaping</a></span></dt>
  71 <dt><span class="section"><a href="complex-scripts.html">Complex scripts</a></span></dt>
  72 <dt><span class="section"><a href="shaping-operations.html">Shaping operations</a></span></dt>
  73 <dt><span class="section"><a href="unicode-character-categories.html">Unicode character categories</a></span></dt>
  74 <dt><span class="section"><a href="text-runs.html">Text runs</a></span></dt>
  75 <dt><span class="section"><a href="opentype-shaping-models.html">OpenType shaping models</a></span></dt>
  76 <dt><span class="section"><a href="graphite-shaping.html">Graphite shaping</a></span></dt>
  77 <dt><span class="section"><a href="aat-shaping.html">AAT shaping</a></span></dt>
  78 </dl></dd>
  79 <dt><span class="chapter"><a href="buffers-language-script-and-direction.html">Buffers, language, script and direction</a></span></dt>
  80 <dd><dl>
  81 <dt><span class="section"><a href="buffers-language-script-and-direction.html#creating-and-destroying-buffers">Creating and destroying buffers</a></span></dt>
  82 <dt><span class="section"><a href="adding-text-to-the-buffer.html">Adding text to the buffer</a></span></dt>
  83 <dt><span class="section"><a href="setting-buffer-properties.html">Setting buffer properties</a></span></dt>
  84 <dt><span class="section"><a href="what-about-the-other-scripts.html">What about the other scripts?</a></span></dt>
  85 <dt><span class="section"><a href="customizing-unicode-functions.html">Customizing Unicode functions</a></span></dt>
  86 </dl></dd>
  87 <dt><span class="chapter"><a href="fonts-and-faces.html">Fonts and faces</a></span></dt>
  88 <dd><dl>
  89 <dt><span class="section"><a href="fonts-and-faces.html#using-freetype">Using FreeType</a></span></dt>
  90 <dt><span class="section"><a href="using-harfbuzzs-native-opentype-implementation.html">Using HarfBuzz's native OpenType implementation</a></span></dt>
  91 <dt><span class="section"><a href="using-your-own-font-functions.html">Using your own font functions</a></span></dt>
  92 </dl></dd>
  93 <dt><span class="chapter"><a href="clusters.html">Clusters</a></span></dt>
  94 <dd><dl>
  95 <dt><span class="section"><a href="clusters.html#clusters-and-shaping">Clusters and shaping</a></span></dt>
  96 <dt><span class="section"><a href="working-with-harfbuzz-clusters.html">Working with HarfBuzz clusters</a></span></dt>
  97 <dt><span class="section"><a href="a-clustering-example-for-levels-0-and-1.html">A clustering example for levels 0 and 1</a></span></dt>
  98 <dt><span class="section"><a href="reordering-in-levels-0-and-1.html">Reordering in levels 0 and 1</a></span></dt>
  99 <dt><span class="section"><a href="the-distinction-between-levels-0-and-1.html">The distinction between levels 0 and 1</a></span></dt>
 100 <dt><span class="section"><a href="level-2.html">Level 2</a></span></dt>
 101 <dd><dl>
 102 <dt><span class="section"><a href="level-2.html#ligatures-with-combining-marks-in-level-2">Ligatures with combining marks in level 2</a></span></dt>
 103 <dt><span class="section"><a href="level-2.html#reordering-in-level-2">Reordering in level 2</a></span></dt>
 104 <dt><span class="section"><a href="level-2.html#other-considerations-in-level-2">Other considerations in level 2</a></span></dt>
 105 </dl></dd>
 106 </dl></dd>
 107 <dt><span class="chapter"><a href="shaping-and-shape-plans.html">Shaping and shape plans</a></span></dt>
 108 <dd><dl>
 109 <dt><span class="section"><a href="shaping-and-shape-plans.html#opentype-features">OpenType features</a></span></dt>
 110 <dt><span class="section"><a href="plans-and-caching.html">Plans and caching</a></span></dt>
 111 </dl></dd>
 112 </dl></dd>
 113 <dt><span class="part"><a href="pt02.html">II. Reference manual</a></span></dt>
 114 <dd><dl>
 115 <dt><span class="chapter"><a href="ch09.html">Core API</a></span></dt>
 116 <dd><dl>
 117 <dt>
 118 <span class="refentrytitle"><a href="harfbuzz-hb-blob.html">hb-blob</a></span><span class="refpurpose"> — Binary data containers</span>
 119 </dt>
 120 <dt>
 121 <span class="refentrytitle"><a href="harfbuzz-hb-buffer.html">hb-buffer</a></span><span class="refpurpose"> — Input and output buffers</span>
 122 </dt>
 123 <dt>
 124 <span class="refentrytitle"><a href="harfbuzz-hb-common.html">hb-common</a></span><span class="refpurpose"> — Common data types</span>
 125 </dt>
 126 <dt>
 127 <span class="refentrytitle"><a href="harfbuzz-hb-deprecated.html">hb-deprecated</a></span><span class="refpurpose"> — Deprecated API</span>
 128 </dt>
 129 <dt>
 130 <span class="refentrytitle"><a href="harfbuzz-hb-face.html">hb-face</a></span><span class="refpurpose"> — Font face objects</span>
 131 </dt>
 132 <dt>
 133 <span class="refentrytitle"><a href="harfbuzz-hb-font.html">hb-font</a></span><span class="refpurpose"> — Font objects</span>
 134 </dt>
 135 <dt>
 136 <span class="refentrytitle"><a href="harfbuzz-hb-map.html">hb-map</a></span><span class="refpurpose"> — Object representing integer to integer mapping</span>
 137 </dt>
 138 <dt>
 139 <span class="refentrytitle"><a href="harfbuzz-hb-set.html">hb-set</a></span><span class="refpurpose"> — Object representing a set of integers</span>
 140 </dt>
 141 <dt>
 142 <span class="refentrytitle"><a href="harfbuzz-hb-shape-plan.html">hb-shape-plan</a></span><span class="refpurpose"> — Object representing a shaping plan</span>
 143 </dt>
 144 <dt>
 145 <span class="refentrytitle"><a href="harfbuzz-hb-shape.html">hb-shape</a></span><span class="refpurpose"> — Conversion of text strings into positioned glyphs</span>
 146 </dt>
 147 <dt>
 148 <span class="refentrytitle"><a href="harfbuzz-hb-unicode.html">hb-unicode</a></span><span class="refpurpose"> — Unicode character property access</span>
 149 </dt>
 150 <dt>
 151 <span class="refentrytitle"><a href="harfbuzz-hb-version.html">hb-version</a></span><span class="refpurpose"> — Information about the version of HarfBuzz in use</span>
 152 </dt>
 153 </dl></dd>
 154 <dt><span class="chapter"><a href="ch10.html">OpenType API</a></span></dt>
 155 <dd><dl>
 156 <dt>
 157 <span class="refentrytitle"><a href="harfbuzz-hb-ot-color.html">hb-ot-color</a></span><span class="refpurpose"> — OpenType Color Fonts</span>
 158 </dt>
 159 <dt>
 160 <span class="refentrytitle"><a href="harfbuzz-hb-ot-font.html">hb-ot-font</a></span><span class="refpurpose"> — OpenType font implementation</span>
 161 </dt>
 162 <dt>
 163 <span class="refentrytitle"><a href="harfbuzz-hb-ot-layout.html">hb-ot-layout</a></span><span class="refpurpose"> — OpenType Layout</span>
 164 </dt>
 165 <dt>
 166 <span class="refentrytitle"><a href="harfbuzz-hb-ot-math.html">hb-ot-math</a></span><span class="refpurpose"> — OpenType Math information</span>
 167 </dt>
 168 <dt>
 169 <span class="refentrytitle"><a href="harfbuzz-hb-ot-name.html">hb-ot-name</a></span><span class="refpurpose"> — OpenType font name information</span>
 170 </dt>
 171 <dt>
 172 <span class="refentrytitle"><a href="harfbuzz-hb-ot-shape.html">hb-ot-shape</a></span><span class="refpurpose"> — OpenType shaping support</span>
 173 </dt>
 174 <dt>
 175 <span class="refentrytitle"><a href="harfbuzz-hb-ot-var.html">hb-ot-var</a></span><span class="refpurpose"> — OpenType Font Variations</span>
 176 </dt>
 177 </dl></dd>
 178 <dt><span class="chapter"><a href="ch11.html">Apple Advanced Typography API</a></span></dt>
 179 <dd><dl><dt>
 180 <span class="refentrytitle"><a href="harfbuzz-hb-aat-layout.html">hb-aat-layout</a></span><span class="refpurpose"> — Apple Advanced Typography Layout</span>
 181 </dt></dl></dd>
 182 <dt><span class="chapter"><a href="ch12.html">Integration API</a></span></dt>
 183 <dd><dl>
 184 <dt>
 185 <span class="refentrytitle"><a href="harfbuzz-hb-coretext.html">hb-coretext</a></span><span class="refpurpose"> — CoreText integration</span>
 186 </dt>
 187 <dt>
 188 <span class="refentrytitle"><a href="harfbuzz-hb-ft.html">hb-ft</a></span><span class="refpurpose"> — FreeType integration</span>
 189 </dt>
 190 <dt>
 191 <span class="refentrytitle"><a href="harfbuzz-hb-glib.html">hb-glib</a></span><span class="refpurpose"> — GLib integration</span>
 192 </dt>
 193 <dt>
 194 <span class="refentrytitle"><a href="harfbuzz-hb-gobject.html">hb-gobject</a></span><span class="refpurpose"> — GObject integration</span>
 195 </dt>
 196 <dt>
 197 <span class="refentrytitle"><a href="harfbuzz-hb-graphite2.html">hb-graphite2</a></span><span class="refpurpose"> — Graphite2 integration</span>
 198 </dt>
 199 <dt>
 200 <span class="refentrytitle"><a href="harfbuzz-hb-icu.html">hb-icu</a></span><span class="refpurpose"> — ICU integration</span>
 201 </dt>
 202 <dt>
 203 <span class="refentrytitle"><a href="harfbuzz-hb-uniscribe.html">hb-uniscribe</a></span><span class="refpurpose"> — Windows integration</span>
 204 </dt>
 205 </dl></dd>
 206 <dt><span class="index"><a href="api-index-full.html">API Index</a></span></dt>
 207 <dt><span class="glossary"><a href="annotation-glossary.html">Annotation Glossary</a></span></dt>
 208 </dl></dd>
 209 </dl></div>
 210 </div>
 211 <div class="footer">
 212 <hr>Generated by GTK-Doc V1.29</div>
 213 </body>
 214 </html>