RubyGems - cairo - Versions diffs - 1.7.0-x86-mswin32 → 1.8.0-x86-mswin32 - Mend

cairo 1.7.0-x86-mswin32 → 1.8.0-x86-mswin32

Potentially problematic release.

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

Files changed (167) hide show

data/ChangeLog +32 -0
data/NEWS +9 -1
data/README +1 -0
data/Rakefile +2 -2
data/cairo/DLL_FAQ.txt +397 -0
data/cairo/README.txt +53 -0
data/cairo/USAGE.txt +94 -0
data/cairo/bin/libcairo-2.dll +0 -0
data/cairo/bin/libpng12-0.dll +0 -0
data/cairo/bin/zlib1.dll +0 -0
data/cairo/include/cairo/cairo-deprecated.h +0 -4
data/cairo/include/cairo/cairo-features.h +7 -22
data/cairo/include/cairo/cairo-pdf.h +1 -1
data/cairo/include/cairo/cairo-ps.h +1 -1
data/cairo/include/cairo/cairo-svg.h +1 -1
data/cairo/include/cairo/cairo-version.h +8 -0
data/cairo/include/cairo/cairo-win32.h +9 -1
data/cairo/include/cairo/cairo.h +420 -32
data/cairo/include/libpng12/png.h +3592 -0
data/cairo/include/libpng12/pngconf.h +1481 -0
data/cairo/include/png.h +36 -13
data/cairo/include/pngconf.h +3 -3
data/cairo/include/zconf.h +332 -0
data/cairo/include/zlib.h +1357 -0
data/cairo/lib/cairo.def +22 -0
data/cairo/lib/cairo.lib +0 -0
data/cairo/lib/libcairo.dll.a +0 -0
data/cairo/lib/libpng.def +1 -0
data/cairo/lib/libpng.lib +0 -0
data/cairo/lib/libpng12.dll.a +0 -0
data/cairo/lib/pkgconfig/cairo-pdf.pc +5 -5
data/cairo/lib/pkgconfig/cairo-png.pc +5 -5
data/cairo/lib/pkgconfig/cairo-ps.pc +5 -5
data/cairo/lib/pkgconfig/cairo-svg.pc +4 -4
data/cairo/lib/pkgconfig/cairo-win32-font.pc +4 -4
data/cairo/lib/pkgconfig/cairo-win32.pc +4 -4
data/cairo/lib/pkgconfig/cairo.pc +4 -4
data/cairo/lib/pkgconfig/libpng.pc +3 -2
data/cairo/lib/pkgconfig/libpng12.pc +3 -2
data/cairo/lib/zdll.exp +0 -0
data/cairo/lib/zdll.lib +0 -0
data/cairo/lib/zlib.def +60 -0
data/cairo/manifest/cairo-dev_1.8.0-1_win32.mft +76 -0
data/cairo/manifest/cairo_1.8.0-1_win32.mft +5 -0
data/cairo/manifest/{libpng-dev-1.2.29.mft → libpng-dev_1.2.32-1_win32.mft} +5 -2
data/cairo/manifest/libpng_1.2.32-1_win32.mft +2 -0
data/cairo/share/doc/{cairo-1.6.4-2 → cairo_1.8.0-1_win32}/COPYING +0 -0
data/cairo/share/doc/{cairo-1.6.4-2 → cairo_1.8.0-1_win32}/COPYING-LGPL-2.1 +0 -0
data/cairo/share/doc/{cairo-1.6.4-2 → cairo_1.8.0-1_win32}/COPYING-MPL-1.1 +0 -0
data/cairo/share/gtk-doc/html/cairo/bindings-errors.html +15 -11
data/cairo/share/gtk-doc/html/cairo/bindings-fonts.html +15 -11
data/cairo/share/gtk-doc/html/cairo/bindings-memory.html +20 -16
data/cairo/share/gtk-doc/html/cairo/bindings-overloading.html +16 -12
data/cairo/share/gtk-doc/html/cairo/bindings-path.html +17 -13
data/cairo/share/gtk-doc/html/cairo/bindings-patterns.html +25 -21
data/cairo/share/gtk-doc/html/cairo/bindings-return-values.html +17 -13
data/cairo/share/gtk-doc/html/cairo/bindings-streams.html +14 -10
data/cairo/share/gtk-doc/html/cairo/bindings-surfaces.html +19 -15
data/cairo/share/gtk-doc/html/cairo/cairo-context.html +2721 -0
data/cairo/share/gtk-doc/html/cairo/cairo-drawing.html +57 -0
data/cairo/share/gtk-doc/html/cairo/cairo-error-status.html +361 -0
data/cairo/share/gtk-doc/html/cairo/cairo-font-face.html +418 -0
data/cairo/share/gtk-doc/html/cairo/cairo-font-options.html +695 -0
data/cairo/share/gtk-doc/html/cairo/cairo-fonts.html +63 -0
data/cairo/share/gtk-doc/html/cairo/cairo-ft-font.html +318 -0
data/cairo/share/gtk-doc/html/cairo/cairo-image-surface.html +486 -0
data/cairo/share/gtk-doc/html/cairo/{cairo-cairo-matrix-t.html → cairo-matrix.html} +137 -156
data/cairo/share/gtk-doc/html/cairo/{cairo-Paths.html → cairo-paths.html} +275 -306
data/cairo/share/gtk-doc/html/cairo/cairo-pattern.html +1524 -0
data/cairo/share/gtk-doc/html/cairo/{cairo-PDF-Surfaces.html → cairo-pdf-surface.html} +60 -70
data/cairo/share/gtk-doc/html/cairo/cairo-png-functions.html +332 -0
data/cairo/share/gtk-doc/html/cairo/{cairo-PostScript-Surfaces.html → cairo-ps-surface.html} +131 -150
data/cairo/share/gtk-doc/html/cairo/cairo-quartz-font.html +153 -0
data/cairo/share/gtk-doc/html/cairo/{cairo-Quartz-Surfaces.html → cairo-quartz-surface.html} +53 -62
data/cairo/share/gtk-doc/html/cairo/cairo-scaled-font.html +1051 -0
data/cairo/share/gtk-doc/html/cairo/cairo-support.html +54 -0
data/cairo/share/gtk-doc/html/cairo/cairo-surface.html +1064 -0
data/cairo/share/gtk-doc/html/cairo/cairo-surfaces.html +69 -0
data/cairo/share/gtk-doc/html/cairo/cairo-svg-surface.html +324 -0
data/cairo/share/gtk-doc/html/cairo/cairo-text.html +1264 -0
data/cairo/share/gtk-doc/html/cairo/{cairo-Transformations.html → cairo-transformations.html} +98 -115
data/cairo/share/gtk-doc/html/cairo/cairo-types.html +134 -0
data/cairo/share/gtk-doc/html/cairo/cairo-user-font.html +769 -0
data/cairo/share/gtk-doc/html/cairo/cairo-version-info.html +355 -0
data/cairo/share/gtk-doc/html/cairo/cairo-win32-font.html +366 -0
data/cairo/share/gtk-doc/html/cairo/cairo-win32-surface.html +321 -0
data/cairo/share/gtk-doc/html/cairo/{cairo-XLib-Surfaces.html → cairo-xlib-surface.html} +104 -121
data/cairo/share/gtk-doc/html/cairo/cairo.devhelp +390 -405
data/cairo/share/gtk-doc/html/cairo/cairo.devhelp2 +390 -405
data/cairo/share/gtk-doc/html/cairo/index-1.2.html +63 -59
data/cairo/share/gtk-doc/html/cairo/index-1.4.html +45 -41
data/cairo/share/gtk-doc/html/cairo/index-1.6.html +29 -23
data/cairo/share/gtk-doc/html/cairo/index-1.8.html +107 -0
data/cairo/share/gtk-doc/html/cairo/index-all.html +759 -0
data/cairo/share/gtk-doc/html/cairo/index.html +51 -41
data/cairo/share/gtk-doc/html/cairo/index.sgml +478 -466
data/cairo/share/gtk-doc/html/cairo/language-bindings.html +22 -18
data/cairo/share/gtk-doc/html/cairo/style.css +14 -2
data/cairo/share/man/man3/libpng.3 +443 -17
data/cairo/share/man/man3/libpngpf.3 +618 -102
data/cairo/share/man/man5/png.5 +1 -1
data/cairo/src/tml/make/cairo_1.8.0-1_win32.log +1021 -0
data/cairo/src/tml/make/cairo_1.8.0-1_win32.sh +68 -0
data/cairo/src/tml/make/libpng_1.2.32-1_win32.log +269 -0
data/cairo/src/tml/make/libpng_1.2.32-1_win32.sh +63 -0
data/cairo/test/example_d.exe +0 -0
data/cairo/test/minigzip_d.exe +0 -0
data/cairo/test/testzlib_d.exe +0 -0
data/cairo/test/untgz_d.exe +0 -0
data/doc/en/cairo-context.html +81 -91
data/doc/en/cairo-font-options.html +11 -26
data/doc/en/cairo-text-cluster-flag.html +35 -0
data/doc/en/cairo-user-font-face-text-to-glyphs-data.html +3 -3
data/doc/en/cairo.html +38 -42
data/doc/en/index.html +129 -142
data/doc/ja/cairo-font-options.html +3 -25
data/doc/ja/cairo-text-cluster-flag.html +46 -0
data/doc/ja/cairo-user-font-face-text-to-glyphs-data.html +16 -15
data/doc/ja/cairo.html +3 -7
data/doc/ja/index.html +9 -17
data/src/cairo.def +1 -1
data/src/cairo.so +0 -0
data/src/lib/cairo/constants.rb +3 -1
data/src/libruby-cairo.a +0 -0
data/src/rb_cairo.c +2 -2
data/src/rb_cairo.h +5 -5
data/src/rb_cairo_constants.c +12 -19
data/src/rb_cairo_context.c +25 -21
data/src/rb_cairo_font_face.c +44 -29
data/src/rb_cairo_font_options.c +1 -23
data/src/rb_cairo_scaled_font.c +5 -5
data/test/test_constants.rb +6 -9
data/test/test_context.rb +0 -12
data/test/test_font_face.rb +7 -7
data/test/test_font_options.rb +2 -21
data/test/test_scaled_font.rb +3 -3
data/test/test_text_to_glyphs_data.rb +19 -15
metadata +68 -45
data/cairo/make/cairo-1.6.4-2.sh +0 -55
data/cairo/make/libpng-1.2.29.sh +0 -35
data/cairo/manifest/cairo-1.6.4-2.mft +0 -6
data/cairo/manifest/cairo-dev-1.6.4-2.mft +0 -72
data/cairo/manifest/libpng-1.2.29.mft +0 -2
data/cairo/share/gtk-doc/html/cairo/Drawing.html +0 -53
data/cairo/share/gtk-doc/html/cairo/Fonts.html +0 -56
data/cairo/share/gtk-doc/html/cairo/Support.html +0 -50
data/cairo/share/gtk-doc/html/cairo/Surfaces.html +0 -65
data/cairo/share/gtk-doc/html/cairo/cairo-Error-Handling.html +0 -328
data/cairo/share/gtk-doc/html/cairo/cairo-Font-Options.html +0 -720
data/cairo/share/gtk-doc/html/cairo/cairo-FreeType-Fonts.html +0 -297
data/cairo/share/gtk-doc/html/cairo/cairo-Image-Surfaces.html +0 -484
data/cairo/share/gtk-doc/html/cairo/cairo-PNG-Support.html +0 -345
data/cairo/share/gtk-doc/html/cairo/cairo-Patterns.html +0 -1560
data/cairo/share/gtk-doc/html/cairo/cairo-Quartz-Fonts.html +0 -161
data/cairo/share/gtk-doc/html/cairo/cairo-SVG-Surfaces.html +0 -337
data/cairo/share/gtk-doc/html/cairo/cairo-Scaled-Fonts.html +0 -823
data/cairo/share/gtk-doc/html/cairo/cairo-Text.html +0 -836
data/cairo/share/gtk-doc/html/cairo/cairo-Types.html +0 -143
data/cairo/share/gtk-doc/html/cairo/cairo-Version-Information.html +0 -325
data/cairo/share/gtk-doc/html/cairo/cairo-Win32-Fonts.html +0 -381
data/cairo/share/gtk-doc/html/cairo/cairo-Win32-Surfaces.html +0 -331
data/cairo/share/gtk-doc/html/cairo/cairo-cairo-font-face-t.html +0 -427
data/cairo/share/gtk-doc/html/cairo/cairo-cairo-surface-t.html +0 -995
data/cairo/share/gtk-doc/html/cairo/cairo-cairo-t.html +0 -2795
data/cairo/share/gtk-doc/html/cairo/ix01.html +0 -693
data/doc/en/cairo-lcd-filter.html +0 -39
data/doc/ja/cairo-lcd-filter.html +0 -63

