cairo 1.14.1-x86-mingw32 → 1.14.2-x86-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 +18 -7
  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_sjlj-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
data/vendor/local/share/gtk-doc/html/cairo/cairo-FreeType-Fonts.html CHANGED
@@ -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>FreeType Fonts</title>
6
- <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
5
+ <title>Cairo: A Vector Graphics Library: FreeType 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-cairo-font-options-t.html" title="cairo_font_options_t">
10
10
  <link rel="next" href="cairo-Win32-Fonts.html" title="Win32 Fonts">
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-cairo-font-options-t.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-Win32-Fonts.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-FreeType-Fonts.synopsis" class="shortcut">Top</a>
25
-  | 
26
- <a href="#cairo-FreeType-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-FreeType-Fonts.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span> 
19
+ <a href="#cairo-FreeType-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-cairo-font-options-t.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
24
+ <td><a accesskey="n" href="cairo-Win32-Fonts.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-FreeType-Fonts"></a><div class="titlepage"></div>
31
28
  <div class="refnamediv"><table width="100%"><tr>
@@ -33,84 +30,134 @@
33
30
  <h2><span class="refentrytitle"><a name="cairo-FreeType-Fonts.top_of_page"></a>FreeType Fonts</span></h2>
34
31
  <p>FreeType Fonts — Font support for FreeType</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-FreeType-Fonts.synopsis"></a><h2>Synopsis</h2>
40
- <pre class="synopsis">#define <a class="link" href="cairo-FreeType-Fonts.html#CAIRO-HAS-FT-FONT:CAPS" title="CAIRO_HAS_FT_FONT">CAIRO_HAS_FT_FONT</a>
41
- #define <a class="link" href="cairo-FreeType-Fonts.html#CAIRO-HAS-FC-FONT:CAPS" title="CAIRO_HAS_FC_FONT">CAIRO_HAS_FC_FONT</a>
42
- <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-FreeType-Fonts.html#cairo-ft-font-face-create-for-ft-face" title="cairo_ft_font_face_create_for_ft_face ()">cairo_ft_font_face_create_for_ft_face</a>
43
- (<em class="parameter"><code><span class="type">FT_Face</span> face</code></em>,
44
- <em class="parameter"><code><span class="type">int</span> load_flags</code></em>);
45
- <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-FreeType-Fonts.html#cairo-ft-font-face-create-for-pattern" title="cairo_ft_font_face_create_for_pattern ()">cairo_ft_font_face_create_for_pattern</a>
46
- (<em class="parameter"><code><span class="type">FcPattern</span> *pattern</code></em>);
47
- <span class="returnvalue">void</span> <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-options-substitute" title="cairo_ft_font_options_substitute ()">cairo_ft_font_options_substitute</a> (<em class="parameter"><code>const <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> *options</code></em>,
48
- <em class="parameter"><code><span class="type">FcPattern</span> *pattern</code></em>);
49
- <span class="returnvalue">FT_Face</span> <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-scaled-font-lock-face" title="cairo_ft_scaled_font_lock_face ()">cairo_ft_scaled_font_lock_face</a> (<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>);
50
- <span class="returnvalue">void</span> <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-scaled-font-unlock-face" title="cairo_ft_scaled_font_unlock_face ()">cairo_ft_scaled_font_unlock_face</a> (<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>);
51
- enum <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-synthesize-t" title="enum cairo_ft_synthesize_t">cairo_ft_synthesize_t</a>;
52
- unsigned <span class="returnvalue">int</span> <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-get-synthesize" title="cairo_ft_font_face_get_synthesize ()">cairo_ft_font_face_get_synthesize</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>);
53
- <span class="returnvalue">void</span> <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-set-synthesize" title="cairo_ft_font_face_set_synthesize ()">cairo_ft_font_face_set_synthesize</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>,
54
- <em class="parameter"><code>unsigned <span class="type">int</span> synth_flags</code></em>);
55
- <span class="returnvalue">void</span> <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-unset-synthesize" title="cairo_ft_font_face_unset_synthesize ()">cairo_ft_font_face_unset_synthesize</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>,
56
- <em class="parameter"><code>unsigned <span class="type">int</span> synth_flags</code></em>);
57
- </pre>
35
+ <div class="refsect1">
36
+ <a name="cairo-FreeType-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-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="returnvalue">cairo_font_face_t</span></a> *
46
+ </td>
47
+ <td class="function_name">
48
+ <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-create-for-ft-face" title="cairo_ft_font_face_create_for_ft_face ()">cairo_ft_font_face_create_for_ft_face</a> <span class="c_punctuation">()</span>
49
+ </td>
50
+ </tr>
51
+ <tr>
52
+ <td class="function_type">
53
+ <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> *
54
+ </td>
55
+ <td class="function_name">
56
+ <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-create-for-pattern" title="cairo_ft_font_face_create_for_pattern ()">cairo_ft_font_face_create_for_pattern</a> <span class="c_punctuation">()</span>
57
+ </td>
58
+ </tr>
59
+ <tr>
60
+ <td class="function_type">
61
+ <span class="returnvalue">void</span>
62
+ </td>
63
+ <td class="function_name">
64
+ <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-options-substitute" title="cairo_ft_font_options_substitute ()">cairo_ft_font_options_substitute</a> <span class="c_punctuation">()</span>
65
+ </td>
66
+ </tr>
67
+ <tr>
68
+ <td class="function_type">
69
+ <span class="returnvalue">FT_Face</span>
70
+ </td>
71
+ <td class="function_name">
72
+ <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-scaled-font-lock-face" title="cairo_ft_scaled_font_lock_face ()">cairo_ft_scaled_font_lock_face</a> <span class="c_punctuation">()</span>
73
+ </td>
74
+ </tr>
75
+ <tr>
76
+ <td class="function_type">
77
+ <span class="returnvalue">void</span>
78
+ </td>
79
+ <td class="function_name">
80
+ <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-scaled-font-unlock-face" title="cairo_ft_scaled_font_unlock_face ()">cairo_ft_scaled_font_unlock_face</a> <span class="c_punctuation">()</span>
81
+ </td>
82
+ </tr>
83
+ <tr>
84
+ <td class="function_type">unsigned <span class="returnvalue">int</span>
85
+ </td>
86
+ <td class="function_name">
87
+ <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-get-synthesize" title="cairo_ft_font_face_get_synthesize ()">cairo_ft_font_face_get_synthesize</a> <span class="c_punctuation">()</span>
88
+ </td>
89
+ </tr>
90
+ <tr>
91
+ <td class="function_type">
92
+ <span class="returnvalue">void</span>
93
+ </td>
94
+ <td class="function_name">
95
+ <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-set-synthesize" title="cairo_ft_font_face_set_synthesize ()">cairo_ft_font_face_set_synthesize</a> <span class="c_punctuation">()</span>
96
+ </td>
97
+ </tr>
98
+ <tr>
99
+ <td class="function_type">
100
+ <span class="returnvalue">void</span>
101
+ </td>
102
+ <td class="function_name">
103
+ <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-unset-synthesize" title="cairo_ft_font_face_unset_synthesize ()">cairo_ft_font_face_unset_synthesize</a> <span class="c_punctuation">()</span>
104
+ </td>
105
+ </tr>
106
+ </tbody>
107
+ </table></div>
58
108
  </div>
59
109
  <div class="refsect1">
60
- <a name="cairo-FreeType-Fonts.description"></a><h2>Description</h2>
61
- <p>
62
- The FreeType font backend is primarily used to render text on GNU/Linux
63
- systems, but can be used on other platforms too.
64
- </p>
110
+ <a name="cairo-FreeType-Fonts.other"></a><h2>Types and Values</h2>
111
+ <div class="informaltable"><table width="100%" border="0">
112
+ <colgroup>
113
+ <col width="150px" class="name">
114
+ <col class="description">
115
+ </colgroup>
116
+ <tbody>
117
+ <tr>
118
+ <td class="define_keyword">#define</td>
119
+ <td class="function_name"><a class="link" href="cairo-FreeType-Fonts.html#CAIRO-HAS-FT-FONT:CAPS" title="CAIRO_HAS_FT_FONT">CAIRO_HAS_FT_FONT</a></td>
120
+ </tr>
121
+ <tr>
122
+ <td class="define_keyword">#define</td>
123
+ <td class="function_name"><a class="link" href="cairo-FreeType-Fonts.html#CAIRO-HAS-FC-FONT:CAPS" title="CAIRO_HAS_FC_FONT">CAIRO_HAS_FC_FONT</a></td>
124
+ </tr>
125
+ <tr>
126
+ <td class="datatype_keyword">enum</td>
127
+ <td class="function_name"><a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-synthesize-t" title="enum cairo_ft_synthesize_t">cairo_ft_synthesize_t</a></td>
128
+ </tr>
129
+ </tbody>
130
+ </table></div>
65
131
  </div>
66
132
  <div class="refsect1">
67
- <a name="cairo-FreeType-Fonts.details"></a><h2>Details</h2>
68
- <div class="refsect2">
69
- <a name="CAIRO-HAS-FT-FONT:CAPS"></a><h3>CAIRO_HAS_FT_FONT</h3>
70
- <pre class="programlisting">#define CAIRO_HAS_FT_FONT 1
133
+ <a name="cairo-FreeType-Fonts.object-hierarchy"></a><h2>Object Hierarchy</h2>
134
+ <pre class="screen">
71
135
  </pre>
72
- <p>
73
- Defined if the FreeType font backend is available.
74
- This macro can be used to conditionally compile backend-specific code.
75
- </p>
76
- <p class="since">Since 1.0</p>
77
136
  </div>
78
- <hr>
79
- <div class="refsect2">
80
- <a name="CAIRO-HAS-FC-FONT:CAPS"></a><h3>CAIRO_HAS_FC_FONT</h3>
81
- <pre class="programlisting">#define CAIRO_HAS_FC_FONT 1
82
- </pre>
83
- <p>
84
- Defined if the Fontconfig-specific functions of the FreeType font backend
85
- are available.
86
- This macro can be used to conditionally compile backend-specific code.
87
- </p>
88
- <p class="since">Since 1.10</p>
137
+ <div class="refsect1">
138
+ <a name="cairo-FreeType-Fonts.description"></a><h2>Description</h2>
139
+ <p>The FreeType font backend is primarily used to render text on GNU/Linux
140
+ systems, but can be used on other platforms too.</p>
89
141
  </div>
90
- <hr>
142
+ <div class="refsect1">
143
+ <a name="cairo-FreeType-Fonts.functions_details"></a><h2>Functions</h2>
91
144
  <div class="refsect2">
92
- <a name="cairo-ft-font-face-create-for-ft-face"></a><h3>cairo_ft_font_face_create_for_ft_face ()</h3>
93
- <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_ft_font_face_create_for_ft_face
94
- (<em class="parameter"><code><span class="type">FT_Face</span> face</code></em>,
95
- <em class="parameter"><code><span class="type">int</span> load_flags</code></em>);</pre>
96
- <p>
97
- Creates a new font face for the FreeType font backend from a
145
+ <a name="cairo-ft-font-face-create-for-ft-face"></a><h3>cairo_ft_font_face_create_for_ft_face ()</h3>
146
+ <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> *
147
+ cairo_ft_font_face_create_for_ft_face (<em class="parameter"><code><span class="type">FT_Face</span> face</code></em>,
148
+ <em class="parameter"><code><span class="type">int</span> load_flags</code></em>);</pre>
149
+ <p>Creates a new font face for the FreeType font backend from a
98
150
  pre-opened FreeType face. This font can then be used with
99
- <a class="link" href="cairo-text.html#cairo-set-font-face" title="cairo_set_font_face ()"><code class="function">cairo_set_font_face()</code></a> or <a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-create" title="cairo_scaled_font_create ()"><code class="function">cairo_scaled_font_create()</code></a>. The
100
- <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> returned from <a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-create" title="cairo_scaled_font_create ()"><code class="function">cairo_scaled_font_create()</code></a> is
151
+ <a class="link" href="cairo-text.html#cairo-set-font-face" title="cairo_set_font_face ()"><code class="function">cairo_set_font_face()</code></a> or <a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-create" title="cairo_scaled_font_create ()"><code class="function">cairo_scaled_font_create()</code></a>. The
152
+ <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> returned from <a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-create" title="cairo_scaled_font_create ()"><code class="function">cairo_scaled_font_create()</code></a> is
101
153
  also for the FreeType backend and can be used with functions such
102
- as <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-scaled-font-lock-face" title="cairo_ft_scaled_font_lock_face ()"><code class="function">cairo_ft_scaled_font_lock_face()</code></a>. Note that Cairo may keep a reference
154
+ as <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-scaled-font-lock-face" title="cairo_ft_scaled_font_lock_face ()"><code class="function">cairo_ft_scaled_font_lock_face()</code></a>. Note that Cairo may keep a reference
103
155
  to the FT_Face alive in a font-cache and the exact lifetime of the reference
104
156
  depends highly upon the exact usage pattern and is subject to external
105
157
  factors. You must not call <code class="function">FT_Done_Face()</code> before the last reference to the
106
- <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> has been dropped.
107
- </p>
108
- <p>
109
- As an example, below is how one might correctly couple the lifetime of
110
- the FreeType face object to the <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>.
111
- </p>
112
- <p>
113
- </p>
158
+ <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> has been dropped.</p>
159
+ <p>As an example, below is how one might correctly couple the lifetime of
160
+ the FreeType face object to the <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>.</p>
114
161
  <div class="informalexample"><pre class="programlisting">
115
162
  static const cairo_user_data_key_t key;
116
163
 
@@ -123,306 +170,377 @@ if (status) {
123
170
  return ERROR;
124
171
  }
125
172
  </pre></div>
126
- <p>
127
- </p>
128
- <div class="variablelist"><table border="0">
129
- <col align="left" valign="top">
173
+ <div class="refsect3">
174
+ <a name="id-1.4.5.7.2.7"></a><h4>Parameters</h4>
175
+ <div class="informaltable"><table width="100%" border="0">
176
+ <colgroup>
177
+ <col width="150px" class="parameters_name">
178
+ <col class="parameters_description">
179
+ <col width="200px" class="parameters_annotations">
180
+ </colgroup>
130
181
  <tbody>
131
182
  <tr>
132
- <td><p><span class="term"><em class="parameter"><code>face</code></em> :</span></p></td>
133
- <td>A FreeType face object, already opened. This must
183
+ <td class="parameter_name"><p>face</p></td>
184
+ <td class="parameter_description"><p>A FreeType face object, already opened. This must
134
185
  be kept around until the face's ref_count drops to
135
186
  zero and it is freed. Since the face may be referenced
136
187
  internally to Cairo, the best way to determine when it
137
188
  is safe to free the face is to pass a
138
- <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> to <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>
139
- </td>
189
+ <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> to <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></p></td>
190
+ <td class="parameter_annotations"> </td>
140
191
  </tr>
141
192
  <tr>
142
- <td><p><span class="term"><em class="parameter"><code>load_flags</code></em> :</span></p></td>
143
- <td>flags to pass to FT_Load_Glyph when loading
193
+ <td class="parameter_name"><p>load_flags</p></td>
194
+ <td class="parameter_description"><p>flags to pass to FT_Load_Glyph when loading
144
195
  glyphs from the font. These flags are OR'ed together with
145
196
  the flags derived from the <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> passed
146
- to <a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-create" title="cairo_scaled_font_create ()"><code class="function">cairo_scaled_font_create()</code></a>, so only a few values such
197
+ to <a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-create" title="cairo_scaled_font_create ()"><code class="function">cairo_scaled_font_create()</code></a>, so only a few values such
147
198
  as <code class="literal">FT_LOAD_VERTICAL_LAYOUT</code>, and <code class="literal">FT_LOAD_FORCE_AUTOHINT</code>
148
199
  are useful. You should not pass any of the flags affecting
149
- the load target, such as <code class="literal">FT_LOAD_TARGET_LIGHT</code>.</td>
150
- </tr>
151
- <tr>
152
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
153
- <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
154
- <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>
200
+ the load target, such as <code class="literal">FT_LOAD_TARGET_LIGHT</code>.</p></td>
201
+ <td class="parameter_annotations"> </td>
155
202
  </tr>
156
203
  </tbody>
157
204
  </table></div>
205
+ </div>
206
+ <div class="refsect3">
207
+ <a name="id-1.4.5.7.2.8"></a><h4>Returns</h4>
208
+ <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
209
+ <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>
210
+ <p></p>
211
+ </div>
158
212
  <p class="since">Since 1.0</p>
159
213
  </div>
160
214
  <hr>
161
215
  <div class="refsect2">
162
- <a name="cairo-ft-font-face-create-for-pattern"></a><h3>cairo_ft_font_face_create_for_pattern ()</h3>
163
- <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_ft_font_face_create_for_pattern
164
- (<em class="parameter"><code><span class="type">FcPattern</span> *pattern</code></em>);</pre>
165
- <p>
166
- Creates a new font face for the FreeType font backend based on a
216
+ <a name="cairo-ft-font-face-create-for-pattern"></a><h3>cairo_ft_font_face_create_for_pattern ()</h3>
217
+ <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> *
218
+ cairo_ft_font_face_create_for_pattern (<em class="parameter"><code><span class="type">FcPattern</span> *pattern</code></em>);</pre>
219
+ <p>Creates a new font face for the FreeType font backend based on a
167
220
  fontconfig pattern. This font can then be used with
168
- <a class="link" href="cairo-text.html#cairo-set-font-face" title="cairo_set_font_face ()"><code class="function">cairo_set_font_face()</code></a> or <a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-create" title="cairo_scaled_font_create ()"><code class="function">cairo_scaled_font_create()</code></a>. The
169
- <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> returned from <a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-create" title="cairo_scaled_font_create ()"><code class="function">cairo_scaled_font_create()</code></a> is
221
+ <a class="link" href="cairo-text.html#cairo-set-font-face" title="cairo_set_font_face ()"><code class="function">cairo_set_font_face()</code></a> or <a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-create" title="cairo_scaled_font_create ()"><code class="function">cairo_scaled_font_create()</code></a>. The
222
+ <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> returned from <a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-create" title="cairo_scaled_font_create ()"><code class="function">cairo_scaled_font_create()</code></a> is
170
223
  also for the FreeType backend and can be used with functions such
171
- as <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-scaled-font-lock-face" title="cairo_ft_scaled_font_lock_face ()"><code class="function">cairo_ft_scaled_font_lock_face()</code></a>.
172
- </p>
173
- <p>
174
- Font rendering options are represented both here and when you
175
- call <a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-create" title="cairo_scaled_font_create ()"><code class="function">cairo_scaled_font_create()</code></a>. Font options that have a representation
224
+ as <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-scaled-font-lock-face" title="cairo_ft_scaled_font_lock_face ()"><code class="function">cairo_ft_scaled_font_lock_face()</code></a>.</p>
225
+ <p>Font rendering options are represented both here and when you
226
+ call <a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-create" title="cairo_scaled_font_create ()"><code class="function">cairo_scaled_font_create()</code></a>. Font options that have a representation
176
227
  in a <span class="type">FcPattern</span> must be passed in here; to modify <span class="type">FcPattern</span>
177
228
  appropriately to reflect the options in a <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>, call
178
- <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-options-substitute" title="cairo_ft_font_options_substitute ()"><code class="function">cairo_ft_font_options_substitute()</code></a>.
179
- </p>
180
- <p>
181
- The pattern's FC_FT_FACE element is inspected first and if that is set,
229
+ <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-options-substitute" title="cairo_ft_font_options_substitute ()"><code class="function">cairo_ft_font_options_substitute()</code></a>.</p>
230
+ <p>The pattern's FC_FT_FACE element is inspected first and if that is set,
182
231
  that will be the FreeType font face associated with the returned cairo
183
232
  font face. Otherwise the FC_FILE element is checked. If it's set,
184
233
  that and the value of the FC_INDEX element (defaults to zero) of <em class="parameter"><code>pattern</code></em>
185
- are used to load a font face from file.
186
- </p>
187
- <p>
188
- If both steps from the previous paragraph fails, <em class="parameter"><code>pattern</code></em> will be passed
234
+
235
+ are used to load a font face from file.</p>
236
+ <p>If both steps from the previous paragraph fails, <em class="parameter"><code>pattern</code></em>
237
+ will be passed
189
238
  to FcConfigSubstitute, FcDefaultSubstitute, and finally FcFontMatch,
190
- and the resulting font pattern is used.
191
- </p>
192
- <p>
193
- If the FC_FT_FACE element of <em class="parameter"><code>pattern</code></em> is set, the user is responsible
239
+ and the resulting font pattern is used.</p>
240
+ <p>If the FC_FT_FACE element of <em class="parameter"><code>pattern</code></em>
241
+ is set, the user is responsible
194
242
  for making sure that the referenced FT_Face remains valid for the life
195
243
  time of the returned <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>. See
196
- <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-create-for-ft-face" title="cairo_ft_font_face_create_for_ft_face ()"><code class="function">cairo_ft_font_face_create_for_ft_face()</code></a> for an example of how to couple
197
- the life time of the FT_Face to that of the cairo font-face.
198
- </p>
199
- <div class="variablelist"><table border="0">
200
- <col align="left" valign="top">
201
- <tbody>
202
- <tr>
203
- <td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
204
- <td>A fontconfig pattern. Cairo makes a copy of the pattern
205
- if it needs to. You are free to modify or free <em class="parameter"><code>pattern</code></em> after this call.</td>
206
- </tr>
207
- <tr>
208
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
209
- <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
210
- <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>
211
- </tr>
212
- </tbody>
244
+ <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-create-for-ft-face" title="cairo_ft_font_face_create_for_ft_face ()"><code class="function">cairo_ft_font_face_create_for_ft_face()</code></a> for an example of how to couple
245
+ the life time of the FT_Face to that of the cairo font-face.</p>
246
+ <div class="refsect3">
247
+ <a name="id-1.4.5.7.3.9"></a><h4>Parameters</h4>
248
+ <div class="informaltable"><table width="100%" border="0">
249
+ <colgroup>
250
+ <col width="150px" class="parameters_name">
251
+ <col class="parameters_description">
252
+ <col width="200px" class="parameters_annotations">
253
+ </colgroup>
254
+ <tbody><tr>
255
+ <td class="parameter_name"><p>pattern</p></td>
256
+ <td class="parameter_description"><p>A fontconfig pattern. Cairo makes a copy of the pattern
257
+ if it needs to. You are free to modify or free <em class="parameter"><code>pattern</code></em>
258
+ after this call.</p></td>
259
+ <td class="parameter_annotations"> </td>
260
+ </tr></tbody>
213
261
  </table></div>
262
+ </div>
263
+ <div class="refsect3">
264
+ <a name="id-1.4.5.7.3.10"></a><h4>Returns</h4>
265
+ <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
266
+ <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>
267
+ <p></p>
268
+ </div>
214
269
  <p class="since">Since 1.0</p>
215
270
  </div>
216
271
  <hr>
217
272
  <div class="refsect2">
218
- <a name="cairo-ft-font-options-substitute"></a><h3>cairo_ft_font_options_substitute ()</h3>
219
- <pre class="programlisting"><span class="returnvalue">void</span> cairo_ft_font_options_substitute (<em class="parameter"><code>const <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> *options</code></em>,
220
- <em class="parameter"><code><span class="type">FcPattern</span> *pattern</code></em>);</pre>
221
- <p>
222
- Add options to a <span class="type">FcPattern</span> based on a <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> font
273
+ <a name="cairo-ft-font-options-substitute"></a><h3>cairo_ft_font_options_substitute ()</h3>
274
+ <pre class="programlisting"><span class="returnvalue">void</span>
275
+ cairo_ft_font_options_substitute (<em class="parameter"><code>const <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> *options</code></em>,
276
+ <em class="parameter"><code><span class="type">FcPattern</span> *pattern</code></em>);</pre>
277
+ <p>Add options to a <span class="type">FcPattern</span> based on a <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> font
223
278
  options object. Options that are already in the pattern, are not overridden,
224
279
  so you should call this function after calling <code class="function">FcConfigSubstitute()</code> (the
225
280
  user's settings should override options based on the surface type), but
226
- before calling <code class="function">FcDefaultSubstitute()</code>.
227
- </p>
228
- <div class="variablelist"><table border="0">
229
- <col align="left" valign="top">
281
+ before calling <code class="function">FcDefaultSubstitute()</code>.</p>
282
+ <div class="refsect3">
283
+ <a name="id-1.4.5.7.4.5"></a><h4>Parameters</h4>
284
+ <div class="informaltable"><table width="100%" border="0">
285
+ <colgroup>
286
+ <col width="150px" class="parameters_name">
287
+ <col class="parameters_description">
288
+ <col width="200px" class="parameters_annotations">
289
+ </colgroup>
230
290
  <tbody>
231
291
  <tr>
232
- <td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
233
- <td>a <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> object</td>
292
+ <td class="parameter_name"><p>options</p></td>
293
+ <td class="parameter_description"><p>a <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> object</p></td>
294
+ <td class="parameter_annotations"> </td>
234
295
  </tr>
235
296
  <tr>
236
- <td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
237
- <td>an existing <span class="type">FcPattern</span>
238
- </td>
297
+ <td class="parameter_name"><p>pattern</p></td>
298
+ <td class="parameter_description"><p>an existing <span class="type">FcPattern</span></p></td>
299
+ <td class="parameter_annotations"> </td>
239
300
  </tr>
240
301
  </tbody>
241
302
  </table></div>
303
+ </div>
242
304
  <p class="since">Since 1.0</p>
243
305
  </div>
244
306
  <hr>
245
307
  <div class="refsect2">
246
- <a name="cairo-ft-scaled-font-lock-face"></a><h3>cairo_ft_scaled_font_lock_face ()</h3>
247
- <pre class="programlisting"><span class="returnvalue">FT_Face</span> cairo_ft_scaled_font_lock_face (<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>);</pre>
248
- <p>
249
- <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-scaled-font-lock-face" title="cairo_ft_scaled_font_lock_face ()"><code class="function">cairo_ft_scaled_font_lock_face()</code></a> gets the <span class="type">FT_Face</span> object from a FreeType
308
+ <a name="cairo-ft-scaled-font-lock-face"></a><h3>cairo_ft_scaled_font_lock_face ()</h3>
309
+ <pre class="programlisting"><span class="returnvalue">FT_Face</span>
310
+ cairo_ft_scaled_font_lock_face (<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>);</pre>
311
+ <p>cairo_ft_scaled_font_lock_face() gets the <span class="type">FT_Face</span> object from a FreeType
250
312
  backend font and scales it appropriately for the font. You must
251
- release the face with <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-scaled-font-unlock-face" title="cairo_ft_scaled_font_unlock_face ()"><code class="function">cairo_ft_scaled_font_unlock_face()</code></a>
313
+ release the face with <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-scaled-font-unlock-face" title="cairo_ft_scaled_font_unlock_face ()"><code class="function">cairo_ft_scaled_font_unlock_face()</code></a>
252
314
  when you are done using it. Since the <span class="type">FT_Face</span> object can be
253
315
  shared between multiple <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> objects, you must not
254
316
  lock any other font objects until you unlock this one. A count is
255
- kept of the number of times <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-scaled-font-lock-face" title="cairo_ft_scaled_font_lock_face ()"><code class="function">cairo_ft_scaled_font_lock_face()</code></a> is
256
- called. <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-scaled-font-unlock-face" title="cairo_ft_scaled_font_unlock_face ()"><code class="function">cairo_ft_scaled_font_unlock_face()</code></a> must be called the same number
257
- of times.
258
- </p>
259
- <p>
260
- You must be careful when using this function in a library or in a
317
+ kept of the number of times <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-scaled-font-lock-face" title="cairo_ft_scaled_font_lock_face ()"><code class="function">cairo_ft_scaled_font_lock_face()</code></a> is
318
+ called. <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-scaled-font-unlock-face" title="cairo_ft_scaled_font_unlock_face ()"><code class="function">cairo_ft_scaled_font_unlock_face()</code></a> must be called the same number
319
+ of times.</p>
320
+ <p>You must be careful when using this function in a library or in a
261
321
  threaded application, because freetype's design makes it unsafe to
262
322
  call freetype functions simultaneously from multiple threads, (even
263
323
  if using distinct FT_Face objects). Because of this, application
264
324
  code that acquires an FT_Face object with this call must add its
265
325
  own locking to protect any use of that object, (and which also must
266
326
  protect any other calls into cairo as almost any cairo function
267
- might result in a call into the freetype library).
268
- </p>
269
- <div class="variablelist"><table border="0">
270
- <col align="left" valign="top">
271
- <tbody>
272
- <tr>
273
- <td><p><span class="term"><em class="parameter"><code>scaled_font</code></em> :</span></p></td>
274
- <td>A <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> from the FreeType font backend. Such an
275
- object can be created by calling <a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-create" title="cairo_scaled_font_create ()"><code class="function">cairo_scaled_font_create()</code></a> on a
276
- FreeType backend font face (see <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-create-for-pattern" title="cairo_ft_font_face_create_for_pattern ()"><code class="function">cairo_ft_font_face_create_for_pattern()</code></a>,
277
- <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-create-for-ft-face" title="cairo_ft_font_face_create_for_ft_face ()"><code class="function">cairo_ft_font_face_create_for_ft_face()</code></a>).</td>
278
- </tr>
279
- <tr>
280
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
281
- <td>The <span class="type">FT_Face</span> object for <em class="parameter"><code>font</code></em>, scaled appropriately,
282
- or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>scaled_font</code></em> is in an error state (see
283
- <a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-status" title="cairo_scaled_font_status ()"><code class="function">cairo_scaled_font_status()</code></a>) or there is insufficient memory.</td>
284
- </tr>
285
- </tbody>
327
+ might result in a call into the freetype library).</p>
328
+ <div class="refsect3">
329
+ <a name="id-1.4.5.7.5.6"></a><h4>Parameters</h4>
330
+ <div class="informaltable"><table width="100%" border="0">
331
+ <colgroup>
332
+ <col width="150px" class="parameters_name">
333
+ <col class="parameters_description">
334
+ <col width="200px" class="parameters_annotations">
335
+ </colgroup>
336
+ <tbody><tr>
337
+ <td class="parameter_name"><p>scaled_font</p></td>
338
+ <td class="parameter_description"><p>A <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> from the FreeType font backend. Such an
339
+ object can be created by calling <a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-create" title="cairo_scaled_font_create ()"><code class="function">cairo_scaled_font_create()</code></a> on a
340
+ FreeType backend font face (see <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-create-for-pattern" title="cairo_ft_font_face_create_for_pattern ()"><code class="function">cairo_ft_font_face_create_for_pattern()</code></a>,
341
+ <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-create-for-ft-face" title="cairo_ft_font_face_create_for_ft_face ()"><code class="function">cairo_ft_font_face_create_for_ft_face()</code></a>).</p></td>
342
+ <td class="parameter_annotations"> </td>
343
+ </tr></tbody>
286
344
  </table></div>
345
+ </div>
346
+ <div class="refsect3">
347
+ <a name="id-1.4.5.7.5.7"></a><h4>Returns</h4>
348
+ <p> The <span class="type">FT_Face</span> object for <em class="parameter"><code>font</code></em>
349
+ , scaled appropriately,
350
+ or <code class="literal">NULL</code> if <em class="parameter"><code>scaled_font</code></em>
351
+ is in an error state (see
352
+ <a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-status" title="cairo_scaled_font_status ()"><code class="function">cairo_scaled_font_status()</code></a>) or there is insufficient memory.</p>
353
+ <p></p>
354
+ </div>
287
355
  <p class="since">Since 1.0</p>
288
356
  </div>
289
357
  <hr>
290
358
  <div class="refsect2">
291
- <a name="cairo-ft-scaled-font-unlock-face"></a><h3>cairo_ft_scaled_font_unlock_face ()</h3>
292
- <pre class="programlisting"><span class="returnvalue">void</span> cairo_ft_scaled_font_unlock_face (<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>);</pre>
293
- <p>
294
- Releases a face obtained with <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-scaled-font-lock-face" title="cairo_ft_scaled_font_lock_face ()"><code class="function">cairo_ft_scaled_font_lock_face()</code></a>.
295
- </p>
296
- <div class="variablelist"><table border="0">
297
- <col align="left" valign="top">
359
+ <a name="cairo-ft-scaled-font-unlock-face"></a><h3>cairo_ft_scaled_font_unlock_face ()</h3>
360
+ <pre class="programlisting"><span class="returnvalue">void</span>
361
+ cairo_ft_scaled_font_unlock_face (<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>);</pre>
362
+ <p>Releases a face obtained with <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-scaled-font-lock-face" title="cairo_ft_scaled_font_lock_face ()"><code class="function">cairo_ft_scaled_font_lock_face()</code></a>.</p>
363
+ <div class="refsect3">
364
+ <a name="id-1.4.5.7.6.5"></a><h4>Parameters</h4>
365
+ <div class="informaltable"><table width="100%" border="0">
366
+ <colgroup>
367
+ <col width="150px" class="parameters_name">
368
+ <col class="parameters_description">
369
+ <col width="200px" class="parameters_annotations">
370
+ </colgroup>
298
371
  <tbody><tr>
299
- <td><p><span class="term"><em class="parameter"><code>scaled_font</code></em> :</span></p></td>
300
- <td>A <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> from the FreeType font backend. Such an
301
- object can be created by calling <a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-create" title="cairo_scaled_font_create ()"><code class="function">cairo_scaled_font_create()</code></a> on a
302
- FreeType backend font face (see <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-create-for-pattern" title="cairo_ft_font_face_create_for_pattern ()"><code class="function">cairo_ft_font_face_create_for_pattern()</code></a>,
303
- <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-create-for-ft-face" title="cairo_ft_font_face_create_for_ft_face ()"><code class="function">cairo_ft_font_face_create_for_ft_face()</code></a>).</td>
372
+ <td class="parameter_name"><p>scaled_font</p></td>
373
+ <td class="parameter_description"><p>A <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> from the FreeType font backend. Such an
374
+ object can be created by calling <a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-create" title="cairo_scaled_font_create ()"><code class="function">cairo_scaled_font_create()</code></a> on a
375
+ FreeType backend font face (see <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-create-for-pattern" title="cairo_ft_font_face_create_for_pattern ()"><code class="function">cairo_ft_font_face_create_for_pattern()</code></a>,
376
+ <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-create-for-ft-face" title="cairo_ft_font_face_create_for_ft_face ()"><code class="function">cairo_ft_font_face_create_for_ft_face()</code></a>).</p></td>
377
+ <td class="parameter_annotations"> </td>
304
378
  </tr></tbody>
305
379
  </table></div>
380
+ </div>
306
381
  <p class="since">Since 1.0</p>
307
382
  </div>
308
383
  <hr>
309
384
  <div class="refsect2">
310
- <a name="cairo-ft-synthesize-t"></a><h3>enum cairo_ft_synthesize_t</h3>
311
- <pre class="programlisting">typedef enum {
312
- CAIRO_FT_SYNTHESIZE_BOLD = 1 &lt;&lt; 0,
313
- CAIRO_FT_SYNTHESIZE_OBLIQUE = 1 &lt;&lt; 1
314
- } cairo_ft_synthesize_t;
315
- </pre>
316
- <p>
317
- A set of synthesis options to control how FreeType renders the glyphs
318
- for a particular font face.
319
- </p>
320
- <p>
321
- Individual synthesis features of a <span class="type">cairo_ft_font_face_t</span> can be set
322
- using <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-set-synthesize" title="cairo_ft_font_face_set_synthesize ()"><code class="function">cairo_ft_font_face_set_synthesize()</code></a>, or disabled using
323
- <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-unset-synthesize" title="cairo_ft_font_face_unset_synthesize ()"><code class="function">cairo_ft_font_face_unset_synthesize()</code></a>. The currently enabled set of
324
- synthesis options can be queried with <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-get-synthesize" title="cairo_ft_font_face_get_synthesize ()"><code class="function">cairo_ft_font_face_get_synthesize()</code></a>.
325
- </p>
326
- <p>
327
- Note: that when synthesizing glyphs, the font metrics returned will only
328
- be estimates.
329
- </p>
330
- <div class="variablelist"><table border="0">
331
- <col align="left" valign="top">
332
- <tbody>
333
- <tr>
334
- <td><p><a name="CAIRO-FT-SYNTHESIZE-BOLD:CAPS"></a><span class="term"><code class="literal">CAIRO_FT_SYNTHESIZE_BOLD</code></span></p></td>
335
- <td>Embolden the glyphs (redraw with a pixel offset)
336
- </td>
337
- </tr>
338
- <tr>
339
- <td><p><a name="CAIRO-FT-SYNTHESIZE-OBLIQUE:CAPS"></a><span class="term"><code class="literal">CAIRO_FT_SYNTHESIZE_OBLIQUE</code></span></p></td>
340
- <td>Slant the glyph outline by 12 degrees to the
341
- right.
342
- </td>
343
- </tr>
344
- </tbody>
385
+ <a name="cairo-ft-font-face-get-synthesize"></a><h3>cairo_ft_font_face_get_synthesize ()</h3>
386
+ <pre class="programlisting">unsigned <span class="returnvalue">int</span>
387
+ cairo_ft_font_face_get_synthesize (<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>
388
+ <p>See <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-synthesize-t" title="enum cairo_ft_synthesize_t"><span class="type">cairo_ft_synthesize_t</span></a>.</p>
389
+ <div class="refsect3">
390
+ <a name="id-1.4.5.7.7.5"></a><h4>Parameters</h4>
391
+ <div class="informaltable"><table width="100%" border="0">
392
+ <colgroup>
393
+ <col width="150px" class="parameters_name">
394
+ <col class="parameters_description">
395
+ <col width="200px" class="parameters_annotations">
396
+ </colgroup>
397
+ <tbody><tr>
398
+ <td class="parameter_name"><p>font_face</p></td>
399
+ <td class="parameter_description"><p>The <span class="type">cairo_ft_font_face_t</span> object to query</p></td>
400
+ <td class="parameter_annotations"> </td>
401
+ </tr></tbody>
345
402
  </table></div>
403
+ </div>
404
+ <div class="refsect3">
405
+ <a name="id-1.4.5.7.7.6"></a><h4>Returns</h4>
406
+ <p> the current set of synthesis options.</p>
407
+ <p></p>
408
+ </div>
346
409
  <p class="since">Since 1.12</p>
347
410
  </div>
348
411
  <hr>
349
412
  <div class="refsect2">
350
- <a name="cairo-ft-font-face-get-synthesize"></a><h3>cairo_ft_font_face_get_synthesize ()</h3>
351
- <pre class="programlisting">unsigned <span class="returnvalue">int</span> cairo_ft_font_face_get_synthesize (<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>
352
- <p>
353
- See <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-synthesize-t" title="enum cairo_ft_synthesize_t"><span class="type">cairo_ft_synthesize_t</span></a>.
354
- </p>
355
- <div class="variablelist"><table border="0">
356
- <col align="left" valign="top">
413
+ <a name="cairo-ft-font-face-set-synthesize"></a><h3>cairo_ft_font_face_set_synthesize ()</h3>
414
+ <pre class="programlisting"><span class="returnvalue">void</span>
415
+ cairo_ft_font_face_set_synthesize (<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>,
416
+ <em class="parameter"><code>unsigned <span class="type">int</span> synth_flags</code></em>);</pre>
417
+ <p>FreeType provides the ability to synthesize different glyphs from a base
418
+ font, which is useful if you lack those glyphs from a true bold or oblique
419
+ font. See also <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-synthesize-t" title="enum cairo_ft_synthesize_t"><span class="type">cairo_ft_synthesize_t</span></a>.</p>
420
+ <div class="refsect3">
421
+ <a name="id-1.4.5.7.8.5"></a><h4>Parameters</h4>
422
+ <div class="informaltable"><table width="100%" border="0">
423
+ <colgroup>
424
+ <col width="150px" class="parameters_name">
425
+ <col class="parameters_description">
426
+ <col width="200px" class="parameters_annotations">
427
+ </colgroup>
357
428
  <tbody>
358
429
  <tr>
359
- <td><p><span class="term"><em class="parameter"><code>font_face</code></em> :</span></p></td>
360
- <td>The <span class="type">cairo_ft_font_face_t</span> object to query</td>
430
+ <td class="parameter_name"><p>font_face</p></td>
431
+ <td class="parameter_description"><p>The <span class="type">cairo_ft_font_face_t</span> object to modify</p></td>
432
+ <td class="parameter_annotations"> </td>
361
433
  </tr>
362
434
  <tr>
363
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
364
- <td>the current set of synthesis options.</td>
435
+ <td class="parameter_name"><p>synth_flags</p></td>
436
+ <td class="parameter_description"><p>the set of synthesis options to enable</p></td>
437
+ <td class="parameter_annotations"> </td>
365
438
  </tr>
366
439
  </tbody>
367
440
  </table></div>
441
+ </div>
368
442
  <p class="since">Since 1.12</p>
369
443
  </div>
370
444
  <hr>
371
445
  <div class="refsect2">
372
- <a name="cairo-ft-font-face-set-synthesize"></a><h3>cairo_ft_font_face_set_synthesize ()</h3>
373
- <pre class="programlisting"><span class="returnvalue">void</span> cairo_ft_font_face_set_synthesize (<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>,
374
- <em class="parameter"><code>unsigned <span class="type">int</span> synth_flags</code></em>);</pre>
375
- <p>
376
- FreeType provides the ability to synthesize different glyphs from a base
377
- font, which is useful if you lack those glyphs from a true bold or oblique
378
- font. See also <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-synthesize-t" title="enum cairo_ft_synthesize_t"><span class="type">cairo_ft_synthesize_t</span></a>.
379
- </p>
380
- <div class="variablelist"><table border="0">
381
- <col align="left" valign="top">
446
+ <a name="cairo-ft-font-face-unset-synthesize"></a><h3>cairo_ft_font_face_unset_synthesize ()</h3>
447
+ <pre class="programlisting"><span class="returnvalue">void</span>
448
+ cairo_ft_font_face_unset_synthesize (<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>,
449
+ <em class="parameter"><code>unsigned <span class="type">int</span> synth_flags</code></em>);</pre>
450
+ <p>See <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-set-synthesize" title="cairo_ft_font_face_set_synthesize ()"><code class="function">cairo_ft_font_face_set_synthesize()</code></a>.</p>
451
+ <div class="refsect3">
452
+ <a name="id-1.4.5.7.9.5"></a><h4>Parameters</h4>
453
+ <div class="informaltable"><table width="100%" border="0">
454
+ <colgroup>
455
+ <col width="150px" class="parameters_name">
456
+ <col class="parameters_description">
457
+ <col width="200px" class="parameters_annotations">
458
+ </colgroup>
382
459
  <tbody>
383
460
  <tr>
384
- <td><p><span class="term"><em class="parameter"><code>font_face</code></em> :</span></p></td>
385
- <td>The <span class="type">cairo_ft_font_face_t</span> object to modify</td>
461
+ <td class="parameter_name"><p>font_face</p></td>
462
+ <td class="parameter_description"><p>The <span class="type">cairo_ft_font_face_t</span> object to modify</p></td>
463
+ <td class="parameter_annotations"> </td>
386
464
  </tr>
387
465
  <tr>
388
- <td><p><span class="term"><em class="parameter"><code>synth_flags</code></em> :</span></p></td>
389
- <td>the set of synthesis options to enable</td>
466
+ <td class="parameter_name"><p>synth_flags</p></td>
467
+ <td class="parameter_description"><p>the set of synthesis options to disable</p></td>
468
+ <td class="parameter_annotations"> </td>
390
469
  </tr>
391
470
  </tbody>
392
471
  </table></div>
472
+ </div>
393
473
  <p class="since">Since 1.12</p>
394
474
  </div>
475
+ </div>
476
+ <div class="refsect1">
477
+ <a name="cairo-FreeType-Fonts.other_details"></a><h2>Types and Values</h2>
478
+ <div class="refsect2">
479
+ <a name="CAIRO-HAS-FT-FONT:CAPS"></a><h3>CAIRO_HAS_FT_FONT</h3>
480
+ <pre class="programlisting">#define CAIRO_HAS_FT_FONT 1
481
+ </pre>
482
+ <p>Defined if the FreeType font backend is available.
483
+ This macro can be used to conditionally compile backend-specific code.</p>
484
+ <p class="since">Since 1.0</p>
485
+ </div>
486
+ <hr>
487
+ <div class="refsect2">
488
+ <a name="CAIRO-HAS-FC-FONT:CAPS"></a><h3>CAIRO_HAS_FC_FONT</h3>
489
+ <pre class="programlisting">#define CAIRO_HAS_FC_FONT 1
490
+ </pre>
491
+ <p>Defined if the Fontconfig-specific functions of the FreeType font backend
492
+ are available.
493
+ This macro can be used to conditionally compile backend-specific code.</p>
494
+ <p class="since">Since 1.10</p>
495
+ </div>
395
496
  <hr>
396
497
  <div class="refsect2">
397
- <a name="cairo-ft-font-face-unset-synthesize"></a><h3>cairo_ft_font_face_unset_synthesize ()</h3>
398
- <pre class="programlisting"><span class="returnvalue">void</span> cairo_ft_font_face_unset_synthesize (<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>,
399
- <em class="parameter"><code>unsigned <span class="type">int</span> synth_flags</code></em>);</pre>
400
- <p>
401
- See <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-set-synthesize" title="cairo_ft_font_face_set_synthesize ()"><code class="function">cairo_ft_font_face_set_synthesize()</code></a>.
402
- </p>
403
- <div class="variablelist"><table border="0">
404
- <col align="left" valign="top">
498
+ <a name="cairo-ft-synthesize-t"></a><h3>enum cairo_ft_synthesize_t</h3>
499
+ <p>A set of synthesis options to control how FreeType renders the glyphs
500
+ for a particular font face.</p>
501
+ <p>Individual synthesis features of a <span class="type">cairo_ft_font_face_t</span> can be set
502
+ using <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-set-synthesize" title="cairo_ft_font_face_set_synthesize ()"><code class="function">cairo_ft_font_face_set_synthesize()</code></a>, or disabled using
503
+ <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-unset-synthesize" title="cairo_ft_font_face_unset_synthesize ()"><code class="function">cairo_ft_font_face_unset_synthesize()</code></a>. The currently enabled set of
504
+ synthesis options can be queried with <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-get-synthesize" title="cairo_ft_font_face_get_synthesize ()"><code class="function">cairo_ft_font_face_get_synthesize()</code></a>.</p>
505
+ <p>Note: that when synthesizing glyphs, the font metrics returned will only
506
+ be estimates.</p>
507
+ <div class="refsect3">
508
+ <a name="id-1.4.5.8.4.6"></a><h4>Members</h4>
509
+ <div class="informaltable"><table width="100%" border="0">
510
+ <colgroup>
511
+ <col width="300px" class="enum_members_name">
512
+ <col class="enum_members_description">
513
+ <col width="200px" class="enum_members_annotations">
514
+ </colgroup>
405
515
  <tbody>
406
516
  <tr>
407
- <td><p><span class="term"><em class="parameter"><code>font_face</code></em> :</span></p></td>
408
- <td>The <span class="type">cairo_ft_font_face_t</span> object to modify</td>
517
+ <td class="enum_member_name"><p><a name="CAIRO-FT-SYNTHESIZE-BOLD:CAPS"></a>CAIRO_FT_SYNTHESIZE_BOLD</p></td>
518
+ <td class="enum_member_description">
519
+ <p>Embolden the glyphs (redraw with a pixel offset)</p>
520
+ </td>
521
+ <td class="enum_member_annotations"> </td>
409
522
  </tr>
410
523
  <tr>
411
- <td><p><span class="term"><em class="parameter"><code>synth_flags</code></em> :</span></p></td>
412
- <td>the set of synthesis options to disable</td>
524
+ <td class="enum_member_name"><p><a name="CAIRO-FT-SYNTHESIZE-OBLIQUE:CAPS"></a>CAIRO_FT_SYNTHESIZE_OBLIQUE</p></td>
525
+ <td class="enum_member_description">
526
+ <p>Slant the glyph outline by 12 degrees to the
527
+ right.</p>
528
+ </td>
529
+ <td class="enum_member_annotations"> </td>
413
530
  </tr>
414
531
  </tbody>
415
532
  </table></div>
533
+ </div>
416
534
  <p class="since">Since 1.12</p>
417
535
  </div>
418
536
  </div>
419
537
  <div class="refsect1">
420
538
  <a name="cairo-FreeType-Fonts.see-also"></a><h2>See Also</h2>
421
- <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>
539
+ <p><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></p>
422
540
  </div>
423
541
  </div>
424
542
  <div class="footer">
425
543
  <hr>
426
- Generated by GTK-Doc V1.18</div>
544
+ Generated by GTK-Doc V1.20</div>
427
545
  </body>
428
546
  </html>