<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
  "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"
[
<!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
<!ENTITY version SYSTEM "version.xml">
]>
<refentry id="pango-FreeType-Fonts-and-Rendering">
<refmeta>
<refentrytitle role="top_of_page" id="pango-FreeType-Fonts-and-Rendering.top_of_page">FreeType Fonts and Rendering</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>PANGO Library</refmiscinfo>
</refmeta>
<refnamediv>
<refname>FreeType Fonts and Rendering</refname>
<refpurpose>Font handling and rendering with FreeType</refpurpose>
</refnamediv>

<refsect1 id="pango-FreeType-Fonts-and-Rendering.functions" role="functions_proto">
<title role="functions_proto.title">Functions</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="functions_proto_type" colwidth="150px"/>
<colspec colname="functions_proto_name"/>
<tbody>
<row><entry role="function_type"><link linkend="PangoFontMap"><returnvalue>PangoFontMap</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="pango-ft2-font-map-new">pango_ft2_font_map_new</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="pango-ft2-font-map-set-resolution">pango_ft2_font_map_set_resolution</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="PangoContext"><returnvalue>PangoContext</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="pango-ft2-font-map-create-context">pango_ft2_font_map_create_context</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><phrase role="c_punctuation">(</phrase><link linkend="PangoFT2SubstituteFunc">*PangoFT2SubstituteFunc</link><phrase role="c_punctuation">)</phrase>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="pango-ft2-font-map-set-default-substitute">pango_ft2_font_map_set_default_substitute</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="pango-ft2-font-map-substitute-changed">pango_ft2_font_map_substitute_changed</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="PangoContext"><returnvalue>PangoContext</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="pango-ft2-get-context">pango_ft2_get_context</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="pango-ft2-render">pango_ft2_render</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="pango-ft2-render-transformed">pango_ft2_render_transformed</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="pango-ft2-render-layout-line">pango_ft2_render_layout_line</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="pango-ft2-render-layout-line-subpixel">pango_ft2_render_layout_line_subpixel</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="pango-ft2-render-layout">pango_ft2_render_layout</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="pango-ft2-render-layout-subpixel">pango_ft2_render_layout_subpixel</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="PangoGlyph"><returnvalue>PangoGlyph</returnvalue></link>
</entry><entry role="function_name"><link linkend="pango-ft2-get-unknown-glyph">pango_ft2_get_unknown_glyph</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="int"><returnvalue>int</returnvalue></link>
</entry><entry role="function_name"><link linkend="pango-ft2-font-get-kerning">pango_ft2_font_get_kerning</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="FT-Face"><returnvalue>FT_Face</returnvalue></link>
</entry><entry role="function_name"><link linkend="pango-ft2-font-get-face">pango_ft2_font_get_face</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="PangoCoverage"><returnvalue>PangoCoverage</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="pango-ft2-font-get-coverage">pango_ft2_font_get_coverage</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="PangoFontMap"><returnvalue>PangoFontMap</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="pango-ft2-font-map-for-display">pango_ft2_font_map_for_display</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="pango-ft2-shutdown-display">pango_ft2_shutdown_display</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<anchor id="PangoFT2FontMap"/><refsect1 id="pango-FreeType-Fonts-and-Rendering.other" role="other_proto">
<title role="other_proto.title">Types and Values</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="other_proto_type" colwidth="150px"/>
<colspec colname="other_proto_name"/>
<tbody>
<row><entry role="datatype_keyword"></entry><entry role="function_name"><link linkend="PangoFT2FontMap-struct">PangoFT2FontMap</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="pango-FreeType-Fonts-and-Rendering.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<screen>    <link linkend="GObject">GObject</link>
    <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> <link linkend="PangoFontMap">PangoFontMap</link>
        <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> <link linkend="PangoFcFontMap">PangoFcFontMap</link>
            <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> PangoFT2FontMap
</screen>
</refsect1>
<refsect1 id="pango-FreeType-Fonts-and-Rendering.implemented-interfaces" role="impl_interfaces">
<title role="impl_interfaces.title">Implemented Interfaces</title>
<para>
PangoFT2FontMap implements
 <link linkend="GListModel">GListModel</link>.</para>

