cairo 1.15.3-x86-mingw32 → 1.15.4-x86-mingw32

data/vendor/local/share/gtk-doc/html/cairo/cairo-PNG-Support.html

@@ -152,7 +152,8 @@ surface can be checked for with cairo_surface_status(surface) which
 may return one of the following values:</p>
 <p><a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-NO-MEMORY:CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a>
 <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-FILE-NOT-FOUND:CAPS"><code class="literal">CAIRO_STATUS_FILE_NOT_FOUND</code></a>
-<a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-READ-ERROR:CAPS"><code class="literal">CAIRO_STATUS_READ_ERROR</code></a></p>
+<a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-READ-ERROR:CAPS"><code class="literal">CAIRO_STATUS_READ_ERROR</code></a>
+<a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-PNG-ERROR:CAPS"><code class="literal">CAIRO_STATUS_PNG_ERROR</code></a></p>
 <p>Alternatively, you can allow errors to propagate through the drawing
 operations and check the status on the context upon completion
 using <a class="link" href="cairo-cairo-t.html#cairo-status" title="cairo_status ()"><code class="function">cairo_status()</code></a>.</p>
@@ -249,7 +250,8 @@ or memory could not be allocated for the operation.  A nil
 surface can be checked for with cairo_surface_status(surface) which
 may return one of the following values:</p>
 <p><a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-NO-MEMORY:CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a>
-<a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-READ-ERROR:CAPS"><code class="literal">CAIRO_STATUS_READ_ERROR</code></a></p>
+<a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-READ-ERROR:CAPS"><code class="literal">CAIRO_STATUS_READ_ERROR</code></a>
+<a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-PNG-ERROR:CAPS"><code class="literal">CAIRO_STATUS_PNG_ERROR</code></a></p>
 <p>Alternatively, you can allow errors to propagate through the drawing
 operations and check the status on the context upon completion
 using <a class="link" href="cairo-cairo-t.html#cairo-status" title="cairo_status ()"><code class="function">cairo_status()</code></a>.</p>
@@ -296,7 +298,8 @@ successfully. Otherwise, <a class="link" href="cairo-Error-handling.html#CAIRO-S
 be allocated for the operation or
 <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-SURFACE-TYPE-MISMATCH:CAPS"><code class="literal">CAIRO_STATUS_SURFACE_TYPE_MISMATCH</code></a> if the surface does not have
 pixel contents, or <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-WRITE-ERROR:CAPS"><code class="literal">CAIRO_STATUS_WRITE_ERROR</code></a> if an I/O error occurs
-while attempting to write the file.</p>
+while attempting to write the file, or <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-PNG-ERROR:CAPS"><code class="literal">CAIRO_STATUS_PNG_ERROR</code></a> if libpng
+returned an error.</p>
 <p></p>
 </div>
 <p class="since">Since 1.0</p>
