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>
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>);
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">
38
<col width="150px" class="functions_return">
39
<col class="functions_name">
43
<td class="function_type">
44
<a class="link" href="pango-Text-Processing.html#PangoContext"><span class="returnvalue">PangoContext</span></a> *
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>
51
<td class="function_type">
52
<span class="returnvalue">void</span>
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>
59
<td class="function_type">
60
<span class="returnvalue">void</span>
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>
67
<td class="function_type">
68
<span class="returnvalue">void</span>
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>
75
<td class="function_type">
76
<span class="returnvalue">void</span>
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>
83
<td class="function_type">
84
<a class="link" href="pango-Glyph-Storage.html#PangoGlyph" title="PangoGlyph"><span class="returnvalue">PangoGlyph</span></a>
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>
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>
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>
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>
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>
107
<td class="function_type">
108
<span class="returnvalue">void</span>
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>
115
<td class="function_type">
116
<span class="returnvalue">double</span>
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>
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>
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>
131
<td class="function_type">
132
<span class="returnvalue">HDC</span>
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>
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> *
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>
147
<td class="function_type">
148
<span class="returnvalue">void</span>
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>
155
<td class="function_type">
156
<span class="returnvalue">HFONT</span>
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>
163
<td class="function_type">
164
<span class="returnvalue">HFONT</span>
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>
171
<td class="function_type">
172
<span class="returnvalue">void</span>
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>
179
<td class="function_type">
180
<a class="link" href="pango-Fonts.html#PangoFontMap"><span class="returnvalue">PangoFontMap</span></a> *
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>
187
<td class="function_type">
188
<span class="returnvalue">void</span>
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>
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> *
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>
203
<td class="function_type">
204
<span class="returnvalue">LOGFONTA</span> *
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>
211
<td class="function_type">
212
<span class="returnvalue">LOGFONTW</span> *
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>
219
<td class="function_type">
220
<a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> *
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>
227
<td class="function_type">
228
<a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> *
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>
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">
241
<col width="150px" class="name">
242
<col class="description">
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>
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>
89
256
<div class="refsect1">
90
257
<a name="pango-Win32-Fonts-and-Rendering.description"></a><h2>Description</h2>
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>
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"
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>
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>
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">
118
<col align="left" valign="top">
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>
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>
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>
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>
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">
140
<col align="left" valign="top">
293
<col width="150px" class="parameters_name">
294
<col class="parameters_description">
295
<col width="200px" class="parameters_annotations">
145
<td><p><span class="term"><em class="parameter"><code>hdc</code></em> :</span></p></td>
146
<td>the device context</td>
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>
153
<td><p><span class="term"><em class="parameter"><code>glyphs</code></em> :</span></p></td>
154
<td>the glyph string to draw</td>
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>
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>
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>
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>
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>
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>
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>
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>
180
341
changed, so to produce correct rendering results, the <em class="parameter"><code>font</code></em>
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">
185
<col align="left" valign="top">
349
<col width="150px" class="parameters_name">
350
<col class="parameters_description">
351
<col width="200px" class="parameters_annotations">
190
<td><p><span class="term"><em class="parameter"><code>hdc</code></em> :</span></p></td>
191
<td>a windows device context</td>
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>
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>
202
<td><p><span class="term"><em class="parameter"><code>glyphs</code></em> :</span></p></td>
203
<td>the glyph string to draw</td>
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>
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>
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>
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>
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>
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>
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>
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>
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
229
<div class="variablelist"><table border="0" class="variablelist">
231
<col align="left" valign="top">
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>
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>
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>
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>
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>
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">
266
<col align="left" valign="top">
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>
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>
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>
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>
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>
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">
405
<col width="150px" class="parameters_name">
406
<col class="parameters_description">
407
<col width="200px" class="parameters_annotations">
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>
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>
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>
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>
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">
447
<col width="150px" class="parameters_name">
448
<col class="parameters_description">
449
<col width="200px" class="parameters_annotations">
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>
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>
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>
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>
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>
301
485
unknown character.</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">
306
<col align="left" valign="top">
491
<col width="150px" class="parameters_name">
492
<col class="parameters_description">
493
<col width="200px" class="parameters_annotations">
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>
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>
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>
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>
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>
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>
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>
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>
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">
341
<col align="left" valign="top">
531
<col width="150px" class="parameters_name">
532
<col class="parameters_description">
533
<col width="200px" class="parameters_annotations">
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>
350
<td><p><span class="term"><em class="parameter"><code>wc</code></em> :</span></p></td>
351
<td>a Unicode character.</td>
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>
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>
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>
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>
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>
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">
377
<col align="left" valign="top">
574
<col width="150px" class="parameters_name">
575
<col class="parameters_description">
576
<col width="200px" class="parameters_annotations">
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>
386
<td><p><span class="term"><em class="parameter"><code>hdc</code></em> :</span></p></td>
387
<td>a windows device context</td>
390
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></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>
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>
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>
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>
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">
405
<col align="left" valign="top">
608
<col width="150px" class="parameters_name">
609
<col class="parameters_description">
610
<col width="200px" class="parameters_annotations">
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>
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>
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">
424
<col align="left" valign="top">
632
<col width="150px" class="parameters_name">
633
<col class="parameters_description">
634
<col width="200px" class="parameters_annotations">
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>
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
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>
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
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>
445
Returns whether debugging is turned on.</p>
446
<div class="variablelist"><table border="0" class="variablelist">
448
<col align="left" valign="top">
452
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></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>
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>
457
661
<p class="since">Since 1.2</p>
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>
464
Obtains a handle to the Windows device context that is used by Pango.</p>
465
<div class="variablelist"><table border="0" class="variablelist">
467
<col align="left" valign="top">
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>
477
<div class="refsect2">
478
<a name="PangoWin32FontCache"></a><h3>PangoWin32FontCache</h3>
479
<pre class="programlisting">typedef struct _PangoWin32FontCache PangoWin32FontCache;</pre>
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>
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>
488
Creates a font cache.</p>
489
<div class="variablelist"><table border="0" class="variablelist">
491
<col align="left" valign="top">
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>
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>
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>
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>
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">
510
<col align="left" valign="top">
699
<col width="150px" class="parameters_name">
700
<col class="parameters_description">
701
<col width="200px" class="parameters_annotations">
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>
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>
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>
526
Creates a HFONT from a LOGFONTA. The
527
result may be newly loaded, or it may have been previously
529
<div class="variablelist"><table border="0" class="variablelist">
531
<col align="left" valign="top">
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>
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>
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>
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>
559
Creates a HFONT from a LOGFONTW. The
560
result may be newly loaded, or it may have been previously
562
<div class="variablelist"><table border="0" class="variablelist">
564
<col align="left" valign="top">
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>
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>
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>
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
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">
724
<col width="150px" class="parameters_name">
725
<col class="parameters_description">
726
<col width="200px" class="parameters_annotations">
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>
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>
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>
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
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">
763
<col width="150px" class="parameters_name">
764
<col class="parameters_description">
765
<col width="200px" class="parameters_annotations">
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>
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>
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>
585
788
<p class="since">Since 1.16</p>
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>
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">
596
<col align="left" valign="top">
801
<col width="150px" class="parameters_name">
802
<col class="parameters_description">
803
<col width="200px" class="parameters_annotations">
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>
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>
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>
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>
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>
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>
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">
622
<col align="left" valign="top">
851
<col width="150px" class="parameters_name">
852
<col class="parameters_description">
853
<col width="200px" class="parameters_annotations">
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>
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>
636
Free cached resources.</p>
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>
644
Obtains the font cache associated with the given font map.</p>
645
<div class="variablelist"><table border="0" class="variablelist">
647
<col align="left" valign="top">
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>
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>
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>
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>
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">
676
<col align="left" valign="top">
885
<col width="150px" class="parameters_name">
886
<col class="parameters_description">
887
<col width="200px" class="parameters_annotations">
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>
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>
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>
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>
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>
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">
700
<col align="left" valign="top">
913
<col width="150px" class="parameters_name">
914
<col class="parameters_description">
915
<col width="200px" class="parameters_annotations">
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>
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>
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>
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>
715
930
<p class="since">Since 1.16</p>
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>
723
Creates a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> that matches the specified LOGFONTA.</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">
734
<col align="left" valign="top">
950
<col width="150px" class="parameters_name">
951
<col class="parameters_description">
952
<col width="200px" class="parameters_annotations">
739
<td><p><span class="term"><em class="parameter"><code>lfp</code></em> :</span></p></td>
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>
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>
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>
750
967
<p class="since">Since 1.12</p>
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>
758
Creates a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> that matches the specified LOGFONTW.</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">
769
<col align="left" valign="top">
987
<col width="150px" class="parameters_name">
988
<col class="parameters_description">
989
<col width="200px" class="parameters_annotations">
774
<td><p><span class="term"><em class="parameter"><code>lfp</code></em> :</span></p></td>
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>
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>
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>
785
1004
<p class="since">Since 1.16</p>
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"
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>
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>
789
1024
<div class="footer">
791
Generated by GTK-Doc V1.19.1</div>
1026
Generated by GTK-Doc V1.20.1</div>
b'\\ No newline at end of file'