RubyGems - clutter - Versions diffs - 2.2.0-x86-mingw32 → 2.2.1-x86-mingw32 - Mend

clutter 2.2.0-x86-mingw32 → 2.2.1-x86-mingw32

Files changed (631) hide show

data/vendor/local/share/gtk-doc/html/clutter/ClutterCanvas.html CHANGED Viewed

@@ -8,23 +8,18 @@
 <link rel="up" href="ch07.html" title="Content">
 <link rel="prev" href="ch07.html" title="Content">
 <link rel="next" href="ClutterImage.html" title="ClutterImage">
-<meta name="generator" content="GTK-Doc V1.19.1 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.20.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="10"><tr valign="middle">
-<td width="100%" align="left">
-<a href="#" class="shortcut">Top</a>
-                   |
-                  <a href="#ClutterCanvas.description" class="shortcut">Description</a>
-                   |
-                  <a href="#ClutterCanvas.object-hierarchy" class="shortcut">Object Hierarchy</a>
-                   |
-                  <a href="#ClutterCanvas.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
-                   |
-                  <a href="#ClutterCanvas.properties" class="shortcut">Properties</a>
-                   |
-                  <a href="#ClutterCanvas.signals" class="shortcut">Signals</a>
+<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="#ClutterCanvas.description" class="shortcut">Description</a></span><span id="nav_hierarchy">  <span class="dim">|</span>
+                  <a href="#ClutterCanvas.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_interfaces">  <span class="dim">|</span>
+                  <a href="#ClutterCanvas.implemented-interfaces" class="shortcut">Implemented Interfaces</a></span><span id="nav_properties">  <span class="dim">|</span>
+                  <a href="#ClutterCanvas.properties" class="shortcut">Properties</a></span><span id="nav_signals">  <span class="dim">|</span>
+                  <a href="#ClutterCanvas.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="ch07.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
@@ -38,325 +33,175 @@
 <h2><span class="refentrytitle"><a name="ClutterCanvas.top_of_page"></a>ClutterCanvas</span></h2>
 <p>ClutterCanvas — Content for 2D painting</p>
 </td>
-<td valign="top" align="right"></td>
+<td class="gallery_image" valign="top" align="right"></td>
 </tr></table></div>
-<div class="refsynopsisdiv">
-<a name="ClutterCanvas.synopsis"></a><h2>Synopsis</h2>
-<pre class="synopsis">struct              <a class="link" href="ClutterCanvas.html#ClutterCanvas-struct" title="struct ClutterCanvas">ClutterCanvas</a>;
-struct              <a class="link" href="ClutterCanvas.html#ClutterCanvasClass" title="struct ClutterCanvasClass">ClutterCanvasClass</a>;
-<a class="link" href="ClutterContent.html" title="ClutterContent"><span class="returnvalue">ClutterContent</span></a> *    <a class="link" href="ClutterCanvas.html#clutter-canvas-new" title="clutter_canvas_new ()">clutter_canvas_new</a>                  (<em class="parameter"><code><span class="type">void</span></code></em>);
-<span class="returnvalue">gboolean</span>            <a class="link" href="ClutterCanvas.html#clutter-canvas-set-size" title="clutter_canvas_set_size ()">clutter_canvas_set_size</a>             (<em class="parameter"><code><a class="link" href="ClutterCanvas.html" title="ClutterCanvas"><span class="type">ClutterCanvas</span></a> *canvas</code></em>,
-                                                         <em class="parameter"><code><span class="type">int</span> width</code></em>,
-                                                         <em class="parameter"><code><span class="type">int</span> height</code></em>);
-</pre>
+<div class="refsect1">
+<a name="ClutterCanvas.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="ClutterContent.html" title="ClutterContent"><span class="returnvalue">ClutterContent</span></a> *
+</td>
+<td class="function_name">
+<a class="link" href="ClutterCanvas.html#clutter-canvas-new" title="clutter_canvas_new ()">clutter_canvas_new</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="ClutterCanvas.html#clutter-canvas-set-size" title="clutter_canvas_set_size ()">clutter_canvas_set_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="ClutterCanvas.html#clutter-canvas-set-scale-factor" title="clutter_canvas_set_scale_factor ()">clutter_canvas_set_scale_factor</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">int</span>
+</td>
+<td class="function_name">
+<a class="link" href="ClutterCanvas.html#clutter-canvas-get-scale-factor" title="clutter_canvas_get_scale_factor ()">clutter_canvas_get_scale_factor</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+</tbody>
+</table></div>
 </div>
 <div class="refsect1">
