1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5 <title>ClutterX11TexturePixmap</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="clutterbackends.html" title="Part VII. Clutter Backends">
9 <link rel="prev" href="clutter-X11-Specific-Support.html" title="X11 Specific Support">
10 <link rel="next" href="clutter-ClutterGLXTexturePixmap.html" title="ClutterGLXTexturePixmap">
11 <meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
12 <link rel="stylesheet" href="style.css" type="text/css">
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">
17 <td><a accesskey="p" href="clutter-X11-Specific-Support.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18 <td><a accesskey="u" href="clutterbackends.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="clutter-ClutterGLXTexturePixmap.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
23 <tr><td colspan="5" class="shortcuts">
24 <a href="#clutter-ClutterX11TexturePixmap.synopsis" class="shortcut">Top</a>
26 <a href="#clutter-ClutterX11TexturePixmap.description" class="shortcut">Description</a>
29 <div class="refentry">
30 <a name="clutter-ClutterX11TexturePixmap"></a><div class="titlepage"></div>
31 <div class="refnamediv"><table width="100%"><tr>
33 <h2><span class="refentrytitle"><a name="clutter-ClutterX11TexturePixmap.top_of_page"></a>ClutterX11TexturePixmap</span></h2>
34 <p>ClutterX11TexturePixmap — A texture which displays the content of an X Pixmap.</p>
36 <td valign="top" align="right"></td>
38 <div class="refsynopsisdiv">
39 <a name="clutter-ClutterX11TexturePixmap.synopsis"></a><h2>Synopsis</h2>
40 <pre class="synopsis">struct <a class="link" href="clutter-ClutterX11TexturePixmap.html#ClutterX11TexturePixmap" title="struct ClutterX11TexturePixmap">ClutterX11TexturePixmap</a>;
41 struct <a class="link" href="clutter-ClutterX11TexturePixmap.html#ClutterX11TexturePixmapClass" title="struct ClutterX11TexturePixmapClass">ClutterX11TexturePixmapClass</a>;
42 <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="returnvalue">ClutterActor</span></a> * <a class="link" href="clutter-ClutterX11TexturePixmap.html#clutter-x11-texture-pixmap-new" title="clutter_x11_texture_pixmap_new ()">clutter_x11_texture_pixmap_new</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
43 <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="returnvalue">ClutterActor</span></a> * <a class="link" href="clutter-ClutterX11TexturePixmap.html#clutter-x11-texture-pixmap-new-with-pixmap" title="clutter_x11_texture_pixmap_new_with_pixmap ()">clutter_x11_texture_pixmap_new_with_pixmap</a>
44 (<em class="parameter"><code><span class="type">Pixmap</span> pixmap</code></em>);
45 <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="returnvalue">ClutterActor</span></a> * <a class="link" href="clutter-ClutterX11TexturePixmap.html#clutter-x11-texture-pixmap-new-with-window" title="clutter_x11_texture_pixmap_new_with_window ()">clutter_x11_texture_pixmap_new_with_window</a>
46 (<em class="parameter"><code><span class="type">Window</span> window</code></em>);
47 <span class="returnvalue">void</span> <a class="link" href="clutter-ClutterX11TexturePixmap.html#clutter-x11-texture-pixmap-set-pixmap" title="clutter_x11_texture_pixmap_set_pixmap ()">clutter_x11_texture_pixmap_set_pixmap</a>
48 (<em class="parameter"><code><a class="link" href="clutter-ClutterX11TexturePixmap.html#ClutterX11TexturePixmap" title="struct ClutterX11TexturePixmap"><span class="type">ClutterX11TexturePixmap</span></a> *texture</code></em>,
49 <em class="parameter"><code><span class="type">Pixmap</span> pixmap</code></em>);
50 <span class="returnvalue">void</span> <a class="link" href="clutter-ClutterX11TexturePixmap.html#clutter-x11-texture-pixmap-set-window" title="clutter_x11_texture_pixmap_set_window ()">clutter_x11_texture_pixmap_set_window</a>
51 (<em class="parameter"><code><a class="link" href="clutter-ClutterX11TexturePixmap.html#ClutterX11TexturePixmap" title="struct ClutterX11TexturePixmap"><span class="type">ClutterX11TexturePixmap</span></a> *texture</code></em>,
52 <em class="parameter"><code><span class="type">Window</span> window</code></em>,
53 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> automatic</code></em>);
54 <span class="returnvalue">void</span> <a class="link" href="clutter-ClutterX11TexturePixmap.html#clutter-x11-texture-pixmap-sync-window" title="clutter_x11_texture_pixmap_sync_window ()">clutter_x11_texture_pixmap_sync_window</a>
55 (<em class="parameter"><code><a class="link" href="clutter-ClutterX11TexturePixmap.html#ClutterX11TexturePixmap" title="struct ClutterX11TexturePixmap"><span class="type">ClutterX11TexturePixmap</span></a> *texture</code></em>);
56 <span class="returnvalue">void</span> <a class="link" href="clutter-ClutterX11TexturePixmap.html#clutter-x11-texture-pixmap-update-area" title="clutter_x11_texture_pixmap_update_area ()">clutter_x11_texture_pixmap_update_area</a>
57 (<em class="parameter"><code><a class="link" href="clutter-ClutterX11TexturePixmap.html#ClutterX11TexturePixmap" title="struct ClutterX11TexturePixmap"><span class="type">ClutterX11TexturePixmap</span></a> *texture</code></em>,
58 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x</code></em>,
59 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y</code></em>,
60 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> width</code></em>,
61 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> height</code></em>);
62 <span class="returnvalue">void</span> <a class="link" href="clutter-ClutterX11TexturePixmap.html#clutter-x11-texture-pixmap-set-automatic" title="clutter_x11_texture_pixmap_set_automatic ()">clutter_x11_texture_pixmap_set_automatic</a>
63 (<em class="parameter"><code><a class="link" href="clutter-ClutterX11TexturePixmap.html#ClutterX11TexturePixmap" title="struct ClutterX11TexturePixmap"><span class="type">ClutterX11TexturePixmap</span></a> *texture</code></em>,
64 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> setting</code></em>);
67 <div class="refsect1">
68 <a name="clutter-ClutterX11TexturePixmap.description"></a><h2>Description</h2>
70 <a class="link" href="clutter-ClutterX11TexturePixmap.html#ClutterX11TexturePixmap" title="struct ClutterX11TexturePixmap"><span class="type">ClutterX11TexturePixmap</span></a> is a class for displaying the content of an
71 X Pixmap as a ClutterActor. Used together with the X Composite extension,
72 it allows to display the content of X Windows inside Clutter.
75 The class uses the GLX_EXT_texture_from_pixmap OpenGL extension
76 (http://people.freedesktop.org/~davidr/GLX_EXT_texture_from_pixmap.txt)
80 <div class="refsect1">
81 <a name="clutter-ClutterX11TexturePixmap.details"></a><h2>Details</h2>
82 <div class="refsect2">
83 <a name="ClutterX11TexturePixmap"></a><h3>struct ClutterX11TexturePixmap</h3>
84 <pre class="programlisting">struct ClutterX11TexturePixmap {
88 The <a class="link" href="clutter-ClutterX11TexturePixmap.html#ClutterX11TexturePixmap" title="struct ClutterX11TexturePixmap"><span class="type">ClutterX11TexturePixmap</span></a> structure contains only private data
90 <p class="since">Since 0.8</p>
93 <div class="refsect2">
94 <a name="ClutterX11TexturePixmapClass"></a><h3>struct ClutterX11TexturePixmapClass</h3>
95 <pre class="programlisting">struct ClutterX11TexturePixmapClass {
96 void (* update_area) (ClutterX11TexturePixmap *texture,
104 The <a class="link" href="clutter-ClutterX11TexturePixmap.html#ClutterX11TexturePixmapClass" title="struct ClutterX11TexturePixmapClass"><span class="type">ClutterX11TexturePixmapClass</span></a> structure contains only private data
106 <div class="variablelist"><table border="0">
107 <col align="left" valign="top">
109 <td><p><span class="term"><em class="structfield"><code><a name="ClutterX11TexturePixmapClass.update-area"></a>update_area</code></em> ()</span></p></td>
110 <td>virtual function for updating the area of the texture</td>
113 <p class="since">Since 0.8</p>
116 <div class="refsect2">
117 <a name="clutter-x11-texture-pixmap-new"></a><h3>clutter_x11_texture_pixmap_new ()</h3>
118 <pre class="programlisting"><a class="link" href="ClutterActor.html" title="ClutterActor"><span class="returnvalue">ClutterActor</span></a> * clutter_x11_texture_pixmap_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
120 Creates a new <a class="link" href="clutter-ClutterX11TexturePixmap.html#ClutterX11TexturePixmap" title="struct ClutterX11TexturePixmap"><span class="type">ClutterX11TexturePixmap</span></a> which can be used to display the
121 contents of an X11 Pixmap inside a Clutter scene graph
123 <div class="variablelist"><table border="0">
124 <col align="left" valign="top">
126 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
127 <td>A new <a class="link" href="clutter-ClutterX11TexturePixmap.html#ClutterX11TexturePixmap" title="struct ClutterX11TexturePixmap"><span class="type">ClutterX11TexturePixmap</span></a>
131 <p class="since">Since 0.8</p>
134 <div class="refsect2">
135 <a name="clutter-x11-texture-pixmap-new-with-pixmap"></a><h3>clutter_x11_texture_pixmap_new_with_pixmap ()</h3>
136 <pre class="programlisting"><a class="link" href="ClutterActor.html" title="ClutterActor"><span class="returnvalue">ClutterActor</span></a> * clutter_x11_texture_pixmap_new_with_pixmap
137 (<em class="parameter"><code><span class="type">Pixmap</span> pixmap</code></em>);</pre>
139 Creates a new <a class="link" href="clutter-ClutterX11TexturePixmap.html#ClutterX11TexturePixmap" title="struct ClutterX11TexturePixmap"><span class="type">ClutterX11TexturePixmap</span></a> for <em class="parameter"><code>pixmap</code></em>
141 <div class="variablelist"><table border="0">
142 <col align="left" valign="top">
145 <td><p><span class="term"><em class="parameter"><code>pixmap</code></em> :</span></p></td>
146 <td>the X Pixmap to which this texture should be bound</td>
149 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
150 <td>A new <a class="link" href="clutter-ClutterX11TexturePixmap.html#ClutterX11TexturePixmap" title="struct ClutterX11TexturePixmap"><span class="type">ClutterX11TexturePixmap</span></a> bound to the given X Pixmap</td>
154 <p class="since">Since 0.8</p>
157 <div class="refsect2">
158 <a name="clutter-x11-texture-pixmap-new-with-window"></a><h3>clutter_x11_texture_pixmap_new_with_window ()</h3>
159 <pre class="programlisting"><a class="link" href="ClutterActor.html" title="ClutterActor"><span class="returnvalue">ClutterActor</span></a> * clutter_x11_texture_pixmap_new_with_window
160 (<em class="parameter"><code><span class="type">Window</span> window</code></em>);</pre>
162 Creates a new <a class="link" href="clutter-ClutterX11TexturePixmap.html#ClutterX11TexturePixmap" title="struct ClutterX11TexturePixmap"><span class="type">ClutterX11TexturePixmap</span></a> for <em class="parameter"><code>window</code></em>
164 <div class="variablelist"><table border="0">
165 <col align="left" valign="top">
168 <td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td>
169 <td>the X window to which this texture should be bound</td>
172 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
173 <td>A new <a class="link" href="clutter-ClutterX11TexturePixmap.html#ClutterX11TexturePixmap" title="struct ClutterX11TexturePixmap"><span class="type">ClutterX11TexturePixmap</span></a> bound to the given X window.</td>
177 <p class="since">Since 0.8</p>
180 <div class="refsect2">
181 <a name="clutter-x11-texture-pixmap-set-pixmap"></a><h3>clutter_x11_texture_pixmap_set_pixmap ()</h3>
182 <pre class="programlisting"><span class="returnvalue">void</span> clutter_x11_texture_pixmap_set_pixmap
183 (<em class="parameter"><code><a class="link" href="clutter-ClutterX11TexturePixmap.html#ClutterX11TexturePixmap" title="struct ClutterX11TexturePixmap"><span class="type">ClutterX11TexturePixmap</span></a> *texture</code></em>,
184 <em class="parameter"><code><span class="type">Pixmap</span> pixmap</code></em>);</pre>
186 Sets the X Pixmap to which the texture should be bound.
188 <div class="variablelist"><table border="0">
189 <col align="left" valign="top">
192 <td><p><span class="term"><em class="parameter"><code>texture</code></em> :</span></p></td>
193 <td>the texture to bind</td>
196 <td><p><span class="term"><em class="parameter"><code>pixmap</code></em> :</span></p></td>
197 <td>the X Pixmap to which the texture should be bound</td>
201 <p class="since">Since 0.8</p>
204 <div class="refsect2">
205 <a name="clutter-x11-texture-pixmap-set-window"></a><h3>clutter_x11_texture_pixmap_set_window ()</h3>
206 <pre class="programlisting"><span class="returnvalue">void</span> clutter_x11_texture_pixmap_set_window
207 (<em class="parameter"><code><a class="link" href="clutter-ClutterX11TexturePixmap.html#ClutterX11TexturePixmap" title="struct ClutterX11TexturePixmap"><span class="type">ClutterX11TexturePixmap</span></a> *texture</code></em>,
208 <em class="parameter"><code><span class="type">Window</span> window</code></em>,
209 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> automatic</code></em>);</pre>
211 Sets up a suitable pixmap for the window, using the composite and damage
212 extensions if possible, and then calls
213 <a class="link" href="clutter-ClutterX11TexturePixmap.html#clutter-x11-texture-pixmap-set-pixmap" title="clutter_x11_texture_pixmap_set_pixmap ()"><code class="function">clutter_x11_texture_pixmap_set_pixmap()</code></a>.
216 If you want to display a window in a <a class="link" href="ClutterTexture.html" title="ClutterTexture"><span class="type">ClutterTexture</span></a>, you probably want
217 this function, or its older sister, <code class="function">clutter_glx_texture_pixmap_set_window()</code>.
220 This function has no effect unless the XComposite extension is available.
222 <div class="variablelist"><table border="0">
223 <col align="left" valign="top">
226 <td><p><span class="term"><em class="parameter"><code>texture</code></em> :</span></p></td>
227 <td>the texture to bind</td>
230 <td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td>
231 <td>the X window to which the texture should be bound</td>
234 <td><p><span class="term"><em class="parameter"><code>automatic</code></em> :</span></p></td>
236 <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> for automatic window updates, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> for manual.</td>
240 <p class="since">Since 0.8</p>
243 <div class="refsect2">
244 <a name="clutter-x11-texture-pixmap-sync-window"></a><h3>clutter_x11_texture_pixmap_sync_window ()</h3>
245 <pre class="programlisting"><span class="returnvalue">void</span> clutter_x11_texture_pixmap_sync_window
246 (<em class="parameter"><code><a class="link" href="clutter-ClutterX11TexturePixmap.html#ClutterX11TexturePixmap" title="struct ClutterX11TexturePixmap"><span class="type">ClutterX11TexturePixmap</span></a> *texture</code></em>);</pre>
248 Resets the texture's pixmap from its window, perhaps in response to the
249 pixmap's invalidation as the window changed size.
251 <div class="variablelist"><table border="0">
252 <col align="left" valign="top">
254 <td><p><span class="term"><em class="parameter"><code>texture</code></em> :</span></p></td>
255 <td>the texture to bind</td>
258 <p class="since">Since 0.8</p>
261 <div class="refsect2">
262 <a name="clutter-x11-texture-pixmap-update-area"></a><h3>clutter_x11_texture_pixmap_update_area ()</h3>
263 <pre class="programlisting"><span class="returnvalue">void</span> clutter_x11_texture_pixmap_update_area
264 (<em class="parameter"><code><a class="link" href="clutter-ClutterX11TexturePixmap.html#ClutterX11TexturePixmap" title="struct ClutterX11TexturePixmap"><span class="type">ClutterX11TexturePixmap</span></a> *texture</code></em>,
265 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x</code></em>,
266 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y</code></em>,
267 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> width</code></em>,
268 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> height</code></em>);</pre>
270 Performs the actual binding of texture to the current content of
271 the pixmap. Can be called to update the texture if the pixmap
274 <div class="variablelist"><table border="0">
275 <col align="left" valign="top">
278 <td><p><span class="term"><em class="parameter"><code>texture</code></em> :</span></p></td>
279 <td>The texture whose content shall be updated.</td>
282 <td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
283 <td>the X coordinate of the area to update</td>
286 <td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
287 <td>the Y coordinate of the area to update</td>
290 <td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td>
291 <td>the width of the area to update</td>
294 <td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td>
295 <td>the height of the area to update</td>
299 <p class="since">Since 0.8</p>
302 <div class="refsect2">
303 <a name="clutter-x11-texture-pixmap-set-automatic"></a><h3>clutter_x11_texture_pixmap_set_automatic ()</h3>
304 <pre class="programlisting"><span class="returnvalue">void</span> clutter_x11_texture_pixmap_set_automatic
305 (<em class="parameter"><code><a class="link" href="clutter-ClutterX11TexturePixmap.html#ClutterX11TexturePixmap" title="struct ClutterX11TexturePixmap"><span class="type">ClutterX11TexturePixmap</span></a> *texture</code></em>,
306 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> setting</code></em>);</pre>
308 Enables or disables the automatic updates ot <em class="parameter"><code>texture</code></em> in case the backing
309 pixmap or window is damaged
311 <div class="variablelist"><table border="0">
312 <col align="left" valign="top">
315 <td><p><span class="term"><em class="parameter"><code>texture</code></em> :</span></p></td>
316 <td>a <a class="link" href="clutter-ClutterX11TexturePixmap.html#ClutterX11TexturePixmap" title="struct ClutterX11TexturePixmap"><span class="type">ClutterX11TexturePixmap</span></a>
320 <td><p><span class="term"><em class="parameter"><code>setting</code></em> :</span></p></td>
322 <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to enable automatic updates</td>
326 <p class="since">Since 0.8</p>
332 Generated by GTK-Doc V1.18.1</div>