File: //usr/share/gtk-doc/html/pango/pango-Win32-Fonts-and-Rendering.html
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>Win32 Fonts and Rendering</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="index.html" title="Pango Reference Manual">
<link rel="up" href="rendering.html" title="Rendering with Pango">
<link rel="prev" href="rendering.html" title="Rendering with Pango">
<link rel="next" href="pango-FreeType-Fonts-and-Rendering.html" title="FreeType Fonts and Rendering">
<meta name="generator" content="GTK-Doc V1.6 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="chapter" href="pango.html" title="Basic Pango Interfaces">
<link rel="chapter" href="rendering.html" title="Rendering with Pango">
<link rel="chapter" href="lowlevel.html" title="Low Level Functionality">
<link rel="chapter" href="tools.html" title="Pango Tools">
<link rel="index" href="ix01.html" title="Index">
<link rel="index" href="ix02.html" title="Index of deprecated symbols">
<link rel="index" href="ix03.html" title="Index of new symbols in 1.2">
<link rel="index" href="ix04.html" title="Index of new symbols in 1.4">
<link rel="index" href="ix05.html" title="Index of new symbols in 1.6">
<link rel="index" href="ix06.html" title="Index of new symbols in 1.8">
<link rel="index" href="ix07.html" title="Index of new symbols in 1.10">
<link rel="index" href="ix08.html" title="Index of new symbols in 1.12">
<link rel="index" href="ix09.html" title="Index of new symbols in 1.14">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="rendering.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="rendering.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">Pango Reference Manual</th>
<td><a accesskey="n" href="pango-FreeType-Fonts-and-Rendering.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#top_of_page" class="shortcut">Top</a>
 | 