</refsect1>


<refsect1 id="pango-FreeType-Fonts-and-Rendering.description" role="desc">
<title role="desc.title">Description</title>
<para>The macros and functions in this section are used to access fonts and render
text to bitmaps using the FreeType 2 library.</para>

</refsect1>
<refsect1 id="pango-FreeType-Fonts-and-Rendering.functions_details" role="details">
<title role="details.title">Functions</title>
<refsect2 id="pango-ft2-font-map-new" role="function" condition="since:1.2">
<title>pango_ft2_font_map_new&#160;()</title>
<indexterm zone="pango-ft2-font-map-new" role="1.2"><primary>pango_ft2_font_map_new</primary></indexterm>
<programlisting language="C"><link linkend="PangoFontMap"><returnvalue>PangoFontMap</returnvalue></link>&#160;*
pango_ft2_font_map_new (<parameter><type>void</type></parameter>);</programlisting>
<para>Create a new <link linkend="PangoFT2FontMap"><type>PangoFT2FontMap</type></link> object; a fontmap is used
to cache information about available fonts, and holds
certain global parameters such as the resolution and
the default substitute function (see
<link linkend="pango-ft2-font-map-set-default-substitute"><function>pango_ft2_font_map_set_default_substitute()</function></link>).</para>
<refsect3 id="pango-ft2-font-map-new.returns" role="returns">
<title>Returns</title>
<para> the newly created fontmap object. Unref
with <link linkend="g-object-unref"><function>g_object_unref()</function></link> when you are finished with it.</para>
</refsect3><para role="since">Since: <link linkend="api-index-1.2">1.2</link></para></refsect2>
<refsect2 id="pango-ft2-font-map-set-resolution" role="function" condition="since:1.2">
<title>pango_ft2_font_map_set_resolution&#160;()</title>
<indexterm zone="pango-ft2-font-map-set-resolution" role="1.2"><primary>pango_ft2_font_map_set_resolution</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
pango_ft2_font_map_set_resolution (<parameter><link linkend="PangoFT2FontMap"><type>PangoFT2FontMap</type></link> *fontmap</parameter>,
                                   <parameter><link linkend="double"><type>double</type></link> dpi_x</parameter>,
                                   <parameter><link linkend="double"><type>double</type></link> dpi_y</parameter>);</programlisting>
<para>Sets the horizontal and vertical resolutions for the fontmap.</para>
<refsect3 id="pango-ft2-font-map-set-resolution.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>fontmap</para></entry>
<entry role="parameter_description"><para>a <link linkend="PangoFT2FontMap"><type>PangoFT2FontMap</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>dpi_x</para></entry>
<entry role="parameter_description"><para>dots per inch in the X direction</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>dpi_y</para></entry>
<entry role="parameter_description"><para>dots per inch in the Y direction</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para role="since">Since: <link linkend="api-index-1.2">1.2</link></para></refsect2>
<refsect2 id="pango-ft2-font-map-create-context" role="function" condition="deprecated:1.22: Use pango_font_map_create_context() instead.|since:1.2">
<title>pango_ft2_font_map_create_context&#160;()</title>
<indexterm zone="pango-ft2-font-map-create-context" role="deprecated"><primary>pango_ft2_font_map_create_context</primary></indexterm><indexterm zone="pango-ft2-font-map-create-context" role="1.2"><primary>pango_ft2_font_map_create_context</primary></indexterm>
<programlisting language="C"><link linkend="PangoContext"><returnvalue>PangoContext</returnvalue></link>&#160;*
pango_ft2_font_map_create_context (<parameter><link linkend="PangoFT2FontMap"><type>PangoFT2FontMap</type></link> *fontmap</parameter>);</programlisting>
<warning><para><literal>pango_ft2_font_map_create_context</literal> has been deprecated since version 1.22 and should not be used in newly-written code.</para> <para>Use <link linkend="pango-font-map-create-context"><function>pango_font_map_create_context()</function></link> instead.</para>
</warning>
<para>Create a <link linkend="PangoContext"><type>PangoContext</type></link> for the given fontmap.</para>

