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

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 (167) hide show
  1. data/ChangeLog +32 -0
  2. data/NEWS +9 -1
  3. data/README +1 -0
  4. data/Rakefile +2 -2
  5. data/cairo/DLL_FAQ.txt +397 -0
  6. data/cairo/README.txt +53 -0
  7. data/cairo/USAGE.txt +94 -0
  8. data/cairo/bin/libcairo-2.dll +0 -0
  9. data/cairo/bin/libpng12-0.dll +0 -0
  10. data/cairo/bin/zlib1.dll +0 -0
  11. data/cairo/include/cairo/cairo-deprecated.h +0 -4
  12. data/cairo/include/cairo/cairo-features.h +7 -22
  13. data/cairo/include/cairo/cairo-pdf.h +1 -1
  14. data/cairo/include/cairo/cairo-ps.h +1 -1
  15. data/cairo/include/cairo/cairo-svg.h +1 -1
  16. data/cairo/include/cairo/cairo-version.h +8 -0
  17. data/cairo/include/cairo/cairo-win32.h +9 -1
  18. data/cairo/include/cairo/cairo.h +420 -32
  19. data/cairo/include/libpng12/png.h +3592 -0
  20. data/cairo/include/libpng12/pngconf.h +1481 -0
  21. data/cairo/include/png.h +36 -13
  22. data/cairo/include/pngconf.h +3 -3
  23. data/cairo/include/zconf.h +332 -0
  24. data/cairo/include/zlib.h +1357 -0
  25. data/cairo/lib/cairo.def +22 -0
  26. data/cairo/lib/cairo.lib +0 -0
  27. data/cairo/lib/libcairo.dll.a +0 -0
  28. data/cairo/lib/libpng.def +1 -0
  29. data/cairo/lib/libpng.lib +0 -0
  30. data/cairo/lib/libpng12.dll.a +0 -0
  31. data/cairo/lib/pkgconfig/cairo-pdf.pc +5 -5
  32. data/cairo/lib/pkgconfig/cairo-png.pc +5 -5
  33. data/cairo/lib/pkgconfig/cairo-ps.pc +5 -5
  34. data/cairo/lib/pkgconfig/cairo-svg.pc +4 -4
  35. data/cairo/lib/pkgconfig/cairo-win32-font.pc +4 -4
  36. data/cairo/lib/pkgconfig/cairo-win32.pc +4 -4
  37. data/cairo/lib/pkgconfig/cairo.pc +4 -4
  38. data/cairo/lib/pkgconfig/libpng.pc +3 -2
  39. data/cairo/lib/pkgconfig/libpng12.pc +3 -2
  40. data/cairo/lib/zdll.exp +0 -0
  41. data/cairo/lib/zdll.lib +0 -0
  42. data/cairo/lib/zlib.def +60 -0
  43. data/cairo/manifest/cairo-dev_1.8.0-1_win32.mft +76 -0
  44. data/cairo/manifest/cairo_1.8.0-1_win32.mft +5 -0
  45. data/cairo/manifest/{libpng-dev-1.2.29.mft → libpng-dev_1.2.32-1_win32.mft} +5 -2
  46. data/cairo/manifest/libpng_1.2.32-1_win32.mft +2 -0
  47. data/cairo/share/doc/{cairo-1.6.4-2 → cairo_1.8.0-1_win32}/COPYING +0 -0
  48. data/cairo/share/doc/{cairo-1.6.4-2 → cairo_1.8.0-1_win32}/COPYING-LGPL-2.1 +0 -0
  49. data/cairo/share/doc/{cairo-1.6.4-2 → cairo_1.8.0-1_win32}/COPYING-MPL-1.1 +0 -0
  50. data/cairo/share/gtk-doc/html/cairo/bindings-errors.html +15 -11
  51. data/cairo/share/gtk-doc/html/cairo/bindings-fonts.html +15 -11
  52. data/cairo/share/gtk-doc/html/cairo/bindings-memory.html +20 -16
  53. data/cairo/share/gtk-doc/html/cairo/bindings-overloading.html +16 -12
  54. data/cairo/share/gtk-doc/html/cairo/bindings-path.html +17 -13
  55. data/cairo/share/gtk-doc/html/cairo/bindings-patterns.html +25 -21
  56. data/cairo/share/gtk-doc/html/cairo/bindings-return-values.html +17 -13
  57. data/cairo/share/gtk-doc/html/cairo/bindings-streams.html +14 -10
  58. data/cairo/share/gtk-doc/html/cairo/bindings-surfaces.html +19 -15
  59. data/cairo/share/gtk-doc/html/cairo/cairo-context.html +2721 -0
  60. data/cairo/share/gtk-doc/html/cairo/cairo-drawing.html +57 -0
  61. data/cairo/share/gtk-doc/html/cairo/cairo-error-status.html +361 -0
  62. data/cairo/share/gtk-doc/html/cairo/cairo-font-face.html +418 -0
  63. data/cairo/share/gtk-doc/html/cairo/cairo-font-options.html +695 -0
  64. data/cairo/share/gtk-doc/html/cairo/cairo-fonts.html +63 -0
  65. data/cairo/share/gtk-doc/html/cairo/cairo-ft-font.html +318 -0
  66. data/cairo/share/gtk-doc/html/cairo/cairo-image-surface.html +486 -0
  67. data/cairo/share/gtk-doc/html/cairo/{cairo-cairo-matrix-t.html → cairo-matrix.html} +137 -156
  68. data/cairo/share/gtk-doc/html/cairo/{cairo-Paths.html → cairo-paths.html} +275 -306
  69. data/cairo/share/gtk-doc/html/cairo/cairo-pattern.html +1524 -0
  70. data/cairo/share/gtk-doc/html/cairo/{cairo-PDF-Surfaces.html → cairo-pdf-surface.html} +60 -70
  71. data/cairo/share/gtk-doc/html/cairo/cairo-png-functions.html +332 -0
  72. data/cairo/share/gtk-doc/html/cairo/{cairo-PostScript-Surfaces.html → cairo-ps-surface.html} +131 -150
  73. data/cairo/share/gtk-doc/html/cairo/cairo-quartz-font.html +153 -0
  74. data/cairo/share/gtk-doc/html/cairo/{cairo-Quartz-Surfaces.html → cairo-quartz-surface.html} +53 -62
  75. data/cairo/share/gtk-doc/html/cairo/cairo-scaled-font.html +1051 -0
  76. data/cairo/share/gtk-doc/html/cairo/cairo-support.html +54 -0
  77. data/cairo/share/gtk-doc/html/cairo/cairo-surface.html +1064 -0
  78. data/cairo/share/gtk-doc/html/cairo/cairo-surfaces.html +69 -0
  79. data/cairo/share/gtk-doc/html/cairo/cairo-svg-surface.html +324 -0
  80. data/cairo/share/gtk-doc/html/cairo/cairo-text.html +1264 -0
  81. data/cairo/share/gtk-doc/html/cairo/{cairo-Transformations.html → cairo-transformations.html} +98 -115
  82. data/cairo/share/gtk-doc/html/cairo/cairo-types.html +134 -0
  83. data/cairo/share/gtk-doc/html/cairo/cairo-user-font.html +769 -0
  84. data/cairo/share/gtk-doc/html/cairo/cairo-version-info.html +355 -0
  85. data/cairo/share/gtk-doc/html/cairo/cairo-win32-font.html +366 -0
  86. data/cairo/share/gtk-doc/html/cairo/cairo-win32-surface.html +321 -0
  87. data/cairo/share/gtk-doc/html/cairo/{cairo-XLib-Surfaces.html → cairo-xlib-surface.html} +104 -121
  88. data/cairo/share/gtk-doc/html/cairo/cairo.devhelp +390 -405
  89. data/cairo/share/gtk-doc/html/cairo/cairo.devhelp2 +390 -405
  90. data/cairo/share/gtk-doc/html/cairo/index-1.2.html +63 -59
  91. data/cairo/share/gtk-doc/html/cairo/index-1.4.html +45 -41
  92. data/cairo/share/gtk-doc/html/cairo/index-1.6.html +29 -23
  93. data/cairo/share/gtk-doc/html/cairo/index-1.8.html +107 -0
  94. data/cairo/share/gtk-doc/html/cairo/index-all.html +759 -0
  95. data/cairo/share/gtk-doc/html/cairo/index.html +51 -41
  96. data/cairo/share/gtk-doc/html/cairo/index.sgml +478 -466
  97. data/cairo/share/gtk-doc/html/cairo/language-bindings.html +22 -18
  98. data/cairo/share/gtk-doc/html/cairo/style.css +14 -2
  99. data/cairo/share/man/man3/libpng.3 +443 -17
  100. data/cairo/share/man/man3/libpngpf.3 +618 -102
  101. data/cairo/share/man/man5/png.5 +1 -1
  102. data/cairo/src/tml/make/cairo_1.8.0-1_win32.log +1021 -0
  103. data/cairo/src/tml/make/cairo_1.8.0-1_win32.sh +68 -0
  104. data/cairo/src/tml/make/libpng_1.2.32-1_win32.log +269 -0
  105. data/cairo/src/tml/make/libpng_1.2.32-1_win32.sh +63 -0
  106. data/cairo/test/example_d.exe +0 -0
  107. data/cairo/test/minigzip_d.exe +0 -0
  108. data/cairo/test/testzlib_d.exe +0 -0
  109. data/cairo/test/untgz_d.exe +0 -0
  110. data/doc/en/cairo-context.html +81 -91
  111. data/doc/en/cairo-font-options.html +11 -26
  112. data/doc/en/cairo-text-cluster-flag.html +35 -0
  113. data/doc/en/cairo-user-font-face-text-to-glyphs-data.html +3 -3
  114. data/doc/en/cairo.html +38 -42
  115. data/doc/en/index.html +129 -142
  116. data/doc/ja/cairo-font-options.html +3 -25
  117. data/doc/ja/cairo-text-cluster-flag.html +46 -0
  118. data/doc/ja/cairo-user-font-face-text-to-glyphs-data.html +16 -15
  119. data/doc/ja/cairo.html +3 -7
  120. data/doc/ja/index.html +9 -17
  121. data/src/cairo.def +1 -1
  122. data/src/cairo.so +0 -0
  123. data/src/lib/cairo/constants.rb +3 -1
  124. data/src/libruby-cairo.a +0 -0
  125. data/src/rb_cairo.c +2 -2
  126. data/src/rb_cairo.h +5 -5
  127. data/src/rb_cairo_constants.c +12 -19
  128. data/src/rb_cairo_context.c +25 -21
  129. data/src/rb_cairo_font_face.c +44 -29
  130. data/src/rb_cairo_font_options.c +1 -23
  131. data/src/rb_cairo_scaled_font.c +5 -5
  132. data/test/test_constants.rb +6 -9
  133. data/test/test_context.rb +0 -12
  134. data/test/test_font_face.rb +7 -7
  135. data/test/test_font_options.rb +2 -21
  136. data/test/test_scaled_font.rb +3 -3
  137. data/test/test_text_to_glyphs_data.rb +19 -15
  138. metadata +68 -45
  139. data/cairo/make/cairo-1.6.4-2.sh +0 -55
  140. data/cairo/make/libpng-1.2.29.sh +0 -35
  141. data/cairo/manifest/cairo-1.6.4-2.mft +0 -6
  142. data/cairo/manifest/cairo-dev-1.6.4-2.mft +0 -72
  143. data/cairo/manifest/libpng-1.2.29.mft +0 -2
  144. data/cairo/share/gtk-doc/html/cairo/Drawing.html +0 -53
  145. data/cairo/share/gtk-doc/html/cairo/Fonts.html +0 -56
  146. data/cairo/share/gtk-doc/html/cairo/Support.html +0 -50
  147. data/cairo/share/gtk-doc/html/cairo/Surfaces.html +0 -65
  148. data/cairo/share/gtk-doc/html/cairo/cairo-Error-Handling.html +0 -328
  149. data/cairo/share/gtk-doc/html/cairo/cairo-Font-Options.html +0 -720
  150. data/cairo/share/gtk-doc/html/cairo/cairo-FreeType-Fonts.html +0 -297
  151. data/cairo/share/gtk-doc/html/cairo/cairo-Image-Surfaces.html +0 -484
  152. data/cairo/share/gtk-doc/html/cairo/cairo-PNG-Support.html +0 -345
  153. data/cairo/share/gtk-doc/html/cairo/cairo-Patterns.html +0 -1560
  154. data/cairo/share/gtk-doc/html/cairo/cairo-Quartz-Fonts.html +0 -161
  155. data/cairo/share/gtk-doc/html/cairo/cairo-SVG-Surfaces.html +0 -337
  156. data/cairo/share/gtk-doc/html/cairo/cairo-Scaled-Fonts.html +0 -823
  157. data/cairo/share/gtk-doc/html/cairo/cairo-Text.html +0 -836
  158. data/cairo/share/gtk-doc/html/cairo/cairo-Types.html +0 -143
  159. data/cairo/share/gtk-doc/html/cairo/cairo-Version-Information.html +0 -325
  160. data/cairo/share/gtk-doc/html/cairo/cairo-Win32-Fonts.html +0 -381
  161. data/cairo/share/gtk-doc/html/cairo/cairo-Win32-Surfaces.html +0 -331
  162. data/cairo/share/gtk-doc/html/cairo/cairo-cairo-font-face-t.html +0 -427
  163. data/cairo/share/gtk-doc/html/cairo/cairo-cairo-surface-t.html +0 -995
  164. data/cairo/share/gtk-doc/html/cairo/cairo-cairo-t.html +0 -2795
  165. data/cairo/share/gtk-doc/html/cairo/ix01.html +0 -693
  166. data/doc/en/cairo-lcd-filter.html +0 -39
  167. data/doc/ja/cairo-lcd-filter.html +0 -63
