xft-fonts.xml

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

</variablelist><para>Since  1.2
</para></refsect2>
<refsect2>
<title><anchor id="PangoXftSubstituteFunc" role="function"/>PangoXftSubstituteFunc ()</title>
<indexterm><primary>PangoXftSubstituteFunc</primary></indexterm><programlisting><link linkend="void">void</link>        (*PangoXftSubstituteFunc)       (<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 FcPattern to tweak.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>data</parameter>&nbsp;:</term>
<listitem><simpara>user data.


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="pango-xft-substitute-changed" role="function" condition="since:1.2"/>pango_xft_substitute_changed ()</title>
<indexterm role="1.2"><primary>pango_xft_substitute_changed</primary></indexterm><programlisting><link linkend="void">void</link>        pango_xft_substitute_changed    (<link linkend="Display">Display</link> *display,
                                             <link linkend="int">int</link> screen);</programlisting>
<para>
Call this function any time the results of the
default substitution function set with
<link linkend="pango-xft-set-default-substitute"><function>pango_xft_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>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>display</parameter>&nbsp;:</term>
<listitem><simpara> an X Display
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>screen</parameter>&nbsp;:</term>
<listitem><simpara> the screen number of a screen within <parameter>display</parameter>
</simpara></listitem></varlistentry>
</variablelist><para>Since  1.2
</para></refsect2>
<refsect2>
<title><anchor id="pango-xft-shutdown-display" role="function" condition="since:1.2"/>pango_xft_shutdown_display ()</title>
<indexterm role="1.2"><primary>pango_xft_shutdown_display</primary></indexterm><programlisting><link linkend="void">void</link>        pango_xft_shutdown_display      (<link linkend="Display">Display</link> *display,
                                             <link linkend="int">int</link> screen);</programlisting>
<para>
Release any resources that have been cached for the
combination of <parameter>display</parameter> and <parameter>screen</parameter>. Note that when the
X display is closed, resources are released automatically,
without needing to call this function.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>display</parameter>&nbsp;:</term>
<listitem><simpara> an X display
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>screen</parameter>&nbsp;:</term>
<listitem><simpara> the screen number of a screen within <parameter>display</parameter>
</simpara></listitem></varlistentry>
</variablelist><para>Since  1.2
</para></refsect2>
<refsect2>
<title><anchor id="pango-xft-font-get-font" role="function"/>pango_xft_font_get_font ()</title>
<indexterm><primary>pango_xft_font_get_font</primary></indexterm><programlisting><link linkend="XftFont">XftFont</link>*    pango_xft_font_get_font         (<link linkend="PangoFont">PangoFont</link> *font);</programlisting>
<para>
Returns the XftFont of a font.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>font</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoFont"><type>PangoFont</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the XftFont associated to <parameter>font</parameter>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="pango-xft-font-get-display" role="function"/>pango_xft_font_get_display ()</title>
<indexterm><primary>pango_xft_font_get_display</primary></indexterm><programlisting><link linkend="Display">Display</link>*    pango_xft_font_get_display      (<link linkend="PangoFont">PangoFont</link> *font);</programlisting>
<para>
Returns the X display of the XftFont of a font.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>font</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoFont"><type>PangoFont</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the X display of the XftFont associated to <parameter>font</parameter>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="pango-xft-font-has-char" role="function" condition="deprecated:|since:1.2"/>pango_xft_font_has_char ()</title>
<indexterm role="deprecated"><primary>pango_xft_font_has_char</primary></indexterm><indexterm role="1.2"><primary>pango_xft_font_has_char</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>    pango_xft_font_has_char         (<link linkend="PangoFont">PangoFont</link> *font,
                                             <link linkend="gunichar">gunichar</link> wc);</programlisting>
<warning><para><literal>pango_xft_font_has_char</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Determines whether <parameter>font</parameter> has a glyph for the codepoint <parameter>wc</parameter>.
</para>
<para>
Use <link linkend="pango-fc-font-has-char"><function>pango_fc_font_has_char()</function></link> instead.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>font</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoFont"><type>PangoFont</type></link> for the Xft backend
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>wc</parameter>&nbsp;:</term>
<listitem><simpara> Unicode codepoint to look up
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if <parameter>font</parameter> has the requested codepoint.

</simpara></listitem></varlistentry>
</variablelist><para>Since  1.2
</para></refsect2>
<refsect2>
<title><anchor id="pango-xft-font-lock-face" role="function" condition="deprecated:|since:1.2"/>pango_xft_font_lock_face ()</title>
<indexterm role="deprecated"><primary>pango_xft_font_lock_face</primary></indexterm><indexterm role="1.2"><primary>pango_xft_font_lock_face</primary></indexterm><programlisting><link linkend="FT-Face">FT_Face</link>     pango_xft_font_lock_face        (<link linkend="PangoFont">PangoFont</link> *font);</programlisting>
<warning><para><literal>pango_xft_font_lock_face</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Gets the FreeType <type>FT_Face</type> associated with a font,
This face will be kept around until you call
<link linkend="pango-xft-font-unlock-face"><function>pango_xft_font_unlock_face()</function></link>.
</para>
<para>
Use <link linkend="pango-fc-font-lock-face"><function>pango_fc_font_lock_face()</function></link> instead.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>font</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoFont"><type>PangoFont</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the FreeType <type>FT_Face</type> associated with <parameter>font</parameter>.

</simpara></listitem></varlistentry>
</variablelist><para>Since  1.2
</para></refsect2>
<refsect2>
<title><anchor id="pango-xft-font-unlock-face" role="function" condition="deprecated:|since:1.2"/>pango_xft_font_unlock_face ()</title>
<indexterm role="deprecated"><primary>pango_xft_font_unlock_face</primary></indexterm><indexterm role="1.2"><primary>pango_xft_font_unlock_face</primary></indexterm><programlisting><link linkend="void">void</link>        pango_xft_font_unlock_face      (<link linkend="PangoFont">PangoFont</link> *font);</programlisting>
<warning><para><literal>pango_xft_font_unlock_face</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Releases a font previously obtained with
<link linkend="pango-xft-font-lock-face"><function>pango_xft_font_lock_face()</function></link>.
</para>
<para>
Use <link linkend="pango-fc-font-unlock-face"><function>pango_fc_font_unlock_face()</function></link> instead.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>font</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoFont"><type>PangoFont</type></link>.
</simpara></listitem></varlistentry>
</variablelist><para>Since  1.2
</para></refsect2>
<refsect2>
<title><anchor id="pango-xft-font-get-glyph" role="function" condition="deprecated:|since:1.2"/>pango_xft_font_get_glyph ()</title>
<indexterm role="deprecated"><primary>pango_xft_font_get_glyph</primary></indexterm><indexterm role="1.2"><primary>pango_xft_font_get_glyph</primary></indexterm><programlisting><link linkend="guint">guint</link>       pango_xft_font_get_glyph        (<link linkend="PangoFont">PangoFont</link> *font,
                                             <link linkend="gunichar">gunichar</link> wc);</programlisting>
<warning><para><literal>pango_xft_font_get_glyph</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Gets the glyph index for a given Unicode character
for <parameter>font</parameter>. If you only want to determine
whether the font has the glyph, use <link linkend="pango-xft-font-has-char"><function>pango_xft_font_has_char()</function></link>.
</para>
<para>
Use <link linkend="pango-fc-font-get-glyph"><function>pango_fc_font_get_glyph()</function></link> instead.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>font</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoFont"><type>PangoFont</type></link> for the Xft backend
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>wc</parameter>&nbsp;:</term>
<listitem><simpara> Unicode codepoint to look up
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the glyph index, or 0, if the Unicode
 character does not exist in the font.

</simpara></listitem></varlistentry>
</variablelist><para>Since  1.2
</para></refsect2>
<refsect2>
<title><anchor id="pango-xft-font-get-unknown-glyph" role="function" condition="deprecated:"/>pango_xft_font_get_unknown_glyph ()</title>
<indexterm role="deprecated"><primary>pango_xft_font_get_unknown_glyph</primary></indexterm><programlisting><link linkend="PangoGlyph">PangoGlyph</link>  pango_xft_font_get_unknown_glyph
                                            (<link linkend="PangoFont">PangoFont</link> *font,
                                             <link linkend="gunichar">gunichar</link> wc);</programlisting>
<warning><para><literal>pango_xft_font_get_unknown_glyph</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Returns the index of a glyph suitable for drawing <parameter>wc</parameter> as an
unknown character.
</para>
<para>
Use <link linkend="PANGO-GET-UNKNOWN-GLYPH:CAPS"><function>PANGO_GET_UNKNOWN_GLYPH()</function></link> instead.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>font</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoFont"><type>PangoFont</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>wc</parameter>&nbsp;:</term>
<listitem><simpara> the Unicode character for which a glyph is needed.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> a glyph index into <parameter>font</parameter>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="PangoXftRenderer" role="struct" condition="since:1.8"/>PangoXftRenderer</title>
<indexterm role="1.8"><primary>PangoXftRenderer</primary></indexterm><programlisting>typedef struct {
} PangoXftRenderer;
</programlisting>
<para>
<link linkend="PangoXftRenderer"><type>PangoXftRenderer</type></link> is a subclass of <link linkend="PangoRenderer"><type>PangoRenderer</type></link> used for rendering
with Pango's Xft backend. It can be used directly, or it can be
further subclassed to modify exactly how drawing of individual
elements occurs.</para>
<para>

</para><para>Since  1.8
</para></refsect2>
<refsect2>
<title><anchor id="PangoXftRendererClass" role="struct" condition="since:1.8"/>PangoXftRendererClass</title>
<indexterm role="1.8"><primary>PangoXftRendererClass</primary></indexterm><programlisting>typedef struct {
  void (*composite_trapezoids) (PangoXftRenderer *xftrenderer,
				PangoRenderPart   part,
				XTrapezoid       *trapezoids,
				int               n_trapezoids);
  void (*composite_glyphs)     (PangoXftRenderer *xftrenderer,
				XftFont          *xft_font,
				XftGlyphSpec     *glyphs,
				int               n_glyphs);
} PangoXftRendererClass;
</programlisting>
<para>
The class structure for <link linkend="PangoXftRenderer"><type>PangoXftRenderer</type></link></para>
<para>

</para><variablelist role="struct">
<varlistentry>
<term><structfield>composite_trapezoids</structfield>&nbsp;()</term>
<listitem><simpara> draw the specified trapezoids using
  the current color and other attributes for <parameter>part</parameter>
</simpara></listitem>
</varlistentry>
<varlistentry>
<term><structfield>composite_glyphs</structfield>&nbsp;()</term>
<listitem><simpara> draw the specified glyphs using
  the current foreground color and other foreground