<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>ClutterCairoTexture: Clutter Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
<link rel="home" href="index.html" title="Clutter Reference Manual">
<link rel="up" href="deprecated.html" title="Part IX. Deprecated Classes">
<link rel="prev" href="ClutterBox.html" title="ClutterBox">
<link rel="next" href="ClutterGroup.html" title="ClutterGroup">
<meta name="generator" content="GTK-Doc V1.23.1 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
<td width="100%" align="left" class="shortcuts">
<a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span>
<a href="#ClutterCairoTexture.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span>
<a href="#ClutterCairoTexture.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_interfaces"> <span class="dim">|</span>
<a href="#ClutterCairoTexture.implemented-interfaces" class="shortcut">Implemented Interfaces</a></span><span id="nav_properties"> <span class="dim">|</span>
<a href="#ClutterCairoTexture.properties" class="shortcut">Properties</a></span><span id="nav_signals"> <span class="dim">|</span>
<a href="#ClutterCairoTexture.signals" class="shortcut">Signals</a></span>
</td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="deprecated.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="ClutterBox.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="ClutterGroup.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
<a name="ClutterCairoTexture"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="ClutterCairoTexture.top_of_page"></a>ClutterCairoTexture</span></h2>
<p>ClutterCairoTexture — Texture with Cairo integration</p>
</td>
<td class="gallery_image" valign="top" align="right"></td>
</tr></table></div>
<div class="refsect1">
<a name="ClutterCairoTexture.functions"></a><h2>Functions</h2>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="functions_return">
<col class="functions_name">
</colgroup>
<tbody>
<tr>
<td class="function_type">
<a class="link" href="ClutterActor.html" title="ClutterActor"><span class="returnvalue">ClutterActor</span></a> *
</td>
<td class="function_name">
<a class="link" href="ClutterCairoTexture.html#clutter-cairo-texture-new" title="clutter_cairo_texture_new ()">clutter_cairo_texture_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="ClutterCairoTexture.html#clutter-cairo-texture-set-surface-size" title="clutter_cairo_texture_set_surface_size ()">clutter_cairo_texture_set_surface_size</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="ClutterCairoTexture.html#clutter-cairo-texture-get-surface-size" title="clutter_cairo_texture_get_surface_size ()">clutter_cairo_texture_get_surface_size</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="ClutterCairoTexture.html#clutter-cairo-texture-set-auto-resize" title="clutter_cairo_texture_set_auto_resize ()">clutter_cairo_texture_set_auto_resize</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="ClutterCairoTexture.html#clutter-cairo-texture-get-auto-resize" title="clutter_cairo_texture_get_auto_resize ()">clutter_cairo_texture_get_auto_resize</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">cairo_t</span> *
</td>
<td class="function_name">
<a class="link" href="ClutterCairoTexture.html#clutter-cairo-texture-create" title="clutter_cairo_texture_create ()">clutter_cairo_texture_create</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">cairo_t</span> *
</td>
<td class="function_name">
<a class="link" href="ClutterCairoTexture.html#clutter-cairo-texture-create-region" title="clutter_cairo_texture_create_region ()">clutter_cairo_texture_create_region</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="ClutterCairoTexture.html#clutter-cairo-texture-invalidate-rectangle" title="clutter_cairo_texture_invalidate_rectangle ()">clutter_cairo_texture_invalidate_rectangle</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="ClutterCairoTexture.html#clutter-cairo-texture-invalidate" title="clutter_cairo_texture_invalidate ()">clutter_cairo_texture_invalidate</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="ClutterCairoTexture.html#clutter-cairo-texture-clear" title="clutter_cairo_texture_clear ()">clutter_cairo_texture_clear</a> <span class="c_punctuation">()</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="ClutterCairoTexture.properties"></a><h2>Properties</h2>
<div class="informaltable"><table border="0">
<colgroup>
<col width="150px" class="properties_type">
<col width="300px" class="properties_name">
<col width="200px" class="properties_flags">
</colgroup>
<tbody>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="ClutterCairoTexture.html#ClutterCairoTexture--auto-resize" title="The “auto-resize” property">auto-resize</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">guint</span></td>
<td class="property_name"><a class="link" href="ClutterCairoTexture.html#ClutterCairoTexture--surface-height" title="The “surface-height” property">surface-height</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">guint</span></td>
<td class="property_name"><a class="link" href="ClutterCairoTexture.html#ClutterCairoTexture--surface-width" title="The “surface-width” property">surface-width</a></td>
<td class="property_flags">Read / Write</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="ClutterCairoTexture.signals"></a><h2>Signals</h2>
<div class="informaltable"><table border="0">
<colgroup>
<col width="150px" class="signals_return">
<col width="300px" class="signals_name">
<col width="200px" class="signals_flags">
</colgroup>
<tbody>
<tr>
<td class="signal_type">
<span class="returnvalue">CairoSurface</span>*</td>
<td class="signal_name"><a class="link" href="ClutterCairoTexture.html#ClutterCairoTexture-create-surface" title="The “create-surface” signal">create-surface</a></td>
<td class="signal_flags">No Recursion</td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">gboolean</span></td>
<td class="signal_name"><a class="link" href="ClutterCairoTexture.html#ClutterCairoTexture-draw" title="The “draw” signal">draw</a></td>
<td class="signal_flags">No Recursion</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="ClutterCairoTexture.other"></a><h2>Types and Values</h2>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="name">
<col class="description">
</colgroup>
<tbody>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="ClutterCairoTexture.html#ClutterCairoTexture-struct" title="struct ClutterCairoTexture">ClutterCairoTexture</a></td>
</tr>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="ClutterCairoTexture.html#ClutterCairoTextureClass" title="struct ClutterCairoTextureClass">ClutterCairoTextureClass</a></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="ClutterCairoTexture.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="screen"> GObject
<span class="lineart">╰──</span> GInitiallyUnowned
<span class="lineart">╰──</span> <a class="link" href="ClutterActor.html" title="ClutterActor">ClutterActor</a>
<span class="lineart">╰──</span> <a class="link" href="ClutterTexture.html" title="ClutterTexture">ClutterTexture</a>
<span class="lineart">╰──</span> ClutterCairoTexture
</pre>
</div>
<div class="refsect1">
<a name="ClutterCairoTexture.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
<p>
ClutterCairoTexture implements
<a class="link" href="ClutterContainer.html" title="ClutterContainer">ClutterContainer</a>, <a class="link" href="ClutterScriptable.html" title="ClutterScriptable">ClutterScriptable</a>, <a class="link" href="ClutterAnimatable.html" title="ClutterAnimatable">ClutterAnimatable</a> and AtkImplementorIface.</p>
</div>
<div class="refsect1">
<a name="ClutterCairoTexture.description"></a><h2>Description</h2>
<p><a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a> is a <a class="link" href="ClutterTexture.html" title="ClutterTexture"><span class="type">ClutterTexture</span></a> that displays the contents
of a Cairo context. The <a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a> actor will create a
Cairo image surface which will then be uploaded to a GL texture when
needed.</p>
<p>Since <a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a> uses a Cairo image surface
internally all the drawing operations will be performed in
software and not using hardware acceleration. This can lead to
performance degradation if the contents of the texture change
frequently.</p>
<p>In order to use a <a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a> you should connect to the
<a class="link" href="ClutterCairoTexture.html#ClutterCairoTexture-draw" title="The “draw” signal"><span class="type">“draw”</span></a> signal; the signal is emitted each time
the <a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a> has been told to invalidate its contents,
by using <a class="link" href="ClutterCairoTexture.html#clutter-cairo-texture-invalidate-rectangle" title="clutter_cairo_texture_invalidate_rectangle ()"><code class="function">clutter_cairo_texture_invalidate_rectangle()</code></a> or its
sister function, <a class="link" href="ClutterCairoTexture.html#clutter-cairo-texture-invalidate" title="clutter_cairo_texture_invalidate ()"><code class="function">clutter_cairo_texture_invalidate()</code></a>.</p>
<p>Each callback to the <a class="link" href="ClutterCairoTexture.html#ClutterCairoTexture-draw" title="The “draw” signal"><span class="type">“draw”</span></a> signal will receive
a <span class="type">cairo_t</span> context which can be used for drawing; the Cairo context
is owned by the <a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a> and should not be destroyed
explicitly.</p>
<p><a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a> is available since Clutter 1.0.</p>
<p><a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a> is deprecated since Clutter 1.12. You should
use <a class="link" href="ClutterCanvas.html" title="ClutterCanvas"><span class="type">ClutterCanvas</span></a> instead.</p>
</div>
<div class="refsect1">
<a name="ClutterCairoTexture.functions_details"></a><h2>Functions</h2>
<div class="refsect2">
<a name="clutter-cairo-texture-new"></a><h3>clutter_cairo_texture_new ()</h3>
<pre class="programlisting"><a class="link" href="ClutterActor.html" title="ClutterActor"><span class="returnvalue">ClutterActor</span></a> *
clutter_cairo_texture_new (<em class="parameter"><code><span class="type">guint</span> width</code></em>,
<em class="parameter"><code><span class="type">guint</span> height</code></em>);</pre>
<div class="warning">
<p><code class="literal">clutter_cairo_texture_new</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="ClutterCanvas.html" title="ClutterCanvas"><span class="type">ClutterCanvas</span></a> instead</p>
</div>
<p>Creates a new <a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a> actor, with a surface of <em class="parameter"><code>width</code></em>
by
<em class="parameter"><code>height</code></em>
pixels.</p>
<div class="refsect3">
<a name="id-1.10.13.10.2.7"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>width</p></td>
<td class="parameter_description"><p>the width of the surface</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>height</p></td>
<td class="parameter_description"><p>the height of the surface</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.10.13.10.2.8"></a><h4>Returns</h4>
<p> the newly created <a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a> actor</p>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-cairo-texture-set-surface-size"></a><h3>clutter_cairo_texture_set_surface_size ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
clutter_cairo_texture_set_surface_size
(<em class="parameter"><code><a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a> *self</code></em>,
<em class="parameter"><code><span class="type">guint</span> width</code></em>,
<em class="parameter"><code><span class="type">guint</span> height</code></em>);</pre>
<div class="warning">
<p><code class="literal">clutter_cairo_texture_set_surface_size</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="ClutterCanvas.html" title="ClutterCanvas"><span class="type">ClutterCanvas</span></a> instead</p>
</div>
<p>Resizes the Cairo surface used by <em class="parameter"><code>self</code></em>
to <em class="parameter"><code>width</code></em>
and <em class="parameter"><code>height</code></em>
.</p>
<p>This function will not invalidate the contents of the Cairo
texture: you will have to explicitly call either
<a class="link" href="ClutterCairoTexture.html#clutter-cairo-texture-invalidate-rectangle" title="clutter_cairo_texture_invalidate_rectangle ()"><code class="function">clutter_cairo_texture_invalidate_rectangle()</code></a> or
<a class="link" href="ClutterCairoTexture.html#clutter-cairo-texture-invalidate" title="clutter_cairo_texture_invalidate ()"><code class="function">clutter_cairo_texture_invalidate()</code></a>.</p>
<div class="refsect3">
<a name="id-1.10.13.10.3.8"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>width</p></td>
<td class="parameter_description"><p>the new width of the surface</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>height</p></td>
<td class="parameter_description"><p>the new height of the surface</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-cairo-texture-get-surface-size"></a><h3>clutter_cairo_texture_get_surface_size ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
clutter_cairo_texture_get_surface_size
(<em class="parameter"><code><a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a> *self</code></em>,
<em class="parameter"><code><span class="type">guint</span> *width</code></em>,
<em class="parameter"><code><span class="type">guint</span> *height</code></em>);</pre>
<div class="warning">
<p><code class="literal">clutter_cairo_texture_get_surface_size</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="ClutterCanvas.html" title="ClutterCanvas"><span class="type">ClutterCanvas</span></a> instead</p>
</div>
<p>Retrieves the surface width and height for <em class="parameter"><code>self</code></em>
.</p>
<div class="refsect3">
<a name="id-1.10.13.10.4.7"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>width</p></td>
<td class="parameter_description"><p> return location for the surface width, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>height</p></td>
<td class="parameter_description"><p> return location for the surface height, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-cairo-texture-set-auto-resize"></a><h3>clutter_cairo_texture_set_auto_resize ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
clutter_cairo_texture_set_auto_resize (<em class="parameter"><code><a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a> *self</code></em>,
<em class="parameter"><code><span class="type">gboolean</span> value</code></em>);</pre>
<div class="warning">
<p><code class="literal">clutter_cairo_texture_set_auto_resize</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="ClutterCanvas.html" title="ClutterCanvas"><span class="type">ClutterCanvas</span></a> instead</p>
</div>
<p>Sets whether the <a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a> should ensure that the
backing Cairo surface used matches the allocation assigned to
the actor. If the allocation changes, the contents of the
<a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a> will also be invalidated automatically.</p>
<div class="refsect3">
<a name="id-1.10.13.10.5.7"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p><code class="literal">TRUE</code> if the <a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a> should bind the surface
size to the allocation</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix11.html#api-index-1.8">1.8</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-cairo-texture-get-auto-resize"></a><h3>clutter_cairo_texture_get_auto_resize ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
clutter_cairo_texture_get_auto_resize (<em class="parameter"><code><a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a> *self</code></em>);</pre>
<div class="warning">
<p><code class="literal">clutter_cairo_texture_get_auto_resize</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="ClutterCanvas.html" title="ClutterCanvas"><span class="type">ClutterCanvas</span></a> instead</p>
</div>
<p>Retrieves the value set using <a class="link" href="ClutterCairoTexture.html#clutter-cairo-texture-set-auto-resize" title="clutter_cairo_texture_set_auto_resize ()"><code class="function">clutter_cairo_texture_set_auto_resize()</code></a>.</p>
<div class="refsect3">
<a name="id-1.10.13.10.6.7"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.10.13.10.6.8"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if the <a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a> should track the
allocation, and <code class="literal">FALSE</code> otherwise</p>
</div>
<p class="since">Since: <a class="link" href="ix11.html#api-index-1.8">1.8</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-cairo-texture-create"></a><h3>clutter_cairo_texture_create ()</h3>
<pre class="programlisting"><span class="returnvalue">cairo_t</span> *
clutter_cairo_texture_create (<em class="parameter"><code><a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a> *self</code></em>);</pre>
<div class="warning">
<p><code class="literal">clutter_cairo_texture_create</code> has been deprecated since version 1.8 and should not be used in newly-written code.</p>
<p>Use the <a class="link" href="ClutterCairoTexture.html#ClutterCairoTexture-draw" title="The “draw” signal"><span class="type">“draw”</span></a> signal and
the <a class="link" href="ClutterCairoTexture.html#clutter-cairo-texture-invalidate" title="clutter_cairo_texture_invalidate ()"><code class="function">clutter_cairo_texture_invalidate()</code></a> function to obtain a
Cairo context for 2D drawing.</p>
</div>
<p>Creates a new Cairo context for the <em class="parameter"><code>cairo</code></em>
texture. It is
similar to using <a class="link" href="ClutterCairoTexture.html#clutter-cairo-texture-create-region" title="clutter_cairo_texture_create_region ()"><code class="function">clutter_cairo_texture_create_region()</code></a> with <em class="parameter"><code>x_offset</code></em>
and <em class="parameter"><code>y_offset</code></em>
of 0, <em class="parameter"><code>width</code></em>
equal to the <em class="parameter"><code>cairo</code></em>
texture surface width
and <em class="parameter"><code>height</code></em>
equal to the <em class="parameter"><code>cairo</code></em>
texture surface height.</p>
<p>Do not call this function within the paint virtual
function or from a callback to the <a class="link" href="ClutterActor.html#ClutterActor-paint" title="The “paint” signal"><span class="type">“paint”</span></a>
signal.</p>
<div class="refsect3">
<a name="id-1.10.13.10.7.8"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.10.13.10.7.9"></a><h4>Returns</h4>
<p> a newly created Cairo context. Use <code class="function">cairo_destroy()</code>
to upload the contents of the context when done drawing</p>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-cairo-texture-create-region"></a><h3>clutter_cairo_texture_create_region ()</h3>
<pre class="programlisting"><span class="returnvalue">cairo_t</span> *
clutter_cairo_texture_create_region (<em class="parameter"><code><a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a> *self</code></em>,
<em class="parameter"><code><span class="type">gint</span> x_offset</code></em>,
<em class="parameter"><code><span class="type">gint</span> y_offset</code></em>,
<em class="parameter"><code><span class="type">gint</span> width</code></em>,
<em class="parameter"><code><span class="type">gint</span> height</code></em>);</pre>
<div class="warning">
<p><code class="literal">clutter_cairo_texture_create_region</code> has been deprecated since version 1.8 and should not be used in newly-written code.</p>
<p>Use the <a class="link" href="ClutterCairoTexture.html#ClutterCairoTexture-draw" title="The “draw” signal"><span class="type">“draw”</span></a> signal and
<a class="link" href="ClutterCairoTexture.html#clutter-cairo-texture-invalidate-rectangle" title="clutter_cairo_texture_invalidate_rectangle ()"><code class="function">clutter_cairo_texture_invalidate_rectangle()</code></a> to obtain a
clipped Cairo context for 2D drawing.</p>
</div>
<p>Creates a new Cairo context that will updat the region defined
by <em class="parameter"><code>x_offset</code></em>
, <em class="parameter"><code>y_offset</code></em>
, <em class="parameter"><code>width</code></em>
and <em class="parameter"><code>height</code></em>
.</p>
<p>Do not call this function within the paint virtual
function or from a callback to the <a class="link" href="ClutterActor.html#ClutterActor-paint" title="The “paint” signal"><span class="type">“paint”</span></a>
signal.</p>
<div class="refsect3">
<a name="id-1.10.13.10.8.8"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>x_offset</p></td>
<td class="parameter_description"><p>offset of the region on the X axis</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>y_offset</p></td>
<td class="parameter_description"><p>offset of the region on the Y axis</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>width</p></td>
<td class="parameter_description"><p>width of the region, or -1 for the full surface width</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>height</p></td>
<td class="parameter_description"><p>height of the region, or -1 for the full surface height</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.10.13.10.8.9"></a><h4>Returns</h4>
<p> a newly created Cairo context. Use <code class="function">cairo_destroy()</code>
to upload the contents of the context when done drawing</p>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-cairo-texture-invalidate-rectangle"></a><h3>clutter_cairo_texture_invalidate_rectangle ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
clutter_cairo_texture_invalidate_rectangle
(<em class="parameter"><code><a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a> *self</code></em>,
<em class="parameter"><code><span class="type">cairo_rectangle_int_t</span> *rect</code></em>);</pre>
<div class="warning">
<p><code class="literal">clutter_cairo_texture_invalidate_rectangle</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="ClutterCanvas.html" title="ClutterCanvas"><span class="type">ClutterCanvas</span></a> instead</p>
</div>
<p>Invalidates a rectangular region of a <a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a>.</p>
<p>The invalidation will cause the <a class="link" href="ClutterCairoTexture.html#ClutterCairoTexture-draw" title="The “draw” signal"><span class="type">“draw”</span></a> signal
to be emitted.</p>
<p>See also: <a class="link" href="ClutterCairoTexture.html#clutter-cairo-texture-invalidate" title="clutter_cairo_texture_invalidate ()"><code class="function">clutter_cairo_texture_invalidate()</code></a></p>
<div class="refsect3">
<a name="id-1.10.13.10.9.9"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>rect</p></td>
<td class="parameter_description"><p> a rectangle with the area to invalida,
or <code class="literal">NULL</code> to perform an unbounded invalidation. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix11.html#api-index-1.8">1.8</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-cairo-texture-invalidate"></a><h3>clutter_cairo_texture_invalidate ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
clutter_cairo_texture_invalidate (<em class="parameter"><code><a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a> *self</code></em>);</pre>
<div class="warning">
<p><code class="literal">clutter_cairo_texture_invalidate</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="ClutterCanvas.html" title="ClutterCanvas"><span class="type">ClutterCanvas</span></a> instead</p>
</div>
<p>Invalidates the whole surface of a <a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a>.</p>
<p>This function will cause the <a class="link" href="ClutterCairoTexture.html#ClutterCairoTexture-draw" title="The “draw” signal"><span class="type">“draw”</span></a> signal
to be emitted.</p>
<p>See also: <a class="link" href="ClutterCairoTexture.html#clutter-cairo-texture-invalidate-rectangle" title="clutter_cairo_texture_invalidate_rectangle ()"><code class="function">clutter_cairo_texture_invalidate_rectangle()</code></a></p>
<div class="refsect3">
<a name="id-1.10.13.10.10.9"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix11.html#api-index-1.8">1.8</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-cairo-texture-clear"></a><h3>clutter_cairo_texture_clear ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
clutter_cairo_texture_clear (<em class="parameter"><code><a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a> *self</code></em>);</pre>
<div class="warning">
<p><code class="literal">clutter_cairo_texture_clear</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="ClutterCanvas.html" title="ClutterCanvas"><span class="type">ClutterCanvas</span></a> instead</p>
</div>
<p>Clears <em class="parameter"><code>self</code></em>
's internal drawing surface, so that the next upload
will replace the previous contents of the <a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a>
rather than adding to it.</p>
<p>Calling this function from within a <a class="link" href="ClutterCairoTexture.html#ClutterCairoTexture-draw" title="The “draw” signal"><span class="type">“draw”</span></a>
signal handler will clear the invalidated area.</p>
<div class="refsect3">
<a name="id-1.10.13.10.11.8"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
</div>
<div class="refsect1">
<a name="ClutterCairoTexture.other_details"></a><h2>Types and Values</h2>
<div class="refsect2">
<a name="ClutterCairoTexture-struct"></a><h3>struct ClutterCairoTexture</h3>
<pre class="programlisting">struct ClutterCairoTexture;</pre>
<div class="warning">
<p><code class="literal">ClutterCairoTexture</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="ClutterCanvas.html" title="ClutterCanvas"><span class="type">ClutterCanvas</span></a> instead</p>
</div>
<p>The <a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a> struct contains only private data.</p>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="ClutterCairoTextureClass"></a><h3>struct ClutterCairoTextureClass</h3>
<pre class="programlisting">struct ClutterCairoTextureClass {
cairo_surface_t *(* create_surface) (ClutterCairoTexture *texture,
guint width,
guint height);
gboolean (* draw) (ClutterCairoTexture *texture,
cairo_t *cr);
};
</pre>
<div class="warning">
<p><code class="literal">ClutterCairoTextureClass</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="ClutterCanvas.html" title="ClutterCanvas"><span class="type">ClutterCanvas</span></a> instead</p>
</div>
<p>The <a class="link" href="ClutterCairoTexture.html#ClutterCairoTextureClass" title="struct ClutterCairoTextureClass"><span class="type">ClutterCairoTextureClass</span></a> struct contains only private data.</p>
<div class="refsect3">
<a name="id-1.10.13.11.3.7"></a><h4>Members</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="300px" class="struct_members_name">
<col class="struct_members_description">
<col width="200px" class="struct_members_annotations">
</colgroup>
<tbody>
<tr>
<td class="struct_member_name"><p><em class="structfield"><code><a name="ClutterCairoTextureClass.create-surface"></a>create_surface</code></em> ()</p></td>
<td class="struct_member_description"><p>class handler for the <a class="link" href="ClutterCairoTexture.html#ClutterCairoTexture-create-surface" title="The “create-surface” signal"><span class="type">“create-surface”</span></a>
signal</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><em class="structfield"><code><a name="ClutterCairoTextureClass.draw"></a>draw</code></em> ()</p></td>
<td class="struct_member_description"><p>class handler for the <a class="link" href="ClutterCairoTexture.html#ClutterCairoTexture-draw" title="The “draw” signal"><span class="type">“draw”</span></a> signal</p></td>
<td class="struct_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
</div>
<div class="refsect1">
<a name="ClutterCairoTexture.property-details"></a><h2>Property Details</h2>
<div class="refsect2">
<a name="ClutterCairoTexture--auto-resize"></a><h3>The <code class="literal">“auto-resize”</code> property</h3>
<pre class="programlisting"> “auto-resize” <span class="type">gboolean</span></pre>
<p>Controls whether the <a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a> should automatically
resize the Cairo surface whenever the actor's allocation changes.
If :auto-resize is set to <code class="literal">TRUE</code> the surface contents will also
be invalidated automatically.</p>
<div class="warning"><p><code class="literal">ClutterCairoTexture:auto-resize</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p></div>
<p>Flags: Read / Write</p>
<p>Default value: FALSE</p>
<p class="since">Since: <a class="link" href="ix11.html#api-index-1.8">1.8</a></p>
</div>
<hr>
<div class="refsect2">
<a name="ClutterCairoTexture--surface-height"></a><h3>The <code class="literal">“surface-height”</code> property</h3>
<pre class="programlisting"> “surface-height” <span class="type">guint</span></pre>
<p>The height of the Cairo surface used by the <a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a>
actor, in pixels.</p>
<div class="warning"><p><code class="literal">ClutterCairoTexture:surface-height</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p></div>
<p>Flags: Read / Write</p>
<p>Default value: 0</p>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="ClutterCairoTexture--surface-width"></a><h3>The <code class="literal">“surface-width”</code> property</h3>
<pre class="programlisting"> “surface-width” <span class="type">guint</span></pre>
<p>The width of the Cairo surface used by the <a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a>
actor, in pixels.</p>
<div class="warning"><p><code class="literal">ClutterCairoTexture:surface-width</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p></div>
<p>Flags: Read / Write</p>
<p>Default value: 0</p>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
</div>
<div class="refsect1">
<a name="ClutterCairoTexture.signal-details"></a><h2>Signal Details</h2>
<div class="refsect2">
<a name="ClutterCairoTexture-create-surface"></a><h3>The <code class="literal">“create-surface”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">CairoSurface</span>*
user_function (<a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a> *texture,
<span class="type">guint</span> width,
<span class="type">guint</span> height,
<span class="type">gpointer</span> user_data)</pre>
<p>The ::create-surface signal is emitted when a <a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a>
news its surface (re)created, which happens either when the Cairo
context is created with <a class="link" href="ClutterCairoTexture.html#clutter-cairo-texture-create" title="clutter_cairo_texture_create ()"><code class="function">clutter_cairo_texture_create()</code></a> or
<a class="link" href="ClutterCairoTexture.html#clutter-cairo-texture-create-region" title="clutter_cairo_texture_create_region ()"><code class="function">clutter_cairo_texture_create_region()</code></a>, or when the surface is resized
through <a class="link" href="ClutterCairoTexture.html#clutter-cairo-texture-set-surface-size" title="clutter_cairo_texture_set_surface_size ()"><code class="function">clutter_cairo_texture_set_surface_size()</code></a>.</p>
<p>The first signal handler that returns a non-<code class="literal">NULL</code>, valid surface will
stop any further signal emission, and the returned surface will be
the one used.</p>
<div class="warning"><p><code class="literal">ClutterCairoTexture::create-surface</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p></div>
<div class="refsect3">
<a name="id-1.10.13.13.2.8"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>texture</p></td>
<td class="parameter_description"><p>the <a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a> that emitted the signal</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>width</p></td>
<td class="parameter_description"><p>the width of the surface to create</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>height</p></td>
<td class="parameter_description"><p>the height of the surface to create</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.10.13.13.2.9"></a><h4>Returns</h4>
<p> the newly created <span class="type">cairo_surface_t</span> for the texture</p>
</div>
<p>Flags: No Recursion</p>
<p class="since">Since: <a class="link" href="ix10.html#api-index-1.6">1.6</a></p>
</div>
<hr>
<div class="refsect2">
<a name="ClutterCairoTexture-draw"></a><h3>The <code class="literal">“draw”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
user_function (<a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a> *texture,
<span class="type">CairoContext</span> *cr,
<span class="type">gpointer</span> user_data)</pre>
<p>The ::draw signal is emitted each time a <a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a> has
been invalidated.</p>
<p>The passed Cairo context passed will be clipped to the invalidated
area.</p>
<p>It is safe to connect multiple callbacks to this signals; the state
of the Cairo context passed to each callback is automatically saved
and restored, so it's not necessary to call <code class="function">cairo_save()</code> and
<code class="function">cairo_restore()</code>.</p>
<div class="warning"><p><code class="literal">ClutterCairoTexture::draw</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p></div>
<div class="refsect3">
<a name="id-1.10.13.13.3.9"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>texture</p></td>
<td class="parameter_description"><p>the <a class="link" href="ClutterCairoTexture.html" title="ClutterCairoTexture"><span class="type">ClutterCairoTexture</span></a> that emitted the signal</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cr</p></td>
<td class="parameter_description"><p>the Cairo context to use to draw</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.10.13.13.3.10"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if the signal emission should stop, and <code class="literal">FALSE</code>
to continue</p>
</div>
<p>Flags: No Recursion</p>
<p class="since">Since: <a class="link" href="ix11.html#api-index-1.8">1.8</a></p>
</div>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.23.1</div>
</body>
</html>