cairo 1.8.3-x86-mingw32 → 1.8.4-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 (126) hide show
  1. data/NEWS +14 -0
  2. data/Rakefile +2 -2
  3. data/ext/cairo/rb_cairo.c +1 -1
  4. data/extconf.rb +11 -11
  5. data/home/kou/work/ruby/rcairo.win32/vendor/local/bin/freetype6.dll +0 -0
  6. data/home/kou/work/ruby/rcairo.win32/vendor/local/bin/libcairo-2.dll +0 -0
  7. data/home/kou/work/ruby/rcairo.win32/vendor/local/bin/libfontconfig-1.dll +0 -0
  8. data/home/kou/work/ruby/rcairo.win32/vendor/local/bin/libpng14-14.dll +0 -0
  9. data/home/kou/work/ruby/rcairo.win32/vendor/local/bin/zlib1.dll +0 -0
  10. data/home/kou/work/ruby/rcairo.win32/vendor/local/etc/fonts/fonts.conf +151 -0
  11. data/home/kou/work/ruby/rcairo.win32/vendor/local/include/cairo/cairo-deprecated.h +138 -0
  12. data/home/kou/work/ruby/rcairo.win32/vendor/local/include/cairo/cairo-features.h +20 -0
  13. data/home/kou/work/ruby/rcairo.win32/vendor/local/include/cairo/cairo-ft.h +75 -0
  14. data/home/kou/work/ruby/rcairo.win32/vendor/local/include/cairo/cairo-pdf.h +68 -0
  15. data/home/kou/work/ruby/rcairo.win32/vendor/local/include/cairo/cairo-ps.h +114 -0
  16. data/home/kou/work/ruby/rcairo.win32/vendor/local/include/cairo/cairo-svg.h +82 -0
  17. data/home/kou/work/ruby/rcairo.win32/vendor/local/include/cairo/cairo-version.h +8 -0
  18. data/home/kou/work/ruby/rcairo.win32/vendor/local/include/cairo/cairo-win32.h +112 -0
  19. data/home/kou/work/ruby/rcairo.win32/vendor/local/include/cairo/cairo.h +2328 -0
  20. data/home/kou/work/ruby/rcairo.win32/vendor/local/include/libpng14/png.h +2701 -0
  21. data/home/kou/work/ruby/rcairo.win32/vendor/local/include/libpng14/pngconf.h +1525 -0
  22. data/home/kou/work/ruby/rcairo.win32/vendor/local/include/png.h +2701 -0
  23. data/home/kou/work/ruby/rcairo.win32/vendor/local/include/pngconf.h +1525 -0
  24. data/home/kou/work/ruby/rcairo.win32/vendor/local/include/zconf.h +461 -0
  25. data/home/kou/work/ruby/rcairo.win32/vendor/local/include/zlib.h +1589 -0
  26. data/home/kou/work/ruby/rcairo.win32/vendor/local/lib/cairo.def +278 -0
  27. data/home/kou/work/ruby/rcairo.win32/vendor/local/lib/cairo.lib +0 -0
  28. data/home/kou/work/ruby/rcairo.win32/vendor/local/lib/libcairo.dll.a +0 -0
  29. data/home/kou/work/ruby/rcairo.win32/vendor/local/lib/libpng.def +192 -0
  30. data/home/kou/work/ruby/rcairo.win32/vendor/local/lib/libpng.lib +0 -0
  31. data/home/kou/work/ruby/rcairo.win32/vendor/local/lib/libpng14.dll.a +0 -0
  32. data/home/kou/work/ruby/rcairo.win32/vendor/local/lib/libz.dll.a +0 -0
  33. data/home/kou/work/ruby/rcairo.win32/vendor/local/lib/pkgconfig/cairo-ft.pc +12 -0
  34. data/home/kou/work/ruby/rcairo.win32/vendor/local/lib/pkgconfig/cairo-pdf.pc +12 -0
  35. data/home/kou/work/ruby/rcairo.win32/vendor/local/lib/pkgconfig/cairo-png.pc +12 -0
  36. data/home/kou/work/ruby/rcairo.win32/vendor/local/lib/pkgconfig/cairo-ps.pc +12 -0
  37. data/home/kou/work/ruby/rcairo.win32/vendor/local/lib/pkgconfig/cairo-svg.pc +12 -0
  38. data/home/kou/work/ruby/rcairo.win32/vendor/local/lib/pkgconfig/cairo-win32-font.pc +12 -0
  39. data/home/kou/work/ruby/rcairo.win32/vendor/local/lib/pkgconfig/cairo-win32.pc +12 -0
  40. data/home/kou/work/ruby/rcairo.win32/vendor/local/lib/pkgconfig/cairo.pc +13 -0
  41. data/home/kou/work/ruby/rcairo.win32/vendor/local/lib/pkgconfig/libpng.pc +11 -0
  42. data/home/kou/work/ruby/rcairo.win32/vendor/local/lib/pkgconfig/libpng14.pc +11 -0
  43. data/home/kou/work/ruby/rcairo.win32/vendor/local/lib/zdll.lib +0 -0
  44. data/home/kou/work/ruby/rcairo.win32/vendor/local/lib/zlib.def +67 -0
  45. data/home/kou/work/ruby/rcairo.win32/vendor/local/manifest/cairo-dev_1.8.10-4_win32.mft +76 -0
  46. data/home/kou/work/ruby/rcairo.win32/vendor/local/manifest/cairo_1.8.10-4_win32.mft +5 -0
  47. data/home/kou/work/ruby/rcairo.win32/vendor/local/manifest/fontconfig_2.8.0-2_win32.mft +3 -0
  48. data/home/kou/work/ruby/rcairo.win32/vendor/local/manifest/freetype_2.4.2-1_win32.mft +2 -0
  49. data/home/kou/work/ruby/rcairo.win32/vendor/local/manifest/libpng-dev_1.4.3-1_win32.mft +15 -0
  50. data/home/kou/work/ruby/rcairo.win32/vendor/local/manifest/libpng_1.4.3-1_win32.mft +2 -0
  51. data/home/kou/work/ruby/rcairo.win32/vendor/local/manifest/zlib-dev_1.2.5-2_win32.mft +8 -0
  52. data/home/kou/work/ruby/rcairo.win32/vendor/local/manifest/zlib_1.2.5-2_win32.mft +2 -0
  53. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/doc/cairo_1.8.10-4_win32/COPYING +32 -0
  54. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/doc/cairo_1.8.10-4_win32/COPYING-LGPL-2.1 +510 -0
  55. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/doc/cairo_1.8.10-4_win32/COPYING-MPL-1.1 +470 -0
  56. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/bindings-errors.html +132 -0
  57. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/bindings-fonts.html +63 -0
  58. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/bindings-memory.html +133 -0
  59. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/bindings-overloading.html +131 -0
  60. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/bindings-path.html +127 -0
  61. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/bindings-patterns.html +67 -0
  62. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/bindings-return-values.html +130 -0
  63. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/bindings-streams.html +102 -0
  64. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/bindings-surfaces.html +103 -0
  65. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/cairo-context.html +2643 -0
  66. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/cairo-drawing.html +57 -0
  67. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/cairo-error-status.html +360 -0
  68. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/cairo-font-face.html +408 -0
  69. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/cairo-font-options.html +678 -0
  70. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/cairo-fonts.html +63 -0
  71. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/cairo-ft-font.html +319 -0
  72. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/cairo-image-surface.html +473 -0
  73. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/cairo-matrix.html +596 -0
  74. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/cairo-paths.html +1274 -0
  75. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/cairo-pattern.html +1485 -0
  76. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/cairo-pdf-surface.html +238 -0
  77. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/cairo-png-functions.html +341 -0
  78. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/cairo-ps-surface.html +622 -0
  79. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/cairo-quartz-font.html +151 -0
  80. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/cairo-quartz-surface.html +219 -0
  81. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/cairo-scaled-font.html +1023 -0
  82. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/cairo-support.html +54 -0
  83. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/cairo-surface.html +1026 -0
  84. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/cairo-surfaces.html +69 -0
  85. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/cairo-svg-surface.html +321 -0
  86. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/cairo-text.html +1222 -0
  87. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/cairo-transformations.html +436 -0
  88. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/cairo-types.html +133 -0
  89. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/cairo-user-font.html +735 -0
  90. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/cairo-version-info.html +345 -0
  91. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/cairo-win32-font.html +358 -0
  92. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/cairo-win32-surface.html +312 -0
  93. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/cairo-xlib-surface.html +492 -0
  94. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/cairo.devhelp +417 -0
  95. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/cairo.devhelp2 +542 -0
  96. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/home.png +0 -0
  97. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/index-1.2.html +141 -0
  98. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/index-1.4.html +109 -0
  99. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/index-1.6.html +71 -0
  100. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/index-1.8.html +107 -0
  101. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/index-all.html +759 -0
  102. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/index.html +144 -0
  103. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/index.sgml +478 -0
  104. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/language-bindings.html +83 -0
  105. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/left.png +0 -0
  106. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/right.png +0 -0
  107. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/style.css +167 -0
  108. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/gtk-doc/html/cairo/up.png +0 -0
  109. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/man/man3/libpng.3 +4455 -0
  110. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/man/man3/libpngpf.3 +808 -0
  111. data/home/kou/work/ruby/rcairo.win32/vendor/local/share/man/man5/png.5 +74 -0
  112. data/home/kou/work/ruby/rcairo.win32/vendor/local/src/tml/packaging/cairo_1.8.10-4_win32.log +920 -0
  113. data/home/kou/work/ruby/rcairo.win32/vendor/local/src/tml/packaging/cairo_1.8.10-4_win32.sh +76 -0
  114. data/home/kou/work/ruby/rcairo.win32/vendor/local/src/tml/packaging/libpng_1.4.3-1_win32.log +272 -0
  115. data/home/kou/work/ruby/rcairo.win32/vendor/local/src/tml/packaging/libpng_1.4.3-1_win32.sh +71 -0
  116. data/home/kou/work/ruby/rcairo.win32/vendor/local/src/tml/packaging/zlib_1.2.5-2_win32.log +42 -0
  117. data/home/kou/work/ruby/rcairo.win32/vendor/local/src/tml/packaging/zlib_1.2.5-2_win32.sh +189 -0
  118. data/lib/1.8/cairo.so +0 -0
  119. data/lib/1.9/cairo.so +0 -0
  120. data/tmp/{x86-mingw32 → i386-mingw32}/cairo/1.8.7/fake.rb +0 -0
  121. data/tmp/{x86-mingw32 → i386-mingw32}/cairo/1.8.7/mkmf.rb +0 -0
  122. data/tmp/{x86-mingw32 → i386-mingw32}/cairo/1.8.7/rbconfig.rb +0 -0
  123. data/tmp/{x86-mingw32 → i386-mingw32}/cairo/1.9.2/fake.rb +0 -0
  124. data/tmp/{x86-mingw32 → i386-mingw32}/cairo/1.9.2/mkmf.rb +0 -0
  125. data/tmp/{x86-mingw32 → i386-mingw32}/cairo/1.9.2/rbconfig.rb +1 -1
  126. metadata +126 -40
