doc/reference/clutter/html/clutter-Versioning-Macros.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <html>
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   5 <title>Versioning Macros</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
   7 <link rel="home" href="index.html" title="Clutter Reference Manual">
   8 <link rel="up" href="ch11.html" title="General purpose API">
   9 <link rel="prev" href="clutter-Utilities.html" title="Utilities">
  10 <link rel="next" href="ch12.html" title="User interface definition">
  11 <meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
  12 <link rel="stylesheet" href="style.css" type="text/css">
  13 </head>
  14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
  16 <tr valign="middle">
  17 <td><a accesskey="p" href="clutter-Utilities.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
  18 <td><a accesskey="u" href="ch11.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
  19 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
  20 <th width="100%" align="center">Clutter Reference Manual</th>
  21 <td><a accesskey="n" href="ch12.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
  22 </tr>
  23 <tr><td colspan="5" class="shortcuts">
  24 <a href="#clutter-Versioning-Macros.synopsis" class="shortcut">Top</a>
  25                    |
  26                   <a href="#clutter-Versioning-Macros.description" class="shortcut">Description</a>
  27 </td></tr>
  28 </table>
  29 <div class="refentry">
  30 <a name="clutter-Versioning-Macros"></a><div class="titlepage"></div>
  31 <div class="refnamediv"><table width="100%"><tr>
  32 <td valign="top">
  33 <h2><span class="refentrytitle"><a name="clutter-Versioning-Macros.top_of_page"></a>Versioning Macros</span></h2>
  34 <p>Versioning Macros — Versioning utility macros</p>
  35 </td>
  36 <td valign="top" align="right"></td>
  37 </tr></table></div>
  38 <div class="refsynopsisdiv">
  39 <a name="clutter-Versioning-Macros.synopsis"></a><h2>Synopsis</h2>
  40 <pre class="synopsis">#define             <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-MAJOR-VERSION:CAPS" title="CLUTTER_MAJOR_VERSION">CLUTTER_MAJOR_VERSION</a>
  41 #define             <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-MINOR-VERSION:CAPS" title="CLUTTER_MINOR_VERSION">CLUTTER_MINOR_VERSION</a>
  42 #define             <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-MICRO-VERSION:CAPS" title="CLUTTER_MICRO_VERSION">CLUTTER_MICRO_VERSION</a>
  43 #define             <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-VERSION:CAPS" title="CLUTTER_VERSION">CLUTTER_VERSION</a>
  44 #define             <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-VERSION-S:CAPS" title="CLUTTER_VERSION_S">CLUTTER_VERSION_S</a>
  45 #define             <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-VERSION-HEX:CAPS" title="CLUTTER_VERSION_HEX">CLUTTER_VERSION_HEX</a>
  46
  47 #define             <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-CHECK-VERSION:CAPS" title="CLUTTER_CHECK_VERSION()">CLUTTER_CHECK_VERSION</a>               (major,
  48                                                          minor,
  49                                                          micro)
  50
  51 #define             <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-FLAVOUR:CAPS" title="CLUTTER_FLAVOUR">CLUTTER_FLAVOUR</a>
  52 #define             <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-COGL:CAPS" title="CLUTTER_COGL">CLUTTER_COGL</a>
  53 #define             <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-NO-FPU:CAPS" title="CLUTTER_NO_FPU">CLUTTER_NO_FPU</a>
  54
  55 #define             <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-VERSION-1-0:CAPS" title="CLUTTER_VERSION_1_0">CLUTTER_VERSION_1_0</a>
  56 #define             <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-VERSION-1-2:CAPS" title="CLUTTER_VERSION_1_2">CLUTTER_VERSION_1_2</a>
  57 #define             <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-VERSION-1-4:CAPS" title="CLUTTER_VERSION_1_4">CLUTTER_VERSION_1_4</a>
  58 #define             <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-VERSION-1-6:CAPS" title="CLUTTER_VERSION_1_6">CLUTTER_VERSION_1_6</a>
  59 #define             <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-VERSION-1-8:CAPS" title="CLUTTER_VERSION_1_8">CLUTTER_VERSION_1_8</a>
  60 #define             <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-VERSION-1-10:CAPS" title="CLUTTER_VERSION_1_10">CLUTTER_VERSION_1_10</a>
  61 #define             <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-VERSION-MAX-ALLOWED:CAPS" title="CLUTTER_VERSION_MAX_ALLOWED">CLUTTER_VERSION_MAX_ALLOWED</a>
  62 #define             <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-VERSION-MIN-REQUIRED:CAPS" title="CLUTTER_VERSION_MIN_REQUIRED">CLUTTER_VERSION_MIN_REQUIRED</a>
  63
  64 extern const guint  <a class="link" href="clutter-Versioning-Macros.html#clutter-major-version" title="clutter_major_version">clutter_major_version</a>;
  65 extern const guint  <a class="link" href="clutter-Versioning-Macros.html#clutter-minor-version" title="clutter_minor_version">clutter_minor_version</a>;
  66 extern const guint  <a class="link" href="clutter-Versioning-Macros.html#clutter-micro-version" title="clutter_micro_version">clutter_micro_version</a>;
  67 <a href="../glib/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>               (<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> major</code></em>,
  68                                                          <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> minor</code></em>,
  69                                                          <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> micro</code></em>);
  70 </pre>
  71 </div>
  72 <div class="refsect1">
  73 <a name="clutter-Versioning-Macros.description"></a><h2>Description</h2>
  74 <p>
  75 Clutter offers a set of macros for checking the version of the library
  76 at compile time; it also provides a function to perform the same check
  77 at run time.
  78 </p>
  79 <p>
  80 Clutter adds version information to both API deprecations and additions;
  81 by definining the macros <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-VERSION-MIN-REQUIRED:CAPS" title="CLUTTER_VERSION_MIN_REQUIRED"><code class="literal">CLUTTER_VERSION_MIN_REQUIRED</code></a> and
  82 <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-VERSION-MAX-ALLOWED:CAPS" title="CLUTTER_VERSION_MAX_ALLOWED"><code class="literal">CLUTTER_VERSION_MAX_ALLOWED</code></a>, you can specify the range of Clutter versions
  83 whose API you want to use. Functions that were deprecated before, or
  84 introduced after, this range will trigger compiler warnings. For instance,
  85 if we define the following symbols:
  86 </p>
  87 <p>
  88 </p>
  89 <div class="informalexample">
  90   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
  91     <tbody>
  92       <tr>
  93         <td class="listing_lines" align="right"><pre>1
  94 2</pre></td>
  95         <td class="listing_code"><pre class="programlisting"><span class="normal"><a href="clutter-Versioning-Macros.html#CLUTTER-VERSION-MIN-REQUIRED:CAPS">CLUTTER_VERSION_MIN_REQUIRED</a> </span><span class="symbol">=</span><span class="normal"> <a href="clutter-Versioning-Macros.html#CLUTTER-VERSION-1-6:CAPS">CLUTTER_VERSION_1_6</a></span>
  96 <span class="normal"><a href="clutter-Versioning-Macros.html#CLUTTER-VERSION-MAX-ALLOWED:CAPS">CLUTTER_VERSION_MAX_ALLOWED</a>  </span><span class="symbol">=</span><span class="normal"> <a href="clutter-Versioning-Macros.html#CLUTTER-VERSION-1-8:CAPS">CLUTTER_VERSION_1_8</a></span></pre></td>
  97       </tr>
  98     </tbody>
  99   </table>
 100 </div>
 101
 102 <p>
 103 </p>
 104 <p>
 105 and we have the following functions annotated in the Clutter headers:
 106 </p>
 107 <p>
 108 </p>
 109 <div class="informalexample">
 110   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
 111     <tbody>
 112       <tr>
 113         <td class="listing_lines" align="right"><pre>1
 114 2
 115 3
 116 4</pre></td>
 117         <td class="listing_code"><pre class="programlisting"><span class="type">void</span><span class="normal"> </span><span class="function">clutter_function_A</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">)</span><span class="normal"> CLUTTER_DEPRECATED_IN_1_4</span><span class="symbol">;</span>
 118 <span class="type">void</span><span class="normal"> </span><span class="function">clutter_function_B</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">)</span><span class="normal"> CLUTTER_DEPRECATED_IN_1_6</span><span class="symbol">;</span>
 119 <span class="type">void</span><span class="normal"> </span><span class="function">clutter_function_C</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">)</span><span class="normal"> CLUTTER_AVAILABLE_IN_1_8</span><span class="symbol">;</span>
 120 <span class="type">void</span><span class="normal"> </span><span class="function">clutter_function_D</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">)</span><span class="normal"> CLUTTER_AVAILABLE_IN_1_10</span><span class="symbol">;</span></pre></td>
 121       </tr>
 122     </tbody>
 123   </table>
 124 </div>
 125
 126 <p>
 127 </p>
 128 <p>
 129 then any application code using the functions above will get the output:
 130 </p>
 131 <p>
 132 </p>
 133 <div class="informalexample">
 134   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
 135     <tbody>
 136       <tr>
 137         <td class="listing_lines" align="right"><pre>1
 138 2
 139 3
 140 4</pre></td>
 141         <td class="listing_code"><pre class="programlisting"><span class="normal">clutter_function_A</span><span class="symbol">:</span><span class="normal"> deprecation warning</span>
 142 <span class="normal">clutter_function_B</span><span class="symbol">:</span><span class="normal"> no warning</span>
 143 <span class="normal">clutter_function_C</span><span class="symbol">:</span><span class="normal"> no warning</span>
 144 <span class="normal">clutter_function_D</span><span class="symbol">:</span><span class="normal"> symbol not available warning</span></pre></td>
 145       </tr>
 146     </tbody>
 147   </table>
 148 </div>
 149
 150 <p>
 151 </p>
 152 <p>
 153 It is possible to disable the compiler warnings by defining the macro
 154 <code class="literal">CLUTTER_DISABLE_DEPRECATION_WARNINGS</code> before including the clutter.h
 155 header.
 156 </p>
 157 </div>
 158 <div class="refsect1">
 159 <a name="clutter-Versioning-Macros.details"></a><h2>Details</h2>
 160 <div class="refsect2">
 161 <a name="CLUTTER-MAJOR-VERSION:CAPS"></a><h3>CLUTTER_MAJOR_VERSION</h3>
 162 <pre class="programlisting">#define CLUTTER_MAJOR_VERSION   (1)
 163 </pre>
 164 <p>
 165 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)
 166 </p>
 167 </div>
 168 <hr>
 169 <div class="refsect2">
 170 <a name="CLUTTER-MINOR-VERSION:CAPS"></a><h3>CLUTTER_MINOR_VERSION</h3>
 171 <pre class="programlisting">#define CLUTTER_MINOR_VERSION   (10)
 172 </pre>
 173 <p>
 174 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)
 175 </p>
 176 </div>
 177 <hr>
 178 <div class="refsect2">
 179 <a name="CLUTTER-MICRO-VERSION:CAPS"></a><h3>CLUTTER_MICRO_VERSION</h3>
 180 <pre class="programlisting">#define CLUTTER_MICRO_VERSION   (4)
 181 </pre>
 182 <p>
 183 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)
 184 </p>
 185 </div>
 186 <hr>
 187 <div class="refsect2">
 188 <a name="CLUTTER-VERSION:CAPS"></a><h3>CLUTTER_VERSION</h3>
 189 <pre class="programlisting">#define CLUTTER_VERSION         1.10.4
 190 </pre>
 191 <p>
 192 The full version of the Clutter library, like 1.2.3
 193 </p>
 194 </div>
 195 <hr>
 196 <div class="refsect2">
 197 <a name="CLUTTER-VERSION-S:CAPS"></a><h3>CLUTTER_VERSION_S</h3>
 198 <pre class="programlisting">#define CLUTTER_VERSION_S       "1.10.4"
 199 </pre>
 200 <p>
 201 The full version of the Clutter library, in string form (suited for
 202 string concatenation)
 203 </p>
 204 </div>
 205 <hr>
 206 <div class="refsect2">
 207 <a name="CLUTTER-VERSION-HEX:CAPS"></a><h3>CLUTTER_VERSION_HEX</h3>
 208 <pre class="programlisting">#define             CLUTTER_VERSION_HEX</pre>
 209 <p>
 210 Numerically encoded version of the Clutter library, like 0x010203
 211 </p>
 212 </div>
 213 <hr>
 214 <div class="refsect2">
 215 <a name="CLUTTER-CHECK-VERSION:CAPS"></a><h3>CLUTTER_CHECK_VERSION()</h3>
 216 <pre class="programlisting">#define             CLUTTER_CHECK_VERSION(major,minor,micro)</pre>
 217 <p>
 218 Evaluates to <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the version of the Clutter library is greater
 219 than <em class="parameter"><code>major</code></em>, <em class="parameter"><code>minor</code></em> and <em class="parameter"><code>micro</code></em>
 220 </p>
 221 <div class="variablelist"><table border="0">
 222 <col align="left" valign="top">
 223 <tbody>
 224 <tr>
 225 <td><p><span class="term"><em class="parameter"><code>major</code></em> :</span></p></td>
 226 <td>major version, like 1 in 1.2.3</td>
 227 </tr>
 228 <tr>
 229 <td><p><span class="term"><em class="parameter"><code>minor</code></em> :</span></p></td>
 230 <td>minor version, like 2 in 1.2.3</td>
 231 </tr>
 232 <tr>
 233 <td><p><span class="term"><em class="parameter"><code>micro</code></em> :</span></p></td>
 234 <td>micro version, like 3 in 1.2.3</td>
 235 </tr>
 236 </tbody>
 237 </table></div>
 238 </div>
 239 <hr>
 240 <div class="refsect2">
 241 <a name="CLUTTER-FLAVOUR:CAPS"></a><h3>CLUTTER_FLAVOUR</h3>
 242 <pre class="programlisting">#define CLUTTER_FLAVOUR         "deprecated"
 243 </pre>
 244 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 245 <h3 class="title">Warning</h3>
 246 <p><code class="literal">CLUTTER_FLAVOUR</code> has been deprecated since version 1.10 and should not be used in newly-written code. The macro evaluates to "deprecated" as Clutter can be
 247   compiled with multiple windowing system backends. Use the various
 248   CLUTTER_WINDOWING_* macros to detect the windowing system that Clutter
 249   is being compiled against, and the type check macros for the
 250   <a class="link" href="ClutterBackend.html" title="ClutterBackend"><span class="type">ClutterBackend</span></a> for a run-time check.</p>
 251 </div>
 252 <p>
 253 GL Windowing system used
 254 </p>
 255 <p class="since">Since 0.4</p>
 256 </div>
 257 <hr>
 258 <div class="refsect2">
 259 <a name="CLUTTER-COGL:CAPS"></a><h3>CLUTTER_COGL</h3>
 260 <pre class="programlisting">#define CLUTTER_COGL            "deprecated"
 261 </pre>
 262 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 263 <h3 class="title">Warning</h3>
 264 <p><code class="literal">CLUTTER_COGL</code> has been deprecated since version 1.10 and should not be used in newly-written code. The macro evaluates to "deprecated" as Cogl can be
 265   compiled against multiple GL implementations.</p>
 266 </div>
 267 <p>
 268 Cogl (internal GL abstraction utility library) backend. Can be "gl" or
 269 "gles" currently
 270 </p>
 271 <p class="since">Since 0.4</p>
 272 </div>
 273 <hr>
 274 <div class="refsect2">
 275 <a name="CLUTTER-NO-FPU:CAPS"></a><h3>CLUTTER_NO_FPU</h3>
 276 <pre class="programlisting">#define CLUTTER_NO_FPU          (0)
 277 </pre>
 278 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 279 <h3 class="title">Warning</h3>
 280 <p><code class="literal">CLUTTER_NO_FPU</code> has been deprecated since version 0.6 and should not be used in newly-written code. This macro is no longer defined (identical code is used
 281  regardless the presence of FPU).</p>
 282 </div>
 283 <p>
 284 Set to 1 if Clutter was built without FPU (i.e fixed math), 0 otherwise
 285 </p>
 286 </div>
 287 <hr>
 288 <div class="refsect2">
 289 <a name="CLUTTER-VERSION-1-0:CAPS"></a><h3>CLUTTER_VERSION_1_0</h3>
 290 <pre class="programlisting">#define CLUTTER_VERSION_1_0     (G_ENCODE_VERSION (1, 0))
 291 </pre>
 292 <p>
 293 A macro that evaluates to the 1.0 version of Clutter, in a format
 294 that can be used by the C pre-processor.
 295 </p>
 296 <p class="since">Since 1.10</p>
 297 </div>
 298 <hr>
 299 <div class="refsect2">
 300 <a name="CLUTTER-VERSION-1-2:CAPS"></a><h3>CLUTTER_VERSION_1_2</h3>
 301 <pre class="programlisting">#define CLUTTER_VERSION_1_2     (G_ENCODE_VERSION (1, 2))
 302 </pre>
 303 <p>
 304 A macro that evaluates to the 1.2 version of Clutter, in a format
 305 that can be used by the C pre-processor.
 306 </p>
 307 <p class="since">Since 1.10</p>
 308 </div>
 309 <hr>
 310 <div class="refsect2">
 311 <a name="CLUTTER-VERSION-1-4:CAPS"></a><h3>CLUTTER_VERSION_1_4</h3>
 312 <pre class="programlisting">#define CLUTTER_VERSION_1_4     (G_ENCODE_VERSION (1, 4))
 313 </pre>
 314 <p>
 315 A macro that evaluates to the 1.4 version of Clutter, in a format
 316 that can be used by the C pre-processor.
 317 </p>
 318 <p class="since">Since 1.10</p>
 319 </div>
 320 <hr>
 321 <div class="refsect2">
 322 <a name="CLUTTER-VERSION-1-6:CAPS"></a><h3>CLUTTER_VERSION_1_6</h3>
 323 <pre class="programlisting">#define CLUTTER_VERSION_1_6     (G_ENCODE_VERSION (1, 6))
 324 </pre>
 325 <p>
 326 A macro that evaluates to the 1.6 version of Clutter, in a format
 327 that can be used by the C pre-processor.
 328 </p>
 329 <p class="since">Since 1.10</p>
 330 </div>
 331 <hr>
 332 <div class="refsect2">
 333 <a name="CLUTTER-VERSION-1-8:CAPS"></a><h3>CLUTTER_VERSION_1_8</h3>
 334 <pre class="programlisting">#define CLUTTER_VERSION_1_8     (G_ENCODE_VERSION (1, 8))
 335 </pre>
 336 <p>
 337 A macro that evaluates to the 1.8 version of Clutter, in a format
 338 that can be used by the C pre-processor.
 339 </p>
 340 <p class="since">Since 1.10</p>
 341 </div>
 342 <hr>
 343 <div class="refsect2">
 344 <a name="CLUTTER-VERSION-1-10:CAPS"></a><h3>CLUTTER_VERSION_1_10</h3>
 345 <pre class="programlisting">#define CLUTTER_VERSION_1_10    (G_ENCODE_VERSION (1, 10))
 346 </pre>
 347 <p>
 348 A macro that evaluates to the 1.10 version of Clutter, in a format
 349 that can be used by the C pre-processor.
 350 </p>
 351 <p class="since">Since 1.10</p>
 352 </div>
 353 <hr>
 354 <div class="refsect2">
 355 <a name="CLUTTER-VERSION-MAX-ALLOWED:CAPS"></a><h3>CLUTTER_VERSION_MAX_ALLOWED</h3>
 356 <pre class="programlisting">#  define CLUTTER_VERSION_MAX_ALLOWED   CLUTTER_VERSION_MIN_REQUIRED
 357 </pre>
 358 <p>
 359 A macro that should be define by the user prior to including the
 360 clutter.h header.
 361 </p>
 362 <p>
 363 The definition should be one of the predefined Clutter version macros,
 364 such as: <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-VERSION-1-0:CAPS" title="CLUTTER_VERSION_1_0"><code class="literal">CLUTTER_VERSION_1_0</code></a>, <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-VERSION-1-2:CAPS" title="CLUTTER_VERSION_1_2"><code class="literal">CLUTTER_VERSION_1_2</code></a>, ...
 365 </p>
 366 <p>
 367 This macro defines the upper bound for the Clutter API to be used.
 368 </p>
 369 <p>
 370 If a function has been introduced in a newer version of Clutter, it
 371 is possible to use this symbol to get compiler warnings when trying
 372 to use that function.
 373 </p>
 374 <p class="since">Since 1.10</p>
 375 </div>
 376 <hr>
 377 <div class="refsect2">
 378 <a name="CLUTTER-VERSION-MIN-REQUIRED:CAPS"></a><h3>CLUTTER_VERSION_MIN_REQUIRED</h3>
 379 <pre class="programlisting"># define CLUTTER_VERSION_MIN_REQUIRED   (CLUTTER_VERSION_PREV_STABLE)
 380 </pre>
 381 <p>
 382 A macro that should be defined by the user prior to including the
 383 clutter.h header.
 384 </p>
 385 <p>
 386 The definition should be one of the predefined Clutter version macros,
 387 such as: <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-VERSION-1-0:CAPS" title="CLUTTER_VERSION_1_0"><code class="literal">CLUTTER_VERSION_1_0</code></a>, <a class="link" href="clutter-Versioning-Macros.html#CLUTTER-VERSION-1-2:CAPS" title="CLUTTER_VERSION_1_2"><code class="literal">CLUTTER_VERSION_1_2</code></a>, ...
 388 </p>
 389 <p>
 390 This macro defines the lower bound for the Clutter API to be used.
 391 </p>
 392 <p>
 393 If a function has been deprecated in a newer version of Clutter, it
 394 is possible to use this symbol to avoid the compiler warnings without
 395 disabling warnings for every deprecated function.
 396 </p>
 397 <p class="since">Since 1.10</p>
 398 </div>
 399 <hr>
 400 <div class="refsect2">
 401 <a name="clutter-major-version"></a><h3>clutter_major_version</h3>
 402 <pre class="programlisting">extern const guint clutter_major_version;
 403 </pre>
 404 <p>
 405 The major component of the Clutter library version, e.g. 1 if the version
 406 is 1.2.3
 407 </p>
 408 <p>
 409 This value can be used for run-time version checks
 410 </p>
 411 <p>
 412 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>
 413 </p>
 414 <p class="since">Since 1.2</p>
 415 </div>
 416 <hr>
 417 <div class="refsect2">
 418 <a name="clutter-minor-version"></a><h3>clutter_minor_version</h3>
 419 <pre class="programlisting">extern const guint clutter_minor_version;
 420 </pre>
 421 <p>
 422 The minor component of the Clutter library version, e.g. 2 if the version
 423 is 1.2.3
 424 </p>
 425 <p>
 426 This value can be used for run-time version checks
 427 </p>
 428 <p>
 429 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>
 430 </p>
 431 <p class="since">Since 1.2</p>
 432 </div>
 433 <hr>
 434 <div class="refsect2">
 435 <a name="clutter-micro-version"></a><h3>clutter_micro_version</h3>
 436 <pre class="programlisting">extern const guint clutter_micro_version;
 437 </pre>
 438 <p>
 439 The micro component of the Clutter library version, e.g. 3 if the version
 440 is 1.2.3
 441 </p>
 442 <p>
 443 This value can be used for run-time version checks
 444 </p>
 445 <p>
 446 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>
 447 </p>
 448 <p class="since">Since 1.2</p>
 449 </div>
 450 <hr>
 451 <div class="refsect2">
 452 <a name="clutter-check-version"></a><h3>clutter_check_version ()</h3>
 453 <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            clutter_check_version               (<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> major</code></em>,
 454                                                          <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> minor</code></em>,
 455                                                          <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> micro</code></em>);</pre>
 456 <p>
 457 Run-time version check, to check the version the Clutter library
 458 that an application is currently linked against
 459 </p>
 460 <p>
 461 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>
 462 pre-processor macro
 463 </p>
 464 <div class="variablelist"><table border="0">
 465 <col align="left" valign="top">
 466 <tbody>
 467 <tr>
 468 <td><p><span class="term"><em class="parameter"><code>major</code></em> :</span></p></td>
 469 <td>major version, like 1 in 1.2.3</td>
 470 </tr>
 471 <tr>
 472 <td><p><span class="term"><em class="parameter"><code>minor</code></em> :</span></p></td>
 473 <td>minor version, like 2 in 1.2.3</td>
 474 </tr>
 475 <tr>
 476 <td><p><span class="term"><em class="parameter"><code>micro</code></em> :</span></p></td>
 477 <td>micro version, like 3 in 1.2.3</td>
 478 </tr>
 479 <tr>
 480 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 481 <td>
 482 <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the version of the Clutter library is
 483 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="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise</td>
 484 </tr>
 485 </tbody>
 486 </table></div>
 487 <p class="since">Since 1.2</p>
 488 </div>
 489 </div>
 490 </div>
 491 <div class="footer">
 492 <hr>
 493           Generated by GTK-Doc V1.18.1</div>
 494 </body>
 495 </html>