5
5
<title>Versioning Macros</title>
6
6
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
7
7
<link rel="home" href="index.html" title="Clutter Reference Manual">
8
<link rel="up" href="ch07.html" title="General purpose API">
9
<link rel="prev" href="clutter-Utilities.html" title="Utilities">
10
<link rel="next" href="ch08.html" title="User interface definition">
11
<meta name="generator" content="GTK-Doc V1.11 (XML mode)">
8
<link rel="up" href="ch08.html" title="General purpose API">
9
<link rel="prev" href="clutter-Features.html" title="Features">
10
<link rel="next" href="ch09.html" title="User interface definition">
11
<meta name="generator" content="GTK-Doc V1.13 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
<link rel="part" href="clutter-overview.html" title="Part I. Overview">
14
14
<link rel="part" href="building-clutter.html" title="Part II. Building Clutter">
17
17
<link rel="chapter" href="ch01.html" title="Abstract classes and interfaces">
18
18
<link rel="chapter" href="ch02.html" title="Base actors">
19
19
<link rel="chapter" href="ch03.html" title="Container actors">
20
<link rel="chapter" href="ch04.html" title="Layout managers">
20
21
<link rel="part" href="clutteranimation.html" title="Part V. Clutter Animation Framework">
21
<link rel="chapter" href="ch04.html" title="Base classes">
22
<link rel="chapter" href="ch05.html" title="Behaviours">
23
<link rel="chapter" href="ch06.html" title="High Level API">
22
<link rel="chapter" href="ch05.html" title="Base classes">
23
<link rel="chapter" href="ch06.html" title="Behaviours">
24
<link rel="chapter" href="ch07.html" title="High Level API">
24
25
<link rel="part" href="cluttertools.html" title="Part VI. Clutter Tools">
25
<link rel="chapter" href="ch07.html" title="General purpose API">
26
<link rel="chapter" href="ch08.html" title="User interface definition">
27
<link rel="chapter" href="ch09.html" title="Generic list model">
26
<link rel="chapter" href="ch08.html" title="General purpose API">
27
<link rel="chapter" href="ch09.html" title="User interface definition">
28
<link rel="chapter" href="ch10.html" title="Generic list model">
28
29
<link rel="part" href="clutterbackends.html" title="Part VII. Clutter Backends">
29
30
<link rel="part" href="additionaldocs.html" title="Part VIII. Additional Documentation">
30
31
<link rel="chapter" href="clutter-subclassing-ClutterActor.html" title="Implementing a new actor">
47
48
<link rel="index" href="ix05.html" title="Index of new symbols in 0.6">
48
49
<link rel="index" href="ix06.html" title="Index of new symbols in 0.8">
49
50
<link rel="index" href="ix07.html" title="Index of new symbols in 1.0">
51
<link rel="index" href="ix08.html" title="Index of new symbols in 1.2">
50
52
<link rel="appendix" href="license.html" title="Appendix A. License">
52
54
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
53
55
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
54
56
<tr valign="middle">
55
<td><a accesskey="p" href="clutter-Utilities.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
56
<td><a accesskey="u" href="ch07.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
57
<td><a accesskey="p" href="clutter-Features.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
58
<td><a accesskey="u" href="ch08.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
57
59
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
58
60
<th width="100%" align="center">Clutter Reference Manual</th>
59
<td><a accesskey="n" href="ch08.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
61
<td><a accesskey="n" href="ch09.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
61
63
<tr><td colspan="5" class="shortcuts">
62
64
<a href="#clutter-Versioning-Macros.synopsis" class="shortcut">Top</a>
64
<a href="#clutter-Versioning-Macros.description" class="shortcut">Description</a>
66
<a href="#clutter-Versioning-Macros.description" class="shortcut">Description</a>
67
69
<div class="refentry" title="Versioning Macros">
75
77
</tr></table></div>
76
78
<div class="refsynopsisdiv" title="Synopsis">
77
79
<a name="clutter-Versioning-Macros.synopsis"></a><h2>Synopsis</h2>
78
<pre class="synopsis">
79
#define <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-MAJOR-VERSION--CAPS" title="CLUTTER_MAJOR_VERSION">CLUTTER_MAJOR_VERSION</a>
80
#define <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-MINOR-VERSION--CAPS" title="CLUTTER_MINOR_VERSION">CLUTTER_MINOR_VERSION</a>
81
#define <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-MICRO-VERSION--CAPS" title="CLUTTER_MICRO_VERSION">CLUTTER_MICRO_VERSION</a>
82
#define <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-VERSION--CAPS" title="CLUTTER_VERSION">CLUTTER_VERSION</a>
83
#define <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-VERSION-S--CAPS" title="CLUTTER_VERSION_S">CLUTTER_VERSION_S</a>
84
#define <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-VERSION-HEX--CAPS" title="CLUTTER_VERSION_HEX">CLUTTER_VERSION_HEX</a>
85
#define <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-CHECK-VERSION--CAPS" title="CLUTTER_CHECK_VERSION()">CLUTTER_CHECK_VERSION</a> (major,minor,micro)
86
#define <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-FLAVOUR--CAPS" title="CLUTTER_FLAVOUR">CLUTTER_FLAVOUR</a>
87
#define <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-COGL--CAPS" title="CLUTTER_COGL">CLUTTER_COGL</a>
88
#define <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-NO-FPU--CAPS" title="CLUTTER_NO_FPU">CLUTTER_NO_FPU</a>
80
<pre class="synopsis">#define <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-MAJOR-VERSION:CAPS" title="CLUTTER_MAJOR_VERSION">CLUTTER_MAJOR_VERSION</a>
81
#define <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-MINOR-VERSION:CAPS" title="CLUTTER_MINOR_VERSION">CLUTTER_MINOR_VERSION</a>
82
#define <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-MICRO-VERSION:CAPS" title="CLUTTER_MICRO_VERSION">CLUTTER_MICRO_VERSION</a>
83
#define <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-VERSION:CAPS" title="CLUTTER_VERSION">CLUTTER_VERSION</a>
84
#define <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-VERSION-S:CAPS" title="CLUTTER_VERSION_S">CLUTTER_VERSION_S</a>
85
#define <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-VERSION-HEX:CAPS" title="CLUTTER_VERSION_HEX">CLUTTER_VERSION_HEX</a>
87
#define <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-CHECK-VERSION:CAPS" title="CLUTTER_CHECK_VERSION()">CLUTTER_CHECK_VERSION</a> (major,minor,micro)
89
#define <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-FLAVOUR:CAPS" title="CLUTTER_FLAVOUR">CLUTTER_FLAVOUR</a>
90
#define <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-COGL:CAPS" title="CLUTTER_COGL">CLUTTER_COGL</a>
91
#define <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-NO-FPU:CAPS" title="CLUTTER_NO_FPU">CLUTTER_NO_FPU</a>
93
extern const guint <a class="link" href="clutter-Versioning-Macros.html#clutter-major-version" title="clutter_major_version">clutter_major_version</a>;
94
extern const guint <a class="link" href="clutter-Versioning-Macros.html#clutter-minor-version" title="clutter_minor_version">clutter_minor_version</a>;
95
extern const guint <a class="link" href="clutter-Versioning-Macros.html#clutter-micro-version" title="clutter_micro_version">clutter_micro_version</a>;
96
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="clutter-Versioning-Macros.html#clutter-check-version" title="clutter_check_version ()">clutter_check_version</a> (<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> major,
97
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> minor,
98
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> micro);
91
101
<div class="refsect1" title="Description">
94
104
Clutter offers a set of macros for checking the version of the library
95
105
an application was linked to.</p>
99
107
<div class="refsect1" title="Details">
100
108
<a name="clutter-Versioning-Macros.details"></a><h2>Details</h2>
101
109
<div class="refsect2" title="CLUTTER_MAJOR_VERSION">
102
<a name="CLUTTER-MAJOR-VERSION--CAPS"></a><h3>CLUTTER_MAJOR_VERSION</h3>
110
<a name="CLUTTER-MAJOR-VERSION:CAPS"></a><h3>CLUTTER_MAJOR_VERSION</h3>
103
111
<pre class="programlisting">#define CLUTTER_MAJOR_VERSION (1)
106
The major version of the Clutter library (1, if <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-VERSION--CAPS" title="CLUTTER_VERSION"><code class="literal">CLUTTER_VERSION</code></a> is 1.2.3)</p>
114
The major version of the Clutter library (1, if <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-VERSION:CAPS" title="CLUTTER_VERSION"><code class="literal">CLUTTER_VERSION</code></a> is 1.2.3)</p>
111
117
<div class="refsect2" title="CLUTTER_MINOR_VERSION">
112
<a name="CLUTTER-MINOR-VERSION--CAPS"></a><h3>CLUTTER_MINOR_VERSION</h3>
113
<pre class="programlisting">#define CLUTTER_MINOR_VERSION (0)
118
<a name="CLUTTER-MINOR-VERSION:CAPS"></a><h3>CLUTTER_MINOR_VERSION</h3>
119
<pre class="programlisting">#define CLUTTER_MINOR_VERSION (2)
116
The minor version of the Clutter library (2, if <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-VERSION--CAPS" title="CLUTTER_VERSION"><code class="literal">CLUTTER_VERSION</code></a> is 1.2.3)</p>
122
The minor version of the Clutter library (2, if <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-VERSION:CAPS" title="CLUTTER_VERSION"><code class="literal">CLUTTER_VERSION</code></a> is 1.2.3)</p>
121
125
<div class="refsect2" title="CLUTTER_MICRO_VERSION">
122
<a name="CLUTTER-MICRO-VERSION--CAPS"></a><h3>CLUTTER_MICRO_VERSION</h3>
123
<pre class="programlisting">#define CLUTTER_MICRO_VERSION (8)
126
<a name="CLUTTER-MICRO-VERSION:CAPS"></a><h3>CLUTTER_MICRO_VERSION</h3>
127
<pre class="programlisting">#define CLUTTER_MICRO_VERSION (2)
126
The micro version of the Clutter library (3, if <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-VERSION--CAPS" title="CLUTTER_VERSION"><code class="literal">CLUTTER_VERSION</code></a> is 1.2.3)</p>
130
The micro version of the Clutter library (3, if <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-VERSION:CAPS" title="CLUTTER_VERSION"><code class="literal">CLUTTER_VERSION</code></a> is 1.2.3)</p>
131
133
<div class="refsect2" title="CLUTTER_VERSION">
132
<a name="CLUTTER-VERSION--CAPS"></a><h3>CLUTTER_VERSION</h3>
133
<pre class="programlisting">#define CLUTTER_VERSION 1.0.8
134
<a name="CLUTTER-VERSION:CAPS"></a><h3>CLUTTER_VERSION</h3>
135
<pre class="programlisting">#define CLUTTER_VERSION 1.2.2
136
138
The full version of the Clutter library, like 1.2.3</p>
141
141
<div class="refsect2" title="CLUTTER_VERSION_S">
142
<a name="CLUTTER-VERSION-S--CAPS"></a><h3>CLUTTER_VERSION_S</h3>
143
<pre class="programlisting">#define CLUTTER_VERSION_S "1.0.8"
142
<a name="CLUTTER-VERSION-S:CAPS"></a><h3>CLUTTER_VERSION_S</h3>
143
<pre class="programlisting">#define CLUTTER_VERSION_S "1.2.2"
146
146
The full version of the Clutter library, in string form (suited for
147
147
string concatenation)</p>
152
150
<div class="refsect2" title="CLUTTER_VERSION_HEX">
153
<a name="CLUTTER-VERSION-HEX--CAPS"></a><h3>CLUTTER_VERSION_HEX</h3>
151
<a name="CLUTTER-VERSION-HEX:CAPS"></a><h3>CLUTTER_VERSION_HEX</h3>
154
152
<pre class="programlisting">#define CLUTTER_VERSION_HEX</pre>
156
154
Numerically encoded version of the Clutter library, like 0x010203</p>
161
157
<div class="refsect2" title="CLUTTER_CHECK_VERSION()">
162
<a name="CLUTTER-CHECK-VERSION--CAPS"></a><h3>CLUTTER_CHECK_VERSION()</h3>
158
<a name="CLUTTER-CHECK-VERSION:CAPS"></a><h3>CLUTTER_CHECK_VERSION()</h3>
163
159
<pre class="programlisting">#define CLUTTER_CHECK_VERSION(major,minor,micro)</pre>
166
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
167
><code class="literal">TRUE</code></a> if the version of the Clutter library is greater
161
Evaluates to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the version of the Clutter library is greater
168
162
than <em class="parameter"><code>major</code></em>, <em class="parameter"><code>minor</code></em> and <em class="parameter"><code>micro</code></em></p>
171
163
<div class="variablelist"><table border="0">
172
164
<col align="left" valign="top">
193
185
<div class="refsect2" title="CLUTTER_FLAVOUR">
194
<a name="CLUTTER-FLAVOUR--CAPS"></a><h3>CLUTTER_FLAVOUR</h3>
186
<a name="CLUTTER-FLAVOUR:CAPS"></a><h3>CLUTTER_FLAVOUR</h3>
195
187
<pre class="programlisting">#define CLUTTER_FLAVOUR "glx"
198
190
GL Windowing system used</p>
201
191
<p class="since">Since 0.4</p>
204
194
<div class="refsect2" title="CLUTTER_COGL">
205
<a name="CLUTTER-COGL--CAPS"></a><h3>CLUTTER_COGL</h3>
195
<a name="CLUTTER-COGL:CAPS"></a><h3>CLUTTER_COGL</h3>
206
196
<pre class="programlisting">#define CLUTTER_COGL "gl"
209
199
Cogl (internal GL abstraction utility library) backend. Can be "gl" or
210
200
"gles" currently</p>
213
201
<p class="since">Since 0.4</p>
216
204
<div class="refsect2" title="CLUTTER_NO_FPU">
217
<a name="CLUTTER-NO-FPU--CAPS"></a><h3>CLUTTER_NO_FPU</h3>
205
<a name="CLUTTER-NO-FPU:CAPS"></a><h3>CLUTTER_NO_FPU</h3>
218
206
<pre class="programlisting">#define CLUTTER_NO_FPU CLUTTER_NO_FPU_MACRO_WAS_REMOVED
224
212
<em class="parameter"><code>Deprecated</code></em>: 0.6: This macro is no longer defined (identical code is used
225
213
regardless the presence of FPU).</p>
216
<div class="refsect2" title="clutter_major_version">
217
<a name="clutter-major-version"></a><h3>clutter_major_version</h3>
218
<pre class="programlisting">extern const guint clutter_major_version;
221
The major component of the Clutter library version, e.g. 1 if the version
225
This value can be used for run-time version checks
228
For a compile-time check, use <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-MAJOR-VERSION:CAPS" title="CLUTTER_MAJOR_VERSION"><code class="literal">CLUTTER_MAJOR_VERSION</code></a></p>
229
<p class="since">Since 1.2</p>
232
<div class="refsect2" title="clutter_minor_version">
233
<a name="clutter-minor-version"></a><h3>clutter_minor_version</h3>
234
<pre class="programlisting">extern const guint clutter_minor_version;
237
The minor component of the Clutter library version, e.g. 2 if the version
241
This value can be used for run-time version checks
244
For a compile-time check, use <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-MINOR-VERSION:CAPS" title="CLUTTER_MINOR_VERSION"><code class="literal">CLUTTER_MINOR_VERSION</code></a></p>
245
<p class="since">Since 1.2</p>
248
<div class="refsect2" title="clutter_micro_version">
249
<a name="clutter-micro-version"></a><h3>clutter_micro_version</h3>
250
<pre class="programlisting">extern const guint clutter_micro_version;
253
The micro component of the Clutter library version, e.g. 3 if the version
257
This value can be used for run-time version checks
260
For a compile-time check, use <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-MICRO-VERSION:CAPS" title="CLUTTER_MICRO_VERSION"><code class="literal">CLUTTER_MICRO_VERSION</code></a></p>
261
<p class="since">Since 1.2</p>
264
<div class="refsect2" title="clutter_check_version ()">
265
<a name="clutter-check-version"></a><h3>clutter_check_version ()</h3>
266
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> clutter_check_version (<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> major,
267
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> minor,
268
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> micro);</pre>
270
Run-time version check, to check the version the Clutter library
271
that an application is currently linked against
274
This is the run-time equivalent of the compile-time <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-CHECK-VERSION:CAPS" title="CLUTTER_CHECK_VERSION()"><code class="literal">CLUTTER_CHECK_VERSION</code></a>
275
pre-processor macro</p>
276
<div class="variablelist"><table border="0">
277
<col align="left" valign="top">
280
<td><p><span class="term"><em class="parameter"><code>major</code></em> :</span></p></td>
281
<td> major version, like 1 in 1.2.3
285
<td><p><span class="term"><em class="parameter"><code>minor</code></em> :</span></p></td>
286
<td> minor version, like 2 in 1.2.3
290
<td><p><span class="term"><em class="parameter"><code>micro</code></em> :</span></p></td>
291
<td> micro version, like 3 in 1.2.3
295
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
296
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the version of the Clutter library is
297
greater than (<em class="parameter"><code>major</code></em>, <em class="parameter"><code>minor</code></em>, <em class="parameter"><code>micro</code></em>), and <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise
303
<p class="since">Since 1.2</p>
231
307
<div class="footer">
233
Generated by GTK-Doc V1.11</div>
309
Generated by GTK-Doc V1.13</div>
b'\\ No newline at end of file'