~ubuntu-branches/ubuntu/utopic/pango1.0/utopic

Viewing changes to docs/html/pango-Fonts.html

Committer: Package Import Robot
Author(s): Iain Lane
Date: 2014-03-20 18:19:30 UTC
mfrom: (1.6.10)
Revision ID: package-import@ubuntu.com-20140320181930-7sdul8ru2qlh86md

Tags: 1.36.3-1ubuntu1

* Merge with Debian, remaining change:
  - Add a versioned conflicts on old versions of plymouth whose initramfs
    hook tries to find pango modules. The Debian version of this change
    uses Breaks which is insufficient, and doesn't match the version of
    the plymouth package that supports the new path in Ubuntu.

files removed:
.pc/0001-Fix-tests-for-builddir-srcdir-by-setting-G_TEST_-SRC.patch

.pc/0001-Fix-tests-for-builddir-srcdir-by-setting-G_TEST_-SRC.patch/tests

.pc/0001-Fix-tests-for-builddir-srcdir-by-setting-G_TEST_-SRC.patch/tests/Makefile.am

debian/patches/0001-Fix-tests-for-builddir-srcdir-by-setting-G_TEST_-SRC.patch

files modified:
.pc/applied-patches

ChangeLog

NEWS

aclocal.m4

build/Makefile-msvcproj.am

build/pango-introspection-msvc.mak

config.h.win32

configure

configure.ac

debian/changelog

debian/control

debian/patches/series

debian/tests/control

docs/Makefile.in

docs/html/PangoEngineLang.html

docs/html/PangoEngineShape.html

docs/html/PangoFcDecoder.html

docs/html/PangoFcFont.html

docs/html/PangoFcFontMap.html

docs/html/PangoMarkupFormat.html

docs/html/PangoRenderer.html

docs/html/annotation-glossary.html

docs/html/api-index-1-10.html

docs/html/api-index-1-12.html

docs/html/api-index-1-14.html

docs/html/api-index-1-16.html

docs/html/api-index-1-18.html

docs/html/api-index-1-2.html

docs/html/api-index-1-20.html

docs/html/api-index-1-22.html

docs/html/api-index-1-24.html

docs/html/api-index-1-26.html

docs/html/api-index-1-30.html

docs/html/api-index-1-31-0.html

docs/html/api-index-1-32-4.html

docs/html/api-index-1-32.html

docs/html/api-index-1-34.html

docs/html/api-index-1-4.html

docs/html/api-index-1-6.html

docs/html/api-index-1-8.html

docs/html/api-index-deprecated.html

docs/html/api-index-full.html

docs/html/index.html

docs/html/index.sgml

docs/html/lowlevel.html

docs/html/pango-Bidirectional-Text.html

docs/html/pango-Cairo-Rendering.html

docs/html/pango-CoreText-Fonts.html

docs/html/pango-Coverage-Maps.html

docs/html/pango-Engines.html

docs/html/pango-Fonts.html

docs/html/pango-FreeType-Fonts-and-Rendering.html

docs/html/pango-Glyph-Storage.html

docs/html/pango-Layout-Objects.html

docs/html/pango-Miscellaneous-Utilities.html

docs/html/pango-Modules.html

docs/html/pango-OpenType-Font-Handling.html

docs/html/pango-Scripts-and-Languages.html

docs/html/pango-Tab-Stops.html

docs/html/pango-Text-Attributes.html

docs/html/pango-Text-Processing.html

docs/html/pango-Version-Checking.html

docs/html/pango-Vertical-Text.html

docs/html/pango-Win32-Fonts-and-Rendering.html

docs/html/pango-Xft-Fonts-and-Rendering.html

docs/html/pango-hierarchy.html

docs/html/pango-querymodules.html

docs/html/pango.devhelp2

docs/html/pango.html

docs/html/rendering.html

docs/html/style.css

docs/html/tools.html

docs/pango-querymodules.1

docs/version.xml

examples/cairotwisted.c

gtk-doc.make

pango-view/pango-view.1.in

pango/Makefile.in

pango/mini-fribidi/Makefile.in

pango/pango-color.c

pango/pango-features.h

pango/pango-ot-info.c

pango/pango.rc

pango/pangocairo.rc

pango/pangoft2.rc

pango/pangowin32.rc

pango/pangoxft.rc

tests/Makefile.in

Show diffs side-by-side

added added

removed removed

docs/html/pango-Fonts.html

</head>

<a href="#pango-Fonts.description" class="shortcut">Description</a>

<a href="#pango-Fonts.object-hierarchy" class="shortcut">Object Hierarchy</a>

<a href="#pango-Fonts.derived-interfaces" class="shortcut">Known Derived Interfaces</a>

<a href="#pango-Fonts.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span>

<a href="#pango-Fonts.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_derived_interfaces"> <span class="dim">|</span>

<a href="#pango-Fonts.derived-interfaces" class="shortcut">Known Derived Interfaces</a></span>

</td>

<h2><span class="refentrytitle"><a name="pango-Fonts.top_of_page"></a>Fonts</span></h2>

<p>Fonts — Structures representing abstract fonts</p>

</td>

</tr></table></div>

<a name="pango-Fonts.synopsis"></a><h2>Synopsis</h2>

<a name="PangoFontDescription"></a><a name="PangoStyle"></a><a name="PangoWeight"></a><a name="PangoVariant"></a><a name="PangoStretch"></a><a name="PangoFontMask"></a><a name="PangoFontMetrics"></a><a name="PangoFont"></a><a name="PangoFontFamily"></a><a name="PangoFontFace"></a><a name="PangoFontMap"></a><a name="PangoFontset"></a><a name="PangoFontsetSimple"></a><pre class="synopsis"> <a class="link" href="pango-Fonts.html#PangoFontDescription-struct" title="PangoFontDescription">PangoFontDescription</a>;

#define <a class="link" href="pango-Fonts.html#PANGO-TYPE-FONT-DESCRIPTION:CAPS" title="PANGO_TYPE_FONT_DESCRIPTION">PANGO_TYPE_FONT_DESCRIPTION</a>

enum <a class="link" href="pango-Fonts.html#PangoStyle-enum" title="enum PangoStyle">PangoStyle</a>;

#define <a class="link" href="pango-Fonts.html#PANGO-TYPE-STYLE:CAPS" title="PANGO_TYPE_STYLE">PANGO_TYPE_STYLE</a>

enum <a class="link" href="pango-Fonts.html#PangoWeight-enum" title="enum PangoWeight">PangoWeight</a>;

#define <a class="link" href="pango-Fonts.html#PANGO-TYPE-WEIGHT:CAPS" title="PANGO_TYPE_WEIGHT">PANGO_TYPE_WEIGHT</a>

enum <a class="link" href="pango-Fonts.html#PangoVariant-enum" title="enum PangoVariant">PangoVariant</a>;

#define <a class="link" href="pango-Fonts.html#PANGO-TYPE-VARIANT:CAPS" title="PANGO_TYPE_VARIANT">PANGO_TYPE_VARIANT</a>

enum <a class="link" href="pango-Fonts.html#PangoStretch-enum" title="enum PangoStretch">PangoStretch</a>;

#define <a class="link" href="pango-Fonts.html#PANGO-TYPE-STRETCH:CAPS" title="PANGO_TYPE_STRETCH">PANGO_TYPE_STRETCH</a>

enum <a class="link" href="pango-Fonts.html#PangoFontMask-enum" title="enum PangoFontMask">PangoFontMask</a>;

#define <a class="link" href="pango-Fonts.html#PANGO-TYPE-FONT-MASK:CAPS" title="PANGO_TYPE_FONT_MASK">PANGO_TYPE_FONT_MASK</a>

<a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> * <a class="link" href="pango-Fonts.html#pango-font-description-new" title="pango_font_description_new ()">pango_font_description_new</a> (<em class="parameter"><code><span class="type">void</span></code></em>);

<a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> * <a class="link" href="pango-Fonts.html#pango-font-description-copy" title="pango_font_description_copy ()">pango_font_description_copy</a> (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);

(<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> <a class="link" href="pango-Fonts.html#pango-font-description-hash" title="pango_font_description_hash ()">pango_font_description_hash</a> (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="pango-Fonts.html#pango-font-description-equal" title="pango_font_description_equal ()">pango_font_description_equal</a> (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc1</code></em>,

<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc2</code></em>);

<span class="returnvalue">void</span> <a class="link" href="pango-Fonts.html#pango-font-description-free" title="pango_font_description_free ()">pango_font_description_free</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);

<span class="returnvalue">void</span> <a class="link" href="pango-Fonts.html#pango-font-descriptions-free" title="pango_font_descriptions_free ()">pango_font_descriptions_free</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> **descs</code></em>,

<em class="parameter"><code><span class="type">int</span> n_descs</code></em>);

<span class="returnvalue">void</span> <a class="link" href="pango-Fonts.html#pango-font-description-set-family" title="pango_font_description_set_family ()">pango_font_description_set_family</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

<em class="parameter"><code>const <span class="type">char</span> *family</code></em>);

<span class="returnvalue">void</span> <a class="link" href="pango-Fonts.html#pango-font-description-set-family-static" title="pango_font_description_set_family_static ()">pango_font_description_set_family_static</a>

(<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

<em class="parameter"><code>const <span class="type">char</span> *family</code></em>);

const <span class="returnvalue">char</span> * <a class="link" href="pango-Fonts.html#pango-font-description-get-family" title="pango_font_description_get_family ()">pango_font_description_get_family</a> (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);

<span class="returnvalue">void</span> <a class="link" href="pango-Fonts.html#pango-font-description-set-style" title="pango_font_description_set_style ()">pango_font_description_set_style</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoStyle"><span class="type">PangoStyle</span></a> style</code></em>);

<a class="link" href="pango-Fonts.html#PangoStyle"><span class="returnvalue">PangoStyle</span></a> <a class="link" href="pango-Fonts.html#pango-font-description-get-style" title="pango_font_description_get_style ()">pango_font_description_get_style</a> (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);

<span class="returnvalue">void</span> <a class="link" href="pango-Fonts.html#pango-font-description-set-variant" title="pango_font_description_set_variant ()">pango_font_description_set_variant</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoVariant"><span class="type">PangoVariant</span></a> variant</code></em>);

<a class="link" href="pango-Fonts.html#PangoVariant"><span class="returnvalue">PangoVariant</span></a> <a class="link" href="pango-Fonts.html#pango-font-description-get-variant" title="pango_font_description_get_variant ()">pango_font_description_get_variant</a> (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);

<span class="returnvalue">void</span> <a class="link" href="pango-Fonts.html#pango-font-description-set-weight" title="pango_font_description_set_weight ()">pango_font_description_set_weight</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoWeight"><span class="type">PangoWeight</span></a> weight</code></em>);

<a class="link" href="pango-Fonts.html#PangoWeight"><span class="returnvalue">PangoWeight</span></a> <a class="link" href="pango-Fonts.html#pango-font-description-get-weight" title="pango_font_description_get_weight ()">pango_font_description_get_weight</a> (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);

<span class="returnvalue">void</span> <a class="link" href="pango-Fonts.html#pango-font-description-set-stretch" title="pango_font_description_set_stretch ()">pango_font_description_set_stretch</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoStretch"><span class="type">PangoStretch</span></a> stretch</code></em>);

<a class="link" href="pango-Fonts.html#PangoStretch"><span class="returnvalue">PangoStretch</span></a> <a class="link" href="pango-Fonts.html#pango-font-description-get-stretch" title="pango_font_description_get_stretch ()">pango_font_description_get_stretch</a> (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);

<span class="returnvalue">void</span> <a class="link" href="pango-Fonts.html#pango-font-description-set-size" title="pango_font_description_set_size ()">pango_font_description_set_size</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> size</code></em>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> <a class="link" href="pango-Fonts.html#pango-font-description-get-size" title="pango_font_description_get_size ()">pango_font_description_get_size</a> (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);

<span class="returnvalue">void</span> <a class="link" href="pango-Fonts.html#pango-font-description-set-absolute-size" title="pango_font_description_set_absolute_size ()">pango_font_description_set_absolute_size</a>

(<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

<em class="parameter"><code><span class="type">double</span> size</code></em>);

(<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);

<span class="returnvalue">void</span> <a class="link" href="pango-Fonts.html#pango-font-description-set-gravity" title="pango_font_description_set_gravity ()">pango_font_description_set_gravity</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

<em class="parameter"><code><a class="link" href="pango-Vertical-Text.html#PangoGravity"><span class="type">PangoGravity</span></a> gravity</code></em>);

<a class="link" href="pango-Vertical-Text.html#PangoGravity"><span class="returnvalue">PangoGravity</span></a> <a class="link" href="pango-Fonts.html#pango-font-description-get-gravity" title="pango_font_description_get_gravity ()">pango_font_description_get_gravity</a> (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);

<a class="link" href="pango-Fonts.html#PangoFontMask"><span class="returnvalue">PangoFontMask</span></a> <a class="link" href="pango-Fonts.html#pango-font-description-get-set-fields" title="pango_font_description_get_set_fields ()">pango_font_description_get_set_fields</a>

(<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);

<span class="returnvalue">void</span> <a class="link" href="pango-Fonts.html#pango-font-description-unset-fields" title="pango_font_description_unset_fields ()">pango_font_description_unset_fields</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMask"><span class="type">PangoFontMask</span></a> to_unset</code></em>);

<span class="returnvalue">void</span> <a class="link" href="pango-Fonts.html#pango-font-description-merge" title="pango_font_description_merge ()">pango_font_description_merge</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc_to_merge</code></em>,

<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> replace_existing</code></em>);

<span class="returnvalue">void</span> <a class="link" href="pango-Fonts.html#pango-font-description-merge-static" title="pango_font_description_merge_static ()">pango_font_description_merge_static</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

100

<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc_to_merge</code></em>,

101

<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> replace_existing</code></em>);

102

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="pango-Fonts.html#pango-font-description-better-match" title="pango_font_description_better_match ()">pango_font_description_better_match</a> (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

103

<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *old_match</code></em>,

104

<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *new_match</code></em>);

105

106

(<em class="parameter"><code>const <span class="type">char</span> *str</code></em>);

107

<span class="returnvalue">char</span> * <a class="link" href="pango-Fonts.html#pango-font-description-to-string" title="pango_font_description_to_string ()">pango_font_description_to_string</a> (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);

108

<span class="returnvalue">char</span> * <a class="link" href="pango-Fonts.html#pango-font-description-to-filename" title="pango_font_description_to_filename ()">pango_font_description_to_filename</a> (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);

109

110

struct <a class="link" href="pango-Fonts.html#PangoFontMetrics-struct" title="struct PangoFontMetrics">PangoFontMetrics</a>;

111

#define <a class="link" href="pango-Fonts.html#PANGO-TYPE-FONT-METRICS:CAPS" title="PANGO_TYPE_FONT_METRICS">PANGO_TYPE_FONT_METRICS</a>

112

<a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="returnvalue">PangoFontMetrics</span></a> * <a class="link" href="pango-Fonts.html#pango-font-metrics-ref" title="pango_font_metrics_ref ()">pango_font_metrics_ref</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> *metrics</code></em>);

113

<span class="returnvalue">void</span> <a class="link" href="pango-Fonts.html#pango-font-metrics-unref" title="pango_font_metrics_unref ()">pango_font_metrics_unref</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> *metrics</code></em>);

114

<span class="returnvalue">int</span> <a class="link" href="pango-Fonts.html#pango-font-metrics-get-ascent" title="pango_font_metrics_get_ascent ()">pango_font_metrics_get_ascent</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> *metrics</code></em>);

115

<span class="returnvalue">int</span> <a class="link" href="pango-Fonts.html#pango-font-metrics-get-descent" title="pango_font_metrics_get_descent ()">pango_font_metrics_get_descent</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> *metrics</code></em>);

116

<span class="returnvalue">int</span> <a class="link" href="pango-Fonts.html#pango-font-metrics-get-approximate-char-width" title="pango_font_metrics_get_approximate_char_width ()">pango_font_metrics_get_approximate_char_width</a>

117

(<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> *metrics</code></em>);

118

<span class="returnvalue">int</span> <a class="link" href="pango-Fonts.html#pango-font-metrics-get-approximate-digit-width" title="pango_font_metrics_get_approximate_digit_width ()">pango_font_metrics_get_approximate_digit_width</a>

119

(<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> *metrics</code></em>);

120

<span class="returnvalue">int</span> <a class="link" href="pango-Fonts.html#pango-font-metrics-get-underline-thickness" title="pango_font_metrics_get_underline_thickness ()">pango_font_metrics_get_underline_thickness</a>

121

(<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> *metrics</code></em>);

122

<span class="returnvalue">int</span> <a class="link" href="pango-Fonts.html#pango-font-metrics-get-underline-position" title="pango_font_metrics_get_underline_position ()">pango_font_metrics_get_underline_position</a>

123

(<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> *metrics</code></em>);

124

<span class="returnvalue">int</span> <a class="link" href="pango-Fonts.html#pango-font-metrics-get-strikethrough-thickness" title="pango_font_metrics_get_strikethrough_thickness ()">pango_font_metrics_get_strikethrough_thickness</a>

125

(<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> *metrics</code></em>);

126

<span class="returnvalue">int</span> <a class="link" href="pango-Fonts.html#pango-font-metrics-get-strikethrough-position" title="pango_font_metrics_get_strikethrough_position ()">pango_font_metrics_get_strikethrough_position</a>

127

(<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> *metrics</code></em>);

128

129

<a class="link" href="pango-Fonts.html#PangoFont-struct" title="PangoFont">PangoFont</a>;

130

#define <a class="link" href="pango-Fonts.html#PANGO-TYPE-FONT:CAPS" title="PANGO_TYPE_FONT">PANGO_TYPE_FONT</a>

131

#define <a class="link" href="pango-Fonts.html#PANGO-FONT:CAPS" title="PANGO_FONT()">PANGO_FONT</a> (object)

132

#define <a class="link" href="pango-Fonts.html#PANGO-IS-FONT:CAPS" title="PANGO_IS_FONT()">PANGO_IS_FONT</a> (object)

133

<a class="link" href="PangoEngineShape.html" title="PangoEngineShape"><span class="returnvalue">PangoEngineShape</span></a> * <a class="link" href="pango-Fonts.html#pango-font-find-shaper" title="pango_font_find_shaper ()">pango_font_find_shaper</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,

134

<em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> *language</code></em>,

135

<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> ch</code></em>);

136

<a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> * <a class="link" href="pango-Fonts.html#pango-font-describe" title="pango_font_describe ()">pango_font_describe</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>);

137

<a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> * <a class="link" href="pango-Fonts.html#pango-font-describe-with-absolute-size" title="pango_font_describe_with_absolute_size ()">pango_font_describe_with_absolute_size</a>

138

(<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>);

139

<a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage"><span class="returnvalue">PangoCoverage</span></a> * <a class="link" href="pango-Fonts.html#pango-font-get-coverage" title="pango_font_get_coverage ()">pango_font_get_coverage</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,

140

<em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> *language</code></em>);

141

<span class="returnvalue">void</span> <a class="link" href="pango-Fonts.html#pango-font-get-glyph-extents" title="pango_font_get_glyph_extents ()">pango_font_get_glyph_extents</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,

142

<em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoGlyph" title="PangoGlyph"><span class="type">PangoGlyph</span></a> glyph</code></em>,

143

<em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoRectangle" title="struct PangoRectangle"><span class="type">PangoRectangle</span></a> *ink_rect</code></em>,

144

<em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoRectangle" title="struct PangoRectangle"><span class="type">PangoRectangle</span></a> *logical_rect</code></em>);

145

<a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="returnvalue">PangoFontMetrics</span></a> * <a class="link" href="pango-Fonts.html#pango-font-get-metrics" title="pango_font_get_metrics ()">pango_font_get_metrics</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,

146

<em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> *language</code></em>);

147

<a class="link" href="pango-Fonts.html#PangoFontMap"><span class="returnvalue">PangoFontMap</span></a> * <a class="link" href="pango-Fonts.html#pango-font-get-font-map" title="pango_font_get_font_map ()">pango_font_get_font_map</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>);

148

149

struct <a class="link" href="pango-Fonts.html#PangoFontFamily-struct" title="struct PangoFontFamily">PangoFontFamily</a>;

150

#define <a class="link" href="pango-Fonts.html#PANGO-TYPE-FONT-FAMILY:CAPS" title="PANGO_TYPE_FONT_FAMILY">PANGO_TYPE_FONT_FAMILY</a>

151

#define <a class="link" href="pango-Fonts.html#PANGO-FONT-FAMILY:CAPS" title="PANGO_FONT_FAMILY()">PANGO_FONT_FAMILY</a> (object)

152

#define <a class="link" href="pango-Fonts.html#PANGO-IS-FONT-FAMILY:CAPS" title="PANGO_IS_FONT_FAMILY()">PANGO_IS_FONT_FAMILY</a> (object)

153

const <span class="returnvalue">char</span> * <a class="link" href="pango-Fonts.html#pango-font-family-get-name" title="pango_font_family_get_name ()">pango_font_family_get_name</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a> *family</code></em>);

154

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="pango-Fonts.html#pango-font-family-is-monospace" title="pango_font_family_is_monospace ()">pango_font_family_is_monospace</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a> *family</code></em>);

155

<span class="returnvalue">void</span> <a class="link" href="pango-Fonts.html#pango-font-family-list-faces" title="pango_font_family_list_faces ()">pango_font_family_list_faces</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a> *family</code></em>,

156

<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a> ***faces</code></em>,

157

<em class="parameter"><code><span class="type">int</span> *n_faces</code></em>);

158

159

struct <a class="link" href="pango-Fonts.html#PangoFontFace-struct" title="struct PangoFontFace">PangoFontFace</a>;

160

#define <a class="link" href="pango-Fonts.html#PANGO-TYPE-FONT-FACE:CAPS" title="PANGO_TYPE_FONT_FACE">PANGO_TYPE_FONT_FACE</a>

161

#define <a class="link" href="pango-Fonts.html#PANGO-FONT-FACE:CAPS" title="PANGO_FONT_FACE()">PANGO_FONT_FACE</a> (object)

162

#define <a class="link" href="pango-Fonts.html#PANGO-IS-FONT-FACE:CAPS" title="PANGO_IS_FONT_FACE()">PANGO_IS_FONT_FACE</a> (object)

163

const <span class="returnvalue">char</span> * <a class="link" href="pango-Fonts.html#pango-font-face-get-face-name" title="pango_font_face_get_face_name ()">pango_font_face_get_face_name</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a> *face</code></em>);

164

<span class="returnvalue">void</span> <a class="link" href="pango-Fonts.html#pango-font-face-list-sizes" title="pango_font_face_list_sizes ()">pango_font_face_list_sizes</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a> *face</code></em>,

165

<em class="parameter"><code><span class="type">int</span> **sizes</code></em>,

166

<em class="parameter"><code><span class="type">int</span> *n_sizes</code></em>);

167

<a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> * <a class="link" href="pango-Fonts.html#pango-font-face-describe" title="pango_font_face_describe ()">pango_font_face_describe</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a> *face</code></em>);

168

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="pango-Fonts.html#pango-font-face-is-synthesized" title="pango_font_face_is_synthesized ()">pango_font_face_is_synthesized</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a> *face</code></em>);

169

170

<a class="link" href="pango-Fonts.html#PangoFontMap-struct" title="PangoFontMap">PangoFontMap</a>;

171

#define <a class="link" href="pango-Fonts.html#PANGO-TYPE-FONT-MAP:CAPS" title="PANGO_TYPE_FONT_MAP">PANGO_TYPE_FONT_MAP</a>

172

#define <a class="link" href="pango-Fonts.html#PANGO-FONT-MAP:CAPS" title="PANGO_FONT_MAP()">PANGO_FONT_MAP</a> (object)

173

#define <a class="link" href="pango-Fonts.html#PANGO-IS-FONT-MAP:CAPS" title="PANGO_IS_FONT_MAP()">PANGO_IS_FONT_MAP</a> (object)

174

struct <a class="link" href="pango-Fonts.html#PangoFontMapClass" title="struct PangoFontMapClass">PangoFontMapClass</a>;

175

#define <a class="link" href="pango-Fonts.html#PANGO-FONT-MAP-CLASS:CAPS" title="PANGO_FONT_MAP_CLASS()">PANGO_FONT_MAP_CLASS</a> (klass)

176

#define <a class="link" href="pango-Fonts.html#PANGO-IS-FONT-MAP-CLASS:CAPS" title="PANGO_IS_FONT_MAP_CLASS()">PANGO_IS_FONT_MAP_CLASS</a> (klass)

177

#define <a class="link" href="pango-Fonts.html#PANGO-FONT-MAP-GET-CLASS:CAPS" title="PANGO_FONT_MAP_GET_CLASS()">PANGO_FONT_MAP_GET_CLASS</a> (obj)

178

<a class="link" href="pango-Text-Processing.html#PangoContext"><span class="returnvalue">PangoContext</span></a> * <a class="link" href="pango-Fonts.html#pango-font-map-create-context" title="pango_font_map_create_context ()">pango_font_map_create_context</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> *fontmap</code></em>);

179

<a class="link" href="pango-Fonts.html#PangoFont"><span class="returnvalue">PangoFont</span></a> * <a class="link" href="pango-Fonts.html#pango-font-map-load-font" title="pango_font_map_load_font ()">pango_font_map_load_font</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> *fontmap</code></em>,

180

<em class="parameter"><code><a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> *context</code></em>,

181

<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);

182

<a class="link" href="pango-Fonts.html#PangoFontset"><span class="returnvalue">PangoFontset</span></a> * <a class="link" href="pango-Fonts.html#pango-font-map-load-fontset" title="pango_font_map_load_fontset ()">pango_font_map_load_fontset</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> *fontmap</code></em>,

183

<em class="parameter"><code><a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> *context</code></em>,

184

<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

185

<em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> *language</code></em>);

186

<span class="returnvalue">void</span> <a class="link" href="pango-Fonts.html#pango-font-map-list-families" title="pango_font_map_list_families ()">pango_font_map_list_families</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> *fontmap</code></em>,

187

<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a> ***families</code></em>,

188

<em class="parameter"><code><span class="type">int</span> *n_families</code></em>);

189

const <span class="returnvalue">char</span> * <a class="link" href="pango-Fonts.html#pango-font-map-get-shape-engine-type" title="pango_font_map_get_shape_engine_type ()">pango_font_map_get_shape_engine_type</a>

190

(<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> *fontmap</code></em>);

191

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> <a class="link" href="pango-Fonts.html#pango-font-map-get-serial" title="pango_font_map_get_serial ()">pango_font_map_get_serial</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> *fontmap</code></em>);

192

<span class="returnvalue">void</span> <a class="link" href="pango-Fonts.html#pango-font-map-changed" title="pango_font_map_changed ()">pango_font_map_changed</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> *fontmap</code></em>);

193

194

struct <a class="link" href="pango-Fonts.html#PangoFontset-struct" title="struct PangoFontset">PangoFontset</a>;

195

#define <a class="link" href="pango-Fonts.html#PANGO-TYPE-FONTSET:CAPS" title="PANGO_TYPE_FONTSET">PANGO_TYPE_FONTSET</a>

196

struct <a class="link" href="pango-Fonts.html#PangoFontsetClass" title="struct PangoFontsetClass">PangoFontsetClass</a>;

197

<a class="link" href="pango-Fonts.html#PangoFont"><span class="returnvalue">PangoFont</span></a> * <a class="link" href="pango-Fonts.html#pango-fontset-get-font" title="pango_fontset_get_font ()">pango_fontset_get_font</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a> *fontset</code></em>,

198

<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> wc</code></em>);

199

<a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="returnvalue">PangoFontMetrics</span></a> * <a class="link" href="pango-Fonts.html#pango-fontset-get-metrics" title="pango_fontset_get_metrics ()">pango_fontset_get_metrics</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a> *fontset</code></em>);

200

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> (<a class="link" href="pango-Fonts.html#PangoFontsetForeachFunc" title="PangoFontsetForeachFunc ()">*PangoFontsetForeachFunc</a>) (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a> *fontset</code></em>,

201

<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,

202

<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);

203

<span class="returnvalue">void</span> <a class="link" href="pango-Fonts.html#pango-fontset-foreach" title="pango_fontset_foreach ()">pango_fontset_foreach</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a> *fontset</code></em>,

204

<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontsetForeachFunc" title="PangoFontsetForeachFunc ()"><span class="type">PangoFontsetForeachFunc</span></a> func</code></em>,

205

<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);

206

<a class="link" href="pango-Fonts.html#PangoFontsetSimple-struct" title="PangoFontsetSimple">PangoFontsetSimple</a>;

207

#define <a class="link" href="pango-Fonts.html#PANGO-TYPE-FONTSET-SIMPLE:CAPS" title="PANGO_TYPE_FONTSET_SIMPLE">PANGO_TYPE_FONTSET_SIMPLE</a>

208

<a class="link" href="pango-Fonts.html#PangoFontsetSimple"><span class="returnvalue">PangoFontsetSimple</span></a> * <a class="link" href="pango-Fonts.html#pango-fontset-simple-new" title="pango_fontset_simple_new ()">pango_fontset_simple_new</a> (<em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> *language</code></em>);

209

<span class="returnvalue">void</span> <a class="link" href="pango-Fonts.html#pango-fontset-simple-append" title="pango_fontset_simple_append ()">pango_fontset_simple_append</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontsetSimple"><span class="type">PangoFontsetSimple</span></a> *fontset</code></em>,

210

<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>);

211

<span class="returnvalue">int</span> <a class="link" href="pango-Fonts.html#pango-fontset-simple-size" title="pango_fontset_simple_size ()">pango_fontset_simple_size</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontsetSimple"><span class="type">PangoFontsetSimple</span></a> *fontset</code></em>);

212

</pre>

<a name="pango-Fonts.functions"></a><h2>Functions</h2>

</colgroup>

<tbody>

<tr>

<td class="define_keyword">#define</td>

<td class="function_name"><a class="link" href="pango-Fonts.html#PANGO-TYPE-FONT-DESCRIPTION:CAPS" title="PANGO_TYPE_FONT_DESCRIPTION">PANGO_TYPE_FONT_DESCRIPTION</a></td>

</tr>

<tr>

<td class="define_keyword">#define</td>

<td class="function_name"><a class="link" href="pango-Fonts.html#PANGO-TYPE-STYLE:CAPS" title="PANGO_TYPE_STYLE">PANGO_TYPE_STYLE</a></td>

</tr>

<tr>

<td class="define_keyword">#define</td>

<td class="function_name"><a class="link" href="pango-Fonts.html#PANGO-TYPE-WEIGHT:CAPS" title="PANGO_TYPE_WEIGHT">PANGO_TYPE_WEIGHT</a></td>

</tr>

<tr>

<td class="define_keyword">#define</td>

<td class="function_name"><a class="link" href="pango-Fonts.html#PANGO-TYPE-VARIANT:CAPS" title="PANGO_TYPE_VARIANT">PANGO_TYPE_VARIANT</a></td>

</tr>

<tr>

<td class="define_keyword">#define</td>

<td class="function_name"><a class="link" href="pango-Fonts.html#PANGO-TYPE-STRETCH:CAPS" title="PANGO_TYPE_STRETCH">PANGO_TYPE_STRETCH</a></td>

</tr>

<tr>

<td class="define_keyword">#define</td>

<td class="function_name"><a class="link" href="pango-Fonts.html#PANGO-TYPE-FONT-MASK:CAPS" title="PANGO_TYPE_FONT_MASK">PANGO_TYPE_FONT_MASK</a></td>

</tr>

<tr>

<a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> *

</td>

<a class="link" href="pango-Fonts.html#pango-font-description-new" title="pango_font_description_new ()">pango_font_description_new</a> <span class="c_punctuation">()</span>

</td>

</tr>

<tr>

<a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> *

</td>

<a class="link" href="pango-Fonts.html#pango-font-description-copy" title="pango_font_description_copy ()">pango_font_description_copy</a> <span class="c_punctuation">()</span>

</td>

</tr>

<tr>

<a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> *

</td>

<a class="link" href="pango-Fonts.html#pango-font-description-copy-static" title="pango_font_description_copy_static ()">pango_font_description_copy_static</a> <span class="c_punctuation">()</span>

</td>

</tr>

<tr>

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>

</td>

<a class="link" href="pango-Fonts.html#pango-font-description-hash" title="pango_font_description_hash ()">pango_font_description_hash</a> <span class="c_punctuation">()</span>

</td>

</tr>

100

<tr>

101

102

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>

103

</td>

104

105

<a class="link" href="pango-Fonts.html#pango-font-description-equal" title="pango_font_description_equal ()">pango_font_description_equal</a> <span class="c_punctuation">()</span>

106

</td>

107

</tr>

108

<tr>

109

110

111

</td>

112

113

<a class="link" href="pango-Fonts.html#pango-font-description-free" title="pango_font_description_free ()">pango_font_description_free</a> <span class="c_punctuation">()</span>

114

</td>

115

</tr>

116

<tr>

117

118

119

</td>

120

121

<a class="link" href="pango-Fonts.html#pango-font-descriptions-free" title="pango_font_descriptions_free ()">pango_font_descriptions_free</a> <span class="c_punctuation">()</span>

122

</td>

123

</tr>

124

<tr>

125

126

127

</td>

128

129

<a class="link" href="pango-Fonts.html#pango-font-description-set-family" title="pango_font_description_set_family ()">pango_font_description_set_family</a> <span class="c_punctuation">()</span>

130

</td>

131

</tr>

132

<tr>

133

134

135

</td>

136

137

<a class="link" href="pango-Fonts.html#pango-font-description-set-family-static" title="pango_font_description_set_family_static ()">pango_font_description_set_family_static</a> <span class="c_punctuation">()</span>

138

</td>

139

</tr>

140

<tr>

141

<td class="function_type">const <span class="returnvalue">char</span> *

142

</td>

143

144

<a class="link" href="pango-Fonts.html#pango-font-description-get-family" title="pango_font_description_get_family ()">pango_font_description_get_family</a> <span class="c_punctuation">()</span>

145

</td>

146

</tr>

147

<tr>

148

149

150

</td>

151

152

<a class="link" href="pango-Fonts.html#pango-font-description-set-style" title="pango_font_description_set_style ()">pango_font_description_set_style</a> <span class="c_punctuation">()</span>