<para><emphasis role="annotation">[<acronym>skip</acronym>]</emphasis></para><refsect3 id="pango-ft2-font-map-create-context.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>fontmap</para></entry>
<entry role="parameter_description"><para>a <link linkend="PangoFT2FontMap"><type>PangoFT2FontMap</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="pango-ft2-font-map-create-context.returns" role="returns">
<title>Returns</title>
<para>the newly created context; free with
<link linkend="g-object-unref"><function>g_object_unref()</function></link>. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>]</emphasis></para>
</refsect3><para role="since">Since: <link linkend="api-index-1.2">1.2</link></para></refsect2>
<refsect2 id="PangoFT2SubstituteFunc" role="function">
<title>PangoFT2SubstituteFunc&#160;()</title>
<indexterm zone="PangoFT2SubstituteFunc"><primary>PangoFT2SubstituteFunc</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
<phrase role="c_punctuation">(</phrase>*PangoFT2SubstituteFunc<phrase role="c_punctuation">)</phrase> (<parameter><link linkend="FcPattern"><type>FcPattern</type></link> *pattern</parameter>,
                           <parameter><link linkend="gpointer"><type>gpointer</type></link> data</parameter>);</programlisting>
<para>Function type for doing final config tweaking on prepared FcPatterns.</para>
<refsect3 id="PangoFT2SubstituteFunc.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pattern</para></entry>
<entry role="parameter_description"><para>the <type>FcPattern</type> to tweak.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>data</para></entry>
<entry role="parameter_description"><para>user data.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="pango-ft2-font-map-set-default-substitute" role="function" condition="since:1.2">
<title>pango_ft2_font_map_set_default_substitute&#160;()</title>
<indexterm zone="pango-ft2-font-map-set-default-substitute" role="1.2"><primary>pango_ft2_font_map_set_default_substitute</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
pango_ft2_font_map_set_default_substitute
                               (<parameter><link linkend="PangoFT2FontMap"><type>PangoFT2FontMap</type></link> *fontmap</parameter>,
                                <parameter><link linkend="PangoFT2SubstituteFunc"><type>PangoFT2SubstituteFunc</type></link> func</parameter>,
                                <parameter><link linkend="gpointer"><type>gpointer</type></link> data</parameter>,
                                <parameter><link linkend="GDestroyNotify"><type>GDestroyNotify</type></link> notify</parameter>);</programlisting>
<para>Sets a function that will be called to do final configuration
substitution on a <link linkend="FcPattern"><type>FcPattern</type></link> before it is used to load
the font. This function can be used to do things like set
hinting and antialiasing options.</para>
<refsect3 id="pango-ft2-font-map-set-default-substitute.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>fontmap</para></entry>
<entry role="parameter_description"><para>a <link linkend="PangoFT2FontMap"><type>PangoFT2FontMap</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>func</para></entry>
<entry role="parameter_description"><para>function to call to to do final config tweaking
on <link linkend="FcPattern"><type>FcPattern</type></link> objects.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>data</para></entry>
<entry role="parameter_description"><para>data to pass to <parameter>func</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>notify</para></entry>
<entry role="parameter_description"><para>function to call when <parameter>data</parameter>
is no longer used.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para role="since">Since: <link linkend="api-index-1.2">1.2</link></para></refsect2>
<refsect2 id="pango-ft2-font-map-substitute-changed" role="function" condition="since:1.2">
<title>pango_ft2_font_map_substitute_changed&#160;()</title>
<indexterm zone="pango-ft2-font-map-substitute-changed" role="1.2"><primary>pango_ft2_font_map_substitute_changed</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
pango_ft2_font_map_substitute_changed (<parameter><link linkend="PangoFT2FontMap"><type>PangoFT2FontMap</type></link> *fontmap</parameter>);</programlisting>
<para>Call this function any time the results of the
default substitution function set with
<link linkend="pango-ft2-font-map-set-default-substitute"><function>pango_ft2_font_map_set_default_substitute()</function></link> change.
That is, if your substitution function will return different
results for the same input pattern, you must call this function.</para>
<refsect3 id="pango-ft2-font-map-substitute-changed.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>fontmap</para></entry>
<entry role="parameter_description"><para>a <link linkend="PangoFT2FontMap"><type>PangoFT2FontMap</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para role="since">Since: <link linkend="api-index-1.2">1.2</link></para></refsect2>
<refsect2 id="pango-ft2-get-context" role="function" condition="deprecated:1.22: Use pango_font_map_create_context() instead.">
<title>pango_ft2_get_context&#160;()</title>
<indexterm zone="pango-ft2-get-context" role="deprecated"><primary>pango_ft2_get_context</primary></indexterm>
<programlisting language="C"><link linkend="PangoContext"><returnvalue>PangoContext</returnvalue></link>&#160;*
pango_ft2_get_context (<parameter><link linkend="double"><type>double</type></link> dpi_x</parameter>,
                       <parameter><link linkend="double"><type>double</type></link> dpi_y</parameter>);</programlisting>
