FM / harfbuzz

/usr/share/gtk-doc/html/harfbuzz

Name	Size	Mode	Actions
a-clustering-example-for-levels-0-and-1.html	5307	0644	edit dl rm
aat-shaping.html	2359	0644	edit dl rm
adding-text-to-the-buffer.html	5800	0644	edit dl rm
annotation-glossary.html	5644	0644	edit dl rm
api-index-0-9-2.html	44447	0644	edit dl rm
api-index-0-9-5.html	3339	0644	edit dl rm
api-index-0-9-7.html	12306	0644	edit dl rm
api-index-0-9-8.html	2088	0644	edit dl rm
api-index-0-9-10.html	3200	0644	edit dl rm
api-index-0-9-11.html	2070	0644	edit dl rm
api-index-0-9-20.html	2303	0644	edit dl rm
api-index-0-9-22.html	2115	0644	edit dl rm
api-index-0-9-28.html	2062	0644	edit dl rm
api-index-0-9-30.html	2525	0644	edit dl rm
api-index-0-9-31.html	2932	0644	edit dl rm
api-index-0-9-38.html	3822	0644	edit dl rm
api-index-0-9-39.html	2058	0644	edit dl rm
api-index-0-9-41.html	2067	0644	edit dl rm
api-index-0-9-42.html	2587	0644	edit dl rm
api-index-1-0-5.html	2737	0644	edit dl rm
api-index-1-1-2.html	2374	0644	edit dl rm
api-index-1-1-3.html	2957	0644	edit dl rm
api-index-1-2-3.html	2872	0644	edit dl rm
api-index-1-3-3.html	5536	0644	edit dl rm
api-index-1-4-0.html	2347	0644	edit dl rm
api-index-1-4-2.html	5369	0644	edit dl rm
api-index-1-4-3.html	2029	0644	edit dl rm
api-index-1-5-0.html	2900	0644	edit dl rm
api-index-1-6-0.html	2266	0644	edit dl rm
api-index-1-7-5.html	1701	0644	edit dl rm
api-index-1-7-7.html	5550	0644	edit dl rm
api-index-1-8-0.html	2662	0644	edit dl rm
api-index-1-8-1.html	2485	0644	edit dl rm
api-index-1-8-5.html	2088	0644	edit dl rm
api-index-1-8-6.html	3187	0644	edit dl rm
api-index-1-9-0.html	3460	0644	edit dl rm
api-index-2-0-0.html	5926	0644	edit dl rm
api-index-2-1-0.html	8069	0644	edit dl rm
api-index-2-2-0.html	5326	0644	edit dl rm
api-index-2-3-0.html	2650	0644	edit dl rm
api-index-2-4-0.html	2087	0644	edit dl rm
api-index-2-5-0.html	2108	0644	edit dl rm
api-index-2-6-0.html	5240	0644	edit dl rm
api-index-2-7-3.html	2824	0644	edit dl rm
api-index-full.html	140340	0644	edit dl rm
buffers-language-script-and-direction.html	4951	0644	edit dl rm
building.html	15346	0644	edit dl rm
ch01s03.html	4495	0644	edit dl rm
ch03s02.html	6078	0644	edit dl rm
ch03s03.html	4580	0644	edit dl rm
ch12.html	3557	0644	edit dl rm
ch13.html	3078	0644	edit dl rm
ch14.html	1876	0644	edit dl rm
ch15.html	3044	0644	edit dl rm
clusters.html	6499	0644	edit dl rm
complex-scripts.html	3001	0644	edit dl rm
customizing-unicode-functions.html	6400	0644	edit dl rm
deprecated-api-index.html	6223	0644	edit dl rm
fonts-and-faces-custom-functions.html	7398	0644	edit dl rm
fonts-and-faces-native-opentype.html	5196	0644	edit dl rm
fonts-and-faces-variable.html	5304	0644	edit dl rm
fonts-and-faces.html	7671	0644	edit dl rm
getting-started.html	5043	0644	edit dl rm
graphite-shaping.html	2308	0644	edit dl rm
harfbuzz-hb-aat-layout.html	139345	0644	edit dl rm
harfbuzz-hb-blob.html	35902	0644	edit dl rm
harfbuzz-hb-buffer.html	195491	0644	edit dl rm
harfbuzz-hb-common.html	65323	0644	edit dl rm
harfbuzz-hb-coretext.html	11371	0644	edit dl rm
harfbuzz-hb-deprecated.html	25328	0644	edit dl rm
harfbuzz-hb-directwrite.html	6155	0644	edit dl rm
harfbuzz-hb-face.html	52100	0644	edit dl rm
harfbuzz-hb-font.html	262696	0644	edit dl rm
harfbuzz-hb-ft.html	28719	0644	edit dl rm
harfbuzz-hb-gdi.html	4310	0644	edit dl rm
harfbuzz-hb-glib.html	10086	0644	edit dl rm
harfbuzz-hb-gobject.html	2953	0644	edit dl rm
harfbuzz-hb-graphite2.html	5828	0644	edit dl rm
harfbuzz-hb-icu.html	7969	0644	edit dl rm
harfbuzz-hb-map.html	29188	0644	edit dl rm
harfbuzz-hb-ot-color.html	39949	0644	edit dl rm
harfbuzz-hb-ot-font.html	4630	0644	edit dl rm
harfbuzz-hb-ot-layout.html	145088	0644	edit dl rm
harfbuzz-hb-ot-math.html	52886	0644	edit dl rm
harfbuzz-hb-ot-meta.html	10286	0644	edit dl rm
harfbuzz-hb-ot-metrics.html	17927	0644	edit dl rm
harfbuzz-hb-ot-name.html	19603	0644	edit dl rm
harfbuzz-hb-ot-shape.html	6257	0644	edit dl rm
harfbuzz-hb-ot-var.html	36708	0644	edit dl rm
harfbuzz-hb-set.html	59423	0644	edit dl rm
harfbuzz-hb-shape-plan.html	38412	0644	edit dl rm
harfbuzz-hb-shape.html	11702	0644	edit dl rm
harfbuzz-hb-unicode.html	106701	0644	edit dl rm
harfbuzz-hb-uniscribe.html	6099	0644	edit dl rm
harfbuzz-hb-version.html	10415	0644	edit dl rm
harfbuzz.devhelp2	179457	0644	edit dl rm
HarfBuzz.png	6254	0644	edit dl rm
HarfBuzz.svg	6745	0644	edit dl rm
home.png	169	0644	edit dl rm
index.html	19566	0644	edit dl rm
install-harfbuzz.html	3787	0644	edit dl rm
integration-coretext.html	6483	0644	edit dl rm
integration-freetype.html	9293	0644	edit dl rm
integration-icu.html	4186	0644	edit dl rm
integration-python.html	3181	0644	edit dl rm
integration-uniscribe.html	6725	0644	edit dl rm
integration.html	9936	0644	edit dl rm
left-insensitive.png	334	0644	edit dl rm
left.png	185	0644	edit dl rm
level-2.html	7009	0644	edit dl rm
object-model-blobs.html	2902	0644	edit dl rm
object-model-lifecycle.html	4978	0644	edit dl rm
object-model-object-types.html	4111	0644	edit dl rm
object-model-user-data.html	3255	0644	edit dl rm
object-model.html	3978	0644	edit dl rm
opentype-shaping-models.html	4463	0644	edit dl rm
pt01.html	9417	0644	edit dl rm
pt02.html	12674	0644	edit dl rm
reordering-in-levels-0-and-1.html	3102	0644	edit dl rm
right-insensitive.png	233	0644	edit dl rm
right.png	184	0644	edit dl rm
setting-buffer-properties.html	7830	0644	edit dl rm
shaping-and-shape-plans.html	8196	0644	edit dl rm
shaping-concepts.html	3869	0644	edit dl rm
shaping-opentype-features.html	6663	0644	edit dl rm
shaping-operations.html	4537	0644	edit dl rm
shaping-plans-and-caching.html	4641	0644	edit dl rm
shaping-shaper-selection.html	3406	0644	edit dl rm
style.css	11606	0644	edit dl rm
text-runs.html	2533	0644	edit dl rm
the-distinction-between-levels-0-and-1.html	4864	0644	edit dl rm
unicode-character-categories.html	4204	0644	edit dl rm
up-insensitive.png	288	0644	edit dl rm
up.png	186	0644	edit dl rm
utilities-common-types-apis.html	4365	0644	edit dl rm
utilities-ucdn.html	2632	0644	edit dl rm
utilities.html	9274	0644	edit dl rm
what-harfbuzz-doesnt-do.html	5535	0644	edit dl rm
what-is-harfbuzz.html	5503	0644	edit dl rm
why-do-i-need-a-shaping-engine.html	8124	0644	edit dl rm
why-is-it-called-harfbuzz.html	2171	0644	edit dl rm
working-with-harfbuzz-clusters.html	10083	0644	edit dl rm

