freetype-fonts.xml

Pango is a library for layout and rendering of text, with an emphasis on internationalization. Pang

<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>Functions for shape engines to manipulate FreeType fonts</refpurpose>
<!--[<xref linkend="desc" endterm="desc.title"/>]-->
</refnamediv>

<refsynopsisdiv id="pango-FreeType-Fonts-and-Rendering.synopsis" role="synopsis">
<title role="synopsis.title">Synopsis</title>
<anchor id="PangoFT2FontMap"/>
<synopsis>
                    <link linkend="PangoFT2FontMap-struct">PangoFT2FontMap</link>;
#define             <link linkend="PANGO-RENDER-TYPE-FT2:CAPS">PANGO_RENDER_TYPE_FT2</link>
<link linkend="PangoFontMap">PangoFontMap</link>*       <link linkend="pango-ft2-font-map-new">pango_ft2_font_map_new</link>              (void);
<link linkend="void">void</link>                <link linkend="pango-ft2-font-map-set-resolution">pango_ft2_font_map_set_resolution</link>   (<link linkend="PangoFT2FontMap">PangoFT2FontMap</link> *fontmap,
                                                         <link linkend="double">double</link> dpi_x,
                                                         <link linkend="double">double</link> dpi_y);
<link linkend="PangoContext">PangoContext</link>*       <link linkend="pango-ft2-font-map-create-context">pango_ft2_font_map_create_context</link>   (<link linkend="PangoFT2FontMap">PangoFT2FontMap</link> *fontmap);
<link linkend="void">void</link>                (<link linkend="PangoFT2SubstituteFunc">*PangoFT2SubstituteFunc</link>)           (<link linkend="FcPattern">FcPattern</link> *pattern,
                                                         <link linkend="gpointer">gpointer</link> data);
<link linkend="void">void</link>                <link linkend="pango-ft2-font-map-set-default-substitute">pango_ft2_font_map_set_default_substitute</link>
                                                        (<link linkend="PangoFT2FontMap">PangoFT2FontMap</link> *fontmap,
                                                         <link linkend="PangoFT2SubstituteFunc">PangoFT2SubstituteFunc</link> func,
                                                         <link linkend="gpointer">gpointer</link> data,
                                                         <link linkend="GDestroyNotify">GDestroyNotify</link> notify);
<link linkend="void">void</link>                <link linkend="pango-ft2-font-map-substitute-changed">pango_ft2_font_map_substitute_changed</link>
                                                        (<link linkend="PangoFT2FontMap">PangoFT2FontMap</link> *fontmap);
<link linkend="PangoContext">PangoContext</link>*       <link linkend="pango-ft2-get-context">pango_ft2_get_context</link>               (<link linkend="double">double</link> dpi_x,
                                                         <link linkend="double">double</link> dpi_y);
<link linkend="void">void</link>                <link linkend="pango-ft2-render">pango_ft2_render</link>                    (<link linkend="FT-Bitmap">FT_Bitmap</link> *bitmap,
                                                         <link linkend="PangoFont">PangoFont</link> *font,
                                                         <link linkend="PangoGlyphString">PangoGlyphString</link> *glyphs,
                                                         <link linkend="gint">gint</link> x,
                                                         <link linkend="gint">gint</link> y);
<link linkend="void">void</link>                <link linkend="pango-ft2-render-transformed">pango_ft2_render_transformed</link>        (<link linkend="FT-Bitmap">FT_Bitmap</link> *bitmap,
                                                         const <link linkend="PangoMatrix">PangoMatrix</link> *matrix,
                                                         <link linkend="PangoFont">PangoFont</link> *font,
                                                         <link linkend="PangoGlyphString">PangoGlyphString</link> *glyphs,
                                                         <link linkend="int">int</link> x,
                                                         <link linkend="int">int</link> y);
<link linkend="void">void</link>                <link linkend="pango-ft2-render-layout-line">pango_ft2_render_layout_line</link>        (<link linkend="FT-Bitmap">FT_Bitmap</link> *bitmap,
                                                         <link linkend="PangoLayoutLine">PangoLayoutLine</link> *line,
                                                         <link linkend="int">int</link> x,
                                                         <link linkend="int">int</link> y);
<link linkend="void">void</link>                <link linkend="pango-ft2-render-layout-line-subpixel">pango_ft2_render_layout_line_subpixel</link>
                                                        (<link linkend="FT-Bitmap">FT_Bitmap</link> *bitmap,
                                                         <link linkend="PangoLayoutLine">PangoLayoutLine</link> *line,
                                                         <link linkend="int">int</link> x,
                                                         <link linkend="int">int</link> y);
<link linkend="void">void</link>                <link linkend="pango-ft2-render-layout">pango_ft2_render_layout</link>             (<link linkend="FT-Bitmap">FT_Bitmap</link> *bitmap,
                                                         <link linkend="PangoLayout">PangoLayout</link> *layout,
                                                         <link linkend="int">int</link> x,
                                                         <link linkend="int">int</link> y);
<link linkend="void">void</link>                <link linkend="pango-ft2-render-layout-subpixel">pango_ft2_render_layout_subpixel</link>    (<link linkend="FT-Bitmap">FT_Bitmap</link> *bitmap,
                                                         <link linkend="PangoLayout">PangoLayout</link> *layout,
                                                         <link linkend="int">int</link> x,
                                                         <link linkend="int">int</link> y);
<link linkend="PangoGlyph">PangoGlyph</link>          <link linkend="pango-ft2-get-unknown-glyph">pango_ft2_get_unknown_glyph</link>         (<link linkend="PangoFont">PangoFont</link> *font);
<link linkend="int">int</link>                 <link linkend="pango-ft2-font-get-kerning">pango_ft2_font_get_kerning</link>          (<link linkend="PangoFont">PangoFont</link> *font,
                                                         <link linkend="PangoGlyph">PangoGlyph</link> left,
                                                         <link linkend="PangoGlyph">PangoGlyph</link> right);