<warning><para><literal>pango_ft2_get_context</literal> has been deprecated since version 1.22 and should not be used in newly-written code.</para> <para>Use <link linkend="pango-font-map-create-context"><function>pango_font_map_create_context()</function></link> instead.</para>
</warning>
<para>Retrieves a <link linkend="PangoContext"><type>PangoContext</type></link> for the default PangoFT2 fontmap
(see <link linkend="pango-ft2-font-map-for-display"><function>pango_ft2_font_map_for_display()</function></link>) and sets the resolution
for the default fontmap to <parameter>dpi_x</parameter>
 by <parameter>dpi_y</parameter>
.</para>

<para><emphasis role="annotation">[<acronym>skip</acronym>]</emphasis></para><refsect3 id="pango-ft2-get-context.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>dpi_x</para></entry>
<entry role="parameter_description"><para>the horizontal DPI of the target device</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>dpi_y</para></entry>
<entry role="parameter_description"><para>the vertical DPI of the target device</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="pango-ft2-get-context.returns" role="returns">
<title>Returns</title>
<para>the new <link linkend="PangoContext"><type>PangoContext</type></link>. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="pango-ft2-render" role="function">
<title>pango_ft2_render&#160;()</title>
<indexterm zone="pango-ft2-render"><primary>pango_ft2_render</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
pango_ft2_render (<parameter><link linkend="FT-Bitmap"><type>FT_Bitmap</type></link> *bitmap</parameter>,
                  <parameter><link linkend="PangoFont"><type>PangoFont</type></link> *font</parameter>,
                  <parameter><link linkend="PangoGlyphString"><type>PangoGlyphString</type></link> *glyphs</parameter>,
                  <parameter><link linkend="gint"><type>gint</type></link> x</parameter>,
                  <parameter><link linkend="gint"><type>gint</type></link> y</parameter>);</programlisting>
<para>Renders a <link linkend="PangoGlyphString"><type>PangoGlyphString</type></link> onto a FreeType2 bitmap.</para>
<refsect3 id="pango-ft2-render.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bitmap</para></entry>
<entry role="parameter_description"><para>the FreeType2 bitmap onto which to draw the string</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>font</para></entry>
<entry role="parameter_description"><para>the font in which to draw the string</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>glyphs</para></entry>
<entry role="parameter_description"><para>the glyph string to draw</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>x</para></entry>
<entry role="parameter_description"><para>the x position of the start of the string (in pixels)</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>y</para></entry>
<entry role="parameter_description"><para>the y position of the baseline (in pixels)</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="pango-ft2-render-transformed" role="function" condition="since:1.6">
<title>pango_ft2_render_transformed&#160;()</title>
<indexterm zone="pango-ft2-render-transformed" role="1.6"><primary>pango_ft2_render_transformed</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
pango_ft2_render_transformed (<parameter><link linkend="FT-Bitmap"><type>FT_Bitmap</type></link> *bitmap</parameter>,
                              <parameter>const <link linkend="PangoMatrix"><type>PangoMatrix</type></link> *matrix</parameter>,
                              <parameter><link linkend="PangoFont"><type>PangoFont</type></link> *font</parameter>,
                              <parameter><link linkend="PangoGlyphString"><type>PangoGlyphString</type></link> *glyphs</parameter>,
                              <parameter><link linkend="int"><type>int</type></link> x</parameter>,
                              <parameter><link linkend="int"><type>int</type></link> y</parameter>);</programlisting>
