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.

Files changed (215) hide show
  1. checksums.yaml +4 -4
  2. data/NEWS +21 -0
  3. data/Rakefile +17 -6
  4. data/ext/cairo/cairo.def +1 -0
  5. data/ext/cairo/extconf.rb +23 -10
  6. data/ext/cairo/rb_cairo.c +3 -0
  7. data/ext/cairo/rb_cairo.h +3 -3
  8. data/ext/cairo/rb_cairo_context.c +1 -1
  9. data/ext/cairo/rb_cairo_io.c +4 -0
  10. data/ext/cairo/rb_cairo_io.h +2 -0
  11. data/ext/cairo/rb_cairo_pattern.c +4 -4
  12. data/ext/cairo/rb_cairo_private.h +2 -0
  13. data/ext/cairo/rb_cairo_surface.c +64 -232
  14. data/lib/2.0/cairo.so +0 -0
  15. data/lib/2.1/cairo.so +0 -0
  16. data/lib/2.2/cairo.so +0 -0
  17. data/lib/cairo.rb +20 -19
  18. data/lib/cairo/region.rb +14 -0
  19. data/test/test_region.rb +26 -0
  20. data/vendor/local/bin/fc-cache.exe +0 -0
  21. data/vendor/local/bin/fc-cat.exe +0 -0
  22. data/vendor/local/bin/fc-list.exe +0 -0
  23. data/vendor/local/bin/fc-match.exe +0 -0
  24. data/vendor/local/bin/fc-pattern.exe +0 -0
  25. data/vendor/local/bin/fc-query.exe +0 -0
  26. data/vendor/local/bin/fc-scan.exe +0 -0
  27. data/vendor/local/bin/fc-validate.exe +0 -0
  28. data/vendor/local/bin/freetype-config +2 -2
  29. data/vendor/local/bin/libcairo-2.dll +0 -0
  30. data/vendor/local/bin/libcairo-gobject-2.dll +0 -0
  31. data/vendor/local/bin/libcairo-script-interpreter-2.dll +0 -0
  32. data/vendor/local/bin/libfontconfig-1.dll +0 -0
  33. data/vendor/local/bin/libfreetype-6.dll +0 -0
  34. data/vendor/local/bin/libgcc_s_seh-1.dll +0 -0
  35. data/vendor/local/bin/libpixman-1-0.dll +0 -0
  36. data/vendor/local/bin/libpng-config +1 -1
  37. data/vendor/local/bin/libpng16-16.dll +0 -0
  38. data/vendor/local/bin/libpng16-config +1 -1
  39. data/vendor/local/bin/libstdc++-6.dll +0 -0
  40. data/vendor/local/bin/libwinpthread-1.dll +0 -0
  41. data/vendor/local/bin/libxml2-2.dll +0 -0
  42. data/vendor/local/bin/png-fix-itxt.exe +0 -0
  43. data/vendor/local/bin/pngfix.exe +0 -0
  44. data/vendor/local/bin/xmlcatalog.exe +0 -0
  45. data/vendor/local/bin/xmllint.exe +0 -0
  46. data/vendor/local/bin/zlib1.dll +0 -0
  47. data/vendor/local/include/cairo/cairo-version.h +1 -1
  48. data/vendor/local/include/freetype2/config/ftconfig.h +19 -2
  49. data/vendor/local/include/freetype2/config/ftheader.h +7 -5
  50. data/vendor/local/include/freetype2/config/ftoption.h +9 -22
  51. data/vendor/local/include/freetype2/config/ftstdlib.h +2 -3
  52. data/vendor/local/include/freetype2/freetype.h +38 -17
  53. data/vendor/local/include/freetype2/ft2build.h +1 -1
  54. data/vendor/local/include/freetype2/ftadvanc.h +2 -2
  55. data/vendor/local/include/freetype2/ftautoh.h +50 -2
  56. data/vendor/local/include/freetype2/ftbbox.h +1 -1
  57. data/vendor/local/include/freetype2/ftbdf.h +1 -1
  58. data/vendor/local/include/freetype2/ftbitmap.h +11 -3
  59. data/vendor/local/include/freetype2/ftbzip2.h +1 -1
  60. data/vendor/local/include/freetype2/ftcache.h +3 -3
  61. data/vendor/local/include/freetype2/ftcffdrv.h +1 -1
  62. data/vendor/local/include/freetype2/ftcid.h +2 -1
  63. data/vendor/local/include/freetype2/fterrdef.h +1 -1
  64. data/vendor/local/include/freetype2/fterrors.h +1 -1
  65. data/vendor/local/include/freetype2/{ftxf86.h → ftfntfmt.h} +22 -14
  66. data/vendor/local/include/freetype2/ftgasp.h +1 -1
  67. data/vendor/local/include/freetype2/ftglyph.h +1 -1
  68. data/vendor/local/include/freetype2/ftgxval.h +1 -1
  69. data/vendor/local/include/freetype2/ftgzip.h +1 -1
  70. data/vendor/local/include/freetype2/ftimage.h +7 -13
  71. data/vendor/local/include/freetype2/ftincrem.h +1 -1
  72. data/vendor/local/include/freetype2/ftlcdfil.h +2 -2
  73. data/vendor/local/include/freetype2/ftlist.h +1 -1
  74. data/vendor/local/include/freetype2/ftlzw.h +1 -1
  75. data/vendor/local/include/freetype2/ftmac.h +1 -1
  76. data/vendor/local/include/freetype2/ftmm.h +17 -11
  77. data/vendor/local/include/freetype2/ftmodapi.h +4 -2
  78. data/vendor/local/include/freetype2/ftmoderr.h +1 -1
  79. data/vendor/local/include/freetype2/ftotval.h +1 -1
  80. data/vendor/local/include/freetype2/ftoutln.h +1 -1
  81. data/vendor/local/include/freetype2/ftpfr.h +1 -1
  82. data/vendor/local/include/freetype2/ftrender.h +3 -8
  83. data/vendor/local/include/freetype2/ftsizes.h +1 -1
  84. data/vendor/local/include/freetype2/ftsnames.h +1 -1
  85. data/vendor/local/include/freetype2/ftstroke.h +1 -1
  86. data/vendor/local/include/freetype2/ftsynth.h +5 -3
  87. data/vendor/local/include/freetype2/ftsystem.h +10 -1
  88. data/vendor/local/include/freetype2/fttrigon.h +1 -1
  89. data/vendor/local/include/freetype2/ftttdrv.h +85 -22
  90. data/vendor/local/include/freetype2/fttypes.h +1 -1
  91. data/vendor/local/include/freetype2/ftwinfnt.h +3 -3
  92. data/vendor/local/include/freetype2/t1tables.h +4 -3
  93. data/vendor/local/include/freetype2/ttnameid.h +116 -116
  94. data/vendor/local/include/freetype2/tttables.h +2 -2
  95. data/vendor/local/include/freetype2/tttags.h +1 -1
  96. data/vendor/local/include/freetype2/ttunpat.h +1 -1
  97. data/vendor/local/include/libpng16/png.h +63 -80
  98. data/vendor/local/include/libpng16/pngconf.h +8 -30
  99. data/vendor/local/include/libpng16/pnglibconf.h +10 -4
  100. data/vendor/local/include/png.h +63 -80
  101. data/vendor/local/include/pngconf.h +8 -30
  102. data/vendor/local/include/pnglibconf.h +10 -4
  103. data/vendor/local/lib/libcairo-gobject.a +0 -0
  104. data/vendor/local/lib/libcairo-gobject.dll.a +0 -0
  105. data/vendor/local/lib/libcairo-gobject.la +2 -2
  106. data/vendor/local/lib/libcairo-script-interpreter.a +0 -0
  107. data/vendor/local/lib/libcairo-script-interpreter.dll.a +0 -0
  108. data/vendor/local/lib/libcairo-script-interpreter.la +2 -2
  109. data/vendor/local/lib/libcairo.a +0 -0
  110. data/vendor/local/lib/libcairo.dll.a +0 -0
  111. data/vendor/local/lib/libcairo.la +2 -2
  112. data/vendor/local/lib/libfontconfig.dll.a +0 -0
  113. data/vendor/local/lib/libfreetype.a +0 -0
  114. data/vendor/local/lib/libfreetype.dll.a +0 -0
  115. data/vendor/local/lib/libfreetype.la +4 -4
  116. data/vendor/local/lib/libpixman-1.a +0 -0
  117. data/vendor/local/lib/libpixman-1.dll.a +0 -0
  118. data/vendor/local/lib/libpng.a +0 -0
  119. data/vendor/local/lib/libpng.dll.a +0 -0
  120. data/vendor/local/lib/libpng.la +4 -4
  121. data/vendor/local/lib/libpng16.a +0 -0
  122. data/vendor/local/lib/libpng16.dll.a +0 -0
  123. data/vendor/local/lib/libpng16.la +4 -4
  124. data/vendor/local/lib/libxml2.a +0 -0
  125. data/vendor/local/lib/libxml2.dll.a +0 -0
  126. data/vendor/local/lib/libz.a +0 -0
  127. data/vendor/local/lib/libz.dll.a +0 -0
  128. data/vendor/local/lib/pkgconfig/cairo-fc.pc +1 -1
  129. data/vendor/local/lib/pkgconfig/cairo-ft.pc +1 -1
  130. data/vendor/local/lib/pkgconfig/cairo-gobject.pc +1 -1
  131. data/vendor/local/lib/pkgconfig/cairo-pdf.pc +1 -1
  132. data/vendor/local/lib/pkgconfig/cairo-png.pc +1 -1
  133. data/vendor/local/lib/pkgconfig/cairo-ps.pc +1 -1
  134. data/vendor/local/lib/pkgconfig/cairo-script.pc +1 -1
  135. data/vendor/local/lib/pkgconfig/cairo-svg.pc +1 -1
  136. data/vendor/local/lib/pkgconfig/cairo-win32-font.pc +1 -1
  137. data/vendor/local/lib/pkgconfig/cairo-win32.pc +1 -1
  138. data/vendor/local/lib/pkgconfig/cairo.pc +1 -1
  139. data/vendor/local/lib/pkgconfig/freetype2.pc +1 -1
  140. data/vendor/local/lib/pkgconfig/libpng.pc +1 -1
  141. data/vendor/local/lib/pkgconfig/libpng16.pc +1 -1
  142. data/vendor/local/share/aclocal/freetype2.m4 +1 -1
  143. data/vendor/local/share/gtk-doc/html/cairo/bindings-errors.html +12 -12
  144. data/vendor/local/share/gtk-doc/html/cairo/bindings-fonts.html +12 -12
  145. data/vendor/local/share/gtk-doc/html/cairo/bindings-memory.html +12 -12
  146. data/vendor/local/share/gtk-doc/html/cairo/bindings-overloading.html +13 -13
  147. data/vendor/local/share/gtk-doc/html/cairo/bindings-path.html +12 -12
  148. data/vendor/local/share/gtk-doc/html/cairo/bindings-patterns.html +35 -35
  149. data/vendor/local/share/gtk-doc/html/cairo/bindings-return-values.html +10 -10
  150. data/vendor/local/share/gtk-doc/html/cairo/bindings-streams.html +11 -11
  151. data/vendor/local/share/gtk-doc/html/cairo/bindings-surfaces.html +13 -13
  152. data/vendor/local/share/gtk-doc/html/cairo/cairo-Error-handling.html +294 -225
  153. data/vendor/local/share/gtk-doc/html/cairo/cairo-FreeType-Fonts.html +387 -269
  154. data/vendor/local/share/gtk-doc/html/cairo/cairo-Image-Surfaces.html +432 -302
  155. data/vendor/local/share/gtk-doc/html/cairo/cairo-PDF-Surfaces.html +325 -217
  156. data/vendor/local/share/gtk-doc/html/cairo/cairo-PNG-Support.html +298 -193
  157. data/vendor/local/share/gtk-doc/html/cairo/cairo-Paths.html +1121 -812
  158. data/vendor/local/share/gtk-doc/html/cairo/cairo-PostScript-Surfaces.html +513 -383
  159. data/vendor/local/share/gtk-doc/html/cairo/cairo-Quartz-(CGFont)-Fonts.html +126 -83
  160. data/vendor/local/share/gtk-doc/html/cairo/cairo-Quartz-Surfaces.html +172 -119
  161. data/vendor/local/share/gtk-doc/html/cairo/cairo-Raster-Sources.html +581 -372
  162. data/vendor/local/share/gtk-doc/html/cairo/cairo-Recording-Surfaces.html +179 -130
  163. data/vendor/local/share/gtk-doc/html/cairo/cairo-Regions.html +888 -539
  164. data/vendor/local/share/gtk-doc/html/cairo/cairo-SVG-Surfaces.html +287 -192
  165. data/vendor/local/share/gtk-doc/html/cairo/cairo-Script-Surfaces.html +374 -231
  166. data/vendor/local/share/gtk-doc/html/cairo/cairo-Transformations.html +395 -219
  167. data/vendor/local/share/gtk-doc/html/cairo/cairo-Types.html +125 -75
  168. data/vendor/local/share/gtk-doc/html/cairo/cairo-User-Fonts.html +630 -464
  169. data/vendor/local/share/gtk-doc/html/cairo/cairo-Version-Information.html +225 -200
  170. data/vendor/local/share/gtk-doc/html/cairo/cairo-Win32-Fonts.html +336 -214
  171. data/vendor/local/share/gtk-doc/html/cairo/cairo-Win32-Surfaces.html +277 -186
  172. data/vendor/local/share/gtk-doc/html/cairo/cairo-XCB-Surfaces.html +495 -350
  173. data/vendor/local/share/gtk-doc/html/cairo/cairo-XLib-Surfaces.html +557 -362
  174. data/vendor/local/share/gtk-doc/html/cairo/cairo-XLib-XRender-Backend.html +158 -111
  175. data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-device-t.html +655 -441
  176. data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-font-face-t.html +389 -280
  177. data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-font-options-t.html +667 -451
  178. data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-matrix-t.html +579 -351
  179. data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-pattern-t.html +2006 -1545
  180. data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-scaled-font-t.html +892 -618
  181. data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-surface-t.html +1624 -1188
  182. data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-t.html +2903 -2104
  183. data/vendor/local/share/gtk-doc/html/cairo/cairo-drawing.html +13 -13
  184. data/vendor/local/share/gtk-doc/html/cairo/cairo-fonts.html +13 -13
  185. data/vendor/local/share/gtk-doc/html/cairo/cairo-support.html +13 -13
  186. data/vendor/local/share/gtk-doc/html/cairo/cairo-surfaces.html +13 -13
  187. data/vendor/local/share/gtk-doc/html/cairo/cairo-text.html +1115 -758
  188. data/vendor/local/share/gtk-doc/html/cairo/cairo.devhelp2 +419 -604
  189. data/vendor/local/share/gtk-doc/html/cairo/home.png +0 -0
  190. data/vendor/local/share/gtk-doc/html/cairo/index-1.10.html +56 -56
  191. data/vendor/local/share/gtk-doc/html/cairo/index-1.12.html +70 -70
  192. data/vendor/local/share/gtk-doc/html/cairo/index-1.2.html +58 -58
  193. data/vendor/local/share/gtk-doc/html/cairo/index-1.4.html +39 -39
  194. data/vendor/local/share/gtk-doc/html/cairo/index-1.6.html +30 -30
  195. data/vendor/local/share/gtk-doc/html/cairo/index-1.8.html +38 -38
  196. data/vendor/local/share/gtk-doc/html/cairo/index-all.html +426 -426
  197. data/vendor/local/share/gtk-doc/html/cairo/index.html +6 -6
  198. data/vendor/local/share/gtk-doc/html/cairo/index.sgml +234 -325
  199. data/vendor/local/share/gtk-doc/html/cairo/language-bindings.html +12 -12
  200. data/vendor/local/share/gtk-doc/html/cairo/left-insensitive.png +0 -0
  201. data/vendor/local/share/gtk-doc/html/cairo/left.png +0 -0
  202. data/vendor/local/share/gtk-doc/html/cairo/right-insensitive.png +0 -0
  203. data/vendor/local/share/gtk-doc/html/cairo/right.png +0 -0
  204. data/vendor/local/share/gtk-doc/html/cairo/style.css +221 -26
  205. data/vendor/local/share/gtk-doc/html/cairo/up-insensitive.png +0 -0
  206. data/vendor/local/share/gtk-doc/html/cairo/up.png +0 -0
  207. data/vendor/local/share/license/cairo/README +1 -1
  208. data/vendor/local/share/license/freetype/README +6 -6
  209. data/vendor/local/share/license/freetype/README.git +1 -1
  210. data/vendor/local/share/license/libpng/README +2 -2
  211. data/vendor/local/share/man/man1/freetype-config.1 +1 -1
  212. data/vendor/local/share/man/man3/libpng.3 +85 -92
  213. data/vendor/local/share/man/man3/libpngpf.3 +2 -2
  214. data/vendor/local/share/man/man5/png.5 +1 -1
  215. 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.76.1">
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.18 (XML mode)">
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="2">
16
- <tr valign="middle">
17
- <td><a accesskey="p" href="cairo-Version-Information.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
- <td><a accesskey="u" href="cairo-support.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19
- <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20
- <th width="100%" align="center">Cairo: A Vector Graphics Library</th>
21
- <td><a accesskey="n" href="index-all.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
22
- </tr>
23
- <tr><td colspan="5" class="shortcuts">
24
- <a href="#cairo-Types.synopsis" class="shortcut">Top</a>
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="refsynopsisdiv">
39
- <a name="cairo-Types.synopsis"></a><h2>Synopsis</h2>
40
- <pre class="synopsis">typedef <a class="link" href="cairo-Types.html#cairo-bool-t" title="cairo_bool_t">cairo_bool_t</a>;
41
- <a class="link" href="cairo-Types.html#cairo-user-data-key-t" title="cairo_user_data_key_t">cairo_user_data_key_t</a>;
42
- <span class="returnvalue">void</span> (<a class="link" href="cairo-Types.html#cairo-destroy-func-t" title="cairo_destroy_func_t ()">*cairo_destroy_func_t</a>) (<em class="parameter"><code><span class="type">void</span> *data</code></em>);
43
- <a class="link" href="cairo-Types.html#cairo-rectangle-int-t" title="cairo_rectangle_int_t">cairo_rectangle_int_t</a>;
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.details"></a><h2>Details</h2>
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
- </p>
89
- <div class="variablelist"><table border="0">
90
- <col align="left" valign="top">
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><p><span class="term"><span class="type">int</span> <em class="structfield"><code><a name="cairo-user-data-key-t.unused"></a>unused</code></em>;</span></p></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
- A data structure for holding a rectangle with integer coordinates.
126
- </p>
127
- <div class="variablelist"><table border="0">
128
- <col align="left" valign="top">
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><p><span class="term"><span class="type">int</span> <em class="structfield"><code><a name="cairo-rectangle-int-t.x"></a>x</code></em>;</span></p></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><p><span class="term"><span class="type">int</span> <em class="structfield"><code><a name="cairo-rectangle-int-t.y"></a>y</code></em>;</span></p></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><p><span class="term"><span class="type">int</span> <em class="structfield"><code><a name="cairo-rectangle-int-t.width"></a>width</code></em>;</span></p></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><p><span class="term"><span class="type">int</span> <em class="structfield"><code><a name="cairo-rectangle-int-t.height"></a>height</code></em>;</span></p></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.18</div>
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.76.1">
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.18 (XML mode)">
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="2">
16
- <tr valign="middle">
17
- <td><a accesskey="p" href="cairo-Quartz-(CGFont)-Fonts.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
- <td><a accesskey="u" href="cairo-fonts.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19
- <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20
- <th width="100%" align="center">Cairo: A Vector Graphics Library</th>
21
- <td><a accesskey="n" href="cairo-surfaces.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
22
- </tr>
23
- <tr><td colspan="5" class="shortcuts">
24
- <a href="#cairo-User-Fonts.synopsis" class="shortcut">Top</a>
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="refsynopsisdiv">
39
- <a name="cairo-User-Fonts.synopsis"></a><h2>Synopsis</h2>
40
- <pre class="synopsis">#define <a class="link" href="cairo-User-Fonts.html#CAIRO-HAS-USER-FONT:CAPS" title="CAIRO_HAS_USER_FONT">CAIRO_HAS_USER_FONT</a>
41
- <a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="returnvalue">cairo_status_t</span></a> (<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>)
42
- (<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>,
43
- <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>,
44
- <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>);
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> (<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>)
46
- (<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>,
47
- <em class="parameter"><code><span class="type">unsigned long </span> glyph</code></em>,
48
- <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>,
49
- <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>);
50
- <a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="returnvalue">cairo_status_t</span></a> (<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>)
51
- (<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>,
52
- <em class="parameter"><code>const <span class="type">char</span> *utf8</code></em>,
53
- <em class="parameter"><code><span class="type">int</span> utf8_len</code></em>,
54
- <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>,
55
- <em class="parameter"><code><span class="type">int</span> *num_glyphs</code></em>,
56
- <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>,
57
- <em class="parameter"><code><span class="type">int</span> *num_clusters</code></em>,
58
- <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>);
59
- <a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="returnvalue">cairo_status_t</span></a> (<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>)
60
- (<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>,
61
- <em class="parameter"><code><span class="type">unsigned long </span> unicode</code></em>,
62
- <em class="parameter"><code>unsigned <span class="type">long</span> *glyph_index</code></em>);
63
- <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> * <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> (<em class="parameter"><code><span class="type">void</span></code></em>);
64
- <span class="returnvalue">void</span> <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> (<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>,
65
- <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>);
66
- <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> <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>
67
- (<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>);
68
- <span class="returnvalue">void</span> <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>
69
- (<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>,
70
- <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>);
71
- <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> <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>
72
- (<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>);
73
- <span class="returnvalue">void</span> <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>
74
- (<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>,
75
- <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>);
76
- <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> <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>
77
- (<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>);
78
- <span class="returnvalue">void</span> <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>
79
- (<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>,
80
- <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>);
81
- <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> <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>
82
- (<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>);
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.details"></a><h2>Details</h2>
176
+ <a name="cairo-User-Fonts.functions_details"></a><h2>Functions</h2>
96
177
  <div class="refsect2">
