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

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

Files changed (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>