<HTML><HEAD><TITLE>Utility/Convenience Functions</TITLE><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK REL="HOME" TITLE="RSVG Reference Manual" HREF="index.html"><LINK REL="UP" TITLE="Utility and Convenience Functions" HREF="r354.html"><LINK REL="PREVIOUS" TITLE="Utility and Convenience Functions" HREF="r354.html"><LINK REL="NEXT" TITLE="Index" HREF="i909.html"><META NAME="GENERATOR" CONTENT="GTK-Doc V1.0 (SGML mode)"><STYLE TYPE="text/css">.synopsis, .classsynopsis {
background: #eeeeee;
border: solid 1px #aaaaaa;
padding: 0.5em;
}
.programlisting {
background: #eeeeff;
border: solid 1px #aaaaff;
padding: 0.5em;
}
.variablelist {
padding: 4px;
margin-left: 3em;
}
.navigation {
background: #ffeeee;
border: solid 1px #ffaaaa;
margin-top: 0.5em;
margin-bottom: 0.5em;
}
.navigation a {
color: #770000;
}
.navigation a:visited {
color: #550000;
}
.navigation .title {
font-size: 200%;
}</STYLE></HEAD><BODY CLASS="REFENTRY" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF"><TABLE WIDTH="100%" CLASS="navigation" SUMMARY="Navigation header" CELLPADDING="2" CELLSPACING="2"><TR VALIGN="middle"><TD><A ACCESSKEY="p" HREF="r354.html"><IMG SRC="left.png" WIDTH="24" HEIGHT="24" BORDER="0" ALT="Prev"></A></TD><TD><A ACCESSKEY="u" HREF="r354.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 Reference Manual</TH><TD><A ACCESSKEY="n" HREF="i909.html"><IMG SRC="right.png" WIDTH="24" HEIGHT="24" BORDER="0" ALT="Next"></A></TD></TR></TABLE><H1><A NAME="RSVG-CONVENIENCE-FUNCTIONS"></A>Utility/Convenience Functions</H1><DIV CLASS="REFNAMEDIV"><A NAME="AEN361"></A><H2>Name</H2>Utility/Convenience Functions -- </DIV><DIV CLASS="REFSYNOPSISDIV"><A NAME="AEN364"></A><H2>Synopsis</H2><PRE CLASS="SYNOPSIS">
GdkPixbuf* <A HREF="rsvg-convenience-functions.html#RSVG-PIXBUF-FROM-FILE">rsvg_pixbuf_from_file</A> (const gchar *file_name,
GError **error);
GdkPixbuf* <A HREF="rsvg-convenience-functions.html#RSVG-PIXBUF-FROM-FILE-AT-ZOOM">rsvg_pixbuf_from_file_at_zoom</A> (const gchar *file_name,
double x_zoom,
double y_zoom,
GError **error);
GdkPixbuf* <A HREF="rsvg-convenience-functions.html#RSVG-PIXBUF-FROM-FILE-AT-SIZE">rsvg_pixbuf_from_file_at_size</A> (const gchar *file_name,
gint width,
gint height,
GError **error);
GdkPixbuf* <A HREF="rsvg-convenience-functions.html#RSVG-PIXBUF-FROM-FILE-AT-MAX-SIZE">rsvg_pixbuf_from_file_at_max_size</A>
(const gchar *file_name,
gint max_width,
gint max_height,
GError **error);
GdkPixbuf* <A HREF="rsvg-convenience-functions.html#RSVG-PIXBUF-FROM-FILE-AT-ZOOM-WITH-MAX">rsvg_pixbuf_from_file_at_zoom_with_max</A>
(const gchar *file_name,
double x_zoom,
double y_zoom,
gint max_width,
gint max_height,
GError **error);
GdkPixbuf* <A HREF="rsvg-convenience-functions.html#RSVG-PIXBUF-FROM-FILE-EX">rsvg_pixbuf_from_file_ex</A> (RsvgHandle *handle,
const gchar *file_name,
GError **error);
GdkPixbuf* <A HREF="rsvg-convenience-functions.html#RSVG-PIXBUF-FROM-FILE-AT-ZOOM-EX">rsvg_pixbuf_from_file_at_zoom_ex</A>
(RsvgHandle *handle,
const gchar *file_name,
double x_zoom,
double y_zoom,
GError **error);
GdkPixbuf* <A HREF="rsvg-convenience-functions.html#RSVG-PIXBUF-FROM-FILE-AT-SIZE-EX">rsvg_pixbuf_from_file_at_size_ex</A>
(RsvgHandle *handle,
const gchar *file_name,
gint width,
gint height,
GError **error);
GdkPixbuf* <A HREF="rsvg-convenience-functions.html#RSVG-PIXBUF-FROM-FILE-AT-MAX-SIZE-EX">rsvg_pixbuf_from_file_at_max_size_ex</A>
(RsvgHandle *handle,
const gchar *file_name,
gint max_width,
gint max_height,
GError **error);
GdkPixbuf* <A HREF="rsvg-convenience-functions.html#RSVG-PIXBUF-FROM-FILE-AT-ZOOM-WITH-MAX-EX">rsvg_pixbuf_from_file_at_zoom_with_max_ex</A>
(RsvgHandle *handle,
const gchar *file_name,
double x_zoom,
double y_zoom,
gint max_width,
gint max_height,
GError **error);</PRE></DIV><DIV CLASS="REFSECT1"><A NAME="AEN432"></A><H2>Description</H2><P></P></DIV><DIV CLASS="REFSECT1"><A NAME="AEN435"></A><H2>Details</H2><DIV CLASS="REFSECT2"><A NAME="AEN437"></A><H3><A NAME="RSVG-PIXBUF-FROM-FILE"></A>rsvg_pixbuf_from_file ()</H3><PRE CLASS="PROGRAMLISTING">GdkPixbuf* rsvg_pixbuf_from_file (const gchar *file_name,
GError **error);</PRE><P>Loads a new GdkPixbuf from <TT CLASS="PARAMETER"><I>file_name</I></TT> and returns it. The caller must
assume the reference to the reurned pixbuf. If an error occurred, <TT CLASS="PARAMETER"><I>error</I></TT> is
set and <TT CLASS="LITERAL">NULL</TT> is returned.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN451"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>file_name</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> A file name</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN456"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>error</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> return location for errors</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN461"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> A newly allocated GdkPixbuf, or <TT CLASS="LITERAL">NULL</TT></P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN468"></A><H3><A NAME="RSVG-PIXBUF-FROM-FILE-AT-ZOOM"></A>rsvg_pixbuf_from_file_at_zoom ()</H3><PRE CLASS="PROGRAMLISTING">GdkPixbuf* rsvg_pixbuf_from_file_at_zoom (const gchar *file_name,
double x_zoom,
double y_zoom,
GError **error);</PRE><P>Loads a new GdkPixbuf from <TT CLASS="PARAMETER"><I>file_name</I></TT> and returns it. This pixbuf is scaled
from the size indicated by the file by a factor of <TT CLASS="PARAMETER"><I>x_zoom</I></TT> and <TT CLASS="PARAMETER"><I>y_zoom</I></TT>. The
caller must assume the reference to the returned pixbuf. If an error
occurred, <TT CLASS="PARAMETER"><I>error</I></TT> is set and <TT CLASS="LITERAL">NULL</TT> is returned.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN486"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>file_name</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> A file name</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN491"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>x_zoom</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> The horizontal zoom factor</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN496"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>y_zoom</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> The vertical zoom factor</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN501"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>error</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> return location for errors</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN506"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> A newly allocated GdkPixbuf, or <TT CLASS="LITERAL">NULL</TT></P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN513"></A><H3><A NAME="RSVG-PIXBUF-FROM-FILE-AT-SIZE"></A>rsvg_pixbuf_from_file_at_size ()</H3><PRE CLASS="PROGRAMLISTING">GdkPixbuf* rsvg_pixbuf_from_file_at_size (const gchar *file_name,
gint width,
gint height,
GError **error);</PRE><P>Loads a new GdkPixbuf from <TT CLASS="PARAMETER"><I>file_name</I></TT> and returns it. This pixbuf is scaled
from the size indicated to the new size indicated by <TT CLASS="PARAMETER"><I>width</I></TT> and <TT CLASS="PARAMETER"><I>height</I></TT>. 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, <TT CLASS="PARAMETER"><I>error</I></TT> is set and <TT CLASS="LITERAL">NULL</TT> is returned.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN531"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>file_name</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> A file name</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN536"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>width</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> The new width, or -1</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN541"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>height</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> The new height, or -1</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN546"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>error</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> return location for errors</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN551"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> A newly allocated GdkPixbuf, or <TT CLASS="LITERAL">NULL</TT></P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN558"></A><H3><A NAME="RSVG-PIXBUF-FROM-FILE-AT-MAX-SIZE"></A>rsvg_pixbuf_from_file_at_max_size ()</H3><PRE CLASS="PROGRAMLISTING">GdkPixbuf* rsvg_pixbuf_from_file_at_max_size
(const gchar *file_name,
gint max_width,
gint max_height,
GError **error);</PRE><P>Loads a new GdkPixbuf from <TT CLASS="PARAMETER"><I>file_name</I></TT> 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,
<TT CLASS="PARAMETER"><I>error</I></TT> is set and <TT CLASS="LITERAL">NULL</TT> is returned.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN574"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>file_name</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> A file name</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN579"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>max_width</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> The requested max width</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN584"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>max_height</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> The requested max heigh</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN589"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>error</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> return location for errors</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN594"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> A newly allocated GdkPixbuf, or <TT CLASS="LITERAL">NULL</TT></P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN601"></A><H3><A NAME="RSVG-PIXBUF-FROM-FILE-AT-ZOOM-WITH-MAX"></A>rsvg_pixbuf_from_file_at_zoom_with_max ()</H3><PRE CLASS="PROGRAMLISTING">GdkPixbuf* rsvg_pixbuf_from_file_at_zoom_with_max
(const gchar *file_name,
double x_zoom,
double y_zoom,
gint max_width,
gint max_height,
GError **error);</PRE><P>Loads a new GdkPixbuf from <TT CLASS="PARAMETER"><I>file_name</I></TT> and returns it. This pixbuf is scaled
from the size indicated by the file by a factor of <TT CLASS="PARAMETER"><I>x_zoom</I></TT> and <TT CLASS="PARAMETER"><I>y_zoom</I></TT>. 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, <TT CLASS="PARAMETER"><I>error</I></TT> is set and <TT CLASS="LITERAL">NULL</TT> is returned.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN621"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>file_name</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> A file name</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN626"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>x_zoom</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> The horizontal zoom factor</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN631"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>y_zoom</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> The vertical zoom factor</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN636"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>max_width</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> The requested max width</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN641"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>max_height</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> The requested max heigh</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN646"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>error</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> return location for errors</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN651"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> A newly allocated GdkPixbuf, or <TT CLASS="LITERAL">NULL</TT></P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN658"></A><H3><A NAME="RSVG-PIXBUF-FROM-FILE-EX"></A>rsvg_pixbuf_from_file_ex ()</H3><PRE CLASS="PROGRAMLISTING">GdkPixbuf* rsvg_pixbuf_from_file_ex (RsvgHandle *handle,
const gchar *file_name,
GError **error);</PRE><P>Loads a new GdkPixbuf from <TT CLASS="PARAMETER"><I>file_name</I></TT> and returns it. The caller must
assume the reference to the reurned pixbuf. If an error occurred, <TT CLASS="PARAMETER"><I>error</I></TT> is
set and <TT CLASS="LITERAL">NULL</TT> is returned. Returned handle is closed by this call and must be
freed by the caller.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN673"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>handle</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> The RSVG handle you wish to render with (either normal or gzipped)</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN678"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>file_name</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> A file name</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN683"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>error</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> return location for errors</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN688"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> A newly allocated GdkPixbuf, or <TT CLASS="LITERAL">NULL</TT></P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN695"></A><H3><A NAME="RSVG-PIXBUF-FROM-FILE-AT-ZOOM-EX"></A>rsvg_pixbuf_from_file_at_zoom_ex ()</H3><PRE CLASS="PROGRAMLISTING">GdkPixbuf* rsvg_pixbuf_from_file_at_zoom_ex
(RsvgHandle *handle,
const gchar *file_name,
double x_zoom,
double y_zoom,
GError **error);</PRE><P>Loads a new GdkPixbuf from <TT CLASS="PARAMETER"><I>file_name</I></TT> and returns it. This pixbuf is scaled
from the size indicated by the file by a factor of <TT CLASS="PARAMETER"><I>x_zoom</I></TT> and <TT CLASS="PARAMETER"><I>y_zoom</I></TT>. The
caller must assume the reference to the returned pixbuf. If an error
occurred, <TT CLASS="PARAMETER"><I>error</I></TT> is set and <TT CLASS="LITERAL">NULL</TT> is returned. Returned handle is closed by this
call and must be freed by the caller.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN714"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>handle</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> The RSVG handle you wish to render with (either normal or gzipped)</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN719"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>file_name</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> A file name</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN724"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>x_zoom</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> The horizontal zoom factor</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN729"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>y_zoom</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> The vertical zoom factor</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN734"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>error</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> return location for errors</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN739"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> A newly allocated GdkPixbuf, or <TT CLASS="LITERAL">NULL</TT></P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN746"></A><H3><A NAME="RSVG-PIXBUF-FROM-FILE-AT-SIZE-EX"></A>rsvg_pixbuf_from_file_at_size_ex ()</H3><PRE CLASS="PROGRAMLISTING">GdkPixbuf* rsvg_pixbuf_from_file_at_size_ex
(RsvgHandle *handle,
const gchar *file_name,
gint width,
gint height,
GError **error);</PRE><P>Loads a new GdkPixbuf from <TT CLASS="PARAMETER"><I>file_name</I></TT> and returns it. This pixbuf is scaled
from the size indicated to the new size indicated by <TT CLASS="PARAMETER"><I>width</I></TT> and <TT CLASS="PARAMETER"><I>height</I></TT>. 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, <TT CLASS="PARAMETER"><I>error</I></TT> is set and <TT CLASS="LITERAL">NULL</TT> is returned. Returned handle is closed
by this call and must be freed by the caller.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN765"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>handle</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> The RSVG handle you wish to render with (either normal or gzipped)</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN770"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>file_name</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> A file name</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN775"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>width</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> The new width, or -1</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN780"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>height</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> The new height, or -1</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN785"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>error</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> return location for errors</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN790"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> A newly allocated GdkPixbuf, or <TT CLASS="LITERAL">NULL</TT></P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN797"></A><H3><A NAME="RSVG-PIXBUF-FROM-FILE-AT-MAX-SIZE-EX"></A>rsvg_pixbuf_from_file_at_max_size_ex ()</H3><PRE CLASS="PROGRAMLISTING">GdkPixbuf* rsvg_pixbuf_from_file_at_max_size_ex
(RsvgHandle *handle,
const gchar *file_name,
gint max_width,
gint max_height,
GError **error);</PRE><P>Loads a new GdkPixbuf from <TT CLASS="PARAMETER"><I>file_name</I></TT> 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,
<TT CLASS="PARAMETER"><I>error</I></TT> is set and <TT CLASS="LITERAL">NULL</TT> is returned. Returned handle is closed by this call and
must be freed by the caller.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN814"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>handle</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> The RSVG handle you wish to render with (either normal or gzipped)</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN819"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>file_name</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> A file name</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN824"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>max_width</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> The requested max width</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN829"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>max_height</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> The requested max heigh</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN834"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>error</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> return location for errors</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN839"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> A newly allocated GdkPixbuf, or <TT CLASS="LITERAL">NULL</TT></P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN846"></A><H3><A NAME="RSVG-PIXBUF-FROM-FILE-AT-ZOOM-WITH-MAX-EX"></A>rsvg_pixbuf_from_file_at_zoom_with_max_ex ()</H3><PRE CLASS="PROGRAMLISTING">GdkPixbuf* rsvg_pixbuf_from_file_at_zoom_with_max_ex
(RsvgHandle *handle,
const gchar *file_name,
double x_zoom,
double y_zoom,
gint max_width,
gint max_height,
GError **error);</PRE><P>Loads a new GdkPixbuf from <TT CLASS="PARAMETER"><I>file_name</I></TT> and returns it. This pixbuf is scaled
from the size indicated by the file by a factor of <TT CLASS="PARAMETER"><I>x_zoom</I></TT> and <TT CLASS="PARAMETER"><I>y_zoom</I></TT>. 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, <TT CLASS="PARAMETER"><I>error</I></TT> is set and <TT CLASS="LITERAL">NULL</TT> is returned.
Returned handle is closed by this call and must be freed by the caller.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN867"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>handle</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> The RSVG handle you wish to render with (either normal or gzipped)</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN872"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>file_name</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> A file name</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN877"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>x_zoom</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> The horizontal zoom factor</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN882"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>y_zoom</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> The vertical zoom factor</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN887"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>max_width</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> The requested max width</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN892"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>max_height</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> The requested max heigh</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN897"><SPAN STYLE="white-space: nowrap"><TT CLASS="PARAMETER"><I>error</I></TT> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> return location for errors</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN902"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> A newly allocated GdkPixbuf, or <TT CLASS="LITERAL">NULL</TT></P></TD></TR></TBODY></TABLE></DIV></DIV><TABLE CLASS="navigation" WIDTH="100%" SUMMARY="Navigation footer" CELLPADDING="2" CELLSPACING="2"><TR VALIGN="middle"><TD ALIGN="left"><A ACCESSKEY="p" HREF="r354.html"><B><<< Utility and Convenience Functions</B></A></TD><TD ALIGN="right"><A ACCESSKEY="n" HREF="i909.html"><B>Index >>></B></A></TD></TR></TABLE></BODY></HTML>