data/cairo/share/gtk-doc/html/cairo/cairo-font-options.html ADDED
@@ -0,0 +1,695 @@
1
+ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
+ <html>
3
+ <head>
4
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
+ <title>cairo_font_options_t</title>
6
+ <meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
7
+ <link rel="start" href="index.html" title="Cairo: A Vector Graphics Library">
8
+ <link rel="up" href="cairo-fonts.html" title="Fonts">
9
+ <link rel="prev" href="cairo-scaled-font.html" title="cairo_scaled_font_t">
10
+ <link rel="next" href="cairo-ft-font.html" title="FreeType Fonts">
11
+ <meta name="generator" content="GTK-Doc V1.10 (XML mode)">
12
+ <link rel="stylesheet" href="style.css" type="text/css">
13
+ <link rel="chapter" href="cairo-drawing.html" title="Drawing">
14
+ <link rel="chapter" href="cairo-fonts.html" title="Fonts">
15
+ <link rel="chapter" href="cairo-surfaces.html" title="Surfaces">
16
+ <link rel="chapter" href="cairo-support.html" title="Utilities">
17
+ <link rel="index" href="index-all.html" title="Index">
18
+ <link rel="index" href="index-1.2.html" title="Index of new symbols in 1.2">
19
+ <link rel="index" href="index-1.4.html" title="Index of new symbols in 1.4">
20
+ <link rel="index" href="index-1.6.html" title="Index of new symbols in 1.6">
21
+ <link rel="index" href="index-1.8.html" title="Index of new symbols in 1.8">
22
+ <link rel="appendix" href="language-bindings.html" title="Appendix A. Creating a language binding for cairo">
23
+ </head>
24
+ <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
25
+ <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
26
+ <tr valign="middle">
27
+ <td><a accesskey="p" href="cairo-scaled-font.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
28
+ <td><a accesskey="u" href="cairo-fonts.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
29
+ <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
30
+ <th width="100%" align="center">Cairo: A Vector Graphics Library</th>
31
+ <td><a accesskey="n" href="cairo-ft-font.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
32
+ </tr>
33
+ <tr><td colspan="5" class="shortcuts"><nobr><a href="#cairo-font-options.synopsis" class="shortcut">Top</a>
34
+  | 
35
+ <a href="#cairo-font-options.description" class="shortcut">Description</a></nobr></td></tr>
36
+ </table>
37
+ <div class="refentry" lang="en">
38
+ <a name="cairo-font-options"></a><div class="titlepage"></div>
39
+ <div class="refnamediv"><table width="100%"><tr>
40
+ <td valign="top">
41
+ <h2><span class="refentrytitle"><a name="cairo-font-options.top_of_page"></a>cairo_font_options_t</span></h2>
42
+ <p>cairo_font_options_t — How a font should be rendered</p>
43
+ </td>
44
+ <td valign="top" align="right"></td>
45
+ </tr></table></div>
46
+ <div class="refsynopsisdiv">
47
+ <a name="cairo-font-options.synopsis"></a><h2>Synopsis</h2>
48
+ <pre class="synopsis">
49
+ typedef <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a>;
50
+ <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a>* <a class="link" href="cairo-font-options.html#cairo-font-options-create" title="cairo_font_options_create ()">cairo_font_options_create</a> (void);
51
+ <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a>* <a class="link" href="cairo-font-options.html#cairo-font-options-copy" title="cairo_font_options_copy ()">cairo_font_options_copy</a> (const <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *original);
52
+ void <a class="link" href="cairo-font-options.html#cairo-font-options-destroy" title="cairo_font_options_destroy ()">cairo_font_options_destroy</a> (<a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options);
53
+ <a class="link" href="cairo-error-status.html#cairo-status-t" title="enum cairo_status_t">cairo_status_t</a> <a class="link" href="cairo-font-options.html#cairo-font-options-status" title="cairo_font_options_status ()">cairo_font_options_status</a> (<a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options);
54
+ void <a class="link" href="cairo-font-options.html#cairo-font-options-merge" title="cairo_font_options_merge ()">cairo_font_options_merge</a> (<a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options,
55
+ const <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *other);
56
+ unsigned long <a class="link" href="cairo-font-options.html#cairo-font-options-hash" title="cairo_font_options_hash ()">cairo_font_options_hash</a> (const <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options);
57
+ <a class="link" href="cairo-types.html#cairo-bool-t" title="cairo_bool_t">cairo_bool_t</a> <a class="link" href="cairo-font-options.html#cairo-font-options-equal" title="cairo_font_options_equal ()">cairo_font_options_equal</a> (const <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options,
58
+ const <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *other);
59
+ void <a class="link" href="cairo-font-options.html#cairo-font-options-set-antialias" title="cairo_font_options_set_antialias ()">cairo_font_options_set_antialias</a> (<a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options,
60
+ <a class="link" href="cairo-context.html#cairo-antialias-t" title="enum cairo_antialias_t">cairo_antialias_t</a> antialias);
61
+ <a class="link" href="cairo-context.html#cairo-antialias-t" title="enum cairo_antialias_t">cairo_antialias_t</a> <a class="link" href="cairo-font-options.html#cairo-font-options-get-antialias" title="cairo_font_options_get_antialias ()">cairo_font_options_get_antialias</a> (const <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options);
62
+ enum <a class="link" href="cairo-font-options.html#cairo-subpixel-order-t" title="enum cairo_subpixel_order_t">cairo_subpixel_order_t</a>;
63
+ void <a class="link" href="cairo-font-options.html#cairo-font-options-set-subpixel-order" title="cairo_font_options_set_subpixel_order ()">cairo_font_options_set_subpixel_order</a>
64
+ (<a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options,
65
+ <a class="link" href="cairo-font-options.html#cairo-subpixel-order-t" title="enum cairo_subpixel_order_t">cairo_subpixel_order_t</a> subpixel_order);
66
+ <a class="link" href="cairo-font-options.html#cairo-subpixel-order-t" title="enum cairo_subpixel_order_t">cairo_subpixel_order_t</a> <a class="link" href="cairo-font-options.html#cairo-font-options-get-subpixel-order" title="cairo_font_options_get_subpixel_order ()">cairo_font_options_get_subpixel_order</a>
67
+ (const <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options);
68
+ enum <a class="link" href="cairo-font-options.html#cairo-hint-style-t" title="enum cairo_hint_style_t">cairo_hint_style_t</a>;
69
+ void <a class="link" href="cairo-font-options.html#cairo-font-options-set-hint-style" title="cairo_font_options_set_hint_style ()">cairo_font_options_set_hint_style</a> (<a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options,
70
+ <a class="link" href="cairo-font-options.html#cairo-hint-style-t" title="enum cairo_hint_style_t">cairo_hint_style_t</a> hint_style);
71
+ <a class="link" href="cairo-font-options.html#cairo-hint-style-t" title="enum cairo_hint_style_t">cairo_hint_style_t</a> <a class="link" href="cairo-font-options.html#cairo-font-options-get-hint-style" title="cairo_font_options_get_hint_style ()">cairo_font_options_get_hint_style</a> (const <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options);
72
+ enum <a class="link" href="cairo-font-options.html#cairo-hint-metrics-t" title="enum cairo_hint_metrics_t">cairo_hint_metrics_t</a>;
73
+ void <a class="link" href="cairo-font-options.html#cairo-font-options-set-hint-metrics" title="cairo_font_options_set_hint_metrics ()">cairo_font_options_set_hint_metrics</a> (<a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options,
74
+ <a class="link" href="cairo-font-options.html#cairo-hint-metrics-t" title="enum cairo_hint_metrics_t">cairo_hint_metrics_t</a> hint_metrics);
75
+ <a class="link" href="cairo-font-options.html#cairo-hint-metrics-t" title="enum cairo_hint_metrics_t">cairo_hint_metrics_t</a> <a class="link" href="cairo-font-options.html#cairo-font-options-get-hint-metrics" title="cairo_font_options_get_hint_metrics ()">cairo_font_options_get_hint_metrics</a>
76
+ (const <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options);
77
+ </pre>
78
+ </div>
79
+ <div class="refsect1" lang="en">
80
+ <a name="cairo-font-options.description"></a><h2>Description</h2>
81
+ <p>
82
+ The font options specify how fonts should be rendered. Most of the time the
83
+ font options implied by a surface are just right and do not need any changes,
84
+ but for pixel-based targets tweaking font options may result in superior
85
+ output on a particular display.
86
+ </p>
87
+ </div>
88
+ <div class="refsect1" lang="en">
89
+ <a name="cairo-font-options.details"></a><h2>Details</h2>
90
+ <div class="refsect2" lang="en">
91
+ <a name="cairo-font-options-t"></a><h3>cairo_font_options_t</h3>
92
+ <pre class="programlisting">typedef struct _cairo_font_options cairo_font_options_t;
93
+ </pre>
94
+ <p>
95
+ An opaque structure holding all options that are used when
96
+ rendering fonts.
97
+ </p>
98
+ <p>
99
+ Individual features of a <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> can be set or
100
+ accessed using functions named
101
+ cairo_font_options_set_<span class="emphasis"><em>feature_name</em></span> and
102
+ cairo_font_options_get_<span class="emphasis"><em>feature_name</em></span>, like
103
+ <a class="link" href="cairo-font-options.html#cairo-font-options-set-antialias" title="cairo_font_options_set_antialias ()"><code class="function">cairo_font_options_set_antialias()</code></a> and
104
+ <a class="link" href="cairo-font-options.html#cairo-font-options-get-antialias" title="cairo_font_options_get_antialias ()"><code class="function">cairo_font_options_get_antialias()</code></a>.
105
+ </p>
106
+ <p>
107
+ New features may be added to a <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> in the
108
+ future. For this reason, <a class="link" href="cairo-font-options.html#cairo-font-options-copy" title="cairo_font_options_copy ()"><code class="function">cairo_font_options_copy()</code></a>,
109
+ <a class="link" href="cairo-font-options.html#cairo-font-options-equal" title="cairo_font_options_equal ()"><code class="function">cairo_font_options_equal()</code></a>, <a class="link" href="cairo-font-options.html#cairo-font-options-merge" title="cairo_font_options_merge ()"><code class="function">cairo_font_options_merge()</code></a>, and
110
+ <a class="link" href="cairo-font-options.html#cairo-font-options-hash" title="cairo_font_options_hash ()"><code class="function">cairo_font_options_hash()</code></a> should be used to copy, check
111
+ for equality, merge, or compute a hash value of
112
+ <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> objects.</p>
113
+ <p>
114
+
115
+ </p>
116
+ </div>
117
+ <hr>
118
+ <div class="refsect2" lang="en">
119
+ <a name="cairo-font-options-create"></a><h3>cairo_font_options_create ()</h3>
120
+ <pre class="programlisting"><a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a>* cairo_font_options_create (void);</pre>
121
+ <p>
122
+ Allocates a new font options object with all options initialized
123
+ to default values.</p>
124
+ <p>
125
+
126
+ </p>
127
+ <div class="variablelist"><table border="0">
128
+ <col align="left" valign="top">
129
+ <tbody><tr>
130
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
131
+ <td> a newly allocated <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>. Free with
132
+ <a class="link" href="cairo-font-options.html#cairo-font-options-destroy" title="cairo_font_options_destroy ()"><code class="function">cairo_font_options_destroy()</code></a>. This function always returns a
133
+ valid pointer; if memory cannot be allocated, then a special
134
+ error object is returned where all operations on the object do nothing.
135
+ You can check for this with <a class="link" href="cairo-font-options.html#cairo-font-options-status" title="cairo_font_options_status ()"><code class="function">cairo_font_options_status()</code></a>.
136
+ </td>
137
+ </tr></tbody>
138
+ </table></div>
139
+ </div>
140
+ <hr>
141
+ <div class="refsect2" lang="en">
142
+ <a name="cairo-font-options-copy"></a><h3>cairo_font_options_copy ()</h3>
143
+ <pre class="programlisting"><a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a>* cairo_font_options_copy (const <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *original);</pre>
144
+ <p>
145
+ Allocates a new font options object copying the option values from
146
+ <em class="parameter"><code>original</code></em>.</p>
147
+ <p>
148
+
149
+ </p>
150
+ <div class="variablelist"><table border="0">
151
+ <col align="left" valign="top">
152
+ <tbody>
153
+ <tr>
154
+ <td><p><span class="term"><em class="parameter"><code>original</code></em> :</span></p></td>
155
+ <td> a <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>
156
+ </td>
157
+ </tr>
158
+ <tr>
159
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
160
+ <td> a newly allocated <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>. Free with
161
+ <a class="link" href="cairo-font-options.html#cairo-font-options-destroy" title="cairo_font_options_destroy ()"><code class="function">cairo_font_options_destroy()</code></a>. This function always returns a
162
+ valid pointer; if memory cannot be allocated, then a special
163
+ error object is returned where all operations on the object do nothing.
164
+ You can check for this with <a class="link" href="cairo-font-options.html#cairo-font-options-status" title="cairo_font_options_status ()"><code class="function">cairo_font_options_status()</code></a>.
165
+ </td>
166
+ </tr>
167
+ </tbody>
168
+ </table></div>
169
+ </div>
170
+ <hr>
171
+ <div class="refsect2" lang="en">
172
+ <a name="cairo-font-options-destroy"></a><h3>cairo_font_options_destroy ()</h3>
173
+ <pre class="programlisting">void cairo_font_options_destroy (<a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options);</pre>
174
+ <p>
175
+ Destroys a <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> object created with with
176
+ <a class="link" href="cairo-font-options.html#cairo-font-options-create" title="cairo_font_options_create ()"><code class="function">cairo_font_options_create()</code></a> or <a class="link" href="cairo-font-options.html#cairo-font-options-copy" title="cairo_font_options_copy ()"><code class="function">cairo_font_options_copy()</code></a>.</p>
177
+ <p>
178
+
179
+ </p>
180
+ <div class="variablelist"><table border="0">
181
+ <col align="left" valign="top">
182
+ <tbody><tr>
183
+ <td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
184
+ <td> a <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>
185
+ </td>
186
+ </tr></tbody>
187
+ </table></div>
188
+ </div>
189
+ <hr>
190
+ <div class="refsect2" lang="en">
191
+ <a name="cairo-font-options-status"></a><h3>cairo_font_options_status ()</h3>
192
+ <pre class="programlisting"><a class="link" href="cairo-error-status.html#cairo-status-t" title="enum cairo_status_t">cairo_status_t</a> cairo_font_options_status (<a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options);</pre>
193
+ <p>
194
+ Checks whether an error has previously occurred for this
195
+ font options object</p>
196
+ <p>
197
+
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>options</code></em> :</span></p></td>
204
+ <td> a <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>
205
+ </td>
206
+ </tr>
207
+ <tr>
208
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
209
+ <td> <a class="link" href="cairo-error-status.html#CAIRO-STATUS-SUCCESS:CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> or <a class="link" href="cairo-error-status.html#CAIRO-STATUS-NO-MEMORY:CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a>
210
+ </td>
211
+ </tr>
212
+ </tbody>
213
+ </table></div>
214
+ </div>
215
+ <hr>
216
+ <div class="refsect2" lang="en">
217
+ <a name="cairo-font-options-merge"></a><h3>cairo_font_options_merge ()</h3>
218
+ <pre class="programlisting">void cairo_font_options_merge (<a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options,
219
+ const <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *other);</pre>
220
+ <p>
221
+ Merges non-default options from <em class="parameter"><code>other</code></em> into <em class="parameter"><code>options</code></em>, replacing
222
+ existing values. This operation can be thought of as somewhat
223
+ similar to compositing <em class="parameter"><code>other</code></em> onto <em class="parameter"><code>options</code></em> with the operation
224
+ of <code class="literal">CAIRO_OPERATION_OVER</code>.</p>
225
+ <p>
226
+
227
+ </p>
228
+ <div class="variablelist"><table border="0">
229
+ <col align="left" valign="top">
230
+ <tbody>
231
+ <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-font-options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>
234
+ </td>
235
+ </tr>
236
+ <tr>
237
+ <td><p><span class="term"><em class="parameter"><code>other</code></em> :</span></p></td>
238
+ <td> another <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>
239
+ </td>
240
+ </tr>
241
+ </tbody>
242
+ </table></div>
243
+ </div>
244
+ <hr>
245
+ <div class="refsect2" lang="en">
246
+ <a name="cairo-font-options-hash"></a><h3>cairo_font_options_hash ()</h3>
247
+ <pre class="programlisting">unsigned long cairo_font_options_hash (const <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options);</pre>
248
+ <p>
249
+ Compute a hash for the font options object; this value will
250
+ be useful when storing an object containing a <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>
251
+ in a hash table.</p>
252
+ <p>
253
+
254
+ </p>
255
+ <div class="variablelist"><table border="0">
256
+ <col align="left" valign="top">
257
+ <tbody>
258
+ <tr>
259
+ <td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
260
+ <td> a <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>
261
+ </td>
262
+ </tr>
263
+ <tr>
264
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
265
+ <td> the hash value for the font options object.
266
+ The return value can be cast to a 32-bit type if a
267
+ 32-bit hash value is needed.
268
+ </td>
269
+ </tr>
270
+ </tbody>
271
+ </table></div>
272
+ </div>
273
+ <hr>
274
+ <div class="refsect2" lang="en">
275
+ <a name="cairo-font-options-equal"></a><h3>cairo_font_options_equal ()</h3>
276
+ <pre class="programlisting"><a class="link" href="cairo-types.html#cairo-bool-t" title="cairo_bool_t">cairo_bool_t</a> cairo_font_options_equal (const <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options,
277
+ const <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *other);</pre>
278
+ <p>
279
+ Compares two font options objects for equality.</p>
280
+ <p>
281
+
282
+ </p>
283
+ <div class="variablelist"><table border="0">
284
+ <col align="left" valign="top">
285
+ <tbody>
286
+ <tr>
287
+ <td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
288
+ <td> a <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>
289
+ </td>
290
+ </tr>
291
+ <tr>
292
+ <td><p><span class="term"><em class="parameter"><code>other</code></em> :</span></p></td>
293
+ <td> another <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>
294
+ </td>
295
+ </tr>
296
+ <tr>
297
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
298
+ <td> <code class="literal">TRUE</code> if all fields of the two font options objects match.
299
+ Note that this function will return <code class="literal">FALSE</code> if either object is in
300
+ error.
301
+ </td>
302
+ </tr>
303
+ </tbody>
304
+ </table></div>
305
+ </div>
306
+ <hr>
307
+ <div class="refsect2" lang="en">
308
+ <a name="cairo-font-options-set-antialias"></a><h3>cairo_font_options_set_antialias ()</h3>
309
+ <pre class="programlisting">void cairo_font_options_set_antialias (<a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options,
310
+ <a class="link" href="cairo-context.html#cairo-antialias-t" title="enum cairo_antialias_t">cairo_antialias_t</a> antialias);</pre>
311
+ <p>
312
+ Sets the antialiasing mode for the font options object. This
313
+ specifies the type of antialiasing to do when rendering text.</p>
314
+ <p>
315
+
316
+ </p>
317
+ <div class="variablelist"><table border="0">
318
+ <col align="left" valign="top">
319
+ <tbody>
320
+ <tr>
321
+ <td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
322
+ <td> a <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>
323
+ </td>
324
+ </tr>
325
+ <tr>
326
+ <td><p><span class="term"><em class="parameter"><code>antialias</code></em> :</span></p></td>
327
+ <td> the new antialiasing mode
328
+ </td>
329
+ </tr>
330
+ </tbody>
331
+ </table></div>
332
+ </div>
333
+ <hr>
334
+ <div class="refsect2" lang="en">
335
+ <a name="cairo-font-options-get-antialias"></a><h3>cairo_font_options_get_antialias ()</h3>
336
+ <pre class="programlisting"><a class="link" href="cairo-context.html#cairo-antialias-t" title="enum cairo_antialias_t">cairo_antialias_t</a> cairo_font_options_get_antialias (const <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options);</pre>
337
+ <p>
338
+ Gets the antialiasing mode for the font options object.</p>
339
+ <p>
340
+
341
+ </p>
342
+ <div class="variablelist"><table border="0">
343
+ <col align="left" valign="top">
344
+ <tbody>
345
+ <tr>
346
+ <td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
347
+ <td> a <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>
348
+ </td>
349
+ </tr>
350
+ <tr>
351
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
352
+ <td> the antialiasing mode
353
+ </td>
354
+ </tr>
355
+ </tbody>
356
+ </table></div>
357
+ </div>
358
+ <hr>
359
+ <div class="refsect2" lang="en">
360
+ <a name="cairo-subpixel-order-t"></a><h3>enum cairo_subpixel_order_t</h3>
361
+ <pre class="programlisting">typedef enum _cairo_subpixel_order {
362
+ CAIRO_SUBPIXEL_ORDER_DEFAULT,
363
+ CAIRO_SUBPIXEL_ORDER_RGB,
364
+ CAIRO_SUBPIXEL_ORDER_BGR,
365
+ CAIRO_SUBPIXEL_ORDER_VRGB,
366
+ CAIRO_SUBPIXEL_ORDER_VBGR
367
+ } cairo_subpixel_order_t;
368
+ </pre>
369
+ <p>
370
+ The subpixel order specifies the order of color elements within
371
+ each pixel on the display device when rendering with an
372
+ antialiasing mode of <a class="link" href="cairo-context.html#CAIRO-ANTIALIAS-SUBPIXEL:CAPS"><code class="literal">CAIRO_ANTIALIAS_SUBPIXEL</code></a>.</p>
373
+ <p>
374
+
375
+ </p>
376
+ <div class="variablelist"><table border="0">
377
+ <col align="left" valign="top">
378
+ <tbody>
379
+ <tr>
380
+ <td><p><a name="CAIRO-SUBPIXEL-ORDER-DEFAULT:CAPS"></a><span class="term"><code class="literal">CAIRO_SUBPIXEL_ORDER_DEFAULT</code></span></p></td>
381
+ <td> Use the default subpixel order for
382
+ for the target device
383
+ </td>
384
+ </tr>
385
+ <tr>
386
+ <td><p><a name="CAIRO-SUBPIXEL-ORDER-RGB:CAPS"></a><span class="term"><code class="literal">CAIRO_SUBPIXEL_ORDER_RGB</code></span></p></td>
387
+ <td> Subpixel elements are arranged horizontally
388
+ with red at the left
389
+ </td>
390
+ </tr>
391
+ <tr>
392
+ <td><p><a name="CAIRO-SUBPIXEL-ORDER-BGR:CAPS"></a><span class="term"><code class="literal">CAIRO_SUBPIXEL_ORDER_BGR</code></span></p></td>
393
+ <td> Subpixel elements are arranged horizontally
394
+ with blue at the left
395
+ </td>
396
+ </tr>
397
+ <tr>
398
+ <td><p><a name="CAIRO-SUBPIXEL-ORDER-VRGB:CAPS"></a><span class="term"><code class="literal">CAIRO_SUBPIXEL_ORDER_VRGB</code></span></p></td>
399
+ <td> Subpixel elements are arranged vertically
400
+ with red at the top
401
+ </td>
402
+ </tr>
403
+ <tr>
404
+ <td><p><a name="CAIRO-SUBPIXEL-ORDER-VBGR:CAPS"></a><span class="term"><code class="literal">CAIRO_SUBPIXEL_ORDER_VBGR</code></span></p></td>
405
+ <td> Subpixel elements are arranged vertically
406
+ with blue at the top
407
+ </td>
408
+ </tr>
409
+ </tbody>
410
+ </table></div>
411
+ </div>
412
+ <hr>
413
+ <div class="refsect2" lang="en">
414
+ <a name="cairo-font-options-set-subpixel-order"></a><h3>cairo_font_options_set_subpixel_order ()</h3>
415
+ <pre class="programlisting">void cairo_font_options_set_subpixel_order
416
+ (<a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options,
417
+ <a class="link" href="cairo-font-options.html#cairo-subpixel-order-t" title="enum cairo_subpixel_order_t">cairo_subpixel_order_t</a> subpixel_order);</pre>
418
+ <p>
419
+ Sets the subpixel order for the font options object. The subpixel
420
+ order specifies the order of color elements within each pixel on
421
+ the display device when rendering with an antialiasing mode of
422
+ <a class="link" href="cairo-context.html#CAIRO-ANTIALIAS-SUBPIXEL:CAPS"><code class="literal">CAIRO_ANTIALIAS_SUBPIXEL</code></a>. See the documentation for
423
+ <a class="link" href="cairo-font-options.html#cairo-subpixel-order-t" title="enum cairo_subpixel_order_t"><span class="type">cairo_subpixel_order_t</span></a> for full details.</p>
424
+ <p>
425
+
426
+ </p>
427
+ <div class="variablelist"><table border="0">
428
+ <col align="left" valign="top">
429
+ <tbody>
430
+ <tr>
431
+ <td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
432
+ <td> a <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>
433
+ </td>
434
+ </tr>
435
+ <tr>
436
+ <td><p><span class="term"><em class="parameter"><code>subpixel_order</code></em> :</span></p></td>
437
+ <td> the new subpixel order
438
+ </td>
439
+ </tr>
440
+ </tbody>
441
+ </table></div>
442
+ </div>
443
+ <hr>
444
+ <div class="refsect2" lang="en">
445
+ <a name="cairo-font-options-get-subpixel-order"></a><h3>cairo_font_options_get_subpixel_order ()</h3>
446
+ <pre class="programlisting"><a class="link" href="cairo-font-options.html#cairo-subpixel-order-t" title="enum cairo_subpixel_order_t">cairo_subpixel_order_t</a> cairo_font_options_get_subpixel_order
447
+ (const <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options);</pre>
448
+ <p>
449
+ Gets the subpixel order for the font options object.
450
+ See the documentation for <a class="link" href="cairo-font-options.html#cairo-subpixel-order-t" title="enum cairo_subpixel_order_t"><span class="type">cairo_subpixel_order_t</span></a> for full details.</p>
451
+ <p>
452
+
453
+ </p>
454
+ <div class="variablelist"><table border="0">
455
+ <col align="left" valign="top">
456
+ <tbody>
457
+ <tr>
458
+ <td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
459
+ <td> a <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>
460
+ </td>
461
+ </tr>
462
+ <tr>
463
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
464
+ <td> the subpixel order for the font options object
465
+ </td>
466
+ </tr>
467
+ </tbody>
468
+ </table></div>
469
+ </div>
470
+ <hr>
471
+ <div class="refsect2" lang="en">
472
+ <a name="cairo-hint-style-t"></a><h3>enum cairo_hint_style_t</h3>
473
+ <pre class="programlisting">typedef enum _cairo_hint_style {
474
+ CAIRO_HINT_STYLE_DEFAULT,
475
+ CAIRO_HINT_STYLE_NONE,
476
+ CAIRO_HINT_STYLE_SLIGHT,
477
+ CAIRO_HINT_STYLE_MEDIUM,
478
+ CAIRO_HINT_STYLE_FULL
479
+ } cairo_hint_style_t;
480
+ </pre>
481
+ <p>
482
+ Specifies the type of hinting to do on font outlines. Hinting
483
+ is the process of fitting outlines to the pixel grid in order
484
+ to improve the appearance of the result. Since hinting outlines
485
+ involves distorting them, it also reduces the faithfulness
486
+ to the original outline shapes. Not all of the outline hinting
487
+ styles are supported by all font backends.
488
+ </p>
489
+ <p>
490
+ New entries may be added in future versions.</p>
491
+ <p>
492
+
493
+ </p>
494
+ <div class="variablelist"><table border="0">
495
+ <col align="left" valign="top">
496
+ <tbody>
497
+ <tr>
498
+ <td><p><a name="CAIRO-HINT-STYLE-DEFAULT:CAPS"></a><span class="term"><code class="literal">CAIRO_HINT_STYLE_DEFAULT</code></span></p></td>
499
+ <td> Use the default hint style for
500
+ font backend and target device
501
+ </td>
502
+ </tr>
503
+ <tr>
504
+ <td><p><a name="CAIRO-HINT-STYLE-NONE:CAPS"></a><span class="term"><code class="literal">CAIRO_HINT_STYLE_NONE</code></span></p></td>
505
+ <td> Do not hint outlines
506
+ </td>
507
+ </tr>
508
+ <tr>
509
+ <td><p><a name="CAIRO-HINT-STYLE-SLIGHT:CAPS"></a><span class="term"><code class="literal">CAIRO_HINT_STYLE_SLIGHT</code></span></p></td>
510
+ <td> Hint outlines slightly to improve
511
+ contrast while retaining good fidelity to the original
512
+ shapes.
513
+ </td>
514
+ </tr>
515
+ <tr>
516
+ <td><p><a name="CAIRO-HINT-STYLE-MEDIUM:CAPS"></a><span class="term"><code class="literal">CAIRO_HINT_STYLE_MEDIUM</code></span></p></td>
517
+ <td> Hint outlines with medium strength
518
+ giving a compromise between fidelity to the original shapes
519
+ and contrast
520
+ </td>
521
+ </tr>
522
+ <tr>
523
+ <td><p><a name="CAIRO-HINT-STYLE-FULL:CAPS"></a><span class="term"><code class="literal">CAIRO_HINT_STYLE_FULL</code></span></p></td>
524
+ <td> Hint outlines to maximize contrast
525
+ </td>
526
+ </tr>
527
+ </tbody>
528
+ </table></div>
529
+ </div>
530
+ <hr>
531
+ <div class="refsect2" lang="en">
532
+ <a name="cairo-font-options-set-hint-style"></a><h3>cairo_font_options_set_hint_style ()</h3>
533
+ <pre class="programlisting">void cairo_font_options_set_hint_style (<a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options,
534
+ <a class="link" href="cairo-font-options.html#cairo-hint-style-t" title="enum cairo_hint_style_t">cairo_hint_style_t</a> hint_style);</pre>
535
+ <p>
536
+ Sets the hint style for font outlines for the font options object.
537
+ This controls whether to fit font outlines to the pixel grid,
538
+ and if so, whether to optimize for fidelity or contrast.
539
+ See the documentation for <a class="link" href="cairo-font-options.html#cairo-hint-style-t" title="enum cairo_hint_style_t"><span class="type">cairo_hint_style_t</span></a> for full details.</p>
540
+ <p>
541
+
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>options</code></em> :</span></p></td>
548
+ <td> a <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>
549
+ </td>
550
+ </tr>
551
+ <tr>
552
+ <td><p><span class="term"><em class="parameter"><code>hint_style</code></em> :</span></p></td>
553
+ <td> the new hint style
554
+ </td>
555
+ </tr>
556
+ </tbody>
557
+ </table></div>
558
+ </div>
559
+ <hr>
560
+ <div class="refsect2" lang="en">
561
+ <a name="cairo-font-options-get-hint-style"></a><h3>cairo_font_options_get_hint_style ()</h3>
562
+ <pre class="programlisting"><a class="link" href="cairo-font-options.html#cairo-hint-style-t" title="enum cairo_hint_style_t">cairo_hint_style_t</a> cairo_font_options_get_hint_style (const <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options);</pre>
563
+ <p>
564
+ Gets the hint style for font outlines for the font options object.
565
+ See the documentation for <a class="link" href="cairo-font-options.html#cairo-hint-style-t" title="enum cairo_hint_style_t"><span class="type">cairo_hint_style_t</span></a> for full details.</p>
566
+ <p>
567
+
568
+ </p>
569
+ <div class="variablelist"><table border="0">
570
+ <col align="left" valign="top">
571
+ <tbody>
572
+ <tr>
573
+ <td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
574
+ <td> a <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>
575
+ </td>
576
+ </tr>
577
+ <tr>
578
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
579
+ <td> the hint style for the font options object
580
+ </td>
581
+ </tr>
582
+ </tbody>
583
+ </table></div>
584
+ </div>
585
+ <hr>
586
+ <div class="refsect2" lang="en">
587
+ <a name="cairo-hint-metrics-t"></a><h3>enum cairo_hint_metrics_t</h3>
588
+ <pre class="programlisting">typedef enum _cairo_hint_metrics {
589
+ CAIRO_HINT_METRICS_DEFAULT,
590
+ CAIRO_HINT_METRICS_OFF,
591
+ CAIRO_HINT_METRICS_ON
592
+ } cairo_hint_metrics_t;
593
+ </pre>
594
+ <p>
595
+ Specifies whether to hint font metrics; hinting font metrics
596
+ means quantizing them so that they are integer values in
597
+ device space. Doing this improves the consistency of
598
+ letter and line spacing, however it also means that text
599
+ will be laid out differently at different zoom factors.</p>
600
+ <p>
601
+
602
+ </p>
603
+ <div class="variablelist"><table border="0">
604
+ <col align="left" valign="top">
605
+ <tbody>
606
+ <tr>
607
+ <td><p><a name="CAIRO-HINT-METRICS-DEFAULT:CAPS"></a><span class="term"><code class="literal">CAIRO_HINT_METRICS_DEFAULT</code></span></p></td>
608
+ <td> Hint metrics in the default
609
+ manner for the font backend and target device
610
+ </td>
611
+ </tr>
612
+ <tr>
613
+ <td><p><a name="CAIRO-HINT-METRICS-OFF:CAPS"></a><span class="term"><code class="literal">CAIRO_HINT_METRICS_OFF</code></span></p></td>
614
+ <td> Do not hint font metrics
615
+ </td>
616
+ </tr>
617
+ <tr>
618
+ <td><p><a name="CAIRO-HINT-METRICS-ON:CAPS"></a><span class="term"><code class="literal">CAIRO_HINT_METRICS_ON</code></span></p></td>
619
+ <td> Hint font metrics
620
+ </td>
621
+ </tr>
622
+ </tbody>
623
+ </table></div>
624
+ </div>
625
+ <hr>
626
+ <div class="refsect2" lang="en">
627
+ <a name="cairo-font-options-set-hint-metrics"></a><h3>cairo_font_options_set_hint_metrics ()</h3>
628
+ <pre class="programlisting">void cairo_font_options_set_hint_metrics (<a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options,
629
+ <a class="link" href="cairo-font-options.html#cairo-hint-metrics-t" title="enum cairo_hint_metrics_t">cairo_hint_metrics_t</a> hint_metrics);</pre>
630
+ <p>
631
+ Sets the metrics hinting mode for the font options object. This
632
+ controls whether metrics are quantized to integer values in
633
+ device units.
634
+ See the documentation for <a class="link" href="cairo-font-options.html#cairo-hint-metrics-t" title="enum cairo_hint_metrics_t"><span class="type">cairo_hint_metrics_t</span></a> for full details.</p>
635
+ <p>
636
+
637
+ </p>
638
+ <div class="variablelist"><table border="0">
639
+ <col align="left" valign="top">
640
+ <tbody>
641
+ <tr>
642
+ <td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
643
+ <td> a <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>
644
+ </td>
645
+ </tr>
646
+ <tr>
647
+ <td><p><span class="term"><em class="parameter"><code>hint_metrics</code></em> :</span></p></td>
648
+ <td> the new metrics hinting mode
649
+ </td>
650
+ </tr>
651
+ </tbody>
652
+ </table></div>
653
+ </div>
654
+ <hr>
655
+ <div class="refsect2" lang="en">
656
+ <a name="cairo-font-options-get-hint-metrics"></a><h3>cairo_font_options_get_hint_metrics ()</h3>
657
+ <pre class="programlisting"><a class="link" href="cairo-font-options.html#cairo-hint-metrics-t" title="enum cairo_hint_metrics_t">cairo_hint_metrics_t</a> cairo_font_options_get_hint_metrics
658
+ (const <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options);</pre>
659
+ <p>
660
+ Gets the metrics hinting mode for the font options object.
661
+ See the documentation for <a class="link" href="cairo-font-options.html#cairo-hint-metrics-t" title="enum cairo_hint_metrics_t"><span class="type">cairo_hint_metrics_t</span></a> for full details.</p>
662
+ <p>
663
+
664
+ </p>
665
+ <div class="variablelist"><table border="0">
666
+ <col align="left" valign="top">
667
+ <tbody>
668
+ <tr>
669
+ <td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
670
+ <td> a <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>
671
+ </td>
672
+ </tr>
673
+ <tr>
674
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
675
+ <td> the metrics hinting mode for the font options object
676
+ </td>
677
+ </tr>
678
+ </tbody>
679
+ </table></div>
680
+ </div>
681
+ </div>
682
+ <div class="refsect1" lang="en">
683
+ <a name="cairo-font-options.see-also"></a><h2>See Also</h2>
684
+ <p>
685
+ </p>
686
+ <div class="itemizedlist"><ul type="disc"><li><a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t"><span class="type">cairo_scaled_font_t</span></a></li></ul></div>
687
+ <p>
688
+ </p>
689
+ </div>
690
+ </div>
691
+ <div class="footer">
692
+ <hr>
693
+ Generated by GTK-Doc V1.10</div>
694
+ </body>
695
+ </html>