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-version-info.html ADDED
@@ -0,0 +1,355 @@
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.73.2">
7
+ <link rel="start" 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.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-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"><nobr><a href="#cairo-version-info.synopsis" class="shortcut">Top</a>
34
+  | 
35
+ <a href="#cairo-version-info.description" class="shortcut">Description</a></nobr></td></tr>
36
+ </table>
37
+ <div class="refentry" lang="en">
38
+ <a name="cairo-version-info"></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-version-info.top_of_page"></a>Version Information</span></h2>
42
+ <p>Version Information — Compile-time and run-time version checks.</p>
43
+ </td>
44
+ <td valign="top" align="right"></td>
45
+ </tr></table></div>
46
+ <div class="refsynopsisdiv">
47
+ <a name="cairo-version-info.synopsis"></a><h2>Synopsis</h2>
48
+ <pre class="synopsis">
49
+ #define <a class="link" href="cairo-version-info.html#CAIRO-VERSION:CAPS" title="CAIRO_VERSION">CAIRO_VERSION</a>
50
+ #define <a class="link" href="cairo-version-info.html#CAIRO-VERSION-MAJOR:CAPS" title="CAIRO_VERSION_MAJOR">CAIRO_VERSION_MAJOR</a>
51
+ #define <a class="link" href="cairo-version-info.html#CAIRO-VERSION-MINOR:CAPS" title="CAIRO_VERSION_MINOR">CAIRO_VERSION_MINOR</a>
52
+ #define <a class="link" href="cairo-version-info.html#CAIRO-VERSION-MICRO:CAPS" title="CAIRO_VERSION_MICRO">CAIRO_VERSION_MICRO</a>
53
+ #define <a class="link" href="cairo-version-info.html#CAIRO-VERSION-STRING:CAPS" title="CAIRO_VERSION_STRING">CAIRO_VERSION_STRING</a>
54
+ #define <a class="link" href="cairo-version-info.html#CAIRO-VERSION-ENCODE:CAPS" title="CAIRO_VERSION_ENCODE()">CAIRO_VERSION_ENCODE</a> (major, minor, micro)
55
+ #define <a class="link" href="cairo-version-info.html#CAIRO-VERSION-STRINGIZE:CAPS" title="CAIRO_VERSION_STRINGIZE()">CAIRO_VERSION_STRINGIZE</a> (major, minor, micro)
56
+ int <a class="link" href="cairo-version-info.html#cairo-version" title="cairo_version ()">cairo_version</a> (void);
57
+ const char* <a class="link" href="cairo-version-info.html#cairo-version-string" title="cairo_version_string ()">cairo_version_string</a> (void);
58
+ </pre>
59
+ </div>
60
+ <div class="refsect1" lang="en">
61
+ <a name="cairo-version-info.description"></a><h2>Description</h2>
62
+ <p>
63
+ Cairo has a three-part version number scheme. In this scheme, we use
64
+ even vs. odd numbers to distinguish fixed points in the software
65
+ vs. in-progress development, (such as from git instead of a tar file,
66
+ or as a "snapshot" tar file as opposed to a "release" tar file).
67
+ </p>
68
+ <p>
69
+ </p>
70
+ <div class="informalexample"><pre class="programlisting">
71
+ _____ Major. Always 1, until we invent a new scheme.
72
+ / ___ Minor. Even/Odd = Release/Snapshot (tar files) or Branch/Head (git)
73
+ | / _ Micro. Even/Odd = Tar-file/git
74
+ | | /
75
+ 1.0.0
76
+ </pre></div>
77
+ <p>
78
+ </p>
79
+ <p>
80
+ Here are a few examples of versions that one might see.
81
+ </p>
82
+ <div class="informalexample"><pre class="programlisting">
83
+ Releases
84
+ --------
85
+ 1.0.0 - A major release
86
+ 1.0.2 - A subsequent maintenance release
87
+ 1.2.0 - Another major release
88
+
89
+ Snapshots
90
+ ---------
91
+ 1.1.2 - A snapshot (working toward the 1.2.0 release)
92
+
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" lang="en">
101
+ <a name="id2657112"></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" lang="en">
129
+ <a name="id2657151"></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
+
144
+ Run-time
145
+ --------
146
+ cairo_version_string() Human-readable
147
+ cairo_version() Encoded, suitable for comparison
148
+ </pre></div>
149
+ <p>
150
+ </p>
151
+ <p>
152
+ For example, checking that the cairo version is greater than or equal
153
+ to 1.0.0 could be achieved at compile-time or run-time as follows:
154
+
155
+ </p>
156
+ <div class="informalexample"><pre class="programlisting">
157
+ ##if CAIRO_VERSION &gt;= CAIRO_VERSION_ENCODE(1, 0, 0)
158
+ printf ("Compiling with suitable cairo version: %s\n", %CAIRO_VERSION_STRING);
159
+ ##endif
160
+
161
+ if (cairo_version() &gt;= CAIRO_VERSION_ENCODE(1, 0, 0))
162
+ printf ("Running with suitable cairo version: %s\n", cairo_version_string ());
163
+ </pre></div>
164
+ <p>
165
+ </p>
166
+ </div>
167
+ </div>
168
+ <div class="refsect1" lang="en">
169
+ <a name="cairo-version-info.details"></a><h2>Details</h2>
170
+ <div class="refsect2" lang="en">
171
+ <a name="CAIRO-VERSION:CAPS"></a><h3>CAIRO_VERSION</h3>
172
+ <pre class="programlisting">#define CAIRO_VERSION</pre>
173
+ <p>
174
+ The version of cairo available at compile-time, encoded using
175
+ <a class="link" href="cairo-version-info.html#CAIRO-VERSION-ENCODE:CAPS" title="CAIRO_VERSION_ENCODE()"><code class="function">CAIRO_VERSION_ENCODE()</code></a>.
176
+ </p>
177
+ </div>
178
+ <hr>
179
+ <div class="refsect2" lang="en">
180
+ <a name="CAIRO-VERSION-MAJOR:CAPS"></a><h3>CAIRO_VERSION_MAJOR</h3>
181
+ <pre class="programlisting">#define CAIRO_VERSION_MAJOR USE_cairo_version_OR_cairo_version_string_INSTEAD
182
+ </pre>
183
+ <p>
184
+ The major component of the version of cairo available at compile-time.
185
+ </p>
186
+ </div>
187
+ <hr>
188
+ <div class="refsect2" lang="en">
189
+ <a name="CAIRO-VERSION-MINOR:CAPS"></a><h3>CAIRO_VERSION_MINOR</h3>
190
+ <pre class="programlisting">#define CAIRO_VERSION_MINOR USE_cairo_version_OR_cairo_version_string_INSTEAD
191
+ </pre>
192
+ <p>
193
+ The minor component of the version of cairo available at compile-time.
194
+ </p>
195
+ </div>
196
+ <hr>
197
+ <div class="refsect2" lang="en">
198
+ <a name="CAIRO-VERSION-MICRO:CAPS"></a><h3>CAIRO_VERSION_MICRO</h3>
199
+ <pre class="programlisting">#define CAIRO_VERSION_MICRO USE_cairo_version_OR_cairo_version_string_INSTEAD
200
+ </pre>
201
+ <p>
202
+ The micro component of the version of cairo available at compile-time.
203
+ </p>
204
+ </div>
205
+ <hr>
206
+ <div class="refsect2" lang="en">
207
+ <a name="CAIRO-VERSION-STRING:CAPS"></a><h3>CAIRO_VERSION_STRING</h3>
208
+ <pre class="programlisting">#define CAIRO_VERSION_STRING</pre>
209
+ <p>
210
+ A human-readable string literal containing the version of cairo available
211
+ at compile-time, in the form of "X.Y.Z".
212
+ </p>
213
+ </div>
214
+ <hr>
215
+ <div class="refsect2" lang="en">
216
+ <a name="CAIRO-VERSION-ENCODE:CAPS"></a><h3>CAIRO_VERSION_ENCODE()</h3>
217
+ <pre class="programlisting">#define CAIRO_VERSION_ENCODE(major, minor, micro)</pre>
218
+ <p>
219
+ This macro encodes the given cairo version into an integer. The numbers
220
+ 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.
221
+ Two encoded version numbers can be compared as integers. The encoding ensures
222
+ that later versions compare greater than earlier versions.
223
+ </p>
224
+ <div class="variablelist"><table border="0">
225
+ <col align="left" valign="top">
226
+ <tbody>
227
+ <tr>
228
+ <td><p><span class="term"><em class="parameter"><code>major</code></em> :</span></p></td>
229
+ <td>the major component of the version number
230
+ </td>
231
+ </tr>
232
+ <tr>
233
+ <td><p><span class="term"><em class="parameter"><code>minor</code></em> :</span></p></td>
234
+ <td>the minor component of the version number
235
+ </td>
236
+ </tr>
237
+ <tr>
238
+ <td><p><span class="term"><em class="parameter"><code>micro</code></em> :</span></p></td>
239
+ <td>the micro component of the version number
240
+ </td>
241
+ </tr>
242
+ <tr>
243
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
244
+ <td>the encoded version.
245
+
246
+
247
+ </td>
248
+ </tr>
249
+ </tbody>
250
+ </table></div>
251
+ </div>
252
+ <hr>
253
+ <div class="refsect2" lang="en">
254
+ <a name="CAIRO-VERSION-STRINGIZE:CAPS"></a><h3>CAIRO_VERSION_STRINGIZE()</h3>
255
+ <pre class="programlisting">#define CAIRO_VERSION_STRINGIZE(major, minor, micro)</pre>
256
+ <p>
257
+ This macro encodes the given cairo version into an string. The numbers
258
+ 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.
259
+ The parameters to this macro must expand to numerical literals.
260
+ </p>
261
+ <div class="variablelist"><table border="0">
262
+ <col align="left" valign="top">
263
+ <tbody>
264
+ <tr>
265
+ <td><p><span class="term"><em class="parameter"><code>major</code></em> :</span></p></td>
266
+ <td>the major component of the version number
267
+ </td>
268
+ </tr>
269
+ <tr>
270
+ <td><p><span class="term"><em class="parameter"><code>minor</code></em> :</span></p></td>
271
+ <td>the minor component of the version number
272
+ </td>
273
+ </tr>
274
+ <tr>
275
+ <td><p><span class="term"><em class="parameter"><code>micro</code></em> :</span></p></td>
276
+ <td>the micro component of the version number
277
+ </td>
278
+ </tr>
279
+ <tr>
280
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
281
+ <td>a string literal containing the version.
282
+ </td>
283
+ </tr>
284
+ </tbody>
285
+ </table></div>
286
+ <p class="since">Since 1.8
287
+
288
+
289
+ </p>
290
+ </div>
291
+ <hr>
292
+ <div class="refsect2" lang="en">
293
+ <a name="cairo-version"></a><h3>cairo_version ()</h3>
294
+ <pre class="programlisting">int cairo_version (void);</pre>
295
+ <p>
296
+ Returns the version of the cairo library encoded in a single
297
+ 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
298
+ later versions compare greater than earlier versions.
299
+ </p>
300
+ <p>
301
+ A run-time comparison to check that cairo's version is greater than
302
+ or equal to version X.Y.Z could be performed as follows:
303
+ </p>
304
+ <p>
305
+ </p>
306
+ <div class="informalexample"><pre class="programlisting">
307
+ if (cairo_version() &gt;= CAIRO_VERSION_ENCODE(X,Y,Z)) {...}
308
+ </pre></div>
309
+ <p>
310
+ </p>
311
+ <p>
312
+ 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
313
+ 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>
314
+ <p>
315
+
316
+ </p>
317
+ <div class="variablelist"><table border="0">
318
+ <col align="left" valign="top">
319
+ <tbody><tr>
320
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
321
+ <td> the encoded version.
322
+ </td>
323
+ </tr></tbody>
324
+ </table></div>
325
+ </div>
326
+ <hr>
327
+ <div class="refsect2" lang="en">
328
+ <a name="cairo-version-string"></a><h3>cairo_version_string ()</h3>
329
+ <pre class="programlisting">const char* cairo_version_string (void);</pre>
330
+ <p>
331
+ Returns the version of the cairo library as a human-readable string
332
+ of the form "X.Y.Z".
333
+ </p>
334
+ <p>
335
+ 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
336
+ <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>
337
+ <p>
338
+
339
+ </p>
340
+ <div class="variablelist"><table border="0">
341
+ <col align="left" valign="top">
342
+ <tbody><tr>
343
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
344
+ <td> a string containing the version.
345
+ </td>
346
+ </tr></tbody>
347
+ </table></div>
348
+ </div>
349
+ </div>
350
+ </div>
351
+ <div class="footer">
352
+ <hr>
353
+ Generated by GTK-Doc V1.10</div>
354
+ </body>
355
+ </html>
data/cairo/share/gtk-doc/html/cairo/cairo-win32-font.html ADDED
@@ -0,0 +1,366 @@
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.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-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.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-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"><nobr><a href="#cairo-win32-font.synopsis" class="shortcut">Top</a>
34
+  | 
35
+ <a href="#cairo-win32-font.description" class="shortcut">Description</a></nobr></td></tr>
36
+ </table>
37
+ <div class="refentry" lang="en">
38
+ <a name="cairo-win32-font"></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-win32-font.top_of_page"></a>Win32 Fonts</span></h2>
42
+ <p>Win32 Fonts — Font support for Microsoft Windows</p>
43
+ </td>
44
+ <td valign="top" align="right"></td>
45
+ </tr></table></div>
46
+ <div class="refsynopsisdiv">
47
+ <a name="cairo-win32-font.synopsis"></a><h2>Synopsis</h2>
48
+ <pre class="synopsis">
49
+ #define <a class="link" href="cairo-win32-font.html#CAIRO-HAS-WIN32-FONT:CAPS" title="CAIRO_HAS_WIN32_FONT">CAIRO_HAS_WIN32_FONT</a>
50
+ <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>
51
+ (LOGFONTW *logfont);
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-hfont" title="cairo_win32_font_face_create_for_hfont ()">cairo_win32_font_face_create_for_hfont</a>
53
+ (HFONT font);
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-logfontw-hfont" title="cairo_win32_font_face_create_for_logfontw_hfont ()">cairo_win32_font_face_create_for_logfontw_hfont</a>
55
+ (LOGFONTW *logfont,
56
+ HFONT font);
57
+ <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,
58
+ HDC hdc);
59
+ 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);
60
+ 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>
61
+ (<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
+ 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>
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
+ <a class="link" href="cairo-matrix.html#cairo-matrix-t" title="cairo_matrix_t">cairo_matrix_t</a> *logical_to_device);
65
+ 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>
66
+ (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font,
67
+ <a class="link" href="cairo-matrix.html#cairo-matrix-t" title="cairo_matrix_t">cairo_matrix_t</a> *device_to_logical);
68
+ </pre>
69
+ </div>
70
+ <div class="refsect1" lang="en">
71
+ <a name="cairo-win32-font.description"></a><h2>Description</h2>
72
+ <p>
73
+ The Microsoft Windows font backend is primarily used to render text on
74
+ Microsoft Windows systems.
75
+ </p>
76
+ </div>
77
+ <div class="refsect1" lang="en">
78
+ <a name="cairo-win32-font.details"></a><h2>Details</h2>
79
+ <div class="refsect2" lang="en">
80
+ <a name="CAIRO-HAS-WIN32-FONT:CAPS"></a><h3>CAIRO_HAS_WIN32_FONT</h3>
81
+ <pre class="programlisting">#define CAIRO_HAS_WIN32_FONT 1
82
+ </pre>
83
+ <p>
84
+ Defined if the Microsoft Windows font backend is available.
85
+ This macro can be used to conditionally compile backend-specific code.
86
+ </p>
87
+ </div>
88
+ <hr>
89
+ <div class="refsect2" lang="en">
90
+ <a name="cairo-win32-font-face-create-for-logfontw"></a><h3>cairo_win32_font_face_create_for_logfontw ()</h3>
91
+ <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
92
+ (LOGFONTW *logfont);</pre>
93
+ <p>
94
+ Creates a new font for the Win32 font backend based on a
95
+ <span class="type">LOGFONT</span>. This font can then be used with
96
+ <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>.
97
+ 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>
98
+ 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
99
+ 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>
100
+ <p>
101
+
102
+ </p>
103
+ <div class="variablelist"><table border="0">
104
+ <col align="left" valign="top">
105
+ <tbody>
106
+ <tr>
107
+ <td><p><span class="term"><em class="parameter"><code>logfont</code></em> :</span></p></td>
108
+ <td> A <span class="type">LOGFONTW</span> structure specifying the font to use.
109
+ The lfHeight, lfWidth, lfOrientation and lfEscapement
110
+ fields of this structure are ignored.
111
+ </td>
112
+ </tr>
113
+ <tr>
114
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
115
+ <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
116
+ <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.
117
+ </td>
118
+ </tr>
119
+ </tbody>
120
+ </table></div>
121
+ </div>
122
+ <hr>
123
+ <div class="refsect2" lang="en">
124
+ <a name="cairo-win32-font-face-create-for-hfont"></a><h3>cairo_win32_font_face_create_for_hfont ()</h3>
125
+ <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
126
+ (HFONT font);</pre>
127
+ <p>
128
+ Creates a new font for the Win32 font backend based on a
129
+ <span class="type">HFONT</span>. This font can then be used with
130
+ <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>.
131
+ 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>
132
+ 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
133
+ 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>
134
+ <p>
135
+
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" lang="en">
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
+
169
+ </p>
170
+ <div class="variablelist"><table border="0">
171
+ <col align="left" valign="top">
172
+ <tbody>
173
+ <tr>
174
+ <td><p><span class="term"><em class="parameter"><code>logfont</code></em> :</span></p></td>
175
+ <td> A <span class="type">LOGFONTW</span> structure specifying the font to use.
176
+ If hfont is null then the lfHeight, lfWidth, lfOrientation and lfEscapement
177
+ fields of this structure are ignored. Otherwise lfWidth, lfOrientation and
178
+ lfEscapement must be zero.
179
+ </td>
180
+ </tr>
181
+ <tr>
182
+ <td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
183
+ <td> An <span class="type">HFONT</span> that can be used when the font matrix is a scale by
184
+ -lfHeight and the CTM is identity.
185
+ </td>
186
+ </tr>
187
+ <tr>
188
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
189
+ <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
190
+ <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.
191
+ </td>
192
+ </tr>
193
+ </tbody>
194
+ </table></div>
195
+ </div>
196
+ <hr>
197
+ <div class="refsect2" lang="en">
198
+ <a name="cairo-win32-scaled-font-select-font"></a><h3>cairo_win32_scaled_font_select_font ()</h3>
199
+ <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,
200
+ HDC hdc);</pre>
201
+ <p>
202
+ Selects the font into the given device context and changes the
203
+ map mode and world transformation of the device context to match
204
+ that of the font. This function is intended for use when using
205
+ layout APIs such as Uniscribe to do text layout with the
206
+ cairo font. After finishing using the device context, you must call
207
+ <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
208
+ by this function.
209
+ </p>
210
+ <p>
211
+ 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
212
+ coordinates from the device context to font space.
213
+ </p>
214
+ <p>
215
+ Normally, calls to <code class="function">SaveDC()</code> and <code class="function">RestoreDC()</code> would be made around
216
+ the use of this function to preserve the original graphics state.</p>
217
+ <p>
218
+
219
+ </p>
220
+ <div class="variablelist"><table border="0">
221
+ <col align="left" valign="top">
222
+ <tbody>
223
+ <tr>
224
+ <td><p><span class="term"><em class="parameter"><code>scaled_font</code></em> :</span></p></td>
225
+ <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
226
+ object can be created with <code class="function">cairo_win32_scaled_font_create_for_logfontw()</code>.
227
+ </td>
228
+ </tr>
229
+ <tr>
230
+ <td><p><span class="term"><em class="parameter"><code>hdc</code></em> :</span></p></td>
231
+ <td> a device context
232
+ </td>
233
+ </tr>
234
+ <tr>
235
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
236
+ <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.
237
+ 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
238
+ the device context is unchanged.
239
+ </td>
240
+ </tr>
241
+ </tbody>
242
+ </table></div>
243
+ </div>
244
+ <hr>
245
+ <div class="refsect2" lang="en">
246
+ <a name="cairo-win32-scaled-font-done-font"></a><h3>cairo_win32_scaled_font_done_font ()</h3>
247
+ <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>
248
+ <p>
249
+ 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>
250
+ <p>
251
+
252
+ </p>
253
+ <div class="variablelist"><table border="0">
254
+ <col align="left" valign="top">
255
+ <tbody><tr>
256
+ <td><p><span class="term"><em class="parameter"><code>scaled_font</code></em> :</span></p></td>
257
+ <td> A scaled font from the Win32 font backend.
258
+ </td>
259
+ </tr></tbody>
260
+ </table></div>
261
+ </div>
262
+ <hr>
263
+ <div class="refsect2" lang="en">
264
+ <a name="cairo-win32-scaled-font-get-metrics-factor"></a><h3>cairo_win32_scaled_font_get_metrics_factor ()</h3>
265
+ <pre class="programlisting">double cairo_win32_scaled_font_get_metrics_factor
266
+ (<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>
267
+ <p>
268
+ Gets a scale factor between logical coordinates in the coordinate
269
+ 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
270
+ coordinate system used by the Windows functions to return metrics) and
271
+ font space coordinates.</p>
272
+ <p>
273
+
274
+ </p>
275
+ <div class="variablelist"><table border="0">
276
+ <col align="left" valign="top">
277
+ <tbody>
278
+ <tr>
279
+ <td><p><span class="term"><em class="parameter"><code>scaled_font</code></em> :</span></p></td>
280
+ <td> a scaled font from the Win32 font backend
281
+ </td>
282
+ </tr>
283
+ <tr>
284
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
285
+ <td> factor to multiply logical units by to get font space
286
+ coordinates.
287
+ </td>
288
+ </tr>
289
+ </tbody>
290
+ </table></div>
291
+ </div>
292
+ <hr>
293
+ <div class="refsect2" lang="en">
294
+ <a name="cairo-win32-scaled-font-get-logical-to-device"></a><h3>cairo_win32_scaled_font_get_logical_to_device ()</h3>
295
+ <pre class="programlisting">void cairo_win32_scaled_font_get_logical_to_device
296
+ (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font,
297
+ <a class="link" href="cairo-matrix.html#cairo-matrix-t" title="cairo_matrix_t">cairo_matrix_t</a> *logical_to_device);</pre>
298
+ <p>
299
+ Gets the transformation mapping the logical space used by <em class="parameter"><code>scaled_font</code></em>
300
+ to device space.</p>
301
+ <p>
302
+
303
+ </p>
304
+ <div class="variablelist"><table border="0">
305
+ <col align="left" valign="top">
306
+ <tbody>
307
+ <tr>
308
+ <td><p><span class="term"><em class="parameter"><code>scaled_font</code></em> :</span></p></td>
309
+ <td> a scaled font from the Win32 font backend
310
+ </td>
311
+ </tr>
312
+ <tr>
313
+ <td><p><span class="term"><em class="parameter"><code>logical_to_device</code></em> :</span></p></td>
314
+ <td> matrix to return
315
+ </td>
316
+ </tr>
317
+ </tbody>
318
+ </table></div>
319
+ <p class="since">Since 1.4
320
+ </p>
321
+ </div>
322
+ <hr>
323
+ <div class="refsect2" lang="en">
324
+ <a name="cairo-win32-scaled-font-get-device-to-logical"></a><h3>cairo_win32_scaled_font_get_device_to_logical ()</h3>
325
+ <pre class="programlisting">void cairo_win32_scaled_font_get_device_to_logical
326
+ (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font,
327
+ <a class="link" href="cairo-matrix.html#cairo-matrix-t" title="cairo_matrix_t">cairo_matrix_t</a> *device_to_logical);</pre>
328
+ <p>
329
+ Gets the transformation mapping device space to the logical space
330
+ used by <em class="parameter"><code>scaled_font</code></em>.</p>
331
+ <p>
332
+
333
+ </p>
334
+ <div class="variablelist"><table border="0">
335
+ <col align="left" valign="top">
336
+ <tbody>
337
+ <tr>
338
+ <td><p><span class="term"><em class="parameter"><code>scaled_font</code></em> :</span></p></td>
339
+ <td> a scaled font from the Win32 font backend
340
+ </td>
341
+ </tr>
342
+ <tr>
343
+ <td><p><span class="term"><em class="parameter"><code>device_to_logical</code></em> :</span></p></td>
344
+ <td> matrix to return
345
+ </td>
346
+ </tr>
347
+ </tbody>
348
+ </table></div>
349
+ <p class="since">Since 1.4
350
+ </p>
351
+ </div>
352
+ </div>
353
+ <div class="refsect1" lang="en">
354
+ <a name="cairo-win32-font.see-also"></a><h2>See Also</h2>
355
+ <p>
356
+ </p>
357
+ <div class="itemizedlist"><ul type="disc"><li><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>
358
+ <p>
359
+ </p>
360
+ </div>
361
+ </div>
362
+ <div class="footer">
363
+ <hr>
364
+ Generated by GTK-Doc V1.10</div>
365
+ </body>
366
+ </html>