@@ -390,7 +393,8 @@ cairo_surface_write_to_png_stream (<em class="parameter"><code><a class="link" h
 successfully.  Otherwise, <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-NO-MEMORY:CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a> is returned if
 memory could not be allocated for the operation,
 <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-SURFACE-TYPE-MISMATCH:CAPS"><code class="literal">CAIRO_STATUS_SURFACE_TYPE_MISMATCH</code></a> if the surface does not have
-pixel contents.</p>
+pixel contents, or <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-PNG-ERROR:CAPS"><code class="literal">CAIRO_STATUS_PNG_ERROR</code></a> if libpng
+returned an error.</p>
 <p></p>
 </div>
 <p class="since">Since 1.0</p>

data/vendor/local/share/gtk-doc/html/cairo/cairo-Paths.html

@@ -254,7 +254,7 @@ cairo_copy_path (<em class="parameter"><code><a class="link" href="cairo-cairo-t
 <a class="link" href="cairo-Paths.html#cairo-path-t" title="cairo_path_t"><span class="type">cairo_path_t</span></a>. See <a class="link" href="cairo-Paths.html#cairo-path-data-t" title="union cairo_path_data_t"><span class="type">cairo_path_data_t</span></a> for hints on how to iterate
 over the returned data structure.</p>
 <p>This function will always return a valid pointer, but the result
-will have no data (<code class="literal">data==<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></code> and
+will have no data (<code class="literal">data==<code class="literal">NULL</code></code> and
 <code class="literal">num_data==0</code>), if either of the following
 conditions hold:</p>
 <div class="orderedlist"><ol class="orderedlist" type="1">
@@ -304,7 +304,7 @@ value). That is, the result is guaranteed to not have any elements
 of type <a class="link" href="cairo-Paths.html#CAIRO-PATH-CURVE-TO:CAPS"><code class="literal">CAIRO_PATH_CURVE_TO</code></a> which will instead be replaced by a
 series of <a class="link" href="cairo-Paths.html#CAIRO-PATH-LINE-TO:CAPS"><code class="literal">CAIRO_PATH_LINE_TO</code></a> elements.</p>
 <p>This function will always return a valid pointer, but the result
-will have no data (<code class="literal">data==<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></code> and
+will have no data (<code class="literal">data==<code class="literal">NULL</code></code> and
 <code class="literal">num_data==0</code>), if either of the following
 conditions hold:</p>
 <div class="orderedlist"><ol class="orderedlist" type="1">
@@ -1060,7 +1060,7 @@ serious text-using applications. See <a class="link" href="cairo-Paths.html#cair
 </tr>
 <tr>
 <td class="parameter_name"><p>utf8</p></td>
-<td class="parameter_description"><p>a NUL-terminated string of text encoded in UTF-8, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
+<td class="parameter_description"><p>a NUL-terminated string of text encoded in UTF-8, or <code class="literal">NULL</code></p></td>
 <td class="parameter_annotations"> </td>
 </tr>
 </tbody>

data/vendor/local/share/gtk-doc/html/cairo/cairo-PostScript-Surfaces.html

@@ -185,7 +185,7 @@ vary. See <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-
 <tbody>
 <tr>
 <td class="parameter_name"><p>filename</p></td>
-<td class="parameter_description"><p>a filename for the PS output (must be writable), <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> may be
+<td class="parameter_description"><p>a filename for the PS output (must be writable), <code class="literal">NULL</code> may be
 used to specify no output. This will generate a PS surface that
 may be queried and used as a source, without generating a
 temporary file.</p></td>
@@ -243,7 +243,7 @@ output can vary. See <a class="link" href="cairo-PostScript-Surfaces.html#cairo-
 <tbody>
 <tr>
 <td class="parameter_name"><p>write_func</p></td>
-<td class="parameter_description"><p>a <a class="link" href="cairo-PNG-Support.html#cairo-write-func-t" title="cairo_write_func_t ()"><span class="type">cairo_write_func_t</span></a> to accept the output data, may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
+<td class="parameter_description"><p>a <a class="link" href="cairo-PNG-Support.html#cairo-write-func-t" title="cairo_write_func_t ()"><span class="type">cairo_write_func_t</span></a> to accept the output data, may be <code class="literal">NULL</code>
 to indicate a no-op <em class="parameter"><code>write_func</code></em>
 . With a no-op <em class="parameter"><code>write_func</code></em>
 ,
@@ -359,7 +359,7 @@ cairo_ps_get_levels (<em class="parameter"><code><a class="link" href="cairo-Pos
 cairo_ps_level_to_string (<em class="parameter"><code><a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-level-t" title="enum cairo_ps_level_t"><span class="type">cairo_ps_level_t</span></a> level</code></em>);</pre>
 <p>Get the string representation of the given <em class="parameter"><code>level</code></em>
  id. This function
-will return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>level</code></em>
+will return <code class="literal">NULL</code> if <em class="parameter"><code>level</code></em>
  id isn't valid. See <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-get-levels" title="cairo_ps_get_levels ()"><code class="function">cairo_ps_get_levels()</code></a>
 for a way to get the list of valid level ids.</p>
 <div class="refsect3">
@@ -391,7 +391,7 @@ for a way to get the list of valid level ids.</p>
 cairo_ps_surface_set_eps (<em class="parameter"><code><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a> *surface</code></em>,
                           <em class="parameter"><code><a class="link" href="cairo-Types.html#cairo-bool-t" title="cairo_bool_t"><span class="type">cairo_bool_t</span></a> eps</code></em>);</pre>
 <p>If <em class="parameter"><code>eps</code></em>
- is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, the PostScript surface will output Encapsulated
+ is <code class="literal">TRUE</code>, the PostScript surface will output Encapsulated
 PostScript.</p>
 <p>This function should only be called before any drawing operations
 have been performed on the current page. The simplest way to do
@@ -414,7 +414,7 @@ than one page.</p>
 </tr>
 <tr>
 <td class="parameter_name"><p>eps</p></td>
-<td class="parameter_description"><p><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to output EPS format PostScript</p></td>
+<td class="parameter_description"><p><code class="literal">TRUE</code> to output EPS format PostScript</p></td>
 <td class="parameter_annotations"> </td>
 </tr>
 </tbody>
@@ -445,7 +445,7 @@ cairo_ps_surface_get_eps (<em class="parameter"><code><a class="link" href="cair
 </div>
 <div class="refsect3">
 <a name="id-1.5.7.7.8.6"></a><h4>Returns</h4>
-<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the surface will output Encapsulated PostScript.</p>
+<p> <code class="literal">TRUE</code> if the surface will output Encapsulated PostScript.</p>
 <p></p>
 </div>
 <p class="since">Since 1.6</p>

data/vendor/local/share/gtk-doc/html/cairo/cairo-Raster-Sources.html

@@ -7,7 +7,7 @@
 <link rel="home" href="index.html" title="Cairo: A Vector Graphics Library">
 <link rel="up" href="cairo-drawing.html" title="Drawing">
 <link rel="prev" href="cairo-text.html" title="text">
-<link rel="next" href="cairo-fonts.html" title="Fonts">
+<link rel="next" href="cairo-Tags-and-Links.html" title="Tags and Links">
 <meta name="generator" content="GTK-Doc V1.20 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
@@ -21,7 +21,7 @@
 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
 <td><a accesskey="u" href="cairo-drawing.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
 <td><a accesskey="p" href="cairo-text.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
-<td><a accesskey="n" href="cairo-fonts.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
+<td><a accesskey="n" href="cairo-Tags-and-Links.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
 </tr></table>
 <div class="refentry">
 <a name="cairo-Raster-Sources"></a><div class="titlepage"></div>

data/vendor/local/share/gtk-doc/html/cairo/cairo-Recording-Surfaces.html

@@ -146,7 +146,7 @@ accurate replay.</p>
 </tr>
 <tr>
 <td class="parameter_name"><p>extents</p></td>
-<td class="parameter_description"><p>the extents to record in pixels, can be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to record
+<td class="parameter_description"><p>the extents to record in pixels, can be <code class="literal">NULL</code> to record
 unbounded operations.</p></td>
 <td class="parameter_annotations"> </td>
 </tr>
@@ -244,8 +244,8 @@ cairo_recording_surface_get_extents (<em class="parameter"><code><a class="link"
 </div>
 <div class="refsect3">
 <a name="id-1.5.8.7.4.6"></a><h4>Returns</h4>
-<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the surface is bounded, of recording type, and
-not in an error state, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a></p>
+<p> <code class="literal">TRUE</code> if the surface is bounded, of recording type, and
+not in an error state, otherwise <code class="literal">FALSE</code></p>
 <p></p>
 </div>
 <p class="since">Since 1.12</p>

data/vendor/local/share/gtk-doc/html/cairo/cairo-Regions.html

@@ -594,8 +594,8 @@ cairo_region_is_empty (<em class="parameter"><code>const <a class="link" href="c
 </div>
 <div class="refsect3">
 <a name="id-1.3.5.7.12.6"></a><h4>Returns</h4>
-<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>region</code></em>
-is empty, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if it isn't.</p>
+<p> <code class="literal">TRUE</code> if <em class="parameter"><code>region</code></em>
+is empty, <code class="literal">FALSE</code> if it isn't.</p>
 <p></p>
 </div>
 <p class="since">Since 1.10</p>
@@ -640,10 +640,10 @@ cairo_region_contains_point (<em class="parameter"><code>const <a class="link" h
 </div>
 <div class="refsect3">
 <a name="id-1.3.5.7.13.6"></a><h4>Returns</h4>
-<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if (<em class="parameter"><code>x</code></em>
+<p> <code class="literal">TRUE</code> if (<em class="parameter"><code>x</code></em>
 , <em class="parameter"><code>y</code></em>
 ) is contained in <em class="parameter"><code>region</code></em>
-, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if it is not.</p>
+, <code class="literal">FALSE</code> if it is not.</p>
 <p></p>
 </div>
 <p class="since">Since 1.10</p>
@@ -701,8 +701,8 @@ is partially inside and partially outside <em class="parameter"><code>region</co
 <pre class="programlisting"><a class="link" href="cairo-Types.html#cairo-bool-t" title="cairo_bool_t"><span class="returnvalue">cairo_bool_t</span></a>
 cairo_region_equal (<em class="parameter"><code>const <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> *a</code></em>,
                     <em class="parameter"><code>const <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> *b</code></em>);</pre>
-<p>Compares whether region_a is equivalent to region_b. <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> as an argument
-is equal to itself, but not to any non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> region.</p>
+<p>Compares whether region_a is equivalent to region_b. <code class="literal">NULL</code> as an argument
+is equal to itself, but not to any non-<code class="literal">NULL</code> region.</p>
 <div class="refsect3">
 <a name="id-1.3.5.7.15.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
@@ -714,12 +714,12 @@ is equal to itself, but not to any non-<a href="http://library.gnome.org/devel/g
 <tbody>
 <tr>
 <td class="parameter_name"><p>a</p></td>
-<td class="parameter_description"><p>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
+<td class="parameter_description"><p>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> or <code class="literal">NULL</code></p></td>
 <td class="parameter_annotations"> </td>
 </tr>
 <tr>
 <td class="parameter_name"><p>b</p></td>
-<td class="parameter_description"><p>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
+<td class="parameter_description"><p>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> or <code class="literal">NULL</code></p></td>
 <td class="parameter_annotations"> </td>
 </tr>
 </tbody>
@@ -727,8 +727,8 @@ is equal to itself, but not to any non-<a href="http://library.gnome.org/devel/g
 </div>
 <div class="refsect3">
 <a name="id-1.3.5.7.15.6"></a><h4>Returns</h4>
-<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if both regions contained the same coverage,
-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if it is not or any region is in an error status.</p>
+<p> <code class="literal">TRUE</code> if both regions contained the same coverage,
+<code class="literal">FALSE</code> if it is not or any region is in an error status.</p>
 <p></p>
 </div>
 <p class="since">Since 1.10</p>

data/vendor/local/share/gtk-doc/html/cairo/cairo-SVG-Surfaces.html

@@ -146,7 +146,7 @@ Base64-encoded and emitted.</p>
 <tbody>
 <tr>
 <td class="parameter_name"><p>filename</p></td>
-<td class="parameter_description"><p>a filename for the SVG output (must be writable), <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> may be
+<td class="parameter_description"><p>a filename for the SVG output (must be writable), <code class="literal">NULL</code> may be
 used to specify no output. This will generate a SVG surface that
 may be queried and used as a source, without generating a
 temporary file.</p></td>
@@ -200,7 +200,7 @@ incrementally to the stream represented by <em class="parameter"><code>write_fun
 <tbody>
 <tr>
 <td class="parameter_name"><p>write_func</p></td>
-<td class="parameter_description"><p>a <a class="link" href="cairo-PNG-Support.html#cairo-write-func-t" title="cairo_write_func_t ()"><span class="type">cairo_write_func_t</span></a> to accept the output data, may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
+<td class="parameter_description"><p>a <a class="link" href="cairo-PNG-Support.html#cairo-write-func-t" title="cairo_write_func_t ()"><span class="type">cairo_write_func_t</span></a> to accept the output data, may be <code class="literal">NULL</code>
 to indicate a no-op <em class="parameter"><code>write_func</code></em>
 . With a no-op <em class="parameter"><code>write_func</code></em>
 ,
@@ -315,7 +315,7 @@ cairo_svg_get_versions (<em class="parameter"><code><a class="link" href="cairo-
 cairo_svg_version_to_string (<em class="parameter"><code><a class="link" href="cairo-SVG-Surfaces.html#cairo-svg-version-t" title="enum cairo_svg_version_t"><span class="type">cairo_svg_version_t</span></a> version</code></em>);</pre>
 <p>Get the string representation of the given <em class="parameter"><code>version</code></em>
  id. This function
-will return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>version</code></em>
+will return <code class="literal">NULL</code> if <em class="parameter"><code>version</code></em>
  isn't valid. See <a class="link" href="cairo-SVG-Surfaces.html#cairo-svg-get-versions" title="cairo_svg_get_versions ()"><code class="function">cairo_svg_get_versions()</code></a>
 for a way to get the list of valid version ids.</p>
 <div class="refsect3">

data/vendor/local/share/gtk-doc/html/cairo/cairo-Tags-and-Links.html

@@ -0,0 +1,415 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>Cairo: A Vector Graphics Library: Tags and Links</title>
+<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
+<link rel="home" href="index.html" title="Cairo: A Vector Graphics Library">
+<link rel="up" href="cairo-drawing.html" title="Drawing">
+<link rel="prev" href="cairo-Raster-Sources.html" title="Raster Sources">
+<link rel="next" href="cairo-fonts.html" title="Fonts">
+<meta name="generator" content="GTK-Doc V1.20 (XML mode)">
+<link rel="stylesheet" href="style.css" type="text/css">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
+<td width="100%" align="left" class="shortcuts">
+<a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span> 
+                  <a href="#cairo-Tags-and-Links.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span> 
+                  <a href="#cairo-Tags-and-Links.object-hierarchy" class="shortcut">Object Hierarchy</a></span>
+</td>
+<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
+<td><a accesskey="u" href="cairo-drawing.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
+<td><a accesskey="p" href="cairo-Raster-Sources.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
+<td><a accesskey="n" href="cairo-fonts.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
+</tr></table>
+<div class="refentry">
+<a name="cairo-Tags-and-Links"></a><div class="titlepage"></div>
+<div class="refnamediv"><table width="100%"><tr>
+<td valign="top">
+<h2><span class="refentrytitle"><a name="cairo-Tags-and-Links.top_of_page"></a>Tags and Links</span></h2>
+<p>Tags and Links — Hyperlinks and document structure</p>
+</td>
+<td class="gallery_image" valign="top" align="right"></td>
+</tr></table></div>
+<div class="refsect1">
+<a name="cairo-Tags-and-Links.functions"></a><h2>Functions</h2>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="functions_return">
+<col class="functions_name">
+</colgroup>
+<tbody>
+<tr>
+<td class="function_type">
+<span class="returnvalue">void</span>
+</td>
+<td class="function_name">
+<a class="link" href="cairo-Tags-and-Links.html#cairo-tag-begin" title="cairo_tag_begin ()">cairo_tag_begin</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">void</span>
+</td>
+<td class="function_name">
+<a class="link" href="cairo-Tags-and-Links.html#cairo-tag-end" title="cairo_tag_end ()">cairo_tag_end</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect1">
+<a name="cairo-Tags-and-Links.other"></a><h2>Types and Values</h2>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="name">
+<col class="description">
+</colgroup>
+<tbody>
+<tr>
+<td class="define_keyword">#define</td>
+<td class="function_name"><a class="link" href="cairo-Tags-and-Links.html#CAIRO-TAG-DEST:CAPS" title="CAIRO_TAG_DEST">CAIRO_TAG_DEST</a></td>
+</tr>
+<tr>
+<td class="define_keyword">#define</td>
+<td class="function_name"><a class="link" href="cairo-Tags-and-Links.html#CAIRO-TAG-LINK:CAPS" title="CAIRO_TAG_LINK">CAIRO_TAG_LINK</a></td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect1">
+<a name="cairo-Tags-and-Links.object-hierarchy"></a><h2>Object Hierarchy</h2>
+<pre class="screen">
+</pre>
+</div>
+<div class="refsect1">
+<a name="cairo-Tags-and-Links.description"></a><h2>Description</h2>
+<p>The tag functions provide the ability to specify hyperlinks and
+document logical structure on supported backends. The following tags are supported:</p>
+<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
+<li class="listitem"><p><a class="link" href="cairo-Tags-and-Links.html#link" title="Link Tags">Link</a> - Create a hyperlink</p></li>
+<li class="listitem"><p><a class="link" href="cairo-Tags-and-Links.html#dest" title="Destination Tags">Destinations</a> - Create a hyperlink destination</p></li>
+<li class="listitem"><p><a class="link" href="cairo-Tags-and-Links.html#doc-struct" title="Document Structure (PDF)">Document Structure Tags</a> - Create PDF Document Structure</p></li>
+</ul></div>
+<div class="refsect2">
+<a name="link"></a><h3>Link Tags</h3>
+<p>A hyperlink is specified by enclosing the hyperlink text with the <a class="link" href="cairo-Tags-and-Links.html#CAIRO-TAG-LINK:CAPS" title="CAIRO_TAG_LINK"><code class="literal">CAIRO_TAG_LINK</code></a> tag.</p>
+<p>For example:</p>
+<div class="informalexample"><pre class="programlisting">
+cairo_tag_begin (cr, CAIRO_TAG_LINK, "uri='http://cairographics.org'");
+cairo_move_to (cr, 50, 50);
+cairo_show_text (cr, "This is a link to the cairo website.");
+cairo_tag_end (cr, CAIRO_TAG_LINK);
+</pre></div>
+<p>The PDF backend uses one or more rectangles to define the clickable
+area of the link.  By default cairo will use the extents of the
+drawing operations enclosed by the begin/end link tags to define the
+clickable area. In some cases, such as a link split across two
+lines, the default rectangle is undesirable.</p>
+<p><em class="parameter"><code>rect</code></em>
+: [optional] The "rect" attribute allows the application to
+specify one or more rectangles that form the clickable region.  The
+value of this attribute is an array of floats. Each rectangle is
+specified by four elements in the array: x, y, width, height. The
+array size must be a multiple of four.</p>
+<p>An example of creating a link with user specified clickable region:</p>
+<div class="informalexample"><pre class="programlisting">
+cairo_font_extents_t font_extents;
+cairo_text_extents_t text1_extents;
+cairo_text_extents_t text2_extents;
+char attribs[100];
+const char *text1 = "This link is split";
+const char *text2 = "across two lines";
+
+cairo_font_extents (cr, &amp;font_extents);
+cairo_move_to (cr, 450, 50);
+cairo_text_extents (cr, text1, &amp;text1_extents);
+cairo_move_to (cr, 50, 70);
+cairo_text_extents (cr, text2, &amp;text2_extents);
+sprintf (attribs,
+         "rect=[%f %f %f %f %f %f %f %f] uri='http://cairographics.org'",
+         text1_extents.x_bearing,
+         text1_extents.y_bearing,
+         text1_extents.width,
+         text1_extents.height,
+         text2_extents.x_bearing,
+         text2_extents.y_bearing,
+         text2_extents.width,
+         text2_extents.height);
+
+cairo_tag_begin (cr, CAIRO_TAG_LINK, attribs);
+cairo_show_text (cr, "This is a link to the cairo website");
+cairo_move_to (cr, 450, 50);
+cairo_show_text (cr, text1);
+cairo_move_to (cr, 50, 70);
+cairo_show_text (cr, text2);
+cairo_tag_end (cr, CAIRO_TAG_LINK);
+</pre></div>
+<p>There are three types of links. Each type has its own attributes as detailed below.</p>
+<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
+<li class="listitem"><p><a class="link" href="cairo-Tags-and-Links.html#internal-link" title="Internal Links">Internal Links</a> - A link to a location in the same document</p></li>
+<li class="listitem"><p><a class="link" href="cairo-Tags-and-Links.html#uri-link" title="URI Links">URI Links</a> - A link to a Uniform resource identifier</p></li>
+<li class="listitem"><p><a class="link" href="cairo-Tags-and-Links.html#file-link" title="File Links">File Links</a> - A link to a location in another document</p></li>
+</ul></div>
+<div class="refsect3">
+<a name="internal-link"></a><h4>Internal Links</h4>
+<p>An internal link is a link to a location in the same document. The destination
+is specified with either:</p>
+<p><em class="parameter"><code>dest</code></em>
+: a UTF-8 string specifying the destination in the PDF file to link
+to. Destinations are created with the <a class="link" href="cairo-Tags-and-Links.html#CAIRO-TAG-DEST:CAPS" title="CAIRO_TAG_DEST"><code class="literal">CAIRO_TAG_DEST</code></a> tag.</p>
+<p>or the two attributes:</p>
+<p><em class="parameter"><code>page</code></em>
+: An integer specifying the page number in the PDF file to link to.</p>
+<p><em class="parameter"><code>pos</code></em>
+: [optional] An array of two floats specifying the x,y position
+on the page. Default is 0,0.</p>
+<p>An example of the link attributes to link to a page and x,y position:</p>
+<pre class="programlisting">
+"page=3 pos=[3.1 6.2]"
+</pre>
+</div>
+<div class="refsect3">
+<a name="uri-link"></a><h4>URI Links</h4>
+<p>A URI link is a link to a Uniform Resource Identifier (<a class="ulink" href="http://tools.ietf.org/html/rfc2396" target="_top">RFC 2396</a>).</p>
+<p>A URI is specified with the following attribute:</p>
+<p><em class="parameter"><code>uri</code></em>
+: An ASCII string specifying the URI.</p>
+<p>An example of the link attributes to the cairo website:</p>
+<pre class="programlisting">
+"uri='http://cairographics.org'"
+</pre>
+</div>
+<div class="refsect3">
+<a name="file-link"></a><h4>File Links</h4>
+<p>A file link is a link a location in another PDF file.</p>
+<p>The file attribute (required) specifies the name of the PDF file:</p>
+<p><em class="parameter"><code>file</code></em>
+: File name of PDF file to link to.</p>
+<p>The position is specified by either:</p>
+<p> <em class="parameter"><code>dest</code></em>
+: a UTF-8 string specifying the named destination in the PDF file.</p>
+<p>or</p>
+<p> <em class="parameter"><code>page</code></em>
+: An integer specifying the page number in the PDF file.</p>
+<p> <em class="parameter"><code>pos</code></em>
+: [optional] An array of two floats specifying the x,y position
+ on the page. Default is 0,0.</p>
+<p>An example of the link attributes to PDF file:</p>
+<pre class="programlisting">
+"file='document.pdf' page=16 pos=[25 40]"
+</pre>
+</div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="dest"></a><h3>Destination Tags</h3>
+<p>A destination is specified by enclosing the destination drawing
+operations with the <a class="link" href="cairo-Tags-and-Links.html#CAIRO-TAG-DEST:CAPS" title="CAIRO_TAG_DEST"><code class="literal">CAIRO_TAG_DEST</code></a> tag.</p>
+<p><em class="parameter"><code>name</code></em>
+: [required] A UTF-8 string specifying the name of this destination.</p>
+<p><em class="parameter"><code>x</code></em>
+: [optional] A float specifying the x coordinate of destination
+                position on this page. If not specified the default
+                x coordinate is the left side of the extents of the
+                operations enclosed by the <a class="link" href="cairo-Tags-and-Links.html#CAIRO-TAG-DEST:CAPS" title="CAIRO_TAG_DEST"><code class="literal">CAIRO_TAG_DEST</code></a> begin/end tags. If
+                no operations are enclosed, the x coordidate is 0.</p>
+<p><em class="parameter"><code>y</code></em>
+: [optional] A float specifying the y coordinate of destination
+                position on this page. If not specified the default
+                y coordinate is the top of the extents of the
+                operations enclosed by the <a class="link" href="cairo-Tags-and-Links.html#CAIRO-TAG-DEST:CAPS" title="CAIRO_TAG_DEST"><code class="literal">CAIRO_TAG_DEST</code></a> begin/end tags. If
+                no operations are enclosed, the y coordidate is 0.</p>
+<p><em class="parameter"><code>internal</code></em>
+: A boolean that if true, the destination name may be
+           ommitted from PDF where possible. In this case, links
+           refer directly to the page and position instead of via
+           the named destination table. Note that if this
+           destination is referenced by another PDF (see <a class="link" href="cairo-Tags-and-Links.html#file-link" title="File Links">File Links</a>),
+           this attribute must be false. Default is false.</p>
+<div class="informalexample"><pre class="programlisting">
+/* Create a hyperlink */
+cairo_tag_begin (cr, CAIRO_TAG_LINK, "dest='mydest' internal");
+cairo_move_to (cr, 50, 50);
+cairo_show_text (cr, "This is a hyperlink.");
+cairo_tag_end (cr, CAIRO_TAG_LINK);
+
+/* Create a destination */
+cairo_tag_begin (cr, CAIRO_TAG_DEST, "name='mydest'");
+cairo_move_to (cr, 50, 250);
+cairo_show_text (cr, "This paragraph is the destination of the above link.");
+cairo_tag_end (cr, CAIRO_TAG_DEST);
+</pre></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="doc-struct"></a><h3>Document Structure (PDF)</h3>
+<p>The document structure tags provide a means of specifying structural information
+such as headers, paragraphs, tables, and figures. The inclusion of structural information faciliates:</p>
+<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
+<li class="listitem"><p>Extraction of text and graphics for copy and paste</p></li>
+<li class="listitem"><p>Reflow of text and graphics in the viewer</p></li>
+<li class="listitem"><p>Proccessing text eg searching and indexing</p></li>
+<li class="listitem"><p>Conversion to other formats</p></li>
+<li class="listitem"><p>Accessability support</p></li>
+</ul></div>
+<p>The list of structure types is specified in section 14.8.4 of the
+<a class="ulink" href="http://www.adobe.com/content/dam/Adobe/en/devnet/acrobat/pdfs/PDF32000_2008.pdf" target="_top">PDF Reference</a>.</p>
+<p>Note the PDF "Link" structure tag is the same as the cairo <a class="link" href="cairo-Tags-and-Links.html#CAIRO-TAG-LINK:CAPS" title="CAIRO_TAG_LINK"><code class="literal">CAIRO_TAG_LINK</code></a> tag.</p>
+<p>The following example creates a document structure for a document containing two section, each with
+a header and a paragraph.</p>
+<div class="informalexample"><pre class="programlisting">
+cairo_tag_begin (cr, "Document", NULL);
+
+cairo_tag_begin (cr, "Sect", NULL);
+cairo_tag_begin (cr, "H1", NULL);
+cairo_show_text (cr, "Heading 1");
+cairo_tag_end (cr, "H1");
+
+cairo_tag_begin (cr, "P", NULL);
+cairo_show_text (cr, "Paragraph 1");
+cairo_tag_end (cr, "P");
+cairo_tag_end (cr, "Sect");
+
+cairo_tag_begin (cr, "Sect", NULL);
+cairo_tag_begin (cr, "H1", NULL);
+cairo_show_text (cr, "Heading 2");
+cairo_tag_end (cr, "H1");
+
+cairo_tag_begin (cr, "P", NULL);
+cairo_show_text (cr, "Paragraph 2");
+cairo_tag_end (cr, "P");
+cairo_tag_end (cr, "Sect");
+
+cairo_tag_end (cr, "Document");
+</pre></div>
+</div>
+</div>
+<div class="refsect1">
+<a name="cairo-Tags-and-Links.functions_details"></a><h2>Functions</h2>
+<div class="refsect2">
+<a name="cairo-tag-begin"></a><h3>cairo_tag_begin ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>
+cairo_tag_begin (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
+                 <em class="parameter"><code>const <span class="type">char</span> *tag_name</code></em>,
+                 <em class="parameter"><code>const <span class="type">char</span> *attributes</code></em>);</pre>
+<p>Marks the beginning of the <em class="parameter"><code>tag_name</code></em>
+ structure. Call
+<a class="link" href="cairo-Tags-and-Links.html#cairo-tag-end" title="cairo_tag_end ()"><code class="function">cairo_tag_end()</code></a> with the same <em class="parameter"><code>tag_name</code></em>
+ to mark the end of the
+structure.</p>
+<p>The attributes string is of the form "key1=value2 key2=value2 ...".
+Values may be boolean (true/false or 1/0), integer, float, string,
+or an array.</p>
+<p>String values are enclosed in single quotes
+('). Single quotes and backslashes inside the string should be
+escaped with a backslash.</p>
+<p>Boolean values may be set to true by only
+specifying the key. eg the attribute string "key" is the equivalent
+to "key=true".</p>
+<p>Arrays are enclosed in '[]'. eg "rect=[1.2 4.3 2.0 3.0]".</p>
+<p>If no attributes are required, <em class="parameter"><code>attributes</code></em>
+ can be an empty string or NULL.</p>
+<p>See <a class="link" href="cairo-Tags-and-Links.html#cairo-Tags-and-Links.description" title="Description">Tags and Links Description</a>
+for the list of tags and attributes.</p>
+<p>Invalid nesting of tags or invalid attributes will cause <em class="parameter"><code>cr</code></em>
+ to
+shutdown with a status of <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-TAG-ERROR:CAPS"><code class="literal">CAIRO_STATUS_TAG_ERROR</code></a>.</p>
+<p>See <a class="link" href="cairo-Tags-and-Links.html#cairo-tag-end" title="cairo_tag_end ()"><code class="function">cairo_tag_end()</code></a>.</p>
+<div class="refsect3">
+<a name="id-1.3.9.7.2.13"></a><h4>Parameters</h4>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>cr</p></td>
+<td class="parameter_description"><p>a cairo context</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>tag_name</p></td>
+<td class="parameter_description"><p>tag name</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>attributes</p></td>
+<td class="parameter_description"><p>tag attributes</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<p class="since">Since 1.16</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="cairo-tag-end"></a><h3>cairo_tag_end ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>
+cairo_tag_end (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
+               <em class="parameter"><code>const <span class="type">char</span> *tag_name</code></em>);</pre>
+<p>Marks the end of the <em class="parameter"><code>tag_name</code></em>
+ structure.</p>
+<p>Invalid nesting of tags will cause <em class="parameter"><code>cr</code></em>
+ to shutdown with a status of
+<a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-TAG-ERROR:CAPS"><code class="literal">CAIRO_STATUS_TAG_ERROR</code></a>.</p>
+<p>See <a class="link" href="cairo-Tags-and-Links.html#cairo-tag-begin" title="cairo_tag_begin ()"><code class="function">cairo_tag_begin()</code></a>.</p>
+<div class="refsect3">
+<a name="id-1.3.9.7.3.7"></a><h4>Parameters</h4>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>cr</p></td>
+<td class="parameter_description"><p>a cairo context</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>tag_name</p></td>
+<td class="parameter_description"><p>tag name</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<p class="since">Since 1.16</p>
+</div>
+</div>
+<div class="refsect1">
+<a name="cairo-Tags-and-Links.other_details"></a><h2>Types and Values</h2>
+<div class="refsect2">
+<a name="CAIRO-TAG-DEST:CAPS"></a><h3>CAIRO_TAG_DEST</h3>
+<pre class="programlisting">#define CAIRO_TAG_DEST "cairo.dest"
+</pre>
+<p>Create a destination for a hyperlink. Destination tag attributes
+are detailed at <a href="../cairo/cairo-Tags-and-Links.html#dest">Destinations</a>.</p>
+<p class="since">Since 1.16</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="CAIRO-TAG-LINK:CAPS"></a><h3>CAIRO_TAG_LINK</h3>
+<pre class="programlisting">#define CAIRO_TAG_LINK "Link"
+</pre>
+<p>Create hyperlink. Link tag attributes are detailed at
+<a href="../cairo/cairo-Tags-and-Links.html#link">Links</a>.</p>
+<p class="since">Since 1.16</p>
+</div>
+</div>
+<div class="refsect1">
+<a name="cairo-Tags-and-Links.see-also"></a><h2>See Also</h2>
+<p><span class="type">cairo_pdf_surface_t</span></p>
+</div>
+</div>
+<div class="footer">
+<hr>
+          Generated by GTK-Doc V1.20</div>
+</body>
+</html>