docs/html/pango-Fonts.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <html>
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   5 <title>Fonts</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.74.3">
   7 <link rel="home" href="index.html" title="Pango Reference Manual">
   8 <link rel="up" href="pango.html" title="Basic Pango Interfaces">
   9 <link rel="prev" href="pango-Glyph-Storage.html" title="Glyph Storage">
  10 <link rel="next" href="pango-Text-Attributes.html" title="Text Attributes">
  11 <meta name="generator" content="GTK-Doc V1.11 (XML mode)">
  12 <link rel="stylesheet" href="style.css" type="text/css">
  13 <link rel="chapter" href="pango.html" title="Basic Pango Interfaces">
  14 <link rel="chapter" href="rendering.html" title="Rendering with Pango">
  15 <link rel="chapter" href="lowlevel.html" title="Low Level Functionality">
  16 <link rel="chapter" href="tools.html" title="Pango Tools">
  17 <link rel="chapter" href="pango-hierarchy.html" title="Object Hierarchy">
  18 <link rel="index" href="index-all.html" title="Index">
  19 <link rel="index" href="index-deprecated.html" title="Index of deprecated symbols">
  20 <link rel="index" href="index-1.2.html" title="Index of new symbols in 1.2">
  21 <link rel="index" href="index-1.4.html" title="Index of new symbols in 1.4">
  22 <link rel="index" href="index-1.6.html" title="Index of new symbols in 1.6">
  23 <link rel="index" href="index-1.8.html" title="Index of new symbols in 1.8">
  24 <link rel="index" href="index-1.10.html" title="Index of new symbols in 1.10">
  25 <link rel="index" href="index-1.12.html" title="Index of new symbols in 1.12">
  26 <link rel="index" href="index-1.14.html" title="Index of new symbols in 1.14">
  27 <link rel="index" href="index-1.16.html" title="Index of new symbols in 1.16">
  28 <link rel="index" href="index-1.18.html" title="Index of new symbols in 1.18">
  29 <link rel="index" href="index-1.20.html" title="Index of new symbols in 1.20">
  30 <link rel="index" href="index-1.22.html" title="Index of new symbols in 1.22">
  31 <link rel="index" href="index-1.24.html" title="Index of new symbols in 1.24">
  32 <link rel="index" href="index-1.26.html" title="Index of new symbols in 1.26">
  33 </head>
  34 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  35 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
  36 <tr valign="middle">
  37 <td><a accesskey="p" href="pango-Glyph-Storage.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
  38 <td><a accesskey="u" href="pango.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
  39 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
  40 <th width="100%" align="center">Pango Reference Manual</th>
  41 <td><a accesskey="n" href="pango-Text-Attributes.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
  42 </tr>
  43 <tr><td colspan="5" class="shortcuts">
  44 <a href="#pango-Fonts.synopsis" class="shortcut">Top</a>
  45                  |
  46                 <a href="#pango-Fonts.description" class="shortcut">Description</a>
  47                  |
  48                 <a href="#pango-Fonts.object-hierarchy" class="shortcut">Object Hierarchy</a>
  49                  |
  50                 <a href="#pango-Fonts.derived-interfaces" class="shortcut">Known Derived Interfaces</a>
  51 </td></tr>
  52 </table>
  53 <div class="refentry" lang="en">
  54 <a name="pango-Fonts"></a><div class="titlepage"></div>
  55 <div class="refnamediv"><table width="100%"><tr>
  56 <td valign="top">
  57 <h2><span class="refentrytitle"><a name="pango-Fonts.top_of_page"></a>Fonts</span></h2>
  58 <p>Fonts — Structures representing abstract fonts</p>
  59 </td>
  60 <td valign="top" align="right"></td>
  61 </tr></table></div>
  62 <div class="refsynopsisdiv">
  63 <a name="pango-Fonts.synopsis"></a><h2>Synopsis</h2>
  64 <a name="PangoFont"></a><a name="PangoFontFamily"></a><a name="PangoFontFace"></a><a name="PangoFontMap"></a><a name="PangoFontset"></a><a name="PangoFontsetSimple"></a><pre class="synopsis">
  65                     <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a>;
  66 #define             <a class="link" href="pango-Fonts.html#PANGO-TYPE-FONT-DESCRIPTION--CAPS" title="PANGO_TYPE_FONT_DESCRIPTION">PANGO_TYPE_FONT_DESCRIPTION</a>
  67 enum                <a class="link" href="pango-Fonts.html#PangoStyle" title="enum PangoStyle">PangoStyle</a>;
  68 #define             <a class="link" href="pango-Fonts.html#PANGO-TYPE-STYLE--CAPS" title="PANGO_TYPE_STYLE">PANGO_TYPE_STYLE</a>
  69 enum                <a class="link" href="pango-Fonts.html#PangoWeight" title="enum PangoWeight">PangoWeight</a>;
  70 #define             <a class="link" href="pango-Fonts.html#PANGO-TYPE-WEIGHT--CAPS" title="PANGO_TYPE_WEIGHT">PANGO_TYPE_WEIGHT</a>
  71 enum                <a class="link" href="pango-Fonts.html#PangoVariant" title="enum PangoVariant">PangoVariant</a>;
  72 #define             <a class="link" href="pango-Fonts.html#PANGO-TYPE-VARIANT--CAPS" title="PANGO_TYPE_VARIANT">PANGO_TYPE_VARIANT</a>
  73 enum                <a class="link" href="pango-Fonts.html#PangoStretch" title="enum PangoStretch">PangoStretch</a>;
  74 #define             <a class="link" href="pango-Fonts.html#PANGO-TYPE-STRETCH--CAPS" title="PANGO_TYPE_STRETCH">PANGO_TYPE_STRETCH</a>
  75 enum                <a class="link" href="pango-Fonts.html#PangoFontMask" title="enum PangoFontMask">PangoFontMask</a>;
  76 #define             <a class="link" href="pango-Fonts.html#PANGO-TYPE-FONT-MASK--CAPS" title="PANGO_TYPE_FONT_MASK">PANGO_TYPE_FONT_MASK</a>
  77 <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> * <a class="link" href="pango-Fonts.html#pango-font-description-new" title="pango_font_description_new ()">pango_font_description_new</a>       (void);
  78 <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> * <a class="link" href="pango-Fonts.html#pango-font-description-copy" title="pango_font_description_copy ()">pango_font_description_copy</a>      (const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc);
  79 <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>
  80                                                         (const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc);
  81 <a
  82 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
  83 >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);
  84 <a
  85 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
  86 >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,
  87                                                          const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc2);
  88 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);
  89 void                <a class="link" href="pango-Fonts.html#pango-font-descriptions-free" title="pango_font_descriptions_free ()">pango_font_descriptions_free</a>        (<a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> **descs,
  90                                                          int n_descs);
  91 void                <a class="link" href="pango-Fonts.html#pango-font-description-set-family" title="pango_font_description_set_family ()">pango_font_description_set_family</a>   (<a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc,
  92                                                          const char *family);
  93 void                <a class="link" href="pango-Fonts.html#pango-font-description-set-family-static" title="pango_font_description_set_family_static ()">pango_font_description_set_family_static</a>
  94                                                         (<a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc,
  95                                                          const char *family);
  96 const char *        <a class="link" href="pango-Fonts.html#pango-font-description-get-family" title="pango_font_description_get_family ()">pango_font_description_get_family</a>   (const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc);
  97 void                <a class="link" href="pango-Fonts.html#pango-font-description-set-style" title="pango_font_description_set_style ()">pango_font_description_set_style</a>    (<a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc,
  98                                                          <a class="link" href="pango-Fonts.html#PangoStyle" title="enum PangoStyle">PangoStyle</a> style);
  99 <a class="link" href="pango-Fonts.html#PangoStyle" title="enum PangoStyle">PangoStyle</a>          <a class="link" href="pango-Fonts.html#pango-font-description-get-style" title="pango_font_description_get_style ()">pango_font_description_get_style</a>    (const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc);
 100 void                <a class="link" href="pango-Fonts.html#pango-font-description-set-variant" title="pango_font_description_set_variant ()">pango_font_description_set_variant</a>  (<a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc,
 101                                                          <a class="link" href="pango-Fonts.html#PangoVariant" title="enum PangoVariant">PangoVariant</a> variant);
 102 <a class="link" href="pango-Fonts.html#PangoVariant" title="enum PangoVariant">PangoVariant</a>        <a class="link" href="pango-Fonts.html#pango-font-description-get-variant" title="pango_font_description_get_variant ()">pango_font_description_get_variant</a>  (const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc);
 103 void                <a class="link" href="pango-Fonts.html#pango-font-description-set-weight" title="pango_font_description_set_weight ()">pango_font_description_set_weight</a>   (<a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc,
 104                                                          <a class="link" href="pango-Fonts.html#PangoWeight" title="enum PangoWeight">PangoWeight</a> weight);
 105 <a class="link" href="pango-Fonts.html#PangoWeight" title="enum PangoWeight">PangoWeight</a>         <a class="link" href="pango-Fonts.html#pango-font-description-get-weight" title="pango_font_description_get_weight ()">pango_font_description_get_weight</a>   (const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc);
 106 void                <a class="link" href="pango-Fonts.html#pango-font-description-set-stretch" title="pango_font_description_set_stretch ()">pango_font_description_set_stretch</a>  (<a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc,
 107                                                          <a class="link" href="pango-Fonts.html#PangoStretch" title="enum PangoStretch">PangoStretch</a> stretch);
 108 <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);
 109 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,
 110                                                          <a
 111 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
 112 >gint</a> size);
 113 <a
 114 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
 115 >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);
 116 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>
 117                                                         (<a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc,
 118                                                          double size);
 119 <a
 120 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
 121 >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>
 122                                                         (const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc);
 123 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,
 124                                                          <a class="link" href="pango-Vertical-Text.html#PangoGravity" title="enum PangoGravity">PangoGravity</a> gravity);
 125 <a class="link" href="pango-Vertical-Text.html#PangoGravity" title="enum PangoGravity">PangoGravity</a>        <a class="link" href="pango-Fonts.html#pango-font-description-get-gravity" title="pango_font_description_get_gravity ()">pango_font_description_get_gravity</a>  (const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc);
 126 <a class="link" href="pango-Fonts.html#PangoFontMask" title="enum PangoFontMask">PangoFontMask</a>       <a class="link" href="pango-Fonts.html#pango-font-description-get-set-fields" title="pango_font_description_get_set_fields ()">pango_font_description_get_set_fields</a>
 127                                                         (const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc);
 128 void                <a class="link" href="pango-Fonts.html#pango-font-description-unset-fields" title="pango_font_description_unset_fields ()">pango_font_description_unset_fields</a> (<a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc,
 129                                                          <a class="link" href="pango-Fonts.html#PangoFontMask" title="enum PangoFontMask">PangoFontMask</a> to_unset);
 130 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,
 131                                                          const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc_to_merge,
 132                                                          <a
 133 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
 134 >gboolean</a> replace_existing);
 135 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,
 136                                                          const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc_to_merge,
 137                                                          <a
 138 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
 139 >gboolean</a> replace_existing);
 140 <a
 141 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
 142 >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,
 143                                                          const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *old_match,
 144                                                          const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *new_match);
 145 <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> * <a class="link" href="pango-Fonts.html#pango-font-description-from-string" title="pango_font_description_from_string ()">pango_font_description_from_string</a>
 146                                                         (const char *str);
 147 char *              <a class="link" href="pango-Fonts.html#pango-font-description-to-string" title="pango_font_description_to_string ()">pango_font_description_to_string</a>    (const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc);
 148 char *              <a class="link" href="pango-Fonts.html#pango-font-description-to-filename" title="pango_font_description_to_filename ()">pango_font_description_to_filename</a>  (const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc);
 149
 150                     <a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics">PangoFontMetrics</a>;
 151 #define             <a class="link" href="pango-Fonts.html#PANGO-TYPE-FONT-METRICS--CAPS" title="PANGO_TYPE_FONT_METRICS">PANGO_TYPE_FONT_METRICS</a>
 152 <a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics">PangoFontMetrics</a> *  <a class="link" href="pango-Fonts.html#pango-font-metrics-ref" title="pango_font_metrics_ref ()">pango_font_metrics_ref</a>              (<a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics">PangoFontMetrics</a> *metrics);
 153 void                <a class="link" href="pango-Fonts.html#pango-font-metrics-unref" title="pango_font_metrics_unref ()">pango_font_metrics_unref</a>            (<a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics">PangoFontMetrics</a> *metrics);
 154 int                 <a class="link" href="pango-Fonts.html#pango-font-metrics-get-ascent" title="pango_font_metrics_get_ascent ()">pango_font_metrics_get_ascent</a>       (<a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics">PangoFontMetrics</a> *metrics);
 155 int                 <a class="link" href="pango-Fonts.html#pango-font-metrics-get-descent" title="pango_font_metrics_get_descent ()">pango_font_metrics_get_descent</a>      (<a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics">PangoFontMetrics</a> *metrics);
 156 int                 <a class="link" href="pango-Fonts.html#pango-font-metrics-get-approximate-char-width" title="pango_font_metrics_get_approximate_char_width ()">pango_font_metrics_get_approximate_char_width</a>
 157                                                         (<a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics">PangoFontMetrics</a> *metrics);
 158 int                 <a class="link" href="pango-Fonts.html#pango-font-metrics-get-approximate-digit-width" title="pango_font_metrics_get_approximate_digit_width ()">pango_font_metrics_get_approximate_digit_width</a>
 159                                                         (<a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics">PangoFontMetrics</a> *metrics);
 160 int                 <a class="link" href="pango-Fonts.html#pango-font-metrics-get-underline-thickness" title="pango_font_metrics_get_underline_thickness ()">pango_font_metrics_get_underline_thickness</a>
 161                                                         (<a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics">PangoFontMetrics</a> *metrics);
 162 int                 <a class="link" href="pango-Fonts.html#pango-font-metrics-get-underline-position" title="pango_font_metrics_get_underline_position ()">pango_font_metrics_get_underline_position</a>
 163                                                         (<a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics">PangoFontMetrics</a> *metrics);
 164 int                 <a class="link" href="pango-Fonts.html#pango-font-metrics-get-strikethrough-thickness" title="pango_font_metrics_get_strikethrough_thickness ()">pango_font_metrics_get_strikethrough_thickness</a>
 165                                                         (<a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics">PangoFontMetrics</a> *metrics);
 166 int                 <a class="link" href="pango-Fonts.html#pango-font-metrics-get-strikethrough-position" title="pango_font_metrics_get_strikethrough_position ()">pango_font_metrics_get_strikethrough_position</a>
 167                                                         (<a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics">PangoFontMetrics</a> *metrics);
 168
 169                     <a class="link" href="pango-Fonts.html#PangoFont-struct" title="PangoFont">PangoFont</a>;
 170 #define             <a class="link" href="pango-Fonts.html#PANGO-TYPE-FONT--CAPS" title="PANGO_TYPE_FONT">PANGO_TYPE_FONT</a>
 171 #define             <a class="link" href="pango-Fonts.html#PANGO-FONT--CAPS" title="PANGO_FONT()">PANGO_FONT</a>                          (object)
 172 #define             <a class="link" href="pango-Fonts.html#PANGO-IS-FONT--CAPS" title="PANGO_IS_FONT()">PANGO_IS_FONT</a>                       (object)
 173 <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,
 174                                                          <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage">PangoLanguage</a> *language,
 175                                                          <a
 176 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"
 177 >guint32</a> ch);
 178 <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);
 179 <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>
 180                                                         (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font);
 181 <a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage">PangoCoverage</a> *     <a class="link" href="pango-Fonts.html#pango-font-get-coverage" title="pango_font_get_coverage ()">pango_font_get_coverage</a>             (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
 182                                                          <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage">PangoLanguage</a> *language);
 183 void                <a class="link" href="pango-Fonts.html#pango-font-get-glyph-extents" title="pango_font_get_glyph_extents ()">pango_font_get_glyph_extents</a>        (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
 184                                                          <a class="link" href="pango-Glyph-Storage.html#PangoGlyph" title="PangoGlyph">PangoGlyph</a> glyph,
 185                                                          <a class="link" href="pango-Glyph-Storage.html#PangoRectangle" title="PangoRectangle">PangoRectangle</a> *ink_rect,
 186                                                          <a class="link" href="pango-Glyph-Storage.html#PangoRectangle" title="PangoRectangle">PangoRectangle</a> *logical_rect);
 187 <a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics">PangoFontMetrics</a> *  <a class="link" href="pango-Fonts.html#pango-font-get-metrics" title="pango_font_get_metrics ()">pango_font_get_metrics</a>              (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
 188                                                          <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage">PangoLanguage</a> *language);
 189 <a class="link" href="pango-Fonts.html#PangoFontMap">PangoFontMap</a> *      <a class="link" href="pango-Fonts.html#pango-font-get-font-map" title="pango_font_get_font_map ()">pango_font_get_font_map</a>             (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font);
 190
 191                     <a class="link" href="pango-Fonts.html#PangoFontFamily-struct" title="PangoFontFamily">PangoFontFamily</a>;
 192 #define             <a class="link" href="pango-Fonts.html#PANGO-TYPE-FONT-FAMILY--CAPS" title="PANGO_TYPE_FONT_FAMILY">PANGO_TYPE_FONT_FAMILY</a>
 193 #define             <a class="link" href="pango-Fonts.html#PANGO-FONT-FAMILY--CAPS" title="PANGO_FONT_FAMILY()">PANGO_FONT_FAMILY</a>                   (object)
 194 #define             <a class="link" href="pango-Fonts.html#PANGO-IS-FONT-FAMILY--CAPS" title="PANGO_IS_FONT_FAMILY()">PANGO_IS_FONT_FAMILY</a>                (object)
 195 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);
 196 <a
 197 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
 198 >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);
 199 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,
 200                                                          <a class="link" href="pango-Fonts.html#PangoFontFace">PangoFontFace</a> ***faces,
 201                                                          int *n_faces);
 202
 203                     <a class="link" href="pango-Fonts.html#PangoFontFace-struct" title="PangoFontFace">PangoFontFace</a>;
 204 #define             <a class="link" href="pango-Fonts.html#PANGO-TYPE-FONT-FACE--CAPS" title="PANGO_TYPE_FONT_FACE">PANGO_TYPE_FONT_FACE</a>
 205 #define             <a class="link" href="pango-Fonts.html#PANGO-FONT-FACE--CAPS" title="PANGO_FONT_FACE()">PANGO_FONT_FACE</a>                     (object)
 206 #define             <a class="link" href="pango-Fonts.html#PANGO-IS-FONT-FACE--CAPS" title="PANGO_IS_FONT_FACE()">PANGO_IS_FONT_FACE</a>                  (object)
 207 const char *        <a class="link" href="pango-Fonts.html#pango-font-face-get-face-name" title="pango_font_face_get_face_name ()">pango_font_face_get_face_name</a>       (<a class="link" href="pango-Fonts.html#PangoFontFace">PangoFontFace</a> *face);
 208 void                <a class="link" href="pango-Fonts.html#pango-font-face-list-sizes" title="pango_font_face_list_sizes ()">pango_font_face_list_sizes</a>          (<a class="link" href="pango-Fonts.html#PangoFontFace">PangoFontFace</a> *face,
 209                                                          int **sizes,
 210                                                          int *n_sizes);
 211 <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);
 212 <a
 213 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
 214 >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);
 215
 216                     <a class="link" href="pango-Fonts.html#PangoFontMap-struct" title="PangoFontMap">PangoFontMap</a>;
 217 #define             <a class="link" href="pango-Fonts.html#PANGO-TYPE-FONT-MAP--CAPS" title="PANGO_TYPE_FONT_MAP">PANGO_TYPE_FONT_MAP</a>
 218 #define             <a class="link" href="pango-Fonts.html#PANGO-FONT-MAP--CAPS" title="PANGO_FONT_MAP()">PANGO_FONT_MAP</a>                      (object)
 219 #define             <a class="link" href="pango-Fonts.html#PANGO-IS-FONT-MAP--CAPS" title="PANGO_IS_FONT_MAP()">PANGO_IS_FONT_MAP</a>                   (object)
 220                     <a class="link" href="pango-Fonts.html#PangoFontMapClass" title="PangoFontMapClass">PangoFontMapClass</a>;
 221 #define             <a class="link" href="pango-Fonts.html#PANGO-FONT-MAP-CLASS--CAPS" title="PANGO_FONT_MAP_CLASS()">PANGO_FONT_MAP_CLASS</a>                (klass)
 222 #define             <a class="link" href="pango-Fonts.html#PANGO-IS-FONT-MAP-CLASS--CAPS" title="PANGO_IS_FONT_MAP_CLASS()">PANGO_IS_FONT_MAP_CLASS</a>             (klass)
 223 #define             <a class="link" href="pango-Fonts.html#PANGO-FONT-MAP-GET-CLASS--CAPS" title="PANGO_FONT_MAP_GET_CLASS()">PANGO_FONT_MAP_GET_CLASS</a>            (obj)
 224 <a class="link" href="pango-Text-Processing.html#PangoContext">PangoContext</a> *      <a class="link" href="pango-Fonts.html#pango-font-map-create-context" title="pango_font_map_create_context ()">pango_font_map_create_context</a>       (<a class="link" href="pango-Fonts.html#PangoFontMap">PangoFontMap</a> *fontmap);
 225 <a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *         <a class="link" href="pango-Fonts.html#pango-font-map-load-font" title="pango_font_map_load_font ()">pango_font_map_load_font</a>            (<a class="link" href="pango-Fonts.html#PangoFontMap">PangoFontMap</a> *fontmap,
 226                                                          <a class="link" href="pango-Text-Processing.html#PangoContext">PangoContext</a> *context,
 227                                                          const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc);
 228 <a class="link" href="pango-Fonts.html#PangoFontset">PangoFontset</a> *      <a class="link" href="pango-Fonts.html#pango-font-map-load-fontset" title="pango_font_map_load_fontset ()">pango_font_map_load_fontset</a>         (<a class="link" href="pango-Fonts.html#PangoFontMap">PangoFontMap</a> *fontmap,
 229                                                          <a class="link" href="pango-Text-Processing.html#PangoContext">PangoContext</a> *context,
 230                                                          const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc,
 231                                                          <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage">PangoLanguage</a> *language);
 232 void                <a class="link" href="pango-Fonts.html#pango-font-map-list-families" title="pango_font_map_list_families ()">pango_font_map_list_families</a>        (<a class="link" href="pango-Fonts.html#PangoFontMap">PangoFontMap</a> *fontmap,
 233                                                          <a class="link" href="pango-Fonts.html#PangoFontFamily">PangoFontFamily</a> ***families,
 234                                                          int *n_families);
 235 const char *        <a class="link" href="pango-Fonts.html#pango-font-map-get-shape-engine-type" title="pango_font_map_get_shape_engine_type ()">pango_font_map_get_shape_engine_type</a>
 236                                                         (<a class="link" href="pango-Fonts.html#PangoFontMap">PangoFontMap</a> *fontmap);
 237
 238                     <a class="link" href="pango-Fonts.html#PangoFontset-struct" title="PangoFontset">PangoFontset</a>;
 239 #define             <a class="link" href="pango-Fonts.html#PANGO-TYPE-FONTSET--CAPS" title="PANGO_TYPE_FONTSET">PANGO_TYPE_FONTSET</a>
 240                     <a class="link" href="pango-Fonts.html#PangoFontsetClass" title="PangoFontsetClass">PangoFontsetClass</a>;
 241 <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,
 242                                                          <a
 243 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
 244 >guint</a> wc);
 245 <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);
 246 <a
 247 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
 248 >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,
 249                                                          <a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
 250                                                          <a
 251 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
 252 >gpointer</a> data);
 253 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,
 254                                                          <a class="link" href="pango-Fonts.html#PangoFontsetForeachFunc" title="PangoFontsetForeachFunc ()">PangoFontsetForeachFunc</a> func,
 255                                                          <a
 256 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
 257 >gpointer</a> data);
 258                     <a class="link" href="pango-Fonts.html#PangoFontsetSimple-struct" title="PangoFontsetSimple">PangoFontsetSimple</a>;
 259 #define             <a class="link" href="pango-Fonts.html#PANGO-TYPE-FONTSET-SIMPLE--CAPS" title="PANGO_TYPE_FONTSET_SIMPLE">PANGO_TYPE_FONTSET_SIMPLE</a>
 260 <a class="link" href="pango-Fonts.html#PangoFontsetSimple">PangoFontsetSimple</a> * <a class="link" href="pango-Fonts.html#pango-fontset-simple-new" title="pango_fontset_simple_new ()">pango_fontset_simple_new</a>           (<a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage">PangoLanguage</a> *language);
 261 void                <a class="link" href="pango-Fonts.html#pango-fontset-simple-append" title="pango_fontset_simple_append ()">pango_fontset_simple_append</a>         (<a class="link" href="pango-Fonts.html#PangoFontsetSimple">PangoFontsetSimple</a> *fontset,
 262                                                          <a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font);
 263 int                 <a class="link" href="pango-Fonts.html#pango-fontset-simple-size" title="pango_fontset_simple_size ()">pango_fontset_simple_size</a>           (<a class="link" href="pango-Fonts.html#PangoFontsetSimple">PangoFontsetSimple</a> *fontset);
 264 </pre>
 265 </div>
 266 <div class="refsect1" lang="en">
 267 <a name="pango-Fonts.object-hierarchy"></a><h2>Object Hierarchy</h2>
 268 <pre class="synopsis">
 269   <a
 270 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
 271 >GObject</a>
 272    +----PangoFont
 273          +----<a class="link" href="PangoFcFont.html" title="PangoFcFont">PangoFcFont</a>
 274 </pre>
 275 <pre class="synopsis">
 276   <a
 277 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
 278 >GObject</a>
 279    +----PangoFontFamily
 280 </pre>
 281 <pre class="synopsis">
 282   <a
 283 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
 284 >GObject</a>
 285    +----PangoFontFace
 286 </pre>
 287 <pre class="synopsis">
 288   <a
 289 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
 290 >GObject</a>
 291    +----PangoFontMap
 292          +----<a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap">PangoFcFontMap</a>
 293 </pre>
 294 <pre class="synopsis">
 295   <a
 296 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
 297 >GObject</a>
 298    +----PangoFontset
 299          +----<a class="link" href="pango-Fonts.html#PangoFontsetSimple">PangoFontsetSimple</a>
 300 </pre>
 301 <pre class="synopsis">
 302   <a
 303 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
 304 >GObject</a>
 305    +----<a class="link" href="pango-Fonts.html#PangoFontset">PangoFontset</a>
 306          +----PangoFontsetSimple
 307 </pre>
 308 </div>
 309 <div class="refsect1" lang="en">
 310 <a name="pango-Fonts.derived-interfaces"></a><h2>Known Derived Interfaces</h2>
 311 <p>
 312 PangoFont is required by
 313  <a class="link" href="pango-Cairo-Rendering.html#PangoCairoFont">PangoCairoFont</a>.</p>
 314 <p>
 315 PangoFontMap is required by
 316  <a class="link" href="pango-Cairo-Rendering.html#PangoCairoFontMap">PangoCairoFontMap</a>.</p>
 317 </div>
 318 <div class="refsect1" lang="en">
 319 <a name="pango-Fonts.description"></a><h2>Description</h2>
 320 <p>
 321 Pango supports a flexible architecture where a
 322 particular rendering architecture can supply an
 323 implementation of fonts. The <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> structure
 324 represents an abstract rendering-system-independent font.
 325 Pango provides routines to list available fonts, and
 326 to load a font of a given description.
 327 </p>
 328 </div>
 329 <div class="refsect1" lang="en">
 330 <a name="pango-Fonts.details"></a><h2>Details</h2>
 331 <div class="refsect2" lang="en">
 332 <a name="PangoFontDescription"></a><h3>PangoFontDescription</h3>
 333 <pre class="programlisting">typedef struct _PangoFontDescription PangoFontDescription;</pre>
 334 <p>
 335 The <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a> structure represents the description
 336 of an ideal font. These structures are used both to list
 337 what fonts are available on the system and also for specifying
 338 the characteristics of a font to load.
 339 </p>
 340 </div>
 341 <hr>
 342 <div class="refsect2" lang="en">
 343 <a name="PANGO-TYPE-FONT-DESCRIPTION--CAPS"></a><h3>PANGO_TYPE_FONT_DESCRIPTION</h3>
 344 <pre class="programlisting">#define PANGO_TYPE_FONT_DESCRIPTION (pango_font_description_get_type ())
 345 </pre>
 346 <p>
 347 The <a
 348 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
 349 ><span class="type">GObject</span></a> type for <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>.
 350 </p>
 351 </div>
 352 <hr>
 353 <div class="refsect2" lang="en">
 354 <a name="PangoStyle"></a><h3>enum PangoStyle</h3>
 355 <pre class="programlisting">typedef enum {
 356   PANGO_STYLE_NORMAL,
 357   PANGO_STYLE_OBLIQUE,
 358   PANGO_STYLE_ITALIC
 359 } PangoStyle;
 360 </pre>
 361 <p>
 362 An enumeration specifying the various slant styles possible for a font.</p>
 363 <p>
 364 </p>
 365 <div class="variablelist"><table border="0">
 366 <col align="left" valign="top">
 367 <tbody>
 368 <tr>
 369 <td><p><a name="PANGO-STYLE-NORMAL--CAPS"></a><span class="term"><code class="literal">PANGO_STYLE_NORMAL</code></span></p></td>
 370 <td> the font is upright.
 371 </td>
 372 </tr>
 373 <tr>
 374 <td><p><a name="PANGO-STYLE-OBLIQUE--CAPS"></a><span class="term"><code class="literal">PANGO_STYLE_OBLIQUE</code></span></p></td>
 375 <td> the font is slanted, but in a roman style.
 376 </td>
 377 </tr>
 378 <tr>
 379 <td><p><a name="PANGO-STYLE-ITALIC--CAPS"></a><span class="term"><code class="literal">PANGO_STYLE_ITALIC</code></span></p></td>
 380 <td> the font is slanted in an italic style.
 381 </td>
 382 </tr>
 383 </tbody>
 384 </table></div>
 385 </div>
 386 <hr>
 387 <div class="refsect2" lang="en">
 388 <a name="PANGO-TYPE-STYLE--CAPS"></a><h3>PANGO_TYPE_STYLE</h3>
 389 <pre class="programlisting">#define PANGO_TYPE_STYLE (pango_style_get_type())
 390 </pre>
 391 <p>
 392 The <a
 393 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
 394 ><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>.
 395 </p>
 396 </div>
 397 <hr>
 398 <div class="refsect2" lang="en">
 399 <a name="PangoWeight"></a><h3>enum PangoWeight</h3>
 400 <pre class="programlisting">typedef enum {
 401   PANGO_WEIGHT_THIN = 100,
 402   PANGO_WEIGHT_ULTRALIGHT = 200,
 403   PANGO_WEIGHT_LIGHT = 300,
 404   PANGO_WEIGHT_BOOK = 380,
 405   PANGO_WEIGHT_NORMAL = 400,
 406   PANGO_WEIGHT_MEDIUM = 500,
 407   PANGO_WEIGHT_SEMIBOLD = 600,
 408   PANGO_WEIGHT_BOLD = 700,
 409   PANGO_WEIGHT_ULTRABOLD = 800,
 410   PANGO_WEIGHT_HEAVY = 900,
 411   PANGO_WEIGHT_ULTRAHEAVY = 1000
 412 } PangoWeight;
 413 </pre>
 414 <p>
 415 An enumeration specifying the weight (boldness) of a font. This is a numerical
 416 value ranging from 100 to 900, but there are some predefined values:
 417 </p>
 418 <div class="variablelist"><table border="0">
 419 <col align="left" valign="top">
 420 <tbody>
 421 <tr>
 422 <td><p><a name="PANGO-WEIGHT-THIN--CAPS"></a><span class="term"><code class="literal">PANGO_WEIGHT_THIN</code></span></p></td>
 423 <td>the thin weight (= 100; Since: 1.24)
 424 </td>
 425 </tr>
 426 <tr>
 427 <td><p><a name="PANGO-WEIGHT-ULTRALIGHT--CAPS"></a><span class="term"><code class="literal">PANGO_WEIGHT_ULTRALIGHT</code></span></p></td>
 428 <td>the ultralight weight (= 200)
 429 </td>
 430 </tr>
 431 <tr>
 432 <td><p><a name="PANGO-WEIGHT-LIGHT--CAPS"></a><span class="term"><code class="literal">PANGO_WEIGHT_LIGHT</code></span></p></td>
 433 <td>the light weight (= 300)
 434 </td>
 435 </tr>
 436 <tr>
 437 <td><p><a name="PANGO-WEIGHT-BOOK--CAPS"></a><span class="term"><code class="literal">PANGO_WEIGHT_BOOK</code></span></p></td>
 438 <td>the book weight (= 380; Since: 1.24)
 439 </td>
 440 </tr>
 441 <tr>
 442 <td><p><a name="PANGO-WEIGHT-NORMAL--CAPS"></a><span class="term"><code class="literal">PANGO_WEIGHT_NORMAL</code></span></p></td>
 443 <td>the default weight (= 400)
 444 </td>
 445 </tr>
 446 <tr>
 447 <td><p><a name="PANGO-WEIGHT-MEDIUM--CAPS"></a><span class="term"><code class="literal">PANGO_WEIGHT_MEDIUM</code></span></p></td>
 448 <td>the normal weight (= 500; Since: 1.24)
 449 </td>
 450 </tr>
 451 <tr>
 452 <td><p><a name="PANGO-WEIGHT-SEMIBOLD--CAPS"></a><span class="term"><code class="literal">PANGO_WEIGHT_SEMIBOLD</code></span></p></td>
 453 <td>the semibold weight (= 600)
 454 </td>
 455 </tr>
 456 <tr>
 457 <td><p><a name="PANGO-WEIGHT-BOLD--CAPS"></a><span class="term"><code class="literal">PANGO_WEIGHT_BOLD</code></span></p></td>
 458 <td>the bold weight (= 700)
 459 </td>
 460 </tr>
 461 <tr>
 462 <td><p><a name="PANGO-WEIGHT-ULTRABOLD--CAPS"></a><span class="term"><code class="literal">PANGO_WEIGHT_ULTRABOLD</code></span></p></td>
 463 <td>the ultrabold weight (= 800)
 464 </td>
 465 </tr>
 466 <tr>
 467 <td><p><a name="PANGO-WEIGHT-HEAVY--CAPS"></a><span class="term"><code class="literal">PANGO_WEIGHT_HEAVY</code></span></p></td>
 468 <td>the heavy weight (= 900)
 469 </td>
 470 </tr>
 471 <tr>
 472 <td><p><a name="PANGO-WEIGHT-ULTRAHEAVY--CAPS"></a><span class="term"><code class="literal">PANGO_WEIGHT_ULTRAHEAVY</code></span></p></td>
 473 <td>the ultraheavy weight (= 1000; Since: 1.24)
 474 </td>
 475 </tr>
 476 </tbody>
 477 </table></div>
 478 </div>
 479 <hr>
 480 <div class="refsect2" lang="en">
 481 <a name="PANGO-TYPE-WEIGHT--CAPS"></a><h3>PANGO_TYPE_WEIGHT</h3>
 482 <pre class="programlisting">#define PANGO_TYPE_WEIGHT (pango_weight_get_type())
 483 </pre>
 484 <p>
 485 The <a
 486 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
 487 ><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>.
 488 </p>
 489 </div>
 490 <hr>
 491 <div class="refsect2" lang="en">
 492 <a name="PangoVariant"></a><h3>enum PangoVariant</h3>
 493 <pre class="programlisting">typedef enum {
 494   PANGO_VARIANT_NORMAL,
 495   PANGO_VARIANT_SMALL_CAPS
 496 } PangoVariant;
 497 </pre>
 498 <p>
 499 An enumeration specifying capitalization variant of the font.
 500 </p>
 501 <div class="variablelist"><table border="0">
 502 <col align="left" valign="top">
 503 <tbody>
 504 <tr>
 505 <td><p><a name="PANGO-VARIANT-NORMAL--CAPS"></a><span class="term"><code class="literal">PANGO_VARIANT_NORMAL</code></span></p></td>
 506 <td>A normal font.
 507 </td>
 508 </tr>
 509 <tr>
 510 <td><p><a name="PANGO-VARIANT-SMALL-CAPS--CAPS"></a><span class="term"><code class="literal">PANGO_VARIANT_SMALL_CAPS</code></span></p></td>
 511 <td>A font with the lower case characters
 512   replaced by smaller variants of the capital characters.
 513 </td>
 514 </tr>
 515 </tbody>
 516 </table></div>
 517 </div>
 518 <hr>
 519 <div class="refsect2" lang="en">
 520 <a name="PANGO-TYPE-VARIANT--CAPS"></a><h3>PANGO_TYPE_VARIANT</h3>
 521 <pre class="programlisting">#define PANGO_TYPE_VARIANT (pango_variant_get_type())
 522 </pre>
 523 <p>
 524 The <a
 525 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
 526 ><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>.
 527 </p>
 528 </div>
 529 <hr>
 530 <div class="refsect2" lang="en">
 531 <a name="PangoStretch"></a><h3>enum PangoStretch</h3>
 532 <pre class="programlisting">typedef enum {
 533   PANGO_STRETCH_ULTRA_CONDENSED,
 534   PANGO_STRETCH_EXTRA_CONDENSED,
 535   PANGO_STRETCH_CONDENSED,
 536   PANGO_STRETCH_SEMI_CONDENSED,
 537   PANGO_STRETCH_NORMAL,
 538   PANGO_STRETCH_SEMI_EXPANDED,
 539   PANGO_STRETCH_EXPANDED,
 540   PANGO_STRETCH_EXTRA_EXPANDED,
 541   PANGO_STRETCH_ULTRA_EXPANDED
 542 } PangoStretch;
 543 </pre>
 544 <p>
 545 An enumeration specifying the width of the font relative to other designs
 546 within a family.
 547 </p>
 548 <div class="variablelist"><table border="0">
 549 <col align="left" valign="top">
 550 <tbody>
 551 <tr>
 552 <td><p><a name="PANGO-STRETCH-ULTRA-CONDENSED--CAPS"></a><span class="term"><code class="literal">PANGO_STRETCH_ULTRA_CONDENSED</code></span></p></td>
 553 <td>ultra condensed width
 554 </td>
 555 </tr>
 556 <tr>
 557 <td><p><a name="PANGO-STRETCH-EXTRA-CONDENSED--CAPS"></a><span class="term"><code class="literal">PANGO_STRETCH_EXTRA_CONDENSED</code></span></p></td>
 558 <td>extra condensed width
 559 </td>
 560 </tr>
 561 <tr>
 562 <td><p><a name="PANGO-STRETCH-CONDENSED--CAPS"></a><span class="term"><code class="literal">PANGO_STRETCH_CONDENSED</code></span></p></td>
 563 <td>condensed width
 564 </td>
 565 </tr>
 566 <tr>
 567 <td><p><a name="PANGO-STRETCH-SEMI-CONDENSED--CAPS"></a><span class="term"><code class="literal">PANGO_STRETCH_SEMI_CONDENSED</code></span></p></td>
 568 <td>semi condensed width
 569 </td>
 570 </tr>
 571 <tr>
 572 <td><p><a name="PANGO-STRETCH-NORMAL--CAPS"></a><span class="term"><code class="literal">PANGO_STRETCH_NORMAL</code></span></p></td>
 573 <td>the normal width
 574 </td>
 575 </tr>
 576 <tr>
 577 <td><p><a name="PANGO-STRETCH-SEMI-EXPANDED--CAPS"></a><span class="term"><code class="literal">PANGO_STRETCH_SEMI_EXPANDED</code></span></p></td>
 578 <td>semi expanded width
 579 </td>
 580 </tr>
 581 <tr>
 582 <td><p><a name="PANGO-STRETCH-EXPANDED--CAPS"></a><span class="term"><code class="literal">PANGO_STRETCH_EXPANDED</code></span></p></td>
 583 <td>expanded width
 584 </td>
 585 </tr>
 586 <tr>
 587 <td><p><a name="PANGO-STRETCH-EXTRA-EXPANDED--CAPS"></a><span class="term"><code class="literal">PANGO_STRETCH_EXTRA_EXPANDED</code></span></p></td>
 588 <td>extra expanded width
 589 </td>
 590 </tr>
 591 <tr>
 592 <td><p><a name="PANGO-STRETCH-ULTRA-EXPANDED--CAPS"></a><span class="term"><code class="literal">PANGO_STRETCH_ULTRA_EXPANDED</code></span></p></td>
 593 <td>ultra expanded width
 594 </td>
 595 </tr>
 596 </tbody>
 597 </table></div>
 598 </div>
 599 <hr>
 600 <div class="refsect2" lang="en">
 601 <a name="PANGO-TYPE-STRETCH--CAPS"></a><h3>PANGO_TYPE_STRETCH</h3>
 602 <pre class="programlisting">#define PANGO_TYPE_STRETCH (pango_stretch_get_type())
 603 </pre>
 604 <p>
 605 The <a
 606 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
 607 ><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>.
 608 </p>
 609 </div>
 610 <hr>
 611 <div class="refsect2" lang="en">
 612 <a name="PangoFontMask"></a><h3>enum PangoFontMask</h3>
 613 <pre class="programlisting">typedef enum {
 614   PANGO_FONT_MASK_FAMILY  = 1 &lt;&lt; 0,
 615   PANGO_FONT_MASK_STYLE   = 1 &lt;&lt; 1,
 616   PANGO_FONT_MASK_VARIANT = 1 &lt;&lt; 2,
 617   PANGO_FONT_MASK_WEIGHT  = 1 &lt;&lt; 3,
 618   PANGO_FONT_MASK_STRETCH = 1 &lt;&lt; 4,
 619   PANGO_FONT_MASK_SIZE    = 1 &lt;&lt; 5,
 620   PANGO_FONT_MASK_GRAVITY = 1 &lt;&lt; 6
 621 } PangoFontMask;
 622 </pre>
 623 <p>
 624 The bits in a <a class="link" href="pango-Fonts.html#PangoFontMask" title="enum PangoFontMask"><span class="type">PangoFontMask</span></a> correspond to fields in a
 625 <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a> that have been set.
 626 </p>
 627 <div class="variablelist"><table border="0">
 628 <col align="left" valign="top">
 629 <tbody>
 630 <tr>
 631 <td><p><a name="PANGO-FONT-MASK-FAMILY--CAPS"></a><span class="term"><code class="literal">PANGO_FONT_MASK_FAMILY</code></span></p></td>
 632 <td>the font family is specified.
 633 </td>
 634 </tr>
 635 <tr>
 636 <td><p><a name="PANGO-FONT-MASK-STYLE--CAPS"></a><span class="term"><code class="literal">PANGO_FONT_MASK_STYLE</code></span></p></td>
 637 <td>the font style is specified.
 638 </td>
 639 </tr>
 640 <tr>
 641 <td><p><a name="PANGO-FONT-MASK-VARIANT--CAPS"></a><span class="term"><code class="literal">PANGO_FONT_MASK_VARIANT</code></span></p></td>
 642 <td>the font variant is specified.
 643 </td>
 644 </tr>
 645 <tr>
 646 <td><p><a name="PANGO-FONT-MASK-WEIGHT--CAPS"></a><span class="term"><code class="literal">PANGO_FONT_MASK_WEIGHT</code></span></p></td>
 647 <td>the font weight is specified.
 648 </td>
 649 </tr>
 650 <tr>
 651 <td><p><a name="PANGO-FONT-MASK-STRETCH--CAPS"></a><span class="term"><code class="literal">PANGO_FONT_MASK_STRETCH</code></span></p></td>
 652 <td>the font stretch is specified.
 653 </td>
 654 </tr>
 655 <tr>
 656 <td><p><a name="PANGO-FONT-MASK-SIZE--CAPS"></a><span class="term"><code class="literal">PANGO_FONT_MASK_SIZE</code></span></p></td>
 657 <td>the font size is specified.
 658 </td>
 659 </tr>
 660 <tr>
 661 <td><p><a name="PANGO-FONT-MASK-GRAVITY--CAPS"></a><span class="term"><code class="literal">PANGO_FONT_MASK_GRAVITY</code></span></p></td>
 662 <td>the font gravity is specified (Since: 1.16.)
 663 </td>
 664 </tr>
 665 </tbody>
 666 </table></div>
 667 </div>
 668 <hr>
 669 <div class="refsect2" lang="en">
 670 <a name="PANGO-TYPE-FONT-MASK--CAPS"></a><h3>PANGO_TYPE_FONT_MASK</h3>
 671 <pre class="programlisting">#define PANGO_TYPE_FONT_MASK (pango_font_mask_get_type())
 672 </pre>
 673 <p>
 674 The <a
 675 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
 676 ><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>.
 677 </p>
 678 </div>
 679 <hr>
 680 <div class="refsect2" lang="en">
 681 <a name="pango-font-description-new"></a><h3>pango_font_description_new ()</h3>
 682 <pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> * pango_font_description_new       (void);</pre>
 683 <p>
 684 Creates a new font description structure with all fields unset.</p>
 685 <p>
 686 </p>
 687 <div class="variablelist"><table border="0">
 688 <col align="left" valign="top">
 689 <tbody><tr>
 690 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 691 <td> the newly allocated <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>, which
 692               should be freed using <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>.
 693 </td>
 694 </tr></tbody>
 695 </table></div>
 696 </div>
 697 <hr>
 698 <div class="refsect2" lang="en">
 699 <a name="pango-font-description-copy"></a><h3>pango_font_description_copy ()</h3>
 700 <pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> * pango_font_description_copy      (const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc);</pre>
 701 <p>
 702 Make a copy of a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>.</p>
 703 <p>
 704 </p>
 705 <div class="variablelist"><table border="0">
 706 <col align="left" valign="top">
 707 <tbody>
 708 <tr>
 709 <td><p><span class="term"><em class="parameter"><code>desc</code></em> :</span></p></td>
 710 <td> a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>, may be <a
 711 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
 712 ><code class="literal">NULL</code></a>
 713 </td>
 714 </tr>
 715 <tr>
 716 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 717 <td> the newly allocated <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>, which should
 718               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
 719 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
 720 ><code class="literal">NULL</code></a>
 721               if <em class="parameter"><code>desc</code></em> was <a
 722 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
 723 ><code class="literal">NULL</code></a>.
 724 </td>
 725 </tr>
 726 </tbody>
 727 </table></div>
 728 </div>
 729 <hr>
 730 <div class="refsect2" lang="en">
 731 <a name="pango-font-description-copy-static"></a><h3>pango_font_description_copy_static ()</h3>
 732 <pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> * pango_font_description_copy_static
 733                                                         (const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc);</pre>
 734 <p>
 735 Like <a class="link" href="pango-Fonts.html#pango-font-description-copy" title="pango_font_description_copy ()"><code class="function">pango_font_description_copy()</code></a>, but only a shallow copy is made
 736 of the family name and other allocated fields. The result can only
 737 be used until <em class="parameter"><code>desc</code></em> is modified or freed. This is meant to be used
 738 when the copy is only needed temporarily.</p>
 739 <p>
 740 </p>
 741 <div class="variablelist"><table border="0">
 742 <col align="left" valign="top">
 743 <tbody>
 744 <tr>
 745 <td><p><span class="term"><em class="parameter"><code>desc</code></em> :</span></p></td>
 746 <td> a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>, may be <a
 747 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
 748 ><code class="literal">NULL</code></a>
 749 </td>
 750 </tr>
 751 <tr>
 752 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 753 <td> the newly allocated <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>, which should
 754               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
 755 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
 756 ><code class="literal">NULL</code></a>
 757               if <em class="parameter"><code>desc</code></em> was <a
 758 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
 759 ><code class="literal">NULL</code></a>.
 760 </td>
 761 </tr>
 762 </tbody>
 763 </table></div>
 764 </div>
 765 <hr>
 766 <div class="refsect2" lang="en">
 767 <a name="pango-font-description-hash"></a><h3>pango_font_description_hash ()</h3>
 768 <pre class="programlisting"><a
 769 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
 770 >guint</a>               pango_font_description_hash         (const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc);</pre>
 771 <p>
 772 Computes a hash of a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a> structure suitable
 773 to be used, for example, as an argument to <a
 774 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#g-hash-table-new"
 775 ><code class="function">g_hash_table_new()</code></a>.
 776 The hash value is independent of <em class="parameter"><code>desc-&gt;mask</code></em>.</p>
 777 <p>
 778 </p>
 779 <div class="variablelist"><table border="0">
 780 <col align="left" valign="top">
 781 <tbody>
 782 <tr>
 783 <td><p><span class="term"><em class="parameter"><code>desc</code></em> :</span></p></td>
 784 <td> a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>
 785 </td>
 786 </tr>
 787 <tr>
 788 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 789 <td> the hash value.
 790 </td>
 791 </tr>
 792 </tbody>
 793 </table></div>
 794 </div>
 795 <hr>
 796 <div class="refsect2" lang="en">
 797 <a name="pango-font-description-equal"></a><h3>pango_font_description_equal ()</h3>
 798 <pre class="programlisting"><a
 799 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
 800 >gboolean</a>            pango_font_description_equal        (const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc1,
 801                                                          const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc2);</pre>
 802 <p>
 803 Compares two font descriptions for equality. Two font descriptions
 804 are considered equal if the fonts they describe are provably identical.
 805 This means that their masks do not have to match, as long as other fields
 806 are all the same. (Two font descriptions may result in identical fonts
 807 being loaded, but still compare <a
 808 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
 809 ><code class="literal">FALSE</code></a>.)</p>
 810 <p>
 811 </p>
 812 <div class="variablelist"><table border="0">
 813 <col align="left" valign="top">
 814 <tbody>
 815 <tr>
 816 <td><p><span class="term"><em class="parameter"><code>desc1</code></em> :</span></p></td>
 817 <td> a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>
 818 </td>
 819 </tr>
 820 <tr>
 821 <td><p><span class="term"><em class="parameter"><code>desc2</code></em> :</span></p></td>
 822 <td> another <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>
 823 </td>
 824 </tr>
 825 <tr>
 826 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 827 <td> <a
 828 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
 829 ><code class="literal">TRUE</code></a> if the two font descriptions are identical,
 830          <a
 831 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
 832 ><code class="literal">FALSE</code></a> otherwise.
 833 </td>
 834 </tr>
 835 </tbody>
 836 </table></div>
 837 </div>
 838 <hr>
 839 <div class="refsect2" lang="en">
 840 <a name="pango-font-description-free"></a><h3>pango_font_description_free ()</h3>
 841 <pre class="programlisting">void                pango_font_description_free         (<a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc);</pre>
 842 <p>
 843 Frees a font description.</p>
 844 <p>
 845 </p>
 846 <div class="variablelist"><table border="0">
 847 <col align="left" valign="top">
 848 <tbody><tr>
 849 <td><p><span class="term"><em class="parameter"><code>desc</code></em> :</span></p></td>
 850 <td> a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>, may be <a
 851 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
 852 ><code class="literal">NULL</code></a>
 853 </td>
 854 </tr></tbody>
 855 </table></div>
 856 </div>
 857 <hr>
 858 <div class="refsect2" lang="en">
 859 <a name="pango-font-descriptions-free"></a><h3>pango_font_descriptions_free ()</h3>
 860 <pre class="programlisting">void                pango_font_descriptions_free        (<a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> **descs,
 861                                                          int n_descs);</pre>
 862 <p>
 863 Frees an array of font descriptions.</p>
 864 <p>
 865 </p>
 866 <div class="variablelist"><table border="0">
 867 <col align="left" valign="top">
 868 <tbody>
 869 <tr>
 870 <td><p><span class="term"><em class="parameter"><code>descs</code></em> :</span></p></td>
 871 <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
 872 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
 873 ><code class="literal">NULL</code></a>
 874 </td>
 875 </tr>
 876 <tr>
 877 <td><p><span class="term"><em class="parameter"><code>n_descs</code></em> :</span></p></td>
 878 <td> number of font descriptions in <em class="parameter"><code>descs</code></em>
 879 </td>
 880 </tr>
 881 </tbody>
 882 </table></div>
 883 </div>
 884 <hr>
 885 <div class="refsect2" lang="en">
 886 <a name="pango-font-description-set-family"></a><h3>pango_font_description_set_family ()</h3>
 887 <pre class="programlisting">void                pango_font_description_set_family   (<a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc,
 888                                                          const char *family);</pre>
 889 <p>
 890 Sets the family name field of a font description. The family
 891 name represents a family of related font styles, and will
 892 resolve to a particular <a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a>. In some uses of
 893 <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>, it is also possible to use a comma
 894 separated list of family names for this field.</p>
 895 <p>
 896 </p>
 897 <div class="variablelist"><table border="0">
 898 <col align="left" valign="top">
 899 <tbody>
 900 <tr>
 901 <td><p><span class="term"><em class="parameter"><code>desc</code></em> :</span></p></td>
 902 <td> a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>.
 903 </td>
 904 </tr>
 905 <tr>
 906 <td><p><span class="term"><em class="parameter"><code>family</code></em> :</span></p></td>
 907 <td> a string representing the family name.
 908 </td>
 909 </tr>
 910 </tbody>
 911 </table></div>
 912 </div>
 913 <hr>
 914 <div class="refsect2" lang="en">
 915 <a name="pango-font-description-set-family-static"></a><h3>pango_font_description_set_family_static ()</h3>
 916 <pre class="programlisting">void                pango_font_description_set_family_static
 917                                                         (<a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc,
 918                                                          const char *family);</pre>
 919 <p>
 920 Like <a class="link" href="pango-Fonts.html#pango-font-description-set-family" title="pango_font_description_set_family ()"><code class="function">pango_font_description_set_family()</code></a>, except that no
 921 copy of <em class="parameter"><code>family</code></em> is made. The caller must make sure that the
 922 string passed in stays around until <em class="parameter"><code>desc</code></em> has been freed
 923 or the name is set again. This function can be used if
 924 <em class="parameter"><code>family</code></em> is a static string such as a C string literal, or
 925 if <em class="parameter"><code>desc</code></em> is only needed temporarily.</p>
 926 <p>
 927 </p>
 928 <div class="variablelist"><table border="0">
 929 <col align="left" valign="top">
 930 <tbody>
 931 <tr>
 932 <td><p><span class="term"><em class="parameter"><code>desc</code></em> :</span></p></td>
 933 <td> a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>
 934 </td>
 935 </tr>
 936 <tr>
 937 <td><p><span class="term"><em class="parameter"><code>family</code></em> :</span></p></td>
 938 <td> a string representing the family name.
 939 </td>
 940 </tr>
 941 </tbody>
 942 </table></div>
 943 </div>
 944 <hr>
 945 <div class="refsect2" lang="en">
 946 <a name="pango-font-description-get-family"></a><h3>pango_font_description_get_family ()</h3>
 947 <pre class="programlisting">const char *        pango_font_description_get_family   (const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc);</pre>
 948 <p>
 949 Gets the family name field of a font description. See
 950 <a class="link" href="pango-Fonts.html#pango-font-description-set-family" title="pango_font_description_set_family ()"><code class="function">pango_font_description_set_family()</code></a>.</p>
 951 <p>
 952 </p>
 953 <div class="variablelist"><table border="0">
 954 <col align="left" valign="top">
 955 <tbody>
 956 <tr>
 957 <td><p><span class="term"><em class="parameter"><code>desc</code></em> :</span></p></td>
 958 <td> a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>.
 959 </td>
 960 </tr>
 961 <tr>
 962 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 963 <td> the family name field for the font description, or
 964               <a
 965 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
 966 ><code class="literal">NULL</code></a> if not previously set.  This has the same life-time
 967               as the font description itself and should not be freed.
 968 </td>
 969 </tr>
 970 </tbody>
 971 </table></div>
 972 </div>
 973 <hr>
 974 <div class="refsect2" lang="en">
 975 <a name="pango-font-description-set-style"></a><h3>pango_font_description_set_style ()</h3>
 976 <pre class="programlisting">void                pango_font_description_set_style    (<a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc,
 977                                                          <a class="link" href="pango-Fonts.html#PangoStyle" title="enum PangoStyle">PangoStyle</a> style);</pre>
 978 <p>
 979 Sets the style field of a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>. The
 980 <a class="link" href="pango-Fonts.html#PangoStyle" title="enum PangoStyle"><span class="type">PangoStyle</span></a> enumeration describes whether the font is slanted and
 981 the manner in which it is slanted; it can be either
 982 <a class="link" href="pango-Fonts.html#PANGO-STYLE-NORMAL--CAPS"><span class="type">PANGO_STYLE_NORMAL</span></a>, <a class="link" href="pango-Fonts.html#PANGO-STYLE-ITALIC--CAPS"><span class="type">PANGO_STYLE_ITALIC</span></a>, or <a class="link" href="pango-Fonts.html#PANGO-STYLE-OBLIQUE--CAPS"><span class="type">PANGO_STYLE_OBLIQUE</span></a>.
 983 Most fonts will either have a italic style or an oblique
 984 style, but not both, and font matching in Pango will
 985 match italic specifications with oblique fonts and vice-versa
 986 if an exact match is not found.</p>
 987 <p>
 988 </p>
 989 <div class="variablelist"><table border="0">
 990 <col align="left" valign="top">
 991 <tbody>
 992 <tr>
 993 <td><p><span class="term"><em class="parameter"><code>desc</code></em> :</span></p></td>
 994 <td> a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>
 995 </td>
 996 </tr>
 997 <tr>
 998 <td><p><span class="term"><em class="parameter"><code>style</code></em> :</span></p></td>
 999 <td> the style for the font description
1000 </td>
1001 </tr>
1002 </tbody>
1003 </table></div>
1004 </div>
1005 <hr>
1006 <div class="refsect2" lang="en">
1007 <a name="pango-font-description-get-style"></a><h3>pango_font_description_get_style ()</h3>
1008 <pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoStyle" title="enum PangoStyle">PangoStyle</a>          pango_font_description_get_style    (const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc);</pre>
1009 <p>
1010 Gets the style field of a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>. See
1011 <a class="link" href="pango-Fonts.html#pango-font-description-set-style" title="pango_font_description_set_style ()"><code class="function">pango_font_description_set_style()</code></a>.</p>
1012 <p>
1013 </p>
1014 <div class="variablelist"><table border="0">
1015 <col align="left" valign="top">
1016 <tbody>
1017 <tr>
1018 <td><p><span class="term"><em class="parameter"><code>desc</code></em> :</span></p></td>
1019 <td> a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>
1020 </td>
1021 </tr>
1022 <tr>
1023 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1024 <td> the style field for the font description.
1025   Use <a class="link" href="pango-Fonts.html#pango-font-description-get-set-fields" title="pango_font_description_get_set_fields ()"><code class="function">pango_font_description_get_set_fields()</code></a> to find out if
1026   the field was explicitly set or not.
1027 </td>
1028 </tr>
1029 </tbody>
1030 </table></div>
1031 </div>
1032 <hr>
1033 <div class="refsect2" lang="en">
1034 <a name="pango-font-description-set-variant"></a><h3>pango_font_description_set_variant ()</h3>
1035 <pre class="programlisting">void                pango_font_description_set_variant  (<a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc,
1036                                                          <a class="link" href="pango-Fonts.html#PangoVariant" title="enum PangoVariant">PangoVariant</a> variant);</pre>
1037 <p>
1038 Sets the variant field of a font description. The <a class="link" href="pango-Fonts.html#PangoVariant" title="enum PangoVariant"><span class="type">PangoVariant</span></a>
1039 can either be <a class="link" href="pango-Fonts.html#PANGO-VARIANT-NORMAL--CAPS"><code class="literal">PANGO_VARIANT_NORMAL</code></a> or <a class="link" href="pango-Fonts.html#PANGO-VARIANT-SMALL-CAPS--CAPS"><code class="literal">PANGO_VARIANT_SMALL_CAPS</code></a>.</p>
1040 <p>
1041 </p>
1042 <div class="variablelist"><table border="0">
1043 <col align="left" valign="top">
1044 <tbody>
1045 <tr>
1046 <td><p><span class="term"><em class="parameter"><code>desc</code></em> :</span></p></td>
1047 <td> a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>
1048 </td>
1049 </tr>
1050 <tr>
1051 <td><p><span class="term"><em class="parameter"><code>variant</code></em> :</span></p></td>
1052 <td> the variant type for the font description.
1053 </td>
1054 </tr>
1055 </tbody>
1056 </table></div>
1057 </div>
1058 <hr>
1059 <div class="refsect2" lang="en">
1060 <a name="pango-font-description-get-variant"></a><h3>pango_font_description_get_variant ()</h3>
1061 <pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoVariant" title="enum PangoVariant">PangoVariant</a>        pango_font_description_get_variant  (const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc);</pre>
1062 <p>
1063 Gets the variant field of a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>. See
1064 <a class="link" href="pango-Fonts.html#pango-font-description-set-variant" title="pango_font_description_set_variant ()"><code class="function">pango_font_description_set_variant()</code></a>.</p>
1065 <p>
1066 </p>
1067 <div class="variablelist"><table border="0">
1068 <col align="left" valign="top">
1069 <tbody>
1070 <tr>
1071 <td><p><span class="term"><em class="parameter"><code>desc</code></em> :</span></p></td>
1072 <td> a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>.
1073 </td>
1074 </tr>
1075 <tr>
1076 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1077 <td> the variant field for the font description. Use
1078   <a class="link" href="pango-Fonts.html#pango-font-description-get-set-fields" title="pango_font_description_get_set_fields ()"><code class="function">pango_font_description_get_set_fields()</code></a> to find out if
1079   the field was explicitly set or not.
1080 </td>
1081 </tr>
1082 </tbody>
1083 </table></div>
1084 </div>
1085 <hr>
1086 <div class="refsect2" lang="en">
1087 <a name="pango-font-description-set-weight"></a><h3>pango_font_description_set_weight ()</h3>
1088 <pre class="programlisting">void                pango_font_description_set_weight   (<a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc,
1089                                                          <a class="link" href="pango-Fonts.html#PangoWeight" title="enum PangoWeight">PangoWeight</a> weight);</pre>
1090 <p>
1091 Sets the weight field of a font description. The weight field
1092 specifies how bold or light the font should be. In addition
1093 to the values of the <a class="link" href="pango-Fonts.html#PangoWeight" title="enum PangoWeight"><span class="type">PangoWeight</span></a> enumeration, other intermediate
1094 numeric values are possible.</p>
1095 <p>
1096 </p>
1097 <div class="variablelist"><table border="0">
1098 <col align="left" valign="top">
1099 <tbody>
1100 <tr>
1101 <td><p><span class="term"><em class="parameter"><code>desc</code></em> :</span></p></td>
1102 <td> a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>
1103 </td>
1104 </tr>
1105 <tr>
1106 <td><p><span class="term"><em class="parameter"><code>weight</code></em> :</span></p></td>
1107 <td> the weight for the font description.
1108 </td>
1109 </tr>
1110 </tbody>
1111 </table></div>
1112 </div>
1113 <hr>
1114 <div class="refsect2" lang="en">
1115 <a name="pango-font-description-get-weight"></a><h3>pango_font_description_get_weight ()</h3>
1116 <pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoWeight" title="enum PangoWeight">PangoWeight</a>         pango_font_description_get_weight   (const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc);</pre>
1117 <p>
1118 Gets the weight field of a font description. See
1119 <a class="link" href="pango-Fonts.html#pango-font-description-set-weight" title="pango_font_description_set_weight ()"><code class="function">pango_font_description_set_weight()</code></a>.</p>
1120 <p>
1121 </p>
1122 <div class="variablelist"><table border="0">
1123 <col align="left" valign="top">
1124 <tbody>
1125 <tr>
1126 <td><p><span class="term"><em class="parameter"><code>desc</code></em> :</span></p></td>
1127 <td> a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>
1128 </td>
1129 </tr>
1130 <tr>
1131 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1132 <td> the weight field for the font description. Use
1133   <a class="link" href="pango-Fonts.html#pango-font-description-get-set-fields" title="pango_font_description_get_set_fields ()"><code class="function">pango_font_description_get_set_fields()</code></a> to find out if
1134   the field was explicitly set or not.
1135 </td>
1136 </tr>
1137 </tbody>
1138 </table></div>
1139 </div>
1140 <hr>
1141 <div class="refsect2" lang="en">
1142 <a name="pango-font-description-set-stretch"></a><h3>pango_font_description_set_stretch ()</h3>
1143 <pre class="programlisting">void                pango_font_description_set_stretch  (<a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc,
1144                                                          <a class="link" href="pango-Fonts.html#PangoStretch" title="enum PangoStretch">PangoStretch</a> stretch);</pre>
1145 <p>
1146 Sets the stretch field of a font description. The stretch field
1147 specifies how narrow or wide the font should be.</p>
1148 <p>
1149 </p>
1150 <div class="variablelist"><table border="0">
1151 <col align="left" valign="top">
1152 <tbody>
1153 <tr>
1154 <td><p><span class="term"><em class="parameter"><code>desc</code></em> :</span></p></td>
1155 <td> a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>
1156 </td>
1157 </tr>
1158 <tr>
1159 <td><p><span class="term"><em class="parameter"><code>stretch</code></em> :</span></p></td>
1160 <td> the stretch for the font description
1161 </td>
1162 </tr>
1163 </tbody>
1164 </table></div>
1165 </div>
1166 <hr>
1167 <div class="refsect2" lang="en">
1168 <a name="pango-font-description-get-stretch"></a><h3>pango_font_description_get_stretch ()</h3>
1169 <pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoStretch" title="enum PangoStretch">PangoStretch</a>        pango_font_description_get_stretch  (const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc);</pre>
1170 <p>
1171 Gets the stretch field of a font description.
1172 See <a class="link" href="pango-Fonts.html#pango-font-description-set-stretch" title="pango_font_description_set_stretch ()"><code class="function">pango_font_description_set_stretch()</code></a>.</p>
1173 <p>
1174 </p>
1175 <div class="variablelist"><table border="0">
1176 <col align="left" valign="top">
1177 <tbody>
1178 <tr>
1179 <td><p><span class="term"><em class="parameter"><code>desc</code></em> :</span></p></td>
1180 <td> a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>.
1181 </td>
1182 </tr>
1183 <tr>
1184 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1185 <td> the stretch field for the font description. Use
1186   <a class="link" href="pango-Fonts.html#pango-font-description-get-set-fields" title="pango_font_description_get_set_fields ()"><code class="function">pango_font_description_get_set_fields()</code></a> to find out if
1187   the field was explicitly set or not.
1188 </td>
1189 </tr>
1190 </tbody>
1191 </table></div>
1192 </div>
1193 <hr>
1194 <div class="refsect2" lang="en">
1195 <a name="pango-font-description-set-size"></a><h3>pango_font_description_set_size ()</h3>
1196 <pre class="programlisting">void                pango_font_description_set_size     (<a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc,
1197                                                          <a
1198 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
1199 >gint</a> size);</pre>
1200 <p>
1201 Sets the size field of a font description in fractional points. This is mutually
1202 exclusive with <a class="link" href="pango-Fonts.html#pango-font-description-set-absolute-size" title="pango_font_description_set_absolute_size ()"><code class="function">pango_font_description_set_absolute_size()</code></a>.</p>
1203 <p>
1204 </p>
1205 <div class="variablelist"><table border="0">
1206 <col align="left" valign="top">
1207 <tbody>
1208 <tr>
1209 <td><p><span class="term"><em class="parameter"><code>desc</code></em> :</span></p></td>
1210 <td> a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>
1211 </td>
1212 </tr>
1213 <tr>
1214 <td><p><span class="term"><em class="parameter"><code>size</code></em> :</span></p></td>
1215 <td> the size of the font in points, scaled by PANGO_SCALE. (That is,
1216        a <em class="parameter"><code>size</code></em> value of 10 * PANGO_SCALE is a 10 point font. The conversion
1217        factor between points and device units depends on system configuration
1218        and the output device. For screen display, a logical DPI of 96 is
1219        common, in which case a 10 point font corresponds to a 10 * (96 / 72) = 13.3
1220        pixel font. Use <a class="link" href="pango-Fonts.html#pango-font-description-set-absolute-size" title="pango_font_description_set_absolute_size ()"><code class="function">pango_font_description_set_absolute_size()</code></a> if you need
1221        a particular size in device units.
1222 </td>
1223 </tr>
1224 </tbody>
1225 </table></div>
1226 </div>
1227 <hr>
1228 <div class="refsect2" lang="en">
1229 <a name="pango-font-description-get-size"></a><h3>pango_font_description_get_size ()</h3>
1230 <pre class="programlisting"><a
1231 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
1232 >gint</a>                pango_font_description_get_size     (const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc);</pre>
1233 <p>
1234 Gets the size field of a font description.
1235 See <a class="link" href="pango-Fonts.html#pango-font-description-set-size" title="pango_font_description_set_size ()"><code class="function">pango_font_description_set_size()</code></a>.</p>
1236 <p>
1237 </p>
1238 <div class="variablelist"><table border="0">
1239 <col align="left" valign="top">
1240 <tbody>
1241 <tr>
1242 <td><p><span class="term"><em class="parameter"><code>desc</code></em> :</span></p></td>
1243 <td> a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>
1244 </td>
1245 </tr>
1246 <tr>
1247 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1248 <td> the size field for the font description in points or device units.
1249   You must call <a class="link" href="pango-Fonts.html#pango-font-description-get-size-is-absolute" title="pango_font_description_get_size_is_absolute ()"><code class="function">pango_font_description_get_size_is_absolute()</code></a>
1250   to find out which is the case. Returns 0 if the size field has not
1251   previously been set or it has been set to 0 explicitly.
1252   Use <a class="link" href="pango-Fonts.html#pango-font-description-get-set-fields" title="pango_font_description_get_set_fields ()"><code class="function">pango_font_description_get_set_fields()</code></a> to
1253   find out if the field was explicitly set or not.
1254 </td>
1255 </tr>
1256 </tbody>
1257 </table></div>
1258 </div>
1259 <hr>
1260 <div class="refsect2" lang="en">
1261 <a name="pango-font-description-set-absolute-size"></a><h3>pango_font_description_set_absolute_size ()</h3>
1262 <pre class="programlisting">void                pango_font_description_set_absolute_size
1263                                                         (<a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc,
1264                                                          double size);</pre>
1265 <p>
1266 Sets the size field of a font description, in device units. This is mutually
1267 exclusive with <a class="link" href="pango-Fonts.html#pango-font-description-set-size" title="pango_font_description_set_size ()"><code class="function">pango_font_description_set_size()</code></a> which sets the font size
1268 in points.</p>
1269 <p>
1270 </p>
1271 <div class="variablelist"><table border="0">
1272 <col align="left" valign="top">
1273 <tbody>
1274 <tr>
1275 <td><p><span class="term"><em class="parameter"><code>desc</code></em> :</span></p></td>
1276 <td> a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>
1277 </td>
1278 </tr>
1279 <tr>
1280 <td><p><span class="term"><em class="parameter"><code>size</code></em> :</span></p></td>
1281 <td> the new size, in Pango units. There are <a class="link" href="pango-Glyph-Storage.html#PANGO-SCALE--CAPS" title="PANGO_SCALE"><code class="literal">PANGO_SCALE</code></a> Pango units in one
1282   device unit. For an output backend where a device unit is a pixel, a <em class="parameter"><code>size</code></em>
1283   value of 10 * PANGO_SCALE gives a 10 pixel font.
1284 </td>
1285 </tr>
1286 </tbody>
1287 </table></div>
1288 <p class="since">Since 1.8</p>
1289 </div>
1290 <hr>
1291 <div class="refsect2" lang="en">
1292 <a name="pango-font-description-get-size-is-absolute"></a><h3>pango_font_description_get_size_is_absolute ()</h3>
1293 <pre class="programlisting"><a
1294 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
1295 >gboolean</a>            pango_font_description_get_size_is_absolute
1296                                                         (const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc);</pre>
1297 <p>
1298 Determines whether the size of the font is in points (not absolute) or device units (absolute).
1299 See <a class="link" href="pango-Fonts.html#pango-font-description-set-size" title="pango_font_description_set_size ()"><code class="function">pango_font_description_set_size()</code></a> and <a class="link" href="pango-Fonts.html#pango-font-description-set-absolute-size" title="pango_font_description_set_absolute_size ()"><code class="function">pango_font_description_set_absolute_size()</code></a>.</p>
1300 <p>
1301 </p>
1302 <div class="variablelist"><table border="0">
1303 <col align="left" valign="top">
1304 <tbody>
1305 <tr>
1306 <td><p><span class="term"><em class="parameter"><code>desc</code></em> :</span></p></td>
1307 <td> a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>
1308 </td>
1309 </tr>
1310 <tr>
1311 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1312 <td> whether the size for the font description is in
1313   points or device units.  Use <a class="link" href="pango-Fonts.html#pango-font-description-get-set-fields" title="pango_font_description_get_set_fields ()"><code class="function">pango_font_description_get_set_fields()</code></a> to
1314   find out if the size field of the font description was explicitly set or not.
1315
1316 </td>
1317 </tr>
1318 </tbody>
1319 </table></div>
1320 <p class="since">Since 1.8</p>
1321 </div>
1322 <hr>
1323 <div class="refsect2" lang="en">
1324 <a name="pango-font-description-set-gravity"></a><h3>pango_font_description_set_gravity ()</h3>
1325 <pre class="programlisting">void                pango_font_description_set_gravity  (<a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc,
1326                                                          <a class="link" href="pango-Vertical-Text.html#PangoGravity" title="enum PangoGravity">PangoGravity</a> gravity);</pre>
1327 <p>
1328 Sets the gravity field of a font description. The gravity field
1329 specifies how the glyphs should be rotated.  If <em class="parameter"><code>gravity</code></em> is
1330 <a class="link" href="pango-Vertical-Text.html#PANGO-GRAVITY-AUTO--CAPS"><code class="literal">PANGO_GRAVITY_AUTO</code></a>, this actually unsets the gravity mask on
1331 the font description.
1332 </p>
1333 <p>
1334 This function is seldom useful to the user.  Gravity should normally
1335 be set on a <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>.</p>
1336 <p>
1337 </p>
1338 <div class="variablelist"><table border="0">
1339 <col align="left" valign="top">
1340 <tbody>
1341 <tr>
1342 <td><p><span class="term"><em class="parameter"><code>desc</code></em> :</span></p></td>
1343 <td> a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>
1344 </td>
1345 </tr>
1346 <tr>
1347 <td><p><span class="term"><em class="parameter"><code>gravity</code></em> :</span></p></td>
1348 <td> the gravity for the font description.
1349 </td>
1350 </tr>
1351 </tbody>
1352 </table></div>
1353 <p class="since">Since 1.16</p>
1354 </div>
1355 <hr>
1356 <div class="refsect2" lang="en">
1357 <a name="pango-font-description-get-gravity"></a><h3>pango_font_description_get_gravity ()</h3>
1358 <pre class="programlisting"><a class="link" href="pango-Vertical-Text.html#PangoGravity" title="enum PangoGravity">PangoGravity</a>        pango_font_description_get_gravity  (const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc);</pre>
1359 <p>
1360 Gets the gravity field of a font description. See
1361 <a class="link" href="pango-Fonts.html#pango-font-description-set-gravity" title="pango_font_description_set_gravity ()"><code class="function">pango_font_description_set_gravity()</code></a>.</p>
1362 <p>
1363 </p>
1364 <div class="variablelist"><table border="0">
1365 <col align="left" valign="top">
1366 <tbody>
1367 <tr>
1368 <td><p><span class="term"><em class="parameter"><code>desc</code></em> :</span></p></td>
1369 <td> a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>
1370 </td>
1371 </tr>
1372 <tr>
1373 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1374 <td> the gravity field for the font description. Use
1375   <a class="link" href="pango-Fonts.html#pango-font-description-get-set-fields" title="pango_font_description_get_set_fields ()"><code class="function">pango_font_description_get_set_fields()</code></a> to find out if
1376   the field was explicitly set or not.
1377
1378 </td>
1379 </tr>
1380 </tbody>
1381 </table></div>
1382 <p class="since">Since 1.16</p>
1383 </div>
1384 <hr>
1385 <div class="refsect2" lang="en">
1386 <a name="pango-font-description-get-set-fields"></a><h3>pango_font_description_get_set_fields ()</h3>
1387 <pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontMask" title="enum PangoFontMask">PangoFontMask</a>       pango_font_description_get_set_fields
1388                                                         (const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc);</pre>
1389 <p>
1390 Determines which fields in a font description have been set.</p>
1391 <p>
1392 </p>
1393 <div class="variablelist"><table border="0">
1394 <col align="left" valign="top">
1395 <tbody>
1396 <tr>
1397 <td><p><span class="term"><em class="parameter"><code>desc</code></em> :</span></p></td>
1398 <td> a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>
1399 </td>
1400 </tr>
1401 <tr>
1402 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1403 <td> a bitmask with bits set corresponding to the
1404   fields in <em class="parameter"><code>desc</code></em> that have been set.
1405 </td>
1406 </tr>
1407 </tbody>
1408 </table></div>
1409 </div>
1410 <hr>
1411 <div class="refsect2" lang="en">
1412 <a name="pango-font-description-unset-fields"></a><h3>pango_font_description_unset_fields ()</h3>
1413 <pre class="programlisting">void                pango_font_description_unset_fields (<a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc,
1414                                                          <a class="link" href="pango-Fonts.html#PangoFontMask" title="enum PangoFontMask">PangoFontMask</a> to_unset);</pre>
1415 <p>
1416 Unsets some of the fields in a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>.  The unset
1417 fields will get back to their default values.</p>
1418 <p>
1419 </p>
1420 <div class="variablelist"><table border="0">
1421 <col align="left" valign="top">
1422 <tbody>
1423 <tr>
1424 <td><p><span class="term"><em class="parameter"><code>desc</code></em> :</span></p></td>
1425 <td> a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>
1426 </td>
1427 </tr>
1428 <tr>
1429 <td><p><span class="term"><em class="parameter"><code>to_unset</code></em> :</span></p></td>
1430 <td> bitmask of fields in the <em class="parameter"><code>desc</code></em> to unset.
1431 </td>
1432 </tr>
1433 </tbody>
1434 </table></div>
1435 </div>
1436 <hr>
1437 <div class="refsect2" lang="en">
1438 <a name="pango-font-description-merge"></a><h3>pango_font_description_merge ()</h3>
1439 <pre class="programlisting">void                pango_font_description_merge        (<a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc,
1440                                                          const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc_to_merge,
1441                                                          <a
1442 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
1443 >gboolean</a> replace_existing);</pre>
1444 <p>
1445 Merges the fields that are set in <em class="parameter"><code>desc_to_merge</code></em> into the fields in
1446 <em class="parameter"><code>desc</code></em>.  If <em class="parameter"><code>replace_existing</code></em> is <a
1447 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
1448 ><code class="literal">FALSE</code></a>, only fields in <em class="parameter"><code>desc</code></em> that
1449 are not already set are affected. If <a
1450 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
1451 ><code class="literal">TRUE</code></a>, then fields that are
1452 already set will be replaced as well.
1453 </p>
1454 <p>
1455 If <em class="parameter"><code>desc_to_merge</code></em> is <a
1456 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1457 ><code class="literal">NULL</code></a>, this function performs nothing.</p>
1458 <p>
1459 </p>
1460 <div class="variablelist"><table border="0">
1461 <col align="left" valign="top">
1462 <tbody>
1463 <tr>
1464 <td><p><span class="term"><em class="parameter"><code>desc</code></em> :</span></p></td>
1465 <td> a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>
1466 </td>
1467 </tr>
1468 <tr>
1469 <td><p><span class="term"><em class="parameter"><code>desc_to_merge</code></em> :</span></p></td>
1470 <td> the <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a> to merge from, or <a
1471 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1472 ><code class="literal">NULL</code></a>
1473 </td>
1474 </tr>
1475 <tr>
1476 <td><p><span class="term"><em class="parameter"><code>replace_existing</code></em> :</span></p></td>
1477 <td> if <a
1478 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
1479 ><code class="literal">TRUE</code></a>, replace fields in <em class="parameter"><code>desc</code></em> with the
1480   corresponding values from <em class="parameter"><code>desc_to_merge</code></em>, even if they
1481   are already exist.
1482 </td>
1483 </tr>
1484 </tbody>
1485 </table></div>
1486 </div>
1487 <hr>
1488 <div class="refsect2" lang="en">
1489 <a name="pango-font-description-merge-static"></a><h3>pango_font_description_merge_static ()</h3>
1490 <pre class="programlisting">void                pango_font_description_merge_static (<a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc,
1491                                                          const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc_to_merge,
1492                                                          <a
1493 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
1494 >gboolean</a> replace_existing);</pre>
1495 <p>
1496 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
1497 of the family name and other allocated fields. <em class="parameter"><code>desc</code></em> can only be
1498 used until <em class="parameter"><code>desc_to_merge</code></em> is modified or freed. This is meant
1499 to be used when the merged font description is only needed temporarily.</p>
1500 <p>
1501 </p>
1502 <div class="variablelist"><table border="0">
1503 <col align="left" valign="top">
1504 <tbody>
1505 <tr>
1506 <td><p><span class="term"><em class="parameter"><code>desc</code></em> :</span></p></td>
1507 <td> a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>
1508 </td>
1509 </tr>
1510 <tr>
1511 <td><p><span class="term"><em class="parameter"><code>desc_to_merge</code></em> :</span></p></td>
1512 <td> the <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a> to merge from
1513 </td>
1514 </tr>
1515 <tr>
1516 <td><p><span class="term"><em class="parameter"><code>replace_existing</code></em> :</span></p></td>
1517 <td> if <a
1518 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
1519 ><code class="literal">TRUE</code></a>, replace fields in <em class="parameter"><code>desc</code></em> with the
1520   corresponding values from <em class="parameter"><code>desc_to_merge</code></em>, even if they
1521   are already exist.
1522 </td>
1523 </tr>
1524 </tbody>
1525 </table></div>
1526 </div>
1527 <hr>
1528 <div class="refsect2" lang="en">
1529 <a name="pango-font-description-better-match"></a><h3>pango_font_description_better_match ()</h3>
1530 <pre class="programlisting"><a
1531 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
1532 >gboolean</a>            pango_font_description_better_match (const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc,
1533                                                          const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *old_match,
1534                                                          const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *new_match);</pre>
1535 <p>
1536 Determines if the style attributes of <em class="parameter"><code>new_match</code></em> are a closer match
1537 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
1538 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1539 ><code class="literal">NULL</code></a>,
1540 determines if <em class="parameter"><code>new_match</code></em> is a match at all.
1541 Approximate matching is done for
1542 weight and style; other style attributes must match exactly.
1543 Style attributes are all attributes other than family and size-related
1544 attributes.  Approximate matching for style considers PANGO_STYLE_OBLIQUE
1545 and PANGO_STYLE_ITALIC as matches, but not as good a match as when the
1546 styles are equal.
1547 </p>
1548 <p>
1549 Note that <em class="parameter"><code>old_match</code></em> must match <em class="parameter"><code>desc</code></em>.</p>
1550 <p>
1551 </p>
1552 <div class="variablelist"><table border="0">
1553 <col align="left" valign="top">
1554 <tbody>
1555 <tr>
1556 <td><p><span class="term"><em class="parameter"><code>desc</code></em> :</span></p></td>
1557 <td> a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>
1558 </td>
1559 </tr>
1560 <tr>
1561 <td><p><span class="term"><em class="parameter"><code>old_match</code></em> :</span></p></td>
1562 <td> a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>, or <a
1563 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1564 ><code class="literal">NULL</code></a>
1565 </td>
1566 </tr>
1567 <tr>
1568 <td><p><span class="term"><em class="parameter"><code>new_match</code></em> :</span></p></td>
1569 <td> a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>
1570 </td>
1571 </tr>
1572 <tr>
1573 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1574 <td> <a
1575 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
1576 ><code class="literal">TRUE</code></a> if <em class="parameter"><code>new_match</code></em> is a better match
1577 </td>
1578 </tr>
1579 </tbody>
1580 </table></div>
1581 </div>
1582 <hr>
1583 <div class="refsect2" lang="en">
1584 <a name="pango-font-description-from-string"></a><h3>pango_font_description_from_string ()</h3>
1585 <pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> * pango_font_description_from_string
1586                                                         (const char *str);</pre>
1587 <p>
1588 Creates a new font description from a string representation in the
1589 form "[FAMILY-LIST] [STYLE-OPTIONS] [SIZE]", where FAMILY-LIST is a
1590 comma separated list of families optionally terminated by a comma,
1591 STYLE_OPTIONS is a whitespace separated list of words where each WORD
1592 describes one of style, variant, weight, stretch, or gravity, and SIZE
1593 is a decimal number (size in points) or optionally followed by the
1594 unit modifier "px" for absolute size. Any one of the options may
1595 be absent.  If FAMILY-LIST is absent, then the family_name field of
1596 the resulting font description will be initialized to <a
1597 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1598 ><code class="literal">NULL</code></a>.  If
1599 STYLE-OPTIONS is missing, then all style options will be set to the
1600 default values. If SIZE is missing, the size in the resulting font
1601 description will be set to 0.</p>
1602 <p>
1603 </p>
1604 <div class="variablelist"><table border="0">
1605 <col align="left" valign="top">
1606 <tbody>
1607 <tr>
1608 <td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
1609 <td> string representation of a font description.
1610 </td>
1611 </tr>
1612 <tr>
1613 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1614 <td> a new <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>.
1615 </td>
1616 </tr>
1617 </tbody>
1618 </table></div>
1619 </div>
1620 <hr>
1621 <div class="refsect2" lang="en">
1622 <a name="pango-font-description-to-string"></a><h3>pango_font_description_to_string ()</h3>
1623 <pre class="programlisting">char *              pango_font_description_to_string    (const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc);</pre>
1624 <p>
1625 Creates a string representation of a font description. See
1626 <a class="link" href="pango-Fonts.html#pango-font-description-from-string" title="pango_font_description_from_string ()"><code class="function">pango_font_description_from_string()</code></a> for a description of the
1627 format of the string representation. The family list in the
1628 string description will only have a terminating comma if the
1629 last word of the list is a valid style option.</p>
1630 <p>
1631 </p>
1632 <div class="variablelist"><table border="0">
1633 <col align="left" valign="top">
1634 <tbody>
1635 <tr>
1636 <td><p><span class="term"><em class="parameter"><code>desc</code></em> :</span></p></td>
1637 <td> a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>
1638 </td>
1639 </tr>
1640 <tr>
1641 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1642 <td> a new string that must be freed with <a
1643 href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"
1644 ><code class="function">g_free()</code></a>.
1645 </td>
1646 </tr>
1647 </tbody>
1648 </table></div>
1649 </div>
1650 <hr>
1651 <div class="refsect2" lang="en">
1652 <a name="pango-font-description-to-filename"></a><h3>pango_font_description_to_filename ()</h3>
1653 <pre class="programlisting">char *              pango_font_description_to_filename  (const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc);</pre>
1654 <p>
1655 Creates a filename representation of a font description. The
1656 filename is identical to the result from calling
1657 <a class="link" href="pango-Fonts.html#pango-font-description-to-string" title="pango_font_description_to_string ()"><code class="function">pango_font_description_to_string()</code></a>, but with underscores instead of
1658 characters that are untypical in filenames, and in lower case only.</p>
1659 <p>
1660 </p>
1661 <div class="variablelist"><table border="0">
1662 <col align="left" valign="top">
1663 <tbody>
1664 <tr>
1665 <td><p><span class="term"><em class="parameter"><code>desc</code></em> :</span></p></td>
1666 <td> a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>
1667 </td>
1668 </tr>
1669 <tr>
1670 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1671 <td> a new string that must be freed with <a
1672 href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"
1673 ><code class="function">g_free()</code></a>.
1674 </td>
1675 </tr>
1676 </tbody>
1677 </table></div>
1678 </div>
1679 <hr>
1680 <div class="refsect2" lang="en">
1681 <a name="PangoFontMetrics"></a><h3>PangoFontMetrics</h3>
1682 <pre class="programlisting">typedef struct {
1683   guint ref_count;
1684
1685   int ascent;
1686   int descent;
1687   int approximate_char_width;
1688   int approximate_digit_width;
1689   int underline_position;
1690   int underline_thickness;
1691   int strikethrough_position;
1692   int strikethrough_thickness;
1693 } PangoFontMetrics;
1694 </pre>
1695 <p>
1696 A <a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure holds the overall metric information
1697 for a font (possibly restricted to a script). The fields of this
1698 structure are private to implementations of a font backend. See
1699 the documentation of the corresponding getters for documentation
1700 of their meaning.
1701 </p>
1702 <div class="variablelist"><table border="0">
1703 <col align="left" valign="top">
1704 <tbody>
1705 <tr>
1706 <td><p><span class="term"><a
1707 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
1708 >guint</a> <em class="structfield"><code>ref_count</code></em>;</span></p></td>
1709 <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>
1710             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>.
1711 </td>
1712 </tr>
1713 <tr>
1714 <td><p><span class="term">int <em class="structfield"><code>ascent</code></em>;</span></p></td>
1715 <td>the distance from the baseline to the highest point of the glyphs of
1716          the font. This is positive in practically all fonts.
1717 </td>
1718 </tr>
1719 <tr>
1720 <td><p><span class="term">int <em class="structfield"><code>descent</code></em>;</span></p></td>
1721 <td>the distance from the baseline to the lowest point of the glyphs of
1722          the font. This is positive in practically all fonts.
1723 </td>
1724 </tr>
1725 <tr>
1726 <td><p><span class="term">int <em class="structfield"><code>approximate_char_width</code></em>;</span></p></td>
1727 <td>approximate average width of the regular glyphs of
1728          the font.  Note that for this calculation, East Asian characters
1729          (those passing <a
1730 href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#g-unichar-iswide"
1731 ><code class="function">g_unichar_iswide()</code></a>) are counted as double-width.
1732          This produces a more uniform value for this measure across languages
1733          and results in more uniform and more expected UI sizes.
1734 </td>
1735 </tr>
1736 <tr>
1737 <td><p><span class="term">int <em class="structfield"><code>approximate_digit_width</code></em>;</span></p></td>
1738 <td>approximate average width of the glyphs for digits
1739          of the font.
1740 </td>
1741 </tr>
1742 <tr>
1743 <td><p><span class="term">int <em class="structfield"><code>underline_position</code></em>;</span></p></td>
1744 <td>position of the underline. This is normally negative.
1745 </td>
1746 </tr>
1747 <tr>
1748 <td><p><span class="term">int <em class="structfield"><code>underline_thickness</code></em>;</span></p></td>
1749 <td>thickness of the underline.
1750 </td>
1751 </tr>
1752 <tr>
1753 <td><p><span class="term">int <em class="structfield"><code>strikethrough_position</code></em>;</span></p></td>
1754 <td>position of the strikethrough line. This is
1755          normally positive.
1756 </td>
1757 </tr>
1758 <tr>
1759 <td><p><span class="term">int <em class="structfield"><code>strikethrough_thickness</code></em>;</span></p></td>
1760 <td>thickness of the strikethrough line.
1761 </td>
1762 </tr>
1763 </tbody>
1764 </table></div>
1765 </div>
1766 <hr>
1767 <div class="refsect2" lang="en">
1768 <a name="PANGO-TYPE-FONT-METRICS--CAPS"></a><h3>PANGO_TYPE_FONT_METRICS</h3>
1769 <pre class="programlisting">#define PANGO_TYPE_FONT_METRICS  (pango_font_metrics_get_type ())
1770 </pre>
1771 <p>
1772 The <a
1773 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
1774 ><span class="type">GObject</span></a> type for <a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics"><span class="type">PangoFontMetrics</span></a>.
1775 </p>
1776 </div>
1777 <hr>
1778 <div class="refsect2" lang="en">
1779 <a name="pango-font-metrics-ref"></a><h3>pango_font_metrics_ref ()</h3>
1780 <pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics">PangoFontMetrics</a> *  pango_font_metrics_ref              (<a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics">PangoFontMetrics</a> *metrics);</pre>
1781 <p>
1782 Increase the reference count of a font metrics structure by one.</p>
1783 <p>
1784 </p>
1785 <div class="variablelist"><table border="0">
1786 <col align="left" valign="top">
1787 <tbody>
1788 <tr>
1789 <td><p><span class="term"><em class="parameter"><code>metrics</code></em> :</span></p></td>
1790 <td> a <a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure, may be <a
1791 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1792 ><code class="literal">NULL</code></a>
1793 </td>
1794 </tr>
1795 <tr>
1796 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1797 <td> <em class="parameter"><code>metrics</code></em>
1798 </td>
1799 </tr>
1800 </tbody>
1801 </table></div>
1802 </div>
1803 <hr>
1804 <div class="refsect2" lang="en">
1805 <a name="pango-font-metrics-unref"></a><h3>pango_font_metrics_unref ()</h3>
1806 <pre class="programlisting">void                pango_font_metrics_unref            (<a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics">PangoFontMetrics</a> *metrics);</pre>
1807 <p>
1808 Decrease the reference count of a font metrics structure by one. If
1809 the result is zero, frees the structure and any associated
1810 memory.</p>
1811 <p>
1812 </p>
1813 <div class="variablelist"><table border="0">
1814 <col align="left" valign="top">
1815 <tbody><tr>
1816 <td><p><span class="term"><em class="parameter"><code>metrics</code></em> :</span></p></td>
1817 <td> a <a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure, may be <a
1818 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1819 ><code class="literal">NULL</code></a>
1820 </td>
1821 </tr></tbody>
1822 </table></div>
1823 </div>
1824 <hr>
1825 <div class="refsect2" lang="en">
1826 <a name="pango-font-metrics-get-ascent"></a><h3>pango_font_metrics_get_ascent ()</h3>
1827 <pre class="programlisting">int                 pango_font_metrics_get_ascent       (<a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics">PangoFontMetrics</a> *metrics);</pre>
1828 <p>
1829 Gets the ascent from a font metrics structure. The ascent is
1830 the distance from the baseline to the logical top of a line
1831 of text. (The logical top may be above or below the top of the
1832 actual drawn ink. It is necessary to lay out the text to figure
1833 where the ink will be.)</p>
1834 <p>
1835 </p>
1836 <div class="variablelist"><table border="0">
1837 <col align="left" valign="top">
1838 <tbody>
1839 <tr>
1840 <td><p><span class="term"><em class="parameter"><code>metrics</code></em> :</span></p></td>
1841 <td> a <a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure
1842 </td>
1843 </tr>
1844 <tr>
1845 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1846 <td> the ascent, in Pango units.
1847 </td>
1848 </tr>
1849 </tbody>
1850 </table></div>
1851 </div>
1852 <hr>
1853 <div class="refsect2" lang="en">
1854 <a name="pango-font-metrics-get-descent"></a><h3>pango_font_metrics_get_descent ()</h3>
1855 <pre class="programlisting">int                 pango_font_metrics_get_descent      (<a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics">PangoFontMetrics</a> *metrics);</pre>
1856 <p>
1857 Gets the descent from a font metrics structure. The descent is
1858 the distance from the baseline to the logical bottom of a line
1859 of text. (The logical bottom may be above or below the bottom of the
1860 actual drawn ink. It is necessary to lay out the text to figure
1861 where the ink will be.)</p>
1862 <p>
1863 </p>
1864 <div class="variablelist"><table border="0">
1865 <col align="left" valign="top">
1866 <tbody>
1867 <tr>
1868 <td><p><span class="term"><em class="parameter"><code>metrics</code></em> :</span></p></td>
1869 <td> a <a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure
1870 </td>
1871 </tr>
1872 <tr>
1873 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1874 <td> the descent, in Pango units.
1875 </td>
1876 </tr>
1877 </tbody>
1878 </table></div>
1879 </div>
1880 <hr>
1881 <div class="refsect2" lang="en">
1882 <a name="pango-font-metrics-get-approximate-char-width"></a><h3>pango_font_metrics_get_approximate_char_width ()</h3>
1883 <pre class="programlisting">int                 pango_font_metrics_get_approximate_char_width
1884                                                         (<a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics">PangoFontMetrics</a> *metrics);</pre>
1885 <p>
1886 Gets the approximate character width for a font metrics structure.
1887 This is merely a representative value useful, for example, for
1888 determining the initial size for a window. Actual characters in
1889 text will be wider and narrower than this.</p>
1890 <p>
1891 </p>
1892 <div class="variablelist"><table border="0">
1893 <col align="left" valign="top">
1894 <tbody>
1895 <tr>
1896 <td><p><span class="term"><em class="parameter"><code>metrics</code></em> :</span></p></td>
1897 <td> a <a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure
1898 </td>
1899 </tr>
1900 <tr>
1901 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1902 <td> the character width, in Pango units.
1903 </td>
1904 </tr>
1905 </tbody>
1906 </table></div>
1907 </div>
1908 <hr>
1909 <div class="refsect2" lang="en">
1910 <a name="pango-font-metrics-get-approximate-digit-width"></a><h3>pango_font_metrics_get_approximate_digit_width ()</h3>
1911 <pre class="programlisting">int                 pango_font_metrics_get_approximate_digit_width
1912                                                         (<a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics">PangoFontMetrics</a> *metrics);</pre>
1913 <p>
1914 Gets the approximate digit width for a font metrics structure.
1915 This is merely a representative value useful, for example, for
1916 determining the initial size for a window. Actual digits in
1917 text can be wider or narrower than this, though this value
1918 is generally somewhat more accurate than the result of
1919 <a class="link" href="pango-Fonts.html#pango-font-metrics-get-approximate-char-width" title="pango_font_metrics_get_approximate_char_width ()"><code class="function">pango_font_metrics_get_approximate_char_width()</code></a> for digits.</p>
1920 <p>
1921 </p>
1922 <div class="variablelist"><table border="0">
1923 <col align="left" valign="top">
1924 <tbody>
1925 <tr>
1926 <td><p><span class="term"><em class="parameter"><code>metrics</code></em> :</span></p></td>
1927 <td> a <a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure
1928 </td>
1929 </tr>
1930 <tr>
1931 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1932 <td> the digit width, in Pango units.
1933 </td>
1934 </tr>
1935 </tbody>
1936 </table></div>
1937 </div>
1938 <hr>
1939 <div class="refsect2" lang="en">
1940 <a name="pango-font-metrics-get-underline-thickness"></a><h3>pango_font_metrics_get_underline_thickness ()</h3>
1941 <pre class="programlisting">int                 pango_font_metrics_get_underline_thickness
1942                                                         (<a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics">PangoFontMetrics</a> *metrics);</pre>
1943 <p>
1944 Gets the suggested thickness to draw for the underline.</p>
1945 <p>
1946 </p>
1947 <div class="variablelist"><table border="0">
1948 <col align="left" valign="top">
1949 <tbody>
1950 <tr>
1951 <td><p><span class="term"><em class="parameter"><code>metrics</code></em> :</span></p></td>
1952 <td> a <a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure
1953 </td>
1954 </tr>
1955 <tr>
1956 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1957 <td> the suggested underline thickness, in Pango units.
1958
1959 </td>
1960 </tr>
1961 </tbody>
1962 </table></div>
1963 <p class="since">Since 1.6</p>
1964 </div>
1965 <hr>
1966 <div class="refsect2" lang="en">
1967 <a name="pango-font-metrics-get-underline-position"></a><h3>pango_font_metrics_get_underline_position ()</h3>
1968 <pre class="programlisting">int                 pango_font_metrics_get_underline_position
1969                                                         (<a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics">PangoFontMetrics</a> *metrics);</pre>
1970 <p>
1971 Gets the suggested position to draw the underline.
1972 The value returned is the distance <span class="emphasis"><em>above</em></span> the
1973 baseline of the top of the underline. Since most fonts have
1974 underline positions beneath the baseline, this value is typically
1975 negative.</p>
1976 <p>
1977 </p>
1978 <div class="variablelist"><table border="0">
1979 <col align="left" valign="top">
1980 <tbody>
1981 <tr>
1982 <td><p><span class="term"><em class="parameter"><code>metrics</code></em> :</span></p></td>
1983 <td> a <a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure
1984 </td>
1985 </tr>
1986 <tr>
1987 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1988 <td> the suggested underline position, in Pango units.
1989
1990 </td>
1991 </tr>
1992 </tbody>
1993 </table></div>
1994 <p class="since">Since 1.6</p>
1995 </div>
1996 <hr>
1997 <div class="refsect2" lang="en">
1998 <a name="pango-font-metrics-get-strikethrough-thickness"></a><h3>pango_font_metrics_get_strikethrough_thickness ()</h3>
1999 <pre class="programlisting">int                 pango_font_metrics_get_strikethrough_thickness
2000                                                         (<a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics">PangoFontMetrics</a> *metrics);</pre>
2001 <p>
2002 Gets the suggested thickness to draw for the strikethrough.</p>
2003 <p>
2004 </p>
2005 <div class="variablelist"><table border="0">
2006 <col align="left" valign="top">
2007 <tbody>
2008 <tr>
2009 <td><p><span class="term"><em class="parameter"><code>metrics</code></em> :</span></p></td>
2010 <td> a <a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure
2011 </td>
2012 </tr>
2013 <tr>
2014 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2015 <td> the suggested strikethrough thickness, in Pango units.
2016
2017 </td>
2018 </tr>
2019 </tbody>
2020 </table></div>
2021 <p class="since">Since 1.6</p>
2022 </div>
2023 <hr>
2024 <div class="refsect2" lang="en">
2025 <a name="pango-font-metrics-get-strikethrough-position"></a><h3>pango_font_metrics_get_strikethrough_position ()</h3>
2026 <pre class="programlisting">int                 pango_font_metrics_get_strikethrough_position
2027                                                         (<a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics">PangoFontMetrics</a> *metrics);</pre>
2028 <p>
2029 Gets the suggested position to draw the strikethrough.
2030 The value returned is the distance <span class="emphasis"><em>above</em></span> the
2031 baseline of the top of the strikethrough.</p>
2032 <p>
2033 </p>
2034 <div class="variablelist"><table border="0">
2035 <col align="left" valign="top">
2036 <tbody>
2037 <tr>
2038 <td><p><span class="term"><em class="parameter"><code>metrics</code></em> :</span></p></td>
2039 <td> a <a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure
2040 </td>
2041 </tr>
2042 <tr>
2043 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2044 <td> the suggested strikethrough position, in Pango units.
2045
2046 </td>
2047 </tr>
2048 </tbody>
2049 </table></div>
2050 <p class="since">Since 1.6</p>
2051 </div>
2052 <hr>
2053 <div class="refsect2" lang="en">
2054 <a name="PangoFont-struct"></a><h3>PangoFont</h3>
2055 <pre class="programlisting">typedef struct _PangoFont PangoFont;</pre>
2056 <p>
2057 The <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> structure is used to represent
2058 a font in a rendering-system-independent matter.
2059 To create an implementation of a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>,
2060 the rendering-system specific code should allocate
2061 a larger structure that contains a nested
2062 <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>, fill in the <em class="structfield"><code>klass</code></em> member of
2063 the nested <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> with a pointer to
2064 a appropriate <span class="type">PangoFontClass</span>, then call
2065 <code class="function">pango_font_init()</code> on the structure.
2066 </p>
2067 <p>
2068 The <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> structure contains one member
2069 which the implementation fills in.
2070 </p>
2071 </div>
2072 <hr>
2073 <div class="refsect2" lang="en">
2074 <a name="PANGO-TYPE-FONT--CAPS"></a><h3>PANGO_TYPE_FONT</h3>
2075 <pre class="programlisting">#define PANGO_TYPE_FONT              (pango_font_get_type ())
2076 </pre>
2077 <p>
2078 The <a
2079 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
2080 ><span class="type">GObject</span></a> type for <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.
2081 </p>
2082 </div>
2083 <hr>
2084 <div class="refsect2" lang="en">
2085 <a name="PANGO-FONT--CAPS"></a><h3>PANGO_FONT()</h3>
2086 <pre class="programlisting">#define PANGO_FONT(object)           (G_TYPE_CHECK_INSTANCE_CAST ((object), PANGO_TYPE_FONT, PangoFont))
2087 </pre>
2088 <p>
2089 Casts a <a
2090 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
2091 ><span class="type">GObject</span></a> to a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.
2092 </p>
2093 <div class="variablelist"><table border="0">
2094 <col align="left" valign="top">
2095 <tbody><tr>
2096 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
2097 <td>a <a
2098 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
2099 ><span class="type">GObject</span></a>.
2100 </td>
2101 </tr></tbody>
2102 </table></div>
2103 </div>
2104 <hr>
2105 <div class="refsect2" lang="en">
2106 <a name="PANGO-IS-FONT--CAPS"></a><h3>PANGO_IS_FONT()</h3>
2107 <pre class="programlisting">#define PANGO_IS_FONT(object)        (G_TYPE_CHECK_INSTANCE_TYPE ((object), PANGO_TYPE_FONT))
2108 </pre>
2109 <p>
2110 Returns <a
2111 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
2112 ><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>.
2113 </p>
2114 <div class="variablelist"><table border="0">
2115 <col align="left" valign="top">
2116 <tbody><tr>
2117 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
2118 <td>a <a
2119 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
2120 ><span class="type">GObject</span></a>.
2121 </td>
2122 </tr></tbody>
2123 </table></div>
2124 </div>
2125 <hr>
2126 <div class="refsect2" lang="en">
2127 <a name="pango-font-find-shaper"></a><h3>pango_font_find_shaper ()</h3>
2128 <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,
2129                                                          <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage">PangoLanguage</a> *language,
2130                                                          <a
2131 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"
2132 >guint32</a> ch);</pre>
2133 <p>
2134 Finds the best matching shaper for a font for a particular
2135 language tag and character point.</p>
2136 <p>
2137 </p>
2138 <div class="variablelist"><table border="0">
2139 <col align="left" valign="top">
2140 <tbody>
2141 <tr>
2142 <td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
2143 <td> a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>
2144 </td>
2145 </tr>
2146 <tr>
2147 <td><p><span class="term"><em class="parameter"><code>language</code></em> :</span></p></td>
2148 <td> the language tag
2149 </td>
2150 </tr>
2151 <tr>
2152 <td><p><span class="term"><em class="parameter"><code>ch</code></em> :</span></p></td>
2153 <td> a Unicode character.
2154 </td>
2155 </tr>
2156 <tr>
2157 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2158 <td> the best matching shaper.
2159 </td>
2160 </tr>
2161 </tbody>
2162 </table></div>
2163 </div>
2164 <hr>
2165 <div class="refsect2" lang="en">
2166 <a name="pango-font-describe"></a><h3>pango_font_describe ()</h3>
2167 <pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> * pango_font_describe              (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font);</pre>
2168 <p>
2169 Returns a description of the font, with font size set in points.
2170 Use <a class="link" href="pango-Fonts.html#pango-font-describe-with-absolute-size" title="pango_font_describe_with_absolute_size ()"><code class="function">pango_font_describe_with_absolute_size()</code></a> if you want the font
2171 size in device units.</p>
2172 <p>
2173 </p>
2174 <div class="variablelist"><table border="0">
2175 <col align="left" valign="top">
2176 <tbody>
2177 <tr>
2178 <td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
2179 <td> a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>
2180 </td>
2181 </tr>
2182 <tr>
2183 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2184 <td> a newly-allocated <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a> object.
2185 </td>
2186 </tr>
2187 </tbody>
2188 </table></div>
2189 </div>
2190 <hr>
2191 <div class="refsect2" lang="en">
2192 <a name="pango-font-describe-with-absolute-size"></a><h3>pango_font_describe_with_absolute_size ()</h3>
2193 <pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> * pango_font_describe_with_absolute_size
2194                                                         (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font);</pre>
2195 <p>
2196 Returns a description of the font, with absolute font size set
2197 (in device units). Use <a class="link" href="pango-Fonts.html#pango-font-describe" title="pango_font_describe ()"><code class="function">pango_font_describe()</code></a> if you want the font
2198 size in points.</p>
2199 <p>
2200 </p>
2201 <div class="variablelist"><table border="0">
2202 <col align="left" valign="top">
2203 <tbody>
2204 <tr>
2205 <td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
2206 <td> a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>
2207 </td>
2208 </tr>
2209 <tr>
2210 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2211 <td> a newly-allocated <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a> object.
2212
2213 </td>
2214 </tr>
2215 </tbody>
2216 </table></div>
2217 <p class="since">Since 1.14</p>
2218 </div>
2219 <hr>
2220 <div class="refsect2" lang="en">
2221 <a name="pango-font-get-coverage"></a><h3>pango_font_get_coverage ()</h3>
2222 <pre class="programlisting"><a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage">PangoCoverage</a> *     pango_font_get_coverage             (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
2223                                                          <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage">PangoLanguage</a> *language);</pre>
2224 <p>
2225 Computes the coverage map for a given font and language tag.</p>
2226 <p>
2227 </p>
2228 <div class="variablelist"><table border="0">
2229 <col align="left" valign="top">
2230 <tbody>
2231 <tr>
2232 <td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
2233 <td> a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>
2234 </td>
2235 </tr>
2236 <tr>
2237 <td><p><span class="term"><em class="parameter"><code>language</code></em> :</span></p></td>
2238 <td> the language tag
2239 </td>
2240 </tr>
2241 <tr>
2242 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2243 <td> a newly-allocated <a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage"><span class="type">PangoCoverage</span></a> object.
2244 </td>
2245 </tr>
2246 </tbody>
2247 </table></div>
2248 </div>
2249 <hr>
2250 <div class="refsect2" lang="en">
2251 <a name="pango-font-get-glyph-extents"></a><h3>pango_font_get_glyph_extents ()</h3>
2252 <pre class="programlisting">void                pango_font_get_glyph_extents        (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
2253                                                          <a class="link" href="pango-Glyph-Storage.html#PangoGlyph" title="PangoGlyph">PangoGlyph</a> glyph,
2254                                                          <a class="link" href="pango-Glyph-Storage.html#PangoRectangle" title="PangoRectangle">PangoRectangle</a> *ink_rect,
2255                                                          <a class="link" href="pango-Glyph-Storage.html#PangoRectangle" title="PangoRectangle">PangoRectangle</a> *logical_rect);</pre>
2256 <p>
2257 Gets the logical and ink extents of a glyph within a font. The
2258 coordinate system for each rectangle has its origin at the
2259 base line and horizontal origin of the character with increasing
2260 coordinates extending to the right and down. The macros <a class="link" href="pango-Glyph-Storage.html#PANGO-ASCENT--CAPS" title="PANGO_ASCENT()"><code class="function">PANGO_ASCENT()</code></a>,
2261 <a class="link" href="pango-Glyph-Storage.html#PANGO-DESCENT--CAPS" title="PANGO_DESCENT()"><code class="function">PANGO_DESCENT()</code></a>, <a class="link" href="pango-Glyph-Storage.html#PANGO-LBEARING--CAPS" title="PANGO_LBEARING()"><code class="function">PANGO_LBEARING()</code></a>, and <a class="link" href="pango-Glyph-Storage.html#PANGO-RBEARING--CAPS" title="PANGO_RBEARING()"><code class="function">PANGO_RBEARING()</code></a> can be used to convert
2262 from the extents rectangle to more traditional font metrics. The units
2263 of the rectangles are in 1/PANGO_SCALE of a device unit.
2264 </p>
2265 <p>
2266 If <em class="parameter"><code>font</code></em> is <a
2267 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2268 ><code class="literal">NULL</code></a>, this function gracefully sets some sane values in the
2269 output variables and returns.</p>
2270 <p>
2271 </p>
2272 <div class="variablelist"><table border="0">
2273 <col align="left" valign="top">
2274 <tbody>
2275 <tr>
2276 <td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
2277 <td> a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>
2278 </td>
2279 </tr>
2280 <tr>
2281 <td><p><span class="term"><em class="parameter"><code>glyph</code></em> :</span></p></td>
2282 <td> the glyph index
2283 </td>
2284 </tr>
2285 <tr>
2286 <td><p><span class="term"><em class="parameter"><code>ink_rect</code></em> :</span></p></td>
2287 <td> rectangle used to store the extents of the glyph as drawn
2288            or <a
2289 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2290 ><code class="literal">NULL</code></a> to indicate that the result is not needed.
2291 </td>
2292 </tr>
2293 <tr>
2294 <td><p><span class="term"><em class="parameter"><code>logical_rect</code></em> :</span></p></td>
2295 <td> rectangle used to store the logical extents of the glyph
2296            or <a
2297 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2298 ><code class="literal">NULL</code></a> to indicate that the result is not needed.
2299 </td>
2300 </tr>
2301 </tbody>
2302 </table></div>
2303 </div>
2304 <hr>
2305 <div class="refsect2" lang="en">
2306 <a name="pango-font-get-metrics"></a><h3>pango_font_get_metrics ()</h3>
2307 <pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics">PangoFontMetrics</a> *  pango_font_get_metrics              (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
2308                                                          <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage">PangoLanguage</a> *language);</pre>
2309 <p>
2310 Gets overall metric information for a font. Since the metrics may be
2311 substantially different for different scripts, a language tag can
2312 be provided to indicate that the metrics should be retrieved that
2313 correspond to the script(s) used by that language.
2314 </p>
2315 <p>
2316 If <em class="parameter"><code>font</code></em> is <a
2317 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2318 ><code class="literal">NULL</code></a>, this function gracefully sets some sane values in the
2319 output variables and returns.</p>
2320 <p>
2321 </p>
2322 <div class="variablelist"><table border="0">
2323 <col align="left" valign="top">
2324 <tbody>
2325 <tr>
2326 <td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
2327 <td> a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>
2328 </td>
2329 </tr>
2330 <tr>
2331 <td><p><span class="term"><em class="parameter"><code>language</code></em> :</span></p></td>
2332 <td> language tag used to determine which script to get the metrics
2333            for, or <a
2334 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2335 ><code class="literal">NULL</code></a> to indicate to get the metrics for the entire
2336            font.
2337 </td>
2338 </tr>
2339 <tr>
2340 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2341 <td> a <a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> object. The caller must call <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>
2342   when finished using the object.
2343 </td>
2344 </tr>
2345 </tbody>
2346 </table></div>
2347 </div>
2348 <hr>
2349 <div class="refsect2" lang="en">
2350 <a name="pango-font-get-font-map"></a><h3>pango_font_get_font_map ()</h3>
2351 <pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontMap">PangoFontMap</a> *      pango_font_get_font_map             (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font);</pre>
2352 <p>
2353 Gets the font map for which the font was created.
2354 </p>
2355 <p>
2356 Note that the font maintains a <em class="firstterm">weak</em> reference
2357 to the font map, so if all references to font map are dropped, the font
2358 map will be finalized even if there are fonts created with the font
2359 map that are still alive.  In that case this function will return <a
2360 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2361 ><code class="literal">NULL</code></a>.
2362 It is the responsibility of the user to ensure that the font map is kept
2363 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
2364 a reference to the font map.</p>
2365 <p>
2366 </p>
2367 <div class="variablelist"><table border="0">
2368 <col align="left" valign="top">
2369 <tbody>
2370 <tr>
2371 <td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
2372 <td> a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>, or <a
2373 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2374 ><code class="literal">NULL</code></a>
2375 </td>
2376 </tr>
2377 <tr>
2378 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2379 <td> the <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> for the font, or <a
2380 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2381 ><code class="literal">NULL</code></a> if <em class="parameter"><code>font</code></em> is <a
2382 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2383 ><code class="literal">NULL</code></a>.
2384
2385 </td>
2386 </tr>
2387 </tbody>
2388 </table></div>
2389 <p class="since">Since 1.10</p>
2390 </div>
2391 <hr>
2392 <div class="refsect2" lang="en">
2393 <a name="PangoFontFamily-struct"></a><h3>PangoFontFamily</h3>
2394 <pre class="programlisting">typedef struct _PangoFontFamily PangoFontFamily;</pre>
2395 <p>
2396 The <a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a> structure is used to represent a family of related
2397 font faces. The faces in a family share a common design, but differ in
2398 slant, weight, width and other aspects.
2399 </p>
2400 </div>
2401 <hr>
2402 <div class="refsect2" lang="en">
2403 <a name="PANGO-TYPE-FONT-FAMILY--CAPS"></a><h3>PANGO_TYPE_FONT_FAMILY</h3>
2404 <pre class="programlisting">#define PANGO_TYPE_FONT_FAMILY              (pango_font_family_get_type ())
2405 </pre>
2406 <p>
2407 The <a
2408 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
2409 ><span class="type">GObject</span></a> type for <a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a>.
2410 </p>
2411 </div>
2412 <hr>
2413 <div class="refsect2" lang="en">
2414 <a name="PANGO-FONT-FAMILY--CAPS"></a><h3>PANGO_FONT_FAMILY()</h3>
2415 <pre class="programlisting">#define PANGO_FONT_FAMILY(object)           (G_TYPE_CHECK_INSTANCE_CAST ((object), PANGO_TYPE_FONT_FAMILY, PangoFontFamily))
2416 </pre>
2417 <p>
2418 Casts a <a
2419 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
2420 ><span class="type">GObject</span></a> to a <a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a>.
2421 </p>
2422 <div class="variablelist"><table border="0">
2423 <col align="left" valign="top">
2424 <tbody><tr>
2425 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
2426 <td>a <a
2427 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
2428 ><span class="type">GObject</span></a>.
2429 </td>
2430 </tr></tbody>
2431 </table></div>
2432 </div>
2433 <hr>
2434 <div class="refsect2" lang="en">
2435 <a name="PANGO-IS-FONT-FAMILY--CAPS"></a><h3>PANGO_IS_FONT_FAMILY()</h3>
2436 <pre class="programlisting">#define PANGO_IS_FONT_FAMILY(object)        (G_TYPE_CHECK_INSTANCE_TYPE ((object), PANGO_TYPE_FONT_FAMILY))
2437 </pre>
2438 <p>
2439 Returns <a
2440 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
2441 ><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>.
2442 </p>
2443 <div class="variablelist"><table border="0">
2444 <col align="left" valign="top">
2445 <tbody><tr>
2446 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
2447 <td>a <a
2448 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
2449 ><span class="type">GObject</span></a>.
2450 </td>
2451 </tr></tbody>
2452 </table></div>
2453 </div>
2454 <hr>
2455 <div class="refsect2" lang="en">
2456 <a name="pango-font-family-get-name"></a><h3>pango_font_family_get_name ()</h3>
2457 <pre class="programlisting">const char *        pango_font_family_get_name          (<a class="link" href="pango-Fonts.html#PangoFontFamily">PangoFontFamily</a> *family);</pre>
2458 <p>
2459 Gets the name of the family. The name is unique among all
2460 fonts for the font backend and can be used in a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>
2461 to specify that a face from this family is desired.</p>
2462 <p>
2463 </p>
2464 <div class="variablelist"><table border="0">
2465 <col align="left" valign="top">
2466 <tbody>
2467 <tr>
2468 <td><p><span class="term"><em class="parameter"><code>family</code></em> :</span></p></td>
2469 <td> a <a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a>
2470 </td>
2471 </tr>
2472 <tr>
2473 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2474 <td> the name of the family. This string is owned
2475   by the family object and must not be modified or freed.
2476 </td>
2477 </tr>
2478 </tbody>
2479 </table></div>
2480 </div>
2481 <hr>
2482 <div class="refsect2" lang="en">
2483 <a name="pango-font-family-is-monospace"></a><h3>pango_font_family_is_monospace ()</h3>
2484 <pre class="programlisting"><a
2485 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
2486 >gboolean</a>            pango_font_family_is_monospace      (<a class="link" href="pango-Fonts.html#PangoFontFamily">PangoFontFamily</a> *family);</pre>
2487 <p>
2488 A monospace font is a font designed for text display where the the
2489 characters form a regular grid. For Western languages this would
2490 mean that the advance width of all characters are the same, but
2491 this categorization also includes Asian fonts which include
2492 double-width characters: characters that occupy two grid cells.
2493 <a
2494 href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#g-unichar-iswide"
2495 ><code class="function">g_unichar_iswide()</code></a> returns a result that indicates whether a
2496 character is typically double-width in a monospace font.
2497 </p>
2498 <p>
2499 The best way to find out the grid-cell size is to call
2500 <a class="link" href="pango-Fonts.html#pango-font-metrics-get-approximate-digit-width" title="pango_font_metrics_get_approximate_digit_width ()"><code class="function">pango_font_metrics_get_approximate_digit_width()</code></a>, since the results
2501 of <a class="link" href="pango-Fonts.html#pango-font-metrics-get-approximate-char-width" title="pango_font_metrics_get_approximate_char_width ()"><code class="function">pango_font_metrics_get_approximate_char_width()</code></a> may be affected
2502 by double-width characters.</p>
2503 <p>
2504 </p>
2505 <div class="variablelist"><table border="0">
2506 <col align="left" valign="top">
2507 <tbody>
2508 <tr>
2509 <td><p><span class="term"><em class="parameter"><code>family</code></em> :</span></p></td>
2510 <td> a <a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a>
2511 </td>
2512 </tr>
2513 <tr>
2514 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2515 <td> <a
2516 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
2517 ><code class="literal">TRUE</code></a> if the family is monospace.
2518
2519 </td>
2520 </tr>
2521 </tbody>
2522 </table></div>
2523 <p class="since">Since 1.4</p>
2524 </div>
2525 <hr>
2526 <div class="refsect2" lang="en">
2527 <a name="pango-font-family-list-faces"></a><h3>pango_font_family_list_faces ()</h3>
2528 <pre class="programlisting">void                pango_font_family_list_faces        (<a class="link" href="pango-Fonts.html#PangoFontFamily">PangoFontFamily</a> *family,
2529                                                          <a class="link" href="pango-Fonts.html#PangoFontFace">PangoFontFace</a> ***faces,
2530                                                          int *n_faces);</pre>
2531 <p>
2532 Lists the different font faces that make up <em class="parameter"><code>family</code></em>. The faces
2533 in a family share a common design, but differ in slant, weight,
2534 width and other aspects.</p>
2535 <p>
2536 </p>
2537 <div class="variablelist"><table border="0">
2538 <col align="left" valign="top">
2539 <tbody>
2540 <tr>
2541 <td><p><span class="term"><em class="parameter"><code>family</code></em> :</span></p></td>
2542 <td> a <a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a>
2543 </td>
2544 </tr>
2545 <tr>
2546 <td><p><span class="term"><em class="parameter"><code>faces</code></em> :</span></p></td>
2547 <td> location to store an array of pointers to <a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a>
2548   objects, or <a
2549 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2550 ><code class="literal">NULL</code></a>. This array should be freed with <a
2551 href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"
2552 ><code class="function">g_free()</code></a>
2553   when it is no longer needed.
2554 </td>
2555 </tr>
2556 <tr>
2557 <td><p><span class="term"><em class="parameter"><code>n_faces</code></em> :</span></p></td>
2558 <td> location to store number of elements in <em class="parameter"><code>faces</code></em>.
2559 </td>
2560 </tr>
2561 </tbody>
2562 </table></div>
2563 </div>
2564 <hr>
2565 <div class="refsect2" lang="en">
2566 <a name="PangoFontFace-struct"></a><h3>PangoFontFace</h3>
2567 <pre class="programlisting">typedef struct _PangoFontFace PangoFontFace;</pre>
2568 <p>
2569 The <a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a> structure is used to represent a group of fonts with
2570 the same family, slant, weight, width, but varying sizes.
2571 </p>
2572 </div>
2573 <hr>
2574 <div class="refsect2" lang="en">
2575 <a name="PANGO-TYPE-FONT-FACE--CAPS"></a><h3>PANGO_TYPE_FONT_FACE</h3>
2576 <pre class="programlisting">#define PANGO_TYPE_FONT_FACE              (pango_font_face_get_type ())
2577 </pre>
2578 <p>
2579 The <a
2580 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
2581 ><span class="type">GObject</span></a> type for <a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a>.
2582 </p>
2583 </div>
2584 <hr>
2585 <div class="refsect2" lang="en">
2586 <a name="PANGO-FONT-FACE--CAPS"></a><h3>PANGO_FONT_FACE()</h3>
2587 <pre class="programlisting">#define PANGO_FONT_FACE(object)           (G_TYPE_CHECK_INSTANCE_CAST ((object), PANGO_TYPE_FONT_FACE, PangoFontFace))
2588 </pre>
2589 <p>
2590 Casts a <a
2591 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
2592 ><span class="type">GObject</span></a> to a <a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a>.
2593 </p>
2594 <div class="variablelist"><table border="0">
2595 <col align="left" valign="top">
2596 <tbody><tr>
2597 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
2598 <td>a <a
2599 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
2600 ><span class="type">GObject</span></a>.
2601 </td>
2602 </tr></tbody>
2603 </table></div>
2604 </div>
2605 <hr>
2606 <div class="refsect2" lang="en">
2607 <a name="PANGO-IS-FONT-FACE--CAPS"></a><h3>PANGO_IS_FONT_FACE()</h3>
2608 <pre class="programlisting">#define PANGO_IS_FONT_FACE(object)        (G_TYPE_CHECK_INSTANCE_TYPE ((object), PANGO_TYPE_FONT_FACE))
2609 </pre>
2610 <p>
2611 Returns <a
2612 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
2613 ><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>.
2614 </p>
2615 <div class="variablelist"><table border="0">
2616 <col align="left" valign="top">
2617 <tbody><tr>
2618 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
2619 <td>a <a
2620 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
2621 ><span class="type">GObject</span></a>.
2622 </td>
2623 </tr></tbody>
2624 </table></div>
2625 </div>
2626 <hr>
2627 <div class="refsect2" lang="en">
2628 <a name="pango-font-face-get-face-name"></a><h3>pango_font_face_get_face_name ()</h3>
2629 <pre class="programlisting">const char *        pango_font_face_get_face_name       (<a class="link" href="pango-Fonts.html#PangoFontFace">PangoFontFace</a> *face);</pre>
2630 <p>
2631 Gets a name representing the style of this face among the
2632 different faces in the <a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a> for the face. This
2633 name is unique among all faces in the family and is suitable
2634 for displaying to users.</p>
2635 <p>
2636 </p>
2637 <div class="variablelist"><table border="0">
2638 <col align="left" valign="top">
2639 <tbody>
2640 <tr>
2641 <td><p><span class="term"><em class="parameter"><code>face</code></em> :</span></p></td>
2642 <td> a <a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a>.
2643 </td>
2644 </tr>
2645 <tr>
2646 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2647 <td> the face name for the face. This string is
2648   owned by the face object and must not be modified or freed.
2649 </td>
2650 </tr>
2651 </tbody>
2652 </table></div>
2653 </div>
2654 <hr>
2655 <div class="refsect2" lang="en">
2656 <a name="pango-font-face-list-sizes"></a><h3>pango_font_face_list_sizes ()</h3>
2657 <pre class="programlisting">void                pango_font_face_list_sizes          (<a class="link" href="pango-Fonts.html#PangoFontFace">PangoFontFace</a> *face,
2658                                                          int **sizes,
2659                                                          int *n_sizes);</pre>
2660 <p>
2661 List the available sizes for a font. This is only applicable to bitmap
2662 fonts. For scalable fonts, stores <a
2663 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2664 ><code class="literal">NULL</code></a> at the location pointed to by
2665 <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
2666 are in Pango units and are sorted in ascending order.</p>
2667 <p>
2668 </p>
2669 <div class="variablelist"><table border="0">
2670 <col align="left" valign="top">
2671 <tbody>
2672 <tr>
2673 <td><p><span class="term"><em class="parameter"><code>face</code></em> :</span></p></td>
2674 <td> a <a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a>.
2675 </td>
2676 </tr>
2677 <tr>
2678 <td><p><span class="term"><em class="parameter"><code>sizes</code></em> :</span></p></td>
2679 <td> location to store a pointer to an array of int. This array
2680         should be freed with <a
2681 href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"
2682 ><code class="function">g_free()</code></a>.
2683 </td>
2684 </tr>
2685 <tr>
2686 <td><p><span class="term"><em class="parameter"><code>n_sizes</code></em> :</span></p></td>
2687 <td> location to store the number of elements in <em class="parameter"><code>sizes</code></em>
2688 </td>
2689 </tr>
2690 </tbody>
2691 </table></div>
2692 <p class="since">Since 1.4</p>
2693 </div>
2694 <hr>
2695 <div class="refsect2" lang="en">
2696 <a name="pango-font-face-describe"></a><h3>pango_font_face_describe ()</h3>
2697 <pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> * pango_font_face_describe         (<a class="link" href="pango-Fonts.html#PangoFontFace">PangoFontFace</a> *face);</pre>
2698 <p>
2699 Returns the family, style, variant, weight and stretch of
2700 a <a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a>. The size field of the resulting font description
2701 will be unset.</p>
2702 <p>
2703 </p>
2704 <div class="variablelist"><table border="0">
2705 <col align="left" valign="top">
2706 <tbody>
2707 <tr>
2708 <td><p><span class="term"><em class="parameter"><code>face</code></em> :</span></p></td>
2709 <td> a <a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a>
2710 </td>
2711 </tr>
2712 <tr>
2713 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2714 <td> a newly-created <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a> structure
2715  holding the description of the face. Use <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>
2716  to free the result.
2717 </td>
2718 </tr>
2719 </tbody>
2720 </table></div>
2721 </div>
2722 <hr>
2723 <div class="refsect2" lang="en">
2724 <a name="pango-font-face-is-synthesized"></a><h3>pango_font_face_is_synthesized ()</h3>
2725 <pre class="programlisting"><a
2726 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
2727 >gboolean</a>            pango_font_face_is_synthesized      (<a class="link" href="pango-Fonts.html#PangoFontFace">PangoFontFace</a> *face);</pre>
2728 <p>
2729 Returns whether a <a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a> is synthesized by the underlying
2730 font rendering engine from another face, perhaps by shearing, emboldening,
2731 or lightening it.</p>
2732 <p>
2733 </p>
2734 <div class="variablelist"><table border="0">
2735 <col align="left" valign="top">
2736 <tbody>
2737 <tr>
2738 <td><p><span class="term"><em class="parameter"><code>face</code></em> :</span></p></td>
2739 <td> a <a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a>
2740 </td>
2741 </tr>
2742 <tr>
2743 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2744 <td> whether <em class="parameter"><code>face</code></em> is synthesized.
2745
2746 </td>
2747 </tr>
2748 </tbody>
2749 </table></div>
2750 <p class="since">Since 1.18</p>
2751 </div>
2752 <hr>
2753 <div class="refsect2" lang="en">
2754 <a name="PangoFontMap-struct"></a><h3>PangoFontMap</h3>
2755 <pre class="programlisting">typedef struct _PangoFontMap PangoFontMap;</pre>
2756 <p>
2757 The <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> represents the set of fonts available for a
2758 particular rendering system. This is a virtual object with
2759 implementations being specific to particular rendering systems.  To
2760 create an implementation of a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>, the rendering-system
2761 specific code should allocate a larger structure that contains a nested
2762 <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>, fill in the <em class="structfield"><code>klass</code></em> member of the nested <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> with a
2763 pointer to a appropriate <a class="link" href="pango-Fonts.html#PangoFontMapClass" title="PangoFontMapClass"><span class="type">PangoFontMapClass</span></a>, then call
2764 <code class="function">pango_font_map_init()</code> on the structure.
2765 </p>
2766 <p>
2767 The <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> structure contains one member which the implementation
2768 fills in.
2769 </p>
2770 </div>
2771 <hr>
2772 <div class="refsect2" lang="en">
2773 <a name="PANGO-TYPE-FONT-MAP--CAPS"></a><h3>PANGO_TYPE_FONT_MAP</h3>
2774 <pre class="programlisting">#define PANGO_TYPE_FONT_MAP              (pango_font_map_get_type ())
2775 </pre>
2776 <p>
2777 The <a
2778 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
2779 ><span class="type">GObject</span></a> type for <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>.
2780 </p>
2781 </div>
2782 <hr>
2783 <div class="refsect2" lang="en">
2784 <a name="PANGO-FONT-MAP--CAPS"></a><h3>PANGO_FONT_MAP()</h3>
2785 <pre class="programlisting">#define PANGO_FONT_MAP(object)           (G_TYPE_CHECK_INSTANCE_CAST ((object), PANGO_TYPE_FONT_MAP, PangoFontMap))
2786 </pre>
2787 <p>
2788 Casts a <a
2789 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
2790 ><span class="type">GObject</span></a> to a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>.
2791 </p>
2792 <div class="variablelist"><table border="0">
2793 <col align="left" valign="top">
2794 <tbody><tr>
2795 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
2796 <td>a <a
2797 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
2798 ><span class="type">GObject</span></a>.
2799 </td>
2800 </tr></tbody>
2801 </table></div>
2802 </div>
2803 <hr>
2804 <div class="refsect2" lang="en">
2805 <a name="PANGO-IS-FONT-MAP--CAPS"></a><h3>PANGO_IS_FONT_MAP()</h3>
2806 <pre class="programlisting">#define PANGO_IS_FONT_MAP(object)        (G_TYPE_CHECK_INSTANCE_TYPE ((object), PANGO_TYPE_FONT_MAP))
2807 </pre>
2808 <p>
2809 Returns <a
2810 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
2811 ><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>.
2812 </p>
2813 <div class="variablelist"><table border="0">
2814 <col align="left" valign="top">
2815 <tbody><tr>
2816 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
2817 <td>a <a
2818 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
2819 ><span class="type">GObject</span></a>.
2820 </td>
2821 </tr></tbody>
2822 </table></div>
2823 </div>
2824 <hr>
2825 <div class="refsect2" lang="en">
2826 <a name="PangoFontMapClass"></a><h3>PangoFontMapClass</h3>
2827 <pre class="programlisting">typedef struct {
2828   GObjectClass parent_class;
2829
2830
2831   PangoFont *   (*load_font)     (PangoFontMap               *fontmap,
2832                                   PangoContext               *context,
2833                                   const PangoFontDescription *desc);
2834   void          (*list_families) (PangoFontMap               *fontmap,
2835                                   PangoFontFamily          ***families,
2836                                   int                        *n_families);
2837   PangoFontset *(*load_fontset)  (PangoFontMap               *fontmap,
2838                                   PangoContext               *context,
2839                                   const PangoFontDescription *desc,
2840                                   PangoLanguage              *language);
2841
2842   const char *shape_engine_type;
2843 } PangoFontMapClass;
2844 </pre>
2845 <p>
2846 The <a class="link" href="pango-Fonts.html#PangoFontMapClass" title="PangoFontMapClass"><span class="type">PangoFontMapClass</span></a> structure holds the virtual functions for
2847 a particular <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> implementation.
2848 </p>
2849 <div class="variablelist"><table border="0">
2850 <col align="left" valign="top">
2851 <tbody>
2852 <tr>
2853 <td><p><span class="term"><a
2854 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObjectClass"
2855 >GObjectClass</a> <em class="structfield"><code>parent_class</code></em>;</span></p></td>
2856 <td>parent <a
2857 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObjectClass"
2858 ><span class="type">GObjectClass</span></a>.
2859 </td>
2860 </tr>
2861 <tr>
2862 <td><p><span class="term"><em class="structfield"><code>load_font</code></em> ()</span></p></td>
2863 <td>a function to load a font with a given description. See
2864             <a class="link" href="pango-Fonts.html#pango-font-map-load-font" title="pango_font_map_load_font ()"><code class="function">pango_font_map_load_font()</code></a>.
2865 </td>
2866 </tr>
2867 <tr>
2868 <td><p><span class="term"><em class="structfield"><code>list_families</code></em> ()</span></p></td>
2869 <td>A function to list available font families. See
2870                 <a class="link" href="pango-Fonts.html#pango-font-map-list-families" title="pango_font_map_list_families ()"><code class="function">pango_font_map_list_families()</code></a>.
2871 </td>
2872 </tr>
2873 <tr>
2874 <td><p><span class="term"><em class="structfield"><code>load_fontset</code></em> ()</span></p></td>
2875 <td>a function to load a fontset with a given given description
2876              suitable for a particular language. See
2877              <a class="link" href="pango-Fonts.html#pango-font-map-load-fontset" title="pango_font_map_load_fontset ()"><code class="function">pango_font_map_load_fontset()</code></a>.
2878 </td>
2879 </tr>
2880 <tr>
2881 <td><p><span class="term">const char *<em class="structfield"><code>shape_engine_type</code></em>;</span></p></td>
2882 <td>the type of rendering-system-dependent engines that
2883              can handle fonts of this fonts loaded with this fontmap.
2884 </td>
2885 </tr>
2886 </tbody>
2887 </table></div>
2888 </div>
2889 <hr>
2890 <div class="refsect2" lang="en">
2891 <a name="PANGO-FONT-MAP-CLASS--CAPS"></a><h3>PANGO_FONT_MAP_CLASS()</h3>
2892 <pre class="programlisting">#define PANGO_FONT_MAP_CLASS(klass)      (G_TYPE_CHECK_CLASS_CAST ((klass), PANGO_TYPE_FONT_MAP, PangoFontMapClass))
2893 </pre>
2894 <p>
2895 Casts a <a
2896 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
2897 ><span class="type">GObject</span></a> to a <a class="link" href="pango-Fonts.html#PangoFontMapClass" title="PangoFontMapClass"><span class="type">PangoFontMapClass</span></a>.
2898 </p>
2899 <div class="variablelist"><table border="0">
2900 <col align="left" valign="top">
2901 <tbody><tr>
2902 <td><p><span class="term"><em class="parameter"><code>klass</code></em> :</span></p></td>
2903 <td>a <a
2904 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
2905 ><span class="type">GObject</span></a>.
2906 </td>
2907 </tr></tbody>
2908 </table></div>
2909 </div>
2910 <hr>
2911 <div class="refsect2" lang="en">
2912 <a name="PANGO-IS-FONT-MAP-CLASS--CAPS"></a><h3>PANGO_IS_FONT_MAP_CLASS()</h3>
2913 <pre class="programlisting">#define PANGO_IS_FONT_MAP_CLASS(klass)   (G_TYPE_CHECK_CLASS_TYPE ((klass), PANGO_TYPE_FONT_MAP))
2914 </pre>
2915 <p>
2916 Returns <a
2917 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
2918 ><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>.
2919 </p>
2920 <div class="variablelist"><table border="0">
2921 <col align="left" valign="top">
2922 <tbody><tr>
2923 <td><p><span class="term"><em class="parameter"><code>klass</code></em> :</span></p></td>
2924 <td>a <a
2925 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
2926 ><span class="type">GObject</span></a>.
2927 </td>
2928 </tr></tbody>
2929 </table></div>
2930 </div>
2931 <hr>
2932 <div class="refsect2" lang="en">
2933 <a name="PANGO-FONT-MAP-GET-CLASS--CAPS"></a><h3>PANGO_FONT_MAP_GET_CLASS()</h3>
2934 <pre class="programlisting">#define PANGO_FONT_MAP_GET_CLASS(obj)    (G_TYPE_INSTANCE_GET_CLASS ((obj), PANGO_TYPE_FONT_MAP, PangoFontMapClass))
2935 </pre>
2936 <p>
2937 Returns the type of a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>.
2938 </p>
2939 <div class="variablelist"><table border="0">
2940 <col align="left" valign="top">
2941 <tbody><tr>
2942 <td><p><span class="term"><em class="parameter"><code>obj</code></em> :</span></p></td>
2943 <td>a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>.
2944 </td>
2945 </tr></tbody>
2946 </table></div>
2947 </div>
2948 <hr>
2949 <div class="refsect2" lang="en">
2950 <a name="pango-font-map-create-context"></a><h3>pango_font_map_create_context ()</h3>
2951 <pre class="programlisting"><a class="link" href="pango-Text-Processing.html#PangoContext">PangoContext</a> *      pango_font_map_create_context       (<a class="link" href="pango-Fonts.html#PangoFontMap">PangoFontMap</a> *fontmap);</pre>
2952 <p>
2953 Creates a <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> connected to <em class="parameter"><code>fontmap</code></em>.  This is equivalent
2954 to <a class="link" href="pango-Text-Processing.html#pango-context-new" title="pango_context_new ()"><code class="function">pango_context_new()</code></a> followed by <a class="link" href="pango-Text-Processing.html#pango-context-set-font-map" title="pango_context_set_font_map ()"><code class="function">pango_context_set_font_map()</code></a>.
2955 </p>
2956 <p>
2957 If you are using Pango as part of a higher-level system,
2958 that system may have it's own way of create a <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>.
2959 For instance, the GTK+ toolkit has, among others,
2960 <a
2961 href="http://library.gnome.org/devel/gdk/unstable/gdk-Pango-Interaction.html#gdk-pango-context-get-for-screen"
2962 ><code class="function">gdk_pango_context_get_for_screen()</code></a>, and
2963 <a
2964 href="http://library.gnome.org/devel/gtk/unstable/GtkWidget.html#gtk-widget-get-pango-context"
2965 ><code class="function">gtk_widget_get_pango_context()</code></a>.  Use those instead.</p>
2966 <p>
2967 </p>
2968 <div class="variablelist"><table border="0">
2969 <col align="left" valign="top">
2970 <tbody>
2971 <tr>
2972 <td><p><span class="term"><em class="parameter"><code>fontmap</code></em> :</span></p></td>
2973 <td> a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>
2974 </td>
2975 </tr>
2976 <tr>
2977 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2978 <td> the newly allocated <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>, which should
2979               be freed with <a
2980 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"
2981 ><code class="function">g_object_unref()</code></a>.
2982
2983 </td>
2984 </tr>
2985 </tbody>
2986 </table></div>
2987 <p class="since">Since 1.22</p>
2988 </div>
2989 <hr>
2990 <div class="refsect2" lang="en">
2991 <a name="pango-font-map-load-font"></a><h3>pango_font_map_load_font ()</h3>
2992 <pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *         pango_font_map_load_font            (<a class="link" href="pango-Fonts.html#PangoFontMap">PangoFontMap</a> *fontmap,
2993                                                          <a class="link" href="pango-Text-Processing.html#PangoContext">PangoContext</a> *context,
2994                                                          const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc);</pre>
2995 <p>
2996 Load the font in the fontmap that is the closest match for <em class="parameter"><code>desc</code></em>.</p>
2997 <p>
2998 </p>
2999 <div class="variablelist"><table border="0">
3000 <col align="left" valign="top">
3001 <tbody>
3002 <tr>
3003 <td><p><span class="term"><em class="parameter"><code>fontmap</code></em> :</span></p></td>
3004 <td> a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>
3005 </td>
3006 </tr>
3007 <tr>
3008 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
3009 <td> the <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> the font will be used with
3010 </td>
3011 </tr>
3012 <tr>
3013 <td><p><span class="term"><em class="parameter"><code>desc</code></em> :</span></p></td>
3014 <td> a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a> describing the font to load
3015 </td>
3016 </tr>
3017 <tr>
3018 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3019 <td> the font loaded, or <a
3020 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3021 ><code class="literal">NULL</code></a> if no font matched.
3022 </td>
3023 </tr>
3024 </tbody>
3025 </table></div>
3026 </div>
3027 <hr>
3028 <div class="refsect2" lang="en">
3029 <a name="pango-font-map-load-fontset"></a><h3>pango_font_map_load_fontset ()</h3>
3030 <pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontset">PangoFontset</a> *      pango_font_map_load_fontset         (<a class="link" href="pango-Fonts.html#PangoFontMap">PangoFontMap</a> *fontmap,
3031                                                          <a class="link" href="pango-Text-Processing.html#PangoContext">PangoContext</a> *context,
3032                                                          const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> *desc,
3033                                                          <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage">PangoLanguage</a> *language);</pre>
3034 <p>
3035 Load a set of fonts in the fontmap that can be used to render
3036 a font matching <em class="parameter"><code>desc</code></em>.</p>
3037 <p>
3038 </p>
3039 <div class="variablelist"><table border="0">
3040 <col align="left" valign="top">
3041 <tbody>
3042 <tr>
3043 <td><p><span class="term"><em class="parameter"><code>fontmap</code></em> :</span></p></td>
3044 <td> a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>
3045 </td>
3046 </tr>
3047 <tr>
3048 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
3049 <td> the <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> the font will be used with
3050 </td>
3051 </tr>
3052 <tr>
3053 <td><p><span class="term"><em class="parameter"><code>desc</code></em> :</span></p></td>
3054 <td> a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a> describing the font to load
3055 </td>
3056 </tr>
3057 <tr>
3058 <td><p><span class="term"><em class="parameter"><code>language</code></em> :</span></p></td>
3059 <td> a <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage"><span class="type">PangoLanguage</span></a> the fonts will be used for
3060 </td>
3061 </tr>
3062 <tr>
3063 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3064 <td> the fontset, or <a
3065 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3066 ><code class="literal">NULL</code></a> if no font matched.
3067 </td>
3068 </tr>
3069 </tbody>
3070 </table></div>
3071 </div>
3072 <hr>
3073 <div class="refsect2" lang="en">
3074 <a name="pango-font-map-list-families"></a><h3>pango_font_map_list_families ()</h3>
3075 <pre class="programlisting">void                pango_font_map_list_families        (<a class="link" href="pango-Fonts.html#PangoFontMap">PangoFontMap</a> *fontmap,
3076                                                          <a class="link" href="pango-Fonts.html#PangoFontFamily">PangoFontFamily</a> ***families,
3077                                                          int *n_families);</pre>
3078 <p>
3079 List all families for a fontmap.</p>
3080 <p>
3081 </p>
3082 <div class="variablelist"><table border="0">
3083 <col align="left" valign="top">
3084 <tbody>
3085 <tr>
3086 <td><p><span class="term"><em class="parameter"><code>fontmap</code></em> :</span></p></td>
3087 <td> a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>
3088 </td>
3089 </tr>
3090 <tr>
3091 <td><p><span class="term"><em class="parameter"><code>families</code></em> :</span></p></td>
3092 <td> location to store a pointer to an array of <a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a> *.
3093            This array should be freed with <a
3094 href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"
3095 ><code class="function">g_free()</code></a>.
3096 </td>
3097 </tr>
3098 <tr>
3099 <td><p><span class="term"><em class="parameter"><code>n_families</code></em> :</span></p></td>
3100 <td> location to store the number of elements in <em class="parameter"><code>families</code></em>
3101 </td>
3102 </tr>
3103 </tbody>
3104 </table></div>
3105 </div>
3106 <hr>
3107 <div class="refsect2" lang="en">
3108 <a name="pango-font-map-get-shape-engine-type"></a><h3>pango_font_map_get_shape_engine_type ()</h3>
3109 <pre class="programlisting">const char *        pango_font_map_get_shape_engine_type
3110                                                         (<a class="link" href="pango-Fonts.html#PangoFontMap">PangoFontMap</a> *fontmap);</pre>
3111 <p>
3112 Returns the render ID for shape engines for this fontmap.
3113 See the <em class="structfield"><code>render_type</code></em> field of
3114 <a class="link" href="pango-Engines.html#PangoEngineInfo" title="PangoEngineInfo"><span class="type">PangoEngineInfo</span></a>.</p>
3115 <p>
3116 </p>
3117 <div class="variablelist"><table border="0">
3118 <col align="left" valign="top">
3119 <tbody>
3120 <tr>
3121 <td><p><span class="term"><em class="parameter"><code>fontmap</code></em> :</span></p></td>
3122 <td> a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>
3123 </td>
3124 </tr>
3125 <tr>
3126 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3127 <td> the ID string for shape engines for
3128  this fontmap. Owned by Pango, should not be modified
3129  or freed.
3130
3131 </td>
3132 </tr>
3133 </tbody>
3134 </table></div>
3135 <p class="since">Since 1.4</p>
3136 </div>
3137 <hr>
3138 <div class="refsect2" lang="en">
3139 <a name="PangoFontset-struct"></a><h3>PangoFontset</h3>
3140 <pre class="programlisting">typedef struct _PangoFontset PangoFontset;</pre>
3141 <p>
3142 A <a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a> represents a set of <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> to use
3143 when rendering text. It is the result of resolving a
3144 <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a> against a particular <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>.
3145 It has operations for finding the component font for
3146 a particular Unicode character, and for finding a composite
3147 set of metrics for the entire fontset.
3148 </p>
3149 </div>
3150 <hr>
3151 <div class="refsect2" lang="en">
3152 <a name="PANGO-TYPE-FONTSET--CAPS"></a><h3>PANGO_TYPE_FONTSET</h3>
3153 <pre class="programlisting">#define PANGO_TYPE_FONTSET              (pango_fontset_get_type ())
3154 </pre>
3155 <p>
3156 The <a
3157 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
3158 ><span class="type">GObject</span></a> type for <a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a>.
3159 </p>
3160 </div>
3161 <hr>
3162 <div class="refsect2" lang="en">
3163 <a name="PangoFontsetClass"></a><h3>PangoFontsetClass</h3>
3164 <pre class="programlisting">typedef struct {
3165   GObjectClass parent_class;
3166
3167
3168   PangoFont *       (*get_font)     (PangoFontset     *fontset,
3169                                      guint             wc);
3170
3171   PangoFontMetrics *(*get_metrics)  (PangoFontset     *fontset);
3172   PangoLanguage *   (*get_language) (PangoFontset     *fontset);
3173   void              (*foreach)      (PangoFontset           *fontset,
3174                                      PangoFontsetForeachFunc func,
3175                                      gpointer                data);
3176 } PangoFontsetClass;
3177 </pre>
3178 <p>
3179 The <a class="link" href="pango-Fonts.html#PangoFontsetClass" title="PangoFontsetClass"><span class="type">PangoFontsetClass</span></a> structure holds the virtual functions for
3180 a particular <a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a> implementation.
3181 </p>
3182 <div class="variablelist"><table border="0">
3183 <col align="left" valign="top">
3184 <tbody>
3185 <tr>
3186 <td><p><span class="term"><a
3187 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObjectClass"
3188 >GObjectClass</a> <em class="structfield"><code>parent_class</code></em>;</span></p></td>
3189 <td>parent <a
3190 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObjectClass"
3191 ><span class="type">GObjectClass</span></a>.
3192 </td>
3193 </tr>
3194 <tr>
3195 <td><p><span class="term"><em class="structfield"><code>get_font</code></em> ()</span></p></td>
3196 <td>a function to get the font in the fontset that contains the
3197    best glyph for the given Unicode character; see <a class="link" href="pango-Fonts.html#pango-fontset-get-font" title="pango_fontset_get_font ()"><code class="function">pango_fontset_get_font()</code></a>.
3198 </td>
3199 </tr>
3200 <tr>
3201 <td><p><span class="term"><em class="structfield"><code>get_metrics</code></em> ()</span></p></td>
3202 <td>a function to get overall metric information for the fonts
3203    in the fontset; see <a class="link" href="pango-Fonts.html#pango-fontset-get-metrics" title="pango_fontset_get_metrics ()"><code class="function">pango_fontset_get_metrics()</code></a>.
3204 </td>
3205 </tr>
3206 <tr>
3207 <td><p><span class="term"><em class="structfield"><code>get_language</code></em> ()</span></p></td>
3208 <td>a function to get the language of the fontset.
3209 </td>
3210 </tr>
3211 <tr>
3212 <td><p><span class="term"><em class="structfield"><code>foreach</code></em> ()</span></p></td>
3213 <td>a function to loop over the fonts in the fontset. See
3214    <a class="link" href="pango-Fonts.html#pango-fontset-foreach" title="pango_fontset_foreach ()"><code class="function">pango_fontset_foreach()</code></a>.
3215 </td>
3216 </tr>
3217 </tbody>
3218 </table></div>
3219 </div>
3220 <hr>
3221 <div class="refsect2" lang="en">
3222 <a name="pango-fontset-get-font"></a><h3>pango_fontset_get_font ()</h3>
3223 <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,
3224                                                          <a
3225 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
3226 >guint</a> wc);</pre>
3227 <p>
3228 Returns the font in the fontset that contains the best glyph for the
3229 Unicode character <em class="parameter"><code>wc</code></em>.</p>
3230 <p>
3231 </p>
3232 <div class="variablelist"><table border="0">
3233 <col align="left" valign="top">
3234 <tbody>
3235 <tr>
3236 <td><p><span class="term"><em class="parameter"><code>fontset</code></em> :</span></p></td>
3237 <td> a <a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a>
3238 </td>
3239 </tr>
3240 <tr>
3241 <td><p><span class="term"><em class="parameter"><code>wc</code></em> :</span></p></td>
3242 <td> a Unicode character
3243 </td>
3244 </tr>
3245 <tr>
3246 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3247 <td> a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>. The caller must call g_object_unref when finished
3248          with the font.
3249 </td>
3250 </tr>
3251 </tbody>
3252 </table></div>
3253 </div>
3254 <hr>
3255 <div class="refsect2" lang="en">
3256 <a name="pango-fontset-get-metrics"></a><h3>pango_fontset_get_metrics ()</h3>
3257 <pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics">PangoFontMetrics</a> *  pango_fontset_get_metrics           (<a class="link" href="pango-Fonts.html#PangoFontset">PangoFontset</a> *fontset);</pre>
3258 <p>
3259 Get overall metric information for the fonts in the fontset.</p>
3260 <p>
3261 </p>
3262 <div class="variablelist"><table border="0">
3263 <col align="left" valign="top">
3264 <tbody>
3265 <tr>
3266 <td><p><span class="term"><em class="parameter"><code>fontset</code></em> :</span></p></td>
3267 <td> a <a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a>
3268 </td>
3269 </tr>
3270 <tr>
3271 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3272 <td> a <a class="link" href="pango-Fonts.html#PangoFontMetrics" title="PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> object. The caller must call <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>
3273   when finished using the object.
3274 </td>
3275 </tr>
3276 </tbody>
3277 </table></div>
3278 </div>
3279 <hr>
3280 <div class="refsect2" lang="en">
3281 <a name="PangoFontsetForeachFunc"></a><h3>PangoFontsetForeachFunc ()</h3>
3282 <pre class="programlisting"><a
3283 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
3284 >gboolean</a>            (*PangoFontsetForeachFunc)          (<a class="link" href="pango-Fonts.html#PangoFontset">PangoFontset</a> *fontset,
3285                                                          <a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
3286                                                          <a
3287 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
3288 >gpointer</a> data);</pre>
3289 <p>
3290 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
3291 the fonts in a fontset.</p>
3292 <p>
3293 </p>
3294 <div class="variablelist"><table border="0">
3295 <col align="left" valign="top">
3296 <tbody>
3297 <tr>
3298 <td><p><span class="term"><em class="parameter"><code>fontset</code></em> :</span></p></td>
3299 <td> a <a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a>
3300 </td>
3301 </tr>
3302 <tr>
3303 <td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
3304 <td> a font from <em class="parameter"><code>fontset</code></em>
3305 </td>
3306 </tr>
3307 <tr>
3308 <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
3309 <td> callback data
3310 </td>
3311 </tr>
3312 <tr>
3313 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3314 <td> if <a
3315 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
3316 ><code class="literal">TRUE</code></a>, stop iteration and return immediately.
3317
3318 </td>
3319 </tr>
3320 </tbody>
3321 </table></div>
3322 <p class="since">Since 1.4</p>
3323 </div>
3324 <hr>
3325 <div class="refsect2" lang="en">
3326 <a name="pango-fontset-foreach"></a><h3>pango_fontset_foreach ()</h3>
3327 <pre class="programlisting">void                pango_fontset_foreach               (<a class="link" href="pango-Fonts.html#PangoFontset">PangoFontset</a> *fontset,
3328                                                          <a class="link" href="pango-Fonts.html#PangoFontsetForeachFunc" title="PangoFontsetForeachFunc ()">PangoFontsetForeachFunc</a> func,
3329                                                          <a
3330 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
3331 >gpointer</a> data);</pre>
3332 <p>
3333 Iterates through all the fonts in a fontset, calling <em class="parameter"><code>func</code></em> for
3334 each one. If <em class="parameter"><code>func</code></em> returns <a
3335 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
3336 ><code class="literal">TRUE</code></a>, that stops the iteration.</p>
3337 <p>
3338 </p>
3339 <div class="variablelist"><table border="0">
3340 <col align="left" valign="top">
3341 <tbody>
3342 <tr>
3343 <td><p><span class="term"><em class="parameter"><code>fontset</code></em> :</span></p></td>
3344 <td> a <a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a>
3345 </td>
3346 </tr>
3347 <tr>
3348 <td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
3349 <td> Callback function
3350 </td>
3351 </tr>
3352 <tr>
3353 <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
3354 <td> data to pass to the callback function
3355 </td>
3356 </tr>
3357 </tbody>
3358 </table></div>
3359 <p class="since">Since 1.4</p>
3360 </div>
3361 <hr>
3362 <div class="refsect2" lang="en">
3363 <a name="PangoFontsetSimple-struct"></a><h3>PangoFontsetSimple</h3>
3364 <pre class="programlisting">typedef struct _PangoFontsetSimple PangoFontsetSimple;</pre>
3365 <p>
3366 <a class="link" href="pango-Fonts.html#PangoFontsetSimple"><span class="type">PangoFontsetSimple</span></a> is a implementation of the abstract
3367 <a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a> base class in terms of an array of fonts,
3368 which the creator provides when constructing the
3369 <a class="link" href="pango-Fonts.html#PangoFontsetSimple"><span class="type">PangoFontsetSimple</span></a>.
3370 </p>
3371 </div>
3372 <hr>
3373 <div class="refsect2" lang="en">
3374 <a name="PANGO-TYPE-FONTSET-SIMPLE--CAPS"></a><h3>PANGO_TYPE_FONTSET_SIMPLE</h3>
3375 <pre class="programlisting">#define PANGO_TYPE_FONTSET_SIMPLE       (pango_fontset_simple_get_type ())
3376 </pre>
3377 <p>
3378 The <a
3379 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
3380 ><span class="type">GObject</span></a> type for <a class="link" href="pango-Fonts.html#PangoFontsetSimple"><span class="type">PangoFontsetSimple</span></a>.
3381 </p>
3382 </div>
3383 <hr>
3384 <div class="refsect2" lang="en">
3385 <a name="pango-fontset-simple-new"></a><h3>pango_fontset_simple_new ()</h3>
3386 <pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontsetSimple">PangoFontsetSimple</a> * pango_fontset_simple_new           (<a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage">PangoLanguage</a> *language);</pre>
3387 <p>
3388 Creates a new <a class="link" href="pango-Fonts.html#PangoFontsetSimple"><span class="type">PangoFontsetSimple</span></a> for the given language.</p>
3389 <p>
3390 </p>
3391 <div class="variablelist"><table border="0">
3392 <col align="left" valign="top">
3393 <tbody>
3394 <tr>
3395 <td><p><span class="term"><em class="parameter"><code>language</code></em> :</span></p></td>
3396 <td> a <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage"><span class="type">PangoLanguage</span></a> tag
3397 </td>
3398 </tr>
3399 <tr>
3400 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3401 <td> the newly allocated <a class="link" href="pango-Fonts.html#PangoFontsetSimple"><span class="type">PangoFontsetSimple</span></a>, which should
3402               be freed with <a
3403 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"
3404 ><code class="function">g_object_unref()</code></a>.
3405 </td>
3406 </tr>
3407 </tbody>
3408 </table></div>
3409 </div>
3410 <hr>
3411 <div class="refsect2" lang="en">
3412 <a name="pango-fontset-simple-append"></a><h3>pango_fontset_simple_append ()</h3>
3413 <pre class="programlisting">void                pango_fontset_simple_append         (<a class="link" href="pango-Fonts.html#PangoFontsetSimple">PangoFontsetSimple</a> *fontset,
3414                                                          <a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font);</pre>
3415 <p>
3416 Adds a font to the fontset.</p>
3417 <p>
3418 </p>
3419 <div class="variablelist"><table border="0">
3420 <col align="left" valign="top">
3421 <tbody>
3422 <tr>
3423 <td><p><span class="term"><em class="parameter"><code>fontset</code></em> :</span></p></td>
3424 <td> a <a class="link" href="pango-Fonts.html#PangoFontsetSimple"><span class="type">PangoFontsetSimple</span></a>.
3425 </td>
3426 </tr>
3427 <tr>
3428 <td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
3429 <td> a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.
3430 </td>
3431 </tr>
3432 </tbody>
3433 </table></div>
3434 </div>
3435 <hr>
3436 <div class="refsect2" lang="en">
3437 <a name="pango-fontset-simple-size"></a><h3>pango_fontset_simple_size ()</h3>
3438 <pre class="programlisting">int                 pango_fontset_simple_size           (<a class="link" href="pango-Fonts.html#PangoFontsetSimple">PangoFontsetSimple</a> *fontset);</pre>
3439 <p>
3440 Returns the number of fonts in the fontset.</p>
3441 <p>
3442 </p>
3443 <div class="variablelist"><table border="0">
3444 <col align="left" valign="top">
3445 <tbody>
3446 <tr>
3447 <td><p><span class="term"><em class="parameter"><code>fontset</code></em> :</span></p></td>
3448 <td> a <a class="link" href="pango-Fonts.html#PangoFontsetSimple"><span class="type">PangoFontsetSimple</span></a>.
3449 </td>
3450 </tr>
3451 <tr>
3452 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3453 <td> the size of <em class="parameter"><code>fontset</code></em>.
3454 </td>
3455 </tr>
3456 </tbody>
3457 </table></div>
3458 </div>
3459 </div>
3460 </div>
3461 <div class="footer">
3462 <hr>
3463           Generated by GTK-Doc V1.11</div>
3464 </body>
3465 </html>