-<a name="ClutterCanvas.object-hierarchy"></a><h2>Object Hierarchy</h2>
-<pre class="synopsis">
-  GObject
-   +----ClutterCanvas
-</pre>
+<a name="ClutterCanvas.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">gint</span></td>
+<td class="property_name"><a class="link" href="ClutterCanvas.html#ClutterCanvas--height" title="The “height” property">height</a></td>
+<td class="property_flags">Read / Write</td>
+</tr>
+<tr>
+<td class="property_type"><span class="type">gint</span></td>
+<td class="property_name"><a class="link" href="ClutterCanvas.html#ClutterCanvas--scale-factor" title="The “scale-factor” property">scale-factor</a></td>
+<td class="property_flags">Read / Write</td>
+</tr>
+<tr>
+<td class="property_type"><span class="type">gboolean</span></td>
+<td class="property_name"><a class="link" href="ClutterCanvas.html#ClutterCanvas--scale-factor-set" title="The “scale-factor-set” property">scale-factor-set</a></td>
+<td class="property_flags">Read</td>
+</tr>
+<tr>
+<td class="property_type"><span class="type">gint</span></td>
+<td class="property_name"><a class="link" href="ClutterCanvas.html#ClutterCanvas--width" title="The “width” property">width</a></td>
+<td class="property_flags">Read / Write</td>
+</tr>
+</tbody>
+</table></div>
 </div>
 <div class="refsect1">
-<a name="ClutterCanvas.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
-<p>
-ClutterCanvas implements
- <a class="link" href="ClutterContent.html" title="ClutterContent">ClutterContent</a>.</p>
+<a name="ClutterCanvas.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">gboolean</span></td>
+<td class="signal_name"><a class="link" href="ClutterCanvas.html#ClutterCanvas-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="ClutterCanvas.properties"></a><h2>Properties</h2>
-<pre class="synopsis">
-  "<a class="link" href="ClutterCanvas.html#ClutterCanvas--height" title='The "height" property'>height</a>"                   <span class="type">gint</span>                  : Read / Write
-  "<a class="link" href="ClutterCanvas.html#ClutterCanvas--width" title='The "width" property'>width</a>"                    <span class="type">gint</span>                  : Read / Write
-</pre>
+<a name="ClutterCanvas.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="ClutterCanvas.html#ClutterCanvas-struct" title="struct ClutterCanvas">ClutterCanvas</a></td>
+</tr>
+<tr>
+<td class="datatype_keyword">struct</td>
+<td class="function_name"><a class="link" href="ClutterCanvas.html#ClutterCanvasClass" title="struct ClutterCanvasClass">ClutterCanvasClass</a></td>
+</tr>
+</tbody>
+</table></div>
 </div>
 <div class="refsect1">
-<a name="ClutterCanvas.signals"></a><h2>Signals</h2>
-<pre class="synopsis">
-  "<a class="link" href="ClutterCanvas.html#ClutterCanvas-draw" title='The "draw" signal'>draw</a>"                                           : <code class="literal">No Recursion</code>
+<a name="ClutterCanvas.object-hierarchy"></a><h2>Object Hierarchy</h2>
+<pre class="screen">    GObject
+    <span class="lineart">╰──</span> ClutterCanvas
 </pre>
 </div>
 <div class="refsect1">