@@ -0,0 +1,345 @@
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>Version Information</title>
6
+ <meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
7
+ <link rel="home" href="index.html" title="Cairo: A Vector Graphics Library">
8
+ <link rel="up" href="cairo-support.html" title="Utilities">
9
+ <link rel="prev" href="cairo-error-status.html" title="Error handling">
10
+ <link rel="next" href="cairo-types.html" title="Types">
11
+ <meta name="generator" content="GTK-Doc V1.11 (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-error-status.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
28
+ <td><a accesskey="u" href="cairo-support.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-types.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
32
+ </tr>
33
+ <tr><td colspan="5" class="shortcuts">
34
+ <a href="#cairo-version-info.synopsis" class="shortcut">Top</a>
35
+  | 
36
+ <a href="#cairo-version-info.description" class="shortcut">Description</a>
37
+ </td></tr>
38
+ </table>
39
+ <div class="refentry" title="Version Information">
40
+ <a name="cairo-version-info"></a><div class="titlepage"></div>
41
+ <div class="refnamediv"><table width="100%"><tr>
42
+ <td valign="top">
43
+ <h2><span class="refentrytitle"><a name="cairo-version-info.top_of_page"></a>Version Information</span></h2>
44
+ <p>Version Information — Compile-time and run-time version checks.</p>
45
+ </td>
46
+ <td valign="top" align="right"></td>
47
+ </tr></table></div>
48
+ <div class="refsynopsisdiv" title="Synopsis">
49
+ <a name="cairo-version-info.synopsis"></a><h2>Synopsis</h2>
50
+ <pre class="synopsis">
51
+ #define <a class="link" href="cairo-version-info.html#CAIRO-VERSION--CAPS" title="CAIRO_VERSION">CAIRO_VERSION</a>
52
+ #define <a class="link" href="cairo-version-info.html#CAIRO-VERSION-MAJOR--CAPS" title="CAIRO_VERSION_MAJOR">CAIRO_VERSION_MAJOR</a>
53
+ #define <a class="link" href="cairo-version-info.html#CAIRO-VERSION-MINOR--CAPS" title="CAIRO_VERSION_MINOR">CAIRO_VERSION_MINOR</a>
54
+ #define <a class="link" href="cairo-version-info.html#CAIRO-VERSION-MICRO--CAPS" title="CAIRO_VERSION_MICRO">CAIRO_VERSION_MICRO</a>
55
+ #define <a class="link" href="cairo-version-info.html#CAIRO-VERSION-STRING--CAPS" title="CAIRO_VERSION_STRING">CAIRO_VERSION_STRING</a>
56
+ #define <a class="link" href="cairo-version-info.html#CAIRO-VERSION-ENCODE--CAPS" title="CAIRO_VERSION_ENCODE()">CAIRO_VERSION_ENCODE</a> (major, minor, micro)
57
+ #define <a class="link" href="cairo-version-info.html#CAIRO-VERSION-STRINGIZE--CAPS" title="CAIRO_VERSION_STRINGIZE()">CAIRO_VERSION_STRINGIZE</a> (major, minor, micro)
58
+ int <a class="link" href="cairo-version-info.html#cairo-version" title="cairo_version ()">cairo_version</a> (void);
59
+ const char * <a class="link" href="cairo-version-info.html#cairo-version-string" title="cairo_version_string ()">cairo_version_string</a> (void);
60
+ </pre>
61
+ </div>
62
+ <div class="refsect1" title="Description">
63
+ <a name="cairo-version-info.description"></a><h2>Description</h2>
64
+ <p>
65
+ Cairo has a three-part version number scheme. In this scheme, we use
66
+ even vs. odd numbers to distinguish fixed points in the software
67
+ vs. in-progress development, (such as from git instead of a tar file,
68
+ or as a "snapshot" tar file as opposed to a "release" tar file).
69
+ </p>
70
+ <p>
71
+ </p>
72
+ <div class="informalexample"><pre class="programlisting">
73
+ _____ Major. Always 1, until we invent a new scheme.
74
+ / ___ Minor. Even/Odd = Release/Snapshot (tar files) or Branch/Head (git)
75
+ | / _ Micro. Even/Odd = Tar-file/git
76
+ | | /
77
+ 1.0.0
78
+ </pre></div>
79
+ <p>
80
+ </p>
81
+ <p>
82
+ Here are a few examples of versions that one might see.
83
+ </p>
84
+ <div class="informalexample"><pre class="programlisting">
85
+ Releases
86
+ --------
87
+ 1.0.0 - A major release
88
+ 1.0.2 - A subsequent maintenance release
89
+ 1.2.0 - Another major release
90
+ Snapshots
91
+ ---------
92
+ 1.1.2 - A snapshot (working toward the 1.2.0 release)
93
+ In-progress development (eg. from git)
94
+ --------------------------------------
95
+ 1.0.1 - Development on a maintenance branch (toward 1.0.2 release)
96
+ 1.1.1 - Development on head (toward 1.1.2 snapshot and 1.2.0 release)
97
+ </pre></div>
98
+ <p>
99
+ </p>
100
+ <div class="refsect2" title="Compatibility">
101
+ <a name="id2663590"></a><h3>Compatibility</h3>
102
+ <p>
103
+ The API/ABI compatibility guarantees for various versions are as
104
+ follows. First, let's assume some cairo-using application code that is
105
+ successfully using the API/ABI "from" one version of cairo. Then let's
106
+ ask the question whether this same code can be moved "to" the API/ABI
107
+ of another version of cairo.
108
+ </p>
109
+ <p>
110
+ Moving from a release to any later version (release, snapshot,
111
+ development) is always guaranteed to provide compatibility.
112
+ </p>
113
+ <p>
114
+ Moving from a snapshot to any later version is not guaranteed to
115
+ provide compatibility, since snapshots may introduce new API that ends
116
+ up being removed before the next release.
117
+ </p>
118
+ <p>
119
+ Moving from an in-development version (odd micro component) to any
120
+ later version is not guaranteed to provide compatibility. In fact,
121
+ there's not even a guarantee that the code will even continue to work
122
+ with the same in-development version number. This is because these
123
+ numbers don't correspond to any fixed state of the software, but
124
+ rather the many states between snapshots and releases.
125
+ </p>
126
+ </div>
127
+ <hr>
128
+ <div class="refsect2" title="Examining the version">
129
+ <a name="id2663629"></a><h3>Examining the version</h3>
130
+ <p>
131
+ Cairo provides the ability to examine the version at either
132
+ compile-time or run-time and in both a human-readable form as well as
133
+ an encoded form suitable for direct comparison. Cairo also provides the
134
+ macro <a class="link" href="cairo-version-info.html#CAIRO-VERSION-ENCODE--CAPS" title="CAIRO_VERSION_ENCODE()"><code class="function">CAIRO_VERSION_ENCODE()</code></a> to perform the encoding.
135
+ </p>
136
+ <p>
137
+ </p>
138
+ <div class="informalexample"><pre class="programlisting">
139
+ Compile-time
140
+ ------------
141
+ CAIRO_VERSION_STRING Human-readable
142
+ CAIRO_VERSION Encoded, suitable for comparison
143
+ Run-time
144
+ --------
145
+ cairo_version_string() Human-readable
146
+ cairo_version() Encoded, suitable for comparison
147
+ </pre></div>
148
+ <p>
149
+ </p>
150
+ <p>
151
+ For example, checking that the cairo version is greater than or equal
152
+ to 1.0.0 could be achieved at compile-time or run-time as follows:
153
+ </p>
154
+ <div class="informalexample"><pre class="programlisting">
155
+ ##if CAIRO_VERSION &gt;= CAIRO_VERSION_ENCODE(1, 0, 0)
156
+ printf ("Compiling with suitable cairo version: %s\n", %CAIRO_VERSION_STRING);
157
+ ##endif
158
+ if (cairo_version() &gt;= CAIRO_VERSION_ENCODE(1, 0, 0))
159
+ printf ("Running with suitable cairo version: %s\n", cairo_version_string ());
160
+ </pre></div>
161
+ <p>
162
+ </p>
163
+ </div>
164
+ </div>
165
+ <div class="refsect1" title="Details">
166
+ <a name="cairo-version-info.details"></a><h2>Details</h2>
167
+ <div class="refsect2" title="CAIRO_VERSION">
168
+ <a name="CAIRO-VERSION--CAPS"></a><h3>CAIRO_VERSION</h3>
169
+ <pre class="programlisting">#define CAIRO_VERSION</pre>
170
+ <p>
171
+ The version of cairo available at compile-time, encoded using
172
+ <a class="link" href="cairo-version-info.html#CAIRO-VERSION-ENCODE--CAPS" title="CAIRO_VERSION_ENCODE()"><code class="function">CAIRO_VERSION_ENCODE()</code></a>.
173
+ </p>
174
+ </div>
175
+ <hr>
176
+ <div class="refsect2" title="CAIRO_VERSION_MAJOR">
177
+ <a name="CAIRO-VERSION-MAJOR--CAPS"></a><h3>CAIRO_VERSION_MAJOR</h3>
178
+ <pre class="programlisting">#define CAIRO_VERSION_MAJOR USE_cairo_version_OR_cairo_version_string_INSTEAD
179
+ </pre>
180
+ <p>
181
+ The major component of the version of cairo available at compile-time.
182
+ </p>
183
+ </div>
184
+ <hr>
185
+ <div class="refsect2" title="CAIRO_VERSION_MINOR">
186
+ <a name="CAIRO-VERSION-MINOR--CAPS"></a><h3>CAIRO_VERSION_MINOR</h3>
187
+ <pre class="programlisting">#define CAIRO_VERSION_MINOR USE_cairo_version_OR_cairo_version_string_INSTEAD
188
+ </pre>
189
+ <p>
190
+ The minor component of the version of cairo available at compile-time.
191
+ </p>
192
+ </div>
193
+ <hr>
194
+ <div class="refsect2" title="CAIRO_VERSION_MICRO">
195
+ <a name="CAIRO-VERSION-MICRO--CAPS"></a><h3>CAIRO_VERSION_MICRO</h3>
196
+ <pre class="programlisting">#define CAIRO_VERSION_MICRO USE_cairo_version_OR_cairo_version_string_INSTEAD
197
+ </pre>
198
+ <p>
199
+ The micro component of the version of cairo available at compile-time.
200
+ </p>
201
+ </div>
202
+ <hr>
203
+ <div class="refsect2" title="CAIRO_VERSION_STRING">
204
+ <a name="CAIRO-VERSION-STRING--CAPS"></a><h3>CAIRO_VERSION_STRING</h3>
205
+ <pre class="programlisting">#define CAIRO_VERSION_STRING</pre>
206
+ <p>
207
+ A human-readable string literal containing the version of cairo available
208
+ at compile-time, in the form of "X.Y.Z".
209
+ </p>
210
+ </div>
211
+ <hr>
212
+ <div class="refsect2" title="CAIRO_VERSION_ENCODE()">
213
+ <a name="CAIRO-VERSION-ENCODE--CAPS"></a><h3>CAIRO_VERSION_ENCODE()</h3>
214
+ <pre class="programlisting">#define CAIRO_VERSION_ENCODE(major, minor, micro)</pre>
215
+ <p>
216
+ This macro encodes the given cairo version into an integer. The numbers
217
+ returned by <a class="link" href="cairo-version-info.html#CAIRO-VERSION--CAPS" title="CAIRO_VERSION"><code class="literal">CAIRO_VERSION</code></a> and <a class="link" href="cairo-version-info.html#cairo-version" title="cairo_version ()"><code class="function">cairo_version()</code></a> are encoded using this macro.
218
+ Two encoded version numbers can be compared as integers. The encoding ensures
219
+ that later versions compare greater than earlier versions.
220
+ </p>
221
+ <div class="variablelist"><table border="0">
222
+ <col align="left" valign="top">
223
+ <tbody>
224
+ <tr>
225
+ <td><p><span class="term"><em class="parameter"><code>major</code></em> :</span></p></td>
226
+ <td>the major component of the version number
227
+ </td>
228
+ </tr>
229
+ <tr>
230
+ <td><p><span class="term"><em class="parameter"><code>minor</code></em> :</span></p></td>
231
+ <td>the minor component of the version number
232
+ </td>
233
+ </tr>
234
+ <tr>
235
+ <td><p><span class="term"><em class="parameter"><code>micro</code></em> :</span></p></td>
236
+ <td>the micro component of the version number
237
+ </td>
238
+ </tr>
239
+ <tr>
240
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
241
+ <td>the encoded version.
242
+ </td>
243
+ </tr>
244
+ </tbody>
245
+ </table></div>
246
+ </div>
247
+ <hr>
248
+ <div class="refsect2" title="CAIRO_VERSION_STRINGIZE()">
249
+ <a name="CAIRO-VERSION-STRINGIZE--CAPS"></a><h3>CAIRO_VERSION_STRINGIZE()</h3>
250
+ <pre class="programlisting">#define CAIRO_VERSION_STRINGIZE(major, minor, micro)</pre>
251
+ <p>
252
+ This macro encodes the given cairo version into an string. The numbers
253
+ returned by <a class="link" href="cairo-version-info.html#CAIRO-VERSION-STRING--CAPS" title="CAIRO_VERSION_STRING"><code class="literal">CAIRO_VERSION_STRING</code></a> and <a class="link" href="cairo-version-info.html#cairo-version-string" title="cairo_version_string ()"><code class="function">cairo_version_string()</code></a> are encoded using this macro.
254
+ The parameters to this macro must expand to numerical literals.
255
+ </p>
256
+ <div class="variablelist"><table border="0">
257
+ <col align="left" valign="top">
258
+ <tbody>
259
+ <tr>
260
+ <td><p><span class="term"><em class="parameter"><code>major</code></em> :</span></p></td>
261
+ <td>the major component of the version number
262
+ </td>
263
+ </tr>
264
+ <tr>
265
+ <td><p><span class="term"><em class="parameter"><code>minor</code></em> :</span></p></td>
266
+ <td>the minor component of the version number
267
+ </td>
268
+ </tr>
269
+ <tr>
270
+ <td><p><span class="term"><em class="parameter"><code>micro</code></em> :</span></p></td>
271
+ <td>the micro component of the version number
272
+ </td>
273
+ </tr>
274
+ <tr>
275
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
276
+ <td>a string literal containing the version.
277
+ </td>
278
+ </tr>
279
+ </tbody>
280
+ </table></div>
281
+ <p class="since">Since 1.8</p>
282
+ </div>
283
+ <hr>
284
+ <div class="refsect2" title="cairo_version ()">
285
+ <a name="cairo-version"></a><h3>cairo_version ()</h3>
286
+ <pre class="programlisting">int cairo_version (void);</pre>
287
+ <p>
288
+ Returns the version of the cairo library encoded in a single
289
+ integer as per <a class="link" href="cairo-version-info.html#CAIRO-VERSION-ENCODE--CAPS" title="CAIRO_VERSION_ENCODE()"><code class="literal">CAIRO_VERSION_ENCODE</code></a>. The encoding ensures that
290
+ later versions compare greater than earlier versions.
291
+ </p>
292
+ <p>
293
+ A run-time comparison to check that cairo's version is greater than
294
+ or equal to version X.Y.Z could be performed as follows:
295
+ </p>
296
+ <p>
297
+ </p>
298
+ <div class="informalexample"><pre class="programlisting">
299
+ if (cairo_version() &gt;= CAIRO_VERSION_ENCODE(X,Y,Z)) {...}
300
+ </pre></div>
301
+ <p>
302
+ </p>
303
+ <p>
304
+ See also <a class="link" href="cairo-version-info.html#cairo-version-string" title="cairo_version_string ()"><code class="function">cairo_version_string()</code></a> as well as the compile-time
305
+ equivalents <a class="link" href="cairo-version-info.html#CAIRO-VERSION--CAPS" title="CAIRO_VERSION"><code class="literal">CAIRO_VERSION</code></a> and <a class="link" href="cairo-version-info.html#CAIRO-VERSION-STRING--CAPS" title="CAIRO_VERSION_STRING"><code class="literal">CAIRO_VERSION_STRING</code></a>.</p>
306
+ <p>
307
+ </p>
308
+ <div class="variablelist"><table border="0">
309
+ <col align="left" valign="top">
310
+ <tbody><tr>
311
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
312
+ <td> the encoded version.
313
+ </td>
314
+ </tr></tbody>
315
+ </table></div>
316
+ </div>
317
+ <hr>
318
+ <div class="refsect2" title="cairo_version_string ()">
319
+ <a name="cairo-version-string"></a><h3>cairo_version_string ()</h3>
320
+ <pre class="programlisting">const char * cairo_version_string (void);</pre>
321
+ <p>
322
+ Returns the version of the cairo library as a human-readable string
323
+ of the form "X.Y.Z".
324
+ </p>
325
+ <p>
326
+ See also <a class="link" href="cairo-version-info.html#cairo-version" title="cairo_version ()"><code class="function">cairo_version()</code></a> as well as the compile-time equivalents
327
+ <a class="link" href="cairo-version-info.html#CAIRO-VERSION-STRING--CAPS" title="CAIRO_VERSION_STRING"><code class="literal">CAIRO_VERSION_STRING</code></a> and <a class="link" href="cairo-version-info.html#CAIRO-VERSION--CAPS" title="CAIRO_VERSION"><code class="literal">CAIRO_VERSION</code></a>.</p>
328
+ <p>
329
+ </p>
330
+ <div class="variablelist"><table border="0">
331
+ <col align="left" valign="top">
332
+ <tbody><tr>
333
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
334
+ <td> a string containing the version.
335
+ </td>
336
+ </tr></tbody>
337
+ </table></div>
338
+ </div>
339
+ </div>
340
+ </div>
341
+ <div class="footer">
342
+ <hr>
343
+ Generated by GTK-Doc V1.11</div>
344
+ </body>
345
+ </html>
@@ -0,0 +1,358 @@
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>Win32 Fonts</title>
6
+ <meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
7
+ <link rel="home" 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-ft-font.html" title="FreeType Fonts">
10
+ <link rel="next" href="cairo-quartz-font.html" title="Quartz (CGFont) Fonts">
11
+ <meta name="generator" content="GTK-Doc V1.11 (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-ft-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-quartz-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">
34
+ <a href="#cairo-win32-font.synopsis" class="shortcut">Top</a>
35
+  | 
36
+ <a href="#cairo-win32-font.description" class="shortcut">Description</a>
37
+ </td></tr>
38
+ </table>
39
+ <div class="refentry" title="Win32 Fonts">
40
+ <a name="cairo-win32-font"></a><div class="titlepage"></div>
41
+ <div class="refnamediv"><table width="100%"><tr>
42
+ <td valign="top">
43
+ <h2><span class="refentrytitle"><a name="cairo-win32-font.top_of_page"></a>Win32 Fonts</span></h2>
44
+ <p>Win32 Fonts — Font support for Microsoft Windows</p>
45
+ </td>
46
+ <td valign="top" align="right"></td>
47
+ </tr></table></div>
48
+ <div class="refsynopsisdiv" title="Synopsis">
49
+ <a name="cairo-win32-font.synopsis"></a><h2>Synopsis</h2>
50
+ <pre class="synopsis">
51
+ #define <a class="link" href="cairo-win32-font.html#CAIRO-HAS-WIN32-FONT--CAPS" title="CAIRO_HAS_WIN32_FONT">CAIRO_HAS_WIN32_FONT</a>
52
+ <a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t">cairo_font_face_t</a> * <a class="link" href="cairo-win32-font.html#cairo-win32-font-face-create-for-logfontw" title="cairo_win32_font_face_create_for_logfontw ()">cairo_win32_font_face_create_for_logfontw</a>
53
+ (LOGFONTW *logfont);
54
+ <a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t">cairo_font_face_t</a> * <a class="link" href="cairo-win32-font.html#cairo-win32-font-face-create-for-hfont" title="cairo_win32_font_face_create_for_hfont ()">cairo_win32_font_face_create_for_hfont</a>
55
+ (HFONT font);
56
+ <a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t">cairo_font_face_t</a> * <a class="link" href="cairo-win32-font.html#cairo-win32-font-face-create-for-logfontw-hfont" title="cairo_win32_font_face_create_for_logfontw_hfont ()">cairo_win32_font_face_create_for_logfontw_hfont</a>
57
+ (LOGFONTW *logfont,
58
+ HFONT font);
59
+ <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-win32-font.html#cairo-win32-scaled-font-select-font" title="cairo_win32_scaled_font_select_font ()">cairo_win32_scaled_font_select_font</a> (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font,
60
+ HDC hdc);
61
+ void <a class="link" href="cairo-win32-font.html#cairo-win32-scaled-font-done-font" title="cairo_win32_scaled_font_done_font ()">cairo_win32_scaled_font_done_font</a> (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font);
62
+ double <a class="link" href="cairo-win32-font.html#cairo-win32-scaled-font-get-metrics-factor" title="cairo_win32_scaled_font_get_metrics_factor ()">cairo_win32_scaled_font_get_metrics_factor</a>
63
+ (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font);
64
+ void <a class="link" href="cairo-win32-font.html#cairo-win32-scaled-font-get-logical-to-device" title="cairo_win32_scaled_font_get_logical_to_device ()">cairo_win32_scaled_font_get_logical_to_device</a>
65
+ (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font,
66
+ <a class="link" href="cairo-matrix.html#cairo-matrix-t" title="cairo_matrix_t">cairo_matrix_t</a> *logical_to_device);
67
+ void <a class="link" href="cairo-win32-font.html#cairo-win32-scaled-font-get-device-to-logical" title="cairo_win32_scaled_font_get_device_to_logical ()">cairo_win32_scaled_font_get_device_to_logical</a>
68
+ (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font,
69
+ <a class="link" href="cairo-matrix.html#cairo-matrix-t" title="cairo_matrix_t">cairo_matrix_t</a> *device_to_logical);
70
+ </pre>
71
+ </div>
72
+ <div class="refsect1" title="Description">
73
+ <a name="cairo-win32-font.description"></a><h2>Description</h2>
74
+ <p>
75
+ The Microsoft Windows font backend is primarily used to render text on
76
+ Microsoft Windows systems.
77
+ </p>
78
+ </div>
79
+ <div class="refsect1" title="Details">
80
+ <a name="cairo-win32-font.details"></a><h2>Details</h2>
81
+ <div class="refsect2" title="CAIRO_HAS_WIN32_FONT">
82
+ <a name="CAIRO-HAS-WIN32-FONT--CAPS"></a><h3>CAIRO_HAS_WIN32_FONT</h3>
83
+ <pre class="programlisting">#define CAIRO_HAS_WIN32_FONT 1
84
+ </pre>
85
+ <p>
86
+ Defined if the Microsoft Windows font backend is available.
87
+ This macro can be used to conditionally compile backend-specific code.
88
+ </p>
89
+ </div>
90
+ <hr>
91
+ <div class="refsect2" title="cairo_win32_font_face_create_for_logfontw ()">
92
+ <a name="cairo-win32-font-face-create-for-logfontw"></a><h3>cairo_win32_font_face_create_for_logfontw ()</h3>
93
+ <pre class="programlisting"><a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t">cairo_font_face_t</a> * cairo_win32_font_face_create_for_logfontw
94
+ (LOGFONTW *logfont);</pre>
95
+ <p>
96
+ Creates a new font for the Win32 font backend based on a
97
+ <span class="type">LOGFONT</span>. This font can then be used with
98
+ <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-scaled-font.html#cairo-scaled-font-create" title="cairo_scaled_font_create ()"><code class="function">cairo_scaled_font_create()</code></a>.
99
+ The <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>
100
+ returned from <a class="link" href="cairo-scaled-font.html#cairo-scaled-font-create" title="cairo_scaled_font_create ()"><code class="function">cairo_scaled_font_create()</code></a> is also for the Win32 backend
101
+ and can be used with functions such as <a class="link" href="cairo-win32-font.html#cairo-win32-scaled-font-select-font" title="cairo_win32_scaled_font_select_font ()"><code class="function">cairo_win32_scaled_font_select_font()</code></a>.</p>
102
+ <p>
103
+ </p>
104
+ <div class="variablelist"><table border="0">
105
+ <col align="left" valign="top">
106
+ <tbody>
107
+ <tr>
108
+ <td><p><span class="term"><em class="parameter"><code>logfont</code></em> :</span></p></td>
109
+ <td> A <span class="type">LOGFONTW</span> structure specifying the font to use.
110
+ The lfHeight, lfWidth, lfOrientation and lfEscapement
111
+ fields of this structure are ignored.
112
+ </td>
113
+ </tr>
114
+ <tr>
115
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
116
+ <td> a newly created <a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a>. Free with
117
+ <a class="link" href="cairo-font-face.html#cairo-font-face-destroy" title="cairo_font_face_destroy ()"><code class="function">cairo_font_face_destroy()</code></a> when you are done using it.
118
+ </td>
119
+ </tr>
120
+ </tbody>
121
+ </table></div>
122
+ </div>
123
+ <hr>
124
+ <div class="refsect2" title="cairo_win32_font_face_create_for_hfont ()">
125
+ <a name="cairo-win32-font-face-create-for-hfont"></a><h3>cairo_win32_font_face_create_for_hfont ()</h3>
126
+ <pre class="programlisting"><a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t">cairo_font_face_t</a> * cairo_win32_font_face_create_for_hfont
127
+ (HFONT font);</pre>
128
+ <p>
129
+ Creates a new font for the Win32 font backend based on a
130
+ <span class="type">HFONT</span>. This font can then be used with
131
+ <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-scaled-font.html#cairo-scaled-font-create" title="cairo_scaled_font_create ()"><code class="function">cairo_scaled_font_create()</code></a>.
132
+ The <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>
133
+ returned from <a class="link" href="cairo-scaled-font.html#cairo-scaled-font-create" title="cairo_scaled_font_create ()"><code class="function">cairo_scaled_font_create()</code></a> is also for the Win32 backend
134
+ and can be used with functions such as <a class="link" href="cairo-win32-font.html#cairo-win32-scaled-font-select-font" title="cairo_win32_scaled_font_select_font ()"><code class="function">cairo_win32_scaled_font_select_font()</code></a>.</p>
135
+ <p>
136
+ </p>
137
+ <div class="variablelist"><table border="0">
138
+ <col align="left" valign="top">
139
+ <tbody>
140
+ <tr>
141
+ <td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
142
+ <td> An <span class="type">HFONT</span> structure specifying the font to use.
143
+ </td>
144
+ </tr>
145
+ <tr>
146
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
147
+ <td> a newly created <a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a>. Free with
148
+ <a class="link" href="cairo-font-face.html#cairo-font-face-destroy" title="cairo_font_face_destroy ()"><code class="function">cairo_font_face_destroy()</code></a> when you are done using it.
149
+ </td>
150
+ </tr>
151
+ </tbody>
152
+ </table></div>
153
+ </div>
154
+ <hr>
155
+ <div class="refsect2" title="cairo_win32_font_face_create_for_logfontw_hfont ()">
156
+ <a name="cairo-win32-font-face-create-for-logfontw-hfont"></a><h3>cairo_win32_font_face_create_for_logfontw_hfont ()</h3>
157
+ <pre class="programlisting"><a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t">cairo_font_face_t</a> * cairo_win32_font_face_create_for_logfontw_hfont
158
+ (LOGFONTW *logfont,
159
+ HFONT font);</pre>
160
+ <p>
161
+ Creates a new font for the Win32 font backend based on a
162
+ <span class="type">LOGFONT</span>. This font can then be used with
163
+ <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-scaled-font.html#cairo-scaled-font-create" title="cairo_scaled_font_create ()"><code class="function">cairo_scaled_font_create()</code></a>.
164
+ The <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>
165
+ returned from <a class="link" href="cairo-scaled-font.html#cairo-scaled-font-create" title="cairo_scaled_font_create ()"><code class="function">cairo_scaled_font_create()</code></a> is also for the Win32 backend
166
+ and can be used with functions such as <a class="link" href="cairo-win32-font.html#cairo-win32-scaled-font-select-font" title="cairo_win32_scaled_font_select_font ()"><code class="function">cairo_win32_scaled_font_select_font()</code></a>.</p>
167
+ <p>
168
+ </p>
169
+ <div class="variablelist"><table border="0">
170
+ <col align="left" valign="top">
171
+ <tbody>
172
+ <tr>
173
+ <td><p><span class="term"><em class="parameter"><code>logfont</code></em> :</span></p></td>
174
+ <td> A <span class="type">LOGFONTW</span> structure specifying the font to use.
175
+ If hfont is null then the lfHeight, lfWidth, lfOrientation and lfEscapement
176
+ fields of this structure are ignored. Otherwise lfWidth, lfOrientation and
177
+ lfEscapement must be zero.
178
+ </td>
179
+ </tr>
180
+ <tr>
181
+ <td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
182
+ <td> An <span class="type">HFONT</span> that can be used when the font matrix is a scale by
183
+ -lfHeight and the CTM is identity.
184
+ </td>
185
+ </tr>
186
+ <tr>
187
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
188
+ <td> a newly created <a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a>. Free with
189
+ <a class="link" href="cairo-font-face.html#cairo-font-face-destroy" title="cairo_font_face_destroy ()"><code class="function">cairo_font_face_destroy()</code></a> when you are done using it.
190
+ </td>
191
+ </tr>
192
+ </tbody>
193
+ </table></div>
194
+ </div>
195
+ <hr>
196
+ <div class="refsect2" title="cairo_win32_scaled_font_select_font ()">
197
+ <a name="cairo-win32-scaled-font-select-font"></a><h3>cairo_win32_scaled_font_select_font ()</h3>
198
+ <pre class="programlisting"><a class="link" href="cairo-error-status.html#cairo-status-t" title="enum cairo_status_t">cairo_status_t</a> cairo_win32_scaled_font_select_font (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font,
199
+ HDC hdc);</pre>
200
+ <p>
201
+ Selects the font into the given device context and changes the
202
+ map mode and world transformation of the device context to match
203
+ that of the font. This function is intended for use when using
204
+ layout APIs such as Uniscribe to do text layout with the
205
+ cairo font. After finishing using the device context, you must call
206
+ <a class="link" href="cairo-win32-font.html#cairo-win32-scaled-font-done-font" title="cairo_win32_scaled_font_done_font ()"><code class="function">cairo_win32_scaled_font_done_font()</code></a> to release any resources allocated
207
+ by this function.
208
+ </p>
209
+ <p>
210
+ See <a class="link" href="cairo-win32-font.html#cairo-win32-scaled-font-get-metrics-factor" title="cairo_win32_scaled_font_get_metrics_factor ()"><code class="function">cairo_win32_scaled_font_get_metrics_factor()</code></a> for converting logical
211
+ coordinates from the device context to font space.
212
+ </p>
213
+ <p>
214
+ Normally, calls to <code class="function">SaveDC()</code> and <code class="function">RestoreDC()</code> would be made around
215
+ the use of this function to preserve the original graphics state.</p>
216
+ <p>
217
+ </p>
218
+ <div class="variablelist"><table border="0">
219
+ <col align="left" valign="top">
220
+ <tbody>
221
+ <tr>
222
+ <td><p><span class="term"><em class="parameter"><code>scaled_font</code></em> :</span></p></td>
223
+ <td> A <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> from the Win32 font backend. Such an
224
+ object can be created with <code class="function">cairo_win32_scaled_font_create_for_logfontw()</code>.
225
+ </td>
226
+ </tr>
227
+ <tr>
228
+ <td><p><span class="term"><em class="parameter"><code>hdc</code></em> :</span></p></td>
229
+ <td> a device context
230
+ </td>
231
+ </tr>
232
+ <tr>
233
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
234
+ <td> <a class="link" href="cairo-error-status.html#CAIRO-STATUS-SUCCESS--CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> if the operation succeeded.
235
+ otherwise an error such as <a class="link" href="cairo-error-status.html#CAIRO-STATUS-NO-MEMORY--CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a> and
236
+ the device context is unchanged.
237
+ </td>
238
+ </tr>
239
+ </tbody>
240
+ </table></div>
241
+ </div>
242
+ <hr>
243
+ <div class="refsect2" title="cairo_win32_scaled_font_done_font ()">
244
+ <a name="cairo-win32-scaled-font-done-font"></a><h3>cairo_win32_scaled_font_done_font ()</h3>
245
+ <pre class="programlisting">void cairo_win32_scaled_font_done_font (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font);</pre>
246
+ <p>
247
+ Releases any resources allocated by <a class="link" href="cairo-win32-font.html#cairo-win32-scaled-font-select-font" title="cairo_win32_scaled_font_select_font ()"><code class="function">cairo_win32_scaled_font_select_font()</code></a></p>
248
+ <p>
249
+ </p>
250
+ <div class="variablelist"><table border="0">
251
+ <col align="left" valign="top">
252
+ <tbody><tr>
253
+ <td><p><span class="term"><em class="parameter"><code>scaled_font</code></em> :</span></p></td>
254
+ <td> A scaled font from the Win32 font backend.
255
+ </td>
256
+ </tr></tbody>
257
+ </table></div>
258
+ </div>
259
+ <hr>
260
+ <div class="refsect2" title="cairo_win32_scaled_font_get_metrics_factor ()">
261
+ <a name="cairo-win32-scaled-font-get-metrics-factor"></a><h3>cairo_win32_scaled_font_get_metrics_factor ()</h3>
262
+ <pre class="programlisting">double cairo_win32_scaled_font_get_metrics_factor
263
+ (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font);</pre>
264
+ <p>
265
+ Gets a scale factor between logical coordinates in the coordinate
266
+ space used by <a class="link" href="cairo-win32-font.html#cairo-win32-scaled-font-select-font" title="cairo_win32_scaled_font_select_font ()"><code class="function">cairo_win32_scaled_font_select_font()</code></a> (that is, the
267
+ coordinate system used by the Windows functions to return metrics) and
268
+ font space coordinates.</p>
269
+ <p>
270
+ </p>
271
+ <div class="variablelist"><table border="0">
272
+ <col align="left" valign="top">
273
+ <tbody>
274
+ <tr>
275
+ <td><p><span class="term"><em class="parameter"><code>scaled_font</code></em> :</span></p></td>
276
+ <td> a scaled font from the Win32 font backend
277
+ </td>
278
+ </tr>
279
+ <tr>
280
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
281
+ <td> factor to multiply logical units by to get font space
282
+ coordinates.
283
+ </td>
284
+ </tr>
285
+ </tbody>
286
+ </table></div>
287
+ </div>
288
+ <hr>
289
+ <div class="refsect2" title="cairo_win32_scaled_font_get_logical_to_device ()">
290
+ <a name="cairo-win32-scaled-font-get-logical-to-device"></a><h3>cairo_win32_scaled_font_get_logical_to_device ()</h3>
291
+ <pre class="programlisting">void cairo_win32_scaled_font_get_logical_to_device
292
+ (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font,
293
+ <a class="link" href="cairo-matrix.html#cairo-matrix-t" title="cairo_matrix_t">cairo_matrix_t</a> *logical_to_device);</pre>
294
+ <p>
295
+ Gets the transformation mapping the logical space used by <em class="parameter"><code>scaled_font</code></em>
296
+ to device space.</p>
297
+ <p>
298
+ </p>
299
+ <div class="variablelist"><table border="0">
300
+ <col align="left" valign="top">
301
+ <tbody>
302
+ <tr>
303
+ <td><p><span class="term"><em class="parameter"><code>scaled_font</code></em> :</span></p></td>
304
+ <td> a scaled font from the Win32 font backend
305
+ </td>
306
+ </tr>
307
+ <tr>
308
+ <td><p><span class="term"><em class="parameter"><code>logical_to_device</code></em> :</span></p></td>
309
+ <td> matrix to return
310
+ </td>
311
+ </tr>
312
+ </tbody>
313
+ </table></div>
314
+ <p class="since">Since 1.4</p>
315
+ </div>
316
+ <hr>
317
+ <div class="refsect2" title="cairo_win32_scaled_font_get_device_to_logical ()">
318
+ <a name="cairo-win32-scaled-font-get-device-to-logical"></a><h3>cairo_win32_scaled_font_get_device_to_logical ()</h3>
319
+ <pre class="programlisting">void cairo_win32_scaled_font_get_device_to_logical
320
+ (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font,
321
+ <a class="link" href="cairo-matrix.html#cairo-matrix-t" title="cairo_matrix_t">cairo_matrix_t</a> *device_to_logical);</pre>
322
+ <p>
323
+ Gets the transformation mapping device space to the logical space
324
+ used by <em class="parameter"><code>scaled_font</code></em>.</p>
325
+ <p>
326
+ </p>
327
+ <div class="variablelist"><table border="0">
328
+ <col align="left" valign="top">
329
+ <tbody>
330
+ <tr>
331
+ <td><p><span class="term"><em class="parameter"><code>scaled_font</code></em> :</span></p></td>
332
+ <td> a scaled font from the Win32 font backend
333
+ </td>
334
+ </tr>
335
+ <tr>
336
+ <td><p><span class="term"><em class="parameter"><code>device_to_logical</code></em> :</span></p></td>
337
+ <td> matrix to return
338
+ </td>
339
+ </tr>
340
+ </tbody>
341
+ </table></div>
342
+ <p class="since">Since 1.4</p>
343
+ </div>
344
+ </div>
345
+ <div class="refsect1" title="See Also">
346
+ <a name="cairo-win32-font.see-also"></a><h2>See Also</h2>
347
+ <p>
348
+ </p>
349
+ <div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a></li></ul></div>
350
+ <p>
351
+ </p>
352
+ </div>
353
+ </div>
354
+ <div class="footer">
355
+ <hr>
356
+ Generated by GTK-Doc V1.11</div>
357
+ </body>
358
+ </html>