data/cairo/share/gtk-doc/html/cairo/cairo-types.html ADDED Viewed

@@ -0,0 +1,134 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>Types</title>
+<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<link rel="start" href="index.html" title="Cairo: A Vector Graphics Library">
+<link rel="up" href="cairo-support.html" title="Utilities">
+<link rel="prev" href="cairo-version-info.html" title="Version Information">
+<link rel="next" href="index-all.html" title="Index">
+<meta name="generator" content="GTK-Doc V1.10 (XML mode)">
+<link rel="stylesheet" href="style.css" type="text/css">
+<link rel="chapter" href="cairo-drawing.html" title="Drawing">
+<link rel="chapter" href="cairo-fonts.html" title="Fonts">
+<link rel="chapter" href="cairo-surfaces.html" title="Surfaces">
+<link rel="chapter" href="cairo-support.html" title="Utilities">
+<link rel="index" href="index-all.html" title="Index">
+<link rel="index" href="index-1.2.html" title="Index of new symbols in 1.2">
+<link rel="index" href="index-1.4.html" title="Index of new symbols in 1.4">
+<link rel="index" href="index-1.6.html" title="Index of new symbols in 1.6">
+<link rel="index" href="index-1.8.html" title="Index of new symbols in 1.8">
+<link rel="appendix" href="language-bindings.html" title="Appendix A. Creating a language binding for cairo">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
+<tr valign="middle">
+<td><a accesskey="p" href="cairo-version-info.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
+<td><a accesskey="u" href="cairo-support.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
+<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
+<th width="100%" align="center">Cairo: A Vector Graphics Library</th>
+<td><a accesskey="n" href="index-all.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
+</tr>
+<tr><td colspan="5" class="shortcuts"><nobr><a href="#cairo-types.synopsis" class="shortcut">Top</a>
+                   |
+                  <a href="#cairo-types.description" class="shortcut">Description</a></nobr></td></tr>
+</table>
+<div class="refentry" lang="en">
+<a name="cairo-types"></a><div class="titlepage"></div>
+<div class="refnamediv"><table width="100%"><tr>
+<td valign="top">
+<h2><span class="refentrytitle"><a name="cairo-types.top_of_page"></a>Types</span></h2>
+<p>Types — Generic data types</p>
+</td>
+<td valign="top" align="right"></td>
+</tr></table></div>
+<div class="refsynopsisdiv">
+<a name="cairo-types.synopsis"></a><h2>Synopsis</h2>
+<pre class="synopsis">
+typedef             <a class="link" href="cairo-types.html#cairo-bool-t" title="cairo_bool_t">cairo_bool_t</a>;
+                    <a class="link" href="cairo-types.html#cairo-user-data-key-t" title="cairo_user_data_key_t">cairo_user_data_key_t</a>;
+void                (<a class="link" href="cairo-types.html#cairo-destroy-func-t" title="cairo_destroy_func_t ()">*cairo_destroy_func_t</a>)             (void *data);
+</pre>
+</div>
+<div class="refsect1" lang="en">
+<a name="cairo-types.description"></a><h2>Description</h2>
+<p>
+Generic data types used in the cairo API
+</p>
+</div>
+<div class="refsect1" lang="en">
+<a name="cairo-types.details"></a><h2>Details</h2>
+<div class="refsect2" lang="en">
+<a name="cairo-bool-t"></a><h3>cairo_bool_t</h3>
+<pre class="programlisting">typedef int cairo_bool_t;
+</pre>
+<p>
+<a class="link" href="cairo-types.html#cairo-bool-t" title="cairo_bool_t"><span class="type">cairo_bool_t</span></a> is used for boolean values. Returns of type
+<a class="link" href="cairo-types.html#cairo-bool-t" title="cairo_bool_t"><span class="type">cairo_bool_t</span></a> will always be either 0 or 1, but testing against
+these values explicitly is not encouraged; just use the
+value as a boolean condition.
+</p>
+<p>
+</p>
+<div class="informalexample"><pre class="programlisting">
+ if (cairo_in_stroke (cr, x, y)) {
+     /* do something */
+ }
+</pre></div>
+<p>
+</p>
+</div>
+<hr>
+<div class="refsect2" lang="en">
+<a name="cairo-user-data-key-t"></a><h3>cairo_user_data_key_t</h3>
+<pre class="programlisting">typedef struct {
+    int unused;
+} cairo_user_data_key_t;
+</pre>
+<p>
+<a class="link" href="cairo-types.html#cairo-user-data-key-t" title="cairo_user_data_key_t"><span class="type">cairo_user_data_key_t</span></a> is used for attaching user data to cairo
+data structures.  The actual contents of the struct is never used,
+and there is no need to initialize the object; only the unique
+address of a <span class="type">cairo_data_key_t</span> object is used.  Typically, you
+would just use the address of a static <span class="type">cairo_data_key_t</span> object.</p>
+<p>
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody><tr>
+<td><p><span class="term">int <em class="structfield"><code>unused</code></em>;</span></p></td>
+<td> not used; ignore.
+</td>
+</tr></tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2" lang="en">
+<a name="cairo-destroy-func-t"></a><h3>cairo_destroy_func_t ()</h3>
+<pre class="programlisting">void                (*cairo_destroy_func_t)             (void *data);</pre>
+<p>
+<a class="link" href="cairo-types.html#cairo-destroy-func-t" title="cairo_destroy_func_t ()"><span class="type">cairo_destroy_func_t</span></a> the type of function which is called when a
+data element is destroyed. It is passed the pointer to the data
+element and should free any memory and resources allocated for it.</p>
+<p>
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody><tr>
+<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
+<td> The data element being destroyed.
+</td>
+</tr></tbody>
+</table></div>
+</div>
+</div>
+</div>
+<div class="footer">
+<hr>
+          Generated by GTK-Doc V1.10</div>
+</body>
+</html>