<para>Renders a <link linkend="PangoGlyphString"><type>PangoGlyphString</type></link> onto a FreeType2 bitmap, possibly
transforming the layed-out coordinates through a transformation
matrix. Note that the transformation matrix for <parameter>font</parameter>
 is not
changed, so to produce correct rendering results, the <parameter>font</parameter>

must have been loaded using a <link linkend="PangoContext"><type>PangoContext</type></link> with an identical
transformation matrix to that passed in to this function.</para>
<refsect3 id="pango-ft2-render-transformed.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bitmap</para></entry>
<entry role="parameter_description"><para>the FreeType2 bitmap onto which to draw the string</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>font</para></entry>
<entry role="parameter_description"><para>the font in which to draw the string</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>matrix</para></entry>
<entry role="parameter_description"><para>a <link linkend="PangoMatrix"><type>PangoMatrix</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> to use an identity
transformation. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>glyphs</para></entry>
<entry role="parameter_description"><para>the glyph string to draw</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>x</para></entry>
<entry role="parameter_description"><para>the x position of the start of the string (in Pango
units in user space coordinates)</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>y</para></entry>
<entry role="parameter_description"><para>the y position of the baseline (in Pango units
in user space coordinates)</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para role="since">Since: <link linkend="api-index-1.6">1.6</link></para></refsect2>
<refsect2 id="pango-ft2-render-layout-line" role="function">
<title>pango_ft2_render_layout_line&#160;()</title>
<indexterm zone="pango-ft2-render-layout-line"><primary>pango_ft2_render_layout_line</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
pango_ft2_render_layout_line (<parameter><link linkend="FT-Bitmap"><type>FT_Bitmap</type></link> *bitmap</parameter>,
                              <parameter><link linkend="PangoLayoutLine"><type>PangoLayoutLine</type></link> *line</parameter>,
                              <parameter><link linkend="int"><type>int</type></link> x</parameter>,
                              <parameter><link linkend="int"><type>int</type></link> y</parameter>);</programlisting>
<para>Render a <link linkend="PangoLayoutLine"><type>PangoLayoutLine</type></link> onto a FreeType2 bitmap</para>
<refsect3 id="pango-ft2-render-layout-line.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bitmap</para></entry>
<entry role="parameter_description"><para>a <type>FT_Bitmap</type> to render the line onto</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>line</para></entry>
<entry role="parameter_description"><para>a <link linkend="PangoLayoutLine"><type>PangoLayoutLine</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>x</para></entry>
<entry role="parameter_description"><para>the x position of start of string (in pixels)</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>y</para></entry>
<entry role="parameter_description"><para>the y position of baseline (in pixels)</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="pango-ft2-render-layout-line-subpixel" role="function" condition="since:1.6">
<title>pango_ft2_render_layout_line_subpixel&#160;()</title>
<indexterm zone="pango-ft2-render-layout-line-subpixel" role="1.6"><primary>pango_ft2_render_layout_line_subpixel</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
pango_ft2_render_layout_line_subpixel (<parameter><link linkend="FT-Bitmap"><type>FT_Bitmap</type></link> *bitmap</parameter>,
                                       <parameter><link linkend="PangoLayoutLine"><type>PangoLayoutLine</type></link> *line</parameter>,
                                       <parameter><link linkend="int"><type>int</type></link> x</parameter>,
                                       <parameter><link linkend="int"><type>int</type></link> y</parameter>);</programlisting>