Edit: /usr/share/gtk-doc/html/harfbuzz/integration-freetype.html (9293B)

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>FreeType integration: HarfBuzz Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
<link rel="home" href="index.html" title="HarfBuzz Manual">
<link rel="up" href="integration.html" title="Platform Integration Guide">
<link rel="prev" href="integration.html" title="Platform Integration Guide">
<link rel="next" href="integration-uniscribe.html" title="Uniscribe integration">
<meta name="generator" content="GTK-Doc V1.32 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
<td width="100%" align="left" class="shortcuts"></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="integration.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="integration.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="integration-uniscribe.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="section">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="integration-freetype"></a>FreeType integration</h2></div></div></div>

 FreeType is the free-software font-rendering engine included in
 desktop Linux distributions, Android, ChromeOS, iOS, and multiple Unix
 operating systems, and used by cross-platform programs like
 Chrome, Java, and GhostScript. Used together, HarfBuzz can
 perform shaping on Unicode text segments, outputting the glyph
 IDs that FreeType should rasterize from the active font as well
 as the positions at which those glyphs should be drawn.
 

 HarfBuzz provides integration points with FreeType at the
 face-object and font-object level and for the font-functions
 virtual-method structure of a font object. To use the
 FreeType-integration API, include the
 <code class="filename">hb-ft.h</code> header.
 

 In a typical client program, you will create your
 hb_face_t face object and hb_font_t
 font object from a FreeType FT_Face. HarfBuzz
 provides a suite of functions for doing this.
 

 In the most common case, you will want to use
 <code class="function">hb_ft_font_create_referenced()</code>, which
 creates both an hb_face_t face object and
 hb_font_t font object (linked to that face object),
 and provides lifecycle management.
 

 It is important to note,
 though, that while HarfBuzz makes a distinction between its face and
 font objects, FreeType's FT_Face does not. After
 you create your FT_Face, you must set its size
 parameter using <code class="function">FT_Set_Char_Size()</code>, because
 an hb_font_t is defined as an instance of an
 hb_face_t with size specified.
 