153

</td>

154

</tr>

155

<tr>

156

157

<a class="link" href="pango-Fonts.html#PangoStyle" title="enum PangoStyle"><span class="returnvalue">PangoStyle</span></a>

158

</td>

159

160

<a class="link" href="pango-Fonts.html#pango-font-description-get-style" title="pango_font_description_get_style ()">pango_font_description_get_style</a> <span class="c_punctuation">()</span>

161

</td>

162

</tr>

163

<tr>

164

165

166

</td>

167

168

<a class="link" href="pango-Fonts.html#pango-font-description-set-variant" title="pango_font_description_set_variant ()">pango_font_description_set_variant</a> <span class="c_punctuation">()</span>

169

</td>

170

</tr>

171

<tr>

172

173

<a class="link" href="pango-Fonts.html#PangoVariant" title="enum PangoVariant"><span class="returnvalue">PangoVariant</span></a>

174

</td>

175

176

<a class="link" href="pango-Fonts.html#pango-font-description-get-variant" title="pango_font_description_get_variant ()">pango_font_description_get_variant</a> <span class="c_punctuation">()</span>

177

</td>

178

</tr>

179

<tr>

180

181

182

</td>

183

184

<a class="link" href="pango-Fonts.html#pango-font-description-set-weight" title="pango_font_description_set_weight ()">pango_font_description_set_weight</a> <span class="c_punctuation">()</span>

185

</td>

186

</tr>

187

<tr>

188

189

<a class="link" href="pango-Fonts.html#PangoWeight" title="enum PangoWeight"><span class="returnvalue">PangoWeight</span></a>

190

</td>

191

192

<a class="link" href="pango-Fonts.html#pango-font-description-get-weight" title="pango_font_description_get_weight ()">pango_font_description_get_weight</a> <span class="c_punctuation">()</span>

193

</td>

194

</tr>

195

<tr>

196

197

198

</td>

199

200

<a class="link" href="pango-Fonts.html#pango-font-description-set-stretch" title="pango_font_description_set_stretch ()">pango_font_description_set_stretch</a> <span class="c_punctuation">()</span>

201

</td>

202

</tr>

203

<tr>

204

205

<a class="link" href="pango-Fonts.html#PangoStretch" title="enum PangoStretch"><span class="returnvalue">PangoStretch</span></a>

206

</td>

207

208

<a class="link" href="pango-Fonts.html#pango-font-description-get-stretch" title="pango_font_description_get_stretch ()">pango_font_description_get_stretch</a> <span class="c_punctuation">()</span>

209

</td>

210

</tr>

211

<tr>

212

213

214

</td>

215

216

<a class="link" href="pango-Fonts.html#pango-font-description-set-size" title="pango_font_description_set_size ()">pango_font_description_set_size</a> <span class="c_punctuation">()</span>

217

</td>

218

</tr>

219

<tr>

220

221

222

</td>

223

224

<a class="link" href="pango-Fonts.html#pango-font-description-get-size" title="pango_font_description_get_size ()">pango_font_description_get_size</a> <span class="c_punctuation">()</span>

225

</td>

226

</tr>

227

<tr>

228

229

230

</td>

231

232

<a class="link" href="pango-Fonts.html#pango-font-description-set-absolute-size" title="pango_font_description_set_absolute_size ()">pango_font_description_set_absolute_size</a> <span class="c_punctuation">()</span>

233

</td>

234

</tr>

235

<tr>

236

237

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>

238

</td>

239

240

<a class="link" href="pango-Fonts.html#pango-font-description-get-size-is-absolute" title="pango_font_description_get_size_is_absolute ()">pango_font_description_get_size_is_absolute</a> <span class="c_punctuation">()</span>

241

</td>

242

</tr>

243

<tr>

244

245

246

</td>

247

248

<a class="link" href="pango-Fonts.html#pango-font-description-set-gravity" title="pango_font_description_set_gravity ()">pango_font_description_set_gravity</a> <span class="c_punctuation">()</span>

249

</td>

250

</tr>

251

<tr>

252

253

<a class="link" href="pango-Vertical-Text.html#PangoGravity" title="enum PangoGravity"><span class="returnvalue">PangoGravity</span></a>

254

</td>

255

256

<a class="link" href="pango-Fonts.html#pango-font-description-get-gravity" title="pango_font_description_get_gravity ()">pango_font_description_get_gravity</a> <span class="c_punctuation">()</span>

257

</td>

258

</tr>

259

<tr>

260

261

<a class="link" href="pango-Fonts.html#PangoFontMask" title="enum PangoFontMask"><span class="returnvalue">PangoFontMask</span></a>

262

</td>

263

264

<a class="link" href="pango-Fonts.html#pango-font-description-get-set-fields" title="pango_font_description_get_set_fields ()">pango_font_description_get_set_fields</a> <span class="c_punctuation">()</span>

265

</td>

266

</tr>

267

<tr>

268

269

270

</td>

271

272

<a class="link" href="pango-Fonts.html#pango-font-description-unset-fields" title="pango_font_description_unset_fields ()">pango_font_description_unset_fields</a> <span class="c_punctuation">()</span>

273

</td>

274

</tr>

275

<tr>

276

277

278

</td>

279

280

<a class="link" href="pango-Fonts.html#pango-font-description-merge" title="pango_font_description_merge ()">pango_font_description_merge</a> <span class="c_punctuation">()</span>

281

</td>

282

</tr>

283

<tr>

284

285

286

</td>

287

288

<a class="link" href="pango-Fonts.html#pango-font-description-merge-static" title="pango_font_description_merge_static ()">pango_font_description_merge_static</a> <span class="c_punctuation">()</span>

289

</td>

290

</tr>

291

<tr>

292

293

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>

294

</td>

295

296

<a class="link" href="pango-Fonts.html#pango-font-description-better-match" title="pango_font_description_better_match ()">pango_font_description_better_match</a> <span class="c_punctuation">()</span>

297

</td>

298

</tr>

299

<tr>

300

301

<a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> *

302

</td>

303

304

<a class="link" href="pango-Fonts.html#pango-font-description-from-string" title="pango_font_description_from_string ()">pango_font_description_from_string</a> <span class="c_punctuation">()</span>

305

</td>

306

</tr>

307

<tr>

308

309

<span class="returnvalue">char</span> *

310

</td>

311

312

<a class="link" href="pango-Fonts.html#pango-font-description-to-string" title="pango_font_description_to_string ()">pango_font_description_to_string</a> <span class="c_punctuation">()</span>

313

</td>

314

</tr>

315

<tr>

316

317

<span class="returnvalue">char</span> *

318

</td>

319

320

<a class="link" href="pango-Fonts.html#pango-font-description-to-filename" title="pango_font_description_to_filename ()">pango_font_description_to_filename</a> <span class="c_punctuation">()</span>

321

</td>

322

</tr>

323

<tr>

324

<td class="define_keyword">#define</td>

325

<td class="function_name"><a class="link" href="pango-Fonts.html#PANGO-TYPE-FONT-METRICS:CAPS" title="PANGO_TYPE_FONT_METRICS">PANGO_TYPE_FONT_METRICS</a></td>

326

</tr>

327

<tr>

328

329

<a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="returnvalue">PangoFontMetrics</span></a> *

330

</td>

331

332

<a class="link" href="pango-Fonts.html#pango-font-metrics-ref" title="pango_font_metrics_ref ()">pango_font_metrics_ref</a> <span class="c_punctuation">()</span>

333

</td>

334

</tr>

335

<tr>

336

337

338

</td>

339

340

<a class="link" href="pango-Fonts.html#pango-font-metrics-unref" title="pango_font_metrics_unref ()">pango_font_metrics_unref</a> <span class="c_punctuation">()</span>

341

</td>

342

</tr>

343

<tr>

344

345

346

</td>

347

348

<a class="link" href="pango-Fonts.html#pango-font-metrics-get-ascent" title="pango_font_metrics_get_ascent ()">pango_font_metrics_get_ascent</a> <span class="c_punctuation">()</span>

349

</td>

350

</tr>

351

<tr>

352

353

354

</td>

355

356

<a class="link" href="pango-Fonts.html#pango-font-metrics-get-descent" title="pango_font_metrics_get_descent ()">pango_font_metrics_get_descent</a> <span class="c_punctuation">()</span>

357

</td>

358

</tr>

359

<tr>

360

361

362

</td>

363

364

<a class="link" href="pango-Fonts.html#pango-font-metrics-get-approximate-char-width" title="pango_font_metrics_get_approximate_char_width ()">pango_font_metrics_get_approximate_char_width</a> <span class="c_punctuation">()</span>

365

</td>

366

</tr>

367

<tr>

368

369

370

</td>

371

372

<a class="link" href="pango-Fonts.html#pango-font-metrics-get-approximate-digit-width" title="pango_font_metrics_get_approximate_digit_width ()">pango_font_metrics_get_approximate_digit_width</a> <span class="c_punctuation">()</span>

373

</td>

374

</tr>

375

<tr>

376

377

378

</td>

379

380

<a class="link" href="pango-Fonts.html#pango-font-metrics-get-underline-thickness" title="pango_font_metrics_get_underline_thickness ()">pango_font_metrics_get_underline_thickness</a> <span class="c_punctuation">()</span>

381

</td>

382

</tr>

383

<tr>

384

385

386

</td>

387

388

<a class="link" href="pango-Fonts.html#pango-font-metrics-get-underline-position" title="pango_font_metrics_get_underline_position ()">pango_font_metrics_get_underline_position</a> <span class="c_punctuation">()</span>

389

</td>

390

</tr>

391

<tr>

392

393

394

</td>

395

396

<a class="link" href="pango-Fonts.html#pango-font-metrics-get-strikethrough-thickness" title="pango_font_metrics_get_strikethrough_thickness ()">pango_font_metrics_get_strikethrough_thickness</a> <span class="c_punctuation">()</span>

397

</td>

398

</tr>

399

<tr>

400

401

402

</td>

403

404

<a class="link" href="pango-Fonts.html#pango-font-metrics-get-strikethrough-position" title="pango_font_metrics_get_strikethrough_position ()">pango_font_metrics_get_strikethrough_position</a> <span class="c_punctuation">()</span>

405

</td>

406

</tr>

407

<tr>

408

<td class="define_keyword">#define</td>

409

<td class="function_name"><a class="link" href="pango-Fonts.html#PANGO-TYPE-FONT:CAPS" title="PANGO_TYPE_FONT">PANGO_TYPE_FONT</a></td>

410

</tr>

411

<tr>

412

<td class="define_keyword">#define</td>

413

414

<a class="link" href="pango-Fonts.html#PANGO-FONT:CAPS" title="PANGO_FONT()">PANGO_FONT</a><span class="c_punctuation">()</span>

415

</td>

416

</tr>

417

<tr>

418

<td class="define_keyword">#define</td>

419

420

<a class="link" href="pango-Fonts.html#PANGO-IS-FONT:CAPS" title="PANGO_IS_FONT()">PANGO_IS_FONT</a><span class="c_punctuation">()</span>

421

</td>

422

</tr>

423

<tr>

424

425

<a class="link" href="PangoEngineShape.html" title="PangoEngineShape"><span class="returnvalue">PangoEngineShape</span></a> *

426

</td>

427

428

<a class="link" href="pango-Fonts.html#pango-font-find-shaper" title="pango_font_find_shaper ()">pango_font_find_shaper</a> <span class="c_punctuation">()</span>

429

</td>

430

</tr>

431

<tr>

432

433

<a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> *

434

</td>

435

436

<a class="link" href="pango-Fonts.html#pango-font-describe" title="pango_font_describe ()">pango_font_describe</a> <span class="c_punctuation">()</span>

437

</td>

438

</tr>

439

<tr>

440

441

<a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> *

442

</td>

443

444

<a class="link" href="pango-Fonts.html#pango-font-describe-with-absolute-size" title="pango_font_describe_with_absolute_size ()">pango_font_describe_with_absolute_size</a> <span class="c_punctuation">()</span>

445

</td>

446

</tr>

447

<tr>

448

449

<a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage"><span class="returnvalue">PangoCoverage</span></a> *

450

</td>

451

452

<a class="link" href="pango-Fonts.html#pango-font-get-coverage" title="pango_font_get_coverage ()">pango_font_get_coverage</a> <span class="c_punctuation">()</span>

453

</td>

454

</tr>

455

<tr>

456

457

458

</td>

459

460

<a class="link" href="pango-Fonts.html#pango-font-get-glyph-extents" title="pango_font_get_glyph_extents ()">pango_font_get_glyph_extents</a> <span class="c_punctuation">()</span>

461

</td>

462

</tr>

463

<tr>

464

465

<a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="returnvalue">PangoFontMetrics</span></a> *

466

</td>

467

468

<a class="link" href="pango-Fonts.html#pango-font-get-metrics" title="pango_font_get_metrics ()">pango_font_get_metrics</a> <span class="c_punctuation">()</span>

469

</td>

470

</tr>

471

<tr>

472

473

<a class="link" href="pango-Fonts.html#PangoFontMap"><span class="returnvalue">PangoFontMap</span></a> *

474

</td>

475

476

<a class="link" href="pango-Fonts.html#pango-font-get-font-map" title="pango_font_get_font_map ()">pango_font_get_font_map</a> <span class="c_punctuation">()</span>

477

</td>

478

</tr>

479

<tr>

480

<td class="define_keyword">#define</td>

481

<td class="function_name"><a class="link" href="pango-Fonts.html#PANGO-TYPE-FONT-FAMILY:CAPS" title="PANGO_TYPE_FONT_FAMILY">PANGO_TYPE_FONT_FAMILY</a></td>

482

</tr>

483

<tr>

484

<td class="define_keyword">#define</td>

485

486

<a class="link" href="pango-Fonts.html#PANGO-FONT-FAMILY:CAPS" title="PANGO_FONT_FAMILY()">PANGO_FONT_FAMILY</a><span class="c_punctuation">()</span>

487

</td>

488

</tr>

489

<tr>

490

<td class="define_keyword">#define</td>

491

492

<a class="link" href="pango-Fonts.html#PANGO-IS-FONT-FAMILY:CAPS" title="PANGO_IS_FONT_FAMILY()">PANGO_IS_FONT_FAMILY</a><span class="c_punctuation">()</span>

493

</td>

494

</tr>

495

<tr>

496

<td class="function_type">const <span class="returnvalue">char</span> *

497

</td>

498

499

<a class="link" href="pango-Fonts.html#pango-font-family-get-name" title="pango_font_family_get_name ()">pango_font_family_get_name</a> <span class="c_punctuation">()</span>

500

</td>

501

</tr>

502

<tr>

503

504

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>

505

</td>

506

507

<a class="link" href="pango-Fonts.html#pango-font-family-is-monospace" title="pango_font_family_is_monospace ()">pango_font_family_is_monospace</a> <span class="c_punctuation">()</span>

508

</td>

509

</tr>

510

<tr>

511

512

513

</td>

514

515

<a class="link" href="pango-Fonts.html#pango-font-family-list-faces" title="pango_font_family_list_faces ()">pango_font_family_list_faces</a> <span class="c_punctuation">()</span>

516

</td>

517

</tr>

518

<tr>

519

<td class="define_keyword">#define</td>

520

<td class="function_name"><a class="link" href="pango-Fonts.html#PANGO-TYPE-FONT-FACE:CAPS" title="PANGO_TYPE_FONT_FACE">PANGO_TYPE_FONT_FACE</a></td>

521

</tr>

522

<tr>

523

<td class="define_keyword">#define</td>

524

525

<a class="link" href="pango-Fonts.html#PANGO-FONT-FACE:CAPS" title="PANGO_FONT_FACE()">PANGO_FONT_FACE</a><span class="c_punctuation">()</span>

526

</td>

527

</tr>

528

<tr>

529

<td class="define_keyword">#define</td>

530

531

<a class="link" href="pango-Fonts.html#PANGO-IS-FONT-FACE:CAPS" title="PANGO_IS_FONT_FACE()">PANGO_IS_FONT_FACE</a><span class="c_punctuation">()</span>

532

</td>

533

</tr>

534

<tr>

535

<td class="function_type">const <span class="returnvalue">char</span> *

536

</td>

537

538

<a class="link" href="pango-Fonts.html#pango-font-face-get-face-name" title="pango_font_face_get_face_name ()">pango_font_face_get_face_name</a> <span class="c_punctuation">()</span>

539

</td>

540

</tr>

541

<tr>

542

543

544

</td>

545

546

<a class="link" href="pango-Fonts.html#pango-font-face-list-sizes" title="pango_font_face_list_sizes ()">pango_font_face_list_sizes</a> <span class="c_punctuation">()</span>

547

</td>

548

</tr>

549

<tr>

550

551

<a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> *

552

</td>

553

554

<a class="link" href="pango-Fonts.html#pango-font-face-describe" title="pango_font_face_describe ()">pango_font_face_describe</a> <span class="c_punctuation">()</span>

555

</td>

556

</tr>

557

<tr>

558

559

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>

560

</td>

561

562

<a class="link" href="pango-Fonts.html#pango-font-face-is-synthesized" title="pango_font_face_is_synthesized ()">pango_font_face_is_synthesized</a> <span class="c_punctuation">()</span>

563

</td>

564

</tr>

565

<tr>

566

<td class="define_keyword">#define</td>

567

<td class="function_name"><a class="link" href="pango-Fonts.html#PANGO-TYPE-FONT-MAP:CAPS" title="PANGO_TYPE_FONT_MAP">PANGO_TYPE_FONT_MAP</a></td>

568

</tr>

569

<tr>

570

<td class="define_keyword">#define</td>

571

572

<a class="link" href="pango-Fonts.html#PANGO-FONT-MAP:CAPS" title="PANGO_FONT_MAP()">PANGO_FONT_MAP</a><span class="c_punctuation">()</span>

573

</td>

574

</tr>

575

<tr>

576

<td class="define_keyword">#define</td>

577

578

<a class="link" href="pango-Fonts.html#PANGO-IS-FONT-MAP:CAPS" title="PANGO_IS_FONT_MAP()">PANGO_IS_FONT_MAP</a><span class="c_punctuation">()</span>

579

</td>

580

</tr>

581

<tr>

582

<td class="define_keyword">#define</td>

583

584

<a class="link" href="pango-Fonts.html#PANGO-FONT-MAP-CLASS:CAPS" title="PANGO_FONT_MAP_CLASS()">PANGO_FONT_MAP_CLASS</a><span class="c_punctuation">()</span>

585

</td>

586

</tr>

587

<tr>

588

<td class="define_keyword">#define</td>

589

590

<a class="link" href="pango-Fonts.html#PANGO-IS-FONT-MAP-CLASS:CAPS" title="PANGO_IS_FONT_MAP_CLASS()">PANGO_IS_FONT_MAP_CLASS</a><span class="c_punctuation">()</span>

591

</td>

592

</tr>

593

<tr>

594

<td class="define_keyword">#define</td>

595

596

<a class="link" href="pango-Fonts.html#PANGO-FONT-MAP-GET-CLASS:CAPS" title="PANGO_FONT_MAP_GET_CLASS()">PANGO_FONT_MAP_GET_CLASS</a><span class="c_punctuation">()</span>

597

</td>

598

</tr>

599

<tr>

600

601

<a class="link" href="pango-Text-Processing.html#PangoContext"><span class="returnvalue">PangoContext</span></a> *

602

</td>

603

604

<a class="link" href="pango-Fonts.html#pango-font-map-create-context" title="pango_font_map_create_context ()">pango_font_map_create_context</a> <span class="c_punctuation">()</span>

605

</td>

606

</tr>

607

<tr>

608

609

<a class="link" href="pango-Fonts.html#PangoFont"><span class="returnvalue">PangoFont</span></a> *

610

</td>

611

612

<a class="link" href="pango-Fonts.html#pango-font-map-load-font" title="pango_font_map_load_font ()">pango_font_map_load_font</a> <span class="c_punctuation">()</span>

613

</td>

614

</tr>

615

<tr>

616

617

<a class="link" href="pango-Fonts.html#PangoFontset"><span class="returnvalue">PangoFontset</span></a> *

618

</td>

619

620

<a class="link" href="pango-Fonts.html#pango-font-map-load-fontset" title="pango_font_map_load_fontset ()">pango_font_map_load_fontset</a> <span class="c_punctuation">()</span>

621

</td>

622

</tr>

623

<tr>

624

625

626

</td>

627

628

<a class="link" href="pango-Fonts.html#pango-font-map-list-families" title="pango_font_map_list_families ()">pango_font_map_list_families</a> <span class="c_punctuation">()</span>

629

</td>

630

</tr>

631

<tr>

632

<td class="function_type">const <span class="returnvalue">char</span> *

633

</td>

634

635

<a class="link" href="pango-Fonts.html#pango-font-map-get-shape-engine-type" title="pango_font_map_get_shape_engine_type ()">pango_font_map_get_shape_engine_type</a> <span class="c_punctuation">()</span>

636

</td>

637

</tr>

638

<tr>

639

640

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>

641

</td>

642

643

<a class="link" href="pango-Fonts.html#pango-font-map-get-serial" title="pango_font_map_get_serial ()">pango_font_map_get_serial</a> <span class="c_punctuation">()</span>

644

</td>

645

</tr>

646

<tr>

647

648

649

</td>

650

651

<a class="link" href="pango-Fonts.html#pango-font-map-changed" title="pango_font_map_changed ()">pango_font_map_changed</a> <span class="c_punctuation">()</span>

652

</td>

653

</tr>

654

<tr>

655

<td class="define_keyword">#define</td>

656

<td class="function_name"><a class="link" href="pango-Fonts.html#PANGO-TYPE-FONTSET:CAPS" title="PANGO_TYPE_FONTSET">PANGO_TYPE_FONTSET</a></td>

657

</tr>

658

<tr>

659

660

<a class="link" href="pango-Fonts.html#PangoFont"><span class="returnvalue">PangoFont</span></a> *

661

</td>

662

663

<a class="link" href="pango-Fonts.html#pango-fontset-get-font" title="pango_fontset_get_font ()">pango_fontset_get_font</a> <span class="c_punctuation">()</span>

664

</td>

665

</tr>

666

<tr>

667

668

<a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="returnvalue">PangoFontMetrics</span></a> *

669

</td>

670

671

<a class="link" href="pango-Fonts.html#pango-fontset-get-metrics" title="pango_fontset_get_metrics ()">pango_fontset_get_metrics</a> <span class="c_punctuation">()</span>

672

</td>

673

</tr>

674

<tr>

675

676

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>

677

</td>

678

679

