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

« back to all changes in this revision

Viewing changes to docs/html/PangoFcFontMap.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastian Dröge
  • Date: 2009-09-09 07:49:30 UTC
  • mfrom: (1.6.1 upstream) (63.1.2 squeeze)
  • Revision ID: james.westby@ubuntu.com-20090909074930-zlgadwz6svi311vh
Tags: 1.25.6-1
New upstream development release.

Show diffs side-by-side

added added

removed removed

Lines of Context:
3
3
<head>
4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>PangoFcFontMap</title>
6
 
<meta name="generator" content="DocBook XSL Stylesheets V1.74.2">
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.74.3">
7
7
<link rel="home" href="index.html" title="Pango Reference Manual">
8
8
<link rel="up" href="lowlevel.html" title="Low Level Functionality">
9
9
<link rel="prev" href="PangoRenderer.html" title="PangoRenderer">
28
28
<link rel="index" href="index-1.18.html" title="Index of new symbols in 1.18">
29
29
<link rel="index" href="index-1.20.html" title="Index of new symbols in 1.20">
30
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">
31
33
</head>
32
34
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
33
35
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
63
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);
64
66
<a class="link" href="PangoFcDecoder.html" title="PangoFcDecoder">PangoFcDecoder</a> *    (<a class="link" href="PangoFcFontMap.html#PangoFcDecoderFindFunc" title="PangoFcDecoderFindFunc ()">*PangoFcDecoderFindFunc</a>)           (FcPattern *pattern,
65
67
                                                         <a
66
 
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
 
68
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
67
69
>gpointer</a> user_data);
68
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>
69
71
                                                        (<a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap">PangoFcFontMap</a> *fcfontmap,
70
72
                                                         <a class="link" href="PangoFcFontMap.html#PangoFcDecoderFindFunc" title="PangoFcDecoderFindFunc ()">PangoFcDecoderFindFunc</a> findfunc,
71
73
                                                         <a
72
 
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
 
74
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
73
75
>gpointer</a> user_data,
74
76
                                                         <a
75
 
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
 
77
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
76
78
>GDestroyNotify</a> dnotify);
77
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,
78
80
                                                         FcPattern *pattern);
81
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>
82
84
                                                        (FcPattern *pattern,
83
85
                                                         <a
84
 
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
 
86
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
85
87
>gboolean</a> include_size);
86
88
#define             <a class="link" href="PangoFcFontMap.html#PANGO-FC-GRAVITY--CAPS" title="PANGO_FC_GRAVITY">PANGO_FC_GRAVITY</a>
87
89
#define             <a class="link" href="PangoFcFontMap.html#PANGO-FC-VERSION--CAPS" title="PANGO_FC_VERSION">PANGO_FC_VERSION</a>
90
92
 
91
93
                    <a class="link" href="PangoFcFontMap.html#PangoFcFontsetKey" title="PangoFcFontsetKey">PangoFcFontsetKey</a>;
92
94
<a
93
 
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
 
95
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
94
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>
95
97
                                                        (const <a class="link" href="PangoFcFontMap.html#PangoFcFontsetKey" title="PangoFcFontsetKey">PangoFcFontsetKey</a> *key);
96
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>
102
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);
103
105
                    <a class="link" href="PangoFcFontMap.html#PangoFcFontKey" title="PangoFcFontKey">PangoFcFontKey</a>;
104
106
<a
105
 
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
 
107
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
106
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);
107
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);
108
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);
112
114
<a name="PangoFcFontMap.object-hierarchy"></a><h2>Object Hierarchy</h2>
113
115
<pre class="synopsis">
114
116
  <a
115
 
href="/home/behdad/.local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
 
117
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
116
118
>GObject</a>
117
119
   +----<a class="link" href="pango-Fonts.html#PangoFontMap">PangoFontMap</a>
118
120
         +----PangoFcFontMap
192
194
<td> Substitutes in default values for
193
195
 unspecified fields in a <span class="type">FcPattern</span>. This will be called
194
196
 prior to creating a font for the pattern. May be <a
195
 
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
 
197
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
196
198
><code class="literal">NULL</code></a>.
197
199
 Deprecated in favor of @<code class="function">font_key_substitute()</code>.
198
200
</td>
203
205
 pattern of the appropriate type for this font map. The
204
206
 <em class="parameter"><code>pattern</code></em> argument must be passed to the "pattern" property
205
207
 of <a class="link" href="PangoFcFont.html" title="PangoFcFont"><span class="type">PangoFcFont</span></a> when you call <a
206
 
href="/home/behdad/.local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-new"
 
208
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-new"
207
209
><code class="function">g_object_new()</code></a>. Deprecated
208
210
 in favor of @<code class="function">create_font()</code>.
209
211
</td>
254
256
<td> Substitutes in default values for
255
257
 unspecified fields in a <span class="type">FcPattern</span>. This will be called
256
258
 prior to creating a font for the pattern. May be <a
257
 
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
 
259
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
258
260
><code class="literal">NULL</code></a>.
259
261
 (Since: 1.24)
