RubyGems - rsvg2 - Versions diffs - 2.0.2-x86-mingw32 → 2.0.3-x86-mingw32 - Mend

rsvg2 2.0.2-x86-mingw32 → 2.0.3-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 (370) hide show

data/vendor/local/share/gtk-doc/html/rsvg-2.0/rsvg-Using-RSVG-with-GdkPixbuf.html ADDED

@@ -0,0 +1,386 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>Using RSVG with GdkPixbuf</title>
+<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
+<link rel="home" href="index.html" title="RSVG Libary Reference Manual">
+<link rel="up" href="rsvg.html" title="Part I. API Reference">
+<link rel="prev" href="rsvg-Using-RSVG-with-cairo.html" title="Using RSVG with cairo">
+<link rel="next" href="rsvg-Version-check-and-feature-tests.html" title="Version check and feature tests">
+<meta name="generator" content="GTK-Doc V1.19 (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="rsvg-Using-RSVG-with-cairo.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
+<td><a accesskey="u" href="rsvg.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">RSVG Libary Reference Manual</th>
+<td><a accesskey="n" href="rsvg-Version-check-and-feature-tests.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
+</tr>
+<tr><td colspan="5" class="shortcuts">
+<a href="#rsvg-Using-RSVG-with-GdkPixbuf.synopsis" class="shortcut">Top</a>
+                   |
+                  <a href="#rsvg-Using-RSVG-with-GdkPixbuf.description" class="shortcut">Description</a>
+</td></tr>
+</table>
+<div class="refentry">
+<a name="rsvg-Using-RSVG-with-GdkPixbuf"></a><div class="titlepage"></div>
+<div class="refnamediv"><table width="100%"><tr>
+<td valign="top">
+<h2><span class="refentrytitle"><a name="rsvg-Using-RSVG-with-GdkPixbuf.top_of_page"></a>Using RSVG with GdkPixbuf</span></h2>
+<p>Using RSVG with GdkPixbuf — How to render SVGs into GdkPixbufs, for easy use in GTK+
+ applications</p>
+</td>
+<td valign="top" align="right"></td>
+</tr></table></div>
+<div class="refsynopsisdiv">
+<a name="rsvg-Using-RSVG-with-GdkPixbuf.synopsis"></a><h2>Synopsis</h2>
+<pre class="synopsis"><span class="returnvalue">GdkPixbuf</span> *         <a class="link" href="rsvg-Using-RSVG-with-GdkPixbuf.html#rsvg-handle-get-pixbuf" title="rsvg_handle_get_pixbuf ()">rsvg_handle_get_pixbuf</a>              (<em class="parameter"><code><a class="link" href="RsvgHandle.html" title="RsvgHandle"><span class="type">RsvgHandle</span></a> *handle</code></em>);
+<span class="returnvalue">GdkPixbuf</span> *         <a class="link" href="rsvg-Using-RSVG-with-GdkPixbuf.html#rsvg-handle-get-pixbuf-sub" title="rsvg_handle_get_pixbuf_sub ()">rsvg_handle_get_pixbuf_sub</a>          (<em class="parameter"><code><a class="link" href="RsvgHandle.html" title="RsvgHandle"><span class="type">RsvgHandle</span></a> *handle</code></em>,
+                                                         <em class="parameter"><code>const <span class="type">char</span> *id</code></em>);
+<span class="returnvalue">GdkPixbuf</span> *         <a class="link" href="rsvg-Using-RSVG-with-GdkPixbuf.html#rsvg-pixbuf-from-file" title="rsvg_pixbuf_from_file ()">rsvg_pixbuf_from_file</a>               (<em class="parameter"><code>const <span class="type">gchar</span> *file_name</code></em>,
+                                                         <em class="parameter"><code><span class="type">GError</span> **error</code></em>);
+<span class="returnvalue">GdkPixbuf</span> *         <a class="link" href="rsvg-Using-RSVG-with-GdkPixbuf.html#rsvg-pixbuf-from-file-at-zoom" title="rsvg_pixbuf_from_file_at_zoom ()">rsvg_pixbuf_from_file_at_zoom</a>       (<em class="parameter"><code>const <span class="type">gchar</span> *file_name</code></em>,
+                                                         <em class="parameter"><code><span class="type">double</span> x_zoom</code></em>,
+                                                         <em class="parameter"><code><span class="type">double</span> y_zoom</code></em>,
+                                                         <em class="parameter"><code><span class="type">GError</span> **error</code></em>);
+<span class="returnvalue">GdkPixbuf</span> *         <a class="link" href="rsvg-Using-RSVG-with-GdkPixbuf.html#rsvg-pixbuf-from-file-at-size" title="rsvg_pixbuf_from_file_at_size ()">rsvg_pixbuf_from_file_at_size</a>       (<em class="parameter"><code>const <span class="type">gchar</span> *file_name</code></em>,
+                                                         <em class="parameter"><code><span class="type">gint</span> width</code></em>,
+                                                         <em class="parameter"><code><span class="type">gint</span> height</code></em>,
+                                                         <em class="parameter"><code><span class="type">GError</span> **error</code></em>);
+<span class="returnvalue">GdkPixbuf</span> *         <a class="link" href="rsvg-Using-RSVG-with-GdkPixbuf.html#rsvg-pixbuf-from-file-at-max-size" title="rsvg_pixbuf_from_file_at_max_size ()">rsvg_pixbuf_from_file_at_max_size</a>   (<em class="parameter"><code>const <span class="type">gchar</span> *file_name</code></em>,
+                                                         <em class="parameter"><code><span class="type">gint</span> max_width</code></em>,
+                                                         <em class="parameter"><code><span class="type">gint</span> max_height</code></em>,
+                                                         <em class="parameter"><code><span class="type">GError</span> **error</code></em>);
+<span class="returnvalue">GdkPixbuf</span> *         <a class="link" href="rsvg-Using-RSVG-with-GdkPixbuf.html#rsvg-pixbuf-from-file-at-zoom-with-max" title="rsvg_pixbuf_from_file_at_zoom_with_max ()">rsvg_pixbuf_from_file_at_zoom_with_max</a>
+                                                        (<em class="parameter"><code>const <span class="type">gchar</span> *file_name</code></em>,
+                                                         <em class="parameter"><code><span class="type">double</span> x_zoom</code></em>,
+                                                         <em class="parameter"><code><span class="type">double</span> y_zoom</code></em>,
+                                                         <em class="parameter"><code><span class="type">gint</span> max_width</code></em>,
+                                                         <em class="parameter"><code><span class="type">gint</span> max_height</code></em>,
+                                                         <em class="parameter"><code><span class="type">GError</span> **error</code></em>);
+</pre>
+</div>
+<div class="refsect1">
+<a name="rsvg-Using-RSVG-with-GdkPixbuf.description"></a><h2>Description</h2>
+<p>
+GdkPixbuf is a library for image loading and manipulation. It is part of the
+cross-platform GTK+ widget toolkit.
+</p>
+</div>
+<div class="refsect1">
+<a name="rsvg-Using-RSVG-with-GdkPixbuf.details"></a><h2>Details</h2>
+<div class="refsect2">
+<a name="rsvg-handle-get-pixbuf"></a><h3>rsvg_handle_get_pixbuf ()</h3>
+<pre class="programlisting"><span class="returnvalue">GdkPixbuf</span> *         rsvg_handle_get_pixbuf              (<em class="parameter"><code><a class="link" href="RsvgHandle.html" title="RsvgHandle"><span class="type">RsvgHandle</span></a> *handle</code></em>);</pre>
+<p>
+Returns the pixbuf loaded by <span class="type">handle</span>.  The pixbuf returned will be reffed, so
+the caller of this function must assume that ref.  If insufficient data has
+been read to create the pixbuf, or an error occurred in loading, then <code class="literal">NULL</code>
+will be returned.  Note that the pixbuf may not be complete until
+<em class="parameter"><code>rsvg_handle_close</code></em> has been called.
+</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="parameter"><code>handle</code></em> :</span></p></td>
+<td>An <a class="link" href="RsvgHandle.html" title="RsvgHandle"><span class="type">RsvgHandle</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the pixbuf loaded by <span class="type">handle</span>, or <code class="literal">NULL</code>. <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>
+</div>
+<hr>
+<div class="refsect2">
+<a name="rsvg-handle-get-pixbuf-sub"></a><h3>rsvg_handle_get_pixbuf_sub ()</h3>
+<pre class="programlisting"><span class="returnvalue">GdkPixbuf</span> *         rsvg_handle_get_pixbuf_sub          (<em class="parameter"><code><a class="link" href="RsvgHandle.html" title="RsvgHandle"><span class="type">RsvgHandle</span></a> *handle</code></em>,
+                                                         <em class="parameter"><code>const <span class="type">char</span> *id</code></em>);</pre>
+<p>
+Returns the pixbuf loaded by <span class="type">handle</span>.  The pixbuf returned will be reffed, so
+the caller of this function must assume that ref.  If insufficient data has
+been read to create the pixbuf, or an error occurred in loading, then <code class="literal">NULL</code>
+will be returned.  Note that the pixbuf may not be complete until
+<em class="parameter"><code>rsvg_handle_close</code></em> has been called.
+</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="parameter"><code>handle</code></em> :</span></p></td>
+<td>An <a class="link" href="RsvgHandle.html" title="RsvgHandle"><span class="type">RsvgHandle</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>id</code></em> :</span></p></td>
+<td>The id of an element inside the SVG, or <code class="literal">NULL</code> to render the whole SVG. For
+example, if you have a layer called "layer1" that you wish to render, pass
+"#<span class="type">layer1</span>" as the id.</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the pixbuf loaded by <span class="type">handle</span>, or <code class="literal">NULL</code>. <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 2.14</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="rsvg-pixbuf-from-file"></a><h3>rsvg_pixbuf_from_file ()</h3>
+<pre class="programlisting"><span class="returnvalue">GdkPixbuf</span> *         rsvg_pixbuf_from_file               (<em class="parameter"><code>const <span class="type">gchar</span> *file_name</code></em>,
+                                                         <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
+<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
+<h3 class="title">Warning</h3>
+<p><code class="literal">rsvg_pixbuf_from_file</code> is deprecated and should not be used in newly-written code. Set up a cairo matrix and use <a class="link" href="RsvgHandle.html#rsvg-handle-new-from-file" title="rsvg_handle_new_from_file ()"><code class="function">rsvg_handle_new_from_file()</code></a> + <a class="link" href="rsvg-Using-RSVG-with-cairo.html#rsvg-handle-render-cairo" title="rsvg_handle_render_cairo ()"><code class="function">rsvg_handle_render_cairo()</code></a> instead.</p>
+</div>
+<p>
+Loads a new <span class="type">GdkPixbuf</span> from <em class="parameter"><code>file_name</code></em> and returns it.  The caller must
+assume the reference to the reurned pixbuf. If an error occurred, <em class="parameter"><code>error</code></em> is
+set and <code class="literal">NULL</code> is returned.
+</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="parameter"><code>file_name</code></em> :</span></p></td>
+<td>A file name</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
+<td>return location for errors</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>A newly allocated <span class="type">GdkPixbuf</span>, or <code class="literal">NULL</code>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="rsvg-pixbuf-from-file-at-zoom"></a><h3>rsvg_pixbuf_from_file_at_zoom ()</h3>
+<pre class="programlisting"><span class="returnvalue">GdkPixbuf</span> *         rsvg_pixbuf_from_file_at_zoom       (<em class="parameter"><code>const <span class="type">gchar</span> *file_name</code></em>,
+                                                         <em class="parameter"><code><span class="type">double</span> x_zoom</code></em>,
+                                                         <em class="parameter"><code><span class="type">double</span> y_zoom</code></em>,
+                                                         <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
+<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
+<h3 class="title">Warning</h3>
+<p><code class="literal">rsvg_pixbuf_from_file_at_zoom</code> is deprecated and should not be used in newly-written code. Set up a cairo matrix and use <a class="link" href="RsvgHandle.html#rsvg-handle-new-from-file" title="rsvg_handle_new_from_file ()"><code class="function">rsvg_handle_new_from_file()</code></a> + <a class="link" href="rsvg-Using-RSVG-with-cairo.html#rsvg-handle-render-cairo" title="rsvg_handle_render_cairo ()"><code class="function">rsvg_handle_render_cairo()</code></a> instead.</p>
+</div>
+<p>
+Loads a new <span class="type">GdkPixbuf</span> from <em class="parameter"><code>file_name</code></em> and returns it.  This pixbuf is scaled
+from the size indicated by the file by a factor of <em class="parameter"><code>x_zoom</code></em> and <em class="parameter"><code>y_zoom</code></em>.  The
+caller must assume the reference to the returned pixbuf. If an error
+occurred, <em class="parameter"><code>error</code></em> is set and <code class="literal">NULL</code> is returned.
+</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="parameter"><code>file_name</code></em> :</span></p></td>
+<td>A file name</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>x_zoom</code></em> :</span></p></td>
+<td>The horizontal zoom factor</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>y_zoom</code></em> :</span></p></td>
+<td>The vertical zoom factor</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
+<td>return location for errors</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>A newly allocated <span class="type">GdkPixbuf</span>, or <code class="literal">NULL</code>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="rsvg-pixbuf-from-file-at-size"></a><h3>rsvg_pixbuf_from_file_at_size ()</h3>
+<pre class="programlisting"><span class="returnvalue">GdkPixbuf</span> *         rsvg_pixbuf_from_file_at_size       (<em class="parameter"><code>const <span class="type">gchar</span> *file_name</code></em>,
+                                                         <em class="parameter"><code><span class="type">gint</span> width</code></em>,
+                                                         <em class="parameter"><code><span class="type">gint</span> height</code></em>,
+                                                         <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
+<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
+<h3 class="title">Warning</h3>
+<p><code class="literal">rsvg_pixbuf_from_file_at_size</code> is deprecated and should not be used in newly-written code. Set up a cairo matrix and use <a class="link" href="RsvgHandle.html#rsvg-handle-new-from-file" title="rsvg_handle_new_from_file ()"><code class="function">rsvg_handle_new_from_file()</code></a> + <a class="link" href="rsvg-Using-RSVG-with-cairo.html#rsvg-handle-render-cairo" title="rsvg_handle_render_cairo ()"><code class="function">rsvg_handle_render_cairo()</code></a> instead.</p>
+</div>
+<p>
+Loads a new <span class="type">GdkPixbuf</span> from <em class="parameter"><code>file_name</code></em> and returns it.  This pixbuf is scaled
+from the size indicated to the new size indicated by <em class="parameter"><code>width</code></em> and <em class="parameter"><code>height</code></em>.  If
+either of these are -1, then the default size of the image being loaded is
+used.  The caller must assume the reference to the returned pixbuf. If an
+error occurred, <em class="parameter"><code>error</code></em> is set and <code class="literal">NULL</code> is returned.
+</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="parameter"><code>file_name</code></em> :</span></p></td>
+<td>A file name</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td>
+<td>The new width, or -1</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td>
+<td>The new height, or -1</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
+<td>return location for errors</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>A newly allocated <span class="type">GdkPixbuf</span>, or <code class="literal">NULL</code>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="rsvg-pixbuf-from-file-at-max-size"></a><h3>rsvg_pixbuf_from_file_at_max_size ()</h3>
+<pre class="programlisting"><span class="returnvalue">GdkPixbuf</span> *         rsvg_pixbuf_from_file_at_max_size   (<em class="parameter"><code>const <span class="type">gchar</span> *file_name</code></em>,
+                                                         <em class="parameter"><code><span class="type">gint</span> max_width</code></em>,
+                                                         <em class="parameter"><code><span class="type">gint</span> max_height</code></em>,
+                                                         <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
+<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
+<h3 class="title">Warning</h3>
+<p><code class="literal">rsvg_pixbuf_from_file_at_max_size</code> is deprecated and should not be used in newly-written code. Set up a cairo matrix and use <a class="link" href="RsvgHandle.html#rsvg-handle-new-from-file" title="rsvg_handle_new_from_file ()"><code class="function">rsvg_handle_new_from_file()</code></a> + <a class="link" href="rsvg-Using-RSVG-with-cairo.html#rsvg-handle-render-cairo" title="rsvg_handle_render_cairo ()"><code class="function">rsvg_handle_render_cairo()</code></a> instead.</p>
+</div>
+<p>
+Loads a new <span class="type">GdkPixbuf</span> from <em class="parameter"><code>file_name</code></em> and returns it.  This pixbuf is uniformly
+scaled so that the it fits into a rectangle of size max_width * max_height. The
+caller must assume the reference to the returned pixbuf. If an error occurred,
+<em class="parameter"><code>error</code></em> is set and <code class="literal">NULL</code> is returned.
+</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="parameter"><code>file_name</code></em> :</span></p></td>
+<td>A file name</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>max_width</code></em> :</span></p></td>
+<td>The requested max width</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>max_height</code></em> :</span></p></td>
+<td>The requested max heigh</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
+<td>return location for errors</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>A newly allocated <span class="type">GdkPixbuf</span>, or <code class="literal">NULL</code>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="rsvg-pixbuf-from-file-at-zoom-with-max"></a><h3>rsvg_pixbuf_from_file_at_zoom_with_max ()</h3>
+<pre class="programlisting"><span class="returnvalue">GdkPixbuf</span> *         rsvg_pixbuf_from_file_at_zoom_with_max
+                                                        (<em class="parameter"><code>const <span class="type">gchar</span> *file_name</code></em>,
+                                                         <em class="parameter"><code><span class="type">double</span> x_zoom</code></em>,
+                                                         <em class="parameter"><code><span class="type">double</span> y_zoom</code></em>,
+                                                         <em class="parameter"><code><span class="type">gint</span> max_width</code></em>,
+                                                         <em class="parameter"><code><span class="type">gint</span> max_height</code></em>,
+                                                         <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
+<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
+<h3 class="title">Warning</h3>
+<p><code class="literal">rsvg_pixbuf_from_file_at_zoom_with_max</code> is deprecated and should not be used in newly-written code. Set up a cairo matrix and use <a class="link" href="RsvgHandle.html#rsvg-handle-new-from-file" title="rsvg_handle_new_from_file ()"><code class="function">rsvg_handle_new_from_file()</code></a> + <a class="link" href="rsvg-Using-RSVG-with-cairo.html#rsvg-handle-render-cairo" title="rsvg_handle_render_cairo ()"><code class="function">rsvg_handle_render_cairo()</code></a> instead.</p>
+</div>
+<p>
+Loads a new <span class="type">GdkPixbuf</span> from <em class="parameter"><code>file_name</code></em> and returns it.  This pixbuf is scaled
+from the size indicated by the file by a factor of <em class="parameter"><code>x_zoom</code></em> and <em class="parameter"><code>y_zoom</code></em>. If the
+resulting pixbuf would be larger than max_width/max_heigh it is uniformly scaled
+down to fit in that rectangle. The caller must assume the reference to the
+returned pixbuf. If an error occurred, <em class="parameter"><code>error</code></em> is set and <code class="literal">NULL</code> is returned.
+</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="parameter"><code>file_name</code></em> :</span></p></td>
+<td>A file name</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>x_zoom</code></em> :</span></p></td>
+<td>The horizontal zoom factor</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>y_zoom</code></em> :</span></p></td>
+<td>The vertical zoom factor</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>max_width</code></em> :</span></p></td>
+<td>The requested max width</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>max_height</code></em> :</span></p></td>
+<td>The requested max heigh</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
+<td>return location for errors</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>A newly allocated <span class="type">GdkPixbuf</span>, or <code class="literal">NULL</code>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+</div>
+</div>
+<div class="footer">
+<hr>
+          Generated by GTK-Doc V1.19</div>
+</body>
+</html>

data/vendor/local/share/gtk-doc/html/rsvg-2.0/rsvg-Using-RSVG-with-cairo.html ADDED

@@ -0,0 +1,126 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>Using RSVG with cairo</title>
+<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
+<link rel="home" href="index.html" title="RSVG Libary Reference Manual">
+<link rel="up" href="rsvg.html" title="Part I. API Reference">
+<link rel="prev" href="rsvg-Using-RSVG-with-GIO.html" title="Using RSVG with GIO">
+<link rel="next" href="rsvg-Using-RSVG-with-GdkPixbuf.html" title="Using RSVG with GdkPixbuf">
+<meta name="generator" content="GTK-Doc V1.19 (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="rsvg-Using-RSVG-with-GIO.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
+<td><a accesskey="u" href="rsvg.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">RSVG Libary Reference Manual</th>
+<td><a accesskey="n" href="rsvg-Using-RSVG-with-GdkPixbuf.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
+</tr>
+<tr><td colspan="5" class="shortcuts">
+<a href="#rsvg-Using-RSVG-with-cairo.synopsis" class="shortcut">Top</a>
+                   |
+                  <a href="#rsvg-Using-RSVG-with-cairo.description" class="shortcut">Description</a>
+</td></tr>
+</table>
+<div class="refentry">
+<a name="rsvg-Using-RSVG-with-cairo"></a><div class="titlepage"></div>
+<div class="refnamediv"><table width="100%"><tr>
+<td valign="top">
+<h2><span class="refentrytitle"><a name="rsvg-Using-RSVG-with-cairo.top_of_page"></a>Using RSVG with cairo</span></h2>
+<p>Using RSVG with cairo</p>
+</td>
+<td valign="top" align="right"></td>
+</tr></table></div>
+<div class="refsynopsisdiv">
+<a name="rsvg-Using-RSVG-with-cairo.synopsis"></a><h2>Synopsis</h2>
+<pre class="synopsis"><span class="returnvalue">gboolean</span>            <a class="link" href="rsvg-Using-RSVG-with-cairo.html#rsvg-handle-render-cairo" title="rsvg_handle_render_cairo ()">rsvg_handle_render_cairo</a>            (<em class="parameter"><code><a class="link" href="RsvgHandle.html" title="RsvgHandle"><span class="type">RsvgHandle</span></a> *handle</code></em>,
+                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-t.html#cairo-t"><span class="type">cairo_t</span></a> *cr</code></em>);
+<span class="returnvalue">gboolean</span>            <a class="link" href="rsvg-Using-RSVG-with-cairo.html#rsvg-handle-render-cairo-sub" title="rsvg_handle_render_cairo_sub ()">rsvg_handle_render_cairo_sub</a>        (<em class="parameter"><code><a class="link" href="RsvgHandle.html" title="RsvgHandle"><span class="type">RsvgHandle</span></a> *handle</code></em>,
+                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-t.html#cairo-t"><span class="type">cairo_t</span></a> *cr</code></em>,
+                                                         <em class="parameter"><code>const <span class="type">char</span> *id</code></em>);
+</pre>
+</div>
+<div class="refsect1">
+<a name="rsvg-Using-RSVG-with-cairo.description"></a><h2>Description</h2>
+</div>
+<div class="refsect1">
+<a name="rsvg-Using-RSVG-with-cairo.details"></a><h2>Details</h2>
+<div class="refsect2">
+<a name="rsvg-handle-render-cairo"></a><h3>rsvg_handle_render_cairo ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>            rsvg_handle_render_cairo            (<em class="parameter"><code><a class="link" href="RsvgHandle.html" title="RsvgHandle"><span class="type">RsvgHandle</span></a> *handle</code></em>,
+                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-t.html#cairo-t"><span class="type">cairo_t</span></a> *cr</code></em>);</pre>
+<p>
+Draws a SVG to a Cairo surface
+</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="parameter"><code>handle</code></em> :</span></p></td>
+<td>A RsvgHandle</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
+<td>A Cairo renderer</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 drawing succeeded.</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 2.14</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="rsvg-handle-render-cairo-sub"></a><h3>rsvg_handle_render_cairo_sub ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>            rsvg_handle_render_cairo_sub        (<em class="parameter"><code><a class="link" href="RsvgHandle.html" title="RsvgHandle"><span class="type">RsvgHandle</span></a> *handle</code></em>,
+                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-t.html#cairo-t"><span class="type">cairo_t</span></a> *cr</code></em>,
+                                                         <em class="parameter"><code>const <span class="type">char</span> *id</code></em>);</pre>
+<p>
+Draws a subset of a SVG to a Cairo surface
+</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="parameter"><code>handle</code></em> :</span></p></td>
+<td>A RsvgHandle</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
+<td>A Cairo renderer</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>id</code></em> :</span></p></td>
+<td>An element's id within the SVG, or <code class="literal">NULL</code> to render the whole SVG. For
+example, if you have a layer called "layer1" that you wish to render, pass
+"#<span class="type">layer1</span>" as the id.</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 drawing succeeded.</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 2.14</p>
+</div>
+</div>
+</div>
+<div class="footer">
+<hr>
+          Generated by GTK-Doc V1.19</div>
+</body>
+</html>