32
30
<h2><span class="refentrytitle"><a name="PangoFcFontMap.top_of_page"></a>PangoFcFontMap</span></h2>
33
31
<p>PangoFcFontMap — Base fontmap class for Fontconfig-based backends</p>
35
<td valign="top" align="right"></td>
33
<td class="gallery_image" valign="top" align="right"></td>
36
34
</tr></table></div>
37
<div class="refsynopsisdiv">
38
<a name="PangoFcFontMap.synopsis"></a><h2>Synopsis</h2>
39
<pre class="synopsis">struct <a class="link" href="PangoFcFontMap.html#PangoFcFontMap-struct" title="struct PangoFcFontMap">PangoFcFontMap</a>;
40
struct <a class="link" href="PangoFcFontMap.html#PangoFcFontMapClass" title="struct PangoFcFontMapClass">PangoFcFontMapClass</a>;
41
<a class="link" href="pango-Text-Processing.html#PangoContext"><span class="returnvalue">PangoContext</span></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> (<em class="parameter"><code><a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a> *fcfontmap</code></em>);
42
<a class="link" href="PangoFcDecoder.html" title="PangoFcDecoder"><span class="returnvalue">PangoFcDecoder</span></a> * (<a class="link" href="PangoFcFontMap.html#PangoFcDecoderFindFunc" title="PangoFcDecoderFindFunc ()">*PangoFcDecoderFindFunc</a>) (<em class="parameter"><code><span class="type">FcPattern</span> *pattern</code></em>,
43
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
44
<span class="returnvalue">void</span> <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>
45
(<em class="parameter"><code><a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a> *fcfontmap</code></em>,
46
<em class="parameter"><code><a class="link" href="PangoFcFontMap.html#PangoFcDecoderFindFunc" title="PangoFcDecoderFindFunc ()"><span class="type">PangoFcDecoderFindFunc</span></a> findfunc</code></em>,
47
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
48
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> dnotify</code></em>);
49
<a class="link" href="PangoFcDecoder.html" title="PangoFcDecoder"><span class="returnvalue">PangoFcDecoder</span></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> (<em class="parameter"><code><a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a> *fcfontmap</code></em>,
50
<em class="parameter"><code><span class="type">FcPattern</span> *pattern</code></em>);
51
<span class="returnvalue">void</span> <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> (<em class="parameter"><code><a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a> *fcfontmap</code></em>);
52
<span class="returnvalue">void</span> <a class="link" href="PangoFcFontMap.html#pango-fc-font-map-shutdown" title="pango_fc_font_map_shutdown ()">pango_fc_font_map_shutdown</a> (<em class="parameter"><code><a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a> *fcfontmap</code></em>);
53
<a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></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>
54
(<em class="parameter"><code><span class="type">FcPattern</span> *pattern</code></em>,
55
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> include_size</code></em>);
56
#define <a class="link" href="PangoFcFontMap.html#PANGO-FC-FONT-FEATURES:CAPS" title="PANGO_FC_FONT_FEATURES">PANGO_FC_FONT_FEATURES</a>
57
#define <a class="link" href="PangoFcFontMap.html#PANGO-FC-GRAVITY:CAPS" title="PANGO_FC_GRAVITY">PANGO_FC_GRAVITY</a>
58
#define <a class="link" href="PangoFcFontMap.html#PANGO-FC-VERSION:CAPS" title="PANGO_FC_VERSION">PANGO_FC_VERSION</a>
59
#define <a class="link" href="PangoFcFontMap.html#PANGO-FC-PRGNAME:CAPS" title="PANGO_FC_PRGNAME">PANGO_FC_PRGNAME</a>
62
<a class="link" href="PangoFcFontMap.html#PangoFcFontsetKey" title="PangoFcFontsetKey">PangoFcFontsetKey</a>;
63
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></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>
64
(<em class="parameter"><code>const <a class="link" href="PangoFcFontMap.html#PangoFcFontsetKey" title="PangoFcFontsetKey"><span class="type">PangoFcFontsetKey</span></a> *key</code></em>);
65
const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></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>
66
(<em class="parameter"><code>const <a class="link" href="PangoFcFontMap.html#PangoFcFontsetKey" title="PangoFcFontsetKey"><span class="type">PangoFcFontsetKey</span></a> *key</code></em>);
67
<a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="returnvalue">PangoLanguage</span></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> (<em class="parameter"><code>const <a class="link" href="PangoFcFontMap.html#PangoFcFontsetKey" title="PangoFcFontsetKey"><span class="type">PangoFcFontsetKey</span></a> *key</code></em>);
68
const <a class="link" href="pango-Glyph-Storage.html#PangoMatrix"><span class="returnvalue">PangoMatrix</span></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> (<em class="parameter"><code>const <a class="link" href="PangoFcFontMap.html#PangoFcFontsetKey" title="PangoFcFontsetKey"><span class="type">PangoFcFontsetKey</span></a> *key</code></em>);
69
<span class="returnvalue">double</span> <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>
70
(<em class="parameter"><code>const <a class="link" href="PangoFcFontMap.html#PangoFcFontsetKey" title="PangoFcFontsetKey"><span class="type">PangoFcFontsetKey</span></a> *key</code></em>);
71
<span class="returnvalue">double</span> <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> (<em class="parameter"><code>const <a class="link" href="PangoFcFontMap.html#PangoFcFontsetKey" title="PangoFcFontsetKey"><span class="type">PangoFcFontsetKey</span></a> *key</code></em>);
72
<a class="link" href="PangoFcFontMap.html#PangoFcFontKey" title="PangoFcFontKey">PangoFcFontKey</a>;
73
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></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> (<em class="parameter"><code>const <a class="link" href="PangoFcFontMap.html#PangoFcFontKey" title="PangoFcFontKey"><span class="type">PangoFcFontKey</span></a> *key</code></em>);
74
const <a class="link" href="pango-Glyph-Storage.html#PangoMatrix"><span class="returnvalue">PangoMatrix</span></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> (<em class="parameter"><code>const <a class="link" href="PangoFcFontMap.html#PangoFcFontKey" title="PangoFcFontKey"><span class="type">PangoFcFontKey</span></a> *key</code></em>);
75
const <span class="returnvalue">FcPattern</span> * <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> (<em class="parameter"><code>const <a class="link" href="PangoFcFontMap.html#PangoFcFontKey" title="PangoFcFontKey"><span class="type">PangoFcFontKey</span></a> *key</code></em>);
35
<div class="refsect1">
36
<a name="PangoFcFontMap.functions"></a><h2>Functions</h2>
37
<div class="informaltable"><table width="100%" border="0">
39
<col width="150px" class="functions_return">
40
<col class="functions_name">
44
<td class="function_type">
45
<a class="link" href="pango-Text-Processing.html#PangoContext"><span class="returnvalue">PangoContext</span></a> *
47
<td class="function_name">
48
<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> <span class="c_punctuation">()</span>
52
<td class="function_type">
53
<a class="link" href="PangoFcDecoder.html" title="PangoFcDecoder"><span class="returnvalue">PangoFcDecoder</span></a> *
55
<td class="function_name">
56
<span class="c_punctuation">(</span><a class="link" href="PangoFcFontMap.html#PangoFcDecoderFindFunc" title="PangoFcDecoderFindFunc ()">*PangoFcDecoderFindFunc</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
60
<td class="function_type">
61
<span class="returnvalue">void</span>
63
<td class="function_name">
64
<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> <span class="c_punctuation">()</span>
68
<td class="function_type">
69
<a class="link" href="PangoFcDecoder.html" title="PangoFcDecoder"><span class="returnvalue">PangoFcDecoder</span></a> *
71
<td class="function_name">
72
<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> <span class="c_punctuation">()</span>
76
<td class="function_type">
77
<span class="returnvalue">void</span>
79
<td class="function_name">
80
<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> <span class="c_punctuation">()</span>
84
<td class="function_type">
85
<span class="returnvalue">void</span>
87
<td class="function_name">
88
<a class="link" href="PangoFcFontMap.html#pango-fc-font-map-shutdown" title="pango_fc_font_map_shutdown ()">pango_fc_font_map_shutdown</a> <span class="c_punctuation">()</span>
92
<td class="function_type">
93
<a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> *
95
<td class="function_name">
96
<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> <span class="c_punctuation">()</span>
100
<td class="function_type">
101
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a>
103
<td class="function_name">
104
<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> <span class="c_punctuation">()</span>
108
<td class="function_type">const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> *
110
<td class="function_name">
111
<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> <span class="c_punctuation">()</span>
115
<td class="function_type">
116
<a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="returnvalue">PangoLanguage</span></a> *
118
<td class="function_name">
119
<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> <span class="c_punctuation">()</span>
123
<td class="function_type">const <a class="link" href="pango-Glyph-Storage.html#PangoMatrix"><span class="returnvalue">PangoMatrix</span></a> *
125
<td class="function_name">
126
<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> <span class="c_punctuation">()</span>
130
<td class="function_type">
131
<span class="returnvalue">double</span>
133
<td class="function_name">
134
<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> <span class="c_punctuation">()</span>
138
<td class="function_type">
139
<span class="returnvalue">double</span>
141
<td class="function_name">
142
<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> <span class="c_punctuation">()</span>
146
<td class="function_type">
147
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a>
149
<td class="function_name">
150
<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> <span class="c_punctuation">()</span>
154
<td class="function_type">const <a class="link" href="pango-Glyph-Storage.html#PangoMatrix"><span class="returnvalue">PangoMatrix</span></a> *
156
<td class="function_name">
157
<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> <span class="c_punctuation">()</span>
161
<td class="function_type">const <span class="returnvalue">FcPattern</span> *
163
<td class="function_name">
164
<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> <span class="c_punctuation">()</span>
170
<div class="refsect1">
171
<a name="PangoFcFontMap.other"></a><h2>Types and Values</h2>
172
<div class="informaltable"><table width="100%" border="0">
174
<col width="150px" class="name">
175
<col class="description">
179
<td class="datatype_keyword">struct</td>
180
<td class="function_name"><a class="link" href="PangoFcFontMap.html#PangoFcFontMap-struct" title="struct PangoFcFontMap">PangoFcFontMap</a></td>
183
<td class="datatype_keyword">struct</td>
184
<td class="function_name"><a class="link" href="PangoFcFontMap.html#PangoFcFontMapClass" title="struct PangoFcFontMapClass">PangoFcFontMapClass</a></td>
187
<td class="define_keyword">#define</td>
188
<td class="function_name"><a class="link" href="PangoFcFontMap.html#PANGO-FC-FONT-FEATURES:CAPS" title="PANGO_FC_FONT_FEATURES">PANGO_FC_FONT_FEATURES</a></td>
191
<td class="define_keyword">#define</td>
192
<td class="function_name"><a class="link" href="PangoFcFontMap.html#PANGO-FC-GRAVITY:CAPS" title="PANGO_FC_GRAVITY">PANGO_FC_GRAVITY</a></td>
195
<td class="define_keyword">#define</td>
196
<td class="function_name"><a class="link" href="PangoFcFontMap.html#PANGO-FC-VERSION:CAPS" title="PANGO_FC_VERSION">PANGO_FC_VERSION</a></td>
199
<td class="define_keyword">#define</td>
200
<td class="function_name"><a class="link" href="PangoFcFontMap.html#PANGO-FC-PRGNAME:CAPS" title="PANGO_FC_PRGNAME">PANGO_FC_PRGNAME</a></td>
203
<td class="datatype_keyword"> </td>
204
<td class="function_name"><a class="link" href="PangoFcFontMap.html#PangoFcFontsetKey" title="PangoFcFontsetKey">PangoFcFontsetKey</a></td>
207
<td class="datatype_keyword"> </td>
208
<td class="function_name"><a class="link" href="PangoFcFontMap.html#PangoFcFontKey" title="PangoFcFontKey">PangoFcFontKey</a></td>
78
213
<div class="refsect1">
79
214
<a name="PangoFcFontMap.object-hierarchy"></a><h2>Object Hierarchy</h2>
80
<pre class="synopsis">
81
<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
82
+----<a class="link" href="pango-Fonts.html#PangoFontMap">PangoFontMap</a>
84
+----<a class="link" href="pango-FreeType-Fonts-and-Rendering.html#PangoFT2FontMap">PangoFT2FontMap</a>
85
+----<a class="link" href="pango-Xft-Fonts-and-Rendering.html#PangoXftFontMap">PangoXftFontMap</a>
215
<pre class="screen"> <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
216
<span class="lineart">╰──</span> <a class="link" href="pango-Fonts.html#PangoFontMap">PangoFontMap</a>
217
<span class="lineart">╰──</span> PangoFcFontMap
218
<span class="lineart">├──</span> <a class="link" href="pango-FreeType-Fonts-and-Rendering.html#PangoFT2FontMap">PangoFT2FontMap</a>
219
<span class="lineart">╰──</span> <a class="link" href="pango-Xft-Fonts-and-Rendering.html#PangoXftFontMap">PangoXftFontMap</a>
88
222
<div class="refsect1">
89
223
<a name="PangoFcFontMap.description"></a><h2>Description</h2>
91
PangoFcFontMap is a base class for font map implementations using the
92
Fontconfig and FreeType libraries. It is used in the
224
<p>PangoFcFontMap is a base class for font map implementations using the
225
Fontconfig and FreeType libraries. It is used in the</p>
93
226
<a class="link" href="pango-Xft-Fonts-and-Rendering.html" title="Xft Fonts and Rendering">Xft</a> and
94
<a class="link" href="pango-FreeType-Fonts-and-Rendering.html" title="FreeType Fonts and Rendering">FreeType</a>
95
backends shipped with Pango, but can also be used when creating
227
<a class="link" href="pango-FreeType-Fonts-and-Rendering.html" title="FreeType Fonts and Rendering">FreeType</a><p>backends shipped with Pango, but can also be used when creating
96
228
new backends. Any backend deriving from this base class will
97
229
take advantage of the wide range of shapers implemented using
98
230
FreeType that come with Pango.</p>
100
232
<div class="refsect1">
101
<a name="PangoFcFontMap.details"></a><h2>Details</h2>
233
<a name="PangoFcFontMap.functions_details"></a><h2>Functions</h2>
234
<div class="refsect2">
235
<a name="pango-fc-font-map-create-context"></a><h3>pango_fc_font_map_create_context ()</h3>
236
<pre class="programlisting"><a class="link" href="pango-Text-Processing.html#PangoContext"><span class="returnvalue">PangoContext</span></a> *
237
pango_fc_font_map_create_context (<em class="parameter"><code><a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a> *fcfontmap</code></em>);</pre>
238
<div class="warning">
239
<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.</p>
240
<p>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>
242
<p>Creates a new context for this fontmap. This function is intended
243
only for backend implementations deriving from <a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a>;
244
it is possible that a backend will store additional information
245
needed for correct operation on the <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> after calling
247
<div class="refsect3">
248
<a name="id-1.4.3.7.2.7"></a><h4>Parameters</h4>
249
<div class="informaltable"><table width="100%" border="0">
251
<col width="150px" class="parameters_name">
252
<col class="parameters_description">
253
<col width="200px" class="parameters_annotations">
256
<td class="parameter_name"><p>fcfontmap</p></td>
257
<td class="parameter_description"><p>a <a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a></p></td>
258
<td class="parameter_annotations"> </td>
262
<div class="refsect3">
263
<a name="id-1.4.3.7.2.8"></a><h4>Returns</h4>
264
<p> a new <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a></p>
267
<p class="since">Since 1.4</p>
270
<div class="refsect2">
271
<a name="PangoFcDecoderFindFunc"></a><h3>PangoFcDecoderFindFunc ()</h3>
272
<pre class="programlisting"><a class="link" href="PangoFcDecoder.html" title="PangoFcDecoder"><span class="returnvalue">PangoFcDecoder</span></a> *
273
<span class="c_punctuation">(</span>*PangoFcDecoderFindFunc<span class="c_punctuation">)</span> (<em class="parameter"><code><span class="type">FcPattern</span> *pattern</code></em>,
274
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
275
<p>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>
276
<div class="refsect3">
277
<a name="id-1.4.3.7.3.5"></a><h4>Parameters</h4>
278
<div class="informaltable"><table width="100%" border="0">
280
<col width="150px" class="parameters_name">
281
<col class="parameters_description">
282
<col width="200px" class="parameters_annotations">
286
<td class="parameter_name"><p>pattern</p></td>
287
<td class="parameter_description"><p>a fully resolved <span class="type">FcPattern</span> specifying the font on the system</p></td>
288
<td class="parameter_annotations"> </td>
291
<td class="parameter_name"><p>user_data</p></td>
292
<td class="parameter_description"><p>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></p></td>
293
<td class="parameter_annotations"> </td>
298
<div class="refsect3">
299
<a name="id-1.4.3.7.3.6"></a><h4>Returns</h4>
300
<p> a new reference to a custom decoder for this pattern,
301
or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the default decoder handling should be used.</p>
306
<div class="refsect2">
307
<a name="pango-fc-font-map-add-decoder-find-func"></a><h3>pango_fc_font_map_add_decoder_find_func ()</h3>
308
<pre class="programlisting"><span class="returnvalue">void</span>
309
pango_fc_font_map_add_decoder_find_func
310
(<em class="parameter"><code><a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a> *fcfontmap</code></em>,
311
<em class="parameter"><code><a class="link" href="PangoFcFontMap.html#PangoFcDecoderFindFunc" title="PangoFcDecoderFindFunc ()"><span class="type">PangoFcDecoderFindFunc</span></a> findfunc</code></em>,
312
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
313
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> dnotify</code></em>);</pre>
314
<p>This function saves a callback method in the <a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a> that
315
will be called whenever new fonts are created. If the
316
function returns a <a class="link" href="PangoFcDecoder.html" title="PangoFcDecoder"><span class="type">PangoFcDecoder</span></a>, that decoder will be used to
317
determine both coverage via a <span class="type">FcCharSet</span> and a one-to-one mapping of
318
characters to glyphs. This will allow applications to have
319
application-specific encodings for various fonts.</p>
320
<div class="refsect3">
321
<a name="id-1.4.3.7.4.5"></a><h4>Parameters</h4>
322
<div class="informaltable"><table width="100%" border="0">
324
<col width="150px" class="parameters_name">
325
<col class="parameters_description">
326
<col width="200px" class="parameters_annotations">
330
<td class="parameter_name"><p>fcfontmap</p></td>
331
<td class="parameter_description"><p>The <a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a> to add this method to.</p></td>
332
<td class="parameter_annotations"> </td>
335
<td class="parameter_name"><p>findfunc</p></td>
336
<td class="parameter_description"><p>The <a class="link" href="PangoFcFontMap.html#PangoFcDecoderFindFunc" title="PangoFcDecoderFindFunc ()"><span class="type">PangoFcDecoderFindFunc</span></a> callback function</p></td>
337
<td class="parameter_annotations"> </td>
340
<td class="parameter_name"><p>user_data</p></td>
341
<td class="parameter_description"><p>User data.</p></td>
342
<td class="parameter_annotations"> </td>
345
<td class="parameter_name"><p>dnotify</p></td>
346
<td class="parameter_description"><p>A <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> callback that will be called when the
347
fontmap is finalized and the decoder is released.</p></td>
348
<td class="parameter_annotations"> </td>
353
<p class="since">Since 1.6</p>
356
<div class="refsect2">
357
<a name="pango-fc-font-map-find-decoder"></a><h3>pango_fc_font_map_find_decoder ()</h3>
358
<pre class="programlisting"><a class="link" href="PangoFcDecoder.html" title="PangoFcDecoder"><span class="returnvalue">PangoFcDecoder</span></a> *
359
pango_fc_font_map_find_decoder (<em class="parameter"><code><a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a> *fcfontmap</code></em>,
360
<em class="parameter"><code><span class="type">FcPattern</span> *pattern</code></em>);</pre>
361
<p>Finds the decoder to use for <em class="parameter"><code>pattern</code></em>
362
. Decoders can be added to
363
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>
364
<div class="refsect3">
365
<a name="id-1.4.3.7.5.5"></a><h4>Parameters</h4>
366
<div class="informaltable"><table width="100%" border="0">
368
<col width="150px" class="parameters_name">
369
<col class="parameters_description">
370
<col width="200px" class="parameters_annotations">
374
<td class="parameter_name"><p>fcfontmap</p></td>
375
<td class="parameter_description"><p>The <a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a> to use.</p></td>
376
<td class="parameter_annotations"> </td>
379
<td class="parameter_name"><p>pattern</p></td>
380
<td class="parameter_description"><p>The <span class="type">FcPattern</span> to find the decoder for.</p></td>
381
<td class="parameter_annotations"> </td>
386
<div class="refsect3">
387
<a name="id-1.4.3.7.5.6"></a><h4>Returns</h4>
388
<p> a newly created <a class="link" href="PangoFcDecoder.html" title="PangoFcDecoder"><span class="type">PangoFcDecoder</span></a> object or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
389
no decoder is set for <em class="parameter"><code>pattern</code></em>
393
<p class="since">Since 1.26</p>
396
<div class="refsect2">
397
<a name="pango-fc-font-map-cache-clear"></a><h3>pango_fc_font_map_cache_clear ()</h3>
398
<pre class="programlisting"><span class="returnvalue">void</span>
399
pango_fc_font_map_cache_clear (<em class="parameter"><code><a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a> *fcfontmap</code></em>);</pre>
400
<p>Clear all cached information and fontsets for this font map;
401
this should be called whenever there is a change in the
402
output of the <code class="function">default_substitute()</code> virtual function of the
403
font map, or if fontconfig has been reinitialized to new
405
<div class="refsect3">
406
<a name="id-1.4.3.7.6.5"></a><h4>Parameters</h4>
407
<div class="informaltable"><table width="100%" border="0">
409
<col width="150px" class="parameters_name">
410
<col class="parameters_description">
411
<col width="200px" class="parameters_annotations">
414
<td class="parameter_name"><p>fcfontmap</p></td>
415
<td class="parameter_description"><p>a <a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a></p></td>
416
<td class="parameter_annotations"> </td>
420
<p class="since">Since 1.4</p>
423
<div class="refsect2">
424
<a name="pango-fc-font-map-shutdown"></a><h3>pango_fc_font_map_shutdown ()</h3>
425
<pre class="programlisting"><span class="returnvalue">void</span>
426
pango_fc_font_map_shutdown (<em class="parameter"><code><a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a> *fcfontmap</code></em>);</pre>
427
<p>Clears all cached information for the fontmap and marks
428
all fonts open for the fontmap as dead. (See the <code class="function">shutdown()</code>
429
virtual function of <a class="link" href="PangoFcFont.html" title="PangoFcFont"><span class="type">PangoFcFont</span></a>.) This function might be used
430
by a backend when the underlying windowing system for the font
431
map exits. This function is only intended to be called
432
only for backend implementations deriving from <a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a>.</p>
433
<div class="refsect3">
434
<a name="id-1.4.3.7.7.5"></a><h4>Parameters</h4>
435
<div class="informaltable"><table width="100%" border="0">
437
<col width="150px" class="parameters_name">
438
<col class="parameters_description">
439
<col width="200px" class="parameters_annotations">
442
<td class="parameter_name"><p>fcfontmap</p></td>
443
<td class="parameter_description"><p>a <a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a></p></td>
444
<td class="parameter_annotations"> </td>
448
<p class="since">Since 1.4</p>
451
<div class="refsect2">
452
<a name="pango-fc-font-description-from-pattern"></a><h3>pango_fc_font_description_from_pattern ()</h3>
453
<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> *
454
pango_fc_font_description_from_pattern
455
(<em class="parameter"><code><span class="type">FcPattern</span> *pattern</code></em>,
456
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> include_size</code></em>);</pre>
457
<p>Creates a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> that matches the specified
458
Fontconfig pattern as closely as possible. Many possible Fontconfig
459
pattern values, such as <code class="literal">FC_RASTERIZER</code> or <code class="literal">FC_DPI</code>, don't make sense in
460
the context of <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>, so will be ignored.</p>
461
<div class="refsect3">
462
<a name="id-1.4.3.7.8.5"></a><h4>Parameters</h4>
463
<div class="informaltable"><table width="100%" border="0">
465
<col width="150px" class="parameters_name">
466
<col class="parameters_description">
467
<col width="200px" class="parameters_annotations">
471
<td class="parameter_name"><p>pattern</p></td>
472
<td class="parameter_description"><p>a <span class="type">FcPattern</span></p></td>
473
<td class="parameter_annotations"> </td>
476
<td class="parameter_name"><p>include_size</p></td>
477
<td class="parameter_description"><p>if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, the pattern will include the size from
478
the <em class="parameter"><code>pattern</code></em>
479
; otherwise the resulting pattern will be unsized.
480
(only <code class="literal">FC_SIZE</code> is examined, not <code class="literal">FC_PIXEL_SIZE</code>)</p></td>
481
<td class="parameter_annotations"> </td>
486
<div class="refsect3">
487
<a name="id-1.4.3.7.8.6"></a><h4>Returns</h4>
488
<p> a new <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>. Free with
489
<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>.</p>
492
<p class="since">Since 1.4</p>
495
<div class="refsect2">
496
<a name="pango-fc-fontset-key-get-context-key"></a><h3>pango_fc_fontset_key_get_context_key ()</h3>
497
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a>
498
pango_fc_fontset_key_get_context_key (<em class="parameter"><code>const <a class="link" href="PangoFcFontMap.html#PangoFcFontsetKey" title="PangoFcFontsetKey"><span class="type">PangoFcFontsetKey</span></a> *key</code></em>);</pre>
499
<p>Gets the context key member of <em class="parameter"><code>key</code></em>
501
<div class="refsect3">
502
<a name="id-1.4.3.7.9.5"></a><h4>Parameters</h4>
503
<div class="informaltable"><table width="100%" border="0">
505
<col width="150px" class="parameters_name">
506
<col class="parameters_description">
507
<col width="200px" class="parameters_annotations">
510
<td class="parameter_name"><p>key</p></td>
511
<td class="parameter_description"><p>the font key</p></td>
512
<td class="parameter_annotations"> </td>
516
<div class="refsect3">
517
<a name="id-1.4.3.7.9.6"></a><h4>Returns</h4>
518
<p> the context key, which is owned by <em class="parameter"><code>key</code></em>
519
and should not be modified.</p>
522
<p class="since">Since 1.24</p>
525
<div class="refsect2">
526
<a name="pango-fc-fontset-key-get-description"></a><h3>pango_fc_fontset_key_get_description ()</h3>
527
<pre class="programlisting">const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> *
528
pango_fc_fontset_key_get_description (<em class="parameter"><code>const <a class="link" href="PangoFcFontMap.html#PangoFcFontsetKey" title="PangoFcFontsetKey"><span class="type">PangoFcFontsetKey</span></a> *key</code></em>);</pre>
529
<p>Gets the font description of <em class="parameter"><code>key</code></em>
531
<div class="refsect3">
532
<a name="id-1.4.3.7.10.5"></a><h4>Parameters</h4>
533
<div class="informaltable"><table width="100%" border="0">
535
<col width="150px" class="parameters_name">
536
<col class="parameters_description">
537
<col width="200px" class="parameters_annotations">
540
<td class="parameter_name"><p>key</p></td>
541
<td class="parameter_description"><p>the fontset key</p></td>
542
<td class="parameter_annotations"> </td>
546
<div class="refsect3">
547
<a name="id-1.4.3.7.10.6"></a><h4>Returns</h4>
548
<p> the font description, which is owned by <em class="parameter"><code>key</code></em>
549
and should not be modified.</p>
552
<p class="since">Since 1.24</p>
555
<div class="refsect2">
556
<a name="pango-fc-fontset-key-get-language"></a><h3>pango_fc_fontset_key_get_language ()</h3>
557
<pre class="programlisting"><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="returnvalue">PangoLanguage</span></a> *
558
pango_fc_fontset_key_get_language (<em class="parameter"><code>const <a class="link" href="PangoFcFontMap.html#PangoFcFontsetKey" title="PangoFcFontsetKey"><span class="type">PangoFcFontsetKey</span></a> *key</code></em>);</pre>
559
<p>Gets the language member of <em class="parameter"><code>key</code></em>
561
<div class="refsect3">
562
<a name="id-1.4.3.7.11.5"></a><h4>Parameters</h4>
563
<div class="informaltable"><table width="100%" border="0">
565
<col width="150px" class="parameters_name">
566
<col class="parameters_description">
567
<col width="200px" class="parameters_annotations">
570
<td class="parameter_name"><p>key</p></td>
571
<td class="parameter_description"><p>the fontset key</p></td>
572
<td class="parameter_annotations"> </td>
576
<div class="refsect3">
577
<a name="id-1.4.3.7.11.6"></a><h4>Returns</h4>
581
<p class="since">Since 1.24</p>
584
<div class="refsect2">
585
<a name="pango-fc-fontset-key-get-matrix"></a><h3>pango_fc_fontset_key_get_matrix ()</h3>
586
<pre class="programlisting">const <a class="link" href="pango-Glyph-Storage.html#PangoMatrix"><span class="returnvalue">PangoMatrix</span></a> *
587
pango_fc_fontset_key_get_matrix (<em class="parameter"><code>const <a class="link" href="PangoFcFontMap.html#PangoFcFontsetKey" title="PangoFcFontsetKey"><span class="type">PangoFcFontsetKey</span></a> *key</code></em>);</pre>
588
<p>Gets the matrix member of <em class="parameter"><code>key</code></em>
590
<div class="refsect3">
591
<a name="id-1.4.3.7.12.5"></a><h4>Parameters</h4>
592
<div class="informaltable"><table width="100%" border="0">
594
<col width="150px" class="parameters_name">
595
<col class="parameters_description">
596
<col width="200px" class="parameters_annotations">
599
<td class="parameter_name"><p>key</p></td>
600
<td class="parameter_description"><p>the fontset key</p></td>
601
<td class="parameter_annotations"> </td>
605
<div class="refsect3">
606
<a name="id-1.4.3.7.12.6"></a><h4>Returns</h4>
607
<p> the matrix, which is owned by <em class="parameter"><code>key</code></em>
608
and should not be modified.</p>
611
<p class="since">Since 1.24</p>
614
<div class="refsect2">
615
<a name="pango-fc-fontset-key-get-absolute-size"></a><h3>pango_fc_fontset_key_get_absolute_size ()</h3>
616
<pre class="programlisting"><span class="returnvalue">double</span>
617
pango_fc_fontset_key_get_absolute_size
618
(<em class="parameter"><code>const <a class="link" href="PangoFcFontMap.html#PangoFcFontsetKey" title="PangoFcFontsetKey"><span class="type">PangoFcFontsetKey</span></a> *key</code></em>);</pre>
619
<p>Gets the absolute font size of <em class="parameter"><code>key</code></em>
620
in Pango units. This is adjusted
621
for both resolution and transformation matrix.</p>
622
<div class="refsect3">
623
<a name="id-1.4.3.7.13.5"></a><h4>Parameters</h4>
624
<div class="informaltable"><table width="100%" border="0">
626
<col width="150px" class="parameters_name">
627
<col class="parameters_description">
628
<col width="200px" class="parameters_annotations">
631
<td class="parameter_name"><p>key</p></td>
632
<td class="parameter_description"><p>the fontset key</p></td>
633
<td class="parameter_annotations"> </td>
637
<div class="refsect3">
638
<a name="id-1.4.3.7.13.6"></a><h4>Returns</h4>
639
<p> the pixel size of <em class="parameter"><code>key</code></em>
643
<p class="since">Since 1.24</p>
646
<div class="refsect2">
647
<a name="pango-fc-fontset-key-get-resolution"></a><h3>pango_fc_fontset_key_get_resolution ()</h3>
648
<pre class="programlisting"><span class="returnvalue">double</span>
649
pango_fc_fontset_key_get_resolution (<em class="parameter"><code>const <a class="link" href="PangoFcFontMap.html#PangoFcFontsetKey" title="PangoFcFontsetKey"><span class="type">PangoFcFontsetKey</span></a> *key</code></em>);</pre>
650
<p>Gets the resolution of <em class="parameter"><code>key</code></em>
652
<div class="refsect3">
653
<a name="id-1.4.3.7.14.5"></a><h4>Parameters</h4>
654
<div class="informaltable"><table width="100%" border="0">
656
<col width="150px" class="parameters_name">
657
<col class="parameters_description">
658
<col width="200px" class="parameters_annotations">
661
<td class="parameter_name"><p>key</p></td>
662
<td class="parameter_description"><p>the fontset key</p></td>
663
<td class="parameter_annotations"> </td>
667
<div class="refsect3">
668
<a name="id-1.4.3.7.14.6"></a><h4>Returns</h4>
669
<p> the resolution of <em class="parameter"><code>key</code></em>
673
<p class="since">Since 1.24</p>
676
<div class="refsect2">
677
<a name="pango-fc-font-key-get-context-key"></a><h3>pango_fc_font_key_get_context_key ()</h3>
678
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a>
679
pango_fc_font_key_get_context_key (<em class="parameter"><code>const <a class="link" href="PangoFcFontMap.html#PangoFcFontKey" title="PangoFcFontKey"><span class="type">PangoFcFontKey</span></a> *key</code></em>);</pre>
680
<p>Gets the context key member of <em class="parameter"><code>key</code></em>
682
<div class="refsect3">
683
<a name="id-1.4.3.7.15.5"></a><h4>Parameters</h4>
684
<div class="informaltable"><table width="100%" border="0">
686
<col width="150px" class="parameters_name">
687
<col class="parameters_description">
688
<col width="200px" class="parameters_annotations">
691
<td class="parameter_name"><p>key</p></td>
692
<td class="parameter_description"><p>the font key</p></td>
693
<td class="parameter_annotations"> </td>
697
<div class="refsect3">
698
<a name="id-1.4.3.7.15.6"></a><h4>Returns</h4>
699
<p> the context key, which is owned by <em class="parameter"><code>key</code></em>
700
and should not be modified.</p>
703
<p class="since">Since 1.24</p>
706
<div class="refsect2">
707
<a name="pango-fc-font-key-get-matrix"></a><h3>pango_fc_font_key_get_matrix ()</h3>
708
<pre class="programlisting">const <a class="link" href="pango-Glyph-Storage.html#PangoMatrix"><span class="returnvalue">PangoMatrix</span></a> *
709
pango_fc_font_key_get_matrix (<em class="parameter"><code>const <a class="link" href="PangoFcFontMap.html#PangoFcFontKey" title="PangoFcFontKey"><span class="type">PangoFcFontKey</span></a> *key</code></em>);</pre>
710
<p>Gets the matrix member of <em class="parameter"><code>key</code></em>
712
<div class="refsect3">
713
<a name="id-1.4.3.7.16.5"></a><h4>Parameters</h4>
714
<div class="informaltable"><table width="100%" border="0">
716
<col width="150px" class="parameters_name">
717
<col class="parameters_description">
718
<col width="200px" class="parameters_annotations">
721
<td class="parameter_name"><p>key</p></td>
722
<td class="parameter_description"><p>the font key</p></td>
723
<td class="parameter_annotations"> </td>
727
<div class="refsect3">
728
<a name="id-1.4.3.7.16.6"></a><h4>Returns</h4>
729
<p> the matrix, which is owned by <em class="parameter"><code>key</code></em>
730
and should not be modified.</p>
733
<p class="since">Since 1.24</p>
736
<div class="refsect2">
737
<a name="pango-fc-font-key-get-pattern"></a><h3>pango_fc_font_key_get_pattern ()</h3>
738
<pre class="programlisting">const <span class="returnvalue">FcPattern</span> *
739
pango_fc_font_key_get_pattern (<em class="parameter"><code>const <a class="link" href="PangoFcFontMap.html#PangoFcFontKey" title="PangoFcFontKey"><span class="type">PangoFcFontKey</span></a> *key</code></em>);</pre>
740
<p>Gets the fontconfig pattern member of <em class="parameter"><code>key</code></em>
742
<div class="refsect3">
743
<a name="id-1.4.3.7.17.5"></a><h4>Parameters</h4>
744
<div class="informaltable"><table width="100%" border="0">
746
<col width="150px" class="parameters_name">
747
<col class="parameters_description">
748
<col width="200px" class="parameters_annotations">
751
<td class="parameter_name"><p>key</p></td>
752
<td class="parameter_description"><p>the font key</p></td>
753
<td class="parameter_annotations"> </td>
757
<div class="refsect3">
758
<a name="id-1.4.3.7.17.6"></a><h4>Returns</h4>
759
<p> the pattern, which is owned by <em class="parameter"><code>key</code></em>
760
and should not be modified.</p>
763
<p class="since">Since 1.24</p>
766
<div class="refsect1">
767
<a name="PangoFcFontMap.other_details"></a><h2>Types and Values</h2>
102
768
<div class="refsect2">
103
769
<a name="PangoFcFontMap-struct"></a><h3>struct PangoFcFontMap</h3>
104
770
<pre class="programlisting">struct PangoFcFontMap;</pre>
106
<a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a> is a base class for font map implementations
771
<p><a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a> is a base class for font map implementations
107
772
using the Fontconfig and FreeType libraries. To create a new
108
773
backend using Fontconfig and FreeType, you derive from this class
109
774
and implement a <code class="function">new_font()</code> virtual function that creates an
142
807
PangoFcFontKey *fontkey);
146
Class structure for <a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a>.</p>
147
<div class="variablelist"><table border="0" class="variablelist">
810
<p>Class structure for <a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a>.</p>
811
<div class="refsect3">
812
<a name="id-1.4.3.8.3.5"></a><h4>Members</h4>
813
<div class="informaltable"><table width="100%" border="0">
149
<col align="left" valign="top">
815
<col width="300px" class="struct_members_name">
816
<col class="struct_members_description">
817
<col width="200px" class="struct_members_annotations">
154
<td><p><span class="term"><em class="structfield"><code><a name="PangoFcFontMapClass.default-substitute"></a>default_substitute</code></em> ()</span></p></td>
155
<td>Substitutes in default values for
821
<td class="struct_member_name"><p><em class="structfield"><code><a name="PangoFcFontMapClass.default-substitute"></a>default_substitute</code></em> ()</p></td>
822
<td class="struct_member_description"><p>Substitutes in default values for
156
823
unspecified fields in a <span class="type">FcPattern</span>. This will be called
157
824
prior to creating a font for the pattern. May be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
158
Deprecated in favor of <em class="parameter"><code><code class="function">font_key_substitute()</code></code></em>.</td>
825
Deprecated in favor of <em class="parameter"><code><code class="function">font_key_substitute()</code></code></em>
827
<td class="struct_member_annotations"> </td>
161
<td><p><span class="term"><em class="structfield"><code><a name="PangoFcFontMapClass.new-font"></a>new_font</code></em> ()</span></p></td>
162
<td>Creates a new <a class="link" href="PangoFcFont.html" title="PangoFcFont"><span class="type">PangoFcFont</span></a> for the specified
830
<td class="struct_member_name"><p><em class="structfield"><code><a name="PangoFcFontMapClass.new-font"></a>new_font</code></em> ()</p></td>
831
<td class="struct_member_description"><p>Creates a new <a class="link" href="PangoFcFont.html" title="PangoFcFont"><span class="type">PangoFcFont</span></a> for the specified
163
832
pattern of the appropriate type for this font map. The
164
<em class="parameter"><code>pattern</code></em> argument must be passed to the "pattern" property
833
<em class="parameter"><code>pattern</code></em>
834
argument must be passed to the "pattern" property
165
835
of <a class="link" href="PangoFcFont.html" title="PangoFcFont"><span class="type">PangoFcFont</span></a> when you call <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-new"><code class="function">g_object_new()</code></a>. Deprecated
166
in favor of <em class="parameter"><code><code class="function">create_font()</code></code></em>.</td>
836
in favor of <em class="parameter"><code><code class="function">create_font()</code></code></em>
838
<td class="struct_member_annotations"> </td>
169
<td><p><span class="term"><em class="structfield"><code><a name="PangoFcFontMapClass.get-resolution"></a>get_resolution</code></em> ()</span></p></td>
170
<td>Gets the resolution (the scale factor
841
<td class="struct_member_name"><p><em class="structfield"><code><a name="PangoFcFontMapClass.get-resolution"></a>get_resolution</code></em> ()</p></td>
842
<td class="struct_member_description"><p>Gets the resolution (the scale factor
171
843
between logical and absolute font sizes) that the backend
172
844
will use for a particular fontmap and context. <em class="parameter"><code>context</code></em>
845
may be null.</p></td>
846
<td class="struct_member_annotations"> </td>
176
<td><p><span class="term"><em class="structfield"><code><a name="PangoFcFontMapClass.context-key-get"></a>context_key_get</code></em> ()</span></p></td>
177
<td>Gets an opaque key holding backend
849
<td class="struct_member_name"><p><em class="structfield"><code><a name="PangoFcFontMapClass.context-key-get"></a>context_key_get</code></em> ()</p></td>
850
<td class="struct_member_description"><p>Gets an opaque key holding backend
178
851
specific options for the context that will affect
179
fonts created by <em class="parameter"><code><code class="function">create_font()</code></code></em>. The result must point to
852
fonts created by <em class="parameter"><code><code class="function">create_font()</code></code></em>
853
. The result must point to
180
854
persistant storage owned by the fontmap. This key
181
855
is used to index hash tables used to look up fontsets
857
<td class="struct_member_annotations"> </td>
185
<td><p><span class="term"><em class="structfield"><code><a name="PangoFcFontMapClass.context-key-copy"></a>context_key_copy</code></em> ()</span></p></td>
186
<td>Copies a context key. Pango uses this
860
<td class="struct_member_name"><p><em class="structfield"><code><a name="PangoFcFontMapClass.context-key-copy"></a>context_key_copy</code></em> ()</p></td>
861
<td class="struct_member_description"><p>Copies a context key. Pango uses this
187
862
to make a persistant copy of the value returned from
188
<em class="parameter"><code>context_key_get</code></em>.</td>
191
<td><p><span class="term"><em class="structfield"><code><a name="PangoFcFontMapClass.context-key-free"></a>context_key_free</code></em> ()</span></p></td>
192
<td>Frees a context key copied with
193
<em class="parameter"><code>context_key_copy</code></em>.</td>
196
<td><p><span class="term"><em class="structfield"><code><a name="PangoFcFontMapClass.context-key-hash"></a>context_key_hash</code></em> ()</span></p></td>
197
<td>Gets a hash value for a context key</td>
200
<td><p><span class="term"><em class="structfield"><code><a name="PangoFcFontMapClass.context-key-equal"></a>context_key_equal</code></em> ()</span></p></td>
201
<td>Compares two context keys for equality.</td>
204
<td><p><span class="term"><em class="structfield"><code><a name="PangoFcFontMapClass.fontset-key-substitute"></a>fontset_key_substitute</code></em> ()</span></p></td>
205
<td>Substitutes in default values for
863
<em class="parameter"><code>context_key_get</code></em>
865
<td class="struct_member_annotations"> </td>
868
<td class="struct_member_name"><p><em class="structfield"><code><a name="PangoFcFontMapClass.context-key-free"></a>context_key_free</code></em> ()</p></td>
869
<td class="struct_member_description"><p>Frees a context key copied with
870
<em class="parameter"><code>context_key_copy</code></em>
872
<td class="struct_member_annotations"> </td>
875
<td class="struct_member_name"><p><em class="structfield"><code><a name="PangoFcFontMapClass.context-key-hash"></a>context_key_hash</code></em> ()</p></td>
876
<td class="struct_member_description"><p>Gets a hash value for a context key</p></td>
877
<td class="struct_member_annotations"> </td>
880
<td class="struct_member_name"><p><em class="structfield"><code><a name="PangoFcFontMapClass.context-key-equal"></a>context_key_equal</code></em> ()</p></td>
881
<td class="struct_member_description"><p>Compares two context keys for equality.</p></td>
882
<td class="struct_member_annotations"> </td>
885
<td class="struct_member_name"><p><em class="structfield"><code><a name="PangoFcFontMapClass.fontset-key-substitute"></a>fontset_key_substitute</code></em> ()</p></td>
886
<td class="struct_member_description"><p>Substitutes in default values for
206
887
unspecified fields in a <span class="type">FcPattern</span>. This will be called
207
888
prior to creating a font for the pattern. May be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
889
(Since: 1.24)</p></td>
890
<td class="struct_member_annotations"> </td>
211
<td><p><span class="term"><em class="structfield"><code><a name="PangoFcFontMapClass.create-font"></a>create_font</code></em> ()</span></p></td>
212
<td>Creates a new <a class="link" href="PangoFcFont.html" title="PangoFcFont"><span class="type">PangoFcFont</span></a> for the specified
893
<td class="struct_member_name"><p><em class="structfield"><code><a name="PangoFcFontMapClass.create-font"></a>create_font</code></em> ()</p></td>
894
<td class="struct_member_description"><p>Creates a new <a class="link" href="PangoFcFont.html" title="PangoFcFont"><span class="type">PangoFcFont</span></a> for the specified
213
895
pattern of the appropriate type for this font map using
214
896
information from the font key that is passed in. The
215
<em class="parameter"><code>pattern</code></em> member of <em class="parameter"><code>font_key</code></em> can be retrieved using
216
<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
897
<em class="parameter"><code>pattern</code></em>
898
member of <em class="parameter"><code>font_key</code></em>
899
can be retrieved using
900
<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
217
901
the "pattern" property of <a class="link" href="PangoFcFont.html" title="PangoFcFont"><span class="type">PangoFcFont</span></a> when you call
218
902
<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-new"><code class="function">g_object_new()</code></a>. If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, <code class="function">new_font()</code> is used.
225
<div class="refsect2">
226
<a name="pango-fc-font-map-create-context"></a><h3>pango_fc_font_map_create_context ()</h3>
227
<pre class="programlisting"><a class="link" href="pango-Text-Processing.html#PangoContext"><span class="returnvalue">PangoContext</span></a> * pango_fc_font_map_create_context (<em class="parameter"><code><a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a> *fcfontmap</code></em>);</pre>
228
<div class="warning">
229
<h3 class="title">Warning</h3>
230
<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>
233
Creates a new context for this fontmap. This function is intended
234
only for backend implementations deriving from <a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a>;
235
it is possible that a backend will store additional information
236
needed for correct operation on the <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> after calling
238
<div class="variablelist"><table border="0" class="variablelist">
240
<col align="left" valign="top">
245
<td><p><span class="term"><em class="parameter"><code>fcfontmap</code></em> :</span></p></td>
246
<td>a <a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a>
250
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
251
<td>a new <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>
256
<p class="since">Since 1.4</p>
259
<div class="refsect2">
260
<a name="PangoFcDecoderFindFunc"></a><h3>PangoFcDecoderFindFunc ()</h3>
261
<pre class="programlisting"><a class="link" href="PangoFcDecoder.html" title="PangoFcDecoder"><span class="returnvalue">PangoFcDecoder</span></a> * (*PangoFcDecoderFindFunc) (<em class="parameter"><code><span class="type">FcPattern</span> *pattern</code></em>,
262
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
264
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>
265
<div class="variablelist"><table border="0" class="variablelist">
267
<col align="left" valign="top">
272
<td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
273
<td>a fully resolved <span class="type">FcPattern</span> specifying the font on the system</td>
276
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
277
<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>
281
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
282
<td>a new reference to a custom decoder for this pattern,
283
or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the default decoder handling should be used.</td>
289
<div class="refsect2">
290
<a name="pango-fc-font-map-add-decoder-find-func"></a><h3>pango_fc_font_map_add_decoder_find_func ()</h3>
291
<pre class="programlisting"><span class="returnvalue">void</span> pango_fc_font_map_add_decoder_find_func
292
(<em class="parameter"><code><a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a> *fcfontmap</code></em>,
293
<em class="parameter"><code><a class="link" href="PangoFcFontMap.html#PangoFcDecoderFindFunc" title="PangoFcDecoderFindFunc ()"><span class="type">PangoFcDecoderFindFunc</span></a> findfunc</code></em>,
294
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
295
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> dnotify</code></em>);</pre>
297
This function saves a callback method in the <a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a> that
298
will be called whenever new fonts are created. If the
299
function returns a <a class="link" href="PangoFcDecoder.html" title="PangoFcDecoder"><span class="type">PangoFcDecoder</span></a>, that decoder will be used to
300
determine both coverage via a <span class="type">FcCharSet</span> and a one-to-one mapping of
301
characters to glyphs. This will allow applications to have
302
application-specific encodings for various fonts.</p>
303
<div class="variablelist"><table border="0" class="variablelist">
305
<col align="left" valign="top">
310
<td><p><span class="term"><em class="parameter"><code>fcfontmap</code></em> :</span></p></td>
311
<td>The <a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a> to add this method to.</td>
314
<td><p><span class="term"><em class="parameter"><code>findfunc</code></em> :</span></p></td>
315
<td>The <a class="link" href="PangoFcFontMap.html#PangoFcDecoderFindFunc" title="PangoFcDecoderFindFunc ()"><span class="type">PangoFcDecoderFindFunc</span></a> callback function</td>
318
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
322
<td><p><span class="term"><em class="parameter"><code>dnotify</code></em> :</span></p></td>
323
<td>A <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> callback that will be called when the
324
fontmap is finalized and the decoder is released.</td>
328
<p class="since">Since 1.6</p>
331
<div class="refsect2">
332
<a name="pango-fc-font-map-find-decoder"></a><h3>pango_fc_font_map_find_decoder ()</h3>
333
<pre class="programlisting"><a class="link" href="PangoFcDecoder.html" title="PangoFcDecoder"><span class="returnvalue">PangoFcDecoder</span></a> * pango_fc_font_map_find_decoder (<em class="parameter"><code><a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a> *fcfontmap</code></em>,
334
<em class="parameter"><code><span class="type">FcPattern</span> *pattern</code></em>);</pre>
336
Finds the decoder to use for <em class="parameter"><code>pattern</code></em>. Decoders can be added to
337
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>
338
<div class="variablelist"><table border="0" class="variablelist">
340
<col align="left" valign="top">
345
<td><p><span class="term"><em class="parameter"><code>fcfontmap</code></em> :</span></p></td>
346
<td>The <a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a> to use.</td>
349
<td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
350
<td>The <span class="type">FcPattern</span> to find the decoder for.</td>
353
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
354
<td>a newly created <a class="link" href="PangoFcDecoder.html" title="PangoFcDecoder"><span class="type">PangoFcDecoder</span></a> object or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
355
no decoder is set for <em class="parameter"><code>pattern</code></em>.</td>
359
<p class="since">Since 1.26</p>
362
<div class="refsect2">
363
<a name="pango-fc-font-map-cache-clear"></a><h3>pango_fc_font_map_cache_clear ()</h3>
364
<pre class="programlisting"><span class="returnvalue">void</span> pango_fc_font_map_cache_clear (<em class="parameter"><code><a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a> *fcfontmap</code></em>);</pre>
366
Clear all cached information and fontsets for this font map;
367
this should be called whenever there is a change in the
368
output of the <code class="function">default_substitute()</code> virtual function of the
369
font map, or if fontconfig has been reinitialized to new
371
<div class="variablelist"><table border="0" class="variablelist">
373
<col align="left" valign="top">
377
<td><p><span class="term"><em class="parameter"><code>fcfontmap</code></em> :</span></p></td>
378
<td>a <a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a>
382
<p class="since">Since 1.4</p>
385
<div class="refsect2">
386
<a name="pango-fc-font-map-shutdown"></a><h3>pango_fc_font_map_shutdown ()</h3>
387
<pre class="programlisting"><span class="returnvalue">void</span> pango_fc_font_map_shutdown (<em class="parameter"><code><a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a> *fcfontmap</code></em>);</pre>
389
Clears all cached information for the fontmap and marks
390
all fonts open for the fontmap as dead. (See the <code class="function">shutdown()</code>
391
virtual function of <a class="link" href="PangoFcFont.html" title="PangoFcFont"><span class="type">PangoFcFont</span></a>.) This function might be used
392
by a backend when the underlying windowing system for the font
393
map exits. This function is only intended to be called
394
only for backend implementations deriving from <a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a>.</p>
395
<div class="variablelist"><table border="0" class="variablelist">
397
<col align="left" valign="top">
401
<td><p><span class="term"><em class="parameter"><code>fcfontmap</code></em> :</span></p></td>
402
<td>a <a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a>
406
<p class="since">Since 1.4</p>
409
<div class="refsect2">
410
<a name="pango-fc-font-description-from-pattern"></a><h3>pango_fc_font_description_from_pattern ()</h3>
411
<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> * pango_fc_font_description_from_pattern
412
(<em class="parameter"><code><span class="type">FcPattern</span> *pattern</code></em>,
413
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> include_size</code></em>);</pre>
415
Creates a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> that matches the specified
416
Fontconfig pattern as closely as possible. Many possible Fontconfig
417
pattern values, such as <code class="literal">FC_RASTERIZER</code> or <code class="literal">FC_DPI</code>, don't make sense in
418
the context of <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>, so will be ignored.</p>
419
<div class="variablelist"><table border="0" class="variablelist">
421
<col align="left" valign="top">
426
<td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
427
<td>a <span class="type">FcPattern</span>
431
<td><p><span class="term"><em class="parameter"><code>include_size</code></em> :</span></p></td>
432
<td>if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, the pattern will include the size from
433
the <em class="parameter"><code>pattern</code></em>; otherwise the resulting pattern will be unsized.
434
(only <code class="literal">FC_SIZE</code> is examined, not <code class="literal">FC_PIXEL_SIZE</code>)</td>
437
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
438
<td>a new <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>. Free with
439
<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>.</td>
443
<p class="since">Since 1.4</p>
903
(Since: 1.24)</p></td>
904
<td class="struct_member_annotations"> </td>
446
911
<div class="refsect2">
447
912
<a name="PANGO-FC-FONT-FEATURES:CAPS"></a><h3>PANGO_FC_FONT_FEATURES</h3>
448
913
<pre class="programlisting">#define PANGO_FC_FONT_FEATURES "fontfeatures"
451
String representing a fontconfig property name that Pango reads from font
915
<p>String representing a fontconfig property name that Pango reads from font
452
916
patterns to populate list of OpenType features to be enabled for the font
455
The property will have a number of string elements, each of which is the
918
<p>The property will have a number of string elements, each of which is the
456
919
OpenType feature tag of one feature to enable.</p>
458
This is equivalent to FC_FONT_FEATURES in versions of fontconfig that have that.</p>
920
<p>This is equivalent to FC_FONT_FEATURES in versions of fontconfig that have that.</p>
459
921
<p class="since">Since 1.34</p>
494
952
<a name="PANGO-FC-PRGNAME:CAPS"></a><h3>PANGO_FC_PRGNAME</h3>
495
953
<pre class="programlisting">#define PANGO_FC_PRGNAME "prgname"
498
String representing a fontconfig property name that Pango sets on any
955
<p>String representing a fontconfig property name that Pango sets on any
499
956
fontconfig pattern it passes to fontconfig.</p>
501
The property will have a string equal to what
957
<p>The property will have a string equal to what
502
958
<a href="http://library.gnome.org/devel/glib/unstable/glib-Miscellaneous-Utility-Functions.html#g-get-prgname"><code class="function">g_get_prgname()</code></a> returns.
503
959
This can be used to write fontconfig configuration rules that only affect
504
960
certain applications.</p>
506
This is equivalent to FC_PRGNAME in versions of fontconfig that have that.</p>
961
<p>This is equivalent to FC_PRGNAME in versions of fontconfig that have that.</p>
507
962
<p class="since">Since 1.24</p>
510
965
<div class="refsect2">
511
966
<a name="PangoFcFontsetKey"></a><h3>PangoFcFontsetKey</h3>
512
967
<pre class="programlisting">typedef struct _PangoFcFontsetKey PangoFcFontsetKey;</pre>
514
An opaque structure containing all the information needed for
968
<p>An opaque structure containing all the information needed for
515
969
loading a fontset with the PangoFc fontmap.</p>
516
970
<p class="since">Since 1.24</p>
519
973
<div class="refsect2">
520
<a name="pango-fc-fontset-key-get-context-key"></a><h3>pango_fc_fontset_key_get_context_key ()</h3>
521
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> pango_fc_fontset_key_get_context_key
522
(<em class="parameter"><code>const <a class="link" href="PangoFcFontMap.html#PangoFcFontsetKey" title="PangoFcFontsetKey"><span class="type">PangoFcFontsetKey</span></a> *key</code></em>);</pre>
524
Gets the context key member of <em class="parameter"><code>key</code></em>.</p>
525
<div class="variablelist"><table border="0" class="variablelist">
527
<col align="left" valign="top">
532
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
533
<td>the font key</td>
536
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
537
<td>the context key, which is owned by <em class="parameter"><code>key</code></em> and should not be modified.</td>
541
<p class="since">Since 1.24</p>
544
<div class="refsect2">
545
<a name="pango-fc-fontset-key-get-description"></a><h3>pango_fc_fontset_key_get_description ()</h3>
546
<pre class="programlisting">const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> * pango_fc_fontset_key_get_description
547
(<em class="parameter"><code>const <a class="link" href="PangoFcFontMap.html#PangoFcFontsetKey" title="PangoFcFontsetKey"><span class="type">PangoFcFontsetKey</span></a> *key</code></em>);</pre>
549
Gets the font description of <em class="parameter"><code>key</code></em>.</p>
550
<div class="variablelist"><table border="0" class="variablelist">
552
<col align="left" valign="top">
557
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
558
<td>the fontset key</td>
561
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
562
<td>the font description, which is owned by <em class="parameter"><code>key</code></em> and should not be modified.</td>
566
<p class="since">Since 1.24</p>
569
<div class="refsect2">
570
<a name="pango-fc-fontset-key-get-language"></a><h3>pango_fc_fontset_key_get_language ()</h3>
571
<pre class="programlisting"><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="returnvalue">PangoLanguage</span></a> * pango_fc_fontset_key_get_language (<em class="parameter"><code>const <a class="link" href="PangoFcFontMap.html#PangoFcFontsetKey" title="PangoFcFontsetKey"><span class="type">PangoFcFontsetKey</span></a> *key</code></em>);</pre>
573
Gets the language member of <em class="parameter"><code>key</code></em>.</p>
574
<div class="variablelist"><table border="0" class="variablelist">
576
<col align="left" valign="top">
581
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
582
<td>the fontset key</td>
585
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
586
<td>the language</td>
590
<p class="since">Since 1.24</p>
593
<div class="refsect2">
594
<a name="pango-fc-fontset-key-get-matrix"></a><h3>pango_fc_fontset_key_get_matrix ()</h3>
595
<pre class="programlisting">const <a class="link" href="pango-Glyph-Storage.html#PangoMatrix"><span class="returnvalue">PangoMatrix</span></a> * pango_fc_fontset_key_get_matrix (<em class="parameter"><code>const <a class="link" href="PangoFcFontMap.html#PangoFcFontsetKey" title="PangoFcFontsetKey"><span class="type">PangoFcFontsetKey</span></a> *key</code></em>);</pre>
597
Gets the matrix member of <em class="parameter"><code>key</code></em>.</p>
598
<div class="variablelist"><table border="0" class="variablelist">
600
<col align="left" valign="top">
605
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
606
<td>the fontset key</td>
609
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
610
<td>the matrix, which is owned by <em class="parameter"><code>key</code></em> and should not be modified.</td>
614
<p class="since">Since 1.24</p>
617
<div class="refsect2">
618
<a name="pango-fc-fontset-key-get-absolute-size"></a><h3>pango_fc_fontset_key_get_absolute_size ()</h3>
619
<pre class="programlisting"><span class="returnvalue">double</span> pango_fc_fontset_key_get_absolute_size
620
(<em class="parameter"><code>const <a class="link" href="PangoFcFontMap.html#PangoFcFontsetKey" title="PangoFcFontsetKey"><span class="type">PangoFcFontsetKey</span></a> *key</code></em>);</pre>
622
Gets the absolute font size of <em class="parameter"><code>key</code></em> in Pango units. This is adjusted
623
for both resolution and transformation matrix.</p>
624
<div class="variablelist"><table border="0" class="variablelist">
626
<col align="left" valign="top">
631
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
632
<td>the fontset key</td>
635
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
636
<td>the pixel size of <em class="parameter"><code>key</code></em>.</td>
640
<p class="since">Since 1.24</p>
643
<div class="refsect2">
644
<a name="pango-fc-fontset-key-get-resolution"></a><h3>pango_fc_fontset_key_get_resolution ()</h3>
645
<pre class="programlisting"><span class="returnvalue">double</span> pango_fc_fontset_key_get_resolution (<em class="parameter"><code>const <a class="link" href="PangoFcFontMap.html#PangoFcFontsetKey" title="PangoFcFontsetKey"><span class="type">PangoFcFontsetKey</span></a> *key</code></em>);</pre>
647
Gets the resolution of <em class="parameter"><code>key</code></em></p>
648
<div class="variablelist"><table border="0" class="variablelist">
650
<col align="left" valign="top">
655
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
656
<td>the fontset key</td>
659
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
660
<td>the resolution of <em class="parameter"><code>key</code></em>
665
<p class="since">Since 1.24</p>
668
<div class="refsect2">
669
974
<a name="PangoFcFontKey"></a><h3>PangoFcFontKey</h3>
670
975
<pre class="programlisting">typedef struct _PangoFcFontKey PangoFcFontKey;</pre>
672
An opaque structure containing all the information needed for
976
<p>An opaque structure containing all the information needed for
673
977
loading a font with the PangoFc fontmap.</p>
674
978
<p class="since">Since 1.24</p>
677
<div class="refsect2">
678
<a name="pango-fc-font-key-get-context-key"></a><h3>pango_fc_font_key_get_context_key ()</h3>
679
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> pango_fc_font_key_get_context_key (<em class="parameter"><code>const <a class="link" href="PangoFcFontMap.html#PangoFcFontKey" title="PangoFcFontKey"><span class="type">PangoFcFontKey</span></a> *key</code></em>);</pre>
681
Gets the context key member of <em class="parameter"><code>key</code></em>.</p>
682
<div class="variablelist"><table border="0" class="variablelist">
684
<col align="left" valign="top">
689
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
690
<td>the font key</td>
693
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
694
<td>the context key, which is owned by <em class="parameter"><code>key</code></em> and should not be modified.</td>
698
<p class="since">Since 1.24</p>
701
<div class="refsect2">
702
<a name="pango-fc-font-key-get-matrix"></a><h3>pango_fc_font_key_get_matrix ()</h3>
703
<pre class="programlisting">const <a class="link" href="pango-Glyph-Storage.html#PangoMatrix"><span class="returnvalue">PangoMatrix</span></a> * pango_fc_font_key_get_matrix (<em class="parameter"><code>const <a class="link" href="PangoFcFontMap.html#PangoFcFontKey" title="PangoFcFontKey"><span class="type">PangoFcFontKey</span></a> *key</code></em>);</pre>
705
Gets the matrix member of <em class="parameter"><code>key</code></em>.</p>
706
<div class="variablelist"><table border="0" class="variablelist">
708
<col align="left" valign="top">
713
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
714
<td>the font key</td>
717
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
718
<td>the matrix, which is owned by <em class="parameter"><code>key</code></em> and should not be modified.</td>
722
<p class="since">Since 1.24</p>
725
<div class="refsect2">
726
<a name="pango-fc-font-key-get-pattern"></a><h3>pango_fc_font_key_get_pattern ()</h3>
727
<pre class="programlisting">const <span class="returnvalue">FcPattern</span> * pango_fc_font_key_get_pattern (<em class="parameter"><code>const <a class="link" href="PangoFcFontMap.html#PangoFcFontKey" title="PangoFcFontKey"><span class="type">PangoFcFontKey</span></a> *key</code></em>);</pre>
729
Gets the fontconfig pattern member of <em class="parameter"><code>key</code></em>.</p>
730
<div class="variablelist"><table border="0" class="variablelist">
732
<col align="left" valign="top">
737
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
738
<td>the font key</td>
741
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
742
<td>the pattern, which is owned by <em class="parameter"><code>key</code></em> and should not be modified.</td>
746
<p class="since">Since 1.24</p>
749
981
<div class="refsect1">
750
982
<a name="PangoFcFontMap.see-also"></a><h2>See Also</h2>