<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
  "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"
[
<!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
<!ENTITY version SYSTEM "version.xml">
]>
<refentry id="pango-Win32-Fonts-and-Rendering">
<refmeta>
<refentrytitle role="top_of_page" id="pango-Win32-Fonts-and-Rendering.top_of_page">Win32 Fonts and Rendering</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>PANGO Library</refmiscinfo>
</refmeta>
<refnamediv>
<refname>Win32 Fonts and Rendering</refname>
<refpurpose>Font handling and rendering on Windows</refpurpose>
</refnamediv>

<refsect1 id="pango-Win32-Fonts-and-Rendering.functions" role="functions_proto">
<title role="functions_proto.title">Functions</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="functions_proto_type" colwidth="150px"/>
<colspec colname="functions_proto_name"/>
<tbody>
<row><entry role="function_type"><link linkend="PangoContext"><returnvalue>PangoContext</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="pango-win32-get-context">pango_win32_get_context</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="pango-win32-render">pango_win32_render</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="pango-win32-render-transformed">pango_win32_render_transformed</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="pango-win32-render-layout-line">pango_win32_render_layout_line</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="pango-win32-render-layout">pango_win32_render_layout</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="PangoGlyph"><returnvalue>PangoGlyph</returnvalue></link>
</entry><entry role="function_name"><link linkend="pango-win32-get-unknown-glyph">pango_win32_get_unknown_glyph</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gint"><returnvalue>gint</returnvalue></link>
</entry><entry role="function_name"><link linkend="pango-win32-font-get-glyph-index">pango_win32_font_get_glyph_index</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="pango-win32-font-select-font">pango_win32_font_select_font</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="pango-win32-font-done-font">pango_win32_font_done_font</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="double"><returnvalue>double</returnvalue></link>
</entry><entry role="function_name"><link linkend="pango-win32-font-get-metrics-factor">pango_win32_font_get_metrics_factor</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="pango-win32-get-debug-flag">pango_win32_get_debug_flag</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="HDC:CAPS"><returnvalue>HDC</returnvalue></link>
</entry><entry role="function_name"><link linkend="pango-win32-get-dc">pango_win32_get_dc</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="PangoWin32FontCache"><returnvalue>PangoWin32FontCache</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="pango-win32-font-cache-new">pango_win32_font_cache_new</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="pango-win32-font-cache-free">pango_win32_font_cache_free</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="HFONT:CAPS"><returnvalue>HFONT</returnvalue></link>
</entry><entry role="function_name"><link linkend="pango-win32-font-cache-load">pango_win32_font_cache_load</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="HFONT:CAPS"><returnvalue>HFONT</returnvalue></link>
</entry><entry role="function_name"><link linkend="pango-win32-font-cache-loadw">pango_win32_font_cache_loadw</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="pango-win32-font-cache-unload">pango_win32_font_cache_unload</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="PangoFontMap"><returnvalue>PangoFontMap</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="pango-win32-font-map-for-display">pango_win32_font_map_for_display</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="pango-win32-shutdown-display">pango_win32_shutdown_display</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="PangoWin32FontCache"><returnvalue>PangoWin32FontCache</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="pango-win32-font-map-get-font-cache">pango_win32_font_map_get_font_cache</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="LOGFONTA:CAPS"><returnvalue>LOGFONTA</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="pango-win32-font-logfont">pango_win32_font_logfont</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="LOGFONTW:CAPS"><returnvalue>LOGFONTW</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="pango-win32-font-logfontw">pango_win32_font_logfontw</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="PangoFontDescription"><returnvalue>PangoFontDescription</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="pango-win32-font-description-from-logfont">pango_win32_font_description_from_logfont</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="PangoFontDescription"><returnvalue>PangoFontDescription</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="pango-win32-font-description-from-logfontw">pango_win32_font_description_from_logfontw</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="pango-Win32-Fonts-and-Rendering.other" role="other_proto">
<title role="other_proto.title">Types and Values</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="other_proto_type" colwidth="150px"/>
<colspec colname="other_proto_name"/>
<tbody>
<row><entry role="datatype_keyword"></entry><entry role="function_name"><link linkend="PangoWin32FontCache">PangoWin32FontCache</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>


