x-fonts.xml

GTK+-2.0源码之pango-1.15.6.tar.gz

<refentry id="pango-X-Fonts-and-Rendering">
<refmeta>
<refentrytitle id="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 id="synopsis">
<title id="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 id="desc">
<title id="desc.title">Description</title>
<para>
The functions and macros in this section are for use with the old
X font backend which used server-side bitmap fonts. This font backend
is no longer supported, and attempts to use it will produce
unpredictable 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 id="details">
<title id="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 the
given 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 when
rendering 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 given
color. 
</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>