~ubuntu-branches/ubuntu/feisty/pango1.0/feisty

« back to all changes in this revision

Viewing changes to docs/html/pango-Win32-Fonts-and-Rendering.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2007-04-10 00:59:24 UTC
  • mfrom: (20.1.23 feisty)
  • Revision ID: james.westby@ubuntu.com-20070410005924-bbuu8vi6fw9f1fn1
Tags: 1.16.2-0ubuntu1
* New upstream version
  - Fixed various bug in the OpenType Layout code
  - Improved documentation
  - Improved ATSUI backend
  - Misc build system fixes
  - Bugs fixed in this release:
    - pangowin32-fontmap.c:using function without prototype
    - Don't create coverage every time it's asked for

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=US-ASCII">
5
5
<title>Win32 Fonts and Rendering</title>
6
 
<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
7
7
<link rel="start" href="index.html" title="Pango Reference Manual">
8
8
<link rel="up" href="rendering.html" title="Rendering with Pango">
9
9
<link rel="prev" href="rendering.html" title="Rendering with Pango">
35
35
<th width="100%" align="center">Pango Reference Manual</th>
36
36
<td><a accesskey="n" href="pango-FreeType-Fonts-and-Rendering.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
37
37
</tr>
38
 
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id3107844" class="shortcut">Top</a>
 
38
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2697205" class="shortcut">Top</a>
39
39
                  &#160;|&#160;
40
 
                  <a href="#id3108475" class="shortcut">Description</a></nobr></td></tr>
 
40
                  <a href="#id2697918" class="shortcut">Description</a></nobr></td></tr>
41
41
</table>
42
42
<div class="refentry" lang="en">
43
43
<a name="pango-Win32-Fonts-and-Rendering"></a><div class="titlepage"></div>
44
44
<div class="refnamediv"><table width="100%"><tr>
45
45
<td valign="top">
46
46
<h2>
47
 
<a name="id3107844"></a><span class="refentrytitle">Win32 Fonts and Rendering</span>
 
47
<a name="id2697205"></a><span class="refentrytitle">Win32 Fonts and Rendering</span>
48
48
</h2>
49
49
<p>Win32 Fonts and Rendering &#8212; Functions for shape engines to manipulate Win32 fonts</p>
50
50
</td>
108
108
                                            (void);
109
109
void        <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-cache-free">pango_win32_font_cache_free</a>     (<a href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache">PangoWin32FontCache</a> *cache);
110
110
HFONT       <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-cache-load">pango_win32_font_cache_load</a>     (<a href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache">PangoWin32FontCache</a> *cache,
111
 
                                             const LOGFONT *logfont);
 
111
                                             const LOGFONTA *logfont);
 
112
HFONT       <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-cache-loadw">pango_win32_font_cache_loadw</a>    (<a href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache">PangoWin32FontCache</a> *cache,
 
113
                                             const LOGFONTW *logfont);
112
114
void        <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-cache-unload">pango_win32_font_cache_unload</a>   (<a href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache">PangoWin32FontCache</a> *cache,
113
115
                                             HFONT hfont);
114
116
<a href="pango-Fonts.html#PangoFontMap">PangoFontMap</a>* <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-map-for-display">pango_win32_font_map_for_display</a>
116
118
void        <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-shutdown-display">pango_win32_shutdown_display</a>    (void);
117
119
<a href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache">PangoWin32FontCache</a>* <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-map-get-font-cache">pango_win32_font_map_get_font_cache</a>
118
120
                                            (<a href="pango-Fonts.html#PangoFontMap">PangoFontMap</a> *font_map);
119
 
LOGFONT*    <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-logfont">pango_win32_font_logfont</a>        (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font);
 
121
LOGFONTA*   <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-logfont">pango_win32_font_logfont</a>        (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font);
 
122
LOGFONTW*   <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-logfontw">pango_win32_font_logfontw</a>       (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font);
120
123
<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a>* <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-description-from-logfont">pango_win32_font_description_from_logfont</a>
121
 
                                            (const LOGFONT *lfp);
 
124
                                            (const LOGFONTA *lfp);
 
125
<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a>* <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-description-from-logfontw">pango_win32_font_description_from_logfontw</a>
 