<link linkend="FT-Face">FT_Face</link>             <link linkend="pango-ft2-font-get-face">pango_ft2_font_get_face</link>             (<link linkend="PangoFont">PangoFont</link> *font);
<link linkend="PangoCoverage">PangoCoverage</link>*      <link linkend="pango-ft2-font-get-coverage">pango_ft2_font_get_coverage</link>         (<link linkend="PangoFont">PangoFont</link> *font,
                                                         <link linkend="PangoLanguage">PangoLanguage</link> *language);
<link linkend="PangoFontMap">PangoFontMap</link>*       <link linkend="pango-ft2-font-map-for-display">pango_ft2_font_map_for_display</link>      (void);
<link linkend="void">void</link>                <link linkend="pango-ft2-shutdown-display">pango_ft2_shutdown_display</link>          (void);
</synopsis>
</refsynopsisdiv>

<refsect1 id="pango-FreeType-Fonts-and-Rendering.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<synopsis>
  <link linkend="GObject">GObject</link>
   +----<link linkend="PangoFontMap">PangoFontMap</link>
         +----<link linkend="PangoFcFontMap">PangoFcFontMap</link>
               +----PangoFT2FontMap
</synopsis>

</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.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="PangoFT2FontMap-struct" role="struct">
<title>PangoFT2FontMap</title>
<indexterm zone="PangoFT2FontMap-struct"><primary>PangoFT2FontMap</primary></indexterm><programlisting>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>
<refsect2 id="PANGO-RENDER-TYPE-FT2:CAPS" role="macro" condition="deprecated:">
<title>PANGO_RENDER_TYPE_FT2</title>
<indexterm zone="PANGO-RENDER-TYPE-FT2:CAPS" role="deprecated"><primary>PANGO_RENDER_TYPE_FT2</primary></indexterm><programlisting>#define PANGO_RENDER_TYPE_FT2 "PangoRenderFT2"
</programlisting>
<warning><para><literal>PANGO_RENDER_TYPE_FT2</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
A string constant that was used to identify shape engines that work
with the FreeType backend. See <link linkend="PANGO-RENDER-TYPE-FC:CAPS"><literal>PANGO_RENDER_TYPE_FC</literal></link> for the replacement.
</para></refsect2>
<refsect2 id="pango-ft2-font-map-new" role="function" condition="since:1.2">
<title>pango_ft2_font_map_new ()</title>
<indexterm zone="pango-ft2-font-map-new" role="1.2"><primary>pango_ft2_font_map_new</primary></indexterm><programlisting><link linkend="PangoFontMap">PangoFontMap</link>*       pango_ft2_font_map_new              (void);</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>
<para>

</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the newly created fontmap object. Unref
with <link linkend="g-object-unref"><function>g_object_unref()</function></link> when you are finished with it.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since  1.2
</para></refsect2>
<refsect2 id="pango-ft2-font-map-set-resolution" role="function" condition="since:1.2">
<title>pango_ft2_font_map_set_resolution ()</title>
<indexterm zone="pango-ft2-font-map-set-resolution" role="1.2"><primary>pango_ft2_font_map_set_resolution</primary></indexterm><programlisting><link linkend="void">void</link>                pango_ft2_font_map_set_resolution   (<link linkend="PangoFT2FontMap">PangoFT2FontMap</link> *fontmap,
                                                         <link linkend="double">double</link> dpi_x,
                                                         <link linkend="double">double</link> dpi_y);</programlisting>
<para>
Sets the horizontal and vertical resolutions for the fontmap.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>fontmap</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoFT2Fontmap"><type>PangoFT2Fontmap</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>dpi_x</parameter>&nbsp;:</term>
<listitem><simpara> dots per inch in the X direction
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>dpi_y</parameter>&nbsp;:</term>
<listitem><simpara> dots per inch in the Y direction
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since  1.2
</para></refsect2>
<refsect2 id="pango-ft2-font-map-create-context" role="function" condition="since:1.2">
<title>pango_ft2_font_map_create_context ()</title>
<indexterm zone="pango-ft2-font-map-create-context" role="1.2"><primary>pango_ft2_font_map_create_context</primary></indexterm><programlisting><link linkend="PangoContext">PangoContext</link>*       pango_ft2_font_map_create_context   (<link linkend="PangoFT2FontMap">PangoFT2FontMap</link> *fontmap);</programlisting>
<para>
Create a <link linkend="PangoContext"><type>PangoContext</type></link> for the given fontmap.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>fontmap</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoFT2Fontmap"><type>PangoFT2Fontmap</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the newly created context; free with <link linkend="g-object-unref"><function>g_object_unref()</function></link>.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since  1.2
</para></refsect2>
<refsect2 id="PangoFT2SubstituteFunc" role="function">
<title>PangoFT2SubstituteFunc ()</title>
<indexterm zone="PangoFT2SubstituteFunc"><primary>PangoFT2SubstituteFunc</primary></indexterm><programlisting><link linkend="void">void</link>                (*PangoFT2SubstituteFunc)           (<link linkend="FcPattern">FcPattern</link> *pattern,
                                                         <link linkend="gpointer">gpointer</link> data);</programlisting>
<para>
Function type for doing final config tweaking on prepared FcPatterns.
</para><variablelist role="params">
<varlistentry><term><parameter>pattern</parameter>&nbsp;:</term>
<listitem><simpara>the <type>FcPattern</type> to tweak.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>data</parameter>&nbsp;:</term>
<listitem><simpara>user data.