⚝
One Hat Cyber Team
⚝
Your IP:
216.73.216.96
Server IP:
157.245.101.34
Server:
Linux skvinfotech-website 5.4.0-131-generic #147-Ubuntu SMP Fri Oct 14 17:07:22 UTC 2022 x86_64
Server Software:
Apache/2.4.41 (Ubuntu)
PHP Version:
7.4.33
Buat File
|
Buat Folder
Eksekusi
Dir :
~
/
proc
/
self
/
root
/
usr
/
share
/
gtk-doc
/
html
/
pango
/
View File Name :
pango-Fonts.html
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>Fonts: Pango Reference Manual</title> <meta name="generator" content="DocBook XSL Stylesheets V1.79.1"> <link rel="home" href="index.html" title="Pango Reference Manual"> <link rel="up" href="pango.html" title="Basic Pango Interfaces"> <link rel="prev" href="pango-Text-Processing.html" title="Rendering"> <link rel="next" href="pango-Glyph-Storage.html" title="Glyphs"> <meta name="generator" content="GTK-Doc V1.32 (XML mode)"> <link rel="stylesheet" href="style.css" type="text/css"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle"> <td width="100%" align="left" class="shortcuts"> <a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span> <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> <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td> <td><a accesskey="u" href="pango.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td> <td><a accesskey="p" href="pango-Text-Processing.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td> <td><a accesskey="n" href="pango-Glyph-Storage.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td> </tr></table> <div class="refentry"> <a name="pango-Fonts"></a><div class="titlepage"></div> <div class="refnamediv"><table width="100%"><tr> <td valign="top"> <h2><span class="refentrytitle"><a name="pango-Fonts.top_of_page"></a>Fonts</span></h2> <p>Fonts — Structures representing abstract fonts</p> </td> <td class="gallery_image" valign="top" align="right"></td> </tr></table></div> <div class="refsect1"> <a name="pango-Fonts.functions"></a><h2>Functions</h2> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="functions_proto_type"> <col class="functions_proto_name"> </colgroup> <tbody> <tr> <td class="function_type"> <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> * </td> <td class="function_name"> <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> <td class="function_type"> <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> * </td> <td class="function_name"> <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> <td class="function_type"> <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> * </td> <td class="function_name"> <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> <td class="function_type"> <a href="../glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> </td> <td class="function_name"> <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> <tr> <td class="function_type"> <a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type">const <span class="returnvalue">char</span> * </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <a class="link" href="pango-Fonts.html#PangoStyle" title="enum PangoStyle"><span class="returnvalue">PangoStyle</span></a> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <a class="link" href="pango-Fonts.html#PangoVariant" title="enum PangoVariant"><span class="returnvalue">PangoVariant</span></a> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <a class="link" href="pango-Fonts.html#PangoWeight" title="enum PangoWeight"><span class="returnvalue">PangoWeight</span></a> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <a class="link" href="pango-Fonts.html#PangoStretch" title="enum PangoStretch"><span class="returnvalue">PangoStretch</span></a> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <a class="link" href="pango-Vertical-Text.html#PangoGravity" title="enum PangoGravity"><span class="returnvalue">PangoGravity</span></a> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <a class="link" href="pango-Fonts.html#pango-font-description-set-variations" title="pango_font_description_set_variations ()">pango_font_description_set_variations</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <a class="link" href="pango-Fonts.html#pango-font-description-set-variations-static" title="pango_font_description_set_variations_static ()">pango_font_description_set_variations_static</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type">const <span class="returnvalue">char</span> * </td> <td class="function_name"> <a class="link" href="pango-Fonts.html#pango-font-description-get-variations" title="pango_font_description_get_variations ()">pango_font_description_get_variations</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a class="link" href="pango-Fonts.html#PangoFontMask" title="enum PangoFontMask"><span class="returnvalue">PangoFontMask</span></a> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> * </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">char</span> * </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">char</span> * </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="returnvalue">PangoFontMetrics</span></a> * </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">int</span> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">int</span> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">int</span> </td> <td class="function_name"> <a class="link" href="pango-Fonts.html#pango-font-metrics-get-height" title="pango_font_metrics_get_height ()">pango_font_metrics_get_height</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">int</span> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">int</span> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">int</span> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">int</span> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">int</span> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">int</span> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <a class="link" href="PangoEngineShape.html" title="PangoEngineShape"><span class="returnvalue">PangoEngineShape</span></a> * </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> * </td> <td class="function_name"> <a class="link" href="pango-Fonts.html#pango-font-describe" title="pango_font_describe ()">pango_font_describe</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> * </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <a class="link" href="pango-Coverage-Maps.html#PangoCoverage"><span class="returnvalue">PangoCoverage</span></a> * </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> </td> <td class="function_name"> <a class="link" href="pango-Fonts.html#pango-font-has-char" title="pango_font_has_char ()">pango_font_has_char</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="returnvalue">PangoFontMetrics</span></a> * </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="returnvalue">PangoFontMap</span></a> * </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <a class="link" href="pango-Fonts.html#pango-font-get-features" title="pango_font_get_features ()">pango_font_get_features</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a href="../harfbuzz/harfbuzz-hb-font.html#hb-font-t"><span class="returnvalue">hb_font_t</span></a> * </td> <td class="function_name"> <a class="link" href="pango-Fonts.html#pango-font-get-hb-font" title="pango_font_get_hb_font ()">pango_font_get_hb_font</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type">const <span class="returnvalue">char</span> * </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> </td> <td class="function_name"> <a class="link" href="pango-Fonts.html#pango-font-family-is-variable" title="pango_font_family_is_variable ()">pango_font_family_is_variable</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type">const <span class="returnvalue">char</span> * </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> * </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <a class="link" href="pango-Contexts.html#PangoContext"><span class="returnvalue">PangoContext</span></a> * </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <a class="link" href="pango-Fonts.html#PangoFont"><span class="returnvalue">PangoFont</span></a> * </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <a class="link" href="pango-Fonts.html#PangoFontset"><span class="returnvalue">PangoFontset</span></a> * </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <a href="../glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <a class="link" href="pango-Fonts.html#PangoFont"><span class="returnvalue">PangoFont</span></a> * </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="returnvalue">PangoFontMetrics</span></a> * </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> </td> <td class="function_name"> <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> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <a class="link" href="pango-Fonts.html#pango-fontset-foreach" title="pango_fontset_foreach ()">pango_fontset_foreach</a> <span class="c_punctuation">()</span> </td> </tr> </tbody> </table></div> </div> <a name="PangoFontDescription"></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><div class="refsect1"> <a name="pango-Fonts.other"></a><h2>Types and Values</h2> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="other_proto_type"> <col class="other_proto_name"> </colgroup> <tbody> <tr> <td class="datatype_keyword"> </td> <td class="function_name"><a class="link" href="pango-Fonts.html#PangoFontDescription-struct" title="PangoFontDescription">PangoFontDescription</a></td> </tr> <tr> <td class="datatype_keyword">enum</td> <td class="function_name"><a class="link" href="pango-Fonts.html#PangoStyle" title="enum PangoStyle">PangoStyle</a></td> </tr> <tr> <td class="datatype_keyword">enum</td> <td class="function_name"><a class="link" href="pango-Fonts.html#PangoWeight" title="enum PangoWeight">PangoWeight</a></td> </tr> <tr> <td class="datatype_keyword">enum</td> <td class="function_name"><a class="link" href="pango-Fonts.html#PangoVariant" title="enum PangoVariant">PangoVariant</a></td> </tr> <tr> <td class="datatype_keyword">enum</td> <td class="function_name"><a class="link" href="pango-Fonts.html#PangoStretch" title="enum PangoStretch">PangoStretch</a></td> </tr> <tr> <td class="datatype_keyword">enum</td> <td class="function_name"><a class="link" href="pango-Fonts.html#PangoFontMask" title="enum PangoFontMask">PangoFontMask</a></td> </tr> <tr> <td class="datatype_keyword">struct</td> <td class="function_name"><a class="link" href="pango-Fonts.html#PangoFontMetrics-struct" title="struct PangoFontMetrics">PangoFontMetrics</a></td> </tr> <tr> <td class="datatype_keyword"> </td> <td class="function_name"><a class="link" href="pango-Fonts.html#PangoFont-struct" title="PangoFont">PangoFont</a></td> </tr> <tr> <td class="datatype_keyword">struct</td> <td class="function_name"><a class="link" href="pango-Fonts.html#PangoFontFamily-struct" title="struct PangoFontFamily">PangoFontFamily</a></td> </tr> <tr> <td class="datatype_keyword">struct</td> <td class="function_name"><a class="link" href="pango-Fonts.html#PangoFontFace-struct" title="struct PangoFontFace">PangoFontFace</a></td> </tr> <tr> <td class="datatype_keyword"> </td> <td class="function_name"><a class="link" href="pango-Fonts.html#PangoFontMap-struct" title="PangoFontMap">PangoFontMap</a></td> </tr> <tr> <td class="datatype_keyword">struct</td> <td class="function_name"><a class="link" href="pango-Fonts.html#PangoFontMapClass" title="struct PangoFontMapClass">PangoFontMapClass</a></td> </tr> <tr> <td class="datatype_keyword">struct</td> <td class="function_name"><a class="link" href="pango-Fonts.html#PangoFontset-struct" title="struct PangoFontset">PangoFontset</a></td> </tr> <tr> <td class="datatype_keyword">struct</td> <td class="function_name"><a class="link" href="pango-Fonts.html#PangoFontsetClass" title="struct PangoFontsetClass">PangoFontsetClass</a></td> </tr> </tbody> </table></div> </div> <div class="refsect1"> <a name="pango-Fonts.object-hierarchy"></a><h2>Object Hierarchy</h2> <pre class="screen"> <a href="/usr/share/gtk-doc/html/gobject/gobject-Boxed-Types.html">GBoxed</a> <span class="lineart">├──</span> PangoFontDescription <span class="lineart">╰──</span> PangoFontMetrics <a href="/usr/share/gtk-doc/html/gobject/gobject-Enumeration-and-Flag-Types.html">GEnum</a> <span class="lineart">├──</span> PangoStretch <span class="lineart">├──</span> PangoStyle <span class="lineart">├──</span> PangoVariant <span class="lineart">╰──</span> PangoWeight <a href="/usr/share/gtk-doc/html/gobject/gobject-Enumeration-and-Flag-Types.html">GFlags</a> <span class="lineart">╰──</span> PangoFontMask <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a> <span class="lineart">├──</span> PangoFont <span class="lineart">│</span> <span class="lineart">╰──</span> <a class="link" href="PangoFcFont.html" title="PangoFcFont">PangoFcFont</a> <span class="lineart">├──</span> PangoFontFace <span class="lineart">├──</span> PangoFontFamily <span class="lineart">├──</span> PangoFontMap <span class="lineart">│</span> <span class="lineart">╰──</span> <a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap">PangoFcFontMap</a> <span class="lineart">╰──</span> PangoFontset </pre> </div> <div class="refsect1"> <a name="pango-Fonts.derived-interfaces"></a><h2>Known Derived Interfaces</h2> <p> PangoFont is required by <a class="link" href="pango-Cairo-Rendering.html#PangoCairoFont">PangoCairoFont</a>.</p> <p> PangoFontMap is required by <a class="link" href="pango-Cairo-Rendering.html#PangoCairoFontMap">PangoCairoFontMap</a>.</p> </div> <div class="refsect1"> <a name="pango-Fonts.description"></a><h2>Description</h2> <p>Pango supports a flexible architecture where a particular rendering architecture can supply an implementation of fonts. The <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> structure represents an abstract rendering-system-independent font. Pango provides routines to list available fonts, and to load a font matching a given description.</p> </div> <div class="refsect1"> <a name="pango-Fonts.functions_details"></a><h2>Functions</h2> <div class="refsect2"> <a name="pango-font-description-new"></a><h3>pango_font_description_new ()</h3> <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> <p>Creates a new font description structure with all fields unset.</p> <div class="refsect3"> <a name="pango-font-description-new.returns"></a><h4>Returns</h4> <p> the newly allocated <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>, which 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> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-description-copy"></a><h3>pango_font_description_copy ()</h3> <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> <p>Make a copy of a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>.</p> <div class="refsect3"> <a name="pango-font-description-copy.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>desc</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>, may be <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-description-copy.returns"></a><h4>Returns</h4> <p>the newly allocated <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>, which should 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="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>desc</code></em> was <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p> <p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-description-copy-static"></a><h3>pango_font_description_copy_static ()</h3> <pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> * 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> <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 of the family name and other allocated fields. The result can only be used until <em class="parameter"><code>desc</code></em> is modified or freed. This is meant to be used when the copy is only needed temporarily.</p> <div class="refsect3"> <a name="pango-font-description-copy-static.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>desc</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>, may be <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-description-copy-static.returns"></a><h4>Returns</h4> <p>the newly allocated <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>, which should 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="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>desc</code></em> was <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p> <p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-description-hash"></a><h3>pango_font_description_hash ()</h3> <pre class="programlisting"><a href="../glib/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> <p>Computes a hash of a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> structure suitable to be used, for example, as an argument to <a href="../glib/glib-Hash-Tables.html#g-hash-table-new"><code class="function">g_hash_table_new()</code></a>. The hash value is independent of <em class="parameter"><code>desc->mask</code></em> .</p> <div class="refsect3"> <a name="pango-font-description-hash.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>desc</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-description-hash.returns"></a><h4>Returns</h4> <p> the hash value.</p> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-description-equal"></a><h3>pango_font_description_equal ()</h3> <pre class="programlisting"><a href="../glib/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>, <em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc2</code></em>);</pre> <p>Compares two font descriptions for equality. Two font descriptions are considered equal if the fonts they describe are provably identical. This means that their masks do not have to match, as long as other fields are all the same. (Two font descriptions may result in identical fonts being loaded, but still compare <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.)</p> <div class="refsect3"> <a name="pango-font-description-equal.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>desc1</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>desc2</p></td> <td class="parameter_description"><p>another <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-description-equal.returns"></a><h4>Returns</h4> <p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the two font descriptions are identical, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-description-free"></a><h3>pango_font_description_free ()</h3> <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> <p>Frees a font description.</p> <div class="refsect3"> <a name="pango-font-description-free.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>desc</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>, may be <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td> </tr></tbody> </table></div> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-descriptions-free"></a><h3>pango_font_descriptions_free ()</h3> <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>, <em class="parameter"><code><span class="type">int</span> n_descs</code></em>);</pre> <p>Frees an array of font descriptions.</p> <div class="refsect3"> <a name="pango-font-descriptions-free.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>descs</p></td> <td class="parameter_description"><p>a pointer to an array of <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>, may be <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> <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> </tr> <tr> <td class="parameter_name"><p>n_descs</p></td> <td class="parameter_description"><p>number of font descriptions in <em class="parameter"><code>descs</code></em> </p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-description-set-family"></a><h3>pango_font_description_set_family ()</h3> <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>, <em class="parameter"><code>const <span class="type">char</span> *family</code></em>);</pre> <p>Sets the family name field of a font description. The family name represents a family of related font styles, and will resolve to a particular <a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a>. In some uses of <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>, it is also possible to use a comma separated list of family names for this field.</p> <div class="refsect3"> <a name="pango-font-description-set-family.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>desc</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>family</p></td> <td class="parameter_description"><p>a string representing the family name.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-description-set-family-static"></a><h3>pango_font_description_set_family_static ()</h3> <pre class="programlisting"><span class="returnvalue">void</span> pango_font_description_set_family_static (<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>);</pre> <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 copy of <em class="parameter"><code>family</code></em> is made. The caller must make sure that the string passed in stays around until <em class="parameter"><code>desc</code></em> has been freed or the name is set again. This function can be used if <em class="parameter"><code>family</code></em> is a static string such as a C string literal, or if <em class="parameter"><code>desc</code></em> is only needed temporarily.</p> <div class="refsect3"> <a name="pango-font-description-set-family-static.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>desc</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>family</p></td> <td class="parameter_description"><p>a string representing the family name.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-description-get-family"></a><h3>pango_font_description_get_family ()</h3> <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> <p>Gets the family name field of a font description. See <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> <div class="refsect3"> <a name="pango-font-description-get-family.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>desc</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>.</p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-description-get-family.returns"></a><h4>Returns</h4> <p>the family name field for the font description, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not previously set. This has the same life-time as the font description itself and should not be freed. </p> <p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-description-set-style"></a><h3>pango_font_description_set_style ()</h3> <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>, <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> <p>Sets the style field of a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>. The <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 the manner in which it is slanted; it can be either <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>. Most fonts will either have a italic style or an oblique style, but not both, and font matching in Pango will match italic specifications with oblique fonts and vice-versa if an exact match is not found.</p> <div class="refsect3"> <a name="pango-font-description-set-style.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>desc</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>style</p></td> <td class="parameter_description"><p>the style for the font description</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-description-get-style"></a><h3>pango_font_description_get_style ()</h3> <pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoStyle" title="enum 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> <p>Gets the style field of a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>. See <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> <div class="refsect3"> <a name="pango-font-description-get-style.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>desc</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-description-get-style.returns"></a><h4>Returns</h4> <p> the style field for the font description. 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 the field was explicitly set or not.</p> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-description-set-variant"></a><h3>pango_font_description_set_variant ()</h3> <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>, <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> <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> 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> <div class="refsect3"> <a name="pango-font-description-set-variant.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>desc</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>variant</p></td> <td class="parameter_description"><p>the variant type for the font description.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-description-get-variant"></a><h3>pango_font_description_get_variant ()</h3> <pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoVariant" title="enum 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> <p>Gets the variant field of a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>. See <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> <div class="refsect3"> <a name="pango-font-description-get-variant.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>desc</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>.</p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-description-get-variant.returns"></a><h4>Returns</h4> <p> the variant field for the font description. 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 the field was explicitly set or not.</p> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-description-set-weight"></a><h3>pango_font_description_set_weight ()</h3> <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>, <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> <p>Sets the weight field of a font description. The weight field specifies how bold or light the font should be. In addition 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 numeric values are possible.</p> <div class="refsect3"> <a name="pango-font-description-set-weight.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>desc</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>weight</p></td> <td class="parameter_description"><p>the weight for the font description.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-description-get-weight"></a><h3>pango_font_description_get_weight ()</h3> <pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoWeight" title="enum 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> <p>Gets the weight field of a font description. See <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> <div class="refsect3"> <a name="pango-font-description-get-weight.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>desc</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-description-get-weight.returns"></a><h4>Returns</h4> <p> the weight field for the font description. 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 the field was explicitly set or not.</p> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-description-set-stretch"></a><h3>pango_font_description_set_stretch ()</h3> <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>, <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> <p>Sets the stretch field of a font description. The stretch field specifies how narrow or wide the font should be.</p> <div class="refsect3"> <a name="pango-font-description-set-stretch.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>desc</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>stretch</p></td> <td class="parameter_description"><p>the stretch for the font description</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-description-get-stretch"></a><h3>pango_font_description_get_stretch ()</h3> <pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoStretch" title="enum 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> <p>Gets the stretch field of a font description. 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> <div class="refsect3"> <a name="pango-font-description-get-stretch.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>desc</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>.</p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-description-get-stretch.returns"></a><h4>Returns</h4> <p> the stretch field for the font description. 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 the field was explicitly set or not.</p> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-description-set-size"></a><h3>pango_font_description_set_size ()</h3> <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>, <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> size</code></em>);</pre> <p>Sets the size field of a font description in fractional points. This is mutually 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> <div class="refsect3"> <a name="pango-font-description-set-size.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>desc</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>size</p></td> <td class="parameter_description"><p>the size of the font in points, scaled by PANGO_SCALE. (That is, a <em class="parameter"><code>size</code></em> value of 10 * PANGO_SCALE is a 10 point font. The conversion factor between points and device units depends on system configuration and the output device. For screen display, a logical DPI of 96 is common, in which case a 10 point font corresponds to a 10 * (96 / 72) = 13.3 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 a particular size in device units.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-description-get-size"></a><h3>pango_font_description_get_size ()</h3> <pre class="programlisting"><a href="../glib/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> <p>Gets the size field of a font description. 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> <div class="refsect3"> <a name="pango-font-description-get-size.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>desc</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-description-get-size.returns"></a><h4>Returns</h4> <p> the size field for the font description in points or device units. 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> to find out which is the case. Returns 0 if the size field has not previously been set or it has been set to 0 explicitly. 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 the field was explicitly set or not.</p> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-description-set-absolute-size"></a><h3>pango_font_description_set_absolute_size ()</h3> <pre class="programlisting"><span class="returnvalue">void</span> pango_font_description_set_absolute_size (<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>);</pre> <p>Sets the size field of a font description, in device units. This is mutually 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 in points.</p> <div class="refsect3"> <a name="pango-font-description-set-absolute-size.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>desc</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>size</p></td> <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 device unit. For an output backend where a device unit is a pixel, a <em class="parameter"><code>size</code></em> value of 10 * PANGO_SCALE gives a 10 pixel font.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <p class="since">Since: <a class="link" href="api-index-1-8.html#api-index-1.8">1.8</a></p> </div> <hr> <div class="refsect2"> <a name="pango-font-description-get-size-is-absolute"></a><h3>pango_font_description_get_size_is_absolute ()</h3> <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> pango_font_description_get_size_is_absolute (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);</pre> <p>Determines whether the size of the font is in points (not absolute) or device units (absolute). 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> <div class="refsect3"> <a name="pango-font-description-get-size-is-absolute.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>desc</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-description-get-size-is-absolute.returns"></a><h4>Returns</h4> <p> whether the size for the font description is in 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 find out if the size field of the font description was explicitly set or not.</p> </div> <p class="since">Since: <a class="link" href="api-index-1-8.html#api-index-1.8">1.8</a></p> </div> <hr> <div class="refsect2"> <a name="pango-font-description-set-gravity"></a><h3>pango_font_description_set_gravity ()</h3> <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>, <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> <p>Sets the gravity field of a font description. The gravity field specifies how the glyphs should be rotated. If <em class="parameter"><code>gravity</code></em> is <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 the font description.</p> <p>This function is seldom useful to the user. Gravity should normally be set on a <a class="link" href="pango-Contexts.html#PangoContext"><span class="type">PangoContext</span></a>.</p> <div class="refsect3"> <a name="pango-font-description-set-gravity.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>desc</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>gravity</p></td> <td class="parameter_description"><p>the gravity for the font description.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <p class="since">Since: <a class="link" href="api-index-1-16.html#api-index-1.16">1.16</a></p> </div> <hr> <div class="refsect2"> <a name="pango-font-description-get-gravity"></a><h3>pango_font_description_get_gravity ()</h3> <pre class="programlisting"><a class="link" href="pango-Vertical-Text.html#PangoGravity" title="enum 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> <p>Gets the gravity field of a font description. See <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> <div class="refsect3"> <a name="pango-font-description-get-gravity.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>desc</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-description-get-gravity.returns"></a><h4>Returns</h4> <p> the gravity field for the font description. 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 the field was explicitly set or not.</p> </div> <p class="since">Since: <a class="link" href="api-index-1-16.html#api-index-1.16">1.16</a></p> </div> <hr> <div class="refsect2"> <a name="pango-font-description-set-variations"></a><h3>pango_font_description_set_variations ()</h3> <pre class="programlisting"><span class="returnvalue">void</span> pango_font_description_set_variations (<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> *variations</code></em>);</pre> <p>Sets the variations field of a font description. OpenType font variations allow to select a font instance by specifying values for a number of axes, such as width or weight.</p> <p>The format of the variations string is AXIS1=VALUE,AXIS2=VALUE..., with each AXIS a 4 character tag that identifies a font axis, and each VALUE a floating point number. Unknown axes are ignored, and values are clamped to their allowed range.</p> <p>Pango does not currently have a way to find supported axes of a font. Both harfbuzz or freetype have API for this.</p> <div class="refsect3"> <a name="pango-font-description-set-variations.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>desc</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>variations</p></td> <td class="parameter_description"><p>a string representing the variations</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <p class="since">Since: <a class="link" href="api-index-1-42.html#api-index-1.42">1.42</a></p> </div> <hr> <div class="refsect2"> <a name="pango-font-description-set-variations-static"></a><h3>pango_font_description_set_variations_static ()</h3> <pre class="programlisting"><span class="returnvalue">void</span> pango_font_description_set_variations_static (<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> *variations</code></em>);</pre> <p>Like <a class="link" href="pango-Fonts.html#pango-font-description-set-variations" title="pango_font_description_set_variations ()"><code class="function">pango_font_description_set_variations()</code></a>, except that no copy of <em class="parameter"><code>variations</code></em> is made. The caller must make sure that the string passed in stays around until <em class="parameter"><code>desc</code></em> has been freed or the name is set again. This function can be used if <em class="parameter"><code>variations</code></em> is a static string such as a C string literal, or if <em class="parameter"><code>desc</code></em> is only needed temporarily.</p> <div class="refsect3"> <a name="pango-font-description-set-variations-static.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>desc</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>variations</p></td> <td class="parameter_description"><p>a string representing the variations</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <p class="since">Since: <a class="link" href="api-index-1-42.html#api-index-1.42">1.42</a></p> </div> <hr> <div class="refsect2"> <a name="pango-font-description-get-variations"></a><h3>pango_font_description_get_variations ()</h3> <pre class="programlisting">const <span class="returnvalue">char</span> * pango_font_description_get_variations (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);</pre> <p>Gets the variations field of a font description. See <a class="link" href="pango-Fonts.html#pango-font-description-set-variations" title="pango_font_description_set_variations ()"><code class="function">pango_font_description_set_variations()</code></a>.</p> <div class="refsect3"> <a name="pango-font-description-get-variations.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>desc</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-description-get-variations.returns"></a><h4>Returns</h4> <p>the varitions field for the font description, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not previously set. This has the same life-time as the font description itself and should not be freed. </p> <p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p> </div> <p class="since">Since: <a class="link" href="api-index-1-42.html#api-index-1.42">1.42</a></p> </div> <hr> <div class="refsect2"> <a name="pango-font-description-get-set-fields"></a><h3>pango_font_description_get_set_fields ()</h3> <pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontMask" title="enum PangoFontMask"><span class="returnvalue">PangoFontMask</span></a> 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> <p>Determines which fields in a font description have been set.</p> <div class="refsect3"> <a name="pango-font-description-get-set-fields.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>desc</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-description-get-set-fields.returns"></a><h4>Returns</h4> <p> a bitmask with bits set corresponding to the fields in <em class="parameter"><code>desc</code></em> that have been set.</p> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-description-unset-fields"></a><h3>pango_font_description_unset_fields ()</h3> <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>, <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> <p>Unsets some of the fields in a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>. The unset fields will get back to their default values.</p> <div class="refsect3"> <a name="pango-font-description-unset-fields.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>desc</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>to_unset</p></td> <td class="parameter_description"><p>bitmask of fields in the <em class="parameter"><code>desc</code></em> to unset.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-description-merge"></a><h3>pango_font_description_merge ()</h3> <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>, <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="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> replace_existing</code></em>);</pre> <p>Merges the fields that are set in <em class="parameter"><code>desc_to_merge</code></em> into the fields in <em class="parameter"><code>desc</code></em> . If <em class="parameter"><code>replace_existing</code></em> is <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, only fields in <em class="parameter"><code>desc</code></em> that are not already set are affected. If <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, then fields that are already set will be replaced as well.</p> <p>If <em class="parameter"><code>desc_to_merge</code></em> is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, this function performs nothing.</p> <div class="refsect3"> <a name="pango-font-description-merge.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>desc</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>desc_to_merge</p></td> <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="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> <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> </tr> <tr> <td class="parameter_name"><p>replace_existing</p></td> <td class="parameter_description"><p>if <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, replace fields in <em class="parameter"><code>desc</code></em> with the corresponding values from <em class="parameter"><code>desc_to_merge</code></em> , even if they are already exist.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-description-merge-static"></a><h3>pango_font_description_merge_static ()</h3> <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>, <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="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> replace_existing</code></em>);</pre> <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 of the family name and other allocated fields. <em class="parameter"><code>desc</code></em> can only be used until <em class="parameter"><code>desc_to_merge</code></em> is modified or freed. This is meant to be used when the merged font description is only needed temporarily.</p> <div class="refsect3"> <a name="pango-font-description-merge-static.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>desc</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>desc_to_merge</p></td> <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> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>replace_existing</p></td> <td class="parameter_description"><p>if <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, replace fields in <em class="parameter"><code>desc</code></em> with the corresponding values from <em class="parameter"><code>desc_to_merge</code></em> , even if they are already exist.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-description-better-match"></a><h3>pango_font_description_better_match ()</h3> <pre class="programlisting"><a href="../glib/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>, <em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *old_match</code></em>, <em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *new_match</code></em>);</pre> <p>Determines if the style attributes of <em class="parameter"><code>new_match</code></em> are a closer match 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="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, determines if <em class="parameter"><code>new_match</code></em> is a match at all. Approximate matching is done for weight and style; other style attributes must match exactly. Style attributes are all attributes other than family and size-related attributes. Approximate matching for style considers PANGO_STYLE_OBLIQUE and PANGO_STYLE_ITALIC as matches, but not as good a match as when the styles are equal.</p> <p>Note that <em class="parameter"><code>old_match</code></em> must match <em class="parameter"><code>desc</code></em> .</p> <div class="refsect3"> <a name="pango-font-description-better-match.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>desc</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>old_match</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> <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> </tr> <tr> <td class="parameter_name"><p>new_match</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-description-better-match.returns"></a><h4>Returns</h4> <p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>new_match</code></em> is a better match</p> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-description-from-string"></a><h3>pango_font_description_from_string ()</h3> <pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> * pango_font_description_from_string (<em class="parameter"><code>const <span class="type">char</span> *str</code></em>);</pre> <p>Creates a new font description from a string representation in the form</p> <p>"[FAMILY-LIST] [STYLE-OPTIONS] [SIZE] [VARIATIONS]",</p> <p>where FAMILY-LIST is a comma-separated list of families optionally terminated by a comma, STYLE_OPTIONS is a whitespace-separated list of words where each word describes one of style, variant, weight, stretch, or gravity, and SIZE is a decimal number (size in points) or optionally followed by the unit modifier "px" for absolute size. VARIATIONS is a comma-separated list of font variation specifications of the form "@axis=value" (the = sign is optional).</p> <p>The following words are understood as styles: "Normal", "Roman", "Oblique", "Italic".</p> <p>The following words are understood as variants: "Small-Caps".</p> <p>The following words are understood as weights: "Thin", "Ultra-Light", "Extra-Light", "Light", "Semi-Light", "Demi-Light", "Book", "Regular", "Medium", "Semi-Bold", "Demi-Bold", "Bold", "Ultra-Bold", "Extra-Bold", "Heavy", "Black", "Ultra-Black", "Extra-Black".</p> <p>The following words are understood as stretch values: "Ultra-Condensed", "Extra-Condensed", "Condensed", "Semi-Condensed", "Semi-Expanded", "Expanded", "Extra-Expanded", "Ultra-Expanded".</p> <p>The following words are understood as gravity values: "Not-Rotated", "South", "Upside-Down", "North", "Rotated-Left", "East", "Rotated-Right", "West".</p> <p>Any one of the options may be absent. If FAMILY-LIST is absent, then the family_name field of the resulting font description will be initialized to <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. If STYLE-OPTIONS is missing, then all style options will be set to the default values. If SIZE is missing, the size in the resulting font description will be set to 0.</p> <p>A typical example:</p> <p>"Cantarell Italic Light 15 @wght=200"</p> <div class="refsect3"> <a name="pango-font-description-from-string.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>str</p></td> <td class="parameter_description"><p>string representation of a font description.</p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-description-from-string.returns"></a><h4>Returns</h4> <p> a new <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>.</p> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-description-to-string"></a><h3>pango_font_description_to_string ()</h3> <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> <p>Creates a string representation of a font description. See <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 format of the string representation. The family list in the string description will only have a terminating comma if the last word of the list is a valid style option.</p> <div class="refsect3"> <a name="pango-font-description-to-string.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>desc</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-description-to-string.returns"></a><h4>Returns</h4> <p> a new string that must be freed with <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.</p> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-description-to-filename"></a><h3>pango_font_description_to_filename ()</h3> <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> <p>Creates a filename representation of a font description. The filename is identical to the result from calling <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 characters that are untypical in filenames, and in lower case only.</p> <div class="refsect3"> <a name="pango-font-description-to-filename.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>desc</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-description-to-filename.returns"></a><h4>Returns</h4> <p> a new string that must be freed with <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.</p> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-metrics-ref"></a><h3>pango_font_metrics_ref ()</h3> <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> <p>Increase the reference count of a font metrics structure by one.</p> <div class="refsect3"> <a name="pango-font-metrics-ref.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>metrics</p></td> <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="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-metrics-ref.returns"></a><h4>Returns</h4> <p><em class="parameter"><code>metrics</code></em> . </p> <p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-metrics-unref"></a><h3>pango_font_metrics_unref ()</h3> <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> <p>Decrease the reference count of a font metrics structure by one. If the result is zero, frees the structure and any associated memory.</p> <div class="refsect3"> <a name="pango-font-metrics-unref.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>metrics</p></td> <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="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td> </tr></tbody> </table></div> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-metrics-get-ascent"></a><h3>pango_font_metrics_get_ascent ()</h3> <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> <p>Gets the ascent from a font metrics structure. The ascent is the distance from the baseline to the logical top of a line of text. (The logical top may be above or below the top of the actual drawn ink. It is necessary to lay out the text to figure where the ink will be.)</p> <div class="refsect3"> <a name="pango-font-metrics-get-ascent.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>metrics</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure</p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-metrics-get-ascent.returns"></a><h4>Returns</h4> <p> the ascent, in Pango units.</p> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-metrics-get-descent"></a><h3>pango_font_metrics_get_descent ()</h3> <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> <p>Gets the descent from a font metrics structure. The descent is the distance from the baseline to the logical bottom of a line of text. (The logical bottom may be above or below the bottom of the actual drawn ink. It is necessary to lay out the text to figure where the ink will be.)</p> <div class="refsect3"> <a name="pango-font-metrics-get-descent.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>metrics</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure</p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-metrics-get-descent.returns"></a><h4>Returns</h4> <p> the descent, in Pango units.</p> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-metrics-get-height"></a><h3>pango_font_metrics_get_height ()</h3> <pre class="programlisting"><span class="returnvalue">int</span> pango_font_metrics_get_height (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> *metrics</code></em>);</pre> <p>Gets the line height from a font metrics structure. The line height is the distance between successive baselines in wrapped text.</p> <p>If the line height is not available, 0 is returned.</p> <div class="refsect3"> <a name="pango-font-metrics-get-height.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>metrics</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure</p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-metrics-get-height.returns"></a><h4>Returns</h4> <p> the height, in Pango units</p> </div> <p class="since">Since: <a class="link" href="api-index-1-44.html#api-index-1.44">1.44</a></p> </div> <hr> <div class="refsect2"> <a name="pango-font-metrics-get-approximate-char-width"></a><h3>pango_font_metrics_get_approximate_char_width ()</h3> <pre class="programlisting"><span class="returnvalue">int</span> pango_font_metrics_get_approximate_char_width (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> *metrics</code></em>);</pre> <p>Gets the approximate character width for a font metrics structure. This is merely a representative value useful, for example, for determining the initial size for a window. Actual characters in text will be wider and narrower than this.</p> <div class="refsect3"> <a name="pango-font-metrics-get-approximate-char-width.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>metrics</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure</p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-metrics-get-approximate-char-width.returns"></a><h4>Returns</h4> <p> the character width, in Pango units.</p> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-metrics-get-approximate-digit-width"></a><h3>pango_font_metrics_get_approximate_digit_width ()</h3> <pre class="programlisting"><span class="returnvalue">int</span> pango_font_metrics_get_approximate_digit_width (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> *metrics</code></em>);</pre> <p>Gets the approximate digit width for a font metrics structure. This is merely a representative value useful, for example, for determining the initial size for a window. Actual digits in text can be wider or narrower than this, though this value is generally somewhat more accurate than the result 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> for digits.</p> <div class="refsect3"> <a name="pango-font-metrics-get-approximate-digit-width.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>metrics</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure</p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-metrics-get-approximate-digit-width.returns"></a><h4>Returns</h4> <p> the digit width, in Pango units.</p> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-metrics-get-underline-thickness"></a><h3>pango_font_metrics_get_underline_thickness ()</h3> <pre class="programlisting"><span class="returnvalue">int</span> pango_font_metrics_get_underline_thickness (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> *metrics</code></em>);</pre> <p>Gets the suggested thickness to draw for the underline.</p> <div class="refsect3"> <a name="pango-font-metrics-get-underline-thickness.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>metrics</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure</p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-metrics-get-underline-thickness.returns"></a><h4>Returns</h4> <p> the suggested underline thickness, in Pango units.</p> </div> <p class="since">Since: <a class="link" href="api-index-1-6.html#api-index-1.6">1.6</a></p> </div> <hr> <div class="refsect2"> <a name="pango-font-metrics-get-underline-position"></a><h3>pango_font_metrics_get_underline_position ()</h3> <pre class="programlisting"><span class="returnvalue">int</span> pango_font_metrics_get_underline_position (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> *metrics</code></em>);</pre> <p>Gets the suggested position to draw the underline. The value returned is the distance <span class="emphasis"><em>above</em></span> the baseline of the top of the underline. Since most fonts have underline positions beneath the baseline, this value is typically negative.</p> <div class="refsect3"> <a name="pango-font-metrics-get-underline-position.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>metrics</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure</p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-metrics-get-underline-position.returns"></a><h4>Returns</h4> <p> the suggested underline position, in Pango units.</p> </div> <p class="since">Since: <a class="link" href="api-index-1-6.html#api-index-1.6">1.6</a></p> </div> <hr> <div class="refsect2"> <a name="pango-font-metrics-get-strikethrough-thickness"></a><h3>pango_font_metrics_get_strikethrough_thickness ()</h3> <pre class="programlisting"><span class="returnvalue">int</span> pango_font_metrics_get_strikethrough_thickness (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> *metrics</code></em>);</pre> <p>Gets the suggested thickness to draw for the strikethrough.</p> <div class="refsect3"> <a name="pango-font-metrics-get-strikethrough-thickness.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>metrics</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure</p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-metrics-get-strikethrough-thickness.returns"></a><h4>Returns</h4> <p> the suggested strikethrough thickness, in Pango units.</p> </div> <p class="since">Since: <a class="link" href="api-index-1-6.html#api-index-1.6">1.6</a></p> </div> <hr> <div class="refsect2"> <a name="pango-font-metrics-get-strikethrough-position"></a><h3>pango_font_metrics_get_strikethrough_position ()</h3> <pre class="programlisting"><span class="returnvalue">int</span> pango_font_metrics_get_strikethrough_position (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> *metrics</code></em>);</pre> <p>Gets the suggested position to draw the strikethrough. The value returned is the distance <span class="emphasis"><em>above</em></span> the baseline of the top of the strikethrough.</p> <div class="refsect3"> <a name="pango-font-metrics-get-strikethrough-position.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>metrics</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure</p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-metrics-get-strikethrough-position.returns"></a><h4>Returns</h4> <p> the suggested strikethrough position, in Pango units.</p> </div> <p class="since">Since: <a class="link" href="api-index-1-6.html#api-index-1.6">1.6</a></p> </div> <hr> <div class="refsect2"> <a name="pango-font-find-shaper"></a><h3>pango_font_find_shaper ()</h3> <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>, <em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> *language</code></em>, <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> ch</code></em>);</pre> <div class="warning"> <p><code class="literal">pango_font_find_shaper</code> is deprecated and should not be used in newly-written code.</p> <p>Shape engines are no longer used</p> </div> <p>Finds the best matching shaper for a font for a particular language tag and character point.</p> <div class="refsect3"> <a name="pango-font-find-shaper.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>font</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>language</p></td> <td class="parameter_description"><p>the language tag</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>ch</p></td> <td class="parameter_description"><p>a Unicode character.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-find-shaper.returns"></a><h4>Returns</h4> <p>the best matching shaper. </p> <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-describe"></a><h3>pango_font_describe ()</h3> <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> <p>Returns a description of the font, with font size set in points. 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 size in device units.</p> <div class="refsect3"> <a name="pango-font-describe.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>font</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a></p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-describe.returns"></a><h4>Returns</h4> <p> a newly-allocated <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> object.</p> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-describe-with-absolute-size"></a><h3>pango_font_describe_with_absolute_size ()</h3> <pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> * pango_font_describe_with_absolute_size (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>);</pre> <p>Returns a description of the font, with absolute font size set (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 size in points.</p> <div class="refsect3"> <a name="pango-font-describe-with-absolute-size.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>font</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a></p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-describe-with-absolute-size.returns"></a><h4>Returns</h4> <p> a newly-allocated <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> object.</p> </div> <p class="since">Since: <a class="link" href="api-index-1-14.html#api-index-1.14">1.14</a></p> </div> <hr> <div class="refsect2"> <a name="pango-font-get-coverage"></a><h3>pango_font_get_coverage ()</h3> <pre class="programlisting"><a class="link" href="pango-Coverage-Maps.html#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>, <em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> *language</code></em>);</pre> <p>Computes the coverage map for a given font and language tag.</p> <div class="refsect3"> <a name="pango-font-get-coverage.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>font</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>language</p></td> <td class="parameter_description"><p>the language tag</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-get-coverage.returns"></a><h4>Returns</h4> <p>a newly-allocated <a class="link" href="pango-Coverage-Maps.html#PangoCoverage"><span class="type">PangoCoverage</span></a> object. </p> <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-has-char"></a><h3>pango_font_has_char ()</h3> <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> pango_font_has_char (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>, <em class="parameter"><code><a href="../glib/glib-Unicode-Manipulation.html#gunichar"><span class="type">gunichar</span></a> wc</code></em>);</pre> <p>Returns whether the font provides a glyph for this character.</p> <p>Returns <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>font</code></em> can render <em class="parameter"><code>wc</code></em> </p> <div class="refsect3"> <a name="pango-font-has-char.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>font</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>wc</p></td> <td class="parameter_description"><p>a Unicode character</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <p class="since">Since: <a class="link" href="api-index-1-44.html#api-index-1.44">1.44</a></p> </div> <hr> <div class="refsect2"> <a name="pango-font-get-glyph-extents"></a><h3>pango_font_get_glyph_extents ()</h3> <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>, <em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoGlyph" title="PangoGlyph"><span class="type">PangoGlyph</span></a> glyph</code></em>, <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>, <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> <p>Gets the logical and ink extents of a glyph within a font. The coordinate system for each rectangle has its origin at the base line and horizontal origin of the character with increasing 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>, <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 from the extents rectangle to more traditional font metrics. The units of the rectangles are in 1/PANGO_SCALE of a device unit.</p> <p>If <em class="parameter"><code>font</code></em> is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, this function gracefully sets some sane values in the output variables and returns.</p> <div class="refsect3"> <a name="pango-font-get-glyph-extents.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>font</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>. </p></td> <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td> </tr> <tr> <td class="parameter_name"><p>glyph</p></td> <td class="parameter_description"><p>the glyph index</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>ink_rect</p></td> <td class="parameter_description"><p>rectangle used to store the extents of the glyph as drawn or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to indicate that the result is not needed. </p></td> <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>]</span></td> </tr> <tr> <td class="parameter_name"><p>logical_rect</p></td> <td class="parameter_description"><p>rectangle used to store the logical extents of the glyph or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to indicate that the result is not needed. </p></td> <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>]</span></td> </tr> </tbody> </table></div> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-get-metrics"></a><h3>pango_font_get_metrics ()</h3> <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>, <em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> *language</code></em>);</pre> <p>Gets overall metric information for a font. Since the metrics may be substantially different for different scripts, a language tag can be provided to indicate that the metrics should be retrieved that correspond to the script(s) used by that language.</p> <p>If <em class="parameter"><code>font</code></em> is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, this function gracefully sets some sane values in the output variables and returns.</p> <div class="refsect3"> <a name="pango-font-get-metrics.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>font</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>. </p></td> <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td> </tr> <tr> <td class="parameter_name"><p>language</p></td> <td class="parameter_description"><p>language tag used to determine which script to get the metrics for, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to indicate to get the metrics for the entire font. </p></td> <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> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-get-metrics.returns"></a><h4>Returns</h4> <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> when finished using the object.</p> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-get-font-map"></a><h3>pango_font_get_font_map ()</h3> <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> <p>Gets the font map for which the font was created.</p> <p>Note that the font maintains a <em class="firstterm">weak</em> reference to the font map, so if all references to font map are dropped, the font map will be finalized even if there are fonts created with the font map that are still alive. In that case this function will return <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. It is the responsibility of the user to ensure that the font map is kept alive. In most uses this is not an issue as a <a class="link" href="pango-Contexts.html#PangoContext"><span class="type">PangoContext</span></a> holds a reference to the font map.</p> <div class="refsect3"> <a name="pango-font-get-font-map.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>font</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-get-font-map.returns"></a><h4>Returns</h4> <p>the <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> for the font, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>font</code></em> is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p> <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p> </div> <p class="since">Since: <a class="link" href="api-index-1-10.html#api-index-1.10">1.10</a></p> </div> <hr> <div class="refsect2"> <a name="pango-font-get-features"></a><h3>pango_font_get_features ()</h3> <pre class="programlisting"><span class="returnvalue">void</span> pango_font_get_features (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>, <em class="parameter"><code><a href="../harfbuzz/harfbuzz-hb-common.html#hb-feature-t-struct"><span class="type">hb_feature_t</span></a> *features</code></em>, <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> len</code></em>, <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *num_features</code></em>);</pre> <p>Obtain the OpenType features that are provided by the font. These are passed to the rendering system, together with features that have been explicitly set via attributes.</p> <p>Note that this does not include OpenType features which the rendering system enables by default.</p> <div class="refsect3"> <a name="pango-font-get-features.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>font</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>features</p></td> <td class="parameter_description"><p>Array to features in. </p></td> <td class="parameter_annotations"><span class="annotation">[<acronym title="Out parameter, where caller must allocate storage."><span class="acronym">out caller-allocates</span></acronym>][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=len]</span></td> </tr> <tr> <td class="parameter_name"><p>len</p></td> <td class="parameter_description"><p>the length of <em class="parameter"><code>features</code></em> </p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>num_features</p></td> <td class="parameter_description"><p>the number of used items in <em class="parameter"><code>features</code></em> . </p></td> <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for input and for returning results. Default is transfer full."><span class="acronym">inout</span></acronym>]</span></td> </tr> </tbody> </table></div> </div> <p class="since">Since: <a class="link" href="api-index-1-44.html#api-index-1.44">1.44</a></p> </div> <hr> <div class="refsect2"> <a name="pango-font-get-hb-font"></a><h3>pango_font_get_hb_font ()</h3> <pre class="programlisting"><a href="../harfbuzz/harfbuzz-hb-font.html#hb-font-t"><span class="returnvalue">hb_font_t</span></a> * pango_font_get_hb_font (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>);</pre> <p>Get a hb_font_t object backing this font.</p> <p>Note that the objects returned by this function are cached and immutable. If you need to make changes to the hb_font_t, use <a href="../harfbuzz/harfbuzz-hb-font.html#hb-font-create-sub-font"><code class="function">hb_font_create_sub_font()</code></a>.</p> <p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p> <div class="refsect3"> <a name="pango-font-get-hb-font.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>font</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a></p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-get-hb-font.returns"></a><h4>Returns</h4> <p>the hb_font_t object backing the font, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the font does not have one. </p> <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p> </div> <p class="since">Since: <a class="link" href="api-index-1-44.html#api-index-1.44">1.44</a></p> </div> <hr> <div class="refsect2"> <a name="pango-font-family-get-name"></a><h3>pango_font_family_get_name ()</h3> <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> <p>Gets the name of the family. The name is unique among all 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> to specify that a face from this family is desired.</p> <div class="refsect3"> <a name="pango-font-family-get-name.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>family</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a></p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-family-get-name.returns"></a><h4>Returns</h4> <p> the name of the family. This string is owned by the family object and must not be modified or freed.</p> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-family-is-monospace"></a><h3>pango_font_family_is_monospace ()</h3> <pre class="programlisting"><a href="../glib/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> <p>A monospace font is a font designed for text display where the the characters form a regular grid. For Western languages this would mean that the advance width of all characters are the same, but this categorization also includes Asian fonts which include double-width characters: characters that occupy two grid cells. <a href="../glib/glib-Unicode-Manipulation.html#g-unichar-iswide"><code class="function">g_unichar_iswide()</code></a> returns a result that indicates whether a character is typically double-width in a monospace font.</p> <p>The best way to find out the grid-cell size is to call <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 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 by double-width characters.</p> <div class="refsect3"> <a name="pango-font-family-is-monospace.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>family</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a></p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-family-is-monospace.returns"></a><h4>Returns</h4> <p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the family is monospace.</p> </div> <p class="since">Since: <a class="link" href="api-index-1-4.html#api-index-1.4">1.4</a></p> </div> <hr> <div class="refsect2"> <a name="pango-font-family-is-variable"></a><h3>pango_font_family_is_variable ()</h3> <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> pango_font_family_is_variable (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a> *family</code></em>);</pre> <p>A variable font is a font which has axes that can be modified to produce different faces.</p> <div class="refsect3"> <a name="pango-font-family-is-variable.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>family</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a></p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-family-is-variable.returns"></a><h4>Returns</h4> <p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the family is variable</p> </div> <p class="since">Since: <a class="link" href="api-index-1-44.html#api-index-1.44">1.44</a></p> </div> <hr> <div class="refsect2"> <a name="pango-font-family-list-faces"></a><h3>pango_font_family_list_faces ()</h3> <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>, <em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a> ***faces</code></em>, <em class="parameter"><code><span class="type">int</span> *n_faces</code></em>);</pre> <p>Lists the different font faces that make up <em class="parameter"><code>family</code></em> . The faces in a family share a common design, but differ in slant, weight, width and other aspects.</p> <div class="refsect3"> <a name="pango-font-family-list-faces.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>family</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>faces</p></td> <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, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. This array should be freed with <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when it is no longer needed. </p></td> <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> </tr> <tr> <td class="parameter_name"><p>n_faces</p></td> <td class="parameter_description"><p>location to store number of elements in <em class="parameter"><code>faces</code></em> . </p></td> <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td> </tr> </tbody> </table></div> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-face-get-face-name"></a><h3>pango_font_face_get_face_name ()</h3> <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> <p>Gets a name representing the style of this face among the different faces in the <a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a> for the face. This name is unique among all faces in the family and is suitable for displaying to users.</p> <div class="refsect3"> <a name="pango-font-face-get-face-name.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>face</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a>.</p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-face-get-face-name.returns"></a><h4>Returns</h4> <p> the face name for the face. This string is owned by the face object and must not be modified or freed.</p> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-face-list-sizes"></a><h3>pango_font_face_list_sizes ()</h3> <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>, <em class="parameter"><code><span class="type">int</span> **sizes</code></em>, <em class="parameter"><code><span class="type">int</span> *n_sizes</code></em>);</pre> <p>List the available sizes for a font. This is only applicable to bitmap fonts. For scalable fonts, stores <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> at the location pointed to by <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 are in Pango units and are sorted in ascending order.</p> <div class="refsect3"> <a name="pango-font-face-list-sizes.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>face</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a>.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>sizes</p></td> <td class="parameter_description"><p>location to store a pointer to an array of int. This array should be freed with <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. </p></td> <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_sizes][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="NULL may be passed instead of a pointer to a location."><span class="acronym">optional</span></acronym>]</span></td> </tr> <tr> <td class="parameter_name"><p>n_sizes</p></td> <td class="parameter_description"><p>location to store the number of elements in <em class="parameter"><code>sizes</code></em> </p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <p class="since">Since: <a class="link" href="api-index-1-4.html#api-index-1.4">1.4</a></p> </div> <hr> <div class="refsect2"> <a name="pango-font-face-describe"></a><h3>pango_font_face_describe ()</h3> <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> <p>Returns the family, style, variant, weight and stretch of a <a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a>. The size field of the resulting font description will be unset.</p> <div class="refsect3"> <a name="pango-font-face-describe.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>face</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a></p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-face-describe.returns"></a><h4>Returns</h4> <p> a newly-created <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> structure 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> to free the result.</p> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-face-is-synthesized"></a><h3>pango_font_face_is_synthesized ()</h3> <pre class="programlisting"><a href="../glib/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> <p>Returns whether a <a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a> is synthesized by the underlying font rendering engine from another face, perhaps by shearing, emboldening, or lightening it.</p> <div class="refsect3"> <a name="pango-font-face-is-synthesized.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>face</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a></p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-face-is-synthesized.returns"></a><h4>Returns</h4> <p> whether <em class="parameter"><code>face</code></em> is synthesized.</p> </div> <p class="since">Since: <a class="link" href="api-index-1-18.html#api-index-1.18">1.18</a></p> </div> <hr> <div class="refsect2"> <a name="pango-font-map-create-context"></a><h3>pango_font_map_create_context ()</h3> <pre class="programlisting"><a class="link" href="pango-Contexts.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> <p>Creates a <a class="link" href="pango-Contexts.html#PangoContext"><span class="type">PangoContext</span></a> connected to <em class="parameter"><code>fontmap</code></em> . This is equivalent to <a class="link" href="pango-Contexts.html#pango-context-new" title="pango_context_new ()"><code class="function">pango_context_new()</code></a> followed by <a class="link" href="pango-Contexts.html#pango-context-set-font-map" title="pango_context_set_font_map ()"><code class="function">pango_context_set_font_map()</code></a>.</p> <p>If you are using Pango as part of a higher-level system, that system may have it's own way of create a <a class="link" href="pango-Contexts.html#PangoContext"><span class="type">PangoContext</span></a>. For instance, the GTK+ toolkit has, among others, <a href="../gdk3/gdk3-Pango-Interaction.html#gdk-pango-context-get-for-screen"><code class="function">gdk_pango_context_get_for_screen()</code></a>, and <a href="../gtk3/GtkWidget.html#gtk-widget-get-pango-context"><code class="function">gtk_widget_get_pango_context()</code></a>. Use those instead.</p> <div class="refsect3"> <a name="pango-font-map-create-context.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>fontmap</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a></p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-map-create-context.returns"></a><h4>Returns</h4> <p>the newly allocated <a class="link" href="pango-Contexts.html#PangoContext"><span class="type">PangoContext</span></a>, which should be freed with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. </p> <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p> </div> <p class="since">Since: <a class="link" href="api-index-1-22.html#api-index-1.22">1.22</a></p> </div> <hr> <div class="refsect2"> <a name="pango-font-map-load-font"></a><h3>pango_font_map_load_font ()</h3> <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>, <em class="parameter"><code><a class="link" href="pango-Contexts.html#PangoContext"><span class="type">PangoContext</span></a> *context</code></em>, <em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);</pre> <p>Load the font in the fontmap that is the closest match for <em class="parameter"><code>desc</code></em> .</p> <div class="refsect3"> <a name="pango-font-map-load-font.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>fontmap</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>context</p></td> <td class="parameter_description"><p>the <a class="link" href="pango-Contexts.html#PangoContext"><span class="type">PangoContext</span></a> the font will be used with</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>desc</p></td> <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> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-map-load-font.returns"></a><h4>Returns</h4> <p>the newly allocated <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> loaded, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no font matched. </p> <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-map-load-fontset"></a><h3>pango_font_map_load_fontset ()</h3> <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>, <em class="parameter"><code><a class="link" href="pango-Contexts.html#PangoContext"><span class="type">PangoContext</span></a> *context</code></em>, <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><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> *language</code></em>);</pre> <p>Load a set of fonts in the fontmap that can be used to render a font matching <em class="parameter"><code>desc</code></em> .</p> <div class="refsect3"> <a name="pango-font-map-load-fontset.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>fontmap</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>context</p></td> <td class="parameter_description"><p>the <a class="link" href="pango-Contexts.html#PangoContext"><span class="type">PangoContext</span></a> the font will be used with</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>desc</p></td> <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> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>language</p></td> <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> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-map-load-fontset.returns"></a><h4>Returns</h4> <p>the newly allocated <a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a> loaded, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no font matched. </p> <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-map-list-families"></a><h3>pango_font_map_list_families ()</h3> <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>, <em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a> ***families</code></em>, <em class="parameter"><code><span class="type">int</span> *n_families</code></em>);</pre> <p>List all families for a fontmap.</p> <div class="refsect3"> <a name="pango-font-map-list-families.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>fontmap</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>families</p></td> <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> *. This array should be freed with <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. </p></td> <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> </tr> <tr> <td class="parameter_name"><p>n_families</p></td> <td class="parameter_description"><p>location to store the number of elements in <em class="parameter"><code>families</code></em> . </p></td> <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td> </tr> </tbody> </table></div> </div> </div> <hr> <div class="refsect2"> <a name="pango-font-map-get-serial"></a><h3>pango_font_map_get_serial ()</h3> <pre class="programlisting"><a href="../glib/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> <p>Returns the current serial number of <em class="parameter"><code>fontmap</code></em> . The serial number is initialized to an small number larger than zero when a new fontmap is created and is increased whenever the fontmap is changed. It may wrap, but will never have the value 0. Since it can wrap, never compare it with "less than", always use "not equals".</p> <p>The fontmap can only be changed using backend-specific API, like changing fontmap resolution.</p> <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 in <a class="link" href="pango-Contexts.html#PangoContext"><span class="type">PangoContext</span></a>.</p> <div class="refsect3"> <a name="pango-font-map-get-serial.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>fontmap</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a></p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="pango-font-map-get-serial.returns"></a><h4>Returns</h4> <p> The current serial number of <em class="parameter"><code>fontmap</code></em> .</p> </div> <p class="since">Since: <a class="link" href="api-index-1-32-4.html#api-index-1.32.4">1.32.4</a></p> </div> <hr> <div class="refsect2"> <a name="pango-font-map-changed"></a><h3>pango_font_map_changed ()</h3> <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> <p>Forces a change in the context, which will cause any <a class="link" href="pango-Contexts.html#PangoContext"><span class="type">PangoContext</span></a> using this fontmap to change.</p> <p>This function is only useful when implementing a new backend for Pango, something applications won't do. Backends should call this function if they have attached extra data to the context and such data is changed.</p> <div class="refsect3"> <a name="pango-font-map-changed.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>fontmap</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a></p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <p class="since">Since: <a class="link" href="api-index-1-34.html#api-index-1.34">1.34</a></p> </div> <hr> <div class="refsect2"> <a name="pango-fontset-get-font"></a><h3>pango_fontset_get_font ()</h3> <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>, <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> wc</code></em>);</pre> <p>Returns the font in the fontset that contains the best glyph for the Unicode character <em class="parameter"><code>wc</code></em> .</p> <div class="refsect3"> <a name="pango-fontset-get-font.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>fontset</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>wc</p></td> <td class="parameter_description"><p>a Unicode character</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="pango-fontset-get-font.returns"></a><h4>Returns</h4> <p>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>. The caller must call g_object_unref when finished with the font. </p> <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p> </div> </div> <hr> <div class="refsect2"> <a name="pango-fontset-get-metrics"></a><h3>pango_fontset_get_metrics ()</h3> <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> <p>Get overall metric information for the fonts in the fontset.</p> <div class="refsect3"> <a name="pango-fontset-get-metrics.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>fontset</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a></p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="pango-fontset-get-metrics.returns"></a><h4>Returns</h4> <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> when finished using the object.</p> </div> </div> <hr> <div class="refsect2"> <a name="PangoFontsetForeachFunc"></a><h3>PangoFontsetForeachFunc ()</h3> <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <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>, <em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>, <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre> <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 the fonts in a fontset.</p> <div class="refsect3"> <a name="PangoFontsetForeachFunc.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>fontset</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>font</p></td> <td class="parameter_description"><p>a font from <em class="parameter"><code>fontset</code></em> </p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>user_data</p></td> <td class="parameter_description"><p>callback data</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="PangoFontsetForeachFunc.returns"></a><h4>Returns</h4> <p> if <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, stop iteration and return immediately.</p> </div> <p class="since">Since: <a class="link" href="api-index-1-4.html#api-index-1.4">1.4</a></p> </div> <hr> <div class="refsect2"> <a name="pango-fontset-foreach"></a><h3>pango_fontset_foreach ()</h3> <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>, <em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontsetForeachFunc" title="PangoFontsetForeachFunc ()"><span class="type">PangoFontsetForeachFunc</span></a> func</code></em>, <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre> <p>Iterates through all the fonts in a fontset, calling <em class="parameter"><code>func</code></em> for each one. If <em class="parameter"><code>func</code></em> returns <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, that stops the iteration.</p> <div class="refsect3"> <a name="pango-fontset-foreach.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>fontset</p></td> <td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>func</p></td> <td class="parameter_description"><p>Callback function. </p></td> <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> </tr> <tr> <td class="parameter_name"><p>data</p></td> <td class="parameter_description"><p>data to pass to the callback function. </p></td> <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>]</span></td> </tr> </tbody> </table></div> </div> <p class="since">Since: <a class="link" href="api-index-1-4.html#api-index-1.4">1.4</a></p> </div> </div> <div class="refsect1"> <a name="pango-Fonts.other_details"></a><h2>Types and Values</h2> <div class="refsect2"> <a name="PangoFontDescription-struct"></a><h3>PangoFontDescription</h3> <pre class="programlisting">typedef struct _PangoFontDescription PangoFontDescription;</pre> <p>The <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> structure represents the description of an ideal font. These structures are used both to list what fonts are available on the system and also for specifying the characteristics of a font to load.</p> </div> <hr> <div class="refsect2"> <a name="PangoStyle"></a><h3>enum PangoStyle</h3> <p>An enumeration specifying the various slant styles possible for a font.</p> <div class="refsect3"> <a name="PangoStyle.members"></a><h4>Members</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="300px" class="enum_members_name"> <col class="enum_members_description"> <col width="200px" class="enum_members_annotations"> </colgroup> <tbody> <tr> <td class="enum_member_name"><p><a name="PANGO-STYLE-NORMAL:CAPS"></a>PANGO_STYLE_NORMAL</p></td> <td class="enum_member_description"> <p>the font is upright.</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="PANGO-STYLE-OBLIQUE:CAPS"></a>PANGO_STYLE_OBLIQUE</p></td> <td class="enum_member_description"> <p>the font is slanted, but in a roman style.</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="PANGO-STYLE-ITALIC:CAPS"></a>PANGO_STYLE_ITALIC</p></td> <td class="enum_member_description"> <p>the font is slanted in an italic style.</p> </td> <td class="enum_member_annotations"> </td> </tr> </tbody> </table></div> </div> </div> <hr> <div class="refsect2"> <a name="PangoWeight"></a><h3>enum PangoWeight</h3> <p>An enumeration specifying the weight (boldness) of a font. This is a numerical value ranging from 100 to 1000, but there are some predefined values:</p> <div class="refsect3"> <a name="PangoWeight.members"></a><h4>Members</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="300px" class="enum_members_name"> <col class="enum_members_description"> <col width="200px" class="enum_members_annotations"> </colgroup> <tbody> <tr> <td class="enum_member_name"><p><a name="PANGO-WEIGHT-THIN:CAPS"></a>PANGO_WEIGHT_THIN</p></td> <td class="enum_member_description"> <p>the thin weight (= 100; Since: 1.24)</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="PANGO-WEIGHT-ULTRALIGHT:CAPS"></a>PANGO_WEIGHT_ULTRALIGHT</p></td> <td class="enum_member_description"> <p>the ultralight weight (= 200)</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="PANGO-WEIGHT-LIGHT:CAPS"></a>PANGO_WEIGHT_LIGHT</p></td> <td class="enum_member_description"> <p>the light weight (= 300)</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="PANGO-WEIGHT-SEMILIGHT:CAPS"></a>PANGO_WEIGHT_SEMILIGHT</p></td> <td class="enum_member_description"> <p>the semilight weight (= 350; Since: 1.36.7)</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="PANGO-WEIGHT-BOOK:CAPS"></a>PANGO_WEIGHT_BOOK</p></td> <td class="enum_member_description"> <p>the book weight (= 380; Since: 1.24)</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="PANGO-WEIGHT-NORMAL:CAPS"></a>PANGO_WEIGHT_NORMAL</p></td> <td class="enum_member_description"> <p>the default weight (= 400)</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="PANGO-WEIGHT-MEDIUM:CAPS"></a>PANGO_WEIGHT_MEDIUM</p></td> <td class="enum_member_description"> <p>the normal weight (= 500; Since: 1.24)</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="PANGO-WEIGHT-SEMIBOLD:CAPS"></a>PANGO_WEIGHT_SEMIBOLD</p></td> <td class="enum_member_description"> <p>the semibold weight (= 600)</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="PANGO-WEIGHT-BOLD:CAPS"></a>PANGO_WEIGHT_BOLD</p></td> <td class="enum_member_description"> <p>the bold weight (= 700)</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="PANGO-WEIGHT-ULTRABOLD:CAPS"></a>PANGO_WEIGHT_ULTRABOLD</p></td> <td class="enum_member_description"> <p>the ultrabold weight (= 800)</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="PANGO-WEIGHT-HEAVY:CAPS"></a>PANGO_WEIGHT_HEAVY</p></td> <td class="enum_member_description"> <p>the heavy weight (= 900)</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="PANGO-WEIGHT-ULTRAHEAVY:CAPS"></a>PANGO_WEIGHT_ULTRAHEAVY</p></td> <td class="enum_member_description"> <p>the ultraheavy weight (= 1000; Since: 1.24)</p> </td> <td class="enum_member_annotations"> </td> </tr> </tbody> </table></div> </div> </div> <hr> <div class="refsect2"> <a name="PangoVariant"></a><h3>enum PangoVariant</h3> <p>An enumeration specifying capitalization variant of the font.</p> <div class="refsect3"> <a name="PangoVariant.members"></a><h4>Members</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="300px" class="enum_members_name"> <col class="enum_members_description"> <col width="200px" class="enum_members_annotations"> </colgroup> <tbody> <tr> <td class="enum_member_name"><p><a name="PANGO-VARIANT-NORMAL:CAPS"></a>PANGO_VARIANT_NORMAL</p></td> <td class="enum_member_description"> <p>A normal font.</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="PANGO-VARIANT-SMALL-CAPS"></a>PANGO_VARIANT_SMALL_CAPS</p></td> <td class="enum_member_description"> <p>A font with the lower case characters replaced by smaller variants of the capital characters.</p> </td> <td class="enum_member_annotations"> </td> </tr> </tbody> </table></div> </div> </div> <hr> <div class="refsect2"> <a name="PangoStretch"></a><h3>enum PangoStretch</h3> <p>An enumeration specifying the width of the font relative to other designs within a family.</p> <div class="refsect3"> <a name="PangoStretch.members"></a><h4>Members</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="300px" class="enum_members_name"> <col class="enum_members_description"> <col width="200px" class="enum_members_annotations"> </colgroup> <tbody> <tr> <td class="enum_member_name"><p><a name="PANGO-STRETCH-ULTRA-CONDENSED:CAPS"></a>PANGO_STRETCH_ULTRA_CONDENSED</p></td> <td class="enum_member_description"> <p>ultra condensed width</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="PANGO-STRETCH-EXTRA-CONDENSED:CAPS"></a>PANGO_STRETCH_EXTRA_CONDENSED</p></td> <td class="enum_member_description"> <p>extra condensed width</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="PANGO-STRETCH-CONDENSED:CAPS"></a>PANGO_STRETCH_CONDENSED</p></td> <td class="enum_member_description"> <p>condensed width</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="PANGO-STRETCH-SEMI-CONDENSED:CAPS"></a>PANGO_STRETCH_SEMI_CONDENSED</p></td> <td class="enum_member_description"> <p>semi condensed width</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="PANGO-STRETCH-NORMAL:CAPS"></a>PANGO_STRETCH_NORMAL</p></td> <td class="enum_member_description"> <p>the normal width</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="PANGO-STRETCH-SEMI-EXPANDED:CAPS"></a>PANGO_STRETCH_SEMI_EXPANDED</p></td> <td class="enum_member_description"> <p>semi expanded width</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="PANGO-STRETCH-EXPANDED:CAPS"></a>PANGO_STRETCH_EXPANDED</p></td> <td class="enum_member_description"> <p>expanded width</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="PANGO-STRETCH-EXTRA-EXPANDED:CAPS"></a>PANGO_STRETCH_EXTRA_EXPANDED</p></td> <td class="enum_member_description"> <p>extra expanded width</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="PANGO-STRETCH-ULTRA-EXPANDED:CAPS"></a>PANGO_STRETCH_ULTRA_EXPANDED</p></td> <td class="enum_member_description"> <p>ultra expanded width</p> </td> <td class="enum_member_annotations"> </td> </tr> </tbody> </table></div> </div> </div> <hr> <div class="refsect2"> <a name="PangoFontMask"></a><h3>enum PangoFontMask</h3> <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 <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> that have been set.</p> <div class="refsect3"> <a name="PangoFontMask.members"></a><h4>Members</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="300px" class="enum_members_name"> <col class="enum_members_description"> <col width="200px" class="enum_members_annotations"> </colgroup> <tbody> <tr> <td class="enum_member_name"><p><a name="PANGO-FONT-MASK-FAMILY:CAPS"></a>PANGO_FONT_MASK_FAMILY</p></td> <td class="enum_member_description"> <p>the font family is specified.</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="PANGO-FONT-MASK-STYLE:CAPS"></a>PANGO_FONT_MASK_STYLE</p></td> <td class="enum_member_description"> <p>the font style is specified.</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="PANGO-FONT-MASK-VARIANT:CAPS"></a>PANGO_FONT_MASK_VARIANT</p></td> <td class="enum_member_description"> <p>the font variant is specified.</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="PANGO-FONT-MASK-WEIGHT:CAPS"></a>PANGO_FONT_MASK_WEIGHT</p></td> <td class="enum_member_description"> <p>the font weight is specified.</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="PANGO-FONT-MASK-STRETCH:CAPS"></a>PANGO_FONT_MASK_STRETCH</p></td> <td class="enum_member_description"> <p>the font stretch is specified.</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="PANGO-FONT-MASK-SIZE:CAPS"></a>PANGO_FONT_MASK_SIZE</p></td> <td class="enum_member_description"> <p>the font size is specified.</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="PANGO-FONT-MASK-GRAVITY:CAPS"></a>PANGO_FONT_MASK_GRAVITY</p></td> <td class="enum_member_description"> <p>the font gravity is specified (Since: 1.16.)</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="PANGO-FONT-MASK-VARIATIONS:CAPS"></a>PANGO_FONT_MASK_VARIATIONS</p></td> <td class="enum_member_description"> <p>OpenType font variations are specified (Since: 1.42)</p> </td> <td class="enum_member_annotations"> </td> </tr> </tbody> </table></div> </div> </div> <hr> <div class="refsect2"> <a name="PangoFontMetrics-struct"></a><h3>struct PangoFontMetrics</h3> <pre class="programlisting">struct PangoFontMetrics { }; </pre> <p>A <a class="link" href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure holds the overall metric information for a font (possibly restricted to a script). The fields of this structure are private to implementations of a font backend. See the documentation of the corresponding getters for documentation of their meaning.</p> </div> <hr> <div class="refsect2"> <a name="PangoFont-struct"></a><h3>PangoFont</h3> <pre class="programlisting">typedef struct _PangoFont PangoFont;</pre> <div class="warning"><p><code class="literal">PangoFont</code> is deprecated and should not be used in newly-written code.</p></div> <p>The <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> structure is used to represent a font in a rendering-system-independent matter. To create an implementation of a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>, the rendering-system specific code should allocate a larger structure that contains a nested <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 the nested <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> with a pointer to a appropriate <span class="type">PangoFontClass</span>, then call <code class="function">pango_font_init()</code> on the structure.</p> <p>The <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> structure contains one member which the implementation fills in.</p> </div> <hr> <div class="refsect2"> <a name="PangoFontFamily-struct"></a><h3>struct PangoFontFamily</h3> <pre class="programlisting">struct PangoFontFamily;</pre> <div class="warning"><p><code class="literal">PangoFontFamily</code> is deprecated and should not be used in newly-written code.</p></div> <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 font faces. The faces in a family share a common design, but differ in slant, weight, width and other aspects.</p> </div> <hr> <div class="refsect2"> <a name="PangoFontFace-struct"></a><h3>struct PangoFontFace</h3> <pre class="programlisting">struct PangoFontFace;</pre> <div class="warning"><p><code class="literal">PangoFontFace</code> is deprecated and should not be used in newly-written code.</p></div> <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 the same family, slant, weight, width, but varying sizes.</p> </div> <hr> <div class="refsect2"> <a name="PangoFontMap-struct"></a><h3>PangoFontMap</h3> <pre class="programlisting">typedef struct _PangoFontMap PangoFontMap;</pre> <p>The <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> represents the set of fonts available for a particular rendering system. This is a virtual object with implementations being specific to particular rendering systems. To create an implementation of a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>, the rendering-system specific code should allocate a larger structure that contains a nested <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 pointer to a appropriate <a class="link" href="pango-Fonts.html#PangoFontMapClass" title="struct PangoFontMapClass"><span class="type">PangoFontMapClass</span></a>, then call <code class="function">pango_font_map_init()</code> on the structure.</p> <p>The <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> structure contains one member which the implementation fills in.</p> </div> <hr> <div class="refsect2"> <a name="PangoFontMapClass"></a><h3>struct PangoFontMapClass</h3> <pre class="programlisting">struct PangoFontMapClass { GObjectClass parent_class; PangoFont * (*load_font) (PangoFontMap *fontmap, PangoContext *context, const PangoFontDescription *desc); void (*list_families) (PangoFontMap *fontmap, PangoFontFamily ***families, int *n_families); PangoFontset *(*load_fontset) (PangoFontMap *fontmap, PangoContext *context, const PangoFontDescription *desc, PangoLanguage *language); const char *shape_engine_type; guint (*get_serial) (PangoFontMap *fontmap); void (*changed) (PangoFontMap *fontmap); }; </pre> <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 a particular <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> implementation.</p> <div class="refsect3"> <a name="PangoFontMapClass.members"></a><h4>Members</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="300px" class="struct_members_name"> <col class="struct_members_description"> <col width="200px" class="struct_members_annotations"> </colgroup> <tbody> <tr> <td class="struct_member_name"><p><em class="structfield"><code><a name="PangoFontMapClass.load-font"></a>load_font</code></em> ()</p></td> <td class="struct_member_description"><p>a function to load a font with a given description. See <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> <td class="struct_member_annotations"> </td> </tr> <tr> <td class="struct_member_name"><p><em class="structfield"><code><a name="PangoFontMapClass.list-families"></a>list_families</code></em> ()</p></td> <td class="struct_member_description"><p>A function to list available font families. See <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> <td class="struct_member_annotations"> </td> </tr> <tr> <td class="struct_member_name"><p><em class="structfield"><code><a name="PangoFontMapClass.load-fontset"></a>load_fontset</code></em> ()</p></td> <td class="struct_member_description"><p>a function to load a fontset with a given given description 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>.</p></td> <td class="struct_member_annotations"> </td> </tr> <tr> <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> <td class="struct_member_description"><p>the type of rendering-system-dependent engines that can handle fonts of this fonts loaded with this fontmap.</p></td> <td class="struct_member_annotations"> </td> </tr> <tr> <td class="struct_member_name"><p><em class="structfield"><code><a name="PangoFontMapClass.get-serial"></a>get_serial</code></em> ()</p></td> <td class="struct_member_description"><p>a function to get the serial number of the fontmap. 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> <td class="struct_member_annotations"> </td> </tr> <tr> <td class="struct_member_name"><p><em class="structfield"><code><a name="PangoFontMapClass.changed"></a>changed</code></em> ()</p></td> <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> <td class="struct_member_annotations"> </td> </tr> </tbody> </table></div> </div> </div> <hr> <div class="refsect2"> <a name="PangoFontset-struct"></a><h3>struct PangoFontset</h3> <pre class="programlisting">struct PangoFontset;</pre> <div class="warning"><p><code class="literal">PangoFontset</code> is deprecated and should not be used in newly-written code.</p></div> <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 when rendering text. It is the result of resolving a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> against a particular <a class="link" href="pango-Contexts.html#PangoContext"><span class="type">PangoContext</span></a>. It has operations for finding the component font for a particular Unicode character, and for finding a composite set of metrics for the entire fontset.</p> </div> <hr> <div class="refsect2"> <a name="PangoFontsetClass"></a><h3>struct PangoFontsetClass</h3> <pre class="programlisting">struct PangoFontsetClass { GObjectClass parent_class; PangoFont * (*get_font) (PangoFontset *fontset, guint wc); PangoFontMetrics *(*get_metrics) (PangoFontset *fontset); PangoLanguage * (*get_language) (PangoFontset *fontset); void (*foreach) (PangoFontset *fontset, PangoFontsetForeachFunc func, gpointer data); }; </pre> <div class="warning"><p><code class="literal">PangoFontsetClass</code> is deprecated and should not be used in newly-written code.</p></div> <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 a particular <a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a> implementation.</p> <div class="refsect3"> <a name="PangoFontsetClass.members"></a><h4>Members</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="300px" class="struct_members_name"> <col class="struct_members_description"> <col width="200px" class="struct_members_annotations"> </colgroup> <tbody> <tr> <td class="struct_member_name"><p><em class="structfield"><code><a name="PangoFontsetClass.get-font"></a>get_font</code></em> ()</p></td> <td class="struct_member_description"><p>a function to get the font in the fontset that contains the 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>.</p></td> <td class="struct_member_annotations"> </td> </tr> <tr> <td class="struct_member_name"><p><em class="structfield"><code><a name="PangoFontsetClass.get-metrics"></a>get_metrics</code></em> ()</p></td> <td class="struct_member_description"><p>a function to get overall metric information for the fonts 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> <td class="struct_member_annotations"> </td> </tr> <tr> <td class="struct_member_name"><p><em class="structfield"><code><a name="PangoFontsetClass.get-language"></a>get_language</code></em> ()</p></td> <td class="struct_member_description"><p>a function to get the language of the fontset.</p></td> <td class="struct_member_annotations"> </td> </tr> <tr> <td class="struct_member_name"><p><em class="structfield"><code><a name="PangoFontsetClass.foreach"></a>foreach</code></em> ()</p></td> <td class="struct_member_description"><p>a function to loop over the fonts in the fontset. See <a class="link" href="pango-Fonts.html#pango-fontset-foreach" title="pango_fontset_foreach ()"><code class="function">pango_fontset_foreach()</code></a>.</p></td> <td class="struct_member_annotations"> </td> </tr> </tbody> </table></div> </div> </div> </div> </div> <div class="footer"> <hr>Generated by GTK-Doc V1.32</div> </body> </html>