<refsect1 id="pango-Win32-Fonts-and-Rendering.description" role="desc">
<title role="desc.title">Description</title>
<para>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.</para>

</refsect1>
<refsect1 id="pango-Win32-Fonts-and-Rendering.functions_details" role="details">
<title role="details.title">Functions</title>
<refsect2 id="pango-win32-get-context" role="function" condition="deprecated">
<title>pango_win32_get_context&#160;()</title>
<indexterm zone="pango-win32-get-context" role="deprecated"><primary>pango_win32_get_context</primary></indexterm>
<programlisting language="C"><link linkend="PangoContext"><returnvalue>PangoContext</returnvalue></link>&#160;*
pango_win32_get_context (<parameter><type>void</type></parameter>);</programlisting>
<warning><para><literal>pango_win32_get_context</literal> has been deprecated since version 1.22 and should not be used in newly-written code.</para> <para>Use <link linkend="pango-win32-font-map-for-display"><function>pango_win32_font_map_for_display()</function></link> followed by
<link linkend="pango-font-map-create-context"><function>pango_font_map_create_context()</function></link> instead.</para>
</warning>
<para>Retrieves a <link linkend="PangoContext"><type>PangoContext</type></link> appropriate for rendering with Windows fonts.</para>
<refsect3 id="pango-win32-get-context.returns" role="returns">
<title>Returns</title>
<para> the new <link linkend="PangoContext"><type>PangoContext</type></link></para>
</refsect3></refsect2>
<refsect2 id="pango-win32-render" role="function">
<title>pango_win32_render&#160;()</title>
<indexterm zone="pango-win32-render"><primary>pango_win32_render</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
pango_win32_render (<parameter><link linkend="HDC:CAPS"><type>HDC</type></link> hdc</parameter>,
                    <parameter><link linkend="PangoFont"><type>PangoFont</type></link> *font</parameter>,
                    <parameter><link linkend="PangoGlyphString"><type>PangoGlyphString</type></link> *glyphs</parameter>,
                    <parameter><link linkend="gint"><type>gint</type></link> x</parameter>,
                    <parameter><link linkend="gint"><type>gint</type></link> y</parameter>);</programlisting>
<para>Render a <link linkend="PangoGlyphString"><type>PangoGlyphString</type></link> onto a Windows DC</para>
<refsect3 id="pango-win32-render.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>hdc</para></entry>
<entry role="parameter_description"><para>the device context</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>font</para></entry>
<entry role="parameter_description"><para>the font in which to draw the string</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>glyphs</para></entry>
<entry role="parameter_description"><para>the glyph string to draw</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>x</para></entry>
<entry role="parameter_description"><para>the x position of start of string (in pixels)</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>y</para></entry>
<entry role="parameter_description"><para>the y position of baseline (in pixels)</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="pango-win32-render-transformed" role="function">
<title>pango_win32_render_transformed&#160;()</title>
<indexterm zone="pango-win32-render-transformed"><primary>pango_win32_render_transformed</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
pango_win32_render_transformed (<parameter><link linkend="HDC:CAPS"><type>HDC</type></link> hdc</parameter>,
                                <parameter>const <link linkend="PangoMatrix"><type>PangoMatrix</type></link> *matrix</parameter>,
                                <parameter><link linkend="PangoFont"><type>PangoFont</type></link> *font</parameter>,
                                <parameter><link linkend="PangoGlyphString"><type>PangoGlyphString</type></link> *glyphs</parameter>,
                                <parameter><link linkend="int"><type>int</type></link> x</parameter>,
                                <parameter><link linkend="int"><type>int</type></link> y</parameter>);</programlisting>
<para>Renders a <link linkend="PangoGlyphString"><type>PangoGlyphString</type></link> onto a windows DC, possibly
transforming the layed-out coordinates through a transformation
matrix. Note that the transformation matrix for <parameter>font</parameter>
 is not
changed, so to produce correct rendering results, the <parameter>font</parameter>