<para>Render a <link linkend="PangoLayoutLine"><type>PangoLayoutLine</type></link> onto a FreeType2 bitmap, with he
location specified in fixed-point Pango units rather than
pixels. (Using this will avoid extra inaccuracies from
rounding to integer pixels multiple times, even if the
final glyph positions are integers.)</para>
<refsect3 id="pango-ft2-render-layout-line-subpixel.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bitmap</para></entry>
<entry role="parameter_description"><para>a <type>FT_Bitmap</type> to render the line onto</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>line</para></entry>
<entry role="parameter_description"><para>a <link linkend="PangoLayoutLine"><type>PangoLayoutLine</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>x</para></entry>
<entry role="parameter_description"><para>the x position of start of string (in Pango units)</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>y</para></entry>
<entry role="parameter_description"><para>the y position of baseline (in Pango units)</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para role="since">Since: <link linkend="api-index-1.6">1.6</link></para></refsect2>
<refsect2 id="pango-ft2-render-layout" role="function">
<title>pango_ft2_render_layout&#160;()</title>
<indexterm zone="pango-ft2-render-layout"><primary>pango_ft2_render_layout</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
pango_ft2_render_layout (<parameter><link linkend="FT-Bitmap"><type>FT_Bitmap</type></link> *bitmap</parameter>,
                         <parameter><link linkend="PangoLayout"><type>PangoLayout</type></link> *layout</parameter>,
                         <parameter><link linkend="int"><type>int</type></link> x</parameter>,
                         <parameter><link linkend="int"><type>int</type></link> y</parameter>);</programlisting>
<para>Render a <link linkend="PangoLayout"><type>PangoLayout</type></link> onto a FreeType2 bitmap</para>
<refsect3 id="pango-ft2-render-layout.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bitmap</para></entry>
<entry role="parameter_description"><para>a <type>FT_Bitmap</type> to render the layout onto</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>layout</para></entry>
<entry role="parameter_description"><para>a <link linkend="PangoLayout"><type>PangoLayout</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>x</para></entry>
<entry role="parameter_description"><para>the X position of the left of the layout (in pixels)</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>y</para></entry>
<entry role="parameter_description"><para>the Y position of the top of the layout (in pixels)</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="pango-ft2-render-layout-subpixel" role="function" condition="since:1.6">
<title>pango_ft2_render_layout_subpixel&#160;()</title>
<indexterm zone="pango-ft2-render-layout-subpixel" role="1.6"><primary>pango_ft2_render_layout_subpixel</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
pango_ft2_render_layout_subpixel (<parameter><link linkend="FT-Bitmap"><type>FT_Bitmap</type></link> *bitmap</parameter>,
                                  <parameter><link linkend="PangoLayout"><type>PangoLayout</type></link> *layout</parameter>,
                                  <parameter><link linkend="int"><type>int</type></link> x</parameter>,
                                  <parameter><link linkend="int"><type>int</type></link> y</parameter>);</programlisting>
<para>Render a <link linkend="PangoLayout"><type>PangoLayout</type></link> onto a FreeType2 bitmap, with he
location specified in fixed-point Pango units rather than
pixels. (Using this will avoid extra inaccuracies from
rounding to integer pixels multiple times, even if the
final glyph positions are integers.)</para>
<refsect3 id="pango-ft2-render-layout-subpixel.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bitmap</para></entry>
<entry role="parameter_description"><para>a <type>FT_Bitmap</type> to render the layout onto</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>layout</para></entry>
<entry role="parameter_description"><para>a <link linkend="PangoLayout"><type>PangoLayout</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>x</para></entry>
<entry role="parameter_description"><para>the X position of the left of the layout (in Pango units)</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>y</para></entry>
<entry role="parameter_description"><para>the Y position of the top of the layout (in Pango units)</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para role="since">Since: <link linkend="api-index-1.6">1.6</link></para></refsect2>
<refsect2 id="pango-ft2-get-unknown-glyph" role="function" condition="deprecated:">
<title>pango_ft2_get_unknown_glyph&#160;()</title>
<indexterm zone="pango-ft2-get-unknown-glyph" role="deprecated"><primary>pango_ft2_get_unknown_glyph</primary></indexterm>
<programlisting language="C"><link linkend="PangoGlyph"><returnvalue>PangoGlyph</returnvalue></link>
pango_ft2_get_unknown_glyph (<parameter><link linkend="PangoFont"><type>PangoFont</type></link> *font</parameter>);</programlisting>
<warning><para><literal>pango_ft2_get_unknown_glyph</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>Return the index of a glyph suitable for drawing unknown characters with
<parameter>font</parameter>
, or <link linkend="PANGO-GLYPH-EMPTY:CAPS"><literal>PANGO_GLYPH_EMPTY</literal></link> if no suitable glyph found.</para>
<para>If you want to draw an unknown-box for a character that is not covered
by the font,
use <link linkend="PANGO-GET-UNKNOWN-GLYPH:CAPS"><function>PANGO_GET_UNKNOWN_GLYPH()</function></link> instead.</para>
<refsect3 id="pango-ft2-get-unknown-glyph.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>font</para></entry>
<entry role="parameter_description"><para>a <link linkend="PangoFont"><type>PangoFont</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="pango-ft2-get-unknown-glyph.returns" role="returns">
<title>Returns</title>
<para> a glyph index into <parameter>font</parameter>
, or <link linkend="PANGO-GLYPH-EMPTY:CAPS"><literal>PANGO_GLYPH_EMPTY</literal></link></para>
</refsect3></refsect2>
<refsect2 id="pango-ft2-font-get-kerning" role="function" condition="deprecated:">
<title>pango_ft2_font_get_kerning&#160;()</title>
<indexterm zone="pango-ft2-font-get-kerning" role="deprecated"><primary>pango_ft2_font_get_kerning</primary></indexterm>
<programlisting language="C"><link linkend="int"><returnvalue>int</returnvalue></link>
pango_ft2_font_get_kerning (<parameter><link linkend="PangoFont"><type>PangoFont</type></link> *font</parameter>,
                            <parameter><link linkend="PangoGlyph"><type>PangoGlyph</type></link> left</parameter>,
                            <parameter><link linkend="PangoGlyph"><type>PangoGlyph</type></link> right</parameter>);</programlisting>