126
                                            (const LOGFONTW *lfp);
122
127
 
123
128
</pre>
124
129
</div>
125
130
<div class="refsect1" lang="en">
126
 
<a name="id3108475"></a><h2>Description</h2>
 
131
<a name="id2697918"></a><h2>Description</h2>
127
132
<p>
128
133
The macros and functions in this section are used to access fonts natively on
129
134
Win32 systems and to render text in conjunction with Win32 APIs.
130
135
</p>
131
136
</div>
132
137
<div class="refsect1" lang="en">
133
 
<a name="id3108492"></a><h2>Details</h2>
 
138
<a name="id2697935"></a><h2>Details</h2>
134
139
<div class="refsect2" lang="en">
135
 
<a name="id3108502"></a><h3>
 
140
<a name="id2697945"></a><h3>
136
141
<a name="PANGO-RENDER-TYPE-WIN32:CAPS"></a>PANGO_RENDER_TYPE_WIN32</h3>
137
 
<a class="indexterm" name="id3108516"></a><pre class="programlisting">#define PANGO_RENDER_TYPE_WIN32 "PangoRenderWin32"
 
142
<a class="indexterm" name="id2697959"></a><pre class="programlisting">#define PANGO_RENDER_TYPE_WIN32 "PangoRenderWin32"
138
143
</pre>
139
144
<p>
140
145
A string constant identifying the Win32 renderer. The associated quark (see
145
150
</div>
146
151
<hr>
147
152
<div class="refsect2" lang="en">
148
 
<a name="id3108558"></a><h3>
 
153
<a name="id2698001"></a><h3>
149
154
<a name="pango-win32-get-context"></a>pango_win32_get_context ()</h3>
150
 
<a class="indexterm" name="id3108572"></a><pre class="programlisting"><a href="pango-Text-Processing.html#PangoContext">PangoContext</a>* pango_win32_get_context       (void);</pre>
 
155
<a class="indexterm" name="id2698014"></a><pre class="programlisting"><a href="pango-Text-Processing.html#PangoContext">PangoContext</a>* pango_win32_get_context       (void);</pre>
151
156
<p>
152
157
Retrieves a <a href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> appropriate for rendering with Windows fonts.</p>
153
158
<p>
164
169
</div>
165
170
<hr>
166
171
<div class="refsect2" lang="en">
167
 
<a name="id3108629"></a><h3>
 
172
<a name="id2698071"></a><h3>
168
173
<a name="pango-win32-render"></a>pango_win32_render ()</h3>
169
 
<a class="indexterm" name="id3108642"></a><pre class="programlisting">void        pango_win32_render              (HDC hdc,
 
174
<a class="indexterm" name="id2698085"></a><pre class="programlisting">void        pango_win32_render              (HDC hdc,
170
175
                                             <a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
171
176
                                             <a href="pango-Glyph-Storage.html#PangoGlyphString">PangoGlyphString</a> *glyphs,
172
177
                                             <a
213
218
</div>
214
219
<hr>
215
220
<div class="refsect2" lang="en">
216
 
<a name="id3108788"></a><h3>
 
221
<a name="id2698230"></a><h3>
217
222
<a name="pango-win32-render-transformed"></a>pango_win32_render_transformed ()</h3>
218
 
<a class="indexterm" name="id3108801"></a><pre class="programlisting">void        pango_win32_render_transformed  (HDC hdc,
 
223
<a class="indexterm" name="id2698243"></a><pre class="programlisting">void        pango_win32_render_transformed  (HDC hdc,
219
224
                                             const <a href="pango-Glyph-Storage.html#PangoMatrix">PangoMatrix</a> *matrix,
220
225
                                             <a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
221
226
                                             <a href="pango-Glyph-Storage.html#PangoGlyphString">PangoGlyphString</a> *glyphs,
273
278
</div>
274
279
<hr>
275
280
<div class="refsect2" lang="en">
276
 
<a name="id3109013"></a><h3>
 
281
<a name="id2698455"></a><h3>
277
282
<a name="pango-win32-render-layout-line"></a>pango_win32_render_layout_line ()</h3>
278
 
<a class="indexterm" name="id3109026"></a><pre class="programlisting">void        pango_win32_render_layout_line  (HDC hdc,
 
283
<a class="indexterm" name="id2698468"></a><pre class="programlisting">void        pango_win32_render_layout_line  (HDC hdc,
279
284
                                             <a href="pango-Layout-Objects.html#PangoLayoutLine">PangoLayoutLine</a> *line,
280
285
                                             int x,
281
286
                                             int y);</pre>
314
319
</div>
315
320
<hr>
316
321
<div class="refsect2" lang="en">
317
 
<a name="id3109159"></a><h3>
 
322
<a name="id2698601"></a><h3>
318
323
<a name="pango-win32-render-layout"></a>pango_win32_render_layout ()</h3>
319
 
<a class="indexterm" name="id3109172"></a><pre class="programlisting">void        pango_win32_render_layout       (HDC hdc,
 
324
<a class="indexterm" name="id2698614"></a><pre class="programlisting">void        pango_win32_render_layout       (HDC hdc,
320
325
                                             <a href="pango-Layout-Objects.html#PangoLayout">PangoLayout</a> *layout,
321
326
                                             int x,
322
327
                                             int y);</pre>
353
358
</div>
354
359
<hr>
355
360
<div class="refsect2" lang="en">
356
 
<a name="id3109302"></a><h3>
 
361
<a name="id2698744"></a><h3>
357
362
<a name="pango-win32-get-unknown-glyph"></a>pango_win32_get_unknown_glyph ()</h3>
358
 
<a class="indexterm" name="id3109318"></a><pre class="programlisting"><a href="pango-Glyph-Storage.html#PangoGlyph">PangoGlyph</a>  pango_win32_get_unknown_glyph   (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
 
363
<a class="indexterm" name="id2698760"></a><pre class="programlisting"><a href="pango-Glyph-Storage.html#PangoGlyph">PangoGlyph</a>  pango_win32_get_unknown_glyph   (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
359
364
                                             <a
360
365
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Unicode-Manipulation.html#gunichar"
361
366
>gunichar</a> wc);</pre>
395
400
</div>
396
401
<hr>
397
402
<div class="refsect2" lang="en">
398
 
<a name="id3109448"></a><h3>
 
403
<a name="id2698891"></a><h3>
399
404
<a name="pango-win32-font-get-glyph-index"></a>pango_win32_font_get_glyph_index ()</h3>
400
 
<a class="indexterm" name="id3109462"></a><pre class="programlisting"><a
 
405
<a class="indexterm" name="id2698904"></a><pre class="programlisting"><a
401
406
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
402
407
>gint</a>        pango_win32_font_get_glyph_index
403
408
                                            (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
433
438
</div>
434
439
<hr>
435
440
<div class="refsect2" lang="en">
436
 
<a name="id3109570"></a><h3>
 
441
<a name="id2699012"></a><h3>
437
442
<a name="pango-win32-font-select-font"></a>pango_win32_font_select_font ()</h3>
438
 
<a class="indexterm" name="id3109584"></a><pre class="programlisting"><a
 
443
<a class="indexterm" name="id2699026"></a><pre class="programlisting"><a
439
444
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
440
445
>gboolean</a>    pango_win32_font_select_font    (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
441
446
                                             HDC hdc);</pre>
478
483
</div>
479
484
<hr>
480
485
<div class="refsect2" lang="en">
481
 
<a name="id3109738"></a><h3>
 
486
<a name="id2699181"></a><h3>
482
487
<a name="pango-win32-font-done-font"></a>pango_win32_font_done_font ()</h3>
483
 
<a class="indexterm" name="id3109752"></a><pre class="programlisting">void        pango_win32_font_done_font      (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font);</pre>
 
488
<a class="indexterm" name="id2699195"></a><pre class="programlisting">void        pango_win32_font_done_font      (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font);</pre>
484
489
<p>
485
490
Releases any resources allocated by <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-done-font"><code class="function">pango_win32_font_done_font()</code></a></p>
486
491
<p>
497
502
</div>
498
503
<hr>
499
504
<div class="refsect2" lang="en">
500
 
<a name="id3109820"></a><h3>
 
505
<a name="id2699262"></a><h3>
501
506
<a name="pango-win32-font-get-metrics-factor"></a>pango_win32_font_get_metrics_factor ()</h3>
502
 
<a class="indexterm" name="id3109834"></a><pre class="programlisting">double      pango_win32_font_get_metrics_factor
 
507
<a class="indexterm" name="id2699277"></a><pre class="programlisting">double      pango_win32_font_get_metrics_factor
503
508
                                            (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font);</pre>
504
509
<p>
505
510
Returns the scale factor from logical units in the coordinate
527
532
</div>
528
533
<hr>
529
534
<div class="refsect2" lang="en">
530
 
<a name="id3109917"></a><h3>
 
535
<a name="id2699359"></a><h3>
531
536
<a name="pango-win32-get-debug-flag"></a>pango_win32_get_debug_flag ()</h3>
532
 
<a class="indexterm" name="id3109933"></a><pre class="programlisting"><a
 
537
<a class="indexterm" name="id2699376"></a><pre class="programlisting"><a
533
538
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
534
539
>gboolean</a>    pango_win32_get_debug_flag      (void);</pre>
535
540
<p>
553
558
</div>
554
559
<hr>
555
560
<div class="refsect2" lang="en">
556
 
<a name="id3109988"></a><h3>
 
561
<a name="id2699430"></a><h3>
557
562
<a name="pango-win32-get-dc"></a>pango_win32_get_dc ()</h3>
558
 
<a class="indexterm" name="id3110001"></a><pre class="programlisting">HDC         pango_win32_get_dc              (void);</pre>
 
563
<a class="indexterm" name="id2699443"></a><pre class="programlisting">HDC         pango_win32_get_dc              (void);</pre>
559
564
<p>
560
565
Obtains a handle to the Windows device context that is used by Pango.</p>
561
566
<p>
572
577
</div>
573
578
<hr>
574
579
<div class="refsect2" lang="en">
575
 
<a name="id3110042"></a><h3>
 
580
<a name="id2699484"></a><h3>
576
581
<a name="PangoWin32FontCache"></a>PangoWin32FontCache</h3>
577
 
<a class="indexterm" name="id3110055"></a><pre class="programlisting">typedef struct _PangoWin32FontCache PangoWin32FontCache;</pre>
 
582
<a class="indexterm" name="id2699497"></a><pre class="programlisting">typedef struct _PangoWin32FontCache PangoWin32FontCache;</pre>
578
583
<p>
579
584
A <a href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache"><span class="type">PangoWin32FontCache</span></a> caches
580
585
HFONTs by their LOGFONT descriptions. 
582
587
</div>
583
588
<hr>
584
589
<div class="refsect2" lang="en">
585
 
<a name="id3110080"></a><h3>
 
590
<a name="id2699522"></a><h3>
586
591
<a name="pango-win32-font-cache-new"></a>pango_win32_font_cache_new ()</h3>
587
 
<a class="indexterm" name="id3110094"></a><pre class="programlisting"><a href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache">PangoWin32FontCache</a>* pango_win32_font_cache_new
 
592
<a class="indexterm" name="id2699536"></a><pre class="programlisting"><a href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache">PangoWin32FontCache</a>* pango_win32_font_cache_new
588
593
                                            (void);</pre>
589
594
<p>
590
595
Creates a font cache.</p>
603
608
</div>
604
609
<hr>
605
610
<div class="refsect2" lang="en">
606
 
<a name="id3110146"></a><h3>
 
611
<a name="id2699588"></a><h3>
607
612
<a name="pango-win32-font-cache-free"></a>pango_win32_font_cache_free ()</h3>
608
 
<a class="indexterm" name="id3110159"></a><pre class="programlisting">void        pango_win32_font_cache_free     (<a href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache">PangoWin32FontCache</a> *cache);</pre>
 
613
<a class="indexterm" name="id2699602"></a><pre class="programlisting">void        pango_win32_font_cache_free     (<a href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache">PangoWin32FontCache</a> *cache);</pre>
609
614
<p>
610
615
Frees a <a href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache"><span class="type">PangoWin32FontCache</span></a> and all associated memory. All fonts loaded
611
616
through this font cache will be freed along with the cache.</p>
623
628
</div>
624
629
<hr>
625
630
<div class="refsect2" lang="en">
626
 
<a name="id3110227"></a><h3>
 
631
<a name="id2699669"></a><h3>
627
632
<a name="pango-win32-font-cache-load"></a>pango_win32_font_cache_load ()</h3>
628
 
<a class="indexterm" name="id3110241"></a><pre class="programlisting">HFONT       pango_win32_font_cache_load     (<a href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache">PangoWin32FontCache</a> *cache,
629
 
                                             const LOGFONT *logfont);</pre>
630
 
<p>
631
 
Creates a HFONT from a LOGFONT. The
632
 
result may be newly loaded, or it may have been previously
633
 
stored</p>
634
 
<p>
635
 
 
636
 
</p>
637
 
<div class="variablelist"><table border="0">
638
 
<col align="left" valign="top">
639
 
<tbody>
640
 
<tr>
641
 
<td><span class="term"><em class="parameter"><code>cache</code></em>&#160;:</span></td>
642
 
<td> a <a href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache"><span class="type">PangoWin32FontCache</span></a>
643
 
</td>
644
 
</tr>
645
 
<tr>
646
 
<td><span class="term"><em class="parameter"><code>logfont</code></em>&#160;:</span></td>
647
 
<td> a pointer to a LOGFONT structure describing the font to load.
648
 
</td>
649
 
</tr>
650
 
<tr>
651
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
652
 
<td> The font structure, or <a
653
 
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
654
 
><code class="literal">NULL</code></a> if the font could
655
 
not be loaded. In order to free this structure, you must call
656
 
<a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-cache-unload"><code class="function">pango_win32_font_cache_unload()</code></a>.
657
 
</td>
658
 
</tr>
659
 
</tbody>
660
 
</table></div>
661
 
</div>
662
 
<hr>
663
 
<div class="refsect2" lang="en">
664
 
<a name="id3110356"></a><h3>
 
633
<a class="indexterm" name="id2699683"></a><pre class="programlisting">HFONT       pango_win32_font_cache_load     (<a href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache">PangoWin32FontCache</a> *cache,
 
634
                                             const LOGFONTA *logfont);</pre>
 
635
<p>
 
636
Creates a HFONT from a LOGFONTA. The
 
637
result may be newly loaded, or it may have been previously
 
638
stored</p>
 
639
<p>
 
640
 
 
641
</p>
 
642
<div class="variablelist"><table border="0">
 
643
<col align="left" valign="top">
 
644
<tbody>
 
645
<tr>
 
646
<td><span class="term"><em class="parameter"><code>cache</code></em>&#160;:</span></td>
 
647
<td> a <a href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache"><span class="type">PangoWin32FontCache</span></a>
 
648
</td>
 
649
</tr>
 
650
<tr>
 
651
<td><span class="term"><em class="parameter"><code>logfont</code></em>&#160;:</span></td>
 
652
<td> a pointer to a LOGFONTA structure describing the font to load.
 
653
</td>
 
654
</tr>
 
655
<tr>
 
656
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
657
<td> The font structure, or <a
 
658
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
 
659
><code class="literal">NULL</code></a> if the font could
 
660
not be loaded. In order to free this structure, you must call
 
661
<a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-cache-unload"><code class="function">pango_win32_font_cache_unload()</code></a>.
 
662
</td>
 
663
</tr>
 
664
</tbody>
 
665
</table></div>
 
666
</div>
 
667
<hr>
 
668
<div class="refsect2" lang="en">
 
669
<a name="id2699798"></a><h3>
 
670
<a name="pango-win32-font-cache-loadw"></a>pango_win32_font_cache_loadw ()</h3>
 
671
<a class="indexterm" name="id2699814"></a><pre class="programlisting">HFONT       pango_win32_font_cache_loadw    (<a href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache">PangoWin32FontCache</a> *cache,
 
672
                                             const LOGFONTW *logfont);</pre>
 
673
<p>
 
674
Creates a HFONT from a LOGFONTW. The
 
675
result may be newly loaded, or it may have been previously
 
676
stored</p>
 
677
<p>
 
678
 
 
679
</p>
 
680
<div class="variablelist"><table border="0">
 
681
<col align="left" valign="top">
 
682
<tbody>
 
683
<tr>
 
684
<td><span class="term"><em class="parameter"><code>cache</code></em>&#160;:</span></td>
 
685
<td> a <a href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache"><span class="type">PangoWin32FontCache</span></a>
 
686
</td>
 
687
</tr>
 
688
<tr>
 
689
<td><span class="term"><em class="parameter"><code>logfont</code></em>&#160;:</span></td>
 
690
<td> a pointer to a LOGFONTW structure describing the font to load.
 
691
</td>
 
692
</tr>
 
693
<tr>
 
694
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
695
<td> The font structure, or <a
 
696
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
 
697
><code class="literal">NULL</code></a> if the font could
 
698
not be loaded. In order to free this structure, you must call
 
699
<a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-cache-unload"><code class="function">pango_win32_font_cache_unload()</code></a>.
 
700
 
 
701
</td>
 
702
</tr>
 
703
</tbody>
 
704
</table></div>
 
705
<p>Since  1.16
 
706
</p>
 
707
</div>
 
708
<hr>
 
709
<div class="refsect2" lang="en">
 
710
<a name="id2699935"></a><h3>
665
711
<a name="pango-win32-font-cache-unload"></a>pango_win32_font_cache_unload ()</h3>
666
 
<a class="indexterm" name="id3110369"></a><pre class="programlisting">void        pango_win32_font_cache_unload   (<a href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache">PangoWin32FontCache</a> *cache,
 
712
<a class="indexterm" name="id2699948"></a><pre class="programlisting">void        pango_win32_font_cache_unload   (<a href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache">PangoWin32FontCache</a> *cache,
667
713
                                             HFONT hfont);</pre>
668
714
<p>
669
715
Frees a font structure previously loaded with <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-cache-load"><code class="function">pango_win32_font_cache_load()</code></a>.</p>
688
734
</div>
689
735
<hr>
690
736
<div class="refsect2" lang="en">
691
 
<a name="id3110461"></a><h3>
 
737
<a name="id2700040"></a><h3>
692
738
<a name="pango-win32-font-map-for-display"></a>pango_win32_font_map_for_display ()</h3>
693
 
<a class="indexterm" name="id3110474"></a><pre class="programlisting"><a href="pango-Fonts.html#PangoFontMap">PangoFontMap</a>* pango_win32_font_map_for_display
 
739
<a class="indexterm" name="id2700054"></a><pre class="programlisting"><a href="pango-Fonts.html#PangoFontMap">PangoFontMap</a>* pango_win32_font_map_for_display
694
740
                                            (void);</pre>
695
741
<p>
696
742
Returns a <span class="type">PangoWin32FontMap</span>. Font maps are cached and should
710
756
</div>
711
757
<hr>
712
758
<div class="refsect2" lang="en">
713
 
<a name="id3110546"></a><h3>
 
759
<a name="id2700125"></a><h3>
714
760
<a name="pango-win32-shutdown-display"></a>pango_win32_shutdown_display ()</h3>
715
 
<a class="indexterm" name="id3110560"></a><pre class="programlisting">void        pango_win32_shutdown_display    (void);</pre>
 
761
<a class="indexterm" name="id2700139"></a><pre class="programlisting">void        pango_win32_shutdown_display    (void);</pre>
716
762
<p>
717
763
Free cached resources.</p>
718
764
<p>
721
767
</div>
722
768
<hr>
723
769
<div class="refsect2" lang="en">
724
 
<a name="id3110585"></a><h3>
 
770
<a name="id2700164"></a><h3>
725
771
<a name="pango-win32-font-map-get-font-cache"></a>pango_win32_font_map_get_font_cache ()</h3>
726
 
<a class="indexterm" name="id3110599"></a><pre class="programlisting"><a href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache">PangoWin32FontCache</a>* pango_win32_font_map_get_font_cache
 
772
<a class="indexterm" name="id2700178"></a><pre class="programlisting"><a href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache">PangoWin32FontCache</a>* pango_win32_font_map_get_font_cache
727
773
                                            (<a href="pango-Fonts.html#PangoFontMap">PangoFontMap</a> *font_map);</pre>
728
774
<p>
729
775
Obtains the font cache associated with the given font map.</p>
748
794
</div>
749
795
<hr>
750
796
<div class="refsect2" lang="en">
751
 
<a name="id3110683"></a><h3>
 
797
<a name="id2700262"></a><h3>
752
798
<a name="pango-win32-font-logfont"></a>pango_win32_font_logfont ()</h3>
753
 
<a class="indexterm" name="id3110697"></a><pre class="programlisting">LOGFONT*    pango_win32_font_logfont        (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font);</pre>
754
 
<p>
755
 
Determine the LOGFONT struct for the specified font.</p>
756
 
<p>
757
 
 
758
 
</p>
759
 
<div class="variablelist"><table border="0">
760
 
<col align="left" valign="top">
761
 
<tbody>
762
 
<tr>
763
 
<td><span class="term"><em class="parameter"><code>font</code></em>&#160;:</span></td>
764
 
<td> a <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> which must be from the Win32 backend
765
 
</td>
766
 
</tr>
767
 
<tr>
768
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
769
 
<td> A newly allocated LOGFONT struct. It must be
770
 
freed with <a
771
 
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"
772
 
><code class="function">g_free()</code></a>.
773
 
</td>
774
 
</tr>
775
 
</tbody>
776
 
</table></div>
777
 
</div>
778
 
<hr>
779
 
<div class="refsect2" lang="en">
780
 
<a name="id3110777"></a><h3>
 
799
<a class="indexterm" name="id2700276"></a><pre class="programlisting">LOGFONTA*   pango_win32_font_logfont        (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font);</pre>
 
800
<p>
 
801
Determine the LOGFONTA struct for the specified font. Note that
 
802
Pango internally uses LOGFONTW structs, so if converting the UTF-16
 
803
face name in the LOGFONTW struct to system codepage fails, the
 
804
returned LOGFONTA will have an emppty face name. To get the
 
805
LOGFONTW of a PangoFont, use <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-logfontw"><code class="function">pango_win32_font_logfontw()</code></a>. It
 
806
is recommended to do that always even if you don't expect
 
807
to come across fonts with odd names.</p>
 
808
<p>
 
809
 
 
810
</p>
 
811
<div class="variablelist"><table border="0">
 
812
<col align="left" valign="top">
 
813
<tbody>
 
814
<tr>
 
815
<td><span class="term"><em class="parameter"><code>font</code></em>&#160;:</span></td>
 
816
<td> a <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> which must be from the Win32 backend
 
817
</td>
 
818
</tr>
 
819
<tr>
 
820
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
821
<td> A newly allocated LOGFONTA struct. It must be
 
822
freed with <a
 
823
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"
 
824
><code class="function">g_free()</code></a>.
 
825
</td>
 
826
</tr>
 
827
</tbody>
 
828
</table></div>
 
829
</div>
 
830
<hr>
 
831
<div class="refsect2" lang="en">
 
832
<a name="id2700372"></a><h3>
 
833
<a name="pango-win32-font-logfontw"></a>pango_win32_font_logfontw ()</h3>
 
834
<a class="indexterm" name="id2700389"></a><pre class="programlisting">LOGFONTW*   pango_win32_font_logfontw       (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font);</pre>
 
835
<p>
 
836
Determine the LOGFONTW struct for the specified font.</p>
 
837
<p>
 
838
 
 
839
</p>
 
840
<div class="variablelist"><table border="0">
 
841
<col align="left" valign="top">
 
842
<tbody>
 
843
<tr>
 
844
<td><span class="term"><em class="parameter"><code>font</code></em>&#160;:</span></td>
 
845
<td> a <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> which must be from the Win32 backend
 
846
</td>
 
847
</tr>
 
848
<tr>
 
849
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
850
<td> A newly allocated LOGFONTW struct. It must be
 
851
freed with <a
 
852
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"
 
853
><code class="function">g_free()</code></a>.
 
854
 
 
855
</td>
 
856
</tr>
 
857
</tbody>
 
858
</table></div>
 
859
<p>Since  1.16
 
860
</p>
 
861
</div>
 
862
<hr>
 
863
<div class="refsect2" lang="en">
 
864
<a name="id2700473"></a><h3>
781
865
<a name="pango-win32-font-description-from-logfont"></a>pango_win32_font_description_from_logfont ()</h3>
782
 
<a class="indexterm" name="id3110794"></a><pre class="programlisting"><a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a>* pango_win32_font_description_from_logfont
783
 
                                            (const LOGFONT *lfp);</pre>
 
866
<a class="indexterm" name="id2700491"></a><pre class="programlisting"><a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a>* pango_win32_font_description_from_logfont
 
867
                                            (const LOGFONTA *lfp);</pre>
784
868
<p>
785
 
Creates a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> that matches the specified LOGFONT.
 
869
Creates a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> that matches the specified LOGFONTA.
786
870
</p>
787
871
<p>
788
 
The face name, italicness and weight fields in the LOGFONT are used
 
872
The face name, italicness and weight fields in the LOGFONTA are used
789
873
to set up the resulting <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>. If the face name in
790
 
the LOGFONT contains non-ASCII characters the font is temporarily
 
874
the LOGFONTA contains non-ASCII characters the font is temporarily
791
875
loaded (using <code class="function">CreateFontIndirect()</code>) and an ASCII (usually English)
792
876
name for it is looked up from the font name tables in the font
793
877
data. If that doesn't work, the face name is converted from the
800
884
<tbody>
801
885
<tr>
802
886
<td><span class="term"><em class="parameter"><code>lfp</code></em>&#160;:</span></td>
803
 
<td> a LOGFONT
804
 
</td>
805
 
</tr>
806
 
<tr>
807
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
808
 
<td> the newly allocated <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>, which
809
 
 should be freed using <a href="pango-Fonts.html#pango-font-description-free"><code class="function">pango_font_description_free()</code></a>
810
 
 
811
 
</td>
812
 
</tr>
813
 
</tbody>
814
 
</table></div>
815
 
<p>Since  1.12
 
887
<td> a LOGFONTA
 
888
</td>
 
889
</tr>
 
890
<tr>
 
891
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
892
<td> the newly allocated <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>, which
 
893
 should be freed using <a href="pango-Fonts.html#pango-font-description-free"><code class="function">pango_font_description_free()</code></a>
 
894
 
 
895
</td>
 
896
</tr>
 
897
</tbody>
 
898
</table></div>
 
899
<p>Since  1.16
 
900
</p>
 
901
</div>
 
902
<hr>
 
903
<div class="refsect2" lang="en">
 
904
<a name="id2700618"></a><h3>
 
905
<a name="pango-win32-font-description-from-logfontw"></a>pango_win32_font_description_from_logfontw ()</h3>
 
906
<a class="indexterm" name="id2700634"></a><pre class="programlisting"><a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a>* pango_win32_font_description_from_logfontw
 
907
                                            (const LOGFONTW *lfp);</pre>
 
908
<p>
 
909
Creates a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> that matches the specified LOGFONTW.
 
910
</p>
 
911
<p>
 
912
The face name, italicness and weight fields in the LOGFONTW are used
 
913
to set up the resulting <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>. If the face name in
 
914
the LOGFONTW contains non-ASCII characters the font is temporarily
 
915
loaded (using <code class="function">CreateFontIndirect()</code>) and an ASCII (usually English)
 
916
name for it is looked up from the font name tables in the font
 
917
data. If that doesn't work, the face name is converted from UTF-16
 
918
to UTF-8 and that is used.</p>
 
919
<p>
 
920
 
 
921
</p>
 
922
<div class="variablelist"><table border="0">
 
923
<col align="left" valign="top">
 
924
<tbody>
 
925
<tr>
 
926
<td><span class="term"><em class="parameter"><code>lfp</code></em>&#160;:</span></td>
 
927
<td> a LOGFONTW
 
928
</td>
 
929
</tr>
 
930
<tr>
 
931
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
932
<td> the newly allocated <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>, which
 
933
 should be freed using <a href="pango-Fonts.html#pango-font-description-free"><code class="function">pango_font_description_free()</code></a>
 
934
 
 
935
</td>
 
936
</tr>
 
937
</tbody>
 
938
</table></div>
 
939
<p>Since  1.16
816
940
</p>
817
941
</div>
818
942
</div>