~ubuntu-branches/debian/sid/pango1.0/sid

« back to all changes in this revision

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

  • Committer: Package Import Robot
  • Author(s): Iain Lane
  • Date: 2014-03-20 18:01:45 UTC
  • mfrom: (1.9.3)
  • Revision ID: package-import@ubuntu.com-20140320180145-y2zs0pzp6390a6y9
Tags: 1.36.3-1
* Add xauth test-dep, needed for xvfb-run
* New upstream release
  - Fix builddir != srdir builds
    + Drop 0001-Fix-tests-for-builddir-srcdir-by-setting-G_TEST_-SRC.patch,
      which was a cherry-pick of this fix.
  - Avoid a crash when FT_Face is NULL
  - Update pango_color_parse docs

Show diffs side-by-side

added added

removed removed

Lines of Context:
8
8
<link rel="up" href="rendering.html" title="Rendering with Pango">
9
9
<link rel="prev" href="rendering.html" title="Rendering with Pango">
10
10
<link rel="next" href="pango-FreeType-Fonts-and-Rendering.html" title="FreeType Fonts and Rendering">
11
 
<meta name="generator" content="GTK-Doc V1.19.1 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.20.1 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
</head>
14
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
 
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
16
 
<td width="100%" align="left">
17
 
<a href="#" class="shortcut">Top</a>
18
 
                   | 
19
 
                  <a href="#pango-Win32-Fonts-and-Rendering.description" class="shortcut">Description</a>
 
15
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
 
16
<td width="100%" align="left" class="shortcuts">
 
17
<a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
 
18
                  <a href="#pango-Win32-Fonts-and-Rendering.description" class="shortcut">Description</a></span>
20
19
</td>
21
20
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
22
21
<td><a accesskey="u" href="rendering.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
30
29
<h2><span class="refentrytitle"><a name="pango-Win32-Fonts-and-Rendering.top_of_page"></a>Win32 Fonts and Rendering</span></h2>
31
30
<p>Win32 Fonts and Rendering — Functions for shape engines to manipulate Win32 fonts</p>
32
31
</td>
33
 
<td valign="top" align="right"></td>
 
32
<td class="gallery_image" valign="top" align="right"></td>
34
33
</tr></table></div>
35
 
<div class="refsynopsisdiv">
36
 
<a name="pango-Win32-Fonts-and-Rendering.synopsis"></a><h2>Synopsis</h2>
37
 
<pre class="synopsis">#define             <a class="link" href="pango-Win32-Fonts-and-Rendering.html#PANGO-RENDER-TYPE-WIN32:CAPS" title="PANGO_RENDER_TYPE_WIN32">PANGO_RENDER_TYPE_WIN32</a>
38
 
<a class="link" href="pango-Text-Processing.html#PangoContext"><span class="returnvalue">PangoContext</span></a> *      <a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-get-context" title="pango_win32_get_context ()">pango_win32_get_context</a>             (<em class="parameter"><code><span class="type">void</span></code></em>);
39
 
<span class="returnvalue">void</span>                <a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-render" title="pango_win32_render ()">pango_win32_render</a>                  (<em class="parameter"><code><span class="type">HDC</span> hdc</code></em>,
40
 
                                                         <em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,
41
 
                                                         <em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoGlyphString"><span class="type">PangoGlyphString</span></a> *glyphs</code></em>,
42
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x</code></em>,
43
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y</code></em>);
44
 
<span class="returnvalue">void</span>                <a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-render-transformed" title="pango_win32_render_transformed ()">pango_win32_render_transformed</a>      (<em class="parameter"><code><span class="type">HDC</span> hdc</code></em>,
45
 
                                                         <em class="parameter"><code>const <a class="link" href="pango-Glyph-Storage.html#PangoMatrix"><span class="type">PangoMatrix</span></a> *matrix</code></em>,
46
 
                                                         <em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,
47
 
                                                         <em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoGlyphString"><span class="type">PangoGlyphString</span></a> *glyphs</code></em>,
48
 
                                                         <em class="parameter"><code><span class="type">int</span> x</code></em>,
49
 
                                                         <em class="parameter"><code><span class="type">int</span> y</code></em>);
50
 
<span class="returnvalue">void</span>                <a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-render-layout-line" title="pango_win32_render_layout_line ()">pango_win32_render_layout_line</a>      (<em class="parameter"><code><span class="type">HDC</span> hdc</code></em>,
51
 
                                                         <em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayoutLine"><span class="type">PangoLayoutLine</span></a> *line</code></em>,
52
 
                                                         <em class="parameter"><code><span class="type">int</span> x</code></em>,
53
 
                                                         <em class="parameter"><code><span class="type">int</span> y</code></em>);
54
 
<span class="returnvalue">void</span>                <a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-render-layout" title="pango_win32_render_layout ()">pango_win32_render_layout</a>           (<em class="parameter"><code><span class="type">HDC</span> hdc</code></em>,
55
 
                                                         <em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> *layout</code></em>,
56
 
                                                         <em class="parameter"><code><span class="type">int</span> x</code></em>,
57
 
                                                         <em class="parameter"><code><span class="type">int</span> y</code></em>);
58
 
<a class="link" href="pango-Glyph-Storage.html#PangoGlyph" title="PangoGlyph"><span class="returnvalue">PangoGlyph</span></a>          <a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-get-unknown-glyph" title="pango_win32_get_unknown_glyph ()">pango_win32_get_unknown_glyph</a>       (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,
59
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#gunichar"><span class="type">gunichar</span></a> wc</code></em>);
60
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-get-glyph-index" title="pango_win32_font_get_glyph_index ()">pango_win32_font_get_glyph_index</a>    (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,
61
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#gunichar"><span class="type">gunichar</span></a> wc</code></em>);
62
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-select-font" title="pango_win32_font_select_font ()">pango_win32_font_select_font</a>        (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,
63
 
                                                         <em class="parameter"><code><span class="type">HDC</span> hdc</code></em>);
64
 
<span class="returnvalue">void</span>                <a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-done-font" title="pango_win32_font_done_font ()">pango_win32_font_done_font</a>          (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>);
65
 
<span class="returnvalue">double</span>              <a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-get-metrics-factor" title="pango_win32_font_get_metrics_factor ()">pango_win32_font_get_metrics_factor</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>);
66
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-get-debug-flag" title="pango_win32_get_debug_flag ()">pango_win32_get_debug_flag</a>          (<em class="parameter"><code><span class="type">void</span></code></em>);
67
 
<span class="returnvalue">HDC</span>                 <a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-get-dc" title="pango_win32_get_dc ()">pango_win32_get_dc</a>                  (<em class="parameter"><code><span class="type">void</span></code></em>);
68
 
                    <a class="link" href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache" title="PangoWin32FontCache">PangoWin32FontCache</a>;
69
 
<a class="link" href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache" title="PangoWin32FontCache"><span class="returnvalue">PangoWin32FontCache</span></a> * <a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-cache-new" title="pango_win32_font_cache_new ()">pango_win32_font_cache_new</a>        (<em class="parameter"><code><span class="type">void</span></code></em>);
70
 
<span class="returnvalue">void</span>                <a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-cache-free" title="pango_win32_font_cache_free ()">pango_win32_font_cache_free</a>         (<em class="parameter"><code><a class="link" href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache" title="PangoWin32FontCache"><span class="type">PangoWin32FontCache</span></a> *cache</code></em>);
71
 
<span class="returnvalue">HFONT</span>               <a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-cache-load" title="pango_win32_font_cache_load ()">pango_win32_font_cache_load</a>         (<em class="parameter"><code><a class="link" href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache" title="PangoWin32FontCache"><span class="type">PangoWin32FontCache</span></a> *cache</code></em>,
72
 
                                                         <em class="parameter"><code>const <span class="type">LOGFONTA</span> *logfont</code></em>);
73
 
<span class="returnvalue">HFONT</span>               <a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-cache-loadw" title="pango_win32_font_cache_loadw ()">pango_win32_font_cache_loadw</a>        (<em class="parameter"><code><a class="link" href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache" title="PangoWin32FontCache"><span class="type">PangoWin32FontCache</span></a> *cache</code></em>,
74
 
                                                         <em class="parameter"><code>const <span class="type">LOGFONTW</span> *logfont</code></em>);
75
 
<span class="returnvalue">void</span>                <a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-cache-unload" title="pango_win32_font_cache_unload ()">pango_win32_font_cache_unload</a>       (<em class="parameter"><code><a class="link" href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache" title="PangoWin32FontCache"><span class="type">PangoWin32FontCache</span></a> *cache</code></em>,
76
 
                                                         <em class="parameter"><code><span class="type">HFONT</span> hfont</code></em>);
77
 
<a class="link" href="pango-Fonts.html#PangoFontMap"><span class="returnvalue">PangoFontMap</span></a> *      <a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-map-for-display" title="pango_win32_font_map_for_display ()">pango_win32_font_map_for_display</a>    (<em class="parameter"><code><span class="type">void</span></code></em>);
78
 
<span class="returnvalue">void</span>                <a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-shutdown-display" title="pango_win32_shutdown_display ()">pango_win32_shutdown_display</a>        (<em class="parameter"><code><span class="type">void</span></code></em>);
79
 
<a class="link" href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache" title="PangoWin32FontCache"><span class="returnvalue">PangoWin32FontCache</span></a> * <a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-map-get-font-cache" title="pango_win32_font_map_get_font_cache ()">pango_win32_font_map_get_font_cache</a>
80
 
                                                        (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> *font_map</code></em>);
81
 
<span class="returnvalue">LOGFONTA</span> *          <a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-logfont" title="pango_win32_font_logfont ()">pango_win32_font_logfont</a>            (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>);
82
 
<span class="returnvalue">LOGFONTW</span> *          <a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-logfontw" title="pango_win32_font_logfontw ()">pango_win32_font_logfontw</a>           (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>);
83
 
<a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> * <a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-description-from-logfont" title="pango_win32_font_description_from_logfont ()">pango_win32_font_description_from_logfont</a>
84
 
                                                        (<em class="parameter"><code>const <span class="type">LOGFONTA</span> *lfp</code></em>);
85
 
<a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> * <a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-description-from-logfontw" title="pango_win32_font_description_from_logfontw ()">pango_win32_font_description_from_logfontw</a>
86
 
                                                        (<em class="parameter"><code>const <span class="type">LOGFONTW</span> *lfp</code></em>);
87
 
</pre>
 
34
<div class="refsect1">
 
35
<a name="pango-Win32-Fonts-and-Rendering.functions"></a><h2>Functions</h2>
 
36
<div class="informaltable"><table width="100%" border="0">
 
37
<colgroup>
 
38
<col width="150px" class="functions_return">
 
39
<col class="functions_name">
 
40
</colgroup>
 
41
<tbody>
 
42
<tr>
 
43
<td class="function_type">
 
44
<a class="link" href="pango-Text-Processing.html#PangoContext"><span class="returnvalue">PangoContext</span></a> *
 
45
</td>
 
46
<td class="function_name">
 
47
<a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-get-context" title="pango_win32_get_context ()">pango_win32_get_context</a> <span class="c_punctuation">()</span>
 
48
</td>
 
49
</tr>
 
50
<tr>
 
51
<td class="function_type">
 
52
<span class="returnvalue">void</span>
 
53
</td>
 
54
<td class="function_name">
 
55
<a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-render" title="pango_win32_render ()">pango_win32_render</a> <span class="c_punctuation">()</span>
 
56
</td>
 
57
</tr>
 
58
<tr>
 
59
<td class="function_type">
 
60
<span class="returnvalue">void</span>
 
61
</td>
 
62
<td class="function_name">
 
