clutter-gtk 2.0.0-x86-mingw32

Sign up to get free protection for your applications and to get access to all the features.
Files changed (54) hide show
  1. data/Rakefile +74 -0
  2. data/lib/clutter-gtk.rb +65 -0
  3. data/sample/events.rb +178 -0
  4. data/sample/multistage.rb +176 -0
  5. data/sample/redhand.png +0 -0
  6. data/sample/test-actor.rb +165 -0
  7. data/sample/test-scroll.rb +176 -0
  8. data/sample/test.rb +171 -0
  9. data/sample/window-test.rb +115 -0
  10. data/sample/window-test2.rb +134 -0
  11. data/test/clutter-gtk-test-utils.rb +21 -0
  12. data/test/run-test.rb +50 -0
  13. data/vendor/local/include/clutter-gtk-1.0/clutter-gtk/clutter-gtk.h +17 -0
  14. data/vendor/local/include/clutter-gtk-1.0/clutter-gtk/gtk-clutter-actor.h +87 -0
  15. data/vendor/local/include/clutter-gtk-1.0/clutter-gtk/gtk-clutter-embed.h +94 -0
  16. data/vendor/local/include/clutter-gtk-1.0/clutter-gtk/gtk-clutter-texture.h +115 -0
  17. data/vendor/local/include/clutter-gtk-1.0/clutter-gtk/gtk-clutter-util.h +46 -0
  18. data/vendor/local/include/clutter-gtk-1.0/clutter-gtk/gtk-clutter-version.h +111 -0
  19. data/vendor/local/include/clutter-gtk-1.0/clutter-gtk/gtk-clutter-window.h +90 -0
  20. data/vendor/local/lib/girepository-1.0/GtkClutter-1.0.typelib +0 -0
  21. data/vendor/local/lib/libclutter-gtk-1.0.a +0 -0
  22. data/vendor/local/lib/libclutter-gtk-1.0.la +41 -0
  23. data/vendor/local/lib/pkgconfig/clutter-gtk-1.0.pc +13 -0
  24. data/vendor/local/share/gir-1.0/GtkClutter-1.0.gir +669 -0
  25. data/vendor/local/share/gtk-doc/html/clutter-gtk-1.0/GtkClutterActor.html +275 -0
  26. data/vendor/local/share/gtk-doc/html/clutter-gtk-1.0/GtkClutterEmbed.html +272 -0
  27. data/vendor/local/share/gtk-doc/html/clutter-gtk-1.0/GtkClutterWindow.html +170 -0
  28. data/vendor/local/share/gtk-doc/html/clutter-gtk-1.0/annotation-glossary.html +58 -0
  29. data/vendor/local/share/gtk-doc/html/clutter-gtk-1.0/ch01.html +36 -0
  30. data/vendor/local/share/gtk-doc/html/clutter-gtk-1.0/ch02.html +42 -0
  31. data/vendor/local/share/gtk-doc/html/clutter-gtk-1.0/ch03.html +34 -0
  32. data/vendor/local/share/gtk-doc/html/clutter-gtk-1.0/clutter-gtk-1.0-Utility-Functions.html +257 -0
  33. data/vendor/local/share/gtk-doc/html/clutter-gtk-1.0/clutter-gtk-1.0.devhelp2 +50 -0
  34. data/vendor/local/share/gtk-doc/html/clutter-gtk-1.0/cluttergtk-glossary.html +35 -0
  35. data/vendor/local/share/gtk-doc/html/clutter-gtk-1.0/cluttergtk-object-hierarchy.html +45 -0
  36. data/vendor/local/share/gtk-doc/html/clutter-gtk-1.0/cluttergtk-object-index.html +60 -0
  37. data/vendor/local/share/gtk-doc/html/clutter-gtk-1.0/cluttergtk-objects.html +38 -0
  38. data/vendor/local/share/gtk-doc/html/clutter-gtk-1.0/home.png +0 -0
  39. data/vendor/local/share/gtk-doc/html/clutter-gtk-1.0/index.html +82 -0
  40. data/vendor/local/share/gtk-doc/html/clutter-gtk-1.0/index.sgml +53 -0
  41. data/vendor/local/share/gtk-doc/html/clutter-gtk-1.0/ix01.html +100 -0
  42. data/vendor/local/share/gtk-doc/html/clutter-gtk-1.0/ix02.html +203 -0
  43. data/vendor/local/share/gtk-doc/html/clutter-gtk-1.0/ix03.html +71 -0
  44. data/vendor/local/share/gtk-doc/html/clutter-gtk-1.0/ix04.html +32 -0
  45. data/vendor/local/share/gtk-doc/html/clutter-gtk-1.0/left.png +0 -0
  46. data/vendor/local/share/gtk-doc/html/clutter-gtk-1.0/license.html +59 -0
  47. data/vendor/local/share/gtk-doc/html/clutter-gtk-1.0/right.png +0 -0
  48. data/vendor/local/share/gtk-doc/html/clutter-gtk-1.0/style.css +266 -0
  49. data/vendor/local/share/gtk-doc/html/clutter-gtk-1.0/up.png +0 -0
  50. data/vendor/local/share/license/clutter-gtk/COPYING +504 -0
  51. data/vendor/local/share/locale/ja/LC_MESSAGES/cluttergtk-1.0.mo +0 -0
  52. data/vendor/local/share/locale/pl/LC_MESSAGES/cluttergtk-1.0.mo +0 -0
  53. data/vendor/local/share/locale/zh_CN/LC_MESSAGES/cluttergtk-1.0.mo +0 -0
  54. metadata +145 -0
