Git init
[external/pango1.0.git] / docs / html / PangoFcFontMap.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>PangoFcFontMap</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="lowlevel.html" title="Low Level Functionality">
9 <link rel="prev" href="PangoRenderer.html" title="PangoRenderer">
10 <link rel="next" href="PangoFcFont.html" title="PangoFcFont">
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="PangoRenderer.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
38 <td><a accesskey="u" href="lowlevel.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="PangoFcFont.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="#PangoFcFontMap.synopsis" class="shortcut">Top</a>
45                  | 
46                 <a href="#PangoFcFontMap.description" class="shortcut">Description</a>
47                  | 
48                 <a href="#PangoFcFontMap.object-hierarchy" class="shortcut">Object Hierarchy</a>
49 </td></tr>
50 </table>
51 <div class="refentry" lang="en">
52 <a name="PangoFcFontMap"></a><div class="titlepage"></div>
53 <div class="refnamediv"><table width="100%"><tr>
54 <td valign="top">
55 <h2><span class="refentrytitle"><a name="PangoFcFontMap.top_of_page"></a>PangoFcFontMap</span></h2>
56 <p>PangoFcFontMap — Base fontmap class for Fontconfig-based backends</p>
57 </td>
58 <td valign="top" align="right"></td>
59 </tr></table></div>
60 <div class="refsynopsisdiv">
61 <a name="PangoFcFontMap.synopsis"></a><h2>Synopsis</h2>
62 <pre class="synopsis">
63                     <a class="link" href="PangoFcFontMap.html#PangoFcFontMap-struct" title="PangoFcFontMap">PangoFcFontMap</a>;
64                     <a class="link" href="PangoFcFontMap.html#PangoFcFontMapClass" title="PangoFcFontMapClass">PangoFcFontMapClass</a>;
65 <a class="link" href="pango-Text-Processing.html#PangoContext">PangoContext</a> *      <a class="link" href="PangoFcFontMap.html#pango-fc-font-map-create-context" title="pango_fc_font_map_create_context ()">pango_fc_font_map_create_context</a>    (<a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap">PangoFcFontMap</a> *fcfontmap);
66 <a class="link" href="PangoFcDecoder.html" title="PangoFcDecoder">PangoFcDecoder</a> *    (<a class="link" href="PangoFcFontMap.html#PangoFcDecoderFindFunc" title="PangoFcDecoderFindFunc ()">*PangoFcDecoderFindFunc</a>)           (FcPattern *pattern,
67                                                          <a
68 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
69 >gpointer</a> user_data);
70 void                <a class="link" href="PangoFcFontMap.html#pango-fc-font-map-add-decoder-find-func" title="pango_fc_font_map_add_decoder_find_func ()">pango_fc_font_map_add_decoder_find_func</a>
71                                                         (<a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap">PangoFcFontMap</a> *fcfontmap,
72                                                          <a class="link" href="PangoFcFontMap.html#PangoFcDecoderFindFunc" title="PangoFcDecoderFindFunc ()">PangoFcDecoderFindFunc</a> findfunc,
73                                                          <a
74 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
75 >gpointer</a> user_data,
76                                                          <a
77 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
78 >GDestroyNotify</a> dnotify);
79 <a class="link" href="PangoFcDecoder.html" title="PangoFcDecoder">PangoFcDecoder</a> *    <a class="link" href="PangoFcFontMap.html#pango-fc-font-map-find-decoder" title="pango_fc_font_map_find_decoder ()">pango_fc_font_map_find_decoder</a>      (<a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap">PangoFcFontMap</a> *fcfontmap,
80                                                          FcPattern *pattern);
81 void                <a class="link" href="PangoFcFontMap.html#pango-fc-font-map-cache-clear" title="pango_fc_font_map_cache_clear ()">pango_fc_font_map_cache_clear</a>       (<a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap">PangoFcFontMap</a> *fcfontmap);
82 void                <a class="link" href="PangoFcFontMap.html#pango-fc-font-map-shutdown" title="pango_fc_font_map_shutdown ()">pango_fc_font_map_shutdown</a>          (<a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap">PangoFcFontMap</a> *fcfontmap);
83 <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> * <a class="link" href="PangoFcFontMap.html#pango-fc-font-description-from-pattern" title="pango_fc_font_description_from_pattern ()">pango_fc_font_description_from_pattern</a>
84                                                         (FcPattern *pattern,
85                                                          <a
86 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
87 >gboolean</a> include_size);
88 #define             <a class="link" href="PangoFcFontMap.html#PANGO-FC-GRAVITY--CAPS" title="PANGO_FC_GRAVITY">PANGO_FC_GRAVITY</a>
89 #define             <a class="link" href="PangoFcFontMap.html#PANGO-FC-VERSION--CAPS" title="PANGO_FC_VERSION">PANGO_FC_VERSION</a>
90 #define             <a class="link" href="PangoFcFontMap.html#PANGO-FC-PRGNAME--CAPS" title="PANGO_FC_PRGNAME">PANGO_FC_PRGNAME</a>
91
92
93                     <a class="link" href="PangoFcFontMap.html#PangoFcFontsetKey" title="PangoFcFontsetKey">PangoFcFontsetKey</a>;
94 <a
95 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
96 >gpointer</a>            <a class="link" href="PangoFcFontMap.html#pango-fc-fontset-key-get-context-key" title="pango_fc_fontset_key_get_context_key ()">pango_fc_fontset_key_get_context_key</a>
97                                                         (const <a class="link" href="PangoFcFontMap.html#PangoFcFontsetKey" title="PangoFcFontsetKey">PangoFcFontsetKey</a> *key);
98 const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> * <a class="link" href="PangoFcFontMap.html#pango-fc-fontset-key-get-description" title="pango_fc_fontset_key_get_description ()">pango_fc_fontset_key_get_description</a>
99                                                         (const <a class="link" href="PangoFcFontMap.html#PangoFcFontsetKey" title="PangoFcFontsetKey">PangoFcFontsetKey</a> *key);
100 <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage">PangoLanguage</a> *     <a class="link" href="PangoFcFontMap.html#pango-fc-fontset-key-get-language" title="pango_fc_fontset_key_get_language ()">pango_fc_fontset_key_get_language</a>   (const <a class="link" href="PangoFcFontMap.html#PangoFcFontsetKey" title="PangoFcFontsetKey">PangoFcFontsetKey</a> *key);
101 const <a class="link" href="pango-Glyph-Storage.html#PangoMatrix" title="PangoMatrix">PangoMatrix</a> * <a class="link" href="PangoFcFontMap.html#pango-fc-fontset-key-get-matrix" title="pango_fc_fontset_key_get_matrix ()">pango_fc_fontset_key_get_matrix</a>     (const <a class="link" href="PangoFcFontMap.html#PangoFcFontsetKey" title="PangoFcFontsetKey">PangoFcFontsetKey</a> *key);
102 double              <a class="link" href="PangoFcFontMap.html#pango-fc-fontset-key-get-absolute-size" title="pango_fc_fontset_key_get_absolute_size ()">pango_fc_fontset_key_get_absolute_size</a>
103                                                         (const <a class="link" href="PangoFcFontMap.html#PangoFcFontsetKey" title="PangoFcFontsetKey">PangoFcFontsetKey</a> *key);
104 double              <a class="link" href="PangoFcFontMap.html#pango-fc-fontset-key-get-resolution" title="pango_fc_fontset_key_get_resolution ()">pango_fc_fontset_key_get_resolution</a> (const <a class="link" href="PangoFcFontMap.html#PangoFcFontsetKey" title="PangoFcFontsetKey">PangoFcFontsetKey</a> *key);
105                     <a class="link" href="PangoFcFontMap.html#PangoFcFontKey" title="PangoFcFontKey">PangoFcFontKey</a>;
106 <a
107 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
108 >gpointer</a>            <a class="link" href="PangoFcFontMap.html#pango-fc-font-key-get-context-key" title="pango_fc_font_key_get_context_key ()">pango_fc_font_key_get_context_key</a>   (const <a class="link" href="PangoFcFontMap.html#PangoFcFontKey" title="PangoFcFontKey">PangoFcFontKey</a> *key);
109 const <a class="link" href="pango-Glyph-Storage.html#PangoMatrix" title="PangoMatrix">PangoMatrix</a> * <a class="link" href="PangoFcFontMap.html#pango-fc-font-key-get-matrix" title="pango_fc_font_key_get_matrix ()">pango_fc_font_key_get_matrix</a>        (const <a class="link" href="PangoFcFontMap.html#PangoFcFontKey" title="PangoFcFontKey">PangoFcFontKey</a> *key);
110 const FcPattern *   <a class="link" href="PangoFcFontMap.html#pango-fc-font-key-get-pattern" title="pango_fc_font_key_get_pattern ()">pango_fc_font_key_get_pattern</a>       (const <a class="link" href="PangoFcFontMap.html#PangoFcFontKey" title="PangoFcFontKey">PangoFcFontKey</a> *key);
111 </pre>
112 </div>
113 <div class="refsect1" lang="en">
114 <a name="PangoFcFontMap.object-hierarchy"></a><h2>Object Hierarchy</h2>
115 <pre class="synopsis">
116   <a
117 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
118 >GObject</a>
119    +----<a class="link" href="pango-Fonts.html#PangoFontMap">PangoFontMap</a>
120          +----PangoFcFontMap
121                +----<a class="link" href="pango-FreeType-Fonts-and-Rendering.html#PangoFT2FontMap">PangoFT2FontMap</a>
122                +----<a class="link" href="pango-Xft-Fonts-and-Rendering.html#PangoXftFontMap">PangoXftFontMap</a>
123 </pre>
124 </div>
125 <div class="refsect1" lang="en">
126 <a name="PangoFcFontMap.description"></a><h2>Description</h2>
127 <p>
128 PangoFcFontMap is a base class for font map implementations using the
129 Fontconfig and FreeType libraries. It is used in the
130 <a class="link" href="pango-Xft-Fonts-and-Rendering.html" title="Xft Fonts and Rendering">Xft</a> and
131 <a class="link" href="pango-FreeType-Fonts-and-Rendering.html" title="FreeType Fonts and Rendering">FreeType</a>
132 backends shipped with Pango, but can also be used when creating
133 new backends. Any backend deriving from this base class will
134 take advantage of the wide range of shapers implemented using
135 FreeType that come with Pango.
136 </p>
137 </div>
138 <div class="refsect1" lang="en">
139 <a name="PangoFcFontMap.details"></a><h2>Details</h2>
140 <div class="refsect2" lang="en">
141 <a name="PangoFcFontMap-struct"></a><h3>PangoFcFontMap</h3>
142 <pre class="programlisting">typedef struct _PangoFcFontMap PangoFcFontMap;</pre>
143 <p>
144 <a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a> is a base class for font map implementations
145 using the Fontconfig and FreeType libraries. To create a new
146 backend using Fontconfig and FreeType, you derive from this class
147 and implement a <code class="function">new_font()</code> virtual function that creates an
148 instance deriving from <a class="link" href="PangoFcFont.html" title="PangoFcFont"><span class="type">PangoFcFont</span></a>.</p>
149 <p>
150 </p>
151 </div>
152 <hr>
153 <div class="refsect2" lang="en">
154 <a name="PangoFcFontMapClass"></a><h3>PangoFcFontMapClass</h3>
155 <pre class="programlisting">typedef struct {
156   /* Deprecated in favor of fontset_key_substitute */
157   void         (*default_substitute) (PangoFcFontMap   *fontmap,
158                                       FcPattern        *pattern);
159   /* Deprecated in favor of create_font */
160   PangoFcFont  *(*new_font)          (PangoFcFontMap  *fontmap,
161                                       FcPattern       *pattern);
162
163   double       (*get_resolution)     (PangoFcFontMap             *fcfontmap,
164                                       PangoContext               *context);
165
166   gconstpointer (*context_key_get)   (PangoFcFontMap             *fcfontmap,
167                                       PangoContext               *context);
168   gpointer     (*context_key_copy)   (PangoFcFontMap             *fcfontmap,
169                                       gconstpointer               key);
170   void         (*context_key_free)   (PangoFcFontMap             *fcfontmap,
171                                       gpointer                    key);
172   guint32      (*context_key_hash)   (PangoFcFontMap             *fcfontmap,
173                                       gconstpointer               key);
174   gboolean     (*context_key_equal)  (PangoFcFontMap             *fcfontmap,
175                                       gconstpointer               key_a,
176                                       gconstpointer               key_b);
177
178   void         (*fontset_key_substitute)(PangoFcFontMap             *fontmap,
179                                       PangoFcFontsetKey          *fontsetkey,
180                                       FcPattern                  *pattern);
181   PangoFcFont  *(*create_font)       (PangoFcFontMap             *fontmap,
182                                       PangoFcFontKey             *fontkey);
183 } PangoFcFontMapClass;
184 </pre>
185 <p>
186 Class structure for <a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a>.</p>
187 <p>
188 </p>
189 <div class="variablelist"><table border="0">
190 <col align="left" valign="top">
191 <tbody>
192 <tr>
193 <td><p><span class="term"><em class="structfield"><code>default_substitute</code></em> ()</span></p></td>
194 <td> Substitutes in default values for
195  unspecified fields in a <span class="type">FcPattern</span>. This will be called
196  prior to creating a font for the pattern. May be <a
197 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
198 ><code class="literal">NULL</code></a>.
199  Deprecated in favor of @<code class="function">font_key_substitute()</code>.
200 </td>
201 </tr>
202 <tr>
203 <td><p><span class="term"><em class="structfield"><code>new_font</code></em> ()</span></p></td>
204 <td> Creates a new <a class="link" href="PangoFcFont.html" title="PangoFcFont"><span class="type">PangoFcFont</span></a> for the specified
205  pattern of the appropriate type for this font map. The
206  <em class="parameter"><code>pattern</code></em> argument must be passed to the "pattern" property
207  of <a class="link" href="PangoFcFont.html" title="PangoFcFont"><span class="type">PangoFcFont</span></a> when you call <a
208 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-new"
209 ><code class="function">g_object_new()</code></a>. Deprecated
210  in favor of @<code class="function">create_font()</code>.
211 </td>
212 </tr>
213 <tr>
214 <td><p><span class="term"><em class="structfield"><code>get_resolution</code></em> ()</span></p></td>
215 <td> Gets the resolution (the scale factor
216  between logical and absolute font sizes) that the backend
217  will use for a particular fontmap and context. <em class="parameter"><code>context</code></em>
218  may be null.
219 </td>
220 </tr>
221 <tr>
222 <td><p><span class="term"><em class="structfield"><code>context_key_get</code></em> ()</span></p></td>
223 <td> Gets an opaque key holding backend
224  specific options for the context that will affect
225  fonts created by <code class="function">create_font()</code>. The result must point to
226  persistant storage owned by the fontmap. This key
227  is used to index hash tables used to look up fontsets
228  and fonts.
229 </td>
230 </tr>
231 <tr>
232 <td><p><span class="term"><em class="structfield"><code>context_key_copy</code></em> ()</span></p></td>
233 <td> Copies a context key. Pango uses this
234  to make a persistant copy of the value returned from
235  <em class="parameter"><code>context_key_get</code></em>.
236 </td>
237 </tr>
238 <tr>
239 <td><p><span class="term"><em class="structfield"><code>context_key_free</code></em> ()</span></p></td>
240 <td> Frees a context key copied with
241  <em class="parameter"><code>context_key_copy</code></em>.
242 </td>
243 </tr>
244 <tr>
245 <td><p><span class="term"><em class="structfield"><code>context_key_hash</code></em> ()</span></p></td>
246 <td> Gets a hash value for a context key
247 </td>
248 </tr>
249 <tr>
250 <td><p><span class="term"><em class="structfield"><code>context_key_equal</code></em> ()</span></p></td>
251 <td> Compares two context keys for equality.
252 </td>
253 </tr>
254 <tr>
255 <td><p><span class="term"><em class="structfield"><code>fontset_key_substitute</code></em> ()</span></p></td>
256 <td> Substitutes in default values for
257  unspecified fields in a <span class="type">FcPattern</span>. This will be called
258  prior to creating a font for the pattern. May be <a
259 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
260 ><code class="literal">NULL</code></a>.
261  (Since: 1.24)
262 </td>
263 </tr>
264 <tr>
265 <td><p><span class="term"><em class="structfield"><code>create_font</code></em> ()</span></p></td>
266 <td> Creates a new <a class="link" href="PangoFcFont.html" title="PangoFcFont"><span class="type">PangoFcFont</span></a> for the specified
267  pattern of the appropriate type for this font map using
268  information from the font key that is passed in. The
269  <em class="parameter"><code>pattern</code></em> member of <em class="parameter"><code>font_key</code></em> can be retrieved using
270  <a class="link" href="PangoFcFontMap.html#pango-fc-font-key-get-pattern" title="pango_fc_font_key_get_pattern ()"><code class="function">pango_fc_font_key_get_pattern()</code></a> and must be passed to
271  the "pattern" property of <a class="link" href="PangoFcFont.html" title="PangoFcFont"><span class="type">PangoFcFont</span></a> when you call
272  <a
273 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-new"
274 ><code class="function">g_object_new()</code></a>.  If <a
275 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
276 ><code class="literal">NULL</code></a>, <code class="function">new_font()</code> is used.
277  (Since: 1.24)
278 </td>
279 </tr>
280 </tbody>
281 </table></div>
282 </div>
283 <hr>
284 <div class="refsect2" lang="en">
285 <a name="pango-fc-font-map-create-context"></a><h3>pango_fc_font_map_create_context ()</h3>
286 <pre class="programlisting"><a class="link" href="pango-Text-Processing.html#PangoContext">PangoContext</a> *      pango_fc_font_map_create_context    (<a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap">PangoFcFontMap</a> *fcfontmap);</pre>
287 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
288 <h3 class="title">Warning</h3>
289 <p><code class="literal">pango_fc_font_map_create_context</code> has been deprecated since version 1.22 and should not be used in newly-written code. Use <a class="link" href="pango-Fonts.html#pango-font-map-create-context" title="pango_font_map_create_context ()"><code class="function">pango_font_map_create_context()</code></a> instead.</p>
290 </div>
291 <p>
292 Creates a new context for this fontmap. This function is intended
293 only for backend implementations deriving from <span class="type">PangoFcFontmap</span>;
294 it is possible that a backend will store additional information
295 needed for correct operation on the <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> after calling
296 this function.</p>
297 <p>
298 </p>
299 <div class="variablelist"><table border="0">
300 <col align="left" valign="top">
301 <tbody>
302 <tr>
303 <td><p><span class="term"><em class="parameter"><code>fcfontmap</code></em> :</span></p></td>
304 <td> a <a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a>
305 </td>
306 </tr>
307 <tr>
308 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
309 <td> a new <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>
310
311 </td>
312 </tr>
313 </tbody>
314 </table></div>
315 <p class="since">Since 1.4</p>
316 </div>
317 <hr>
318 <div class="refsect2" lang="en">
319 <a name="PangoFcDecoderFindFunc"></a><h3>PangoFcDecoderFindFunc ()</h3>
320 <pre class="programlisting"><a class="link" href="PangoFcDecoder.html" title="PangoFcDecoder">PangoFcDecoder</a> *    (*PangoFcDecoderFindFunc)           (FcPattern *pattern,
321                                                          <a
322 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
323 >gpointer</a> user_data);</pre>
324 <p>
325 Callback function passed to <a class="link" href="PangoFcFontMap.html#pango-fc-font-map-add-decoder-find-func" title="pango_fc_font_map_add_decoder_find_func ()"><code class="function">pango_fc_font_map_add_decoder_find_func()</code></a>.</p>
326 <p>
327 </p>
328 <div class="variablelist"><table border="0">
329 <col align="left" valign="top">
330 <tbody>
331 <tr>
332 <td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
333 <td> a fully resolved <span class="type">FcPattern</span> specifying the font on the system
334 </td>
335 </tr>
336 <tr>
337 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
338 <td> user data passed to <a class="link" href="PangoFcFontMap.html#pango-fc-font-map-add-decoder-find-func" title="pango_fc_font_map_add_decoder_find_func ()"><code class="function">pango_fc_font_map_add_decoder_find_func()</code></a>
339 </td>
340 </tr>
341 <tr>
342 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
343 <td> a new reference to a custom decoder for this pattern,
344  or <a
345 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
346 ><code class="literal">NULL</code></a> if the default decoder handling should be used.
347 </td>
348 </tr>
349 </tbody>
350 </table></div>
351 </div>
352 <hr>
353 <div class="refsect2" lang="en">
354 <a name="pango-fc-font-map-add-decoder-find-func"></a><h3>pango_fc_font_map_add_decoder_find_func ()</h3>
355 <pre class="programlisting">void                pango_fc_font_map_add_decoder_find_func
356                                                         (<a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap">PangoFcFontMap</a> *fcfontmap,
357                                                          <a class="link" href="PangoFcFontMap.html#PangoFcDecoderFindFunc" title="PangoFcDecoderFindFunc ()">PangoFcDecoderFindFunc</a> findfunc,
358                                                          <a
359 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
360 >gpointer</a> user_data,
361                                                          <a
362 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
363 >GDestroyNotify</a> dnotify);</pre>
364 <p>
365 This function saves a callback method in the <a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a> that
366 will be called whenever new fonts are created.  If the
367 function returns a <a class="link" href="PangoFcDecoder.html" title="PangoFcDecoder"><span class="type">PangoFcDecoder</span></a>, that decoder will be used to
368 determine both coverage via a <span class="type">FcCharSet</span> and a one-to-one mapping of
369 characters to glyphs.  This will allow applications to have
370 application-specific encodings for various fonts.</p>
371 <p>
372 </p>
373 <div class="variablelist"><table border="0">
374 <col align="left" valign="top">
375 <tbody>
376 <tr>
377 <td><p><span class="term"><em class="parameter"><code>fcfontmap</code></em> :</span></p></td>
378 <td> The <a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a> to add this method to.
379 </td>
380 </tr>
381 <tr>
382 <td><p><span class="term"><em class="parameter"><code>findfunc</code></em> :</span></p></td>
383 <td> The <a class="link" href="PangoFcFontMap.html#PangoFcDecoderFindFunc" title="PangoFcDecoderFindFunc ()"><span class="type">PangoFcDecoderFindFunc</span></a> callback function
384 </td>
385 </tr>
386 <tr>
387 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
388 <td> User data.
389 </td>
390 </tr>
391 <tr>
392 <td><p><span class="term"><em class="parameter"><code>dnotify</code></em> :</span></p></td>
393 <td> A <a
394 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
395 ><span class="type">GDestroyNotify</span></a> callback that will be called when the
396  fontmap is finalized and the decoder is released.
397 </td>
398 </tr>
399 </tbody>
400 </table></div>
401 <p class="since">Since 1.6.</p>
402 </div>
403 <hr>
404 <div class="refsect2" lang="en">
405 <a name="pango-fc-font-map-find-decoder"></a><h3>pango_fc_font_map_find_decoder ()</h3>
406 <pre class="programlisting"><a class="link" href="PangoFcDecoder.html" title="PangoFcDecoder">PangoFcDecoder</a> *    pango_fc_font_map_find_decoder      (<a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap">PangoFcFontMap</a> *fcfontmap,
407                                                          FcPattern *pattern);</pre>
408 <p>
409 Finds the decoder to use for <em class="parameter"><code>pattern</code></em>.  Decoders can be added to
410 a font map using <a class="link" href="PangoFcFontMap.html#pango-fc-font-map-add-decoder-find-func" title="pango_fc_font_map_add_decoder_find_func ()"><code class="function">pango_fc_font_map_add_decoder_find_func()</code></a>.</p>
411 <p>
412 </p>
413 <div class="variablelist"><table border="0">
414 <col align="left" valign="top">
415 <tbody>
416 <tr>
417 <td><p><span class="term"><em class="parameter"><code>fcfontmap</code></em> :</span></p></td>
418 <td> The <a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a> to use.
419 </td>
420 </tr>
421 <tr>
422 <td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
423 <td> The <span class="type">FcPattern</span> to find the decoder for.
424 </td>
425 </tr>
426 <tr>
427 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
428 <td> a newly created <a class="link" href="PangoFcDecoder.html" title="PangoFcDecoder"><span class="type">PangoFcDecoder</span></a> object or <a
429 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
430 ><code class="literal">NULL</code></a> if
431          no decoder is set for <em class="parameter"><code>pattern</code></em>.
432
433 </td>
434 </tr>
435 </tbody>
436 </table></div>
437 <p class="since">Since 1.26.</p>
438 </div>
439 <hr>
440 <div class="refsect2" lang="en">
441 <a name="pango-fc-font-map-cache-clear"></a><h3>pango_fc_font_map_cache_clear ()</h3>
442 <pre class="programlisting">void                pango_fc_font_map_cache_clear       (<a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap">PangoFcFontMap</a> *fcfontmap);</pre>
443 <p>
444 Clear all cached information and fontsets for this font map;
445 this should be called whenever there is a change in the
446 output of the <code class="function">default_substitute()</code> virtual function of the
447 font map, or if fontconfig has been reinitialized to new
448 configuration.</p>
449 <p>
450 </p>
451 <div class="variablelist"><table border="0">
452 <col align="left" valign="top">
453 <tbody><tr>
454 <td><p><span class="term"><em class="parameter"><code>fcfontmap</code></em> :</span></p></td>
455 <td> a <span class="type">PangoFcFontmap</span>
456 </td>
457 </tr></tbody>
458 </table></div>
459 <p class="since">Since 1.4</p>
460 </div>
461 <hr>
462 <div class="refsect2" lang="en">
463 <a name="pango-fc-font-map-shutdown"></a><h3>pango_fc_font_map_shutdown ()</h3>
464 <pre class="programlisting">void                pango_fc_font_map_shutdown          (<a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap">PangoFcFontMap</a> *fcfontmap);</pre>
465 <p>
466 Clears all cached information for the fontmap and marks
467 all fonts open for the fontmap as dead. (See the <code class="function">shutdown()</code>
468 virtual function of <a class="link" href="PangoFcFont.html" title="PangoFcFont"><span class="type">PangoFcFont</span></a>.) This function might be used
469 by a backend when the underlying windowing system for the font
470 map exits. This function is only intended to be called
471 only for backend implementations deriving from <span class="type">PangoFcFontmap</span>.</p>
472 <p>
473 </p>
474 <div class="variablelist"><table border="0">
475 <col align="left" valign="top">
476 <tbody><tr>
477 <td><p><span class="term"><em class="parameter"><code>fcfontmap</code></em> :</span></p></td>
478 <td> a <span class="type">PangoFcFontmap</span>
479 </td>
480 </tr></tbody>
481 </table></div>
482 <p class="since">Since 1.4</p>
483 </div>
484 <hr>
485 <div class="refsect2" lang="en">
486 <a name="pango-fc-font-description-from-pattern"></a><h3>pango_fc_font_description_from_pattern ()</h3>
487 <pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> * pango_fc_font_description_from_pattern
488                                                         (FcPattern *pattern,
489                                                          <a
490 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
491 >gboolean</a> include_size);</pre>
492 <p>
493 Creates a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a> that matches the specified
494 Fontconfig pattern as closely as possible. Many possible Fontconfig
495 pattern values, such as <code class="literal">FC_RASTERIZER</code> or <code class="literal">FC_DPI</code>, don't make sense in
496 the context of <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>, so will be ignored.</p>
497 <p>
498 </p>
499 <div class="variablelist"><table border="0">
500 <col align="left" valign="top">
501 <tbody>
502 <tr>
503 <td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
504 <td> a <span class="type">FcPattern</span>
505 </td>
506 </tr>
507 <tr>
508 <td><p><span class="term"><em class="parameter"><code>include_size</code></em> :</span></p></td>
509 <td> if <a
510 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
511 ><code class="literal">TRUE</code></a>, the pattern will include the size from
512   the <em class="parameter"><code>pattern</code></em>; otherwise the resulting pattern will be unsized.
513   (only <code class="literal">FC_SIZE</code> is examined, not <code class="literal">FC_PIXEL_SIZE</code>)
514 </td>
515 </tr>
516 <tr>
517 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
518 <td> a new <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>. Free with
519  <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>.
520
521 </td>
522 </tr>
523 </tbody>
524 </table></div>
525 <p class="since">Since 1.4</p>
526 </div>
527 <hr>
528 <div class="refsect2" lang="en">
529 <a name="PANGO-FC-GRAVITY--CAPS"></a><h3>PANGO_FC_GRAVITY</h3>
530 <pre class="programlisting">#define PANGO_FC_GRAVITY "pangogravity"
531 </pre>
532 <p>
533 String representing a fontconfig property name that Pango sets on any
534 fontconfig pattern it passes to fontconfig if a <a class="link" href="pango-Vertical-Text.html#PangoGravity" title="enum PangoGravity"><span class="type">PangoGravity</span></a> other
535 than <code class="literal">PangoGravitySouth</code> is desired.
536 </p>
537 <p>
538 The property will have a <a class="link" href="pango-Vertical-Text.html#PangoGravity" title="enum PangoGravity"><span class="type">PangoGravity</span></a> value as a string, like "east".
539 This can be used to write fontconfig configuration rules to choose
540 different fonts for horizontal and vertical writing directions.</p>
541 <p>
542 </p>
543 <p class="since">Since 1.20</p>
544 </div>
545 <hr>
546 <div class="refsect2" lang="en">
547 <a name="PANGO-FC-VERSION--CAPS"></a><h3>PANGO_FC_VERSION</h3>
548 <pre class="programlisting">#define PANGO_FC_VERSION "pangoversion"
549 </pre>
550 <p>
551 String representing a fontconfig property name that Pango sets on any
552 fontconfig pattern it passes to fontconfig.
553 </p>
554 <p>
555 The property will have an integer value equal to what
556 <a class="link" href="pango-Version-Checking.html#pango-version" title="pango_version ()"><code class="function">pango_version()</code></a> returns.
557 This can be used to write fontconfig configuration rules that only affect
558 certain pango versions (or only pango-using applications, or only
559 non-pango-using applications).</p>
560 <p>
561 </p>
562 <p class="since">Since 1.20</p>
563 </div>
564 <hr>
565 <div class="refsect2" lang="en">
566 <a name="PANGO-FC-PRGNAME--CAPS"></a><h3>PANGO_FC_PRGNAME</h3>
567 <pre class="programlisting">#define PANGO_FC_PRGNAME "pangoprgname"
568 </pre>
569 <p>
570 String representing a fontconfig property name that Pango sets on any
571 fontconfig pattern it passes to fontconfig.
572 </p>
573 <p>
574 The property will have a string equal to what
575 <a
576 href="http://library.gnome.org/devel/glib/unstable/glib-Miscellaneous-Utility-Functions.html#g-get-prgname"
577 ><code class="function">g_get_prgname()</code></a> returns.
578 This can be used to write fontconfig configuration rules that only affect
579 certain applications.</p>
580 <p>
581 </p>
582 <p class="since">Since 1.24</p>
583 </div>
584 <hr>
585 <div class="refsect2" lang="en">
586 <a name="PangoFcFontsetKey"></a><h3>PangoFcFontsetKey</h3>
587 <pre class="programlisting">typedef struct _PangoFcFontsetKey PangoFcFontsetKey;</pre>
588 <p>
589 An opaque structure containing all the information needed for
590 loading a fontset with the PangoFc fontmap.</p>
591 <p>
592 </p>
593 <p class="since">Since 1.24</p>
594 </div>
595 <hr>
596 <div class="refsect2" lang="en">
597 <a name="pango-fc-fontset-key-get-context-key"></a><h3>pango_fc_fontset_key_get_context_key ()</h3>
598 <pre class="programlisting"><a
599 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
600 >gpointer</a>            pango_fc_fontset_key_get_context_key
601                                                         (const <a class="link" href="PangoFcFontMap.html#PangoFcFontsetKey" title="PangoFcFontsetKey">PangoFcFontsetKey</a> *key);</pre>
602 <p>
603 Gets the context key member of <em class="parameter"><code>key</code></em>.</p>
604 <p>
605 </p>
606 <div class="variablelist"><table border="0">
607 <col align="left" valign="top">
608 <tbody>
609 <tr>
610 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
611 <td> the font key
612 </td>
613 </tr>
614 <tr>
615 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
616 <td> the context key, which is owned by <em class="parameter"><code>key</code></em> and should not be modified.
617
618 </td>
619 </tr>
620 </tbody>
621 </table></div>
622 <p class="since">Since 1.24</p>
623 </div>
624 <hr>
625 <div class="refsect2" lang="en">
626 <a name="pango-fc-fontset-key-get-description"></a><h3>pango_fc_fontset_key_get_description ()</h3>
627 <pre class="programlisting">const <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> * pango_fc_fontset_key_get_description
628                                                         (const <a class="link" href="PangoFcFontMap.html#PangoFcFontsetKey" title="PangoFcFontsetKey">PangoFcFontsetKey</a> *key);</pre>
629 <p>
630 Gets the font description of <em class="parameter"><code>key</code></em>.</p>
631 <p>
632 </p>
633 <div class="variablelist"><table border="0">
634 <col align="left" valign="top">
635 <tbody>
636 <tr>
637 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
638 <td> the fontset key
639 </td>
640 </tr>
641 <tr>
642 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
643 <td> the font description, which is owned by <em class="parameter"><code>key</code></em> and should not be modified.
644
645 </td>
646 </tr>
647 </tbody>
648 </table></div>
649 <p class="since">Since 1.24</p>
650 </div>
651 <hr>
652 <div class="refsect2" lang="en">
653 <a name="pango-fc-fontset-key-get-language"></a><h3>pango_fc_fontset_key_get_language ()</h3>
654 <pre class="programlisting"><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage">PangoLanguage</a> *     pango_fc_fontset_key_get_language   (const <a class="link" href="PangoFcFontMap.html#PangoFcFontsetKey" title="PangoFcFontsetKey">PangoFcFontsetKey</a> *key);</pre>
655 <p>
656 Gets the language member of <em class="parameter"><code>key</code></em>.</p>
657 <p>
658 </p>
659 <div class="variablelist"><table border="0">
660 <col align="left" valign="top">
661 <tbody>
662 <tr>
663 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
664 <td> the fontset key
665 </td>
666 </tr>
667 <tr>
668 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
669 <td> the language
670
671 </td>
672 </tr>
673 </tbody>
674 </table></div>
675 <p class="since">Since 1.24</p>
676 </div>
677 <hr>
678 <div class="refsect2" lang="en">
679 <a name="pango-fc-fontset-key-get-matrix"></a><h3>pango_fc_fontset_key_get_matrix ()</h3>
680 <pre class="programlisting">const <a class="link" href="pango-Glyph-Storage.html#PangoMatrix" title="PangoMatrix">PangoMatrix</a> * pango_fc_fontset_key_get_matrix     (const <a class="link" href="PangoFcFontMap.html#PangoFcFontsetKey" title="PangoFcFontsetKey">PangoFcFontsetKey</a> *key);</pre>
681 <p>
682 Gets the matrix member of <em class="parameter"><code>key</code></em>.</p>
683 <p>
684 </p>
685 <div class="variablelist"><table border="0">
686 <col align="left" valign="top">
687 <tbody>
688 <tr>
689 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
690 <td> the fontset key
691 </td>
692 </tr>
693 <tr>
694 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
695 <td> the matrix, which is owned by <em class="parameter"><code>key</code></em> and should not be modified.
696
697 </td>
698 </tr>
699 </tbody>
700 </table></div>
701 <p class="since">Since 1.24</p>
702 </div>
703 <hr>
704 <div class="refsect2" lang="en">
705 <a name="pango-fc-fontset-key-get-absolute-size"></a><h3>pango_fc_fontset_key_get_absolute_size ()</h3>
706 <pre class="programlisting">double              pango_fc_fontset_key_get_absolute_size
707                                                         (const <a class="link" href="PangoFcFontMap.html#PangoFcFontsetKey" title="PangoFcFontsetKey">PangoFcFontsetKey</a> *key);</pre>
708 <p>
709 Gets the absolute font size of <em class="parameter"><code>key</code></em> in Pango units.  This is adjusted
710 for both resolution and transformation matrix.</p>
711 <p>
712 </p>
713 <div class="variablelist"><table border="0">
714 <col align="left" valign="top">
715 <tbody>
716 <tr>
717 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
718 <td> the fontset key
719 </td>
720 </tr>
721 <tr>
722 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
723 <td> the pixel size of <em class="parameter"><code>key</code></em>.
724
725 </td>
726 </tr>
727 </tbody>
728 </table></div>
729 <p class="since">Since 1.24</p>
730 </div>
731 <hr>
732 <div class="refsect2" lang="en">
733 <a name="pango-fc-fontset-key-get-resolution"></a><h3>pango_fc_fontset_key_get_resolution ()</h3>
734 <pre class="programlisting">double              pango_fc_fontset_key_get_resolution (const <a class="link" href="PangoFcFontMap.html#PangoFcFontsetKey" title="PangoFcFontsetKey">PangoFcFontsetKey</a> *key);</pre>
735 <p>
736 Gets the resolution of <em class="parameter"><code>key</code></em></p>
737 <p>
738 </p>
739 <div class="variablelist"><table border="0">
740 <col align="left" valign="top">
741 <tbody>
742 <tr>
743 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
744 <td> the fontset key
745 </td>
746 </tr>
747 <tr>
748 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
749 <td> the resolution of <em class="parameter"><code>key</code></em>
750
751 </td>
752 </tr>
753 </tbody>
754 </table></div>
755 <p class="since">Since 1.24</p>
756 </div>
757 <hr>
758 <div class="refsect2" lang="en">
759 <a name="PangoFcFontKey"></a><h3>PangoFcFontKey</h3>
760 <pre class="programlisting">typedef struct _PangoFcFontKey PangoFcFontKey;</pre>
761 <p>
762 An opaque structure containing all the information needed for
763 loading a font with the PangoFc fontmap.</p>
764 <p>
765 </p>
766 <p class="since">Since 1.24</p>
767 </div>
768 <hr>
769 <div class="refsect2" lang="en">
770 <a name="pango-fc-font-key-get-context-key"></a><h3>pango_fc_font_key_get_context_key ()</h3>
771 <pre class="programlisting"><a
772 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
773 >gpointer</a>            pango_fc_font_key_get_context_key   (const <a class="link" href="PangoFcFontMap.html#PangoFcFontKey" title="PangoFcFontKey">PangoFcFontKey</a> *key);</pre>
774 <p>
775 Gets the context key member of <em class="parameter"><code>key</code></em>.</p>
776 <p>
777 </p>
778 <div class="variablelist"><table border="0">
779 <col align="left" valign="top">
780 <tbody>
781 <tr>
782 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
783 <td> the font key
784 </td>
785 </tr>
786 <tr>
787 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
788 <td> the context key, which is owned by <em class="parameter"><code>key</code></em> and should not be modified.
789
790 </td>
791 </tr>
792 </tbody>
793 </table></div>
794 <p class="since">Since 1.24</p>
795 </div>
796 <hr>
797 <div class="refsect2" lang="en">
798 <a name="pango-fc-font-key-get-matrix"></a><h3>pango_fc_font_key_get_matrix ()</h3>
799 <pre class="programlisting">const <a class="link" href="pango-Glyph-Storage.html#PangoMatrix" title="PangoMatrix">PangoMatrix</a> * pango_fc_font_key_get_matrix        (const <a class="link" href="PangoFcFontMap.html#PangoFcFontKey" title="PangoFcFontKey">PangoFcFontKey</a> *key);</pre>
800 <p>
801 Gets the matrix member of <em class="parameter"><code>key</code></em>.</p>
802 <p>
803 </p>
804 <div class="variablelist"><table border="0">
805 <col align="left" valign="top">
806 <tbody>
807 <tr>
808 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
809 <td> the font key
810 </td>
811 </tr>
812 <tr>
813 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
814 <td> the matrix, which is owned by <em class="parameter"><code>key</code></em> and should not be modified.
815
816 </td>
817 </tr>
818 </tbody>
819 </table></div>
820 <p class="since">Since 1.24</p>
821 </div>
822 <hr>
823 <div class="refsect2" lang="en">
824 <a name="pango-fc-font-key-get-pattern"></a><h3>pango_fc_font_key_get_pattern ()</h3>
825 <pre class="programlisting">const FcPattern *   pango_fc_font_key_get_pattern       (const <a class="link" href="PangoFcFontMap.html#PangoFcFontKey" title="PangoFcFontKey">PangoFcFontKey</a> *key);</pre>
826 <p>
827 Gets the fontconfig pattern member of <em class="parameter"><code>key</code></em>.</p>
828 <p>
829 </p>
830 <div class="variablelist"><table border="0">
831 <col align="left" valign="top">
832 <tbody>
833 <tr>
834 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
835 <td> the font key
836 </td>
837 </tr>
838 <tr>
839 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
840 <td> the pattern, which is owned by <em class="parameter"><code>key</code></em> and should not be modified.
841
842 </td>
843 </tr>
844 </tbody>
845 </table></div>
846 <p class="since">Since 1.24</p>
847 </div>
848 </div>
849 <div class="refsect1" lang="en">
850 <a name="PangoFcFontMap.see-also"></a><h2>See Also</h2>
851 <p>
852 </p>
853 <div class="variablelist"><table border="0">
854 <col align="left" valign="top">
855 <tbody><tr>
856 <td><p><span class="term"><a class="link" href="PangoFcFont.html" title="PangoFcFont"><span class="type">PangoFcFont</span></a></span></p></td>
857 <td><p>The base class for fonts; creating a new
858 Fontconfig-based backend involves deriving from both
859 <a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a> and <a class="link" href="PangoFcFont.html" title="PangoFcFont"><span class="type">PangoFcFont</span></a>.
860 </p></td>
861 </tr></tbody>
862 </table></div>
863 <p>
864 </p>
865 </div>
866 </div>
867 <div class="footer">
868 <hr>
869           Generated by GTK-Doc V1.11</div>
870 </body>
871 </html>