xft-fonts.xml

linux

<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 role="since">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 role="since">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 role="since">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-struct" role="struct"/>PangoXftRenderer</title>
<indexterm role="1.8"><primary>PangoXftRenderer</primary></indexterm><programlisting>typedef struct _PangoXftRenderer 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 role="since">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
  attributes
</simpara></listitem>
</varlistentry>
</variablelist><para role="since">Since  1.8
</para></refsect2>
<refsect2>
<title><anchor id="pango-xft-renderer-new" role="function" condition="since:1.8"/>pango_xft_renderer_new ()</title>
<indexterm role="1.8"><primary>pango_xft_renderer_new</primary></indexterm><programlisting><link linkend="PangoRenderer">PangoRenderer</link>*      pango_xft_renderer_new              (<link linkend="Display">Display</link> *display,
                                                         <link linkend="int">int</link> screen);</programlisting>
<para>
Create a new <link linkend="PangoXftRenderer"><type>PangoXftRenderer</type></link> to allow rendering Pango objects
with the Xft library. You must call <link linkend="pango-xft-renderer-set-draw"><function>pango_xft_renderer_set_draw()</function></link> before
using the renderer.</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 index of the screen for <parameter>display</parameter> to which rendering will be done
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the newly created <link linkend="PangoXftRenderer"><type>PangoXftRenderer</type></link>, which should
              be freed with <link linkend="g-object-unref"><function>g_object_unref()</function></link>.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since  1.8
</para></refsect2>
<refsect2>
<title><anchor id="pango-xft-renderer-set-draw" role="function" condition="since:1.8"/>pango_xft_renderer_set_draw ()</title>
<indexterm role="1.8"><primary>pango_xft_renderer_set_draw</primary></indexterm><programlisting><link linkend="void">void</link>                pango_xft_renderer_set_draw         (<link linkend="PangoXftRenderer">PangoXftRenderer</link> *xftrenderer,
                                                         <link linkend="XftDraw">XftDraw</link> *draw);</programlisting>
<para>
Sets the <link linkend="XftDraw"><type>XftDraw</type></link> object that the renderer is drawing to.
The renderer must not be currently active.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>xftrenderer</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoXftRenderer"><type>PangoXftRenderer</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>draw</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="XftDraw"><type>XftDraw</type></link>
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since  1.8
</para></refsect2>
<refsect2>
<title><anchor id="pango-xft-renderer-set-default-color" role="function" condition="since:1.8"/>pango_xft_renderer_set_default_color ()</title>
<indexterm role="1.8"><primary>pango_xft_renderer_set_default_color</primary></indexterm><programlisting><link linkend="void">void</link>                pango_xft_renderer_set_default_color
                                                        (<link linkend="PangoXftRenderer">PangoXftRenderer</link> *xftrenderer,
                                                         <link linkend="PangoColor">PangoColor</link> *default_color);</programlisting>
<para>
Sets the default foreground color for a <link linkend="XftRenderer"><type>XftRenderer</type></link>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>xftrenderer</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="XftRenderer"><type>XftRenderer</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>default_color</parameter>&nbsp;:</term>
<listitem><simpara> the default foreground color
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since  1.8
</para></refsect2>
<refsect2>
<title><anchor id="pango-xft-render" role="function"/>pango_xft_render ()</title>
<indexterm><primary>pango_xft_render</primary></indexterm><programlisting><link linkend="void">void</link>                pango_xft_render                    (<link linkend="XftDraw">XftDraw</link> *draw,