cairo 1.14.1-x64-mingw32 → 1.14.2-x64-mingw32
Sign up to get free protection for your applications and to get access to all the features.
Potentially problematic release.
This version of cairo might be problematic. Click here for more details.
- checksums.yaml +4 -4
- data/NEWS +21 -0
- data/Rakefile +17 -6
- data/ext/cairo/cairo.def +1 -0
- data/ext/cairo/extconf.rb +23 -10
- data/ext/cairo/rb_cairo.c +3 -0
- data/ext/cairo/rb_cairo.h +3 -3
- data/ext/cairo/rb_cairo_context.c +1 -1
- data/ext/cairo/rb_cairo_io.c +4 -0
- data/ext/cairo/rb_cairo_io.h +2 -0
- data/ext/cairo/rb_cairo_pattern.c +4 -4
- data/ext/cairo/rb_cairo_private.h +2 -0
- data/ext/cairo/rb_cairo_surface.c +64 -232
- data/lib/2.0/cairo.so +0 -0
- data/lib/2.1/cairo.so +0 -0
- data/lib/2.2/cairo.so +0 -0
- data/lib/cairo.rb +20 -19
- data/lib/cairo/region.rb +14 -0
- data/test/test_region.rb +26 -0
- data/vendor/local/bin/fc-cache.exe +0 -0
- data/vendor/local/bin/fc-cat.exe +0 -0
- data/vendor/local/bin/fc-list.exe +0 -0
- data/vendor/local/bin/fc-match.exe +0 -0
- data/vendor/local/bin/fc-pattern.exe +0 -0
- data/vendor/local/bin/fc-query.exe +0 -0
- data/vendor/local/bin/fc-scan.exe +0 -0
- data/vendor/local/bin/fc-validate.exe +0 -0
- data/vendor/local/bin/freetype-config +2 -2
- data/vendor/local/bin/libcairo-2.dll +0 -0
- data/vendor/local/bin/libcairo-gobject-2.dll +0 -0
- data/vendor/local/bin/libcairo-script-interpreter-2.dll +0 -0
- data/vendor/local/bin/libfontconfig-1.dll +0 -0
- data/vendor/local/bin/libfreetype-6.dll +0 -0
- data/vendor/local/bin/libgcc_s_seh-1.dll +0 -0
- data/vendor/local/bin/libpixman-1-0.dll +0 -0
- data/vendor/local/bin/libpng-config +1 -1
- data/vendor/local/bin/libpng16-16.dll +0 -0
- data/vendor/local/bin/libpng16-config +1 -1
- data/vendor/local/bin/libstdc++-6.dll +0 -0
- data/vendor/local/bin/libwinpthread-1.dll +0 -0
- data/vendor/local/bin/libxml2-2.dll +0 -0
- data/vendor/local/bin/png-fix-itxt.exe +0 -0
- data/vendor/local/bin/pngfix.exe +0 -0
- data/vendor/local/bin/xmlcatalog.exe +0 -0
- data/vendor/local/bin/xmllint.exe +0 -0
- data/vendor/local/bin/zlib1.dll +0 -0
- data/vendor/local/include/cairo/cairo-version.h +1 -1
- data/vendor/local/include/freetype2/config/ftconfig.h +19 -2
- data/vendor/local/include/freetype2/config/ftheader.h +7 -5
- data/vendor/local/include/freetype2/config/ftoption.h +9 -22
- data/vendor/local/include/freetype2/config/ftstdlib.h +2 -3
- data/vendor/local/include/freetype2/freetype.h +38 -17
- data/vendor/local/include/freetype2/ft2build.h +1 -1
- data/vendor/local/include/freetype2/ftadvanc.h +2 -2
- data/vendor/local/include/freetype2/ftautoh.h +50 -2
- data/vendor/local/include/freetype2/ftbbox.h +1 -1
- data/vendor/local/include/freetype2/ftbdf.h +1 -1
- data/vendor/local/include/freetype2/ftbitmap.h +11 -3
- data/vendor/local/include/freetype2/ftbzip2.h +1 -1
- data/vendor/local/include/freetype2/ftcache.h +3 -3
- data/vendor/local/include/freetype2/ftcffdrv.h +1 -1
- data/vendor/local/include/freetype2/ftcid.h +2 -1
- data/vendor/local/include/freetype2/fterrdef.h +1 -1
- data/vendor/local/include/freetype2/fterrors.h +1 -1
- data/vendor/local/include/freetype2/{ftxf86.h → ftfntfmt.h} +22 -14
- data/vendor/local/include/freetype2/ftgasp.h +1 -1
- data/vendor/local/include/freetype2/ftglyph.h +1 -1
- data/vendor/local/include/freetype2/ftgxval.h +1 -1
- data/vendor/local/include/freetype2/ftgzip.h +1 -1
- data/vendor/local/include/freetype2/ftimage.h +7 -13
- data/vendor/local/include/freetype2/ftincrem.h +1 -1
- data/vendor/local/include/freetype2/ftlcdfil.h +2 -2
- data/vendor/local/include/freetype2/ftlist.h +1 -1
- data/vendor/local/include/freetype2/ftlzw.h +1 -1
- data/vendor/local/include/freetype2/ftmac.h +1 -1
- data/vendor/local/include/freetype2/ftmm.h +17 -11
- data/vendor/local/include/freetype2/ftmodapi.h +4 -2
- data/vendor/local/include/freetype2/ftmoderr.h +1 -1
- data/vendor/local/include/freetype2/ftotval.h +1 -1
- data/vendor/local/include/freetype2/ftoutln.h +1 -1
- data/vendor/local/include/freetype2/ftpfr.h +1 -1
- data/vendor/local/include/freetype2/ftrender.h +3 -8
- data/vendor/local/include/freetype2/ftsizes.h +1 -1
- data/vendor/local/include/freetype2/ftsnames.h +1 -1
- data/vendor/local/include/freetype2/ftstroke.h +1 -1
- data/vendor/local/include/freetype2/ftsynth.h +5 -3
- data/vendor/local/include/freetype2/ftsystem.h +10 -1
- data/vendor/local/include/freetype2/fttrigon.h +1 -1
- data/vendor/local/include/freetype2/ftttdrv.h +85 -22
- data/vendor/local/include/freetype2/fttypes.h +1 -1
- data/vendor/local/include/freetype2/ftwinfnt.h +3 -3
- data/vendor/local/include/freetype2/t1tables.h +4 -3
- data/vendor/local/include/freetype2/ttnameid.h +116 -116
- data/vendor/local/include/freetype2/tttables.h +2 -2
- data/vendor/local/include/freetype2/tttags.h +1 -1
- data/vendor/local/include/freetype2/ttunpat.h +1 -1
- data/vendor/local/include/libpng16/png.h +63 -80
- data/vendor/local/include/libpng16/pngconf.h +8 -30
- data/vendor/local/include/libpng16/pnglibconf.h +10 -4
- data/vendor/local/include/png.h +63 -80
- data/vendor/local/include/pngconf.h +8 -30
- data/vendor/local/include/pnglibconf.h +10 -4
- data/vendor/local/lib/libcairo-gobject.a +0 -0
- data/vendor/local/lib/libcairo-gobject.dll.a +0 -0
- data/vendor/local/lib/libcairo-gobject.la +2 -2
- data/vendor/local/lib/libcairo-script-interpreter.a +0 -0
- data/vendor/local/lib/libcairo-script-interpreter.dll.a +0 -0
- data/vendor/local/lib/libcairo-script-interpreter.la +2 -2
- data/vendor/local/lib/libcairo.a +0 -0
- data/vendor/local/lib/libcairo.dll.a +0 -0
- data/vendor/local/lib/libcairo.la +2 -2
- data/vendor/local/lib/libfontconfig.dll.a +0 -0
- data/vendor/local/lib/libfreetype.a +0 -0
- data/vendor/local/lib/libfreetype.dll.a +0 -0
- data/vendor/local/lib/libfreetype.la +4 -4
- data/vendor/local/lib/libpixman-1.a +0 -0
- data/vendor/local/lib/libpixman-1.dll.a +0 -0
- data/vendor/local/lib/libpng.a +0 -0
- data/vendor/local/lib/libpng.dll.a +0 -0
- data/vendor/local/lib/libpng.la +4 -4
- data/vendor/local/lib/libpng16.a +0 -0
- data/vendor/local/lib/libpng16.dll.a +0 -0
- data/vendor/local/lib/libpng16.la +4 -4
- data/vendor/local/lib/libxml2.a +0 -0
- data/vendor/local/lib/libxml2.dll.a +0 -0
- data/vendor/local/lib/libz.a +0 -0
- data/vendor/local/lib/libz.dll.a +0 -0
- data/vendor/local/lib/pkgconfig/cairo-fc.pc +1 -1
- data/vendor/local/lib/pkgconfig/cairo-ft.pc +1 -1
- data/vendor/local/lib/pkgconfig/cairo-gobject.pc +1 -1
- data/vendor/local/lib/pkgconfig/cairo-pdf.pc +1 -1
- data/vendor/local/lib/pkgconfig/cairo-png.pc +1 -1
- data/vendor/local/lib/pkgconfig/cairo-ps.pc +1 -1
- data/vendor/local/lib/pkgconfig/cairo-script.pc +1 -1
- data/vendor/local/lib/pkgconfig/cairo-svg.pc +1 -1
- data/vendor/local/lib/pkgconfig/cairo-win32-font.pc +1 -1
- data/vendor/local/lib/pkgconfig/cairo-win32.pc +1 -1
- data/vendor/local/lib/pkgconfig/cairo.pc +1 -1
- data/vendor/local/lib/pkgconfig/freetype2.pc +1 -1
- data/vendor/local/lib/pkgconfig/libpng.pc +1 -1
- data/vendor/local/lib/pkgconfig/libpng16.pc +1 -1
- data/vendor/local/share/aclocal/freetype2.m4 +1 -1
- data/vendor/local/share/gtk-doc/html/cairo/bindings-errors.html +12 -12
- data/vendor/local/share/gtk-doc/html/cairo/bindings-fonts.html +12 -12
- data/vendor/local/share/gtk-doc/html/cairo/bindings-memory.html +12 -12
- data/vendor/local/share/gtk-doc/html/cairo/bindings-overloading.html +13 -13
- data/vendor/local/share/gtk-doc/html/cairo/bindings-path.html +12 -12
- data/vendor/local/share/gtk-doc/html/cairo/bindings-patterns.html +35 -35
- data/vendor/local/share/gtk-doc/html/cairo/bindings-return-values.html +10 -10
- data/vendor/local/share/gtk-doc/html/cairo/bindings-streams.html +11 -11
- data/vendor/local/share/gtk-doc/html/cairo/bindings-surfaces.html +13 -13
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Error-handling.html +294 -225
- data/vendor/local/share/gtk-doc/html/cairo/cairo-FreeType-Fonts.html +387 -269
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Image-Surfaces.html +432 -302
- data/vendor/local/share/gtk-doc/html/cairo/cairo-PDF-Surfaces.html +325 -217
- data/vendor/local/share/gtk-doc/html/cairo/cairo-PNG-Support.html +298 -193
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Paths.html +1121 -812
- data/vendor/local/share/gtk-doc/html/cairo/cairo-PostScript-Surfaces.html +513 -383
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Quartz-(CGFont)-Fonts.html +126 -83
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Quartz-Surfaces.html +172 -119
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Raster-Sources.html +581 -372
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Recording-Surfaces.html +179 -130
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Regions.html +888 -539
- data/vendor/local/share/gtk-doc/html/cairo/cairo-SVG-Surfaces.html +287 -192
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Script-Surfaces.html +374 -231
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Transformations.html +395 -219
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Types.html +125 -75
- data/vendor/local/share/gtk-doc/html/cairo/cairo-User-Fonts.html +630 -464
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Version-Information.html +225 -200
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Win32-Fonts.html +336 -214
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Win32-Surfaces.html +277 -186
- data/vendor/local/share/gtk-doc/html/cairo/cairo-XCB-Surfaces.html +495 -350
- data/vendor/local/share/gtk-doc/html/cairo/cairo-XLib-Surfaces.html +557 -362
- data/vendor/local/share/gtk-doc/html/cairo/cairo-XLib-XRender-Backend.html +158 -111
- data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-device-t.html +655 -441
- data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-font-face-t.html +389 -280
- data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-font-options-t.html +667 -451
- data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-matrix-t.html +579 -351
- data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-pattern-t.html +2006 -1545
- data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-scaled-font-t.html +892 -618
- data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-surface-t.html +1624 -1188
- data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-t.html +2903 -2104
- data/vendor/local/share/gtk-doc/html/cairo/cairo-drawing.html +13 -13
- data/vendor/local/share/gtk-doc/html/cairo/cairo-fonts.html +13 -13
- data/vendor/local/share/gtk-doc/html/cairo/cairo-support.html +13 -13
- data/vendor/local/share/gtk-doc/html/cairo/cairo-surfaces.html +13 -13
- data/vendor/local/share/gtk-doc/html/cairo/cairo-text.html +1115 -758
- data/vendor/local/share/gtk-doc/html/cairo/cairo.devhelp2 +419 -604
- data/vendor/local/share/gtk-doc/html/cairo/home.png +0 -0
- data/vendor/local/share/gtk-doc/html/cairo/index-1.10.html +56 -56
- data/vendor/local/share/gtk-doc/html/cairo/index-1.12.html +70 -70
- data/vendor/local/share/gtk-doc/html/cairo/index-1.2.html +58 -58
- data/vendor/local/share/gtk-doc/html/cairo/index-1.4.html +39 -39
- data/vendor/local/share/gtk-doc/html/cairo/index-1.6.html +30 -30
- data/vendor/local/share/gtk-doc/html/cairo/index-1.8.html +38 -38
- data/vendor/local/share/gtk-doc/html/cairo/index-all.html +426 -426
- data/vendor/local/share/gtk-doc/html/cairo/index.html +6 -6
- data/vendor/local/share/gtk-doc/html/cairo/index.sgml +234 -325
- data/vendor/local/share/gtk-doc/html/cairo/language-bindings.html +12 -12
- data/vendor/local/share/gtk-doc/html/cairo/left-insensitive.png +0 -0
- data/vendor/local/share/gtk-doc/html/cairo/left.png +0 -0
- data/vendor/local/share/gtk-doc/html/cairo/right-insensitive.png +0 -0
- data/vendor/local/share/gtk-doc/html/cairo/right.png +0 -0
- data/vendor/local/share/gtk-doc/html/cairo/style.css +221 -26
- data/vendor/local/share/gtk-doc/html/cairo/up-insensitive.png +0 -0
- data/vendor/local/share/gtk-doc/html/cairo/up.png +0 -0
- data/vendor/local/share/license/cairo/README +1 -1
- data/vendor/local/share/license/freetype/README +6 -6
- data/vendor/local/share/license/freetype/README.git +1 -1
- data/vendor/local/share/license/libpng/README +2 -2
- data/vendor/local/share/man/man1/freetype-config.1 +1 -1
- data/vendor/local/share/man/man3/libpng.3 +85 -92
- data/vendor/local/share/man/man3/libpngpf.3 +2 -2
- data/vendor/local/share/man/man5/png.5 +1 -1
- metadata +23 -19
@@ -2,30 +2,27 @@
|
|
2
2
|
<html>
|
3
3
|
<head>
|
4
4
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
5
|
-
<title>Types</title>
|
6
|
-
<meta name="generator" content="DocBook XSL Stylesheets V1.
|
5
|
+
<title>Cairo: A Vector Graphics Library: Types</title>
|
6
|
+
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
|
7
7
|
<link rel="home" href="index.html" title="Cairo: A Vector Graphics Library">
|
8
8
|
<link rel="up" href="cairo-support.html" title="Utilities">
|
9
9
|
<link rel="prev" href="cairo-Version-Information.html" title="Version Information">
|
10
10
|
<link rel="next" href="index-all.html" title="Index">
|
11
|
-
<meta name="generator" content="GTK-Doc V1.
|
11
|
+
<meta name="generator" content="GTK-Doc V1.20 (XML mode)">
|
12
12
|
<link rel="stylesheet" href="style.css" type="text/css">
|
13
13
|
</head>
|
14
14
|
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
15
|
-
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="
|
16
|
-
<
|
17
|
-
<
|
18
|
-
<
|
19
|
-
<
|
20
|
-
|
21
|
-
<td><a accesskey="
|
22
|
-
|
23
|
-
<
|
24
|
-
<a href="
|
25
|
-
|
26
|
-
<a href="#cairo-Types.description" class="shortcut">Description</a>
|
27
|
-
</td></tr>
|
28
|
-
</table>
|
15
|
+
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
|
16
|
+
<td width="100%" align="left" class="shortcuts">
|
17
|
+
<a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span>
|
18
|
+
<a href="#cairo-Types.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span>
|
19
|
+
<a href="#cairo-Types.object-hierarchy" class="shortcut">Object Hierarchy</a></span>
|
20
|
+
</td>
|
21
|
+
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
|
22
|
+
<td><a accesskey="u" href="cairo-support.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
|
23
|
+
<td><a accesskey="p" href="cairo-Version-Information.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
|
24
|
+
<td><a accesskey="n" href="index-all.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
|
25
|
+
</tr></table>
|
29
26
|
<div class="refentry">
|
30
27
|
<a name="cairo-Types"></a><div class="titlepage"></div>
|
31
28
|
<div class="refnamediv"><table width="100%"><tr>
|
@@ -33,43 +30,99 @@
|
|
33
30
|
<h2><span class="refentrytitle"><a name="cairo-Types.top_of_page"></a>Types</span></h2>
|
34
31
|
<p>Types — Generic data types</p>
|
35
32
|
</td>
|
36
|
-
<td valign="top" align="right"></td>
|
33
|
+
<td class="gallery_image" valign="top" align="right"></td>
|
37
34
|
</tr></table></div>
|
38
|
-
<div class="
|
39
|
-
<a name="cairo-Types.
|
40
|
-
<
|
41
|
-
|
42
|
-
<
|
43
|
-
|
35
|
+
<div class="refsect1">
|
36
|
+
<a name="cairo-Types.functions"></a><h2>Functions</h2>
|
37
|
+
<div class="informaltable"><table width="100%" border="0">
|
38
|
+
<colgroup>
|
39
|
+
<col width="150px" class="functions_return">
|
40
|
+
<col class="functions_name">
|
41
|
+
</colgroup>
|
42
|
+
<tbody><tr>
|
43
|
+
<td class="function_type">
|
44
|
+
<span class="returnvalue">void</span>
|
45
|
+
</td>
|
46
|
+
<td class="function_name">
|
47
|
+
<span class="c_punctuation">(</span><a class="link" href="cairo-Types.html#cairo-destroy-func-t" title="cairo_destroy_func_t ()">*cairo_destroy_func_t</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
|
48
|
+
</td>
|
49
|
+
</tr></tbody>
|
50
|
+
</table></div>
|
51
|
+
</div>
|
52
|
+
<div class="refsect1">
|
53
|
+
<a name="cairo-Types.other"></a><h2>Types and Values</h2>
|
54
|
+
<div class="informaltable"><table width="100%" border="0">
|
55
|
+
<colgroup>
|
56
|
+
<col width="150px" class="name">
|
57
|
+
<col class="description">
|
58
|
+
</colgroup>
|
59
|
+
<tbody>
|
60
|
+
<tr>
|
61
|
+
<td class="typedef_keyword">typedef</td>
|
62
|
+
<td class="function_name"><a class="link" href="cairo-Types.html#cairo-bool-t" title="cairo_bool_t">cairo_bool_t</a></td>
|
63
|
+
</tr>
|
64
|
+
<tr>
|
65
|
+
<td class="datatype_keyword"> </td>
|
66
|
+
<td class="function_name"><a class="link" href="cairo-Types.html#cairo-user-data-key-t" title="cairo_user_data_key_t">cairo_user_data_key_t</a></td>
|
67
|
+
</tr>
|
68
|
+
<tr>
|
69
|
+
<td class="datatype_keyword"> </td>
|
70
|
+
<td class="function_name"><a class="link" href="cairo-Types.html#cairo-rectangle-int-t" title="cairo_rectangle_int_t">cairo_rectangle_int_t</a></td>
|
71
|
+
</tr>
|
72
|
+
</tbody>
|
73
|
+
</table></div>
|
74
|
+
</div>
|
75
|
+
<div class="refsect1">
|
76
|
+
<a name="cairo-Types.object-hierarchy"></a><h2>Object Hierarchy</h2>
|
77
|
+
<pre class="screen">
|
44
78
|
</pre>
|
45
79
|
</div>
|
46
80
|
<div class="refsect1">
|
47
81
|
<a name="cairo-Types.description"></a><h2>Description</h2>
|
48
|
-
<p>
|
49
|
-
This section lists generic data types used in the cairo API.
|
50
|
-
</p>
|
82
|
+
<p>This section lists generic data types used in the cairo API.</p>
|
51
83
|
</div>
|
52
84
|
<div class="refsect1">
|
53
|
-
<a name="cairo-Types.
|
85
|
+
<a name="cairo-Types.functions_details"></a><h2>Functions</h2>
|
86
|
+
<div class="refsect2">
|
87
|
+
<a name="cairo-destroy-func-t"></a><h3>cairo_destroy_func_t ()</h3>
|
88
|
+
<pre class="programlisting"><span class="returnvalue">void</span>
|
89
|
+
<span class="c_punctuation">(</span>*cairo_destroy_func_t<span class="c_punctuation">)</span> (<em class="parameter"><code><span class="type">void</span> *data</code></em>);</pre>
|
90
|
+
<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
|
91
|
+
data element is destroyed. It is passed the pointer to the data
|
92
|
+
element and should free any memory and resources allocated for it.</p>
|
93
|
+
<div class="refsect3">
|
94
|
+
<a name="id-1.6.5.7.2.5"></a><h4>Parameters</h4>
|
95
|
+
<div class="informaltable"><table width="100%" border="0">
|
96
|
+
<colgroup>
|
97
|
+
<col width="150px" class="parameters_name">
|
98
|
+
<col class="parameters_description">
|
99
|
+
<col width="200px" class="parameters_annotations">
|
100
|
+
</colgroup>
|
101
|
+
<tbody><tr>
|
102
|
+
<td class="parameter_name"><p>data</p></td>
|
103
|
+
<td class="parameter_description"><p>The data element being destroyed.</p></td>
|
104
|
+
<td class="parameter_annotations"> </td>
|
105
|
+
</tr></tbody>
|
106
|
+
</table></div>
|
107
|
+
</div>
|
108
|
+
<p class="since">Since 1.0</p>
|
109
|
+
</div>
|
110
|
+
</div>
|
111
|
+
<div class="refsect1">
|
112
|
+
<a name="cairo-Types.other_details"></a><h2>Types and Values</h2>
|
54
113
|
<div class="refsect2">
|
55
114
|
<a name="cairo-bool-t"></a><h3>cairo_bool_t</h3>
|
56
115
|
<pre class="programlisting">typedef int cairo_bool_t;
|
57
116
|
</pre>
|
58
|
-
<p>
|
59
|
-
<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
|
117
|
+
<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
|
60
118
|
<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
|
61
119
|
these values explicitly is not encouraged; just use the
|
62
|
-
value as a boolean condition
|
63
|
-
</p>
|
64
|
-
<p>
|
65
|
-
</p>
|
120
|
+
value as a boolean condition.</p>
|
66
121
|
<div class="informalexample"><pre class="programlisting">
|
67
122
|
if (cairo_in_stroke (cr, x, y)) {
|
68
123
|
/* do something */
|
69
124
|
}
|
70
125
|
</pre></div>
|
71
|
-
<p>
|
72
|
-
</p>
|
73
126
|
<p class="since">Since 1.0</p>
|
74
127
|
</div>
|
75
128
|
<hr>
|
@@ -79,38 +132,26 @@ value as a boolean condition.
|
|
79
132
|
int unused;
|
80
133
|
} cairo_user_data_key_t;
|
81
134
|
</pre>
|
82
|
-
<p>
|
83
|
-
<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
|
135
|
+
<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
|
84
136
|
data structures. The actual contents of the struct is never used,
|
85
137
|
and there is no need to initialize the object; only the unique
|
86
138
|
address of a <span class="type">cairo_data_key_t</span> object is used. Typically, you
|
87
|
-
would just use the address of a static <span class="type">cairo_data_key_t</span> object
|
88
|
-
|
89
|
-
<
|
90
|
-
<
|
139
|
+
would just use the address of a static <span class="type">cairo_data_key_t</span> object.</p>
|
140
|
+
<div class="refsect3">
|
141
|
+
<a name="id-1.6.5.8.3.5"></a><h4>Members</h4>
|
142
|
+
<div class="informaltable"><table width="100%" border="0">
|
143
|
+
<colgroup>
|
144
|
+
<col width="300px" class="struct_members_name">
|
145
|
+
<col class="struct_members_description">
|
146
|
+
<col width="200px" class="struct_members_annotations">
|
147
|
+
</colgroup>
|
91
148
|
<tbody><tr>
|
92
|
-
<td
|
93
|
-
<td>not used; ignore.</td>
|
149
|
+
<td class="struct_member_name"><p><span class="type">int</span> <em class="structfield"><code><a name="cairo-user-data-key-t.unused"></a>unused</code></em>;</p></td>
|
150
|
+
<td class="struct_member_description"><p>not used; ignore.</p></td>
|
151
|
+
<td class="struct_member_annotations"> </td>
|
94
152
|
</tr></tbody>
|
95
153
|
</table></div>
|
96
|
-
<p class="since">Since 1.0</p>
|
97
154
|
</div>
|
98
|
-
<hr>
|
99
|
-
<div class="refsect2">
|
100
|
-
<a name="cairo-destroy-func-t"></a><h3>cairo_destroy_func_t ()</h3>
|
101
|
-
<pre class="programlisting"><span class="returnvalue">void</span> (*cairo_destroy_func_t) (<em class="parameter"><code><span class="type">void</span> *data</code></em>);</pre>
|
102
|
-
<p>
|
103
|
-
<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
|
104
|
-
data element is destroyed. It is passed the pointer to the data
|
105
|
-
element and should free any memory and resources allocated for it.
|
106
|
-
</p>
|
107
|
-
<div class="variablelist"><table border="0">
|
108
|
-
<col align="left" valign="top">
|
109
|
-
<tbody><tr>
|
110
|
-
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
|
111
|
-
<td>The data element being destroyed.</td>
|
112
|
-
</tr></tbody>
|
113
|
-
</table></div>
|
114
155
|
<p class="since">Since 1.0</p>
|
115
156
|
</div>
|
116
157
|
<hr>
|
@@ -121,36 +162,45 @@ element and should free any memory and resources allocated for it.
|
|
121
162
|
int width, height;
|
122
163
|
} cairo_rectangle_int_t;
|
123
164
|
</pre>
|
124
|
-
<p>
|
125
|
-
|
126
|
-
</
|
127
|
-
<div class="
|
128
|
-
<
|
165
|
+
<p>A data structure for holding a rectangle with integer coordinates.</p>
|
166
|
+
<div class="refsect3">
|
167
|
+
<a name="id-1.6.5.8.4.5"></a><h4>Members</h4>
|
168
|
+
<div class="informaltable"><table width="100%" border="0">
|
169
|
+
<colgroup>
|
170
|
+
<col width="300px" class="struct_members_name">
|
171
|
+
<col class="struct_members_description">
|
172
|
+
<col width="200px" class="struct_members_annotations">
|
173
|
+
</colgroup>
|
129
174
|
<tbody>
|
130
175
|
<tr>
|
131
|
-
<td
|
132
|
-
<td>X coordinate of the left side of the rectangle</td>
|
176
|
+
<td class="struct_member_name"><p><span class="type">int</span> <em class="structfield"><code><a name="cairo-rectangle-int-t.x"></a>x</code></em>;</p></td>
|
177
|
+
<td class="struct_member_description"><p>X coordinate of the left side of the rectangle</p></td>
|
178
|
+
<td class="struct_member_annotations"> </td>
|
133
179
|
</tr>
|
134
180
|
<tr>
|
135
|
-
<td
|
136
|
-
<td>Y coordinate of the the top side of the rectangle</td>
|
181
|
+
<td class="struct_member_name"><p><span class="type">int</span> <em class="structfield"><code><a name="cairo-rectangle-int-t.y"></a>y</code></em>;</p></td>
|
182
|
+
<td class="struct_member_description"><p>Y coordinate of the the top side of the rectangle</p></td>
|
183
|
+
<td class="struct_member_annotations"> </td>
|
137
184
|
</tr>
|
138
185
|
<tr>
|
139
|
-
<td
|
140
|
-
<td>width of the rectangle</td>
|
186
|
+
<td class="struct_member_name"><p><span class="type">int</span> <em class="structfield"><code><a name="cairo-rectangle-int-t.width"></a>width</code></em>;</p></td>
|
187
|
+
<td class="struct_member_description"><p>width of the rectangle</p></td>
|
188
|
+
<td class="struct_member_annotations"> </td>
|
141
189
|
</tr>
|
142
190
|
<tr>
|
143
|
-
<td
|
144
|
-
<td>height of the rectangle</td>
|
191
|
+
<td class="struct_member_name"><p><span class="type">int</span> <em class="structfield"><code><a name="cairo-rectangle-int-t.height"></a>height</code></em>;</p></td>
|
192
|
+
<td class="struct_member_description"><p>height of the rectangle</p></td>
|
193
|
+
<td class="struct_member_annotations"> </td>
|
145
194
|
</tr>
|
146
195
|
</tbody>
|
147
196
|
</table></div>
|
197
|
+
</div>
|
148
198
|
<p class="since">Since 1.10</p>
|
149
199
|
</div>
|
150
200
|
</div>
|
151
201
|
</div>
|
152
202
|
<div class="footer">
|
153
203
|
<hr>
|
154
|
-
Generated by GTK-Doc V1.
|
204
|
+
Generated by GTK-Doc V1.20</div>
|
155
205
|
</body>
|
156
206
|
</html>
|
@@ -2,30 +2,27 @@
|
|
2
2
|
<html>
|
3
3
|
<head>
|
4
4
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
5
|
-
<title>User Fonts</title>
|
6
|
-
<meta name="generator" content="DocBook XSL Stylesheets V1.
|
5
|
+
<title>Cairo: A Vector Graphics Library: User Fonts</title>
|
6
|
+
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
|
7
7
|
<link rel="home" href="index.html" title="Cairo: A Vector Graphics Library">
|
8
8
|
<link rel="up" href="cairo-fonts.html" title="Fonts">
|
9
9
|
<link rel="prev" href="cairo-Quartz-(CGFont)-Fonts.html" title="Quartz (CGFont) Fonts">
|
10
10
|
<link rel="next" href="cairo-surfaces.html" title="Surfaces">
|
11
|
-
<meta name="generator" content="GTK-Doc V1.
|
11
|
+
<meta name="generator" content="GTK-Doc V1.20 (XML mode)">
|
12
12
|
<link rel="stylesheet" href="style.css" type="text/css">
|
13
13
|
</head>
|
14
14
|
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
15
|
-
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="
|
16
|
-
<
|
17
|
-
<
|
18
|
-
<
|
19
|
-
<
|
20
|
-
|
21
|
-
<td><a accesskey="
|
22
|
-
|
23
|
-
<
|
24
|
-
<a href="
|
25
|
-
|
26
|
-
<a href="#cairo-User-Fonts.description" class="shortcut">Description</a>
|
27
|
-
</td></tr>
|
28
|
-
</table>
|
15
|
+
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
|
16
|
+
<td width="100%" align="left" class="shortcuts">
|
17
|
+
<a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span>
|
18
|
+
<a href="#cairo-User-Fonts.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span>
|
19
|
+
<a href="#cairo-User-Fonts.object-hierarchy" class="shortcut">Object Hierarchy</a></span>
|
20
|
+
</td>
|
21
|
+
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
|
22
|
+
<td><a accesskey="u" href="cairo-fonts.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
|
23
|
+
<td><a accesskey="p" href="cairo-Quartz-(CGFont)-Fonts.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
|
24
|
+
<td><a accesskey="n" href="cairo-surfaces.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
|
25
|
+
</tr></table>
|
29
26
|
<div class="refentry">
|
30
27
|
<a name="cairo-User-Fonts"></a><div class="titlepage"></div>
|
31
28
|
<div class="refnamediv"><table width="100%"><tr>
|
@@ -33,166 +30,250 @@
|
|
33
30
|
<h2><span class="refentrytitle"><a name="cairo-User-Fonts.top_of_page"></a>User Fonts</span></h2>
|
34
31
|
<p>User Fonts — Font support with font data provided by the user</p>
|
35
32
|
</td>
|
36
|
-
<td valign="top" align="right"></td>
|
33
|
+
<td class="gallery_image" valign="top" align="right"></td>
|
37
34
|
</tr></table></div>
|
38
|
-
<div class="
|
39
|
-
<a name="cairo-User-Fonts.
|
40
|
-
<
|
41
|
-
<
|
42
|
-
|
43
|
-
|
44
|
-
|
45
|
-
<
|
46
|
-
|
47
|
-
|
48
|
-
|
49
|
-
|
50
|
-
<
|
51
|
-
|
52
|
-
|
53
|
-
|
54
|
-
|
55
|
-
|
56
|
-
|
57
|
-
|
58
|
-
|
59
|
-
<
|
60
|
-
|
61
|
-
|
62
|
-
|
63
|
-
<
|
64
|
-
<
|
65
|
-
|
66
|
-
<
|
67
|
-
|
68
|
-
|
69
|
-
|
70
|
-
|
71
|
-
<
|
72
|
-
|
73
|
-
|
74
|
-
|
75
|
-
|
76
|
-
|
77
|
-
|
78
|
-
<
|
79
|
-
|
80
|
-
|
81
|
-
|
82
|
-
|
35
|
+
<div class="refsect1">
|
36
|
+
<a name="cairo-User-Fonts.functions"></a><h2>Functions</h2>
|
37
|
+
<div class="informaltable"><table width="100%" border="0">
|
38
|
+
<colgroup>
|
39
|
+
<col width="150px" class="functions_return">
|
40
|
+
<col class="functions_name">
|
41
|
+
</colgroup>
|
42
|
+
<tbody>
|
43
|
+
<tr>
|
44
|
+
<td class="function_type">
|
45
|
+
<a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="returnvalue">cairo_status_t</span></a>
|
46
|
+
</td>
|
47
|
+
<td class="function_name">
|
48
|
+
<span class="c_punctuation">(</span><a class="link" href="cairo-User-Fonts.html#cairo-user-scaled-font-init-func-t" title="cairo_user_scaled_font_init_func_t ()">*cairo_user_scaled_font_init_func_t</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
|
49
|
+
</td>
|
50
|
+
</tr>
|
51
|
+
<tr>
|
52
|
+
<td class="function_type">
|
53
|
+
<a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="returnvalue">cairo_status_t</span></a>
|
54
|
+
</td>
|
55
|
+
<td class="function_name">
|
56
|
+
<span class="c_punctuation">(</span><a class="link" href="cairo-User-Fonts.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><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
|
57
|
+
</td>
|
58
|
+
</tr>
|
59
|
+
<tr>
|
60
|
+
<td class="function_type">
|
61
|
+
<a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="returnvalue">cairo_status_t</span></a>
|
62
|
+
</td>
|
63
|
+
<td class="function_name">
|
64
|
+
<span class="c_punctuation">(</span><a class="link" href="cairo-User-Fonts.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><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
|
65
|
+
</td>
|
66
|
+
</tr>
|
67
|
+
<tr>
|
68
|
+
<td class="function_type">
|
69
|
+
<a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="returnvalue">cairo_status_t</span></a>
|
70
|
+
</td>
|
71
|
+
<td class="function_name">
|
72
|
+
<span class="c_punctuation">(</span><a class="link" href="cairo-User-Fonts.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><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
|
73
|
+
</td>
|
74
|
+
</tr>
|
75
|
+
<tr>
|
76
|
+
<td class="function_type">
|
77
|
+
<a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="returnvalue">cairo_font_face_t</span></a> *
|
78
|
+
</td>
|
79
|
+
<td class="function_name">
|
80
|
+
<a class="link" href="cairo-User-Fonts.html#cairo-user-font-face-create" title="cairo_user_font_face_create ()">cairo_user_font_face_create</a> <span class="c_punctuation">()</span>
|
81
|
+
</td>
|
82
|
+
</tr>
|
83
|
+
<tr>
|
84
|
+
<td class="function_type">
|
85
|
+
<span class="returnvalue">void</span>
|
86
|
+
</td>
|
87
|
+
<td class="function_name">
|
88
|
+
<a class="link" href="cairo-User-Fonts.html#cairo-user-font-face-set-init-func" title="cairo_user_font_face_set_init_func ()">cairo_user_font_face_set_init_func</a> <span class="c_punctuation">()</span>
|
89
|
+
</td>
|
90
|
+
</tr>
|
91
|
+
<tr>
|
92
|
+
<td class="function_type">
|
93
|
+
<a class="link" href="cairo-User-Fonts.html#cairo-user-scaled-font-init-func-t" title="cairo_user_scaled_font_init_func_t ()"><span class="returnvalue">cairo_user_scaled_font_init_func_t</span></a>
|
94
|
+
</td>
|
95
|
+
<td class="function_name">
|
96
|
+
<a class="link" href="cairo-User-Fonts.html#cairo-user-font-face-get-init-func" title="cairo_user_font_face_get_init_func ()">cairo_user_font_face_get_init_func</a> <span class="c_punctuation">()</span>
|
97
|
+
</td>
|
98
|
+
</tr>
|
99
|
+
<tr>
|
100
|
+
<td class="function_type">
|
101
|
+
<span class="returnvalue">void</span>
|
102
|
+
</td>
|
103
|
+
<td class="function_name">
|
104
|
+
<a class="link" href="cairo-User-Fonts.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> <span class="c_punctuation">()</span>
|
105
|
+
</td>
|
106
|
+
</tr>
|
107
|
+
<tr>
|
108
|
+
<td class="function_type">
|
109
|
+
<a class="link" href="cairo-User-Fonts.html#cairo-user-scaled-font-render-glyph-func-t" title="cairo_user_scaled_font_render_glyph_func_t ()"><span class="returnvalue">cairo_user_scaled_font_render_glyph_func_t</span></a>
|
110
|
+
</td>
|
111
|
+
<td class="function_name">
|
112
|
+
<a class="link" href="cairo-User-Fonts.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> <span class="c_punctuation">()</span>
|
113
|
+
</td>
|
114
|
+
</tr>
|
115
|
+
<tr>
|
116
|
+
<td class="function_type">
|
117
|
+
<span class="returnvalue">void</span>
|
118
|
+
</td>
|
119
|
+
<td class="function_name">
|
120
|
+
<a class="link" href="cairo-User-Fonts.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> <span class="c_punctuation">()</span>
|
121
|
+
</td>
|
122
|
+
</tr>
|
123
|
+
<tr>
|
124
|
+
<td class="function_type">
|
125
|
+
<a class="link" href="cairo-User-Fonts.html#cairo-user-scaled-font-unicode-to-glyph-func-t" title="cairo_user_scaled_font_unicode_to_glyph_func_t ()"><span class="returnvalue">cairo_user_scaled_font_unicode_to_glyph_func_t</span></a>
|
126
|
+
</td>
|
127
|
+
<td class="function_name">
|
128
|
+
<a class="link" href="cairo-User-Fonts.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> <span class="c_punctuation">()</span>
|
129
|
+
</td>
|
130
|
+
</tr>
|
131
|
+
<tr>
|
132
|
+
<td class="function_type">
|
133
|
+
<span class="returnvalue">void</span>
|
134
|
+
</td>
|
135
|
+
<td class="function_name">
|
136
|
+
<a class="link" href="cairo-User-Fonts.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> <span class="c_punctuation">()</span>
|
137
|
+
</td>
|
138
|
+
</tr>
|
139
|
+
<tr>
|
140
|
+
<td class="function_type">
|
141
|
+
<a class="link" href="cairo-User-Fonts.html#cairo-user-scaled-font-text-to-glyphs-func-t" title="cairo_user_scaled_font_text_to_glyphs_func_t ()"><span class="returnvalue">cairo_user_scaled_font_text_to_glyphs_func_t</span></a>
|
142
|
+
</td>
|
143
|
+
<td class="function_name">
|
144
|
+
<a class="link" href="cairo-User-Fonts.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> <span class="c_punctuation">()</span>
|
145
|
+
</td>
|
146
|
+
</tr>
|
147
|
+
</tbody>
|
148
|
+
</table></div>
|
149
|
+
</div>
|
150
|
+
<div class="refsect1">
|
151
|
+
<a name="cairo-User-Fonts.other"></a><h2>Types and Values</h2>
|
152
|
+
<div class="informaltable"><table width="100%" border="0">
|
153
|
+
<colgroup>
|
154
|
+
<col width="150px" class="name">
|
155
|
+
<col class="description">
|
156
|
+
</colgroup>
|
157
|
+
<tbody><tr>
|
158
|
+
<td class="define_keyword">#define</td>
|
159
|
+
<td class="function_name"><a class="link" href="cairo-User-Fonts.html#CAIRO-HAS-USER-FONT:CAPS" title="CAIRO_HAS_USER_FONT">CAIRO_HAS_USER_FONT</a></td>
|
160
|
+
</tr></tbody>
|
161
|
+
</table></div>
|
162
|
+
</div>
|
163
|
+
<div class="refsect1">
|
164
|
+
<a name="cairo-User-Fonts.object-hierarchy"></a><h2>Object Hierarchy</h2>
|
165
|
+
<pre class="screen">
|
83
166
|
</pre>
|
84
167
|
</div>
|
85
168
|
<div class="refsect1">
|
86
169
|
<a name="cairo-User-Fonts.description"></a><h2>Description</h2>
|
87
|
-
<p>
|
88
|
-
The user-font feature allows the cairo user to provide drawings for glyphs
|
170
|
+
<p>The user-font feature allows the cairo user to provide drawings for glyphs
|
89
171
|
in a font. This is most useful in implementing fonts in non-standard
|
90
172
|
formats, like SVG fonts and Flash fonts, but can also be used by games and
|
91
|
-
other application to draw "funky" fonts
|
92
|
-
</p>
|
173
|
+
other application to draw "funky" fonts.</p>
|
93
174
|
</div>
|
94
175
|
<div class="refsect1">
|
95
|
-
<a name="cairo-User-Fonts.
|
176
|
+
<a name="cairo-User-Fonts.functions_details"></a><h2>Functions</h2>
|
96
177
|
<div class="refsect2">
|
97
|
-
<a name="
|
98
|
-
<pre class="programlisting"
|
99
|
-
</
|
100
|
-
<
|
101
|
-
|
102
|
-
|
103
|
-
|
104
|
-
|
105
|
-
|
106
|
-
<p class="since">Since 1.8</p>
|
107
|
-
</div>
|
108
|
-
<hr>
|
109
|
-
<div class="refsect2">
|
110
|
-
<a name="cairo-user-scaled-font-init-func-t"></a><h3>cairo_user_scaled_font_init_func_t ()</h3>
|
111
|
-
<pre class="programlisting"><a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="returnvalue">cairo_status_t</span></a> (*cairo_user_scaled_font_init_func_t)
|
112
|
-
(<em class="parameter"><code><a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-t" title="cairo_scaled_font_t"><span class="type">cairo_scaled_font_t</span></a> *scaled_font</code></em>,
|
113
|
-
<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>,
|
114
|
-
<em class="parameter"><code><a class="link" href="cairo-cairo-scaled-font-t.html#cairo-font-extents-t" title="cairo_font_extents_t"><span class="type">cairo_font_extents_t</span></a> *extents</code></em>);</pre>
|
115
|
-
<p>
|
116
|
-
<a class="link" href="cairo-User-Fonts.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
|
117
|
-
called when a scaled-font needs to be created for a user font-face.
|
118
|
-
</p>
|
119
|
-
<p>
|
120
|
-
The cairo context <em class="parameter"><code>cr</code></em> is not used by the caller, but is prepared in font
|
178
|
+
<a name="cairo-user-scaled-font-init-func-t"></a><h3>cairo_user_scaled_font_init_func_t ()</h3>
|
179
|
+
<pre class="programlisting"><a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="returnvalue">cairo_status_t</span></a>
|
180
|
+
<span class="c_punctuation">(</span>*cairo_user_scaled_font_init_func_t<span class="c_punctuation">)</span> (<em class="parameter"><code><a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-t" title="cairo_scaled_font_t"><span class="type">cairo_scaled_font_t</span></a> *scaled_font</code></em>,
|
181
|
+
<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>,
|
182
|
+
<em class="parameter"><code><a class="link" href="cairo-cairo-scaled-font-t.html#cairo-font-extents-t" title="cairo_font_extents_t"><span class="type">cairo_font_extents_t</span></a> *extents</code></em>);</pre>
|
183
|
+
<p><a class="link" href="cairo-User-Fonts.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
|
184
|
+
called when a scaled-font needs to be created for a user font-face.</p>
|
185
|
+
<p>The cairo context <em class="parameter"><code>cr</code></em>
|
186
|
+
is not used by the caller, but is prepared in font
|
121
187
|
space, similar to what the cairo contexts passed to the render_glyph
|
122
188
|
method will look like. The callback can use this context for extents
|
123
|
-
computation for example. After the callback is called, <em class="parameter"><code>cr</code></em>
|
124
|
-
|
125
|
-
|
126
|
-
<p>
|
127
|
-
|
128
|
-
<em class="parameter"><code>scaled_font</code></em
|
129
|
-
|
189
|
+
computation for example. After the callback is called, <em class="parameter"><code>cr</code></em>
|
190
|
+
is checked
|
191
|
+
for any error status.</p>
|
192
|
+
<p>The <em class="parameter"><code>extents</code></em>
|
193
|
+
argument is where the user font sets the font extents for
|
194
|
+
<em class="parameter"><code>scaled_font</code></em>
|
195
|
+
. It is in font space, which means that for most cases its
|
196
|
+
ascent and descent members should add to 1.0. <em class="parameter"><code>extents</code></em>
|
197
|
+
is preset to
|
130
198
|
hold a value of 1.0 for ascent, height, and max_x_advance, and 0.0 for
|
131
|
-
descent and max_y_advance members
|
132
|
-
|
133
|
-
|
134
|
-
|
135
|
-
|
136
|
-
</p>
|
137
|
-
<p>
|
138
|
-
Note that <em class="parameter"><code>scaled_font</code></em> is not fully initialized at this
|
199
|
+
descent and max_y_advance members.</p>
|
200
|
+
<p>The callback is optional. If not set, default font extents as described
|
201
|
+
in the previous paragraph will be used.</p>
|
202
|
+
<p>Note that <em class="parameter"><code>scaled_font</code></em>
|
203
|
+
is not fully initialized at this
|
139
204
|
point and trying to use it for text operations in the callback will result
|
140
|
-
in deadlock
|
141
|
-
|
142
|
-
<
|
143
|
-
<
|
205
|
+
in deadlock.</p>
|
206
|
+
<div class="refsect3">
|
207
|
+
<a name="id-1.4.8.7.2.9"></a><h4>Parameters</h4>
|
208
|
+
<div class="informaltable"><table width="100%" border="0">
|
209
|
+
<colgroup>
|
210
|
+
<col width="150px" class="parameters_name">
|
211
|
+
<col class="parameters_description">
|
212
|
+
<col width="200px" class="parameters_annotations">
|
213
|
+
</colgroup>
|
144
214
|
<tbody>
|
145
215
|
<tr>
|
146
|
-
<td
|
147
|
-
<td>the scaled-font being created</td>
|
148
|
-
</
|
149
|
-
<tr>
|
150
|
-
<td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
|
151
|
-
<td>a cairo context, in font space</td>
|
216
|
+
<td class="parameter_name"><p>scaled_font</p></td>
|
217
|
+
<td class="parameter_description"><p>the scaled-font being created</p></td>
|
218
|
+
<td class="parameter_annotations"> </td>
|
152
219
|
</tr>
|
153
220
|
<tr>
|
154
|
-
<td
|
155
|
-
<td>
|
221
|
+
<td class="parameter_name"><p>cr</p></td>
|
222
|
+
<td class="parameter_description"><p>a cairo context, in font space</p></td>
|
223
|
+
<td class="parameter_annotations"> </td>
|
156
224
|
</tr>
|
157
225
|
<tr>
|
158
|
-
<td
|
159
|
-
<td>
|
160
|
-
<
|
226
|
+
<td class="parameter_name"><p>extents</p></td>
|
227
|
+
<td class="parameter_description"><p>font extents to fill in, in font space</p></td>
|
228
|
+
<td class="parameter_annotations"> </td>
|
161
229
|
</tr>
|
162
230
|
</tbody>
|
163
231
|
</table></div>
|
232
|
+
</div>
|
233
|
+
<div class="refsect3">
|
234
|
+
<a name="id-1.4.8.7.2.10"></a><h4>Returns</h4>
|
235
|
+
<p> <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-SUCCESS:CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> upon success, or an error status on error.</p>
|
236
|
+
<p></p>
|
237
|
+
</div>
|
164
238
|
<p class="since">Since 1.8</p>
|
165
239
|
</div>
|
166
240
|
<hr>
|
167
241
|
<div class="refsect2">
|
168
|
-
<a name="cairo-user-scaled-font-render-glyph-func-t"></a><h3>cairo_user_scaled_font_render_glyph_func_t
|
169
|
-
<pre class="programlisting"><a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="returnvalue">cairo_status_t</span></a>
|
170
|
-
|
171
|
-
|
172
|
-
|
173
|
-
|
174
|
-
<
|
175
|
-
<a class="link" href="cairo-User-Fonts.html#cairo-user-scaled-font-render-glyph-func-t" title="cairo_user_scaled_font_render_glyph_func_t
|
176
|
-
is called when a user scaled-font needs to render a glyph
|
177
|
-
|
178
|
-
|
179
|
-
|
180
|
-
|
181
|
-
|
182
|
-
|
183
|
-
<em class="parameter"><code>scaled_font</code></em
|
184
|
-
|
185
|
-
|
186
|
-
|
187
|
-
|
188
|
-
|
189
|
-
<
|
190
|
-
|
242
|
+
<a name="cairo-user-scaled-font-render-glyph-func-t"></a><h3>cairo_user_scaled_font_render_glyph_func_t ()</h3>
|
243
|
+
<pre class="programlisting"><a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="returnvalue">cairo_status_t</span></a>
|
244
|
+
<span class="c_punctuation">(</span>*cairo_user_scaled_font_render_glyph_func_t<span class="c_punctuation">)</span>
|
245
|
+
(<em class="parameter"><code><a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-t" title="cairo_scaled_font_t"><span class="type">cairo_scaled_font_t</span></a> *scaled_font</code></em>,
|
246
|
+
<em class="parameter"><code><span class="type">unsigned long </span> glyph</code></em>,
|
247
|
+
<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>,
|
248
|
+
<em class="parameter"><code><a class="link" href="cairo-cairo-scaled-font-t.html#cairo-text-extents-t" title="cairo_text_extents_t"><span class="type">cairo_text_extents_t</span></a> *extents</code></em>);</pre>
|
249
|
+
<p><a class="link" href="cairo-User-Fonts.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
|
250
|
+
is called when a user scaled-font needs to render a glyph.</p>
|
251
|
+
<p>The callback is mandatory, and expected to draw the glyph with code <em class="parameter"><code>glyph</code></em>
|
252
|
+
to
|
253
|
+
the cairo context <em class="parameter"><code>cr</code></em>
|
254
|
+
. <em class="parameter"><code>cr</code></em>
|
255
|
+
is prepared such that the glyph drawing is done in
|
256
|
+
font space. That is, the matrix set on <em class="parameter"><code>cr</code></em>
|
257
|
+
is the scale matrix of <em class="parameter"><code>scaled_font</code></em>
|
258
|
+
,
|
259
|
+
The <em class="parameter"><code>extents</code></em>
|
260
|
+
argument is where the user font sets the font extents for
|
261
|
+
<em class="parameter"><code>scaled_font</code></em>
|
262
|
+
. However, if user prefers to draw in user space, they can
|
263
|
+
achieve that by changing the matrix on <em class="parameter"><code>cr</code></em>
|
264
|
+
. All cairo rendering operations
|
265
|
+
to <em class="parameter"><code>cr</code></em>
|
266
|
+
are permitted, however, the result is undefined if any source other
|
267
|
+
than the default source on <em class="parameter"><code>cr</code></em>
|
268
|
+
is used. That means, glyph bitmaps should
|
269
|
+
be rendered using <a class="link" href="cairo-cairo-t.html#cairo-mask" title="cairo_mask ()"><code class="function">cairo_mask()</code></a> instead of <a class="link" href="cairo-cairo-t.html#cairo-paint" title="cairo_paint ()"><code class="function">cairo_paint()</code></a>.</p>
|
270
|
+
<p>Other non-default settings on <em class="parameter"><code>cr</code></em>
|
271
|
+
include a font size of 1.0 (given that
|
191
272
|
it is set up to be in font space), and font options corresponding to
|
192
|
-
<em class="parameter"><code>scaled_font</code></em
|
193
|
-
|
194
|
-
<p>
|
195
|
-
|
273
|
+
<em class="parameter"><code>scaled_font</code></em>
|
274
|
+
.</p>
|
275
|
+
<p>The <em class="parameter"><code>extents</code></em>
|
276
|
+
argument is preset to have <code class="literal">x_bearing</code>,
|
196
277
|
<code class="literal">width</code>, and <code class="literal">y_advance</code> of zero,
|
197
278
|
<code class="literal">y_bearing</code> set to <code class="literal">-font_extents.ascent</code>,
|
198
279
|
<code class="literal">height</code> to <code class="literal">font_extents.ascent+font_extents.descent</code>,
|
@@ -201,477 +282,562 @@ The only field user needs to set in majority of cases is
|
|
201
282
|
<code class="literal">x_advance</code>.
|
202
283
|
If the <code class="literal">width</code> field is zero upon the callback returning
|
203
284
|
(which is its preset value), the glyph extents are automatically computed
|
204
|
-
based on the drawings done to <em class="parameter"><code>cr</code></em
|
285
|
+
based on the drawings done to <em class="parameter"><code>cr</code></em>
|
286
|
+
. This is in most cases exactly what the
|
205
287
|
desired behavior is. However, if for any reason the callback sets the
|
206
288
|
extents, it must be ink extents, and include the extents of all drawing
|
207
|
-
done to <em class="parameter"><code>cr</code></em>
|
208
|
-
|
209
|
-
<div class="
|
210
|
-
<
|
289
|
+
done to <em class="parameter"><code>cr</code></em>
|
290
|
+
in the callback.</p>
|
291
|
+
<div class="refsect3">
|
292
|
+
<a name="id-1.4.8.7.3.8"></a><h4>Parameters</h4>
|
293
|
+
<div class="informaltable"><table width="100%" border="0">
|
294
|
+
<colgroup>
|
295
|
+
<col width="150px" class="parameters_name">
|
296
|
+
<col class="parameters_description">
|
297
|
+
<col width="200px" class="parameters_annotations">
|
298
|
+
</colgroup>
|
211
299
|
<tbody>
|
212
300
|
<tr>
|
213
|
-
<td
|
214
|
-
<td>user scaled-font</td>
|
215
|
-
</
|
216
|
-
<tr>
|
217
|
-
<td><p><span class="term"><em class="parameter"><code>glyph</code></em> :</span></p></td>
|
218
|
-
<td>glyph code to render</td>
|
301
|
+
<td class="parameter_name"><p>scaled_font</p></td>
|
302
|
+
<td class="parameter_description"><p>user scaled-font</p></td>
|
303
|
+
<td class="parameter_annotations"> </td>
|
219
304
|
</tr>
|
220
305
|
<tr>
|
221
|
-
<td
|
222
|
-
<td>
|
306
|
+
<td class="parameter_name"><p>glyph</p></td>
|
307
|
+
<td class="parameter_description"><p>glyph code to render</p></td>
|
308
|
+
<td class="parameter_annotations"> </td>
|
223
309
|
</tr>
|
224
310
|
<tr>
|
225
|
-
<td
|
226
|
-
<td>
|
311
|
+
<td class="parameter_name"><p>cr</p></td>
|
312
|
+
<td class="parameter_description"><p>cairo context to draw to, in font space</p></td>
|
313
|
+
<td class="parameter_annotations"> </td>
|
227
314
|
</tr>
|
228
315
|
<tr>
|
229
|
-
<td
|
230
|
-
<td>
|
231
|
-
<
|
232
|
-
<a class="link" href="cairo-Error-handling.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>
|
316
|
+
<td class="parameter_name"><p>extents</p></td>
|
317
|
+
<td class="parameter_description"><p>glyph extents to fill in, in font space</p></td>
|
318
|
+
<td class="parameter_annotations"> </td>
|
233
319
|
</tr>
|
234
320
|
</tbody>
|
235
321
|
</table></div>
|
322
|
+
</div>
|
323
|
+
<div class="refsect3">
|
324
|
+
<a name="id-1.4.8.7.3.9"></a><h4>Returns</h4>
|
325
|
+
<p> <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-SUCCESS:CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> upon success, or
|
326
|
+
<a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-USER-FONT-ERROR:CAPS"><code class="literal">CAIRO_STATUS_USER_FONT_ERROR</code></a> or any other error status on error.</p>
|
327
|
+
<p></p>
|
328
|
+
</div>
|
236
329
|
<p class="since">Since 1.8</p>
|
237
330
|
</div>
|
238
331
|
<hr>
|
239
332
|
<div class="refsect2">
|
240
|
-
<a name="cairo-user-scaled-font-text-to-glyphs-func-t"></a><h3>cairo_user_scaled_font_text_to_glyphs_func_t
|
241
|
-
<pre class="programlisting"><a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="returnvalue">cairo_status_t</span></a>
|
242
|
-
|
243
|
-
|
244
|
-
|
245
|
-
|
246
|
-
|
247
|
-
|
248
|
-
|
249
|
-
|
250
|
-
<
|
251
|
-
<a class="link" href="cairo-User-Fonts.html#cairo-user-scaled-font-text-to-glyphs-func-t" title="cairo_user_scaled_font_text_to_glyphs_func_t
|
333
|
+
<a name="cairo-user-scaled-font-text-to-glyphs-func-t"></a><h3>cairo_user_scaled_font_text_to_glyphs_func_t ()</h3>
|
334
|
+
<pre class="programlisting"><a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="returnvalue">cairo_status_t</span></a>
|
335
|
+
<span class="c_punctuation">(</span>*cairo_user_scaled_font_text_to_glyphs_func_t<span class="c_punctuation">)</span>
|
336
|
+
(<em class="parameter"><code><a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-t" title="cairo_scaled_font_t"><span class="type">cairo_scaled_font_t</span></a> *scaled_font</code></em>,
|
337
|
+
<em class="parameter"><code>const <span class="type">char</span> *utf8</code></em>,
|
338
|
+
<em class="parameter"><code><span class="type">int</span> utf8_len</code></em>,
|
339
|
+
<em class="parameter"><code><a class="link" href="cairo-text.html#cairo-glyph-t" title="cairo_glyph_t"><span class="type">cairo_glyph_t</span></a> **glyphs</code></em>,
|
340
|
+
<em class="parameter"><code><span class="type">int</span> *num_glyphs</code></em>,
|
341
|
+
<em class="parameter"><code><a class="link" href="cairo-text.html#cairo-text-cluster-t" title="cairo_text_cluster_t"><span class="type">cairo_text_cluster_t</span></a> **clusters</code></em>,
|
342
|
+
<em class="parameter"><code><span class="type">int</span> *num_clusters</code></em>,
|
343
|
+
<em class="parameter"><code><a class="link" href="cairo-text.html#cairo-text-cluster-flags-t" title="enum cairo_text_cluster_flags_t"><span class="type">cairo_text_cluster_flags_t</span></a> *cluster_flags</code></em>);</pre>
|
344
|
+
<p><a class="link" href="cairo-User-Fonts.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
|
252
345
|
is called to convert input text to an array of glyphs. This is used by the
|
253
|
-
<a class="link" href="cairo-text.html#cairo-show-text" title="cairo_show_text
|
254
|
-
|
255
|
-
<p>
|
256
|
-
Using this callback the user-font has full control on glyphs and their
|
346
|
+
<a class="link" href="cairo-text.html#cairo-show-text" title="cairo_show_text ()"><code class="function">cairo_show_text()</code></a> operation.</p>
|
347
|
+
<p>Using this callback the user-font has full control on glyphs and their
|
257
348
|
positions. That means, it allows for features like ligatures and kerning,
|
258
349
|
as well as complex <em class="firstterm">shaping</em> required for scripts like
|
259
|
-
Arabic and Indic
|
260
|
-
|
261
|
-
|
262
|
-
|
263
|
-
|
264
|
-
<
|
350
|
+
Arabic and Indic.</p>
|
351
|
+
<p>The <em class="parameter"><code>num_glyphs</code></em>
|
352
|
+
argument is preset to the number of glyph entries available
|
353
|
+
in the <em class="parameter"><code>glyphs</code></em>
|
354
|
+
buffer. If the <em class="parameter"><code>glyphs</code></em>
|
355
|
+
buffer is <code class="literal">NULL</code>, the value of
|
356
|
+
<em class="parameter"><code>num_glyphs</code></em>
|
357
|
+
will be zero. If the provided glyph array is too short for
|
265
358
|
the conversion (or for convenience), a new glyph array may be allocated
|
266
|
-
using <a class="link" href="cairo-text.html#cairo-glyph-allocate" title="cairo_glyph_allocate
|
267
|
-
|
268
|
-
<em class="parameter"><code>
|
269
|
-
|
270
|
-
|
359
|
+
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>
|
360
|
+
. Upon return,
|
361
|
+
<em class="parameter"><code>num_glyphs</code></em>
|
362
|
+
should contain the number of generated glyphs. If the value
|
363
|
+
<em class="parameter"><code>glyphs</code></em>
|
364
|
+
points at has changed after the call, the caller will free the
|
365
|
+
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>. The caller will also free
|
366
|
+
the original value of <em class="parameter"><code>glyphs</code></em>
|
367
|
+
, so the callback shouldn't do so.
|
271
368
|
The callback should populate the glyph indices and positions (in font space)
|
272
|
-
assuming that the text is to be shown at the origin
|
273
|
-
|
274
|
-
<
|
275
|
-
|
276
|
-
|
369
|
+
assuming that the text is to be shown at the origin.</p>
|
370
|
+
<p>If <em class="parameter"><code>clusters</code></em>
|
371
|
+
is not <code class="literal">NULL</code>, <em class="parameter"><code>num_clusters</code></em>
|
372
|
+
and <em class="parameter"><code>cluster_flags</code></em>
|
373
|
+
are also
|
374
|
+
non-<code class="literal">NULL</code>, and cluster mapping should be computed. The semantics of how
|
277
375
|
cluster array allocation works is similar to the glyph array. That is,
|
278
|
-
if <em class="parameter"><code>clusters</code></em>
|
279
|
-
|
376
|
+
if <em class="parameter"><code>clusters</code></em>
|
377
|
+
initially points to a non-<code class="literal">NULL</code> value, that array may be used
|
378
|
+
as a cluster buffer, and <em class="parameter"><code>num_clusters</code></em>
|
379
|
+
points to the number of cluster
|
280
380
|
entries available there. If the provided cluster array is too short for
|
281
381
|
the conversion (or for convenience), a new cluster array may be allocated
|
282
|
-
using <a class="link" href="cairo-text.html#cairo-text-cluster-allocate" title="cairo_text_cluster_allocate
|
283
|
-
|
284
|
-
|
285
|
-
|
286
|
-
|
287
|
-
|
288
|
-
<
|
289
|
-
|
382
|
+
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>
|
383
|
+
. In this case,
|
384
|
+
the original value of <em class="parameter"><code>clusters</code></em>
|
385
|
+
will still be freed by the caller. Upon
|
386
|
+
return, <em class="parameter"><code>num_clusters</code></em>
|
387
|
+
should contain the number of generated clusters.
|
388
|
+
If the value <em class="parameter"><code>clusters</code></em>
|
389
|
+
points at has changed after the call, the caller
|
390
|
+
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>
|
391
|
+
<p>The callback is optional. If <em class="parameter"><code>num_glyphs</code></em>
|
392
|
+
is negative upon
|
290
393
|
the callback returning or if the return value
|
291
394
|
is <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-USER-FONT-NOT-IMPLEMENTED:CAPS"><code class="literal">CAIRO_STATUS_USER_FONT_NOT_IMPLEMENTED</code></a>, the unicode_to_glyph callback
|
292
|
-
is tried. See <a class="link" href="cairo-User-Fonts.html#cairo-user-scaled-font-unicode-to-glyph-func-t" title="cairo_user_scaled_font_unicode_to_glyph_func_t
|
293
|
-
|
294
|
-
<p>
|
295
|
-
Note: While cairo does not impose any limitation on glyph indices,
|
395
|
+
is tried. See <a class="link" href="cairo-User-Fonts.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>
|
396
|
+
<p>Note: While cairo does not impose any limitation on glyph indices,
|
296
397
|
some applications may assume that a glyph index fits in a 16-bit
|
297
398
|
unsigned integer. As such, it is advised that user-fonts keep their
|
298
399
|
glyphs in the 0 to 65535 range. Furthermore, some applications may
|
299
400
|
assume that glyph 0 is a special glyph-not-found glyph. User-fonts
|
300
401
|
are advised to use glyph 0 for such purposes and do not use that
|
301
|
-
glyph value for other purposes
|
302
|
-
|
303
|
-
<
|
304
|
-
<
|
402
|
+
glyph value for other purposes.</p>
|
403
|
+
<div class="refsect3">
|
404
|
+
<a name="id-1.4.8.7.4.10"></a><h4>Parameters</h4>
|
405
|
+
<div class="informaltable"><table width="100%" border="0">
|
406
|
+
<colgroup>
|
407
|
+
<col width="150px" class="parameters_name">
|
408
|
+
<col class="parameters_description">
|
409
|
+
<col width="200px" class="parameters_annotations">
|
410
|
+
</colgroup>
|
305
411
|
<tbody>
|
306
412
|
<tr>
|
307
|
-
<td
|
308
|
-
<td>the scaled-font being created</td>
|
413
|
+
<td class="parameter_name"><p>scaled_font</p></td>
|
414
|
+
<td class="parameter_description"><p>the scaled-font being created</p></td>
|
415
|
+
<td class="parameter_annotations"> </td>
|
309
416
|
</tr>
|
310
417
|
<tr>
|
311
|
-
<td
|
312
|
-
<td>a string of text encoded in UTF-8</td>
|
418
|
+
<td class="parameter_name"><p>utf8</p></td>
|
419
|
+
<td class="parameter_description"><p>a string of text encoded in UTF-8</p></td>
|
420
|
+
<td class="parameter_annotations"> </td>
|
313
421
|
</tr>
|
314
422
|
<tr>
|
315
|
-
<td
|
316
|
-
<td>length of <em class="parameter"><code>utf8</code></em>
|
423
|
+
<td class="parameter_name"><p>utf8_len</p></td>
|
424
|
+
<td class="parameter_description"><p>length of <em class="parameter"><code>utf8</code></em>
|
425
|
+
in bytes</p></td>
|
426
|
+
<td class="parameter_annotations"> </td>
|
317
427
|
</tr>
|
318
428
|
<tr>
|
319
|
-
<td
|
320
|
-
<td>pointer to array of glyphs to fill, in font space</td>
|
429
|
+
<td class="parameter_name"><p>glyphs</p></td>
|
430
|
+
<td class="parameter_description"><p>pointer to array of glyphs to fill, in font space</p></td>
|
431
|
+
<td class="parameter_annotations"> </td>
|
321
432
|
</tr>
|
322
433
|
<tr>
|
323
|
-
<td
|
324
|
-
<td>pointer to number of glyphs</td>
|
434
|
+
<td class="parameter_name"><p>num_glyphs</p></td>
|
435
|
+
<td class="parameter_description"><p>pointer to number of glyphs</p></td>
|
436
|
+
<td class="parameter_annotations"> </td>
|
325
437
|
</tr>
|
326
438
|
<tr>
|
327
|
-
<td
|
328
|
-
<td>pointer to array of cluster mapping information to fill, or <
|
329
|
-
</td>
|
439
|
+
<td class="parameter_name"><p>clusters</p></td>
|
440
|
+
<td class="parameter_description"><p>pointer to array of cluster mapping information to fill, or <code class="literal">NULL</code></p></td>
|
441
|
+
<td class="parameter_annotations"> </td>
|
330
442
|
</tr>
|
331
443
|
<tr>
|
332
|
-
<td
|
333
|
-
<td>pointer to number of clusters</td>
|
444
|
+
<td class="parameter_name"><p>num_clusters</p></td>
|
445
|
+
<td class="parameter_description"><p>pointer to number of clusters</p></td>
|
446
|
+
<td class="parameter_annotations"> </td>
|
334
447
|
</tr>
|
335
448
|
<tr>
|
336
|
-
<td
|
337
|
-
<td>pointer to location to store cluster flags corresponding to the
|
449
|
+
<td class="parameter_name"><p>cluster_flags</p></td>
|
450
|
+
<td class="parameter_description"><p>pointer to location to store cluster flags corresponding to the
|
338
451
|
output <em class="parameter"><code>clusters</code></em>
|
339
|
-
</td>
|
340
|
-
</
|
341
|
-
<tr>
|
342
|
-
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
343
|
-
<td>
|
344
|
-
<a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-SUCCESS:CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> upon success,
|
345
|
-
<a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-USER-FONT-NOT-IMPLEMENTED:CAPS"><code class="literal">CAIRO_STATUS_USER_FONT_NOT_IMPLEMENTED</code></a> if fallback options should be tried,
|
346
|
-
or <a class="link" href="cairo-Error-handling.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>
|
452
|
+
</p></td>
|
453
|
+
<td class="parameter_annotations"> </td>
|
347
454
|
</tr>
|
348
455
|
</tbody>
|
349
456
|
</table></div>
|
457
|
+
</div>
|
458
|
+
<div class="refsect3">
|
459
|
+
<a name="id-1.4.8.7.4.11"></a><h4>Returns</h4>
|
460
|
+
<p> <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-SUCCESS:CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> upon success,
|
461
|
+
<a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-USER-FONT-NOT-IMPLEMENTED:CAPS"><code class="literal">CAIRO_STATUS_USER_FONT_NOT_IMPLEMENTED</code></a> if fallback options should be tried,
|
462
|
+
or <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-USER-FONT-ERROR:CAPS"><code class="literal">CAIRO_STATUS_USER_FONT_ERROR</code></a> or any other error status on error.</p>
|
463
|
+
<p></p>
|
464
|
+
</div>
|
350
465
|
<p class="since">Since 1.8</p>
|
351
466
|
</div>
|
352
467
|
<hr>
|
353
468
|
<div class="refsect2">
|
354
|
-
<a name="cairo-user-scaled-font-unicode-to-glyph-func-t"></a><h3>cairo_user_scaled_font_unicode_to_glyph_func_t
|
355
|
-
<pre class="programlisting"><a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="returnvalue">cairo_status_t</span></a>
|
356
|
-
|
357
|
-
|
358
|
-
|
359
|
-
<
|
360
|
-
<a class="link" href="cairo-User-Fonts.html#cairo-user-scaled-font-unicode-to-glyph-func-t" title="cairo_user_scaled_font_unicode_to_glyph_func_t
|
469
|
+
<a name="cairo-user-scaled-font-unicode-to-glyph-func-t"></a><h3>cairo_user_scaled_font_unicode_to_glyph_func_t ()</h3>
|
470
|
+
<pre class="programlisting"><a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="returnvalue">cairo_status_t</span></a>
|
471
|
+
<span class="c_punctuation">(</span>*cairo_user_scaled_font_unicode_to_glyph_func_t<span class="c_punctuation">)</span>
|
472
|
+
(<em class="parameter"><code><a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-t" title="cairo_scaled_font_t"><span class="type">cairo_scaled_font_t</span></a> *scaled_font</code></em>,
|
473
|
+
<em class="parameter"><code><span class="type">unsigned long </span> unicode</code></em>,
|
474
|
+
<em class="parameter"><code>unsigned <span class="type">long</span> *glyph_index</code></em>);</pre>
|
475
|
+
<p><a class="link" href="cairo-User-Fonts.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
|
361
476
|
is called to convert an input Unicode character to a single glyph.
|
362
|
-
This is used by the <a class="link" href="cairo-text.html#cairo-show-text" title="cairo_show_text
|
363
|
-
|
364
|
-
<
|
365
|
-
This callback is used to provide the same functionality as the
|
366
|
-
text_to_glyphs callback does (see <a class="link" href="cairo-User-Fonts.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>)
|
477
|
+
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>
|
478
|
+
<p>This callback is used to provide the same functionality as the
|
479
|
+
text_to_glyphs callback does (see <a class="link" href="cairo-User-Fonts.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>)
|
367
480
|
but has much less control on the output,
|
368
481
|
in exchange for increased ease of use. The inherent assumption to using
|
369
482
|
this callback is that each character maps to one glyph, and that the
|
370
483
|
mapping is context independent. It also assumes that glyphs are positioned
|
371
484
|
according to their advance width. These mean no ligatures, kerning, or
|
372
|
-
complex scripts can be implemented using this callback
|
373
|
-
|
374
|
-
<p>
|
375
|
-
The callback is optional, and only used if text_to_glyphs callback is not
|
485
|
+
complex scripts can be implemented using this callback.</p>
|
486
|
+
<p>The callback is optional, and only used if text_to_glyphs callback is not
|
376
487
|
set or fails to return glyphs. If this callback is not set or if it returns
|
377
488
|
<a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-USER-FONT-NOT-IMPLEMENTED:CAPS"><code class="literal">CAIRO_STATUS_USER_FONT_NOT_IMPLEMENTED</code></a>, an identity mapping from Unicode
|
378
|
-
code-points to glyph indices is assumed
|
379
|
-
|
380
|
-
<p>
|
381
|
-
Note: While cairo does not impose any limitation on glyph indices,
|
489
|
+
code-points to glyph indices is assumed.</p>
|
490
|
+
<p>Note: While cairo does not impose any limitation on glyph indices,
|
382
491
|
some applications may assume that a glyph index fits in a 16-bit
|
383
492
|
unsigned integer. As such, it is advised that user-fonts keep their
|
384
493
|
glyphs in the 0 to 65535 range. Furthermore, some applications may
|
385
494
|
assume that glyph 0 is a special glyph-not-found glyph. User-fonts
|
386
495
|
are advised to use glyph 0 for such purposes and do not use that
|
387
|
-
glyph value for other purposes
|
388
|
-
|
389
|
-
<
|
390
|
-
<
|
496
|
+
glyph value for other purposes.</p>
|
497
|
+
<div class="refsect3">
|
498
|
+
<a name="id-1.4.8.7.5.8"></a><h4>Parameters</h4>
|
499
|
+
<div class="informaltable"><table width="100%" border="0">
|
500
|
+
<colgroup>
|
501
|
+
<col width="150px" class="parameters_name">
|
502
|
+
<col class="parameters_description">
|
503
|
+
<col width="200px" class="parameters_annotations">
|
504
|
+
</colgroup>
|
391
505
|
<tbody>
|
392
506
|
<tr>
|
393
|
-
<td
|
394
|
-
<td>the scaled-font being created</td>
|
507
|
+
<td class="parameter_name"><p>scaled_font</p></td>
|
508
|
+
<td class="parameter_description"><p>the scaled-font being created</p></td>
|
509
|
+
<td class="parameter_annotations"> </td>
|
395
510
|
</tr>
|
396
511
|
<tr>
|
397
|
-
<td
|
398
|
-
<td>input unicode character code-point</td>
|
512
|
+
<td class="parameter_name"><p>unicode</p></td>
|
513
|
+
<td class="parameter_description"><p>input unicode character code-point</p></td>
|
514
|
+
<td class="parameter_annotations"> </td>
|
399
515
|
</tr>
|
400
516
|
<tr>
|
401
|
-
<td
|
402
|
-
<td>output glyph index</td>
|
403
|
-
</
|
404
|
-
<tr>
|
405
|
-
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
406
|
-
<td>
|
407
|
-
<a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-SUCCESS:CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> upon success,
|
408
|
-
<a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-USER-FONT-NOT-IMPLEMENTED:CAPS"><code class="literal">CAIRO_STATUS_USER_FONT_NOT_IMPLEMENTED</code></a> if fallback options should be tried,
|
409
|
-
or <a class="link" href="cairo-Error-handling.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>
|
517
|
+
<td class="parameter_name"><p>glyph_index</p></td>
|
518
|
+
<td class="parameter_description"><p>output glyph index</p></td>
|
519
|
+
<td class="parameter_annotations"> </td>
|
410
520
|
</tr>
|
411
521
|
</tbody>
|
412
522
|
</table></div>
|
523
|
+
</div>
|
524
|
+
<div class="refsect3">
|
525
|
+
<a name="id-1.4.8.7.5.9"></a><h4>Returns</h4>
|
526
|
+
<p> <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-SUCCESS:CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> upon success,
|
527
|
+
<a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-USER-FONT-NOT-IMPLEMENTED:CAPS"><code class="literal">CAIRO_STATUS_USER_FONT_NOT_IMPLEMENTED</code></a> if fallback options should be tried,
|
528
|
+
or <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-USER-FONT-ERROR:CAPS"><code class="literal">CAIRO_STATUS_USER_FONT_ERROR</code></a> or any other error status on error.</p>
|
529
|
+
<p></p>
|
530
|
+
</div>
|
413
531
|
<p class="since">Since 1.8</p>
|
414
532
|
</div>
|
415
533
|
<hr>
|
416
534
|
<div class="refsect2">
|
417
|
-
<a name="cairo-user-font-face-create"></a><h3>cairo_user_font_face_create
|
418
|
-
<pre class="programlisting"><a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="returnvalue">cairo_font_face_t</span></a>
|
419
|
-
<
|
420
|
-
Creates a new user font-face
|
421
|
-
|
422
|
-
|
423
|
-
|
424
|
-
|
425
|
-
</p>
|
426
|
-
<p>
|
427
|
-
After the font-face is created, the user can attach arbitrary data
|
428
|
-
(the actual font data) to it using <a class="link" href="cairo-cairo-font-face-t.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>
|
535
|
+
<a name="cairo-user-font-face-create"></a><h3>cairo_user_font_face_create ()</h3>
|
536
|
+
<pre class="programlisting"><a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="returnvalue">cairo_font_face_t</span></a> *
|
537
|
+
cairo_user_font_face_create (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
|
538
|
+
<p>Creates a new user font-face.</p>
|
539
|
+
<p>Use the setter functions to associate callbacks with the returned
|
540
|
+
user font. The only mandatory callback is render_glyph.</p>
|
541
|
+
<p>After the font-face is created, the user can attach arbitrary data
|
542
|
+
(the actual font data) to it using <a class="link" href="cairo-cairo-font-face-t.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>
|
429
543
|
and access it from the user-font callbacks by using
|
430
|
-
<a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-get-font-face" title="cairo_scaled_font_get_font_face
|
431
|
-
<a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-get-user-data" title="cairo_font_face_get_user_data
|
432
|
-
|
433
|
-
<
|
434
|
-
<
|
435
|
-
<
|
436
|
-
<
|
437
|
-
|
438
|
-
<a class="link" href="cairo-cairo-font-face-t.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>
|
439
|
-
</tr></tbody>
|
440
|
-
</table></div>
|
544
|
+
<a class="link" href="cairo-cairo-scaled-font-t.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
|
545
|
+
<a class="link" href="cairo-cairo-font-face-t.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>
|
546
|
+
<div class="refsect3">
|
547
|
+
<a name="id-1.4.8.7.6.7"></a><h4>Returns</h4>
|
548
|
+
<p> a newly created <a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a>. Free with
|
549
|
+
<a class="link" href="cairo-cairo-font-face-t.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.</p>
|
550
|
+
<p></p>
|
551
|
+
</div>
|
441
552
|
<p class="since">Since 1.8</p>
|
442
553
|
</div>
|
443
554
|
<hr>
|
444
555
|
<div class="refsect2">
|
445
|
-
<a name="cairo-user-font-face-set-init-func"></a><h3>cairo_user_font_face_set_init_func
|
446
|
-
<pre class="programlisting"><span class="returnvalue">void</span>
|
447
|
-
|
448
|
-
<
|
449
|
-
Sets the scaled-font initialization function of a user-font.
|
450
|
-
See <a class="link" href="cairo-User-Fonts.html#cairo-user-scaled-font-init-func-t" title="cairo_user_scaled_font_init_func_t
|
451
|
-
works
|
452
|
-
|
453
|
-
<p>
|
454
|
-
The font-face should not be immutable or a <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-USER-FONT-IMMUTABLE:CAPS"><code class="literal">CAIRO_STATUS_USER_FONT_IMMUTABLE</code></a>
|
556
|
+
<a name="cairo-user-font-face-set-init-func"></a><h3>cairo_user_font_face_set_init_func ()</h3>
|
557
|
+
<pre class="programlisting"><span class="returnvalue">void</span>
|
558
|
+
cairo_user_font_face_set_init_func (<em class="parameter"><code><a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a> *font_face</code></em>,
|
559
|
+
<em class="parameter"><code><a class="link" href="cairo-User-Fonts.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> init_func</code></em>);</pre>
|
560
|
+
<p>Sets the scaled-font initialization function of a user-font.
|
561
|
+
See <a class="link" href="cairo-User-Fonts.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
|
562
|
+
works.</p>
|
563
|
+
<p>The font-face should not be immutable or a <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-USER-FONT-IMMUTABLE:CAPS"><code class="literal">CAIRO_STATUS_USER_FONT_IMMUTABLE</code></a>
|
455
564
|
error will occur. A user font-face is immutable as soon as a scaled-font
|
456
|
-
is created from it
|
457
|
-
|
458
|
-
<
|
459
|
-
<
|
565
|
+
is created from it.</p>
|
566
|
+
<div class="refsect3">
|
567
|
+
<a name="id-1.4.8.7.7.6"></a><h4>Parameters</h4>
|
568
|
+
<div class="informaltable"><table width="100%" border="0">
|
569
|
+
<colgroup>
|
570
|
+
<col width="150px" class="parameters_name">
|
571
|
+
<col class="parameters_description">
|
572
|
+
<col width="200px" class="parameters_annotations">
|
573
|
+
</colgroup>
|
460
574
|
<tbody>
|
461
575
|
<tr>
|
462
|
-
<td
|
463
|
-
<td>A user font face</td>
|
576
|
+
<td class="parameter_name"><p>font_face</p></td>
|
577
|
+
<td class="parameter_description"><p>A user font face</p></td>
|
578
|
+
<td class="parameter_annotations"> </td>
|
464
579
|
</tr>
|
465
580
|
<tr>
|
466
|
-
<td
|
467
|
-
<td>The init callback, or <
|
468
|
-
</td>
|
581
|
+
<td class="parameter_name"><p>init_func</p></td>
|
582
|
+
<td class="parameter_description"><p>The init callback, or <code class="literal">NULL</code></p></td>
|
583
|
+
<td class="parameter_annotations"> </td>
|
469
584
|
</tr>
|
470
585
|
</tbody>
|
471
586
|
</table></div>
|
587
|
+
</div>
|
472
588
|
<p class="since">Since 1.8</p>
|
473
589
|
</div>
|
474
590
|
<hr>
|
475
591
|
<div class="refsect2">
|
476
|
-
<a name="cairo-user-font-face-get-init-func"></a><h3>cairo_user_font_face_get_init_func
|
477
|
-
<pre class="programlisting"><a class="link" href="cairo-User-Fonts.html#cairo-user-scaled-font-init-func-t" title="cairo_user_scaled_font_init_func_t
|
478
|
-
|
479
|
-
<p>
|
480
|
-
|
481
|
-
</
|
482
|
-
<div class="
|
483
|
-
<
|
484
|
-
<
|
485
|
-
<
|
486
|
-
<
|
487
|
-
|
488
|
-
|
489
|
-
<
|
490
|
-
<td
|
491
|
-
<td
|
492
|
-
|
493
|
-
</tr>
|
494
|
-
</tbody>
|
592
|
+
<a name="cairo-user-font-face-get-init-func"></a><h3>cairo_user_font_face_get_init_func ()</h3>
|
593
|
+
<pre class="programlisting"><a class="link" href="cairo-User-Fonts.html#cairo-user-scaled-font-init-func-t" title="cairo_user_scaled_font_init_func_t ()"><span class="returnvalue">cairo_user_scaled_font_init_func_t</span></a>
|
594
|
+
cairo_user_font_face_get_init_func (<em class="parameter"><code><a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a> *font_face</code></em>);</pre>
|
595
|
+
<p>Gets the scaled-font initialization function of a user-font.</p>
|
596
|
+
<div class="refsect3">
|
597
|
+
<a name="id-1.4.8.7.8.5"></a><h4>Parameters</h4>
|
598
|
+
<div class="informaltable"><table width="100%" border="0">
|
599
|
+
<colgroup>
|
600
|
+
<col width="150px" class="parameters_name">
|
601
|
+
<col class="parameters_description">
|
602
|
+
<col width="200px" class="parameters_annotations">
|
603
|
+
</colgroup>
|
604
|
+
<tbody><tr>
|
605
|
+
<td class="parameter_name"><p>font_face</p></td>
|
606
|
+
<td class="parameter_description"><p>A user font face</p></td>
|
607
|
+
<td class="parameter_annotations"> </td>
|
608
|
+
</tr></tbody>
|
495
609
|
</table></div>
|
610
|
+
</div>
|
611
|
+
<div class="refsect3">
|
612
|
+
<a name="id-1.4.8.7.8.6"></a><h4>Returns</h4>
|
613
|
+
<p> The init callback of <em class="parameter"><code>font_face</code></em>
|
614
|
+
or <code class="literal">NULL</code> if none set or an error has occurred.</p>
|
615
|
+
<p></p>
|
616
|
+
</div>
|
496
617
|
<p class="since">Since 1.8</p>
|
497
618
|
</div>
|
498
619
|
<hr>
|
499
620
|
<div class="refsect2">
|
500
|
-
<a name="cairo-user-font-face-set-render-glyph-func"></a><h3>cairo_user_font_face_set_render_glyph_func
|
501
|
-
<pre class="programlisting"><span class="returnvalue">void</span>
|
502
|
-
|
503
|
-
|
504
|
-
<
|
505
|
-
Sets the glyph rendering function of a user-font.
|
506
|
-
See <a class="link" href="cairo-User-Fonts.html#cairo-user-scaled-font-render-glyph-func-t" title="cairo_user_scaled_font_render_glyph_func_t
|
507
|
-
works
|
508
|
-
|
509
|
-
<p>
|
510
|
-
The font-face should not be immutable or a <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-USER-FONT-IMMUTABLE:CAPS"><code class="literal">CAIRO_STATUS_USER_FONT_IMMUTABLE</code></a>
|
621
|
+
<a name="cairo-user-font-face-set-render-glyph-func"></a><h3>cairo_user_font_face_set_render_glyph_func ()</h3>
|
622
|
+
<pre class="programlisting"><span class="returnvalue">void</span>
|
623
|
+
cairo_user_font_face_set_render_glyph_func
|
624
|
+
(<em class="parameter"><code><a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a> *font_face</code></em>,
|
625
|
+
<em class="parameter"><code><a class="link" href="cairo-User-Fonts.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> render_glyph_func</code></em>);</pre>
|
626
|
+
<p>Sets the glyph rendering function of a user-font.
|
627
|
+
See <a class="link" href="cairo-User-Fonts.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
|
628
|
+
works.</p>
|
629
|
+
<p>The font-face should not be immutable or a <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-USER-FONT-IMMUTABLE:CAPS"><code class="literal">CAIRO_STATUS_USER_FONT_IMMUTABLE</code></a>
|
511
630
|
error will occur. A user font-face is immutable as soon as a scaled-font
|
512
|
-
is created from it
|
513
|
-
|
514
|
-
<
|
515
|
-
|
516
|
-
|
517
|
-
<
|
518
|
-
</
|
519
|
-
<div class="
|
520
|
-
<
|
631
|
+
is created from it.</p>
|
632
|
+
<p>The render_glyph callback is the only mandatory callback of a user-font.
|
633
|
+
If the callback is <code class="literal">NULL</code> and a glyph is tried to be rendered using
|
634
|
+
<em class="parameter"><code>font_face</code></em>
|
635
|
+
, a <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-USER-FONT-ERROR:CAPS"><code class="literal">CAIRO_STATUS_USER_FONT_ERROR</code></a> will occur.</p>
|
636
|
+
<div class="refsect3">
|
637
|
+
<a name="id-1.4.8.7.9.7"></a><h4>Parameters</h4>
|
638
|
+
<div class="informaltable"><table width="100%" border="0">
|
639
|
+
<colgroup>
|
640
|
+
<col width="150px" class="parameters_name">
|
641
|
+
<col class="parameters_description">
|
642
|
+
<col width="200px" class="parameters_annotations">
|
643
|
+
</colgroup>
|
521
644
|
<tbody>
|
522
645
|
<tr>
|
523
|
-
<td
|
524
|
-
<td>A user font face</td>
|
646
|
+
<td class="parameter_name"><p>font_face</p></td>
|
647
|
+
<td class="parameter_description"><p>A user font face</p></td>
|
648
|
+
<td class="parameter_annotations"> </td>
|
525
649
|
</tr>
|
526
650
|
<tr>
|
527
|
-
<td
|
528
|
-
<td>The render_glyph callback, or <
|
529
|
-
</td>
|
651
|
+
<td class="parameter_name"><p>render_glyph_func</p></td>
|
652
|
+
<td class="parameter_description"><p>The render_glyph callback, or <code class="literal">NULL</code></p></td>
|
653
|
+
<td class="parameter_annotations"> </td>
|
530
654
|
</tr>
|
531
655
|
</tbody>
|
532
656
|
</table></div>
|
657
|
+
</div>
|
533
658
|
<p class="since">Since 1.8</p>
|
534
659
|
</div>
|
535
660
|
<hr>
|
536
661
|
<div class="refsect2">
|
537
|
-
<a name="cairo-user-font-face-get-render-glyph-func"></a><h3>cairo_user_font_face_get_render_glyph_func
|
538
|
-
<pre class="programlisting"><a class="link" href="cairo-User-Fonts.html#cairo-user-scaled-font-render-glyph-func-t" title="cairo_user_scaled_font_render_glyph_func_t
|
539
|
-
|
540
|
-
<
|
541
|
-
Gets the glyph rendering function of a user-font
|
542
|
-
|
543
|
-
<
|
544
|
-
<
|
545
|
-
<
|
546
|
-
<
|
547
|
-
<
|
548
|
-
<
|
549
|
-
</
|
550
|
-
<tr>
|
551
|
-
<td
|
552
|
-
<td
|
553
|
-
|
554
|
-
</tr>
|
555
|
-
</tbody>
|
662
|
+
<a name="cairo-user-font-face-get-render-glyph-func"></a><h3>cairo_user_font_face_get_render_glyph_func ()</h3>
|
663
|
+
<pre class="programlisting"><a class="link" href="cairo-User-Fonts.html#cairo-user-scaled-font-render-glyph-func-t" title="cairo_user_scaled_font_render_glyph_func_t ()"><span class="returnvalue">cairo_user_scaled_font_render_glyph_func_t</span></a>
|
664
|
+
cairo_user_font_face_get_render_glyph_func
|
665
|
+
(<em class="parameter"><code><a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a> *font_face</code></em>);</pre>
|
666
|
+
<p>Gets the glyph rendering function of a user-font.</p>
|
667
|
+
<div class="refsect3">
|
668
|
+
<a name="id-1.4.8.7.10.5"></a><h4>Parameters</h4>
|
669
|
+
<div class="informaltable"><table width="100%" border="0">
|
670
|
+
<colgroup>
|
671
|
+
<col width="150px" class="parameters_name">
|
672
|
+
<col class="parameters_description">
|
673
|
+
<col width="200px" class="parameters_annotations">
|
674
|
+
</colgroup>
|
675
|
+
<tbody><tr>
|
676
|
+
<td class="parameter_name"><p>font_face</p></td>
|
677
|
+
<td class="parameter_description"><p>A user font face</p></td>
|
678
|
+
<td class="parameter_annotations"> </td>
|
679
|
+
</tr></tbody>
|
556
680
|
</table></div>
|
681
|
+
</div>
|
682
|
+
<div class="refsect3">
|
683
|
+
<a name="id-1.4.8.7.10.6"></a><h4>Returns</h4>
|
684
|
+
<p> The render_glyph callback of <em class="parameter"><code>font_face</code></em>
|
685
|
+
or <code class="literal">NULL</code> if none set or an error has occurred.</p>
|
686
|
+
<p></p>
|
687
|
+
</div>
|
557
688
|
<p class="since">Since 1.8</p>
|
558
689
|
</div>
|
559
690
|
<hr>
|
560
691
|
<div class="refsect2">
|
561
|
-
<a name="cairo-user-font-face-set-unicode-to-glyph-func"></a><h3>cairo_user_font_face_set_unicode_to_glyph_func
|
562
|
-
<pre class="programlisting"><span class="returnvalue">void</span>
|
563
|
-
|
564
|
-
|
565
|
-
<
|
566
|
-
Sets the unicode-to-glyph conversion function of a user-font.
|
567
|
-
See <a class="link" href="cairo-User-Fonts.html#cairo-user-scaled-font-unicode-to-glyph-func-t" title="cairo_user_scaled_font_unicode_to_glyph_func_t
|
568
|
-
works
|
569
|
-
|
570
|
-
<p>
|
571
|
-
The font-face should not be immutable or a <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-USER-FONT-IMMUTABLE:CAPS"><code class="literal">CAIRO_STATUS_USER_FONT_IMMUTABLE</code></a>
|
692
|
+
<a name="cairo-user-font-face-set-unicode-to-glyph-func"></a><h3>cairo_user_font_face_set_unicode_to_glyph_func ()</h3>
|
693
|
+
<pre class="programlisting"><span class="returnvalue">void</span>
|
694
|
+
cairo_user_font_face_set_unicode_to_glyph_func
|
695
|
+
(<em class="parameter"><code><a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a> *font_face</code></em>,
|
696
|
+
<em class="parameter"><code><a class="link" href="cairo-User-Fonts.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> unicode_to_glyph_func</code></em>);</pre>
|
697
|
+
<p>Sets the unicode-to-glyph conversion function of a user-font.
|
698
|
+
See <a class="link" href="cairo-User-Fonts.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
|
699
|
+
works.</p>
|
700
|
+
<p>The font-face should not be immutable or a <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-USER-FONT-IMMUTABLE:CAPS"><code class="literal">CAIRO_STATUS_USER_FONT_IMMUTABLE</code></a>
|
572
701
|
error will occur. A user font-face is immutable as soon as a scaled-font
|
573
|
-
is created from it
|
574
|
-
|
575
|
-
<
|
576
|
-
<
|
702
|
+
is created from it.</p>
|
703
|
+
<div class="refsect3">
|
704
|
+
<a name="id-1.4.8.7.11.6"></a><h4>Parameters</h4>
|
705
|
+
<div class="informaltable"><table width="100%" border="0">
|
706
|
+
<colgroup>
|
707
|
+
<col width="150px" class="parameters_name">
|
708
|
+
<col class="parameters_description">
|
709
|
+
<col width="200px" class="parameters_annotations">
|
710
|
+
</colgroup>
|
577
711
|
<tbody>
|
578
712
|
<tr>
|
579
|
-
<td
|
580
|
-
<td>A user font face</td>
|
713
|
+
<td class="parameter_name"><p>font_face</p></td>
|
714
|
+
<td class="parameter_description"><p>A user font face</p></td>
|
715
|
+
<td class="parameter_annotations"> </td>
|
581
716
|
</tr>
|
582
717
|
<tr>
|
583
|
-
<td
|
584
|
-
<td>The unicode_to_glyph callback, or <
|
585
|
-
</td>
|
718
|
+
<td class="parameter_name"><p>unicode_to_glyph_func</p></td>
|
719
|
+
<td class="parameter_description"><p>The unicode_to_glyph callback, or <code class="literal">NULL</code></p></td>
|
720
|
+
<td class="parameter_annotations"> </td>
|
586
721
|
</tr>
|
587
722
|
</tbody>
|
588
723
|
</table></div>
|
724
|
+
</div>
|
589
725
|
<p class="since">Since 1.8</p>
|
590
726
|
</div>
|
591
727
|
<hr>
|
592
728
|
<div class="refsect2">
|
593
|
-
<a name="cairo-user-font-face-get-unicode-to-glyph-func"></a><h3>cairo_user_font_face_get_unicode_to_glyph_func
|
594
|
-
<pre class="programlisting"><a class="link" href="cairo-User-Fonts.html#cairo-user-scaled-font-unicode-to-glyph-func-t" title="cairo_user_scaled_font_unicode_to_glyph_func_t
|
595
|
-
|
596
|
-
<
|
597
|
-
Gets the unicode-to-glyph conversion function of a user-font
|
598
|
-
|
599
|
-
<
|
600
|
-
<
|
601
|
-
<
|
602
|
-
<
|
603
|
-
<
|
604
|
-
<
|
605
|
-
</
|
606
|
-
<tr>
|
607
|
-
<td
|
608
|
-
<td
|
609
|
-
|
610
|
-
</tr>
|
611
|
-
</tbody>
|
729
|
+
<a name="cairo-user-font-face-get-unicode-to-glyph-func"></a><h3>cairo_user_font_face_get_unicode_to_glyph_func ()</h3>
|
730
|
+
<pre class="programlisting"><a class="link" href="cairo-User-Fonts.html#cairo-user-scaled-font-unicode-to-glyph-func-t" title="cairo_user_scaled_font_unicode_to_glyph_func_t ()"><span class="returnvalue">cairo_user_scaled_font_unicode_to_glyph_func_t</span></a>
|
731
|
+
cairo_user_font_face_get_unicode_to_glyph_func
|
732
|
+
(<em class="parameter"><code><a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a> *font_face</code></em>);</pre>
|
733
|
+
<p>Gets the unicode-to-glyph conversion function of a user-font.</p>
|
734
|
+
<div class="refsect3">
|
735
|
+
<a name="id-1.4.8.7.12.5"></a><h4>Parameters</h4>
|
736
|
+
<div class="informaltable"><table width="100%" border="0">
|
737
|
+
<colgroup>
|
738
|
+
<col width="150px" class="parameters_name">
|
739
|
+
<col class="parameters_description">
|
740
|
+
<col width="200px" class="parameters_annotations">
|
741
|
+
</colgroup>
|
742
|
+
<tbody><tr>
|
743
|
+
<td class="parameter_name"><p>font_face</p></td>
|
744
|
+
<td class="parameter_description"><p>A user font face</p></td>
|
745
|
+
<td class="parameter_annotations"> </td>
|
746
|
+
</tr></tbody>
|
612
747
|
</table></div>
|
748
|
+
</div>
|
749
|
+
<div class="refsect3">
|
750
|
+
<a name="id-1.4.8.7.12.6"></a><h4>Returns</h4>
|
751
|
+
<p> The unicode_to_glyph callback of <em class="parameter"><code>font_face</code></em>
|
752
|
+
or <code class="literal">NULL</code> if none set or an error occurred.</p>
|
753
|
+
<p></p>
|
754
|
+
</div>
|
613
755
|
<p class="since">Since 1.8</p>
|
614
756
|
</div>
|
615
757
|
<hr>
|
616
758
|
<div class="refsect2">
|
617
|
-
<a name="cairo-user-font-face-set-text-to-glyphs-func"></a><h3>cairo_user_font_face_set_text_to_glyphs_func
|
618
|
-
<pre class="programlisting"><span class="returnvalue">void</span>
|
619
|
-
|
620
|
-
|
621
|
-
<
|
622
|
-
Sets th text-to-glyphs conversion function of a user-font.
|
623
|
-
See <a class="link" href="cairo-User-Fonts.html#cairo-user-scaled-font-text-to-glyphs-func-t" title="cairo_user_scaled_font_text_to_glyphs_func_t
|
624
|
-
works
|
625
|
-
|
626
|
-
<p>
|
627
|
-
The font-face should not be immutable or a <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-USER-FONT-IMMUTABLE:CAPS"><code class="literal">CAIRO_STATUS_USER_FONT_IMMUTABLE</code></a>
|
759
|
+
<a name="cairo-user-font-face-set-text-to-glyphs-func"></a><h3>cairo_user_font_face_set_text_to_glyphs_func ()</h3>
|
760
|
+
<pre class="programlisting"><span class="returnvalue">void</span>
|
761
|
+
cairo_user_font_face_set_text_to_glyphs_func
|
762
|
+
(<em class="parameter"><code><a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a> *font_face</code></em>,
|
763
|
+
<em class="parameter"><code><a class="link" href="cairo-User-Fonts.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> text_to_glyphs_func</code></em>);</pre>
|
764
|
+
<p>Sets th text-to-glyphs conversion function of a user-font.
|
765
|
+
See <a class="link" href="cairo-User-Fonts.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
|
766
|
+
works.</p>
|
767
|
+
<p>The font-face should not be immutable or a <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-USER-FONT-IMMUTABLE:CAPS"><code class="literal">CAIRO_STATUS_USER_FONT_IMMUTABLE</code></a>
|
628
768
|
error will occur. A user font-face is immutable as soon as a scaled-font
|
629
|
-
is created from it
|
630
|
-
|
631
|
-
<
|
632
|
-
<
|
769
|
+
is created from it.</p>
|
770
|
+
<div class="refsect3">
|
771
|
+
<a name="id-1.4.8.7.13.6"></a><h4>Parameters</h4>
|
772
|
+
<div class="informaltable"><table width="100%" border="0">
|
773
|
+
<colgroup>
|
774
|
+
<col width="150px" class="parameters_name">
|
775
|
+
<col class="parameters_description">
|
776
|
+
<col width="200px" class="parameters_annotations">
|
777
|
+
</colgroup>
|
633
778
|
<tbody>
|
634
779
|
<tr>
|
635
|
-
<td
|
636
|
-
<td>A user font face</td>
|
780
|
+
<td class="parameter_name"><p>font_face</p></td>
|
781
|
+
<td class="parameter_description"><p>A user font face</p></td>
|
782
|
+
<td class="parameter_annotations"> </td>
|
637
783
|
</tr>
|
638
784
|
<tr>
|
639
|
-
<td
|
640
|
-
<td>The text_to_glyphs callback, or <
|
641
|
-
</td>
|
785
|
+
<td class="parameter_name"><p>text_to_glyphs_func</p></td>
|
786
|
+
<td class="parameter_description"><p>The text_to_glyphs callback, or <code class="literal">NULL</code></p></td>
|
787
|
+
<td class="parameter_annotations"> </td>
|
642
788
|
</tr>
|
643
789
|
</tbody>
|
644
790
|
</table></div>
|
791
|
+
</div>
|
645
792
|
<p class="since">Since 1.8</p>
|
646
793
|
</div>
|
647
794
|
<hr>
|
648
795
|
<div class="refsect2">
|
649
|
-
<a name="cairo-user-font-face-get-text-to-glyphs-func"></a><h3>cairo_user_font_face_get_text_to_glyphs_func
|
650
|
-
<pre class="programlisting"><a class="link" href="cairo-User-Fonts.html#cairo-user-scaled-font-text-to-glyphs-func-t" title="cairo_user_scaled_font_text_to_glyphs_func_t
|
651
|
-
|
652
|
-
<
|
653
|
-
Gets the text-to-glyphs conversion function of a user-font
|
654
|
-
|
655
|
-
<
|
656
|
-
<
|
657
|
-
<
|
658
|
-
<
|
659
|
-
<
|
660
|
-
<
|
661
|
-
</
|
662
|
-
<tr>
|
663
|
-
<td
|
664
|
-
<td
|
665
|
-
|
666
|
-
</tr>
|
667
|
-
</tbody>
|
796
|
+
<a name="cairo-user-font-face-get-text-to-glyphs-func"></a><h3>cairo_user_font_face_get_text_to_glyphs_func ()</h3>
|
797
|
+
<pre class="programlisting"><a class="link" href="cairo-User-Fonts.html#cairo-user-scaled-font-text-to-glyphs-func-t" title="cairo_user_scaled_font_text_to_glyphs_func_t ()"><span class="returnvalue">cairo_user_scaled_font_text_to_glyphs_func_t</span></a>
|
798
|
+
cairo_user_font_face_get_text_to_glyphs_func
|
799
|
+
(<em class="parameter"><code><a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a> *font_face</code></em>);</pre>
|
800
|
+
<p>Gets the text-to-glyphs conversion function of a user-font.</p>
|
801
|
+
<div class="refsect3">
|
802
|
+
<a name="id-1.4.8.7.14.5"></a><h4>Parameters</h4>
|
803
|
+
<div class="informaltable"><table width="100%" border="0">
|
804
|
+
<colgroup>
|
805
|
+
<col width="150px" class="parameters_name">
|
806
|
+
<col class="parameters_description">
|
807
|
+
<col width="200px" class="parameters_annotations">
|
808
|
+
</colgroup>
|
809
|
+
<tbody><tr>
|
810
|
+
<td class="parameter_name"><p>font_face</p></td>
|
811
|
+
<td class="parameter_description"><p>A user font face</p></td>
|
812
|
+
<td class="parameter_annotations"> </td>
|
813
|
+
</tr></tbody>
|
668
814
|
</table></div>
|
815
|
+
</div>
|
816
|
+
<div class="refsect3">
|
817
|
+
<a name="id-1.4.8.7.14.6"></a><h4>Returns</h4>
|
818
|
+
<p> The text_to_glyphs callback of <em class="parameter"><code>font_face</code></em>
|
819
|
+
or <code class="literal">NULL</code> if none set or an error occurred.</p>
|
820
|
+
<p></p>
|
821
|
+
</div>
|
822
|
+
<p class="since">Since 1.8</p>
|
823
|
+
</div>
|
824
|
+
</div>
|
825
|
+
<div class="refsect1">
|
826
|
+
<a name="cairo-User-Fonts.other_details"></a><h2>Types and Values</h2>
|
827
|
+
<div class="refsect2">
|
828
|
+
<a name="CAIRO-HAS-USER-FONT:CAPS"></a><h3>CAIRO_HAS_USER_FONT</h3>
|
829
|
+
<pre class="programlisting">#define CAIRO_HAS_USER_FONT 1
|
830
|
+
</pre>
|
831
|
+
<p>Defined if the user font backend is available.
|
832
|
+
This macro can be used to conditionally compile backend-specific code.
|
833
|
+
The user font backend is always built in versions of cairo that support
|
834
|
+
this feature (1.8 and later).</p>
|
669
835
|
<p class="since">Since 1.8</p>
|
670
836
|
</div>
|
671
837
|
</div>
|
672
838
|
</div>
|
673
839
|
<div class="footer">
|
674
840
|
<hr>
|
675
|
-
Generated by GTK-Doc V1.
|
841
|
+
Generated by GTK-Doc V1.20</div>
|
676
842
|
</body>
|
677
843
|
</html>
|