clutter-gtk 2.0.0-x86-mingw32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
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>