-<a name="ClutterCanvas.description"></a><h2>Description</h2>
-<p>
-The <a class="link" href="ClutterCanvas.html" title="ClutterCanvas"><span class="type">ClutterCanvas</span></a> class is a <a class="link" href="ClutterContent.html" title="ClutterContent"><span class="type">ClutterContent</span></a> implementation that allows
-drawing using the Cairo API on a 2D surface.
-</p>
-<p>
-In order to draw on a <a class="link" href="ClutterCanvas.html" title="ClutterCanvas"><span class="type">ClutterCanvas</span></a>, you should connect a handler to the
-<a class="link" href="ClutterCanvas.html#ClutterCanvas-draw" title='The "draw" signal'><span class="type">"draw"</span></a> signal; the signal will receive a <a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-t.html#cairo-t"><span class="type">cairo_t</span></a> context
-that can be used to draw. <a class="link" href="ClutterCanvas.html" title="ClutterCanvas"><span class="type">ClutterCanvas</span></a> will emit the <a class="link" href="ClutterCanvas.html#ClutterCanvas-draw" title='The "draw" signal'><span class="type">"draw"</span></a>
-signal when invalidated using <a class="link" href="ClutterContent.html#clutter-content-invalidate" title="clutter_content_invalidate ()"><code class="function">clutter_content_invalidate()</code></a>.
-</p>
-<p>
-</p>
-<div class="informalexample">
-<a name="canvas-example"></a><pre class="programlisting">
-#include &lt;stdlib.h&gt;
-#include &lt;math.h&gt;
-#include &lt;cairo.h&gt;
-#include &lt;clutter/clutter.h&gt;
-static gboolean
-draw_clock (ClutterCanvas *canvas,
-            cairo_t       *cr,
-            int            width,
-            int            height)
-{
-  GDateTime *now;
-  float hours, minutes, seconds;
-  ClutterColor color;
-  /* get the current time and compute the angles */
-  now = g_date_time_new_now_local ();
-  seconds = g_date_time_get_second (now) * G_PI / 30;
-  minutes = g_date_time_get_minute (now) * G_PI / 30;
-  hours = g_date_time_get_hour (now) * G_PI / 6;
-  cairo_save (cr);
-  /* clear the contents of the canvas, to avoid painting
-   * over the previous frame
-   */
-  cairo_set_operator (cr, CAIRO_OPERATOR_CLEAR);
-  cairo_paint (cr);
-  cairo_restore (cr);
-  cairo_set_operator (cr, CAIRO_OPERATOR_OVER);
-  /* scale the modelview to the size of the surface */
-  cairo_scale (cr, width, height);
-  cairo_set_line_cap (cr, CAIRO_LINE_CAP_ROUND);
-  cairo_set_line_width (cr, 0.1);
-  /* the black rail that holds the seconds indicator */
-  clutter_cairo_set_source_color (cr, CLUTTER_COLOR_Black);
-  cairo_translate (cr, 0.5, 0.5);
-  cairo_arc (cr, 0, 0, 0.4, 0, G_PI * 2);
-  cairo_stroke (cr);
-  /* the seconds indicator */
-  color = *CLUTTER_COLOR_White;
-  color.alpha = 128;
-  clutter_cairo_set_source_color (cr, &amp;color);
-  cairo_move_to (cr, 0, 0);
-  cairo_arc (cr, sinf (seconds) * 0.4, - cosf (seconds) * 0.4, 0.05, 0, G_PI * 2);
-  cairo_fill (cr);
-  /* the minutes hand */
-  color = *CLUTTER_COLOR_DarkChameleon;
-  color.alpha = 196;
-  clutter_cairo_set_source_color (cr, &amp;color);
-  cairo_move_to (cr, 0, 0);
-  cairo_line_to (cr, sinf (minutes) * 0.4, -cosf (minutes) * 0.4);
-  cairo_stroke (cr);
-  /* the hours hand */
-  cairo_move_to (cr, 0, 0);
-  cairo_line_to (cr, sinf (hours) * 0.2, -cosf (hours) * 0.2);
-  cairo_stroke (cr);
-  g_date_time_unref (now);
-  /* we're done drawing */
-  return TRUE;
-}
-static gboolean
-invalidate_clock (gpointer data_)
-{
-  /* invalidate the contents of the canvas */
-  clutter_content_invalidate (data_);
-  /* keep the timeout source */
-  return G_SOURCE_CONTINUE;
-}
-static guint idle_resize_id;
-static gboolean
-idle_resize (gpointer data)
-{
-  ClutterActor *actor = data;
-  float width, height;
-  /* match the canvas size to the actor's */
-  clutter_actor_get_size (actor, &amp;width, &amp;height);
-  clutter_canvas_set_size (CLUTTER_CANVAS (clutter_actor_get_content (actor)),
-                           ceilf (width),
-                           ceilf (height));
-  /* unset the guard */
-  idle_resize_id = 0;
-  /* remove the timeout */
-  return G_SOURCE_REMOVE;
-}
-static void
-on_actor_resize (ClutterActor           *actor,
-                 const ClutterActorBox  *allocation,
-                 ClutterAllocationFlags  flags,
-                 gpointer                user_data)
-{
-  /* throttle multiple actor allocations to one canvas resize; we use a guard
-   * variable to avoid queueing multiple resize operations
-   */
-  if (idle_resize_id == 0)
-    idle_resize_id = clutter_threads_add_timeout (1000, idle_resize, actor);
-}
-int
-main (int argc, char *argv[])
-{
-  ClutterActor *stage, *actor;
-  ClutterContent *canvas;
-  /* initialize Clutter */
-  if (clutter_init (&amp;argc, &amp;argv) != CLUTTER_INIT_SUCCESS)
-    return EXIT_FAILURE;
-  /* create a resizable stage */
-  stage = clutter_stage_new ();
-  clutter_stage_set_title (CLUTTER_STAGE (stage), "2D Clock");
-  clutter_stage_set_user_resizable (CLUTTER_STAGE (stage), TRUE);
-  clutter_actor_set_background_color (stage, CLUTTER_COLOR_LightSkyBlue);
-  clutter_actor_set_size (stage, 300, 300);
-  clutter_actor_show (stage);
-  /* our 2D canvas, courtesy of Cairo */
-  canvas = clutter_canvas_new ();
-  clutter_canvas_set_size (CLUTTER_CANVAS (canvas), 300, 300);
-  actor = clutter_actor_new ();
-  clutter_actor_set_content (actor, canvas);
-  clutter_actor_set_content_scaling_filters (actor,
-                                             CLUTTER_SCALING_FILTER_TRILINEAR,
-                                             CLUTTER_SCALING_FILTER_LINEAR);
-  clutter_actor_add_child (stage, actor);
-  /* the actor now owns the canvas */
-  g_object_unref (canvas);
-  /* bind the size of the actor to that of the stage */
-  clutter_actor_add_constraint (actor, clutter_bind_constraint_new (stage, CLUTTER_BIND_SIZE, 0));
-  /* resize the canvas whenever the actor changes size */
-  g_signal_connect (actor, "allocation-changed", G_CALLBACK (on_actor_resize), NULL);
-  /* quit on destroy */
-  g_signal_connect (stage, "destroy", G_CALLBACK (clutter_main_quit), NULL);
-  /* connect our drawing code */
-  g_signal_connect (canvas, "draw", G_CALLBACK (draw_clock), NULL);
-  /* invalidate the canvas, so that we can draw before the main loop starts */
-  clutter_content_invalidate (canvas);
-  /* set up a timer that invalidates the canvas every second */
-  clutter_threads_add_timeout (1000, invalidate_clock, canvas);
-  clutter_main ();
-  return EXIT_SUCCESS;
-}
-  </pre>
-</div>
-<p>
-</p>
+<a name="ClutterCanvas.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
 <p>