must have been loaded using a <link linkend="PangoContext"><type>PangoContext</type></link> with an identical
transformation matrix to that passed in to this function.</para>
<refsect3 id="pango-win32-render-transformed.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>hdc</para></entry>
<entry role="parameter_description"><para>a windows device context</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>matrix</para></entry>
<entry role="parameter_description"><para>a <link linkend="PangoMatrix"><type>PangoMatrix</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> to use an identity
transformation. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>font</para></entry>
<entry role="parameter_description"><para>the font in which to draw the string</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>glyphs</para></entry>
<entry role="parameter_description"><para>the glyph string to draw</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>x</para></entry>
<entry role="parameter_description"><para>the x position of the start of the string (in Pango
units in user space coordinates)</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>y</para></entry>
<entry role="parameter_description"><para>the y position of the baseline (in Pango units
in user space coordinates)</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="pango-win32-render-layout-line" role="function">
<title>pango_win32_render_layout_line&#160;()</title>
<indexterm zone="pango-win32-render-layout-line"><primary>pango_win32_render_layout_line</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
pango_win32_render_layout_line (<parameter><link linkend="HDC:CAPS"><type>HDC</type></link> hdc</parameter>,
                                <parameter><link linkend="PangoLayoutLine"><type>PangoLayoutLine</type></link> *line</parameter>,
                                <parameter><link linkend="int"><type>int</type></link> x</parameter>,
                                <parameter><link linkend="int"><type>int</type></link> y</parameter>);</programlisting>
<para>Render a <link linkend="PangoLayoutLine"><type>PangoLayoutLine</type></link> onto a device context. For underlining to
work property the text alignment of the DC should have TA_BASELINE
and TA_LEFT.</para>
<refsect3 id="pango-win32-render-layout-line.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>hdc</para></entry>
<entry role="parameter_description"><para>DC to use for drawing</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>line</para></entry>
<entry role="parameter_description"><para>a <link linkend="PangoLayoutLine"><type>PangoLayoutLine</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>x</para></entry>
<entry role="parameter_description"><para>the x position of start of string (in pixels)</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>y</para></entry>
<entry role="parameter_description"><para>the y position of baseline (in pixels)</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="pango-win32-render-layout" role="function">
<title>pango_win32_render_layout&#160;()</title>
<indexterm zone="pango-win32-render-layout"><primary>pango_win32_render_layout</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
pango_win32_render_layout (<parameter><link linkend="HDC:CAPS"><type>HDC</type></link> hdc</parameter>,
                           <parameter><link linkend="PangoLayout"><type>PangoLayout</type></link> *layout</parameter>,
                           <parameter><link linkend="int"><type>int</type></link> x</parameter>,
                           <parameter><link linkend="int"><type>int</type></link> y</parameter>);</programlisting>
<para>Render a <link linkend="PangoLayoutLine"><type>PangoLayoutLine</type></link> onto an X drawable</para>
<refsect3 id="pango-win32-render-layout.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>hdc</para></entry>
<entry role="parameter_description"><para>HDC to use for drawing</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>layout</para></entry>
<entry role="parameter_description"><para>a <link linkend="PangoLayout"><type>PangoLayout</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>x</para></entry>
<entry role="parameter_description"><para>the X position of the left of the layout (in pixels)</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>y</para></entry>
<entry role="parameter_description"><para>the Y position of the top of the layout (in pixels)</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="pango-win32-get-unknown-glyph" role="function" condition="deprecated:">
<title>pango_win32_get_unknown_glyph&#160;()</title>
<indexterm zone="pango-win32-get-unknown-glyph" role="deprecated"><primary>pango_win32_get_unknown_glyph</primary></indexterm>
<programlisting language="C"><link linkend="PangoGlyph"><returnvalue>PangoGlyph</returnvalue></link>
pango_win32_get_unknown_glyph (<parameter><link linkend="PangoFont"><type>PangoFont</type></link> *font</parameter>,
                               <parameter><link linkend="gunichar"><type>gunichar</type></link> wc</parameter>);</programlisting>
<warning><para><literal>pango_win32_get_unknown_glyph</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>Returns the index of a glyph suitable for drawing <parameter>wc</parameter>
 as an
