8
8
<link rel="up" href="lowlevel.html" title="Low Level Functionality">
9
9
<link rel="prev" href="pango-Miscellaneous-Utilities.html" title="Miscellaneous Utilities">
10
10
<link rel="next" href="tools.html" title="Pango Tools">
11
<meta name="generator" content="GTK-Doc V1.13 (XML mode)">
11
<meta name="generator" content="GTK-Doc V1.15.1 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
<link rel="chapter" href="pango.html" title="Basic Pango Interfaces">
14
<link rel="chapter" href="rendering.html" title="Rendering with Pango">
15
<link rel="chapter" href="lowlevel.html" title="Low Level Functionality">
16
<link rel="chapter" href="tools.html" title="Pango Tools">
17
<link rel="chapter" href="pango-hierarchy.html" title="Object Hierarchy">
18
<link rel="index" href="index-all.html" title="Index">
19
<link rel="index" href="index-deprecated.html" title="Index of deprecated symbols">
20
<link rel="index" href="index-1.2.html" title="Index of new symbols in 1.2">
21
<link rel="index" href="index-1.4.html" title="Index of new symbols in 1.4">
22
<link rel="index" href="index-1.6.html" title="Index of new symbols in 1.6">
23
<link rel="index" href="index-1.8.html" title="Index of new symbols in 1.8">
24
<link rel="index" href="index-1.10.html" title="Index of new symbols in 1.10">
25
<link rel="index" href="index-1.12.html" title="Index of new symbols in 1.12">
26
<link rel="index" href="index-1.14.html" title="Index of new symbols in 1.14">
27
<link rel="index" href="index-1.16.html" title="Index of new symbols in 1.16">
28
<link rel="index" href="index-1.18.html" title="Index of new symbols in 1.18">
29
<link rel="index" href="index-1.20.html" title="Index of new symbols in 1.20">
30
<link rel="index" href="index-1.22.html" title="Index of new symbols in 1.22">
31
<link rel="index" href="index-1.24.html" title="Index of new symbols in 1.24">
32
<link rel="index" href="index-1.26.html" title="Index of new symbols in 1.26">
33
<link rel="index" href="index-1.28.html" title="Index of new symbols in 1.26">
35
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
36
15
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
57
36
<td valign="top" align="right"></td>
58
37
</tr></table></div>
59
<div class="refsynopsisdiv" title="Synopsis">
38
<div class="refsynopsisdiv">
60
39
<a name="pango-Version-Checking.synopsis"></a><h2>Synopsis</h2>
61
<pre class="synopsis">#define <a class="link" href="pango-Version-Checking.html#PANGO-VERSION-ENCODE:CAPS" title="PANGO_VERSION_ENCODE()">PANGO_VERSION_ENCODE</a> (major, minor, micro)
40
<pre class="synopsis">#define <a class="link" href="pango-Version-Checking.html#PANGO-VERSION-ENCODE:CAPS" title="PANGO_VERSION_ENCODE()">PANGO_VERSION_ENCODE</a> (major,
62
43
#define <a class="link" href="pango-Version-Checking.html#PANGO-VERSION:CAPS" title="PANGO_VERSION">PANGO_VERSION</a>
63
44
#define <a class="link" href="pango-Version-Checking.html#PANGO-VERSION-MAJOR:CAPS" title="PANGO_VERSION_MAJOR">PANGO_VERSION_MAJOR</a>
64
45
#define <a class="link" href="pango-Version-Checking.html#PANGO-VERSION-MINOR:CAPS" title="PANGO_VERSION_MINOR">PANGO_VERSION_MINOR</a>
65
46
#define <a class="link" href="pango-Version-Checking.html#PANGO-VERSION-MICRO:CAPS" title="PANGO_VERSION_MICRO">PANGO_VERSION_MICRO</a>
66
47
#define <a class="link" href="pango-Version-Checking.html#PANGO-VERSION-STRING:CAPS" title="PANGO_VERSION_STRING">PANGO_VERSION_STRING</a>
67
#define <a class="link" href="pango-Version-Checking.html#PANGO-VERSION-CHECK:CAPS" title="PANGO_VERSION_CHECK()">PANGO_VERSION_CHECK</a> (major,minor,micro)
68
<span class="returnvalue">int</span> <a class="link" href="pango-Version-Checking.html#pango-version" title="pango_version ()">pango_version</a> (void);
69
const <span class="returnvalue">char</span> * <a class="link" href="pango-Version-Checking.html#pango-version-string" title="pango_version_string ()">pango_version_string</a> (void);
70
const <span class="returnvalue">char</span> * <a class="link" href="pango-Version-Checking.html#pango-version-check" title="pango_version_check ()">pango_version_check</a> (<span class="returnvalue">int</span> required_major,
71
<span class="returnvalue">int</span> required_minor,
72
<span class="returnvalue">int</span> required_micro);
48
#define <a class="link" href="pango-Version-Checking.html#PANGO-VERSION-CHECK:CAPS" title="PANGO_VERSION_CHECK()">PANGO_VERSION_CHECK</a> (major,
51
<span class="returnvalue">int</span> <a class="link" href="pango-Version-Checking.html#pango-version" title="pango_version ()">pango_version</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
52
const <span class="returnvalue">char</span> * <a class="link" href="pango-Version-Checking.html#pango-version-string" title="pango_version_string ()">pango_version_string</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
53
const <span class="returnvalue">char</span> * <a class="link" href="pango-Version-Checking.html#pango-version-check" title="pango_version_check ()">pango_version_check</a> (<em class="parameter"><code><span class="type">int</span> required_major</code></em>,
54
<em class="parameter"><code><span class="type">int</span> required_minor</code></em>,
55
<em class="parameter"><code><span class="type">int</span> required_micro</code></em>);
75
<div class="refsect1" title="Description">
58
<div class="refsect1">
76
59
<a name="pango-Version-Checking.description"></a><h2>Description</h2>
78
61
The capital-letter macros defined here can be used to check the version of
85
<div class="refsect1" title="Details">
68
<div class="refsect1">
86
69
<a name="pango-Version-Checking.details"></a><h2>Details</h2>
87
<div class="refsect2" title="PANGO_VERSION_ENCODE()">
70
<div class="refsect2">
88
71
<a name="PANGO-VERSION-ENCODE:CAPS"></a><h3>PANGO_VERSION_ENCODE()</h3>
89
72
<pre class="programlisting">#define PANGO_VERSION_ENCODE(major, minor, micro)</pre>
144
<div class="refsect2" title="PANGO_VERSION_MICRO">
127
<div class="refsect2">
145
128
<a name="PANGO-VERSION-MICRO:CAPS"></a><h3>PANGO_VERSION_MICRO</h3>
146
<pre class="programlisting">#define PANGO_VERSION_MICRO 1
129
<pre class="programlisting">#define PANGO_VERSION_MICRO 3
149
132
The micro component of the version of Pango available at compile-time.
153
<div class="refsect2" title="PANGO_VERSION_STRING">
136
<div class="refsect2">
154
137
<a name="PANGO-VERSION-STRING:CAPS"></a><h3>PANGO_VERSION_STRING</h3>
155
<pre class="programlisting">#define PANGO_VERSION_STRING "1.28.1"
138
<pre class="programlisting">#define PANGO_VERSION_STRING "1.28.3"
158
141
A string literal containing the version of Pango available at compile-time.
162
<div class="refsect2" title="PANGO_VERSION_CHECK()">
145
<div class="refsect2">
163
146
<a name="PANGO-VERSION-CHECK:CAPS"></a><h3>PANGO_VERSION_CHECK()</h3>
164
147
<pre class="programlisting">#define PANGO_VERSION_CHECK(major,minor,micro)</pre>
191
<div class="refsect2" title="pango_version ()">
174
<div class="refsect2">
192
175
<a name="pango-version"></a><h3>pango_version ()</h3>
193
<pre class="programlisting"><span class="returnvalue">int</span> pango_version (void);</pre>
176
<pre class="programlisting"><span class="returnvalue">int</span> pango_version (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
195
178
This is similar to the macro <a class="link" href="pango-Version-Checking.html#PANGO-VERSION:CAPS" title="PANGO_VERSION"><code class="literal">PANGO_VERSION</code></a> except that
196
179
it returns the encoded version of Pango available at run-time,
200
183
A version number can be encoded into an integer using
201
<a class="link" href="pango-Version-Checking.html#PANGO-VERSION-ENCODE:CAPS" title="PANGO_VERSION_ENCODE()"><code class="function">PANGO_VERSION_ENCODE()</code></a>.</p>
184
<a class="link" href="pango-Version-Checking.html#PANGO-VERSION-ENCODE:CAPS" title="PANGO_VERSION_ENCODE()"><code class="function">PANGO_VERSION_ENCODE()</code></a>.
202
186
<div class="variablelist"><table border="0">
203
187
<col align="left" valign="top">
212
196
<p class="since">Since 1.16</p>
215
<div class="refsect2" title="pango_version_string ()">
199
<div class="refsect2">
216
200
<a name="pango-version-string"></a><h3>pango_version_string ()</h3>
217
<pre class="programlisting">const <span class="returnvalue">char</span> * pango_version_string (void);</pre>
201
<pre class="programlisting">const <span class="returnvalue">char</span> * pango_version_string (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
219
203
This is similar to the macro <a class="link" href="pango-Version-Checking.html#PANGO-VERSION-STRING:CAPS" title="PANGO_VERSION_STRING"><code class="literal">PANGO_VERSION_STRING</code></a> except that
220
204
it returns the version of Pango available at run-time, as opposed to
221
the version available at compile-time.</p>
205
the version available at compile-time.
222
207
<div class="variablelist"><table border="0">
223
208
<col align="left" valign="top">
234
219
<p class="since">Since 1.16</p>
237
<div class="refsect2" title="pango_version_check ()">
222
<div class="refsect2">
238
223
<a name="pango-version-check"></a><h3>pango_version_check ()</h3>
239
<pre class="programlisting">const <span class="returnvalue">char</span> * pango_version_check (<span class="returnvalue">int</span> required_major,
240
<span class="returnvalue">int</span> required_minor,
241
<span class="returnvalue">int</span> required_micro);</pre>
224
<pre class="programlisting">const <span class="returnvalue">char</span> * pango_version_check (<em class="parameter"><code><span class="type">int</span> required_major</code></em>,
225
<em class="parameter"><code><span class="type">int</span> required_minor</code></em>,
226
<em class="parameter"><code><span class="type">int</span> required_micro</code></em>);</pre>
243
228
Checks that the Pango library in use is compatible with the
244
229
given version. Generally you would pass in the constants
256
241
(same major version.)
259
For compile-time version checking use <a class="link" href="pango-Version-Checking.html#PANGO-VERSION-CHECK:CAPS" title="PANGO_VERSION_CHECK()"><code class="function">PANGO_VERSION_CHECK()</code></a>.</p>
244
For compile-time version checking use <a class="link" href="pango-Version-Checking.html#PANGO-VERSION-CHECK:CAPS" title="PANGO_VERSION_CHECK()"><code class="function">PANGO_VERSION_CHECK()</code></a>.
260
246
<div class="variablelist"><table border="0">
261
247
<col align="left" valign="top">
264
250
<td><p><span class="term"><em class="parameter"><code>required_major</code></em> :</span></p></td>
265
<td> the required major version.
251
<td>the required major version.
269
255
<td><p><span class="term"><em class="parameter"><code>required_minor</code></em> :</span></p></td>
270
<td> the required minor version.
256
<td>the required minor version.
274
260
<td><p><span class="term"><em class="parameter"><code>required_micro</code></em> :</span></p></td>
275
<td> the required major version.
261
<td>the required major version.
279
265
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
280
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the Pango library is compatible with the
266
<td> <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> if the Pango library is compatible with the
281
267
given version, or a string describing the version mismatch.
282
268
The returned string is owned by Pango and should not be modified