-<a class="link" href="ClutterCanvas.html" title="ClutterCanvas"><span class="type">ClutterCanvas</span></a> is available since Clutter 1.10.
-</p>
+ClutterCanvas implements
+ <a class="link" href="ClutterContent.html" title="ClutterContent">ClutterContent</a>.</p>
 </div>
 <div class="refsect1">
-<a name="ClutterCanvas.details"></a><h2>Details</h2>
-<div class="refsect2">
-<a name="ClutterCanvas-struct"></a><h3>struct ClutterCanvas</h3>
-<pre class="programlisting">struct ClutterCanvas;</pre>
-<p>
-The <span class="structname">ClutterCanvas</span> structure contains
-private data and should only be accessed using the provided
-API.
-</p>
-<p class="since">Since 1.10</p>
+<a name="ClutterCanvas.description"></a><h2>Description</h2>
+<p>The <a class="link" href="ClutterCanvas.html" title="ClutterCanvas"><span class="type">ClutterCanvas</span></a> class is a <a class="link" href="ClutterContent.html" title="ClutterContent"><span class="type">ClutterContent</span></a> implementation that allows
+drawing using the Cairo API on a 2D surface.</p>
+<p>In order to draw on a <a class="link" href="ClutterCanvas.html" title="ClutterCanvas"><span class="type">ClutterCanvas</span></a>, you should connect a handler to the
+<a class="link" href="ClutterCanvas.html#ClutterCanvas-draw" title="The “draw” signal"><span class="type">“draw”</span></a> signal; the signal will receive a <span class="type">cairo_t</span> context
+that can be used to draw. <a class="link" href="ClutterCanvas.html" title="ClutterCanvas"><span class="type">ClutterCanvas</span></a> will emit the <a class="link" href="ClutterCanvas.html#ClutterCanvas-draw" title="The “draw” signal"><span class="type">“draw”</span></a>
+signal when invalidated using <a class="link" href="ClutterContent.html#clutter-content-invalidate" title="clutter_content_invalidate ()"><code class="function">clutter_content_invalidate()</code></a>.</p>
+<p>See <a class="ulink" href="https://git.gnome.org/browse/clutter/tree/examples/canvas.c?h=clutter-1.18" target="_top">canvas.c</a>
+for an example of how to use <a class="link" href="ClutterCanvas.html" title="ClutterCanvas"><span class="type">ClutterCanvas</span></a>.</p>
+<p><a class="link" href="ClutterCanvas.html" title="ClutterCanvas"><span class="type">ClutterCanvas</span></a> is available since Clutter 1.10.</p>
 </div>
-<hr>
+<div class="refsect1">
+<a name="ClutterCanvas.functions_details"></a><h2>Functions</h2>
 <div class="refsect2">
