~ubuntu-branches/ubuntu/maverick/pango1.0/maverick-proposed

<a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> * <a class="link" href="pango-Fonts.html#pango-font-description-copy-static" title="pango_font_description_copy_static ()">pango_font_description_copy_static</a>

                                                        (const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc);

<a

>guint</a>               <a class="link" href="pango-Fonts.html#pango-font-description-hash" title="pango_font_description_hash ()">pango_font_description_hash</a>         (const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc);

<a

>gboolean</a>            <a class="link" href="pango-Fonts.html#pango-font-description-equal" title="pango_font_description_equal ()">pango_font_description_equal</a>        (const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc1,

                                                         const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc2);

void                <a class="link" href="pango-Fonts.html#pango-font-description-free" title="pango_font_description_free ()">pango_font_description_free</a>         (<a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc);

<a class="link" href="pango-Fonts.html#PangoStretch" title="enum PangoStretch">PangoStretch</a>        <a class="link" href="pango-Fonts.html#pango-font-description-get-stretch" title="pango_font_description_get_stretch ()">pango_font_description_get_stretch</a>  (const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc);

void                <a class="link" href="pango-Fonts.html#pango-font-description-set-size" title="pango_font_description_set_size ()">pango_font_description_set_size</a>     (<a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc,

                                                         <a

>gint</a> size);

<a

>gint</a>                <a class="link" href="pango-Fonts.html#pango-font-description-get-size" title="pango_font_description_get_size ()">pango_font_description_get_size</a>     (const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc);

void                <a class="link" href="pango-Fonts.html#pango-font-description-set-absolute-size" title="pango_font_description_set_absolute_size ()">pango_font_description_set_absolute_size</a>

                                                        (<a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc,

                                                         double size);

<a

>gboolean</a>            <a class="link" href="pango-Fonts.html#pango-font-description-get-size-is-absolute" title="pango_font_description_get_size_is_absolute ()">pango_font_description_get_size_is_absolute</a>

                                                        (const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc);