63
<a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-render-transformed" title="pango_win32_render_transformed ()">pango_win32_render_transformed</a> <span class="c_punctuation">()</span>
 
64
</td>
 
65
</tr>
 
66
<tr>
 
67
<td class="function_type">
 
68
<span class="returnvalue">void</span>
 
69
</td>
 
70
<td class="function_name">
 
71
<a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-render-layout-line" title="pango_win32_render_layout_line ()">pango_win32_render_layout_line</a> <span class="c_punctuation">()</span>
 
72
</td>
 
73
</tr>
 
74
<tr>
 
75
<td class="function_type">
 
76
<span class="returnvalue">void</span>
 
77
</td>
 
78
<td class="function_name">
 
79
<a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-render-layout" title="pango_win32_render_layout ()">pango_win32_render_layout</a> <span class="c_punctuation">()</span>
 
80
</td>
 
81
</tr>
 
82
<tr>
 
83
<td class="function_type">
 
84
<a class="link" href="pango-Glyph-Storage.html#PangoGlyph" title="PangoGlyph"><span class="returnvalue">PangoGlyph</span></a>
 
85
</td>
 
86
<td class="function_name">
 
87
<a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-get-unknown-glyph" title="pango_win32_get_unknown_glyph ()">pango_win32_get_unknown_glyph</a> <span class="c_punctuation">()</span>
 
88
</td>
 
89
</tr>
 
90
<tr>
 
91
<td class="function_type">
 
92
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
 
93
</td>
 
94
<td class="function_name">
 
95
<a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-get-glyph-index" title="pango_win32_font_get_glyph_index ()">pango_win32_font_get_glyph_index</a> <span class="c_punctuation">()</span>
 
96
</td>
 
97
</tr>
 
98
<tr>
 
99
<td class="function_type">
 
100
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 
101
</td>
 
102
<td class="function_name">
 
103
<a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-select-font" title="pango_win32_font_select_font ()">pango_win32_font_select_font</a> <span class="c_punctuation">()</span>
 
104
</td>
 
105
</tr>
 
106
<tr>
 
107
<td class="function_type">
 
108
<span class="returnvalue">void</span>
 
109
</td>
 
110
<td class="function_name">
 
111
<a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-done-font" title="pango_win32_font_done_font ()">pango_win32_font_done_font</a> <span class="c_punctuation">()</span>
 
112
</td>
 
113
</tr>
 
114
<tr>
 
115
<td class="function_type">
 
116
<span class="returnvalue">double</span>
 
117
</td>
 
118
<td class="function_name">
 
119
<a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-get-metrics-factor" title="pango_win32_font_get_metrics_factor ()">pango_win32_font_get_metrics_factor</a> <span class="c_punctuation">()</span>
 
120
</td>
 
121
</tr>
 
122
<tr>
 
123
<td class="function_type">
 
124
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 
125
</td>
 
126
<td class="function_name">
 
127
<a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-get-debug-flag" title="pango_win32_get_debug_flag ()">pango_win32_get_debug_flag</a> <span class="c_punctuation">()</span>
 
128
</td>
 
129
</tr>
 
130
<tr>
 
131
<td class="function_type">
 
132
<span class="returnvalue">HDC</span>
 
133
</td>
 
134
<td class="function_name">
 
135
<a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-get-dc" title="pango_win32_get_dc ()">pango_win32_get_dc</a> <span class="c_punctuation">()</span>
 
136
</td>
 
137
</tr>
 
138
<tr>
 
139
<td class="function_type">
 
140
<a class="link" href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache" title="PangoWin32FontCache"><span class="returnvalue">PangoWin32FontCache</span></a> *
 
141
</td>
 
142
<td class="function_name">
 
143
<a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-cache-new" title="pango_win32_font_cache_new ()">pango_win32_font_cache_new</a> <span class="c_punctuation">()</span>
 
144
</td>
 
145
</tr>
 
146
<tr>
 
147
<td class="function_type">
 
148
<span class="returnvalue">void</span>
 
149
</td>
 
150
<td class="function_name">
 
151
<a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-cache-free" title="pango_win32_font_cache_free ()">pango_win32_font_cache_free</a> <span class="c_punctuation">()</span>
 
152
</td>
 
153
</tr>
 
154
<tr>
 
155
<td class="function_type">
 
156
<span class="returnvalue">HFONT</span>
 
157
</td>
 
158
<td class="function_name">
 
159
<a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-cache-load" title="pango_win32_font_cache_load ()">pango_win32_font_cache_load</a> <span class="c_punctuation">()</span>
 
160
</td>
 
161
</tr>
 
162
<tr>
 
163
<td class="function_type">
 
164
<span class="returnvalue">HFONT</span>
 
165
</td>
 
166
<td class="function_name">
 
167
<a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-cache-loadw" title="pango_win32_font_cache_loadw ()">pango_win32_font_cache_loadw</a> <span class="c_punctuation">()</span>
 
168
</td>
 
169
</tr>
 
170
<tr>
 
171
<td class="function_type">
 
172
<span class="returnvalue">void</span>
 
173
</td>
 
174
<td class="function_name">
 
175
<a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-cache-unload" title="pango_win32_font_cache_unload ()">pango_win32_font_cache_unload</a> <span class="c_punctuation">()</span>
 
176
</td>
 
177
</tr>
 
178
<tr>
 
179
<td class="function_type">
 
180
<a class="link" href="pango-Fonts.html#PangoFontMap"><span class="returnvalue">PangoFontMap</span></a> *
 
181
</td>
 
182
<td class="function_name">
 
183
<a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-map-for-display" title="pango_win32_font_map_for_display ()">pango_win32_font_map_for_display</a> <span class="c_punctuation">()</span>
 
184
</td>
 
185
</tr>
 
186
<tr>
 
187
<td class="function_type">
 
188
<span class="returnvalue">void</span>
 
189
</td>
 
190
<td class="function_name">
 
191
<a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-shutdown-display" title="pango_win32_shutdown_display ()">pango_win32_shutdown_display</a> <span class="c_punctuation">()</span>
 
192
</td>
 
193
</tr>
 
194
<tr>
 
195
<td class="function_type">
 
196
<a class="link" href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache" title="PangoWin32FontCache"><span class="returnvalue">PangoWin32FontCache</span></a> *
 
197
</td>
 
198
<td class="function_name">
 
199
<a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-map-get-font-cache" title="pango_win32_font_map_get_font_cache ()">pango_win32_font_map_get_font_cache</a> <span class="c_punctuation">()</span>
 
200
</td>
 
201
</tr>
 
202
<tr>
 
203
<td class="function_type">
 
204
<span class="returnvalue">LOGFONTA</span> *
 
205
</td>
 
206
<td class="function_name">
 
207
<a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-logfont" title="pango_win32_font_logfont ()">pango_win32_font_logfont</a> <span class="c_punctuation">()</span>
 
208
</td>
 
209
</tr>
 
210
<tr>
 
211
<td class="function_type">
 
212
<span class="returnvalue">LOGFONTW</span> *
 
213
</td>
 
214
<td class="function_name">
 
215
<a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-logfontw" title="pango_win32_font_logfontw ()">pango_win32_font_logfontw</a> <span class="c_punctuation">()</span>
 
216
</td>
 
217
</tr>
 
218
<tr>
 
219
<td class="function_type">
 
220
<a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> *
 
221
</td>
 
222
<td class="function_name">
 
223
<a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-description-from-logfont" title="pango_win32_font_description_from_logfont ()">pango_win32_font_description_from_logfont</a> <span class="c_punctuation">()</span>
 
224
</td>
 
225
</tr>
 
226
<tr>
 
227
<td class="function_type">
 
228
<a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> *
 
229
</td>
 
230
<td class="function_name">
 
231
<a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-description-from-logfontw" title="pango_win32_font_description_from_logfontw ()">pango_win32_font_description_from_logfontw</a> <span class="c_punctuation">()</span>
 
232
</td>
 
233
</tr>
 
234
</tbody>
 
235
</table></div>
 
236
</div>
 
237
<div class="refsect1">
 
238
<a name="pango-Win32-Fonts-and-Rendering.other"></a><h2>Types and Values</h2>
 
239
<div class="informaltable"><table width="100%" border="0">
 
240
<colgroup>
 
241
<col width="150px" class="name">
 
242
<col class="description">
 
243
</colgroup>
 
244
<tbody>
 
245
<tr>
 
246
<td class="define_keyword">#define</td>
 
247
<td class="function_name"><a class="link" href="pango-Win32-Fonts-and-Rendering.html#PANGO-RENDER-TYPE-WIN32:CAPS" title="PANGO_RENDER_TYPE_WIN32">PANGO_RENDER_TYPE_WIN32</a></td>
 
248
</tr>
 
249
<tr>
 
250
<td class="datatype_keyword"> </td>
 
251
<td class="function_name"><a class="link" href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache" title="PangoWin32FontCache">PangoWin32FontCache</a></td>
 
252
</tr>
 
253
</tbody>
 
254
</table></div>
88
255
</div>
89
256
<div class="refsect1">
90
257
<a name="pango-Win32-Fonts-and-Rendering.description"></a><h2>Description</h2>
91
 
<p>
92
 
The macros and functions in this section are used to access fonts natively on
 
258
<p>The macros and functions in this section are used to access fonts natively on
93
259
Win32 systems and to render text in conjunction with Win32 APIs.</p>
94
260
</div>
95
261
<div class="refsect1">
96
 
<a name="pango-Win32-Fonts-and-Rendering.details"></a><h2>Details</h2>
97
 
<div class="refsect2">
98
 
<a name="PANGO-RENDER-TYPE-WIN32:CAPS"></a><h3>PANGO_RENDER_TYPE_WIN32</h3>
99
 
<pre class="programlisting">#define PANGO_RENDER_TYPE_WIN32 "PangoRenderWin32"
100
 
</pre>
101
 
<p>
102
 
