pango 1.1.9-x86-mingw32 → 1.2.0-x86-mingw32
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- data/Rakefile +12 -1
- data/lib/1.8/pango.so +0 -0
- data/lib/1.9/pango.so +0 -0
- data/vendor/local/bin/libpango-1.0-0.dll +0 -0
- data/vendor/local/bin/libpangocairo-1.0-0.dll +0 -0
- data/vendor/local/bin/libpangowin32-1.0-0.dll +0 -0
- data/vendor/local/bin/pango-querymodules.exe +0 -0
- data/vendor/local/bin/pango-view.exe +0 -0
- data/vendor/local/etc/pango/pango.modules +14 -1
- data/vendor/local/include/pango-1.0/pango/pango-attributes.h +27 -2
- data/vendor/local/include/pango-1.0/pango/pango-bidi-type.h +1 -0
- data/vendor/local/include/pango-1.0/pango/pango-context.h +2 -1
- data/vendor/local/include/pango-1.0/pango/pango-engine.h +7 -5
- data/vendor/local/include/pango-1.0/pango/pango-enum-types.h +47 -38
- data/vendor/local/include/pango-1.0/pango/pango-features.h +3 -3
- data/vendor/local/include/pango-1.0/pango/pango-fontmap.h +4 -2
- data/vendor/local/include/pango-1.0/pango/pango-fontset.h +3 -3
- data/vendor/local/include/pango-1.0/pango/pango-glyph.h +7 -0
- data/vendor/local/include/pango-1.0/pango/pango-gravity.h +14 -0
- data/vendor/local/include/pango-1.0/pango/pango-layout.h +2 -1
- data/vendor/local/include/pango-1.0/pango/pango-matrix.h +2 -2
- data/vendor/local/include/pango-1.0/pango/pango-script.h +15 -1
- data/vendor/local/include/pango-1.0/pango/pango-utils.h +2 -0
- data/vendor/local/include/pango-1.0/pango/pangocairo.h +1 -0
- data/vendor/local/include/pango-1.0/pango/pangowin32.h +2 -0
- data/vendor/local/lib/libpango-1.0.dll.a +0 -0
- data/vendor/local/lib/libpango-1.0.la +41 -0
- data/vendor/local/lib/libpangocairo-1.0.dll.a +0 -0
- data/vendor/local/lib/libpangocairo-1.0.la +41 -0
- data/vendor/local/lib/libpangowin32-1.0.dll.a +0 -0
- data/vendor/local/lib/libpangowin32-1.0.la +41 -0
- data/vendor/local/lib/pango/1.8.0/modules/pango-arabic-lang.dll +0 -0
- data/vendor/local/lib/pango/1.8.0/modules/pango-arabic-lang.dll.a +0 -0
- data/vendor/local/lib/pango/1.8.0/modules/pango-arabic-lang.la +41 -0
- data/vendor/local/lib/pango/1.8.0/modules/pango-basic-win32.dll +0 -0
- data/vendor/local/lib/pango/1.8.0/modules/pango-basic-win32.dll.a +0 -0
- data/vendor/local/lib/pango/1.8.0/modules/pango-basic-win32.la +41 -0
- data/vendor/local/lib/pango/1.8.0/modules/pango-indic-lang.dll +0 -0
- data/vendor/local/lib/pango/1.8.0/modules/pango-indic-lang.dll.a +0 -0
- data/vendor/local/lib/pango/1.8.0/modules/pango-indic-lang.la +41 -0
- data/vendor/local/lib/pkgconfig/pango.pc +5 -4
- data/vendor/local/lib/pkgconfig/pangocairo.pc +2 -2
- data/vendor/local/lib/pkgconfig/pangowin32.pc +1 -1
- data/vendor/local/share/gtk-doc/html/pango/PangoEngineLang.html +17 -11
- data/vendor/local/share/gtk-doc/html/pango/PangoEngineShape.html +23 -15
- data/vendor/local/share/gtk-doc/html/pango/PangoFcDecoder.html +18 -9
- data/vendor/local/share/gtk-doc/html/pango/PangoFcFont.html +56 -28
- data/vendor/local/share/gtk-doc/html/pango/PangoFcFontMap.html +103 -49
- data/vendor/local/share/gtk-doc/html/pango/PangoMarkupFormat.html +32 -20
- data/vendor/local/share/gtk-doc/html/pango/annotation-glossary.html +96 -0
- data/vendor/local/share/gtk-doc/html/pango/api-index-1-10.html +140 -0
- data/vendor/local/share/gtk-doc/html/pango/api-index-1-12.html +54 -0
- data/vendor/local/share/gtk-doc/html/pango/api-index-1-14.html +69 -0
- data/vendor/local/share/gtk-doc/html/pango/api-index-1-16.html +229 -0
- data/vendor/local/share/gtk-doc/html/pango/api-index-1-18.html +157 -0
- data/vendor/local/share/gtk-doc/html/pango/api-index-1-2.html +127 -0
- data/vendor/local/share/gtk-doc/html/pango/api-index-1-20.html +99 -0
- data/vendor/local/share/gtk-doc/html/pango/api-index-1-22.html +129 -0
- data/vendor/local/share/gtk-doc/html/pango/api-index-1-24.html +91 -0
- data/vendor/local/share/gtk-doc/html/pango/api-index-1-26.html +51 -0
- data/vendor/local/share/gtk-doc/html/pango/{index-1.28.html → api-index-1-28.html} +9 -9
- data/vendor/local/share/gtk-doc/html/pango/api-index-1-30.html +42 -0
- data/vendor/local/share/gtk-doc/html/pango/api-index-1-32.html +46 -0
- data/vendor/local/share/gtk-doc/html/pango/api-index-1-4.html +206 -0
- data/vendor/local/share/gtk-doc/html/pango/api-index-1-6.html +170 -0
- data/vendor/local/share/gtk-doc/html/pango/api-index-1-8.html +176 -0
- data/vendor/local/share/gtk-doc/html/pango/api-index-deprecated.html +150 -0
- data/vendor/local/share/gtk-doc/html/pango/api-index-full.html +2965 -0
- data/vendor/local/share/gtk-doc/html/pango/index.html +25 -26
- data/vendor/local/share/gtk-doc/html/pango/index.sgml +36 -37
- data/vendor/local/share/gtk-doc/html/pango/lowlevel.html +8 -8
- data/vendor/local/share/gtk-doc/html/pango/pango-Bidirectional-Text.html +42 -24
- data/vendor/local/share/gtk-doc/html/pango/pango-Cairo-Rendering.html +222 -123
- data/vendor/local/share/gtk-doc/html/pango/pango-CoreText-Fonts.html +94 -0
- data/vendor/local/share/gtk-doc/html/pango/pango-Coverage-Maps.html +61 -26
- data/vendor/local/share/gtk-doc/html/pango/pango-Engines.html +34 -19
- data/vendor/local/share/gtk-doc/html/pango/pango-Fonts.html +536 -228
- data/vendor/local/share/gtk-doc/html/pango/pango-FreeType-Fonts-and-Rendering.html +90 -36
- data/vendor/local/share/gtk-doc/html/pango/pango-Glyph-Storage.html +291 -130
- data/vendor/local/share/gtk-doc/html/pango/pango-Layout-Objects.html +564 -256
- data/vendor/local/share/gtk-doc/html/pango/pango-Miscellaneous-Utilities.html +206 -110
- data/vendor/local/share/gtk-doc/html/pango/pango-Modules.html +32 -17
- data/vendor/local/share/gtk-doc/html/pango/pango-OpenType-Font-Handling.html +261 -144
- data/vendor/local/share/gtk-doc/html/pango/pango-Scripts-and-Languages.html +175 -65
- data/vendor/local/share/gtk-doc/html/pango/pango-Tab-Stops.html +89 -52
- data/vendor/local/share/gtk-doc/html/pango/pango-Text-Attributes.html +602 -258
- data/vendor/local/share/gtk-doc/html/pango/pango-Text-Processing.html +359 -114
- data/vendor/local/share/gtk-doc/html/pango/pango-Version-Checking.html +27 -12
- data/vendor/local/share/gtk-doc/html/pango/pango-Vertical-Text.html +65 -16
- data/vendor/local/share/gtk-doc/html/pango/pango-Win32-Fonts-and-Rendering.html +117 -48
- data/vendor/local/share/gtk-doc/html/pango/pango-Xft-Fonts-and-Rendering.html +127 -61
- data/vendor/local/share/gtk-doc/html/pango/pango-hierarchy.html +12 -12
- data/vendor/local/share/gtk-doc/html/pango/pango-pango-renderer.html +99 -38
- data/vendor/local/share/gtk-doc/html/pango/pango-querymodules.html +77 -17
- data/vendor/local/share/gtk-doc/html/pango/pango.devhelp2 +45 -52
- data/vendor/local/share/gtk-doc/html/pango/pango.html +6 -6
- data/vendor/local/share/gtk-doc/html/pango/rendering.html +7 -10
- data/vendor/local/share/gtk-doc/html/pango/tools.html +6 -6
- data/vendor/local/share/license/pango/AUTHORS +2 -0
- data/vendor/local/share/{doc/pango-1.29.4 → license/pango}/COPYING +0 -0
- data/vendor/local/share/man/man1/pango-querymodules.1 +67 -16
- data/vendor/local/share/man/man1/pango-view.1 +4 -4
- metadata +43 -50
- data/vendor/local/bin/libpangoft2-1.0-0.dll +0 -0
- data/vendor/local/include/pango-1.0/pango/pango-ot.h +0 -197
- data/vendor/local/include/pango-1.0/pango/pangofc-decoder.h +0 -110
- data/vendor/local/include/pango-1.0/pango/pangofc-font.h +0 -151
- data/vendor/local/include/pango-1.0/pango/pangofc-fontmap.h +0 -270
- data/vendor/local/include/pango-1.0/pango/pangoft2.h +0 -112
- data/vendor/local/lib/libpangoft2-1.0.dll.a +0 -0
- data/vendor/local/lib/pango-1.0.def +0 -397
- data/vendor/local/lib/pango-1.0.lib +0 -0
- data/vendor/local/lib/pangocairo-1.0.def +0 -34
- data/vendor/local/lib/pangocairo-1.0.lib +0 -0
- data/vendor/local/lib/pangoft2-1.0.def +0 -85
- data/vendor/local/lib/pangoft2-1.0.lib +0 -0
- data/vendor/local/lib/pangowin32-1.0.def +0 -30
- data/vendor/local/lib/pangowin32-1.0.lib +0 -0
- data/vendor/local/lib/pkgconfig/pangoft2.pc +0 -11
- data/vendor/local/manifest/pango-dev_1.29.4-1_win32.mft +0 -116
- data/vendor/local/manifest/pango_1.29.4-1_win32.mft +0 -8
- data/vendor/local/share/doc/pango-dev-1.29.4/COPYING +0 -482
- data/vendor/local/share/gtk-doc/html/pango/index-1.10.html +0 -81
- data/vendor/local/share/gtk-doc/html/pango/index-1.12.html +0 -41
- data/vendor/local/share/gtk-doc/html/pango/index-1.14.html +0 -47
- data/vendor/local/share/gtk-doc/html/pango/index-1.16.html +0 -115
- data/vendor/local/share/gtk-doc/html/pango/index-1.18.html +0 -91
- data/vendor/local/share/gtk-doc/html/pango/index-1.2.html +0 -73
- data/vendor/local/share/gtk-doc/html/pango/index-1.20.html +0 -59
- data/vendor/local/share/gtk-doc/html/pango/index-1.22.html +0 -71
- data/vendor/local/share/gtk-doc/html/pango/index-1.24.html +0 -59
- data/vendor/local/share/gtk-doc/html/pango/index-1.26.html +0 -39
- data/vendor/local/share/gtk-doc/html/pango/index-1.30.html +0 -38
- data/vendor/local/share/gtk-doc/html/pango/index-1.4.html +0 -111
- data/vendor/local/share/gtk-doc/html/pango/index-1.6.html +0 -91
- data/vendor/local/share/gtk-doc/html/pango/index-1.8.html +0 -99
- data/vendor/local/share/gtk-doc/html/pango/index-all.html +0 -1514
- data/vendor/local/share/gtk-doc/html/pango/index-deprecated.html +0 -137
- data/vendor/local/share/gtk-doc/html/pango/pango-ATSUI-Fonts.html +0 -57
- data/vendor/local/share/gtk-doc/html/pango/pango-X-Fonts-and-Rendering.html +0 -1023
- data/vendor/local/src/dieterv/packaging/pango_1.29.4-1_win32.log +0 -806
- data/vendor/local/src/dieterv/packaging/pango_1.29.4-1_win32.sh +0 -56
|
@@ -3,12 +3,12 @@
|
|
|
3
3
|
<head>
|
|
4
4
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
|
5
5
|
<title>Rendering</title>
|
|
6
|
-
<meta name="generator" content="DocBook XSL Stylesheets V1.
|
|
6
|
+
<meta name="generator" content="DocBook XSL Stylesheets V1.78.0">
|
|
7
7
|
<link rel="home" href="index.html" title="Pango Reference Manual">
|
|
8
8
|
<link rel="up" href="pango.html" title="Basic Pango Interfaces">
|
|
9
9
|
<link rel="prev" href="pango.html" title="Basic Pango Interfaces">
|
|
10
10
|
<link rel="next" href="pango-Glyph-Storage.html" title="Glyph Storage">
|
|
11
|
-
<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
|
|
11
|
+
<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
|
|
12
12
|
<link rel="stylesheet" href="style.css" type="text/css">
|
|
13
13
|
</head>
|
|
14
14
|
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
|
@@ -45,13 +45,13 @@ struct <a class="link" href="pango-Text-Processing.html#PangoAnalys
|
|
|
45
45
|
#define <a class="link" href="pango-Text-Processing.html#PANGO-ANALYSIS-FLAG-CENTERED-BASELINE:CAPS" title="PANGO_ANALYSIS_FLAG_CENTERED_BASELINE">PANGO_ANALYSIS_FLAG_CENTERED_BASELINE</a>
|
|
46
46
|
#define <a class="link" href="pango-Text-Processing.html#PANGO-TYPE-DIRECTION:CAPS" title="PANGO_TYPE_DIRECTION">PANGO_TYPE_DIRECTION</a>
|
|
47
47
|
|
|
48
|
-
<
|
|
48
|
+
<span class="returnvalue">GList</span> * <a class="link" href="pango-Text-Processing.html#pango-itemize" title="pango_itemize ()">pango_itemize</a> (<em class="parameter"><code><a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> *context</code></em>,
|
|
49
49
|
<em class="parameter"><code>const <span class="type">char</span> *text</code></em>,
|
|
50
50
|
<em class="parameter"><code><span class="type">int</span> start_index</code></em>,
|
|
51
51
|
<em class="parameter"><code><span class="type">int</span> length</code></em>,
|
|
52
52
|
<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> *attrs</code></em>,
|
|
53
53
|
<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a> *cached_iter</code></em>);
|
|
54
|
-
<
|
|
54
|
+
<span class="returnvalue">GList</span> * <a class="link" href="pango-Text-Processing.html#pango-itemize-with-base-dir" title="pango_itemize_with_base_dir ()">pango_itemize_with_base_dir</a> (<em class="parameter"><code><a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> *context</code></em>,
|
|
55
55
|
<em class="parameter"><code><a class="link" href="pango-Bidirectional-Text.html#PangoDirection"><span class="type">PangoDirection</span></a> base_dir</code></em>,
|
|
56
56
|
<em class="parameter"><code>const <span class="type">char</span> *text</code></em>,
|
|
57
57
|
<em class="parameter"><code><span class="type">int</span> start_index</code></em>,
|
|
@@ -64,9 +64,11 @@ struct <a class="link" href="pango-Text-Processing.html#PangoAnalys
|
|
|
64
64
|
<a class="link" href="pango-Text-Processing.html#PangoItem"><span class="returnvalue">PangoItem</span></a> * <a class="link" href="pango-Text-Processing.html#pango-item-split" title="pango_item_split ()">pango_item_split</a> (<em class="parameter"><code><a class="link" href="pango-Text-Processing.html#PangoItem"><span class="type">PangoItem</span></a> *orig</code></em>,
|
|
65
65
|
<em class="parameter"><code><span class="type">int</span> split_index</code></em>,
|
|
66
66
|
<em class="parameter"><code><span class="type">int</span> split_offset</code></em>);
|
|
67
|
-
<
|
|
67
|
+
<span class="returnvalue">GList</span> * <a class="link" href="pango-Text-Processing.html#pango-reorder-items" title="pango_reorder_items ()">pango_reorder_items</a> (<em class="parameter"><code><span class="type">GList</span> *logical_items</code></em>);
|
|
68
68
|
|
|
69
69
|
<a class="link" href="pango-Text-Processing.html#PangoContext"><span class="returnvalue">PangoContext</span></a> * <a class="link" href="pango-Text-Processing.html#pango-context-new" title="pango_context_new ()">pango_context_new</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
|
|
70
|
+
<span class="returnvalue">void</span> <a class="link" href="pango-Text-Processing.html#pango-context-changed" title="pango_context_changed ()">pango_context_changed</a> (<em class="parameter"><code><a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> *context</code></em>);
|
|
71
|
+
<span class="returnvalue">guint</span> <a class="link" href="pango-Text-Processing.html#pango-context-get-serial" title="pango_context_get_serial ()">pango_context_get_serial</a> (<em class="parameter"><code><a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> *context</code></em>);
|
|
70
72
|
<span class="returnvalue">void</span> <a class="link" href="pango-Text-Processing.html#pango-context-set-font-map" title="pango_context_set_font_map ()">pango_context_set_font_map</a> (<em class="parameter"><code><a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> *context</code></em>,
|
|
71
73
|
<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> *font_map</code></em>);
|
|
72
74
|
<a class="link" href="pango-Fonts.html#PangoFontMap"><span class="returnvalue">PangoFontMap</span></a> * <a class="link" href="pango-Text-Processing.html#pango-context-get-font-map" title="pango_context_get_font_map ()">pango_context_get_font_map</a> (<em class="parameter"><code><a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> *context</code></em>);
|
|
@@ -103,7 +105,7 @@ const <a class="link" href="pango-Glyph-Storage.html#PangoMatrix"><span class="r
|
|
|
103
105
|
<em class="parameter"><code><span class="type">int</span> *n_families</code></em>);
|
|
104
106
|
|
|
105
107
|
|
|
106
|
-
<span class="returnvalue">void</span> <a class="link" href="pango-Text-Processing.html#pango-break" title="pango_break ()">pango_break</a> (<em class="parameter"><code>const <
|
|
108
|
+
<span class="returnvalue">void</span> <a class="link" href="pango-Text-Processing.html#pango-break" title="pango_break ()">pango_break</a> (<em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>,
|
|
107
109
|
<em class="parameter"><code><span class="type">int</span> length</code></em>,
|
|
108
110
|
<em class="parameter"><code><a class="link" href="pango-Text-Processing.html#PangoAnalysis" title="struct PangoAnalysis"><span class="type">PangoAnalysis</span></a> *analysis</code></em>,
|
|
109
111
|
<em class="parameter"><code><a class="link" href="pango-Text-Processing.html#PangoLogAttr" title="PangoLogAttr"><span class="type">PangoLogAttr</span></a> *attrs</code></em>,
|
|
@@ -114,19 +116,25 @@ const <a class="link" href="pango-Glyph-Storage.html#PangoMatrix"><span class="r
|
|
|
114
116
|
<em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> *language</code></em>,
|
|
115
117
|
<em class="parameter"><code><a class="link" href="pango-Text-Processing.html#PangoLogAttr" title="PangoLogAttr"><span class="type">PangoLogAttr</span></a> *log_attrs</code></em>,
|
|
116
118
|
<em class="parameter"><code><span class="type">int</span> attrs_len</code></em>);
|
|
117
|
-
<span class="returnvalue">void</span> <a class="link" href="pango-Text-Processing.html#pango-find-paragraph-boundary" title="pango_find_paragraph_boundary ()">pango_find_paragraph_boundary</a> (<em class="parameter"><code>const <
|
|
118
|
-
<em class="parameter"><code><
|
|
119
|
-
<em class="parameter"><code><
|
|
120
|
-
<em class="parameter"><code><
|
|
121
|
-
<span class="returnvalue">void</span> <a class="link" href="pango-Text-Processing.html#pango-default-break" title="pango_default_break ()">pango_default_break</a> (<em class="parameter"><code>const <
|
|
119
|
+
<span class="returnvalue">void</span> <a class="link" href="pango-Text-Processing.html#pango-find-paragraph-boundary" title="pango_find_paragraph_boundary ()">pango_find_paragraph_boundary</a> (<em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>,
|
|
120
|
+
<em class="parameter"><code><span class="type">gint</span> length</code></em>,
|
|
121
|
+
<em class="parameter"><code><span class="type">gint</span> *paragraph_delimiter_index</code></em>,
|
|
122
|
+
<em class="parameter"><code><span class="type">gint</span> *next_paragraph_start</code></em>);
|
|
123
|
+
<span class="returnvalue">void</span> <a class="link" href="pango-Text-Processing.html#pango-default-break" title="pango_default_break ()">pango_default_break</a> (<em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>,
|
|
122
124
|
<em class="parameter"><code><span class="type">int</span> length</code></em>,
|
|
123
125
|
<em class="parameter"><code><a class="link" href="pango-Text-Processing.html#PangoAnalysis" title="struct PangoAnalysis"><span class="type">PangoAnalysis</span></a> *analysis</code></em>,
|
|
124
126
|
<em class="parameter"><code><a class="link" href="pango-Text-Processing.html#PangoLogAttr" title="PangoLogAttr"><span class="type">PangoLogAttr</span></a> *attrs</code></em>,
|
|
125
127
|
<em class="parameter"><code><span class="type">int</span> attrs_len</code></em>);
|
|
126
128
|
<a class="link" href="pango-Text-Processing.html#PangoLogAttr" title="PangoLogAttr">PangoLogAttr</a>;
|
|
127
129
|
|
|
128
|
-
<span class="returnvalue">void</span> <a class="link" href="pango-Text-Processing.html#pango-shape" title="pango_shape ()">pango_shape</a> (<em class="parameter"><code>const <
|
|
129
|
-
<em class="parameter"><code><
|
|
130
|
+
<span class="returnvalue">void</span> <a class="link" href="pango-Text-Processing.html#pango-shape" title="pango_shape ()">pango_shape</a> (<em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>,
|
|
131
|
+
<em class="parameter"><code><span class="type">gint</span> length</code></em>,
|
|
132
|
+
<em class="parameter"><code>const <a class="link" href="pango-Text-Processing.html#PangoAnalysis" title="struct PangoAnalysis"><span class="type">PangoAnalysis</span></a> *analysis</code></em>,
|
|
133
|
+
<em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoGlyphString"><span class="type">PangoGlyphString</span></a> *glyphs</code></em>);
|
|
134
|
+
<span class="returnvalue">void</span> <a class="link" href="pango-Text-Processing.html#pango-shape-full" title="pango_shape_full ()">pango_shape_full</a> (<em class="parameter"><code>const <span class="type">gchar</span> *item_text</code></em>,
|
|
135
|
+
<em class="parameter"><code><span class="type">gint</span> item_length</code></em>,
|
|
136
|
+
<em class="parameter"><code>const <span class="type">gchar</span> *paragraph_text</code></em>,
|
|
137
|
+
<em class="parameter"><code><span class="type">gint</span> paragraph_length</code></em>,
|
|
130
138
|
<em class="parameter"><code>const <a class="link" href="pango-Text-Processing.html#PangoAnalysis" title="struct PangoAnalysis"><span class="type">PangoAnalysis</span></a> *analysis</code></em>,
|
|
131
139
|
<em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoGlyphString"><span class="type">PangoGlyphString</span></a> *glyphs</code></em>);
|
|
132
140
|
</pre>
|
|
@@ -134,7 +142,7 @@ const <a class="link" href="pango-Glyph-Storage.html#PangoMatrix"><span class="r
|
|
|
134
142
|
<div class="refsect1">
|
|
135
143
|
<a name="pango-Text-Processing.object-hierarchy"></a><h2>Object Hierarchy</h2>
|
|
136
144
|
<pre class="synopsis">
|
|
137
|
-
|
|
145
|
+
GObject
|
|
138
146
|
+----PangoContext
|
|
139
147
|
</pre>
|
|
140
148
|
<pre class="synopsis">
|
|
@@ -199,8 +207,11 @@ The <a class="link" href="pango-Text-Processing.html#PangoAnalysis" title="struc
|
|
|
199
207
|
the properties of a segment of text. It has the following
|
|
200
208
|
fields:
|
|
201
209
|
</p>
|
|
202
|
-
<div class="variablelist"><table border="0">
|
|
210
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
|
211
|
+
<colgroup>
|
|
203
212
|
<col align="left" valign="top">
|
|
213
|
+
<col>
|
|
214
|
+
</colgroup>
|
|
204
215
|
<tbody>
|
|
205
216
|
<tr>
|
|
206
217
|
<td><p><span class="term"><a class="link" href="PangoEngineShape.html" title="PangoEngineShape"><span class="type">PangoEngineShape</span></a> *<em class="structfield"><code><a name="PangoAnalysis.shape-engine"></a>shape_engine</code></em>;</span></p></td>
|
|
@@ -215,19 +226,19 @@ fields:
|
|
|
215
226
|
<td>the font for this segment.</td>
|
|
216
227
|
</tr>
|
|
217
228
|
<tr>
|
|
218
|
-
<td><p><span class="term"><
|
|
229
|
+
<td><p><span class="term"><span class="type">guint8</span> <em class="structfield"><code><a name="PangoAnalysis.level"></a>level</code></em>;</span></p></td>
|
|
219
230
|
<td>the bidirectional level for this segment.</td>
|
|
220
231
|
</tr>
|
|
221
232
|
<tr>
|
|
222
|
-
<td><p><span class="term"><
|
|
233
|
+
<td><p><span class="term"><span class="type">guint8</span> <em class="structfield"><code><a name="PangoAnalysis.gravity"></a>gravity</code></em>;</span></p></td>
|
|
223
234
|
<td>the glyph orientation for this segment (A <a class="link" href="pango-Vertical-Text.html#PangoGravity"><span class="type">PangoGravity</span></a>).</td>
|
|
224
235
|
</tr>
|
|
225
236
|
<tr>
|
|
226
|
-
<td><p><span class="term"><
|
|
237
|
+
<td><p><span class="term"><span class="type">guint8</span> <em class="structfield"><code><a name="PangoAnalysis.flags"></a>flags</code></em>;</span></p></td>
|
|
227
238
|
<td>boolean flags for this segment (currently only one) (Since: 1.16).</td>
|
|
228
239
|
</tr>
|
|
229
240
|
<tr>
|
|
230
|
-
<td><p><span class="term"><
|
|
241
|
+
<td><p><span class="term"><span class="type">guint8</span> <em class="structfield"><code><a name="PangoAnalysis.script"></a>script</code></em>;</span></p></td>
|
|
231
242
|
<td>the detected script for this segment (A <a class="link" href="pango-Scripts-and-Languages.html#PangoScript"><span class="type">PangoScript</span></a>) (Since: 1.18).</td>
|
|
232
243
|
</tr>
|
|
233
244
|
<tr>
|
|
@@ -235,7 +246,7 @@ fields:
|
|
|
235
246
|
<td>the detected language for this segment.</td>
|
|
236
247
|
</tr>
|
|
237
248
|
<tr>
|
|
238
|
-
<td><p><span class="term"><
|
|
249
|
+
<td><p><span class="term"><span class="type">GSList</span> *<em class="structfield"><code><a name="PangoAnalysis.extra-attrs"></a>extra_attrs</code></em>;</span></p></td>
|
|
239
250
|
<td>extra attributes for this segment.</td>
|
|
240
251
|
</tr>
|
|
241
252
|
</tbody>
|
|
@@ -255,16 +266,16 @@ Since: 1.16
|
|
|
255
266
|
<hr>
|
|
256
267
|
<div class="refsect2">
|
|
257
268
|
<a name="PANGO-TYPE-DIRECTION:CAPS"></a><h3>PANGO_TYPE_DIRECTION</h3>
|
|
258
|
-
<pre class="programlisting">#define PANGO_TYPE_DIRECTION (pango_direction_get_type())
|
|
269
|
+
<pre class="programlisting">#define PANGO_TYPE_DIRECTION (pango_direction_get_type ())
|
|
259
270
|
</pre>
|
|
260
271
|
<p>
|
|
261
|
-
The <
|
|
272
|
+
The <span class="type">GObject</span> type for <a class="link" href="pango-Bidirectional-Text.html#PangoDirection"><span class="type">PangoDirection</span></a>.
|
|
262
273
|
</p>
|
|
263
274
|
</div>
|
|
264
275
|
<hr>
|
|
265
276
|
<div class="refsect2">
|
|
266
277
|
<a name="pango-itemize"></a><h3>pango_itemize ()</h3>
|
|
267
|
-
<pre class="programlisting"><
|
|
278
|
+
<pre class="programlisting"><span class="returnvalue">GList</span> * pango_itemize (<em class="parameter"><code><a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> *context</code></em>,
|
|
268
279
|
<em class="parameter"><code>const <span class="type">char</span> *text</code></em>,
|
|
269
280
|
<em class="parameter"><code><span class="type">int</span> start_index</code></em>,
|
|
270
281
|
<em class="parameter"><code><span class="type">int</span> length</code></em>,
|
|
@@ -283,8 +294,11 @@ range before or containing <em class="parameter"><code>start_index</code></em>;
|
|
|
283
294
|
the range covering the position just after <em class="parameter"><code>start_index</code></em> + <em class="parameter"><code>length</code></em>.
|
|
284
295
|
(i.e. if itemizing in a loop, just keep passing in the same <em class="parameter"><code>cached_iter</code></em>).
|
|
285
296
|
</p>
|
|
286
|
-
<div class="variablelist"><table border="0">
|
|
297
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
|
298
|
+
<colgroup>
|
|
287
299
|
<col align="left" valign="top">
|
|
300
|
+
<col>
|
|
301
|
+
</colgroup>
|
|
288
302
|
<tbody>
|
|
289
303
|
<tr>
|
|
290
304
|
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
|
|
@@ -311,15 +325,15 @@ This must be >= 0.</td>
|
|
|
311
325
|
</tr>
|
|
312
326
|
<tr>
|
|
313
327
|
<td><p><span class="term"><em class="parameter"><code>cached_iter</code></em> :</span></p></td>
|
|
314
|
-
<td>Cached attribute iterator, or <a href="/
|
|
328
|
+
<td>Cached attribute iterator, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
|
|
315
329
|
</td>
|
|
316
330
|
</tr>
|
|
317
331
|
<tr>
|
|
318
332
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
319
|
-
<td>a <
|
|
333
|
+
<td>a <span class="type">GList</span> of <a class="link" href="pango-Text-Processing.html#PangoItem"><span class="type">PangoItem</span></a>
|
|
320
334
|
structures. The items should be freed using <a class="link" href="pango-Text-Processing.html#pango-item-free" title="pango_item_free ()"><code class="function">pango_item_free()</code></a>
|
|
321
|
-
probably in combination with <
|
|
322
|
-
using <
|
|
335
|
+
probably in combination with <code class="function">g_list_foreach()</code>, and the list itself
|
|
336
|
+
using <code class="function">g_list_free()</code>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> Pango.Item]</span>
|
|
323
337
|
</td>
|
|
324
338
|
</tr>
|
|
325
339
|
</tbody>
|
|
@@ -328,7 +342,7 @@ using <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-L
|
|
|
328
342
|
<hr>
|
|
329
343
|
<div class="refsect2">
|
|
330
344
|
<a name="pango-itemize-with-base-dir"></a><h3>pango_itemize_with_base_dir ()</h3>
|
|
331
|
-
<pre class="programlisting"><
|
|
345
|
+
<pre class="programlisting"><span class="returnvalue">GList</span> * pango_itemize_with_base_dir (<em class="parameter"><code><a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> *context</code></em>,
|
|
332
346
|
<em class="parameter"><code><a class="link" href="pango-Bidirectional-Text.html#PangoDirection"><span class="type">PangoDirection</span></a> base_dir</code></em>,
|
|
333
347
|
<em class="parameter"><code>const <span class="type">char</span> *text</code></em>,
|
|
334
348
|
<em class="parameter"><code><span class="type">int</span> start_index</code></em>,
|
|
@@ -340,8 +354,11 @@ Like <a class="link" href="pango-Text-Processing.html#pango-itemize" title="pang
|
|
|
340
354
|
computing bidirectional levels (see <a class="link" href="pango-Text-Processing.html#pango-context-set-base-dir" title="pango_context_set_base_dir ()"><code class="function">pango_context_set_base_dir()</code></a>),
|
|
341
355
|
is specified explicitly rather than gotten from the <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>.
|
|
342
356
|
</p>
|
|
343
|
-
<div class="variablelist"><table border="0">
|
|
357
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
|
358
|
+
<colgroup>
|
|
344
359
|
<col align="left" valign="top">
|
|
360
|
+
<col>
|
|
361
|
+
</colgroup>
|
|
345
362
|
<tbody>
|
|
346
363
|
<tr>
|
|
347
364
|
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
|
|
@@ -371,15 +388,15 @@ after <em class="parameter"><code>start_index</code></em>. This must be >= 0.
|
|
|
371
388
|
</tr>
|
|
372
389
|
<tr>
|
|
373
390
|
<td><p><span class="term"><em class="parameter"><code>cached_iter</code></em> :</span></p></td>
|
|
374
|
-
<td>Cached attribute iterator, or <a href="/
|
|
391
|
+
<td>Cached attribute iterator, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
|
|
375
392
|
</td>
|
|
376
393
|
</tr>
|
|
377
394
|
<tr>
|
|
378
395
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
379
|
-
<td>a <
|
|
396
|
+
<td>a <span class="type">GList</span> of
|
|
380
397
|
<a class="link" href="pango-Text-Processing.html#PangoItem"><span class="type">PangoItem</span></a> structures. The items should be freed using
|
|
381
398
|
<a class="link" href="pango-Text-Processing.html#pango-item-free" title="pango_item_free ()"><code class="function">pango_item_free()</code></a> probably in combination with
|
|
382
|
-
<
|
|
399
|
+
<code class="function">g_list_foreach()</code>, and the list itself using <code class="function">g_list_free()</code>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> Pango.Item]</span>
|
|
383
400
|
</td>
|
|
384
401
|
</tr>
|
|
385
402
|
</tbody>
|
|
@@ -393,11 +410,14 @@ after <em class="parameter"><code>start_index</code></em>. This must be >= 0.
|
|
|
393
410
|
<p>
|
|
394
411
|
Free a <a class="link" href="pango-Text-Processing.html#PangoItem"><span class="type">PangoItem</span></a> and all associated memory.
|
|
395
412
|
</p>
|
|
396
|
-
<div class="variablelist"><table border="0">
|
|
413
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
|
414
|
+
<colgroup>
|
|
397
415
|
<col align="left" valign="top">
|
|
416
|
+
<col>
|
|
417
|
+
</colgroup>
|
|
398
418
|
<tbody><tr>
|
|
399
419
|
<td><p><span class="term"><em class="parameter"><code>item</code></em> :</span></p></td>
|
|
400
|
-
<td>a <a class="link" href="pango-Text-Processing.html#PangoItem"><span class="type">PangoItem</span></a>, may be <a href="/
|
|
420
|
+
<td>a <a class="link" href="pango-Text-Processing.html#PangoItem"><span class="type">PangoItem</span></a>, may be <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>
|
|
401
421
|
</td>
|
|
402
422
|
</tr></tbody>
|
|
403
423
|
</table></div>
|
|
@@ -409,18 +429,21 @@ Free a <a class="link" href="pango-Text-Processing.html#PangoItem"><span class="
|
|
|
409
429
|
<p>
|
|
410
430
|
Copy an existing <a class="link" href="pango-Text-Processing.html#PangoItem"><span class="type">PangoItem</span></a> structure.
|
|
411
431
|
</p>
|
|
412
|
-
<div class="variablelist"><table border="0">
|
|
432
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
|
433
|
+
<colgroup>
|
|
413
434
|
<col align="left" valign="top">
|
|
435
|
+
<col>
|
|
436
|
+
</colgroup>
|
|
414
437
|
<tbody>
|
|
415
438
|
<tr>
|
|
416
439
|
<td><p><span class="term"><em class="parameter"><code>item</code></em> :</span></p></td>
|
|
417
|
-
<td>a <a class="link" href="pango-Text-Processing.html#PangoItem"><span class="type">PangoItem</span></a>, may be <a href="/
|
|
440
|
+
<td>a <a class="link" href="pango-Text-Processing.html#PangoItem"><span class="type">PangoItem</span></a>, may be <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>
|
|
418
441
|
</td>
|
|
419
442
|
</tr>
|
|
420
443
|
<tr>
|
|
421
444
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
422
445
|
<td>the newly allocated <a class="link" href="pango-Text-Processing.html#PangoItem"><span class="type">PangoItem</span></a>, which should
|
|
423
|
-
be freed with <a class="link" href="pango-Text-Processing.html#pango-item-free" title="pango_item_free ()"><code class="function">pango_item_free()</code></a>, or <a href="/
|
|
446
|
+
be freed with <a class="link" href="pango-Text-Processing.html#pango-item-free" title="pango_item_free ()"><code class="function">pango_item_free()</code></a>, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> if
|
|
424
447
|
<em class="parameter"><code>item</code></em> was NULL.</td>
|
|
425
448
|
</tr>
|
|
426
449
|
</tbody>
|
|
@@ -433,8 +456,11 @@ be freed with <a class="link" href="pango-Text-Processing.html#pango-item-free"
|
|
|
433
456
|
<p>
|
|
434
457
|
Creates a new <a class="link" href="pango-Text-Processing.html#PangoItem"><span class="type">PangoItem</span></a> structure initialized to default values.
|
|
435
458
|
</p>
|
|
436
|
-
<div class="variablelist"><table border="0">
|
|
459
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
|
460
|
+
<colgroup>
|
|
437
461
|
<col align="left" valign="top">
|
|
462
|
+
<col>
|
|
463
|
+
</colgroup>
|
|
438
464
|
<tbody><tr>
|
|
439
465
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
440
466
|
<td>the newly allocated <a class="link" href="pango-Text-Processing.html#PangoItem"><span class="type">PangoItem</span></a>, which should
|
|
@@ -460,8 +486,11 @@ chars, and must be provided because the text used to generate the
|
|
|
460
486
|
item isn't available, so <a class="link" href="pango-Text-Processing.html#pango-item-split" title="pango_item_split ()"><code class="function">pango_item_split()</code></a> can't count the char
|
|
461
487
|
length of the split items itself.
|
|
462
488
|
</p>
|
|
463
|
-
<div class="variablelist"><table border="0">
|
|
489
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
|
490
|
+
<colgroup>
|
|
464
491
|
<col align="left" valign="top">
|
|
492
|
+
<col>
|
|
493
|
+
</colgroup>
|
|
465
494
|
<tbody>
|
|
466
495
|
<tr>
|
|
467
496
|
<td><p><span class="term"><em class="parameter"><code>orig</code></em> :</span></p></td>
|
|
@@ -488,26 +517,30 @@ should be freed with <a class="link" href="pango-Text-Processing.html#pango-item
|
|
|
488
517
|
<hr>
|
|
489
518
|
<div class="refsect2">
|
|
490
519
|
<a name="pango-reorder-items"></a><h3>pango_reorder_items ()</h3>
|
|
491
|
-
<pre class="programlisting"><
|
|
520
|
+
<pre class="programlisting"><span class="returnvalue">GList</span> * pango_reorder_items (<em class="parameter"><code><span class="type">GList</span> *logical_items</code></em>);</pre>
|
|
492
521
|
<p>
|
|
493
522
|
From a list of items in logical order and the associated
|
|
494
523
|
directional levels, produce a list in visual order.
|
|
495
524
|
The original list is unmodified.
|
|
496
525
|
</p>
|
|
497
|
-
<div class="variablelist"><table border="0">
|
|
526
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
|
527
|
+
<colgroup>
|
|
498
528
|
<col align="left" valign="top">
|
|
529
|
+
<col>
|
|
530
|
+
</colgroup>
|
|
499
531
|
<tbody>
|
|
500
532
|
<tr>
|
|
501
533
|
<td><p><span class="term"><em class="parameter"><code>logical_items</code></em> :</span></p></td>
|
|
502
|
-
<td>a <
|
|
534
|
+
<td>a <span class="type">GList</span> of <a class="link" href="pango-Text-Processing.html#PangoItem"><span class="type">PangoItem</span></a> in logical order. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> Pango.Item]</span>
|
|
535
|
+
</td>
|
|
503
536
|
</tr>
|
|
504
537
|
<tr>
|
|
505
538
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
506
|
-
<td>a <
|
|
539
|
+
<td>a <span class="type">GList</span>
|
|
507
540
|
of <a class="link" href="pango-Text-Processing.html#PangoItem"><span class="type">PangoItem</span></a> structures in visual order.
|
|
508
541
|
(Please open a bug if you use this function.
|
|
509
542
|
It is not a particularly convenient interface, and the code
|
|
510
|
-
is duplicated elsewhere in Pango for that reason.). <span class="annotation">[<
|
|
543
|
+
is duplicated elsewhere in Pango for that reason.). <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> Pango.Item]</span>
|
|
511
544
|
</td>
|
|
512
545
|
</tr>
|
|
513
546
|
</tbody>
|
|
@@ -530,20 +563,86 @@ together and hence users are recommended to use that.
|
|
|
530
563
|
If you are using Pango as part of a higher-level system,
|
|
531
564
|
that system may have it's own way of create a <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>.
|
|
532
565
|
For instance, the GTK+ toolkit has, among others,
|
|
533
|
-
<a href="http://library.gnome.org/devel/
|
|
566
|
+
<a href="http://library.gnome.org/devel/gdk3/gdk2-Pango-Interaction.html#gdk-pango-context-get-for-screen"><code class="function">gdk_pango_context_get_for_screen()</code></a>, and
|
|
534
567
|
<a href="http://library.gnome.org/devel/gtk3/GtkWidget.html#gtk-widget-get-pango-context"><code class="function">gtk_widget_get_pango_context()</code></a>. Use those instead.
|
|
535
568
|
</p>
|
|
536
|
-
<div class="variablelist"><table border="0">
|
|
569
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
|
570
|
+
<colgroup>
|
|
537
571
|
<col align="left" valign="top">
|
|
572
|
+
<col>
|
|
573
|
+
</colgroup>
|
|
538
574
|
<tbody><tr>
|
|
539
575
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
540
576
|
<td>the newly allocated <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>, which should
|
|
541
|
-
be freed with <
|
|
577
|
+
be freed with <code class="function">g_object_unref()</code>.</td>
|
|
542
578
|
</tr></tbody>
|
|
543
579
|
</table></div>
|
|
544
580
|
</div>
|
|
545
581
|
<hr>
|
|
546
582
|
<div class="refsect2">
|
|
583
|
+
<a name="pango-context-changed"></a><h3>pango_context_changed ()</h3>
|
|
584
|
+
<pre class="programlisting"><span class="returnvalue">void</span> pango_context_changed (<em class="parameter"><code><a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> *context</code></em>);</pre>
|
|
585
|
+
<p>
|
|
586
|
+
Forces a change in the context, which will cause any <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a>
|
|
587
|
+
using this context to re-layout.
|
|
588
|
+
</p>
|
|
589
|
+
<p>
|
|
590
|
+
This function is only useful when implementing a new backend
|
|
591
|
+
for Pango, something applications won't do. Backends should
|
|
592
|
+
call this function if they have attached extra data to the context
|
|
593
|
+
and such data is changed.
|
|
594
|
+
</p>
|
|
595
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
|
596
|
+
<colgroup>
|
|
597
|
+
<col align="left" valign="top">
|
|
598
|
+
<col>
|
|
599
|
+
</colgroup>
|
|
600
|
+
<tbody><tr>
|
|
601
|
+
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
|
|
602
|
+
<td>a <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>
|
|
603
|
+
</td>
|
|
604
|
+
</tr></tbody>
|
|
605
|
+
</table></div>
|
|
606
|
+
<p class="since">Since 1.32.4</p>
|
|
607
|
+
</div>
|
|
608
|
+
<hr>
|
|
609
|
+
<div class="refsect2">
|
|
610
|
+
<a name="pango-context-get-serial"></a><h3>pango_context_get_serial ()</h3>
|
|
611
|
+
<pre class="programlisting"><span class="returnvalue">guint</span> pango_context_get_serial (<em class="parameter"><code><a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> *context</code></em>);</pre>
|
|
612
|
+
<p>
|
|
613
|
+
Returns the current serial number of <em class="parameter"><code>context</code></em>. The serial number is
|
|
614
|
+
initialized to an small number larger than zero when a new context
|
|
615
|
+
is created and is increased whenever the context is changed using any
|
|
616
|
+
of the setter functions, or the <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> it uses to find fonts has
|
|
617
|
+
changed. The serial may wrap, but will never have the value 0. Since it
|
|
618
|
+
can wrap, never compare it with "less than", always use "not equals".
|
|
619
|
+
</p>
|
|
620
|
+
<p>
|
|
621
|
+
This can be used to automatically detect changes to a <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>, and
|
|
622
|
+
is only useful when implementing objects that need update when their
|
|
623
|
+
<a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> changes, like <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a>.
|
|
624
|
+
</p>
|
|
625
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
|
626
|
+
<colgroup>
|
|
627
|
+
<col align="left" valign="top">
|
|
628
|
+
<col>
|
|
629
|
+
</colgroup>
|
|
630
|
+
<tbody>
|
|
631
|
+
<tr>
|
|
632
|
+
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
|
|
633
|
+
<td>a <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>
|
|
634
|
+
</td>
|
|
635
|
+
</tr>
|
|
636
|
+
<tr>
|
|
637
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
638
|
+
<td>The current serial number of <em class="parameter"><code>context</code></em>.</td>
|
|
639
|
+
</tr>
|
|
640
|
+
</tbody>
|
|
641
|
+
</table></div>
|
|
642
|
+
<p class="since">Since 1.32.4</p>
|
|
643
|
+
</div>
|
|
644
|
+
<hr>
|
|
645
|
+
<div class="refsect2">
|
|
547
646
|
<a name="pango-context-set-font-map"></a><h3>pango_context_set_font_map ()</h3>
|
|
548
647
|
<pre class="programlisting"><span class="returnvalue">void</span> pango_context_set_font_map (<em class="parameter"><code><a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> *context</code></em>,
|
|
549
648
|
<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> *font_map</code></em>);</pre>
|
|
@@ -552,8 +651,11 @@ Sets the font map to be searched when fonts are looked-up in this context.
|
|
|
552
651
|
This is only for internal use by Pango backends, a <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> obtained
|
|
553
652
|
via one of the recommended methods should already have a suitable font map.
|
|
554
653
|
</p>
|
|
555
|
-
<div class="variablelist"><table border="0">
|
|
654
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
|
655
|
+
<colgroup>
|
|
556
656
|
<col align="left" valign="top">
|
|
657
|
+
<col>
|
|
658
|
+
</colgroup>
|
|
557
659
|
<tbody>
|
|
558
660
|
<tr>
|
|
559
661
|
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
|
|
@@ -574,8 +676,11 @@ via one of the recommended methods should already have a suitable font map.
|
|
|
574
676
|
<p>
|
|
575
677
|
Gets the <span class="type">PangoFontmap</span> used to look up fonts for this context.
|
|
576
678
|
</p>
|
|
577
|
-
<div class="variablelist"><table border="0">
|
|
679
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
|
680
|
+
<colgroup>
|
|
578
681
|
<col align="left" valign="top">
|
|
682
|
+
<col>
|
|
683
|
+
</colgroup>
|
|
579
684
|
<tbody>
|
|
580
685
|
<tr>
|
|
581
686
|
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
|
|
@@ -585,7 +690,7 @@ Gets the <span class="type">PangoFontmap</span> used to look up fonts for this c
|
|
|
585
690
|
<tr>
|
|
586
691
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
587
692
|
<td>the font map for the <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>.
|
|
588
|
-
This value is owned by Pango and should not be unreferenced. <span class="annotation">[<
|
|
693
|
+
This value is owned by Pango and should not be unreferenced. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
|
|
589
694
|
</td>
|
|
590
695
|
</tr>
|
|
591
696
|
</tbody>
|
|
@@ -600,8 +705,11 @@ This value is owned by Pango and should not be unreferenced. <span class="annota
|
|
|
600
705
|
<p>
|
|
601
706
|
Retrieve the default font description for the context.
|
|
602
707
|
</p>
|
|
603
|
-
<div class="variablelist"><table border="0">
|
|
708
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
|
709
|
+
<colgroup>
|
|
604
710
|
<col align="left" valign="top">
|
|
711
|
+
<col>
|
|
712
|
+
</colgroup>
|
|
605
713
|
<tbody>
|
|
606
714
|
<tr>
|
|
607
715
|
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
|
|
@@ -610,8 +718,9 @@ Retrieve the default font description for the context.
|
|
|
610
718
|
</tr>
|
|
611
719
|
<tr>
|
|
612
720
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
613
|
-
<td>a pointer to the context's default font
|
|
614
|
-
This value must not be modified or freed
|
|
721
|
+
<td>a pointer to the context's default font
|
|
722
|
+
description. This value must not be modified or freed. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
|
|
723
|
+
</td>
|
|
615
724
|
</tr>
|
|
616
725
|
</tbody>
|
|
617
726
|
</table></div>
|
|
@@ -624,8 +733,11 @@ This value must not be modified or freed.</td>
|
|
|
624
733
|
<p>
|
|
625
734
|
Set the default font description for the context
|
|
626
735
|
</p>
|
|
627
|
-
<div class="variablelist"><table border="0">
|
|
736
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
|
737
|
+
<colgroup>
|
|
628
738
|
<col align="left" valign="top">
|
|
739
|
+
<col>
|
|
740
|
+
</colgroup>
|
|
629
741
|
<tbody>
|
|
630
742
|
<tr>
|
|
631
743
|
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
|
|
@@ -646,8 +758,11 @@ Set the default font description for the context
|
|
|
646
758
|
<p>
|
|
647
759
|
Retrieves the global language tag for the context.
|
|
648
760
|
</p>
|
|
649
|
-
<div class="variablelist"><table border="0">
|
|
761
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
|
762
|
+
<colgroup>
|
|
650
763
|
<col align="left" valign="top">
|
|
764
|
+
<col>
|
|
765
|
+
</colgroup>
|
|
651
766
|
<tbody>
|
|
652
767
|
<tr>
|
|
653
768
|
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
|
|
@@ -671,8 +786,11 @@ Sets the global language tag for the context. The default language
|
|
|
671
786
|
for the locale of the running process can be found using
|
|
672
787
|
<a class="link" href="pango-Scripts-and-Languages.html#pango-language-get-default" title="pango_language_get_default ()"><code class="function">pango_language_get_default()</code></a>.
|
|
673
788
|
</p>
|
|
674
|
-
<div class="variablelist"><table border="0">
|
|
789
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
|
790
|
+
<colgroup>
|
|
675
791
|
<col align="left" valign="top">
|
|
792
|
+
<col>
|
|
793
|
+
</colgroup>
|
|
676
794
|
<tbody>
|
|
677
795
|
<tr>
|
|
678
796
|
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
|
|
@@ -694,8 +812,11 @@ for the locale of the running process can be found using
|
|
|
694
812
|
Retrieves the base direction for the context. See
|
|
695
813
|
<a class="link" href="pango-Text-Processing.html#pango-context-set-base-dir" title="pango_context_set_base_dir ()"><code class="function">pango_context_set_base_dir()</code></a>.
|
|
696
814
|
</p>
|
|
697
|
-
<div class="variablelist"><table border="0">
|
|
815
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
|
816
|
+
<colgroup>
|
|
698
817
|
<col align="left" valign="top">
|
|
818
|
+
<col>
|
|
819
|
+
</colgroup>
|
|
699
820
|
<tbody>
|
|
700
821
|
<tr>
|
|
701
822
|
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
|
|
@@ -725,8 +846,11 @@ direction in the Unicode bidirectional algorithm. A value of
|
|
|
725
846
|
<a class="link" href="pango-Bidirectional-Text.html#PANGO-DIRECTION-WEAK-LTR:CAPS"><code class="literal">PANGO_DIRECTION_WEAK_LTR</code></a> or <a class="link" href="pango-Bidirectional-Text.html#PANGO-DIRECTION-WEAK-RTL:CAPS"><code class="literal">PANGO_DIRECTION_WEAK_RTL</code></a> is used only
|
|
726
847
|
for paragraphs that do not contain any strong characters themselves.
|
|
727
848
|
</p>
|
|
728
|
-
<div class="variablelist"><table border="0">
|
|
849
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
|
850
|
+
<colgroup>
|
|
729
851
|
<col align="left" valign="top">
|
|
852
|
+
<col>
|
|
853
|
+
</colgroup>
|
|
730
854
|
<tbody>
|
|
731
855
|
<tr>
|
|
732
856
|
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
|
|
@@ -748,8 +872,11 @@ for paragraphs that do not contain any strong characters themselves.
|
|
|
748
872
|
Retrieves the base gravity for the context. See
|
|
749
873
|
<a class="link" href="pango-Text-Processing.html#pango-context-set-base-gravity" title="pango_context_set_base_gravity ()"><code class="function">pango_context_set_base_gravity()</code></a>.
|
|
750
874
|
</p>
|
|
751
|
-
<div class="variablelist"><table border="0">
|
|
875
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
|
876
|
+
<colgroup>
|
|
752
877
|
<col align="left" valign="top">
|
|
878
|
+
<col>
|
|
879
|
+
</colgroup>
|
|
753
880
|
<tbody>
|
|
754
881
|
<tr>
|
|
755
882
|
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
|
|
@@ -775,8 +902,11 @@ Sets the base gravity for the context.
|
|
|
775
902
|
<p>
|
|
776
903
|
The base gravity is used in laying vertical text out.
|
|
777
904
|
</p>
|
|
778
|
-
<div class="variablelist"><table border="0">
|
|
905
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
|
906
|
+
<colgroup>
|
|
779
907
|
<col align="left" valign="top">
|
|
908
|
+
<col>
|
|
909
|
+
</colgroup>
|
|
780
910
|
<tbody>
|
|
781
911
|
<tr>
|
|
782
912
|
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
|
|
@@ -801,8 +931,11 @@ Retrieves the gravity for the context. This is similar to
|
|
|
801
931
|
is <a class="link" href="pango-Vertical-Text.html#PANGO-GRAVITY-AUTO:CAPS"><code class="literal">PANGO_GRAVITY_AUTO</code></a> for which <a class="link" href="pango-Vertical-Text.html#pango-gravity-get-for-matrix" title="pango_gravity_get_for_matrix ()"><code class="function">pango_gravity_get_for_matrix()</code></a> is used
|
|
802
932
|
to return the gravity from the current context matrix.
|
|
803
933
|
</p>
|
|
804
|
-
<div class="variablelist"><table border="0">
|
|
934
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
|
935
|
+
<colgroup>
|
|
805
936
|
<col align="left" valign="top">
|
|
937
|
+
<col>
|
|
938
|
+
</colgroup>
|
|
806
939
|
<tbody>
|
|
807
940
|
<tr>
|
|
808
941
|
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
|
|
@@ -825,8 +958,11 @@ to return the gravity from the current context matrix.
|
|
|
825
958
|
Retrieves the gravity hint for the context. See
|
|
826
959
|
<a class="link" href="pango-Text-Processing.html#pango-context-set-gravity-hint" title="pango_context_set_gravity_hint ()"><code class="function">pango_context_set_gravity_hint()</code></a> for details.
|
|
827
960
|
</p>
|
|
828
|
-
<div class="variablelist"><table border="0">
|
|
961
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
|
962
|
+
<colgroup>
|
|
829
963
|
<col align="left" valign="top">
|
|
964
|
+
<col>
|
|
965
|
+
</colgroup>
|
|
830
966
|
<tbody>
|
|
831
967
|
<tr>
|
|
832
968
|
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
|
|
@@ -854,8 +990,11 @@ The gravity hint is used in laying vertical text out, and is only relevant
|
|
|
854
990
|
if gravity of the context as returned by <a class="link" href="pango-Text-Processing.html#pango-context-get-gravity" title="pango_context_get_gravity ()"><code class="function">pango_context_get_gravity()</code></a>
|
|
855
991
|
is set <a class="link" href="pango-Vertical-Text.html#PANGO-GRAVITY-EAST:CAPS"><code class="literal">PANGO_GRAVITY_EAST</code></a> or <a class="link" href="pango-Vertical-Text.html#PANGO-GRAVITY-WEST:CAPS"><code class="literal">PANGO_GRAVITY_WEST</code></a>.
|
|
856
992
|
</p>
|
|
857
|
-
<div class="variablelist"><table border="0">
|
|
993
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
|
994
|
+
<colgroup>
|
|
858
995
|
<col align="left" valign="top">
|
|
996
|
+
<col>
|
|
997
|
+
</colgroup>
|
|
859
998
|
<tbody>
|
|
860
999
|
<tr>
|
|
861
1000
|
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
|
|
@@ -878,8 +1017,11 @@ is set <a class="link" href="pango-Vertical-Text.html#PANGO-GRAVITY-EAST:CAPS"><
|
|
|
878
1017
|
Gets the transformation matrix that will be applied when
|
|
879
1018
|
rendering with this context. See <a class="link" href="pango-Text-Processing.html#pango-context-set-matrix" title="pango_context_set_matrix ()"><code class="function">pango_context_set_matrix()</code></a>.
|
|
880
1019
|
</p>
|
|
881
|
-
<div class="variablelist"><table border="0">
|
|
1020
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
|
1021
|
+
<colgroup>
|
|
882
1022
|
<col align="left" valign="top">
|
|
1023
|
+
<col>
|
|
1024
|
+
</colgroup>
|
|
883
1025
|
<tbody>
|
|
884
1026
|
<tr>
|
|
885
1027
|
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
|
|
@@ -888,7 +1030,7 @@ rendering with this context. See <a class="link" href="pango-Text-Processing.htm
|
|
|
888
1030
|
</tr>
|
|
889
1031
|
<tr>
|
|
890
1032
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
891
|
-
<td>the matrix, or <a href="/
|
|
1033
|
+
<td>the matrix, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> if no matrix has been set
|
|
892
1034
|
(which is the same as the identity matrix). The returned
|
|
893
1035
|
matrix is owned by Pango and must not be modified or
|
|
894
1036
|
freed.</td>
|
|
@@ -910,8 +1052,11 @@ coordinates after the application of the matrix. So, they don't scale
|
|
|
910
1052
|
with the matrix, though they may change slightly for different
|
|
911
1053
|
matrices, depending on how the text is fit to the pixel grid.
|
|
912
1054
|
</p>
|
|
913
|
-
<div class="variablelist"><table border="0">
|
|
1055
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
|
1056
|
+
<colgroup>
|
|
914
1057
|
<col align="left" valign="top">
|
|
1058
|
+
<col>
|
|
1059
|
+
</colgroup>
|
|
915
1060
|
<tbody>
|
|
916
1061
|
<tr>
|
|
917
1062
|
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
|
|
@@ -920,8 +1065,8 @@ matrices, depending on how the text is fit to the pixel grid.
|
|
|
920
1065
|
</tr>
|
|
921
1066
|
<tr>
|
|
922
1067
|
<td><p><span class="term"><em class="parameter"><code>matrix</code></em> :</span></p></td>
|
|
923
|
-
<td>a <a class="link" href="pango-Glyph-Storage.html#PangoMatrix"><span class="type">PangoMatrix</span></a>, or <a href="/
|
|
924
|
-
matrix. (No matrix set is the same as setting the identity matrix.). <span class="annotation">[<
|
|
1068
|
+
<td>a <a class="link" href="pango-Glyph-Storage.html#PangoMatrix"><span class="type">PangoMatrix</span></a>, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> to unset any existing
|
|
1069
|
+
matrix. (No matrix set is the same as setting the identity matrix.). <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
|
|
925
1070
|
</td>
|
|
926
1071
|
</tr>
|
|
927
1072
|
</tbody>
|
|
@@ -937,8 +1082,11 @@ matrix. (No matrix set is the same as setting the identity matrix.). <span class
|
|
|
937
1082
|
Loads the font in one of the fontmaps in the context
|
|
938
1083
|
that is the closest match for <em class="parameter"><code>desc</code></em>.
|
|
939
1084
|
</p>
|
|
940
|
-
<div class="variablelist"><table border="0">
|
|
1085
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
|
1086
|
+
<colgroup>
|
|
941
1087
|
<col align="left" valign="top">
|
|
1088
|
+
<col>
|
|
1089
|
+
</colgroup>
|
|
942
1090
|
<tbody>
|
|
943
1091
|
<tr>
|
|
944
1092
|
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
|
|
@@ -952,7 +1100,7 @@ that is the closest match for <em class="parameter"><code>desc</code></em>.
|
|
|
952
1100
|
<tr>
|
|
953
1101
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
954
1102
|
<td>the newly allocated <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> that
|
|
955
|
-
was loaded, or <a href="/
|
|
1103
|
+
was loaded, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> if no font matched. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
|
|
956
1104
|
</td>
|
|
957
1105
|
</tr>
|
|
958
1106
|
</tbody>
|
|
@@ -968,8 +1116,11 @@ was loaded, or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NU
|
|
|
968
1116
|
Load a set of fonts in the context that can be used to render
|
|
969
1117
|
a font matching <em class="parameter"><code>desc</code></em>.
|
|
970
1118
|
</p>
|
|
971
|
-
<div class="variablelist"><table border="0">
|
|
1119
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
|
1120
|
+
<colgroup>
|
|
972
1121
|
<col align="left" valign="top">
|
|
1122
|
+
<col>
|
|
1123
|
+
</colgroup>
|
|
973
1124
|
<tbody>
|
|
974
1125
|
<tr>
|
|
975
1126
|
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
|
|
@@ -987,7 +1138,7 @@ a font matching <em class="parameter"><code>desc</code></em>.
|
|
|
987
1138
|
<tr>
|
|
988
1139
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
989
1140
|
<td>the newly allocated <a class="link" href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a> loaded,
|
|
990
|
-
or <a href="/
|
|
1141
|
+
or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> if no font matched. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
|
|
991
1142
|
</td>
|
|
992
1143
|
</tr>
|
|
993
1144
|
</tbody>
|
|
@@ -1014,8 +1165,11 @@ would be used to render the string, then the returned fonts would
|
|
|
1014
1165
|
be a composite of the metrics for the fonts loaded for the
|
|
1015
1166
|
individual families.
|
|
1016
1167
|
</p>
|
|
1017
|
-
<div class="variablelist"><table border="0">
|
|
1168
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
|
1169
|
+
<colgroup>
|
|
1018
1170
|
<col align="left" valign="top">
|
|
1171
|
+
<col>
|
|
1172
|
+
</colgroup>
|
|
1019
1173
|
<tbody>
|
|
1020
1174
|
<tr>
|
|
1021
1175
|
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
|
|
@@ -1024,17 +1178,17 @@ individual families.
|
|
|
1024
1178
|
</tr>
|
|
1025
1179
|
<tr>
|
|
1026
1180
|
<td><p><span class="term"><em class="parameter"><code>desc</code></em> :</span></p></td>
|
|
1027
|
-
<td>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> structure. <a href="/
|
|
1028
|
-
font description from the context will be used. <span class="annotation">[<
|
|
1181
|
+
<td>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> structure. <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> means that the
|
|
1182
|
+
font description from the context will be used. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
|
|
1029
1183
|
</td>
|
|
1030
1184
|
</tr>
|
|
1031
1185
|
<tr>
|
|
1032
1186
|
<td><p><span class="term"><em class="parameter"><code>language</code></em> :</span></p></td>
|
|
1033
1187
|
<td>language tag used to determine which script to get
|
|
1034
|
-
the metrics for. <a href="/
|
|
1188
|
+
the metrics for. <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> means that the language tag from the context
|
|
1035
1189
|
will be used. If no language tag is set on the context, metrics
|
|
1036
1190
|
for the default language (as determined by <a class="link" href="pango-Scripts-and-Languages.html#pango-language-get-default" title="pango_language_get_default ()"><code class="function">pango_language_get_default()</code></a>)
|
|
1037
|
-
will be returned. <span class="annotation">[<
|
|
1191
|
+
will be returned. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
|
|
1038
1192
|
</td>
|
|
1039
1193
|
</tr>
|
|
1040
1194
|
<tr>
|
|
@@ -1054,8 +1208,11 @@ when finished using the object.</td>
|
|
|
1054
1208
|
<p>
|
|
1055
1209
|
List all families for a context.
|
|
1056
1210
|
</p>
|
|
1057
|
-
<div class="variablelist"><table border="0">
|
|
1211
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
|
1212
|
+
<colgroup>
|
|
1058
1213
|
<col align="left" valign="top">
|
|
1214
|
+
<col>
|
|
1215
|
+
</colgroup>
|
|
1059
1216
|
<tbody>
|
|
1060
1217
|
<tr>
|
|
1061
1218
|
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
|
|
@@ -1066,12 +1223,12 @@ List all families for a context.
|
|
|
1066
1223
|
<td><p><span class="term"><em class="parameter"><code>families</code></em> :</span></p></td>
|
|
1067
1224
|
<td>location to store a pointer to
|
|
1068
1225
|
an array of <a class="link" href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a> *. This array should be freed
|
|
1069
|
-
with <
|
|
1226
|
+
with <code class="function">g_free()</code>. <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>
|
|
1070
1227
|
</td>
|
|
1071
1228
|
</tr>
|
|
1072
1229
|
<tr>
|
|
1073
1230
|
<td><p><span class="term"><em class="parameter"><code>n_families</code></em> :</span></p></td>
|
|
1074
|
-
<td>location to store the number of elements in <em class="parameter"><code>descs</code></em>. <span class="annotation">[<
|
|
1231
|
+
<td>location to store the number of elements in <em class="parameter"><code>descs</code></em>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
|
|
1075
1232
|
</td>
|
|
1076
1233
|
</tr>
|
|
1077
1234
|
</tbody>
|
|
@@ -1080,7 +1237,7 @@ with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocatio
|
|
|
1080
1237
|
<hr>
|
|
1081
1238
|
<div class="refsect2">
|
|
1082
1239
|
<a name="pango-break"></a><h3>pango_break ()</h3>
|
|
1083
|
-
<pre class="programlisting"><span class="returnvalue">void</span> pango_break (<em class="parameter"><code>const <
|
|
1240
|
+
<pre class="programlisting"><span class="returnvalue">void</span> pango_break (<em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>,
|
|
1084
1241
|
<em class="parameter"><code><span class="type">int</span> length</code></em>,
|
|
1085
1242
|
<em class="parameter"><code><a class="link" href="pango-Text-Processing.html#PangoAnalysis" title="struct PangoAnalysis"><span class="type">PangoAnalysis</span></a> *analysis</code></em>,
|
|
1086
1243
|
<em class="parameter"><code><a class="link" href="pango-Text-Processing.html#PangoLogAttr" title="PangoLogAttr"><span class="type">PangoLogAttr</span></a> *attrs</code></em>,
|
|
@@ -1090,8 +1247,11 @@ Determines possible line, word, and character breaks
|
|
|
1090
1247
|
for a string of Unicode text with a single analysis. For most
|
|
1091
1248
|
purposes you may want to use <a class="link" href="pango-Text-Processing.html#pango-get-log-attrs" title="pango_get_log_attrs ()"><code class="function">pango_get_log_attrs()</code></a>.
|
|
1092
1249
|
</p>
|
|
1093
|
-
<div class="variablelist"><table border="0">
|
|
1250
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
|
1251
|
+
<colgroup>
|
|
1094
1252
|
<col align="left" valign="top">
|
|
1253
|
+
<col>
|
|
1254
|
+
</colgroup>
|
|
1095
1255
|
<tbody>
|
|
1096
1256
|
<tr>
|
|
1097
1257
|
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
|
|
@@ -1109,7 +1269,9 @@ purposes you may want to use <a class="link" href="pango-Text-Processing.html#pa
|
|
|
1109
1269
|
</tr>
|
|
1110
1270
|
<tr>
|
|
1111
1271
|
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
|
|
1112
|
-
<td>an array to store character
|
|
1272
|
+
<td>an array to store character
|
|
1273
|
+
information in. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=attrs_len]</span>
|
|
1274
|
+
</td>
|
|
1113
1275
|
</tr>
|
|
1114
1276
|
<tr>
|
|
1115
1277
|
<td><p><span class="term"><em class="parameter"><code>attrs_len</code></em> :</span></p></td>
|
|
@@ -1137,8 +1299,11 @@ paragraph; logical attributes can't be computed without context
|
|
|
1137
1299
|
(for example you need to see spaces on either side of a word to know
|
|
1138
1300
|
the word is a word).
|
|
1139
1301
|
</p>
|
|
1140
|
-
<div class="variablelist"><table border="0">
|
|
1302
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
|
1303
|
+
<colgroup>
|
|
1141
1304
|
<col align="left" valign="top">
|
|
1305
|
+
<col>
|
|
1306
|
+
</colgroup>
|
|
1142
1307
|
<tbody>
|
|
1143
1308
|
<tr>
|
|
1144
1309
|
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
|
|
@@ -1159,7 +1324,9 @@ the word is a word).
|
|
|
1159
1324
|
</tr>
|
|
1160
1325
|
<tr>
|
|
1161
1326
|
<td><p><span class="term"><em class="parameter"><code>log_attrs</code></em> :</span></p></td>
|
|
1162
|
-
<td>array with one <a class="link" href="pango-Text-Processing.html#PangoLogAttr" title="PangoLogAttr"><span class="type">PangoLogAttr</span></a>
|
|
1327
|
+
<td>array with one <a class="link" href="pango-Text-Processing.html#PangoLogAttr" title="PangoLogAttr"><span class="type">PangoLogAttr</span></a>
|
|
1328
|
+
per character in <em class="parameter"><code>text</code></em>, plus one extra, to be filled in. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=attrs_len]</span>
|
|
1329
|
+
</td>
|
|
1163
1330
|
</tr>
|
|
1164
1331
|
<tr>
|
|
1165
1332
|
<td><p><span class="term"><em class="parameter"><code>attrs_len</code></em> :</span></p></td>
|
|
@@ -1171,10 +1338,10 @@ the word is a word).
|
|
|
1171
1338
|
<hr>
|
|
1172
1339
|
<div class="refsect2">
|
|
1173
1340
|
<a name="pango-find-paragraph-boundary"></a><h3>pango_find_paragraph_boundary ()</h3>
|
|
1174
|
-
<pre class="programlisting"><span class="returnvalue">void</span> pango_find_paragraph_boundary (<em class="parameter"><code>const <
|
|
1175
|
-
<em class="parameter"><code><
|
|
1176
|
-
<em class="parameter"><code><
|
|
1177
|
-
<em class="parameter"><code><
|
|
1341
|
+
<pre class="programlisting"><span class="returnvalue">void</span> pango_find_paragraph_boundary (<em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>,
|
|
1342
|
+
<em class="parameter"><code><span class="type">gint</span> length</code></em>,
|
|
1343
|
+
<em class="parameter"><code><span class="type">gint</span> *paragraph_delimiter_index</code></em>,
|
|
1344
|
+
<em class="parameter"><code><span class="type">gint</span> *next_paragraph_start</code></em>);</pre>
|
|
1178
1345
|
<p>
|
|
1179
1346
|
Locates a paragraph boundary in <em class="parameter"><code>text</code></em>. A boundary is caused by
|
|
1180
1347
|
delimiter characters, such as a newline, carriage return, carriage
|
|
@@ -1188,8 +1355,11 @@ If no delimiters are found, both <em class="parameter"><code>paragraph_delimiter
|
|
|
1188
1355
|
<em class="parameter"><code>next_paragraph_start</code></em> are filled with the length of <em class="parameter"><code>text</code></em> (an index one
|
|
1189
1356
|
off the end).
|
|
1190
1357
|
</p>
|
|
1191
|
-
<div class="variablelist"><table border="0">
|
|
1358
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
|
1359
|
+
<colgroup>
|
|
1192
1360
|
<col align="left" valign="top">
|
|
1361
|
+
<col>
|
|
1362
|
+
</colgroup>
|
|
1193
1363
|
<tbody>
|
|
1194
1364
|
<tr>
|
|
1195
1365
|
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
|
|
@@ -1201,11 +1371,15 @@ off the end).
|
|
|
1201
1371
|
</tr>
|
|
1202
1372
|
<tr>
|
|
1203
1373
|
<td><p><span class="term"><em class="parameter"><code>paragraph_delimiter_index</code></em> :</span></p></td>
|
|
1204
|
-
<td>return location for index of
|
|
1374
|
+
<td>return location for index of
|
|
1375
|
+
delimiter. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
|
|
1376
|
+
</td>
|
|
1205
1377
|
</tr>
|
|
1206
1378
|
<tr>
|
|
1207
1379
|
<td><p><span class="term"><em class="parameter"><code>next_paragraph_start</code></em> :</span></p></td>
|
|
1208
|
-
<td>return location for start of next
|
|
1380
|
+
<td>return location for start of next
|
|
1381
|
+
paragraph. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
|
|
1382
|
+
</td>
|
|
1209
1383
|
</tr>
|
|
1210
1384
|
</tbody>
|
|
1211
1385
|
</table></div>
|
|
@@ -1213,7 +1387,7 @@ off the end).
|
|
|
1213
1387
|
<hr>
|
|
1214
1388
|
<div class="refsect2">
|
|
1215
1389
|
<a name="pango-default-break"></a><h3>pango_default_break ()</h3>
|
|
1216
|
-
<pre class="programlisting"><span class="returnvalue">void</span> pango_default_break (<em class="parameter"><code>const <
|
|
1390
|
+
<pre class="programlisting"><span class="returnvalue">void</span> pango_default_break (<em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>,
|
|
1217
1391
|
<em class="parameter"><code><span class="type">int</span> length</code></em>,
|
|
1218
1392
|
<em class="parameter"><code><a class="link" href="pango-Text-Processing.html#PangoAnalysis" title="struct PangoAnalysis"><span class="type">PangoAnalysis</span></a> *analysis</code></em>,
|
|
1219
1393
|
<em class="parameter"><code><a class="link" href="pango-Text-Processing.html#PangoLogAttr" title="PangoLogAttr"><span class="type">PangoLogAttr</span></a> *attrs</code></em>,
|
|
@@ -1222,13 +1396,16 @@ off the end).
|
|
|
1222
1396
|
This is the default break algorithm, used if no language
|
|
1223
1397
|
engine overrides it. Normally you should use <a class="link" href="pango-Text-Processing.html#pango-break" title="pango_break ()"><code class="function">pango_break()</code></a>
|
|
1224
1398
|
instead. Unlike <a class="link" href="pango-Text-Processing.html#pango-break" title="pango_break ()"><code class="function">pango_break()</code></a>,
|
|
1225
|
-
<em class="parameter"><code>analysis</code></em> can be <a href="/
|
|
1399
|
+
<em class="parameter"><code>analysis</code></em> can be <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>, but only do that if you know what
|
|
1226
1400
|
you're doing. If you need an analysis to pass to <a class="link" href="pango-Text-Processing.html#pango-break" title="pango_break ()"><code class="function">pango_break()</code></a>,
|
|
1227
1401
|
you need to <a class="link" href="pango-Text-Processing.html#pango-itemize" title="pango_itemize ()"><code class="function">pango_itemize()</code></a>. In most cases however you should
|
|
1228
1402
|
simply use <a class="link" href="pango-Text-Processing.html#pango-get-log-attrs" title="pango_get_log_attrs ()"><code class="function">pango_get_log_attrs()</code></a>.
|
|
1229
1403
|
</p>
|
|
1230
|
-
<div class="variablelist"><table border="0">
|
|
1404
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
|
1405
|
+
<colgroup>
|
|
1231
1406
|
<col align="left" valign="top">
|
|
1407
|
+
<col>
|
|
1408
|
+
</colgroup>
|
|
1232
1409
|
<tbody>
|
|
1233
1410
|
<tr>
|
|
1234
1411
|
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
|
|
@@ -1310,27 +1487,30 @@ simply use <a class="link" href="pango-Text-Processing.html#pango-get-log-attrs"
|
|
|
1310
1487
|
The <a class="link" href="pango-Text-Processing.html#PangoLogAttr" title="PangoLogAttr"><span class="type">PangoLogAttr</span></a> structure stores information
|
|
1311
1488
|
about the attributes of a single character.
|
|
1312
1489
|
</p>
|
|
1313
|
-
<div class="variablelist"><table border="0">
|
|
1490
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
|
1491
|
+
<colgroup>
|
|
1314
1492
|
<col align="left" valign="top">
|
|
1493
|
+
<col>
|
|
1494
|
+
</colgroup>
|
|
1315
1495
|
<tbody>
|
|
1316
1496
|
<tr>
|
|
1317
|
-
<td><p><span class="term"><
|
|
1497
|
+
<td><p><span class="term"><span class="type">guint</span> <em class="structfield"><code><a name="PangoLogAttr.is-line-break"></a>is_line_break</code></em> : 1;</span></p></td>
|
|
1318
1498
|
<td>if set, can break line in front of character</td>
|
|
1319
1499
|
</tr>
|
|
1320
1500
|
<tr>
|
|
1321
|
-
<td><p><span class="term"><
|
|
1501
|
+
<td><p><span class="term"><span class="type">guint</span> <em class="structfield"><code><a name="PangoLogAttr.is-mandatory-break"></a>is_mandatory_break</code></em> : 1;</span></p></td>
|
|
1322
1502
|
<td>if set, must break line in front of character</td>
|
|
1323
1503
|
</tr>
|
|
1324
1504
|
<tr>
|
|
1325
|
-
<td><p><span class="term"><
|
|
1505
|
+
<td><p><span class="term"><span class="type">guint</span> <em class="structfield"><code><a name="PangoLogAttr.is-char-break"></a>is_char_break</code></em> : 1;</span></p></td>
|
|
1326
1506
|
<td>if set, can break here when doing character wrapping</td>
|
|
1327
1507
|
</tr>
|
|
1328
1508
|
<tr>
|
|
1329
|
-
<td><p><span class="term"><
|
|
1509
|
+
<td><p><span class="term"><span class="type">guint</span> <em class="structfield"><code><a name="PangoLogAttr.is-white"></a>is_white</code></em> : 1;</span></p></td>
|
|
1330
1510
|
<td>is whitespace character</td>
|
|
1331
1511
|
</tr>
|
|
1332
1512
|
<tr>
|
|
1333
|
-
<td><p><span class="term"><
|
|
1513
|
+
<td><p><span class="term"><span class="type">guint</span> <em class="structfield"><code><a name="PangoLogAttr.is-cursor-position"></a>is_cursor_position</code></em> : 1;</span></p></td>
|
|
1334
1514
|
<td>if set, cursor can appear in front of character.
|
|
1335
1515
|
i.e. this is a grapheme boundary, or the first character
|
|
1336
1516
|
in the text.
|
|
@@ -1339,17 +1519,17 @@ This flag implements Unicode's
|
|
|
1339
1519
|
Cluster Boundaries</a> semantics.</td>
|
|
1340
1520
|
</tr>
|
|
1341
1521
|
<tr>
|
|
1342
|
-
<td><p><span class="term"><
|
|
1522
|
+
<td><p><span class="term"><span class="type">guint</span> <em class="structfield"><code><a name="PangoLogAttr.is-word-start"></a>is_word_start</code></em> : 1;</span></p></td>
|
|
1343
1523
|
<td>is first character in a word</td>
|
|
1344
1524
|
</tr>
|
|
1345
1525
|
<tr>
|
|
1346
|
-
<td><p><span class="term"><
|
|
1526
|
+
<td><p><span class="term"><span class="type">guint</span> <em class="structfield"><code><a name="PangoLogAttr.is-word-end"></a>is_word_end</code></em> : 1;</span></p></td>
|
|
1347
1527
|
<td>is first non-word char after a word
|
|
1348
1528
|
Note that in degenerate cases, you could have both <em class="parameter"><code>is_word_start</code></em>
|
|
1349
1529
|
and <em class="parameter"><code>is_word_end</code></em> set for some character.</td>
|
|
1350
1530
|
</tr>
|
|
1351
1531
|
<tr>
|
|
1352
|
-
<td><p><span class="term"><
|
|
1532
|
+
<td><p><span class="term"><span class="type">guint</span> <em class="structfield"><code><a name="PangoLogAttr.is-sentence-boundary"></a>is_sentence_boundary</code></em> : 1;</span></p></td>
|
|
1353
1533
|
<td>is a sentence boundary.
|
|
1354
1534
|
There are two ways to divide sentences. The first assigns all
|
|
1355
1535
|
inter-sentence whitespace/control/format chars to some sentence,
|
|
@@ -1360,18 +1540,18 @@ between-sentence spaces, etc. to any sentence, so
|
|
|
1360
1540
|
of those sentences.</td>
|
|
1361
1541
|
</tr>
|
|
1362
1542
|
<tr>
|
|
1363
|
-
<td><p><span class="term"><
|
|
1543
|
+
<td><p><span class="term"><span class="type">guint</span> <em class="structfield"><code><a name="PangoLogAttr.is-sentence-start"></a>is_sentence_start</code></em> : 1;</span></p></td>
|
|
1364
1544
|
<td>is first character in a sentence</td>
|
|
1365
1545
|
</tr>
|
|
1366
1546
|
<tr>
|
|
1367
|
-
<td><p><span class="term"><
|
|
1547
|
+
<td><p><span class="term"><span class="type">guint</span> <em class="structfield"><code><a name="PangoLogAttr.is-sentence-end"></a>is_sentence_end</code></em> : 1;</span></p></td>
|
|
1368
1548
|
<td>is first char after a sentence.
|
|
1369
1549
|
Note that in degenerate cases, you could have both <em class="parameter"><code>is_sentence_start</code></em>
|
|
1370
1550
|
and <em class="parameter"><code>is_sentence_end</code></em> set for some character. (e.g. no space after a
|
|
1371
1551
|
period, so the next sentence starts right away)</td>
|
|
1372
1552
|
</tr>
|
|
1373
1553
|
<tr>
|
|
1374
|
-
<td><p><span class="term"><
|
|
1554
|
+
<td><p><span class="term"><span class="type">guint</span> <em class="structfield"><code><a name="PangoLogAttr.backspace-deletes-character"></a>backspace_deletes_character</code></em> : 1;</span></p></td>
|
|
1375
1555
|
<td>if set, backspace deletes one character
|
|
1376
1556
|
rather than the entire grapheme cluster. This
|
|
1377
1557
|
field is only meaningful on grapheme
|
|
@@ -1386,12 +1566,12 @@ those following Latin, Cyrillic or Greek base
|
|
|
1386
1566
|
characters.</td>
|
|
1387
1567
|
</tr>
|
|
1388
1568
|
<tr>
|
|
1389
|
-
<td><p><span class="term"><
|
|
1569
|
+
<td><p><span class="term"><span class="type">guint</span> <em class="structfield"><code><a name="PangoLogAttr.is-expandable-space"></a>is_expandable_space</code></em> : 1;</span></p></td>
|
|
1390
1570
|
<td>is a whitespace character that can possibly be
|
|
1391
1571
|
expanded for justification purposes. (Since: 1.18)</td>
|
|
1392
1572
|
</tr>
|
|
1393
1573
|
<tr>
|
|
1394
|
-
<td><p><span class="term"><
|
|
1574
|
+
<td><p><span class="term"><span class="type">guint</span> <em class="structfield"><code><a name="PangoLogAttr.is-word-boundary"></a>is_word_boundary</code></em> : 1;</span></p></td>
|
|
1395
1575
|
<td>is a word boundary.
|
|
1396
1576
|
More specifically, means that this is not a position in the middle
|
|
1397
1577
|
of a word. For example, both sides of a punctuation mark are
|
|
@@ -1408,8 +1588,8 @@ Boundaries</a> semantics.
|
|
|
1408
1588
|
<hr>
|
|
1409
1589
|
<div class="refsect2">
|
|
1410
1590
|
<a name="pango-shape"></a><h3>pango_shape ()</h3>
|
|
1411
|
-
<pre class="programlisting"><span class="returnvalue">void</span> pango_shape (<em class="parameter"><code>const <
|
|
1412
|
-
<em class="parameter"><code><
|
|
1591
|
+
<pre class="programlisting"><span class="returnvalue">void</span> pango_shape (<em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>,
|
|
1592
|
+
<em class="parameter"><code><span class="type">gint</span> length</code></em>,
|
|
1413
1593
|
<em class="parameter"><code>const <a class="link" href="pango-Text-Processing.html#PangoAnalysis" title="struct PangoAnalysis"><span class="type">PangoAnalysis</span></a> *analysis</code></em>,
|
|
1414
1594
|
<em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoGlyphString"><span class="type">PangoGlyphString</span></a> *glyphs</code></em>);</pre>
|
|
1415
1595
|
<p>
|
|
@@ -1418,8 +1598,16 @@ Given a segment of text and the corresponding
|
|
|
1418
1598
|
convert the characters into glyphs. You may also pass
|
|
1419
1599
|
in only a substring of the item from <a class="link" href="pango-Text-Processing.html#pango-itemize" title="pango_itemize ()"><code class="function">pango_itemize()</code></a>.
|
|
1420
1600
|
</p>
|
|
1421
|
-
<
|
|
1601
|
+
<p>
|
|
1602
|
+
It is recommended that you use <a class="link" href="pango-Text-Processing.html#pango-shape-full" title="pango_shape_full ()"><code class="function">pango_shape_full()</code></a> instead, since
|
|
1603
|
+
that API allows for shaping interaction happening across text item
|
|
1604
|
+
boundaries.
|
|
1605
|
+
</p>
|
|
1606
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
|
1607
|
+
<colgroup>
|
|
1422
1608
|
<col align="left" valign="top">
|
|
1609
|
+
<col>
|
|
1610
|
+
</colgroup>
|
|
1423
1611
|
<tbody>
|
|
1424
1612
|
<tr>
|
|
1425
1613
|
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
|
|
@@ -1443,10 +1631,67 @@ in only a substring of the item from <a class="link" href="pango-Text-Processing
|
|
|
1443
1631
|
</tbody>
|
|
1444
1632
|
</table></div>
|
|
1445
1633
|
</div>
|
|
1634
|
+
<hr>
|
|
1635
|
+
<div class="refsect2">
|
|
1636
|
+
<a name="pango-shape-full"></a><h3>pango_shape_full ()</h3>
|
|
1637
|
+
<pre class="programlisting"><span class="returnvalue">void</span> pango_shape_full (<em class="parameter"><code>const <span class="type">gchar</span> *item_text</code></em>,
|
|
1638
|
+
<em class="parameter"><code><span class="type">gint</span> item_length</code></em>,
|
|
1639
|
+
<em class="parameter"><code>const <span class="type">gchar</span> *paragraph_text</code></em>,
|
|
1640
|
+
<em class="parameter"><code><span class="type">gint</span> paragraph_length</code></em>,
|
|
1641
|
+
<em class="parameter"><code>const <a class="link" href="pango-Text-Processing.html#PangoAnalysis" title="struct PangoAnalysis"><span class="type">PangoAnalysis</span></a> *analysis</code></em>,
|
|
1642
|
+
<em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoGlyphString"><span class="type">PangoGlyphString</span></a> *glyphs</code></em>);</pre>
|
|
1643
|
+
<p>
|
|
1644
|
+
Given a segment of text and the corresponding
|
|
1645
|
+
<a class="link" href="pango-Text-Processing.html#PangoAnalysis" title="struct PangoAnalysis"><span class="type">PangoAnalysis</span></a> structure returned from <a class="link" href="pango-Text-Processing.html#pango-itemize" title="pango_itemize ()"><code class="function">pango_itemize()</code></a>,
|
|
1646
|
+
convert the characters into glyphs. You may also pass
|
|
1647
|
+
in only a substring of the item from <a class="link" href="pango-Text-Processing.html#pango-itemize" title="pango_itemize ()"><code class="function">pango_itemize()</code></a>.
|
|
1648
|
+
</p>
|
|
1649
|
+
<p>
|
|
1650
|
+
This is similar to <a class="link" href="pango-Text-Processing.html#pango-shape" title="pango_shape ()"><code class="function">pango_shape()</code></a>, except it also can optionally take
|
|
1651
|
+
the full paragraph text as input, which will then be used to perform
|
|
1652
|
+
certain cross-item shaping interactions. If you have access to the broader
|
|
1653
|
+
text of which <em class="parameter"><code>item_text</code></em> is part of, provide the broader text as
|
|
1654
|
+
<em class="parameter"><code>paragraph_text</code></em>. If <em class="parameter"><code>paragraph_text</code></em> is <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>, item text is used instead.
|
|
1655
|
+
</p>
|
|
1656
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
|
1657
|
+
<colgroup>
|
|
1658
|
+
<col align="left" valign="top">
|
|
1659
|
+
<col>
|
|
1660
|
+
</colgroup>
|
|
1661
|
+
<tbody>
|
|
1662
|
+
<tr>
|
|
1663
|
+
<td><p><span class="term"><em class="parameter"><code>item_text</code></em> :</span></p></td>
|
|
1664
|
+
<td>valid UTF-8 text to shape.</td>
|
|
1665
|
+
</tr>
|
|
1666
|
+
<tr>
|
|
1667
|
+
<td><p><span class="term"><em class="parameter"><code>item_length</code></em> :</span></p></td>
|
|
1668
|
+
<td>the length (in bytes) of <em class="parameter"><code>item_text</code></em>. -1 means nul-terminated text.</td>
|
|
1669
|
+
</tr>
|
|
1670
|
+
<tr>
|
|
1671
|
+
<td><p><span class="term"><em class="parameter"><code>paragraph_text</code></em> :</span></p></td>
|
|
1672
|
+
<td>(allow-none) text of the paragraph (see details). May be <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>.</td>
|
|
1673
|
+
</tr>
|
|
1674
|
+
<tr>
|
|
1675
|
+
<td><p><span class="term"><em class="parameter"><code>paragraph_length</code></em> :</span></p></td>
|
|
1676
|
+
<td>the length (in bytes) of <em class="parameter"><code>paragraph_text</code></em>. -1 means nul-terminated text.</td>
|
|
1677
|
+
</tr>
|
|
1678
|
+
<tr>
|
|
1679
|
+
<td><p><span class="term"><em class="parameter"><code>analysis</code></em> :</span></p></td>
|
|
1680
|
+
<td>
|
|
1681
|
+
<a class="link" href="pango-Text-Processing.html#PangoAnalysis" title="struct PangoAnalysis"><span class="type">PangoAnalysis</span></a> structure from <a class="link" href="pango-Text-Processing.html#pango-itemize" title="pango_itemize ()"><code class="function">pango_itemize()</code></a>.</td>
|
|
1682
|
+
</tr>
|
|
1683
|
+
<tr>
|
|
1684
|
+
<td><p><span class="term"><em class="parameter"><code>glyphs</code></em> :</span></p></td>
|
|
1685
|
+
<td>glyph string in which to store results.</td>
|
|
1686
|
+
</tr>
|
|
1687
|
+
</tbody>
|
|
1688
|
+
</table></div>
|
|
1689
|
+
<p class="since">Since 1.32</p>
|
|
1690
|
+
</div>
|
|
1446
1691
|
</div>
|
|
1447
1692
|
</div>
|
|
1448
1693
|
<div class="footer">
|
|
1449
1694
|
<hr>
|
|
1450
|
-
Generated by GTK-Doc V1.18</div>
|
|
1695
|
+
Generated by GTK-Doc V1.18.1</div>
|
|
1451
1696
|
</body>
|
|
1452
1697
|
</html>
|