unknown character.</para>
<para>Use <link linkend="PANGO-GET-UNKNOWN-GLYPH:CAPS"><function>PANGO_GET_UNKNOWN_GLYPH()</function></link> instead.</para>
<refsect3 id="pango-win32-get-unknown-glyph.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>font</para></entry>
<entry role="parameter_description"><para>a <link linkend="PangoFont"><type>PangoFont</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>wc</para></entry>
<entry role="parameter_description"><para>the Unicode character for which a glyph is needed.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="pango-win32-get-unknown-glyph.returns" role="returns">
<title>Returns</title>
<para> a glyph index into <parameter>font</parameter>
</para>
</refsect3></refsect2>
<refsect2 id="pango-win32-font-get-glyph-index" role="function" condition="deprecated:">
<title>pango_win32_font_get_glyph_index&#160;()</title>
<indexterm zone="pango-win32-font-get-glyph-index" role="deprecated"><primary>pango_win32_font_get_glyph_index</primary></indexterm>
<programlisting language="C"><link linkend="gint"><returnvalue>gint</returnvalue></link>
pango_win32_font_get_glyph_index (<parameter><link linkend="PangoFont"><type>PangoFont</type></link> *font</parameter>,
                                  <parameter><link linkend="gunichar"><type>gunichar</type></link> wc</parameter>);</programlisting>
<warning><para><literal>pango_win32_font_get_glyph_index</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>Obtains the index of the glyph for <parameter>wc</parameter>
 in <parameter>font</parameter>
, or 0, if not
covered.</para>
<refsect3 id="pango-win32-font-get-glyph-index.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>font</para></entry>
<entry role="parameter_description"><para>a <link linkend="PangoFont"><type>PangoFont</type></link>.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>wc</para></entry>
<entry role="parameter_description"><para>a Unicode character.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="pango-win32-font-get-glyph-index.returns" role="returns">
<title>Returns</title>
<para> the glyph index for <parameter>wc</parameter>
.</para>
</refsect3></refsect2>
<refsect2 id="pango-win32-font-select-font" role="function" condition="deprecated:">
<title>pango_win32_font_select_font&#160;()</title>
<indexterm zone="pango-win32-font-select-font" role="deprecated"><primary>pango_win32_font_select_font</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
pango_win32_font_select_font (<parameter><link linkend="PangoFont"><type>PangoFont</type></link> *font</parameter>,
                              <parameter><link linkend="HDC:CAPS"><type>HDC</type></link> hdc</parameter>);</programlisting>
<warning><para><literal>pango_win32_font_select_font</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>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 <link linkend="SaveDC"><function>SaveDC()</function></link> and <link linkend="RestoreDC"><function>RestoreDC()</function></link>. Call <link linkend="pango-win32-font-done-font"><function>pango_win32_font_done_font()</function></link> when
you are done using the DC to release allocated resources.</para>
<para>See <link linkend="pango-win32-font-get-metrics-factor"><function>pango_win32_font_get_metrics_factor()</function></link> for information about
converting from the coordinate space used by this function
into Pango units.</para>
<refsect3 id="pango-win32-font-select-font.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>font</para></entry>
<entry role="parameter_description"><para>a <link linkend="PangoFont"><type>PangoFont</type></link> from the Win32 backend</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>hdc</para></entry>
<entry role="parameter_description"><para>a windows device context</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="pango-win32-font-select-font.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the operation succeeded.</para>
</refsect3></refsect2>
<refsect2 id="pango-win32-font-done-font" role="function" condition="deprecated:">
<title>pango_win32_font_done_font&#160;()</title>
<indexterm zone="pango-win32-font-done-font" role="deprecated"><primary>pango_win32_font_done_font</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
pango_win32_font_done_font (<parameter><link linkend="PangoFont"><type>PangoFont</type></link> *font</parameter>);</programlisting>
<warning><para><literal>pango_win32_font_done_font</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>Releases any resources allocated by <link linkend="pango-win32-font-done-font"><function>pango_win32_font_done_font()</function></link></para>
<refsect3 id="pango-win32-font-done-font.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>font</para></entry>
<entry role="parameter_description"><para>a <link linkend="PangoFont"><type>PangoFont</type></link> from the win32 backend</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="pango-win32-font-get-metrics-factor" role="function" condition="deprecated:">
<title>pango_win32_font_get_metrics_factor&#160;()</title>
<indexterm zone="pango-win32-font-get-metrics-factor" role="deprecated"><primary>pango_win32_font_get_metrics_factor</primary></indexterm>
<programlisting language="C"><link linkend="double"><returnvalue>double</returnvalue></link>
pango_win32_font_get_metrics_factor (<parameter><link linkend="PangoFont"><type>PangoFont</type></link> *font</parameter>);</programlisting>
<warning><para><literal>pango_win32_font_get_metrics_factor</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>Returns the scale factor from logical units in the coordinate
space used by <link linkend="pango-win32-font-select-font"><function>pango_win32_font_select_font()</function></link> to Pango units
in user space.</para>
<refsect3 id="pango-win32-font-get-metrics-factor.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>font</para></entry>
<entry role="parameter_description"><para>a <link linkend="PangoFont"><type>PangoFont</type></link> from the win32 backend</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="pango-win32-font-get-metrics-factor.returns" role="returns">
<title>Returns</title>
<para> factor to multiply logical units by to get Pango
units.</para>
</refsect3></refsect2>
<refsect2 id="pango-win32-get-debug-flag" role="function" condition="deprecated:|since:1.2">
<title>pango_win32_get_debug_flag&#160;()</title>
<indexterm zone="pango-win32-get-debug-flag" role="deprecated"><primary>pango_win32_get_debug_flag</primary></indexterm><indexterm zone="pango-win32-get-debug-flag" role="1.2"><primary>pango_win32_get_debug_flag</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
pango_win32_get_debug_flag (<parameter><type>void</type></parameter>);</programlisting>
<warning><para><literal>pango_win32_get_debug_flag</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>Returns whether debugging is turned on.</para>
<refsect3 id="pango-win32-get-debug-flag.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if debugging is turned on.</para>
</refsect3><para role="since">Since: <link linkend="api-index-1.2">1.2</link></para></refsect2>
<refsect2 id="pango-win32-get-dc" role="function" condition="deprecated:">
<title>pango_win32_get_dc&#160;()</title>
<indexterm zone="pango-win32-get-dc" role="deprecated"><primary>pango_win32_get_dc</primary></indexterm>
<programlisting language="C"><link linkend="HDC:CAPS"><returnvalue>HDC</returnvalue></link>
pango_win32_get_dc (<parameter><type>void</type></parameter>);</programlisting>
<warning><para><literal>pango_win32_get_dc</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>Obtains a handle to the Windows device context that is used by Pango.</para>
<refsect3 id="pango-win32-get-dc.returns" role="returns">
<title>Returns</title>
<para> A handle to the Windows device context that is used by Pango.</para>
</refsect3></refsect2>
<refsect2 id="pango-win32-font-cache-new" role="function">
<title>pango_win32_font_cache_new&#160;()</title>
<indexterm zone="pango-win32-font-cache-new"><primary>pango_win32_font_cache_new</primary></indexterm>
<programlisting language="C"><link linkend="PangoWin32FontCache"><returnvalue>PangoWin32FontCache</returnvalue></link>&#160;*
pango_win32_font_cache_new (<parameter><type>void</type></parameter>);</programlisting>
<para>Creates a font cache.</para>
<refsect3 id="pango-win32-font-cache-new.returns" role="returns">
<title>Returns</title>
<para> The new font cache. This must be freed with
<link linkend="pango-win32-font-cache-free"><function>pango_win32_font_cache_free()</function></link>.</para>
</refsect3></refsect2>
<refsect2 id="pango-win32-font-cache-free" role="function">
<title>pango_win32_font_cache_free&#160;()</title>
<indexterm zone="pango-win32-font-cache-free"><primary>pango_win32_font_cache_free</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
pango_win32_font_cache_free (<parameter><link linkend="PangoWin32FontCache"><type>PangoWin32FontCache</type></link> *cache</parameter>);</programlisting>
<para>Frees a <link linkend="PangoWin32FontCache"><type>PangoWin32FontCache</type></link> and all associated memory. All fonts loaded
through this font cache will be freed along with the cache.</para>
<refsect3 id="pango-win32-font-cache-free.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>cache</para></entry>
<entry role="parameter_description"><para>a <link linkend="PangoWin32FontCache"><type>PangoWin32FontCache</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="pango-win32-font-cache-load" role="function">
<title>pango_win32_font_cache_load&#160;()</title>
<indexterm zone="pango-win32-font-cache-load"><primary>pango_win32_font_cache_load</primary></indexterm>
<programlisting language="C"><link linkend="HFONT:CAPS"><returnvalue>HFONT</returnvalue></link>
pango_win32_font_cache_load (<parameter><link linkend="PangoWin32FontCache"><type>PangoWin32FontCache</type></link> *cache</parameter>,
                             <parameter>const <link linkend="LOGFONTA:CAPS"><type>LOGFONTA</type></link> *logfont</parameter>);</programlisting>
<para>Creates a HFONT from a LOGFONTA. The
result may be newly loaded, or it may have been previously
stored</para>
<refsect3 id="pango-win32-font-cache-load.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>cache</para></entry>
<entry role="parameter_description"><para>a <link linkend="PangoWin32FontCache"><type>PangoWin32FontCache</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>logfont</para></entry>
<entry role="parameter_description"><para>a pointer to a LOGFONTA structure describing the font to load.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="pango-win32-font-cache-load.returns" role="returns">
<title>Returns</title>
<para>The font structure, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if the font
could not be loaded. In order to free this structure, you must call
<link linkend="pango-win32-font-cache-unload"><function>pango_win32_font_cache_unload()</function></link>. </para>
<para><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="pango-win32-font-cache-loadw" role="function" condition="since:1.16">
<title>pango_win32_font_cache_loadw&#160;()</title>
<indexterm zone="pango-win32-font-cache-loadw" role="1.16"><primary>pango_win32_font_cache_loadw</primary></indexterm>
<programlisting language="C"><link linkend="HFONT:CAPS"><returnvalue>HFONT</returnvalue></link>
pango_win32_font_cache_loadw (<parameter><link linkend="PangoWin32FontCache"><type>PangoWin32FontCache</type></link> *cache</parameter>,
                              <parameter>const <link linkend="LOGFONTW:CAPS"><type>LOGFONTW</type></link> *logfont</parameter>);</programlisting>
<para>Creates a HFONT from a LOGFONTW. The
result may be newly loaded, or it may have been previously
stored</para>
<refsect3 id="pango-win32-font-cache-loadw.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>cache</para></entry>
<entry role="parameter_description"><para>a <link linkend="PangoWin32FontCache"><type>PangoWin32FontCache</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>logfont</para></entry>
<entry role="parameter_description"><para>a pointer to a LOGFONTW structure describing the font to load.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="pango-win32-font-cache-loadw.returns" role="returns">
<title>Returns</title>
<para>The font structure, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if the font
could not be loaded. In order to free this structure, you must call
<link linkend="pango-win32-font-cache-unload"><function>pango_win32_font_cache_unload()</function></link>. </para>
<para><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></para>
</refsect3><para role="since">Since: <link linkend="api-index-1.16">1.16</link></para></refsect2>
<refsect2 id="pango-win32-font-cache-unload" role="function">
<title>pango_win32_font_cache_unload&#160;()</title>
<indexterm zone="pango-win32-font-cache-unload"><primary>pango_win32_font_cache_unload</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
pango_win32_font_cache_unload (<parameter><link linkend="PangoWin32FontCache"><type>PangoWin32FontCache</type></link> *cache</parameter>,
                               <parameter><link linkend="HFONT:CAPS"><type>HFONT</type></link> hfont</parameter>);</programlisting>
<para>Frees a font structure previously loaded with <link linkend="pango-win32-font-cache-load"><function>pango_win32_font_cache_load()</function></link>.</para>
<refsect3 id="pango-win32-font-cache-unload.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>cache</para></entry>
<entry role="parameter_description"><para>a <link linkend="PangoWin32FontCache"><type>PangoWin32FontCache</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>hfont</para></entry>
<entry role="parameter_description"><para>the HFONT to unload</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="pango-win32-font-map-for-display" role="function">
<title>pango_win32_font_map_for_display&#160;()</title>
<indexterm zone="pango-win32-font-map-for-display"><primary>pango_win32_font_map_for_display</primary></indexterm>
<programlisting language="C"><link linkend="PangoFontMap"><returnvalue>PangoFontMap</returnvalue></link>&#160;*
pango_win32_font_map_for_display (<parameter><type>void</type></parameter>);</programlisting>
<para>Returns a <type>PangoWin32FontMap</type>. Font maps are cached and should
not be freed. If the font map is no longer needed, it can
be released with <link linkend="pango-win32-shutdown-display"><function>pango_win32_shutdown_display()</function></link>.</para>
<refsect3 id="pango-win32-font-map-for-display.returns" role="returns">
<title>Returns</title>
<para> a <link linkend="PangoFontMap"><type>PangoFontMap</type></link>.</para>
</refsect3></refsect2>
<refsect2 id="pango-win32-shutdown-display" role="function">
<title>pango_win32_shutdown_display&#160;()</title>
<indexterm zone="pango-win32-shutdown-display"><primary>pango_win32_shutdown_display</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
pango_win32_shutdown_display (<parameter><type>void</type></parameter>);</programlisting>
<para>Free cached resources.</para>
</refsect2>
<refsect2 id="pango-win32-font-map-get-font-cache" role="function">
<title>pango_win32_font_map_get_font_cache&#160;()</title>
<indexterm zone="pango-win32-font-map-get-font-cache"><primary>pango_win32_font_map_get_font_cache</primary></indexterm>
<programlisting language="C"><link linkend="PangoWin32FontCache"><returnvalue>PangoWin32FontCache</returnvalue></link>&#160;*
pango_win32_font_map_get_font_cache (<parameter><link linkend="PangoFontMap"><type>PangoFontMap</type></link> *font_map</parameter>);</programlisting>
<para>Obtains the font cache associated with the given font map.</para>
<refsect3 id="pango-win32-font-map-get-font-cache.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>font_map</para></entry>
<entry role="parameter_description"><para>a <type>PangoWin32FontMap</type>.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="pango-win32-font-map-get-font-cache.returns" role="returns">
<title>Returns</title>
<para> the <link linkend="PangoWin32FontCache"><type>PangoWin32FontCache</type></link> of <parameter>font_map</parameter>
.</para>
</refsect3></refsect2>
<refsect2 id="pango-win32-font-logfont" role="function">
<title>pango_win32_font_logfont&#160;()</title>
<indexterm zone="pango-win32-font-logfont"><primary>pango_win32_font_logfont</primary></indexterm>
<programlisting language="C"><link linkend="LOGFONTA:CAPS"><returnvalue>LOGFONTA</returnvalue></link>&#160;*
pango_win32_font_logfont (<parameter><link linkend="PangoFont"><type>PangoFont</type></link> *font</parameter>);</programlisting>
<para>Determine the LOGFONTA struct for the specified font. Note that
Pango internally uses LOGFONTW structs, so if converting the UTF-16
face name in the LOGFONTW struct to system codepage fails, the
returned LOGFONTA will have an emppty face name. To get the
LOGFONTW of a PangoFont, use <link linkend="pango-win32-font-logfontw"><function>pango_win32_font_logfontw()</function></link>. It
is recommended to do that always even if you don't expect
to come across fonts with odd names.</para>
<refsect3 id="pango-win32-font-logfont.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>font</para></entry>
<entry role="parameter_description"><para>a <link linkend="PangoFont"><type>PangoFont</type></link> which must be from the Win32 backend</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="pango-win32-font-logfont.returns" role="returns">
<title>Returns</title>
<para> A newly allocated LOGFONTA struct. It must be
freed with <link linkend="g-free"><function>g_free()</function></link>.</para>
</refsect3></refsect2>
<refsect2 id="pango-win32-font-logfontw" role="function" condition="since:1.16">
<title>pango_win32_font_logfontw&#160;()</title>
<indexterm zone="pango-win32-font-logfontw" role="1.16"><primary>pango_win32_font_logfontw</primary></indexterm>
<programlisting language="C"><link linkend="LOGFONTW:CAPS"><returnvalue>LOGFONTW</returnvalue></link>&#160;*
pango_win32_font_logfontw (<parameter><link linkend="PangoFont"><type>PangoFont</type></link> *font</parameter>);</programlisting>
<para>Determine the LOGFONTW struct for the specified font.</para>
<refsect3 id="pango-win32-font-logfontw.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>font</para></entry>
<entry role="parameter_description"><para>a <link linkend="PangoFont"><type>PangoFont</type></link> which must be from the Win32 backend</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="pango-win32-font-logfontw.returns" role="returns">
<title>Returns</title>
<para> A newly allocated LOGFONTW struct. It must be
freed with <link linkend="g-free"><function>g_free()</function></link>.</para>
</refsect3><para role="since">Since: <link linkend="api-index-1.16">1.16</link></para></refsect2>
<refsect2 id="pango-win32-font-description-from-logfont" role="function" condition="since:1.12">
<title>pango_win32_font_description_from_logfont&#160;()</title>
<indexterm zone="pango-win32-font-description-from-logfont" role="1.12"><primary>pango_win32_font_description_from_logfont</primary></indexterm>
<programlisting language="C"><link linkend="PangoFontDescription"><returnvalue>PangoFontDescription</returnvalue></link>&#160;*
pango_win32_font_description_from_logfont
                               (<parameter>const <link linkend="LOGFONTA:CAPS"><type>LOGFONTA</type></link> *lfp</parameter>);</programlisting>
<para>Creates a <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link> that matches the specified LOGFONTA.</para>
<para>The face name, italicness and weight fields in the LOGFONTA are used
to set up the resulting <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link>. If the face name in
the LOGFONTA contains non-ASCII characters the font is temporarily
loaded (using <link linkend="CreateFontIndirect"><function>CreateFontIndirect()</function></link>) 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.</para>
<refsect3 id="pango-win32-font-description-from-logfont.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>lfp</para></entry>
<entry role="parameter_description"><para>a LOGFONTA</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="pango-win32-font-description-from-logfont.returns" role="returns">
<title>Returns</title>
<para> the newly allocated <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link>, which
should be freed using <link linkend="pango-font-description-free"><function>pango_font_description_free()</function></link></para>
</refsect3><para role="since">Since: <link linkend="api-index-1.12">1.12</link></para></refsect2>
<refsect2 id="pango-win32-font-description-from-logfontw" role="function" condition="since:1.16">
<title>pango_win32_font_description_from_logfontw&#160;()</title>
<indexterm zone="pango-win32-font-description-from-logfontw" role="1.16"><primary>pango_win32_font_description_from_logfontw</primary></indexterm>
<programlisting language="C"><link linkend="PangoFontDescription"><returnvalue>PangoFontDescription</returnvalue></link>&#160;*
pango_win32_font_description_from_logfontw
                               (<parameter>const <link linkend="LOGFONTW:CAPS"><type>LOGFONTW</type></link> *lfp</parameter>);</programlisting>
<para>Creates a <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link> that matches the specified LOGFONTW.</para>
<para>The face name, italicness and weight fields in the LOGFONTW are used
to set up the resulting <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link>. If the face name in
the LOGFONTW contains non-ASCII characters the font is temporarily
loaded (using <link linkend="CreateFontIndirect"><function>CreateFontIndirect()</function></link>) 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 UTF-16
to UTF-8 and that is used.</para>
<refsect3 id="pango-win32-font-description-from-logfontw.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>lfp</para></entry>
<entry role="parameter_description"><para>a LOGFONTW</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="pango-win32-font-description-from-logfontw.returns" role="returns">
<title>Returns</title>
<para> the newly allocated <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link>, which
should be freed using <link linkend="pango-font-description-free"><function>pango_font_description_free()</function></link></para>
</refsect3><para role="since">Since: <link linkend="api-index-1.16">1.16</link></para></refsect2>

</refsect1>
<refsect1 id="pango-Win32-Fonts-and-Rendering.other_details" role="details">
<title role="details.title">Types and Values</title>
<refsect2 id="PangoWin32FontCache" role="struct">
<title>PangoWin32FontCache</title>
<indexterm zone="PangoWin32FontCache"><primary>PangoWin32FontCache</primary></indexterm>
<programlisting language="C">typedef struct _PangoWin32FontCache PangoWin32FontCache;</programlisting>
<para>A <link linkend="PangoWin32FontCache"><type>PangoWin32FontCache</type></link> caches HFONTs by their LOGFONT descriptions.</para>
</refsect2>

</refsect1>

</refentry>