<a href="#desc" class="shortcut">Description</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="pango-Win32-Fonts-and-Rendering"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="top_of_page"></a>Win32 Fonts and Rendering</span></h2>
<p>Win32 Fonts and Rendering — Functions for shape engines to manipulate Win32 fonts</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<a name="synopsis"></a><h2>Synopsis</h2>
<pre class="synopsis">
#define <a href="pango-Win32-Fonts-and-Rendering.html#PANGO-RENDER-TYPE-WIN32:CAPS">PANGO_RENDER_TYPE_WIN32</a>
<a href="pango-Text-Processing.html#PangoContext">PangoContext</a>* <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-get-context">pango_win32_get_context</a> (void);
void <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-render">pango_win32_render</a> (HDC hdc,
<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
<a href="pango-Glyph-Storage.html#PangoGlyphString">PangoGlyphString</a> *glyphs,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> x,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> y);
void <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-render-transformed">pango_win32_render_transformed</a> (HDC hdc,
const <a href="pango-Glyph-Storage.html#PangoMatrix">PangoMatrix</a> *matrix,
<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
<a href="pango-Glyph-Storage.html#PangoGlyphString">PangoGlyphString</a> *glyphs,
int x,
int y);
void <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-render-layout-line">pango_win32_render_layout_line</a> (HDC hdc,
<a href="pango-Layout-Objects.html#PangoLayoutLine">PangoLayoutLine</a> *line,
int x,
int y);
void <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-render-layout">pango_win32_render_layout</a> (HDC hdc,
<a href="pango-Layout-Objects.html#PangoLayout">PangoLayout</a> *layout,
int x,
int y);
<a href="pango-Glyph-Storage.html#PangoGlyph">PangoGlyph</a> <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-get-unknown-glyph">pango_win32_get_unknown_glyph</a> (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
<a
href="../glib/glib-Unicode-Manipulation.html#gunichar"
>gunichar</a> wc);
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-get-glyph-index">pango_win32_font_get_glyph_index</a>
(<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
<a
href="../glib/glib-Unicode-Manipulation.html#gunichar"
>gunichar</a> wc);
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-select-font">pango_win32_font_select_font</a> (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
HDC hdc);
void <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-done-font">pango_win32_font_done_font</a> (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font);
double <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-get-metrics-factor">pango_win32_font_get_metrics_factor</a>
(<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font);
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-get-debug-flag">pango_win32_get_debug_flag</a> (void);
HDC <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-get-dc">pango_win32_get_dc</a> (void);
<a href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache">PangoWin32FontCache</a>;
<a href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache">PangoWin32FontCache</a>* <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-cache-new">pango_win32_font_cache_new</a>
(void);
void <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-cache-free">pango_win32_font_cache_free</a> (<a href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache">PangoWin32FontCache</a> *cache);
HFONT <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-cache-load">pango_win32_font_cache_load</a> (<a href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache">PangoWin32FontCache</a> *cache,
const LOGFONT *logfont);
void <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-cache-unload">pango_win32_font_cache_unload</a> (<a href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache">PangoWin32FontCache</a> *cache,
HFONT hfont);
<a href="pango-Fonts.html#PangoFontMap">PangoFontMap</a>* <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-map-for-display">pango_win32_font_map_for_display</a>
(void);
void <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-shutdown-display">pango_win32_shutdown_display</a> (void);
<a href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache">PangoWin32FontCache</a>* <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-map-get-font-cache">pango_win32_font_map_get_font_cache</a>
(<a href="pango-Fonts.html#PangoFontMap">PangoFontMap</a> *font_map);
LOGFONT* <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-logfont">pango_win32_font_logfont</a> (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font);
<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a>* <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-description-from-logfont">pango_win32_font_description_from_logfont</a>
(const LOGFONT *lfp);
</pre>
</div>
<div class="refsect1" lang="en">
<a name="desc"></a><h2>Description</h2>
<p>
The macros and functions in this section are used to access fonts natively on
Win32 systems and to render text in conjunction with Win32 APIs.
</p>
</div>
<div class="refsect1" lang="en">
<a name="details"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id2844153"></a><h3>
<a name="PANGO-RENDER-TYPE-WIN32:CAPS"></a>PANGO_RENDER_TYPE_WIN32</h3>
<a class="indexterm" name="id2844166"></a><pre class="programlisting">#define PANGO_RENDER_TYPE_WIN32 "PangoRenderWin32"
</pre>
<p>
A string constant identifying the Win32 renderer. The associated quark (see
<a
href="../glib/glib-Quarks.html#g-quark-from-string"
><code class="function">g_quark_from_string()</code></a>) is used to identify the renderer in <a href="pango-Modules.html#pango-find-map"><code class="function">pango_find_map()</code></a>.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2844207"></a><h3>
<a name="pango-win32-get-context"></a>pango_win32_get_context ()</h3>
<a class="indexterm" name="id2844221"></a><pre class="programlisting"><a href="pango-Text-Processing.html#PangoContext">PangoContext</a>* pango_win32_get_context (void);</pre>
<p>
Retrieves a <a href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> appropriate for rendering with Windows fonts.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the new <a href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2844278"></a><h3>
<a name="pango-win32-render"></a>pango_win32_render ()</h3>
<a class="indexterm" name="id2844291"></a><pre class="programlisting">void pango_win32_render (HDC hdc,
<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
<a href="pango-Glyph-Storage.html#PangoGlyphString">PangoGlyphString</a> *glyphs,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> x,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> y);</pre>
<p>
Render a PangoGlyphString onto a Windows DC</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>hdc</code></em> :</span></td>
<td> the device context
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>font</code></em> :</span></td>
<td> the font in which to draw the string
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>glyphs</code></em> :</span></td>
<td> the glyph string to draw
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>x</code></em> :</span></td>
<td> the x position of start of string (in pixels)
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>y</code></em> :</span></td>
<td> the y position of baseline (in pixels)
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2844428"></a><h3>
<a name="pango-win32-render-transformed"></a>pango_win32_render_transformed ()</h3>
<a class="indexterm" name="id2844442"></a><pre class="programlisting">void pango_win32_render_transformed (HDC hdc,
const <a href="pango-Glyph-Storage.html#PangoMatrix">PangoMatrix</a> *matrix,
<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
<a href="pango-Glyph-Storage.html#PangoGlyphString">PangoGlyphString</a> *glyphs,
int x,
int y);</pre>
<p>
Renders a <a href="pango-Glyph-Storage.html#PangoGlyphString"><span class="type">PangoGlyphString</span></a> onto a windows DC, possibly
transforming the layed-out coordinates through a transformation
matrix. Note that the transformation matrix for <em class="parameter"><code>font</code></em> is not
changed, so to produce correct rendering results, the <em class="parameter"><code>font</code></em>
must have been loaded using a <a href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> with an identical
transformation matrix to that passed in to this function.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>hdc</code></em> :</span></td>
<td> a windows device context
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>matrix</code></em> :</span></td>
<td> a <a href="pango-Glyph-Storage.html#PangoMatrix"><span class="type">PangoMatrix</span></a>, or <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a> to use an identity transformation
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>font</code></em> :</span></td>
<td> the font in which to draw the string
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>glyphs</code></em> :</span></td>
<td> the glyph string to draw
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>x</code></em> :</span></td>
<td> the x position of the start of the string (in Pango
units in user space coordinates)
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>y</code></em> :</span></td>
<td> the y position of the baseline (in Pango units
in user space coordinates)
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2844654"></a><h3>
<a name="pango-win32-render-layout-line"></a>pango_win32_render_layout_line ()</h3>
<a class="indexterm" name="id2844667"></a><pre class="programlisting">void pango_win32_render_layout_line (HDC hdc,
<a href="pango-Layout-Objects.html#PangoLayoutLine">PangoLayoutLine</a> *line,
int x,
int y);</pre>
<p>
Render a <a href="pango-Layout-Objects.html#PangoLayoutLine"><span class="type">PangoLayoutLine</span></a> onto a device context. For underlining to
work property the text alignment of the DC should have TA_BASELINE
and TA_LEFT.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>hdc</code></em> :</span></td>
<td> DC to use for uncolored drawing
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>line</code></em> :</span></td>
<td> a <a href="pango-Layout-Objects.html#PangoLayoutLine"><span class="type">PangoLayoutLine</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>x</code></em> :</span></td>
<td> the x position of start of string (in pixels)
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>y</code></em> :</span></td>
<td> the y position of baseline (in pixels)
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2844800"></a><h3>
<a name="pango-win32-render-layout"></a>pango_win32_render_layout ()</h3>
<a class="indexterm" name="id2844813"></a><pre class="programlisting">void pango_win32_render_layout (HDC hdc,
<a href="pango-Layout-Objects.html#PangoLayout">PangoLayout</a> *layout,
int x,
int y);</pre>
<p>
Render a <a href="pango-Layout-Objects.html#PangoLayoutLine"><span class="type">PangoLayoutLine</span></a> onto an X drawable</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>hdc</code></em> :</span></td>
<td> HDC to use for uncolored drawing
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>layout</code></em> :</span></td>
<td> a <a href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>x</code></em> :</span></td>
<td> the X position of the left of the layout (in pixels)
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>y</code></em> :</span></td>
<td> the Y position of the top of the layout (in pixels)
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2844943"></a><h3>
<a name="pango-win32-get-unknown-glyph"></a>pango_win32_get_unknown_glyph ()</h3>
<a class="indexterm" name="id2844959"></a><pre class="programlisting"><a href="pango-Glyph-Storage.html#PangoGlyph">PangoGlyph</a> pango_win32_get_unknown_glyph (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
<a
href="../glib/glib-Unicode-Manipulation.html#gunichar"
>gunichar</a> wc);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">pango_win32_get_unknown_glyph</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Returns the index of a glyph suitable for drawing <em class="parameter"><code>wc</code></em> as an
unknown character.
</p>
<p>
Use <a href="pango-Glyph-Storage.html#PANGO-GET-UNKNOWN-GLYPH:CAPS"><code class="function">PANGO_GET_UNKNOWN_GLYPH()</code></a> instead.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>font</code></em> :</span></td>
<td> a <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>wc</code></em> :</span></td>
<td> the Unicode character for which a glyph is needed.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> a glyph index into <em class="parameter"><code>font</code></em>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2845090"></a><h3>
<a name="pango-win32-font-get-glyph-index"></a>pango_win32_font_get_glyph_index ()</h3>
<a class="indexterm" name="id2845103"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> pango_win32_font_get_glyph_index
(<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
<a
href="../glib/glib-Unicode-Manipulation.html#gunichar"
>gunichar</a> wc);</pre>
<p>
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
covered.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>font</code></em> :</span></td>
<td> a <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>wc</code></em> :</span></td>
<td> a Unicode character.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the glyph index for <em class="parameter"><code>wc</code></em>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2845211"></a><h3>
<a name="pango-win32-font-select-font"></a>pango_win32_font_select_font ()</h3>
<a class="indexterm" name="id2845225"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> pango_win32_font_select_font (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
HDC hdc);</pre>
<p>
Selects the font into the specified DC and changes the mapping mode
and world transformation of the DC appropriately for the font.
You may want to surround the use of this function with calls
to SaveDC and RestoreDC. Call <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-done-font"><code class="function">pango_win32_font_done_font()</code></a> when
you are done using the DC to release allocated resources.
</p>
<p>
See <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-get-metrics-factor"><code class="function">pango_win32_font_get_metrics_factor()</code></a> for information about
converting from the coordinate space used by this function
into Pango units.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>font</code></em> :</span></td>
<td> a <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> from the Win32 backend
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>hdc</code></em> :</span></td>
<td> a windows device context
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> <a
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if the operation succeeded.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2845357"></a><h3>
<a name="pango-win32-font-done-font"></a>pango_win32_font_done_font ()</h3>
<a class="indexterm" name="id2845371"></a><pre class="programlisting">void pango_win32_font_done_font (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font);</pre>
<p>
Releases any resources allocated by <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-done-font"><code class="function">pango_win32_font_done_font()</code></a></p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>font</code></em> :</span></td>
<td> a <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> from the win32 backend
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2845438"></a><h3>
<a name="pango-win32-font-get-metrics-factor"></a>pango_win32_font_get_metrics_factor ()</h3>
<a class="indexterm" name="id2845453"></a><pre class="programlisting">double pango_win32_font_get_metrics_factor
(<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font);</pre>
<p>
Returns the scale factor from logical units in the coordinate
space used by <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-select-font"><code class="function">pango_win32_font_select_font()</code></a> to Pango units
in user space.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>font</code></em> :</span></td>
<td> a <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> from the win32 backend
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> factor to multiply logical units by to get Pango
units.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2845536"></a><h3>
<a name="pango-win32-get-debug-flag"></a>pango_win32_get_debug_flag ()</h3>
<a class="indexterm" name="id2845552"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> pango_win32_get_debug_flag (void);</pre>
<p>
Returns wether debugging is turned on.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> <a
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if debugging is turned on.
</td>
</tr></tbody>
</table></div>
<p>Since 1.2
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2845606"></a><h3>
<a name="pango-win32-get-dc"></a>pango_win32_get_dc ()</h3>
<a class="indexterm" name="id2845620"></a><pre class="programlisting">HDC pango_win32_get_dc (void);</pre>
<p>
Obtains a handle to the Windows device context that is used by Pango.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> A handle to the Windows device context that is used by Pango.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2845660"></a><h3>
<a name="PangoWin32FontCache"></a>PangoWin32FontCache</h3>
<a class="indexterm" name="id2845673"></a><pre class="programlisting">typedef struct _PangoWin32FontCache PangoWin32FontCache;</pre>
<p>
A <a href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache"><span class="type">PangoWin32FontCache</span></a> caches
<span class="type">HFONTs</span> by their <span class="type">LOGFONT</span> descriptions.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2845715"></a><h3>
<a name="pango-win32-font-cache-new"></a>pango_win32_font_cache_new ()</h3>
<a class="indexterm" name="id2845729"></a><pre class="programlisting"><a href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache">PangoWin32FontCache</a>* pango_win32_font_cache_new
(void);</pre>
<p>
Creates a font cache.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> The new font cache. This must be freed with
<a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-cache-free"><code class="function">pango_win32_font_cache_free()</code></a>.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2845781"></a><h3>
<a name="pango-win32-font-cache-free"></a>pango_win32_font_cache_free ()</h3>
<a class="indexterm" name="id2845795"></a><pre class="programlisting">void pango_win32_font_cache_free (<a href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache">PangoWin32FontCache</a> *cache);</pre>
<p>
Frees a <a href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache"><span class="type">PangoWin32FontCache</span></a> and all associated memory. All fonts loaded
through this font cache will be freed along with the cache.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>cache</code></em> :</span></td>
<td> a <a href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache"><span class="type">PangoWin32FontCache</span></a>
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2845862"></a><h3>
<a name="pango-win32-font-cache-load"></a>pango_win32_font_cache_load ()</h3>
<a class="indexterm" name="id2845876"></a><pre class="programlisting">HFONT pango_win32_font_cache_load (<a href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache">PangoWin32FontCache</a> *cache,
const LOGFONT *logfont);</pre>
<p>
Creates a <span class="type">HFONT</span> from a LOGFONT. The
result may be newly loaded, or it may have been previously
stored</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>cache</code></em> :</span></td>
<td> a <a href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache"><span class="type">PangoWin32FontCache</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>logfont</code></em> :</span></td>
<td> a pointer to a LOGFONT structure describing the font to load.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> The font structure, or <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a> if the font could
not be loaded. In order to free this structure, you must call
<a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-cache-unload"><code class="function">pango_win32_font_cache_unload()</code></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2845999"></a><h3>
<a name="pango-win32-font-cache-unload"></a>pango_win32_font_cache_unload ()</h3>
<a class="indexterm" name="id2846012"></a><pre class="programlisting">void pango_win32_font_cache_unload (<a href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache">PangoWin32FontCache</a> *cache,
HFONT hfont);</pre>
<p>
Frees a font structure previously loaded with <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-font-cache-load"><code class="function">pango_win32_font_cache_load()</code></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>cache</code></em> :</span></td>
<td> a <a href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache"><span class="type">PangoWin32FontCache</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>hfont</code></em> :</span></td>
<td> the HFONT to unload
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2846104"></a><h3>
<a name="pango-win32-font-map-for-display"></a>pango_win32_font_map_for_display ()</h3>
<a class="indexterm" name="id2846118"></a><pre class="programlisting"><a href="pango-Fonts.html#PangoFontMap">PangoFontMap</a>* pango_win32_font_map_for_display
(void);</pre>
<p>
Returns a <span class="type">PangoWin32FontMap</span>. Font maps are cached and should
not be freed. If the font map is no longer needed, it can
be released with <a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-shutdown-display"><code class="function">pango_win32_shutdown_display()</code></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> a <a href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2846189"></a><h3>
<a name="pango-win32-shutdown-display"></a>pango_win32_shutdown_display ()</h3>
<a class="indexterm" name="id2846203"></a><pre class="programlisting">void pango_win32_shutdown_display (void);</pre>
<p>
Free cached resources.</p>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2846228"></a><h3>
<a name="pango-win32-font-map-get-font-cache"></a>pango_win32_font_map_get_font_cache ()</h3>
<a class="indexterm" name="id2846242"></a><pre class="programlisting"><a href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache">PangoWin32FontCache</a>* pango_win32_font_map_get_font_cache
(<a href="pango-Fonts.html#PangoFontMap">PangoFontMap</a> *font_map);</pre>
<p>
Obtains the font cache associated with the given font map.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>font_map</code></em> :</span></td>
<td> a <span class="type">PangoWin32FontMap</span>.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the <a href="pango-Win32-Fonts-and-Rendering.html#PangoWin32FontCache"><span class="type">PangoWin32FontCache</span></a> of <em class="parameter"><code>font_map</code></em>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2846326"></a><h3>
<a name="pango-win32-font-logfont"></a>pango_win32_font_logfont ()</h3>
<a class="indexterm" name="id2846340"></a><pre class="programlisting">LOGFONT* pango_win32_font_logfont (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font);</pre>
<p>
Determine the LOGFONT struct for the specified bfont.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>font</code></em> :</span></td>
<td> a <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> which must be from the Win32 backend
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> A newly allocated LOGFONT struct. It must be
freed with <a
href="../glib/glib-Memory-Allocation.html#g-free"
><code class="function">g_free()</code></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2846420"></a><h3>
<a name="pango-win32-font-description-from-logfont"></a>pango_win32_font_description_from_logfont ()</h3>
<a class="indexterm" name="id2846437"></a><pre class="programlisting"><a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a>* pango_win32_font_description_from_logfont
(const LOGFONT *lfp);</pre>
<p>
Creates a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> that matches the specified LOGFONT.
</p>
<p>
The face name, italicness and weight fields in the LOGFONT are used
to set up the resulting <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>. If the face name in
the LOGFONT contains non-ASCII characters the font is temporarily
loaded (using CreateFontIndirect) and an ASCII (usually English)
name for it is looked up from the font name tables in the font
data. If that doesn't work, the face name is converted from the
system codepage to UTF-8 and that is used.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>lfp</code></em> :</span></td>
<td> a LOGFONT
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the newly allocated <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>, which
should be freed using <code class="function">pango_font_desciption_free()</code>
</td>
</tr>
</tbody>
</table></div>
<p>Since 1.12
</p>
</div>
</div>
</div>
</body>
</html>