@@ -0,0 +1,170 @@
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>GtkClutterWindow</title>
6
+ <meta name="generator" content="DocBook XSL Stylesheets V1.77.1">
7
+ <link rel="home" href="index.html" title="Clutter-Gtk 1.4.4 Reference Manual">
8
+ <link rel="up" href="ch02.html" title="Clutter-Gtk Widgets">
9
+ <link rel="prev" href="GtkClutterActor.html" title="GtkClutterActor">
10
+ <link rel="next" href="ch03.html" title="Miscellaneous">
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="GtkClutterActor.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
+ <td><a accesskey="u" href="ch02.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-Gtk 1.4.4
21
+ Reference Manual</th>
22
+ <td><a accesskey="n" href="ch03.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
23
+ </tr>
24
+ <tr><td colspan="5" class="shortcuts">
25
+ <a href="#GtkClutterWindow.synopsis" class="shortcut">Top</a>
26
+  | 
27
+ <a href="#GtkClutterWindow.description" class="shortcut">Description</a>
28
+  | 
29
+ <a href="#GtkClutterWindow.object-hierarchy" class="shortcut">Object Hierarchy</a>
30
+  | 
31
+ <a href="#GtkClutterWindow.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
32
+ </td></tr>
33
+ </table>
34
+ <div class="refentry">
35
+ <a name="GtkClutterWindow"></a><div class="titlepage"></div>
36
+ <div class="refnamediv"><table width="100%"><tr>
37
+ <td valign="top">
38
+ <h2><span class="refentrytitle"><a name="GtkClutterWindow.top_of_page"></a>GtkClutterWindow</span></h2>
39
+ <p>GtkClutterWindow — a GtkWindow that embeds its contents onto a stage</p>
40
+ </td>
41
+ <td valign="top" align="right"></td>
42
+ </tr></table></div>
43
+ <div class="refsynopsisdiv">
44
+ <a name="GtkClutterWindow.synopsis"></a><h2>Synopsis</h2>
45
+ <pre class="synopsis">struct <a class="link" href="GtkClutterWindow.html#GtkClutterWindow-struct" title="struct GtkClutterWindow">GtkClutterWindow</a>;
46
+ struct <a class="link" href="GtkClutterWindow.html#GtkClutterWindowClass" title="struct GtkClutterWindowClass">GtkClutterWindowClass</a>;
47
+ <span class="returnvalue">GtkWidget</span> * <a class="link" href="GtkClutterWindow.html#gtk-clutter-window-new" title="gtk_clutter_window_new ()">gtk_clutter_window_new</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
48
+ <span class="returnvalue">ClutterActor</span> * <a class="link" href="GtkClutterWindow.html#gtk-clutter-window-get-stage" title="gtk_clutter_window_get_stage ()">gtk_clutter_window_get_stage</a> (<em class="parameter"><code><a class="link" href="GtkClutterWindow.html" title="GtkClutterWindow"><span class="type">GtkClutterWindow</span></a> *window</code></em>);
49
+ </pre>
50
+ </div>
51
+ <div class="refsect1">
52
+ <a name="GtkClutterWindow.object-hierarchy"></a><h2>Object Hierarchy</h2>
53
+ <pre class="synopsis">
54
+ GObject
55
+ +----GInitiallyUnowned
56
+ +----GtkWidget
57
+ +----GtkContainer
58
+ +----GtkBin
59
+ +----GtkWindow
60
+ +----GtkClutterWindow
61
+ </pre>
62
+ </div>
63
+ <div class="refsect1">
64
+ <a name="GtkClutterWindow.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
65
+ <p>
66
+ GtkClutterWindow implements
67
+ AtkImplementorIface and GtkBuildable.</p>
68
+ </div>
69
+ <div class="refsect1">
70
+ <a name="GtkClutterWindow.description"></a><h2>Description</h2>
71
+ <p>
72
+ <a class="link" href="GtkClutterWindow.html" title="GtkClutterWindow"><span class="type">GtkClutterWindow</span></a> is a <span class="type">GtkWindow</span> sub-class that embeds a Clutter stage.
73
+ </p>
74
+ <p>
75
+ <a class="link" href="GtkClutterWindow.html" title="GtkClutterWindow"><span class="type">GtkClutterWindow</span></a> behaves exactly like a <span class="type">GtkWindow</span>, except that its
76
+ child is automatically embedded inside a <a class="link" href="GtkClutterActor.html" title="GtkClutterActor"><span class="type">GtkClutterActor</span></a> and it is
77
+ thus part of the embedded <span class="type">ClutterStage</span>.
78
+ </p>
79
+ <p>
80
+ Clutter actors can be added to the same stage by calling
81
+ <a class="link" href="GtkClutterWindow.html#gtk-clutter-window-get-stage" title="gtk_clutter_window_get_stage ()"><code class="function">gtk_clutter_window_get_stage()</code></a>.
82
+ </p>
83
+ </div>
84
+ <div class="refsect1">
85
+ <a name="GtkClutterWindow.details"></a><h2>Details</h2>
86
+ <div class="refsect2">
87
+ <a name="GtkClutterWindow-struct"></a><h3>struct GtkClutterWindow</h3>
88
+ <pre class="programlisting">struct GtkClutterWindow;</pre>
89
+ <p>
90
+ A <span class="type">GtkWindow</span> containing a <span class="type">ClutterStage</span>.
91
+ </p>
92
+ <p>
93
+ The <span class="structname">GtkClutterWindow</span> structure contains only
94
+ private data and it should be accessed using the provided API.
95
+ </p>
96
+ </div>
97
+ <hr>
98
+ <div class="refsect2">
99
+ <a name="GtkClutterWindowClass"></a><h3>struct GtkClutterWindowClass</h3>
100
+ <pre class="programlisting">struct GtkClutterWindowClass {
101
+ };
102
+ </pre>
103
+ <p>
104
+ Base class for <a class="link" href="GtkClutterWindow.html" title="GtkClutterWindow"><span class="type">GtkClutterWindow</span></a>.
105
+ </p>
106
+ <p>
107
+ The <span class="structname">GtkClutterWindowClass</span> structure contains
108
+ only private data.
109
+ </p>
110
+ </div>
111
+ <hr>
112
+ <div class="refsect2">
113
+ <a name="gtk-clutter-window-new"></a><h3>gtk_clutter_window_new ()</h3>
114
+ <pre class="programlisting"><span class="returnvalue">GtkWidget</span> * gtk_clutter_window_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
115
+ <p>
116
+ Creates a new <a class="link" href="GtkClutterWindow.html" title="GtkClutterWindow"><span class="type">GtkClutterWindow</span></a> widget.
117
+ </p>
118
+ <p>
119
+ This window provides a hidden <span class="type">ClutterStage</span> on which the child
120
+ <span class="type">GtkWidget</span>s are placed. This allows other <span class="type">ClutterActor</span>s
121
+ to also be placed on the stage.
122
+ </p>
123
+ <div class="variablelist"><table border="0" class="variablelist">
124
+ <colgroup>
125
+ <col align="left" valign="top">
126
+ <col>
127
+ </colgroup>
128
+ <tbody><tr>
129
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
130
+ <td>the newly created <a class="link" href="GtkClutterWindow.html" title="GtkClutterWindow"><span class="type">GtkClutterWindow</span></a>
131
+ </td>
132
+ </tr></tbody>
133
+ </table></div>
134
+ </div>
135
+ <hr>
136
+ <div class="refsect2">
137
+ <a name="gtk-clutter-window-get-stage"></a><h3>gtk_clutter_window_get_stage ()</h3>
138
+ <pre class="programlisting"><span class="returnvalue">ClutterActor</span> * gtk_clutter_window_get_stage (<em class="parameter"><code><a class="link" href="GtkClutterWindow.html" title="GtkClutterWindow"><span class="type">GtkClutterWindow</span></a> *window</code></em>);</pre>
139
+ <p>
140
+ Retrieves the <span class="type">ClutterStage</span> that this window is embedding
141
+ </p>
142
+ <p>
143
+ Use this function if you wish to add other actors to the <span class="type">ClutterStage</span>.
144
+ </p>
145
+ <div class="variablelist"><table border="0" class="variablelist">
146
+ <colgroup>
147
+ <col align="left" valign="top">
148
+ <col>
149
+ </colgroup>
150
+ <tbody>
151
+ <tr>
152
+ <td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td>
153
+ <td>the <a class="link" href="GtkClutterWindow.html" title="GtkClutterWindow"><span class="type">GtkClutterWindow</span></a>
154
+ </td>
155
+ </tr>
156
+ <tr>
157
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
158
+ <td>the window's <span class="type">ClutterStage</span>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
159
+ </td>
160
+ </tr>
161
+ </tbody>
162
+ </table></div>
163
+ </div>
164
+ </div>
165
+ </div>
166
+ <div class="footer">
167
+ <hr>
168
+ Generated by GTK-Doc V1.18.1</div>
169
+ </body>
170
+ </html>
@@ -0,0 +1,58 @@
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>Annotation Glossary</title>
6
+ <meta name="generator" content="DocBook XSL Stylesheets V1.77.1">
7
+ <link rel="home" href="index.html" title="Clutter-Gtk 1.4.4 Reference Manual">
8
+ <link rel="up" href="cluttergtk-glossary.html" title="Part II. Glossaries">
9
+ <link rel="prev" href="cluttergtk-glossary.html" title="Part II. Glossaries">
10
+ <link rel="next" href="ix02.html" title="Index of all symbols">
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="cluttergtk-glossary.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
+ <td><a accesskey="u" href="cluttergtk-glossary.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-Gtk 1.4.4
21
+ Reference Manual</th>
22
+ <td><a accesskey="n" href="ix02.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
23
+ </tr>
24
+ <tr><td colspan="5" class="shortcuts">
25
+ <a class="shortcut" href="#glsA">A</a>
26
+  | 
27
+ <a class="shortcut" href="#glsI">I</a>
28
+  | 
29
+ <a class="shortcut" href="#glsT">T</a>
30
+ </td></tr>
31
+ </table>
32
+ <div class="glossary">
33
+ <div class="titlepage"><div><div><h2 class="title">
34
+ <a name="annotation-glossary"></a>Annotation Glossary</h2></div></div></div>
35
+ <a name="glsA"></a><h3 class="title">A</h3>
36
+ <dt>
37
+ <a name="annotation-glossterm-array"></a>array</dt>
38
+ <dd><p>Parameter points to an array of items.</p></dd>
39
+ <dt>
40
+ <a name="annotation-glossterm-allow-none"></a>allow-none</dt>
41
+ <dd><p>NULL is ok, both for passing and for returning.</p></dd>
42
+ <a name="glsI"></a><h3 class="title">I</h3>
43
+ <dt>
44
+ <a name="annotation-glossterm-inout"></a>inout</dt>
45
+ <dd><p>Parameter for input and for returning results. Default is <acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>.</p></dd>
46
+ <a name="glsT"></a><h3 class="title">T</h3>
47
+ <dt>
48
+ <a name="annotation-glossterm-transfer%20full"></a>transfer full</dt>
49
+ <dd><p>Free data after the code is done.</p></dd>
50
+ <dt>
51
+ <a name="annotation-glossterm-transfer%20none"></a>transfer none</dt>
52
+ <dd><p>Don't free data after the code is done.</p></dd>
53
+ </div>
54
+ <div class="footer">
55
+ <hr>
56
+ Generated by GTK-Doc V1.18.1</div>
57
+ </body>
58
+ </html>
@@ -0,0 +1,36 @@
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>Clutter-Gtk Overview</title>
6
+ <meta name="generator" content="DocBook XSL Stylesheets V1.77.1">
7
+ <link rel="home" href="index.html" title="Clutter-Gtk 1.4.4 Reference Manual">
8
+ <link rel="up" href="index.html" title="Clutter-Gtk 1.4.4 Reference Manual">
9
+ <link rel="prev" href="index.html" title="Clutter-Gtk 1.4.4 Reference Manual">
10
+ <link rel="next" href="ch02.html" title="Clutter-Gtk Widgets">
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"><tr valign="middle">
16
+ <td><a accesskey="p" href="index.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
17
+ <td> </td>
18
+ <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
19
+ <th width="100%" align="center">Clutter-Gtk 1.4.4
20
+ Reference Manual</th>
21
+ <td><a accesskey="n" href="ch02.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
22
+ </tr></table>
23
+ <div class="chapter">
24
+ <div class="titlepage"><div><div><h1 class="title">
25
+ <a name="id-1.2"></a>Clutter-Gtk Overview</h1></div></div></div>
26
+ <p>Clutter-Gtk is an integration library for the Clutter toolkit
27
+ providing access and integration for the GTK+ library.</p>
28
+ <p>Clutter-Gtk allows embedding a Clutter scene graph into a
29
+ GTK+ application; retrieving themeing information; integrate GTK+
30
+ data structures and object classes with Clutter actors.</p>
31
+ </div>
32
+ <div class="footer">
33
+ <hr>
34
+ Generated by GTK-Doc V1.18.1</div>
35
+ </body>
36
+ </html>
@@ -0,0 +1,42 @@
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>Clutter-Gtk Widgets</title>
6
+ <meta name="generator" content="DocBook XSL Stylesheets V1.77.1">
7
+ <link rel="home" href="index.html" title="Clutter-Gtk 1.4.4 Reference Manual">
8
+ <link rel="up" href="index.html" title="Clutter-Gtk 1.4.4 Reference Manual">
9
+ <link rel="prev" href="ch01.html" title="Clutter-Gtk Overview">
10
+ <link rel="next" href="GtkClutterEmbed.html" title="GtkClutterEmbed">
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"><tr valign="middle">
16
+ <td><a accesskey="p" href="ch01.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
17
+ <td> </td>
18
+ <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
19
+ <th width="100%" align="center">Clutter-Gtk 1.4.4
20
+ Reference Manual</th>
21
+ <td><a accesskey="n" href="GtkClutterEmbed.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
22
+ </tr></table>
23
+ <div class="chapter">
24
+ <div class="titlepage"><div><div><h1 class="title">
25
+ <a name="id-1.3"></a>Clutter-Gtk Widgets</h1></div></div></div>
26
+ <div class="toc"><dl>
27
+ <dt>
28
+ <span class="refentrytitle"><a href="GtkClutterEmbed.html">GtkClutterEmbed</a></span><span class="refpurpose"> — Widget for embedding a Clutter scene</span>
29
+ </dt>
30
+ <dt>
31
+ <span class="refentrytitle"><a href="GtkClutterActor.html">GtkClutterActor</a></span><span class="refpurpose"> — actor for embedding a Widget in a Clutter stage</span>
32
+ </dt>
33
+ <dt>
34
+ <span class="refentrytitle"><a href="GtkClutterWindow.html">GtkClutterWindow</a></span><span class="refpurpose"> — a GtkWindow that embeds its contents onto a stage</span>
35
+ </dt>
36
+ </dl></div>
37
+ </div>
38
+ <div class="footer">
39
+ <hr>
40
+ Generated by GTK-Doc V1.18.1</div>
41
+ </body>
42
+ </html>
@@ -0,0 +1,34 @@
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>Miscellaneous</title>
6
+ <meta name="generator" content="DocBook XSL Stylesheets V1.77.1">
7
+ <link rel="home" href="index.html" title="Clutter-Gtk 1.4.4 Reference Manual">
8
+ <link rel="up" href="index.html" title="Clutter-Gtk 1.4.4 Reference Manual">
9
+ <link rel="prev" href="GtkClutterWindow.html" title="GtkClutterWindow">
10
+ <link rel="next" href="clutter-gtk-1.0-Utility-Functions.html" title="Utility Functions">
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"><tr valign="middle">
16
+ <td><a accesskey="p" href="GtkClutterWindow.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
17
+ <td> </td>
18
+ <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
19
+ <th width="100%" align="center">Clutter-Gtk 1.4.4
20
+ Reference Manual</th>
21
+ <td><a accesskey="n" href="clutter-gtk-1.0-Utility-Functions.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
22
+ </tr></table>
23
+ <div class="chapter">
24
+ <div class="titlepage"><div><div><h1 class="title">
25
+ <a name="id-1.4"></a>Miscellaneous</h1></div></div></div>
26
+ <div class="toc"><dl><dt>
27
+ <span class="refentrytitle"><a href="clutter-gtk-1.0-Utility-Functions.html">Utility Functions</a></span><span class="refpurpose"> — Utility functions for integrating Clutter in GTK+</span>
28
+ </dt></dl></div>
29
+ </div>
30
+ <div class="footer">
31
+ <hr>
32
+ Generated by GTK-Doc V1.18.1</div>
33
+ </body>
34
+ </html>
@@ -0,0 +1,257 @@
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>Utility Functions</title>
6
+ <meta name="generator" content="DocBook XSL Stylesheets V1.77.1">
7
+ <link rel="home" href="index.html" title="Clutter-Gtk 1.4.4 Reference Manual">
8
+ <link rel="up" href="ch03.html" title="Miscellaneous">
9
+ <link rel="prev" href="ch03.html" title="Miscellaneous">
10
+ <link rel="next" href="ix01.html" title="Index">
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="ch03.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
+ <td><a accesskey="u" href="ch03.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-Gtk 1.4.4
21
+ Reference Manual</th>
22
+ <td><a accesskey="n" href="ix01.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
23
+ </tr>
24
+ <tr><td colspan="5" class="shortcuts">
25
+ <a href="#clutter-gtk-1.0-Utility-Functions.synopsis" class="shortcut">Top</a>
26
+  | 
27
+ <a href="#clutter-gtk-1.0-Utility-Functions.description" class="shortcut">Description</a>
28
+ </td></tr>
29
+ </table>
30
+ <div class="refentry">
31
+ <a name="clutter-gtk-1.0-Utility-Functions"></a><div class="titlepage"></div>
32
+ <div class="refnamediv"><table width="100%"><tr>
33
+ <td valign="top">
34
+ <h2><span class="refentrytitle"><a name="clutter-gtk-1.0-Utility-Functions.top_of_page"></a>Utility Functions</span></h2>
35
+ <p>Utility Functions — Utility functions for integrating Clutter in GTK+</p>
36
+ </td>
37
+ <td valign="top" align="right"></td>
38
+ </tr></table></div>
39
+ <div class="refsynopsisdiv">
40
+ <a name="clutter-gtk-1.0-Utility-Functions.synopsis"></a><h2>Synopsis</h2>
41
+ <pre class="synopsis"><span class="returnvalue">ClutterInitError</span> <a class="link" href="clutter-gtk-1.0-Utility-Functions.html#gtk-clutter-init" title="gtk_clutter_init ()">gtk_clutter_init</a> (<em class="parameter"><code><span class="type">int</span> *argc</code></em>,
42
+ <em class="parameter"><code><span class="type">char</span> ***argv</code></em>);
43
+ <span class="returnvalue">ClutterInitError</span> <a class="link" href="clutter-gtk-1.0-Utility-Functions.html#gtk-clutter-init-with-args" title="gtk_clutter_init_with_args ()">gtk_clutter_init_with_args</a> (<em class="parameter"><code><span class="type">int</span> *argc</code></em>,
44
+ <em class="parameter"><code><span class="type">char</span> ***argv</code></em>,
45
+ <em class="parameter"><code>const <span class="type">char</span> *parameter_string</code></em>,
46
+ <em class="parameter"><code><span class="type">GOptionEntry</span> *entries</code></em>,
47
+ <em class="parameter"><code>const <span class="type">char</span> *translation_domain</code></em>,
48
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);
49
+ <span class="returnvalue">GOptionGroup</span> * <a class="link" href="clutter-gtk-1.0-Utility-Functions.html#gtk-clutter-get-option-group" title="gtk_clutter_get_option_group ()">gtk_clutter_get_option_group</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
50
+ </pre>
51
+ </div>
52
+ <div class="refsect1">
53
+ <a name="clutter-gtk-1.0-Utility-Functions.description"></a><h2>Description</h2>
54
+ <p>
55
+ In order to properly integrate a Clutter scene into a GTK+ applications
56
+ a certain degree of state must be retrieved from GTK+ itself.
57
+ </p>
58
+ <p>
59
+ Clutter-GTK provides API for easing the process of synchronizing colors
60
+ with the current GTK+ theme and for loading image sources from <span class="type">GdkPixbuf</span>,
61
+ GTK+ stock items and icon themes.
62
+ </p>
63
+ </div>
64
+ <div class="refsect1">
65
+ <a name="clutter-gtk-1.0-Utility-Functions.details"></a><h2>Details</h2>
66
+ <div class="refsect2">
67
+ <a name="gtk-clutter-init"></a><h3>gtk_clutter_init ()</h3>
68
+ <pre class="programlisting"><span class="returnvalue">ClutterInitError</span> gtk_clutter_init (<em class="parameter"><code><span class="type">int</span> *argc</code></em>,
69
+ <em class="parameter"><code><span class="type">char</span> ***argv</code></em>);</pre>
70
+ <p>
71
+ This function should be called instead of <code class="function">clutter_init()</code> and
72
+ <code class="function">gtk_init()</code>.
73
+ </p>
74
+ <div class="variablelist"><table border="0" class="variablelist">
75
+ <colgroup>
76
+ <col align="left" valign="top">
77
+ <col>
78
+ </colgroup>
79
+ <tbody>
80
+ <tr>
81
+ <td><p><span class="term"><em class="parameter"><code>argc</code></em> :</span></p></td>
82
+ <td>pointer to the arguments count, or <code class="literal">NULL</code>. <span class="annotation">[<acronym title="Parameter for input and for returning results. Default is transfer full."><span class="acronym">inout</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
83
+ </td>
84
+ </tr>
85
+ <tr>
86
+ <td><p><span class="term"><em class="parameter"><code>argv</code></em> :</span></p></td>
87
+ <td>pointer to the
88
+ arguments vector, or <code class="literal">NULL</code>. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=argc][<acronym title="Parameter for input and for returning results. Default is transfer full."><span class="acronym">inout</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
89
+ </td>
90
+ </tr>
91
+ <tr>
92
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
93
+ <td>
94
+ <code class="literal">CLUTTER_INIT_SUCCESS</code> on success, a negative integer
95
+ on failure.</td>
96
+ </tr>
97
+ </tbody>
98
+ </table></div>
99
+ </div>
100
+ <hr>
101
+ <div class="refsect2">
102
+ <a name="gtk-clutter-init-with-args"></a><h3>gtk_clutter_init_with_args ()</h3>
103
+ <pre class="programlisting"><span class="returnvalue">ClutterInitError</span> gtk_clutter_init_with_args (<em class="parameter"><code><span class="type">int</span> *argc</code></em>,
104
+ <em class="parameter"><code><span class="type">char</span> ***argv</code></em>,
105
+ <em class="parameter"><code>const <span class="type">char</span> *parameter_string</code></em>,
106
+ <em class="parameter"><code><span class="type">GOptionEntry</span> *entries</code></em>,
107
+ <em class="parameter"><code>const <span class="type">char</span> *translation_domain</code></em>,
108
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
109
+ <p>
110
+ This function should be called instead of <code class="function">clutter_init()</code> and
111
+ <code class="function">gtk_init_with_args()</code>.
112
+ </p>
113
+ <div class="variablelist"><table border="0" class="variablelist">
114
+ <colgroup>
115
+ <col align="left" valign="top">
116
+ <col>
117
+ </colgroup>
118
+ <tbody>
119
+ <tr>
120
+ <td><p><span class="term"><em class="parameter"><code>argc</code></em> :</span></p></td>
121
+ <td>a pointer to the number of command line
122
+ arguments, or <code class="literal">NULL</code>. <span class="annotation">[<acronym title="Parameter for input and for returning results. Default is transfer full."><span class="acronym">inout</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
123
+ </td>
124
+ </tr>
125
+ <tr>
126
+ <td><p><span class="term"><em class="parameter"><code>argv</code></em> :</span></p></td>
127
+ <td>a pointer to the array
128
+ of command line arguments, or <code class="literal">NULL</code>. <span class="annotation">[<acronym title="Parameter for input and for returning results. Default is transfer full."><span class="acronym">inout</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=argc]</span>
129
+ </td>
130
+ </tr>
131
+ <tr>
132
+ <td><p><span class="term"><em class="parameter"><code>parameter_string</code></em> :</span></p></td>
133
+ <td>a string which is displayed in
134
+ the first line of <code class="option">--help</code> output, after
135
+ <code class="literal"><em class="replaceable"><code>programname</code></em> [OPTION...]</code>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
136
+ </td>
137
+ </tr>
138
+ <tr>
139
+ <td><p><span class="term"><em class="parameter"><code>entries</code></em> :</span></p></td>
140
+ <td>a
141
+ <code class="literal">NULL</code>-terminated array of <span class="type">GOptionEntry</span>s describing the
142
+ options of your program. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1]</span>
143
+ </td>
144
+ </tr>
145
+ <tr>
146
+ <td><p><span class="term"><em class="parameter"><code>translation_domain</code></em> :</span></p></td>
147
+ <td>a translation domain to use for
148
+ translating the <code class="option">--help</code> output for the options
149
+ in <em class="parameter"><code>entries</code></em> with <code class="function">gettext()</code>, or <code class="literal">NULL</code>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
150
+ </td>
151
+ </tr>
152
+ <tr>
153
+ <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
154
+ <td>a return location for errors, or <code class="literal">NULL</code>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
155
+ </td>
156
+ </tr>
157
+ <tr>
158
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
159
+ <td>
160
+ <code class="literal">CLUTTER_INIT_SUCCESS</code> on success, a negative integer
161
+ on failure.</td>
162
+ </tr>
163
+ </tbody>
164
+ </table></div>
165
+ </div>
166
+ <hr>
167
+ <div class="refsect2">
168
+ <a name="gtk-clutter-get-option-group"></a><h3>gtk_clutter_get_option_group ()</h3>
169
+ <pre class="programlisting"><span class="returnvalue">GOptionGroup</span> * gtk_clutter_get_option_group (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
170
+ <p>
171
+ Returns a <span class="type">GOptionGroup</span> for the command line arguments recognized
172
+ by Clutter. You should add this group to your <span class="type">GOptionContext</span> with
173
+ <code class="function">g_option_context_add_group()</code>, if you are using <code class="function">g_option_context_parse()</code>
174
+ to parse your commandline arguments instead of using <a class="link" href="clutter-gtk-1.0-Utility-Functions.html#gtk-clutter-init" title="gtk_clutter_init ()"><code class="function">gtk_clutter_init()</code></a>
175
+ or <a class="link" href="clutter-gtk-1.0-Utility-Functions.html#gtk-clutter-init-with-args" title="gtk_clutter_init_with_args ()"><code class="function">gtk_clutter_init_with_args()</code></a>.
176
+ </p>
177
+ <p>
178
+ You should add this option group to your <span class="type">GOptionContext</span> after
179
+ the GTK option group created with <code class="function">gtk_get_option_group()</code>, and after
180
+ the clutter option group obtained from <code class="function">clutter_get_option_group_without_init()</code>.
181
+ You should not use <code class="function">clutter_get_option_group()</code> together with this function.
182
+ </p>
183
+ <p>
184
+ You must pass <code class="literal">TRUE</code> to <code class="function">gtk_get_option_group()</code> since gtk-clutter's option
185
+ group relies on it.
186
+ </p>
187
+ <p>
188
+ Parsing options using <code class="function">g_option_context_parse()</code> with a <span class="type">GOptionContext</span>
189
+ containing the returned <span class="type">GOptionGroupwith</span> will result in Clutter's and
190
+ GTK-Clutter's initialisation. That is, the following code:
191
+ </p>
192
+ <p>
193
+ </p>
194
+ <div class="informalexample">
195
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
196
+ <tbody>
197
+ <tr>
198
+ <td class="listing_lines" align="right"><pre>1
199
+ 2
200
+ 3
201
+ 4
202
+ 5</pre></td>
203
+ <td class="listing_code"><pre class="programlisting"><span class="function">g_option_context_add_group</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">context</span><span class="symbol">,</span><span class="normal"> </span><span class="function">gtk_get_option_group</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">TRUE</span><span class="symbol">));</span>
204
+ <span class="function">g_option_context_add_group</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">context</span><span class="symbol">,</span><span class="normal"> </span><span class="function">cogl_get_option_group</span><span class="normal"> </span><span class="symbol">());</span>
205
+ <span class="function">g_option_context_add_group</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">context</span><span class="symbol">,</span><span class="normal"> </span><span class="function">clutter_get_option_group_without_init</span><span class="normal"> </span><span class="symbol">());</span>
206
+ <span class="function">g_option_context_add_group</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">context</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="clutter-gtk-1.0-Utility-Functions.html#gtk-clutter-get-option-group">gtk_clutter_get_option_group</a></span><span class="normal"> </span><span class="symbol">());</span>
207
+ <span class="normal">res </span><span class="symbol">=</span><span class="normal"> </span><span class="function">g_option_context_parse</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">context</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">argc</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">argc</span><span class="symbol">,</span><span class="normal"> NULL</span><span class="symbol">);</span></pre></td>
208
+ </tr>
209
+ </tbody>
210
+ </table>
211
+ </div>
212
+
213
+ <p>
214
+ </p>
215
+ <p>
216
+ is functionally equivalent to:
217
+ </p>
218
+ <p>
219
+ </p>
220
+ <div class="informalexample">
221
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
222
+ <tbody>
223
+ <tr>
224
+ <td class="listing_lines" align="right"><pre>1</pre></td>
225
+ <td class="listing_code"><pre class="programlisting"><span class="function"><a href="clutter-gtk-1.0-Utility-Functions.html#gtk-clutter-init">gtk_clutter_init</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">argc</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">argv</span><span class="symbol">);</span></pre></td>
226
+ </tr>
227
+ </tbody>
228
+ </table>
229
+ </div>
230
+
231
+ <p>
232
+ </p>
233
+ <p>
234
+ After <code class="function">g_option_context_parse()</code> on a <span class="type">GOptionContext</span> containing the
235
+ the returned <span class="type">GOptionGroup</span> has returned <code class="literal">TRUE</code>, Clutter and GTK-Clutter are
236
+ guaranteed to be initialized.
237
+ </p>
238
+ <div class="variablelist"><table border="0" class="variablelist">
239
+ <colgroup>
240
+ <col align="left" valign="top">
241
+ <col>
242
+ </colgroup>
243
+ <tbody><tr>
244
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
245
+ <td>a <span class="type">GOptionGroup</span> for the commandline arguments
246
+ recognized by ClutterGtk. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
247
+ </td>
248
+ </tr></tbody>
249
+ </table></div>
250
+ </div>
251
+ </div>
252
+ </div>
253
+ <div class="footer">
254
+ <hr>
255
+ Generated by GTK-Doc V1.18.1</div>
256
+ </body>
257
+ </html>