<refentry id="libgnomeprint-gnome-font">
<refmeta>
<refentrytitle role="top_of_page" id="libgnomeprint-gnome-font.top_of_page">gnome-font</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>
  LIBGNOMEPRINT Library
</refmiscinfo>
</refmeta>
<refnamediv>
<refname>gnome-font</refname>
<refpurpose></refpurpose>
</refnamediv>

<refsynopsisdiv id="libgnomeprint-gnome-font.synopsis" role="synopsis">
<title role="synopsis.title">Synopsis</title>

<synopsis>                    <link linkend="GnomeFont">GnomeFont</link>;
                    <link linkend="GnomeFontFace">GnomeFontFace</link>;
#define             <link linkend="gnome-font-ref">gnome_font_ref</link>                      (f)
#define             <link linkend="gnome-font-unref">gnome_font_unref</link>                    (f)
enum                <link linkend="GnomeFontWeight">GnomeFontWeight</link>;
const <link linkend="guchar"><returnvalue>guchar</returnvalue></link> *      <link linkend="gnome-font-get-name">gnome_font_get_name</link>                 (<parameter>const <link linkend="GnomeFont"><type>GnomeFont</type></link> *font</parameter>);
const <link linkend="guchar"><returnvalue>guchar</returnvalue></link> *      <link linkend="gnome-font-get-family-name">gnome_font_get_family_name</link>          (<parameter>const <link linkend="GnomeFont"><type>GnomeFont</type></link> *font</parameter>);
const <link linkend="guchar"><returnvalue>guchar</returnvalue></link> *      <link linkend="gnome-font-get-species-name">gnome_font_get_species_name</link>         (<parameter>const <link linkend="GnomeFont"><type>GnomeFont</type></link> *font</parameter>);
const <link linkend="guchar"><returnvalue>guchar</returnvalue></link> *      <link linkend="gnome-font-get-ps-name">gnome_font_get_ps_name</link>              (<parameter>const <link linkend="GnomeFont"><type>GnomeFont</type></link> *font</parameter>);
<link linkend="gint"><returnvalue>gint</returnvalue></link>                <link linkend="gnome-font-lookup-default">gnome_font_lookup_default</link>           (<parameter><link linkend="GnomeFont"><type>GnomeFont</type></link> *font</parameter>,
                                                         <parameter><link linkend="gint"><type>gint</type></link> unicode</parameter>);
<link linkend="ArtPoint"><returnvalue>ArtPoint</returnvalue></link> *          <link linkend="gnome-font-get-glyph-stdadvance">gnome_font_get_glyph_stdadvance</link>     (<parameter><link linkend="GnomeFont"><type>GnomeFont</type></link> *font</parameter>,
                                                         <parameter><link linkend="gint"><type>gint</type></link> glyph</parameter>,
                                                         <parameter><link linkend="ArtPoint"><type>ArtPoint</type></link> *advance</parameter>);
<link linkend="ArtDRect"><returnvalue>ArtDRect</returnvalue></link> *          <link linkend="gnome-font-get-glyph-stdbbox">gnome_font_get_glyph_stdbbox</link>        (<parameter><link linkend="GnomeFont"><type>GnomeFont</type></link> *font</parameter>,
                                                         <parameter><link linkend="gint"><type>gint</type></link> glyph</parameter>,
                                                         <parameter><link linkend="ArtDRect"><type>ArtDRect</type></link> *bbox</parameter>);
const <link linkend="ArtBpath"><returnvalue>ArtBpath</returnvalue></link> *    <link linkend="gnome-font-get-glyph-stdoutline">gnome_font_get_glyph_stdoutline</link>     (<parameter><link linkend="GnomeFont"><type>GnomeFont</type></link> *font</parameter>,
                                                         <parameter><link linkend="gint"><type>gint</type></link> glyph</parameter>);