260
262
</td>
268
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
269
271
 the "pattern" property of <a class="link" href="PangoFcFont.html" title="PangoFcFont"><span class="type">PangoFcFont</span></a> when you call
270
272
 <a
271
 
href="/home/behdad/.local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-new"
 
273
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-new"
272
274
><code class="function">g_object_new()</code></a>.  If <a
273
 
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
 
275
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
274
276
><code class="literal">NULL</code></a>, <code class="function">new_font()</code> is used.
275
277
 (Since: 1.24)
276
278
</td>
317
319
<a name="PangoFcDecoderFindFunc"></a><h3>PangoFcDecoderFindFunc ()</h3>
318
320
<pre class="programlisting"><a class="link" href="PangoFcDecoder.html" title="PangoFcDecoder">PangoFcDecoder</a> *    (*PangoFcDecoderFindFunc)           (FcPattern *pattern,
319
321
                                                         <a
320
 
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
 
322
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
321
323
>gpointer</a> user_data);</pre>
322
324
<p>
323
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>
340
342
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
341
343
<td> a new reference to a custom decoder for this pattern,
342
344
 or <a
343
 
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
 
345
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
344
346
><code class="literal">NULL</code></a> if the default decoder handling should be used.
345
347
</td>
346
348
</tr>
354
356
                                                        (<a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap">PangoFcFontMap</a> *fcfontmap,
355
357
                                                         <a class="link" href="PangoFcFontMap.html#PangoFcDecoderFindFunc" title="PangoFcDecoderFindFunc ()">PangoFcDecoderFindFunc</a> findfunc,
356
358
                                                         <a
357
 
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
 
359
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
358
360
>gpointer</a> user_data,
359
361
                                                         <a
360
 
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
 
362
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
361
363
>GDestroyNotify</a> dnotify);</pre>
362
364
<p>
363
365
This function saves a callback method in the <a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a> that
389
391
<tr>
390
392
<td><p><span class="term"><em class="parameter"><code>dnotify</code></em> :</span></p></td>
391
393
<td> A <a
392
 
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
 
394
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
393
395
><span class="type">GDestroyNotify</span></a> callback that will be called when the
394
396
 fontmap is finalized and the decoder is released.
395
397
</td>
424
426
<tr>
425
427
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
426
428
<td> a newly created <a class="link" href="PangoFcDecoder.html" title="PangoFcDecoder"><span class="type">PangoFcDecoder</span></a> object or <a
427
 
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
 
429
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
428
430
><code class="literal">NULL</code></a> if
429
431
         no decoder is set for <em class="parameter"><code>pattern</code></em>.
430
432
 
485
487
<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription">PangoFontDescription</a> * pango_fc_font_description_from_pattern
486
488
                                                        (FcPattern *pattern,
487
489
                                                         <a
488
 
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
 
490
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
489
491
>gboolean</a> include_size);</pre>
490
492
<p>
491
493
Creates a <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a> that matches the specified
505
507
<tr>
506
508
<td><p><span class="term"><em class="parameter"><code>include_size</code></em> :</span></p></td>
507
509
<td> if <a
508
 
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE--CAPS"
 
510
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
509
511
><code class="literal">TRUE</code></a>, the pattern will include the size from
510
512
  the <em class="parameter"><code>pattern</code></em>; otherwise the resulting pattern will be unsized.
511
513
  (only <code class="literal">FC_SIZE</code> is examined, not <code class="literal">FC_PIXEL_SIZE</code>)
571
573
<p>
572
574
The property will have a string equal to what
573
575
<a
574
 
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Miscellaneous-Utility-Functions.html#g-get-prgname"
 
576
href="http://library.gnome.org/devel/glib/unstable/glib-Miscellaneous-Utility-Functions.html#g-get-prgname"
575
577
><code class="function">g_get_prgname()</code></a> returns.
576
578
This can be used to write fontconfig configuration rules that only affect
577
579
certain applications.</p>
594
596
<div class="refsect2" lang="en">
595
597
<a name="pango-fc-fontset-key-get-context-key"></a><h3>pango_fc_fontset_key_get_context_key ()</h3>
596
598
<pre class="programlisting"><a
597
 
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
 
599
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
598
600
>gpointer</a>            pango_fc_fontset_key_get_context_key
599
601
                                                        (const <a class="link" href="PangoFcFontMap.html#PangoFcFontsetKey" title="PangoFcFontsetKey">PangoFcFontsetKey</a> *key);</pre>
600
602
<p>
767
769
<div class="refsect2" lang="en">
768
770
<a name="pango-fc-font-key-get-context-key"></a><h3>pango_fc_font_key_get_context_key ()</h3>
769
771
<pre class="programlisting"><a
770
 
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
 
772
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
771
773
>gpointer</a>            pango_fc_font_key_get_context_key   (const <a class="link" href="PangoFcFontMap.html#PangoFcFontKey" title="PangoFcFontKey">PangoFcFontKey</a> *key);</pre>
772
774
<p>
773
775
Gets the context key member of <em class="parameter"><code>key</code></em>.</p>