data/cairo/share/gtk-doc/html/cairo/cairo-user-font.html ADDED Viewed

@@ -0,0 +1,769 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>User Fonts</title>
+<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<link rel="start" href="index.html" title="Cairo: A Vector Graphics Library">
+<link rel="up" href="cairo-fonts.html" title="Fonts">
+<link rel="prev" href="cairo-quartz-font.html" title="Quartz (CGFont) Fonts">
+<link rel="next" href="cairo-surfaces.html" title="Surfaces">
+<meta name="generator" content="GTK-Doc V1.10 (XML mode)">
+<link rel="stylesheet" href="style.css" type="text/css">
+<link rel="chapter" href="cairo-drawing.html" title="Drawing">
+<link rel="chapter" href="cairo-fonts.html" title="Fonts">
+<link rel="chapter" href="cairo-surfaces.html" title="Surfaces">
+<link rel="chapter" href="cairo-support.html" title="Utilities">
+<link rel="index" href="index-all.html" title="Index">
+<link rel="index" href="index-1.2.html" title="Index of new symbols in 1.2">
+<link rel="index" href="index-1.4.html" title="Index of new symbols in 1.4">
+<link rel="index" href="index-1.6.html" title="Index of new symbols in 1.6">
+<link rel="index" href="index-1.8.html" title="Index of new symbols in 1.8">
+<link rel="appendix" href="language-bindings.html" title="Appendix A. Creating a language binding for cairo">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
+<tr valign="middle">
+<td><a accesskey="p" href="cairo-quartz-font.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
+<td><a accesskey="u" href="cairo-fonts.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
+<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
+<th width="100%" align="center">Cairo: A Vector Graphics Library</th>
+<td><a accesskey="n" href="cairo-surfaces.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
+</tr>
+<tr><td colspan="5" class="shortcuts"><nobr><a href="#cairo-user-font.synopsis" class="shortcut">Top</a>
+                   |
+                  <a href="#cairo-user-font.description" class="shortcut">Description</a></nobr></td></tr>
+</table>
+<div class="refentry" lang="en">
+<a name="cairo-user-font"></a><div class="titlepage"></div>
+<div class="refnamediv"><table width="100%"><tr>
+<td valign="top">
+<h2><span class="refentrytitle"><a name="cairo-user-font.top_of_page"></a>User Fonts</span></h2>
+<p>User Fonts — Font support with font data provided by the user</p>
+</td>
+<td valign="top" align="right"></td>
+</tr></table></div>
+<div class="refsynopsisdiv">
+<a name="cairo-user-font.synopsis"></a><h2>Synopsis</h2>
+<pre class="synopsis">
+#define             <a class="link" href="cairo-user-font.html#CAIRO-HAS-USER-FONT:CAPS" title="CAIRO_HAS_USER_FONT">CAIRO_HAS_USER_FONT</a>
+<a class="link" href="cairo-error-status.html#cairo-status-t" title="enum cairo_status_t">cairo_status_t</a>      (<a class="link" href="cairo-user-font.html#cairo-user-scaled-font-init-func-t" title="cairo_user_scaled_font_init_func_t ()">*cairo_user_scaled_font_init_func_t</a>)
+                                                        (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font,
+                                                         <a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
+                                                         <a class="link" href="cairo-scaled-font.html#cairo-font-extents-t" title="cairo_font_extents_t">cairo_font_extents_t</a> *extents);
+<a class="link" href="cairo-error-status.html#cairo-status-t" title="enum cairo_status_t">cairo_status_t</a>      (<a class="link" href="cairo-user-font.html#cairo-user-scaled-font-render-glyph-func-t" title="cairo_user_scaled_font_render_glyph_func_t ()">*cairo_user_scaled_font_render_glyph_func_t</a>)
+                                                        (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font,
+                                                         unsigned long  glyph,
+                                                         <a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
+                                                         <a class="link" href="cairo-scaled-font.html#cairo-text-extents-t" title="cairo_text_extents_t">cairo_text_extents_t</a> *extents);
+<a class="link" href="cairo-error-status.html#cairo-status-t" title="enum cairo_status_t">cairo_status_t</a>      (<a class="link" href="cairo-user-font.html#cairo-user-scaled-font-text-to-glyphs-func-t" title="cairo_user_scaled_font_text_to_glyphs_func_t ()">*cairo_user_scaled_font_text_to_glyphs_func_t</a>)
+                                                        (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font,
+                                                         const char *utf8,
+                                                         int utf8_len,
+                                                         <a class="link" href="cairo-text.html#cairo-glyph-t" title="cairo_glyph_t">cairo_glyph_t</a> **glyphs,
+                                                         int *num_glyphs,
+                                                         <a class="link" href="cairo-text.html#cairo-text-cluster-t" title="cairo_text_cluster_t">cairo_text_cluster_t</a> **clusters,
+                                                         int *num_clusters,
+                                                         <a class="link" href="cairo-text.html#cairo-text-cluster-flags-t" title="enum cairo_text_cluster_flags_t">cairo_text_cluster_flags_t</a> *cluster_flags);
+<a class="link" href="cairo-error-status.html#cairo-status-t" title="enum cairo_status_t">cairo_status_t</a>      (<a class="link" href="cairo-user-font.html#cairo-user-scaled-font-unicode-to-glyph-func-t" title="cairo_user_scaled_font_unicode_to_glyph_func_t ()">*cairo_user_scaled_font_unicode_to_glyph_func_t</a>)
+                                                        (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font,
+                                                         unsigned long  unicode,
+                                                         unsigned long *glyph_index);
+<a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t">cairo_font_face_t</a>*  <a class="link" href="cairo-user-font.html#cairo-user-font-face-create" title="cairo_user_font_face_create ()">cairo_user_font_face_create</a>         (void);
+void                <a class="link" href="cairo-user-font.html#cairo-user-font-face-set-init-func" title="cairo_user_font_face_set_init_func ()">cairo_user_font_face_set_init_func</a>  (<a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t">cairo_font_face_t</a> *font_face,
+                                                         <a class="link" href="cairo-user-font.html#cairo-user-scaled-font-init-func-t" title="cairo_user_scaled_font_init_func_t ()">cairo_user_scaled_font_init_func_t</a> init_func);
+<a class="link" href="cairo-user-font.html#cairo-user-scaled-font-init-func-t" title="cairo_user_scaled_font_init_func_t ()">cairo_user_scaled_font_init_func_t</a> <a class="link" href="cairo-user-font.html#cairo-user-font-face-get-init-func" title="cairo_user_font_face_get_init_func ()">cairo_user_font_face_get_init_func</a>
+                                                        (<a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t">cairo_font_face_t</a> *font_face);
+void                <a class="link" href="cairo-user-font.html#cairo-user-font-face-set-render-glyph-func" title="cairo_user_font_face_set_render_glyph_func ()">cairo_user_font_face_set_render_glyph_func</a>
+                                                        (<a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t">cairo_font_face_t</a> *font_face,
+                                                         <a class="link" href="cairo-user-font.html#cairo-user-scaled-font-render-glyph-func-t" title="cairo_user_scaled_font_render_glyph_func_t ()">cairo_user_scaled_font_render_glyph_func_t</a> render_glyph_func);
+<a class="link" href="cairo-user-font.html#cairo-user-scaled-font-render-glyph-func-t" title="cairo_user_scaled_font_render_glyph_func_t ()">cairo_user_scaled_font_render_glyph_func_t</a> <a class="link" href="cairo-user-font.html#cairo-user-font-face-get-render-glyph-func" title="cairo_user_font_face_get_render_glyph_func ()">cairo_user_font_face_get_render_glyph_func</a>
+                                                        (<a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t">cairo_font_face_t</a> *font_face);
+void                <a class="link" href="cairo-user-font.html#cairo-user-font-face-set-unicode-to-glyph-func" title="cairo_user_font_face_set_unicode_to_glyph_func ()">cairo_user_font_face_set_unicode_to_glyph_func</a>
+                                                        (<a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t">cairo_font_face_t</a> *font_face,
+                                                         <a class="link" href="cairo-user-font.html#cairo-user-scaled-font-unicode-to-glyph-func-t" title="cairo_user_scaled_font_unicode_to_glyph_func_t ()">cairo_user_scaled_font_unicode_to_glyph_func_t</a> unicode_to_glyph_func);
+<a class="link" href="cairo-user-font.html#cairo-user-scaled-font-unicode-to-glyph-func-t" title="cairo_user_scaled_font_unicode_to_glyph_func_t ()">cairo_user_scaled_font_unicode_to_glyph_func_t</a> <a class="link" href="cairo-user-font.html#cairo-user-font-face-get-unicode-to-glyph-func" title="cairo_user_font_face_get_unicode_to_glyph_func ()">cairo_user_font_face_get_unicode_to_glyph_func</a>
+                                                        (<a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t">cairo_font_face_t</a> *font_face);
+void                <a class="link" href="cairo-user-font.html#cairo-user-font-face-set-text-to-glyphs-func" title="cairo_user_font_face_set_text_to_glyphs_func ()">cairo_user_font_face_set_text_to_glyphs_func</a>
+                                                        (<a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t">cairo_font_face_t</a> *font_face,
+                                                         <a class="link" href="cairo-user-font.html#cairo-user-scaled-font-text-to-glyphs-func-t" title="cairo_user_scaled_font_text_to_glyphs_func_t ()">cairo_user_scaled_font_text_to_glyphs_func_t</a> text_to_glyphs_func);
+<a class="link" href="cairo-user-font.html#cairo-user-scaled-font-text-to-glyphs-func-t" title="cairo_user_scaled_font_text_to_glyphs_func_t ()">cairo_user_scaled_font_text_to_glyphs_func_t</a> <a class="link" href="cairo-user-font.html#cairo-user-font-face-get-text-to-glyphs-func" title="cairo_user_font_face_get_text_to_glyphs_func ()">cairo_user_font_face_get_text_to_glyphs_func</a>
+                                                        (<a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t">cairo_font_face_t</a> *font_face);
+</pre>
+</div>
+<div class="refsect1" lang="en">
+<a name="cairo-user-font.description"></a><h2>Description</h2>
+<p>
+The user-font feature allows the cairo user to provide drawings for glyphs
+in a font.  This is most useful in implementing fonts in non-standard
+formats, like SVG fonts and Flash fonts, but can also be used by games and
+other application to draw "funky" fonts.
+</p>
+</div>
+<div class="refsect1" lang="en">
+<a name="cairo-user-font.details"></a><h2>Details</h2>
+<div class="refsect2" lang="en">
+<a name="CAIRO-HAS-USER-FONT:CAPS"></a><h3>CAIRO_HAS_USER_FONT</h3>
+<pre class="programlisting">#define CAIRO_HAS_USER_FONT 1
+</pre>
+<p>
+Defined if the user font backend is available.
+This macro can be used to conditionally compile backend-specific code.
+The user font backend is always built in versions of cairo that support
+this feature (1.8 and later).
+</p>
+<p class="since">Since 1.8
+</p>
+</div>
+<hr>
+<div class="refsect2" lang="en">
+<a name="cairo-user-scaled-font-init-func-t"></a><h3>cairo_user_scaled_font_init_func_t ()</h3>
+<pre class="programlisting"><a class="link" href="cairo-error-status.html#cairo-status-t" title="enum cairo_status_t">cairo_status_t</a>      (*cairo_user_scaled_font_init_func_t)
+                                                        (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font,
+                                                         <a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
+                                                         <a class="link" href="cairo-scaled-font.html#cairo-font-extents-t" title="cairo_font_extents_t">cairo_font_extents_t</a> *extents);</pre>
+<p>
+<a class="link" href="cairo-user-font.html#cairo-user-scaled-font-init-func-t" title="cairo_user_scaled_font_init_func_t ()"><span class="type">cairo_user_scaled_font_init_func_t</span></a> is the type of function which is
+called when a scaled-font needs to be created for a user font-face.
+</p>
+<p>
+The cairo context <em class="parameter"><code>cr</code></em> is not used by the caller, but is prepared in font
+space, similar to what the cairo contexts passed to the render_glyph
+method will look like.  The callback can use this context for extents
+computation for example.  After the callback is called, <em class="parameter"><code>cr</code></em> is checked
+for any error status.
+</p>
+<p>
+The <em class="parameter"><code>extents</code></em> argument is where the user font sets the font extents for
+<em class="parameter"><code>scaled_font</code></em>.  It is in font space, which means that for most cases its
+ascent and descent members should add to 1.0.  <em class="parameter"><code>extents</code></em> is preset to
+hold a value of 1.0 for ascent, height, and max_x_advance, and 0.0 for
+descent and max_y_advance members.
+</p>
+<p>
+The callback is optional.  If not set, default font extents as described
+in the previous paragraph will be used.
+</p>
+<p>
+Note that <em class="parameter"><code>scaled_font</code></em> is not fully initialized at this
+point and trying to use it for text operations in the callback will result
+in deadlock.</p>
+<p>
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>scaled_font</code></em> :</span></p></td>
+<td> the scaled-font being created
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
+<td> a cairo context, in font space
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>extents</code></em> :</span></p></td>
+<td> font extents to fill in, in font space
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td> <a class="link" href="cairo-error-status.html#CAIRO-STATUS-SUCCESS:CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> upon success, or
+<a class="link" href="cairo-error-status.html#CAIRO-STATUS-USER-FONT-ERROR:CAPS"><code class="literal">CAIRO_STATUS_USER_FONT_ERROR</code></a> or any other error status on error.
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since  1.8
+</p>
+</div>
+<hr>
+<div class="refsect2" lang="en">
+<a name="cairo-user-scaled-font-render-glyph-func-t"></a><h3>cairo_user_scaled_font_render_glyph_func_t ()</h3>
+<pre class="programlisting"><a class="link" href="cairo-error-status.html#cairo-status-t" title="enum cairo_status_t">cairo_status_t</a>      (*cairo_user_scaled_font_render_glyph_func_t)
+                                                        (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font,
+                                                         unsigned long  glyph,
+                                                         <a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
+                                                         <a class="link" href="cairo-scaled-font.html#cairo-text-extents-t" title="cairo_text_extents_t">cairo_text_extents_t</a> *extents);</pre>
+<p>
+<a class="link" href="cairo-user-font.html#cairo-user-scaled-font-render-glyph-func-t" title="cairo_user_scaled_font_render_glyph_func_t ()"><span class="type">cairo_user_scaled_font_render_glyph_func_t</span></a> is the type of function which
+is called when a user scaled-font needs to render a glyph.
+</p>
+<p>
+The callback is mandatory, and expected to draw the glyph with code <em class="parameter"><code>glyph</code></em> to
+the cairo context <em class="parameter"><code>cr</code></em>.  <em class="parameter"><code>cr</code></em> is prepared such that the glyph drawing is done in
+font space.  That is, the matrix set on <em class="parameter"><code>cr</code></em> is the scale matrix of <em class="parameter"><code>scaled_font</code></em>,
+The <em class="parameter"><code>extents</code></em> argument is where the user font sets the font extents for
+<em class="parameter"><code>scaled_font</code></em>.  However, if user prefers to draw in user space, they can
+achieve that by changing the matrix on <em class="parameter"><code>cr</code></em>.  All cairo rendering operations
+to <em class="parameter"><code>cr</code></em> are permitted, however, the result is undefined if any source other
+than the default source on <em class="parameter"><code>cr</code></em> is used.  That means, glyph bitmaps should
+be rendered using <a class="link" href="cairo-context.html#cairo-mask" title="cairo_mask ()"><code class="function">cairo_mask()</code></a> instead of <a class="link" href="cairo-context.html#cairo-paint" title="cairo_paint ()"><code class="function">cairo_paint()</code></a>.
+</p>
+<p>
+Other non-default settings on <em class="parameter"><code>cr</code></em> include a font size of 1.0 (given that
+it is set up to be in font space), and font options corresponding to
+<em class="parameter"><code>scaled_font</code></em>.
+</p>
+<p>
+The <em class="parameter"><code>extents</code></em> argument is preset to have <code class="literal">x_bearing</code>,
+<code class="literal">width</code>, and <code class="literal">y_advance</code> of zero,
+<code class="literal">y_bearing</code> set to <code class="literal">-font_extents.ascent</code>,
+<code class="literal">height</code> to <code class="literal">font_extents.ascent+font_extents.descent</code>,
+and <code class="literal">x_advance</code> to <code class="literal">font_extents.max_x_advance</code>.
+The only field user needs to set in majority of cases is
+<code class="literal">x_advance</code>.
+If the <code class="literal">width</code> field is zero upon the callback returning
+(which is its preset value), the glyph extents are automatically computed
+based on the drawings done to <em class="parameter"><code>cr</code></em>.  This is in most cases exactly what the
+desired behavior is.  However, if for any reason the callback sets the
+extents, it must be ink extents, and include the extents of all drawing
+done to <em class="parameter"><code>cr</code></em> in the callback.</p>
+<p>
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>scaled_font</code></em> :</span></p></td>
+<td> user scaled-font
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>glyph</code></em> :</span></p></td>
+<td> glyph code to render
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
+<td> cairo context to draw to, in font space
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>extents</code></em> :</span></p></td>
+<td> glyph extents to fill in, in font space
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td> <a class="link" href="cairo-error-status.html#CAIRO-STATUS-SUCCESS:CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> upon success, or
+<a class="link" href="cairo-error-status.html#CAIRO-STATUS-USER-FONT-ERROR:CAPS"><code class="literal">CAIRO_STATUS_USER_FONT_ERROR</code></a> or any other error status on error.
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since  1.8
+</p>
+</div>
+<hr>
+<div class="refsect2" lang="en">
+<a name="cairo-user-scaled-font-text-to-glyphs-func-t"></a><h3>cairo_user_scaled_font_text_to_glyphs_func_t ()</h3>
+<pre class="programlisting"><a class="link" href="cairo-error-status.html#cairo-status-t" title="enum cairo_status_t">cairo_status_t</a>      (*cairo_user_scaled_font_text_to_glyphs_func_t)
+                                                        (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font,
+                                                         const char *utf8,
+                                                         int utf8_len,
+                                                         <a class="link" href="cairo-text.html#cairo-glyph-t" title="cairo_glyph_t">cairo_glyph_t</a> **glyphs,
+                                                         int *num_glyphs,
+                                                         <a class="link" href="cairo-text.html#cairo-text-cluster-t" title="cairo_text_cluster_t">cairo_text_cluster_t</a> **clusters,
+                                                         int *num_clusters,
+                                                         <a class="link" href="cairo-text.html#cairo-text-cluster-flags-t" title="enum cairo_text_cluster_flags_t">cairo_text_cluster_flags_t</a> *cluster_flags);</pre>
+<p>
+<a class="link" href="cairo-user-font.html#cairo-user-scaled-font-text-to-glyphs-func-t" title="cairo_user_scaled_font_text_to_glyphs_func_t ()"><span class="type">cairo_user_scaled_font_text_to_glyphs_func_t</span></a> is the type of function which
+is called to convert input text to an array of glyphs.  This is used by the
+<a class="link" href="cairo-text.html#cairo-show-text" title="cairo_show_text ()"><code class="function">cairo_show_text()</code></a> operation.
+</p>
+<p>
+Using this callback the user-font has full control on glyphs and their
+positions.  That means, it allows for features like ligatures and kerning,
+as well as complex <em class="firstterm">shaping</em> required for scripts like
+Arabic and Indic.
+</p>
+<p>
+The <em class="parameter"><code>num_glyphs</code></em> argument is preset to -1.  The callback should allocate an
+array for the resulting glyphs (using <code class="function">malloc()</code>), and populate the glyph indices and
+positions (in font space) assuming that the text is to be shown at the
+origin.  Cairo will free the glyph array when done with it, no matter what
+the return value of the callback is.
+</p>
+<p>
+If <em class="parameter"><code>glyphs</code></em> initially points to a non-<code class="literal">NULL</code> value, that array can be used
+as a glyph buffer, and <em class="parameter"><code>num_glyphs</code></em> points to the number of glyph
+entries available there.  If the provided glyph array is too short for
+the conversion (or for convenience), a new glyph array may be allocated
+using <a class="link" href="cairo-text.html#cairo-glyph-allocate" title="cairo_glyph_allocate ()"><code class="function">cairo_glyph_allocate()</code></a> and placed in <em class="parameter"><code>glyphs</code></em>.  Upon return,
+<em class="parameter"><code>num_glyphs</code></em> should contain the number of generated glyphs.
+If the value <em class="parameter"><code>glyphs</code></em> points at has changed after the call, cairo will
+free the allocated glyph array using <a class="link" href="cairo-text.html#cairo-glyph-free" title="cairo_glyph_free ()"><code class="function">cairo_glyph_free()</code></a>.
+</p>
+<p>
+If <em class="parameter"><code>clusters</code></em> is not <code class="literal">NULL</code>, <em class="parameter"><code>num_clusters</code></em> and <em class="parameter"><code>cluster_flags</code></em> are also non-<code class="literal">NULL</code>,
+and cluster mapping should be computed.
+The semantics of how cluster array allocation works is similar to the glyph
+array.  That is,
+if <em class="parameter"><code>clusters</code></em> initially points to a non-<code class="literal">NULL</code> value, that array may be used
+as a cluster buffer, and <em class="parameter"><code>num_clusters</code></em> points to the number of cluster
+entries available there.  If the provided cluster array is too short for
+the conversion (or for convenience), a new cluster array may be allocated
+using <a class="link" href="cairo-text.html#cairo-text-cluster-allocate" title="cairo_text_cluster_allocate ()"><code class="function">cairo_text_cluster_allocate()</code></a> and placed in <em class="parameter"><code>clusters</code></em>.  Upon return,
+<em class="parameter"><code>num_clusters</code></em> should contain the number of generated clusters.
+If the value <em class="parameter"><code>clusters</code></em> points at has changed after the call, cairo will
+free the allocated cluster array using <a class="link" href="cairo-text.html#cairo-text-cluster-free" title="cairo_text_cluster_free ()"><code class="function">cairo_text_cluster_free()</code></a>.
+</p>
+<p>
+The callback is optional.  If not set, or if <em class="parameter"><code>num_glyphs</code></em> is negative upon
+the callback returning, the unicode_to_glyph callback
+is tried.  See <a class="link" href="cairo-user-font.html#cairo-user-scaled-font-unicode-to-glyph-func-t" title="cairo_user_scaled_font_unicode_to_glyph_func_t ()"><span class="type">cairo_user_scaled_font_unicode_to_glyph_func_t</span></a>.
+</p>
+<p>
+Note: While cairo does not impose any limitation on glyph indices,
+some applications may assume that a glyph index fits in a 16-bit
+unsigned integer.  As such, it is advised that user-fonts keep their
+glyphs in the 0 to 65535 range.  Furthermore, some applications may
+assume that glyph 0 is a special glyph-not-found glyph.  User-fonts
+are advised to use glyph 0 for such purposes and do not use that
+glyph value for other purposes.</p>
+<p>
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>scaled_font</code></em> :</span></p></td>
+<td> the scaled-font being created
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>utf8</code></em> :</span></p></td>
+<td> a string of text encoded in UTF-8
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>utf8_len</code></em> :</span></p></td>
+<td> length of <em class="parameter"><code>utf8</code></em> in bytes
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>glyphs</code></em> :</span></p></td>
+<td> pointer to array of glyphs to fill, in font space
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>num_glyphs</code></em> :</span></p></td>
+<td> pointer to number of glyphs
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>clusters</code></em> :</span></p></td>
+<td> pointer to array of cluster mapping information to fill, or <code class="literal">NULL</code>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>num_clusters</code></em> :</span></p></td>
+<td> pointer to number of clusters
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>cluster_flags</code></em> :</span></p></td>
+<td> pointer to location to store cluster flags corresponding to the
+                output <em class="parameter"><code>clusters</code></em>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td> <a class="link" href="cairo-error-status.html#CAIRO-STATUS-SUCCESS:CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> upon success, or
+<a class="link" href="cairo-error-status.html#CAIRO-STATUS-USER-FONT-ERROR:CAPS"><code class="literal">CAIRO_STATUS_USER_FONT_ERROR</code></a> or any other error status on error.
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since  1.8
+</p>
+</div>
+<hr>
+<div class="refsect2" lang="en">
+<a name="cairo-user-scaled-font-unicode-to-glyph-func-t"></a><h3>cairo_user_scaled_font_unicode_to_glyph_func_t ()</h3>
+<pre class="programlisting"><a class="link" href="cairo-error-status.html#cairo-status-t" title="enum cairo_status_t">cairo_status_t</a>      (*cairo_user_scaled_font_unicode_to_glyph_func_t)
+                                                        (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font,
+                                                         unsigned long  unicode,
+                                                         unsigned long *glyph_index);</pre>
+<p>
+<a class="link" href="cairo-user-font.html#cairo-user-scaled-font-unicode-to-glyph-func-t" title="cairo_user_scaled_font_unicode_to_glyph_func_t ()"><span class="type">cairo_user_scaled_font_unicode_to_glyph_func_t</span></a> is the type of function which
+is called to convert an input Unicode character to a single glyph.
+This is used by the <a class="link" href="cairo-text.html#cairo-show-text" title="cairo_show_text ()"><code class="function">cairo_show_text()</code></a> operation.
+</p>
+<p>
+This callback is used to provide the same functionality as the
+text_to_glyphs callback does (see <a class="link" href="cairo-user-font.html#cairo-user-scaled-font-text-to-glyphs-func-t" title="cairo_user_scaled_font_text_to_glyphs_func_t ()"><span class="type">cairo_user_scaled_font_text_to_glyphs_func_t</span></a>)
+but has much less control on the output,
+in exchange for increased ease of use.  The inherent assumption to using
+this callback is that each character maps to one glyph, and that the
+mapping is context independent.  It also assumes that glyphs are positioned
+according to their advance width.  These mean no ligatures, kerning, or
+complex scripts can be implemented using this callback.
+</p>
+<p>
+The callback is optional, and only used if text_to_glyphs callback is not
+set or fails to return glyphs.  If this callback is not set, an identity
+mapping from Unicode code-points to glyph indices is assumed.
+</p>
+<p>
+Note: While cairo does not impose any limitation on glyph indices,
+some applications may assume that a glyph index fits in a 16-bit
+unsigned integer.  As such, it is advised that user-fonts keep their
+glyphs in the 0 to 65535 range.  Furthermore, some applications may
+assume that glyph 0 is a special glyph-not-found glyph.  User-fonts
+are advised to use glyph 0 for such purposes and do not use that
+glyph value for other purposes.</p>
+<p>
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>scaled_font</code></em> :</span></p></td>
+<td> the scaled-font being created
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>unicode</code></em> :</span></p></td>
+<td> input unicode character code-point
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>glyph_index</code></em> :</span></p></td>
+<td> output glyph index
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td> <a class="link" href="cairo-error-status.html#CAIRO-STATUS-SUCCESS:CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> upon success, or
+<a class="link" href="cairo-error-status.html#CAIRO-STATUS-USER-FONT-ERROR:CAPS"><code class="literal">CAIRO_STATUS_USER_FONT_ERROR</code></a> or any other error status on error.
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since  1.8
+</p>
+</div>
+<hr>
+<div class="refsect2" lang="en">
+<a name="cairo-user-font-face-create"></a><h3>cairo_user_font_face_create ()</h3>
+<pre class="programlisting"><a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t">cairo_font_face_t</a>*  cairo_user_font_face_create         (void);</pre>
+<p>
+Creates a new user font-face.
+</p>
+<p>
+Use the setter functions to associate callbacks with the returned
+user font.  The only mandatory callback is render_glyph.
+</p>
+<p>
+After the font-face is created, the user can attach arbitrary data
+(the actual font data) to it using <a class="link" href="cairo-font-face.html#cairo-font-face-set-user-data" title="cairo_font_face_set_user_data ()"><code class="function">cairo_font_face_set_user_data()</code></a>
+and access it from the user-font callbacks by using
+<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-get-font-face" title="cairo_scaled_font_get_font_face ()"><code class="function">cairo_scaled_font_get_font_face()</code></a> followed by
+<a class="link" href="cairo-font-face.html#cairo-font-face-get-user-data" title="cairo_font_face_get_user_data ()"><code class="function">cairo_font_face_get_user_data()</code></a>.</p>
+<p>
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody><tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td> a newly created <a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a>. Free with
+ <a class="link" href="cairo-font-face.html#cairo-font-face-destroy" title="cairo_font_face_destroy ()"><code class="function">cairo_font_face_destroy()</code></a> when you are done using it.
+</td>
+</tr></tbody>
+</table></div>
+<p class="since">Since  1.8
+</p>
+</div>
+<hr>
+<div class="refsect2" lang="en">
+<a name="cairo-user-font-face-set-init-func"></a><h3>cairo_user_font_face_set_init_func ()</h3>
+<pre class="programlisting">void                cairo_user_font_face_set_init_func  (<a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t">cairo_font_face_t</a> *font_face,
+                                                         <a class="link" href="cairo-user-font.html#cairo-user-scaled-font-init-func-t" title="cairo_user_scaled_font_init_func_t ()">cairo_user_scaled_font_init_func_t</a> init_func);</pre>
+<p>
+Sets the scaled-font initialization function of a user-font.
+See <a class="link" href="cairo-user-font.html#cairo-user-scaled-font-init-func-t" title="cairo_user_scaled_font_init_func_t ()"><span class="type">cairo_user_scaled_font_init_func_t</span></a> for details of how the callback
+works.
+</p>
+<p>
+The font-face should not be immutable or a <a class="link" href="cairo-error-status.html#CAIRO-STATUS-USER-FONT-IMMUTABLE:CAPS"><code class="literal">CAIRO_STATUS_USER_FONT_IMMUTABLE</code></a>
+error will occur.  A user font-face is immutable as soon as a scaled-font
+is created from it.</p>
+<p>
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>font_face</code></em> :</span></p></td>
+<td> A user font face
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>init_func</code></em> :</span></p></td>
+<td> The init callback, or <code class="literal">NULL</code>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since  1.8
+</p>
+</div>
+<hr>
+<div class="refsect2" lang="en">
+<a name="cairo-user-font-face-get-init-func"></a><h3>cairo_user_font_face_get_init_func ()</h3>
+<pre class="programlisting"><a class="link" href="cairo-user-font.html#cairo-user-scaled-font-init-func-t" title="cairo_user_scaled_font_init_func_t ()">cairo_user_scaled_font_init_func_t</a> cairo_user_font_face_get_init_func
+                                                        (<a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t">cairo_font_face_t</a> *font_face);</pre>
+<p>
+Gets the scaled-font initialization function of a user-font.</p>
+<p>
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>font_face</code></em> :</span></p></td>
+<td> A user font face
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td> The init callback of <em class="parameter"><code>font_face</code></em>
+or <code class="literal">NULL</code> if none set.
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since  1.8
+</p>
+</div>
+<hr>
+<div class="refsect2" lang="en">
+<a name="cairo-user-font-face-set-render-glyph-func"></a><h3>cairo_user_font_face_set_render_glyph_func ()</h3>
+<pre class="programlisting">void                cairo_user_font_face_set_render_glyph_func
+                                                        (<a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t">cairo_font_face_t</a> *font_face,
+                                                         <a class="link" href="cairo-user-font.html#cairo-user-scaled-font-render-glyph-func-t" title="cairo_user_scaled_font_render_glyph_func_t ()">cairo_user_scaled_font_render_glyph_func_t</a> render_glyph_func);</pre>
+<p>
+Sets the glyph rendering function of a user-font.
+See <a class="link" href="cairo-user-font.html#cairo-user-scaled-font-render-glyph-func-t" title="cairo_user_scaled_font_render_glyph_func_t ()"><span class="type">cairo_user_scaled_font_render_glyph_func_t</span></a> for details of how the callback
+works.
+</p>
+<p>
+The font-face should not be immutable or a <a class="link" href="cairo-error-status.html#CAIRO-STATUS-USER-FONT-IMMUTABLE:CAPS"><code class="literal">CAIRO_STATUS_USER_FONT_IMMUTABLE</code></a>
+error will occur.  A user font-face is immutable as soon as a scaled-font
+is created from it.
+</p>
+<p>
+The render_glyph callback is the only mandatory callback of a user-font.
+If the callback is <code class="literal">NULL</code> and a glyph is tried to be rendered using
+<em class="parameter"><code>font_face</code></em>, a <a class="link" href="cairo-error-status.html#CAIRO-STATUS-USER-FONT-ERROR:CAPS"><code class="literal">CAIRO_STATUS_USER_FONT_ERROR</code></a> will occur.</p>
+<p>
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>font_face</code></em> :</span></p></td>
+<td> A user font face
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>render_glyph_func</code></em> :</span></p></td>
+<td> The render_glyph callback, or <code class="literal">NULL</code>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since  1.8
+</p>
+</div>
+<hr>
+<div class="refsect2" lang="en">
+<a name="cairo-user-font-face-get-render-glyph-func"></a><h3>cairo_user_font_face_get_render_glyph_func ()</h3>
+<pre class="programlisting"><a class="link" href="cairo-user-font.html#cairo-user-scaled-font-render-glyph-func-t" title="cairo_user_scaled_font_render_glyph_func_t ()">cairo_user_scaled_font_render_glyph_func_t</a> cairo_user_font_face_get_render_glyph_func
+                                                        (<a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t">cairo_font_face_t</a> *font_face);</pre>
+<p>
+Gets the glyph rendering function of a user-font.</p>
+<p>
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>font_face</code></em> :</span></p></td>
+<td> A user font face
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td> The render_glyph callback of <em class="parameter"><code>font_face</code></em>
+or <code class="literal">NULL</code> if none set.
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since  1.8
+</p>
+</div>
+<hr>
+<div class="refsect2" lang="en">
+<a name="cairo-user-font-face-set-unicode-to-glyph-func"></a><h3>cairo_user_font_face_set_unicode_to_glyph_func ()</h3>
+<pre class="programlisting">void                cairo_user_font_face_set_unicode_to_glyph_func
+                                                        (<a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t">cairo_font_face_t</a> *font_face,
+                                                         <a class="link" href="cairo-user-font.html#cairo-user-scaled-font-unicode-to-glyph-func-t" title="cairo_user_scaled_font_unicode_to_glyph_func_t ()">cairo_user_scaled_font_unicode_to_glyph_func_t</a> unicode_to_glyph_func);</pre>
+<p>
+Sets the unicode-to-glyph conversion function of a user-font.
+See <a class="link" href="cairo-user-font.html#cairo-user-scaled-font-unicode-to-glyph-func-t" title="cairo_user_scaled_font_unicode_to_glyph_func_t ()"><span class="type">cairo_user_scaled_font_unicode_to_glyph_func_t</span></a> for details of how the callback
+works.
+</p>
+<p>
+The font-face should not be immutable or a <a class="link" href="cairo-error-status.html#CAIRO-STATUS-USER-FONT-IMMUTABLE:CAPS"><code class="literal">CAIRO_STATUS_USER_FONT_IMMUTABLE</code></a>
+error will occur.  A user font-face is immutable as soon as a scaled-font
+is created from it.</p>
+<p>
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>font_face</code></em> :</span></p></td>
+<td> A user font face
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>unicode_to_glyph_func</code></em> :</span></p></td>
+<td> The unicode_to_glyph callback, or <code class="literal">NULL</code>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since  1.8
+</p>
+</div>
+<hr>
+<div class="refsect2" lang="en">
+<a name="cairo-user-font-face-get-unicode-to-glyph-func"></a><h3>cairo_user_font_face_get_unicode_to_glyph_func ()</h3>
+<pre class="programlisting"><a class="link" href="cairo-user-font.html#cairo-user-scaled-font-unicode-to-glyph-func-t" title="cairo_user_scaled_font_unicode_to_glyph_func_t ()">cairo_user_scaled_font_unicode_to_glyph_func_t</a> cairo_user_font_face_get_unicode_to_glyph_func
+                                                        (<a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t">cairo_font_face_t</a> *font_face);</pre>
+<p>
+Gets the unicode-to-glyph conversion function of a user-font.</p>
+<p>
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>font_face</code></em> :</span></p></td>
+<td> A user font face
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td> The unicode_to_glyph callback of <em class="parameter"><code>font_face</code></em>
+or <code class="literal">NULL</code> if none set.
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since  1.8
+</p>
+</div>
+<hr>
+<div class="refsect2" lang="en">
+<a name="cairo-user-font-face-set-text-to-glyphs-func"></a><h3>cairo_user_font_face_set_text_to_glyphs_func ()</h3>
+<pre class="programlisting">void                cairo_user_font_face_set_text_to_glyphs_func
+                                                        (<a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t">cairo_font_face_t</a> *font_face,
+                                                         <a class="link" href="cairo-user-font.html#cairo-user-scaled-font-text-to-glyphs-func-t" title="cairo_user_scaled_font_text_to_glyphs_func_t ()">cairo_user_scaled_font_text_to_glyphs_func_t</a> text_to_glyphs_func);</pre>
+<p>
+Sets th text-to-glyphs conversion function of a user-font.
+See <a class="link" href="cairo-user-font.html#cairo-user-scaled-font-text-to-glyphs-func-t" title="cairo_user_scaled_font_text_to_glyphs_func_t ()"><span class="type">cairo_user_scaled_font_text_to_glyphs_func_t</span></a> for details of how the callback
+works.
+</p>
+<p>
+The font-face should not be immutable or a <a class="link" href="cairo-error-status.html#CAIRO-STATUS-USER-FONT-IMMUTABLE:CAPS"><code class="literal">CAIRO_STATUS_USER_FONT_IMMUTABLE</code></a>
+error will occur.  A user font-face is immutable as soon as a scaled-font
+is created from it.</p>
+<p>
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>font_face</code></em> :</span></p></td>
+<td> A user font face
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>text_to_glyphs_func</code></em> :</span></p></td>
+<td> The text_to_glyphs callback, or <code class="literal">NULL</code>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since  1.8
+</p>
+</div>
+<hr>
+<div class="refsect2" lang="en">
+<a name="cairo-user-font-face-get-text-to-glyphs-func"></a><h3>cairo_user_font_face_get_text_to_glyphs_func ()</h3>
+<pre class="programlisting"><a class="link" href="cairo-user-font.html#cairo-user-scaled-font-text-to-glyphs-func-t" title="cairo_user_scaled_font_text_to_glyphs_func_t ()">cairo_user_scaled_font_text_to_glyphs_func_t</a> cairo_user_font_face_get_text_to_glyphs_func
+                                                        (<a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t">cairo_font_face_t</a> *font_face);</pre>
+<p>
+Gets the text-to-glyphs conversion function of a user-font.</p>
+<p>
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>font_face</code></em> :</span></p></td>
+<td> A user font face
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td> The text_to_glyphs callback of <em class="parameter"><code>font_face</code></em>
+or <code class="literal">NULL</code> if none set.
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since  1.8
+</p>
+</div>
+</div>
+</div>
+<div class="footer">
+<hr>
+          Generated by GTK-Doc V1.10</div>
+</body>
+</html>