<link linkend="ArtPoint"><returnvalue>ArtPoint</returnvalue></link> *          <link linkend="gnome-font-get-glyph-stdkerning">gnome_font_get_glyph_stdkerning</link>     (<parameter><link linkend="GnomeFont"><type>GnomeFont</type></link> *font</parameter>,
                                                         <parameter><link linkend="gint"><type>gint</type></link> glyph0</parameter>,
                                                         <parameter><link linkend="gint"><type>gint</type></link> glyph1</parameter>,
                                                         <parameter><link linkend="ArtPoint"><type>ArtPoint</type></link> *kerning</parameter>);
<link linkend="GnomeFontFace"><returnvalue>GnomeFontFace</returnvalue></link> *     <link linkend="gnome-font-get-face">gnome_font_get_face</link>                 (<parameter>const <link linkend="GnomeFont"><type>GnomeFont</type></link> *font</parameter>);
<link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>             <link linkend="gnome-font-get-size">gnome_font_get_size</link>                 (<parameter>const <link linkend="GnomeFont"><type>GnomeFont</type></link> *font</parameter>);
#define             <link linkend="gnome-font-get-weight-code">gnome_font_get_weight_code</link>          (f)
#define             <link linkend="gnome-font-is-italic">gnome_font_is_italic</link>                (f)
#define             <link linkend="gnome-font-is-fixed-width">gnome_font_is_fixed_width</link>           (f)
<link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>             <link linkend="gnome-font-get-ascender">gnome_font_get_ascender</link>             (<parameter><link linkend="GnomeFont"><type>GnomeFont</type></link> *font</parameter>);
<link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>             <link linkend="gnome-font-get-descender">gnome_font_get_descender</link>            (<parameter><link linkend="GnomeFont"><type>GnomeFont</type></link> *font</parameter>);
<link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>             <link linkend="gnome-font-get-underline-position">gnome_font_get_underline_position</link>   (<parameter><link linkend="GnomeFont"><type>GnomeFont</type></link> *font</parameter>);
<link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>             <link linkend="gnome-font-get-underline-thickness">gnome_font_get_underline_thickness</link>  (<parameter><link linkend="GnomeFont"><type>GnomeFont</type></link> *font</parameter>);
<link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>             <link linkend="gnome-font-get-glyph-width">gnome_font_get_glyph_width</link>          (<parameter><link linkend="GnomeFont"><type>GnomeFont</type></link> *font</parameter>,
                                                         <parameter><link linkend="gint"><type>gint</type></link> glyph</parameter>);
<link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>             <link linkend="gnome-font-get-glyph-kerning">gnome_font_get_glyph_kerning</link>        (<parameter><link linkend="GnomeFont"><type>GnomeFont</type></link> *font</parameter>,
                                                         <parameter><link linkend="gint"><type>gint</type></link> glyph1</parameter>,
                                                         <parameter><link linkend="gint"><type>gint</type></link> glyph2</parameter>);
<link linkend="GnomeFont"><returnvalue>GnomeFont</returnvalue></link> *         <link linkend="gnome-font-find-closest-from-weight-slant">gnome_font_find_closest_from_weight_slant</link>
                                                        (<parameter>const <link linkend="guchar"><type>guchar</type></link> *family</parameter>,
                                                         <parameter><link linkend="GnomeFontWeight"><type>GnomeFontWeight</type></link> weight</parameter>,
                                                         <parameter><link linkend="gboolean"><type>gboolean</type></link> italic</parameter>,
                                                         <parameter><link linkend="gdouble"><type>gdouble</type></link> size</parameter>);
<link linkend="GnomeFont"><returnvalue>GnomeFont</returnvalue></link> *         <link linkend="gnome-font-find">gnome_font_find</link>                     (<parameter>const <link linkend="guchar"><type>guchar</type></link> *name</parameter>,
                                                         <parameter><link linkend="gdouble"><type>gdouble</type></link> size</parameter>);
<link linkend="GnomeFont"><returnvalue>GnomeFont</returnvalue></link> *         <link linkend="gnome-font-find-closest">gnome_font_find_closest</link>             (<parameter>const <link linkend="guchar"><type>guchar</type></link> *name</parameter>,
                                                         <parameter><link linkend="gdouble"><type>gdouble</type></link> size</parameter>);
