RubyGems - cairo - Versions diffs - 1.12.4-x86-mingw32 → 1.12.5-x86-mingw32 - Mend

cairo 1.12.4-x86-mingw32 → 1.12.5-x86-mingw32

Potentially problematic release.

This version of cairo might be problematic. Click here for more details.

Files changed (931) hide show

data/vendor/local/share/gtk-doc/html/cairo/cairo-XLib-XRender-Backend.html ADDED Viewed

@@ -0,0 +1,170 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>XLib-XRender Backend</title>
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
+<link rel="home" href="index.html" title="Cairo: A Vector Graphics Library">
+<link rel="up" href="cairo-surfaces.html" title="Surfaces">
+<link rel="prev" href="cairo-XLib-Surfaces.html" title="XLib Surfaces">
+<link rel="next" href="cairo-Script-Surfaces.html" title="Script Surfaces">
+<meta name="generator" content="GTK-Doc V1.18 (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="2">
+<tr valign="middle">
+<td><a accesskey="p" href="cairo-XLib-Surfaces.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
+<td><a accesskey="u" href="cairo-surfaces.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
+<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
+<th width="100%" align="center">Cairo: A Vector Graphics Library</th>
+<td><a accesskey="n" href="cairo-Script-Surfaces.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
+</tr>
+<tr><td colspan="5" class="shortcuts">
+<a href="#cairo-XLib-XRender-Backend.synopsis" class="shortcut">Top</a>
+                   |
+                  <a href="#cairo-XLib-XRender-Backend.description" class="shortcut">Description</a>
+</td></tr>
+</table>
+<div class="refentry">
+<a name="cairo-XLib-XRender-Backend"></a><div class="titlepage"></div>
+<div class="refnamediv"><table width="100%"><tr>
+<td valign="top">
+<h2><span class="refentrytitle"><a name="cairo-XLib-XRender-Backend.top_of_page"></a>XLib-XRender Backend</span></h2>
+<p>XLib-XRender Backend — X Window System rendering using XLib and the X Render extension</p>
+</td>
+<td valign="top" align="right"></td>
+</tr></table></div>
+<div class="refsynopsisdiv">
+<a name="cairo-XLib-XRender-Backend.synopsis"></a><h2>Synopsis</h2>
+<pre class="synopsis">#define             <a class="link" href="cairo-XLib-XRender-Backend.html#CAIRO-HAS-XLIB-XRENDER-SURFACE:CAPS" title="CAIRO_HAS_XLIB_XRENDER_SURFACE">CAIRO_HAS_XLIB_XRENDER_SURFACE</a>
+<a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="returnvalue">cairo_surface_t</span></a> *   <a class="link" href="cairo-XLib-XRender-Backend.html#cairo-xlib-surface-create-with-xrender-format" title="cairo_xlib_surface_create_with_xrender_format ()">cairo_xlib_surface_create_with_xrender_format</a>
+                                                        (<em class="parameter"><code><span class="type">Display</span> *dpy</code></em>,
+                                                         <em class="parameter"><code><span class="type">Drawable</span> drawable</code></em>,
+                                                         <em class="parameter"><code><span class="type">Screen</span> *screen</code></em>,
+                                                         <em class="parameter"><code><span class="type">XRenderPictFormat</span> *format</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>);
+<span class="returnvalue">XRenderPictFormat</span> * <a class="link" href="cairo-XLib-XRender-Backend.html#cairo-xlib-surface-get-xrender-format" title="cairo_xlib_surface_get_xrender_format ()">cairo_xlib_surface_get_xrender_format</a>
+                                                        (<em class="parameter"><code><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a> *surface</code></em>);
+</pre>
+</div>
+<div class="refsect1">
+<a name="cairo-XLib-XRender-Backend.description"></a><h2>Description</h2>
+<p>
+The XLib surface is used to render cairo graphics to X Window System
+windows and pixmaps using the XLib and Xrender libraries.
+</p>
+<p>
+Note that the XLib surface automatically takes advantage of X Render extension
+if it is available.
+</p>
+</div>
+<div class="refsect1">
+<a name="cairo-XLib-XRender-Backend.details"></a><h2>Details</h2>
+<div class="refsect2">
+<a name="CAIRO-HAS-XLIB-XRENDER-SURFACE:CAPS"></a><h3>CAIRO_HAS_XLIB_XRENDER_SURFACE</h3>
+<pre class="programlisting">#define CAIRO_HAS_XLIB_XRENDER_SURFACE 1
+</pre>
+<p>
+Defined if the XLib/XRender surface functions are available.
+This macro can be used to conditionally compile backend-specific code.
+</p>
+<p class="since">Since 1.6</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="cairo-xlib-surface-create-with-xrender-format"></a><h3>cairo_xlib_surface_create_with_xrender_format ()</h3>
+<pre class="programlisting"><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="returnvalue">cairo_surface_t</span></a> *   cairo_xlib_surface_create_with_xrender_format
+                                                        (<em class="parameter"><code><span class="type">Display</span> *dpy</code></em>,
+                                                         <em class="parameter"><code><span class="type">Drawable</span> drawable</code></em>,
+                                                         <em class="parameter"><code><span class="type">Screen</span> *screen</code></em>,
+                                                         <em class="parameter"><code><span class="type">XRenderPictFormat</span> *format</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>
+Creates an Xlib surface that draws to the given drawable.
+The way that colors are represented in the drawable is specified
+by the provided picture format.
+</p>
+<p>
+Note: If <em class="parameter"><code>drawable</code></em> is a Window, then the function
+<a class="link" href="cairo-XLib-Surfaces.html#cairo-xlib-surface-set-size" title="cairo_xlib_surface_set_size ()"><code class="function">cairo_xlib_surface_set_size()</code></a> must be called whenever the size of the
+window changes.
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>dpy</code></em> :</span></p></td>
+<td>an X Display</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>drawable</code></em> :</span></p></td>
+<td>an X Drawable, (a Pixmap or a Window)</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>screen</code></em> :</span></p></td>
+<td>the X Screen associated with <em class="parameter"><code>drawable</code></em>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
+<td>the picture format to use for drawing to <em class="parameter"><code>drawable</code></em>. The depth
+of <em class="parameter"><code>format</code></em> must match the depth of the drawable.</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td>
+<td>the current width of <em class="parameter"><code>drawable</code></em>.</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td>
+<td>the current height of <em class="parameter"><code>drawable</code></em>.</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the newly created surface</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 1.0</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="cairo-xlib-surface-get-xrender-format"></a><h3>cairo_xlib_surface_get_xrender_format ()</h3>
+<pre class="programlisting"><span class="returnvalue">XRenderPictFormat</span> * cairo_xlib_surface_get_xrender_format
+                                                        (<em class="parameter"><code><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a> *surface</code></em>);</pre>
+<p>
+Gets the X Render picture format that <em class="parameter"><code>surface</code></em> uses for rendering with the
+X Render extension. If the surface was created by
+<a class="link" href="cairo-XLib-XRender-Backend.html#cairo-xlib-surface-create-with-xrender-format" title="cairo_xlib_surface_create_with_xrender_format ()"><code class="function">cairo_xlib_surface_create_with_xrender_format()</code></a> originally, the return
+value is the format passed to that constructor.
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>surface</code></em> :</span></p></td>
+<td>an xlib surface</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the XRenderPictFormat* associated with <em class="parameter"><code>surface</code></em>,
+or <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the surface is not an xlib surface
+or if the X Render extension is not available.</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 1.6</p>
+</div>
+</div>
+<div class="refsect1">
+<a name="cairo-XLib-XRender-Backend.see-also"></a><h2>See Also</h2>
+<a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a>
+</div>
+</div>
+<div class="footer">
+<hr>
+          Generated by GTK-Doc V1.18</div>
+</body>
+</html>

data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-device-t.html CHANGED Viewed

@@ -3,12 +3,12 @@
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>cairo_device_t</title>
-<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
 <link rel="home" href="index.html" title="Cairo: A Vector Graphics Library">
 <link rel="up" href="cairo-surfaces.html" title="Surfaces">
 <link rel="prev" href="cairo-surfaces.html" title="Surfaces">
 <link rel="next" href="cairo-cairo-surface-t.html" title="cairo_surface_t">
-<meta name="generator" content="GTK-Doc V1.15 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -26,7 +26,7 @@
                   <a href="#cairo-cairo-device-t.description" class="shortcut">Description</a>
 </td></tr>
 </table>
-<div class="refentry" title="cairo_device_t">
+<div class="refentry">
 <a name="cairo-cairo-device-t"></a><div class="titlepage"></div>
 <div class="refnamediv"><table width="100%"><tr>
 <td valign="top">
@@ -35,7 +35,7 @@
 </td>
 <td valign="top" align="right"></td>
 </tr></table></div>
-<div class="refsynopsisdiv" title="Synopsis">
+<div class="refsynopsisdiv">
 <a name="cairo-cairo-device-t.synopsis"></a><h2>Synopsis</h2>
 <pre class="synopsis">typedef             <a class="link" href="cairo-cairo-device-t.html#cairo-device-t" title="cairo_device_t">cairo_device_t</a>;
 <a class="link" href="cairo-cairo-device-t.html#cairo-device-t" title="cairo_device_t"><span class="returnvalue">cairo_device_t</span></a> *    <a class="link" href="cairo-cairo-device-t.html#cairo-device-reference" title="cairo_device_reference ()">cairo_device_reference</a>              (<em class="parameter"><code><a class="link" href="cairo-cairo-device-t.html#cairo-device-t" title="cairo_device_t"><span class="type">cairo_device_t</span></a> *device</code></em>);
@@ -44,7 +44,7 @@
 <span class="returnvalue">void</span>                <a class="link" href="cairo-cairo-device-t.html#cairo-device-finish" title="cairo_device_finish ()">cairo_device_finish</a>                 (<em class="parameter"><code><a class="link" href="cairo-cairo-device-t.html#cairo-device-t" title="cairo_device_t"><span class="type">cairo_device_t</span></a> *device</code></em>);
 <span class="returnvalue">void</span>                <a class="link" href="cairo-cairo-device-t.html#cairo-device-flush" title="cairo_device_flush ()">cairo_device_flush</a>                  (<em class="parameter"><code><a class="link" href="cairo-cairo-device-t.html#cairo-device-t" title="cairo_device_t"><span class="type">cairo_device_t</span></a> *device</code></em>);
 enum                <a class="link" href="cairo-cairo-device-t.html#cairo-device-type-t" title="enum cairo_device_type_t">cairo_device_type_t</a>;
-<a class="link" href="cairo-cairo-device-t.html#cairo-device-type-t" title="enum cairo_device_type_t"><span class="returnvalue">cairo_device_type_t</span></a>  <a class="link" href="cairo-cairo-device-t.html#cairo-device-get-type" title="cairo_device_get_type ()">cairo_device_get_type</a>              (<em class="parameter"><code><a class="link" href="cairo-cairo-device-t.html#cairo-device-t" title="cairo_device_t"><span class="type">cairo_device_t</span></a> *device</code></em>);
+<a class="link" href="cairo-cairo-device-t.html#cairo-device-type-t" title="enum cairo_device_type_t"><span class="returnvalue">cairo_device_type_t</span></a> <a class="link" href="cairo-cairo-device-t.html#cairo-device-get-type" title="cairo_device_get_type ()">cairo_device_get_type</a>               (<em class="parameter"><code><a class="link" href="cairo-cairo-device-t.html#cairo-device-t" title="cairo_device_t"><span class="type">cairo_device_t</span></a> *device</code></em>);
 unsigned <span class="returnvalue">int</span>        <a class="link" href="cairo-cairo-device-t.html#cairo-device-get-reference-count" title="cairo_device_get_reference_count ()">cairo_device_get_reference_count</a>    (<em class="parameter"><code><a class="link" href="cairo-cairo-device-t.html#cairo-device-t" title="cairo_device_t"><span class="type">cairo_device_t</span></a> *device</code></em>);
 <a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="returnvalue">cairo_status_t</span></a>      <a class="link" href="cairo-cairo-device-t.html#cairo-device-set-user-data" title="cairo_device_set_user_data ()">cairo_device_set_user_data</a>          (<em class="parameter"><code><a class="link" href="cairo-cairo-device-t.html#cairo-device-t" title="cairo_device_t"><span class="type">cairo_device_t</span></a> *device</code></em>,
                                                          <em class="parameter"><code>const <a class="link" href="cairo-Types.html#cairo-user-data-key-t" title="cairo_user_data_key_t"><span class="type">cairo_user_data_key_t</span></a> *key</code></em>,
@@ -56,7 +56,7 @@ unsigned <span class="returnvalue">int</span>        <a class="link" href="cairo
 <span class="returnvalue">void</span>                <a class="link" href="cairo-cairo-device-t.html#cairo-device-release" title="cairo_device_release ()">cairo_device_release</a>                (<em class="parameter"><code><a class="link" href="cairo-cairo-device-t.html#cairo-device-t" title="cairo_device_t"><span class="type">cairo_device_t</span></a> *device</code></em>);
 </pre>
 </div>
-<div class="refsect1" title="Description">
+<div class="refsect1">
 <a name="cairo-cairo-device-t.description"></a><h2>Description</h2>
 <p>
 Devices are the abstraction Cairo employs for the rendering system
@@ -85,33 +85,60 @@ be used by applications.
 Putting this all together, a function that works with devices should
 look something like this:
 </p>
-<div class="informalexample"><pre class="programlisting">
-void
-my_device_modifying_function (cairo_device_t *device)
-{
-  cairo_status_t status;
+<div class="informalexample">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1
+2
+3
+4
+5
+6
+7
+8
+9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">void</span>
+<span class="function">my_device_modifying_function</span> <span class="gtkdoc opt">(</span>cairo_device_t <span class="gtkdoc opt">*</span>device<span class="gtkdoc opt">)</span>
+<span class="gtkdoc opt">{</span>
+  cairo_status_t status<span class="gtkdoc opt">;</span>
-  // Ensure the device is properly reset
-  cairo_device_flush (device);
-  // Try to acquire the device
-  status = cairo_device_acquire (device);
-  if (status != CAIRO_STATUS_SUCCESS) {
-    printf ("Failed to acquire the device: %s\n", cairo_status_to_string (status));
-    return;
-  }
+  <span class="gtkdoc slc">// Ensure the device is properly reset</span>
+  <span class="function"><a href="../cairo/cairo-cairo-device-t.html#cairo-device-flush">cairo_device_flush</a></span> <span class="gtkdoc opt">(</span>device<span class="gtkdoc opt">);</span>
+  <span class="gtkdoc slc">// Try to acquire the device</span>
+  status <span class="gtkdoc opt">=</span> <span class="function"><a href="../cairo/cairo-cairo-device-t.html#cairo-device-acquire">cairo_device_acquire</a></span> <span class="gtkdoc opt">(</span>device<span class="gtkdoc opt">);</span>
+  <span class="keyword">if</span> <span class="gtkdoc opt">(</span>status <span class="gtkdoc opt">!=</span> CAIRO_STATUS_SUCCESS<span class="gtkdoc opt">) {</span>
+    <span class="function">printf</span> <span class="gtkdoc opt">(</span><span class="string">&quot;Failed to acquire the device: %s</span><span class="gtkdoc esc">\n</span><span class="string">&quot;</span><span class="gtkdoc opt">,</span> <span class="function"><a href="../cairo/cairo-Error-handling.html#cairo-status-to-string">cairo_status_to_string</a></span> <span class="gtkdoc opt">(</span>status<span class="gtkdoc opt">));</span>
+    <span class="keyword">return</span><span class="gtkdoc opt">;</span>
+  <span class="gtkdoc opt">}</span>
-  // Do the custom operations on the device here.
-  // But do not call any Cairo functions that might acquire devices.
+  <span class="gtkdoc slc">// Do the custom operations on the device here.</span>
+  <span class="gtkdoc slc">// But do not call any Cairo functions that might acquire devices.</span>
-  // Release the device when done.
-  cairo_device_release (device);
-}
-</pre></div>
+  <span class="gtkdoc slc">// Release the device when done.</span>
+  <span class="function"><a href="../cairo/cairo-cairo-device-t.html#cairo-device-release">cairo_device_release</a></span> <span class="gtkdoc opt">(</span>device<span class="gtkdoc opt">);</span>
+<span class="gtkdoc opt">}</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
 <p>
 </p>
 <p>
 </p>
-<div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
+<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
 <h3 class="title">Note</h3>
 <p>Please refer to the documentation of each backend for
 additional usage requirements, guarantees provided, and
@@ -122,9 +149,9 @@ surfaces of that type.
 <p>
 </p>
 </div>
-<div class="refsect1" title="Details">
+<div class="refsect1">
 <a name="cairo-cairo-device-t.details"></a><h2>Details</h2>
-<div class="refsect2" title="cairo_device_t">
+<div class="refsect2">
 <a name="cairo-device-t"></a><h3>cairo_device_t</h3>
 <pre class="programlisting">typedef struct _cairo_device cairo_device_t;
 </pre>
@@ -132,8 +159,8 @@ surfaces of that type.
 A <a class="link" href="cairo-cairo-device-t.html#cairo-device-t" title="cairo_device_t"><span class="type">cairo_device_t</span></a> represents the driver interface for drawing
 operations to a <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a>.  There are different subtypes of
 <a class="link" href="cairo-cairo-device-t.html#cairo-device-t" title="cairo_device_t"><span class="type">cairo_device_t</span></a> for different drawing backends; for example,
-<code class="function">cairo_xcb_device_create()</code> creates a device that wraps the connection
-to an X Windows System using the XCB library.
+<code class="function">cairo_egl_device_create()</code> creates a device that wraps an EGL display and
+context.
 </p>
 <p>
 The type of a device can be queried with <a class="link" href="cairo-cairo-device-t.html#cairo-device-get-type" title="cairo_device_get_type ()"><code class="function">cairo_device_get_type()</code></a>.
@@ -145,7 +172,7 @@ Memory management of <a class="link" href="cairo-cairo-device-t.html#cairo-devic
 <p class="since">Since 1.10</p>
 </div>
 <hr>
-<div class="refsect2" title="cairo_device_reference ()">
+<div class="refsect2">
 <a name="cairo-device-reference"></a><h3>cairo_device_reference ()</h3>
 <pre class="programlisting"><a class="link" href="cairo-cairo-device-t.html#cairo-device-t" title="cairo_device_t"><span class="returnvalue">cairo_device_t</span></a> *    cairo_device_reference              (<em class="parameter"><code><a class="link" href="cairo-cairo-device-t.html#cairo-device-t" title="cairo_device_t"><span class="type">cairo_device_t</span></a> *device</code></em>);</pre>
 <p>
@@ -167,16 +194,14 @@ The number of references to a <a class="link" href="cairo-cairo-device-t.html#ca
 </tr>
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td> the referenced <a class="link" href="cairo-cairo-device-t.html#cairo-device-t" title="cairo_device_t"><span class="type">cairo_device_t</span></a>.
-</td>
+<td>the referenced <a class="link" href="cairo-cairo-device-t.html#cairo-device-t" title="cairo_device_t"><span class="type">cairo_device_t</span></a>.</td>
 </tr>
 </tbody>
 </table></div>
 <p class="since">Since 1.10</p>
 </div>
 <hr>
-<div class="refsect2" title="cairo_device_destroy ()">
+<div class="refsect2">
 <a name="cairo-device-destroy"></a><h3>cairo_device_destroy ()</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>                cairo_device_destroy                (<em class="parameter"><code><a class="link" href="cairo-cairo-device-t.html#cairo-device-t" title="cairo_device_t"><span class="type">cairo_device_t</span></a> *device</code></em>);</pre>
 <p>
@@ -198,7 +223,7 @@ This function may acquire devices if the last reference was dropped.
 <p class="since">Since 1.10</p>
 </div>
 <hr>
-<div class="refsect2" title="cairo_device_status ()">
+<div class="refsect2">
 <a name="cairo-device-status"></a><h3>cairo_device_status ()</h3>
 <pre class="programlisting"><a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="returnvalue">cairo_status_t</span></a>      cairo_device_status                 (<em class="parameter"><code><a class="link" href="cairo-cairo-device-t.html#cairo-device-t" title="cairo_device_t"><span class="type">cairo_device_t</span></a> *device</code></em>);</pre>
 <p>
@@ -215,17 +240,16 @@ device.
 </tr>
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td> <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-SUCCESS:CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> on success or an error code if
-              the device is in an error state.
-</td>
+<td>
+<a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-SUCCESS:CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> on success or an error code if
+the device is in an error state.</td>
 </tr>
 </tbody>
 </table></div>
 <p class="since">Since 1.10</p>
 </div>
 <hr>
-<div class="refsect2" title="cairo_device_finish ()">
+<div class="refsect2">
 <a name="cairo-device-finish"></a><h3>cairo_device_finish ()</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>                cairo_device_finish                 (<em class="parameter"><code><a class="link" href="cairo-cairo-device-t.html#cairo-device-t" title="cairo_device_t"><span class="type">cairo_device_t</span></a> *device</code></em>);</pre>
 <p>
@@ -233,7 +257,7 @@ This function finishes the device and drops all references to
 external resources. All surfaces, fonts and other objects created
 for this <em class="parameter"><code>device</code></em> will be finished, too.
 Further operations on the <em class="parameter"><code>device</code></em> will not affect the <em class="parameter"><code>device</code></em> but
-will instead trigger a <code class="literal">CAIRO_STATUS_DEVICE_FINISHED</code> error.
+will instead trigger a <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-DEVICE-FINISHED:CAPS"><code class="literal">CAIRO_STATUS_DEVICE_FINISHED</code></a> error.
 </p>
 <p>
 When the last call to <a class="link" href="cairo-cairo-device-t.html#cairo-device-destroy" title="cairo_device_destroy ()"><code class="function">cairo_device_destroy()</code></a> decreases the
@@ -248,14 +272,13 @@ This function may acquire devices.
 <col align="left" valign="top">
 <tbody><tr>
 <td><p><span class="term"><em class="parameter"><code>device</code></em> :</span></p></td>
-<td>the <a class="link" href="cairo-cairo-device-t.html#cairo-device-t" title="cairo_device_t"><span class="type">cairo_device_t</span></a> to finish
-</td>
+<td>the <a class="link" href="cairo-cairo-device-t.html#cairo-device-t" title="cairo_device_t"><span class="type">cairo_device_t</span></a> to finish</td>
 </tr></tbody>
 </table></div>
 <p class="since">Since 1.10</p>
 </div>
 <hr>
-<div class="refsect2" title="cairo_device_flush ()">
+<div class="refsect2">
 <a name="cairo-device-flush"></a><h3>cairo_device_flush ()</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>                cairo_device_flush                  (<em class="parameter"><code><a class="link" href="cairo-cairo-device-t.html#cairo-device-t" title="cairo_device_t"><span class="type">cairo_device_t</span></a> *device</code></em>);</pre>
 <p>
@@ -280,15 +303,19 @@ This function may acquire devices.
 <p class="since">Since 1.10</p>
 </div>
 <hr>
-<div class="refsect2" title="enum cairo_device_type_t">
+<div class="refsect2">
 <a name="cairo-device-type-t"></a><h3>enum cairo_device_type_t</h3>
-<pre class="programlisting">typedef enum _cairo_device_type {
+<pre class="programlisting">typedef enum {
     CAIRO_DEVICE_TYPE_DRM,
     CAIRO_DEVICE_TYPE_GL,
     CAIRO_DEVICE_TYPE_SCRIPT,
     CAIRO_DEVICE_TYPE_XCB,
     CAIRO_DEVICE_TYPE_XLIB,
-    CAIRO_DEVICE_TYPE_XML
+    CAIRO_DEVICE_TYPE_XML,
+    CAIRO_DEVICE_TYPE_COGL,
+    CAIRO_DEVICE_TYPE_WIN32,
+    CAIRO_DEVICE_TYPE_INVALID = -1
 } cairo_device_type_t;
 </pre>
 <p>
@@ -299,14 +326,15 @@ device. The devices types are also known as "backends" within cairo.
 The device type can be queried with <a class="link" href="cairo-cairo-device-t.html#cairo-device-get-type" title="cairo_device_get_type ()"><code class="function">cairo_device_get_type()</code></a>
 </p>
 <p>
-The various <a class="link" href="cairo-cairo-device-t.html#cairo-device-t" title="cairo_device_t"><span class="type">cairo_device_t</span></a> functions can be used with surfaces of
+The various <a class="link" href="cairo-cairo-device-t.html#cairo-device-t" title="cairo_device_t"><span class="type">cairo_device_t</span></a> functions can be used with devices of
 any type, but some backends also provide type-specific functions
 that must only be called with a device of the appropriate
 type. These functions have names that begin with
-cairo_<span class="emphasis"><em>type</em></span>_device such as <code class="function">cairo_xcb_device_debug_set_render_version()</code>.
+<code class="literal">cairo_<span class="emphasis"><em>type</em></span>_device</code> such as
+<a class="link" href="cairo-XCB-Surfaces.html#cairo-xcb-device-debug-cap-xrender-version" title="cairo_xcb_device_debug_cap_xrender_version ()"><code class="function">cairo_xcb_device_debug_cap_xrender_version()</code></a>.
 </p>
 <p>
-The behavior of calling a type-specific function with a surface of
+The behavior of calling a type-specific function with a device of
 the wrong type is undefined.
 </p>
 <p>
@@ -317,33 +345,47 @@ New entries may be added in future versions.
 <tbody>
 <tr>
 <td><p><a name="CAIRO-DEVICE-TYPE-DRM:CAPS"></a><span class="term"><code class="literal">CAIRO_DEVICE_TYPE_DRM</code></span></p></td>
-<td>The surface is of type Direct Render Manager
+<td>The device is of type Direct Render Manager, since 1.10
 </td>
 </tr>
 <tr>
 <td><p><a name="CAIRO-DEVICE-TYPE-GL:CAPS"></a><span class="term"><code class="literal">CAIRO_DEVICE_TYPE_GL</code></span></p></td>
-<td>The surface is of type OpenGL
+<td>The device is of type OpenGL, since 1.10
 </td>
 </tr>
 <tr>
 <td><p><a name="CAIRO-DEVICE-TYPE-SCRIPT:CAPS"></a><span class="term"><code class="literal">CAIRO_DEVICE_TYPE_SCRIPT</code></span></p></td>
-<td>The surface is of type script
+<td>The device is of type script, since 1.10
 </td>
 </tr>
 <tr>
 <td><p><a name="CAIRO-DEVICE-TYPE-XCB:CAPS"></a><span class="term"><code class="literal">CAIRO_DEVICE_TYPE_XCB</code></span></p></td>
-<td>The surface is of type xcb
+<td>The device is of type xcb, since 1.10
 </td>
 </tr>
 <tr>
 <td><p><a name="CAIRO-DEVICE-TYPE-XLIB:CAPS"></a><span class="term"><code class="literal">CAIRO_DEVICE_TYPE_XLIB</code></span></p></td>
-<td>The surface is of type xlib
+<td>The device is of type xlib, since 1.10
 </td>
 </tr>
 <tr>
 <td><p><a name="CAIRO-DEVICE-TYPE-XML:CAPS"></a><span class="term"><code class="literal">CAIRO_DEVICE_TYPE_XML</code></span></p></td>
-<td>The surface is of type XML
-  <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-create-for-rectangle" title="cairo_surface_create_for_rectangle ()"><code class="function">cairo_surface_create_for_rectangle()</code></a>
+<td>The device is of type XML, since 1.10
+</td>
+</tr>
+<tr>
+<td><p><a name="CAIRO-DEVICE-TYPE-COGL:CAPS"></a><span class="term"><code class="literal">CAIRO_DEVICE_TYPE_COGL</code></span></p></td>
+<td>The device is of type cogl, since 1.12
+</td>
+</tr>
+<tr>
+<td><p><a name="CAIRO-DEVICE-TYPE-WIN32:CAPS"></a><span class="term"><code class="literal">CAIRO_DEVICE_TYPE_WIN32</code></span></p></td>
+<td>The device is of type win32, since 1.12
+</td>
+</tr>
+<tr>
+<td><p><a name="CAIRO-DEVICE-TYPE-INVALID:CAPS"></a><span class="term"><code class="literal">CAIRO_DEVICE_TYPE_INVALID</code></span></p></td>
+<td>The device is invalid, since 1.10
 </td>
 </tr>
 </tbody>
@@ -351,9 +393,9 @@ New entries may be added in future versions.
 <p class="since">Since 1.10</p>
 </div>
 <hr>
-<div class="refsect2" title="cairo_device_get_type ()">
+<div class="refsect2">
 <a name="cairo-device-get-type"></a><h3>cairo_device_get_type ()</h3>
-<pre class="programlisting"><a class="link" href="cairo-cairo-device-t.html#cairo-device-type-t" title="enum cairo_device_type_t"><span class="returnvalue">cairo_device_type_t</span></a>  cairo_device_get_type              (<em class="parameter"><code><a class="link" href="cairo-cairo-device-t.html#cairo-device-t" title="cairo_device_t"><span class="type">cairo_device_t</span></a> *device</code></em>);</pre>
+<pre class="programlisting"><a class="link" href="cairo-cairo-device-t.html#cairo-device-type-t" title="enum cairo_device_type_t"><span class="returnvalue">cairo_device_type_t</span></a> cairo_device_get_type               (<em class="parameter"><code><a class="link" href="cairo-cairo-device-t.html#cairo-device-t" title="cairo_device_t"><span class="type">cairo_device_t</span></a> *device</code></em>);</pre>
 <p>
 This function returns the type of the device. See <a class="link" href="cairo-cairo-device-t.html#cairo-device-type-t" title="enum cairo_device_type_t"><span class="type">cairo_device_type_t</span></a>
 for available types.
@@ -368,16 +410,14 @@ for available types.
 </tr>
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td> The type of <em class="parameter"><code>device</code></em>.
-</td>
+<td>The type of <em class="parameter"><code>device</code></em>.</td>
 </tr>
 </tbody>
 </table></div>
 <p class="since">Since 1.10</p>
 </div>
 <hr>
-<div class="refsect2" title="cairo_device_get_reference_count ()">
+<div class="refsect2">
 <a name="cairo-device-get-reference-count"></a><h3>cairo_device_get_reference_count ()</h3>
 <pre class="programlisting">unsigned <span class="returnvalue">int</span>        cairo_device_get_reference_count    (<em class="parameter"><code><a class="link" href="cairo-cairo-device-t.html#cairo-device-t" title="cairo_device_t"><span class="type">cairo_device_t</span></a> *device</code></em>);</pre>
 <p>
@@ -393,17 +433,15 @@ Returns the current reference count of <em class="parameter"><code>device</code>
 </tr>
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td> the current reference count of <em class="parameter"><code>device</code></em>.  If the
-object is a nil object, 0 will be returned.
-</td>
+<td>the current reference count of <em class="parameter"><code>device</code></em>.  If the
+object is a nil object, 0 will be returned.</td>
 </tr>
 </tbody>
 </table></div>
 <p class="since">Since 1.10</p>
 </div>
 <hr>
-<div class="refsect2" title="cairo_device_set_user_data ()">
+<div class="refsect2">
 <a name="cairo-device-set-user-data"></a><h3>cairo_device_set_user_data ()</h3>
 <pre class="programlisting"><a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="returnvalue">cairo_status_t</span></a>      cairo_device_set_user_data          (<em class="parameter"><code><a class="link" href="cairo-cairo-device-t.html#cairo-device-t" title="cairo_device_t"><span class="type">cairo_device_t</span></a> *device</code></em>,
                                                          <em class="parameter"><code>const <a class="link" href="cairo-Types.html#cairo-user-data-key-t" title="cairo_user_data_key_t"><span class="type">cairo_user_data_key_t</span></a> *key</code></em>,
@@ -411,7 +449,7 @@ object is a nil object, 0 will be returned.
                                                          <em class="parameter"><code><a class="link" href="cairo-Types.html#cairo-destroy-func-t" title="cairo_destroy_func_t ()"><span class="type">cairo_destroy_func_t</span></a> destroy</code></em>);</pre>
 <p>
 Attach user data to <em class="parameter"><code>device</code></em>.  To remove user data from a surface,
-call this function with the key that was used to set it and <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
+call this function with the key that was used to set it and <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
 for <em class="parameter"><code>data</code></em>.
 </p>
 <div class="variablelist"><table border="0">
@@ -424,8 +462,7 @@ for <em class="parameter"><code>data</code></em>.
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
-<td>the address of a <a class="link" href="cairo-Types.html#cairo-user-data-key-t" title="cairo_user_data_key_t"><span class="type">cairo_user_data_key_t</span></a> to attach the user data to
-</td>
+<td>the address of a <a class="link" href="cairo-Types.html#cairo-user-data-key-t" title="cairo_user_data_key_t"><span class="type">cairo_user_data_key_t</span></a> to attach the user data to</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
@@ -436,29 +473,27 @@ for <em class="parameter"><code>data</code></em>.
 <td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
 <td>a <a class="link" href="cairo-Types.html#cairo-destroy-func-t" title="cairo_destroy_func_t ()"><span class="type">cairo_destroy_func_t</span></a> which will be called when the
 <a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> is destroyed or when new user data is attached using the
-same key.
-</td>
+same key.</td>
 </tr>
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td> <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-SUCCESS:CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> or <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-NO-MEMORY:CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a> if a
-slot could not be allocated for the user data.
-</td>
+<td>
+<a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-SUCCESS:CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> or <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-NO-MEMORY:CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a> if a
+slot could not be allocated for the user data.</td>
 </tr>
 </tbody>
 </table></div>
 <p class="since">Since 1.10</p>
 </div>
 <hr>
-<div class="refsect2" title="cairo_device_get_user_data ()">
+<div class="refsect2">
 <a name="cairo-device-get-user-data"></a><h3>cairo_device_get_user_data ()</h3>
 <pre class="programlisting"><span class="returnvalue">void</span> *              cairo_device_get_user_data          (<em class="parameter"><code><a class="link" href="cairo-cairo-device-t.html#cairo-device-t" title="cairo_device_t"><span class="type">cairo_device_t</span></a> *device</code></em>,
                                                          <em class="parameter"><code>const <a class="link" href="cairo-Types.html#cairo-user-data-key-t" title="cairo_user_data_key_t"><span class="type">cairo_user_data_key_t</span></a> *key</code></em>);</pre>
 <p>
 Return user data previously attached to <em class="parameter"><code>device</code></em> using the
 specified key.  If no user data has been attached with the given
-key this function returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
+key this function returns <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
 </p>
 <div class="variablelist"><table border="0">
 <col align="left" valign="top">
@@ -471,21 +506,18 @@ key this function returns <a href="http://library.gnome.org/devel/glib/unstable/
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
 <td>the address of the <a class="link" href="cairo-Types.html#cairo-user-data-key-t" title="cairo_user_data_key_t"><span class="type">cairo_user_data_key_t</span></a> the user data was
-attached to
-</td>
+attached to</td>
 </tr>
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td> the user data previously attached or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
-</td>
+<td>the user data previously attached or <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>
 </tr>
 </tbody>
 </table></div>
 <p class="since">Since 1.10</p>
 </div>
 <hr>
-<div class="refsect2" title="cairo_device_acquire ()">
+<div class="refsect2">
 <a name="cairo-device-acquire"></a><h3>cairo_device_acquire ()</h3>
 <pre class="programlisting"><a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="returnvalue">cairo_status_t</span></a>      cairo_device_acquire                (<em class="parameter"><code><a class="link" href="cairo-cairo-device-t.html#cairo-device-t" title="cairo_device_t"><span class="type">cairo_device_t</span></a> *device</code></em>);</pre>
 <p>
@@ -501,7 +533,7 @@ thread.
 </p>
 <p>
 </p>
-<div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
+<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
 <h3 class="title">Note</h3>
 <p>You must never acquire two different devices at the same time
 unless this is explicitly allowed. Otherwise the possibility of deadlocks
@@ -526,19 +558,18 @@ marked in the documentation.
 </tr>
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td> <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-SUCCESS:CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> on success or an error code if
-              the device is in an error state and could not be
-              acquired. After a successful call to <a class="link" href="cairo-cairo-device-t.html#cairo-device-acquire" title="cairo_device_acquire ()"><code class="function">cairo_device_acquire()</code></a>,
-              a matching call to <a class="link" href="cairo-cairo-device-t.html#cairo-device-release" title="cairo_device_release ()"><code class="function">cairo_device_release()</code></a> is required.
-</td>
+<td>
+<a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-SUCCESS:CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> on success or an error code if
+the device is in an error state and could not be
+acquired. After a successful call to <a class="link" href="cairo-cairo-device-t.html#cairo-device-acquire" title="cairo_device_acquire ()"><code class="function">cairo_device_acquire()</code></a>,
+a matching call to <a class="link" href="cairo-cairo-device-t.html#cairo-device-release" title="cairo_device_release ()"><code class="function">cairo_device_release()</code></a> is required.</td>
 </tr>
 </tbody>
 </table></div>
 <p class="since">Since 1.10</p>
 </div>
 <hr>
-<div class="refsect2" title="cairo_device_release ()">
+<div class="refsect2">
 <a name="cairo-device-release"></a><h3>cairo_device_release ()</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>                cairo_device_release                (<em class="parameter"><code><a class="link" href="cairo-cairo-device-t.html#cairo-device-t" title="cairo_device_t"><span class="type">cairo_device_t</span></a> *device</code></em>);</pre>
 <p>
@@ -556,13 +587,13 @@ that function for details.
 <p class="since">Since 1.10</p>
 </div>
 </div>
-<div class="refsect1" title="See Also">
+<div class="refsect1">
 <a name="cairo-cairo-device-t.see-also"></a><h2>See Also</h2>
 <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a>
 </div>
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.15</div>
+          Generated by GTK-Doc V1.18</div>
 </body>
 </html>