-<a name="ClutterCanvasClass"></a><h3>struct ClutterCanvasClass</h3>
-<pre class="programlisting">struct ClutterCanvasClass {
-  gboolean (* draw) (ClutterCanvas *canvas,
-                     cairo_t       *cr,
-                     int            width,
-                     int            height);
-};
-</pre>
-<p>
-The <span class="structname">ClutterCanvasClass</span> structure contains
-private data.
-</p>
-<div class="variablelist"><table border="0" class="variablelist">
-<colgroup>
-<col align="left" valign="top">
-<col>
-</colgroup>
-<tbody><tr>
-<td><p><span class="term"><em class="structfield"><code><a name="ClutterCanvasClass.draw"></a>draw</code></em> ()</span></p></td>
-<td>class handler for the <a class="link" href="ClutterCanvas.html#ClutterCanvas-draw" title='The "draw" signal'><span class="type">"draw"</span></a> signal</td>
-</tr></tbody>
-</table></div>
-<p class="since">Since 1.10</p>
+<a name="clutter-canvas-new"></a><h3>clutter_canvas_new ()</h3>
+<pre class="programlisting"><a class="link" href="ClutterContent.html" title="ClutterContent"><span class="returnvalue">ClutterContent</span></a> *
+clutter_canvas_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
+<p>Creates a new instance of <a class="link" href="ClutterCanvas.html" title="ClutterCanvas"><span class="type">ClutterCanvas</span></a>.</p>
+<p>You should call <a class="link" href="ClutterCanvas.html#clutter-canvas-set-size" title="clutter_canvas_set_size ()"><code class="function">clutter_canvas_set_size()</code></a> to set the size of the canvas.</p>
+<p>You should call <a class="link" href="ClutterContent.html#clutter-content-invalidate" title="clutter_content_invalidate ()"><code class="function">clutter_content_invalidate()</code></a> every time you wish to
+draw the contents of the canvas.</p>
+<div class="refsect3">
+<a name="id-1.5.8.2.10.2.7"></a><h4>Returns</h4>
+<p> The newly allocated instance of
+<a class="link" href="ClutterCanvas.html" title="ClutterCanvas"><span class="type">ClutterCanvas</span></a>. Use <code class="function">g_object_unref()</code> when done. </p>
+<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
-<hr>
-<div class="refsect2">
-<a name="clutter-canvas-new"></a><h3>clutter_canvas_new ()</h3>
-<pre class="programlisting"><a class="link" href="ClutterContent.html" title="ClutterContent"><span class="returnvalue">ClutterContent</span></a> *    clutter_canvas_new                  (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
-<p>
-Creates a new instance of <a class="link" href="ClutterCanvas.html" title="ClutterCanvas"><span class="type">ClutterCanvas</span></a>.
-</p>
-<p>
-You should call <a class="link" href="ClutterCanvas.html#clutter-canvas-set-size" title="clutter_canvas_set_size ()"><code class="function">clutter_canvas_set_size()</code></a> to set the size of the canvas.
-</p>
-<p>
-You should call <a class="link" href="ClutterContent.html#clutter-content-invalidate" title="clutter_content_invalidate ()"><code class="function">clutter_content_invalidate()</code></a> every time you wish to
-draw the contents of the canvas.
-</p>
-<div class="variablelist"><table border="0" class="variablelist">
-<colgroup>
-<col align="left" valign="top">
-<col>
-</colgroup>
-<tbody><tr>
-<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td>The newly allocated instance of
-<a class="link" href="ClutterCanvas.html" title="ClutterCanvas"><span class="type">ClutterCanvas</span></a>. Use <code class="function">g_object_unref()</code> when done. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
-</td>
-</tr></tbody>
-</table></div>
 <p class="since">Since 1.10</p>
 </div>
 <hr>
 <div class="refsect2">
-<a name="clutter-canvas-set-size"></a><h3>clutter_canvas_set_size ()</h3>
-<pre class="programlisting"><span class="returnvalue">gboolean</span>            clutter_canvas_set_size             (<em class="parameter"><code><a class="link" href="ClutterCanvas.html" title="ClutterCanvas"><span class="type">ClutterCanvas</span></a> *canvas</code></em>,
-                                                         <em class="parameter"><code><span class="type">int</span> width</code></em>,
-                                                         <em class="parameter"><code><span class="type">int</span> height</code></em>);</pre>
-<p>
-Sets the size of the <em class="parameter"><code>canvas</code></em>, and invalidates the content.
-</p>
-<p>
-This function will cause the <em class="parameter"><code>canvas</code></em> to be invalidated only
-if the size of the canvas surface has changed.
-</p>
-<p>
-If you want to invalidate the contents of the <em class="parameter"><code>canvas</code></em> when setting
+<a name="clutter-canvas-set-size"></a><h3>clutter_canvas_set_size ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>
+clutter_canvas_set_size (<em class="parameter"><code><a class="link" href="ClutterCanvas.html" title="ClutterCanvas"><span class="type">ClutterCanvas</span></a> *canvas</code></em>,
+                         <em class="parameter"><code><span class="type">int</span> width</code></em>,
+                         <em class="parameter"><code><span class="type">int</span> height</code></em>);</pre>
+<p>Sets the size of the <em class="parameter"><code>canvas</code></em>
+, and invalidates the content.</p>
+<p>This function will cause the <em class="parameter"><code>canvas</code></em>
+ to be invalidated only
+if the size of the canvas surface has changed.</p>
+<p>If you want to invalidate the contents of the <em class="parameter"><code>canvas</code></em>
+ when setting
 the size, you can use the return value of the function to conditionally
-call <a class="link" href="ClutterContent.html#clutter-content-invalidate" title="clutter_content_invalidate ()"><code class="function">clutter_content_invalidate()</code></a>:
-</p>
-<p>
-</p>
+call <a class="link" href="ClutterContent.html#clutter-content-invalidate" title="clutter_content_invalidate ()"><code class="function">clutter_content_invalidate()</code></a>:</p>
 <div class="informalexample">
   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
     <tbody>
@@ -370,56 +215,198 @@ call <a class="link" href="ClutterContent.html#clutter-content-invalidate" title
   </table>
 </div>
-<p>
-</p>
-<div class="variablelist"><table border="0" class="variablelist">
+<p></p>
+<div class="refsect3">
+<a name="id-1.5.8.2.10.3.9"></a><h4>Parameters</h4>
+<div class="informaltable"><table width="100%" border="0">
 <colgroup>
-<col align="left" valign="top">
-<col>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
 </colgroup>
 <tbody>
 <tr>
-<td><p><span class="term"><em class="parameter"><code>canvas</code></em> :</span></p></td>
-<td>a <a class="link" href="ClutterCanvas.html" title="ClutterCanvas"><span class="type">ClutterCanvas</span></a>
-</td>
+<td class="parameter_name"><p>canvas</p></td>
+<td class="parameter_description"><p>a <a class="link" href="ClutterCanvas.html" title="ClutterCanvas"><span class="type">ClutterCanvas</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 width of the canvas, in pixels</p></td>
+<td class="parameter_annotations"> </td>
 </tr>
 <tr>
-<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td>
-<td>the width of the canvas, in pixels</td>
+<td class="parameter_name"><p>height</p></td>
+<td class="parameter_description"><p>the height of the canvas, in pixels</p></td>
+<td class="parameter_annotations"> </td>
 </tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="id-1.5.8.2.10.3.10"></a><h4>Returns</h4>
+<p> this function returns <code class="literal">TRUE</code> if the size change
+caused a content invalidation, and <code class="literal">FALSE</code> otherwise</p>
+<p></p>
+</div>
+<p class="since">Since 1.10</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="clutter-canvas-set-scale-factor"></a><h3>clutter_canvas_set_scale_factor ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>
+clutter_canvas_set_scale_factor (<em class="parameter"><code><a class="link" href="ClutterCanvas.html" title="ClutterCanvas"><span class="type">ClutterCanvas</span></a> *canvas</code></em>,
+                                 <em class="parameter"><code><span class="type">int</span> scale</code></em>);</pre>
+<p>Sets the scaling factor for the Cairo surface used by <em class="parameter"><code>canvas</code></em>
+.</p>
+<p>This function should rarely be used.</p>
+<p>The default scaling factor of a <a class="link" href="ClutterCanvas.html" title="ClutterCanvas"><span class="type">ClutterCanvas</span></a> content uses the
+<a class="link" href="ClutterSettings.html#ClutterSettings--window-scaling-factor" title="The “window-scaling-factor” property"><span class="type">“window-scaling-factor”</span></a> property, which is set by
+the windowing system. By using this function it is possible to
+override that setting.</p>
+<p>Changing the scale factor will invalidate the <em class="parameter"><code>canvas</code></em>
+.</p>
+<div class="refsect3">
+<a name="id-1.5.8.2.10.4.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><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td>
-<td>the height of the canvas, in pixels</td>
+<td class="parameter_name"><p>canvas</p></td>
+<td class="parameter_description"><p>a <a class="link" href="ClutterCanvas.html" title="ClutterCanvas"><span class="type">ClutterCanvas</span></a></p></td>
+<td class="parameter_annotations"> </td>
 </tr>
 <tr>
-<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td>this function returns <code class="literal">TRUE</code> if the size change
-caused a content invalidation, and <code class="literal">FALSE</code> otherwise</td>
+<td class="parameter_name"><p>scale</p></td>
+<td class="parameter_description"><p>the scale factor, or -1 for the default</p></td>
+<td class="parameter_annotations"> </td>
 </tr>
 </tbody>
 </table></div>
+</div>
+<p class="since">Since 1.18</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="clutter-canvas-get-scale-factor"></a><h3>clutter_canvas_get_scale_factor ()</h3>
+<pre class="programlisting"><span class="returnvalue">int</span>
+clutter_canvas_get_scale_factor (<em class="parameter"><code><a class="link" href="ClutterCanvas.html" title="ClutterCanvas"><span class="type">ClutterCanvas</span></a> *canvas</code></em>);</pre>
+<p>Retrieves the scaling factor of <em class="parameter"><code>canvas</code></em>
+, as set using
+<a class="link" href="ClutterCanvas.html#clutter-canvas-set-scale-factor" title="clutter_canvas_set_scale_factor ()"><code class="function">clutter_canvas_set_scale_factor()</code></a>.</p>
+<div class="refsect3">
+<a name="id-1.5.8.2.10.5.5"></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>canvas</p></td>
+<td class="parameter_description"><p>a <a class="link" href="ClutterCanvas.html" title="ClutterCanvas"><span class="type">ClutterCanvas</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="id-1.5.8.2.10.5.6"></a><h4>Returns</h4>
+<p> the scaling factor, or -1 if the <em class="parameter"><code>canvas</code></em>
+uses the default from <a class="link" href="ClutterSettings.html" title="ClutterSettings"><span class="type">ClutterSettings</span></a></p>
+<p></p>
+</div>
+<p class="since">Since 1.18</p>
+</div>
+</div>
+<div class="refsect1">
+<a name="ClutterCanvas.other_details"></a><h2>Types and Values</h2>
+<div class="refsect2">
+<a name="ClutterCanvas-struct"></a><h3>struct ClutterCanvas</h3>
+<pre class="programlisting">struct ClutterCanvas;</pre>
+<p>The <a class="link" href="ClutterCanvas.html" title="ClutterCanvas"><span class="type">ClutterCanvas</span></a> structure contains
+private data and should only be accessed using the provided
+API.</p>
+<p class="since">Since 1.10</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="ClutterCanvasClass"></a><h3>struct ClutterCanvasClass</h3>
+<pre class="programlisting">struct ClutterCanvasClass {
+  gboolean (* draw) (ClutterCanvas *canvas,
+                     cairo_t       *cr,
+                     int            width,
+                     int            height);
+};
+</pre>
+<p>The <a class="link" href="ClutterCanvas.html#ClutterCanvasClass" title="struct ClutterCanvasClass"><span class="type">ClutterCanvasClass</span></a> structure contains
+private data.</p>
+<div class="refsect3">
+<a name="id-1.5.8.2.11.3.5"></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="ClutterCanvasClass.draw"></a>draw</code></em> ()</p></td>
+<td class="struct_member_description"><p>class handler for the <a class="link" href="ClutterCanvas.html#ClutterCanvas-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 1.10</p>
 </div>
 </div>
 <div class="refsect1">
 <a name="ClutterCanvas.property-details"></a><h2>Property Details</h2>
 <div class="refsect2">
-<a name="ClutterCanvas--height"></a><h3>The <code class="literal">"height"</code> property</h3>
-<pre class="programlisting">  "height"                   <span class="type">gint</span>                  : Read / Write</pre>
-<p>
-The height of the canvas.
-</p>
+<a name="ClutterCanvas--height"></a><h3>The <code class="literal">“height”</code> property</h3>
+<pre class="programlisting">  “height”                   <span class="type">gint</span></pre>
+<p>The height of the canvas.</p>
+<p>Flags: Read / Write</p>
 <p>Allowed values: &gt;= -1</p>
 <p>Default value: -1</p>
 <p class="since">Since 1.10</p>
 </div>
 <hr>
 <div class="refsect2">
-<a name="ClutterCanvas--width"></a><h3>The <code class="literal">"width"</code> property</h3>
-<pre class="programlisting">  "width"                    <span class="type">gint</span>                  : Read / Write</pre>
-<p>
-The width of the canvas.
-</p>
+<a name="ClutterCanvas--scale-factor"></a><h3>The <code class="literal">“scale-factor”</code> property</h3>
+<pre class="programlisting">  “scale-factor”             <span class="type">gint</span></pre>
+<p>The scaling factor to be applied to the Cairo surface used for
+drawing.</p>
+<p>If <a class="link" href="ClutterCanvas.html#ClutterCanvas--scale-factor" title="The “scale-factor” property"><span class="type">“scale-factor”</span></a> is set to a negative value, the
+value of the <a class="link" href="ClutterSettings.html#ClutterSettings--window-scaling-factor" title="The “window-scaling-factor” property"><span class="type">“window-scaling-factor”</span></a> property is
+used instead.</p>
+<p>Use <a class="link" href="ClutterCanvas.html#ClutterCanvas--scale-factor-set" title="The “scale-factor-set” property"><span class="type">“scale-factor-set”</span></a> to check if the scale factor
+is set.</p>
+<p>Flags: Read / Write</p>
+<p>Allowed values: [-1,1000]</p>
+<p>Default value: -1</p>
+<p class="since">Since 1.18</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="ClutterCanvas--scale-factor-set"></a><h3>The <code class="literal">“scale-factor-set”</code> property</h3>
+<pre class="programlisting">  “scale-factor-set”         <span class="type">gboolean</span></pre>
+<p>Whether the <a class="link" href="ClutterCanvas.html#ClutterCanvas--scale-factor" title="The “scale-factor” property"><span class="type">“scale-factor”</span></a> property is set.</p>
+<p>If the <a class="link" href="ClutterCanvas.html#ClutterCanvas--scale-factor-set" title="The “scale-factor-set” property"><span class="type">“scale-factor-set”</span></a> property is <code class="literal">FALSE</code>
+then <a class="link" href="ClutterCanvas.html" title="ClutterCanvas"><span class="type">ClutterCanvas</span></a> will use the <a class="link" href="ClutterSettings.html#ClutterSettings--window-scaling-factor" title="The “window-scaling-factor” property"><span class="type">“window-scaling-factor”</span></a>
+property.</p>
+<p>Flags: Read</p>
+<p>Default value: FALSE</p>
+<p class="since">Since 1.18</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="ClutterCanvas--width"></a><h3>The <code class="literal">“width”</code> property</h3>
+<pre class="programlisting">  “width”                    <span class="type">gint</span></pre>
+<p>The width of the canvas.</p>
+<p>Flags: Read / Write</p>
 <p>Allowed values: &gt;= -1</p>
 <p>Default value: -1</p>
 <p class="since">Since 1.10</p>
@@ -428,67 +415,74 @@ The width of the canvas.
 <div class="refsect1">
 <a name="ClutterCanvas.signal-details"></a><h2>Signal Details</h2>
 <div class="refsect2">
-<a name="ClutterCanvas-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="ClutterCanvas.html" title="ClutterCanvas"><span class="type">ClutterCanvas</span></a> *canvas,
-                                                        <span class="type">CairoContext</span>  *cr,
-                                                        <span class="type">gint</span>           width,
-                                                        <span class="type">gint</span>           height,
-                                                        <span class="type">gpointer</span>       user_data)      : <code class="literal">No Recursion</code></pre>
-<p>
-The <a class="link" href="ClutterCanvas.html#ClutterCanvas-draw" title='The "draw" signal'><span class="type">"draw"</span></a> signal is emitted each time a canvas is
-invalidated.
-</p>
-<p>
-It is safe to connect multiple handlers to this signal: each
-handler invocation will be automatically protected by <a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-t.html#cairo-save"><code class="function">cairo_save()</code></a>
-and <a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-t.html#cairo-restore"><code class="function">cairo_restore()</code></a> pairs.
-</p>
-<div class="variablelist"><table border="0" class="variablelist">
+<a name="ClutterCanvas-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="ClutterCanvas.html" title="ClutterCanvas"><span class="type">ClutterCanvas</span></a> *canvas,
+               <span class="type">CairoContext</span>  *cr,
+               <span class="type">gint</span>           width,
+               <span class="type">gint</span>           height,
+               <span class="type">gpointer</span>       user_data)</pre>
+<p>The <a class="link" href="ClutterCanvas.html#ClutterCanvas-draw" title="The “draw” signal"><span class="type">“draw”</span></a> signal is emitted each time a canvas is
+invalidated.</p>
+<p>It is safe to connect multiple handlers to this signal: each
+handler invocation will be automatically protected by <code class="function">cairo_save()</code>
+and <code class="function">cairo_restore()</code> pairs.</p>
+<div class="refsect3">
+<a name="id-1.5.8.2.13.2.6"></a><h4>Parameters</h4>
+<div class="informaltable"><table width="100%" border="0">
 <colgroup>