<link linkend="GnomeFont"><returnvalue>GnomeFont</returnvalue></link> *         <link linkend="gnome-font-find-from-full-name">gnome_font_find_from_full_name</link>      (<parameter>const <link linkend="guchar"><type>guchar</type></link> *string</parameter>);
<link linkend="GnomeFont"><returnvalue>GnomeFont</returnvalue></link> *         <link linkend="gnome-font-find-from-filename">gnome_font_find_from_filename</link>       (<parameter>const <link linkend="guchar"><type>guchar</type></link> *filename</parameter>,
                                                         <parameter><link linkend="gint"><type>gint</type></link> index_</parameter>,
                                                         <parameter><link linkend="gdouble"><type>gdouble</type></link> size</parameter>);
<link linkend="GnomeFont"><returnvalue>GnomeFont</returnvalue></link> *         <link linkend="gnome-font-find-closest-from-full-name">gnome_font_find_closest_from_full_name</link>
                                                        (<parameter>const <link linkend="guchar"><type>guchar</type></link> *string</parameter>);
<link linkend="GList"><returnvalue>GList</returnvalue></link> *             <link linkend="gnome-font-list">gnome_font_list</link>                     (<parameter><type>void</type></parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="gnome-font-list-free">gnome_font_list_free</link>                (<parameter><link linkend="GList"><type>GList</type></link> *fontlist</parameter>);
<link linkend="GList"><returnvalue>GList</returnvalue></link> *             <link linkend="gnome-font-family-list">gnome_font_family_list</link>              (<parameter><type>void</type></parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="gnome-font-family-list-free">gnome_font_family_list_free</link>         (<parameter><link linkend="GList"><type>GList</type></link> *fontlist</parameter>);
<link linkend="GList"><returnvalue>GList</returnvalue></link> *             <link linkend="gnome-font-style-list">gnome_font_style_list</link>               (<parameter>const <link linkend="guchar"><type>guchar</type></link> *family</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="gnome-font-style-list-free">gnome_font_style_list_free</link>          (<parameter><link linkend="GList"><type>GList</type></link> *styles</parameter>);
<link linkend="guchar"><returnvalue>guchar</returnvalue></link> *            <link linkend="gnome-font-get-full-name">gnome_font_get_full_name</link>            (<parameter><link linkend="GnomeFont"><type>GnomeFont</type></link> *font</parameter>);
<link linkend="PangoFont"><returnvalue>PangoFont</returnvalue></link> *         <link linkend="gnome-font-get-closest-pango-font">gnome_font_get_closest_pango_font</link>   (<parameter>const <link linkend="GnomeFont"><type>GnomeFont</type></link> *font</parameter>,
                                                         <parameter><link linkend="PangoFontMap"><type>PangoFontMap</type></link> *map</parameter>,
                                                         <parameter><link linkend="gdouble"><type>gdouble</type></link> dpi</parameter>);
<link linkend="PangoFontDescription"><returnvalue>PangoFontDescription</returnvalue></link> * <link linkend="gnome-font-get-pango-description">gnome_font_get_pango_description</link> (<parameter>const <link linkend="GnomeFont"><type>GnomeFont</type></link> *font</parameter>,
                                                         <parameter><link linkend="gdouble"><type>gdouble</type></link> dpi</parameter>);
</synopsis>
</refsynopsisdiv>

<refsect1 id="libgnomeprint-gnome-font.description" role="desc">
<title role="desc.title">Description</title>
<para>
</para>
</refsect1>
<refsect1 id="libgnomeprint-gnome-font.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="GnomeFont" role="struct">
<title>GnomeFont</title>
<indexterm zone="GnomeFont"><primary>GnomeFont</primary></indexterm>
<programlisting>typedef struct _GnomeFont GnomeFont;</programlisting>
<para>
</para></refsect2>
<refsect2 id="GnomeFontFace" role="struct">
<title>GnomeFontFace</title>
<indexterm zone="GnomeFontFace"><primary>GnomeFontFace</primary></indexterm>
<programlisting>typedef struct _GnomeFontFace GnomeFontFace;</programlisting>
<para>
</para></refsect2>
<refsect2 id="gnome-font-ref" role="macro">
<title>gnome_font_ref()</title>
<indexterm zone="gnome-font-ref"><primary>gnome_font_ref</primary></indexterm>
<programlisting>#define             gnome_font_ref(f)</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>f</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-font-unref" role="macro">
<title>gnome_font_unref()</title>
<indexterm zone="gnome-font-unref"><primary>gnome_font_unref</primary></indexterm>
<programlisting>#define             gnome_font_unref(f)</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>f</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="GnomeFontWeight" role="enum">
<title>enum GnomeFontWeight</title>
<indexterm zone="GnomeFontWeight"><primary>GnomeFontWeight</primary></indexterm>
<programlisting>typedef enum {
	GNOME_FONT_LIGHTEST = 100,
	GNOME_FONT_EXTRA_LIGHT = 100,
	GNOME_FONT_THIN = 200,
	GNOME_FONT_LIGHT = 300,
	GNOME_FONT_BOOK = 400,
	GNOME_FONT_REGULAR = 400,
	GNOME_FONT_MEDIUM = 500,
	GNOME_FONT_SEMI = 600,
	GNOME_FONT_DEMI = 600,
	GNOME_FONT_BOLD = 700,
	GNOME_FONT_HEAVY = 900,
	GNOME_FONT_EXTRABOLD = 900,
	GNOME_FONT_BLACK = 1000,
	GNOME_FONT_EXTRABLACK = 1100,
	GNOME_FONT_HEAVIEST = 1100
} GnomeFontWeight;
</programlisting>
<para>
</para></refsect2>
<refsect2 id="gnome-font-get-name" role="function">
<title>gnome_font_get_name ()</title>
<indexterm zone="gnome-font-get-name"><primary>gnome_font_get_name</primary></indexterm>
<programlisting>const <link linkend="guchar"><returnvalue>guchar</returnvalue></link> *      gnome_font_get_name                 (<parameter>const <link linkend="GnomeFont"><type>GnomeFont</type></link> *font</parameter>);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>font</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-font-get-family-name" role="function">
<title>gnome_font_get_family_name ()</title>
<indexterm zone="gnome-font-get-family-name"><primary>gnome_font_get_family_name</primary></indexterm>
<programlisting>const <link linkend="guchar"><returnvalue>guchar</returnvalue></link> *      gnome_font_get_family_name          (<parameter>const <link linkend="GnomeFont"><type>GnomeFont</type></link> *font</parameter>);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>font</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-font-get-species-name" role="function">
<title>gnome_font_get_species_name ()</title>
<indexterm zone="gnome-font-get-species-name"><primary>gnome_font_get_species_name</primary></indexterm>
<programlisting>const <link linkend="guchar"><returnvalue>guchar</returnvalue></link> *      gnome_font_get_species_name         (<parameter>const <link linkend="GnomeFont"><type>GnomeFont</type></link> *font</parameter>);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>font</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-font-get-ps-name" role="function">
<title>gnome_font_get_ps_name ()</title>
<indexterm zone="gnome-font-get-ps-name"><primary>gnome_font_get_ps_name</primary></indexterm>
<programlisting>const <link linkend="guchar"><returnvalue>guchar</returnvalue></link> *      gnome_font_get_ps_name              (<parameter>const <link linkend="GnomeFont"><type>GnomeFont</type></link> *font</parameter>);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>font</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-font-lookup-default" role="function">
<title>gnome_font_lookup_default ()</title>
<indexterm zone="gnome-font-lookup-default"><primary>gnome_font_lookup_default</primary></indexterm>
<programlisting><link linkend="gint"><returnvalue>gint</returnvalue></link>                gnome_font_lookup_default           (<parameter><link linkend="GnomeFont"><type>GnomeFont</type></link> *font</parameter>,
                                                         <parameter><link linkend="gint"><type>gint</type></link> unicode</parameter>);</programlisting>
<para>
Get the glyph number corresponding to a given unicode
</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> glyph number, -1 if it is not mapped
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-font-get-glyph-stdadvance" role="function">
<title>gnome_font_get_glyph_stdadvance ()</title>
<indexterm zone="gnome-font-get-glyph-stdadvance"><primary>gnome_font_get_glyph_stdadvance</primary></indexterm>
<programlisting><link linkend="ArtPoint"><returnvalue>ArtPoint</returnvalue></link> *          gnome_font_get_glyph_stdadvance     (<parameter><link linkend="GnomeFont"><type>GnomeFont</type></link> *font</parameter>,
                                                         <parameter><link linkend="gint"><type>gint</type></link> glyph</parameter>,
                                                         <parameter><link linkend="ArtPoint"><type>ArtPoint</type></link> *advance</parameter>);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>font</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>glyph</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>advance</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-font-get-glyph-stdbbox" role="function">
<title>gnome_font_get_glyph_stdbbox ()</title>
<indexterm zone="gnome-font-get-glyph-stdbbox"><primary>gnome_font_get_glyph_stdbbox</primary></indexterm>
<programlisting><link linkend="ArtDRect"><returnvalue>ArtDRect</returnvalue></link> *          gnome_font_get_glyph_stdbbox        (<parameter><link linkend="GnomeFont"><type>GnomeFont</type></link> *font</parameter>,
                                                         <parameter><link linkend="gint"><type>gint</type></link> glyph</parameter>,
                                                         <parameter><link linkend="ArtDRect"><type>ArtDRect</type></link> *bbox</parameter>);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>font</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>glyph</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>bbox</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-font-get-glyph-stdoutline" role="function">
<title>gnome_font_get_glyph_stdoutline ()</title>
<indexterm zone="gnome-font-get-glyph-stdoutline"><primary>gnome_font_get_glyph_stdoutline</primary></indexterm>
<programlisting>const <link linkend="ArtBpath"><returnvalue>ArtBpath</returnvalue></link> *    gnome_font_get_glyph_stdoutline     (<parameter><link linkend="GnomeFont"><type>GnomeFont</type></link> *font</parameter>,
                                                         <parameter><link linkend="gint"><type>gint</type></link> glyph</parameter>);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>font</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>glyph</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-font-get-glyph-stdkerning" role="function">
<title>gnome_font_get_glyph_stdkerning ()</title>
<indexterm zone="gnome-font-get-glyph-stdkerning"><primary>gnome_font_get_glyph_stdkerning</primary></indexterm>
<programlisting><link linkend="ArtPoint"><returnvalue>ArtPoint</returnvalue></link> *          gnome_font_get_glyph_stdkerning     (<parameter><link linkend="GnomeFont"><type>GnomeFont</type></link> *font</parameter>,
                                                         <parameter><link linkend="gint"><type>gint</type></link> glyph0</parameter>,
                                                         <parameter><link linkend="gint"><type>gint</type></link> glyph1</parameter>,
                                                         <parameter><link linkend="ArtPoint"><type>ArtPoint</type></link> *kerning</parameter>);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>font</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>glyph0</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>glyph1</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>kerning</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-font-get-face" role="function">
<title>gnome_font_get_face ()</title>
<indexterm zone="gnome-font-get-face"><primary>gnome_font_get_face</primary></indexterm>
<programlisting><link linkend="GnomeFontFace"><returnvalue>GnomeFontFace</returnvalue></link> *     gnome_font_get_face                 (<parameter>const <link linkend="GnomeFont"><type>GnomeFont</type></link> *font</parameter>);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>font</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-font-get-size" role="function">
<title>gnome_font_get_size ()</title>
<indexterm zone="gnome-font-get-size"><primary>gnome_font_get_size</primary></indexterm>
<programlisting><link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>             gnome_font_get_size                 (<parameter>const <link linkend="GnomeFont"><type>GnomeFont</type></link> *font</parameter>);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>font</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-font-get-weight-code" role="macro">
<title>gnome_font_get_weight_code()</title>
<indexterm zone="gnome-font-get-weight-code"><primary>gnome_font_get_weight_code</primary></indexterm>
<programlisting>#define             gnome_font_get_weight_code(f)</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>f</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-font-is-italic" role="macro">
<title>gnome_font_is_italic()</title>
<indexterm zone="gnome-font-is-italic"><primary>gnome_font_is_italic</primary></indexterm>
<programlisting>#define             gnome_font_is_italic(f)</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>f</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-font-is-fixed-width" role="macro">
<title>gnome_font_is_fixed_width()</title>
<indexterm zone="gnome-font-is-fixed-width"><primary>gnome_font_is_fixed_width</primary></indexterm>
<programlisting>#define             gnome_font_is_fixed_width(f)</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>f</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-font-get-ascender" role="function">
<title>gnome_font_get_ascender ()</title>
<indexterm zone="gnome-font-get-ascender"><primary>gnome_font_get_ascender</primary></indexterm>
<programlisting><link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>             gnome_font_get_ascender             (<parameter><link linkend="GnomeFont"><type>GnomeFont</type></link> *font</parameter>);</programlisting>
<para>
This works with the standard Adobe encoding and without kerning or
ligatures. When the text libs get written, this function will be
deprecated.
</para><variablelist role="params">
<varlistentry><term><parameter>font</parameter>&#160;:</term>
<listitem><simpara>the GnomeFont to operate on
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The ascender of the font.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-font-get-descender" role="function">
<title>gnome_font_get_descender ()</title>
<indexterm zone="gnome-font-get-descender"><primary>gnome_font_get_descender</primary></indexterm>
<programlisting><link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>             gnome_font_get_descender            (<parameter><link linkend="GnomeFont"><type>GnomeFont</type></link> *font</parameter>);</programlisting>
<para>
This works with the standard Adobe encoding and without kerning or
ligatures. When the text libs get written, this function will be
deprecated.
</para><variablelist role="params">
<varlistentry><term><parameter>font</parameter>&#160;:</term>
<listitem><simpara>the GnomeFont to operate on
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The descender of the font.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-font-get-underline-position" role="function">
<title>gnome_font_get_underline_position ()</title>
<indexterm zone="gnome-font-get-underline-position"><primary>gnome_font_get_underline_position</primary></indexterm>
<programlisting><link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>             gnome_font_get_underline_position   (<parameter><link linkend="GnomeFont"><type>GnomeFont</type></link> *font</parameter>);</programlisting>
<para>
This works with the standard Adobe encoding and without kerning or
ligatures. When the text libs get written, this function will be
deprecated.
</para><variablelist role="params">
<varlistentry><term><parameter>font</parameter>&#160;:</term>
<listitem><simpara>the GnomeFont to operate on
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The underline position of the font.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-font-get-underline-thickness" role="function">
<title>gnome_font_get_underline_thickness ()</title>
<indexterm zone="gnome-font-get-underline-thickness"><primary>gnome_font_get_underline_thickness</primary></indexterm>
<programlisting><link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>             gnome_font_get_underline_thickness  (<parameter><link linkend="GnomeFont"><type>GnomeFont</type></link> *font</parameter>);</programlisting>
<para>
This works with the standard Adobe encoding and without kerning or
ligatures. When the text libs get written, this function will be
deprecated.
</para><variablelist role="params">
<varlistentry><term><parameter>font</parameter>&#160;:</term>
<listitem><simpara>the GnomeFont to operate on
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The underline thickness of the font.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-font-get-glyph-width" role="function">
<title>gnome_font_get_glyph_width ()</title>
<indexterm zone="gnome-font-get-glyph-width"><primary>gnome_font_get_glyph_width</primary></indexterm>
<programlisting><link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>             gnome_font_get_glyph_width          (<parameter><link linkend="GnomeFont"><type>GnomeFont</type></link> *font</parameter>,
                                                         <parameter><link linkend="gint"><type>gint</type></link> glyph</parameter>);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>font</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>glyph</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-font-get-glyph-kerning" role="function">
<title>gnome_font_get_glyph_kerning ()</title>
<indexterm zone="gnome-font-get-glyph-kerning"><primary>gnome_font_get_glyph_kerning</primary></indexterm>
<programlisting><link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>             gnome_font_get_glyph_kerning        (<parameter><link linkend="GnomeFont"><type>GnomeFont</type></link> *font</parameter>,
                                                         <parameter><link linkend="gint"><type>gint</type></link> glyph1</parameter>,
                                                         <parameter><link linkend="gint"><type>gint</type></link> glyph2</parameter>);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>font</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>glyph1</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>glyph2</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-font-find-closest-from-weight-slant" role="function">
<title>gnome_font_find_closest_from_weight_slant ()</title>
<indexterm zone="gnome-font-find-closest-from-weight-slant"><primary>gnome_font_find_closest_from_weight_slant</primary></indexterm>
<programlisting><link linkend="GnomeFont"><returnvalue>GnomeFont</returnvalue></link> *         gnome_font_find_closest_from_weight_slant
                                                        (<parameter>const <link linkend="guchar"><type>guchar</type></link> *family</parameter>,
                                                         <parameter><link linkend="GnomeFontWeight"><type>GnomeFontWeight</type></link> weight</parameter>,
                                                         <parameter><link linkend="gboolean"><type>gboolean</type></link> italic</parameter>,
                                                         <parameter><link linkend="gdouble"><type>gdouble</type></link> size</parameter>);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>family</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>weight</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>italic</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>size</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-font-find" role="function">
<title>gnome_font_find ()</title>
<indexterm zone="gnome-font-find"><primary>gnome_font_find</primary></indexterm>
<programlisting><link linkend="GnomeFont"><returnvalue>GnomeFont</returnvalue></link> *         gnome_font_find                     (<parameter>const <link linkend="guchar"><type>guchar</type></link> *name</parameter>,
                                                         <parameter><link linkend="gdouble"><type>gdouble</type></link> size</parameter>);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>name</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>size</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-font-find-closest" role="function">
<title>gnome_font_find_closest ()</title>
<indexterm zone="gnome-font-find-closest"><primary>gnome_font_find_closest</primary></indexterm>
<programlisting><link linkend="GnomeFont"><returnvalue>GnomeFont</returnvalue></link> *         gnome_font_find_closest             (<parameter>const <link linkend="guchar"><type>guchar</type></link> *name</parameter>,
                                                         <parameter><link linkend="gdouble"><type>gdouble</type></link> size</parameter>);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>name</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>size</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-font-find-from-full-name" role="function">
<title>gnome_font_find_from_full_name ()</title>
<indexterm zone="gnome-font-find-from-full-name"><primary>gnome_font_find_from_full_name</primary></indexterm>
<programlisting><link linkend="GnomeFont"><returnvalue>GnomeFont</returnvalue></link> *         gnome_font_find_from_full_name      (<parameter>const <link linkend="guchar"><type>guchar</type></link> *string</parameter>);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>string</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-font-find-from-filename" role="function">
<title>gnome_font_find_from_filename ()</title>
<indexterm zone="gnome-font-find-from-filename"><primary>gnome_font_find_from_filename</primary></indexterm>
<programlisting><link linkend="GnomeFont"><returnvalue>GnomeFont</returnvalue></link> *         gnome_font_find_from_filename       (<parameter>const <link linkend="guchar"><type>guchar</type></link> *filename</parameter>,
                                                         <parameter><link linkend="gint"><type>gint</type></link> index_</parameter>,
                                                         <parameter><link linkend="gdouble"><type>gdouble</type></link> size</parameter>);</programlisting>
<para>
Creates a font using the filename and index of the face within the file to
identify the <link linkend="GnomeFontFace"><type>GnomeFontFace</type></link>. The font must already be within
the system font database; this can't be used to access arbitrary
fonts on disk.
</para><variablelist role="params">
<varlistentry><term><parameter>filename</parameter>&#160;:</term>
<listitem><simpara>filename of a font face in the system font database
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>index_</parameter>&#160;:</term>
<listitem><simpara>index of the face within <parameter>filename</parameter>. (Font formats such as
         TTC/TrueType Collections can have multiple fonts within
         a single file.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>size</parameter>&#160;:</term>
<listitem><simpara>size (in points) at which to load the font
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a newly created font if the face could be located,
 otherwise <link linkend="NULL:CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-font-find-closest-from-full-name" role="function">
<title>gnome_font_find_closest_from_full_name ()</title>
<indexterm zone="gnome-font-find-closest-from-full-name"><primary>gnome_font_find_closest_from_full_name</primary></indexterm>
<programlisting><link linkend="GnomeFont"><returnvalue>GnomeFont</returnvalue></link> *         gnome_font_find_closest_from_full_name
                                                        (<parameter>const <link linkend="guchar"><type>guchar</type></link> *string</parameter>);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>string</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-font-list" role="function">
<title>gnome_font_list ()</title>
<indexterm zone="gnome-font-list"><primary>gnome_font_list</primary></indexterm>
<programlisting><link linkend="GList"><returnvalue>GList</returnvalue></link> *             gnome_font_list                     (<parameter><type>void</type></parameter>);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-font-list-free" role="function">
<title>gnome_font_list_free ()</title>
<indexterm zone="gnome-font-list-free"><primary>gnome_font_list_free</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                gnome_font_list_free                (<parameter><link linkend="GList"><type>GList</type></link> *fontlist</parameter>);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>fontlist</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-font-family-list" role="function">
<title>gnome_font_family_list ()</title>
<indexterm zone="gnome-font-family-list"><primary>gnome_font_family_list</primary></indexterm>
<programlisting><link linkend="GList"><returnvalue>GList</returnvalue></link> *             gnome_font_family_list              (<parameter><type>void</type></parameter>);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-font-family-list-free" role="function">
<title>gnome_font_family_list_free ()</title>
<indexterm zone="gnome-font-family-list-free"><primary>gnome_font_family_list_free</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                gnome_font_family_list_free         (<parameter><link linkend="GList"><type>GList</type></link> *fontlist</parameter>);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>fontlist</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-font-style-list" role="function">
<title>gnome_font_style_list ()</title>
<indexterm zone="gnome-font-style-list"><primary>gnome_font_style_list</primary></indexterm>
<programlisting><link linkend="GList"><returnvalue>GList</returnvalue></link> *             gnome_font_style_list               (<parameter>const <link linkend="guchar"><type>guchar</type></link> *family</parameter>);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>family</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-font-style-list-free" role="function">
<title>gnome_font_style_list_free ()</title>
<indexterm zone="gnome-font-style-list-free"><primary>gnome_font_style_list_free</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                gnome_font_style_list_free          (<parameter><link linkend="GList"><type>GList</type></link> *styles</parameter>);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>styles</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-font-get-full-name" role="function">
<title>gnome_font_get_full_name ()</title>
<indexterm zone="gnome-font-get-full-name"><primary>gnome_font_get_full_name</primary></indexterm>
<programlisting><link linkend="guchar"><returnvalue>guchar</returnvalue></link> *            gnome_font_get_full_name            (<parameter><link linkend="GnomeFont"><type>GnomeFont</type></link> *font</parameter>);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>font</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-font-get-closest-pango-font" role="function">
<title>gnome_font_get_closest_pango_font ()</title>
<indexterm zone="gnome-font-get-closest-pango-font"><primary>gnome_font_get_closest_pango_font</primary></indexterm>
<programlisting><link linkend="PangoFont"><returnvalue>PangoFont</returnvalue></link> *         gnome_font_get_closest_pango_font   (<parameter>const <link linkend="GnomeFont"><type>GnomeFont</type></link> *font</parameter>,
                                                         <parameter><link linkend="PangoFontMap"><type>PangoFontMap</type></link> *map</parameter>,
                                                         <parameter><link linkend="gdouble"><type>gdouble</type></link> dpi</parameter>);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>font</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>map</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>dpi</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-font-get-pango-description" role="function">
<title>gnome_font_get_pango_description ()</title>
<indexterm zone="gnome-font-get-pango-description"><primary>gnome_font_get_pango_description</primary></indexterm>
<programlisting><link linkend="PangoFontDescription"><returnvalue>PangoFontDescription</returnvalue></link> * gnome_font_get_pango_description (<parameter>const <link linkend="GnomeFont"><type>GnomeFont</type></link> *font</parameter>,
                                                         <parameter><link linkend="gdouble"><type>gdouble</type></link> dpi</parameter>);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>font</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>dpi</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>

</refsect1>

</refentry>