void                <a class="link" href="pango-Fonts.html#pango-font-description-set-gravity" title="pango_font_description_set_gravity ()">pango_font_description_set_gravity</a>  (<a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc,

void                <a class="link" href="pango-Fonts.html#pango-font-description-merge" title="pango_font_description_merge ()">pango_font_description_merge</a>        (<a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc,

                                                         const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc_to_merge,

                                                         <a

>gboolean</a> replace_existing);

void                <a class="link" href="pango-Fonts.html#pango-font-description-merge-static" title="pango_font_description_merge_static ()">pango_font_description_merge_static</a> (<a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc,

                                                         const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc_to_merge,

                                                         <a

>gboolean</a> replace_existing);

<a

>gboolean</a>            <a class="link" href="pango-Fonts.html#pango-font-description-better-match" title="pango_font_description_better_match ()">pango_font_description_better_match</a> (const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc,

                                                         const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *old_match,

                                                         const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *new_match);

<a class="link" href="PangoEngineShape.html" title="PangoEngineShape">PangoEngineShape</a> *  <a class="link" href="pango-Fonts.html#pango-font-find-shaper" title="pango_font_find_shaper ()">pango_font_find_shaper</a>              (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,

                                                         <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage">PangoLanguage</a> *language,

                                                         <a

>guint32</a> ch);

<a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> * <a class="link" href="pango-Fonts.html#pango-font-describe" title="pango_font_describe ()">pango_font_describe</a>              (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font);

<a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> * <a class="link" href="pango-Fonts.html#pango-font-describe-with-absolute-size" title="pango_font_describe_with_absolute_size ()">pango_font_describe_with_absolute_size</a>

#define             <a class="link" href="pango-Fonts.html#PANGO-IS-FONT-FAMILY--CAPS" title="PANGO_IS_FONT_FAMILY()">PANGO_IS_FONT_FAMILY</a>                (object)

const char *        <a class="link" href="pango-Fonts.html#pango-font-family-get-name" title="pango_font_family_get_name ()">pango_font_family_get_name</a>          (<a class="link" href="pango-Fonts.html#PangoFontFamily">PangoFontFamily</a> *family);

<a

>gboolean</a>            <a class="link" href="pango-Fonts.html#pango-font-family-is-monospace" title="pango_font_family_is_monospace ()">pango_font_family_is_monospace</a>      (<a class="link" href="pango-Fonts.html#PangoFontFamily">PangoFontFamily</a> *family);

void                <a class="link" href="pango-Fonts.html#pango-font-family-list-faces" title="pango_font_family_list_faces ()">pango_font_family_list_faces</a>        (<a class="link" href="pango-Fonts.html#PangoFontFamily">PangoFontFamily</a> *family,

                                                         <a class="link" href="pango-Fonts.html#PangoFontFace">PangoFontFace</a> ***faces,

                                                         int *n_sizes);

<a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> * <a class="link" href="pango-Fonts.html#pango-font-face-describe" title="pango_font_face_describe ()">pango_font_face_describe</a>         (<a class="link" href="pango-Fonts.html#PangoFontFace">PangoFontFace</a> *face);

<a

>gboolean</a>            <a class="link" href="pango-Fonts.html#pango-font-face-is-synthesized" title="pango_font_face_is_synthesized ()">pango_font_face_is_synthesized</a>      (<a class="link" href="pango-Fonts.html#PangoFontFace">PangoFontFace</a> *face);

 

                    <a class="link" href="pango-Fonts.html#PangoFontMap-struct" title="PangoFontMap">PangoFontMap</a>;

                    <a class="link" href="pango-Fonts.html#PangoFontsetClass" title="PangoFontsetClass">PangoFontsetClass</a>;

<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *         <a class="link" href="pango-Fonts.html#pango-fontset-get-font" title="pango_fontset_get_font ()">pango_fontset_get_font</a>              (<a class="link" href="pango-Fonts.html#PangoFontset">PangoFontset</a> *fontset,

                                                         <a

>guint</a> wc);

<a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics">PangoFontMetrics</a> *  <a class="link" href="pango-Fonts.html#pango-fontset-get-metrics" title="pango_fontset_get_metrics ()">pango_fontset_get_metrics</a>           (<a class="link" href="pango-Fonts.html#PangoFontset">PangoFontset</a> *fontset);

<a

>gboolean</a>            (<a class="link" href="pango-Fonts.html#PangoFontsetForeachFunc" title="PangoFontsetForeachFunc ()">*PangoFontsetForeachFunc</a>)          (<a class="link" href="pango-Fonts.html#PangoFontset">PangoFontset</a> *fontset,

                                                         <a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,

                                                         <a

>gpointer</a> data);

void                <a class="link" href="pango-Fonts.html#pango-fontset-foreach" title="pango_fontset_foreach ()">pango_fontset_foreach</a>               (<a class="link" href="pango-Fonts.html#PangoFontset">PangoFontset</a> *fontset,

                                                         <a class="link" href="pango-Fonts.html#PangoFontsetForeachFunc" title="PangoFontsetForeachFunc ()">PangoFontsetForeachFunc</a> func,

                                                         <a

>gpointer</a> data);

                    <a class="link" href="pango-Fonts.html#PangoFontsetSimple-struct" title="PangoFontsetSimple">PangoFontsetSimple</a>;

#define             <a class="link" href="pango-Fonts.html#PANGO-TYPE-FONTSET-SIMPLE--CAPS" title="PANGO_TYPE_FONTSET_SIMPLE">PANGO_TYPE_FONTSET_SIMPLE</a>

<a name="pango-Fonts.object-hierarchy"></a><h2>Object Hierarchy</h2>

<pre class="synopsis">

  <a

>GObject</a>

   +----PangoFont

         +----<a class="link" href="PangoFcFont.html" title="PangoFcFont">PangoFcFont</a>

</pre>

<pre class="synopsis">

  <a

>GObject</a>

   +----PangoFontFamily

</pre>

<pre class="synopsis">

  <a

>GObject</a>

   +----PangoFontFace

</pre>

<pre class="synopsis">

  <a

>GObject</a>

   +----PangoFontMap

         +----<a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap">PangoFcFontMap</a>

</pre>

<pre class="synopsis">

  <a

>GObject</a>

   +----PangoFontset

         +----<a class="link" href="pango-Fonts.html#PangoFontsetSimple">PangoFontsetSimple</a>

</pre>

<pre class="synopsis">

  <a

>GObject</a>

   +----<a class="link" href="pango-Fonts.html#PangoFontset">PangoFontset</a>

         +----PangoFontsetSimple

</pre>

<p>

The <a

><span class="type">GObject</span></a> type for <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>.

</p>

</div>

</pre>

<p>

The <a

><span class="type">GObject</span></a> type for <a class="link" href="pango-Fonts.html#PangoStyle" title="enum PangoStyle"><span class="type">PangoStyle</span></a>.

</p>

</div>

</pre>

<p>

The <a

><span class="type">GObject</span></a> type for <a class="link" href="pango-Fonts.html#PangoWeight" title="enum PangoWeight"><span class="type">PangoWeight</span></a>.

</p>

</div>

</pre>

<p>

The <a

><span class="type">GObject</span></a> type for <a class="link" href="pango-Fonts.html#PangoVariant" title="enum PangoVariant"><span class="type">PangoVariant</span></a>.

</p>

</div>

</pre>

<p>

The <a

><span class="type">GObject</span></a> type for <a class="link" href="pango-Fonts.html#PangoStretch" title="enum PangoStretch"><span class="type">PangoStretch</span></a>.

</p>

</div>

</pre>

<p>

The <a

><span class="type">GObject</span></a> type for <a class="link" href="pango-Fonts.html#PangoFontMask" title="enum PangoFontMask"><span class="type">PangoFontMask</span></a>.

</p>

</div>

<tr>

<td><p><span class="term"><em class="parameter"><code>desc</code></em> :</span></p></td>

<td> a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>, may be <a

><code class="literal">NULL</code></a>

</td>

</tr>

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

<td> the newly allocated <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>, which should

              be freed with <a class="link" href="pango-Fonts.html#pango-font-description-free" title="pango_font_description_free ()"><code class="function">pango_font_description_free()</code></a>, or <a

><code class="literal">NULL</code></a>

              if <em class="parameter"><code>desc</code></em> was <a

><code class="literal">NULL</code></a>.

</td>

</tr>

<tr>

<td><p><span class="term"><em class="parameter"><code>desc</code></em> :</span></p></td>

<td> a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>, may be <a

><code class="literal">NULL</code></a>

</td>

</tr>

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

<td> the newly allocated <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>, which should

              be freed with <a class="link" href="pango-Fonts.html#pango-font-description-free" title="pango_font_description_free ()"><code class="function">pango_font_description_free()</code></a>, or <a

><code class="literal">NULL</code></a>

              if <em class="parameter"><code>desc</code></em> was <a

><code class="literal">NULL</code></a>.

</td>

</tr>

<div class="refsect2" lang="en">

<a name="pango-font-description-hash"></a><h3>pango_font_description_hash ()</h3>

<pre class="programlisting"><a

>guint</a>               pango_font_description_hash         (const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc);</pre>

<p>

Computes a hash of a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a> structure suitable

to be used, for example, as an argument to <a

><code class="function">g_hash_table_new()</code></a>.

The hash value is independent of <em class="parameter"><code>desc-&gt;mask</code></em>.</p>

<p>

<div class="refsect2" lang="en">

<a name="pango-font-description-equal"></a><h3>pango_font_description_equal ()</h3>

<pre class="programlisting"><a

>gboolean</a>            pango_font_description_equal        (const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc1,

                                                         const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc2);</pre>

<p>

This means that their masks do not have to match, as long as other fields

are all the same. (Two font descriptions may result in identical fonts

being loaded, but still compare <a

><code class="literal">FALSE</code></a>.)</p>

<p>

</p>

<tr>

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

<td> <a

><code class="literal">TRUE</code></a> if the two font descriptions are identical,

         <a

><code class="literal">FALSE</code></a> otherwise.

</td>

</tr>

<tbody><tr>

<td><p><span class="term"><em class="parameter"><code>desc</code></em> :</span></p></td>

<td> a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>, may be <a

><code class="literal">NULL</code></a>

</td>

</tr></tbody>

<tr>

<td><p><span class="term"><em class="parameter"><code>descs</code></em> :</span></p></td>

<td> a pointer to an array of <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>, may be <a

><code class="literal">NULL</code></a>

</td>

</tr>

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

<td> the family name field for the font description, or

              <a

><code class="literal">NULL</code></a> if not previously set.  This has the same life-time

              as the font description itself and should not be freed.

</td>

<a name="pango-font-description-set-size"></a><h3>pango_font_description_set_size ()</h3>

<pre class="programlisting">void                pango_font_description_set_size     (<a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc,

                                                         <a

>gint</a> size);</pre>

<p>

Sets the size field of a font description in fractional points. This is mutually

<div class="refsect2" lang="en">

<a name="pango-font-description-get-size"></a><h3>pango_font_description_get_size ()</h3>

<pre class="programlisting"><a

>gint</a>                pango_font_description_get_size     (const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc);</pre>

<p>

Gets the size field of a font description.

<div class="refsect2" lang="en">

<a name="pango-font-description-get-size-is-absolute"></a><h3>pango_font_description_get_size_is_absolute ()</h3>

<pre class="programlisting"><a

>gboolean</a>            pango_font_description_get_size_is_absolute

                                                        (const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc);</pre>

<p>

<pre class="programlisting">void                pango_font_description_merge        (<a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc,

                                                         const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc_to_merge,

                                                         <a

>gboolean</a> replace_existing);</pre>

<p>

Merges the fields that are set in <em class="parameter"><code>desc_to_merge</code></em> into the fields in

<em class="parameter"><code>desc</code></em>.  If <em class="parameter"><code>replace_existing</code></em> is <a

><code class="literal">FALSE</code></a>, only fields in <em class="parameter"><code>desc</code></em> that

are not already set are affected. If <a

><code class="literal">TRUE</code></a>, then fields that are

already set will be replaced as well.

</p>

<p>

If <em class="parameter"><code>desc_to_merge</code></em> is <a

><code class="literal">NULL</code></a>, this function performs nothing.</p>

<p>

</p>

<tr>

<td><p><span class="term"><em class="parameter"><code>desc_to_merge</code></em> :</span></p></td>

<td> the <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a> to merge from, or <a

><code class="literal">NULL</code></a>

</td>

</tr>

<tr>

<td><p><span class="term"><em class="parameter"><code>replace_existing</code></em> :</span></p></td>

<td> if <a

><code class="literal">TRUE</code></a>, replace fields in <em class="parameter"><code>desc</code></em> with the

  corresponding values from <em class="parameter"><code>desc_to_merge</code></em>, even if they

  are already exist.

<pre class="programlisting">void                pango_font_description_merge_static (<a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc,

                                                         const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc_to_merge,

                                                         <a

>gboolean</a> replace_existing);</pre>

<p>

Like <a class="link" href="pango-Fonts.html#pango-font-description-merge" title="pango_font_description_merge ()"><code class="function">pango_font_description_merge()</code></a>, but only a shallow copy is made

<tr>

<td><p><span class="term"><em class="parameter"><code>replace_existing</code></em> :</span></p></td>

<td> if <a

><code class="literal">TRUE</code></a>, replace fields in <em class="parameter"><code>desc</code></em> with the

  corresponding values from <em class="parameter"><code>desc_to_merge</code></em>, even if they

  are already exist.

<div class="refsect2" lang="en">

<a name="pango-font-description-better-match"></a><h3>pango_font_description_better_match ()</h3>

<pre class="programlisting"><a

>gboolean</a>            pango_font_description_better_match (const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc,

                                                         const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *old_match,

                                                         const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *new_match);</pre>

<p>

Determines if the style attributes of <em class="parameter"><code>new_match</code></em> are a closer match

for <em class="parameter"><code>desc</code></em> than those of <em class="parameter"><code>old_match</code></em> are, or if <em class="parameter"><code>old_match</code></em> is <a

><code class="literal">NULL</code></a>,

determines if <em class="parameter"><code>new_match</code></em> is a match at all.

Approximate matching is done for

<tr>

<td><p><span class="term"><em class="parameter"><code>old_match</code></em> :</span></p></td>

<td> a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>, or <a

><code class="literal">NULL</code></a>

</td>

</tr>

<tr>

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

<td> <a

><code class="literal">TRUE</code></a> if <em class="parameter"><code>new_match</code></em> is a better match

</td>

</tr>

unit modifier "px" for absolute size. Any one of the options may

be absent.  If FAMILY-LIST is absent, then the family_name field of

the resulting font description will be initialized to <a

><code class="literal">NULL</code></a>.  If

STYLE-OPTIONS is missing, then all style options will be set to the

default values. If SIZE is missing, the size in the resulting font

<tr>

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

<td> a new string that must be freed with <a

><code class="function">g_free()</code></a>.

</td>

</tr>

<tr>

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

<td> a new string that must be freed with <a

><code class="function">g_free()</code></a>.

</td>

</tr>

<tbody>

<tr>

<td><p><span class="term"><a

>guint</a> <em class="structfield"><code>ref_count</code></em>;</span></p></td>

<td>reference count.  Used internally.  See <a class="link" href="pango-Fonts.html#pango-font-metrics-ref" title="pango_font_metrics_ref ()"><code class="function">pango_font_metrics_ref()</code></a>

            and <a class="link" href="pango-Fonts.html#pango-font-metrics-unref" title="pango_font_metrics_unref ()"><code class="function">pango_font_metrics_unref()</code></a>.

<td>approximate average width of the regular glyphs of

         the font.  Note that for this calculation, East Asian characters

         (those passing <a

><code class="function">g_unichar_iswide()</code></a>) are counted as double-width.

         This produces a more uniform value for this measure across languages

         and results in more uniform and more expected UI sizes.

</pre>

<p>

The <a

><span class="type">GObject</span></a> type for <a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics"><span class="type">PangoFontMetrics</span></a>.

</p>

</div>

<tr>

<td><p><span class="term"><em class="parameter"><code>metrics</code></em> :</span></p></td>

<td> a <a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure, may be <a

><code class="literal">NULL</code></a>

</td>

</tr>

<tbody><tr>

<td><p><span class="term"><em class="parameter"><code>metrics</code></em> :</span></p></td>

<td> a <a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure, may be <a

><code class="literal">NULL</code></a>

</td>

</tr></tbody>

</tr>

<tr>

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

</td>

</tr>

</tbody>

</tr>

<tr>

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

</td>

</tr>

</tbody>

</tr>

<tr>

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

</td>

</tr>

</tbody>

</tr>

<tr>

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

</td>

</tr>

</tbody>

</pre>

<p>

The <a

><span class="type">GObject</span></a> type for <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.

</p>

</div>

</pre>

<p>

Casts a <a

><span class="type">GObject</span></a> to a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.

</p>

<div class="variablelist"><table border="0">

<tbody><tr>

<td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>

<td>a <a

><span class="type">GObject</span></a>.

</td>

</tr></tbody>

</pre>

<p>

Returns <a

><code class="literal">TRUE</code></a> if <em class="parameter"><code>object</code></em> is a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.

</p>

<div class="variablelist"><table border="0">

<tbody><tr>

<td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>

<td>a <a

><span class="type">GObject</span></a>.

</td>

</tr></tbody>

<pre class="programlisting"><a class="link" href="PangoEngineShape.html" title="PangoEngineShape">PangoEngineShape</a> *  pango_font_find_shaper              (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,

                                                         <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage">PangoLanguage</a> *language,

                                                         <a

>guint32</a> ch);</pre>

<p>

Finds the best matching shaper for a font for a particular

</p>

<p>

If <em class="parameter"><code>font</code></em> is <a

><code class="literal">NULL</code></a>, this function gracefully sets some sane values in the

output variables and returns.</p>

<p>

<td><p><span class="term"><em class="parameter"><code>ink_rect</code></em> :</span></p></td>

<td> rectangle used to store the extents of the glyph as drawn

           or <a

><code class="literal">NULL</code></a> to indicate that the result is not needed.

</td>

</tr>

<td><p><span class="term"><em class="parameter"><code>logical_rect</code></em> :</span></p></td>

<td> rectangle used to store the logical extents of the glyph

           or <a

><code class="literal">NULL</code></a> to indicate that the result is not needed.

</td>

</tr>

</p>

<p>

If <em class="parameter"><code>font</code></em> is <a

><code class="literal">NULL</code></a>, this function gracefully sets some sane values in the

output variables and returns.</p>

<p>

<td><p><span class="term"><em class="parameter"><code>language</code></em> :</span></p></td>

<td> language tag used to determine which script to get the metrics

           for, or <a

><code class="literal">NULL</code></a> to indicate to get the metrics for the entire

           font.

</td>

to the font map, so if all references to font map are dropped, the font

map will be finalized even if there are fonts created with the font

map that are still alive.  In that case this function will return <a

><code class="literal">NULL</code></a>.

It is the responsibility of the user to ensure that the font map is kept

alive.  In most uses this is not an issue as a <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> holds

<tr>

<td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>

<td> a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>, or <a

><code class="literal">NULL</code></a>

</td>

</tr>

<tr>

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

<td> the <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> for the font, or <a

><code class="literal">NULL</code></a> if <em class="parameter"><code>font</code></em> is <a

><code class="literal">NULL</code></a>.

 

</td>

</pre>

<p>

The <a

><span class="type">GObject</span></a> type for <a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a>.

</p>

</div>

</pre>

<p>

Casts a <a

><span class="type">GObject</span></a> to a <a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a>.

</p>

<div class="variablelist"><table border="0">

<tbody><tr>

<td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>

<td>a <a

><span class="type">GObject</span></a>.

</td>

</tr></tbody>

</pre>

<p>

Returns <a

><code class="literal">TRUE</code></a> if <em class="parameter"><code>object</code></em> is a <a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a>.

</p>

<div class="variablelist"><table border="0">

<tbody><tr>

<td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>

<td>a <a

><span class="type">GObject</span></a>.

</td>

</tr></tbody>

<div class="refsect2" lang="en">

<a name="pango-font-family-is-monospace"></a><h3>pango_font_family_is_monospace ()</h3>

<pre class="programlisting"><a

>gboolean</a>            pango_font_family_is_monospace      (<a class="link" href="pango-Fonts.html#PangoFontFamily">PangoFontFamily</a> *family);</pre>

<p>

A monospace font is a font designed for text display where the the

this categorization also includes Asian fonts which include

double-width characters: characters that occupy two grid cells.

<a

><code class="function">g_unichar_iswide()</code></a> returns a result that indicates whether a

character is typically double-width in a monospace font.

</p>

<tr>

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

<td> <a

><code class="literal">TRUE</code></a> if the family is monospace.

 

</td>

<td><p><span class="term"><em class="parameter"><code>faces</code></em> :</span></p></td>

<td> location to store an array of pointers to <a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a>

  objects, or <a

><code class="literal">NULL</code></a>. This array should be freed with <a

><code class="function">g_free()</code></a>

  when it is no longer needed.

</td>

</pre>

<p>

The <a

><span class="type">GObject</span></a> type for <a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a>.

</p>

</div>

</pre>

<p>

Casts a <a

><span class="type">GObject</span></a> to a <a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a>.

</p>

<div class="variablelist"><table border="0">

<tbody><tr>

<td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>

<td>a <a

><span class="type">GObject</span></a>.

</td>

</tr></tbody>

</pre>

<p>

Returns <a

><code class="literal">TRUE</code></a> if <em class="parameter"><code>object</code></em> is a <a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a>.

</p>

<div class="variablelist"><table border="0">

<tbody><tr>

<td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>

<td>a <a

><span class="type">GObject</span></a>.

</td>

</tr></tbody>

<p>

List the available sizes for a font. This is only applicable to bitmap

fonts. For scalable fonts, stores <a

><code class="literal">NULL</code></a> at the location pointed to by

<em class="parameter"><code>sizes</code></em> and 0 at the location pointed to by <em class="parameter"><code>n_sizes</code></em>. The sizes returned

are in Pango units and are sorted in ascending order.</p>

<td><p><span class="term"><em class="parameter"><code>sizes</code></em> :</span></p></td>

<td> location to store a pointer to an array of int. This array

        should be freed with <a

><code class="function">g_free()</code></a>.

</td>

</tr>

<div class="refsect2" lang="en">

<a name="pango-font-face-is-synthesized"></a><h3>pango_font_face_is_synthesized ()</h3>

<pre class="programlisting"><a

>gboolean</a>            pango_font_face_is_synthesized      (<a class="link" href="pango-Fonts.html#PangoFontFace">PangoFontFace</a> *face);</pre>

<p>

Returns whether a <a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a> is synthesized by the underlying

</pre>

<p>

The <a

><span class="type">GObject</span></a> type for <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>.

</p>

</div>

</pre>

<p>

Casts a <a

><span class="type">GObject</span></a> to a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>.

</p>

<div class="variablelist"><table border="0">

<tbody><tr>

<td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>

<td>a <a

><span class="type">GObject</span></a>.

</td>

</tr></tbody>

</pre>

<p>

Returns <a

><code class="literal">TRUE</code></a> if <em class="parameter"><code>object</code></em> is a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>.

</p>

<div class="variablelist"><table border="0">

<tbody><tr>

<td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>

<td>a <a

><span class="type">GObject</span></a>.

</td>

</tr></tbody>

<tbody>

<tr>

<td><p><span class="term"><a

>GObjectClass</a> <em class="structfield"><code>parent_class</code></em>;</span></p></td>

<td>parent <a

><span class="type">GObjectClass</span></a>.

</td>

</tr>

</pre>

<p>

Casts a <a

><span class="type">GObject</span></a> to a <a class="link" href="pango-Fonts.html#PangoFontMapClass" title="PangoFontMapClass"><span class="type">PangoFontMapClass</span></a>.

</p>

<div class="variablelist"><table border="0">

<tbody><tr>

<td><p><span class="term"><em class="parameter"><code>klass</code></em> :</span></p></td>

<td>a <a

><span class="type">GObject</span></a>.

</td>

</tr></tbody>

</pre>

<p>

Returns <a

><code class="literal">TRUE</code></a> if <em class="parameter"><code>klass</code></em> is a subtype of <a class="link" href="pango-Fonts.html#PangoFontMapClass" title="PangoFontMapClass"><span class="type">PangoFontMapClass</span></a>.

</p>

<div class="variablelist"><table border="0">

<tbody><tr>

<td><p><span class="term"><em class="parameter"><code>klass</code></em> :</span></p></td>

<td>a <a

><span class="type">GObject</span></a>.

</td>

</tr></tbody>

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

<td> the newly allocated <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>, which should

              be freed with <a

><code class="function">g_object_unref()</code></a>.

 

</td>

<tr>

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

<td> the font loaded, or <a

><code class="literal">NULL</code></a> if no font matched.

</td>

</tr>

<tr>

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

<td> the fontset, or <a

><code class="literal">NULL</code></a> if no font matched.

</td>

</tr>

<td><p><span class="term"><em class="parameter"><code>families</code></em> :</span></p></td>

<td> location to store a pointer to an array of <a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a> *.

           This array should be freed with <a

><code class="function">g_free()</code></a>.

</td>

</tr>

</pre>

<p>

The <a

><span class="type">GObject</span></a> type for <a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a>.

</p>

</div>

<tbody>

<tr>

<td><p><span class="term"><a

>GObjectClass</a> <em class="structfield"><code>parent_class</code></em>;</span></p></td>

<td>parent <a

><span class="type">GObjectClass</span></a>.

</td>

</tr>

<a name="pango-fontset-get-font"></a><h3>pango_fontset_get_font ()</h3>

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *         pango_fontset_get_font              (<a class="link" href="pango-Fonts.html#PangoFontset">PangoFontset</a> *fontset,

                                                         <a

>guint</a> wc);</pre>

<p>

Returns the font in the fontset that contains the best glyph for the

<div class="refsect2" lang="en">

<a name="PangoFontsetForeachFunc"></a><h3>PangoFontsetForeachFunc ()</h3>

<pre class="programlisting"><a

>gboolean</a>            (*PangoFontsetForeachFunc)          (<a class="link" href="pango-Fonts.html#PangoFontset">PangoFontset</a> *fontset,

                                                         <a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,

                                                         <a

>gpointer</a> data);</pre>

<p>

A callback function used by <a class="link" href="pango-Fonts.html#pango-fontset-foreach" title="pango_fontset_foreach ()"><code class="function">pango_fontset_foreach()</code></a> when enumerating

<tr>

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

<td> if <a

><code class="literal">TRUE</code></a>, stop iteration and return immediately.

 

</td>

<pre class="programlisting">void                pango_fontset_foreach               (<a class="link" href="pango-Fonts.html#PangoFontset">PangoFontset</a> *fontset,

                                                         <a class="link" href="pango-Fonts.html#PangoFontsetForeachFunc" title="PangoFontsetForeachFunc ()">PangoFontsetForeachFunc</a> func,

                                                         <a

>gpointer</a> data);</pre>

<p>

Iterates through all the fonts in a fontset, calling <em class="parameter"><code>func</code></em> for

each one. If <em class="parameter"><code>func</code></em> returns <a

><code class="literal">TRUE</code></a>, that stops the iteration.</p>

<p>

</p>

</pre>

<p>

The <a

><span class="type">GObject</span></a> type for <a class="link" href="pango-Fonts.html#PangoFontsetSimple"><span class="type">PangoFontsetSimple</span></a>.

</p>

</div>

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

<td> the newly allocated <a class="link" href="pango-Fonts.html#PangoFontsetSimple"><span class="type">PangoFontsetSimple</span></a>, which should

              be freed with <a

><code class="function">g_object_unref()</code></a>.

</td>

</tr>