<warning><para><literal>pango_ft2_font_get_kerning</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>Retrieves kerning information for a combination of two glyphs.</para>
<para>Use <link linkend="pango-fc-font-kern-glyphs"><function>pango_fc_font_kern_glyphs()</function></link> instead.</para>
<refsect3 id="pango-ft2-font-get-kerning.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>font</para></entry>
<entry role="parameter_description"><para>a <link linkend="PangoFont"><type>PangoFont</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>left</para></entry>
<entry role="parameter_description"><para>the left <link linkend="PangoGlyph"><type>PangoGlyph</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>right</para></entry>
<entry role="parameter_description"><para>the right <link linkend="PangoGlyph"><type>PangoGlyph</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="pango-ft2-font-get-kerning.returns" role="returns">
<title>Returns</title>
<para> The amount of kerning (in Pango units) to apply for
the given combination of glyphs.</para>
</refsect3></refsect2>
<refsect2 id="pango-ft2-font-get-face" role="function" condition="deprecated:">
<title>pango_ft2_font_get_face&#160;()</title>
<indexterm zone="pango-ft2-font-get-face" role="deprecated"><primary>pango_ft2_font_get_face</primary></indexterm>
<programlisting language="C"><link linkend="FT-Face"><returnvalue>FT_Face</returnvalue></link>
pango_ft2_font_get_face (<parameter><link linkend="PangoFont"><type>PangoFont</type></link> *font</parameter>);</programlisting>
<warning><para><literal>pango_ft2_font_get_face</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>Returns the native FreeType2 <literal>FT_Face</literal> structure used for this <link linkend="PangoFont"><type>PangoFont</type></link>.
This may be useful if you want to use FreeType2 functions directly.</para>
<para>Use <link linkend="pango-fc-font-lock-face"><function>pango_fc_font_lock_face()</function></link> instead; when you are done with a
face from <link linkend="pango-fc-font-lock-face"><function>pango_fc_font_lock_face()</function></link> you must call
<link linkend="pango-fc-font-unlock-face"><function>pango_fc_font_unlock_face()</function></link>.</para>