97
- <a name="CAIRO-HAS-USER-FONT:CAPS"></a><h3>CAIRO_HAS_USER_FONT</h3>
98
- <pre class="programlisting">#define CAIRO_HAS_USER_FONT 1
99
- </pre>
100
- <p>
101
- Defined if the user font backend is available.
102
- This macro can be used to conditionally compile backend-specific code.
103
- The user font backend is always built in versions of cairo that support
104
- this feature (1.8 and later).
105
- </p>
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> is checked
124
- for any error status.
125
- </p>
126
- <p>
127
- The <em class="parameter"><code>extents</code></em> argument is where the user font sets the font extents for
128
- <em class="parameter"><code>scaled_font</code></em>. It is in font space, which means that for most cases its
129
- ascent and descent members should add to 1.0. <em class="parameter"><code>extents</code></em> is preset to
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
- </p>
133
- <p>
134
- The callback is optional. If not set, default font extents as described
135
- in the previous paragraph will be used.
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
- </p>
142
- <div class="variablelist"><table border="0">
143
- <col align="left" valign="top">
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><p><span class="term"><em class="parameter"><code>scaled_font</code></em> :</span></p></td>
147
- <td>the scaled-font being created</td>
148
- </tr>
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><p><span class="term"><em class="parameter"><code>extents</code></em> :</span></p></td>
155
- <td>font extents to fill in, in font space</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><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
159
- <td>
160
- <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.</td>
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 ()</h3>
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> (*cairo_user_scaled_font_render_glyph_func_t)
170
- (<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>,
171
- <em class="parameter"><code><span class="type">unsigned long </span> glyph</code></em>,
172
- <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>,
173
- <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>
174
- <p>
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 ()"><span class="type">cairo_user_scaled_font_render_glyph_func_t</span></a> is the type of function which
176
- is called when a user scaled-font needs to render a glyph.
177
- </p>
178
- <p>
179
- The callback is mandatory, and expected to draw the glyph with code <em class="parameter"><code>glyph</code></em> to
180
- the cairo context <em class="parameter"><code>cr</code></em>. <em class="parameter"><code>cr</code></em> is prepared such that the glyph drawing is done in
181
- font space. That is, the matrix set on <em class="parameter"><code>cr</code></em> is the scale matrix of <em class="parameter"><code>scaled_font</code></em>,
182
- The <em class="parameter"><code>extents</code></em> argument is where the user font sets the font extents for
183
- <em class="parameter"><code>scaled_font</code></em>. However, if user prefers to draw in user space, they can
184
- achieve that by changing the matrix on <em class="parameter"><code>cr</code></em>. All cairo rendering operations
185
- to <em class="parameter"><code>cr</code></em> are permitted, however, the result is undefined if any source other
186
- than the default source on <em class="parameter"><code>cr</code></em> is used. That means, glyph bitmaps should
187
- 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>.
188
- </p>
189
- <p>
190
- Other non-default settings on <em class="parameter"><code>cr</code></em> include a font size of 1.0 (given that
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
- </p>
194
- <p>
195
- The <em class="parameter"><code>extents</code></em> argument is preset to have <code class="literal">x_bearing</code>,
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>. This is in most cases exactly what the
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> in the callback.
208
- </p>
209
- <div class="variablelist"><table border="0">
210
- <col align="left" valign="top">
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><p><span class="term"><em class="parameter"><code>scaled_font</code></em> :</span></p></td>
214
- <td>user scaled-font</td>
215
- </tr>
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><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
222
- <td>cairo context to draw to, in font space</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><p><span class="term"><em class="parameter"><code>extents</code></em> :</span></p></td>
226
- <td>glyph extents to fill in, in font space</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><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
230
- <td>
231
- <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-SUCCESS:CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> upon success, or
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 ()</h3>
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> (*cairo_user_scaled_font_text_to_glyphs_func_t)
242
- (<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>,
243
- <em class="parameter"><code>const <span class="type">char</span> *utf8</code></em>,
244
- <em class="parameter"><code><span class="type">int</span> utf8_len</code></em>,
245
- <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>,
246
- <em class="parameter"><code><span class="type">int</span> *num_glyphs</code></em>,
247
- <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>,
248
- <em class="parameter"><code><span class="type">int</span> *num_clusters</code></em>,
249
- <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>
250
- <p>
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 ()"><span class="type">cairo_user_scaled_font_text_to_glyphs_func_t</span></a> is the type of function which
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 ()"><code class="function">cairo_show_text()</code></a> operation.
254
- </p>
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
- </p>
261
- <p>
262
- The <em class="parameter"><code>num_glyphs</code></em> argument is preset to the number of glyph entries available
263
- in the <em class="parameter"><code>glyphs</code></em> buffer. If the <em class="parameter"><code>glyphs</code></em> buffer is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the value of
264
- <em class="parameter"><code>num_glyphs</code></em> will be zero. If the provided glyph array is too short for
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 ()"><code class="function">cairo_glyph_allocate()</code></a> and placed in <em class="parameter"><code>glyphs</code></em>. Upon return,
267
- <em class="parameter"><code>num_glyphs</code></em> should contain the number of generated glyphs. If the value
268
- <em class="parameter"><code>glyphs</code></em> points at has changed after the call, the caller will free the
269
- 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
270
- the original value of <em class="parameter"><code>glyphs</code></em>, so the callback shouldn't do so.
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
- </p>
274
- <p>
275
- If <em class="parameter"><code>clusters</code></em> is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, <em class="parameter"><code>num_clusters</code></em> and <em class="parameter"><code>cluster_flags</code></em> are also
276
- non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, and cluster mapping should be computed. The semantics of how
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> initially points to a non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> value, that array may be used
279
- as a cluster buffer, and <em class="parameter"><code>num_clusters</code></em> points to the number of cluster
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 ()"><code class="function">cairo_text_cluster_allocate()</code></a> and placed in <em class="parameter"><code>clusters</code></em>. In this case,
283
- the original value of <em class="parameter"><code>clusters</code></em> will still be freed by the caller. Upon
284
- return, <em class="parameter"><code>num_clusters</code></em> should contain the number of generated clusters.
285
- If the value <em class="parameter"><code>clusters</code></em> points at has changed after the call, the caller
286
- 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>.
287
- </p>
288
- <p>
289
- The callback is optional. If <em class="parameter"><code>num_glyphs</code></em> is negative upon
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 ()"><span class="type">cairo_user_scaled_font_unicode_to_glyph_func_t</span></a>.
293
- </p>
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
- </p>
303
- <div class="variablelist"><table border="0">
304
- <col align="left" valign="top">
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><p><span class="term"><em class="parameter"><code>scaled_font</code></em> :</span></p></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><p><span class="term"><em class="parameter"><code>utf8</code></em> :</span></p></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><p><span class="term"><em class="parameter"><code>utf8_len</code></em> :</span></p></td>
316
- <td>length of <em class="parameter"><code>utf8</code></em> in bytes</td>
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><p><span class="term"><em class="parameter"><code>glyphs</code></em> :</span></p></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><p><span class="term"><em class="parameter"><code>num_glyphs</code></em> :</span></p></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><p><span class="term"><em class="parameter"><code>clusters</code></em> :</span></p></td>
328
- <td>pointer to array of cluster mapping information to fill, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
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><p><span class="term"><em class="parameter"><code>num_clusters</code></em> :</span></p></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><p><span class="term"><em class="parameter"><code>cluster_flags</code></em> :</span></p></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
- </tr>
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 ()</h3>
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> (*cairo_user_scaled_font_unicode_to_glyph_func_t)
356
- (<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>,
357
- <em class="parameter"><code><span class="type">unsigned long </span> unicode</code></em>,
358
- <em class="parameter"><code>unsigned <span class="type">long</span> *glyph_index</code></em>);</pre>
359
- <p>
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 ()"><span class="type">cairo_user_scaled_font_unicode_to_glyph_func_t</span></a> is the type of function which
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 ()"><code class="function">cairo_show_text()</code></a> operation.
363
- </p>
364
- <p>
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
- </p>
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
- </p>
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
- </p>
389
- <div class="variablelist"><table border="0">
390
- <col align="left" valign="top">
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><p><span class="term"><em class="parameter"><code>scaled_font</code></em> :</span></p></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><p><span class="term"><em class="parameter"><code>unicode</code></em> :</span></p></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><p><span class="term"><em class="parameter"><code>glyph_index</code></em> :</span></p></td>
402
- <td>output glyph index</td>
403
- </tr>
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 ()</h3>
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> * cairo_user_font_face_create (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
419
- <p>
420
- Creates a new user font-face.
421
- </p>
422
- <p>
423
- Use the setter functions to associate callbacks with the returned
424
- user font. The only mandatory callback is render_glyph.
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 ()"><code class="function">cairo_scaled_font_get_font_face()</code></a> followed by
431
- <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>.
432
- </p>
433
- <div class="variablelist"><table border="0">
434
- <col align="left" valign="top">
435
- <tbody><tr>
436
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
437
- <td>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
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 ()</h3>
446
- <pre class="programlisting"><span class="returnvalue">void</span> 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>,
447
- <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>
448
- <p>
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 ()"><span class="type">cairo_user_scaled_font_init_func_t</span></a> for details of how the callback
451
- works.
452
- </p>
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
- </p>
458
- <div class="variablelist"><table border="0">
459
- <col align="left" valign="top">
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><p><span class="term"><em class="parameter"><code>font_face</code></em> :</span></p></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><p><span class="term"><em class="parameter"><code>init_func</code></em> :</span></p></td>
467
- <td>The init callback, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
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 ()</h3>
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 ()"><span class="returnvalue">cairo_user_scaled_font_init_func_t</span></a> cairo_user_font_face_get_init_func
478
- (<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>
479
- <p>
480
- Gets the scaled-font initialization function of a user-font.
481
- </p>
482
- <div class="variablelist"><table border="0">
483
- <col align="left" valign="top">
484
- <tbody>
485
- <tr>
486
- <td><p><span class="term"><em class="parameter"><code>font_face</code></em> :</span></p></td>
487
- <td>A user font face</td>
488
- </tr>
489
- <tr>
490
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
491
- <td>The init callback of <em class="parameter"><code>font_face</code></em>
492
- or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if none set or an error has occurred.</td>
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 ()</h3>
501
- <pre class="programlisting"><span class="returnvalue">void</span> cairo_user_font_face_set_render_glyph_func
502
- (<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>,
503
- <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>
504
- <p>
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 ()"><span class="type">cairo_user_scaled_font_render_glyph_func_t</span></a> for details of how the callback
507
- works.
508
- </p>
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
- </p>
514
- <p>
515
- The render_glyph callback is the only mandatory callback of a user-font.
516
- If the callback is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> and a glyph is tried to be rendered using
517
- <em class="parameter"><code>font_face</code></em>, 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.
518
- </p>
519
- <div class="variablelist"><table border="0">
520
- <col align="left" valign="top">
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><p><span class="term"><em class="parameter"><code>font_face</code></em> :</span></p></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><p><span class="term"><em class="parameter"><code>render_glyph_func</code></em> :</span></p></td>
528
- <td>The render_glyph callback, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
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 ()</h3>
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 ()"><span class="returnvalue">cairo_user_scaled_font_render_glyph_func_t</span></a> cairo_user_font_face_get_render_glyph_func
539
- (<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>
540
- <p>
541
- Gets the glyph rendering function of a user-font.
542
- </p>
543
- <div class="variablelist"><table border="0">
544
- <col align="left" valign="top">
545
- <tbody>
546
- <tr>
547
- <td><p><span class="term"><em class="parameter"><code>font_face</code></em> :</span></p></td>
548
- <td>A user font face</td>
549
- </tr>
550
- <tr>
551
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
552
- <td>The render_glyph callback of <em class="parameter"><code>font_face</code></em>
553
- or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if none set or an error has occurred.</td>
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 ()</h3>
562
- <pre class="programlisting"><span class="returnvalue">void</span> cairo_user_font_face_set_unicode_to_glyph_func
563
- (<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>,
564
- <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>
565
- <p>
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 ()"><span class="type">cairo_user_scaled_font_unicode_to_glyph_func_t</span></a> for details of how the callback
568
- works.
569
- </p>
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
- </p>
575
- <div class="variablelist"><table border="0">
576
- <col align="left" valign="top">
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><p><span class="term"><em class="parameter"><code>font_face</code></em> :</span></p></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><p><span class="term"><em class="parameter"><code>unicode_to_glyph_func</code></em> :</span></p></td>
584
- <td>The unicode_to_glyph callback, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
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 ()</h3>
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 ()"><span class="returnvalue">cairo_user_scaled_font_unicode_to_glyph_func_t</span></a> cairo_user_font_face_get_unicode_to_glyph_func
595
- (<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>
596
- <p>
597
- Gets the unicode-to-glyph conversion function of a user-font.
598
- </p>
599
- <div class="variablelist"><table border="0">
600
- <col align="left" valign="top">
601
- <tbody>
602
- <tr>
603
- <td><p><span class="term"><em class="parameter"><code>font_face</code></em> :</span></p></td>
604
- <td>A user font face</td>
605
- </tr>
606
- <tr>
607
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
608
- <td>The unicode_to_glyph callback of <em class="parameter"><code>font_face</code></em>
609
- or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if none set or an error occurred.</td>
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 ()</h3>
618
- <pre class="programlisting"><span class="returnvalue">void</span> cairo_user_font_face_set_text_to_glyphs_func
619
- (<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>,
620
- <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>
621
- <p>
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 ()"><span class="type">cairo_user_scaled_font_text_to_glyphs_func_t</span></a> for details of how the callback
624
- works.
625
- </p>
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
- </p>
631
- <div class="variablelist"><table border="0">
632
- <col align="left" valign="top">
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><p><span class="term"><em class="parameter"><code>font_face</code></em> :</span></p></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><p><span class="term"><em class="parameter"><code>text_to_glyphs_func</code></em> :</span></p></td>
640
- <td>The text_to_glyphs callback, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
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 ()</h3>
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 ()"><span class="returnvalue">cairo_user_scaled_font_text_to_glyphs_func_t</span></a> cairo_user_font_face_get_text_to_glyphs_func
651
- (<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>
652
- <p>
653
- Gets the text-to-glyphs conversion function of a user-font.
654
- </p>
655
- <div class="variablelist"><table border="0">
656
- <col align="left" valign="top">
657
- <tbody>
658
- <tr>
659
- <td><p><span class="term"><em class="parameter"><code>font_face</code></em> :</span></p></td>
660
- <td>A user font face</td>
661
- </tr>
662
- <tr>
663
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
664
- <td>The text_to_glyphs callback of <em class="parameter"><code>font_face</code></em>
665
- or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if none set or an error occurred.</td>
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.18</div>
841
+ Generated by GTK-Doc V1.20</div>
676
842
  </body>
677
843
  </html>