x-fonts.xml

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

</variablelist></refsect2>
<refsect2>
<title><anchor id="pango-x-load-font" role="function" condition="deprecated:"/>pango_x_load_font ()</title>
<indexterm role="deprecated"><primary>pango_x_load_font</primary></indexterm><programlisting><link linkend="PangoFont">PangoFont</link>*  pango_x_load_font               (<link linkend="Display">Display</link> *display,
                                             const <link linkend="gchar">gchar</link> *spec);</programlisting>
<warning><para><literal>pango_x_load_font</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Loads up a logical font based on a "fontset" style text
specification. This is not remotely useful (Pango API's generally
work in terms of <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link>) and the result may not
work correctly in all circumstances. Use of this function should
be avoided.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>display</parameter>&nbsp;:</term>
<listitem><simpara> the X display.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>spec</parameter>&nbsp;:</term>
<listitem><simpara>    a comma-separated list of XLFD's.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>a new <link linkend="PangoFont"><type>PangoFont</type></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="pango-x-get-unknown-glyph" role="function" condition="deprecated:"/>pango_x_get_unknown_glyph ()</title>
<indexterm role="deprecated"><primary>pango_x_get_unknown_glyph</primary></indexterm><programlisting><link linkend="PangoGlyph">PangoGlyph</link>  pango_x_get_unknown_glyph       (<link linkend="PangoFont">PangoFont</link> *font);</programlisting>
<warning><para><literal>pango_x_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 unknown characters;
you should generally use <link linkend="PANGO-GET-UNKNOWN-GLYPH:CAPS"><function>PANGO_GET_UNKNOWN_GLYPH()</function></link> instead,
since that may return a glyph that provides a better representation
of a particular char. (E.g., by showing hex digits, or a glyph
representative of a certain Unicode range.)</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> a glyph index into <parameter>font</parameter>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="pango-x-has-glyph" role="function" condition="deprecated:"/>pango_x_has_glyph ()</title>
<indexterm role="deprecated"><primary>pango_x_has_glyph</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>    pango_x_has_glyph               (<link linkend="PangoFont">PangoFont</link> *font,
                                             <link linkend="PangoGlyph">PangoGlyph</link> glyph);</programlisting>
<warning><para><literal>pango_x_has_glyph</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Checks if the given glyph is present in a X font.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>font</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoFont"><type>PangoFont</type></link> which must be from the X backend.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>glyph</parameter>&nbsp;:</term>
<listitem><simpara> the index of a glyph in the font. (Formed
        using the <link linkend="PANGO-X-MAKE-GLYPH:CAPS"><type>PANGO_X_MAKE_GLYPH</type></link> macro)
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the glyph is present.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="pango-x-list-subfonts" role="function" condition="deprecated:"/>pango_x_list_subfonts ()</title>
<indexterm role="deprecated"><primary>pango_x_list_subfonts</primary></indexterm><programlisting><link linkend="int">int</link>         pango_x_list_subfonts           (<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);</programlisting>
<warning><para><literal>pango_x_list_subfonts</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Lists the subfonts of a given font. The result is ordered first by charset,
and then within each charset, by the order of fonts in the font specification.</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>charsets</parameter>&nbsp;:</term>
<listitem><simpara> the charsets to list subfonts for.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>n_charsets</parameter>&nbsp;:</term>
<listitem><simpara> the number of charsets in <parameter>charsets</parameter>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>subfont_ids</parameter>&nbsp;:</term>
<listitem><simpara> location to store a pointer to an array of subfont IDs for each found subfont;
              the result must be freed using <link linkend="g-free"><function>g_free()</function></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>subfont_charsets</parameter>&nbsp;:</term>
<listitem><simpara> location to store a pointer to an array of subfont IDs for each found subfont;
              the result must be freed using <link linkend="g-free"><function>g_free()</function></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> length of the arrays stored in <parameter>subfont_ids</parameter> and
<parameter>subfont_charsets</parameter>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="pango-x-font-map-for-display" role="function" condition="deprecated:"/>pango_x_font_map_for_display ()</title>
<indexterm role="deprecated"><primary>pango_x_font_map_for_display</primary></indexterm><programlisting><link linkend="PangoFontMap">PangoFontMap</link>* pango_x_font_map_for_display  (<link linkend="Display">Display</link> *display);</programlisting>
<warning><para><literal>pango_x_font_map_for_display</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Returns a <link linkend="PangoXFontMap"><type>PangoXFontMap</type></link> for <parameter>display</parameter>. Font maps are cached and should
not be freed. If the font map for a display is no longer needed, it can
be released with <link linkend="pango-x-shutdown-display"><function>pango_x_shutdown_display()</function></link>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>display</parameter>&nbsp;:</term>
<listitem><simpara> an X <link linkend="Display"><type>Display</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> a <link linkend="PangoXFontMap"><type>PangoXFontMap</type></link> for <parameter>display</parameter>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="pango-x-shutdown-display" role="function" condition="deprecated:"/>pango_x_shutdown_display ()</title>
<indexterm role="deprecated"><primary>pango_x_shutdown_display</primary></indexterm><programlisting><link linkend="void">void</link>        pango_x_shutdown_display        (<link linkend="Display">Display</link> *display);</programlisting>
<warning><para><literal>pango_x_shutdown_display</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Free cached resources for the given X display structure.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>display</parameter>&nbsp;:</term>
<listitem><simpara> an X <link linkend="Display"><type>Display</type></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="pango-x-font-map-get-font-cache" role="function" condition="deprecated:"/>pango_x_font_map_get_font_cache ()</title>
<indexterm role="deprecated"><primary>pango_x_font_map_get_font_cache</primary></indexterm><programlisting><link linkend="PangoXFontCache">PangoXFontCache</link>* pango_x_font_map_get_font_cache
                                            (<link linkend="PangoFontMap">PangoFontMap</link> *font_map);</programlisting>
<warning><para><literal>pango_x_font_map_get_font_cache</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Obtains the font cache associated with the given font map.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>font_map</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoXFontMap"><type>PangoXFontMap</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the <link linkend="PangoXFontCache"><type>PangoXFontCache</type></link> of <parameter>font_map</parameter>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="pango-x-font-subfont-xlfd" role="function" condition="deprecated:"/>pango_x_font_subfont_xlfd ()</title>
<indexterm role="deprecated"><primary>pango_x_font_subfont_xlfd</primary></indexterm><programlisting><link linkend="char">char</link>*       pango_x_font_subfont_xlfd       (<link linkend="PangoFont">PangoFont</link> *font,
                                             <link linkend="PangoXSubfont">PangoXSubfont</link> subfont_id);</programlisting>
<warning><para><literal>pango_x_font_subfont_xlfd</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Determines the X Logical Font Description for the specified
subfont.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>font</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoFont"><type>PangoFont</type></link> which must be from the X backend.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>subfont_id</parameter>&nbsp;:</term>
<listitem><simpara> the id of a subfont within the font.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> A newly-allocated string containing the XLFD for the
subfont. This string must be freed with <link linkend="g-free"><function>g_free()</function></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="pango-x-find-first-subfont" role="function" condition="deprecated:"/>pango_x_find_first_subfont ()</title>
<indexterm role="deprecated"><primary>pango_x_find_first_subfont</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>    pango_x_find_first_subfont      (<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);</programlisting>
<warning><para><literal>pango_x_find_first_subfont</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Looks for subfonts with the <parameter>charset</parameter> charset,
in <parameter>font</parameter>, and puts the first one in *<parameter>rfont</parameter>.</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>