<para><emphasis role="annotation">[<acronym>skip</acronym>]</emphasis></para><refsect3 id="pango-ft2-font-get-face.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>font</para></entry>
<entry role="parameter_description"><para>a <link linkend="PangoFont"><type>PangoFont</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="pango-ft2-font-get-face.returns" role="returns">
<title>Returns</title>
<para>a pointer to a <literal>FT_Face</literal> structure, with the
size set correctly, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if <parameter>font</parameter>
is <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para>
<para><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="pango-ft2-font-get-coverage" role="function" condition="deprecated:">
<title>pango_ft2_font_get_coverage&#160;()</title>
<indexterm zone="pango-ft2-font-get-coverage" role="deprecated"><primary>pango_ft2_font_get_coverage</primary></indexterm>
<programlisting language="C"><link linkend="PangoCoverage"><returnvalue>PangoCoverage</returnvalue></link>&#160;*
pango_ft2_font_get_coverage (<parameter><link linkend="PangoFont"><type>PangoFont</type></link> *font</parameter>,
                             <parameter><link linkend="PangoLanguage"><type>PangoLanguage</type></link> *language</parameter>);</programlisting>
<warning><para><literal>pango_ft2_font_get_coverage</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>Gets the <link linkend="PangoCoverage"><type>PangoCoverage</type></link> for a <literal>PangoFT2Font</literal>. Use
<link linkend="pango-font-get-coverage"><function>pango_font_get_coverage()</function></link> instead.</para>
<refsect3 id="pango-ft2-font-get-coverage.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>font</para></entry>
<entry role="parameter_description"><para>a Pango FT2 font</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>language</para></entry>
<entry role="parameter_description"><para>a language tag.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="pango-ft2-font-get-coverage.returns" role="returns">
<title>Returns</title>
<para>a <link linkend="PangoCoverage"><type>PangoCoverage</type></link>. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="pango-ft2-font-map-for-display" role="function" condition="deprecated:">
<title>pango_ft2_font_map_for_display&#160;()</title>
<indexterm zone="pango-ft2-font-map-for-display" role="deprecated"><primary>pango_ft2_font_map_for_display</primary></indexterm>
<programlisting language="C"><link linkend="PangoFontMap"><returnvalue>PangoFontMap</returnvalue></link>&#160;*
pango_ft2_font_map_for_display (<parameter><type>void</type></parameter>);</programlisting>
<warning><para><literal>pango_ft2_font_map_for_display</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>Returns a <link linkend="PangoFT2FontMap"><type>PangoFT2FontMap</type></link>. This font map is cached and should
not be freed. If the font map is no longer needed, it can
be released with <link linkend="pango-ft2-shutdown-display"><function>pango_ft2_shutdown_display()</function></link>. Use of the
global PangoFT2 fontmap is deprecated; use <link linkend="pango-ft2-font-map-new"><function>pango_ft2_font_map_new()</function></link>
instead.</para>

<para><emphasis role="annotation">[<acronym>skip</acronym>]</emphasis></para><refsect3 id="pango-ft2-font-map-for-display.returns" role="returns">
<title>Returns</title>
<para>a <link linkend="PangoFT2FontMap"><type>PangoFT2FontMap</type></link>. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="pango-ft2-shutdown-display" role="function" condition="deprecated:">
<title>pango_ft2_shutdown_display&#160;()</title>
<indexterm zone="pango-ft2-shutdown-display" role="deprecated"><primary>pango_ft2_shutdown_display</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
pango_ft2_shutdown_display (<parameter><type>void</type></parameter>);</programlisting>
<warning><para><literal>pango_ft2_shutdown_display</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>Free the global fontmap. (See <link linkend="pango-ft2-font-map-for-display"><function>pango_ft2_font_map_for_display()</function></link>)
Use of the global PangoFT2 fontmap is deprecated.</para>
</refsect2>

</refsect1>
<refsect1 id="pango-FreeType-Fonts-and-Rendering.other_details" role="details">
<title role="details.title">Types and Values</title>
<refsect2 id="PangoFT2FontMap-struct" role="struct">
<title>PangoFT2FontMap</title>
<indexterm zone="PangoFT2FontMap-struct"><primary>PangoFT2FontMap</primary></indexterm>
<programlisting language="C">typedef struct _PangoFT2FontMap PangoFT2FontMap;</programlisting>
<para>The <link linkend="PangoFT2FontMap"><type>PangoFT2FontMap</type></link> is the <link linkend="PangoFontMap"><type>PangoFontMap</type></link> implementation for FreeType fonts.</para>
</refsect2>

</refsect1>

</refentry>
