<refentry id="pango-X-Fonts-and-Rendering"><refmeta><refentrytitle role="top_of_page">Deprecated X font backend</refentrytitle><manvolnum>3</manvolnum><refmiscinfo>PANGO Library</refmiscinfo></refmeta><refnamediv><refname>Deprecated X font backend</refname><refpurpose>Font handling and rendering with the deprecated X font backend</refpurpose><!--[<xref linkend="desc" endterm="desc.title"/>]--></refnamediv><refsynopsisdiv role="synopsis"><title role="synopsis.title">Synopsis</title><synopsis>#define             <link linkend="PANGO-RENDER-TYPE-X:CAPS">PANGO_RENDER_TYPE_X</link><link linkend="PangoContext">PangoContext</link>*       <link linkend="pango-x-get-context">pango_x_get_context</link>                 (<link linkend="Display">Display</link> *display);<link linkend="void">void</link>                <link linkend="pango-x-context-set-funcs">pango_x_context_set_funcs</link>           (<link linkend="PangoContext">PangoContext</link> *context,                                                         <link linkend="PangoGetGCFunc">PangoGetGCFunc</link> get_gc_func,                                                         <link linkend="PangoFreeGCFunc">PangoFreeGCFunc</link> free_gc_func);<link linkend="GC:CAPS">GC</link>                  (<link linkend="PangoGetGCFunc">*PangoGetGCFunc</link>)                   (<link linkend="PangoContext">PangoContext</link> *context,                                                         <link linkend="PangoColor">PangoColor</link> *color,                                                         <link linkend="GC:CAPS">GC</link> base_gc);<link linkend="void">void</link>                (<link linkend="PangoFreeGCFunc">*PangoFreeGCFunc</link>)                  (<link linkend="PangoContext">PangoContext</link> *context,                                                         <link linkend="GC:CAPS">GC</link> gc);<link linkend="void">void</link>                <link linkend="pango-x-render">pango_x_render</link>                      (<link linkend="Display">Display</link> *display,                                                         <link linkend="Drawable">Drawable</link> d,                                                         <link linkend="GC:CAPS">GC</link> gc,                                                         <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-x-render-layout-line">pango_x_render_layout_line</link>          (<link linkend="Display">Display</link> *display,                                                         <link linkend="Drawable">Drawable</link> drawable,                                                         <link linkend="GC:CAPS">GC</link> gc,                                                         <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-x-render-layout">pango_x_render_layout</link>               (<link linkend="Display">Display</link> *display,                                                         <link linkend="Drawable">Drawable</link> drawable,                                                         <link linkend="GC:CAPS">GC</link> gc,                                                         <link linkend="PangoLayout">PangoLayout</link> *layout,                                                         <link linkend="int">int</link> x,                                                         <link linkend="int">int</link> y);typedef             <link linkend="PangoXSubfont">PangoXSubfont</link>;#define             <link linkend="PANGO-X-MAKE-GLYPH:CAPS">PANGO_X_MAKE_GLYPH</link>                  (subfont,index_)#define             <link linkend="PANGO-X-GLYPH-SUBFONT:CAPS">PANGO_X_GLYPH_SUBFONT</link>               (glyph)#define             <link linkend="PANGO-X-GLYPH-INDEX:CAPS">PANGO_X_GLYPH_INDEX</link>                 (glyph)<link linkend="PangoFont">PangoFont</link>*          <link linkend="pango-x-load-font">pango_x_load_font</link>                   (<link linkend="Display">Display</link> *display,                                                         const <link linkend="gchar">gchar</link> *spec);<link linkend="PangoGlyph">PangoGlyph</link>          <link linkend="pango-x-get-unknown-glyph">pango_x_get_unknown_glyph</link>           (<link linkend="PangoFont">PangoFont</link> *font);<link linkend="gboolean">gboolean</link>            <link linkend="pango-x-has-glyph">pango_x_has_glyph</link>                   (<link linkend="PangoFont">PangoFont</link> *font,                                                         <link linkend="PangoGlyph">PangoGlyph</link> glyph);<link linkend="int">int</link>                 <link linkend="pango-x-list-subfonts">pango_x_list_subfonts</link>               (<link linkend="PangoFont">PangoFont</link> *font,                                                         <link linkend="char">char</link> **charsets,                                                         <link linkend="int">int</link> n_charsets,                                                         <link linkend="PangoXSubfont">PangoXSubfont</link> **subfont_ids,                                                         <link linkend="int">int</link> **subfont_charsets);<link linkend="PangoFontMap">PangoFontMap</link>*       <link linkend="pango-x-font-map-for-display">pango_x_font_map_for_display</link>        (<link linkend="Display">Display</link> *display);<link linkend="void">void</link>                <link linkend="pango-x-shutdown-display">pango_x_shutdown_display</link>            (<link linkend="Display">Display</link> *display);<link linkend="PangoXFontCache">PangoXFontCache</link>*    <link linkend="pango-x-font-map-get-font-cache">pango_x_font_map_get_font_cache</link>     (<link linkend="PangoFontMap">PangoFontMap</link> *font_map);<link linkend="char">char</link>*               <link linkend="pango-x-font-subfont-xlfd">pango_x_font_subfont_xlfd</link>           (<link linkend="PangoFont">PangoFont</link> *font,                                                         <link linkend="PangoXSubfont">PangoXSubfont</link> subfont_id);<link linkend="gboolean">gboolean</link>            <link linkend="pango-x-find-first-subfont">pango_x_find_first_subfont</link>          (<link linkend="PangoFont">PangoFont</link> *font,                                                         <link linkend="char">char</link> **charsets,                                                         <link linkend="int">int</link> n_charsets,                                                         <link linkend="PangoXSubfont">PangoXSubfont</link> *rfont);<link linkend="PangoGlyph">PangoGlyph</link>          <link linkend="pango-x-font-get-unknown-glyph">pango_x_font_get_unknown_glyph</link>      (<link linkend="PangoFont">PangoFont</link> *font,                                                         <link linkend="gunichar">gunichar</link> wc);<link linkend="gboolean">gboolean</link>            <link linkend="pango-x-apply-ligatures">pango_x_apply_ligatures</link>             (<link linkend="PangoFont">PangoFont</link> *font,                                                         <link linkend="PangoXSubfont">PangoXSubfont</link> subfont,                                                         <link linkend="gunichar">gunichar</link> **glyphs,                                                         <link linkend="int">int</link> *n_glyphs,                                                         <link linkend="int">int</link> **clusters);<link linkend="void">void</link>                <link linkend="pango-x-fallback-shape">pango_x_fallback_shape</link>              (<link linkend="PangoFont">PangoFont</link> *font,                                                         <link linkend="PangoGlyphString">PangoGlyphString</link> *glyphs,                                                         const <link linkend="char">char</link> *text,                                                         <link linkend="int">int</link> n_chars);                    <link linkend="PangoXFontCache">PangoXFontCache</link>;<link linkend="PangoXFontCache">PangoXFontCache</link>*    <link linkend="pango-x-font-cache-new">pango_x_font_cache_new</link>              (<link linkend="Display">Display</link> *display);<link linkend="void">void</link>                <link linkend="pango-x-font-cache-free">pango_x_font_cache_free</link>             (<link linkend="PangoXFontCache">PangoXFontCache</link> *cache);<link linkend="XFontStruct">XFontStruct</link>*        <link linkend="pango-x-font-cache-load">pango_x_font_cache_load</link>             (<link linkend="PangoXFontCache">PangoXFontCache</link> *cache,                                                         const <link linkend="char">char</link> *xlfd);<link linkend="void">void</link>                <link linkend="pango-x-font-cache-unload">pango_x_font_cache_unload</link>           (<link linkend="PangoXFontCache">PangoXFontCache</link> *cache,                                                         <link linkend="XFontStruct">XFontStruct</link> *fs);</synopsis></refsynopsisdiv><refsect1 role="desc"><title role="desc.title">Description</title><para>The functions and macros in this section are for use with the oldX font backend which used server-side bitmap fonts. This font backendis no longer supported, and attempts to use it will produceunpredictable results. Use the <link linkend="pango-Xft-Fonts-and-Rendering">Xft</link>or <link linkend="pango-Cairo-Rendering">Cairo</link> backend instead.</para></refsect1><refsect1 role="details"><title role="details.title">Details</title><refsect2><title><anchor id="PANGO-RENDER-TYPE-X:CAPS" role="macro" condition="deprecated:"/>PANGO_RENDER_TYPE_X</title><indexterm role="deprecated"><primary>PANGO_RENDER_TYPE_X</primary></indexterm><programlisting>#define PANGO_RENDER_TYPE_X "PangoRenderX"</programlisting><warning><para><literal>PANGO_RENDER_TYPE_X</literal> is deprecated and should not be used in newly-written code.</para></warning><para>A string constant identifying the X renderer. The associated quark (see <link linkend="g-quark-from-string"><function>g_quark_from_string()</function></link>) is used to identify the renderer in <link linkend="pango-find-map"><function>pango_find_map()</function></link>. </para></refsect2><refsect2><title><anchor id="pango-x-get-context" role="function" condition="deprecated:"/>pango_x_get_context ()</title><indexterm role="deprecated"><primary>pango_x_get_context</primary></indexterm><programlisting><link linkend="PangoContext">PangoContext</link>*       pango_x_get_context                 (<link linkend="Display">Display</link> *display);</programlisting><warning><para><literal>pango_x_get_context</literal> is deprecated and should not be used in newly-written code.</para></warning><para>Retrieves a <link linkend="PangoContext"><type>PangoContext</type></link> appropriate for rendering with X fonts on thegiven display.</para><para></para><variablelist role="params"><varlistentry><term><parameter>display</parameter>&nbsp;:</term><listitem><simpara> an X display (As returned by <link linkend="XOpenDisplay"><function>XOpenDisplay()</function></link>.)</simpara></listitem></varlistentry><varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the new <link linkend="PangoContext"><type>PangoContext</type></link>.</simpara></listitem></varlistentry></variablelist></refsect2><refsect2><title><anchor id="pango-x-context-set-funcs" role="function" condition="deprecated:"/>pango_x_context_set_funcs ()</title><indexterm role="deprecated"><primary>pango_x_context_set_funcs</primary></indexterm><programlisting><link linkend="void">void</link>                pango_x_context_set_funcs           (<link linkend="PangoContext">PangoContext</link> *context,                                                         <link linkend="PangoGetGCFunc">PangoGetGCFunc</link> get_gc_func,                                                         <link linkend="PangoFreeGCFunc">PangoFreeGCFunc</link> free_gc_func);</programlisting><warning><para><literal>pango_x_context_set_funcs</literal> is deprecated and should not be used in newly-written code.</para></warning><para>Sets the functions that will be used to get GC's in various colors whenrendering layouts with this context.</para><para></para><variablelist role="params"><varlistentry><term><parameter>context</parameter>&nbsp;:</term><listitem><simpara> a <link linkend="PangoContext"><type>PangoContext</type></link>.</simpara></listitem></varlistentry><varlistentry><term><parameter>get_gc_func</parameter>&nbsp;:</term><listitem><simpara> function called to create a new GC for a given color.</simpara></listitem></varlistentry><varlistentry><term><parameter>free_gc_func</parameter>&nbsp;:</term><listitem><simpara> function called to free a GC created with <parameter>get_gc_func</parameter>.</simpara></listitem></varlistentry></variablelist></refsect2><refsect2><title><anchor id="PangoGetGCFunc" role="function" condition="deprecated:"/>PangoGetGCFunc ()</title><indexterm role="deprecated"><primary>PangoGetGCFunc</primary></indexterm><programlisting><link linkend="GC:CAPS">GC</link>                  (*PangoGetGCFunc)                   (<link linkend="PangoContext">PangoContext</link> *context,                                                         <link linkend="PangoColor">PangoColor</link> *color,                                                         <link linkend="GC:CAPS">GC</link> base_gc);</programlisting><warning><para><literal>PangoGetGCFunc</literal> is deprecated and should not be used in newly-written code.</para></warning><para>Specifies the type of the function used to create a new GC for a givencolor. </para><variablelist role="params"><varlistentry><term><parameter>context</parameter>&nbsp;:</term><listitem><simpara>a <link linkend="PangoContext"><type>PangoContext</type></link>.</simpara></listitem></varlistentry><varlistentry><term><parameter>color</parameter>&nbsp;:</term><listitem><simpara>the color to create a new GC for.</simpara></listitem></varlistentry><varlistentry><term><parameter>base_gc</parameter>&nbsp;:</term><listitem><simpara>the GC to base the new GC on.</simpara></listitem></varlistentry>