<pre class="programlisting">
 #include &lt;hb-ft.h&gt;
 ...
 FT_New_Face(ft_library, font_path, index, &amp;face);
 FT_Set_Char_Size(face, 0, 1000, 0, 0);
 hb_font_t *font = hb_ft_font_create(face);
 </pre>

 <code class="function">hb_ft_font_create_referenced()</code> is
 the recommended function for creating an hb_face_t face
 object. This function calls <code class="function">FT_Reference_Face()</code>
 before using the FT_Face and calls 
 <code class="function">FT_Done_Face()</code> when it is finished using the
 FT_Face. Consequently, your client program does not need
 to worry about destroying the FT_Face while HarfBuzz
 is still using it.
 

 Although <code class="function">hb_ft_font_create_referenced()</code> is
 the recommended function, there is another variant for client code
 where special circumstances make it necessary. The simpler
 version of the function is <code class="function">hb_ft_font_create()</code>,
 which takes an FT_Face and an optional destroy callback 
 as its arguments. Because <code class="function">hb_ft_font_create()</code> 
 does not offer lifecycle management, however, your client code will
 be responsible for tracking references to the FT_Face
 objects and destroying them when they are no longer needed. If you
 do not have a valid reason for doing this, use
 <code class="function">hb_ft_font_create_referenced()</code>. 
 

 After you have created your font object from your
 FT_Face, you can set or retrieve the
 <code>load_flags</code> of the
 FT_Face through the hb_font_t
 object. HarfBuzz provides
 <code class="function">hb_ft_font_set_load_flags()</code> and
 <code class="function">hb_ft_font_get_load_flags()</code> for this
 purpose. The ability to set the
 <code>load_flags</code> through the font object
 could be useful for enabling or disabling hinting, for example,
 or to activate vertical layout.
 

 HarfBuzz also provides a utility function called
 <code class="function">hb_ft_font_has_changed()</code> that you should
 call whenever you have altered the properties of your underlying
 FT_Face, as well as a
 <code class="function">hb_ft_get_face()</code> that you can call on an
 hb_font_t font object to fetch its underlying FT_Face.
 

 With an hb_face_t and hb_font_t both linked
 to your FT_Face, you will typically also want to
 use FreeType for the <code>font_funcs</code>
 vtable of your hb_font_t. As a reminder, this
 font-functions structure is the set of methods that HarfBuzz
 will use to fetch important information from the font, such as
 the advances and extents of individual glyphs. 
 

 All you need to do is call
 
<pre class="programlisting">
 hb_ft_font_set_funcs(font);
 </pre>

 and HarfBuzz will use FreeType for the font-functions in
 <code class="literal">font</code>. 
 

 As we noted above, an hb_font_t is derived from an
 hb_face_t with size (and, perhaps, other
 parameters, such as variation-axis coordinates)
 specified. Consequently, you can reuse an hb_face_t
 with several hb_font_t objects, and HarfBuzz
 provides functions to simplify this.
 

 The <code class="function">hb_ft_face_create_referenced()</code>
 function creates just an hb_face_t from a FreeType
 FT_Face and, as with
 <code class="function">hb_ft_font_create_referenced()</code> above,
 provides lifecycle management for the FT_Face.
 

 Similarly, there is an <code class="function">hb_ft_face_create()</code>
 function variant that does not provide the lifecycle-management
 feature. As with the font-object case, if you use this version
 of the function, it will be your client code's respsonsibility
 to track usage of the FT_Face objects.
 

 A third variant of this function is
 <code class="function">hb_ft_face_create_cached()</code>, which is the
 same as <code class="function">hb_ft_face_create()</code> except that it
 also uses the <code>generic</code> field of the
 FT_Face structure to save a pointer to the newly
 created hb_face_t. Subsequently, function calls
 that pass the same FT_Face will get the same
 hb_face_t returned — and the
 hb_face_t will be correctly reference
 counted. Still, as with
 <code class="function">hb_ft_face_create()</code>, your client code must
 track references to the FT_Face itself, and destroy
 it when it is unneeded.
 
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.32</div>
</body>
</html>

cmd: