~ubuntu-branches/ubuntu/natty/pygtk/natty-proposed

« back to all changes in this revision

Viewing changes to docs/html/class-pangofontdescription.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2010-01-07 11:08:47 UTC
  • mfrom: (1.2.8 upstream)
  • Revision ID: james.westby@ubuntu.com-20100107110847-f5av7e1ttudh7ra6
Tags: 2.17.0-0ubuntu1
New upstream version

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><title>pango.FontDescription</title><link rel="stylesheet" href="style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" href="index.html" title="PyGTK 2.0 Reference Manual"><link rel="up" href="pango-class-reference.html" title="The pango Class Reference"><link rel="prev" href="class-pangofont.html" title="pango.Font"><link rel="next" href="class-pangofontface.html" title="pango.FontFace"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">pango.FontDescription</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="class-pangofont.html">Prev</a> </td><th width="60%" align="center">The pango Class Reference</th><td width="20%" align="right"> <a accesskey="n" href="class-pangofontface.html">Next</a></td></tr></table><hr></div><div class="refentry" lang="en"><a name="class-pangofontdescription"></a><div class="titlepage"></div><div class="refnamediv"><h2>pango.FontDescription</h2><p>pango.FontDescription — an object representing a description of a font.</p></div><div class="refsect1" lang="en"><a name="id3193286"></a><h2>Synopsis</h2><table bgcolor="#D0E0F0" width="100%"><tr><td><pre class="classsynopsis">class <span class="ooclass"><span class="classname">pango.FontDescription</span></span>(<span class="ooclass"><span class="classname">gobject.GBoxed</span></span>):
2
 
<code class="constructorsynopsis">    <span class="methodname"><a class="link" href="class-pangofontdescription.html#constructor-pangofontdescription" title="Constructor">pango.FontDescription</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>str</code></strong></span><span class="initializer">=None</span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--copy" title="pango.FontDescription.copy">copy</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--copy-static" title="pango.FontDescription.copy_static">copy_static</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--hash" title="pango.FontDescription.hash">hash</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--set-family" title="pango.FontDescription.set_family">set_family</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>family</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--set-family-static" title="pango.FontDescription.set_family_static">set_family_static</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>family</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--get-family" title="pango.FontDescription.get_family">get_family</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--set-style" title="pango.FontDescription.set_style">set_style</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>style</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--get-style" title="pango.FontDescription.get_style">get_style</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--set-variant" title="pango.FontDescription.set_variant">set_variant</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>variant</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--get-variant" title="pango.FontDescription.get_variant">get_variant</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--set-weight" title="pango.FontDescription.set_weight">set_weight</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>weight</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--get-weight" title="pango.FontDescription.get_weight">get_weight</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--set-stretch" title="pango.FontDescription.set_stretch">set_stretch</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>stretch</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--get-stretch" title="pango.FontDescription.get_stretch">get_stretch</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--set-size" title="pango.FontDescription.set_size">set_size</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>size</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--get-size" title="pango.FontDescription.get_size">get_size</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--get-set-fields" title="pango.FontDescription.get_set_fields">get_set_fields</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--unset-fields" title="pango.FontDescription.unset_fields">unset_fields</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>to_unset</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--merge" title="pango.FontDescription.merge">merge</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>desc_to_merge</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>replace_existing</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--merge-static" title="pango.FontDescription.merge_static">merge_static</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>desc_to_merge</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>replace_existing</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--better-match" title="pango.FontDescription.better_match">better_match</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>old_match</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>new_match</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--to-string" title="pango.FontDescription.to_string">to_string</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--to-filename" title="pango.FontDescription.to_filename">to_filename</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--set-absolute-size" title="pango.FontDescription.set_absolute_size">set_absolute_size</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>size</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--get-size-is-absolute" title="pango.FontDescription.get_size_is_absolute">get_size_is_absolute</a></span>(<span class="methodparam"></span>)</code><br></pre></td></tr></table></div><div class="refsect1" lang="en"><a name="id3004725"></a><h2>Description</h2><p>A <a class="link" href="class-pangofontdescription.html" title="pango.FontDescription"><code class="classname">pango.FontDescription</code></a> 
 
1
<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><title>pango.FontDescription</title><link rel="stylesheet" href="style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.1"><link rel="home" href="index.html" title="PyGTK 2.0 Reference Manual"><link rel="up" href="pango-class-reference.html" title="The pango Class Reference"><link rel="prev" href="class-pangofont.html" title="pango.Font"><link rel="next" href="class-pangofontface.html" title="pango.FontFace"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">pango.FontDescription</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="class-pangofont.html">Prev</a> </td><th width="60%" align="center">The pango Class Reference</th><td width="20%" align="right"> <a accesskey="n" href="class-pangofontface.html">Next</a></td></tr></table><hr></div><div class="refentry" title="pango.FontDescription"><a name="class-pangofontdescription"></a><div class="titlepage"></div><div class="refnamediv"><h2>pango.FontDescription</h2><p>pango.FontDescription — an object representing a description of a font.</p></div><div class="refsect1" title="Synopsis"><a name="id3621172"></a><h2>Synopsis</h2><table bgcolor="#D0E0F0" width="100%"><tr><td><pre class="classsynopsis">class <span class="ooclass"><span class="classname">pango.FontDescription</span></span>(<span class="ooclass"><span class="classname">gobject.GBoxed</span></span>):
 
2
<code class="constructorsynopsis">    <span class="methodname"><a class="link" href="class-pangofontdescription.html#constructor-pangofontdescription" title="Constructor">pango.FontDescription</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>str</code></strong></span><span class="initializer">=None</span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--copy" title="pango.FontDescription.copy">copy</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--copy-static" title="pango.FontDescription.copy_static">copy_static</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--hash" title="pango.FontDescription.hash">hash</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--set-family" title="pango.FontDescription.set_family">set_family</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>family</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--set-family-static" title="pango.FontDescription.set_family_static">set_family_static</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>family</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--get-family" title="pango.FontDescription.get_family">get_family</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--set-style" title="pango.FontDescription.set_style">set_style</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>style</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--get-style" title="pango.FontDescription.get_style">get_style</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--set-variant" title="pango.FontDescription.set_variant">set_variant</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>variant</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--get-variant" title="pango.FontDescription.get_variant">get_variant</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--set-weight" title="pango.FontDescription.set_weight">set_weight</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>weight</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--get-weight" title="pango.FontDescription.get_weight">get_weight</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--set-stretch" title="pango.FontDescription.set_stretch">set_stretch</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>stretch</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--get-stretch" title="pango.FontDescription.get_stretch">get_stretch</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--set-size" title="pango.FontDescription.set_size">set_size</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>size</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--get-size" title="pango.FontDescription.get_size">get_size</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--get-set-fields" title="pango.FontDescription.get_set_fields">get_set_fields</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--unset-fields" title="pango.FontDescription.unset_fields">unset_fields</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>to_unset</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--merge" title="pango.FontDescription.merge">merge</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>desc_to_merge</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>replace_existing</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--merge-static" title="pango.FontDescription.merge_static">merge_static</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>desc_to_merge</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>replace_existing</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--better-match" title="pango.FontDescription.better_match">better_match</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>old_match</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>new_match</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--to-string" title="pango.FontDescription.to_string">to_string</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--to-filename" title="pango.FontDescription.to_filename">to_filename</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--set-absolute-size" title="pango.FontDescription.set_absolute_size">set_absolute_size</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>size</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-pangofontdescription.html#method-pangofontdescription--get-size-is-absolute" title="pango.FontDescription.get_size_is_absolute">get_size_is_absolute</a></span>(<span class="methodparam"></span>)</code><br></pre></td></tr></table></div><div class="refsect1" title="Description"><a name="id3501978"></a><h2>Description</h2><p>A <a class="link" href="class-pangofontdescription.html" title="pango.FontDescription"><code class="classname">pango.FontDescription</code></a> 
3
3
represents the description of an ideal font. They are used to both specify
4
4
the characteristics of a font to load and to list the available fonts on the
5
 
system.</p></div><div class="refsect1" lang="en"><a name="constructor-pangofontdescription"></a><h2>Constructor</h2><pre class="programlisting"><code class="constructorsynopsis">    <span class="methodname">pango.FontDescription</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a <a class="link" href="class-pangofontdescription.html" title="pango.FontDescription"><code class="classname">pango.FontDescription</code></a> 
 
5
system.</p></div><div class="refsect1" title="Constructor"><a name="constructor-pangofontdescription"></a><h2>Constructor</h2><pre class="programlisting"><code class="constructorsynopsis">    <span class="methodname">pango.FontDescription</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a <a class="link" href="class-pangofontdescription.html" title="pango.FontDescription"><code class="classname">pango.FontDescription</code></a> 
6
6
object.</td></tr></tbody></table><p>Creates a new <a class="link" href="class-pangofontdescription.html" title="pango.FontDescription"><code class="classname">pango.FontDescription</code></a> 
7
7
object from the representation in the string specified by
8
8
<em class="parameter"><code>str</code></em>. The format of the string representation
18
18
  "serif,monospace bold italic condensed 16"
19
19
  "normal 10"
20
20
</pre><p>The commonly available font families are: Normal, Sans, Serif and
21
 
Monospace. The available styles are:</p><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term">Normal</span></p></td><td>the font is upright.</td></tr><tr><td><p><span class="term">Oblique</span></p></td><td>the font is slanted, but in a roman style.</td></tr><tr><td><p><span class="term">Italic</span></p></td><td>the font is slanted in an italic style. </td></tr></tbody></table><p>The available weights are:</p><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term">Ultra-Light</span></p></td><td>the ultralight weight (= 200)</td></tr><tr><td><p><span class="term">Light</span></p></td><td>the light weight (=300)</td></tr><tr><td><p><span class="term">Normal</span></p></td><td>the default weight (= 400)</td></tr><tr><td><p><span class="term">Bold</span></p></td><td>the bold weight (= 700)</td></tr><tr><td><p><span class="term">Ultra-Bold</span></p></td><td>the ultra-bold weight (= 800)</td></tr><tr><td><p><span class="term">Heavy</span></p></td><td>the heavy weight (= 900)</td></tr></tbody></table><p>The available variants are:</p><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term">Normal</span></p></td><td></td></tr><tr><td><p><span class="term">Small-Caps</span></p></td><td></td></tr></tbody></table><p>The available stretch styles are:</p><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term">Ultra-Condensed</span></p></td><td>the smallest width</td></tr><tr><td><p><span class="term">Extra-Condensed</span></p></td><td></td></tr><tr><td><p><span class="term">Condensed</span></p></td><td></td></tr><tr><td><p><span class="term">Semi-Condensed</span></p></td><td></td></tr><tr><td><p><span class="term">Normal</span></p></td><td>the normal width</td></tr><tr><td><p><span class="term">Semi-Expanded</span></p></td><td></td></tr><tr><td><p><span class="term">Expanded</span></p></td><td></td></tr><tr><td><p><span class="term">Extra-Expanded</span></p></td><td></td></tr><tr><td><p><span class="term">Ultra-Expanded</span></p></td><td>the widest width</td></tr></tbody></table><p></p></div><div class="refsect1" lang="en"><a name="id3280561"></a><h2>Methods</h2><div class="refsect2" lang="en"><a name="method-pangofontdescription--copy"></a><h3>pango.FontDescription.copy</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">copy</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a new <a class="link" href="class-pangofontdescription.html" title="pango.FontDescription"><code class="classname">pango.FontDescription</code></a></td></tr></tbody></table><p>The <code class="methodname">copy</code>() method returns a new copy of
22
 
this font description.</p></div><div class="refsect2" lang="en"><a name="method-pangofontdescription--copy-static"></a><h3>pango.FontDescription.copy_static</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">copy_static</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a new <a class="link" href="class-pangofontdescription.html" title="pango.FontDescription"><code class="classname">pango.FontDescription</code></a>..</td></tr></tbody></table><p>The <code class="methodname">copy_static</code>() method is like the
 
21
Monospace. The available styles are:</p><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term">Normal</span></p></td><td>the font is upright.</td></tr><tr><td><p><span class="term">Oblique</span></p></td><td>the font is slanted, but in a roman style.</td></tr><tr><td><p><span class="term">Italic</span></p></td><td>the font is slanted in an italic style. </td></tr></tbody></table><p>The available weights are:</p><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term">Ultra-Light</span></p></td><td>the ultralight weight (= 200)</td></tr><tr><td><p><span class="term">Light</span></p></td><td>the light weight (=300)</td></tr><tr><td><p><span class="term">Normal</span></p></td><td>the default weight (= 400)</td></tr><tr><td><p><span class="term">Bold</span></p></td><td>the bold weight (= 700)</td></tr><tr><td><p><span class="term">Ultra-Bold</span></p></td><td>the ultra-bold weight (= 800)</td></tr><tr><td><p><span class="term">Heavy</span></p></td><td>the heavy weight (= 900)</td></tr></tbody></table><p>The available variants are:</p><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term">Normal</span></p></td><td></td></tr><tr><td><p><span class="term">Small-Caps</span></p></td><td></td></tr></tbody></table><p>The available stretch styles are:</p><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term">Ultra-Condensed</span></p></td><td>the smallest width</td></tr><tr><td><p><span class="term">Extra-Condensed</span></p></td><td></td></tr><tr><td><p><span class="term">Condensed</span></p></td><td></td></tr><tr><td><p><span class="term">Semi-Condensed</span></p></td><td></td></tr><tr><td><p><span class="term">Normal</span></p></td><td>the normal width</td></tr><tr><td><p><span class="term">Semi-Expanded</span></p></td><td></td></tr><tr><td><p><span class="term">Expanded</span></p></td><td></td></tr><tr><td><p><span class="term">Extra-Expanded</span></p></td><td></td></tr><tr><td><p><span class="term">Ultra-Expanded</span></p></td><td>the widest width</td></tr></tbody></table><p></p></div><div class="refsect1" title="Methods"><a name="id3194603"></a><h2>Methods</h2><div class="refsect2" title="pango.FontDescription.copy"><a name="method-pangofontdescription--copy"></a><h3>pango.FontDescription.copy</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">copy</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a new <a class="link" href="class-pangofontdescription.html" title="pango.FontDescription"><code class="classname">pango.FontDescription</code></a></td></tr></tbody></table><p>The <code class="methodname">copy</code>() method returns a new copy of
 
22
this font description.</p></div><div class="refsect2" title="pango.FontDescription.copy_static"><a name="method-pangofontdescription--copy-static"></a><h3>pango.FontDescription.copy_static</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">copy_static</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a new <a class="link" href="class-pangofontdescription.html" title="pango.FontDescription"><code class="classname">pango.FontDescription</code></a>..</td></tr></tbody></table><p>The <code class="methodname">copy_static</code>() method is like the
23
23
<a class="link" href="class-pangofontdescription.html#method-pangofontdescription--copy" title="pango.FontDescription.copy"><code class="methodname">copy</code>()</a> 
24
24
method, but only a shallow copy is made of the family name and other
25
25
allocated attribute fields. The result can only be used until the original
26
26
font description is modified or freed. This is meant to be used when the
27
 
copy is only needed temporarily.</p></div><div class="refsect2" lang="en"><a name="method-pangofontdescription--hash"></a><h3>pango.FontDescription.hash</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">hash</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the hash value.</td></tr></tbody></table><p>The <code class="methodname">hash</code>() method computes and returns
28
 
a hash of the <a class="link" href="class-pangofontdescription.html" title="pango.FontDescription"><code class="classname">pango.FontDescription</code></a>.</p></div><div class="refsect2" lang="en"><a name="method-pangofontdescription--set-family"></a><h3>pango.FontDescription.set_family</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_family</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>family</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>family</code></strong> :</span></p></td><td>a string representing the family
 
27
copy is only needed temporarily.</p></div><div class="refsect2" title="pango.FontDescription.hash"><a name="method-pangofontdescription--hash"></a><h3>pango.FontDescription.hash</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">hash</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the hash value.</td></tr></tbody></table><p>The <code class="methodname">hash</code>() method computes and returns
 
28
a hash of the <a class="link" href="class-pangofontdescription.html" title="pango.FontDescription"><code class="classname">pango.FontDescription</code></a>.</p></div><div class="refsect2" title="pango.FontDescription.set_family"><a name="method-pangofontdescription--set-family"></a><h3>pango.FontDescription.set_family</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_family</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>family</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>family</code></strong> :</span></p></td><td>a string representing the family
29
29
name.</td></tr></tbody></table><p>The <code class="methodname">set_family</code>() method sets the family
30
30
name attribute field of the font description to the value specified by
31
31
<em class="parameter"><code>family</code></em>. The family name represents a family of
32
32
related font styles, and will resolve to a particular <a class="link" href="class-pangofontfamily.html" title="pango.FontFamily"><code class="classname">pango.FontFamily</code></a>. 
33
33
In some uses of <a class="link" href="class-pangofontdescription.html" title="pango.FontDescription"><code class="classname">pango.FontDescription</code></a>, 
34
34
it is also possible to use a comma separated list of family names for this
35
 
field.</p></div><div class="refsect2" lang="en"><a name="method-pangofontdescription--set-family-static"></a><h3>pango.FontDescription.set_family_static</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_family_static</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>family</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>family</code></strong> :</span></p></td><td>a string representing the family
 
35
field.</p></div><div class="refsect2" title="pango.FontDescription.set_family_static"><a name="method-pangofontdescription--set-family-static"></a><h3>pango.FontDescription.set_family_static</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_family_static</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>family</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>family</code></strong> :</span></p></td><td>a string representing the family
36
36
name.</td></tr></tbody></table><p>The set_family_static() method is like the <a class="link" href="class-pangofontdescription.html#method-pangofontdescription--set-family" title="pango.FontDescription.set_family"><code class="methodname">set_family</code>()</a>, 
37
37
except that no copy of <em class="parameter"><code>family</code></em> is made. The caller
38
38
must make sure that the string passed in stays around until the font
39
39
description is no longer needed or the family name is set again. This method
40
40
can be used if <em class="parameter"><code>family</code></em> is only needed
41
 
temporarily.</p></div><div class="refsect2" lang="en"><a name="method-pangofontdescription--get-family"></a><h3>pango.FontDescription.get_family</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_family</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the family name or <code class="literal">None</code> if
 
41
temporarily.</p></div><div class="refsect2" title="pango.FontDescription.get_family"><a name="method-pangofontdescription--get-family"></a><h3>pango.FontDescription.get_family</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_family</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the family name or <code class="literal">None</code> if
42
42
not previously set.</td></tr></tbody></table><p>The <code class="methodname">get_family</code>() method returns the
43
43
family name attribute field of the font description. See the <a class="link" href="class-pangofontdescription.html#method-pangofontdescription--set-family" title="pango.FontDescription.set_family"><code class="methodname">set_family</code>()</a> 
44
 
method for more information.</p></div><div class="refsect2" lang="en"><a name="method-pangofontdescription--set-style"></a><h3>pango.FontDescription.set_style</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_style</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>style</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>style</code></strong> :</span></p></td><td>the style for the font
 
44
method for more information.</p></div><div class="refsect2" title="pango.FontDescription.set_style"><a name="method-pangofontdescription--set-style"></a><h3>pango.FontDescription.set_style</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_style</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>style</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>style</code></strong> :</span></p></td><td>the style for the font
45
45
description</td></tr></tbody></table><p>The <code class="methodname">set_style</code>() method sets the slant
46
46
style attribute field of the <a class="link" href="class-pangofontdescription.html" title="pango.FontDescription"><code class="classname">pango.FontDescription</code></a> 
47
47
to the value specified by <em class="parameter"><code>style</code></em>. The value of
51
51
<code class="literal">pango.STYLE_OBLIQUE</code>. Most fonts will either have a italic
52
52
style or an oblique style, but not both, and font matching in Pango will
53
53
match italic specifications with oblique fonts and vice-versa if an exact
54
 
match is not found.</p></div><div class="refsect2" lang="en"><a name="method-pangofontdescription--get-style"></a><h3>pango.FontDescription.get_style</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_style</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the slant style for the font description.
 
54
match is not found.</p></div><div class="refsect2" title="pango.FontDescription.get_style"><a name="method-pangofontdescription--get-style"></a><h3>pango.FontDescription.get_style</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_style</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the slant style for the font description.
55
55
</td></tr></tbody></table><p>The <code class="methodname">get_style</code>() method returns the
56
56
slant style attribute field of the <a class="link" href="class-pangofontdescription.html" title="pango.FontDescription"><code class="classname">pango.FontDescription</code></a>. 
57
57
See the <a class="link" href="class-pangofontdescription.html#method-pangofontdescription--set-style" title="pango.FontDescription.set_style"><code class="methodname">set_style</code>()</a> 
58
58
method for more details. Use the <a class="link" href="class-pangofontdescription.html#method-pangofontdescription--get-set-fields" title="pango.FontDescription.get_set_fields"><code class="methodname">get_set_fields</code>()</a> 
59
 
method to find out if the field was explicitly set.</p></div><div class="refsect2" lang="en"><a name="method-pangofontdescription--set-variant"></a><h3>pango.FontDescription.set_variant</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_variant</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>variant</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>variant</code></strong> :</span></p></td><td>the variant type for the font
 
59
method to find out if the field was explicitly set.</p></div><div class="refsect2" title="pango.FontDescription.set_variant"><a name="method-pangofontdescription--set-variant"></a><h3>pango.FontDescription.set_variant</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_variant</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>variant</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>variant</code></strong> :</span></p></td><td>the variant type for the font
60
60
description.</td></tr></tbody></table><p>The <code class="methodname">set_variant</code>() method sets the
61
61
variant attribute field of a font description to the value specified by
62
62
<em class="parameter"><code>variant</code></em>. The value of <em class="parameter"><code>variant</code></em>
63
63
must be either <code class="literal">pango.VARIANT_NORMAL</code> or
64
 
<code class="literal">pango.VARIANT_SMALL_CAPS</code>.</p></div><div class="refsect2" lang="en"><a name="method-pangofontdescription--get-variant"></a><h3>pango.FontDescription.get_variant</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_variant</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the variant style of the font
 
64
<code class="literal">pango.VARIANT_SMALL_CAPS</code>.</p></div><div class="refsect2" title="pango.FontDescription.get_variant"><a name="method-pangofontdescription--get-variant"></a><h3>pango.FontDescription.get_variant</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_variant</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the variant style of the font
65
65
description.</td></tr></tbody></table><p>The <code class="methodname">get_variant</code>() method returns the
66
66
variant style of a <a class="link" href="class-pangofontdescription.html" title="pango.FontDescription"><code class="classname">pango.FontDescription</code></a>. 
67
67
See the <a class="link" href="class-pangofontdescription.html#method-pangofontdescription--set-variant" title="pango.FontDescription.set_variant"><code class="methodname">set_variant</code>()</a> 
68
68
method for more information. Use the <a class="link" href="class-pangofontdescription.html#method-pangofontdescription--get-set-fields" title="pango.FontDescription.get_set_fields"><code class="methodname">get_set_fields</code>()</a> 
69
 
method to find out if the field was explicitly set.</p></div><div class="refsect2" lang="en"><a name="method-pangofontdescription--set-weight"></a><h3>pango.FontDescription.set_weight</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_weight</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>weight</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>weight</code></strong> :</span></p></td><td>the weight for the font
 
69
method to find out if the field was explicitly set.</p></div><div class="refsect2" title="pango.FontDescription.set_weight"><a name="method-pangofontdescription--set-weight"></a><h3>pango.FontDescription.set_weight</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_weight</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>weight</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>weight</code></strong> :</span></p></td><td>the weight for the font
70
70
description.</td></tr></tbody></table><p>The <code class="methodname">set_weight</code>() method sets the weight
71
71
attribute field of a font description to the value specified by
72
72
<em class="parameter"><code>weight</code></em>. The value of <em class="parameter"><code>weight</code></em>
73
73
specifies how bold or light the font should be in a range from 100 to 900.
74
 
The predefined values of weight are:</p><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><code class="literal">pango.WEIGHT_ULTRALIGHT</code></span></p></td><td>the ultralight weight (= 200)</td></tr><tr><td><p><span class="term"><code class="literal">pango.WEIGHT_LIGHT</code></span></p></td><td>the light weight (=300)</td></tr><tr><td><p><span class="term"><code class="literal">pango.WEIGHT_NORMAL</code></span></p></td><td>the default weight (= 400)</td></tr><tr><td><p><span class="term"><code class="literal">pango.WEIGHT_BOLD</code></span></p></td><td>the bold weight (= 700)</td></tr><tr><td><p><span class="term"><code class="literal">pango.WEIGHT_ULTRABOLD</code></span></p></td><td>the ultrabold weight (= 800)</td></tr><tr><td><p><span class="term"><code class="literal">pango.WEIGHT_HEAVY</code></span></p></td><td>the heavy weight (= 900)</td></tr></tbody></table><p></p></div><div class="refsect2" lang="en"><a name="method-pangofontdescription--get-weight"></a><h3>pango.FontDescription.get_weight</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_weight</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the weight field for the font
 
74
The predefined values of weight are:</p><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><code class="literal">pango.WEIGHT_ULTRALIGHT</code></span></p></td><td>the ultralight weight (= 200)</td></tr><tr><td><p><span class="term"><code class="literal">pango.WEIGHT_LIGHT</code></span></p></td><td>the light weight (=300)</td></tr><tr><td><p><span class="term"><code class="literal">pango.WEIGHT_NORMAL</code></span></p></td><td>the default weight (= 400)</td></tr><tr><td><p><span class="term"><code class="literal">pango.WEIGHT_BOLD</code></span></p></td><td>the bold weight (= 700)</td></tr><tr><td><p><span class="term"><code class="literal">pango.WEIGHT_ULTRABOLD</code></span></p></td><td>the ultrabold weight (= 800)</td></tr><tr><td><p><span class="term"><code class="literal">pango.WEIGHT_HEAVY</code></span></p></td><td>the heavy weight (= 900)</td></tr></tbody></table><p></p></div><div class="refsect2" title="pango.FontDescription.get_weight"><a name="method-pangofontdescription--get-weight"></a><h3>pango.FontDescription.get_weight</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_weight</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the weight field for the font
75
75
description.</td></tr></tbody></table><p>The <code class="methodname">get_weight</code>() method returns the
76
76
value of the weight attribute of a font description. See the <a class="link" href="class-pangofontdescription.html#method-pangofontdescription--set-weight" title="pango.FontDescription.set_weight"><code class="methodname">set_weight</code>()</a> 
77
77
method for more information. Use the <a class="link" href="class-pangofontdescription.html#method-pangofontdescription--get-set-fields" title="pango.FontDescription.get_set_fields"><code class="methodname">get_set_fields</code>()</a> 
78
 
method to determine if the attribute was explicitly set.</p></div><div class="refsect2" lang="en"><a name="method-pangofontdescription--set-stretch"></a><h3>pango.FontDescription.set_stretch</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_stretch</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>stretch</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>stretch</code></strong> :</span></p></td><td>the stretch for the font
 
78
method to determine if the attribute was explicitly set.</p></div><div class="refsect2" title="pango.FontDescription.set_stretch"><a name="method-pangofontdescription--set-stretch"></a><h3>pango.FontDescription.set_stretch</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_stretch</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>stretch</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>stretch</code></strong> :</span></p></td><td>the stretch for the font
79
79
description</td></tr></tbody></table><p>The <code class="methodname">set_stretch</code>() method sets the
80
80
stretch attribute field of a font description to the value specified by
81
81
<em class="parameter"><code>stretch</code></em>. The value of <em class="parameter"><code>stretch</code></em>
82
82
specifies how narrow or wide the font should be relative to the base width
83
 
of the font family:</p><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><code class="literal">pango.STRETCH_ULTRA_CONDENSED</code></span></p></td><td>the narrowest width</td></tr><tr><td><p><span class="term"><code class="literal">pango.STRETCH_EXTRA_CONDENSED</code></span></p></td><td></td></tr><tr><td><p><span class="term"><code class="literal">pango.STRETCH_CONDENSED</code></span></p></td><td></td></tr><tr><td><p><span class="term"><code class="literal">pango.STRETCH_SEMI_CONDENSED</code></span></p></td><td></td></tr><tr><td><p><span class="term"><code class="literal">pango.STRETCH_NORMAL</code></span></p></td><td>the normal (base) width</td></tr><tr><td><p><span class="term"><code class="literal">pango.STRETCH_SEMI_EXPANDED</code></span></p></td><td></td></tr><tr><td><p><span class="term"><code class="literal">pango.STRETCH_EXPANDED</code></span></p></td><td></td></tr><tr><td><p><span class="term"><code class="literal">pango.STRETCH_EXTRA_EXPANDED</code></span></p></td><td></td></tr><tr><td><p><span class="term"><code class="literal">pango.STRETCH_ULTRA_EXPANDED</code></span></p></td><td>the widest width</td></tr></tbody></table><p></p></div><div class="refsect2" lang="en"><a name="method-pangofontdescription--get-stretch"></a><h3>pango.FontDescription.get_stretch</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_stretch</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the stretch field for the font
 
83
of the font family:</p><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><code class="literal">pango.STRETCH_ULTRA_CONDENSED</code></span></p></td><td>the narrowest width</td></tr><tr><td><p><span class="term"><code class="literal">pango.STRETCH_EXTRA_CONDENSED</code></span></p></td><td></td></tr><tr><td><p><span class="term"><code class="literal">pango.STRETCH_CONDENSED</code></span></p></td><td></td></tr><tr><td><p><span class="term"><code class="literal">pango.STRETCH_SEMI_CONDENSED</code></span></p></td><td></td></tr><tr><td><p><span class="term"><code class="literal">pango.STRETCH_NORMAL</code></span></p></td><td>the normal (base) width</td></tr><tr><td><p><span class="term"><code class="literal">pango.STRETCH_SEMI_EXPANDED</code></span></p></td><td></td></tr><tr><td><p><span class="term"><code class="literal">pango.STRETCH_EXPANDED</code></span></p></td><td></td></tr><tr><td><p><span class="term"><code class="literal">pango.STRETCH_EXTRA_EXPANDED</code></span></p></td><td></td></tr><tr><td><p><span class="term"><code class="literal">pango.STRETCH_ULTRA_EXPANDED</code></span></p></td><td>the widest width</td></tr></tbody></table><p></p></div><div class="refsect2" title="pango.FontDescription.get_stretch"><a name="method-pangofontdescription--get-stretch"></a><h3>pango.FontDescription.get_stretch</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_stretch</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the stretch field for the font
84
84
description</td></tr></tbody></table><p>The <code class="methodname">get_stretch</code>() method returns the
85
85
stretch attribute field of a font description. See the <a class="link" href="class-pangofontdescription.html#method-pangofontdescription--set-stretch" title="pango.FontDescription.set_stretch"><code class="methodname">set_stretch</code>()</a> 
86
86
method for more details. Use the <a class="link" href="class-pangofontdescription.html#method-pangofontdescription--get-set-fields" title="pango.FontDescription.get_set_fields"><code class="methodname">get_set_fields</code>()</a> 
87
 
method to determine if the field was explicitly set.</p></div><div class="refsect2" lang="en"><a name="method-pangofontdescription--set-size"></a><h3>pango.FontDescription.set_size</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_size</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>size</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>size</code></strong> :</span></p></td><td>the size for the font description in pango
 
87
method to determine if the field was explicitly set.</p></div><div class="refsect2" title="pango.FontDescription.set_size"><a name="method-pangofontdescription--set-size"></a><h3>pango.FontDescription.set_size</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_size</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>size</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>size</code></strong> :</span></p></td><td>the size for the font description in pango
88
88
units.</td></tr></tbody></table><p>The <code class="methodname">set_size</code>() method sets the
89
89
size attribute field of a font description to the value specified by
90
90
<em class="parameter"><code>size</code></em>. The value of <em class="parameter"><code>size</code></em> is
91
91
specified in pango units. There are <code class="literal">pango.SCALE</code> (1024)
92
92
pango units in one device unit (the device unit is a point for font
93
 
sizes).</p></div><div class="refsect2" lang="en"><a name="method-pangofontdescription--get-size"></a><h3>pango.FontDescription.get_size</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_size</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the size for the font description in pango
 
93
sizes).</p></div><div class="refsect2" title="pango.FontDescription.get_size"><a name="method-pangofontdescription--get-size"></a><h3>pango.FontDescription.get_size</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_size</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the size for the font description in pango
94
94
units.</td></tr></tbody></table><p>The <code class="methodname">get_size</code>() method returns the value
95
95
of the size attribute field of a font description. See the <a class="link" href="class-pangofontdescription.html#method-pangofontdescription--get-size" title="pango.FontDescription.get_size"><code class="methodname">get_size</code>()</a> 
96
96
method for more information. There are <code class="literal">pango.SCALE</code> pango
97
97
units in one device unit (point). If the stretch attribute field has not
98
98
previously been set, 0 is returned. Use the <a class="link" href="class-pangofontdescription.html#method-pangofontdescription--get-set-fields" title="pango.FontDescription.get_set_fields"><code class="methodname">get_set_fields</code>()</a> 
99
 
method to determine if the field was explicitly set.</p></div><div class="refsect2" lang="en"><a name="method-pangofontdescription--get-set-fields"></a><h3>pango.FontDescription.get_set_fields</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_set_fields</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a bitmask with bits set corresponding to the
 
99
method to determine if the field was explicitly set.</p></div><div class="refsect2" title="pango.FontDescription.get_set_fields"><a name="method-pangofontdescription--get-set-fields"></a><h3>pango.FontDescription.get_set_fields</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_set_fields</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a bitmask with bits set corresponding to the
100
100
font description attribute fields that have been set.</td></tr></tbody></table><p>The <code class="methodname">get_set_fields</code>() method returns a
101
101
value that indicates which attribute fields in a font description have been
102
 
set. The value returned is a combination of:</p><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><code class="literal">pango.FONT_MASK_FAMILY</code></span></p></td><td>the font family has been set.</td></tr><tr><td><p><span class="term"><code class="literal">pango.FONT_MASK_STYLE</code></span></p></td><td>the font slant style has been set.</td></tr><tr><td><p><span class="term"><code class="literal">pango.FONT_MASK_VARIANT</code></span></p></td><td>the font variant has been set.</td></tr><tr><td><p><span class="term"><code class="literal">pango.FONT_MASK_WEIGHT</code></span></p></td><td>the font weight has been set.</td></tr><tr><td><p><span class="term"><code class="literal">pango.FONT_MASK_STRETCH</code></span></p></td><td>the font stretch has been set.</td></tr><tr><td><p><span class="term"><code class="literal">pango.FONT_MASK_SIZE</code></span></p></td><td>the font size has been set.</td></tr></tbody></table><p></p></div><div class="refsect2" lang="en"><a name="method-pangofontdescription--unset-fields"></a><h3>pango.FontDescription.unset_fields</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">unset_fields</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>to_unset</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>to_unset</code></strong> :</span></p></td><td>a bitmask of attribute fields in the font
 
102
set. The value returned is a combination of:</p><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><code class="literal">pango.FONT_MASK_FAMILY</code></span></p></td><td>the font family has been set.</td></tr><tr><td><p><span class="term"><code class="literal">pango.FONT_MASK_STYLE</code></span></p></td><td>the font slant style has been set.</td></tr><tr><td><p><span class="term"><code class="literal">pango.FONT_MASK_VARIANT</code></span></p></td><td>the font variant has been set.</td></tr><tr><td><p><span class="term"><code class="literal">pango.FONT_MASK_WEIGHT</code></span></p></td><td>the font weight has been set.</td></tr><tr><td><p><span class="term"><code class="literal">pango.FONT_MASK_STRETCH</code></span></p></td><td>the font stretch has been set.</td></tr><tr><td><p><span class="term"><code class="literal">pango.FONT_MASK_SIZE</code></span></p></td><td>the font size has been set.</td></tr></tbody></table><p></p></div><div class="refsect2" title="pango.FontDescription.unset_fields"><a name="method-pangofontdescription--unset-fields"></a><h3>pango.FontDescription.unset_fields</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">unset_fields</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>to_unset</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>to_unset</code></strong> :</span></p></td><td>a bitmask of attribute fields in the font
103
103
description to unset.</td></tr></tbody></table><p>The <code class="methodname">unset_fields</code>() method unsets the
104
104
attribute fields (specified by <em class="parameter"><code>to_unset</code></em>) in the
105
105
<a class="link" href="class-pangofontdescription.html" title="pango.FontDescription"><code class="classname">pango.FontDescription</code></a>. 
106
106
Note that this merely marks the attribute fields cleared, it does not clear
107
 
the settings.</p></div><div class="refsect2" lang="en"><a name="method-pangofontdescription--merge"></a><h3>pango.FontDescription.merge</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">merge</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>desc_to_merge</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>replace_existing</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>desc_to_merge</code></strong> :</span></p></td><td>the <a class="link" href="class-pangofontdescription.html" title="pango.FontDescription"><code class="classname">pango.FontDescription</code></a> 
 
107
the settings.</p></div><div class="refsect2" title="pango.FontDescription.merge"><a name="method-pangofontdescription--merge"></a><h3>pango.FontDescription.merge</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">merge</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>desc_to_merge</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>replace_existing</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>desc_to_merge</code></strong> :</span></p></td><td>the <a class="link" href="class-pangofontdescription.html" title="pango.FontDescription"><code class="classname">pango.FontDescription</code></a> 
108
108
to merge into the font description</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>replace_existing</code></strong> :</span></p></td><td>if <code class="literal">True</code>, replace attribute
109
109
fields in the font description with the corresponding values from
110
110
<em class="parameter"><code>desc_to_merge</code></em>, even if they are already
115
115
<code class="literal">False</code>, only fields in the font description that are not
116
116
already set are affected. If <em class="parameter"><code>replace_existing</code></em> is
117
117
<code class="literal">True</code>, attribute fields that are already set will also be
118
 
replaced.</p></div><div class="refsect2" lang="en"><a name="method-pangofontdescription--merge-static"></a><h3>pango.FontDescription.merge_static</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">merge_static</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>desc_to_merge</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>replace_existing</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>desc_to_merge</code></strong> :</span></p></td><td>the <a class="link" href="class-pangofontdescription.html" title="pango.FontDescription"><code class="classname">pango.FontDescription</code></a> 
 
118
replaced.</p></div><div class="refsect2" title="pango.FontDescription.merge_static"><a name="method-pangofontdescription--merge-static"></a><h3>pango.FontDescription.merge_static</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">merge_static</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>desc_to_merge</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>replace_existing</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>desc_to_merge</code></strong> :</span></p></td><td>the <a class="link" href="class-pangofontdescription.html" title="pango.FontDescription"><code class="classname">pango.FontDescription</code></a> 
119
119
to merge from</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>replace_existing</code></strong> :</span></p></td><td>if <code class="literal">True</code>, replace attribute
120
120
fields in the font description with the corresponding values from
121
121
<em class="parameter"><code>desc_to_merge</code></em>, even if they are already
124
124
method, but only a shallow copy is made of the family name and other
125
125
allocated fields. The font description can only be used until
126
126
<em class="parameter"><code>desc_to_merge</code></em> is modified or freed. This is meant to
127
 
be used when the merged font description is only needed temporarily.</p></div><div class="refsect2" lang="en"><a name="method-pangofontdescription--better-match"></a><h3>pango.FontDescription.better_match</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">better_match</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>old_match</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>new_match</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>old_match</code></strong> :</span></p></td><td>a <a class="link" href="class-pangofontdescription.html" title="pango.FontDescription"><code class="classname">pango.FontDescription</code></a>, 
 
127
be used when the merged font description is only needed temporarily.</p></div><div class="refsect2" title="pango.FontDescription.better_match"><a name="method-pangofontdescription--better-match"></a><h3>pango.FontDescription.better_match</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">better_match</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>old_match</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>new_match</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>old_match</code></strong> :</span></p></td><td>a <a class="link" href="class-pangofontdescription.html" title="pango.FontDescription"><code class="classname">pango.FontDescription</code></a>, 
128
128
or <code class="literal">None</code></td></tr><tr><td><p><span class="term"><strong class="parameter"><code>new_match</code></strong> :</span></p></td><td>a <a class="link" href="class-pangofontdescription.html" title="pango.FontDescription"><code class="classname">pango.FontDescription</code></a></td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if
129
129
<em class="parameter"><code>new_match</code></em> is a better match</td></tr></tbody></table><p>The <code class="methodname">better_match</code>() method determines if
130
130
the attributes of the <a class="link" href="class-pangofontdescription.html" title="pango.FontDescription"><code class="classname">pango.FontDescription</code></a> 
134
134
<em class="parameter"><code>old_match</code></em> is <code class="literal">None</code>, determines if
135
135
<em class="parameter"><code>new_match</code></em> is a match at all. The weight and style
136
136
attribute need only match approximately but the other attributes must match
137
 
exactly.</p></div><div class="refsect2" lang="en"><a name="method-pangofontdescription--to-string"></a><h3>pango.FontDescription.to_string</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">to_string</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a string representation of the font
 
137
exactly.</p></div><div class="refsect2" title="pango.FontDescription.to_string"><a name="method-pangofontdescription--to-string"></a><h3>pango.FontDescription.to_string</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">to_string</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a string representation of the font
138
138
description.</td></tr></tbody></table><p>The <code class="methodname">to_string</code>() method returns a string
139
139
representation of the font description. See the <a class="link" href="class-pangofontdescription.html#constructor-pangofontdescription" title="Constructor">pango.FontDescription</a>()
140
140
constructor for a description of the format of the string representation.
141
141
The family list in the string description will only have a terminating comma
142
 
if the last word of the list is a valid style option.</p></div><div class="refsect2" lang="en"><a name="method-pangofontdescription--to-filename"></a><h3>pango.FontDescription.to_filename</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">to_filename</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a string representation of the font description
 
142
if the last word of the list is a valid style option.</p></div><div class="refsect2" title="pango.FontDescription.to_filename"><a name="method-pangofontdescription--to-filename"></a><h3>pango.FontDescription.to_filename</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">to_filename</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a string representation of the font description
143
143
as a filename.</td></tr></tbody></table><p>The <code class="methodname">to_filename</code>() method returns a
144
144
filename representation of a font description. The filename is identical to
145
145
the result from calling the <a class="link" href="class-pangofontdescription.html#method-pangofontdescription--to-string" title="pango.FontDescription.to_string"><code class="methodname">to_string</code>()</a> 
146
146
method, but underscores replace characters that are not typically used in
147
 
filenames, and it is in lower case only.</p></div><div class="refsect2" lang="en"><a name="method-pangofontdescription--set-absolute-size"></a><h3>pango.FontDescription.set_absolute_size</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_absolute_size</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>size</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>size</code></strong> :</span></p></td><td>the new size, in Pango units. There are
 
147
filenames, and it is in lower case only.</p></div><div class="refsect2" title="pango.FontDescription.set_absolute_size"><a name="method-pangofontdescription--set-absolute-size"></a><h3>pango.FontDescription.set_absolute_size</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_absolute_size</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>size</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>size</code></strong> :</span></p></td><td>the new size, in Pango units. There are
148
148
          <code class="literal">pango.SCALE</code> Pango units in one device unit. For
149
149
          an output backend where a device unit is a pixel, a
150
150
          <em class="parameter"><code>size</code></em> value of 10 * pango.SCALE gives a 10
151
 
          pixel font.</td></tr></tbody></table><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>Sets the size field of a font description, in device units. This
152
 
      is mutually exclusive with <a class="link" href="class-pangofontdescription.html#method-pangofontdescription--set-size" title="pango.FontDescription.set_size"><code class="methodname">pango.FontDescription.set_size()</code></a>.</p></div><div class="refsect2" lang="en"><a name="method-pangofontdescription--get-size-is-absolute"></a><h3>pango.FontDescription.get_size_is_absolute</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_size_is_absolute</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>whether the size for the font description is in
 
151
          pixel font.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>Sets the size field of a font description, in device units. This
 
152
      is mutually exclusive with <a class="link" href="class-pangofontdescription.html#method-pangofontdescription--set-size" title="pango.FontDescription.set_size"><code class="methodname">pango.FontDescription.set_size()</code></a>.</p></div><div class="refsect2" title="pango.FontDescription.get_size_is_absolute"><a name="method-pangofontdescription--get-size-is-absolute"></a><h3>pango.FontDescription.get_size_is_absolute</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_size_is_absolute</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>whether the size for the font description is in
153
153
          points or device units.  Use <a class="link" href="class-pangofontdescription.html#method-pangofontdescription--get-set-fields" title="pango.FontDescription.get_set_fields"><code class="methodname">pango.FontDescription.get_set_fields()</code></a>
154
154
          to find out if the size field of the font description was
155
 
          explicitly set or not.</td></tr></tbody></table><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>Determines whether the size of the font is in points or device
 
155
          explicitly set or not.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>Determines whether the size of the font is in points or device
156
156
      units.  See <a class="link" href="class-pangofontdescription.html#method-pangofontdescription--set-size" title="pango.FontDescription.set_size"><code class="methodname">pango.FontDescription.set_size()</code></a>
157
157
      and <a class="link" href="class-pangofontdescription.html#method-pangofontdescription--set-absolute-size" title="pango.FontDescription.set_absolute_size"><code class="methodname">pango.FontDescription.set_absolute_size()</code></a>.</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="class-pangofont.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="pango-class-reference.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="class-pangofontface.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">pango.Font </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> pango.FontFace</td></tr></table></div></body></html>