-<col align="left" valign="top">
-<col>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
 </colgroup>
 <tbody>
 <tr>
-<td><p><span class="term"><em class="parameter"><code>canvas</code></em> :</span></p></td>
-<td>the <a class="link" href="ClutterCanvas.html" title="ClutterCanvas"><span class="type">ClutterCanvas</span></a> that emitted the signal</td>
+<td class="parameter_name"><p>canvas</p></td>
+<td class="parameter_description"><p>the <a class="link" href="ClutterCanvas.html" title="ClutterCanvas"><span class="type">ClutterCanvas</span></a> that emitted the signal</p></td>
+<td class="parameter_annotations"> </td>
 </tr>
 <tr>
-<td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
-<td>the Cairo context used to draw</td>
+<td class="parameter_name"><p>cr</p></td>
+<td class="parameter_description"><p>the Cairo context used to draw</p></td>
+<td class="parameter_annotations"> </td>
 </tr>
 <tr>
-<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td>
-<td>the width of the <em class="parameter"><code>canvas</code></em>
-</td>
-</tr>
-<tr>
-<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td>
-<td>the height of the <em class="parameter"><code>canvas</code></em>
-</td>
+<td class="parameter_name"><p>width</p></td>
+<td class="parameter_description"><p>the width of the <em class="parameter"><code>canvas</code></em>
+</p></td>
+<td class="parameter_annotations"> </td>
 </tr>
 <tr>
-<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
-<td>user data set when the signal handler was connected.</td>
+<td class="parameter_name"><p>height</p></td>
+<td class="parameter_description"><p>the height of the <em class="parameter"><code>canvas</code></em>
+</p></td>
+<td class="parameter_annotations"> </td>
 </tr>
 <tr>
-<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td>
-<code class="literal">TRUE</code> if the signal emission should stop, and
-<code class="literal">FALSE</code> otherwise</td>
+<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.5.8.2.13.2.7"></a><h4>Returns</h4>
+<p> <code class="literal">TRUE</code> if the signal emission should stop, and
+<code class="literal">FALSE</code> otherwise</p>
+<p></p>
+</div>
+<p>Flags: No Recursion</p>
 <p class="since">Since 1.10</p>
 </div>
 </div>
 <div class="refsect1">
 <a name="ClutterCanvas.see-also"></a><h2>See Also</h2>
-<a class="link" href="ClutterContent.html" title="ClutterContent"><span class="type">ClutterContent</span></a>
+<p><a class="link" href="ClutterContent.html" title="ClutterContent"><span class="type">ClutterContent</span></a></p>
 </div>
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.19.1</div>
+          Generated by GTK-Doc V1.20.1</div>
 </body>
 </html>