A string constant identifying the Win32 renderer. The associated quark (see
103
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#g-quark-from-string"><code class="function">g_quark_from_string()</code></a>) is used to identify the renderer in <a class="link" href="pango-Modules.html#pango-find-map" title="pango_find_map ()"><code class="function">pango_find_map()</code></a>.</p>
104
 
</div>
105
 
<hr>
106
 
<div class="refsect2">
107
 
<a name="pango-win32-get-context"></a><h3>pango_win32_get_context ()</h3>
108
 
<pre class="programlisting"><a class="link" href="pango-Text-Processing.html#PangoContext"><span class="returnvalue">PangoContext</span></a> *      pango_win32_get_context             (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 
262
<a name="pango-Win32-Fonts-and-Rendering.functions_details"></a><h2>Functions</h2>
 
263
<div class="refsect2">
 
264
<a name="pango-win32-get-context"></a><h3>pango_win32_get_context ()</h3>
 
265
<pre class="programlisting"><a class="link" href="pango-Text-Processing.html#PangoContext"><span class="returnvalue">PangoContext</span></a> *
 
266
pango_win32_get_context (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
109
267
<div class="warning">
110
 
<h3 class="title">Warning</h3>
111
 
<p><code class="literal">pango_win32_get_context</code> has been deprecated since version 1.22 and should not be used in newly-written code. Use <a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-map-for-display" title="pango_win32_font_map_for_display ()"><code class="function">pango_win32_font_map_for_display()</code></a> followed by
112
 
<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>
113
 
</div>
114
 
<p>
115
 
Retrieves a <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> appropriate for rendering with Windows fonts.</p>
116
 
<div class="variablelist"><table border="0" class="variablelist">
117
 
<colgroup>
118
 
<col align="left" valign="top">
119
 
<col>
120
 
</colgroup>
121
 
<tbody><tr>
122
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
123
 
<td>the new <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>
124
 
</td>
125
 
</tr></tbody>
126
 
</table></div>
 
268
<p><code class="literal">pango_win32_get_context</code> has been deprecated since version 1.22 and should not be used in newly-written code.</p>
 
269
<p>Use <a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-map-for-display" title="pango_win32_font_map_for_display ()"><code class="function">pango_win32_font_map_for_display()</code></a> followed by
 
270
<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>
 
271
</div>
 
272
<p>Retrieves a <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> appropriate for rendering with Windows fonts.</p>
 
273
<div class="refsect3">
 
274
<a name="id-1.3.2.6.2.6"></a><h4>Returns</h4>
 
275
<p> the new <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a></p>
 
276
<p></p>
 
277
</div>
127
278
</div>
128
279
<hr>
129
280
<div class="refsect2">
130
 
<a name="pango-win32-render"></a><h3>pango_win32_render ()</h3>
131
 
<pre class="programlisting"><span class="returnvalue">void</span>                pango_win32_render                  (<em class="parameter"><code><span class="type">HDC</span> hdc</code></em>,
132
 
                                                         <em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,
133
 
                                                         <em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoGlyphString"><span class="type">PangoGlyphString</span></a> *glyphs</code></em>,
134
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x</code></em>,
135
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y</code></em>);</pre>
136
 
<p>
137
 
Render a <a class="link" href="pango-Glyph-Storage.html#PangoGlyphString"><span class="type">PangoGlyphString</span></a> onto a Windows DC</p>
138
 
<div class="variablelist"><table border="0" class="variablelist">
 
281
<a name="pango-win32-render"></a><h3>pango_win32_render ()</h3>
 
282
<pre class="programlisting"><span class="returnvalue">void</span>
 
283
pango_win32_render (<em class="parameter"><code><span class="type">HDC</span> hdc</code></em>,
 
284
                    <em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,
 
285
                    <em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoGlyphString"><span class="type">PangoGlyphString</span></a> *glyphs</code></em>,
 
286
                    <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x</code></em>,
 
287
                    <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y</code></em>);</pre>
 
288
<p>Render a <a class="link" href="pango-Glyph-Storage.html#PangoGlyphString"><span class="type">PangoGlyphString</span></a> onto a Windows DC</p>
 
289
<div class="refsect3">
 
290
<a name="id-1.3.2.6.3.5"></a><h4>Parameters</h4>
 
291
<div class="informaltable"><table width="100%" border="0">
139
292
<colgroup>
140
 
<col align="left" valign="top">
141
 
<col>
 
293
<col width="150px" class="parameters_name">
 
294
<col class="parameters_description">
 
295
<col width="200px" class="parameters_annotations">
142
296
</colgroup>
143
297
<tbody>
144
298
<tr>
145
 
<td><p><span class="term"><em class="parameter"><code>hdc</code></em> :</span></p></td>
146
 
<td>the device context</td>
147
 
</tr>
148
 
<tr>
149
 
<td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
150
 
<td>the font in which to draw the string</td>
151
 
</tr>
152
 
<tr>
153
 
<td><p><span class="term"><em class="parameter"><code>glyphs</code></em> :</span></p></td>
154
 
<td>the glyph string to draw</td>
155
 
</tr>
156
 
<tr>
157
 
<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
158
 
<td>the x position of start of string (in pixels)</td>
159
 
</tr>
160
 
<tr>
161
 
<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
162
 
<td>the y position of baseline (in pixels)</td>
 
299
<td class="parameter_name"><p>hdc</p></td>
 
300
<td class="parameter_description"><p>the device context</p></td>
 
301
<td class="parameter_annotations"> </td>
 
302
</tr>
 
303
<tr>
 
304
<td class="parameter_name"><p>font</p></td>
 
305
<td class="parameter_description"><p>the font in which to draw the string</p></td>
 
306
<td class="parameter_annotations"> </td>
 
307
</tr>
 
308
<tr>
 
309
<td class="parameter_name"><p>glyphs</p></td>
 
310
<td class="parameter_description"><p>the glyph string to draw</p></td>
 
311
<td class="parameter_annotations"> </td>
 
312
</tr>
 
313
<tr>
 
314
<td class="parameter_name"><p>x</p></td>
 
315
<td class="parameter_description"><p>the x position of start of string (in pixels)</p></td>
 
316
<td class="parameter_annotations"> </td>
 
317
</tr>
 
318
<tr>
 
319
<td class="parameter_name"><p>y</p></td>
 
320
<td class="parameter_description"><p>the y position of baseline (in pixels)</p></td>
 
321
<td class="parameter_annotations"> </td>
163
322
</tr>
164
323
</tbody>
165
324
</table></div>
166
325
</div>
 
326
</div>
167
327
<hr>
168
328
<div class="refsect2">
169
 
<a name="pango-win32-render-transformed"></a><h3>pango_win32_render_transformed ()</h3>
170
 
<pre class="programlisting"><span class="returnvalue">void</span>                pango_win32_render_transformed      (<em class="parameter"><code><span class="type">HDC</span> hdc</code></em>,
171
 
                                                         <em class="parameter"><code>const <a class="link" href="pango-Glyph-Storage.html#PangoMatrix"><span class="type">PangoMatrix</span></a> *matrix</code></em>,
172
 
                                                         <em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,
173
 
                                                         <em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoGlyphString"><span class="type">PangoGlyphString</span></a> *glyphs</code></em>,
174
 
                                                         <em class="parameter"><code><span class="type">int</span> x</code></em>,
175
 
                                                         <em class="parameter"><code><span class="type">int</span> y</code></em>);</pre>
176
 
<p>
177
 
Renders a <a class="link" href="pango-Glyph-Storage.html#PangoGlyphString"><span class="type">PangoGlyphString</span></a> onto a windows DC, possibly
 
329
<a name="pango-win32-render-transformed"></a><h3>pango_win32_render_transformed ()</h3>
 
330
<pre class="programlisting"><span class="returnvalue">void</span>
 
331
pango_win32_render_transformed (<em class="parameter"><code><span class="type">HDC</span> hdc</code></em>,
 
332
                                <em class="parameter"><code>const <a class="link" href="pango-Glyph-Storage.html#PangoMatrix"><span class="type">PangoMatrix</span></a> *matrix</code></em>,
 
333
                                <em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,
 
334
                                <em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoGlyphString"><span class="type">PangoGlyphString</span></a> *glyphs</code></em>,
 
335
                                <em class="parameter"><code><span class="type">int</span> x</code></em>,
 
336
                                <em class="parameter"><code><span class="type">int</span> y</code></em>);</pre>
 
337
<p>Renders a <a class="link" href="pango-Glyph-Storage.html#PangoGlyphString"><span class="type">PangoGlyphString</span></a> onto a windows DC, possibly
178
338
transforming the layed-out coordinates through a transformation
179
 
matrix. Note that the transformation matrix for <em class="parameter"><code>font</code></em> is not
 
339
matrix. Note that the transformation matrix for <em class="parameter"><code>font</code></em>
 
340
 is not
180
341
changed, so to produce correct rendering results, the <em class="parameter"><code>font</code></em>
 
342
 
181
343
must have been loaded using a <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> with an identical
182
344
transformation matrix to that passed in to this function.</p>
183
 
<div class="variablelist"><table border="0" class="variablelist">
 
345
<div class="refsect3">
 
346
<a name="id-1.3.2.6.4.5"></a><h4>Parameters</h4>
 
347
<div class="informaltable"><table width="100%" border="0">
184
348
<colgroup>
185
 
<col align="left" valign="top">
186
 
<col>
 
349
<col width="150px" class="parameters_name">
 
350
<col class="parameters_description">
 
351
<col width="200px" class="parameters_annotations">
187
352
</colgroup>
188
353
<tbody>
189
354
<tr>
190
 
<td><p><span class="term"><em class="parameter"><code>hdc</code></em> :</span></p></td>
191
 
<td>a windows device context</td>
192
 
</tr>
193
 
<tr>
194
 
<td><p><span class="term"><em class="parameter"><code>matrix</code></em> :</span></p></td>
195
 
<td>a <a class="link" href="pango-Glyph-Storage.html#PangoMatrix"><span class="type">PangoMatrix</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to use an identity transformation</td>
196
 
</tr>
197
 
<tr>
198
 
<td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
199
 
<td>the font in which to draw the string</td>
200
 
</tr>
201
 
<tr>
202
 
<td><p><span class="term"><em class="parameter"><code>glyphs</code></em> :</span></p></td>
203
 
<td>the glyph string to draw</td>
204
 
</tr>
205
 
<tr>
206
 
<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
207
 
<td>the x position of the start of the string (in Pango
208
 
units in user space coordinates)</td>
209
 
</tr>
210
 
<tr>
211
 
<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
212
 
<td>the y position of the baseline (in Pango units
213
 
in user space coordinates)</td>
 
355
<td class="parameter_name"><p>hdc</p></td>
 
356
<td class="parameter_description"><p>a windows device context</p></td>
 
357
<td class="parameter_annotations"> </td>
 
358
</tr>
 
359
<tr>
 
360
<td class="parameter_name"><p>matrix</p></td>
 
361
<td class="parameter_description"><p>a <a class="link" href="pango-Glyph-Storage.html#PangoMatrix"><span class="type">PangoMatrix</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to use an identity transformation</p></td>
 
362
<td class="parameter_annotations"> </td>
 
363
</tr>
 
364
<tr>
 
365
<td class="parameter_name"><p>font</p></td>
 
366
<td class="parameter_description"><p>the font in which to draw the string</p></td>
 
367
<td class="parameter_annotations"> </td>
 
368
</tr>
 
369
<tr>
 
370
<td class="parameter_name"><p>glyphs</p></td>
 
371
<td class="parameter_description"><p>the glyph string to draw</p></td>
 
372
<td class="parameter_annotations"> </td>
 
373
</tr>
 
374
<tr>
 
375
<td class="parameter_name"><p>x</p></td>
 
376
<td class="parameter_description"><p>the x position of the start of the string (in Pango
 
377
units in user space coordinates)</p></td>
 
378
<td class="parameter_annotations"> </td>
 
379
</tr>
 
380
<tr>
 
381
<td class="parameter_name"><p>y</p></td>
 
382
<td class="parameter_description"><p>the y position of the baseline (in Pango units
 
383
in user space coordinates)</p></td>
 
384
<td class="parameter_annotations"> </td>
214
385
</tr>
215
386
</tbody>
216
387
</table></div>
217
388
</div>
 
389
</div>
218
390
<hr>
219
391
<div class="refsect2">
220
 
<a name="pango-win32-render-layout-line"></a><h3>pango_win32_render_layout_line ()</h3>
221
 
<pre class="programlisting"><span class="returnvalue">void</span>                pango_win32_render_layout_line      (<em class="parameter"><code><span class="type">HDC</span> hdc</code></em>,
222
 
                                                         <em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayoutLine"><span class="type">PangoLayoutLine</span></a> *line</code></em>,
223
 
                                                         <em class="parameter"><code><span class="type">int</span> x</code></em>,
224
 
                                                         <em class="parameter"><code><span class="type">int</span> y</code></em>);</pre>
225
 
<p>
226
 
Render a <a class="link" href="pango-Layout-Objects.html#PangoLayoutLine"><span class="type">PangoLayoutLine</span></a> onto a device context. For underlining to
 
392
<a name="pango-win32-render-layout-line"></a><h3>pango_win32_render_layout_line ()</h3>
 
393
<pre class="programlisting"><span class="returnvalue">void</span>
 
394
pango_win32_render_layout_line (<em class="parameter"><code><span class="type">HDC</span> hdc</code></em>,
 
395
                                <em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayoutLine"><span class="type">PangoLayoutLine</span></a> *line</code></em>,
 
396
                                <em class="parameter"><code><span class="type">int</span> x</code></em>,
 
397
                                <em class="parameter"><code><span class="type">int</span> y</code></em>);</pre>
 
398
<p>Render a <a class="link" href="pango-Layout-Objects.html#PangoLayoutLine"><span class="type">PangoLayoutLine</span></a> onto a device context. For underlining to
227
399
work property the text alignment of the DC should have TA_BASELINE
228
400
and TA_LEFT.</p>
229
 
<div class="variablelist"><table border="0" class="variablelist">
230
 
<colgroup>
231
 
<col align="left" valign="top">
232
 
<col>
233
 
</colgroup>
234
 
<tbody>
235
 
<tr>
236
 
<td><p><span class="term"><em class="parameter"><code>hdc</code></em> :</span></p></td>
237
 
<td>DC to use for uncolored drawing</td>
238
 
</tr>
239
 
<tr>
240
 
<td><p><span class="term"><em class="parameter"><code>line</code></em> :</span></p></td>
241
 
<td>a <a class="link" href="pango-Layout-Objects.html#PangoLayoutLine"><span class="type">PangoLayoutLine</span></a>
242
 
</td>
243
 
</tr>
244
 
<tr>
245
 
<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
246
 
<td>the x position of start of string (in pixels)</td>
247
 
</tr>
248
 
<tr>
249
 
<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
250
 
<td>the y position of baseline (in pixels)</td>
251
 
</tr>
252
 
</tbody>
253
 
</table></div>
254
 
</div>
255
 
<hr>
256
 
<div class="refsect2">
257
 
<a name="pango-win32-render-layout"></a><h3>pango_win32_render_layout ()</h3>
258
 
<pre class="programlisting"><span class="returnvalue">void</span>                pango_win32_render_layout           (<em class="parameter"><code><span class="type">HDC</span> hdc</code></em>,
259
 
                                                         <em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> *layout</code></em>,
260
 
                                                         <em class="parameter"><code><span class="type">int</span> x</code></em>,
261
 
                                                         <em class="parameter"><code><span class="type">int</span> y</code></em>);</pre>
262
 
<p>
263
 
Render a <a class="link" href="pango-Layout-Objects.html#PangoLayoutLine"><span class="type">PangoLayoutLine</span></a> onto an X drawable</p>
264
 
<div class="variablelist"><table border="0" class="variablelist">
265
 
<colgroup>
266
 
<col align="left" valign="top">
267
 
<col>
268
 
</colgroup>
269
 
<tbody>
270
 
<tr>
271
 
<td><p><span class="term"><em class="parameter"><code>hdc</code></em> :</span></p></td>
272
 
<td>HDC to use for uncolored drawing</td>
273
 
</tr>
274
 
<tr>
275
 
<td><p><span class="term"><em class="parameter"><code>layout</code></em> :</span></p></td>
276
 
<td>a <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a>
277
 
</td>
278
 
</tr>
279
 
<tr>
280
 
<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
281
 
<td>the X position of the left of the layout (in pixels)</td>
282
 
</tr>
283
 
<tr>
284
 
<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
285
 
<td>the Y position of the top of the layout (in pixels)</td>
286
 
</tr>
287
 
</tbody>
288
 
</table></div>
289
 
</div>
290
 
<hr>
291
 
<div class="refsect2">
292
 
<a name="pango-win32-get-unknown-glyph"></a><h3>pango_win32_get_unknown_glyph ()</h3>
293
 
<pre class="programlisting"><a class="link" href="pango-Glyph-Storage.html#PangoGlyph" title="PangoGlyph"><span class="returnvalue">PangoGlyph</span></a>          pango_win32_get_unknown_glyph       (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,
294
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#gunichar"><span class="type">gunichar</span></a> wc</code></em>);</pre>
295
 
<div class="warning">
296
 
<h3 class="title">Warning</h3>
297
 
<p><code class="literal">pango_win32_get_unknown_glyph</code> is deprecated and should not be used in newly-written code.</p>
298
 
</div>
299
 
<p>
300
 
Returns the index of a glyph suitable for drawing <em class="parameter"><code>wc</code></em> as an
 
401
<div class="refsect3">
 
402
<a name="id-1.3.2.6.5.5"></a><h4>Parameters</h4>
 
403
<div class="informaltable"><table width="100%" border="0">
 
404
<colgroup>
 
405
<col width="150px" class="parameters_name">
 
406
<col class="parameters_description">
 
407
<col width="200px" class="parameters_annotations">
 
408
</colgroup>
 
409
<tbody>
 
410
<tr>
 
411
<td class="parameter_name"><p>hdc</p></td>
 
412
<td class="parameter_description"><p>DC to use for uncolored drawing</p></td>
 
413
<td class="parameter_annotations"> </td>
 
414
</tr>
 
415
<tr>
 
416
<td class="parameter_name"><p>line</p></td>
 
417
<td class="parameter_description"><p>a <a class="link" href="pango-Layout-Objects.html#PangoLayoutLine"><span class="type">PangoLayoutLine</span></a></p></td>
 
418
<td class="parameter_annotations"> </td>
 
419
</tr>
 
420
<tr>
 
421
<td class="parameter_name"><p>x</p></td>
 
422
<td class="parameter_description"><p>the x position of start of string (in pixels)</p></td>
 
423
<td class="parameter_annotations"> </td>
 
424
</tr>
 
425
<tr>
 
426
<td class="parameter_name"><p>y</p></td>
 
427
<td class="parameter_description"><p>the y position of baseline (in pixels)</p></td>
 
428
<td class="parameter_annotations"> </td>
 
429
</tr>
 
430
</tbody>
 
431
</table></div>
 
432
</div>
 
433
</div>
 
434
<hr>
 
435
<div class="refsect2">
 
436
<a name="pango-win32-render-layout"></a><h3>pango_win32_render_layout ()</h3>
 
437
<pre class="programlisting"><span class="returnvalue">void</span>
 
438
pango_win32_render_layout (<em class="parameter"><code><span class="type">HDC</span> hdc</code></em>,
 
439
                           <em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> *layout</code></em>,
 
440
                           <em class="parameter"><code><span class="type">int</span> x</code></em>,
 
441
                           <em class="parameter"><code><span class="type">int</span> y</code></em>);</pre>
 
442
<p>Render a <a class="link" href="pango-Layout-Objects.html#PangoLayoutLine"><span class="type">PangoLayoutLine</span></a> onto an X drawable</p>
 
443
<div class="refsect3">
 
444
<a name="id-1.3.2.6.6.5"></a><h4>Parameters</h4>
 
445
<div class="informaltable"><table width="100%" border="0">
 
446
<colgroup>
 
447
<col width="150px" class="parameters_name">
 
448
<col class="parameters_description">
 
449
<col width="200px" class="parameters_annotations">
 
450
</colgroup>
 
451
<tbody>
 
452
<tr>
 
453
<td class="parameter_name"><p>hdc</p></td>
 
454
<td class="parameter_description"><p>HDC to use for uncolored drawing</p></td>
 
455
<td class="parameter_annotations"> </td>
 
456
</tr>
 
457
<tr>
 
458
<td class="parameter_name"><p>layout</p></td>
 
459
<td class="parameter_description"><p>a <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a></p></td>
 
460
<td class="parameter_annotations"> </td>
 
461
</tr>
 
462
<tr>
 
463
<td class="parameter_name"><p>x</p></td>
 
464
<td class="parameter_description"><p>the X position of the left of the layout (in pixels)</p></td>
 
465
<td class="parameter_annotations"> </td>
 
466
</tr>
 
467
<tr>
 
468
<td class="parameter_name"><p>y</p></td>
 
469
<td class="parameter_description"><p>the Y position of the top of the layout (in pixels)</p></td>
 
470
<td class="parameter_annotations"> </td>
 
471
</tr>
 
472
</tbody>
 
473
</table></div>
 
474
</div>
 
475
</div>
 
476
<hr>
 
477
<div class="refsect2">
 
478
<a name="pango-win32-get-unknown-glyph"></a><h3>pango_win32_get_unknown_glyph ()</h3>
 
479
<pre class="programlisting"><a class="link" href="pango-Glyph-Storage.html#PangoGlyph" title="PangoGlyph"><span class="returnvalue">PangoGlyph</span></a>
 
480
pango_win32_get_unknown_glyph (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,
 
481
                               <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#gunichar"><span class="type">gunichar</span></a> wc</code></em>);</pre>
 
482
<div class="warning"><p><code class="literal">pango_win32_get_unknown_glyph</code> is deprecated and should not be used in newly-written code.</p></div>
 
483
<p>Returns the index of a glyph suitable for drawing <em class="parameter"><code>wc</code></em>
 
484
 as an
301
485
unknown character.</p>
302
 
<p>
303
 
Use <a class="link" href="pango-Glyph-Storage.html#PANGO-GET-UNKNOWN-GLYPH:CAPS" title="PANGO_GET_UNKNOWN_GLYPH()"><code class="function">PANGO_GET_UNKNOWN_GLYPH()</code></a> instead.</p>
304
 
<div class="variablelist"><table border="0" class="variablelist">
 
486
<p>Use <a class="link" href="pango-Glyph-Storage.html#PANGO-GET-UNKNOWN-GLYPH:CAPS" title="PANGO_GET_UNKNOWN_GLYPH()"><code class="function">PANGO_GET_UNKNOWN_GLYPH()</code></a> instead.</p>
 
487
<div class="refsect3">
 
488
<a name="id-1.3.2.6.7.7"></a><h4>Parameters</h4>
 
489
<div class="informaltable"><table width="100%" border="0">
305
490
<colgroup>
306
 
<col align="left" valign="top">
307
 
<col>
 
491
<col width="150px" class="parameters_name">
 
492
<col class="parameters_description">
 
493
<col width="200px" class="parameters_annotations">
308
494
</colgroup>
309
495
<tbody>
310
496
<tr>
311
 
<td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
312
 
<td>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>
313
 
</td>
314
 
</tr>
315
 
<tr>
316
 
<td><p><span class="term"><em class="parameter"><code>wc</code></em> :</span></p></td>
317
 
<td>the Unicode character for which a glyph is needed.</td>
318
 
</tr>
319
 
<tr>
320
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
321
 
<td>a glyph index into <em class="parameter"><code>font</code></em>
322
 
</td>
 
497
<td class="parameter_name"><p>font</p></td>
 
498
<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a></p></td>
 
499
<td class="parameter_annotations"> </td>
 
500
</tr>
 
501
<tr>
 
502
<td class="parameter_name"><p>wc</p></td>
 
503
<td class="parameter_description"><p>the Unicode character for which a glyph is needed.</p></td>
 
504
<td class="parameter_annotations"> </td>
323
505
</tr>
324
506
</tbody>
325
507
</table></div>
326
508
</div>
 
509
<div class="refsect3">
 
510
<a name="id-1.3.2.6.7.8"></a><h4>Returns</h4>
 
511
<p> a glyph index into <em class="parameter"><code>font</code></em>
 
512
</p>
 
513
<p></p>
 
514
</div>
 
515
</div>
327
516
<hr>
328
517
<div class="refsect2">
329
 
<a name="pango-win32-font-get-glyph-index"></a><h3>pango_win32_font_get_glyph_index ()</h3>
330
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                pango_win32_font_get_glyph_index    (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,
331
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#gunichar"><span class="type">gunichar</span></a> wc</code></em>);</pre>
332
 
<div class="warning">
333
 
<h3 class="title">Warning</h3>
334
 
<p><code class="literal">pango_win32_font_get_glyph_index</code> is deprecated and should not be used in newly-written code.</p>
335
 
</div>
336
 
<p>
337
 
Obtains the index of the glyph for <em class="parameter"><code>wc</code></em> in <em class="parameter"><code>font</code></em>, or 0, if not
 
518
<a name="pango-win32-font-get-glyph-index"></a><h3>pango_win32_font_get_glyph_index ()</h3>
 
519
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
 
520
pango_win32_font_get_glyph_index (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,
 
521
                                  <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#gunichar"><span class="type">gunichar</span></a> wc</code></em>);</pre>
 
522
<div class="warning"><p><code class="literal">pango_win32_font_get_glyph_index</code> is deprecated and should not be used in newly-written code.</p></div>
 
523
<p>Obtains the index of the glyph for <em class="parameter"><code>wc</code></em>
 
524
 in <em class="parameter"><code>font</code></em>
 
525
, or 0, if not
338
526
covered.</p>
339
 
<div class="variablelist"><table border="0" class="variablelist">
 
527
<div class="refsect3">
 
528
<a name="id-1.3.2.6.8.6"></a><h4>Parameters</h4>
 
529
<div class="informaltable"><table width="100%" border="0">
340
530
<colgroup>
341
 
<col align="left" valign="top">
342
 
<col>
 
531
<col width="150px" class="parameters_name">
 
532
<col class="parameters_description">
 
533
<col width="200px" class="parameters_annotations">
343
534
</colgroup>
344
535
<tbody>
345
536
<tr>
346
 
<td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
347
 
<td>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.</td>
348
 
</tr>
349
 
<tr>
350
 
<td><p><span class="term"><em class="parameter"><code>wc</code></em> :</span></p></td>
351
 
<td>a Unicode character.</td>
352
 
</tr>
353
 
<tr>
354
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
355
 
<td>the glyph index for <em class="parameter"><code>wc</code></em>.</td>
 
537
<td class="parameter_name"><p>font</p></td>
 
538
<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.</p></td>
 
539
<td class="parameter_annotations"> </td>
 
540
</tr>
 
541
<tr>
 
542
<td class="parameter_name"><p>wc</p></td>
 
543
<td class="parameter_description"><p>a Unicode character.</p></td>
 
544
<td class="parameter_annotations"> </td>
356
545
</tr>
357
546
</tbody>
358
547
</table></div>
359
548
</div>
 
549
<div class="refsect3">
 
550
<a name="id-1.3.2.6.8.7"></a><h4>Returns</h4>
 
551
<p> the glyph index for <em class="parameter"><code>wc</code></em>
 
552
.</p>
 
553
<p></p>
 
554
</div>
 
555
</div>
360
556
<hr>
361
557
<div class="refsect2">
362
 
<a name="pango-win32-font-select-font"></a><h3>pango_win32_font_select_font ()</h3>
363
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            pango_win32_font_select_font        (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,
364
 
                                                         <em class="parameter"><code><span class="type">HDC</span> hdc</code></em>);</pre>
365
 
<p>
366
 
Selects the font into the specified DC and changes the mapping mode
 
558
<a name="pango-win32-font-select-font"></a><h3>pango_win32_font_select_font ()</h3>
 
559
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 
560
pango_win32_font_select_font (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,
 
561
                              <em class="parameter"><code><span class="type">HDC</span> hdc</code></em>);</pre>
 
562
<p>Selects the font into the specified DC and changes the mapping mode
367
563
and world transformation of the DC appropriately for the font.
368
564
You may want to surround the use of this function with calls
369
 
to <code class="function">SaveDC()</code> and <code class="function">RestoreDC()</code>. Call <a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-done-font" title="pango_win32_font_done_font ()"><code class="function">pango_win32_font_done_font()</code></a> when
 
565
to <code class="function">SaveDC()</code> and <code class="function">RestoreDC()</code>. Call <a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-done-font" title="pango_win32_font_done_font ()"><code class="function">pango_win32_font_done_font()</code></a> when
370
566
you are done using the DC to release allocated resources.</p>
371
 
<p>
372
 
See <a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-get-metrics-factor" title="pango_win32_font_get_metrics_factor ()"><code class="function">pango_win32_font_get_metrics_factor()</code></a> for information about
 
567
<p>See <a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-get-metrics-factor" title="pango_win32_font_get_metrics_factor ()"><code class="function">pango_win32_font_get_metrics_factor()</code></a> for information about
373
568
converting from the coordinate space used by this function
374
569
into Pango units.</p>
375
 
<div class="variablelist"><table border="0" class="variablelist">
 
570
<div class="refsect3">
 
571
<a name="id-1.3.2.6.9.6"></a><h4>Parameters</h4>
 
572
<div class="informaltable"><table width="100%" border="0">
376
573
<colgroup>
377
 
<col align="left" valign="top">
378
 
<col>
 
574
<col width="150px" class="parameters_name">
 
575
<col class="parameters_description">
 
576
<col width="200px" class="parameters_annotations">
379
577
</colgroup>
380
578
<tbody>
381
579
<tr>
382
 
<td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
383
 
<td>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> from the Win32 backend</td>
384
 
</tr>
385
 
<tr>
386
 
<td><p><span class="term"><em class="parameter"><code>hdc</code></em> :</span></p></td>
387
 
<td>a windows device context</td>
388
 
</tr>
389
 
<tr>
390
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
391
 
<td>
392
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation succeeded.</td>
 
580
<td class="parameter_name"><p>font</p></td>
 
581
<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> from the Win32 backend</p></td>
 
582
<td class="parameter_annotations"> </td>
 
583
</tr>
 
584
<tr>
 
585
<td class="parameter_name"><p>hdc</p></td>
 
586
<td class="parameter_description"><p>a windows device context</p></td>
 
587
<td class="parameter_annotations"> </td>
393
588
</tr>
394
589
</tbody>
395
590
</table></div>
396
591
</div>
 
592
<div class="refsect3">
 
593
<a name="id-1.3.2.6.9.7"></a><h4>Returns</h4>
 
594
<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation succeeded.</p>
 
595
<p></p>
 
596
</div>
 
597
</div>
397
598
<hr>
398
599
<div class="refsect2">
399
 
<a name="pango-win32-font-done-font"></a><h3>pango_win32_font_done_font ()</h3>
400
 
<pre class="programlisting"><span class="returnvalue">void</span>                pango_win32_font_done_font          (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>);</pre>
401
 
<p>
402
 
Releases any resources allocated by <a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-done-font" title="pango_win32_font_done_font ()"><code class="function">pango_win32_font_done_font()</code></a></p>
403
 
<div class="variablelist"><table border="0" class="variablelist">
 
600
<a name="pango-win32-font-done-font"></a><h3>pango_win32_font_done_font ()</h3>
 
601
<pre class="programlisting"><span class="returnvalue">void</span>
 
602
pango_win32_font_done_font (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>);</pre>
 
603
<p>Releases any resources allocated by <a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-done-font" title="pango_win32_font_done_font ()"><code class="function">pango_win32_font_done_font()</code></a></p>
 
604
<div class="refsect3">
 
605
<a name="id-1.3.2.6.10.5"></a><h4>Parameters</h4>
 
606
<div class="informaltable"><table width="100%" border="0">
404
607
<colgroup>
405
 
<col align="left" valign="top">
406
 
<col>
 
608
<col width="150px" class="parameters_name">
 
609
<col class="parameters_description">
 
610
<col width="200px" class="parameters_annotations">
407
611
</colgroup>
408
612
<tbody><tr>
409
 
<td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
410
 
<td>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> from the win32 backend</td>
 
613
<td class="parameter_name"><p>font</p></td>
 
614
<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> from the win32 backend</p></td>
 
615
<td class="parameter_annotations"> </td>
411
616
</tr></tbody>
412
617
</table></div>
413
618
</div>
 
619
</div>
414
620
<hr>
415
621
<div class="refsect2">
416
 
<a name="pango-win32-font-get-metrics-factor"></a><h3>pango_win32_font_get_metrics_factor ()</h3>
417
 
<pre class="programlisting"><span class="returnvalue">double</span>              pango_win32_font_get_metrics_factor (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>);</pre>
418
 
<p>
419
 
Returns the scale factor from logical units in the coordinate
420
 
space used by <a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-select-font" title="pango_win32_font_select_font ()"><code class="function">pango_win32_font_select_font()</code></a> to Pango units
 
622
<a name="pango-win32-font-get-metrics-factor"></a><h3>pango_win32_font_get_metrics_factor ()</h3>
 
623
<pre class="programlisting"><span class="returnvalue">double</span>
 
624
pango_win32_font_get_metrics_factor (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>);</pre>
 
625
<p>Returns the scale factor from logical units in the coordinate
 
626
space used by <a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-select-font" title="pango_win32_font_select_font ()"><code class="function">pango_win32_font_select_font()</code></a> to Pango units
421
627
in user space.</p>
422
 
<div class="variablelist"><table border="0" class="variablelist">
 
628
<div class="refsect3">
 
629
<a name="id-1.3.2.6.11.5"></a><h4>Parameters</h4>
 
630
<div class="informaltable"><table width="100%" border="0">
423
631
<colgroup>
424
 
<col align="left" valign="top">
425
 
<col>
 
632
<col width="150px" class="parameters_name">
 
633
<col class="parameters_description">
 
634
<col width="200px" class="parameters_annotations">
426
635
</colgroup>
427
 
<tbody>
428
 
<tr>
429
 
<td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
430
 
<td>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> from the win32 backend</td>
431
 
</tr>
432
 
<tr>
433
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
434
 
<td>factor to multiply logical units by to get Pango
435
 
units.</td>
436
 
</tr>
437
 
</tbody>
 
636
<tbody><tr>
 
637
<td class="parameter_name"><p>font</p></td>
 
638
<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> from the win32 backend</p></td>
 
639
<td class="parameter_annotations"> </td>
 
640
</tr></tbody>
438
641
</table></div>
439
642
</div>
 
643
<div class="refsect3">
 
644
<a name="id-1.3.2.6.11.6"></a><h4>Returns</h4>
 
645
<p> factor to multiply logical units by to get Pango
 
646
units.</p>
 
647
<p></p>
 
648
</div>
 
649
</div>
440
650
<hr>
441
651
<div class="refsect2">
442
 
<a name="pango-win32-get-debug-flag"></a><h3>pango_win32_get_debug_flag ()</h3>
443
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            pango_win32_get_debug_flag          (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
444
 
<p>
445
 
Returns whether debugging is turned on.</p>
446
 
<div class="variablelist"><table border="0" class="variablelist">
447
 
<colgroup>
448
 
<col align="left" valign="top">
449
 
<col>
450
 
</colgroup>
451
 
<tbody><tr>
452
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
453
 
<td>
454
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if debugging is turned on.</td>
455
 
</tr></tbody>
456
 
</table></div>
 
652
<a name="pango-win32-get-debug-flag"></a><h3>pango_win32_get_debug_flag ()</h3>
 
653
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 
654
pango_win32_get_debug_flag (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 
655
<p>Returns whether debugging is turned on.</p>
 
656
<div class="refsect3">
 
657
<a name="id-1.3.2.6.12.5"></a><h4>Returns</h4>
 
658
<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if debugging is turned on.</p>
 
659
<p></p>
 
660
</div>
457
661
<p class="since">Since 1.2</p>
458
662
</div>
459
663
<hr>
460
664
<div class="refsect2">
461
 
<a name="pango-win32-get-dc"></a><h3>pango_win32_get_dc ()</h3>
462
 
<pre class="programlisting"><span class="returnvalue">HDC</span>                 pango_win32_get_dc                  (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
463
 
<p>
464
 
Obtains a handle to the Windows device context that is used by Pango.</p>
465
 
<div class="variablelist"><table border="0" class="variablelist">
466
 
<colgroup>
467
 
<col align="left" valign="top">
468
 
<col>
469
 
</colgroup>
470
 
<tbody><tr>
471
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
472
 
<td>A handle to the Windows device context that is used by Pango.</td>
473
 
</tr></tbody>
474
 
</table></div>
475
 
</div>
476
 
<hr>
477
 
<div class="refsect2">
478
 
<a name="PangoWin32FontCache"></a><h3>PangoWin32FontCache</h3>
479
 
<pre class="programlisting">typedef struct _PangoWin32FontCache PangoWin32FontCache;</pre>
480
 
<p>
481
 
A <a class="link" href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache" title="PangoWin32FontCache"><span class="type">PangoWin32FontCache</span></a> caches HFONTs by their LOGFONT descriptions.</p>
482
 
</div>
483
 
<hr>
484
 
<div class="refsect2">
485
 
<a name="pango-win32-font-cache-new"></a><h3>pango_win32_font_cache_new ()</h3>
486
 
<pre class="programlisting"><a class="link" href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache" title="PangoWin32FontCache"><span class="returnvalue">PangoWin32FontCache</span></a> * pango_win32_font_cache_new        (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
487
 
<p>
488
 
Creates a font cache.</p>
489
 
<div class="variablelist"><table border="0" class="variablelist">
490
 
<colgroup>
491
 
<col align="left" valign="top">
492
 
<col>
493
 
</colgroup>
494
 
<tbody><tr>
495
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
496
 
<td>The new font cache. This must be freed with
497
 
<a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-cache-free" title="pango_win32_font_cache_free ()"><code class="function">pango_win32_font_cache_free()</code></a>.</td>
498
 
</tr></tbody>
499
 
</table></div>
500
 
</div>
501
 
<hr>
502
 
<div class="refsect2">
503
 
<a name="pango-win32-font-cache-free"></a><h3>pango_win32_font_cache_free ()</h3>
504
 
<pre class="programlisting"><span class="returnvalue">void</span>                pango_win32_font_cache_free         (<em class="parameter"><code><a class="link" href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache" title="PangoWin32FontCache"><span class="type">PangoWin32FontCache</span></a> *cache</code></em>);</pre>
505
 
<p>
506
 
Frees a <a class="link" href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache" title="PangoWin32FontCache"><span class="type">PangoWin32FontCache</span></a> and all associated memory. All fonts loaded
 
665
<a name="pango-win32-get-dc"></a><h3>pango_win32_get_dc ()</h3>
 
666
<pre class="programlisting"><span class="returnvalue">HDC</span>
 
667
pango_win32_get_dc (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 
668
<p>Obtains a handle to the Windows device context that is used by Pango.</p>
 
669
<div class="refsect3">
 
670
<a name="id-1.3.2.6.13.5"></a><h4>Returns</h4>
 
671
<p> A handle to the Windows device context that is used by Pango.</p>
 
672
<p></p>
 
673
</div>
 
674
</div>
 
675
<hr>
 
676
<div class="refsect2">
 
677
<a name="pango-win32-font-cache-new"></a><h3>pango_win32_font_cache_new ()</h3>
 
678
<pre class="programlisting"><a class="link" href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache" title="PangoWin32FontCache"><span class="returnvalue">PangoWin32FontCache</span></a> *
 
679
pango_win32_font_cache_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 
680
<p>Creates a font cache.</p>
 
681
<div class="refsect3">
 
682
<a name="id-1.3.2.6.14.5"></a><h4>Returns</h4>
 
683
<p> The new font cache. This must be freed with
 
684
<a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-cache-free" title="pango_win32_font_cache_free ()"><code class="function">pango_win32_font_cache_free()</code></a>.</p>
 
685
<p></p>
 
686
</div>
 
687
</div>
 
688
<hr>
 
689
<div class="refsect2">
 
690
<a name="pango-win32-font-cache-free"></a><h3>pango_win32_font_cache_free ()</h3>
 
691
<pre class="programlisting"><span class="returnvalue">void</span>
 
692
pango_win32_font_cache_free (<em class="parameter"><code><a class="link" href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache" title="PangoWin32FontCache"><span class="type">PangoWin32FontCache</span></a> *cache</code></em>);</pre>
 
693
<p>Frees a <a class="link" href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache" title="PangoWin32FontCache"><span class="type">PangoWin32FontCache</span></a> and all associated memory. All fonts loaded
507
694
through this font cache will be freed along with the cache.</p>
508
 
<div class="variablelist"><table border="0" class="variablelist">
 
695
<div class="refsect3">
 
696
<a name="id-1.3.2.6.15.5"></a><h4>Parameters</h4>
 
697
<div class="informaltable"><table width="100%" border="0">
509
698
<colgroup>
510
 
<col align="left" valign="top">
511
 
<col>
 
699
<col width="150px" class="parameters_name">
 
700
<col class="parameters_description">
 
701
<col width="200px" class="parameters_annotations">
512
702
</colgroup>
513
703
<tbody><tr>
514
 
<td><p><span class="term"><em class="parameter"><code>cache</code></em> :</span></p></td>
515
 
<td>a <a class="link" href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache" title="PangoWin32FontCache"><span class="type">PangoWin32FontCache</span></a>
516
 
</td>
 
704
<td class="parameter_name"><p>cache</p></td>
 
705
<td class="parameter_description"><p>a <a class="link" href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache" title="PangoWin32FontCache"><span class="type">PangoWin32FontCache</span></a></p></td>
 
706
<td class="parameter_annotations"> </td>
517
707
</tr></tbody>
518
708
</table></div>
519
709
</div>
520
 
<hr>
521
 
<div class="refsect2">
522
 
<a name="pango-win32-font-cache-load"></a><h3>pango_win32_font_cache_load ()</h3>
523
 
<pre class="programlisting"><span class="returnvalue">HFONT</span>               pango_win32_font_cache_load         (<em class="parameter"><code><a class="link" href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache" title="PangoWin32FontCache"><span class="type">PangoWin32FontCache</span></a> *cache</code></em>,
524
 
                                                         <em class="parameter"><code>const <span class="type">LOGFONTA</span> *logfont</code></em>);</pre>
525
 
<p>
526
 
Creates a HFONT from a LOGFONTA. The
527
 
result may be newly loaded, or it may have been previously
528
 
stored</p>
529
 
<div class="variablelist"><table border="0" class="variablelist">
530
 
<colgroup>
531
 
<col align="left" valign="top">
532
 
<col>
533
 
</colgroup>
534
 
<tbody>
535
 
<tr>
536
 
<td><p><span class="term"><em class="parameter"><code>cache</code></em> :</span></p></td>
537
 
<td>a <a class="link" href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache" title="PangoWin32FontCache"><span class="type">PangoWin32FontCache</span></a>
538
 
</td>
539
 
</tr>
540
 
<tr>
541
 
<td><p><span class="term"><em class="parameter"><code>logfont</code></em> :</span></p></td>
542
 
<td>a pointer to a LOGFONTA structure describing the font to load.</td>
543
 
</tr>
544
 
<tr>
545
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
546
 
<td>The font structure, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the font could
547
 
not be loaded. In order to free this structure, you must call
548
 
<a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-cache-unload" title="pango_win32_font_cache_unload ()"><code class="function">pango_win32_font_cache_unload()</code></a>.</td>
549
 
</tr>
550
 
</tbody>
551
 
</table></div>
552
 
</div>
553
 
<hr>
554
 
<div class="refsect2">
555
 
<a name="pango-win32-font-cache-loadw"></a><h3>pango_win32_font_cache_loadw ()</h3>
556
 
<pre class="programlisting"><span class="returnvalue">HFONT</span>               pango_win32_font_cache_loadw        (<em class="parameter"><code><a class="link" href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache" title="PangoWin32FontCache"><span class="type">PangoWin32FontCache</span></a> *cache</code></em>,
557
 
                                                         <em class="parameter"><code>const <span class="type">LOGFONTW</span> *logfont</code></em>);</pre>
558
 
<p>
559
 
Creates a HFONT from a LOGFONTW. The
560
 
result may be newly loaded, or it may have been previously
561
 
stored</p>
562
 
<div class="variablelist"><table border="0" class="variablelist">
563
 
<colgroup>
564
 
<col align="left" valign="top">
565
 
<col>
566
 
</colgroup>
567
 
<tbody>
568
 
<tr>
569
 
<td><p><span class="term"><em class="parameter"><code>cache</code></em> :</span></p></td>
570
 
<td>a <a class="link" href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache" title="PangoWin32FontCache"><span class="type">PangoWin32FontCache</span></a>
571
 
</td>
572
 
</tr>
573
 
<tr>
574
 
<td><p><span class="term"><em class="parameter"><code>logfont</code></em> :</span></p></td>
575
 
<td>a pointer to a LOGFONTW structure describing the font to load.</td>
576
 
</tr>
577
 
<tr>
578
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
579
 
<td>The font structure, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the font could
580
 
not be loaded. In order to free this structure, you must call
581
 
<a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-cache-unload" title="pango_win32_font_cache_unload ()"><code class="function">pango_win32_font_cache_unload()</code></a>.</td>
582
 
</tr>
583
 
</tbody>
584
 
</table></div>
 
710
</div>
 
711
<hr>
 
712
<div class="refsect2">
 
713
<a name="pango-win32-font-cache-load"></a><h3>pango_win32_font_cache_load ()</h3>
 
714
<pre class="programlisting"><span class="returnvalue">HFONT</span>
 
715
pango_win32_font_cache_load (<em class="parameter"><code><a class="link" href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache" title="PangoWin32FontCache"><span class="type">PangoWin32FontCache</span></a> *cache</code></em>,
 
716
                             <em class="parameter"><code>const <span class="type">LOGFONTA</span> *logfont</code></em>);</pre>
 
717
<p>Creates a HFONT from a LOGFONTA. The
 
718
result may be newly loaded, or it may have been previously
 
719
stored</p>
 
720
<div class="refsect3">
 
721
<a name="id-1.3.2.6.16.5"></a><h4>Parameters</h4>
 
722
<div class="informaltable"><table width="100%" border="0">
 
723
<colgroup>
 
724
<col width="150px" class="parameters_name">
 
725
<col class="parameters_description">
 
726
<col width="200px" class="parameters_annotations">
 
727
</colgroup>
 
728
<tbody>
 
729
<tr>
 
730
<td class="parameter_name"><p>cache</p></td>
 
731
<td class="parameter_description"><p>a <a class="link" href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache" title="PangoWin32FontCache"><span class="type">PangoWin32FontCache</span></a></p></td>
 
732
<td class="parameter_annotations"> </td>
 
733
</tr>
 
734
<tr>
 
735
<td class="parameter_name"><p>logfont</p></td>
 
736
<td class="parameter_description"><p>a pointer to a LOGFONTA structure describing the font to load.</p></td>
 
737
<td class="parameter_annotations"> </td>
 
738
</tr>
 
739
</tbody>
 
740
</table></div>
 
741
</div>
 
742
<div class="refsect3">
 
743
<a name="id-1.3.2.6.16.6"></a><h4>Returns</h4>
 
744
<p> The font structure, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the font could
 
745
not be loaded. In order to free this structure, you must call
 
746
<a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-cache-unload" title="pango_win32_font_cache_unload ()"><code class="function">pango_win32_font_cache_unload()</code></a>.</p>
 
747
<p></p>
 
748
</div>
 
749
</div>
 
750
<hr>
 
751
<div class="refsect2">
 
752
<a name="pango-win32-font-cache-loadw"></a><h3>pango_win32_font_cache_loadw ()</h3>
 
753
<pre class="programlisting"><span class="returnvalue">HFONT</span>
 
754
pango_win32_font_cache_loadw (<em class="parameter"><code><a class="link" href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache" title="PangoWin32FontCache"><span class="type">PangoWin32FontCache</span></a> *cache</code></em>,
 
755
                              <em class="parameter"><code>const <span class="type">LOGFONTW</span> *logfont</code></em>);</pre>
 
756
<p>Creates a HFONT from a LOGFONTW. The
 
757
result may be newly loaded, or it may have been previously
 
758
stored</p>
 
759
<div class="refsect3">
 
760
<a name="id-1.3.2.6.17.5"></a><h4>Parameters</h4>
 
761
<div class="informaltable"><table width="100%" border="0">
 
762
<colgroup>
 
763
<col width="150px" class="parameters_name">
 
764
<col class="parameters_description">
 
765
<col width="200px" class="parameters_annotations">
 
766
</colgroup>
 
767
<tbody>
 
768
<tr>
 
769
<td class="parameter_name"><p>cache</p></td>
 
770
<td class="parameter_description"><p>a <a class="link" href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache" title="PangoWin32FontCache"><span class="type">PangoWin32FontCache</span></a></p></td>
 
771
<td class="parameter_annotations"> </td>
 
772
</tr>
 
773
<tr>
 
774
<td class="parameter_name"><p>logfont</p></td>
 
775
<td class="parameter_description"><p>a pointer to a LOGFONTW structure describing the font to load.</p></td>
 
776
<td class="parameter_annotations"> </td>
 
777
</tr>
 
778
</tbody>
 
779
</table></div>
 
780
</div>
 
781
<div class="refsect3">
 
782
<a name="id-1.3.2.6.17.6"></a><h4>Returns</h4>
 
783
<p> The font structure, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the font could
 
784
not be loaded. In order to free this structure, you must call
 
785
<a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-cache-unload" title="pango_win32_font_cache_unload ()"><code class="function">pango_win32_font_cache_unload()</code></a>.</p>
 
786
<p></p>
 
787
</div>
585
788
<p class="since">Since 1.16</p>
586
789
</div>
587
790
<hr>
588
791
<div class="refsect2">
589
 
<a name="pango-win32-font-cache-unload"></a><h3>pango_win32_font_cache_unload ()</h3>
590
 
<pre class="programlisting"><span class="returnvalue">void</span>                pango_win32_font_cache_unload       (<em class="parameter"><code><a class="link" href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache" title="PangoWin32FontCache"><span class="type">PangoWin32FontCache</span></a> *cache</code></em>,
591
 
                                                         <em class="parameter"><code><span class="type">HFONT</span> hfont</code></em>);</pre>
592
 
<p>
593
 
Frees a font structure previously loaded with <a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-cache-load" title="pango_win32_font_cache_load ()"><code class="function">pango_win32_font_cache_load()</code></a>.</p>
594
 
<div class="variablelist"><table border="0" class="variablelist">
 
792
<a name="pango-win32-font-cache-unload"></a><h3>pango_win32_font_cache_unload ()</h3>
 
793
<pre class="programlisting"><span class="returnvalue">void</span>
 
794
pango_win32_font_cache_unload (<em class="parameter"><code><a class="link" href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache" title="PangoWin32FontCache"><span class="type">PangoWin32FontCache</span></a> *cache</code></em>,
 
795
                               <em class="parameter"><code><span class="type">HFONT</span> hfont</code></em>);</pre>
 
796
<p>Frees a font structure previously loaded with <a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-cache-load" title="pango_win32_font_cache_load ()"><code class="function">pango_win32_font_cache_load()</code></a>.</p>
 
797
<div class="refsect3">
 
798
<a name="id-1.3.2.6.18.5"></a><h4>Parameters</h4>
 
799
<div class="informaltable"><table width="100%" border="0">
595
800
<colgroup>
596
 
<col align="left" valign="top">
597
 
<col>
 
801
<col width="150px" class="parameters_name">
 
802
<col class="parameters_description">
 
803
<col width="200px" class="parameters_annotations">
598
804
</colgroup>
599
805
<tbody>
600
806
<tr>
601
 
<td><p><span class="term"><em class="parameter"><code>cache</code></em> :</span></p></td>
602
 
<td>a <a class="link" href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache" title="PangoWin32FontCache"><span class="type">PangoWin32FontCache</span></a>
603
 
</td>
 
807
<td class="parameter_name"><p>cache</p></td>
 
808
<td class="parameter_description"><p>a <a class="link" href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache" title="PangoWin32FontCache"><span class="type">PangoWin32FontCache</span></a></p></td>
 
809
<td class="parameter_annotations"> </td>
604
810
</tr>
605
811
<tr>
606
 
<td><p><span class="term"><em class="parameter"><code>hfont</code></em> :</span></p></td>
607
 
<td>the HFONT to unload</td>
 
812
<td class="parameter_name"><p>hfont</p></td>
 
813
<td class="parameter_description"><p>the HFONT to unload</p></td>
 
814
<td class="parameter_annotations"> </td>
608
815
</tr>
609
816
</tbody>
610
817
</table></div>
611
818
</div>
 
819
</div>
612
820
<hr>
613
821
<div class="refsect2">
614
 
<a name="pango-win32-font-map-for-display"></a><h3>pango_win32_font_map_for_display ()</h3>
615
 
<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontMap"><span class="returnvalue">PangoFontMap</span></a> *      pango_win32_font_map_for_display    (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
616
 
<p>
617
 
Returns a <span class="type">PangoWin32FontMap</span>. Font maps are cached and should
 
822
<a name="pango-win32-font-map-for-display"></a><h3>pango_win32_font_map_for_display ()</h3>
 
823
<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontMap"><span class="returnvalue">PangoFontMap</span></a> *
 
824
pango_win32_font_map_for_display (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 
825
<p>Returns a <span class="type">PangoWin32FontMap</span>. Font maps are cached and should
618
826
not be freed. If the font map is no longer needed, it can
619
 
be released with <a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-shutdown-display" title="pango_win32_shutdown_display ()"><code class="function">pango_win32_shutdown_display()</code></a>.</p>
620
 
<div class="variablelist"><table border="0" class="variablelist">
 
827
be released with <a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-shutdown-display" title="pango_win32_shutdown_display ()"><code class="function">pango_win32_shutdown_display()</code></a>.</p>
 
828
<div class="refsect3">
 
829
<a name="id-1.3.2.6.19.5"></a><h4>Returns</h4>
 
830
<p> a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>.</p>
 
831
<p></p>
 
832
</div>
 
833
</div>
 
834
<hr>
 
835
<div class="refsect2">
 
836
<a name="pango-win32-shutdown-display"></a><h3>pango_win32_shutdown_display ()</h3>
 
837
<pre class="programlisting"><span class="returnvalue">void</span>
 
838
pango_win32_shutdown_display (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 
839
<p>Free cached resources.</p>
 
840
</div>
 
841
<hr>
 
842
<div class="refsect2">
 
843
<a name="pango-win32-font-map-get-font-cache"></a><h3>pango_win32_font_map_get_font_cache ()</h3>
 
844
<pre class="programlisting"><a class="link" href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache" title="PangoWin32FontCache"><span class="returnvalue">PangoWin32FontCache</span></a> *
 
845
pango_win32_font_map_get_font_cache (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> *font_map</code></em>);</pre>
 
846
<p>Obtains the font cache associated with the given font map.</p>
 
847
<div class="refsect3">
 
848
<a name="id-1.3.2.6.21.5"></a><h4>Parameters</h4>
 
849
<div class="informaltable"><table width="100%" border="0">
621
850
<colgroup>
622
 
<col align="left" valign="top">
623
 
<col>
 
851
<col width="150px" class="parameters_name">
 
852
<col class="parameters_description">
 
853
<col width="200px" class="parameters_annotations">
624
854
</colgroup>
625
855
<tbody><tr>
626
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
627
 
<td>a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>.</td>
 
856
<td class="parameter_name"><p>font_map</p></td>
 
857
<td class="parameter_description"><p>a <span class="type">PangoWin32FontMap</span>.</p></td>
 
858
<td class="parameter_annotations"> </td>
628
859
</tr></tbody>
629
860
</table></div>
630
861
</div>
631
 
<hr>
632
 
<div class="refsect2">
633
 
<a name="pango-win32-shutdown-display"></a><h3>pango_win32_shutdown_display ()</h3>
634
 
<pre class="programlisting"><span class="returnvalue">void</span>                pango_win32_shutdown_display        (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
635
 
<p>
636
 
Free cached resources.</p>
637
 
</div>
638
 
<hr>
639
 
<div class="refsect2">
640
 
<a name="pango-win32-font-map-get-font-cache"></a><h3>pango_win32_font_map_get_font_cache ()</h3>
641
 
<pre class="programlisting"><a class="link" href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache" title="PangoWin32FontCache"><span class="returnvalue">PangoWin32FontCache</span></a> * pango_win32_font_map_get_font_cache
642
 
                                                        (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> *font_map</code></em>);</pre>
643
 
<p>
644
 
Obtains the font cache associated with the given font map.</p>
645
 
<div class="variablelist"><table border="0" class="variablelist">
646
 
<colgroup>
647
 
<col align="left" valign="top">
648
 
<col>
649
 
</colgroup>
650
 
<tbody>
651
 
<tr>
652
 
<td><p><span class="term"><em class="parameter"><code>font_map</code></em> :</span></p></td>
653
 
<td>a <span class="type">PangoWin32FontMap</span>.</td>
654
 
</tr>
655
 
<tr>
656
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
657
 
<td>the <a class="link" href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache" title="PangoWin32FontCache"><span class="type">PangoWin32FontCache</span></a> of <em class="parameter"><code>font_map</code></em>.</td>
658
 
</tr>
659
 
</tbody>
660
 
</table></div>
661
 
</div>
662
 
<hr>
663
 
<div class="refsect2">
664
 
<a name="pango-win32-font-logfont"></a><h3>pango_win32_font_logfont ()</h3>
665
 
<pre class="programlisting"><span class="returnvalue">LOGFONTA</span> *          pango_win32_font_logfont            (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>);</pre>
666
 
<p>
667
 
Determine the LOGFONTA struct for the specified font. Note that
 
862
<div class="refsect3">
 
863
<a name="id-1.3.2.6.21.6"></a><h4>Returns</h4>
 
864
<p> the <a class="link" href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache" title="PangoWin32FontCache"><span class="type">PangoWin32FontCache</span></a> of <em class="parameter"><code>font_map</code></em>
 
865
.</p>
 
866
<p></p>
 
867
</div>
 
868
</div>
 
869
<hr>
 
870
<div class="refsect2">
 
871
<a name="pango-win32-font-logfont"></a><h3>pango_win32_font_logfont ()</h3>
 
872
<pre class="programlisting"><span class="returnvalue">LOGFONTA</span> *
 
873
pango_win32_font_logfont (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>);</pre>
 
874
<p>Determine the LOGFONTA struct for the specified font. Note that
668
875
Pango internally uses LOGFONTW structs, so if converting the UTF-16
669
876
face name in the LOGFONTW struct to system codepage fails, the
670
877
returned LOGFONTA will have an emppty face name. To get the
671
 
LOGFONTW of a PangoFont, use <a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-logfontw" title="pango_win32_font_logfontw ()"><code class="function">pango_win32_font_logfontw()</code></a>. It
 
878
LOGFONTW of a PangoFont, use <a class="link" href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-logfontw" title="pango_win32_font_logfontw ()"><code class="function">pango_win32_font_logfontw()</code></a>. It
672
879
is recommended to do that always even if you don't expect
673
880
to come across fonts with odd names.</p>
674
 
<div class="variablelist"><table border="0" class="variablelist">
 
881
<div class="refsect3">
 
882
<a name="id-1.3.2.6.22.5"></a><h4>Parameters</h4>
 
883
<div class="informaltable"><table width="100%" border="0">
675
884
<colgroup>
676
 
<col align="left" valign="top">
677
 
<col>
 
885
<col width="150px" class="parameters_name">
 
886
<col class="parameters_description">
 
887
<col width="200px" class="parameters_annotations">
678
888
</colgroup>
679
 
<tbody>
680
 
<tr>
681
 
<td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
682
 
<td>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> which must be from the Win32 backend</td>
683
 
</tr>
684
 
<tr>
685
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
686
 
<td>A newly allocated LOGFONTA struct. It must be
687
 
freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.</td>
688
 
</tr>
689
 
</tbody>
 
889
<tbody><tr>
 
890
<td class="parameter_name"><p>font</p></td>
 
891
<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> which must be from the Win32 backend</p></td>
 
892
<td class="parameter_annotations"> </td>
 
893
</tr></tbody>
690
894
</table></div>
691
895
</div>
 
896
<div class="refsect3">
 
897
<a name="id-1.3.2.6.22.6"></a><h4>Returns</h4>
 
898
<p> A newly allocated LOGFONTA struct. It must be
 
899
freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.</p>
 
900
<p></p>
 
901
</div>
 
902
</div>
692
903
<hr>
693
904
<div class="refsect2">
694
 
<a name="pango-win32-font-logfontw"></a><h3>pango_win32_font_logfontw ()</h3>
695
 
<pre class="programlisting"><span class="returnvalue">LOGFONTW</span> *          pango_win32_font_logfontw           (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>);</pre>
696
 
<p>
697
 
Determine the LOGFONTW struct for the specified font.</p>
698
 
<div class="variablelist"><table border="0" class="variablelist">
 
905
<a name="pango-win32-font-logfontw"></a><h3>pango_win32_font_logfontw ()</h3>
 
906
<pre class="programlisting"><span class="returnvalue">LOGFONTW</span> *
 
907
pango_win32_font_logfontw (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>);</pre>
 
908
<p>Determine the LOGFONTW struct for the specified font.</p>
 
909
<div class="refsect3">
 
910
<a name="id-1.3.2.6.23.5"></a><h4>Parameters</h4>
 
911
<div class="informaltable"><table width="100%" border="0">
699
912
<colgroup>
700
 
<col align="left" valign="top">
701
 
<col>
 
913
<col width="150px" class="parameters_name">
 
914
<col class="parameters_description">
 
915
<col width="200px" class="parameters_annotations">
702
916
</colgroup>
703
 
<tbody>
704
 
<tr>
705
 
<td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
706
 
<td>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> which must be from the Win32 backend</td>
707
 
</tr>
708
 
<tr>
709
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
710
 
<td>A newly allocated LOGFONTW struct. It must be
711
 
freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.</td>
712
 
</tr>
713
 
</tbody>
 
917
<tbody><tr>
 
918
<td class="parameter_name"><p>font</p></td>
 
919
<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> which must be from the Win32 backend</p></td>
 
920
<td class="parameter_annotations"> </td>
 
921
</tr></tbody>
714
922
</table></div>
 
923
</div>
 
924
<div class="refsect3">
 
925
<a name="id-1.3.2.6.23.6"></a><h4>Returns</h4>
 
926
<p> A newly allocated LOGFONTW struct. It must be
 
927
freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.</p>
 
928
<p></p>
 
929
</div>
715
930
<p class="since">Since 1.16</p>
716
931
</div>
717
932
<hr>
718
933
<div class="refsect2">
719
 
<a name="pango-win32-font-description-from-logfont"></a><h3>pango_win32_font_description_from_logfont ()</h3>
720
 
<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> * pango_win32_font_description_from_logfont
721
 
                                                        (<em class="parameter"><code>const <span class="type">LOGFONTA</span> *lfp</code></em>);</pre>
722
 
<p>
723
 
Creates a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> that matches the specified LOGFONTA.</p>
724
 
<p>
725
 
The face name, italicness and weight fields in the LOGFONTA are used
 
934
<a name="pango-win32-font-description-from-logfont"></a><h3>pango_win32_font_description_from_logfont ()</h3>
 
935
<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> *
 
936
pango_win32_font_description_from_logfont
 
937
                               (<em class="parameter"><code>const <span class="type">LOGFONTA</span> *lfp</code></em>);</pre>
 
938
<p>Creates a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> that matches the specified LOGFONTA.</p>
 
939
<p>The face name, italicness and weight fields in the LOGFONTA are used
726
940
to set up the resulting <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>. If the face name in
727
941
the LOGFONTA contains non-ASCII characters the font is temporarily
728
942
loaded (using <code class="function">CreateFontIndirect()</code>) and an ASCII (usually English)
729
943
name for it is looked up from the font name tables in the font
730
944
data. If that doesn't work, the face name is converted from the
731
945
system codepage to UTF-8 and that is used.</p>
732
 
<div class="variablelist"><table border="0" class="variablelist">
 
946
<div class="refsect3">
 
947
<a name="id-1.3.2.6.24.6"></a><h4>Parameters</h4>
 
948
<div class="informaltable"><table width="100%" border="0">
733
949
<colgroup>
734
 
<col align="left" valign="top">
735
 
<col>
 
950
<col width="150px" class="parameters_name">
 
951
<col class="parameters_description">
 
952
<col width="200px" class="parameters_annotations">
736
953
</colgroup>
737
 
<tbody>
738
 
<tr>
739
 
<td><p><span class="term"><em class="parameter"><code>lfp</code></em> :</span></p></td>
740
 
<td>a LOGFONTA</td>
741
 
</tr>
742
 
<tr>
743
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
744
 
<td>the newly allocated <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>, which
745
 
should be freed using <a class="link" href="pango-Fonts.html#pango-font-description-free" title="pango_font_description_free ()"><code class="function">pango_font_description_free()</code></a>
746
 
</td>
747
 
</tr>
748
 
</tbody>
 
954
<tbody><tr>
 
955
<td class="parameter_name"><p>lfp</p></td>
 
956
<td class="parameter_description"><p>a LOGFONTA</p></td>
 
957
<td class="parameter_annotations"> </td>
 
958
</tr></tbody>
749
959
</table></div>
 
960
</div>
 
961
<div class="refsect3">
 
962
<a name="id-1.3.2.6.24.7"></a><h4>Returns</h4>
 
963
<p> the newly allocated <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>, which
 
964
should be freed using <a class="link" href="pango-Fonts.html#pango-font-description-free" title="pango_font_description_free ()"><code class="function">pango_font_description_free()</code></a></p>
 
965
<p></p>
 
966
</div>
750
967
<p class="since">Since 1.12</p>
751
968
</div>
752
969
<hr>
753
970
<div class="refsect2">
754
 
<a name="pango-win32-font-description-from-logfontw"></a><h3>pango_win32_font_description_from_logfontw ()</h3>
755
 
<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> * pango_win32_font_description_from_logfontw
756
 
                                                        (<em class="parameter"><code>const <span class="type">LOGFONTW</span> *lfp</code></em>);</pre>
757
 
<p>
758
 
Creates a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> that matches the specified LOGFONTW.</p>
759
 
<p>
760
 
The face name, italicness and weight fields in the LOGFONTW are used
 
971
<a name="pango-win32-font-description-from-logfontw"></a><h3>pango_win32_font_description_from_logfontw ()</h3>
 
972
<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> *
 
973
pango_win32_font_description_from_logfontw
 
974
                               (<em class="parameter"><code>const <span class="type">LOGFONTW</span> *lfp</code></em>);</pre>
 
975
<p>Creates a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> that matches the specified LOGFONTW.</p>
 
976
<p>The face name, italicness and weight fields in the LOGFONTW are used
761
977
to set up the resulting <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>. If the face name in
762
978
the LOGFONTW contains non-ASCII characters the font is temporarily
763
979
loaded (using <code class="function">CreateFontIndirect()</code>) and an ASCII (usually English)
764
980
name for it is looked up from the font name tables in the font
765
981
data. If that doesn't work, the face name is converted from UTF-16
766
982
to UTF-8 and that is used.</p>
767
 
<div class="variablelist"><table border="0" class="variablelist">
 
983
<div class="refsect3">
 
984
<a name="id-1.3.2.6.25.6"></a><h4>Parameters</h4>
 
985
<div class="informaltable"><table width="100%" border="0">
768
986
<colgroup>
769
 
<col align="left" valign="top">
770
 
<col>
 
987
<col width="150px" class="parameters_name">
 
988
<col class="parameters_description">
 
989
<col width="200px" class="parameters_annotations">
771
990
</colgroup>
772
 
<tbody>
773
 
<tr>
774
 
<td><p><span class="term"><em class="parameter"><code>lfp</code></em> :</span></p></td>
775
 
<td>a LOGFONTW</td>
776
 
</tr>
777
 
<tr>
778
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
779
 
<td>the newly allocated <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>, which
780
 
should be freed using <a class="link" href="pango-Fonts.html#pango-font-description-free" title="pango_font_description_free ()"><code class="function">pango_font_description_free()</code></a>
781
 
</td>
782
 
</tr>
783
 
</tbody>
 
991
<tbody><tr>
 
992
<td class="parameter_name"><p>lfp</p></td>
 
993
<td class="parameter_description"><p>a LOGFONTW</p></td>
 
994
<td class="parameter_annotations"> </td>
 
995
</tr></tbody>
784
996
</table></div>
 
997
</div>
 
998
<div class="refsect3">
 
999
<a name="id-1.3.2.6.25.7"></a><h4>Returns</h4>
 
1000
<p> the newly allocated <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>, which
 
1001
should be freed using <a class="link" href="pango-Fonts.html#pango-font-description-free" title="pango_font_description_free ()"><code class="function">pango_font_description_free()</code></a></p>
 
1002
<p></p>
 
1003
</div>
785
1004
<p class="since">Since 1.16</p>
786
1005
</div>
787
1006
</div>
 
1007
<div class="refsect1">
 
1008
<a name="pango-Win32-Fonts-and-Rendering.other_details"></a><h2>Types and Values</h2>
 
1009
<div class="refsect2">
 
1010
<a name="PANGO-RENDER-TYPE-WIN32:CAPS"></a><h3>PANGO_RENDER_TYPE_WIN32</h3>
 
1011
<pre class="programlisting">#define PANGO_RENDER_TYPE_WIN32 "PangoRenderWin32"
 
1012
</pre>
 
1013
<p>A string constant identifying the Win32 renderer. The associated quark (see
 
1014
<a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#g-quark-from-string"><code class="function">g_quark_from_string()</code></a>) is used to identify the renderer in <a class="link" href="pango-Modules.html#pango-find-map" title="pango_find_map ()"><code class="function">pango_find_map()</code></a>.</p>
 
1015
</div>
 
1016
<hr>
 
1017
<div class="refsect2">
 
1018
<a name="PangoWin32FontCache"></a><h3>PangoWin32FontCache</h3>
 
1019
<pre class="programlisting">typedef struct _PangoWin32FontCache PangoWin32FontCache;</pre>
 
1020
<p>A <a class="link" href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache" title="PangoWin32FontCache"><span class="type">PangoWin32FontCache</span></a> caches HFONTs by their LOGFONT descriptions.</p>
 
1021
</div>
 
1022
</div>
788
1023
</div>
789
1024
<div class="footer">
790
1025
<hr>
791
 
          Generated by GTK-Doc V1.19.1</div>
 
1026
          Generated by GTK-Doc V1.20.1</div>
792
1027
</body>
793
1028
</html>
 
 
b'\\ No newline at end of file'