Kerala Cyber
Warriors
KCW Uploader V1.1
<?xml version="1.0"?>
<!-- This file was automatically generated from C sources - DO NOT EDIT!
To affect the contents of this file, edit the original C definitions,
and/or use gtk-doc annotations. -->
<repository version="1.2"
xmlns="http://www.gtk.org/introspection/core/1.0"
xmlns:c="http://www.gtk.org/introspection/c/1.0"
xmlns:glib="http://www.gtk.org/introspection/glib/1.0">
<include name="GLib" version="2.0"/>
<include name="GObject" version="2.0"/>
<include name="GdkPixbuf" version="2.0"/>
<include name="Gio" version="2.0"/>
<include name="cairo" version="1.0"/>
<package name="librsvg-2.0"/>
<c:include name="librsvg/rsvg.h"/>
<namespace name="Rsvg"
version="2.0"
shared-library="librsvg-2.so.2"
c:identifier-prefixes="Rsvg"
c:symbol-prefixes="rsvg,librsvg">
<function-macro name="CHECK_VERSION"
c:identifier="LIBRSVG_CHECK_VERSION"
introspectable="0">
<source-position filename="librsvg-features.h" line="13"/>
<parameters>
<parameter name="major">
</parameter>
<parameter name="minor">
</parameter>
<parameter name="micro">
</parameter>
</parameters>
</function-macro>
<function-macro name="DEPRECATED_FOR"
c:identifier="RSVG_DEPRECATED_FOR"
introspectable="0">
<source-position filename="rsvg.h" line="47"/>
<parameters>
<parameter name="f">
</parameter>
</parameters>
</function-macro>
<record name="DimensionData"
c:type="RsvgDimensionData"
deprecated="1"
deprecated-version="2.46.">
<doc xml:space="preserve"
filename="rsvg.h"
line="115">Dimensions of an SVG image from rsvg_handle_get_dimensions(), or an
individual element from rsvg_handle_get_dimensions_sub(). Please see
the deprecation documentation for those functions.</doc>
<doc-deprecated xml:space="preserve">FIXME: point to deprecation documentation.</doc-deprecated>
<source-position filename="rsvg.h" line="133"/>
<field name="width" writable="1">
<doc xml:space="preserve"
filename="rsvg.h"
line="117">SVG's width, in pixels</doc>
<type name="gint" c:type="int"/>
</field>
<field name="height" writable="1">
<doc xml:space="preserve"
filename="rsvg.h"
line="118">SVG's height, in pixels</doc>
<type name="gint" c:type="int"/>
</field>
<field name="em" writable="1">
<doc xml:space="preserve"
filename="rsvg.h"
line="119">SVG's original width, unmodified by #RsvgSizeFunc</doc>
<type name="gdouble" c:type="gdouble"/>
</field>
<field name="ex" writable="1">
<doc xml:space="preserve"
filename="rsvg.h"
line="120">SVG's original height, unmodified by #RsvgSizeFunc</doc>
<type name="gdouble" c:type="gdouble"/>
</field>
</record>
<enumeration name="Error"
glib:type-name="RsvgError"
glib:get-type="rsvg_error_get_type"
c:type="RsvgError"
glib:error-domain="rsvg-error-quark">
<doc xml:space="preserve"
filename="rsvg.h"
line="65">An enumeration representing possible errors</doc>
<member name="failed"
value="0"
c:identifier="RSVG_ERROR_FAILED"
glib:nick="failed">
<doc xml:space="preserve"
filename="rsvg.h"
line="67">the request failed</doc>
</member>
<function name="quark" c:identifier="rsvg_error_quark">
<doc xml:space="preserve"
filename="rsvg-base.c"
line="37">The error domain for RSVG</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-base.c"
line="42">The error domain</doc>
<type name="GLib.Quark" c:type="GQuark"/>
</return-value>
</function>
</enumeration>
<function-macro name="HANDLE"
c:identifier="RSVG_HANDLE"
introspectable="0">
<source-position filename="rsvg.h" line="56"/>
<parameters>
<parameter name="obj">
</parameter>
</parameters>
</function-macro>
<function-macro name="HANDLE_CLASS"
c:identifier="RSVG_HANDLE_CLASS"
introspectable="0">
<source-position filename="rsvg.h" line="57"/>
<parameters>
<parameter name="klass">
</parameter>
</parameters>
</function-macro>
<function-macro name="HANDLE_GET_CLASS"
c:identifier="RSVG_HANDLE_GET_CLASS"
introspectable="0">
<source-position filename="rsvg.h" line="60"/>
<parameters>
<parameter name="obj">
</parameter>
</parameters>
</function-macro>
<class name="Handle"
c:symbol-prefix="handle"
c:type="RsvgHandle"
parent="GObject.Object"
glib:type-name="RsvgHandle"
glib:get-type="rsvg_handle_get_type"
glib:type-struct="HandleClass">
<doc xml:space="preserve"
filename="rsvg.h"
line="102">Lets you load SVG data and render it.</doc>
<source-position filename="rsvg.h" line="100"/>
<constructor name="new" c:identifier="rsvg_handle_new">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="446">Returns a new rsvg handle. Must be freed with @g_object_unref. This
handle can be used to load an image.
The preferred way of loading SVG data into the returned #RsvgHandle is with
rsvg_handle_read_stream_sync().
The deprecated way of loading SVG data is with rsvg_handle_write() and
rsvg_handle_close(); note that these require buffering the entire file
internally, and for this reason it is better to use the stream functions:
rsvg_handle_new_from_stream_sync(), rsvg_handle_read_stream_sync(), or
rsvg_handle_new_from_gfile_sync().
After loading the #RsvgHandle with data, you can render it using Cairo or get
a GdkPixbuf from it. When finished, free the handle with g_object_unref(). No
more than one image can be loaded with one handle.
Note that this function creates an #RsvgHandle with no flags set. If you
require any of #RsvgHandleFlags to be set, use any of
rsvg_handle_new_with_flags(), rsvg_handle_new_from_stream_sync(), or
rsvg_handle_new_from_gfile_sync().</doc>
<source-position filename="rsvg.h" line="184"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="470">A new #RsvgHandle with no flags set.</doc>
<type name="Handle" c:type="RsvgHandle*"/>
</return-value>
</constructor>
<constructor name="new_from_data"
c:identifier="rsvg_handle_new_from_data"
version="2.14"
throws="1">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="478">Loads the SVG specified by @data. Note that this function creates an
#RsvgHandle without a base URL, and without any #RsvgHandleFlags. If you
need these, use rsvg_handle_new_from_stream_sync() instead by creating
a #GMemoryInputStream from your data.</doc>
<source-position filename="rsvg.h" line="342"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="489">A #RsvgHandle or %NULL if an error occurs.</doc>
<type name="Handle" c:type="RsvgHandle*"/>
</return-value>
<parameters>
<parameter name="data" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="480">The SVG data</doc>
<array length="1" zero-terminated="0" c:type="const guint8*">
<type name="guint8" c:type="guint8"/>
</array>
</parameter>
<parameter name="data_len" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="481">The length of @data, in bytes</doc>
<type name="gsize" c:type="gsize"/>
</parameter>
</parameters>
</constructor>
<constructor name="new_from_file"
c:identifier="rsvg_handle_new_from_file"
version="2.14"
throws="1">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="498">Loads the SVG specified by @file_name. Note that this function, like
rsvg_handle_new(), does not specify any loading flags for the resulting
handle. If you require the use of #RsvgHandleFlags, use
rsvg_handle_new_from_gfile_sync().</doc>
<source-position filename="rsvg.h" line="344"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="508">A #RsvgHandle or %NULL if an error occurs.</doc>
<type name="Handle" c:type="RsvgHandle*"/>
</return-value>
<parameters>
<parameter name="filename" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="500">The file name to load, or a URI.</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</constructor>
<constructor name="new_from_gfile_sync"
c:identifier="rsvg_handle_new_from_gfile_sync"
version="2.32"
throws="1">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="535">Creates a new #RsvgHandle for @file.
This function sets the "base file" of the handle to be @file itself, so SVG
elements like <literal>&lt;image&gt;</literal> which reference external
resources will be resolved relative to the location of @file.
If @cancellable is not %NULL, then the operation can be cancelled by
triggering the cancellable object from another thread. If the
operation was cancelled, the error %G_IO_ERROR_CANCELLED will be
returned in @error.</doc>
<source-position filename="rsvg.h" line="329"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="553">a new #RsvgHandle on success, or %NULL with @error filled in</doc>
<type name="Handle" c:type="RsvgHandle*"/>
</return-value>
<parameters>
<parameter name="file" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="537">a #GFile</doc>
<type name="Gio.File" c:type="GFile*"/>
</parameter>
<parameter name="flags" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="538">flags from #RsvgHandleFlags</doc>
<type name="HandleFlags" c:type="RsvgHandleFlags"/>
</parameter>
<parameter name="cancellable"
transfer-ownership="none"
nullable="1"
allow-none="1">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="539">a #GCancellable, or %NULL</doc>
<type name="Gio.Cancellable" c:type="GCancellable*"/>
</parameter>
</parameters>
</constructor>
<constructor name="new_from_stream_sync"
c:identifier="rsvg_handle_new_from_stream_sync"
version="2.32"
throws="1">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="566">Creates a new #RsvgHandle for @stream.
This function sets the "base file" of the handle to be @base_file if
provided. SVG elements like <literal>&lt;image&gt;</literal> which reference
external resources will be resolved relative to the location of @base_file.
If @cancellable is not %NULL, then the operation can be cancelled by
triggering the cancellable object from another thread. If the
operation was cancelled, the error %G_IO_ERROR_CANCELLED will be
returned in @error.</doc>
<source-position filename="rsvg.h" line="335"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="585">a new #RsvgHandle on success, or %NULL with @error filled in</doc>
<type name="Handle" c:type="RsvgHandle*"/>
</return-value>
<parameters>
<parameter name="input_stream" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="568">a #GInputStream</doc>
<type name="Gio.InputStream" c:type="GInputStream*"/>
</parameter>
<parameter name="base_file"
transfer-ownership="none"
nullable="1"
allow-none="1">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="569">a #GFile, or %NULL</doc>
<type name="Gio.File" c:type="GFile*"/>
</parameter>
<parameter name="flags" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="570">flags from #RsvgHandleFlags</doc>
<type name="HandleFlags" c:type="RsvgHandleFlags"/>
</parameter>
<parameter name="cancellable"
transfer-ownership="none"
nullable="1"
allow-none="1">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="571">a #GCancellable, or %NULL</doc>
<type name="Gio.Cancellable" c:type="GCancellable*"/>
</parameter>
</parameters>
</constructor>
<constructor name="new_with_flags"
c:identifier="rsvg_handle_new_with_flags"
version="2.36">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="517">Creates a new #RsvgHandle with flags @flags. After calling this function,
you can feed the resulting handle with SVG data by using
rsvg_handle_read_stream_sync().</doc>
<source-position filename="rsvg.h" line="316"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="525">a new #RsvgHandle</doc>
<type name="Handle" c:type="RsvgHandle*"/>
</return-value>
<parameters>
<parameter name="flags" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="519">flags from #RsvgHandleFlags</doc>
<type name="HandleFlags" c:type="RsvgHandleFlags"/>
</parameter>
</parameters>
</constructor>
<method name="close"
c:identifier="rsvg_handle_close"
deprecated="1"
deprecated-version="2.46."
throws="1">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="633">Closes @handle, to indicate that loading the image is complete. This will
return %TRUE if the loader closed successfully and the SVG data was parsed
correctly. Note that @handle isn't freed until @g_object_unref is called.</doc>
<doc-deprecated xml:space="preserve">Use rsvg_handle_read_stream_sync() or the constructor
functions rsvg_handle_new_from_gfile_sync() or
rsvg_handle_new_from_stream_sync(). See the deprecation notes for
rsvg_handle_write() for more information.</doc-deprecated>
<source-position filename="rsvg.h" line="192"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="642">%TRUE on success, or %FALSE on error.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<instance-parameter name="handle" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="635">a #RsvgHandle</doc>
<type name="Handle" c:type="RsvgHandle*"/>
</instance-parameter>
</parameters>
</method>
<method name="get_base_uri"
c:identifier="rsvg_handle_get_base_uri"
version="2.8">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="729">Gets the base uri for this #RsvgHandle.</doc>
<source-position filename="rsvg.h" line="200"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="735">the base uri, possibly null</doc>
<type name="utf8" c:type="const char*"/>
</return-value>
<parameters>
<instance-parameter name="handle" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="731">A #RsvgHandle</doc>
<type name="Handle" c:type="RsvgHandle*"/>
</instance-parameter>
</parameters>
</method>
<method name="get_dimensions"
c:identifier="rsvg_handle_get_dimensions"
version="2.14">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="892">Get the SVG's size. Do not call from within the size_func callback, because
an infinite loop will occur.
This function depends on the #RsvgHandle's DPI to compute dimensions in
pixels, so you should call rsvg_handle_set_dpi() beforehand.</doc>
<source-position filename="rsvg.h" line="205"/>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="handle" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="894">A #RsvgHandle</doc>
<type name="Handle" c:type="RsvgHandle*"/>
</instance-parameter>
<parameter name="dimension_data"
direction="out"
caller-allocates="1"
transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="895">A place to store the SVG's size</doc>
<type name="DimensionData" c:type="RsvgDimensionData*"/>
</parameter>
</parameters>
</method>
<method name="get_dimensions_sub"
c:identifier="rsvg_handle_get_dimensions_sub"
version="2.22"
deprecated="1"
deprecated-version="2.46.">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="911">Get the size of a subelement of the SVG file. Do not call from within the
size_func callback, because an infinite loop will occur.
This function depends on the #RsvgHandle's DPI to compute dimensions in
pixels, so you should call rsvg_handle_set_dpi() beforehand.
Element IDs should look like an URL fragment identifier; for example, pass
"##foo" (hash <literal>foo</literal>) to get the geometry of the element that
has an <literal>id="foo"</literal> attribute.</doc>
<doc-deprecated xml:space="preserve">Use rsvg_handle_get_geometry_for_layer() instead.</doc-deprecated>
<source-position filename="rsvg.h" line="208"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<instance-parameter name="handle" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="913">A #RsvgHandle</doc>
<type name="Handle" c:type="RsvgHandle*"/>
</instance-parameter>
<parameter name="dimension_data"
direction="out"
caller-allocates="1"
transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="914">A place to store the SVG's size</doc>
<type name="DimensionData" c:type="RsvgDimensionData*"/>
</parameter>
<parameter name="id"
transfer-ownership="none"
nullable="1"
allow-none="1">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="915">An element's id within the SVG, starting with "##" (a single
hash character), for example, "##layer1". This notation corresponds to a
URL's fragment ID. Alternatively, pass %NULL to use the whole SVG.</doc>
<type name="utf8" c:type="const char*"/>
</parameter>
</parameters>
</method>
<method name="get_geometry_for_element"
c:identifier="rsvg_handle_get_geometry_for_element"
version="2.46"
throws="1">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1356">Computes the ink rectangle and logical rectangle of a single SVG element.
While `rsvg_handle_get_geometry_for_layer` computes the geometry of an SVG element subtree with
its transformation matrix, this other function will compute the element's geometry
as if it were being rendered under an identity transformation by itself. That is,
the resulting geometry is as if the element got extracted by itself from the SVG.
This function is the counterpart to `rsvg_handle_render_element`.
Element IDs should look like an URL fragment identifier; for example, pass
"##foo" (hash <literal>foo</literal>) to get the geometry of the element that
has an <literal>id="foo"</literal> attribute.
The "ink rectangle" is the bounding box that would be painted
for fully- stroked and filled elements.
The "logical rectangle" just takes into account the unstroked
paths and text outlines.
Note that these bounds are not minimum bounds; for example,
clipping paths are not taken into account.
You can pass #NULL for the @id if you want to measure all
the elements in the SVG, i.e. to measure everything from the
root element.
This operation is not constant-time, as it involves going through all
the child elements.
API ordering: This function must be called on a fully-loaded @handle. See
the section <ulink url="#API-ordering">API ordering</ulink> for details.
Panics: this function will panic if the @handle is not fully-loaded.</doc>
<source-position filename="rsvg-cairo.h" line="63"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<instance-parameter name="handle" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1358">An #RsvgHandle</doc>
<type name="Handle" c:type="RsvgHandle*"/>
</instance-parameter>
<parameter name="id"
transfer-ownership="none"
nullable="1"
allow-none="1">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1359">An element's id within the SVG, starting with "##" (a single
hash character), for example, "##layer1". This notation corresponds to a
URL's fragment ID. Alternatively, pass %NULL to compute the geometry for the
whole SVG.</doc>
<type name="utf8" c:type="const char*"/>
</parameter>
<parameter name="out_ink_rect"
direction="out"
caller-allocates="1"
transfer-ownership="none"
optional="1"
allow-none="1">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1363">Place to store the ink rectangle of the element.</doc>
<type name="Rectangle" c:type="RsvgRectangle*"/>
</parameter>
<parameter name="out_logical_rect"
direction="out"
caller-allocates="1"
transfer-ownership="none"
optional="1"
allow-none="1">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1364">Place to store the logical rectangle of the element.</doc>
<type name="Rectangle" c:type="RsvgRectangle*"/>
</parameter>
</parameters>
</method>
<method name="get_geometry_for_layer"
c:identifier="rsvg_handle_get_geometry_for_layer"
version="2.46"
throws="1">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1254">Computes the ink rectangle and logical rectangle of an SVG element, or the
whole SVG, as if the whole SVG were rendered to a specific viewport.
Element IDs should look like an URL fragment identifier; for example, pass
"##foo" (hash <literal>foo</literal>) to get the geometry of the element that
has an <literal>id="foo"</literal> attribute.
The "ink rectangle" is the bounding box that would be painted
for fully- stroked and filled elements.
The "logical rectangle" just takes into account the unstroked
paths and text outlines.
Note that these bounds are not minimum bounds; for example,
clipping paths are not taken into account.
You can pass #NULL for the @id if you want to measure all
the elements in the SVG, i.e. to measure everything from the
root element.
This operation is not constant-time, as it involves going through all
the child elements.
API ordering: This function must be called on a fully-loaded @handle. See
the section <ulink url="#API-ordering">API ordering</ulink> for details.
Panics: this function will panic if the @handle is not fully-loaded.</doc>
<source-position filename="rsvg-cairo.h" line="48"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<instance-parameter name="handle" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1256">An #RsvgHandle</doc>
<type name="Handle" c:type="RsvgHandle*"/>
</instance-parameter>
<parameter name="id"
transfer-ownership="none"
nullable="1"
allow-none="1">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1257">An element's id within the SVG, starting with "##" (a single
hash character), for example, "##layer1". This notation corresponds to a
URL's fragment ID. Alternatively, pass %NULL to compute the geometry for the
whole SVG.</doc>
<type name="utf8" c:type="const char*"/>
</parameter>
<parameter name="viewport" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1261">Viewport size at which the whole SVG would be fitted.</doc>
<type name="Rectangle" c:type="const RsvgRectangle*"/>
</parameter>
<parameter name="out_ink_rect"
direction="out"
caller-allocates="1"
transfer-ownership="none"
optional="1"
allow-none="1">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1262">Place to store the ink rectangle of the element.</doc>
<type name="Rectangle" c:type="RsvgRectangle*"/>
</parameter>
<parameter name="out_logical_rect"
direction="out"
caller-allocates="1"
transfer-ownership="none"
optional="1"
allow-none="1">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1263">Place to store the logical rectangle of the element.</doc>
<type name="Rectangle" c:type="RsvgRectangle*"/>
</parameter>
</parameters>
</method>
<method name="get_intrinsic_dimensions"
c:identifier="rsvg_handle_get_intrinsic_dimensions"
version="2.46">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1161">Queries the <literal>width</literal>, <literal>height</literal>, and
<literal>viewBox</literal> attributes in an SVG document.
If you are calling this function to compute a scaling factor to render the SVG,
consider simply using rsvg_handle_render_document() instead; it will do the
scaling computations automatically.
As an example, the following SVG element has a <literal>width</literal> of 100 pixels and a <literal>height</literal> of 400 pixels, but no <literal>viewBox</literal>:
|[
<svg xmlns="http://www.w3.org/2000/svg" width="100" height="400">
]|
Conversely, the following element has a <literal>viewBox</literal>, but no <literal>width</literal> or <literal>height</literal>:
|[
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 400">
]|
Note that the #RsvgLength return values have #RsvgUnits in them; you should
not assume that they are always in pixels. For example, the following SVG element
will return a width value whose <literal>units</literal> field is RSVG_UNIT_MM.
|[
<svg xmlns="http://www.w3.org/2000/svg" width="210mm" height="297mm">
]|
API ordering: This function must be called on a fully-loaded @handle. See
the section <ulink url="#API-ordering">API ordering</ulink> for details.
Panics: this function will panic if the @handle is not fully-loaded.</doc>
<source-position filename="rsvg.h" line="273"/>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="handle" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1163">An #RsvgHandle</doc>
<type name="Handle" c:type="RsvgHandle*"/>
</instance-parameter>
<parameter name="out_has_width"
direction="out"
caller-allocates="0"
transfer-ownership="full"
optional="1"
allow-none="1">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1164">Will be set to #TRUE if the toplevel SVG has a <literal>width</literal> attribute</doc>
<type name="gboolean" c:type="gboolean*"/>
</parameter>
<parameter name="out_width"
direction="out"
caller-allocates="1"
transfer-ownership="none"
optional="1"
allow-none="1">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1165">Will be set to the value of the <literal>width</literal> attribute in the toplevel SVG</doc>
<type name="Length" c:type="RsvgLength*"/>
</parameter>
<parameter name="out_has_height"
direction="out"
caller-allocates="0"
transfer-ownership="full"
optional="1"
allow-none="1">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1166">Will be set to #TRUE if the toplevel SVG has a <literal>height</literal> attribute</doc>
<type name="gboolean" c:type="gboolean*"/>
</parameter>
<parameter name="out_height"
direction="out"
caller-allocates="1"
transfer-ownership="none"
optional="1"
allow-none="1">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1167">Will be set to the value of the <literal>height</literal> attribute in the toplevel SVG</doc>
<type name="Length" c:type="RsvgLength*"/>
</parameter>
<parameter name="out_has_viewbox"
direction="out"
caller-allocates="0"
transfer-ownership="full"
optional="1"
allow-none="1">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1168">Will be set to #TRUE if the toplevel SVG has a <literal>viewBox</literal> attribute</doc>
<type name="gboolean" c:type="gboolean*"/>
</parameter>
<parameter name="out_viewbox"
direction="out"
caller-allocates="1"
transfer-ownership="none"
optional="1"
allow-none="1">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1169">Will be set to the value of the <literal>viewBox</literal> attribute in the toplevel SVG</doc>
<type name="Rectangle" c:type="RsvgRectangle*"/>
</parameter>
</parameters>
</method>
<method name="get_pixbuf" c:identifier="rsvg_handle_get_pixbuf">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1030">Returns the pixbuf loaded by @handle. 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 %NULL
will be returned. Note that the pixbuf may not be complete until
@rsvg_handle_close has been called.
This function depends on the #RsvgHandle's DPI to compute dimensions in
pixels, so you should call rsvg_handle_set_dpi() beforehand.</doc>
<source-position filename="rsvg.h" line="195"/>
<return-value transfer-ownership="full" nullable="1">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1043">the pixbuf loaded by @handle, or %NULL.</doc>
<type name="GdkPixbuf.Pixbuf" c:type="GdkPixbuf*"/>
</return-value>
<parameters>
<instance-parameter name="handle" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1032">An #RsvgHandle</doc>
<type name="Handle" c:type="RsvgHandle*"/>
</instance-parameter>
</parameters>
</method>
<method name="get_pixbuf_sub"
c:identifier="rsvg_handle_get_pixbuf_sub"
version="2.14">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="994">Creates a #GdkPixbuf the same size as the entire SVG loaded into @handle, but
only renders the sub-element that has the specified @id (and all its
sub-sub-elements recursively). If @id is #NULL, this function renders the
whole SVG.
This function depends on the #RsvgHandle's DPI to compute dimensions in
pixels, so you should call rsvg_handle_set_dpi() beforehand.
If you need to render an image which is only big enough to fit a particular
sub-element of the SVG, consider using rsvg_handle_render_cairo_sub(), upon a
surface that is just the size returned by rsvg_handle_get_dimensions_sub().
You will need to offset the rendering by the amount returned in
rsvg_handle_get_position_sub().
Element IDs should look like an URL fragment identifier; for example, pass
"##foo" (hash <literal>foo</literal>) to get the geometry of the element that
has an <literal>id="foo"</literal> attribute.</doc>
<source-position filename="rsvg.h" line="197"/>
<return-value transfer-ownership="full" nullable="1">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1019">a pixbuf, or %NULL if an error occurs
during rendering.</doc>
<type name="GdkPixbuf.Pixbuf" c:type="GdkPixbuf*"/>
</return-value>
<parameters>
<instance-parameter name="handle" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="996">An #RsvgHandle</doc>
<type name="Handle" c:type="RsvgHandle*"/>
</instance-parameter>
<parameter name="id"
transfer-ownership="none"
nullable="1"
allow-none="1">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="997">An element's id within the SVG, starting with "##" (a single
hash character), for example, "##layer1". This notation corresponds to a
URL's fragment ID. Alternatively, pass %NULL to use the whole SVG.</doc>
<type name="utf8" c:type="const char*"/>
</parameter>
</parameters>
</method>
<method name="get_position_sub"
c:identifier="rsvg_handle_get_position_sub"
version="2.22"
deprecated="1"
deprecated-version="2.46.">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="941">Get the position of a subelement of the SVG file. Do not call from within
the size_func callback, because an infinite loop will occur.
This function depends on the #RsvgHandle's DPI to compute dimensions in
pixels, so you should call rsvg_handle_set_dpi() beforehand.
Element IDs should look like an URL fragment identifier; for example, pass
"##foo" (hash <literal>foo</literal>) to get the geometry of the element that
has an <literal>id="foo"</literal> attribute.</doc>
<doc-deprecated xml:space="preserve">Use rsvg_handle_get_geometry_for_layer() instead.</doc-deprecated>
<source-position filename="rsvg.h" line="213"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<instance-parameter name="handle" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="943">A #RsvgHandle</doc>
<type name="Handle" c:type="RsvgHandle*"/>
</instance-parameter>
<parameter name="position_data"
direction="out"
caller-allocates="1"
transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="944">A place to store the SVG fragment's position.</doc>
<type name="PositionData" c:type="RsvgPositionData*"/>
</parameter>
<parameter name="id"
transfer-ownership="none"
nullable="1"
allow-none="1">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="945">An element's id within the SVG, starting with "##" (a single
hash character), for example, "##layer1". This notation corresponds to a
URL's fragment ID. Alternatively, pass %NULL to use the whole SVG.</doc>
<type name="utf8" c:type="const char*"/>
</parameter>
</parameters>
</method>
<method name="has_sub" c:identifier="rsvg_handle_has_sub" version="2.22">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="971">Checks whether the element @id exists in the SVG document.
Element IDs should look like an URL fragment identifier; for example, pass
"##foo" (hash <literal>foo</literal>) to get the geometry of the element that
has an <literal>id="foo"</literal> attribute.</doc>
<source-position filename="rsvg.h" line="218"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="984">%TRUE if @id exists in the SVG document, %FALSE otherwise.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<instance-parameter name="handle" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="973">a #RsvgHandle</doc>
<type name="Handle" c:type="RsvgHandle*"/>
</instance-parameter>
<parameter name="id" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="974">An element's id within the SVG, starting with "##" (a single hash
character), for example, "##layer1". This notation corresponds to a URL's
fragment ID.</doc>
<type name="utf8" c:type="const char*"/>
</parameter>
</parameters>
</method>
<method name="internal_set_testing"
c:identifier="rsvg_handle_internal_set_testing">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1462">Do not call this function. This is intended for librsvg's internal
test suite only.</doc>
<source-position filename="rsvg.h" line="354"/>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="handle" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1464">a #RsvgHandle</doc>
<type name="Handle" c:type="RsvgHandle*"/>
</instance-parameter>
<parameter name="testing" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1465">Whether to enable testing mode</doc>
<type name="gboolean" c:type="gboolean"/>
</parameter>
</parameters>
</method>
<method name="read_stream_sync"
c:identifier="rsvg_handle_read_stream_sync"
version="2.32"
throws="1">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="655">Reads @stream and writes the data from it to @handle.
Before calling this function, you may need to call rsvg_handle_set_base_uri()
or rsvg_handle_set_base_gfile() to set the "base file" for resolving
references to external resources. SVG elements like
<literal>&lt;image&gt;</literal> which reference external resources will be
resolved relative to the location you specify with those functions.
If @cancellable is not %NULL, then the operation can be cancelled by
triggering the cancellable object from another thread. If the
operation was cancelled, the error %G_IO_ERROR_CANCELLED will be
returned.</doc>
<source-position filename="rsvg.h" line="323"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="675">%TRUE if reading @stream succeeded, or %FALSE otherwise
with @error filled in</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<instance-parameter name="handle" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="657">a #RsvgHandle</doc>
<type name="Handle" c:type="RsvgHandle*"/>
</instance-parameter>
<parameter name="stream" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="658">a #GInputStream</doc>
<type name="Gio.InputStream" c:type="GInputStream*"/>
</parameter>
<parameter name="cancellable"
transfer-ownership="none"
nullable="1"
allow-none="1">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="659">a #GCancellable, or %NULL</doc>
<type name="Gio.Cancellable" c:type="GCancellable*"/>
</parameter>
</parameters>
</method>
<method name="render_cairo"
c:identifier="rsvg_handle_render_cairo"
version="2.14">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="865">Draws a loaded SVG handle to a Cairo context. Drawing will occur with
respect to the @cr's current transformation: for example, if the @cr has a
rotated current transformation matrix, the whole SVG will be rotated in the
rendered version.
This function depends on the #RsvgHandle's DPI to compute dimensions in
pixels, so you should call rsvg_handle_set_dpi() beforehand.
Note that @cr must be a Cairo context that is not in an error state, that is,
cairo_status() must return #CAIRO_STATUS_SUCCESS for it. Cairo can set a
context to be in an error state in various situations, for example, if it was
passed an invalid matrix or if it was created for an invalid surface.</doc>
<source-position filename="rsvg-cairo.h" line="37"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="883">%TRUE if drawing succeeded; %FALSE otherwise.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<instance-parameter name="handle" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="867">A #RsvgHandle</doc>
<type name="Handle" c:type="RsvgHandle*"/>
</instance-parameter>
<parameter name="cr" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="868">A Cairo context</doc>
<type name="cairo.Context" c:type="cairo_t*"/>
</parameter>
</parameters>
</method>
<method name="render_cairo_sub"
c:identifier="rsvg_handle_render_cairo_sub"
version="2.14">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="831">Draws a subset of a loaded SVG handle to a Cairo context. Drawing will occur with
respect to the @cr's current transformation: for example, if the @cr has a
rotated current transformation matrix, the whole SVG will be rotated in the
rendered version.
This function depends on the #RsvgHandle's DPI to compute dimensions in
pixels, so you should call rsvg_handle_set_dpi() beforehand.
Note that @cr must be a Cairo context that is not in an error state, that is,
cairo_status() must return #CAIRO_STATUS_SUCCESS for it. Cairo can set a
context to be in an error state in various situations, for example, if it was
passed an invalid matrix or if it was created for an invalid surface.
Element IDs should look like an URL fragment identifier; for example, pass
"##foo" (hash <literal>foo</literal>) to get the geometry of the element that
has an <literal>id="foo"</literal> attribute.</doc>
<source-position filename="rsvg-cairo.h" line="39"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="856">%TRUE if drawing succeeded; %FALSE otherwise.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<instance-parameter name="handle" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="833">A #RsvgHandle</doc>
<type name="Handle" c:type="RsvgHandle*"/>
</instance-parameter>
<parameter name="cr" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="834">A Cairo context</doc>
<type name="cairo.Context" c:type="cairo_t*"/>
</parameter>
<parameter name="id"
transfer-ownership="none"
nullable="1"
allow-none="1">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="835">An element's id within the SVG, starting with "##" (a single
hash character), for example, "##layer1". This notation corresponds to a
URL's fragment ID. Alternatively, pass %NULL to render the whole SVG.</doc>
<type name="utf8" c:type="const char*"/>
</parameter>
</parameters>
</method>
<method name="render_document"
c:identifier="rsvg_handle_render_document"
version="2.46"
throws="1">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1223">Renders the whole SVG document fitted to a viewport.
The @viewport gives the position and size at which the whole SVG
document will be rendered.
The @cr must be in a #CAIRO_STATUS_SUCCESS state, or this function will not
render anything, and instead will return an error.
API ordering: This function must be called on a fully-loaded @handle. See
the section <ulink url="#API-ordering">API ordering</ulink> for details.
Panics: this function will panic if the @handle is not fully-loaded.</doc>
<source-position filename="rsvg-cairo.h" line="42"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<instance-parameter name="handle" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1225">An #RsvgHandle</doc>
<type name="Handle" c:type="RsvgHandle*"/>
</instance-parameter>
<parameter name="cr" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1226">A Cairo context</doc>
<type name="cairo.Context" c:type="cairo_t*"/>
</parameter>
<parameter name="viewport" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1227">Viewport size at which the whole SVG would be fitted.</doc>
<type name="Rectangle" c:type="const RsvgRectangle*"/>
</parameter>
</parameters>
</method>
<method name="render_element"
c:identifier="rsvg_handle_render_element"
version="2.46"
throws="1">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1417">Renders a single SVG element to a given viewport
This function can be used to extract individual element subtrees and render them,
scaled to a given @element_viewport. This is useful for applications which have
reusable objects in an SVG and want to render them individually; for example, an
SVG full of icons that are meant to be be rendered independently of each other.
Element IDs should look like an URL fragment identifier; for example, pass
"##foo" (hash <literal>foo</literal>) to get the geometry of the element that
has an <literal>id="foo"</literal> attribute.
You can pass #NULL for the @id if you want to render all
the elements in the SVG, i.e. to render everything from the
root element.
The `element_viewport` gives the position and size at which the named element will
be rendered. FIXME: mention proportional scaling.
API ordering: This function must be called on a fully-loaded @handle. See
the section <ulink url="#API-ordering">API ordering</ulink> for details.
Panics: this function will panic if the @handle is not fully-loaded.</doc>
<source-position filename="rsvg-cairo.h" line="70"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<instance-parameter name="handle" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1419">An #RsvgHandle</doc>
<type name="Handle" c:type="RsvgHandle*"/>
</instance-parameter>
<parameter name="cr" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1420">A Cairo context</doc>
<type name="cairo.Context" c:type="cairo_t*"/>
</parameter>
<parameter name="id"
transfer-ownership="none"
nullable="1"
allow-none="1">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1421">An element's id within the SVG, starting with "##" (a single
hash character), for example, "##layer1". This notation corresponds to a
URL's fragment ID. Alternatively, pass %NULL to render the whole SVG document tree.</doc>
<type name="utf8" c:type="const char*"/>
</parameter>
<parameter name="element_viewport" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1424">Viewport size in which to fit the element</doc>
<type name="Rectangle" c:type="const RsvgRectangle*"/>
</parameter>
</parameters>
</method>
<method name="render_layer"
c:identifier="rsvg_handle_render_layer"
version="2.46"
throws="1">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1312">Renders a single SVG element in the same place as for a whole SVG document.
This is equivalent to rsvg_handle_render_document(), but it renders only a
single element and its children, as if they composed an individual layer in
the SVG. The element is rendered with the same transformation matrix as it
has within the whole SVG document. Applications can use this to re-render a
single element and repaint it on top of a previously-rendered document, for
example.
Element IDs should look like an URL fragment identifier; for example, pass
"##foo" (hash <literal>foo</literal>) to get the geometry of the element that
has an <literal>id="foo"</literal> attribute.
You can pass #NULL for the @id if you want to render all
the elements in the SVG, i.e. to render everything from the
root element.
API ordering: This function must be called on a fully-loaded @handle. See
the section <ulink url="#API-ordering">API ordering</ulink> for details.
Panics: this function will panic if the @handle is not fully-loaded.</doc>
<source-position filename="rsvg-cairo.h" line="56"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<instance-parameter name="handle" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1314">An #RsvgHandle</doc>
<type name="Handle" c:type="RsvgHandle*"/>
</instance-parameter>
<parameter name="cr" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1315">A Cairo context</doc>
<type name="cairo.Context" c:type="cairo_t*"/>
</parameter>
<parameter name="id"
transfer-ownership="none"
nullable="1"
allow-none="1">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1316">An element's id within the SVG, starting with "##" (a single
hash character), for example, "##layer1". This notation corresponds to a
URL's fragment ID. Alternatively, pass %NULL to render the whole SVG document tree.</doc>
<type name="utf8" c:type="const char*"/>
</parameter>
<parameter name="viewport" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1319">Viewport size at which the whole SVG would be fitted.</doc>
<type name="Rectangle" c:type="const RsvgRectangle*"/>
</parameter>
</parameters>
</method>
<method name="set_base_gfile"
c:identifier="rsvg_handle_set_base_gfile"
version="2.32">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="710">Set the base URI for @handle from @file.
Note: This function may only be called before rsvg_handle_write() or
rsvg_handle_read_stream_sync() have been called.</doc>
<source-position filename="rsvg.h" line="319"/>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="handle" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="712">a #RsvgHandle</doc>
<type name="Handle" c:type="RsvgHandle*"/>
</instance-parameter>
<parameter name="base_file" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="713">a #GFile</doc>
<type name="Gio.File" c:type="GFile*"/>
</parameter>
</parameters>
</method>
<method name="set_base_uri"
c:identifier="rsvg_handle_set_base_uri"
version="2.9">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="692">Set the base URI for this SVG.
Note: This function may only be called before rsvg_handle_write() or
rsvg_handle_read_stream_sync() have been called.</doc>
<source-position filename="rsvg.h" line="202"/>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="handle" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="694">A #RsvgHandle</doc>
<type name="Handle" c:type="RsvgHandle*"/>
</instance-parameter>
<parameter name="base_uri" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="695">The base uri</doc>
<type name="utf8" c:type="const char*"/>
</parameter>
</parameters>
</method>
<method name="set_dpi" c:identifier="rsvg_handle_set_dpi" version="2.8">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1051">Sets the DPI at which the @handle will be rendered. Common values are
75, 90, and 300 DPI.
Passing a number <= 0 to @dpi will reset the DPI to whatever the default
value happens to be, but since rsvg_set_default_dpi() is deprecated, please
do not pass values <= 0 to this function.</doc>
<source-position filename="rsvg.h" line="179"/>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="handle" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1053">An #RsvgHandle</doc>
<type name="Handle" c:type="RsvgHandle*"/>
</instance-parameter>
<parameter name="dpi" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1054">Dots Per Inch (i.e. as Pixels Per Inch)</doc>
<type name="gdouble" c:type="double"/>
</parameter>
</parameters>
</method>
<method name="set_dpi_x_y"
c:identifier="rsvg_handle_set_dpi_x_y"
version="2.8">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1071">Sets the DPI at which the @handle will be rendered. Common values are
75, 90, and 300 DPI.
Passing a number <= 0 to @dpi will reset the DPI to whatever the default
value happens to be, but since rsvg_set_default_dpi_x_y() is deprecated,
please do not pass values <= 0 to this function.</doc>
<source-position filename="rsvg.h" line="181"/>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="handle" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1073">An #RsvgHandle</doc>
<type name="Handle" c:type="RsvgHandle*"/>
</instance-parameter>
<parameter name="dpi_x" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1074">Dots Per Inch (i.e. Pixels Per Inch)</doc>
<type name="gdouble" c:type="double"/>
</parameter>
<parameter name="dpi_y" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="1075">Dots Per Inch (i.e. Pixels Per Inch)</doc>
<type name="gdouble" c:type="double"/>
</parameter>
</parameters>
</method>
<method name="set_stylesheet"
c:identifier="rsvg_handle_set_stylesheet"
version="2.48"
throws="1">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="744">Sets a CSS stylesheet to use for an SVG document.
The @css_len argument is mandatory; this function will not compute the length
of the @css string. This is because a provided stylesheet, which the calling
program could read from a file, can have nul characters in it.
During the CSS cascade, the specified stylesheet will be used with a "User"
<ulink
url="https://drafts.csswg.org/css-cascade-3/#cascading-origins">origin</ulink>.
Note that `@import` rules will not be resolved, except for `data:` URLs.</doc>
<source-position filename="rsvg.h" line="347"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<instance-parameter name="handle" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="746">A #RsvgHandle.</doc>
<type name="Handle" c:type="RsvgHandle*"/>
</instance-parameter>
<parameter name="css" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="747">String with CSS data; must be valid UTF-8.</doc>
<array length="1" zero-terminated="0" c:type="const guint8*">
<type name="guint8" c:type="guint8"/>
</array>
</parameter>
<parameter name="css_len" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="748">Length of the @css data in bytes.</doc>
<type name="gsize" c:type="gsize"/>
</parameter>
</parameters>
</method>
<method name="write"
c:identifier="rsvg_handle_write"
deprecated="1"
deprecated-version="2.46."
throws="1">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="603">Loads the next @count bytes of the image.
Before calling this function for the first time, you may need to call
rsvg_handle_set_base_uri() or rsvg_handle_set_base_gfile() to set the "base
file" for resolving references to external resources. SVG elements like
<literal>&lt;image&gt;</literal> which reference external resources will be
resolved relative to the location you specify with those functions.</doc>
<doc-deprecated xml:space="preserve">Use rsvg_handle_read_stream_sync() or the constructor
functions rsvg_handle_new_from_gfile_sync() or
rsvg_handle_new_from_stream_sync(). This function is deprecated because it
will accumulate data from the @buf in memory until rsvg_handle_close() gets
called. To avoid a big temporary buffer, use the suggested functions, which
take a #GFile or a #GInputStream and do not require a temporary buffer.</doc-deprecated>
<source-position filename="rsvg.h" line="187"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="618">%TRUE on success, or %FALSE on error.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<instance-parameter name="handle" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="605">an #RsvgHandle</doc>
<type name="Handle" c:type="RsvgHandle*"/>
</instance-parameter>
<parameter name="buf" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="606">pointer to svg data</doc>
<array length="1" zero-terminated="0" c:type="const guchar*">
<type name="guint8"/>
</array>
</parameter>
<parameter name="count" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="607">length of the @buf buffer in bytes</doc>
<type name="gsize" c:type="gsize"/>
</parameter>
</parameters>
</method>
<property name="base-uri"
writable="1"
construct="1"
transfer-ownership="none">
<type name="utf8" c:type="gchar*"/>
</property>
<property name="desc"
deprecated="1"
deprecated-version="2.36."
transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="300">SVG's description.</doc>
<doc-deprecated xml:space="preserve">Reading this property always returns #NULL.</doc-deprecated>
<type name="utf8" c:type="gchar*"/>
</property>
<property name="dpi-x"
writable="1"
construct="1"
transfer-ownership="none">
<type name="gdouble" c:type="gdouble"/>
</property>
<property name="dpi-y"
writable="1"
construct="1"
transfer-ownership="none">
<type name="gdouble" c:type="gdouble"/>
</property>
<property name="em"
deprecated="1"
deprecated-version="2.46."
transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="268">Exact width, in pixels, of the rendered SVG before calling the size callback
as specified by rsvg_handle_set_size_callback().</doc>
<doc-deprecated xml:space="preserve">Reading each of the size properties causes the size of the
SVG to be recomputed, so reading both the <literal>em</literal> and
<literal>ex</literal> properties will cause two such computations. Please
use rsvg_handle_get_intrinsic_dimensions() instead.</doc-deprecated>
<type name="gdouble" c:type="gdouble"/>
</property>
<property name="ex"
deprecated="1"
deprecated-version="2.46."
transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="280">Exact height, in pixels, of the rendered SVG before calling the size callback
as specified by rsvg_handle_set_size_callback().</doc>
<doc-deprecated xml:space="preserve">Reading each of the size properties causes the size of the
SVG to be recomputed, so reading both the <literal>em</literal> and
<literal>ex</literal> properties will cause two such computations. Please
use rsvg_handle_get_intrinsic_dimensions() instead.</doc-deprecated>
<type name="gdouble" c:type="gdouble"/>
</property>
<property name="flags"
version="2.36"
writable="1"
construct-only="1"
transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="214">Flags from #RsvgHandleFlags.</doc>
<type name="HandleFlags"/>
</property>
<property name="height"
deprecated="1"
deprecated-version="2.46."
transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="254">Height, in pixels, of the rendered SVG after calling the size callback
as specified by rsvg_handle_set_size_callback().</doc>
<doc-deprecated xml:space="preserve">For historical reasons, this property is of integer type,
which cannot give the exact size of SVG images that are not pixel-aligned.
Moreover, reading each of the size properties causes the size of the SVG to
be recomputed, so reading both the <literal>width</literal> and
<literal>height</literal> properties will cause two such computations.
Please use rsvg_handle_get_intrinsic_dimensions() instead.</doc-deprecated>
<type name="gint" c:type="gint"/>
</property>
<property name="metadata"
deprecated="1"
deprecated-version="2.36."
transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="308">SVG's metadata</doc>
<doc-deprecated xml:space="preserve">Reading this property always returns #NULL.</doc-deprecated>
<type name="utf8" c:type="gchar*"/>
</property>
<property name="title"
deprecated="1"
deprecated-version="2.36."
transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="292">SVG's title.</doc>
<doc-deprecated xml:space="preserve">Reading this property always returns #NULL.</doc-deprecated>
<type name="utf8" c:type="gchar*"/>
</property>
<property name="width"
deprecated="1"
deprecated-version="2.46."
transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-handle.c"
line="240">Width, in pixels, of the rendered SVG after calling the size callback
as specified by rsvg_handle_set_size_callback().</doc>
<doc-deprecated xml:space="preserve">For historical reasons, this property is of integer type,
which cannot give the exact size of SVG images that are not pixel-aligned.
Moreover, reading each of the size properties causes the size of the SVG to
be recomputed, so reading both the <literal>width</literal> and
<literal>height</literal> properties will cause two such computations.
Please use rsvg_handle_get_intrinsic_dimensions() instead.</doc-deprecated>
<type name="gint" c:type="gint"/>
</property>
<field name="parent">
<type name="GObject.Object" c:type="GObject"/>
</field>
<field name="_abi_padding" readable="0" private="1">
<array zero-terminated="0" fixed-size="16">
<type name="gpointer" c:type="gpointer"/>
</array>
</field>
</class>
<record name="HandleClass"
c:type="RsvgHandleClass"
glib:is-gtype-struct-for="Handle">
<doc xml:space="preserve"
filename="rsvg.h"
line="89">Class structure for #RsvgHandle.</doc>
<source-position filename="rsvg.h" line="100"/>
<field name="parent">
<doc xml:space="preserve"
filename="rsvg.h"
line="91">parent class</doc>
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
</field>
<field name="_abi_padding" readable="0" private="1">
<array zero-terminated="0" fixed-size="15">
<type name="gpointer" c:type="gpointer"/>
</array>
</field>
</record>
<bitfield name="HandleFlags"
glib:type-name="RsvgHandleFlags"
glib:get-type="rsvg_handle_flags_get_type"
c:type="RsvgHandleFlags">
<member name="flags_none"
value="0"
c:identifier="RSVG_HANDLE_FLAGS_NONE"
glib:nick="flags-none">
<doc xml:space="preserve"
filename="rsvg.h"
line="285">No flags are set.</doc>
</member>
<member name="flag_unlimited"
value="1"
c:identifier="RSVG_HANDLE_FLAG_UNLIMITED"
glib:nick="flag-unlimited">
<doc xml:space="preserve"
filename="rsvg.h"
line="286">Disable safety limits in the XML parser.
Libxml2 has <ulink
url="https://gitlab.gnome.org/GNOME/libxml2/blob/master/include/libxml/parserInternals.h">several
limits</ulink> designed to keep malicious XML content from consuming too
much memory while parsing. For security reasons, this should only be used
for trusted input!
Since: 2.40.3</doc>
</member>
<member name="flag_keep_image_data"
value="2"
c:identifier="RSVG_HANDLE_FLAG_KEEP_IMAGE_DATA"
glib:nick="flag-keep-image-data">
<doc xml:space="preserve"
filename="rsvg.h"
line="293">Use this if the Cairo surface to which you
are rendering is a PDF, PostScript, SVG, or Win32 Printing surface. This
will make librsvg and Cairo use the original, compressed data for images in
the final output, instead of passing uncompressed images. This will make a
Keeps the image data when loading images, for use by cairo when painting to
e.g. a PDF surface. For example, this will make the a resulting PDF file
smaller and faster. Please see <ulink
url="https://www.cairographics.org/manual/cairo-cairo-surface-t.html#cairo-surface-set-mime-data">the
Cairo documentation</ulink> for details.
Since: 2.40.3</doc>
</member>
</bitfield>
<function-macro name="IS_HANDLE"
c:identifier="RSVG_IS_HANDLE"
introspectable="0">
<source-position filename="rsvg.h" line="58"/>
<parameters>
<parameter name="obj">
</parameter>
</parameters>
</function-macro>
<function-macro name="IS_HANDLE_CLASS"
c:identifier="RSVG_IS_HANDLE_CLASS"
introspectable="0">
<source-position filename="rsvg.h" line="59"/>
<parameters>
<parameter name="klass">
</parameter>
</parameters>
</function-macro>
<record name="Length" c:type="RsvgLength">
<doc xml:space="preserve"
filename="rsvg.h"
line="248">#RsvgLength values are used in rsvg_handle_get_intrinsic_dimensions(), for
example, to return the CSS length values of the <literal>width</literal> and
<literal>height</literal> attributes of an <literal>&lt;svg&gt;</literal>
element.
This is equivalent to <ulink
url="https://www.w3.org/TR/CSS21/syndata.html#length-units">CSS lengths</ulink>.
It is up to the calling application to convert lengths in non-pixel units
(i.e. those where the @unit field is not #RSVG_UNIT_PX) into something
meaningful to the application. For example, if your application knows the
dots-per-inch (DPI) it is using, it can convert lengths with @unit in
#RSVG_UNIT_IN or other physical units.</doc>
<source-position filename="rsvg.h" line="270"/>
<field name="length" writable="1">
<doc xml:space="preserve"
filename="rsvg.h"
line="250">numeric part of the length</doc>
<type name="gdouble" c:type="double"/>
</field>
<field name="unit" writable="1">
<doc xml:space="preserve"
filename="rsvg.h"
line="251">unit part of the length</doc>
<type name="Unit" c:type="RsvgUnit"/>
</field>
</record>
<constant name="MAJOR_VERSION" value="2" c:type="LIBRSVG_MAJOR_VERSION">
<source-position filename="librsvg-features.h" line="8"/>
<type name="gint" c:type="gint"/>
</constant>
<constant name="MICRO_VERSION" value="9" c:type="LIBRSVG_MICRO_VERSION">
<source-position filename="librsvg-features.h" line="10"/>
<type name="gint" c:type="gint"/>
</constant>
<constant name="MINOR_VERSION" value="48" c:type="LIBRSVG_MINOR_VERSION">
<source-position filename="librsvg-features.h" line="9"/>
<type name="gint" c:type="gint"/>
</constant>
<record name="PositionData"
c:type="RsvgPositionData"
deprecated="1"
deprecated-version="2.46.">
<doc xml:space="preserve"
filename="rsvg.h"
line="135">Position of an SVG fragment from rsvg_handle_get_position_sub(). Please
the deprecation documentation for that function.</doc>
<doc-deprecated xml:space="preserve">FIXME: point to deprecation documentation.</doc-deprecated>
<source-position filename="rsvg.h" line="148"/>
<field name="x" writable="1">
<doc xml:space="preserve"
filename="rsvg.h"
line="137">position on the x axis</doc>
<type name="gint" c:type="int"/>
</field>
<field name="y" writable="1">
<doc xml:space="preserve"
filename="rsvg.h"
line="138">position on the y axis</doc>
<type name="gint" c:type="int"/>
</field>
</record>
<record name="Rectangle" c:type="RsvgRectangle" version="2.46">
<doc xml:space="preserve"
filename="rsvg.h"
line="150">A data structure for holding a rectangle.</doc>
<source-position filename="rsvg.h" line="166"/>
<field name="x" writable="1">
<doc xml:space="preserve"
filename="rsvg.h"
line="152">X coordinate of the left side of the rectangle</doc>
<type name="gdouble" c:type="double"/>
</field>
<field name="y" writable="1">
<doc xml:space="preserve"
filename="rsvg.h"
line="153">Y coordinate of the the top side of the rectangle</doc>
<type name="gdouble" c:type="double"/>
</field>
<field name="width" writable="1">
<doc xml:space="preserve"
filename="rsvg.h"
line="154">width of the rectangle</doc>
<type name="gdouble" c:type="double"/>
</field>
<field name="height" writable="1">
<doc xml:space="preserve"
filename="rsvg.h"
line="155">height of the rectangle</doc>
<type name="gdouble" c:type="double"/>
</field>
</record>
<enumeration name="Unit" c:type="RsvgUnit">
<doc xml:space="preserve"
filename="rsvg.h"
line="220">Units for the #RsvgLength struct. These have the same meaning as <ulink
url="https://www.w3.org/TR/CSS21/syndata.html#length-units">CSS length
units</ulink>.</doc>
<source-position filename="rsvg.h" line="246"/>
<member name="percent" value="0" c:identifier="RSVG_UNIT_PERCENT">
<doc xml:space="preserve"
filename="rsvg.h"
line="222">percentage values; where <literal>1.0</literal> means 100%.</doc>
</member>
<member name="px" value="1" c:identifier="RSVG_UNIT_PX">
<doc xml:space="preserve" filename="rsvg.h" line="223">pixels</doc>
</member>
<member name="em" value="2" c:identifier="RSVG_UNIT_EM">
<doc xml:space="preserve"
filename="rsvg.h"
line="224">em, or the current font size</doc>
</member>
<member name="ex" value="3" c:identifier="RSVG_UNIT_EX">
<doc xml:space="preserve"
filename="rsvg.h"
line="225">x-height of the current font</doc>
</member>
<member name="in" value="4" c:identifier="RSVG_UNIT_IN">
<doc xml:space="preserve" filename="rsvg.h" line="226">inches</doc>
</member>
<member name="cm" value="5" c:identifier="RSVG_UNIT_CM">
<doc xml:space="preserve"
filename="rsvg.h"
line="227">centimeters</doc>
</member>
<member name="mm" value="6" c:identifier="RSVG_UNIT_MM">
<doc xml:space="preserve"
filename="rsvg.h"
line="228">millimeters</doc>
</member>
<member name="pt" value="7" c:identifier="RSVG_UNIT_PT">
<doc xml:space="preserve"
filename="rsvg.h"
line="229">points, or 1/72 inch</doc>
</member>
<member name="pc" value="8" c:identifier="RSVG_UNIT_PC">
<doc xml:space="preserve"
filename="rsvg.h"
line="230">picas, or 1/6 inch (12 points)</doc>
</member>
</enumeration>
<constant name="VERSION" value="2.48.9" c:type="LIBRSVG_VERSION">
<source-position filename="librsvg-features.h" line="11"/>
<type name="utf8" c:type="gchar*"/>
</constant>
<function name="cleanup"
c:identifier="rsvg_cleanup"
version="2.36"
deprecated="1"
deprecated-version="2.46">
<doc-deprecated xml:space="preserve">No-op. This function should not be called from normal programs.</doc-deprecated>
<source-position filename="rsvg.h" line="170"/>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
</function>
<function name="error_quark"
c:identifier="rsvg_error_quark"
moved-to="Error.quark">
<doc xml:space="preserve"
filename="rsvg-base.c"
line="37">The error domain for RSVG</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-base.c"
line="42">The error domain</doc>
<type name="GLib.Quark" c:type="GQuark"/>
</return-value>
</function>
<function name="set_default_dpi"
c:identifier="rsvg_set_default_dpi"
version="2.8"
deprecated="1"
deprecated-version="2.42.3">
<doc xml:space="preserve"
filename="rsvg-base.c"
line="50">Do not use this function. Create an #RsvgHandle and call
rsvg_handle_set_dpi() on it instead.</doc>
<doc-deprecated xml:space="preserve">This function used to set a global default DPI. However,
it only worked if it was called before any #RsvgHandle objects had been
created; it would not work after that. To avoid global mutable state, please
use rsvg_handle_set_dpi() instead.</doc-deprecated>
<source-position filename="rsvg.h" line="173"/>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="dpi" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-base.c"
line="52">Dots Per Inch (aka Pixels Per Inch)</doc>
<type name="gdouble" c:type="double"/>
</parameter>
</parameters>
</function>
<function name="set_default_dpi_x_y"
c:identifier="rsvg_set_default_dpi_x_y"
version="2.8"
deprecated="1"
deprecated-version="2.42.3">
<doc xml:space="preserve"
filename="rsvg-base.c"
line="70">Do not use this function. Create an #RsvgHandle and call
rsvg_handle_set_dpi_x_y() on it instead.</doc>
<doc-deprecated xml:space="preserve">This function used to set a global default DPI. However,
it only worked if it was called before any #RsvgHandle objects had been
created; it would not work after that. To avoid global mutable state, please
use rsvg_handle_set_dpi() instead.</doc-deprecated>
<source-position filename="rsvg.h" line="176"/>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="dpi_x" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-base.c"
line="72">Dots Per Inch (aka Pixels Per Inch)</doc>
<type name="gdouble" c:type="double"/>
</parameter>
<parameter name="dpi_y" transfer-ownership="none">
<doc xml:space="preserve"
filename="rsvg-base.c"
line="73">Dots Per Inch (aka Pixels Per Inch)</doc>
<type name="gdouble" c:type="double"/>
</parameter>
</parameters>
</function>
</namespace>
</repository>
-=[ KCW uplo4d3r c0ded by cJ_n4p573r ]=-
Ⓒ2017 ҠЄГѦLѦ СүѣЄГ ЩѦГГіѺГՏ