<span class="c_punctuation">(</span><a class="link" href="pango-Fonts.html#PangoFontsetForeachFunc" title="PangoFontsetForeachFunc ()">*PangoFontsetForeachFunc</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>

680

</td>

681

</tr>

682

<tr>

683

684

685

</td>

686

687

<a class="link" href="pango-Fonts.html#pango-fontset-foreach" title="pango_fontset_foreach ()">pango_fontset_foreach</a> <span class="c_punctuation">()</span>

688

</td>

689

</tr>

690

<tr>

691

<td class="define_keyword">#define</td>

692

<td class="function_name"><a class="link" href="pango-Fonts.html#PANGO-TYPE-FONTSET-SIMPLE:CAPS" title="PANGO_TYPE_FONTSET_SIMPLE">PANGO_TYPE_FONTSET_SIMPLE</a></td>

693

</tr>

694

<tr>

695

696

<a class="link" href="pango-Fonts.html#PangoFontsetSimple"><span class="returnvalue">PangoFontsetSimple</span></a> *

697

</td>

698

699

<a class="link" href="pango-Fonts.html#pango-fontset-simple-new" title="pango_fontset_simple_new ()">pango_fontset_simple_new</a> <span class="c_punctuation">()</span>

700

</td>

701

</tr>

702

<tr>

703

704

705

</td>

706

707

<a class="link" href="pango-Fonts.html#pango-fontset-simple-append" title="pango_fontset_simple_append ()">pango_fontset_simple_append</a> <span class="c_punctuation">()</span>

708

</td>

709

</tr>

710

<tr>

711

712

713

</td>

714

715

<a class="link" href="pango-Fonts.html#pango-fontset-simple-size" title="pango_fontset_simple_size ()">pango_fontset_simple_size</a> <span class="c_punctuation">()</span>

716

</td>

717

</tr>

718

</tbody>

719

</table></div>

720

</div>

721

722

<a name="pango-Fonts.other"></a><h2>Types and Values</h2>

723

724

725

726

727

</colgroup>

728

<tbody>

729

<tr>

730

731

<td class="function_name"><a class="link" href="pango-Fonts.html#PangoFontDescription-struct" title="PangoFontDescription">PangoFontDescription</a></td>

732

</tr>

733

<tr>

734

735

<td class="function_name"><a class="link" href="pango-Fonts.html#PangoStyle" title="enum PangoStyle">PangoStyle</a></td>

736

</tr>

737

<tr>

738

739

<td class="function_name"><a class="link" href="pango-Fonts.html#PangoWeight" title="enum PangoWeight">PangoWeight</a></td>

740

</tr>

741

<tr>

742

743

<td class="function_name"><a class="link" href="pango-Fonts.html#PangoVariant" title="enum PangoVariant">PangoVariant</a></td>

744

</tr>

745

<tr>

746

747

<td class="function_name"><a class="link" href="pango-Fonts.html#PangoStretch" title="enum PangoStretch">PangoStretch</a></td>

748

</tr>

749

<tr>

750

751

<td class="function_name"><a class="link" href="pango-Fonts.html#PangoFontMask" title="enum PangoFontMask">PangoFontMask</a></td>

752

</tr>

753

<tr>

754

<td class="datatype_keyword">struct</td>

755

<td class="function_name"><a class="link" href="pango-Fonts.html#PangoFontMetrics-struct" title="struct PangoFontMetrics">PangoFontMetrics</a></td>

756

</tr>

757

<tr>

758

759

<td class="function_name"><a class="link" href="pango-Fonts.html#PangoFont-struct" title="PangoFont">PangoFont</a></td>

760

</tr>

761

<tr>

762

<td class="datatype_keyword">struct</td>

763

<td class="function_name"><a class="link" href="pango-Fonts.html#PangoFontFamily-struct" title="struct PangoFontFamily">PangoFontFamily</a></td>

764

</tr>

765

<tr>

766

<td class="datatype_keyword">struct</td>

767

<td class="function_name"><a class="link" href="pango-Fonts.html#PangoFontFace-struct" title="struct PangoFontFace">PangoFontFace</a></td>

768

</tr>

769

<tr>

770

771

<td class="function_name"><a class="link" href="pango-Fonts.html#PangoFontMap-struct" title="PangoFontMap">PangoFontMap</a></td>

772

</tr>

773

<tr>

774

<td class="datatype_keyword">struct</td>

775

<td class="function_name"><a class="link" href="pango-Fonts.html#PangoFontMapClass" title="struct PangoFontMapClass">PangoFontMapClass</a></td>

776

</tr>

777

<tr>

778

<td class="datatype_keyword">struct</td>

779

<td class="function_name"><a class="link" href="pango-Fonts.html#PangoFontset-struct" title="struct PangoFontset">PangoFontset</a></td>

780

</tr>

781

<tr>

782

<td class="datatype_keyword">struct</td>

783

<td class="function_name"><a class="link" href="pango-Fonts.html#PangoFontsetClass" title="struct PangoFontsetClass">PangoFontsetClass</a></td>

784

</tr>

785

<tr>

786

787

<td class="function_name"><a class="link" href="pango-Fonts.html#PangoFontsetSimple-struct" title="PangoFontsetSimple">PangoFontsetSimple</a></td>

788

</tr>

789

</tbody>

790

</table></div>

213

791

</div>

214

792

215

793

<a name="pango-Fonts.object-hierarchy"></a><h2>Object Hierarchy</h2>

216

217

GBoxed

218

+----PangoFontDescription

219

</pre>

220

221

GEnum

222

+----PangoStyle

223

</pre>

224

225

GEnum

226

+----PangoWeight

227

</pre>

228

229

GEnum

230

+----PangoVariant

231

</pre>

232

233

GEnum

234

+----PangoStretch

235

</pre>

236

237

GFlags

238

+----PangoFontMask

239

</pre>

240

241

GBoxed

242

+----PangoFontMetrics

243

</pre>

244

245

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>

246

+----PangoFont

247

+----<a class="link" href="PangoFcFont.html" title="PangoFcFont">PangoFcFont</a>

248

</pre>

249

250

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>

251

+----PangoFontFamily

252

</pre>

253

254

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>

255

+----PangoFontFace

256

</pre>

257

258

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>

259

+----PangoFontMap

260

+----<a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap">PangoFcFontMap</a>

261

</pre>

262

263

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>

264

+----PangoFontset

265

+----<a class="link" href="pango-Fonts.html#PangoFontsetSimple">PangoFontsetSimple</a>

266

</pre>

267

268

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>

269

+----<a class="link" href="pango-Fonts.html#PangoFontset">PangoFontset</a>

270

+----PangoFontsetSimple

794

<pre class="screen"> GBoxed

795

<span class="lineart">├──</span> PangoFontDescription

796

<span class="lineart">╰──</span> PangoFontMetrics

797

GEnum

798

<span class="lineart">├──</span> PangoStretch

799

<span class="lineart">├──</span> PangoStyle

800

<span class="lineart">├──</span> PangoVariant

801

<span class="lineart">╰──</span> PangoWeight

802

GFlags

803

<span class="lineart">╰──</span> PangoFontMask

804

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>

805

<span class="lineart">├──</span> <a class="link" href="pango-Fonts.html#PangoFontset">PangoFontset</a>

806

<span class="lineart">│</span> <span class="lineart">╰──</span> PangoFontsetSimple

807

<span class="lineart">├──</span> PangoFont

808

<span class="lineart">│</span> <span class="lineart">╰──</span> <a class="link" href="PangoFcFont.html" title="PangoFcFont">PangoFcFont</a>

809

<span class="lineart">├──</span> PangoFontFace

810

<span class="lineart">├──</span> PangoFontFamily

811

<span class="lineart">├──</span> PangoFontMap

812

<span class="lineart">│</span> <span class="lineart">╰──</span> <a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap">PangoFcFontMap</a>

813

<span class="lineart">╰──</span> PangoFontset

814

<span class="lineart">╰──</span> <a class="link" href="pango-Fonts.html#PangoFontsetSimple">PangoFontsetSimple</a>

271

815

</pre>

272

816

</div>

273

817

281

825

</div>

282

826

283

827

<a name="pango-Fonts.description"></a><h2>Description</h2>

284

<p>

285

Pango supports a flexible architecture where a

828

<p>Pango supports a flexible architecture where a

286

829

particular rendering architecture can supply an

287

830

implementation of fonts. The <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> structure

288

831

represents an abstract rendering-system-independent font.

290

833

to load a font of a given description.</p>

291

834

</div>

292

835

293

<a name="pango-Fonts.details"></a><h2>Details</h2>

294

295

<a name="PangoFontDescription-struct"></a><h3>PangoFontDescription</h3>

296

<pre class="programlisting">typedef struct _PangoFontDescription PangoFontDescription;</pre>

297

<p>

298

The <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> structure represents the description

299

of an ideal font. These structures are used both to list

300

what fonts are available on the system and also for specifying

301

the characteristics of a font to load.</p>

302

</div>

303

<hr>

836

<a name="pango-Fonts.functions_details"></a><h2>Functions</h2>

304

837

305

838

<a name="PANGO-TYPE-FONT-DESCRIPTION:CAPS"></a><h3>PANGO_TYPE_FONT_DESCRIPTION</h3>

306

839

<pre class="programlisting">#define PANGO_TYPE_FONT_DESCRIPTION (pango_font_description_get_type ())

307

840

</pre>

308

<p>

309

The <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> type for <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>.</p>

310

</div>

311

<hr>

312

313

<a name="PangoStyle-enum"></a><h3>enum PangoStyle</h3>

314

<pre class="programlisting">typedef enum {

315

PANGO_STYLE_NORMAL,

316

PANGO_STYLE_OBLIQUE,

317

PANGO_STYLE_ITALIC

318

} PangoStyle;

319

</pre>

320

<p>

321

An enumeration specifying the various slant styles possible for a font.</p>

322

323

324

325

<col>

326

</colgroup>

327

<tbody>

328

<tr>

329

<td><p><a name="PANGO-STYLE-NORMAL:CAPS"></a><span class="term"><code class="literal">PANGO_STYLE_NORMAL</code></span></p></td>

330

<td>the font is upright.

331

</td>

332

</tr>

333

<tr>

334

<td><p><a name="PANGO-STYLE-OBLIQUE:CAPS"></a><span class="term"><code class="literal">PANGO_STYLE_OBLIQUE</code></span></p></td>

335

<td>the font is slanted, but in a roman style.

336

</td>

337

</tr>

338

<tr>

339

<td><p><a name="PANGO-STYLE-ITALIC:CAPS"></a><span class="term"><code class="literal">PANGO_STYLE_ITALIC</code></span></p></td>

340

<td>the font is slanted in an italic style.

341

</td>

342

</tr>

343

</tbody>

344

</table></div>

841

<p>The <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> type for <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>.</p>

345

842

</div>

346

843

<hr>

347

844

351

848

</div>

352

849

<hr>

353

850

354

<a name="PangoWeight-enum"></a><h3>enum PangoWeight</h3>

355

<pre class="programlisting">typedef enum {

356

PANGO_WEIGHT_THIN = 100,

357

PANGO_WEIGHT_ULTRALIGHT = 200,

358

PANGO_WEIGHT_LIGHT = 300,

359

PANGO_WEIGHT_BOOK = 380,

360

PANGO_WEIGHT_NORMAL = 400,

361

PANGO_WEIGHT_MEDIUM = 500,

362

PANGO_WEIGHT_SEMIBOLD = 600,

363

PANGO_WEIGHT_BOLD = 700,

364

PANGO_WEIGHT_ULTRABOLD = 800,

365

PANGO_WEIGHT_HEAVY = 900,

366

PANGO_WEIGHT_ULTRAHEAVY = 1000

367

} PangoWeight;

368

</pre>

369

<p>

370

An enumeration specifying the weight (boldness) of a font. This is a numerical

371

value ranging from 100 to 900, but there are some predefined values:</p>

372

373

374

375

<col>

376

</colgroup>

377

<tbody>

378

<tr>

379

<td><p><a name="PANGO-WEIGHT-THIN:CAPS"></a><span class="term"><code class="literal">PANGO_WEIGHT_THIN</code></span></p></td>

380

<td>the thin weight (= 100; Since: 1.24)

381

</td>

382

</tr>

383

<tr>

384

<td><p><a name="PANGO-WEIGHT-ULTRALIGHT:CAPS"></a><span class="term"><code class="literal">PANGO_WEIGHT_ULTRALIGHT</code></span></p></td>

385

<td>the ultralight weight (= 200)

386

</td>

387

</tr>

388

<tr>

389

<td><p><a name="PANGO-WEIGHT-LIGHT:CAPS"></a><span class="term"><code class="literal">PANGO_WEIGHT_LIGHT</code></span></p></td>

390

<td>the light weight (= 300)

391

</td>

392

</tr>

393

<tr>

394

<td><p><a name="PANGO-WEIGHT-BOOK:CAPS"></a><span class="term"><code class="literal">PANGO_WEIGHT_BOOK</code></span></p></td>

395

<td>the book weight (= 380; Since: 1.24)

396

</td>

397

</tr>

398

<tr>

399

<td><p><a name="PANGO-WEIGHT-NORMAL:CAPS"></a><span class="term"><code class="literal">PANGO_WEIGHT_NORMAL</code></span></p></td>

400

<td>the default weight (= 400)

401

</td>

402

</tr>

403

<tr>

404

<td><p><a name="PANGO-WEIGHT-MEDIUM:CAPS"></a><span class="term"><code class="literal">PANGO_WEIGHT_MEDIUM</code></span></p></td>

405

<td>the normal weight (= 500; Since: 1.24)

406

</td>

407

</tr>

408

<tr>

409

<td><p><a name="PANGO-WEIGHT-SEMIBOLD:CAPS"></a><span class="term"><code class="literal">PANGO_WEIGHT_SEMIBOLD</code></span></p></td>

410

<td>the semibold weight (= 600)

411

</td>

412

</tr>

413

<tr>

414

<td><p><a name="PANGO-WEIGHT-BOLD:CAPS"></a><span class="term"><code class="literal">PANGO_WEIGHT_BOLD</code></span></p></td>

415

<td>the bold weight (= 700)

416

</td>

417

</tr>

418

<tr>

419

<td><p><a name="PANGO-WEIGHT-ULTRABOLD:CAPS"></a><span class="term"><code class="literal">PANGO_WEIGHT_ULTRABOLD</code></span></p></td>

420

<td>the ultrabold weight (= 800)

421

</td>

422

</tr>

423

<tr>

424

<td><p><a name="PANGO-WEIGHT-HEAVY:CAPS"></a><span class="term"><code class="literal">PANGO_WEIGHT_HEAVY</code></span></p></td>

425

<td>the heavy weight (= 900)

426

</td>

427

</tr>

428

<tr>

429

<td><p><a name="PANGO-WEIGHT-ULTRAHEAVY:CAPS"></a><span class="term"><code class="literal">PANGO_WEIGHT_ULTRAHEAVY</code></span></p></td>

430

<td>the ultraheavy weight (= 1000; Since: 1.24)

431

</td>

432

</tr>

433

</tbody>

434

</table></div>

435

</div>

436

<hr>

437

438

851

<a name="PANGO-TYPE-WEIGHT:CAPS"></a><h3>PANGO_TYPE_WEIGHT</h3>

439

852

<pre class="programlisting">#define PANGO_TYPE_WEIGHT (pango_weight_get_type ())

440

853

</pre>

441

854

</div>

442

855

<hr>

443

856

444

<a name="PangoVariant-enum"></a><h3>enum PangoVariant</h3>

445

<pre class="programlisting">typedef enum {

446

PANGO_VARIANT_NORMAL,

447

PANGO_VARIANT_SMALL_CAPS

448

} PangoVariant;

449

</pre>

450

<p>

451

An enumeration specifying capitalization variant of the font.</p>

452

453

454

455

<col>

456

</colgroup>

457

<tbody>

458

<tr>

459

<td><p><a name="PANGO-VARIANT-NORMAL:CAPS"></a><span class="term"><code class="literal">PANGO_VARIANT_NORMAL</code></span></p></td>

460

<td>A normal font.

461

</td>

462

</tr>

463

<tr>

464

<td><p><a name="PANGO-VARIANT-SMALL-CAPS"></a><span class="term"><code class="literal">PANGO_VARIANT_SMALL_CAPS</code></span></p></td>

465

<td>A font with the lower case characters

466

replaced by smaller variants of the capital characters.

467

</td>

468

</tr>

469

</tbody>

470

</table></div>

471

</div>

472

<hr>

473

474

857

<a name="PANGO-TYPE-VARIANT:CAPS"></a><h3>PANGO_TYPE_VARIANT</h3>

475

858

<pre class="programlisting">#define PANGO_TYPE_VARIANT (pango_variant_get_type ())

476

859

</pre>

477

860

</div>

478

861

<hr>

479

862

480

<a name="PangoStretch-enum"></a><h3>enum PangoStretch</h3>

481

<pre class="programlisting">typedef enum {

482

PANGO_STRETCH_ULTRA_CONDENSED,

483

PANGO_STRETCH_EXTRA_CONDENSED,

484

PANGO_STRETCH_CONDENSED,

485

PANGO_STRETCH_SEMI_CONDENSED,

486

PANGO_STRETCH_NORMAL,

487

PANGO_STRETCH_SEMI_EXPANDED,

488

PANGO_STRETCH_EXPANDED,

489

PANGO_STRETCH_EXTRA_EXPANDED,

490

PANGO_STRETCH_ULTRA_EXPANDED

491

} PangoStretch;

492

</pre>

493

<p>

494

An enumeration specifying the width of the font relative to other designs

495

within a family.</p>

496

497

498

499

<col>

500

</colgroup>

501

<tbody>

502

<tr>

503

<td><p><a name="PANGO-STRETCH-ULTRA-CONDENSED:CAPS"></a><span class="term"><code class="literal">PANGO_STRETCH_ULTRA_CONDENSED</code></span></p></td>

504

<td>ultra condensed width

505

</td>

506

</tr>

507

<tr>

508

<td><p><a name="PANGO-STRETCH-EXTRA-CONDENSED:CAPS"></a><span class="term"><code class="literal">PANGO_STRETCH_EXTRA_CONDENSED</code></span></p></td>

509

<td>extra condensed width

510

</td>

511

</tr>

512

<tr>

513

<td><p><a name="PANGO-STRETCH-CONDENSED:CAPS"></a><span class="term"><code class="literal">PANGO_STRETCH_CONDENSED</code></span></p></td>

514

<td>condensed width

515

</td>

516

</tr>

517

<tr>

518

<td><p><a name="PANGO-STRETCH-SEMI-CONDENSED:CAPS"></a><span class="term"><code class="literal">PANGO_STRETCH_SEMI_CONDENSED</code></span></p></td>

519

<td>semi condensed width

520

</td>

521

</tr>

522

<tr>

523

<td><p><a name="PANGO-STRETCH-NORMAL:CAPS"></a><span class="term"><code class="literal">PANGO_STRETCH_NORMAL</code></span></p></td>

524

<td>the normal width

525

</td>

526

</tr>

527

<tr>

528

<td><p><a name="PANGO-STRETCH-SEMI-EXPANDED:CAPS"></a><span class="term"><code class="literal">PANGO_STRETCH_SEMI_EXPANDED</code></span></p></td>

529

<td>semi expanded width

530

</td>

531

</tr>

532

<tr>

533

<td><p><a name="PANGO-STRETCH-EXPANDED:CAPS"></a><span class="term"><code class="literal">PANGO_STRETCH_EXPANDED</code></span></p></td>

534

<td>expanded width

535

</td>

536

</tr>

537

<tr>

538

<td><p><a name="PANGO-STRETCH-EXTRA-EXPANDED:CAPS"></a><span class="term"><code class="literal">PANGO_STRETCH_EXTRA_EXPANDED</code></span></p></td>

539

<td>extra expanded width

540

</td>

541

</tr>

542

<tr>

543

<td><p><a name="PANGO-STRETCH-ULTRA-EXPANDED:CAPS"></a><span class="term"><code class="literal">PANGO_STRETCH_ULTRA_EXPANDED</code></span></p></td>

544

<td>ultra expanded width

545

</td>

546

</tr>

547

</tbody>

548

</table></div>

549

</div>

550

<hr>

551

552

863

<a name="PANGO-TYPE-STRETCH:CAPS"></a><h3>PANGO_TYPE_STRETCH</h3>

553

864

<pre class="programlisting">#define PANGO_TYPE_STRETCH (pango_stretch_get_type ())

554

865

</pre>

555

866

</div>

556

867

<hr>

557

868

558

<a name="PangoFontMask-enum"></a><h3>enum PangoFontMask</h3>

559

<pre class="programlisting">typedef enum {

560

PANGO_FONT_MASK_FAMILY = 1 << 0,

561

PANGO_FONT_MASK_STYLE = 1 << 1,

562

PANGO_FONT_MASK_VARIANT = 1 << 2,

563

PANGO_FONT_MASK_WEIGHT = 1 << 3,

564

PANGO_FONT_MASK_STRETCH = 1 << 4,

565

PANGO_FONT_MASK_SIZE = 1 << 5,

566

PANGO_FONT_MASK_GRAVITY = 1 << 6

567

} PangoFontMask;

568

</pre>

569

<p>

570

The bits in a <a class="link" href="pango-Fonts.html#PangoFontMask"><span class="type">PangoFontMask</span></a> correspond to fields in a

571

<a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> that have been set.</p>

572

573

574

575

<col>

576

</colgroup>

577

<tbody>

578

<tr>

579

<td><p><a name="PANGO-FONT-MASK-FAMILY:CAPS"></a><span class="term"><code class="literal">PANGO_FONT_MASK_FAMILY</code></span></p></td>

580

<td>the font family is specified.

581

</td>

582

</tr>

583

<tr>

584

<td><p><a name="PANGO-FONT-MASK-STYLE:CAPS"></a><span class="term"><code class="literal">PANGO_FONT_MASK_STYLE</code></span></p></td>

585

<td>the font style is specified.

586

</td>

587

</tr>

588

<tr>

589

<td><p><a name="PANGO-FONT-MASK-VARIANT:CAPS"></a><span class="term"><code class="literal">PANGO_FONT_MASK_VARIANT</code></span></p></td>

590

<td>the font variant is specified.

591

</td>

592

</tr>

593

<tr>

594

<td><p><a name="PANGO-FONT-MASK-WEIGHT:CAPS"></a><span class="term"><code class="literal">PANGO_FONT_MASK_WEIGHT</code></span></p></td>

595

<td>the font weight is specified.

596

</td>

597

</tr>

598

<tr>

599

<td><p><a name="PANGO-FONT-MASK-STRETCH:CAPS"></a><span class="term"><code class="literal">PANGO_FONT_MASK_STRETCH</code></span></p></td>

600

<td>the font stretch is specified.

601

</td>

602

</tr>

603

<tr>

604

<td><p><a name="PANGO-FONT-MASK-SIZE:CAPS"></a><span class="term"><code class="literal">PANGO_FONT_MASK_SIZE</code></span></p></td>

605

<td>the font size is specified.

606

</td>

607

</tr>

608

<tr>

609

<td><p><a name="PANGO-FONT-MASK-GRAVITY:CAPS"></a><span class="term"><code class="literal">PANGO_FONT_MASK_GRAVITY</code></span></p></td>

610

<td>the font gravity is specified (Since: 1.16.)

611

</td>

612

</tr>

613

</tbody>

614

</table></div>

615

</div>

616

<hr>

617

618

869

<a name="PANGO-TYPE-FONT-MASK:CAPS"></a><h3>PANGO_TYPE_FONT_MASK</h3>

619

870

<pre class="programlisting">#define PANGO_TYPE_FONT_MASK (pango_font_mask_get_type ())

620

871

</pre>

621

872

</div>

622

873

<hr>

623

874

624

<a name="pango-font-description-new"></a><h3>pango_font_description_new ()</h3>

625

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> * pango_font_description_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>

626

<p>

627

Creates a new font description structure with all fields unset.</p>

628

875

<a name="pango-font-description-new"></a><h3>pango_font_description_new ()</h3>

876

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> *

877

pango_font_description_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>

878

<p>Creates a new font description structure with all fields unset.</p>

879

880

<a name="id-1.2.4.16.8.5"></a><h4>Returns</h4>

881

<p> the newly allocated <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>, which

882

should be freed using <a class="link" href="pango-Fonts.html#pango-font-description-free" title="pango_font_description_free ()"><code class="function">pango_font_description_free()</code></a>.</p>

883

<p></p>

884

</div>

885

</div>

886

<hr>

887

888

<a name="pango-font-description-copy"></a><h3>pango_font_description_copy ()</h3>

889

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> *

890

pango_font_description_copy (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);</pre>

891

<p>Make a copy of a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>.</p>

892

893

<a name="id-1.2.4.16.9.5"></a><h4>Parameters</h4>

894

629

895

630

631

<col>

896

897

898

632

899

</colgroup>

633

900

634

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

635

<td>the newly allocated <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>, which

636

should be freed using <a class="link" href="pango-Fonts.html#pango-font-description-free" title="pango_font_description_free ()"><code class="function">pango_font_description_free()</code></a>.</td>

901

902

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>, may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>

903

637

904

</tr></tbody>

638

905

</table></div>

639

906

</div>

640

<hr>

641

642

<a name="pango-font-description-copy"></a><h3>pango_font_description_copy ()</h3>

643

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> * pango_font_description_copy (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);</pre>

644

<p>

645

Make a copy of a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>.</p>

646

647

648

649

<col>

650

</colgroup>

651

<tbody>

652

<tr>

653

654

<td>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>, may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

655

</td>

656

</tr>

657

<tr>

658

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

659

<td>the newly allocated <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>, which should

660

be freed with <a class="link" href="pango-Fonts.html#pango-font-description-free" title="pango_font_description_free ()"><code class="function">pango_font_description_free()</code></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

661

if <em class="parameter"><code>desc</code></em> was <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>

662

</tr>

663

</tbody>

664

</table></div>

665

</div>

666

<hr>

667

668

<a name="pango-font-description-copy-static"></a><h3>pango_font_description_copy_static ()</h3>

669

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> * pango_font_description_copy_static

670

(<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);</pre>

671

<p>

672

Like <a class="link" href="pango-Fonts.html#pango-font-description-copy" title="pango_font_description_copy ()"><code class="function">pango_font_description_copy()</code></a>, but only a shallow copy is made

907

908

<a name="id-1.2.4.16.9.6"></a><h4>Returns</h4>

909

<p> the newly allocated <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>, which should

910

911

if <em class="parameter"><code>desc</code></em>

912

was <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>

913

<p></p>

914

</div>

915

</div>

916

<hr>

917

918

<a name="pango-font-description-copy-static"></a><h3>pango_font_description_copy_static ()</h3>

919

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> *

920

pango_font_description_copy_static (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);</pre>

921

<p>Like <a class="link" href="pango-Fonts.html#pango-font-description-copy" title="pango_font_description_copy ()"><code class="function">pango_font_description_copy()</code></a>, but only a shallow copy is made

673

922

of the family name and other allocated fields. The result can only

674

be used until <em class="parameter"><code>desc</code></em> is modified or freed. This is meant to be used

923

be used until <em class="parameter"><code>desc</code></em>

924

is modified or freed. This is meant to be used

675

925

when the copy is only needed temporarily.</p>

676

926

927

<a name="id-1.2.4.16.10.5"></a><h4>Parameters</h4>

928

677

929

678

679

<col>

930

931

932

680

933

</colgroup>

681

<tbody>

682

<tr>

683

684

685

</td>

686

</tr>

687

<tr>

688

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

689

<td>the newly allocated <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>, which should

690

691

if <em class="parameter"><code>desc</code></em> was <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>

692

</tr>

693

</tbody>

934

935

936

937

938

</tr></tbody>

694

939

</table></div>

695

940

</div>

941

942

<a name="id-1.2.4.16.10.6"></a><h4>Returns</h4>

943

<p> the newly allocated <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>, which should

944

945

if <em class="parameter"><code>desc</code></em>

946

was <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>

947

<p></p>

948

</div>

949

</div>

696

950

<hr>

697

951

698

<a name="pango-font-description-hash"></a><h3>pango_font_description_hash ()</h3>

699

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> pango_font_description_hash (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);</pre>

700

<p>

701

Computes a hash of a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> structure suitable

952

<a name="pango-font-description-hash"></a><h3>pango_font_description_hash ()</h3>

953

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>

954

pango_font_description_hash (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);</pre>

955

<p>Computes a hash of a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> structure suitable

702

956

to be used, for example, as an argument to <a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#g-hash-table-new"><code class="function">g_hash_table_new()</code></a>.

703

The hash value is independent of <em class="parameter"><code>desc->mask</code></em>.</p>

704

957

The hash value is independent of <em class="parameter"><code>desc->mask</code></em>

958

.</p>

959

960

<a name="id-1.2.4.16.11.5"></a><h4>Parameters</h4>

961

705

962

706

707

<col>

963

964

965

708

966

</colgroup>

709

<tbody>

710

<tr>

711

712

<td>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

713

</td>

714

</tr>

715

<tr>

716

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

717

<td>the hash value.</td>

718

</tr>

719

</tbody>

967

968

969

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td>

970

971

</tr></tbody>

720

972

</table></div>

721

973

</div>

974

975

<a name="id-1.2.4.16.11.6"></a><h4>Returns</h4>

976

<p> the hash value.</p>

977

<p></p>

978

</div>

979

</div>

722

980

<hr>

723

981

724

<a name="pango-font-description-equal"></a><h3>pango_font_description_equal ()</h3>

725

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> pango_font_description_equal (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc1</code></em>,

726

<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc2</code></em>);</pre>

727

<p>

728

Compares two font descriptions for equality. Two font descriptions

982

<a name="pango-font-description-equal"></a><h3>pango_font_description_equal ()</h3>

983

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>

984

pango_font_description_equal (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc1</code></em>,

985

<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc2</code></em>);</pre>

986

<p>Compares two font descriptions for equality. Two font descriptions

729

987

are considered equal if the fonts they describe are provably identical.

730

988

This means that their masks do not have to match, as long as other fields

731

989

are all the same. (Two font descriptions may result in identical fonts

732

990

being loaded, but still compare <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.)</p>

733

991

992

<a name="id-1.2.4.16.12.5"></a><h4>Parameters</h4>

993

734

994

735

736

<col>

995

996

997

737

998

</colgroup>

738

999

<tbody>

739

1000

<tr>

740

741

<td>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

742

</td>

743

</tr>

744

<tr>

745

746

<td>another <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

747

</td>

748

</tr>

749

<tr>

750

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

751

<td>

752

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the two font descriptions are identical,

753

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>

1001

1002

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td>

1003

1004

</tr>

1005

<tr>

1006

1007

<td class="parameter_description"><p>another <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td>

1008

754

1009

</tr>

755

1010

</tbody>

756

1011

</table></div>

757

1012

</div>

1013

1014

<a name="id-1.2.4.16.12.6"></a><h4>Returns</h4>

1015

<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the two font descriptions are identical,

1016

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>

1017

<p></p>

1018

</div>

1019

</div>

758

1020

<hr>

759

1021

760

<a name="pango-font-description-free"></a><h3>pango_font_description_free ()</h3>

761

<pre class="programlisting"><span class="returnvalue">void</span> pango_font_description_free (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);</pre>

762

<p>

763

Frees a font description.</p>

764

1022

<a name="pango-font-description-free"></a><h3>pango_font_description_free ()</h3>

1023

1024

pango_font_description_free (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);</pre>

1025

<p>Frees a font description.</p>

1026

1027

<a name="id-1.2.4.16.13.5"></a><h4>Parameters</h4>

1028

765

1029

766

767

<col>

1030

1031

1032

768

1033

</colgroup>

769

1034

770

771

772

</td>

1035

1036

1037

773

1038

</tr></tbody>

774

1039

</table></div>

775

1040

</div>

1041

</div>

776

1042

<hr>

777

1043

778

<a name="pango-font-descriptions-free"></a><h3>pango_font_descriptions_free ()</h3>

779

<pre class="programlisting"><span class="returnvalue">void</span> pango_font_descriptions_free (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> **descs</code></em>,

780

<em class="parameter"><code><span class="type">int</span> n_descs</code></em>);</pre>

781

<p>

782

Frees an array of font descriptions.</p>

783

1044

<a name="pango-font-descriptions-free"></a><h3>pango_font_descriptions_free ()</h3>

1045

1046

pango_font_descriptions_free (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> **descs</code></em>,

1047

<em class="parameter"><code><span class="type">int</span> n_descs</code></em>);</pre>

1048

<p>Frees an array of font descriptions.</p>

1049

1050

<a name="id-1.2.4.16.14.5"></a><h4>Parameters</h4>

1051

784

1052

785

786

<col>

1053

1054

1055

787

1056

</colgroup>

788

1057

<tbody>

789

1058

<tr>

790

<td><p><span class="term"><em class="parameter"><code>descs</code></em> :</span></p></td>

791

<td>a pointer

792

to an array of <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>, may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_descs][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>

793

</td>

1059

<td class="parameter_name"><p>descs</p></td>

1060

<td class="parameter_description"><p> a pointer

1061

1062

<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_descs][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>

794

1063

</tr>

795

1064

<tr>

796

<td><p><span class="term"><em class="parameter"><code>n_descs</code></em> :</span></p></td>

797

<td>number of font descriptions in <em class="parameter"><code>descs</code></em>

798

</td>

1065

<td class="parameter_name"><p>n_descs</p></td>

1066

<td class="parameter_description"><p>number of font descriptions in <em class="parameter"><code>descs</code></em>

1067

</p></td>

1068

799

1069

</tr>

800

1070

</tbody>

801

1071

</table></div>

802

1072

</div>

1073

</div>

803

1074

<hr>

804

1075

805

<a name="pango-font-description-set-family"></a><h3>pango_font_description_set_family ()</h3>

806

<pre class="programlisting"><span class="returnvalue">void</span> pango_font_description_set_family (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

807

<em class="parameter"><code>const <span class="type">char</span> *family</code></em>);</pre>

808

<p>

809

Sets the family name field of a font description. The family

1076

<a name="pango-font-description-set-family"></a><h3>pango_font_description_set_family ()</h3>

1077

1078

pango_font_description_set_family (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

1079

<em class="parameter"><code>const <span class="type">char</span> *family</code></em>);</pre>

1080

<p>Sets the family name field of a font description. The family

810

1081

name represents a family of related font styles, and will

811

1082

resolve to a particular <a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a>. In some uses of

812

1083

<a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>, it is also possible to use a comma

813

1084

separated list of family names for this field.</p>

814

1085

1086

<a name="id-1.2.4.16.15.5"></a><h4>Parameters</h4>

1087

815

1088

816

817

<col>

1089

1090

1091

818

1092

</colgroup>

819

1093

<tbody>

820

1094

<tr>

821

822

<td>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>.</td>

1095

1096

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>.</p></td>

1097

823

1098

</tr>

824

1099

<tr>

825

<td><p><span class="term"><em class="parameter"><code>family</code></em> :</span></p></td>

826

<td>a string representing the family name.</td>

1100

<td class="parameter_name"><p>family</p></td>

1101

<td class="parameter_description"><p>a string representing the family name.</p></td>

1102

827

1103

</tr>

828

1104

</tbody>

829

1105

</table></div>

830

1106

</div>

1107

</div>

831

1108

<hr>

832

1109

833

<a name="pango-font-description-set-family-static"></a><h3>pango_font_description_set_family_static ()</h3>

834

<pre class="programlisting"><span class="returnvalue">void</span> pango_font_description_set_family_static

835

(<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

836

<em class="parameter"><code>const <span class="type">char</span> *family</code></em>);</pre>

837

<p>

838

Like <a class="link" href="pango-Fonts.html#pango-font-description-set-family" title="pango_font_description_set_family ()"><code class="function">pango_font_description_set_family()</code></a>, except that no

839

copy of <em class="parameter"><code>family</code></em> is made. The caller must make sure that the

840

string passed in stays around until <em class="parameter"><code>desc</code></em> has been freed

1110

<a name="pango-font-description-set-family-static"></a><h3>pango_font_description_set_family_static ()</h3>

1111

1112

pango_font_description_set_family_static

1113

(<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

1114

<em class="parameter"><code>const <span class="type">char</span> *family</code></em>);</pre>

1115

<p>Like <a class="link" href="pango-Fonts.html#pango-font-description-set-family" title="pango_font_description_set_family ()"><code class="function">pango_font_description_set_family()</code></a>, except that no

1116

copy of <em class="parameter"><code>family</code></em>

1117

is made. The caller must make sure that the

1118

string passed in stays around until <em class="parameter"><code>desc</code></em>

1119

has been freed

841

1120

or the name is set again. This function can be used if

842

<em class="parameter"><code>family</code></em> is a static string such as a C string literal, or

843

if <em class="parameter"><code>desc</code></em> is only needed temporarily.</p>

844

1121

<em class="parameter"><code>family</code></em>

1122

is a static string such as a C string literal, or

1123

if <em class="parameter"><code>desc</code></em>

1124

is only needed temporarily.</p>

1125

1126

<a name="id-1.2.4.16.16.5"></a><h4>Parameters</h4>

1127

845

1128

846

847

<col>

1129

1130

1131

848

1132

</colgroup>

849

1133

<tbody>

850

1134

<tr>

851

852

<td>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

853

</td>

1135

1136

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td>

1137

854

1138

</tr>

855

1139

<tr>

856

<td><p><span class="term"><em class="parameter"><code>family</code></em> :</span></p></td>

857

<td>a string representing the family name.</td>

1140

<td class="parameter_name"><p>family</p></td>

1141

<td class="parameter_description"><p>a string representing the family name.</p></td>

1142

858

1143

</tr>

859

1144

</tbody>

860

1145

</table></div>

861

1146

</div>

1147

</div>

862

1148

<hr>

863

1149

864

<a name="pango-font-description-get-family"></a><h3>pango_font_description_get_family ()</h3>

865

<pre class="programlisting">const <span class="returnvalue">char</span> * pango_font_description_get_family (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);</pre>

866

<p>

867

Gets the family name field of a font description. See

868

<a class="link" href="pango-Fonts.html#pango-font-description-set-family" title="pango_font_description_set_family ()"><code class="function">pango_font_description_set_family()</code></a>.</p>

869

1150

<a name="pango-font-description-get-family"></a><h3>pango_font_description_get_family ()</h3>

1151

<pre class="programlisting">const <span class="returnvalue">char</span> *

1152

pango_font_description_get_family (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);</pre>

1153

<p>Gets the family name field of a font description. See

1154

<a class="link" href="pango-Fonts.html#pango-font-description-set-family" title="pango_font_description_set_family ()"><code class="function">pango_font_description_set_family()</code></a>.</p>

1155

1156

<a name="id-1.2.4.16.17.5"></a><h4>Parameters</h4>

1157

870

1158

871

872

<col>

1159

1160

1161

873

1162

</colgroup>

874

<tbody>

875

<tr>

876

877

<td>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>.</td>

878

</tr>

879

<tr>

880

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

881

<td>the family name field for the font description, or

1163

1164

1165

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>.</p></td>

1166

1167

</tr></tbody>

1168

</table></div>

1169

</div>

1170

1171

<a name="id-1.2.4.16.17.6"></a><h4>Returns</h4>

1172

<p> the family name field for the font description, or

882

1173

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not previously set. This has the same life-time

883

as the font description itself and should not be freed.</td>

884

</tr>

885

</tbody>

886

</table></div>

1174

as the font description itself and should not be freed.</p>

1175

<p></p>

1176

</div>

887

1177

</div>

888

1178

<hr>

889

1179

890

<a name="pango-font-description-set-style"></a><h3>pango_font_description_set_style ()</h3>

891

<pre class="programlisting"><span class="returnvalue">void</span> pango_font_description_set_style (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

892

<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoStyle"><span class="type">PangoStyle</span></a> style</code></em>);</pre>

893

<p>

894

Sets the style field of a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>. The

895

<a class="link" href="pango-Fonts.html#PangoStyle"><span class="type">PangoStyle</span></a> enumeration describes whether the font is slanted and

1180

<a name="pango-font-description-set-style"></a><h3>pango_font_description_set_style ()</h3>

1181

1182

pango_font_description_set_style (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

1183

<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoStyle" title="enum PangoStyle"><span class="type">PangoStyle</span></a> style</code></em>);</pre>

1184

<p>Sets the style field of a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>. The

1185

<a class="link" href="pango-Fonts.html#PangoStyle" title="enum PangoStyle"><span class="type">PangoStyle</span></a> enumeration describes whether the font is slanted and

896

1186

the manner in which it is slanted; it can be either

897

1187

<a class="link" href="pango-Fonts.html#PANGO-STYLE-NORMAL:CAPS"><span class="type">PANGO_STYLE_NORMAL</span></a>, <a class="link" href="pango-Fonts.html#PANGO-STYLE-ITALIC:CAPS"><span class="type">PANGO_STYLE_ITALIC</span></a>, or <a class="link" href="pango-Fonts.html#PANGO-STYLE-OBLIQUE:CAPS"><span class="type">PANGO_STYLE_OBLIQUE</span></a>.

898

1188

Most fonts will either have a italic style or an oblique

899

1189

style, but not both, and font matching in Pango will

900

1190

match italic specifications with oblique fonts and vice-versa

901

1191

if an exact match is not found.</p>

902

903

904

905

<col>

906

</colgroup>

907

<tbody>

908

<tr>

909

910

<td>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

911

</td>

912

</tr>

913

<tr>

914

<td><p><span class="term"><em class="parameter"><code>style</code></em> :</span></p></td>

915

<td>the style for the font description</td>

916

</tr>

917

</tbody>

918

</table></div>

919

</div>

920

<hr>

921

922

<a name="pango-font-description-get-style"></a><h3>pango_font_description_get_style ()</h3>

923

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoStyle"><span class="returnvalue">PangoStyle</span></a> pango_font_description_get_style (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);</pre>

924

<p>

925

Gets the style field of a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>. See

926

<a class="link" href="pango-Fonts.html#pango-font-description-set-style" title="pango_font_description_set_style ()"><code class="function">pango_font_description_set_style()</code></a>.</p>

927

928

929

930

<col>

931

</colgroup>

932

<tbody>

933

<tr>

934

935

<td>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

936

</td>

937

</tr>

938

<tr>

939

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

940

<td>the style field for the font description.

941

Use <a class="link" href="pango-Fonts.html#pango-font-description-get-set-fields" title="pango_font_description_get_set_fields ()"><code class="function">pango_font_description_get_set_fields()</code></a> to find out if

942

the field was explicitly set or not.</td>

943

</tr>

944

</tbody>

945

</table></div>

946

</div>

947

<hr>

948

949

<a name="pango-font-description-set-variant"></a><h3>pango_font_description_set_variant ()</h3>

950

<pre class="programlisting"><span class="returnvalue">void</span> pango_font_description_set_variant (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

951

<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoVariant"><span class="type">PangoVariant</span></a> variant</code></em>);</pre>

952

<p>

953

Sets the variant field of a font description. The <a class="link" href="pango-Fonts.html#PangoVariant"><span class="type">PangoVariant</span></a>

1192

1193

<a name="id-1.2.4.16.18.5"></a><h4>Parameters</h4>

1194

1195

1196

1197

1198

1199

</colgroup>

1200

<tbody>

1201

<tr>

1202

1203

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td>

1204

1205

</tr>

1206

<tr>

1207

<td class="parameter_name"><p>style</p></td>

1208

<td class="parameter_description"><p>the style for the font description</p></td>

1209

1210

</tr>

1211

</tbody>

1212

</table></div>

1213

</div>

1214

</div>

1215

<hr>

1216

1217

<a name="pango-font-description-get-style"></a><h3>pango_font_description_get_style ()</h3>

1218

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoStyle" title="enum PangoStyle"><span class="returnvalue">PangoStyle</span></a>

1219

pango_font_description_get_style (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);</pre>

1220

<p>Gets the style field of a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>. See

1221

<a class="link" href="pango-Fonts.html#pango-font-description-set-style" title="pango_font_description_set_style ()"><code class="function">pango_font_description_set_style()</code></a>.</p>

1222

1223

<a name="id-1.2.4.16.19.5"></a><h4>Parameters</h4>

1224

1225

1226

1227

1228

1229

</colgroup>

1230

1231

1232

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td>

1233

1234

</tr></tbody>

1235

</table></div>

1236

</div>

1237

1238

<a name="id-1.2.4.16.19.6"></a><h4>Returns</h4>

1239

<p> the style field for the font description.

1240

1241

the field was explicitly set or not.</p>

1242

<p></p>

1243

</div>

1244

</div>

1245

<hr>

1246

1247

<a name="pango-font-description-set-variant"></a><h3>pango_font_description_set_variant ()</h3>

1248

1249

pango_font_description_set_variant (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

1250

<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoVariant" title="enum PangoVariant"><span class="type">PangoVariant</span></a> variant</code></em>);</pre>

1251

<p>Sets the variant field of a font description. The <a class="link" href="pango-Fonts.html#PangoVariant" title="enum PangoVariant"><span class="type">PangoVariant</span></a>

954

1252

can either be <a class="link" href="pango-Fonts.html#PANGO-VARIANT-NORMAL:CAPS"><code class="literal">PANGO_VARIANT_NORMAL</code></a> or <a class="link" href="pango-Fonts.html#PANGO-VARIANT-SMALL-CAPS"><code class="literal">PANGO_VARIANT_SMALL_CAPS</code></a>.</p>

955

956

957

958

<col>

959

</colgroup>

960

<tbody>

961

<tr>

962

963

<td>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

964

</td>

965

</tr>

966

<tr>

967

<td><p><span class="term"><em class="parameter"><code>variant</code></em> :</span></p></td>

968

<td>the variant type for the font description.</td>

969

</tr>

970

</tbody>

971

</table></div>

972

</div>

973

<hr>

974

975

<a name="pango-font-description-get-variant"></a><h3>pango_font_description_get_variant ()</h3>

976

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoVariant"><span class="returnvalue">PangoVariant</span></a> pango_font_description_get_variant (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);</pre>

977

<p>

978

Gets the variant field of a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>. See

979

<a class="link" href="pango-Fonts.html#pango-font-description-set-variant" title="pango_font_description_set_variant ()"><code class="function">pango_font_description_set_variant()</code></a>.</p>

980

981

982

983

<col>

984

</colgroup>

985

<tbody>

986

<tr>

987

988

<td>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>.</td>

989

</tr>

990

<tr>

991

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

992

<td>the variant field for the font description. Use

993

<a class="link" href="pango-Fonts.html#pango-font-description-get-set-fields" title="pango_font_description_get_set_fields ()"><code class="function">pango_font_description_get_set_fields()</code></a> to find out if

994

the field was explicitly set or not.</td>

995

</tr>

996

</tbody>

997

</table></div>

998

</div>

999

<hr>

1000

1001

<a name="pango-font-description-set-weight"></a><h3>pango_font_description_set_weight ()</h3>

1002

<pre class="programlisting"><span class="returnvalue">void</span> pango_font_description_set_weight (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

1003

<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoWeight"><span class="type">PangoWeight</span></a> weight</code></em>);</pre>

1004

<p>

1005

Sets the weight field of a font description. The weight field

1253

1254

<a name="id-1.2.4.16.20.5"></a><h4>Parameters</h4>

1255

1256

1257

1258

1259

1260

</colgroup>

1261

<tbody>

1262

<tr>

1263

1264

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td>

1265

1266

</tr>

1267

<tr>

1268

<td class="parameter_name"><p>variant</p></td>

1269

<td class="parameter_description"><p>the variant type for the font description.</p></td>

1270

1271

</tr>

1272

</tbody>

1273

</table></div>

1274

</div>

1275

</div>

1276

<hr>

1277

1278

<a name="pango-font-description-get-variant"></a><h3>pango_font_description_get_variant ()</h3>

1279

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoVariant" title="enum PangoVariant"><span class="returnvalue">PangoVariant</span></a>

1280

pango_font_description_get_variant (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);</pre>

1281

<p>Gets the variant field of a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>. See

1282

<a class="link" href="pango-Fonts.html#pango-font-description-set-variant" title="pango_font_description_set_variant ()"><code class="function">pango_font_description_set_variant()</code></a>.</p>

1283

1284

<a name="id-1.2.4.16.21.5"></a><h4>Parameters</h4>

1285

1286

1287

1288

1289

1290

</colgroup>

1291

1292

1293

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>.</p></td>

1294

1295

</tr></tbody>

1296

</table></div>

1297

</div>

1298

1299

<a name="id-1.2.4.16.21.6"></a><h4>Returns</h4>

1300

<p> the variant field for the font description. Use

1301

1302

the field was explicitly set or not.</p>

1303

<p></p>

1304

</div>

1305

</div>

1306

<hr>

1307

1308

<a name="pango-font-description-set-weight"></a><h3>pango_font_description_set_weight ()</h3>

1309

1310

pango_font_description_set_weight (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

1311

<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoWeight" title="enum PangoWeight"><span class="type">PangoWeight</span></a> weight</code></em>);</pre>

1312

<p>Sets the weight field of a font description. The weight field

1006

1313

specifies how bold or light the font should be. In addition

1007

to the values of the <a class="link" href="pango-Fonts.html#PangoWeight"><span class="type">PangoWeight</span></a> enumeration, other intermediate

1314

to the values of the <a class="link" href="pango-Fonts.html#PangoWeight" title="enum PangoWeight"><span class="type">PangoWeight</span></a> enumeration, other intermediate

1008

1315

numeric values are possible.</p>

1009

1010

1011

1012

<col>

1013

</colgroup>

1014

<tbody>

1015

<tr>

1016

1017

<td>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

1018

</td>

1019

</tr>

1020

<tr>

1021

<td><p><span class="term"><em class="parameter"><code>weight</code></em> :</span></p></td>

1022

<td>the weight for the font description.</td>

1023

</tr>

1024

</tbody>

1025

</table></div>

1026

</div>

1027

<hr>

1028

1029

<a name="pango-font-description-get-weight"></a><h3>pango_font_description_get_weight ()</h3>

1030

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoWeight"><span class="returnvalue">PangoWeight</span></a> pango_font_description_get_weight (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);</pre>

1031

<p>

1032

Gets the weight field of a font description. See

1033

<a class="link" href="pango-Fonts.html#pango-font-description-set-weight" title="pango_font_description_set_weight ()"><code class="function">pango_font_description_set_weight()</code></a>.</p>

1034

1035

1036

1037

<col>

1038

</colgroup>

1039

<tbody>

1040

<tr>

1041

1042

<td>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

1043

</td>

1044

</tr>

1045

<tr>

1046

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

1047

<td>the weight field for the font description. Use

1048

1049

the field was explicitly set or not.</td>

1050

</tr>

1051

</tbody>

1052

</table></div>

1053

</div>

1054

<hr>

1055

1056

<a name="pango-font-description-set-stretch"></a><h3>pango_font_description_set_stretch ()</h3>

1057

<pre class="programlisting"><span class="returnvalue">void</span> pango_font_description_set_stretch (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

1058

<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoStretch"><span class="type">PangoStretch</span></a> stretch</code></em>);</pre>

1059

<p>

1060

Sets the stretch field of a font description. The stretch field

1316

1317

<a name="id-1.2.4.16.22.5"></a><h4>Parameters</h4>

1318

1319

1320

1321

1322

1323

</colgroup>

1324

<tbody>

1325

<tr>

1326

1327

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td>

1328

1329

</tr>

1330

<tr>

1331

<td class="parameter_name"><p>weight</p></td>

1332

<td class="parameter_description"><p>the weight for the font description.</p></td>

1333

1334

</tr>

1335

</tbody>

1336

</table></div>

1337

</div>

1338

</div>

1339

<hr>

1340

1341

<a name="pango-font-description-get-weight"></a><h3>pango_font_description_get_weight ()</h3>

1342

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoWeight" title="enum PangoWeight"><span class="returnvalue">PangoWeight</span></a>

1343

pango_font_description_get_weight (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);</pre>

1344

<p>Gets the weight field of a font description. See

1345

<a class="link" href="pango-Fonts.html#pango-font-description-set-weight" title="pango_font_description_set_weight ()"><code class="function">pango_font_description_set_weight()</code></a>.</p>

1346

1347

<a name="id-1.2.4.16.23.5"></a><h4>Parameters</h4>

1348

1349

1350

1351

1352

1353

</colgroup>

1354

1355

1356

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td>

1357

1358

</tr></tbody>

1359

</table></div>

1360

</div>

1361

1362

<a name="id-1.2.4.16.23.6"></a><h4>Returns</h4>

1363

<p> the weight field for the font description. Use

1364

1365

the field was explicitly set or not.</p>

1366

<p></p>

1367

</div>

1368

</div>

1369

<hr>

1370

1371

<a name="pango-font-description-set-stretch"></a><h3>pango_font_description_set_stretch ()</h3>

1372

1373

pango_font_description_set_stretch (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

1374

<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoStretch" title="enum PangoStretch"><span class="type">PangoStretch</span></a> stretch</code></em>);</pre>

1375

<p>Sets the stretch field of a font description. The stretch field

1061

1376

specifies how narrow or wide the font should be.</p>

1062

1063

1064

1065

<col>

1066

</colgroup>

1067

<tbody>

1068

<tr>

1069

1070

<td>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

1071

</td>

1072

</tr>

1073

<tr>

1074

<td><p><span class="term"><em class="parameter"><code>stretch</code></em> :</span></p></td>

1075

<td>the stretch for the font description</td>

1076

</tr>

1077

</tbody>

1078

</table></div>

1079

</div>

1080

<hr>

1081

1082

<a name="pango-font-description-get-stretch"></a><h3>pango_font_description_get_stretch ()</h3>

1083

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoStretch"><span class="returnvalue">PangoStretch</span></a> pango_font_description_get_stretch (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);</pre>

1084

<p>

1085

Gets the stretch field of a font description.

1086

See <a class="link" href="pango-Fonts.html#pango-font-description-set-stretch" title="pango_font_description_set_stretch ()"><code class="function">pango_font_description_set_stretch()</code></a>.</p>

1087

1088

1089

1090

<col>

1091

</colgroup>

1092

<tbody>

1093

<tr>

1094

1095

<td>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>.</td>

1096

</tr>

1097

<tr>

1098

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

1099

<td>the stretch field for the font description. Use

1100

1101

the field was explicitly set or not.</td>

1102

</tr>

1103

</tbody>

1104

</table></div>

1105

</div>

1106

<hr>

1107

1108

<a name="pango-font-description-set-size"></a><h3>pango_font_description_set_size ()</h3>

1109

<pre class="programlisting"><span class="returnvalue">void</span> pango_font_description_set_size (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

1110

1111

<p>

1112

Sets the size field of a font description in fractional points. This is mutually

1113

exclusive with <a class="link" href="pango-Fonts.html#pango-font-description-set-absolute-size" title="pango_font_description_set_absolute_size ()"><code class="function">pango_font_description_set_absolute_size()</code></a>.</p>

1114

1115

1116

1117

<col>

1118

</colgroup>

1119

<tbody>

1120

<tr>

1121

1122

<td>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

1123

</td>

1124

</tr>

1125

<tr>

1126

1127

<td>the size of the font in points, scaled by PANGO_SCALE. (That is,

1128

a <em class="parameter"><code>size</code></em> value of 10 * PANGO_SCALE is a 10 point font. The conversion

1377

1378

<a name="id-1.2.4.16.24.5"></a><h4>Parameters</h4>

1379

1380

1381

1382

1383

1384

</colgroup>

1385

<tbody>

1386

<tr>

1387

1388

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td>

1389

1390

</tr>

1391

<tr>

1392

<td class="parameter_name"><p>stretch</p></td>

1393

<td class="parameter_description"><p>the stretch for the font description</p></td>

1394

1395

</tr>

1396

</tbody>

1397

</table></div>

1398

</div>

1399

</div>

1400

<hr>

1401

1402

<a name="pango-font-description-get-stretch"></a><h3>pango_font_description_get_stretch ()</h3>

1403

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoStretch" title="enum PangoStretch"><span class="returnvalue">PangoStretch</span></a>

1404

pango_font_description_get_stretch (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);</pre>

1405

<p>Gets the stretch field of a font description.

1406

1407

1408

<a name="id-1.2.4.16.25.5"></a><h4>Parameters</h4>

1409

1410

1411

1412

1413

1414

</colgroup>

1415

1416

1417

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>.</p></td>

1418

1419

</tr></tbody>

1420

</table></div>

1421

</div>

1422

1423

<a name="id-1.2.4.16.25.6"></a><h4>Returns</h4>

1424

<p> the stretch field for the font description. Use

1425

1426

the field was explicitly set or not.</p>

1427

<p></p>

1428

</div>

1429

</div>

1430

<hr>

1431

1432

<a name="pango-font-description-set-size"></a><h3>pango_font_description_set_size ()</h3>

1433

1434

pango_font_description_set_size (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

1435

1436

<p>Sets the size field of a font description in fractional points. This is mutually

1437

1438

1439

<a name="id-1.2.4.16.26.5"></a><h4>Parameters</h4>

1440

1441

1442

1443

1444

1445

</colgroup>

1446

<tbody>

1447

<tr>

1448

1449

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td>

1450

1451

</tr>

1452

<tr>

1453

1454

<td class="parameter_description"><p>the size of the font in points, scaled by PANGO_SCALE. (That is,

1455

a <em class="parameter"><code>size</code></em>

1456

value of 10 * PANGO_SCALE is a 10 point font. The conversion

1129

1457

factor between points and device units depends on system configuration

1130

1458

and the output device. For screen display, a logical DPI of 96 is

1131

1459

common, in which case a 10 point font corresponds to a 10 * (96 / 72) = 13.3

1132

pixel font. Use <a class="link" href="pango-Fonts.html#pango-font-description-set-absolute-size" title="pango_font_description_set_absolute_size ()"><code class="function">pango_font_description_set_absolute_size()</code></a> if you need

1133

a particular size in device units.</td>

1460

1461

a particular size in device units.</p></td>

1462

1134

1463

</tr>

1135

1464

</tbody>

1136

1465

</table></div>

1137

1466

</div>

1467

</div>

1138

1468

<hr>

1139

1469

1140

<a name="pango-font-description-get-size"></a><h3>pango_font_description_get_size ()</h3>

1141

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> pango_font_description_get_size (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);</pre>

1142

<p>

1143

Gets the size field of a font description.

1144

See <a class="link" href="pango-Fonts.html#pango-font-description-set-size" title="pango_font_description_set_size ()"><code class="function">pango_font_description_set_size()</code></a>.</p>

1145

1470

<a name="pango-font-description-get-size"></a><h3>pango_font_description_get_size ()</h3>

1471

1472

pango_font_description_get_size (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);</pre>

1473

<p>Gets the size field of a font description.

1474

See <a class="link" href="pango-Fonts.html#pango-font-description-set-size" title="pango_font_description_set_size ()"><code class="function">pango_font_description_set_size()</code></a>.</p>

1475

1476

<a name="id-1.2.4.16.27.5"></a><h4>Parameters</h4>

1477

1146

1478

1147

1148

<col>

1479

1480

1481

1149

1482

</colgroup>

1150

<tbody>

1151

<tr>

1152

1153

<td>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

1154

</td>

1155

</tr>

1156

<tr>

1157

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

1158

<td>the size field for the font description in points or device units.

1159

You must call <a class="link" href="pango-Fonts.html#pango-font-description-get-size-is-absolute" title="pango_font_description_get_size_is_absolute ()"><code class="function">pango_font_description_get_size_is_absolute()</code></a>

1483

1484

1485

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td>

1486

1487

</tr></tbody>

1488

</table></div>

1489

</div>

1490

1491

<a name="id-1.2.4.16.27.6"></a><h4>Returns</h4>

1492

<p> the size field for the font description in points or device units.

1493

1160

1494

to find out which is the case. Returns 0 if the size field has not

1161

1495

previously been set or it has been set to 0 explicitly.

1162

1163

find out if the field was explicitly set or not.</td>

1164

</tr>

1165

</tbody>

1166

</table></div>

1496

1497

find out if the field was explicitly set or not.</p>

1498

<p></p>

1499

</div>

1167

1500

</div>

1168

1501

<hr>

1169

1502

1170

<a name="pango-font-description-set-absolute-size"></a><h3>pango_font_description_set_absolute_size ()</h3>

1171

<pre class="programlisting"><span class="returnvalue">void</span> pango_font_description_set_absolute_size

1172

(<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

1173

<em class="parameter"><code><span class="type">double</span> size</code></em>);</pre>

1174

<p>

1175

Sets the size field of a font description, in device units. This is mutually

1176

exclusive with <a class="link" href="pango-Fonts.html#pango-font-description-set-size" title="pango_font_description_set_size ()"><code class="function">pango_font_description_set_size()</code></a> which sets the font size

1503

<a name="pango-font-description-set-absolute-size"></a><h3>pango_font_description_set_absolute_size ()</h3>

1504

1505

pango_font_description_set_absolute_size

1506

(<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

1507

<em class="parameter"><code><span class="type">double</span> size</code></em>);</pre>

1508

<p>Sets the size field of a font description, in device units. This is mutually

1509

1177

1510

in points.</p>

1178

1511

1512

<a name="id-1.2.4.16.28.5"></a><h4>Parameters</h4>

1513

1179

1514

1180

1181

<col>

1515

1516

1517

1182

1518

</colgroup>

1183

1519

<tbody>

1184

1520

<tr>

1185

1186

<td>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

1187

</td>

1521

1522

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td>

1523

1188

1524

</tr>

1189

1525

<tr>

1190

1191

<td>the new size, in Pango units. There are <a class="link" href="pango-Glyph-Storage.html#PANGO-SCALE:CAPS" title="PANGO_SCALE"><code class="literal">PANGO_SCALE</code></a> Pango units in one

1526

1527

<td class="parameter_description"><p>the new size, in Pango units. There are <a class="link" href="pango-Glyph-Storage.html#PANGO-SCALE:CAPS" title="PANGO_SCALE"><code class="literal">PANGO_SCALE</code></a> Pango units in one

1192

1528

device unit. For an output backend where a device unit is a pixel, a <em class="parameter"><code>size</code></em>

1193

value of 10 * PANGO_SCALE gives a 10 pixel font.</td>

1529

value of 10 * PANGO_SCALE gives a 10 pixel font.</p></td>

1530

1194

1531

</tr>

1195

1532

</tbody>

1196

1533

</table></div>

1534

</div>

1197

1535

<p class="since">Since 1.8</p>

1198

1536

</div>

1199

1537

<hr>

1200

1538

1201

<a name="pango-font-description-get-size-is-absolute"></a><h3>pango_font_description_get_size_is_absolute ()</h3>

1202

1203

(<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);</pre>

1204

<p>

1205

Determines whether the size of the font is in points (not absolute) or device units (absolute).

1206

See <a class="link" href="pango-Fonts.html#pango-font-description-set-size" title="pango_font_description_set_size ()"><code class="function">pango_font_description_set_size()</code></a> and <a class="link" href="pango-Fonts.html#pango-font-description-set-absolute-size" title="pango_font_description_set_absolute_size ()"><code class="function">pango_font_description_set_absolute_size()</code></a>.</p>

1207

1539

<a name="pango-font-description-get-size-is-absolute"></a><h3>pango_font_description_get_size_is_absolute ()</h3>

1540

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>

1541

pango_font_description_get_size_is_absolute

1542

(<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);</pre>

1543

<p>Determines whether the size of the font is in points (not absolute) or device units (absolute).

1544

1545

1546

<a name="id-1.2.4.16.29.5"></a><h4>Parameters</h4>

1547

1208

1548

1209

1210

<col>

1549

1550

1551

1211

1552

</colgroup>

1212

<tbody>

1213

<tr>

1214

1215

<td>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

1216

</td>

1217

</tr>

1218

<tr>

1219

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

1220

<td>whether the size for the font description is in

1221

points or device units. Use <a class="link" href="pango-Fonts.html#pango-font-description-get-set-fields" title="pango_font_description_get_set_fields ()"><code class="function">pango_font_description_get_set_fields()</code></a> to

1222

find out if the size field of the font description was explicitly set or not.</td>

1223

</tr>

1224

</tbody>

1553

1554

1555

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td>

1556

1557

</tr></tbody>

1225

1558

</table></div>

1559

</div>

1560

1561

<a name="id-1.2.4.16.29.6"></a><h4>Returns</h4>

1562

<p> whether the size for the font description is in

1563

1564

find out if the size field of the font description was explicitly set or not.</p>

1565

<p></p>

1566

</div>

1226

1567

<p class="since">Since 1.8</p>

1227

1568

</div>

1228

1569

<hr>

1229

1570

1230

<a name="pango-font-description-set-gravity"></a><h3>pango_font_description_set_gravity ()</h3>

1231

<pre class="programlisting"><span class="returnvalue">void</span> pango_font_description_set_gravity (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

1232

<em class="parameter"><code><a class="link" href="pango-Vertical-Text.html#PangoGravity"><span class="type">PangoGravity</span></a> gravity</code></em>);</pre>

1233

<p>

1234

Sets the gravity field of a font description. The gravity field

1235

specifies how the glyphs should be rotated. If <em class="parameter"><code>gravity</code></em> is

1571

<a name="pango-font-description-set-gravity"></a><h3>pango_font_description_set_gravity ()</h3>

1572

1573

pango_font_description_set_gravity (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

1574

<em class="parameter"><code><a class="link" href="pango-Vertical-Text.html#PangoGravity" title="enum PangoGravity"><span class="type">PangoGravity</span></a> gravity</code></em>);</pre>

1575

<p>Sets the gravity field of a font description. The gravity field

1576

specifies how the glyphs should be rotated. If <em class="parameter"><code>gravity</code></em>

1577

1236

1578

<a class="link" href="pango-Vertical-Text.html#PANGO-GRAVITY-AUTO:CAPS"><code class="literal">PANGO_GRAVITY_AUTO</code></a>, this actually unsets the gravity mask on

1237

1579

the font description.</p>

1238

<p>

1239

This function is seldom useful to the user. Gravity should normally

1580

<p>This function is seldom useful to the user. Gravity should normally

1240

1581

be set on a <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>.</p>

1241

1242

1243

1244

<col>

1245

</colgroup>

1246

<tbody>

1247

<tr>

1248

1249

<td>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

1250

</td>

1251

</tr>

1252

<tr>

1253

<td><p><span class="term"><em class="parameter"><code>gravity</code></em> :</span></p></td>

1254

<td>the gravity for the font description.</td>

1255

</tr>

1256

</tbody>

1257

</table></div>

1258

<p class="since">Since 1.16</p>

1259

</div>

1260

<hr>

1261

1262

<a name="pango-font-description-get-gravity"></a><h3>pango_font_description_get_gravity ()</h3>

1263

<pre class="programlisting"><a class="link" href="pango-Vertical-Text.html#PangoGravity"><span class="returnvalue">PangoGravity</span></a> pango_font_description_get_gravity (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);</pre>

1264

<p>

1265

Gets the gravity field of a font description. See

1266

<a class="link" href="pango-Fonts.html#pango-font-description-set-gravity" title="pango_font_description_set_gravity ()"><code class="function">pango_font_description_set_gravity()</code></a>.</p>

1267

1268

1269

1270

<col>

1271

</colgroup>

1272

<tbody>

1273

<tr>

1274

1275

<td>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

1276

</td>

1277

</tr>

1278

<tr>

1279

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

1280

<td>the gravity field for the font description. Use

1281

1282

the field was explicitly set or not.</td>

1283

</tr>

1284

</tbody>

1285

</table></div>

1286

<p class="since">Since 1.16</p>

1287

</div>

1288

<hr>

1289

1290

<a name="pango-font-description-get-set-fields"></a><h3>pango_font_description_get_set_fields ()</h3>

1291

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontMask"><span class="returnvalue">PangoFontMask</span></a> pango_font_description_get_set_fields

1292

(<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);</pre>

1293

<p>

1294

Determines which fields in a font description have been set.</p>

1295

1296

1297

1298

<col>

1299

</colgroup>

1300

<tbody>

1301

<tr>

1302

1303

<td>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

1304

</td>

1305

</tr>

1306

<tr>

1307

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

1308

<td>a bitmask with bits set corresponding to the

1309

fields in <em class="parameter"><code>desc</code></em> that have been set.</td>

1310

</tr>

1311

</tbody>

1312

</table></div>

1313

</div>

1314

<hr>

1315

1316

<a name="pango-font-description-unset-fields"></a><h3>pango_font_description_unset_fields ()</h3>

1317

<pre class="programlisting"><span class="returnvalue">void</span> pango_font_description_unset_fields (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

1318

<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMask"><span class="type">PangoFontMask</span></a> to_unset</code></em>);</pre>

1319

<p>

1320

Unsets some of the fields in a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>. The unset

1582

1583

<a name="id-1.2.4.16.30.6"></a><h4>Parameters</h4>

1584

1585

1586

1587

1588

1589

</colgroup>

1590

<tbody>

1591

<tr>

1592

1593

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td>

1594

1595

</tr>

1596

<tr>

1597

<td class="parameter_name"><p>gravity</p></td>

1598

<td class="parameter_description"><p>the gravity for the font description.</p></td>

1599

1600

</tr>

1601

</tbody>

1602

</table></div>

1603

</div>

1604

<p class="since">Since 1.16</p>

1605

</div>

1606

<hr>

1607

1608

<a name="pango-font-description-get-gravity"></a><h3>pango_font_description_get_gravity ()</h3>

1609

<pre class="programlisting"><a class="link" href="pango-Vertical-Text.html#PangoGravity" title="enum PangoGravity"><span class="returnvalue">PangoGravity</span></a>

1610

pango_font_description_get_gravity (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);</pre>

1611

<p>Gets the gravity field of a font description. See

1612

<a class="link" href="pango-Fonts.html#pango-font-description-set-gravity" title="pango_font_description_set_gravity ()"><code class="function">pango_font_description_set_gravity()</code></a>.</p>

1613

1614

<a name="id-1.2.4.16.31.5"></a><h4>Parameters</h4>

1615

1616

1617

1618

1619

1620

</colgroup>

1621

1622

1623

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td>

1624

1625

</tr></tbody>

1626

</table></div>

1627

</div>

1628

1629

<a name="id-1.2.4.16.31.6"></a><h4>Returns</h4>

1630

<p> the gravity field for the font description. Use

1631

1632

the field was explicitly set or not.</p>

1633

<p></p>

1634

</div>

1635

<p class="since">Since 1.16</p>

1636

</div>

1637

<hr>

1638

1639

<a name="pango-font-description-get-set-fields"></a><h3>pango_font_description_get_set_fields ()</h3>

1640

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontMask" title="enum PangoFontMask"><span class="returnvalue">PangoFontMask</span></a>

1641

pango_font_description_get_set_fields (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);</pre>

1642

<p>Determines which fields in a font description have been set.</p>

1643

1644

<a name="id-1.2.4.16.32.5"></a><h4>Parameters</h4>

1645

1646

1647

1648

1649

1650

</colgroup>

1651

1652

1653

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td>

1654

1655

</tr></tbody>

1656

</table></div>

1657

</div>

1658

1659

<a name="id-1.2.4.16.32.6"></a><h4>Returns</h4>

1660

<p> a bitmask with bits set corresponding to the

1661

fields in <em class="parameter"><code>desc</code></em>

1662

that have been set.</p>

1663

<p></p>

1664

</div>

1665

</div>

1666

<hr>

1667

1668

<a name="pango-font-description-unset-fields"></a><h3>pango_font_description_unset_fields ()</h3>

1669

1670

pango_font_description_unset_fields (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

1671

<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMask" title="enum PangoFontMask"><span class="type">PangoFontMask</span></a> to_unset</code></em>);</pre>

1672

<p>Unsets some of the fields in a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>. The unset

1321

1673

fields will get back to their default values.</p>

1322

1674

1675

<a name="id-1.2.4.16.33.5"></a><h4>Parameters</h4>

1676

1323

1677

1324

1325

<col>

1678

1679

1680

1326

1681

</colgroup>

1327

1682

<tbody>

1328

1683

<tr>

1329

1330

<td>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

1331

</td>

1684

1685

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td>

1686

1332

1687

</tr>

1333

1688

<tr>

1334

<td><p><span class="term"><em class="parameter"><code>to_unset</code></em> :</span></p></td>

1335

<td>bitmask of fields in the <em class="parameter"><code>desc</code></em> to unset.</td>

1689

<td class="parameter_name"><p>to_unset</p></td>

1690

<td class="parameter_description"><p>bitmask of fields in the <em class="parameter"><code>desc</code></em>

1691

to unset.</p></td>

1692

1336

1693

</tr>

1337

1694

</tbody>

1338

1695

</table></div>

1339

1696

</div>

1697

</div>

1340

1698

<hr>

1341

1699

1342

<a name="pango-font-description-merge"></a><h3>pango_font_description_merge ()</h3>

1343

<pre class="programlisting"><span class="returnvalue">void</span> pango_font_description_merge (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

1344

<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc_to_merge</code></em>,

1345

<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> replace_existing</code></em>);</pre>

1346

<p>

1347

Merges the fields that are set in <em class="parameter"><code>desc_to_merge</code></em> into the fields in

1348

<em class="parameter"><code>desc</code></em>. If <em class="parameter"><code>replace_existing</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, only fields in <em class="parameter"><code>desc</code></em> that

1700

<a name="pango-font-description-merge"></a><h3>pango_font_description_merge ()</h3>

1701

1702

pango_font_description_merge (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

1703

<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc_to_merge</code></em>,

1704

<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> replace_existing</code></em>);</pre>

1705

<p>Merges the fields that are set in <em class="parameter"><code>desc_to_merge</code></em>

1706

into the fields in

1707

1708

. If <em class="parameter"><code>replace_existing</code></em>

1709

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, only fields in <em class="parameter"><code>desc</code></em>

1710

that

1349

1711

are not already set are affected. If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, then fields that are

1350

1712

already set will be replaced as well.</p>

1351

<p>

1352

If <em class="parameter"><code>desc_to_merge</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, this function performs nothing.</p>

1353

1713

<p>If <em class="parameter"><code>desc_to_merge</code></em>

1714

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, this function performs nothing.</p>

1715

1716

<a name="id-1.2.4.16.34.6"></a><h4>Parameters</h4>

1717

1354

1718

1355

1356

<col>

1719

1720

1721

1357

1722

</colgroup>

1358

1723

<tbody>

1359

1724

<tr>

1360

1361

<td>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

1362

</td>

1363

</tr>

1364

<tr>

1365

<td><p><span class="term"><em class="parameter"><code>desc_to_merge</code></em> :</span></p></td>

1366

<td>the <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> to merge from, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>

1367

</td>

1368

</tr>

1369

<tr>

1370

<td><p><span class="term"><em class="parameter"><code>replace_existing</code></em> :</span></p></td>

1371

<td>if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, replace fields in <em class="parameter"><code>desc</code></em> with the

1372

corresponding values from <em class="parameter"><code>desc_to_merge</code></em>, even if they

1373

are already exist.</td>

1725

1726

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td>

1727

1728

</tr>

1729

<tr>

1730

<td class="parameter_name"><p>desc_to_merge</p></td>

1731

<td class="parameter_description"><p> the <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> to merge from, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>

1732

<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>

1733

</tr>

1734

<tr>

1735

<td class="parameter_name"><p>replace_existing</p></td>

1736

<td class="parameter_description"><p>if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, replace fields in <em class="parameter"><code>desc</code></em>

1737

with the

1738

corresponding values from <em class="parameter"><code>desc_to_merge</code></em>

1739

, even if they

1740

are already exist.</p></td>

1741

1374

1742

</tr>

1375

1743

</tbody>

1376

1744

</table></div>

1377

1745

</div>

1746

</div>

1378

1747

<hr>

1379

1748

1380

<a name="pango-font-description-merge-static"></a><h3>pango_font_description_merge_static ()</h3>

1381

<pre class="programlisting"><span class="returnvalue">void</span> pango_font_description_merge_static (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

1382

<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc_to_merge</code></em>,

1383

<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> replace_existing</code></em>);</pre>

1384

<p>

1385

Like <a class="link" href="pango-Fonts.html#pango-font-description-merge" title="pango_font_description_merge ()"><code class="function">pango_font_description_merge()</code></a>, but only a shallow copy is made

1386

of the family name and other allocated fields. <em class="parameter"><code>desc</code></em> can only be

1387

used until <em class="parameter"><code>desc_to_merge</code></em> is modified or freed. This is meant

1749

<a name="pango-font-description-merge-static"></a><h3>pango_font_description_merge_static ()</h3>

1750

1751

pango_font_description_merge_static (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

1752

<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc_to_merge</code></em>,

1753

<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> replace_existing</code></em>);</pre>

1754

<p>Like <a class="link" href="pango-Fonts.html#pango-font-description-merge" title="pango_font_description_merge ()"><code class="function">pango_font_description_merge()</code></a>, but only a shallow copy is made

1755

of the family name and other allocated fields. <em class="parameter"><code>desc</code></em>

1756

can only be

1757

used until <em class="parameter"><code>desc_to_merge</code></em>

1758

is modified or freed. This is meant

1388

1759

to be used when the merged font description is only needed temporarily.</p>

1389

1760

1761

<a name="id-1.2.4.16.35.5"></a><h4>Parameters</h4>

1762

1390

1763

1391

1392

<col>

1764

1765

1766

1393

1767

</colgroup>

1394

1768

<tbody>

1395

1769

<tr>

1396

1397

<td>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

1398

</td>

1399

</tr>

1400

<tr>

1401

<td><p><span class="term"><em class="parameter"><code>desc_to_merge</code></em> :</span></p></td>

1402

<td>the <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> to merge from</td>

1403

</tr>

1404

<tr>

1405

<td><p><span class="term"><em class="parameter"><code>replace_existing</code></em> :</span></p></td>

1406

1407

corresponding values from <em class="parameter"><code>desc_to_merge</code></em>, even if they

1408

are already exist.</td>

1770

1771

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td>

1772

1773

</tr>

1774

<tr>

1775

<td class="parameter_name"><p>desc_to_merge</p></td>

1776

<td class="parameter_description"><p>the <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> to merge from</p></td>

1777

1778

</tr>

1779

<tr>

1780

<td class="parameter_name"><p>replace_existing</p></td>

1781

1782

with the

1783

corresponding values from <em class="parameter"><code>desc_to_merge</code></em>

1784

, even if they

1785

are already exist.</p></td>

1786

1409

1787

</tr>

1410

1788

</tbody>

1411

1789

</table></div>

1412

1790

</div>

1791

</div>

1413

1792

<hr>

1414

1793

1415

<a name="pango-font-description-better-match"></a><h3>pango_font_description_better_match ()</h3>

1416

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> pango_font_description_better_match (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

1417

<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *old_match</code></em>,

1418

<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *new_match</code></em>);</pre>

1419

<p>

1420

Determines if the style attributes of <em class="parameter"><code>new_match</code></em> are a closer match

1421

for <em class="parameter"><code>desc</code></em> than those of <em class="parameter"><code>old_match</code></em> are, or if <em class="parameter"><code>old_match</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>,

1422

determines if <em class="parameter"><code>new_match</code></em> is a match at all.

1794

<a name="pango-font-description-better-match"></a><h3>pango_font_description_better_match ()</h3>

1795

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>

1796

pango_font_description_better_match (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

1797

<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *old_match</code></em>,

1798

<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *new_match</code></em>);</pre>

1799

<p>Determines if the style attributes of <em class="parameter"><code>new_match</code></em>

1800

are a closer match

1801

for <em class="parameter"><code>desc</code></em>

1802

than those of <em class="parameter"><code>old_match</code></em>

1803

are, or if <em class="parameter"><code>old_match</code></em>

1804

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>,

1805

determines if <em class="parameter"><code>new_match</code></em>

1806

is a match at all.

1423

1807

Approximate matching is done for

1424

1808

weight and style; other style attributes must match exactly.

1425

1809

Style attributes are all attributes other than family and size-related

1426

1810

attributes. Approximate matching for style considers PANGO_STYLE_OBLIQUE

1427

1811

and PANGO_STYLE_ITALIC as matches, but not as good a match as when the

1428

1812

styles are equal.</p>

1429

<p>

1430

Note that <em class="parameter"><code>old_match</code></em> must match <em class="parameter"><code>desc</code></em>.</p>

1431

1813

<p>Note that <em class="parameter"><code>old_match</code></em>

1814

must match <em class="parameter"><code>desc</code></em>

1815

.</p>

1816

1817

<a name="id-1.2.4.16.36.6"></a><h4>Parameters</h4>

1818

1432

1819

1433

1434

<col>

1820

1821

1822

1435

1823

</colgroup>

1436

1824

<tbody>

1437

1825

<tr>

1438

1439

<td>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

1440

</td>

1441

</tr>

1442

<tr>

1443

<td><p><span class="term"><em class="parameter"><code>old_match</code></em> :</span></p></td>

1444

<td>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>

1445

</td>

1446

</tr>

1447

<tr>

1448

<td><p><span class="term"><em class="parameter"><code>new_match</code></em> :</span></p></td>

1449

<td>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

1450

</td>

1451

</tr>

1452

<tr>

1453

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

1454

<td>

1455

1826

1827

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td>

1828

1829

</tr>

1830

<tr>

1831

<td class="parameter_name"><p>old_match</p></td>

1832

<td class="parameter_description"><p> a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>

1833

<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>

1834

</tr>

1835

<tr>

1836

<td class="parameter_name"><p>new_match</p></td>

1837

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td>

1838

1456

1839

</tr>

1457

1840

</tbody>

1458

1841

</table></div>

1459

1842

</div>

1843

1844

<a name="id-1.2.4.16.36.7"></a><h4>Returns</h4>

1845

<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>new_match</code></em>

1846

is a better match</p>

1847

<p></p>

1848

</div>

1849

</div>

1460

1850

<hr>

1461

1851

1462

<a name="pango-font-description-from-string"></a><h3>pango_font_description_from_string ()</h3>

1463

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> * pango_font_description_from_string

1464

(<em class="parameter"><code>const <span class="type">char</span> *str</code></em>);</pre>

1465

<p>

1466

Creates a new font description from a string representation in the

1467

form "[FAMILY-LIST] [STYLE-OPTIONS] [SIZE]", where FAMILY-LIST is a

1852

<a name="pango-font-description-from-string"></a><h3>pango_font_description_from_string ()</h3>

1853

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> *

1854

pango_font_description_from_string (<em class="parameter"><code>const <span class="type">char</span> *str</code></em>);</pre>

1855

<p>Creates a new font description from a string representation in the

1856

form "FAMILY-LIST [SIZE]", where FAMILY-LIST is a

1468

1857

comma separated list of families optionally terminated by a comma,

1469

1858

STYLE_OPTIONS is a whitespace separated list of words where each WORD

1470

1859

describes one of style, variant, weight, stretch, or gravity, and SIZE

1475

1864

STYLE-OPTIONS is missing, then all style options will be set to the

1476

1865

default values. If SIZE is missing, the size in the resulting font

1477

1866

description will be set to 0.</p>

1478

1867

1868

<a name="id-1.2.4.16.37.5"></a><h4>Parameters</h4>

1869

1479

1870

1480

1481

<col>

1871

1872

1873

1482

1874

</colgroup>

1483

<tbody>

1484

<tr>

1485

1486

<td>string representation of a font description.</td>

1487

</tr>

1488

<tr>

1489

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

1490

<td>a new <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>.</td>

1491

</tr>

1492

</tbody>

1875

1876

1877

<td class="parameter_description"><p>string representation of a font description.</p></td>

1878

1879

</tr></tbody>

1493

1880

</table></div>

1494

1881

</div>

1882

1883

<a name="id-1.2.4.16.37.6"></a><h4>Returns</h4>

1884

<p> a new <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>.</p>

1885

<p></p>

1886

</div>

1887

</div>

1495

1888

<hr>

1496

1889

1497

<a name="pango-font-description-to-string"></a><h3>pango_font_description_to_string ()</h3>

1498

<pre class="programlisting"><span class="returnvalue">char</span> * pango_font_description_to_string (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);</pre>

1499

<p>

1500

Creates a string representation of a font description. See

1501

<a class="link" href="pango-Fonts.html#pango-font-description-from-string" title="pango_font_description_from_string ()"><code class="function">pango_font_description_from_string()</code></a> for a description of the

1890

<a name="pango-font-description-to-string"></a><h3>pango_font_description_to_string ()</h3>

1891

<pre class="programlisting"><span class="returnvalue">char</span> *

1892

pango_font_description_to_string (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);</pre>

1893

<p>Creates a string representation of a font description. See

1894

1502

1895

format of the string representation. The family list in the

1503

1896

string description will only have a terminating comma if the

1504

1897

last word of the list is a valid style option.</p>

1505

1898

1899

<a name="id-1.2.4.16.38.5"></a><h4>Parameters</h4>

1900

1506

1901

1507

1508

<col>

1902

1903

1904

1509

1905

</colgroup>

1510

<tbody>

1511

<tr>

1512

1513

<td>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

1514

</td>

1515

</tr>

1516

<tr>

1517

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

1518

<td>a new string that must be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.</td>

1519

</tr>

1520

</tbody>

1906

1907

1908

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td>

1909

1910

</tr></tbody>

1521

1911

</table></div>

1522

1912

</div>

1913

1914

<a name="id-1.2.4.16.38.6"></a><h4>Returns</h4>

1915

<p> a new string that must be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.</p>

1916

<p></p>

1917

</div>

1918

</div>

1523

1919

<hr>

1524

1920

1525

<a name="pango-font-description-to-filename"></a><h3>pango_font_description_to_filename ()</h3>

1526

<pre class="programlisting"><span class="returnvalue">char</span> * pango_font_description_to_filename (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);</pre>

1527

<p>

1528

Creates a filename representation of a font description. The

1921

<a name="pango-font-description-to-filename"></a><h3>pango_font_description_to_filename ()</h3>

1922

<pre class="programlisting"><span class="returnvalue">char</span> *

1923

pango_font_description_to_filename (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);</pre>

1924

<p>Creates a filename representation of a font description. The

1529

1925

filename is identical to the result from calling

1530

<a class="link" href="pango-Fonts.html#pango-font-description-to-string" title="pango_font_description_to_string ()"><code class="function">pango_font_description_to_string()</code></a>, but with underscores instead of

1926

1531

1927

characters that are untypical in filenames, and in lower case only.</p>

1532

1928

1929

<a name="id-1.2.4.16.39.5"></a><h4>Parameters</h4>

1930

1533

1931

1534

1535

<col>

1932

1933

1934

1536

1935

</colgroup>

1537

<tbody>

1538

<tr>

1539

1540

<td>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

1541

</td>

1542

</tr>

1543

<tr>

1544

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

1545

<td>a new string that must be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.</td>

1546

</tr>

1547

</tbody>

1936

1937

1938

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td>

1939

1940

</tr></tbody>

1548

1941

</table></div>

1549

1942

</div>

1550

<hr>

1551

1552

<a name="PangoFontMetrics-struct"></a><h3>struct PangoFontMetrics</h3>

1553

<pre class="programlisting">struct PangoFontMetrics {

1554

guint ref_count;

1555

1556

int ascent;

1557

int descent;

1558

int approximate_char_width;

1559

int approximate_digit_width;

1560

int underline_position;

1561

int underline_thickness;

1562

int strikethrough_position;

1563

int strikethrough_thickness;

1564

};

1565

</pre>

1566

<p>

1567

A <a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure holds the overall metric information

1568

for a font (possibly restricted to a script). The fields of this

1569

structure are private to implementations of a font backend. See

1570

the documentation of the corresponding getters for documentation

1571

of their meaning.</p>

1943

1944

<a name="id-1.2.4.16.39.6"></a><h4>Returns</h4>

1945

<p> a new string that must be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.</p>

1946

<p></p>

1947

</div>

1572

1948

</div>

1573

1949

<hr>

1574

1950

1575

1951

<a name="PANGO-TYPE-FONT-METRICS:CAPS"></a><h3>PANGO_TYPE_FONT_METRICS</h3>

1576

1952

<pre class="programlisting">#define PANGO_TYPE_FONT_METRICS (pango_font_metrics_get_type ())

1577

1953

</pre>

1578

<p>

1579

The <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> type for <a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a>.</p>

1954

<p>The <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> type for <a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a>.</p>

1580

1955

</div>

1581

1956

<hr>

1582

1957

1583

<a name="pango-font-metrics-ref"></a><h3>pango_font_metrics_ref ()</h3>

1584

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="returnvalue">PangoFontMetrics</span></a> * pango_font_metrics_ref (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> *metrics</code></em>);</pre>

1585

<p>

1586

Increase the reference count of a font metrics structure by one.</p>

1587

1958

<a name="pango-font-metrics-ref"></a><h3>pango_font_metrics_ref ()</h3>

1959

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="returnvalue">PangoFontMetrics</span></a> *

1960

pango_font_metrics_ref (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> *metrics</code></em>);</pre>

1961

<p>Increase the reference count of a font metrics structure by one.</p>

1962

1963

<a name="id-1.2.4.16.41.5"></a><h4>Parameters</h4>

1964

1588

1965

1589

1590

<col>

1966

1967

1968

1591

1969

</colgroup>

1592

<tbody>

1593

<tr>

1594

<td><p><span class="term"><em class="parameter"><code>metrics</code></em> :</span></p></td>

1595

<td>a <a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure, may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

1596

</td>

1597

</tr>

1598

<tr>

1599

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

1600

<td><em class="parameter"><code>metrics</code></em></td>

1601

</tr>

1602

</tbody>

1970

1971

<td class="parameter_name"><p>metrics</p></td>

1972

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure, may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>

1973

1974

</tr></tbody>

1603

1975

</table></div>

1604

1976

</div>

1977

1978

<a name="id-1.2.4.16.41.6"></a><h4>Returns</h4>

1979

<p> <em class="parameter"><code>metrics</code></em>

1980

</p>

1981

<p></p>

1982

</div>

1983

</div>

1605

1984

<hr>

1606

1985

1607

<a name="pango-font-metrics-unref"></a><h3>pango_font_metrics_unref ()</h3>

1608

<pre class="programlisting"><span class="returnvalue">void</span> pango_font_metrics_unref (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> *metrics</code></em>);</pre>

1609

<p>

1610

Decrease the reference count of a font metrics structure by one. If

1986

<a name="pango-font-metrics-unref"></a><h3>pango_font_metrics_unref ()</h3>

1987

1988

pango_font_metrics_unref (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> *metrics</code></em>);</pre>

1989

<p>Decrease the reference count of a font metrics structure by one. If

1611

1990

the result is zero, frees the structure and any associated

1612

1991

memory.</p>

1613

1992

1993

<a name="id-1.2.4.16.42.5"></a><h4>Parameters</h4>

1994

1614

1995

1615

1616

<col>

1996

1997

1998

1617

1999

</colgroup>

1618

2000

1619

<td><p><span class="term"><em class="parameter"><code>metrics</code></em> :</span></p></td>

1620

1621

</td>

2001

<td class="parameter_name"><p>metrics</p></td>

2002

2003

1622

2004

</tr></tbody>

1623

2005

</table></div>

1624

2006

</div>

2007

</div>

1625

2008

<hr>

1626

2009

1627

<a name="pango-font-metrics-get-ascent"></a><h3>pango_font_metrics_get_ascent ()</h3>

1628

<pre class="programlisting"><span class="returnvalue">int</span> pango_font_metrics_get_ascent (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> *metrics</code></em>);</pre>

1629

<p>

1630

Gets the ascent from a font metrics structure. The ascent is

2010

<a name="pango-font-metrics-get-ascent"></a><h3>pango_font_metrics_get_ascent ()</h3>

2011

2012

pango_font_metrics_get_ascent (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> *metrics</code></em>);</pre>

2013

<p>Gets the ascent from a font metrics structure. The ascent is

1631

2014

the distance from the baseline to the logical top of a line

1632

2015

of text. (The logical top may be above or below the top of the

1633

2016

actual drawn ink. It is necessary to lay out the text to figure

1634

2017

where the ink will be.)</p>

1635

2018

2019

<a name="id-1.2.4.16.43.5"></a><h4>Parameters</h4>

2020

1636

2021

1637

1638

<col>

2022

2023

2024

1639

2025

</colgroup>

1640

<tbody>

1641

<tr>

1642

<td><p><span class="term"><em class="parameter"><code>metrics</code></em> :</span></p></td>

1643

<td>a <a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure</td>

1644

</tr>

1645

<tr>

1646

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

1647

<td>the ascent, in Pango units.</td>

1648

</tr>

1649

</tbody>

2026

2027

<td class="parameter_name"><p>metrics</p></td>

2028

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure</p></td>

2029

2030

</tr></tbody>

1650

2031

</table></div>

1651

2032

</div>

2033

2034

<a name="id-1.2.4.16.43.6"></a><h4>Returns</h4>

2035

<p> the ascent, in Pango units.</p>

2036

<p></p>

2037

</div>

2038

</div>

1652

2039

<hr>

1653

2040

1654

<a name="pango-font-metrics-get-descent"></a><h3>pango_font_metrics_get_descent ()</h3>

1655

<pre class="programlisting"><span class="returnvalue">int</span> pango_font_metrics_get_descent (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> *metrics</code></em>);</pre>

1656

<p>

1657

Gets the descent from a font metrics structure. The descent is

2041

<a name="pango-font-metrics-get-descent"></a><h3>pango_font_metrics_get_descent ()</h3>

2042

2043

pango_font_metrics_get_descent (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> *metrics</code></em>);</pre>

2044

<p>Gets the descent from a font metrics structure. The descent is

1658

2045

the distance from the baseline to the logical bottom of a line

1659

2046

of text. (The logical bottom may be above or below the bottom of the

1660

2047

actual drawn ink. It is necessary to lay out the text to figure

1661

2048

where the ink will be.)</p>

1662

2049

2050

<a name="id-1.2.4.16.44.5"></a><h4>Parameters</h4>

2051

1663

2052

1664

1665

<col>

2053

2054

2055

1666

2056

</colgroup>

1667

<tbody>

1668

<tr>

1669

<td><p><span class="term"><em class="parameter"><code>metrics</code></em> :</span></p></td>

1670

<td>a <a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure</td>

1671

</tr>

1672

<tr>

1673

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

1674

<td>the descent, in Pango units.</td>

1675

</tr>

1676

</tbody>

2057

2058

<td class="parameter_name"><p>metrics</p></td>

2059

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure</p></td>

2060

2061

</tr></tbody>

1677

2062

</table></div>

1678

2063

</div>

2064

2065

<a name="id-1.2.4.16.44.6"></a><h4>Returns</h4>

2066

<p> the descent, in Pango units.</p>

2067

<p></p>

2068

</div>

2069

</div>

1679

2070

<hr>

1680

2071

1681

<a name="pango-font-metrics-get-approximate-char-width"></a><h3>pango_font_metrics_get_approximate_char_width ()</h3>

1682

<pre class="programlisting"><span class="returnvalue">int</span> pango_font_metrics_get_approximate_char_width

1683

(<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> *metrics</code></em>);</pre>

1684

<p>

1685

Gets the approximate character width for a font metrics structure.

2072

<a name="pango-font-metrics-get-approximate-char-width"></a><h3>pango_font_metrics_get_approximate_char_width ()</h3>

2073

2074

pango_font_metrics_get_approximate_char_width

2075

(<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> *metrics</code></em>);</pre>

2076

<p>Gets the approximate character width for a font metrics structure.

1686

2077

This is merely a representative value useful, for example, for

1687

2078

determining the initial size for a window. Actual characters in

1688

2079

text will be wider and narrower than this.</p>

1689

2080

2081

<a name="id-1.2.4.16.45.5"></a><h4>Parameters</h4>

2082

1690

2083

1691

1692

<col>

2084

2085

2086

1693

2087

</colgroup>

1694

<tbody>

1695

<tr>

1696

<td><p><span class="term"><em class="parameter"><code>metrics</code></em> :</span></p></td>

1697

<td>a <a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure</td>

1698

</tr>

1699

<tr>

1700

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

1701

<td>the character width, in Pango units.</td>

1702

</tr>

1703

</tbody>

2088

2089

<td class="parameter_name"><p>metrics</p></td>

2090

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure</p></td>

2091

2092

</tr></tbody>

1704

2093

</table></div>

1705

2094

</div>

2095

2096

<a name="id-1.2.4.16.45.6"></a><h4>Returns</h4>

2097

<p> the character width, in Pango units.</p>

2098

<p></p>

2099

</div>

2100

</div>

1706

2101

<hr>

1707

2102

1708

<a name="pango-font-metrics-get-approximate-digit-width"></a><h3>pango_font_metrics_get_approximate_digit_width ()</h3>

1709

<pre class="programlisting"><span class="returnvalue">int</span> pango_font_metrics_get_approximate_digit_width

1710

(<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> *metrics</code></em>);</pre>

1711

<p>

1712

Gets the approximate digit width for a font metrics structure.

2103

<a name="pango-font-metrics-get-approximate-digit-width"></a><h3>pango_font_metrics_get_approximate_digit_width ()</h3>

2104

2105

pango_font_metrics_get_approximate_digit_width

2106

(<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> *metrics</code></em>);</pre>

2107

<p>Gets the approximate digit width for a font metrics structure.

1713

2108

This is merely a representative value useful, for example, for

1714

2109

determining the initial size for a window. Actual digits in

1715

2110

text can be wider or narrower than this, though this value

1716

2111

is generally somewhat more accurate than the result of

1717

<a class="link" href="pango-Fonts.html#pango-font-metrics-get-approximate-char-width" title="pango_font_metrics_get_approximate_char_width ()"><code class="function">pango_font_metrics_get_approximate_char_width()</code></a> for digits.</p>

1718

2112

2113

2114

<a name="id-1.2.4.16.46.5"></a><h4>Parameters</h4>

2115

1719

2116

1720

1721

<col>

2117

2118

2119

1722

2120

</colgroup>

1723

<tbody>

1724

<tr>

1725

<td><p><span class="term"><em class="parameter"><code>metrics</code></em> :</span></p></td>

1726

<td>a <a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure</td>

1727

</tr>

1728

<tr>

1729

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

1730

<td>the digit width, in Pango units.</td>

1731

</tr>

1732

</tbody>

2121

2122

<td class="parameter_name"><p>metrics</p></td>

2123

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure</p></td>

2124

2125

</tr></tbody>

1733

2126

</table></div>

1734

2127

</div>

2128

2129

<a name="id-1.2.4.16.46.6"></a><h4>Returns</h4>

2130

<p> the digit width, in Pango units.</p>

2131

<p></p>

2132

</div>

2133

</div>

1735

2134

<hr>

1736

2135

1737

<a name="pango-font-metrics-get-underline-thickness"></a><h3>pango_font_metrics_get_underline_thickness ()</h3>

1738

<pre class="programlisting"><span class="returnvalue">int</span> pango_font_metrics_get_underline_thickness

1739

(<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> *metrics</code></em>);</pre>

1740

<p>

1741

Gets the suggested thickness to draw for the underline.</p>

1742

2136

<a name="pango-font-metrics-get-underline-thickness"></a><h3>pango_font_metrics_get_underline_thickness ()</h3>

2137

2138

pango_font_metrics_get_underline_thickness

2139

(<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> *metrics</code></em>);</pre>

2140

<p>Gets the suggested thickness to draw for the underline.</p>

2141

2142

<a name="id-1.2.4.16.47.5"></a><h4>Parameters</h4>

2143

1743

2144

1744

1745

<col>

2145

2146

2147

1746

2148

</colgroup>

1747

<tbody>

1748

<tr>

1749

<td><p><span class="term"><em class="parameter"><code>metrics</code></em> :</span></p></td>

1750

<td>a <a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure</td>

1751

</tr>

1752

<tr>

1753

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

1754

<td>the suggested underline thickness, in Pango units.</td>

1755

</tr>

1756

</tbody>

2149

2150

<td class="parameter_name"><p>metrics</p></td>

2151

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure</p></td>

2152

2153

</tr></tbody>

1757

2154

</table></div>

2155

</div>

2156

2157

<a name="id-1.2.4.16.47.6"></a><h4>Returns</h4>

2158

<p> the suggested underline thickness, in Pango units.</p>

2159

<p></p>

2160

</div>

1758

2161

<p class="since">Since 1.6</p>

1759

2162

</div>

1760

2163

<hr>

1761

2164

1762

<a name="pango-font-metrics-get-underline-position"></a><h3>pango_font_metrics_get_underline_position ()</h3>

1763

<pre class="programlisting"><span class="returnvalue">int</span> pango_font_metrics_get_underline_position

1764

(<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> *metrics</code></em>);</pre>

1765

<p>

1766

Gets the suggested position to draw the underline.

2165

<a name="pango-font-metrics-get-underline-position"></a><h3>pango_font_metrics_get_underline_position ()</h3>

2166

2167

pango_font_metrics_get_underline_position

2168

(<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> *metrics</code></em>);</pre>

2169

<p>Gets the suggested position to draw the underline.

1767

2170

The value returned is the distance <span class="emphasis"><em>above</em></span> the

1768

2171

baseline of the top of the underline. Since most fonts have

1769

2172

underline positions beneath the baseline, this value is typically

1770

2173

negative.</p>

1771

1772

1773

1774

<col>

1775

</colgroup>

1776

<tbody>

1777

<tr>

1778

<td><p><span class="term"><em class="parameter"><code>metrics</code></em> :</span></p></td>

1779

<td>a <a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure</td>

1780

</tr>

1781

<tr>

1782

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

1783

<td>the suggested underline position, in Pango units.</td>

1784

</tr>

1785

</tbody>

1786

</table></div>

1787

<p class="since">Since 1.6</p>

1788

</div>

1789

<hr>

1790

1791

<a name="pango-font-metrics-get-strikethrough-thickness"></a><h3>pango_font_metrics_get_strikethrough_thickness ()</h3>

1792

<pre class="programlisting"><span class="returnvalue">int</span> pango_font_metrics_get_strikethrough_thickness

1793

(<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> *metrics</code></em>);</pre>

1794

<p>

1795

Gets the suggested thickness to draw for the strikethrough.</p>

1796

1797

1798

1799

<col>

1800

</colgroup>

1801

<tbody>

1802

<tr>

1803

<td><p><span class="term"><em class="parameter"><code>metrics</code></em> :</span></p></td>

1804

<td>a <a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure</td>

1805

</tr>

1806

<tr>

1807

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

1808

<td>the suggested strikethrough thickness, in Pango units.</td>

1809

</tr>

1810

</tbody>

1811

</table></div>

1812

<p class="since">Since 1.6</p>

1813

</div>

1814

<hr>

1815

1816

<a name="pango-font-metrics-get-strikethrough-position"></a><h3>pango_font_metrics_get_strikethrough_position ()</h3>

1817

<pre class="programlisting"><span class="returnvalue">int</span> pango_font_metrics_get_strikethrough_position

1818

(<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> *metrics</code></em>);</pre>

1819

<p>

1820

Gets the suggested position to draw the strikethrough.

2174

2175

<a name="id-1.2.4.16.48.5"></a><h4>Parameters</h4>

2176

2177

2178

2179

2180

2181

</colgroup>

2182

2183

<td class="parameter_name"><p>metrics</p></td>

2184

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure</p></td>

2185

2186

</tr></tbody>

2187

</table></div>

2188

</div>

2189

2190

<a name="id-1.2.4.16.48.6"></a><h4>Returns</h4>

2191

<p> the suggested underline position, in Pango units.</p>

2192

<p></p>

2193

</div>

2194

<p class="since">Since 1.6</p>

2195

</div>

2196

<hr>

2197

2198

<a name="pango-font-metrics-get-strikethrough-thickness"></a><h3>pango_font_metrics_get_strikethrough_thickness ()</h3>

2199

2200

pango_font_metrics_get_strikethrough_thickness

2201

(<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> *metrics</code></em>);</pre>

2202

<p>Gets the suggested thickness to draw for the strikethrough.</p>

2203

2204

<a name="id-1.2.4.16.49.5"></a><h4>Parameters</h4>

2205

2206

2207

2208

2209

2210

</colgroup>

2211

2212

<td class="parameter_name"><p>metrics</p></td>

2213

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure</p></td>

2214

2215

</tr></tbody>

2216

</table></div>

2217

</div>

2218

2219

<a name="id-1.2.4.16.49.6"></a><h4>Returns</h4>

2220

<p> the suggested strikethrough thickness, in Pango units.</p>

2221

<p></p>

2222

</div>

2223

<p class="since">Since 1.6</p>

2224

</div>

2225

<hr>

2226

2227

<a name="pango-font-metrics-get-strikethrough-position"></a><h3>pango_font_metrics_get_strikethrough_position ()</h3>

2228

2229

pango_font_metrics_get_strikethrough_position

2230

(<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> *metrics</code></em>);</pre>

2231

<p>Gets the suggested position to draw the strikethrough.

1821

2232

The value returned is the distance <span class="emphasis"><em>above</em></span> the

1822

2233

baseline of the top of the strikethrough.</p>

1823

2234

2235

<a name="id-1.2.4.16.50.5"></a><h4>Parameters</h4>

2236

1824

2237

1825

1826

<col>

2238

2239

2240

1827

2241

</colgroup>

1828

<tbody>

1829

<tr>

1830

<td><p><span class="term"><em class="parameter"><code>metrics</code></em> :</span></p></td>

1831

<td>a <a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure</td>

1832

</tr>

1833

<tr>

1834

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

1835

<td>the suggested strikethrough position, in Pango units.</td>

1836

</tr>

1837

</tbody>

2242

2243

<td class="parameter_name"><p>metrics</p></td>

2244

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure</p></td>

2245

2246

</tr></tbody>

1838

2247

</table></div>

2248

</div>

2249

2250

<a name="id-1.2.4.16.50.6"></a><h4>Returns</h4>

2251

<p> the suggested strikethrough position, in Pango units.</p>

2252

<p></p>

2253

</div>

1839

2254

<p class="since">Since 1.6</p>

1840

2255

</div>

1841

2256

<hr>

1842

2257

1843

<a name="PangoFont-struct"></a><h3>PangoFont</h3>

1844

<pre class="programlisting">typedef struct _PangoFont PangoFont;</pre>

1845

<p>

1846

The <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> structure is used to represent

1847

a font in a rendering-system-independent matter.

1848

To create an implementation of a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>,

1849

the rendering-system specific code should allocate

1850

a larger structure that contains a nested

1851

<a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>, fill in the <em class="structfield"><code>klass</code></em> member of

1852

the nested <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> with a pointer to

1853

a appropriate <span class="type">PangoFontClass</span>, then call

1854

<code class="function">pango_font_init()</code> on the structure.</p>

1855

<p>

1856

The <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> structure contains one member

1857

which the implementation fills in.</p>

1858

</div>

1859

<hr>

1860

1861

2258

<a name="PANGO-TYPE-FONT:CAPS"></a><h3>PANGO_TYPE_FONT</h3>

1862

2259

<pre class="programlisting">#define PANGO_TYPE_FONT (pango_font_get_type ())

1863

2260

</pre>

1864

<p>

1865

2261

1866

2262

</div>

1867

2263

<hr>

1868

2264

1869

2265

<a name="PANGO-FONT:CAPS"></a><h3>PANGO_FONT()</h3>

1870

2266

<pre class="programlisting">#define PANGO_FONT(object) (G_TYPE_CHECK_INSTANCE_CAST ((object), PANGO_TYPE_FONT, PangoFont))

1871

2267

</pre>

1872

<p>

1873

Casts a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> to a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.</p>

1874

2268

<p>Casts a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> to a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.</p>

2269

2270

<a name="id-1.2.4.16.52.5"></a><h4>Parameters</h4>

2271

1875

2272

1876

1877

<col>

2273

2274

2275

1878

2276

</colgroup>

1879

2277

1880

<td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>

1881

<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>.</td>

2278

<td class="parameter_name"><p>object</p></td>

2279

<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>.</p></td>

2280

1882

2281

</tr></tbody>

1883

2282

</table></div>

1884

2283

</div>

2284

</div>

1885

2285

<hr>

1886

2286

1887

2287

<a name="PANGO-IS-FONT:CAPS"></a><h3>PANGO_IS_FONT()</h3>

1888

2288

<pre class="programlisting">#define PANGO_IS_FONT(object) (G_TYPE_CHECK_INSTANCE_TYPE ((object), PANGO_TYPE_FONT))

1889

2289

</pre>

1890

2290

2291

<a name="id-1.2.4.16.53.4"></a><h4>Parameters</h4>

2292

1891

2293

1892

1893

<col>

2294

2295

2296

1894

2297

</colgroup>

1895

<tbody>

1896

<tr>

1897

<td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>

1898

<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>.</td>

1899

</tr>

1900

<tr>

1901

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

1902

<td>

1903

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>object</code></em> is a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.</td>

1904

</tr>

1905

</tbody>

2298

2299

<td class="parameter_name"><p>object</p></td>

2300

<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>.</p></td>

2301

2302

</tr></tbody>

1906

2303

</table></div>

1907

2304

</div>

2305

2306

<a name="id-1.2.4.16.53.5"></a><h4>Returns</h4>

2307

<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>object</code></em>

2308

is a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.</p>

2309

<p></p>

2310

</div>

2311

</div>

1908

2312

<hr>

1909

2313

1910

<a name="pango-font-find-shaper"></a><h3>pango_font_find_shaper ()</h3>

1911

<pre class="programlisting"><a class="link" href="PangoEngineShape.html" title="PangoEngineShape"><span class="returnvalue">PangoEngineShape</span></a> * pango_font_find_shaper (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,

1912

<em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> *language</code></em>,

1913

<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> ch</code></em>);</pre>

1914

<p>

1915

Finds the best matching shaper for a font for a particular

2314

<a name="pango-font-find-shaper"></a><h3>pango_font_find_shaper ()</h3>

2315

<pre class="programlisting"><a class="link" href="PangoEngineShape.html" title="PangoEngineShape"><span class="returnvalue">PangoEngineShape</span></a> *

2316

pango_font_find_shaper (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,

2317

<em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> *language</code></em>,

2318

<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> ch</code></em>);</pre>

2319

<p>Finds the best matching shaper for a font for a particular

1916

2320

language tag and character point.</p>

1917

2321

2322

<a name="id-1.2.4.16.54.5"></a><h4>Parameters</h4>

2323

1918

2324

1919

1920

<col>

2325

2326

2327

1921

2328

</colgroup>

1922

2329

<tbody>

1923

2330

<tr>

1924

1925

<td>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>

1926

</td>

1927

</tr>

1928

<tr>

1929

<td><p><span class="term"><em class="parameter"><code>language</code></em> :</span></p></td>

1930

<td>the language tag</td>

1931

</tr>

1932

<tr>

1933

1934

<td>a Unicode character.</td>

1935

</tr>

1936

<tr>

1937

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

1938

<td>the best matching shaper.</td>

2331

2332

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a></p></td>

2333

2334

</tr>

2335

<tr>

2336

<td class="parameter_name"><p>language</p></td>

2337

<td class="parameter_description"><p>the language tag</p></td>

2338

2339

</tr>

2340

<tr>

2341

2342

<td class="parameter_description"><p>a Unicode character.</p></td>

2343

1939

2344

</tr>

1940

2345

</tbody>

1941

2346

</table></div>

1942

2347

</div>

2348

2349

<a name="id-1.2.4.16.54.6"></a><h4>Returns</h4>

2350

<p> the best matching shaper.</p>

2351

<p></p>

2352

</div>

2353

</div>

1943

2354

<hr>

1944

2355

1945

<a name="pango-font-describe"></a><h3>pango_font_describe ()</h3>

1946

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> * pango_font_describe (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>);</pre>

1947

<p>

1948

Returns a description of the font, with font size set in points.

1949

Use <a class="link" href="pango-Fonts.html#pango-font-describe-with-absolute-size" title="pango_font_describe_with_absolute_size ()"><code class="function">pango_font_describe_with_absolute_size()</code></a> if you want the font

2356

<a name="pango-font-describe"></a><h3>pango_font_describe ()</h3>

2357

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> *

2358

pango_font_describe (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>);</pre>

2359

<p>Returns a description of the font, with font size set in points.

2360

1950

2361

size in device units.</p>

1951

2362

2363

<a name="id-1.2.4.16.55.5"></a><h4>Parameters</h4>

2364

1952

2365

1953

1954

<col>

2366

2367

2368

1955

2369

</colgroup>

1956

<tbody>

1957

<tr>

1958

1959

<td>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>

1960

</td>

1961

</tr>

1962

<tr>

1963

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

1964

<td>a newly-allocated <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> object.</td>

1965

</tr>

1966

</tbody>

2370

2371

2372

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a></p></td>

2373

2374

</tr></tbody>

1967

2375

</table></div>

1968

2376

</div>

2377

2378

<a name="id-1.2.4.16.55.6"></a><h4>Returns</h4>

2379

<p> a newly-allocated <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> object.</p>

2380

<p></p>

2381

</div>

2382

</div>

1969

2383

<hr>

1970

2384

1971

<a name="pango-font-describe-with-absolute-size"></a><h3>pango_font_describe_with_absolute_size ()</h3>

1972

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> * pango_font_describe_with_absolute_size

1973

(<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>);</pre>

1974

<p>

1975

Returns a description of the font, with absolute font size set

1976

(in device units). Use <a class="link" href="pango-Fonts.html#pango-font-describe" title="pango_font_describe ()"><code class="function">pango_font_describe()</code></a> if you want the font

2385

<a name="pango-font-describe-with-absolute-size"></a><h3>pango_font_describe_with_absolute_size ()</h3>

2386

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> *

2387

pango_font_describe_with_absolute_size

2388

(<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>);</pre>

2389

<p>Returns a description of the font, with absolute font size set

2390

(in device units). Use <a class="link" href="pango-Fonts.html#pango-font-describe" title="pango_font_describe ()"><code class="function">pango_font_describe()</code></a> if you want the font

1977

2391

size in points.</p>

1978

2392

2393

<a name="id-1.2.4.16.56.5"></a><h4>Parameters</h4>

2394

1979

2395

1980

1981

<col>

2396

2397

2398

1982

2399

</colgroup>

1983

<tbody>

1984

<tr>

1985

1986

<td>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>

1987

</td>

1988

</tr>

1989

<tr>

1990

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

1991

<td>a newly-allocated <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> object.</td>

1992

</tr>

1993

</tbody>

2400

2401

2402

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a></p></td>

2403

2404

</tr></tbody>

1994

2405

</table></div>

2406

</div>

2407

2408

<a name="id-1.2.4.16.56.6"></a><h4>Returns</h4>

2409

<p> a newly-allocated <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> object.</p>

2410

<p></p>

2411

</div>

1995

2412

<p class="since">Since 1.14</p>

1996

2413

</div>

1997

2414

<hr>

1998

2415

1999

<a name="pango-font-get-coverage"></a><h3>pango_font_get_coverage ()</h3>

2000

<pre class="programlisting"><a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage"><span class="returnvalue">PangoCoverage</span></a> * pango_font_get_coverage (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,

2001

<em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> *language</code></em>);</pre>

2002

<p>

2003

Computes the coverage map for a given font and language tag.</p>

2004

2416

<a name="pango-font-get-coverage"></a><h3>pango_font_get_coverage ()</h3>

2417

<pre class="programlisting"><a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage"><span class="returnvalue">PangoCoverage</span></a> *

2418

pango_font_get_coverage (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,

2419

<em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> *language</code></em>);</pre>

2420

<p>Computes the coverage map for a given font and language tag.</p>

2421

2422

<a name="id-1.2.4.16.57.5"></a><h4>Parameters</h4>

2423

2005

2424

2006

2007

<col>

2425

2426

2427

2008

2428

</colgroup>

2009

2429

<tbody>

2010

2430

<tr>

2011

2012

<td>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>

2013

</td>

2014

</tr>

2015

<tr>

2016

<td><p><span class="term"><em class="parameter"><code>language</code></em> :</span></p></td>

2017

<td>the language tag</td>

2018

</tr>

2019

<tr>

2020

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

2021

<td>a newly-allocated <a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage"><span class="type">PangoCoverage</span></a>

2022

object. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>

2023

</td>

2431

2432

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a></p></td>

2433

2434

</tr>

2435

<tr>

2436

<td class="parameter_name"><p>language</p></td>

2437

<td class="parameter_description"><p>the language tag</p></td>

2438

2024

2439

</tr>

2025

2440

</tbody>

2026

2441

</table></div>

2027

2442

</div>

2443

2444

<a name="id-1.2.4.16.57.6"></a><h4>Returns</h4>

2445

<p> a newly-allocated <a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage"><span class="type">PangoCoverage</span></a>

2446

object. </p>

2447

<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>

2448

</div>

2449

</div>

2028

2450

<hr>

2029

2451

2030

<a name="pango-font-get-glyph-extents"></a><h3>pango_font_get_glyph_extents ()</h3>

2031

<pre class="programlisting"><span class="returnvalue">void</span> pango_font_get_glyph_extents (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,

2032

<em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoGlyph" title="PangoGlyph"><span class="type">PangoGlyph</span></a> glyph</code></em>,

2033

<em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoRectangle" title="struct PangoRectangle"><span class="type">PangoRectangle</span></a> *ink_rect</code></em>,

2034

<em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoRectangle" title="struct PangoRectangle"><span class="type">PangoRectangle</span></a> *logical_rect</code></em>);</pre>

2035

<p>

2036

Gets the logical and ink extents of a glyph within a font. The

2452

<a name="pango-font-get-glyph-extents"></a><h3>pango_font_get_glyph_extents ()</h3>

2453

2454

pango_font_get_glyph_extents (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,

2455

<em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoGlyph" title="PangoGlyph"><span class="type">PangoGlyph</span></a> glyph</code></em>,

2456

<em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoRectangle" title="struct PangoRectangle"><span class="type">PangoRectangle</span></a> *ink_rect</code></em>,

2457

<em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoRectangle" title="struct PangoRectangle"><span class="type">PangoRectangle</span></a> *logical_rect</code></em>);</pre>

2458

<p>Gets the logical and ink extents of a glyph within a font. The

2037

2459

coordinate system for each rectangle has its origin at the

2038

2460

base line and horizontal origin of the character with increasing

2039

2461

coordinates extending to the right and down. The macros <a class="link" href="pango-Glyph-Storage.html#PANGO-ASCENT:CAPS" title="PANGO_ASCENT()"><code class="function">PANGO_ASCENT()</code></a>,

2040

2462

<a class="link" href="pango-Glyph-Storage.html#PANGO-DESCENT:CAPS" title="PANGO_DESCENT()"><code class="function">PANGO_DESCENT()</code></a>, <a class="link" href="pango-Glyph-Storage.html#PANGO-LBEARING:CAPS" title="PANGO_LBEARING()"><code class="function">PANGO_LBEARING()</code></a>, and <a class="link" href="pango-Glyph-Storage.html#PANGO-RBEARING:CAPS" title="PANGO_RBEARING()"><code class="function">PANGO_RBEARING()</code></a> can be used to convert

2041

2463

from the extents rectangle to more traditional font metrics. The units

2042

2464

of the rectangles are in 1/PANGO_SCALE of a device unit.</p>

2043

<p>

2044

If <em class="parameter"><code>font</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, this function gracefully sets some sane values in the

2465

2466

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, this function gracefully sets some sane values in the

2045

2467

output variables and returns.</p>

2046

2468

2469

<a name="id-1.2.4.16.58.6"></a><h4>Parameters</h4>

2470

2047

2471

2048

2049

<col>

2472

2473

2474

2050

2475

</colgroup>

2051

2476

<tbody>

2052

2477

<tr>

2053

2054

<td>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>

2055

</td>

2056

</tr>

2057

<tr>

2058

<td><p><span class="term"><em class="parameter"><code>glyph</code></em> :</span></p></td>

2059

<td>the glyph index</td>

2060

</tr>

2061

<tr>

2062

2063

<td>rectangle used to store the extents of the glyph

2064

as drawn or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to indicate that the result is not needed. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>

2065

</td>

2066

</tr>

2067

<tr>

2068

<td><p><span class="term"><em class="parameter"><code>logical_rect</code></em> :</span></p></td>

2069

<td>rectangle used to store the logical extents of

2070

the glyph or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to indicate that the result is not needed. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>

2071

</td>

2478

2479

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a></p></td>

2480

2481

</tr>

2482

<tr>

2483

<td class="parameter_name"><p>glyph</p></td>

2484

<td class="parameter_description"><p>the glyph index</p></td>

2485

2486

</tr>

2487

<tr>

2488

2489

<td class="parameter_description"><p> rectangle used to store the extents of the glyph

2490

as drawn or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to indicate that the result is not needed. </p></td>

2491

2492

</tr>

2493

<tr>

2494

<td class="parameter_name"><p>logical_rect</p></td>

2495

<td class="parameter_description"><p> rectangle used to store the logical extents of

2496

the glyph or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to indicate that the result is not needed. </p></td>

2497

2072

2498

</tr>

2073

2499

</tbody>

2074

2500

</table></div>

2075

2501

</div>

2502

</div>

2076

2503

<hr>

2077

2504

2078

<a name="pango-font-get-metrics"></a><h3>pango_font_get_metrics ()</h3>

2079

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="returnvalue">PangoFontMetrics</span></a> * pango_font_get_metrics (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,

2080

<em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> *language</code></em>);</pre>

2081

<p>

2082

Gets overall metric information for a font. Since the metrics may be

2505

<a name="pango-font-get-metrics"></a><h3>pango_font_get_metrics ()</h3>

2506

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="returnvalue">PangoFontMetrics</span></a> *

2507

pango_font_get_metrics (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,

2508

<em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> *language</code></em>);</pre>

2509

<p>Gets overall metric information for a font. Since the metrics may be

2083

2510

substantially different for different scripts, a language tag can

2084

2511

be provided to indicate that the metrics should be retrieved that

2085

2512

correspond to the script(s) used by that language.</p>

2086

<p>

2087

2513

2514

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, this function gracefully sets some sane values in the

2088

2515

output variables and returns.</p>

2089

2516

2517

<a name="id-1.2.4.16.59.6"></a><h4>Parameters</h4>

2518

2090

2519

2091

2092

<col>

2520

2521

2522

2093

2523

</colgroup>

2094

2524

<tbody>

2095

2525

<tr>

2096

2097

<td>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>

2098

</td>

2099

</tr>

2100

<tr>

2101

<td><p><span class="term"><em class="parameter"><code>language</code></em> :</span></p></td>

2102

<td>language tag used to determine which script to get the metrics

2103

for, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to indicate to get the metrics for the entire font. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>

2104

</td>

2105

</tr>

2106

<tr>

2107

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

2108

<td>a <a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> object. The caller must call <a class="link" href="pango-Fonts.html#pango-font-metrics-unref" title="pango_font_metrics_unref ()"><code class="function">pango_font_metrics_unref()</code></a>

2109

when finished using the object.</td>

2526

2527

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a></p></td>

2528

2529

</tr>

2530

<tr>

2531

<td class="parameter_name"><p>language</p></td>

2532

<td class="parameter_description"><p> language tag used to determine which script to get the metrics

2533

for, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to indicate to get the metrics for the entire font. </p></td>

2534

<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>

2110

2535

</tr>

2111

2536

</tbody>

2112

2537

</table></div>

2113

2538

</div>

2539

2540

<a name="id-1.2.4.16.59.7"></a><h4>Returns</h4>

2541

<p> a <a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> object. The caller must call <a class="link" href="pango-Fonts.html#pango-font-metrics-unref" title="pango_font_metrics_unref ()"><code class="function">pango_font_metrics_unref()</code></a>

2542

when finished using the object.</p>

2543

<p></p>

2544

</div>

2545

</div>

2114

2546

<hr>

2115

2547

2116

<a name="pango-font-get-font-map"></a><h3>pango_font_get_font_map ()</h3>

2117

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontMap"><span class="returnvalue">PangoFontMap</span></a> * pango_font_get_font_map (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>);</pre>

2118

<p>

2119

Gets the font map for which the font was created.</p>

2120

<p>

2121

Note that the font maintains a <em class="firstterm">weak</em> reference

2548

<a name="pango-font-get-font-map"></a><h3>pango_font_get_font_map ()</h3>

2549

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontMap"><span class="returnvalue">PangoFontMap</span></a> *

2550

pango_font_get_font_map (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>);</pre>

2551

<p>Gets the font map for which the font was created.</p>

2552

<p>Note that the font maintains a <em class="firstterm">weak</em> reference

2122

2553

to the font map, so if all references to font map are dropped, the font

2123

2554

map will be finalized even if there are fonts created with the font

2124

2555

map that are still alive. In that case this function will return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.

2125

2556

It is the responsibility of the user to ensure that the font map is kept

2126

2557

alive. In most uses this is not an issue as a <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> holds

2127

2558

a reference to the font map.</p>

2128

2559

2560

<a name="id-1.2.4.16.60.6"></a><h4>Parameters</h4>

2561

2129

2562

2130

2131

<col>

2563

2564

2565

2132

2566

</colgroup>

2133

<tbody>

2134

<tr>

2135

2136

<td>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

2137

</td>

2138

</tr>

2139

<tr>

2140

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

2141

<td>the <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> for the font, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

2142

if <em class="parameter"><code>font</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>

2143

</td>

2144

</tr>

2145

</tbody>

2567

2568

2569

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>

2570

2571

</tr></tbody>

2146

2572

</table></div>

2573

</div>

2574

2575

<a name="id-1.2.4.16.60.7"></a><h4>Returns</h4>

2576

<p> the <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> for the font, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

2577

if <em class="parameter"><code>font</code></em>

2578

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>

2579

<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>

2580

</div>

2147

2581

<p class="since">Since 1.10</p>

2148

2582

</div>

2149

2583

<hr>

2150

2584

2151

<a name="PangoFontFamily-struct"></a><h3>struct PangoFontFamily</h3>

2152

<pre class="programlisting">struct PangoFontFamily;</pre>

2153

<p>

2154

The <a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a> structure is used to represent a family of related

2155

font faces. The faces in a family share a common design, but differ in

2156

slant, weight, width and other aspects.</p>

2157

</div>

2158

<hr>

2159

2160

2585

<a name="PANGO-TYPE-FONT-FAMILY:CAPS"></a><h3>PANGO_TYPE_FONT_FAMILY</h3>

2161

2586

<pre class="programlisting">#define PANGO_TYPE_FONT_FAMILY (pango_font_family_get_type ())

2162

2587

</pre>

2163

<p>

2164

The <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> type for <a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a>.</p>

2588

<p>The <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> type for <a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a>.</p>

2165

2589

</div>

2166

2590

<hr>

2167

2591

2168

2592

<a name="PANGO-FONT-FAMILY:CAPS"></a><h3>PANGO_FONT_FAMILY()</h3>

2169

2593

<pre class="programlisting">#define PANGO_FONT_FAMILY(object) (G_TYPE_CHECK_INSTANCE_CAST ((object), PANGO_TYPE_FONT_FAMILY, PangoFontFamily))

2170

2594

</pre>

2171

<p>

2172

2173

2595

2596

2597

<a name="id-1.2.4.16.62.5"></a><h4>Parameters</h4>

2598

2174

2599

2175

2176

<col>

2600

2601

2602

2177

2603

</colgroup>

2178

2604

2179

<td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>

2180

<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>.</td>

2605

<td class="parameter_name"><p>object</p></td>

2606

<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>.</p></td>

2607

2181

2608

</tr></tbody>

2182

2609

</table></div>

2183

2610

</div>

2611

</div>

2184

2612

<hr>

2185

2613

2186

2614

<a name="PANGO-IS-FONT-FAMILY:CAPS"></a><h3>PANGO_IS_FONT_FAMILY()</h3>

2187

2615

<pre class="programlisting">#define PANGO_IS_FONT_FAMILY(object) (G_TYPE_CHECK_INSTANCE_TYPE ((object), PANGO_TYPE_FONT_FAMILY))

2188

2616

</pre>

2189

2617

2618

<a name="id-1.2.4.16.63.4"></a><h4>Parameters</h4>

2619

2190

2620

2191

2192

<col>

2621

2622

2623

2193

2624

</colgroup>

2194

<tbody>

2195

<tr>

2196

<td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>

2197

<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>.</td>

2198

</tr>

2199

<tr>

2200

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

2201

<td>

2202

2203

</tr>

2204

</tbody>

2625

2626

<td class="parameter_name"><p>object</p></td>

2627

<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>.</p></td>

2628

2629

</tr></tbody>

2205

2630

</table></div>

2206

2631

</div>

2632

2633

<a name="id-1.2.4.16.63.5"></a><h4>Returns</h4>

2634

<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>object</code></em>

2635

is a <a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a>.</p>

2636

<p></p>

2637

</div>

2638

</div>

2207

2639

<hr>

2208

2640

2209

<a name="pango-font-family-get-name"></a><h3>pango_font_family_get_name ()</h3>

2210

<pre class="programlisting">const <span class="returnvalue">char</span> * pango_font_family_get_name (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a> *family</code></em>);</pre>

2211

<p>

2212

Gets the name of the family. The name is unique among all

2641

<a name="pango-font-family-get-name"></a><h3>pango_font_family_get_name ()</h3>

2642

<pre class="programlisting">const <span class="returnvalue">char</span> *

2643

pango_font_family_get_name (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a> *family</code></em>);</pre>

2644

<p>Gets the name of the family. The name is unique among all

2213

2645

fonts for the font backend and can be used in a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

2214

2646

to specify that a face from this family is desired.</p>

2215

2647

2648

<a name="id-1.2.4.16.64.5"></a><h4>Parameters</h4>

2649

2216

2650

2217

2218

<col>

2651

2652

2653

2219

2654

</colgroup>

2220

<tbody>

2221

<tr>

2222

<td><p><span class="term"><em class="parameter"><code>family</code></em> :</span></p></td>

2223

<td>a <a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a>

2224

</td>

2225

</tr>

2226

<tr>

2227

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

2228

<td>the name of the family. This string is owned

2229

by the family object and must not be modified or freed.</td>

2230

</tr>

2231

</tbody>

2655

2656

<td class="parameter_name"><p>family</p></td>

2657

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a></p></td>

2658

2659

</tr></tbody>

2232

2660

</table></div>

2233

2661

</div>

2662

2663

<a name="id-1.2.4.16.64.6"></a><h4>Returns</h4>

2664

<p> the name of the family. This string is owned

2665

by the family object and must not be modified or freed.</p>

2666

<p></p>

2667

</div>

2668

</div>

2234

2669

<hr>

2235

2670

2236

<a name="pango-font-family-is-monospace"></a><h3>pango_font_family_is_monospace ()</h3>

2237

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> pango_font_family_is_monospace (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a> *family</code></em>);</pre>

2238

<p>

2239

A monospace font is a font designed for text display where the the

2671

<a name="pango-font-family-is-monospace"></a><h3>pango_font_family_is_monospace ()</h3>

2672

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>

2673

pango_font_family_is_monospace (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a> *family</code></em>);</pre>

2674

<p>A monospace font is a font designed for text display where the the

2240

2675

characters form a regular grid. For Western languages this would

2241

2676

mean that the advance width of all characters are the same, but

2242

2677

this categorization also includes Asian fonts which include

2243

2678

double-width characters: characters that occupy two grid cells.

2244

2679

<a href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#g-unichar-iswide"><code class="function">g_unichar_iswide()</code></a> returns a result that indicates whether a

2245

2680

character is typically double-width in a monospace font.</p>

2246

<p>

2247

The best way to find out the grid-cell size is to call

2248

<a class="link" href="pango-Fonts.html#pango-font-metrics-get-approximate-digit-width" title="pango_font_metrics_get_approximate_digit_width ()"><code class="function">pango_font_metrics_get_approximate_digit_width()</code></a>, since the results

2249

of <a class="link" href="pango-Fonts.html#pango-font-metrics-get-approximate-char-width" title="pango_font_metrics_get_approximate_char_width ()"><code class="function">pango_font_metrics_get_approximate_char_width()</code></a> may be affected

2681

<p>The best way to find out the grid-cell size is to call

2682

2683

2250

2684

by double-width characters.</p>

2251

2685

2686

<a name="id-1.2.4.16.65.6"></a><h4>Parameters</h4>

2687

2252

2688

2253

2254

<col>

2689

2690

2691

2255

2692

</colgroup>

2256

<tbody>

2257

<tr>

2258

<td><p><span class="term"><em class="parameter"><code>family</code></em> :</span></p></td>

2259

<td>a <a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a>

2260

</td>

2261

</tr>

2262

<tr>

2263

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

2264

<td>

2265

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the family is monospace.</td>

2266

</tr>

2267

</tbody>

2693

2694

<td class="parameter_name"><p>family</p></td>

2695

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a></p></td>

2696

2697

</tr></tbody>

2268

2698

</table></div>

2699

</div>

2700

2701

<a name="id-1.2.4.16.65.7"></a><h4>Returns</h4>

2702

<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the family is monospace.</p>

2703

<p></p>

2704

</div>

2269

2705

<p class="since">Since 1.4</p>

2270

2706

</div>

2271

2707

<hr>

2272

2708

2273

<a name="pango-font-family-list-faces"></a><h3>pango_font_family_list_faces ()</h3>

2274

<pre class="programlisting"><span class="returnvalue">void</span> pango_font_family_list_faces (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a> *family</code></em>,

2275

<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a> ***faces</code></em>,

2276

<em class="parameter"><code><span class="type">int</span> *n_faces</code></em>);</pre>

2277

<p>

2278

Lists the different font faces that make up <em class="parameter"><code>family</code></em>. The faces

2709

<a name="pango-font-family-list-faces"></a><h3>pango_font_family_list_faces ()</h3>

2710

2711

pango_font_family_list_faces (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a> *family</code></em>,

2712

<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a> ***faces</code></em>,

2713

<em class="parameter"><code><span class="type">int</span> *n_faces</code></em>);</pre>

2714

<p>Lists the different font faces that make up <em class="parameter"><code>family</code></em>

2715

. The faces

2279

2716

in a family share a common design, but differ in slant, weight,

2280

2717

width and other aspects.</p>

2281

2718

2719

<a name="id-1.2.4.16.66.5"></a><h4>Parameters</h4>

2720

2282

2721

2283

2284

<col>

2722

2723

2724

2285

2725

</colgroup>

2286

2726

<tbody>

2287

2727

<tr>

2288

<td><p><span class="term"><em class="parameter"><code>family</code></em> :</span></p></td>

2289

<td>a <a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a>

2290

</td>

2728

<td class="parameter_name"><p>family</p></td>

2729

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a></p></td>

2730

2291

2731

</tr>

2292

2732

<tr>

2293

<td><p><span class="term"><em class="parameter"><code>faces</code></em> :</span></p></td>

2294

<td>location to store an array of pointers to <a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a> objects,

2733

<td class="parameter_name"><p>faces</p></td>

2734

<td class="parameter_description"><p> location to store an array of pointers to <a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a> objects,

2295

2735

or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. This array should be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when it is no

2296

longer needed. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_faces][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span>

2297

</td>

2736

longer needed. </p></td>

2737

<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_faces][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span></td>

2298

2738

</tr>

2299

2739

<tr>

2300

<td><p><span class="term"><em class="parameter"><code>n_faces</code></em> :</span></p></td>

2301

<td>location to store number of elements in <em class="parameter"><code>faces</code></em>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>

2302

</td>

2740

<td class="parameter_name"><p>n_faces</p></td>

2741

<td class="parameter_description"><p> location to store number of elements in <em class="parameter"><code>faces</code></em>

2742

. </p></td>

2743

2303

2744

</tr>

2304

2745

</tbody>

2305

2746

</table></div>

2306

2747

</div>

2307

<hr>

2308

2309

<a name="PangoFontFace-struct"></a><h3>struct PangoFontFace</h3>

2310

<pre class="programlisting">struct PangoFontFace;</pre>

2311

<p>

2312

The <a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a> structure is used to represent a group of fonts with

2313

the same family, slant, weight, width, but varying sizes.</p>

2314

2748

</div>

2315

2749

<hr>

2316

2750

2317

2751

<a name="PANGO-TYPE-FONT-FACE:CAPS"></a><h3>PANGO_TYPE_FONT_FACE</h3>

2318

2752

<pre class="programlisting">#define PANGO_TYPE_FONT_FACE (pango_font_face_get_type ())

2319

2753

</pre>

2320

<p>

2321

The <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> type for <a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a>.</p>

2754

<p>The <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> type for <a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a>.</p>

2322

2755

</div>

2323

2756

<hr>

2324

2757

2325

2758

<a name="PANGO-FONT-FACE:CAPS"></a><h3>PANGO_FONT_FACE()</h3>

2326

2759

<pre class="programlisting">#define PANGO_FONT_FACE(object) (G_TYPE_CHECK_INSTANCE_CAST ((object), PANGO_TYPE_FONT_FACE, PangoFontFace))

2327

2760

</pre>

2328

<p>

2329

2330

2761

2762

2763

<a name="id-1.2.4.16.68.5"></a><h4>Parameters</h4>

2764

2331

2765

2332

2333

<col>

2766

2767

2768

2334

2769

</colgroup>

2335

2770

2336

<td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>

2337

<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>.</td>

2771

<td class="parameter_name"><p>object</p></td>

2772

<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>.</p></td>

2773

2338

2774

</tr></tbody>

2339

2775

</table></div>

2340

2776

</div>

2777

</div>

2341

2778

<hr>

2342

2779

2343

2780

<a name="PANGO-IS-FONT-FACE:CAPS"></a><h3>PANGO_IS_FONT_FACE()</h3>

2344

2781

<pre class="programlisting">#define PANGO_IS_FONT_FACE(object) (G_TYPE_CHECK_INSTANCE_TYPE ((object), PANGO_TYPE_FONT_FACE))

2345

2782

</pre>

2346

2783

2784

<a name="id-1.2.4.16.69.4"></a><h4>Parameters</h4>

2785

2347

2786

2348

2349

<col>

2787

2788

2789

2350

2790

</colgroup>

2351

<tbody>

2352

<tr>

2353

<td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>

2354

<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>.</td>

2355

</tr>

2356

<tr>

2357

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

2358

<td>

2359

2360

</tr>

2361

</tbody>

2791

2792

<td class="parameter_name"><p>object</p></td>

2793

<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>.</p></td>

2794

2795

</tr></tbody>

2362

2796

</table></div>

2363

2797

</div>

2798

2799

<a name="id-1.2.4.16.69.5"></a><h4>Returns</h4>

2800

<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>object</code></em>

2801

is a <a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a>.</p>

2802

<p></p>

2803

</div>

2804

</div>

2364

2805

<hr>

2365

2806

2366

<a name="pango-font-face-get-face-name"></a><h3>pango_font_face_get_face_name ()</h3>

2367

<pre class="programlisting">const <span class="returnvalue">char</span> * pango_font_face_get_face_name (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a> *face</code></em>);</pre>

2368

<p>

2369

Gets a name representing the style of this face among the

2807

<a name="pango-font-face-get-face-name"></a><h3>pango_font_face_get_face_name ()</h3>

2808

<pre class="programlisting">const <span class="returnvalue">char</span> *

2809

pango_font_face_get_face_name (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a> *face</code></em>);</pre>

2810

<p>Gets a name representing the style of this face among the

2370

2811

different faces in the <a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a> for the face. This

2371

2812

name is unique among all faces in the family and is suitable

2372

2813

for displaying to users.</p>

2373

2814

2815

<a name="id-1.2.4.16.70.5"></a><h4>Parameters</h4>

2816

2374

2817

2375

2376

<col>

2818

2819

2820

2377

2821

</colgroup>

2378

<tbody>

2379

<tr>

2380

2381

<td>a <a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a>.</td>

2382

</tr>

2383

<tr>

2384

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

2385

<td>the face name for the face. This string is

2386

owned by the face object and must not be modified or freed.</td>

2387

</tr>

2388

</tbody>

2822

2823

2824

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a>.</p></td>

2825

2826

</tr></tbody>

2389

2827

</table></div>

2390

2828

</div>

2829

2830

<a name="id-1.2.4.16.70.6"></a><h4>Returns</h4>

2831

<p> the face name for the face. This string is

2832

owned by the face object and must not be modified or freed.</p>

2833

<p></p>

2834

</div>

2835

</div>

2391

2836

<hr>

2392

2837

2393

<a name="pango-font-face-list-sizes"></a><h3>pango_font_face_list_sizes ()</h3>

2394

<pre class="programlisting"><span class="returnvalue">void</span> pango_font_face_list_sizes (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a> *face</code></em>,

2395

<em class="parameter"><code><span class="type">int</span> **sizes</code></em>,

2396

<em class="parameter"><code><span class="type">int</span> *n_sizes</code></em>);</pre>

2397

<p>

2398

List the available sizes for a font. This is only applicable to bitmap

2838

<a name="pango-font-face-list-sizes"></a><h3>pango_font_face_list_sizes ()</h3>

2839

2840

pango_font_face_list_sizes (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a> *face</code></em>,

2841

<em class="parameter"><code><span class="type">int</span> **sizes</code></em>,

2842

<em class="parameter"><code><span class="type">int</span> *n_sizes</code></em>);</pre>

2843

<p>List the available sizes for a font. This is only applicable to bitmap

2399

2844

fonts. For scalable fonts, stores <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> at the location pointed to by

2400

<em class="parameter"><code>sizes</code></em> and 0 at the location pointed to by <em class="parameter"><code>n_sizes</code></em>. The sizes returned

2845

<em class="parameter"><code>sizes</code></em>

2846

and 0 at the location pointed to by <em class="parameter"><code>n_sizes</code></em>

2847

. The sizes returned

2401

2848

are in Pango units and are sorted in ascending order.</p>

2402

2849

2850

<a name="id-1.2.4.16.71.5"></a><h4>Parameters</h4>

2851

2403

2852

2404

2405

<col>

2853

2854

2855

2406

2856

</colgroup>

2407

2857

<tbody>

2408

2858

<tr>

2409

2410

<td>a <a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a>.</td>

2859

2860

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a>.</p></td>

2861

2411

2862

</tr>

2412

2863

<tr>

2413

<td><p><span class="term"><em class="parameter"><code>sizes</code></em> :</span></p></td>

2414

<td>location to store a pointer

2864

<td class="parameter_name"><p>sizes</p></td>

2865

<td class="parameter_description"><p> location to store a pointer

2415

2866

to an array of int. This array should be freed with

2416

<a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_sizes]</span>

2417

</td>

2867

2868

2418

2869

</tr>

2419

2870

<tr>

2420

<td><p><span class="term"><em class="parameter"><code>n_sizes</code></em> :</span></p></td>

2421

<td>location to store the number of elements in <em class="parameter"><code>sizes</code></em>

2422

</td>

2871

<td class="parameter_name"><p>n_sizes</p></td>

2872

<td class="parameter_description"><p>location to store the number of elements in <em class="parameter"><code>sizes</code></em>

2873

</p></td>

2874

2423

2875

</tr>

2424

2876

</tbody>

2425

2877

</table></div>

2878

</div>

2426

2879

<p class="since">Since 1.4</p>

2427

2880

</div>

2428

2881

<hr>

2429

2882

2430

<a name="pango-font-face-describe"></a><h3>pango_font_face_describe ()</h3>

2431

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> * pango_font_face_describe (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a> *face</code></em>);</pre>

2432

<p>

2433

Returns the family, style, variant, weight and stretch of

2883

<a name="pango-font-face-describe"></a><h3>pango_font_face_describe ()</h3>

2884

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> *

2885

pango_font_face_describe (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a> *face</code></em>);</pre>

2886

<p>Returns the family, style, variant, weight and stretch of

2434

2887

a <a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a>. The size field of the resulting font description

2435

2888

will be unset.</p>

2436

2889

2890

<a name="id-1.2.4.16.72.5"></a><h4>Parameters</h4>

2891

2437

2892

2438

2439

<col>

2893

2894

2895

2440

2896

</colgroup>

2441

<tbody>

2442

<tr>

2443

2444

<td>a <a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a>

2445

</td>

2446

</tr>

2447

<tr>

2448

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

2449

<td>a newly-created <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> structure

2450

holding the description of the face. Use <a class="link" href="pango-Fonts.html#pango-font-description-free" title="pango_font_description_free ()"><code class="function">pango_font_description_free()</code></a>

2451

to free the result.</td>

2452

</tr>

2453

</tbody>

2897

2898

2899

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a></p></td>

2900

2901

</tr></tbody>

2454

2902

</table></div>

2455

2903

</div>

2904

2905

<a name="id-1.2.4.16.72.6"></a><h4>Returns</h4>

2906

<p> a newly-created <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> structure

2907

2908

to free the result.</p>

2909

<p></p>

2910

</div>

2911

</div>

2456

2912

<hr>

2457

2913

2458

<a name="pango-font-face-is-synthesized"></a><h3>pango_font_face_is_synthesized ()</h3>

2459

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> pango_font_face_is_synthesized (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a> *face</code></em>);</pre>

2460

<p>

2461

Returns whether a <a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a> is synthesized by the underlying

2914

<a name="pango-font-face-is-synthesized"></a><h3>pango_font_face_is_synthesized ()</h3>

2915

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>

2916

pango_font_face_is_synthesized (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a> *face</code></em>);</pre>

2917

<p>Returns whether a <a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a> is synthesized by the underlying

2462

2918

font rendering engine from another face, perhaps by shearing, emboldening,

2463

2919

or lightening it.</p>

2464

2920

2921

<a name="id-1.2.4.16.73.5"></a><h4>Parameters</h4>

2922

2465

2923

2466

2467

<col>

2924

2925

2926

2468

2927

</colgroup>

2469

<tbody>

2470

<tr>

2471

2472

<td>a <a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a>

2473

</td>

2474

</tr>

2475

<tr>

2476

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

2477

<td>whether <em class="parameter"><code>face</code></em> is synthesized.</td>

2478

</tr>

2479

</tbody>

2928

2929

2930

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a></p></td>

2931

2932

</tr></tbody>

2480

2933

</table></div>

2934

</div>

2935

2936

<a name="id-1.2.4.16.73.6"></a><h4>Returns</h4>

2937

<p> whether <em class="parameter"><code>face</code></em>

2938

is synthesized.</p>

2939

<p></p>

2940

</div>

2481

2941

<p class="since">Since 1.18</p>

2482

2942

</div>

2483

2943

<hr>

2484

2944

2485

<a name="PangoFontMap-struct"></a><h3>PangoFontMap</h3>

2486

<pre class="programlisting">typedef struct _PangoFontMap PangoFontMap;</pre>

2487

<p>

2488

The <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> represents the set of fonts available for a

2489

particular rendering system. This is a virtual object with

2490

implementations being specific to particular rendering systems. To

2491

create an implementation of a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>, the rendering-system

2492

specific code should allocate a larger structure that contains a nested

2493

<a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>, fill in the <em class="structfield"><code>klass</code></em> member of the nested <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> with a

2494

pointer to a appropriate <a class="link" href="pango-Fonts.html#PangoFontMapClass" title="struct PangoFontMapClass"><span class="type">PangoFontMapClass</span></a>, then call

2495

<code class="function">pango_font_map_init()</code> on the structure.</p>

2496

<p>

2497

The <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> structure contains one member which the implementation

2498

fills in.</p>

2499

</div>

2500

<hr>

2501

2502

2945

<a name="PANGO-TYPE-FONT-MAP:CAPS"></a><h3>PANGO_TYPE_FONT_MAP</h3>

2503

2946

<pre class="programlisting">#define PANGO_TYPE_FONT_MAP (pango_font_map_get_type ())

2504

2947

</pre>

2505

<p>

2506

The <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> type for <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>.</p>

2948

<p>The <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> type for <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>.</p>

2507

2949

</div>

2508

2950

<hr>

2509

2951

2510

2952

<a name="PANGO-FONT-MAP:CAPS"></a><h3>PANGO_FONT_MAP()</h3>

2511

2953

<pre class="programlisting">#define PANGO_FONT_MAP(object) (G_TYPE_CHECK_INSTANCE_CAST ((object), PANGO_TYPE_FONT_MAP, PangoFontMap))

2512

2954

</pre>

2513

<p>

2514

2515

2955

2956

2957

<a name="id-1.2.4.16.75.5"></a><h4>Parameters</h4>

2958

2516

2959

2517

2518

<col>

2960

2961

2962

2519

2963

</colgroup>

2520

2964

2521

<td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>

2522

<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>.</td>

2965

<td class="parameter_name"><p>object</p></td>

2966

<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>.</p></td>

2967

2523

2968

</tr></tbody>

2524

2969

</table></div>

2525

2970

</div>

2971

</div>

2526

2972

<hr>

2527

2973

2528

2974

<a name="PANGO-IS-FONT-MAP:CAPS"></a><h3>PANGO_IS_FONT_MAP()</h3>

2529

2975

<pre class="programlisting">#define PANGO_IS_FONT_MAP(object) (G_TYPE_CHECK_INSTANCE_TYPE ((object), PANGO_TYPE_FONT_MAP))

2530

2976

</pre>

2531

2532

2533

2534

<col>

2535

</colgroup>

2536

<tbody>

2537

<tr>

2538

<td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>

2539

<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>.</td>

2540

</tr>

2541

<tr>

2542

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

2543

<td>

2544

2545

</tr>

2546

</tbody>

2547

</table></div>

2548

</div>

2549

<hr>

2550

2551

<a name="PangoFontMapClass"></a><h3>struct PangoFontMapClass</h3>

2552

<pre class="programlisting">struct PangoFontMapClass {

2553

GObjectClass parent_class;

2554

2555

2556

PangoFont * (*load_font) (PangoFontMap *fontmap,

2557

PangoContext *context,

2558

const PangoFontDescription *desc);

2559

void (*list_families) (PangoFontMap *fontmap,

2560

PangoFontFamily ***families,

2561

int *n_families);

2562

PangoFontset *(*load_fontset) (PangoFontMap *fontmap,

2563

PangoContext *context,

2564

const PangoFontDescription *desc,

2565

PangoLanguage *language);

2566

2567

const char *shape_engine_type;

2568

2569

guint (*get_serial) (PangoFontMap *fontmap);

2570

void (*changed) (PangoFontMap *fontmap);

2571

};

2572

</pre>

2573

<p>

2574

The <a class="link" href="pango-Fonts.html#PangoFontMapClass" title="struct PangoFontMapClass"><span class="type">PangoFontMapClass</span></a> structure holds the virtual functions for

2575

a particular <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> implementation.</p>

2576

2577

2578

2579

<col>

2580

</colgroup>

2581

<tbody>

2582

<tr>

2583

<td><p><span class="term"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a> <em class="structfield"><code><a name="PangoFontMapClass.parent-class"></a>parent_class</code></em>;</span></p></td>

2584

<td>parent <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a>.</td>

2585

</tr>

2586

<tr>

2587

2588

<td>a function to load a font with a given description. See

2589

<a class="link" href="pango-Fonts.html#pango-font-map-load-font" title="pango_font_map_load_font ()"><code class="function">pango_font_map_load_font()</code></a>.</td>

2590

</tr>

2591

<tr>

2592

<td><p><span class="term"><em class="structfield"><code><a name="PangoFontMapClass.list-families"></a>list_families</code></em> ()</span></p></td>

2593

<td>A function to list available font families. See

2594

<a class="link" href="pango-Fonts.html#pango-font-map-list-families" title="pango_font_map_list_families ()"><code class="function">pango_font_map_list_families()</code></a>.</td>

2595

</tr>

2596

<tr>

2597

<td><p><span class="term"><em class="structfield"><code><a name="PangoFontMapClass.load-fontset"></a>load_fontset</code></em> ()</span></p></td>

2598

<td>a function to load a fontset with a given given description

2599

suitable for a particular language. See <a class="link" href="pango-Fonts.html#pango-font-map-load-fontset" title="pango_font_map_load_fontset ()"><code class="function">pango_font_map_load_fontset()</code></a>.</td>

2600

</tr>

2601

<tr>

2602

<td><p><span class="term">const <span class="type">char</span> *<em class="structfield"><code><a name="PangoFontMapClass.shape-engine-type"></a>shape_engine_type</code></em>;</span></p></td>

2603

<td>the type of rendering-system-dependent engines that

2604

can handle fonts of this fonts loaded with this fontmap.</td>

2605

</tr>

2606

<tr>

2607

<td><p><span class="term"><em class="structfield"><code><a name="PangoFontMapClass.get-serial"></a>get_serial</code></em> ()</span></p></td>

2608

<td>a function to get the serial number of the fontmap.

2609

See <a class="link" href="pango-Fonts.html#pango-font-map-get-serial" title="pango_font_map_get_serial ()"><code class="function">pango_font_map_get_serial()</code></a>.</td>

2610

</tr>

2611

<tr>

2612

<td><p><span class="term"><em class="structfield"><code><a name="PangoFontMapClass.changed"></a>changed</code></em> ()</span></p></td>

2613

<td>See <a class="link" href="pango-Fonts.html#pango-font-map-changed" title="pango_font_map_changed ()"><code class="function">pango_font_map_changed()</code></a>

2614

</td>

2615

</tr>

2616

</tbody>

2617

</table></div>

2977

2978

<a name="id-1.2.4.16.76.4"></a><h4>Parameters</h4>

2979

2980

2981

2982

2983

2984

</colgroup>

2985

2986

<td class="parameter_name"><p>object</p></td>

2987

<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>.</p></td>

2988

2989

</tr></tbody>

2990

</table></div>

2991

</div>

2992

2993

<a name="id-1.2.4.16.76.5"></a><h4>Returns</h4>

2994

<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>object</code></em>

2995

is a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>.</p>

2996

<p></p>

2997

</div>

2618

2998

</div>

2619

2999

<hr>

2620

3000

2621

3001

<a name="PANGO-FONT-MAP-CLASS:CAPS"></a><h3>PANGO_FONT_MAP_CLASS()</h3>

2622

3002

<pre class="programlisting">#define PANGO_FONT_MAP_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), PANGO_TYPE_FONT_MAP, PangoFontMapClass))

2623

3003

</pre>

2624

<p>

2625

2626

3004

3005

3006

<a name="id-1.2.4.16.77.5"></a><h4>Parameters</h4>

3007

2627

3008

2628

2629

<col>

3009

3010

3011

2630

3012

</colgroup>

2631

3013

2632

<td><p><span class="term"><em class="parameter"><code>klass</code></em> :</span></p></td>

2633

<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>.</td>

3014

<td class="parameter_name"><p>klass</p></td>

3015

<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>.</p></td>

3016

2634

3017

</tr></tbody>

2635

3018

</table></div>

2636

3019

</div>

3020

</div>

2637

3021

<hr>

2638

3022

2639

3023

<a name="PANGO-IS-FONT-MAP-CLASS:CAPS"></a><h3>PANGO_IS_FONT_MAP_CLASS()</h3>

2640

3024

<pre class="programlisting">#define PANGO_IS_FONT_MAP_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), PANGO_TYPE_FONT_MAP))

2641

3025

</pre>

2642

3026

3027

<a name="id-1.2.4.16.78.4"></a><h4>Parameters</h4>

3028

2643

3029

2644

2645

<col>

3030

3031

3032

2646

3033

</colgroup>

2647

<tbody>

2648

<tr>

2649

<td><p><span class="term"><em class="parameter"><code>klass</code></em> :</span></p></td>

2650

<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>.</td>

2651

</tr>

2652

<tr>

2653

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

2654

<td>

2655

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>klass</code></em> is a subtype of <a class="link" href="pango-Fonts.html#PangoFontMapClass" title="struct PangoFontMapClass"><span class="type">PangoFontMapClass</span></a>.</td>

2656

</tr>

2657

</tbody>

3034

3035

<td class="parameter_name"><p>klass</p></td>

3036

<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>.</p></td>

3037

3038

</tr></tbody>

2658

3039

</table></div>

2659

3040

</div>

3041

3042

<a name="id-1.2.4.16.78.5"></a><h4>Returns</h4>

3043

<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>klass</code></em>

3044

is a subtype of <a class="link" href="pango-Fonts.html#PangoFontMapClass" title="struct PangoFontMapClass"><span class="type">PangoFontMapClass</span></a>.</p>

3045

<p></p>

3046

</div>

3047

</div>

2660

3048

<hr>

2661

3049

2662

3050

<a name="PANGO-FONT-MAP-GET-CLASS:CAPS"></a><h3>PANGO_FONT_MAP_GET_CLASS()</h3>

2663

3051

<pre class="programlisting">#define PANGO_FONT_MAP_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), PANGO_TYPE_FONT_MAP, PangoFontMapClass))

2664

3052

</pre>

2665

3053

3054

<a name="id-1.2.4.16.79.4"></a><h4>Parameters</h4>

3055

2666

3056

2667

2668

<col>

3057

3058

3059

2669

3060

</colgroup>

2670

<tbody>

2671

<tr>

2672

2673

<td>a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>.</td>

2674

</tr>

2675

<tr>

2676

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

2677

<td>class of <em class="parameter"><code>obj</code></em>

2678

</td>

2679

</tr>

2680

</tbody>

3061

3062

3063

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>.</p></td>

3064

3065

</tr></tbody>

2681

3066

</table></div>

2682

3067

</div>

3068

3069

<a name="id-1.2.4.16.79.5"></a><h4>Returns</h4>

3070

<p> class of <em class="parameter"><code>obj</code></em>

3071

</p>

3072

<p></p>

3073

</div>

3074

</div>

2683

3075

<hr>

2684

3076

2685

<a name="pango-font-map-create-context"></a><h3>pango_font_map_create_context ()</h3>

2686

<pre class="programlisting"><a class="link" href="pango-Text-Processing.html#PangoContext"><span class="returnvalue">PangoContext</span></a> * pango_font_map_create_context (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> *fontmap</code></em>);</pre>

2687

<p>

2688

Creates a <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> connected to <em class="parameter"><code>fontmap</code></em>. This is equivalent

2689

to <a class="link" href="pango-Text-Processing.html#pango-context-new" title="pango_context_new ()"><code class="function">pango_context_new()</code></a> followed by <a class="link" href="pango-Text-Processing.html#pango-context-set-font-map" title="pango_context_set_font_map ()"><code class="function">pango_context_set_font_map()</code></a>.</p>

2690

<p>

2691

If you are using Pango as part of a higher-level system,

3077

<a name="pango-font-map-create-context"></a><h3>pango_font_map_create_context ()</h3>

3078

<pre class="programlisting"><a class="link" href="pango-Text-Processing.html#PangoContext"><span class="returnvalue">PangoContext</span></a> *

3079

pango_font_map_create_context (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> *fontmap</code></em>);</pre>

3080

<p>Creates a <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> connected to <em class="parameter"><code>fontmap</code></em>

3081

. This is equivalent

3082

3083

<p>If you are using Pango as part of a higher-level system,

2692

3084

that system may have it's own way of create a <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>.

2693

3085

For instance, the GTK+ toolkit has, among others,

2694

<a href="http://library.gnome.org/devel/gdk3/gdk2-Pango-Interaction.html#gdk-pango-context-get-for-screen"><code class="function">gdk_pango_context_get_for_screen()</code></a>, and

2695

<a href="http://library.gnome.org/devel/gtk3/GtkWidget.html#gtk-widget-get-pango-context"><code class="function">gtk_widget_get_pango_context()</code></a>. Use those instead.</p>

2696

3086

<a href="http://developer.gnome.org/gdk2/gdk3-Pango-Interaction.html#gdk-pango-context-get-for-screen"><code class="function">gdk_pango_context_get_for_screen()</code></a>, and

3087

<a href="http://developer.gnome.org/gtk2/GtkWidget.html#gtk-widget-get-pango-context"><code class="function">gtk_widget_get_pango_context()</code></a>. Use those instead.</p>

3088

3089

<a name="id-1.2.4.16.80.6"></a><h4>Parameters</h4>

3090

2697

3091

2698

2699

<col>

3092

3093

3094

2700

3095

</colgroup>

2701

<tbody>

2702

<tr>

2703

<td><p><span class="term"><em class="parameter"><code>fontmap</code></em> :</span></p></td>

2704

<td>a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>

2705

</td>

2706

</tr>

2707

<tr>

2708

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

2709

<td>the newly allocated <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>,

2710

which should be freed with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>

2711

</td>

2712

</tr>

2713

</tbody>

3096

3097

<td class="parameter_name"><p>fontmap</p></td>

3098

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a></p></td>

3099

3100

</tr></tbody>

2714

3101

</table></div>

3102

</div>

3103

3104

<a name="id-1.2.4.16.80.7"></a><h4>Returns</h4>

3105

<p> the newly allocated <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>,

3106

which should be freed with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. </p>

3107

<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>

3108

</div>

2715

3109

<p class="since">Since 1.22</p>

2716

3110

</div>

2717

3111

<hr>

2718

3112

2719

<a name="pango-font-map-load-font"></a><h3>pango_font_map_load_font ()</h3>

2720

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFont"><span class="returnvalue">PangoFont</span></a> * pango_font_map_load_font (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> *fontmap</code></em>,

2721

<em class="parameter"><code><a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> *context</code></em>,

2722

<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);</pre>

2723

<p>

2724

Load the font in the fontmap that is the closest match for <em class="parameter"><code>desc</code></em>.</p>

2725

2726

2727

2728

<col>

2729

</colgroup>

2730

<tbody>

2731

<tr>

2732

<td><p><span class="term"><em class="parameter"><code>fontmap</code></em> :</span></p></td>

2733

<td>a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>

2734

</td>

2735

</tr>

2736

<tr>

2737

<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>

2738

<td>the <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> the font will be used with</td>

2739

</tr>

2740

<tr>

2741

2742

<td>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> describing the font to load</td>

2743

</tr>

2744

<tr>

2745

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

2746

<td>the newly allocated <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> loaded,

2747

or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no font matched. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>

2748

</td>

2749

</tr>

2750

</tbody>

2751

</table></div>

2752

</div>

2753

<hr>

2754

2755

<a name="pango-font-map-load-fontset"></a><h3>pango_font_map_load_fontset ()</h3>

2756

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontset"><span class="returnvalue">PangoFontset</span></a> * pango_font_map_load_fontset (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> *fontmap</code></em>,

2757

<em class="parameter"><code><a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> *context</code></em>,

2758

<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

2759

<em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> *language</code></em>);</pre>

2760

<p>

2761

Load a set of fonts in the fontmap that can be used to render

2762

a font matching <em class="parameter"><code>desc</code></em>.</p>

2763

2764

2765

2766

<col>

2767

</colgroup>

2768

<tbody>

2769

<tr>

2770

<td><p><span class="term"><em class="parameter"><code>fontmap</code></em> :</span></p></td>

2771

<td>a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>

2772

</td>

2773

</tr>

2774

<tr>

2775

<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>

2776

<td>the <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> the font will be used with</td>

2777

</tr>

2778

<tr>

2779

2780

<td>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> describing the font to load</td>

2781

</tr>

2782

<tr>

2783

<td><p><span class="term"><em class="parameter"><code>language</code></em> :</span></p></td>

2784

<td>a <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> the fonts will be used for</td>

2785

</tr>

2786

<tr>

2787

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

2788

<td>the newly allocated <a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a>

2789

loaded, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no font matched. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>

2790

</td>

2791

</tr>

2792

</tbody>

2793

</table></div>

2794

</div>

2795

<hr>

2796

2797

<a name="pango-font-map-list-families"></a><h3>pango_font_map_list_families ()</h3>

2798

<pre class="programlisting"><span class="returnvalue">void</span> pango_font_map_list_families (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> *fontmap</code></em>,

2799

<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a> ***families</code></em>,

2800

<em class="parameter"><code><span class="type">int</span> *n_families</code></em>);</pre>

2801

<p>

2802

List all families for a fontmap.</p>

2803

2804

2805

2806

<col>

2807

</colgroup>

2808

<tbody>

2809

<tr>

2810

<td><p><span class="term"><em class="parameter"><code>fontmap</code></em> :</span></p></td>

2811

<td>a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>

2812

</td>

2813

</tr>

2814

<tr>

2815

<td><p><span class="term"><em class="parameter"><code>families</code></em> :</span></p></td>

2816

<td>location to store a pointer to an array of <a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a> *.

2817

This array should be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_families][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span>

2818

</td>

2819

</tr>

2820

<tr>

2821

<td><p><span class="term"><em class="parameter"><code>n_families</code></em> :</span></p></td>

2822

<td>location to store the number of elements in <em class="parameter"><code>families</code></em>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>

2823

</td>

2824

</tr>

2825

</tbody>

2826

</table></div>

2827

</div>

2828

<hr>

2829

2830

<a name="pango-font-map-get-shape-engine-type"></a><h3>pango_font_map_get_shape_engine_type ()</h3>

2831

<pre class="programlisting">const <span class="returnvalue">char</span> * pango_font_map_get_shape_engine_type

2832

(<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> *fontmap</code></em>);</pre>

2833

<p>

2834

Returns the render ID for shape engines for this fontmap.

3113

<a name="pango-font-map-load-font"></a><h3>pango_font_map_load_font ()</h3>

3114

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFont"><span class="returnvalue">PangoFont</span></a> *

3115

pango_font_map_load_font (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> *fontmap</code></em>,

3116

<em class="parameter"><code><a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> *context</code></em>,

3117

<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);</pre>

3118

<p>Load the font in the fontmap that is the closest match for <em class="parameter"><code>desc</code></em>

3119

.</p>

3120

3121

<a name="id-1.2.4.16.81.5"></a><h4>Parameters</h4>

3122

3123

3124

3125

3126

3127

</colgroup>

3128

<tbody>

3129

<tr>

3130

<td class="parameter_name"><p>fontmap</p></td>

3131

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a></p></td>

3132

3133

</tr>

3134

<tr>

3135

<td class="parameter_name"><p>context</p></td>

3136

<td class="parameter_description"><p>the <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> the font will be used with</p></td>

3137

3138

</tr>

3139

<tr>

3140

3141

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> describing the font to load</p></td>

3142

3143

</tr>

3144

</tbody>

3145

</table></div>

3146

</div>

3147

3148

<a name="id-1.2.4.16.81.6"></a><h4>Returns</h4>

3149

<p> the newly allocated <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> loaded,

3150

or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no font matched. </p>

3151

<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>

3152

</div>

3153

</div>

3154

<hr>

3155

3156

<a name="pango-font-map-load-fontset"></a><h3>pango_font_map_load_fontset ()</h3>

3157

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontset"><span class="returnvalue">PangoFontset</span></a> *

3158

pango_font_map_load_fontset (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> *fontmap</code></em>,

3159

<em class="parameter"><code><a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> *context</code></em>,

3160

<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,

3161

<em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> *language</code></em>);</pre>

3162

<p>Load a set of fonts in the fontmap that can be used to render

3163

a font matching <em class="parameter"><code>desc</code></em>

3164

.</p>

3165

3166

<a name="id-1.2.4.16.82.5"></a><h4>Parameters</h4>

3167

3168

3169

3170

3171

3172

</colgroup>

3173

<tbody>

3174

<tr>

3175

<td class="parameter_name"><p>fontmap</p></td>

3176

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a></p></td>

3177

3178

</tr>

3179

<tr>

3180

<td class="parameter_name"><p>context</p></td>

3181

<td class="parameter_description"><p>the <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> the font will be used with</p></td>

3182

3183

</tr>

3184

<tr>

3185

3186

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> describing the font to load</p></td>

3187

3188

</tr>

3189

<tr>

3190

<td class="parameter_name"><p>language</p></td>

3191

<td class="parameter_description"><p>a <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> the fonts will be used for</p></td>

3192

3193

</tr>

3194

</tbody>

3195

</table></div>

3196

</div>

3197

3198

<a name="id-1.2.4.16.82.6"></a><h4>Returns</h4>

3199

<p> the newly allocated <a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a>

3200

loaded, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no font matched. </p>

3201

<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>

3202

</div>

3203

</div>

3204

<hr>

3205

3206

<a name="pango-font-map-list-families"></a><h3>pango_font_map_list_families ()</h3>

3207

3208

pango_font_map_list_families (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> *fontmap</code></em>,

3209

<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a> ***families</code></em>,

3210

<em class="parameter"><code><span class="type">int</span> *n_families</code></em>);</pre>

3211

<p>List all families for a fontmap.</p>

3212

3213

<a name="id-1.2.4.16.83.5"></a><h4>Parameters</h4>

3214

3215

3216

3217

3218

3219

</colgroup>

3220

<tbody>

3221

<tr>

3222

<td class="parameter_name"><p>fontmap</p></td>

3223

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a></p></td>

3224

3225

</tr>

3226

<tr>

3227

<td class="parameter_name"><p>families</p></td>

3228

<td class="parameter_description"><p> location to store a pointer to an array of <a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a> *.

3229

This array should be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. </p></td>

3230

<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_families][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span></td>

3231

</tr>

3232

<tr>

3233

<td class="parameter_name"><p>n_families</p></td>

3234

<td class="parameter_description"><p> location to store the number of elements in <em class="parameter"><code>families</code></em>

3235

. </p></td>

3236

3237

</tr>

3238

</tbody>

3239

</table></div>

3240

</div>

3241

</div>

3242

<hr>

3243

3244

<a name="pango-font-map-get-shape-engine-type"></a><h3>pango_font_map_get_shape_engine_type ()</h3>

3245

<pre class="programlisting">const <span class="returnvalue">char</span> *

3246

pango_font_map_get_shape_engine_type (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> *fontmap</code></em>);</pre>

3247

<p>Returns the render ID for shape engines for this fontmap.

2835

3248

See the <em class="structfield"><code>render_type</code></em> field of

2836

3249

<a class="link" href="pango-Engines.html#PangoEngineInfo" title="struct PangoEngineInfo"><span class="type">PangoEngineInfo</span></a>.</p>

2837

3250

3251

<a name="id-1.2.4.16.84.5"></a><h4>Parameters</h4>

3252

2838

3253

2839

2840

<col>

3254

3255

3256

2841

3257

</colgroup>

2842

<tbody>

2843

<tr>

2844

<td><p><span class="term"><em class="parameter"><code>fontmap</code></em> :</span></p></td>

2845

<td>a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>

2846

</td>

2847

</tr>

2848

<tr>

2849

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

2850

<td>the ID string for shape engines for

3258

3259

<td class="parameter_name"><p>fontmap</p></td>

3260

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a></p></td>

3261

3262

</tr></tbody>

3263

</table></div>

3264

</div>

3265

3266

<a name="id-1.2.4.16.84.6"></a><h4>Returns</h4>

3267

<p> the ID string for shape engines for

2851

3268

this fontmap. Owned by Pango, should not be modified

2852

or freed.</td>

2853

</tr>

2854

</tbody>

2855

</table></div>

3269

or freed.</p>

3270

<p></p>

3271

</div>

2856

3272

<p class="since">Since 1.4</p>

2857

3273

</div>

2858

3274

<hr>

2859

3275

2860

<a name="pango-font-map-get-serial"></a><h3>pango_font_map_get_serial ()</h3>

2861

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> pango_font_map_get_serial (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> *fontmap</code></em>);</pre>

2862

<p>

2863

Returns the current serial number of <em class="parameter"><code>fontmap</code></em>. The serial number is

3276

<a name="pango-font-map-get-serial"></a><h3>pango_font_map_get_serial ()</h3>

3277

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>

3278

pango_font_map_get_serial (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> *fontmap</code></em>);</pre>

3279

<p>Returns the current serial number of <em class="parameter"><code>fontmap</code></em>

3280

. The serial number is

2864

3281

initialized to an small number larger than zero when a new fontmap

2865

3282

is created and is increased whenever the fontmap is changed. It may

2866

3283

wrap, but will never have the value 0. Since it can wrap, never compare

2867

3284

it with "less than", always use "not equals".</p>

2868

<p>

2869

The fontmap can only be changed using backend-specific API, like changing

3285

<p>The fontmap can only be changed using backend-specific API, like changing

2870

3286

fontmap resolution.</p>

2871

<p>

2872

This can be used to automatically detect changes to a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>, like

3287

<p>This can be used to automatically detect changes to a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>, like

2873

3288

in <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>.</p>

2874

3289

3290

<a name="id-1.2.4.16.85.7"></a><h4>Parameters</h4>

3291

2875

3292

2876

2877

<col>

3293

3294

3295

2878

3296

</colgroup>

2879

<tbody>

2880

<tr>

2881

<td><p><span class="term"><em class="parameter"><code>fontmap</code></em> :</span></p></td>

2882

<td>a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>

2883

</td>

2884

</tr>

2885

<tr>

2886

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

2887

<td>The current serial number of <em class="parameter"><code>fontmap</code></em>.</td>

2888

</tr>

2889

</tbody>

3297

3298

<td class="parameter_name"><p>fontmap</p></td>

3299

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a></p></td>

3300

3301

</tr></tbody>

2890

3302

</table></div>

3303

</div>

3304

3305

<a name="id-1.2.4.16.85.8"></a><h4>Returns</h4>

3306

<p> The current serial number of <em class="parameter"><code>fontmap</code></em>

3307

.</p>

3308

<p></p>

3309

</div>

2891

3310

<p class="since">Since 1.32.4</p>

2892

3311

</div>

2893

3312

<hr>

2894

3313

2895

<a name="pango-font-map-changed"></a><h3>pango_font_map_changed ()</h3>

2896

<pre class="programlisting"><span class="returnvalue">void</span> pango_font_map_changed (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> *fontmap</code></em>);</pre>

2897

<p>

2898

Forces a change in the context, which will cause any <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>

3314

<a name="pango-font-map-changed"></a><h3>pango_font_map_changed ()</h3>

3315

3316

pango_font_map_changed (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> *fontmap</code></em>);</pre>

3317

<p>Forces a change in the context, which will cause any <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>

2899

3318

using this fontmap to change.</p>

2900

<p>

2901

This function is only useful when implementing a new backend

3319

<p>This function is only useful when implementing a new backend

2902

3320

for Pango, something applications won't do. Backends should

2903

3321

call this function if they have attached extra data to the context

2904

3322

and such data is changed.</p>

2905

3323

3324

<a name="id-1.2.4.16.86.6"></a><h4>Parameters</h4>

3325

2906

3326

2907

2908

<col>

3327

3328

3329

2909

3330

</colgroup>

2910

3331

2911

<td><p><span class="term"><em class="parameter"><code>fontmap</code></em> :</span></p></td>

2912

<td>a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>

2913

</td>

3332

<td class="parameter_name"><p>fontmap</p></td>

3333

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a></p></td>

3334

2914

3335

</tr></tbody>

2915

3336

</table></div>

3337

</div>

2916

3338

<p class="since">Since 1.34</p>

2917

3339

</div>

2918

3340

<hr>

2919

3341

3342

<a name="PANGO-TYPE-FONTSET:CAPS"></a><h3>PANGO_TYPE_FONTSET</h3>

3343

<pre class="programlisting">#define PANGO_TYPE_FONTSET (pango_fontset_get_type ())

3344

</pre>

3345

<p>The <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> type for <a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a>.</p>

3346

</div>

3347

<hr>

3348

3349

<a name="pango-fontset-get-font"></a><h3>pango_fontset_get_font ()</h3>

3350

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFont"><span class="returnvalue">PangoFont</span></a> *

3351

pango_fontset_get_font (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a> *fontset</code></em>,

3352

<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> wc</code></em>);</pre>

3353

<p>Returns the font in the fontset that contains the best glyph for the

3354

Unicode character <em class="parameter"><code>wc</code></em>

3355

.</p>

3356

3357

<a name="id-1.2.4.16.88.5"></a><h4>Parameters</h4>

3358

3359

3360

3361

3362

3363

</colgroup>

3364

<tbody>

3365

<tr>

3366

<td class="parameter_name"><p>fontset</p></td>

3367

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a></p></td>

3368

3369

</tr>

3370

<tr>

3371

3372

<td class="parameter_description"><p>a Unicode character</p></td>

3373

3374

</tr>

3375

</tbody>

3376

</table></div>

3377

</div>

3378

3379

<a name="id-1.2.4.16.88.6"></a><h4>Returns</h4>

3380

<p> a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>. The caller must call

3381

g_object_unref when finished with the font. </p>

3382

<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>

3383

</div>

3384

</div>

3385

<hr>

3386

3387

<a name="pango-fontset-get-metrics"></a><h3>pango_fontset_get_metrics ()</h3>

3388

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="returnvalue">PangoFontMetrics</span></a> *

3389

pango_fontset_get_metrics (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a> *fontset</code></em>);</pre>

3390

<p>Get overall metric information for the fonts in the fontset.</p>

3391

3392

<a name="id-1.2.4.16.89.5"></a><h4>Parameters</h4>

3393

3394

3395

3396

3397

3398

</colgroup>

3399

3400

<td class="parameter_name"><p>fontset</p></td>

3401

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a></p></td>

3402

3403

</tr></tbody>

3404

</table></div>

3405

</div>

3406

3407

<a name="id-1.2.4.16.89.6"></a><h4>Returns</h4>

3408

3409

when finished using the object.</p>

3410

<p></p>

3411

</div>

3412

</div>

3413

<hr>

3414

3415

<a name="PangoFontsetForeachFunc"></a><h3>PangoFontsetForeachFunc ()</h3>

3416

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>

3417

<span class="c_punctuation">(</span>*PangoFontsetForeachFunc<span class="c_punctuation">)</span> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a> *fontset</code></em>,

3418

<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,

3419

<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>

3420

<p>A callback function used by <a class="link" href="pango-Fonts.html#pango-fontset-foreach" title="pango_fontset_foreach ()"><code class="function">pango_fontset_foreach()</code></a> when enumerating

3421

the fonts in a fontset.</p>

3422

3423

<a name="id-1.2.4.16.90.5"></a><h4>Parameters</h4>

3424

3425

3426

3427

3428

3429

</colgroup>

3430

<tbody>

3431

<tr>

3432

<td class="parameter_name"><p>fontset</p></td>

3433

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a></p></td>

3434

3435

</tr>

3436

<tr>

3437

3438

<td class="parameter_description"><p>a font from <em class="parameter"><code>fontset</code></em>

3439

</p></td>

3440

3441

</tr>

3442

<tr>

3443

3444

<td class="parameter_description"><p>callback data</p></td>

3445

3446

</tr>

3447

</tbody>

3448

</table></div>

3449

</div>

3450

3451

<a name="id-1.2.4.16.90.6"></a><h4>Returns</h4>

3452

<p> if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, stop iteration and return immediately.</p>

3453

<p></p>

3454

</div>

3455

<p class="since">Since 1.4</p>

3456

</div>

3457

<hr>

3458

3459

<a name="pango-fontset-foreach"></a><h3>pango_fontset_foreach ()</h3>

3460

3461

pango_fontset_foreach (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a> *fontset</code></em>,

3462

<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontsetForeachFunc" title="PangoFontsetForeachFunc ()"><span class="type">PangoFontsetForeachFunc</span></a> func</code></em>,

3463

<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>

3464

<p>Iterates through all the fonts in a fontset, calling <em class="parameter"><code>func</code></em>

3465

for

3466

each one. If <em class="parameter"><code>func</code></em>

3467

returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, that stops the iteration.</p>

3468

3469

<a name="id-1.2.4.16.91.5"></a><h4>Parameters</h4>

3470

3471

3472

3473

3474

3475

</colgroup>

3476

<tbody>

3477

<tr>

3478

<td class="parameter_name"><p>fontset</p></td>

3479

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a></p></td>

3480

3481

</tr>

3482

<tr>

3483

3484

<td class="parameter_description"><p> Callback function. </p></td>

3485

<td class="parameter_annotations"><span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym> data][<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>]</span></td>

3486

</tr>

3487

<tr>

3488

3489

<td class="parameter_description"><p> data to pass to the callback function. </p></td>

3490

3491

</tr>

3492

</tbody>

3493

</table></div>

3494

</div>

3495

<p class="since">Since 1.4</p>

3496

</div>

3497

<hr>

3498

3499

<a name="PANGO-TYPE-FONTSET-SIMPLE:CAPS"></a><h3>PANGO_TYPE_FONTSET_SIMPLE</h3>

3500

<pre class="programlisting">#define PANGO_TYPE_FONTSET_SIMPLE (pango_fontset_simple_get_type ())

3501

</pre>

3502

<p>The <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> type for <a class="link" href="pango-Fonts.html#PangoFontsetSimple"><span class="type">PangoFontsetSimple</span></a>.</p>

3503

</div>

3504

<hr>

3505

3506

<a name="pango-fontset-simple-new"></a><h3>pango_fontset_simple_new ()</h3>

3507

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontsetSimple"><span class="returnvalue">PangoFontsetSimple</span></a> *

3508

pango_fontset_simple_new (<em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> *language</code></em>);</pre>

3509

<p>Creates a new <a class="link" href="pango-Fonts.html#PangoFontsetSimple"><span class="type">PangoFontsetSimple</span></a> for the given language.</p>

3510

3511

<a name="id-1.2.4.16.93.5"></a><h4>Parameters</h4>

3512

3513

3514

3515

3516

3517

</colgroup>

3518

3519

<td class="parameter_name"><p>language</p></td>

3520

<td class="parameter_description"><p>a <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> tag</p></td>

3521

3522

</tr></tbody>

3523

</table></div>

3524

</div>

3525

3526

<a name="id-1.2.4.16.93.6"></a><h4>Returns</h4>

3527

<p> the newly allocated <a class="link" href="pango-Fonts.html#PangoFontsetSimple"><span class="type">PangoFontsetSimple</span></a>, which should

3528

be freed with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</p>

3529

<p></p>

3530

</div>

3531

</div>

3532

<hr>

3533

3534

<a name="pango-fontset-simple-append"></a><h3>pango_fontset_simple_append ()</h3>

3535

3536

pango_fontset_simple_append (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontsetSimple"><span class="type">PangoFontsetSimple</span></a> *fontset</code></em>,

3537

<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>);</pre>

3538

<p>Adds a font to the fontset.</p>

3539

3540

<a name="id-1.2.4.16.94.5"></a><h4>Parameters</h4>

3541

3542

3543

3544

3545

3546

</colgroup>

3547

<tbody>

3548

<tr>

3549

<td class="parameter_name"><p>fontset</p></td>

3550

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontsetSimple"><span class="type">PangoFontsetSimple</span></a>.</p></td>

3551

3552

</tr>

3553

<tr>

3554

3555

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.</p></td>

3556

3557

</tr>

3558

</tbody>

3559

</table></div>

3560

</div>

3561

</div>

3562

<hr>

3563

3564

<a name="pango-fontset-simple-size"></a><h3>pango_fontset_simple_size ()</h3>

3565

3566

pango_fontset_simple_size (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontsetSimple"><span class="type">PangoFontsetSimple</span></a> *fontset</code></em>);</pre>

3567

<p>Returns the number of fonts in the fontset.</p>

3568

3569

<a name="id-1.2.4.16.95.5"></a><h4>Parameters</h4>

3570

3571

3572

3573

3574

3575

</colgroup>

3576

3577

<td class="parameter_name"><p>fontset</p></td>

3578

<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontsetSimple"><span class="type">PangoFontsetSimple</span></a>.</p></td>

3579

3580

</tr></tbody>

3581

</table></div>

3582

</div>

3583

3584

<a name="id-1.2.4.16.95.6"></a><h4>Returns</h4>

3585

<p> the size of <em class="parameter"><code>fontset</code></em>

3586

.</p>

3587

<p></p>

3588

</div>

3589

</div>

3590

</div>

3591

3592

<a name="pango-Fonts.other_details"></a><h2>Types and Values</h2>

3593

3594

<a name="PangoFontDescription-struct"></a><h3>PangoFontDescription</h3>

3595

<pre class="programlisting">typedef struct _PangoFontDescription PangoFontDescription;</pre>

3596

<p>The <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> structure represents the description

3597

of an ideal font. These structures are used both to list

3598

what fonts are available on the system and also for specifying

3599

the characteristics of a font to load.</p>

3600

</div>

3601

<hr>

3602

3603

<a name="PangoStyle"></a><h3>enum PangoStyle</h3>

3604

<p>An enumeration specifying the various slant styles possible for a font.</p>

3605

3606

<a name="id-1.2.4.17.3.4"></a><h4>Members</h4>

3607

3608

3609

3610

3611

3612

</colgroup>

3613

<tbody>

3614

<tr>

3615

<td class="enum_member_name"><p><a name="PANGO-STYLE-NORMAL:CAPS"></a>PANGO_STYLE_NORMAL</p></td>

3616

3617

<p>the font is upright.</p>

3618

</td>

3619

3620

</tr>

3621

<tr>

3622

<td class="enum_member_name"><p><a name="PANGO-STYLE-OBLIQUE:CAPS"></a>PANGO_STYLE_OBLIQUE</p></td>

3623

3624

<p>the font is slanted, but in a roman style.</p>

3625

</td>

3626

3627

</tr>

3628

<tr>

3629

<td class="enum_member_name"><p><a name="PANGO-STYLE-ITALIC:CAPS"></a>PANGO_STYLE_ITALIC</p></td>

3630

3631

<p>the font is slanted in an italic style.</p>

3632

</td>

3633

3634

</tr>

3635

</tbody>

3636

</table></div>

3637

</div>

3638

</div>

3639

<hr>

3640

3641

<a name="PangoWeight"></a><h3>enum PangoWeight</h3>

3642

<p>An enumeration specifying the weight (boldness) of a font. This is a numerical

3643

value ranging from 100 to 900, but there are some predefined values:</p>

3644

3645

<a name="id-1.2.4.17.4.4"></a><h4>Members</h4>

3646

3647

3648

3649

3650

3651

</colgroup>

3652

<tbody>

3653

<tr>

3654

<td class="enum_member_name"><p><a name="PANGO-WEIGHT-THIN:CAPS"></a>PANGO_WEIGHT_THIN</p></td>

3655

3656

<p>the thin weight (= 100; Since: 1.24)</p>

3657

</td>

3658

3659

</tr>

3660

<tr>

3661

<td class="enum_member_name"><p><a name="PANGO-WEIGHT-ULTRALIGHT:CAPS"></a>PANGO_WEIGHT_ULTRALIGHT</p></td>

3662

3663

<p>the ultralight weight (= 200)</p>

3664

</td>

3665

3666

</tr>

3667

<tr>

3668

<td class="enum_member_name"><p><a name="PANGO-WEIGHT-LIGHT:CAPS"></a>PANGO_WEIGHT_LIGHT</p></td>

3669

3670

<p>the light weight (= 300)</p>

3671

</td>

3672

3673

</tr>

3674

<tr>

3675

<td class="enum_member_name"><p><a name="PANGO-WEIGHT-BOOK:CAPS"></a>PANGO_WEIGHT_BOOK</p></td>

3676

3677

<p>the book weight (= 380; Since: 1.24)</p>

3678

</td>

3679

3680

</tr>

3681

<tr>

3682

<td class="enum_member_name"><p><a name="PANGO-WEIGHT-NORMAL:CAPS"></a>PANGO_WEIGHT_NORMAL</p></td>

3683

3684

<p>the default weight (= 400)</p>

3685

</td>

3686

3687

</tr>

3688

<tr>

3689

<td class="enum_member_name"><p><a name="PANGO-WEIGHT-MEDIUM:CAPS"></a>PANGO_WEIGHT_MEDIUM</p></td>

3690

3691

<p>the normal weight (= 500; Since: 1.24)</p>

3692

</td>

3693

3694

</tr>

3695

<tr>

3696

<td class="enum_member_name"><p><a name="PANGO-WEIGHT-SEMIBOLD:CAPS"></a>PANGO_WEIGHT_SEMIBOLD</p></td>

3697

3698

<p>the semibold weight (= 600)</p>

3699

</td>

3700

3701

</tr>

3702

<tr>

3703

<td class="enum_member_name"><p><a name="PANGO-WEIGHT-BOLD:CAPS"></a>PANGO_WEIGHT_BOLD</p></td>

3704

3705

<p>the bold weight (= 700)</p>

3706

</td>

3707

3708

</tr>

3709

<tr>

3710

<td class="enum_member_name"><p><a name="PANGO-WEIGHT-ULTRABOLD:CAPS"></a>PANGO_WEIGHT_ULTRABOLD</p></td>

3711

3712

<p>the ultrabold weight (= 800)</p>

3713

</td>

3714

3715

</tr>

3716

<tr>

3717

<td class="enum_member_name"><p><a name="PANGO-WEIGHT-HEAVY:CAPS"></a>PANGO_WEIGHT_HEAVY</p></td>

3718

3719

<p>the heavy weight (= 900)</p>

3720

</td>

3721

3722

</tr>

3723

<tr>

3724

<td class="enum_member_name"><p><a name="PANGO-WEIGHT-ULTRAHEAVY:CAPS"></a>PANGO_WEIGHT_ULTRAHEAVY</p></td>

3725

3726

<p>the ultraheavy weight (= 1000; Since: 1.24)</p>

3727

</td>

3728

3729

</tr>

3730

</tbody>

3731

</table></div>

3732

</div>

3733

</div>

3734

<hr>

3735

3736

<a name="PangoVariant"></a><h3>enum PangoVariant</h3>

3737

<p>An enumeration specifying capitalization variant of the font.</p>

3738

3739

<a name="id-1.2.4.17.5.4"></a><h4>Members</h4>

3740

3741

3742

3743

3744

3745

</colgroup>

3746

<tbody>

3747

<tr>

3748

<td class="enum_member_name"><p><a name="PANGO-VARIANT-NORMAL:CAPS"></a>PANGO_VARIANT_NORMAL</p></td>

3749

3750

<p>A normal font.</p>

3751

</td>

3752

3753

</tr>

3754

<tr>

3755

<td class="enum_member_name"><p><a name="PANGO-VARIANT-SMALL-CAPS"></a>PANGO_VARIANT_SMALL_CAPS</p></td>

3756

3757

<p>A font with the lower case characters

3758

replaced by smaller variants of the capital characters.</p>

3759

</td>

3760

3761

</tr>

3762

</tbody>

3763

</table></div>

3764

</div>

3765

</div>

3766

<hr>

3767

3768

<a name="PangoStretch"></a><h3>enum PangoStretch</h3>

3769

<p>An enumeration specifying the width of the font relative to other designs

3770

within a family.</p>

3771

3772

<a name="id-1.2.4.17.6.4"></a><h4>Members</h4>

3773

3774

3775

3776

3777

3778

</colgroup>

3779

<tbody>

3780

<tr>

3781

<td class="enum_member_name"><p><a name="PANGO-STRETCH-ULTRA-CONDENSED:CAPS"></a>PANGO_STRETCH_ULTRA_CONDENSED</p></td>

3782

3783

<p>ultra condensed width</p>

3784

</td>

3785

3786

</tr>

3787

<tr>

3788

<td class="enum_member_name"><p><a name="PANGO-STRETCH-EXTRA-CONDENSED:CAPS"></a>PANGO_STRETCH_EXTRA_CONDENSED</p></td>

3789

3790

<p>extra condensed width</p>

3791

</td>

3792

3793

</tr>

3794

<tr>

3795

<td class="enum_member_name"><p><a name="PANGO-STRETCH-CONDENSED:CAPS"></a>PANGO_STRETCH_CONDENSED</p></td>

3796

3797

<p>condensed width</p>

3798

</td>

3799

3800

</tr>

3801

<tr>

3802

<td class="enum_member_name"><p><a name="PANGO-STRETCH-SEMI-CONDENSED:CAPS"></a>PANGO_STRETCH_SEMI_CONDENSED</p></td>

3803

3804

<p>semi condensed width</p>

3805

</td>

3806

3807

</tr>

3808

<tr>

3809

<td class="enum_member_name"><p><a name="PANGO-STRETCH-NORMAL:CAPS"></a>PANGO_STRETCH_NORMAL</p></td>

3810

3811

<p>the normal width</p>

3812

</td>

3813

3814

</tr>

3815

<tr>

3816

<td class="enum_member_name"><p><a name="PANGO-STRETCH-SEMI-EXPANDED:CAPS"></a>PANGO_STRETCH_SEMI_EXPANDED</p></td>

3817

3818

<p>semi expanded width</p>

3819

</td>

3820

3821

</tr>

3822

<tr>

3823

<td class="enum_member_name"><p><a name="PANGO-STRETCH-EXPANDED:CAPS"></a>PANGO_STRETCH_EXPANDED</p></td>

3824

3825

<p>expanded width</p>

3826

</td>

3827

3828

</tr>

3829

<tr>

3830

<td class="enum_member_name"><p><a name="PANGO-STRETCH-EXTRA-EXPANDED:CAPS"></a>PANGO_STRETCH_EXTRA_EXPANDED</p></td>

3831

3832

<p>extra expanded width</p>

3833

</td>

3834

3835

</tr>

3836

<tr>

3837

<td class="enum_member_name"><p><a name="PANGO-STRETCH-ULTRA-EXPANDED:CAPS"></a>PANGO_STRETCH_ULTRA_EXPANDED</p></td>

3838

3839

<p>ultra expanded width</p>

3840

</td>

3841

3842

</tr>

3843

</tbody>

3844

</table></div>

3845

</div>

3846

</div>

3847

<hr>

3848

3849

<a name="PangoFontMask"></a><h3>enum PangoFontMask</h3>

3850

<p>The bits in a <a class="link" href="pango-Fonts.html#PangoFontMask" title="enum PangoFontMask"><span class="type">PangoFontMask</span></a> correspond to fields in a

3851

<a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> that have been set.</p>

3852

3853

<a name="id-1.2.4.17.7.4"></a><h4>Members</h4>

3854

3855

3856

3857

3858

3859

</colgroup>

3860

<tbody>

3861

<tr>

3862

<td class="enum_member_name"><p><a name="PANGO-FONT-MASK-FAMILY:CAPS"></a>PANGO_FONT_MASK_FAMILY</p></td>

3863

3864

<p>the font family is specified.</p>

3865

</td>

3866

3867

</tr>

3868

<tr>

3869

<td class="enum_member_name"><p><a name="PANGO-FONT-MASK-STYLE:CAPS"></a>PANGO_FONT_MASK_STYLE</p></td>

3870

3871

<p>the font style is specified.</p>

3872

</td>

3873

3874

</tr>

3875

<tr>

3876

<td class="enum_member_name"><p><a name="PANGO-FONT-MASK-VARIANT:CAPS"></a>PANGO_FONT_MASK_VARIANT</p></td>

3877

3878

<p>the font variant is specified.</p>

3879

</td>

3880

3881

</tr>

3882

<tr>

3883

<td class="enum_member_name"><p><a name="PANGO-FONT-MASK-WEIGHT:CAPS"></a>PANGO_FONT_MASK_WEIGHT</p></td>

3884

3885

<p>the font weight is specified.</p>

3886

</td>

3887

3888

</tr>

3889

<tr>

3890

<td class="enum_member_name"><p><a name="PANGO-FONT-MASK-STRETCH:CAPS"></a>PANGO_FONT_MASK_STRETCH</p></td>

3891

3892

<p>the font stretch is specified.</p>

3893

</td>

3894

3895

</tr>

3896

<tr>

3897

<td class="enum_member_name"><p><a name="PANGO-FONT-MASK-SIZE:CAPS"></a>PANGO_FONT_MASK_SIZE</p></td>

3898

3899

<p>the font size is specified.</p>

3900

</td>

3901

3902

</tr>

3903

<tr>

3904

<td class="enum_member_name"><p><a name="PANGO-FONT-MASK-GRAVITY:CAPS"></a>PANGO_FONT_MASK_GRAVITY</p></td>

3905

3906

<p>the font gravity is specified (Since: 1.16.)</p>

3907

</td>

3908

3909

</tr>

3910

</tbody>

3911

</table></div>

3912

</div>

3913

</div>

3914

<hr>

3915

3916

<a name="PangoFontMetrics-struct"></a><h3>struct PangoFontMetrics</h3>

3917

<pre class="programlisting">struct PangoFontMetrics {

3918

guint ref_count;

3919

3920

int ascent;

3921

int descent;

3922

int approximate_char_width;

3923

int approximate_digit_width;

3924

int underline_position;

3925

int underline_thickness;

3926

int strikethrough_position;

3927

int strikethrough_thickness;

3928

};

3929

</pre>

3930

<p>A <a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure holds the overall metric information

3931

for a font (possibly restricted to a script). The fields of this

3932

structure are private to implementations of a font backend. See

3933

the documentation of the corresponding getters for documentation

3934

of their meaning.</p>

3935

</div>

3936

<hr>

3937

3938

<a name="PangoFont-struct"></a><h3>PangoFont</h3>

3939

<pre class="programlisting">typedef struct _PangoFont PangoFont;</pre>

3940

<p>The <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> structure is used to represent

3941

a font in a rendering-system-independent matter.

3942

To create an implementation of a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>,

3943

the rendering-system specific code should allocate

3944

a larger structure that contains a nested

3945

<a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>, fill in the <em class="structfield"><code>klass</code></em> member of

3946

the nested <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> with a pointer to

3947

a appropriate <span class="type">PangoFontClass</span>, then call

3948

<code class="function">pango_font_init()</code> on the structure.</p>

3949

<p>The <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> structure contains one member

3950

which the implementation fills in.</p>

3951

</div>

3952

<hr>

3953

3954

<a name="PangoFontFamily-struct"></a><h3>struct PangoFontFamily</h3>

3955

<pre class="programlisting">struct PangoFontFamily;</pre>

3956

<p>The <a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a> structure is used to represent a family of related

3957

font faces. The faces in a family share a common design, but differ in

3958

slant, weight, width and other aspects.</p>

3959

</div>

3960

<hr>

3961

3962

<a name="PangoFontFace-struct"></a><h3>struct PangoFontFace</h3>

3963

<pre class="programlisting">struct PangoFontFace;</pre>

3964

<p>The <a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a> structure is used to represent a group of fonts with

3965

the same family, slant, weight, width, but varying sizes.</p>

3966

</div>

3967

<hr>

3968

3969

<a name="PangoFontMap-struct"></a><h3>PangoFontMap</h3>

3970

<pre class="programlisting">typedef struct _PangoFontMap PangoFontMap;</pre>

3971

<p>The <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> represents the set of fonts available for a

3972

particular rendering system. This is a virtual object with

3973

implementations being specific to particular rendering systems. To

3974

create an implementation of a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>, the rendering-system

3975

specific code should allocate a larger structure that contains a nested

3976

3977

pointer to a appropriate <a class="link" href="pango-Fonts.html#PangoFontMapClass" title="struct PangoFontMapClass"><span class="type">PangoFontMapClass</span></a>, then call

3978

<code class="function">pango_font_map_init()</code> on the structure.</p>

3979

<p>The <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> structure contains one member which the implementation

3980

fills in.</p>

3981

</div>

3982

<hr>

3983

3984

<a name="PangoFontMapClass"></a><h3>struct PangoFontMapClass</h3>

3985

<pre class="programlisting">struct PangoFontMapClass {

3986

GObjectClass parent_class;

3987

3988

3989

PangoFont * (*load_font) (PangoFontMap *fontmap,

3990

PangoContext *context,

3991

const PangoFontDescription *desc);

3992

void (*list_families) (PangoFontMap *fontmap,

3993

PangoFontFamily ***families,

3994

int *n_families);

3995

PangoFontset *(*load_fontset) (PangoFontMap *fontmap,

3996

PangoContext *context,

3997

const PangoFontDescription *desc,

3998

PangoLanguage *language);

3999

4000

const char *shape_engine_type;

4001

4002

guint (*get_serial) (PangoFontMap *fontmap);

4003

void (*changed) (PangoFontMap *fontmap);

4004

};

4005

</pre>

4006

<p>The <a class="link" href="pango-Fonts.html#PangoFontMapClass" title="struct PangoFontMapClass"><span class="type">PangoFontMapClass</span></a> structure holds the virtual functions for

4007

a particular <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> implementation.</p>

4008

4009

<a name="id-1.2.4.17.13.5"></a><h4>Members</h4>

4010

4011

4012

4013

4014

4015

</colgroup>

4016

<tbody>

4017

<tr>

4018

<td class="struct_member_name"><p><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a> <em class="structfield"><code><a name="PangoFontMapClass.parent-class"></a>parent_class</code></em>;</p></td>

4019

<td class="struct_member_description"><p>parent <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a>.</p></td>

4020

4021

</tr>

4022

<tr>

4023

4024

<td class="struct_member_description"><p>a function to load a font with a given description. See

4025

<a class="link" href="pango-Fonts.html#pango-font-map-load-font" title="pango_font_map_load_font ()"><code class="function">pango_font_map_load_font()</code></a>.</p></td>

4026

4027

</tr>

4028

<tr>

4029

<td class="struct_member_name"><p><em class="structfield"><code><a name="PangoFontMapClass.list-families"></a>list_families</code></em> ()</p></td>

4030

<td class="struct_member_description"><p>A function to list available font families. See

4031

<a class="link" href="pango-Fonts.html#pango-font-map-list-families" title="pango_font_map_list_families ()"><code class="function">pango_font_map_list_families()</code></a>.</p></td>

4032

4033

</tr>

4034

<tr>

4035

<td class="struct_member_name"><p><em class="structfield"><code><a name="PangoFontMapClass.load-fontset"></a>load_fontset</code></em> ()</p></td>

4036

<td class="struct_member_description"><p>a function to load a fontset with a given given description

4037

4038

4039

</tr>

4040

<tr>

4041

<td class="struct_member_name"><p>const <span class="type">char</span> *<em class="structfield"><code><a name="PangoFontMapClass.shape-engine-type"></a>shape_engine_type</code></em>;</p></td>

4042

<td class="struct_member_description"><p>the type of rendering-system-dependent engines that

4043

can handle fonts of this fonts loaded with this fontmap.</p></td>

4044

4045

</tr>

4046

<tr>

4047

<td class="struct_member_name"><p><em class="structfield"><code><a name="PangoFontMapClass.get-serial"></a>get_serial</code></em> ()</p></td>

4048

<td class="struct_member_description"><p>a function to get the serial number of the fontmap.

4049

See <a class="link" href="pango-Fonts.html#pango-font-map-get-serial" title="pango_font_map_get_serial ()"><code class="function">pango_font_map_get_serial()</code></a>.</p></td>

4050

4051

</tr>

4052

<tr>

4053

<td class="struct_member_name"><p><em class="structfield"><code><a name="PangoFontMapClass.changed"></a>changed</code></em> ()</p></td>

4054

<td class="struct_member_description"><p>See <a class="link" href="pango-Fonts.html#pango-font-map-changed" title="pango_font_map_changed ()"><code class="function">pango_font_map_changed()</code></a></p></td>

4055

4056

</tr>

4057

</tbody>

4058

</table></div>

4059

</div>

4060

</div>

4061

<hr>

4062

2920

4063

<a name="PangoFontset-struct"></a><h3>struct PangoFontset</h3>

2921

4064

<pre class="programlisting">struct PangoFontset;</pre>

2922

<p>

2923

A <a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a> represents a set of <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> to use

4065

<p>A <a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a> represents a set of <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> to use

2924

4066

when rendering text. It is the result of resolving a

2925

4067

<a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> against a particular <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>.

2926

4068

It has operations for finding the component font for

2929

4071

</div>

2930

4072

<hr>

2931

4073

2932

<a name="PANGO-TYPE-FONTSET:CAPS"></a><h3>PANGO_TYPE_FONTSET</h3>

2933

<pre class="programlisting">#define PANGO_TYPE_FONTSET (pango_fontset_get_type ())

2934

</pre>

2935

<p>

2936

The <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> type for <a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a>.</p>

2937

</div>

2938

<hr>

2939

2940

4074

<a name="PangoFontsetClass"></a><h3>struct PangoFontsetClass</h3>

2941

4075

<pre class="programlisting">struct PangoFontsetClass {

2942

4076

GObjectClass parent_class;

2952

4086

gpointer data);

2953

4087

};

2954

4088

</pre>

2955

<p>

2956

The <a class="link" href="pango-Fonts.html#PangoFontsetClass" title="struct PangoFontsetClass"><span class="type">PangoFontsetClass</span></a> structure holds the virtual functions for

4089

<p>The <a class="link" href="pango-Fonts.html#PangoFontsetClass" title="struct PangoFontsetClass"><span class="type">PangoFontsetClass</span></a> structure holds the virtual functions for

2957

4090

a particular <a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a> implementation.</p>

2958

2959

2960

2961

<col>

2962

</colgroup>

2963

<tbody>

2964

<tr>

2965

<td><p><span class="term"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a> <em class="structfield"><code><a name="PangoFontsetClass.parent-class"></a>parent_class</code></em>;</span></p></td>

2966

<td>parent <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a>.</td>

2967

</tr>

2968

<tr>

2969

2970

<td>a function to get the font in the fontset that contains the

2971

best glyph for the given Unicode character; see <a class="link" href="pango-Fonts.html#pango-fontset-get-font" title="pango_fontset_get_font ()"><code class="function">pango_fontset_get_font()</code></a>.</td>

2972

</tr>

2973

<tr>

2974

<td><p><span class="term"><em class="structfield"><code><a name="PangoFontsetClass.get-metrics"></a>get_metrics</code></em> ()</span></p></td>

2975

<td>a function to get overall metric information for the fonts

2976

in the fontset; see <a class="link" href="pango-Fonts.html#pango-fontset-get-metrics" title="pango_fontset_get_metrics ()"><code class="function">pango_fontset_get_metrics()</code></a>.</td>

2977

</tr>

2978

<tr>

2979

<td><p><span class="term"><em class="structfield"><code><a name="PangoFontsetClass.get-language"></a>get_language</code></em> ()</span></p></td>

2980

<td>a function to get the language of the fontset.</td>

2981

</tr>

2982

<tr>

2983

<td><p><span class="term"><em class="structfield"><code><a name="PangoFontsetClass.foreach"></a>foreach</code></em> ()</span></p></td>

2984

<td>a function to loop over the fonts in the fontset. See

2985

<a class="link" href="pango-Fonts.html#pango-fontset-foreach" title="pango_fontset_foreach ()"><code class="function">pango_fontset_foreach()</code></a>.</td>

2986

</tr>

2987

</tbody>

2988

</table></div>

2989

</div>

2990

<hr>

2991

2992

<a name="pango-fontset-get-font"></a><h3>pango_fontset_get_font ()</h3>

2993

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFont"><span class="returnvalue">PangoFont</span></a> * pango_fontset_get_font (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a> *fontset</code></em>,

2994

<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> wc</code></em>);</pre>

2995

<p>

2996

Returns the font in the fontset that contains the best glyph for the

2997

Unicode character <em class="parameter"><code>wc</code></em>.</p>

2998

2999

3000

3001

<col>

3002

</colgroup>

3003

<tbody>

3004

<tr>

3005

<td><p><span class="term"><em class="parameter"><code>fontset</code></em> :</span></p></td>

3006

<td>a <a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a>

3007

</td>

3008

</tr>

3009

<tr>

3010

3011

<td>a Unicode character</td>

3012

</tr>

3013

<tr>

3014

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

3015

<td>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>. The caller must call

3016

g_object_unref when finished with the font. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>

3017

</td>

3018

</tr>

3019

</tbody>

3020

</table></div>

3021

</div>

3022

<hr>

3023

3024

<a name="pango-fontset-get-metrics"></a><h3>pango_fontset_get_metrics ()</h3>

3025

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="returnvalue">PangoFontMetrics</span></a> * pango_fontset_get_metrics (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a> *fontset</code></em>);</pre>

3026

<p>

3027

Get overall metric information for the fonts in the fontset.</p>

3028

3029

3030

3031

<col>

3032

</colgroup>

3033

<tbody>

3034

<tr>

3035

<td><p><span class="term"><em class="parameter"><code>fontset</code></em> :</span></p></td>

3036

<td>a <a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a>

3037

</td>

3038

</tr>

3039

<tr>

3040

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

3041

3042

when finished using the object.</td>

3043

</tr>

3044

</tbody>

3045

</table></div>

3046

</div>

3047

<hr>

3048

3049

<a name="PangoFontsetForeachFunc"></a><h3>PangoFontsetForeachFunc ()</h3>

3050

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> (*PangoFontsetForeachFunc) (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a> *fontset</code></em>,

3051

<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,

3052

<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>

3053

<p>

3054

A callback function used by <a class="link" href="pango-Fonts.html#pango-fontset-foreach" title="pango_fontset_foreach ()"><code class="function">pango_fontset_foreach()</code></a> when enumerating

3055

the fonts in a fontset.</p>

3056

3057

3058

3059

<col>

3060

</colgroup>

3061

<tbody>

3062

<tr>

3063

<td><p><span class="term"><em class="parameter"><code>fontset</code></em> :</span></p></td>

3064

<td>a <a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a>

3065

</td>

3066

</tr>

3067

<tr>

3068

3069

<td>a font from <em class="parameter"><code>fontset</code></em>

3070

</td>

3071

</tr>

3072

<tr>

3073

3074

<td>callback data</td>

3075

</tr>

3076

<tr>

3077

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

3078

<td>if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, stop iteration and return immediately.</td>

3079

</tr>

3080

</tbody>

3081

</table></div>

3082

<p class="since">Since 1.4</p>

3083

</div>

3084

<hr>

3085

3086

<a name="pango-fontset-foreach"></a><h3>pango_fontset_foreach ()</h3>

3087

<pre class="programlisting"><span class="returnvalue">void</span> pango_fontset_foreach (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a> *fontset</code></em>,

3088

<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontsetForeachFunc" title="PangoFontsetForeachFunc ()"><span class="type">PangoFontsetForeachFunc</span></a> func</code></em>,

3089

<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>

3090

<p>

3091

Iterates through all the fonts in a fontset, calling <em class="parameter"><code>func</code></em> for

3092

each one. If <em class="parameter"><code>func</code></em> returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, that stops the iteration.</p>

3093

3094

3095

3096

<col>

3097

</colgroup>

3098

<tbody>

3099

<tr>

3100

<td><p><span class="term"><em class="parameter"><code>fontset</code></em> :</span></p></td>

3101

<td>a <a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a>

3102

</td>

3103

</tr>

3104

<tr>

3105

3106

<td>Callback function. <span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym> data][<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>]</span>

3107

</td>

3108

</tr>

3109

<tr>

3110

3111

<td>data to pass to the callback function. <span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span>

3112

</td>

3113

</tr>

3114

</tbody>

3115

</table></div>

3116

<p class="since">Since 1.4</p>

4091

4092

<a name="id-1.2.4.17.15.5"></a><h4>Members</h4>

4093

4094

4095

4096

4097

4098

</colgroup>

4099

<tbody>

4100

<tr>

4101

<td class="struct_member_name"><p><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a> <em class="structfield"><code><a name="PangoFontsetClass.parent-class"></a>parent_class</code></em>;</p></td>

4102

4103

4104

</tr>

4105

<tr>

4106

4107

<td class="struct_member_description"><p>a function to get the font in the fontset that contains the

4108

4109

4110

</tr>

4111

<tr>

4112

<td class="struct_member_name"><p><em class="structfield"><code><a name="PangoFontsetClass.get-metrics"></a>get_metrics</code></em> ()</p></td>

4113

<td class="struct_member_description"><p>a function to get overall metric information for the fonts

4114

in the fontset; see <a class="link" href="pango-Fonts.html#pango-fontset-get-metrics" title="pango_fontset_get_metrics ()"><code class="function">pango_fontset_get_metrics()</code></a>.</p></td>

4115

4116

</tr>

4117

<tr>

4118

<td class="struct_member_name"><p><em class="structfield"><code><a name="PangoFontsetClass.get-language"></a>get_language</code></em> ()</p></td>

4119

<td class="struct_member_description"><p>a function to get the language of the fontset.</p></td>

4120

4121

</tr>

4122

<tr>

4123

<td class="struct_member_name"><p><em class="structfield"><code><a name="PangoFontsetClass.foreach"></a>foreach</code></em> ()</p></td>

4124

<td class="struct_member_description"><p>a function to loop over the fonts in the fontset. See

4125

<a class="link" href="pango-Fonts.html#pango-fontset-foreach" title="pango_fontset_foreach ()"><code class="function">pango_fontset_foreach()</code></a>.</p></td>

4126

4127

</tr>

4128

</tbody>

4129

</table></div>

4130

</div>

3117

4131

</div>

3118

4132

<hr>

3119

4133

3120

4134

<a name="PangoFontsetSimple-struct"></a><h3>PangoFontsetSimple</h3>

3121

4135

<pre class="programlisting">typedef struct _PangoFontsetSimple PangoFontsetSimple;</pre>

3122

<p>

3123

<a class="link" href="pango-Fonts.html#PangoFontsetSimple"><span class="type">PangoFontsetSimple</span></a> is a implementation of the abstract

4136

<p><a class="link" href="pango-Fonts.html#PangoFontsetSimple"><span class="type">PangoFontsetSimple</span></a> is a implementation of the abstract

3124

4137

<a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a> base class in terms of an array of fonts,

3125

4138

which the creator provides when constructing the

3126

4139

<a class="link" href="pango-Fonts.html#PangoFontsetSimple"><span class="type">PangoFontsetSimple</span></a>.</p>

3127

4140

</div>

3128

<hr>

3129

3130

<a name="PANGO-TYPE-FONTSET-SIMPLE:CAPS"></a><h3>PANGO_TYPE_FONTSET_SIMPLE</h3>

3131

<pre class="programlisting">#define PANGO_TYPE_FONTSET_SIMPLE (pango_fontset_simple_get_type ())

3132

</pre>

3133

<p>

3134

The <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> type for <a class="link" href="pango-Fonts.html#PangoFontsetSimple"><span class="type">PangoFontsetSimple</span></a>.</p>

3135

</div>

3136

<hr>

3137

3138

<a name="pango-fontset-simple-new"></a><h3>pango_fontset_simple_new ()</h3>

3139

<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontsetSimple"><span class="returnvalue">PangoFontsetSimple</span></a> * pango_fontset_simple_new (<em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> *language</code></em>);</pre>

3140

<p>

3141

Creates a new <a class="link" href="pango-Fonts.html#PangoFontsetSimple"><span class="type">PangoFontsetSimple</span></a> for the given language.</p>

3142

3143

3144

3145

<col>

3146

</colgroup>

3147

<tbody>

3148

<tr>

3149

<td><p><span class="term"><em class="parameter"><code>language</code></em> :</span></p></td>

3150

<td>a <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> tag</td>

3151

</tr>

3152

<tr>

3153

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

3154

<td>the newly allocated <a class="link" href="pango-Fonts.html#PangoFontsetSimple"><span class="type">PangoFontsetSimple</span></a>, which should

3155

be freed with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</td>

3156

</tr>

3157

</tbody>

3158

</table></div>

3159

</div>

3160

<hr>

3161

3162

<a name="pango-fontset-simple-append"></a><h3>pango_fontset_simple_append ()</h3>

3163

<pre class="programlisting"><span class="returnvalue">void</span> pango_fontset_simple_append (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontsetSimple"><span class="type">PangoFontsetSimple</span></a> *fontset</code></em>,

3164

<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>);</pre>

3165

<p>

3166

Adds a font to the fontset.</p>

3167

3168

3169

3170

<col>

3171

</colgroup>

3172

<tbody>

3173

<tr>

3174

<td><p><span class="term"><em class="parameter"><code>fontset</code></em> :</span></p></td>

3175

<td>a <a class="link" href="pango-Fonts.html#PangoFontsetSimple"><span class="type">PangoFontsetSimple</span></a>.</td>

3176

</tr>

3177

<tr>

3178

3179

<td>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.</td>

3180

</tr>

3181

</tbody>

3182

</table></div>

3183

</div>

3184

<hr>

3185

3186

<a name="pango-fontset-simple-size"></a><h3>pango_fontset_simple_size ()</h3>

3187

<pre class="programlisting"><span class="returnvalue">int</span> pango_fontset_simple_size (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontsetSimple"><span class="type">PangoFontsetSimple</span></a> *fontset</code></em>);</pre>

3188

<p>

3189

Returns the number of fonts in the fontset.</p>

3190

3191

3192

3193

<col>

3194

</colgroup>

3195

<tbody>

3196

<tr>

3197

<td><p><span class="term"><em class="parameter"><code>fontset</code></em> :</span></p></td>

3198

<td>a <a class="link" href="pango-Fonts.html#PangoFontsetSimple"><span class="type">PangoFontsetSimple</span></a>.</td>

3199

</tr>

3200

<tr>

3201

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

3202

<td>the size of <em class="parameter"><code>fontset</code></em>.</td>

3203

</tr>

3204

</tbody>

3205

</table></div>

3206

</div>

3207

4141

</div>

3208

4142

</div>

3209

4143

3210

4144

<hr>

3211

Generated by GTK-Doc V1.19.1</div>

4145

Generated by GTK-Doc V1.20.1</div>

3212

4146

</body>

3213

4147

</html>

b'\\ No newline at end of file'

Older »