cairo 1.6.1-x86-mswin32 → 1.7.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 (410) hide show
  1. data/ChangeLog +285 -0
  2. data/NEWS +33 -0
  3. data/README +15 -4
  4. data/Rakefile +3 -0
  5. data/cairo/bin/libcairo-2.dll +0 -0
  6. data/cairo/bin/libpng12-0.dll +0 -0
  7. data/cairo/include/{libpng13/png.h → png.h} +285 -135
  8. data/cairo/include/{libpng13/pngconf.h → pngconf.h} +116 -72
  9. data/cairo/lib/cairo.lib +0 -0
  10. data/cairo/lib/libcairo.dll.a +0 -0
  11. data/cairo/lib/libpng.def +361 -371
  12. data/cairo/lib/libpng.lib +0 -0
  13. data/cairo/lib/libpng12.dll.a +0 -0
  14. data/cairo/lib/pkgconfig/cairo-pdf.pc +1 -1
  15. data/cairo/lib/pkgconfig/cairo-png.pc +2 -2
  16. data/cairo/lib/pkgconfig/cairo-ps.pc +1 -1
  17. data/cairo/lib/pkgconfig/cairo-svg.pc +1 -1
  18. data/cairo/lib/pkgconfig/cairo-win32-font.pc +1 -1
  19. data/cairo/lib/pkgconfig/cairo-win32.pc +1 -1
  20. data/cairo/lib/pkgconfig/cairo.pc +2 -2
  21. data/cairo/lib/pkgconfig/libpng.pc +10 -14
  22. data/cairo/lib/pkgconfig/libpng12.pc +10 -0
  23. data/cairo/make/{cairo-1.6.4-1.sh → cairo-1.6.4-2.sh} +3 -3
  24. data/cairo/make/libpng-1.2.29.sh +35 -0
  25. data/cairo/manifest/cairo-1.6.4-2.mft +6 -0
  26. data/cairo/manifest/{cairo-dev-1.6.4-1.mft → cairo-dev-1.6.4-2.mft} +2 -2
  27. data/cairo/manifest/libpng-1.2.29.mft +2 -0
  28. data/cairo/manifest/libpng-dev-1.2.29.mft +12 -0
  29. data/cairo/share/doc/{cairo-1.6.4-1 → cairo-1.6.4-2}/COPYING +0 -0
  30. data/cairo/share/doc/{cairo-1.6.4-1 → cairo-1.6.4-2}/COPYING-LGPL-2.1 +0 -0
  31. data/cairo/share/doc/{cairo-1.6.4-1 → cairo-1.6.4-2}/COPYING-MPL-1.1 +0 -0
  32. data/cairo/share/man/man3/libpng.3 +3680 -0
  33. data/cairo/share/man/man3/libpngpf.3 +274 -0
  34. data/cairo/share/man/man5/png.5 +74 -0
  35. data/doc/en/cairo-antialias.html +0 -3
  36. data/doc/en/cairo-clip-not-representable-error.html +0 -3
  37. data/doc/en/cairo-color-base.html +0 -3
  38. data/doc/en/cairo-color-cmyk.html +0 -3
  39. data/doc/en/cairo-color-hsv.html +0 -3
  40. data/doc/en/cairo-color-rgb.html +0 -3
  41. data/doc/en/cairo-color-x11.html +0 -3
  42. data/doc/en/cairo-color.html +0 -3
  43. data/doc/en/cairo-content.html +0 -3
  44. data/doc/en/cairo-context-blur.html +0 -3
  45. data/doc/en/cairo-context-circle.html +0 -3
  46. data/doc/en/cairo-context-color.html +0 -3
  47. data/doc/en/cairo-context-path.html +0 -3
  48. data/doc/en/cairo-context-rectangle.html +0 -3
  49. data/doc/en/cairo-context-triangle.html +0 -3
  50. data/doc/en/cairo-context.html +119 -102
  51. data/doc/en/cairo-error.html +0 -3
  52. data/doc/en/cairo-extend.html +0 -3
  53. data/doc/en/cairo-file-not-found.html +0 -3
  54. data/doc/en/cairo-fill-rule.html +0 -3
  55. data/doc/en/cairo-filter.html +0 -3
  56. data/doc/en/cairo-font-extents.html +67 -12
  57. data/doc/en/cairo-font-face.html +0 -3
  58. data/doc/en/cairo-font-options.html +26 -14
  59. data/doc/en/cairo-font-slant.html +0 -3
  60. data/doc/en/cairo-font-type-mismatch.html +47 -0
  61. data/doc/en/cairo-font-weight.html +0 -3
  62. data/doc/en/cairo-format.html +0 -3
  63. data/doc/en/cairo-glyph.html +0 -3
  64. data/doc/en/cairo-gradient-pattern.html +0 -3
  65. data/doc/en/cairo-hint-metrics.html +0 -3
  66. data/doc/en/cairo-hint-style.html +0 -3
  67. data/doc/en/cairo-image-surface.html +0 -3
  68. data/doc/en/cairo-invalid-clusters.html +47 -0
  69. data/doc/en/cairo-invalid-content-error.html +0 -3
  70. data/doc/en/cairo-invalid-dash-error.html +0 -3
  71. data/doc/en/cairo-invalid-dsc-comment-error.html +0 -3
  72. data/doc/en/cairo-invalid-format-error.html +0 -3
  73. data/doc/en/cairo-invalid-index-error.html +0 -3
  74. data/doc/en/cairo-invalid-matrix-error.html +0 -3
  75. data/doc/en/cairo-invalid-path-data-error.html +0 -3
  76. data/doc/en/cairo-invalid-pop-group-error.html +0 -3
  77. data/doc/en/cairo-invalid-restore-error.html +0 -3
  78. data/doc/en/cairo-invalid-slant.html +47 -0
  79. data/doc/en/cairo-invalid-status-error.html +0 -3
  80. data/doc/en/cairo-invalid-stride-error.html +0 -3
  81. data/doc/en/cairo-invalid-string-error.html +0 -3
  82. data/doc/en/cairo-invalid-visual-error.html +0 -3
  83. data/doc/en/cairo-invalid-weight.html +47 -0
  84. data/doc/en/cairo-lcd-filter.html +39 -0
  85. data/doc/en/cairo-line-cap.html +0 -3
  86. data/doc/en/cairo-line-join.html +0 -3
  87. data/doc/en/cairo-linear-pattern.html +0 -3
  88. data/doc/en/cairo-matrix.html +43 -41
  89. data/doc/en/cairo-negative-count.html +47 -0
  90. data/doc/en/cairo-no-current-point-error.html +0 -3
  91. data/doc/en/cairo-null-pointer-error.html +0 -3
  92. data/doc/en/cairo-operator.html +0 -3
  93. data/doc/en/cairo-paper-parse-error.html +0 -3
  94. data/doc/en/cairo-paper-unknown-paper-name.html +0 -3
  95. data/doc/en/cairo-paper-unknown-unit.html +0 -3
  96. data/doc/en/cairo-paper-unrecognized-paper-description.html +0 -3
  97. data/doc/en/cairo-paper.html +0 -3
  98. data/doc/en/cairo-path-close-path.html +0 -3
  99. data/doc/en/cairo-path-curve-to.html +0 -3
  100. data/doc/en/cairo-path-data-type.html +0 -3
  101. data/doc/en/cairo-path-data.html +0 -3
  102. data/doc/en/cairo-path-line-to.html +0 -3
  103. data/doc/en/cairo-path-move-to.html +0 -3
  104. data/doc/en/cairo-path.html +0 -3
  105. data/doc/en/cairo-pattern-type-mismatch-error.html +0 -3
  106. data/doc/en/cairo-pattern.html +0 -3
  107. data/doc/en/cairo-pdf-surface.html +0 -3
  108. data/doc/en/cairo-point.html +0 -3
  109. data/doc/en/cairo-ps-level.html +0 -3
  110. data/doc/en/cairo-ps-surface.html +0 -3
  111. data/doc/en/cairo-quartz-image-surface.html +0 -3
  112. data/doc/en/cairo-quartz-surface.html +0 -3
  113. data/doc/en/cairo-radial-pattern.html +0 -3
  114. data/doc/en/cairo-read-error.html +0 -3
  115. data/doc/en/cairo-rectangle.html +0 -3
  116. data/doc/en/cairo-scaled-font.html +13 -6
  117. data/doc/en/cairo-solid-pattern.html +0 -3
  118. data/doc/en/cairo-subpixel-order.html +0 -3
  119. data/doc/en/cairo-surface-finished-error.html +0 -3
  120. data/doc/en/cairo-surface-pattern.html +0 -3
  121. data/doc/en/cairo-surface-type-mismatch-error.html +0 -3
  122. data/doc/en/cairo-surface.html +22 -15
  123. data/doc/en/cairo-svg-surface.html +0 -3
  124. data/doc/en/cairo-svg-version.html +0 -3
  125. data/doc/en/cairo-temp-file-error.html +0 -3
  126. data/doc/en/cairo-text-cluster.html +84 -0
  127. data/doc/en/cairo-text-extents.html +78 -13
  128. data/doc/en/cairo-toy-font-face.html +67 -0
  129. data/doc/en/cairo-user-font-error.html +47 -0
  130. data/doc/en/cairo-user-font-face-text-to-glyphs-data.html +94 -0
  131. data/doc/en/cairo-user-font-face.html +72 -0
  132. data/doc/en/cairo-user-font-immutable.html +47 -0
  133. data/doc/en/cairo-win32-printing-surface.html +0 -3
  134. data/doc/en/cairo-win32-surface.html +0 -3
  135. data/doc/en/cairo-write-error.html +0 -3
  136. data/doc/en/cairo.html +92 -80
  137. data/doc/en/index.html +327 -240
  138. data/doc/ja/cairo-clip-not-representable-error.html +1 -1
  139. data/doc/ja/cairo-color-base.html +1 -1
  140. data/doc/ja/cairo-color-cmyk.html +9 -9
  141. data/doc/ja/cairo-color-hsv.html +8 -8
  142. data/doc/ja/cairo-color-rgb.html +9 -9
  143. data/doc/ja/cairo-color.html +8 -8
  144. data/doc/ja/cairo-context-circle.html +1 -1
  145. data/doc/ja/cairo-context-color.html +1 -1
  146. data/doc/ja/cairo-context-path.html +2 -2
  147. data/doc/ja/cairo-context.html +435 -342
  148. data/doc/ja/cairo-font-extents.html +69 -15
  149. data/doc/ja/cairo-font-face.html +3 -3
  150. data/doc/ja/cairo-font-options.html +37 -12
  151. data/doc/ja/cairo-font-slant.html +1 -1
  152. data/doc/ja/cairo-font-type-mismatch.html +52 -0
  153. data/doc/ja/cairo-glyph.html +5 -5
  154. data/doc/ja/cairo-gradient-pattern.html +6 -6
  155. data/doc/ja/cairo-image-surface.html +8 -8
  156. data/doc/ja/cairo-invalid-clusters.html +55 -0
  157. data/doc/ja/cairo-invalid-restore-error.html +1 -1
  158. data/doc/ja/cairo-invalid-slant.html +57 -0
  159. data/doc/ja/cairo-invalid-weight.html +57 -0
  160. data/doc/ja/cairo-lcd-filter.html +63 -0
  161. data/doc/ja/cairo-line-join.html +1 -1
  162. data/doc/ja/cairo-linear-pattern.html +2 -2
  163. data/doc/ja/cairo-matrix.html +35 -24
  164. data/doc/ja/cairo-negative-count.html +52 -0
  165. data/doc/ja/cairo-paper-unknown-paper-name.html +2 -2
  166. data/doc/ja/cairo-paper-unknown-unit.html +2 -2
  167. data/doc/ja/cairo-paper-unrecognized-paper-description.html +1 -1
  168. data/doc/ja/cairo-paper.html +12 -12
  169. data/doc/ja/cairo-path-close-path.html +1 -1
  170. data/doc/ja/cairo-path-curve-to.html +1 -1
  171. data/doc/ja/cairo-path-data.html +8 -8
  172. data/doc/ja/cairo-path-line-to.html +1 -1
  173. data/doc/ja/cairo-path-move-to.html +1 -1
  174. data/doc/ja/cairo-path.html +21 -21
  175. data/doc/ja/cairo-pattern.html +4 -4
  176. data/doc/ja/cairo-pdf-surface.html +2 -2
  177. data/doc/ja/cairo-point.html +5 -5
  178. data/doc/ja/cairo-ps-level.html +2 -2
  179. data/doc/ja/cairo-ps-surface.html +6 -6
  180. data/doc/ja/cairo-quartz-image-surface.html +2 -2
  181. data/doc/ja/cairo-quartz-surface.html +3 -3
  182. data/doc/ja/cairo-radial-pattern.html +2 -2
  183. data/doc/ja/cairo-rectangle.html +5 -5
  184. data/doc/ja/cairo-scaled-font.html +53 -17
  185. data/doc/ja/cairo-solid-pattern.html +3 -3
  186. data/doc/ja/cairo-surface-pattern.html +2 -2
  187. data/doc/ja/cairo-surface.html +58 -36
  188. data/doc/ja/cairo-svg-surface.html +4 -4
  189. data/doc/ja/cairo-svg-version.html +2 -2
  190. data/doc/ja/cairo-text-cluster.html +102 -0
  191. data/doc/ja/cairo-text-extents.html +84 -22
  192. data/doc/ja/cairo-toy-font-face.html +107 -0
  193. data/doc/ja/cairo-user-font-error.html +55 -0
  194. data/doc/ja/cairo-user-font-face-text-to-glyphs-data.html +155 -0
  195. data/doc/ja/cairo-user-font-face.html +268 -0
  196. data/doc/ja/cairo-user-font-immutable.html +54 -0
  197. data/doc/ja/cairo-win32-printing-surface.html +3 -3
  198. data/doc/ja/cairo-win32-surface.html +4 -4
  199. data/doc/ja/cairo.html +110 -77
  200. data/doc/ja/index.html +292 -205
  201. data/extconf.rb +3 -1
  202. data/misc/update-colors.rb +0 -0
  203. data/pkg-config.rb +54 -28
  204. data/samples/agg/aa_test.rb +0 -0
  205. data/samples/blur.rb +0 -0
  206. data/samples/png.rb +0 -0
  207. data/samples/scalable.rb +0 -0
  208. data/samples/text-on-path.rb +0 -0
  209. data/samples/text2.rb +0 -0
  210. data/src/cairo.def +8 -0
  211. data/src/cairo.so +0 -0
  212. data/src/lib/cairo.rb +12 -7
  213. data/src/lib/cairo/constants.rb +1 -0
  214. data/src/libruby-cairo.a +0 -0
  215. data/src/rb_cairo.c +25 -3
  216. data/src/rb_cairo.h +29 -18
  217. data/src/rb_cairo_constants.c +39 -10
  218. data/src/rb_cairo_context.c +156 -15
  219. data/src/rb_cairo_exception.c +143 -3
  220. data/src/rb_cairo_font_extents.c +81 -6
  221. data/src/rb_cairo_font_face.c +646 -4
  222. data/src/rb_cairo_font_options.c +24 -2
  223. data/src/rb_cairo_glyph.c +5 -3
  224. data/src/rb_cairo_matrix.c +17 -1
  225. data/src/rb_cairo_pattern.c +4 -4
  226. data/src/rb_cairo_private.c +169 -5
  227. data/src/rb_cairo_private.h +45 -3
  228. data/src/rb_cairo_scaled_font.c +61 -3
  229. data/src/rb_cairo_surface.c +174 -59
  230. data/src/rb_cairo_text_cluster.c +151 -0
  231. data/src/rb_cairo_text_extents.c +85 -2
  232. data/test-unit/Rakefile +30 -0
  233. data/test-unit/bin/testrb +5 -0
  234. data/test-unit/lib/test/unit.rb +280 -0
  235. data/test-unit/lib/test/unit/assertionfailederror.rb +14 -0
  236. data/test-unit/lib/test/unit/assertions.rb +722 -0
  237. data/test-unit/lib/test/unit/attribute.rb +125 -0
  238. data/test-unit/lib/test/unit/autorunner.rb +254 -0
  239. data/test-unit/lib/test/unit/collector.rb +43 -0
  240. data/test-unit/lib/test/unit/collector/descendant.rb +23 -0
  241. data/test-unit/lib/test/unit/collector/dir.rb +108 -0
  242. data/test-unit/lib/test/unit/collector/load.rb +135 -0
  243. data/test-unit/lib/test/unit/collector/objectspace.rb +34 -0
  244. data/test-unit/lib/test/unit/color.rb +61 -0
  245. data/test-unit/lib/test/unit/diff.rb +524 -0
  246. data/test-unit/lib/test/unit/error.rb +124 -0
  247. data/test-unit/lib/test/unit/exceptionhandler.rb +39 -0
  248. data/test-unit/lib/test/unit/failure.rb +110 -0
  249. data/test-unit/lib/test/unit/fixture.rb +185 -0
  250. data/test-unit/lib/test/unit/notification.rb +125 -0
  251. data/test-unit/lib/test/unit/omission.rb +143 -0
  252. data/test-unit/lib/test/unit/pending.rb +146 -0
  253. data/test-unit/lib/test/unit/priority.rb +146 -0
  254. data/test-unit/lib/test/unit/runner/console.rb +46 -0
  255. data/test-unit/lib/test/unit/runner/emacs.rb +8 -0
  256. data/test-unit/lib/test/unit/testcase.rb +281 -0
  257. data/test-unit/lib/test/unit/testresult.rb +89 -0
  258. data/test-unit/lib/test/unit/testsuite.rb +110 -0
  259. data/test-unit/lib/test/unit/ui/console/outputlevel.rb +14 -0
  260. data/test-unit/lib/test/unit/ui/console/testrunner.rb +195 -0
  261. data/test-unit/lib/test/unit/ui/emacs/testrunner.rb +49 -0
  262. data/test-unit/lib/test/unit/ui/testrunner.rb +20 -0
  263. data/test-unit/lib/test/unit/ui/testrunnermediator.rb +77 -0
  264. data/test-unit/lib/test/unit/ui/testrunnerutilities.rb +41 -0
  265. data/test-unit/lib/test/unit/util/backtracefilter.rb +41 -0
  266. data/test-unit/lib/test/unit/util/observable.rb +90 -0
  267. data/test-unit/lib/test/unit/util/procwrapper.rb +48 -0
  268. data/test-unit/lib/test/unit/version.rb +7 -0
  269. data/test-unit/sample/adder.rb +13 -0
  270. data/test-unit/sample/subtracter.rb +12 -0
  271. data/test-unit/sample/tc_adder.rb +18 -0
  272. data/test-unit/sample/tc_subtracter.rb +18 -0
  273. data/test-unit/sample/ts_examples.rb +7 -0
  274. data/test-unit/test/collector/test_descendant.rb +135 -0
  275. data/test-unit/test/collector/test_dir.rb +406 -0
  276. data/test-unit/test/collector/test_load.rb +333 -0
  277. data/test-unit/test/collector/test_objectspace.rb +98 -0
  278. data/test-unit/test/run-test.rb +13 -0
  279. data/test-unit/test/test_assertions.rb +693 -0
  280. data/test-unit/test/test_attribute.rb +86 -0
  281. data/test-unit/test/test_color.rb +37 -0
  282. data/test-unit/test/test_diff.rb +477 -0
  283. data/test-unit/test/test_emacs_runner.rb +60 -0
  284. data/test-unit/test/test_error.rb +26 -0
  285. data/test-unit/test/test_failure.rb +33 -0
  286. data/test-unit/test/test_fixture.rb +252 -0
  287. data/test-unit/test/test_notification.rb +33 -0
  288. data/test-unit/test/test_omission.rb +81 -0
  289. data/test-unit/test/test_pending.rb +70 -0
  290. data/test-unit/test/test_priority.rb +89 -0
  291. data/test-unit/test/test_testcase.rb +430 -0
  292. data/test-unit/test/test_testresult.rb +113 -0
  293. data/test-unit/test/test_testsuite.rb +129 -0
  294. data/test-unit/test/testunit_test_util.rb +14 -0
  295. data/test-unit/test/ui/test_testrunmediator.rb +20 -0
  296. data/test-unit/test/util/test_backtracefilter.rb +41 -0
  297. data/test-unit/test/util/test_observable.rb +102 -0
  298. data/test-unit/test/util/test_procwrapper.rb +36 -0
  299. data/test/cairo-test-utils.rb +18 -0
  300. data/test/run-test.rb +14 -1
  301. data/test/test_constants.rb +19 -0
  302. data/test/test_context.rb +117 -0
  303. data/test/test_exception.rb +27 -0
  304. data/test/test_font_extents.rb +36 -0
  305. data/test/test_font_face.rb +244 -0
  306. data/test/test_font_options.rb +32 -0
  307. data/test/test_pkg_config.rb +3 -2
  308. data/test/test_scaled_font.rb +34 -0
  309. data/test/test_surface.rb +41 -0
  310. data/test/test_text_cluster.rb +32 -0
  311. data/test/test_text_extents.rb +40 -0
  312. data/test/test_text_to_glyphs_data.rb +47 -0
  313. metadata +129 -109
  314. data/cairo/bin/libpng13.dll +0 -0
  315. data/cairo/lib/libpng13.dll.a +0 -0
  316. data/cairo/lib/pkgconfig/libpng13.pc +0 -14
  317. data/cairo/manifest/cairo-1.6.4-1.mft +0 -6
  318. data/cairo/manifest/libpng-dev-1.2.8.mft +0 -7
  319. data/doc/en/cairo-antialias.rd +0 -16
  320. data/doc/en/cairo-clip-not-representable-error.rd +0 -17
  321. data/doc/en/cairo-color-base.rd +0 -38
  322. data/doc/en/cairo-color-cmyk.rd +0 -107
  323. data/doc/en/cairo-color-hsv.rd +0 -91
  324. data/doc/en/cairo-color-rgb.rd +0 -95
  325. data/doc/en/cairo-color-x11.rd +0 -151
  326. data/doc/en/cairo-color.rd +0 -213
  327. data/doc/en/cairo-content.rd +0 -15
  328. data/doc/en/cairo-context-blur.rd +0 -15
  329. data/doc/en/cairo-context-circle.rd +0 -15
  330. data/doc/en/cairo-context-color.rd +0 -15
  331. data/doc/en/cairo-context-path.rd +0 -19
  332. data/doc/en/cairo-context-rectangle.rd +0 -15
  333. data/doc/en/cairo-context-triangle.rd +0 -15
  334. data/doc/en/cairo-context.rd +0 -491
  335. data/doc/en/cairo-error.rd +0 -16
  336. data/doc/en/cairo-extend.rd +0 -16
  337. data/doc/en/cairo-file-not-found.rd +0 -17
  338. data/doc/en/cairo-fill-rule.rd +0 -14
  339. data/doc/en/cairo-filter.rd +0 -18
  340. data/doc/en/cairo-font-extents.rd +0 -40
  341. data/doc/en/cairo-font-face.rd +0 -14
  342. data/doc/en/cairo-font-options.rd +0 -94
  343. data/doc/en/cairo-font-slant.rd +0 -15
  344. data/doc/en/cairo-font-weight.rd +0 -14
  345. data/doc/en/cairo-format.rd +0 -22
  346. data/doc/en/cairo-glyph.rd +0 -62
  347. data/doc/en/cairo-gradient-pattern.rd +0 -41
  348. data/doc/en/cairo-hint-metrics.rd +0 -15
  349. data/doc/en/cairo-hint-style.rd +0 -17
  350. data/doc/en/cairo-image-surface.rd +0 -47
  351. data/doc/en/cairo-invalid-content-error.rd +0 -17
  352. data/doc/en/cairo-invalid-dash-error.rd +0 -17
  353. data/doc/en/cairo-invalid-dsc-comment-error.rd +0 -17
  354. data/doc/en/cairo-invalid-format-error.rd +0 -17
  355. data/doc/en/cairo-invalid-index-error.rd +0 -17
  356. data/doc/en/cairo-invalid-matrix-error.rd +0 -17
  357. data/doc/en/cairo-invalid-path-data-error.rd +0 -17
  358. data/doc/en/cairo-invalid-pop-group-error.rd +0 -17
  359. data/doc/en/cairo-invalid-restore-error.rd +0 -17
  360. data/doc/en/cairo-invalid-status-error.rd +0 -17
  361. data/doc/en/cairo-invalid-stride-error.rd +0 -17
  362. data/doc/en/cairo-invalid-string-error.rd +0 -17
  363. data/doc/en/cairo-invalid-visual-error.rd +0 -17
  364. data/doc/en/cairo-line-cap.rd +0 -15
  365. data/doc/en/cairo-line-join.rd +0 -15
  366. data/doc/en/cairo-linear-pattern.rd +0 -28
  367. data/doc/en/cairo-matrix.rd +0 -186
  368. data/doc/en/cairo-no-current-point-error.rd +0 -17
  369. data/doc/en/cairo-null-pointer-error.rd +0 -17
  370. data/doc/en/cairo-operator.rd +0 -26
  371. data/doc/en/cairo-paper-parse-error.rd +0 -17
  372. data/doc/en/cairo-paper-unknown-paper-name.rd +0 -30
  373. data/doc/en/cairo-paper-unknown-unit.rd +0 -30
  374. data/doc/en/cairo-paper-unrecognized-paper-description.rd +0 -30
  375. data/doc/en/cairo-paper.rd +0 -141
  376. data/doc/en/cairo-path-close-path.rd +0 -21
  377. data/doc/en/cairo-path-curve-to.rd +0 -21
  378. data/doc/en/cairo-path-data-type.rd +0 -16
  379. data/doc/en/cairo-path-data.rd +0 -62
  380. data/doc/en/cairo-path-line-to.rd +0 -21
  381. data/doc/en/cairo-path-move-to.rd +0 -21
  382. data/doc/en/cairo-path.rd +0 -109
  383. data/doc/en/cairo-pattern-type-mismatch-error.rd +0 -17
  384. data/doc/en/cairo-pattern.rd +0 -62
  385. data/doc/en/cairo-pdf-surface.rd +0 -27
  386. data/doc/en/cairo-point.rd +0 -42
  387. data/doc/en/cairo-ps-level.rd +0 -24
  388. data/doc/en/cairo-ps-surface.rd +0 -55
  389. data/doc/en/cairo-quartz-image-surface.rd +0 -27
  390. data/doc/en/cairo-quartz-surface.rd +0 -27
  391. data/doc/en/cairo-radial-pattern.rd +0 -28
  392. data/doc/en/cairo-read-error.rd +0 -17
  393. data/doc/en/cairo-rectangle.rd +0 -54
  394. data/doc/en/cairo-scaled-font.rd +0 -50
  395. data/doc/en/cairo-solid-pattern.rd +0 -31
  396. data/doc/en/cairo-subpixel-order.rd +0 -17
  397. data/doc/en/cairo-surface-finished-error.rd +0 -17
  398. data/doc/en/cairo-surface-pattern.rd +0 -27
  399. data/doc/en/cairo-surface-type-mismatch-error.rd +0 -17
  400. data/doc/en/cairo-surface.rd +0 -72
  401. data/doc/en/cairo-svg-surface.rd +0 -44
  402. data/doc/en/cairo-svg-version.rd +0 -24
  403. data/doc/en/cairo-temp-file-error.rd +0 -17
  404. data/doc/en/cairo-text-extents.rd +0 -44
  405. data/doc/en/cairo-win32-printing-surface.rd +0 -27
  406. data/doc/en/cairo-win32-surface.rd +0 -31
  407. data/doc/en/cairo-write-error.rd +0 -17
  408. data/doc/en/cairo.rd +0 -95
  409. data/doc/en/index.rd +0 -1051
  410. data/samples/agg/aa_demo.rb +0 -47
data/doc/ja/cairo-user-font-face-text-to-glyphs-data.html ADDED
@@ -0,0 +1,155 @@
1
+ <?xml version="1.0" encoding="UTF-8" ?>
2
+ <!DOCTYPE html
3
+ PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
4
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
5
+ <html xmlns="http://www.w3.org/1999/xhtml" lang="ja" xml:lang="ja">
6
+ <head>
7
+ <meta http-equiv="Content-type" content="text/html; charset=UTF-8" />
8
+ <title>Cairo::UserFontFace::TextToGlyphsDataクラス</title>
9
+ <link href="../doc.css" type="text/css" rel="stylesheet" />
10
+ </head>
11
+ <div class="footer">
12
+ <ul>
13
+ <li><a href="./">索引</a></li>
14
+ </ul>
15
+
16
+ </div>
17
+ </body>
18
+
19
+ <h1><a name="label-0" id="label-0">Cairo::UserFontFace::TextToGlyphsDataクラス</a></h1><!-- RDLabel: "Cairo::UserFontFace::TextToGlyphsDataクラス" -->
20
+ <p><em>Since 1.7</em>: <a href="cairo-user-font-face.html#label-7">Cairo::UserFontFace#on_text_to_glyphs</a>コール
21
+ バックに渡されるデータです。
22
+ <a href="cairo-user-font-face-text-to-glyphs-data.html#label-12">Cairo::UserFontFace::TextToGlyphsData#glyphs=</a>,
23
+ <a href="cairo-user-font-face-text-to-glyphs-data.html#label-9">Cairo::UserFontFace::TextToGlyphsData#clusters=</a>,
24
+ <a href="cairo-user-font-face-text-to-glyphs-data.html#label-6">Cairo::UserFontFace::TextToGlyphsData#backward=</a>
25
+ で値を設定してください。</p>
26
+ <p>glyphsを設定する必要があるかどうかは
27
+ <a href="cairo-user-font-face-text-to-glyphs-data.html#label-13">Cairo::UserFontFace::TextToGlyphsData#need_glyphs?</a>でわかりま
28
+ す。</p>
29
+ <p>clustersを設定する必要があるかどうかは
30
+ <a href="cairo-user-font-face-text-to-glyphs-data.html#label-10">Cairo::UserFontFace::TextToGlyphsData#need_clusters?</a>でわかりま
31
+ す。</p>
32
+ <p>backwardを設定する必要があるかどうかは
33
+ <a href="cairo-user-font-face-text-to-glyphs-data.html#label-7">Cairo::UserFontFace::TextToGlyphsData#need_backward?</a>でわかりま
34
+ す。</p>
35
+ <h2><a name="label-1" id="label-1">オブジェクト階層</a></h2><!-- RDLabel: "オブジェクト階層" -->
36
+ <ul>
37
+ <li>Object
38
+ <ul>
39
+ <li>Cairo::UserFontFace::TextToGlyphsData</li>
40
+ </ul></li>
41
+ </ul>
42
+ <h2><a name="label-2" id="label-2">クラスメソッド</a></h2><!-- RDLabel: "クラスメソッド" -->
43
+ <dl>
44
+ <dt><a name="label-3" id="label-3"><code>Cairo::UserFontFace::TextToGlyphsData.new(<var>need_glyphs</var>, <var>need_clusters</var>, <var>need_backward</var>)</code></a></dt><!-- RDLabel: "Cairo::UserFontFace::TextToGlyphsData.new" -->
45
+ <dd>
46
+ <em>Since 1.7</em>: 新しく
47
+ <a href="cairo-user-font-face-text-to-glyphs-data.html">Cairo::UserFontFace::TextToGlyphsData</a>オブジェクトを生成
48
+ します。このオブジェクトは
49
+ <a href="cairo-user-font-face.html#label-7">Cairo::UserFontFace#on_text_to_glyphs</a>コールバック中で生
50
+ 成されるため、通常は明示的に生成する必要はありません。
51
+ <ul>
52
+ <li>need_glyphs: グリフを計算する必要があるかどうか。</li>
53
+ <li>need_clusters: クラスタ対応情報を計算する必要があるか
54
+ どうか。</li>
55
+ <li>need_backward: クラスタ対応情報が後ろ向きに進むかどう
56
+ かを計算する必要があるかどうか。</li>
57
+ <li>戻り値: 新しく生成した
58
+ <a href="cairo-user-font-face-text-to-glyphs-data.html">Cairo::UserFontFace::TextToGlyphsData</a>オブジェクト。</li>
59
+ </ul></dd>
60
+ </dl>
61
+ <h2><a name="label-4" id="label-4">インタンスメソッド</a></h2><!-- RDLabel: "インタンスメソッド" -->
62
+ <dl>
63
+ <dt><a name="label-5" id="label-5"><code>backward?</code></a></dt><!-- RDLabel: "backward?" -->
64
+ <dd>
65
+ <em>Since 1.7</em>
66
+ <ul>
67
+ <li>戻り値: クラスタ対応情報が後ろ向きに進むなら
68
+ <code>true</code>、そうでない場合は<code>false</code></li>
69
+ </ul></dd>
70
+ <dt><a name="label-6" id="label-6"><code>backward=(<var>backward</var>)</code></a></dt><!-- RDLabel: "backward=" -->
71
+ <dd>
72
+ <em>Since 1.7</em>
73
+ <ul>
74
+ <li>backward: クラスタ対応情報が後ろ向きに進むかどうかの
75
+ 真偽値</li>
76
+ </ul></dd>
77
+ <dt><a name="label-7" id="label-7"><code>need_backward?</code></a></dt><!-- RDLabel: "need_backward?" -->
78
+ <dd>
79
+ <em>Since 1.7</em>
80
+ <ul>
81
+ <li>戻り値: クラスタ対応情報が後ろ向きに進むかどうかを計
82
+ 算する必要があるなら<code>true</code>、そうでない場合は
83
+ <code>false</code>。</li>
84
+ </ul></dd>
85
+ <dt><a name="label-8" id="label-8"><code>clusters</code></a></dt><!-- RDLabel: "clusters" -->
86
+ <dd>
87
+ <em>Since 1.7</em>
88
+ <ul>
89
+ <li>戻り値: <code>[cluster, ...]</code>
90
+ <ul>
91
+ <li>cluster: <a href="cairo-text-cluster.html">Cairo::TextCluster</a>オブジェクト。</li>
92
+ </ul></li>
93
+ </ul></dd>
94
+ <dt><a name="label-9" id="label-9"><code>clusters=(<var>clusters</var>)</code></a></dt><!-- RDLabel: "clusters=" -->
95
+ <dd>
96
+ <em>Since 1.7</em>
97
+ <ul>
98
+ <li>clusters: <code>[cluster, ...]</code>
99
+ <ul>
100
+ <li>cluster: <a href="cairo-text-cluster.html">Cairo::TextCluster</a>オブジェクト。</li>
101
+ </ul></li>
102
+ </ul></dd>
103
+ <dt><a name="label-10" id="label-10"><code>need_clusters?</code></a></dt><!-- RDLabel: "need_clusters?" -->
104
+ <dd>
105
+ <em>Since 1.7</em>
106
+ <ul>
107
+ <li>戻り値: クラスタ対応情報を計算する必要があるなら
108
+ <code>true</code>、そうでない場合は<code>false</code>。</li>
109
+ </ul></dd>
110
+ <dt><a name="label-11" id="label-11"><code>glyphs</code></a></dt><!-- RDLabel: "glyphs" -->
111
+ <dd>
112
+ <em>Since 1.7</em>
113
+ <ul>
114
+ <li>戻り値: <code>[glyph, ...]</code>
115
+ <ul>
116
+ <li>glyph: <a href="cairo-glyph.html">Cairo::Glyph</a>オブジェクト。</li>
117
+ </ul></li>
118
+ </ul></dd>
119
+ <dt><a name="label-12" id="label-12"><code>glyphs=(<var>glyphs</var>)</code></a></dt><!-- RDLabel: "glyphs=" -->
120
+ <dd>
121
+ <em>Since 1.7</em>
122
+ <ul>
123
+ <li>glyphs: <code>[glyph, ...]</code>
124
+ <ul>
125
+ <li>glyph: <a href="cairo-glyph.html">Cairo::Glyph</a>オブジェクト。</li>
126
+ </ul></li>
127
+ </ul></dd>
128
+ <dt><a name="label-13" id="label-13"><code>need_glyphs?</code></a></dt><!-- RDLabel: "need_glyphs?" -->
129
+ <dd>
130
+ <em>Since 1.7</em>
131
+ <ul>
132
+ <li>戻り値: グリフを計算する必要があるなら<code>true</code>、そ
133
+ うでない場合は<code>false</code>。</li>
134
+ </ul></dd>
135
+ </dl>
136
+ <h2><a name="label-14" id="label-14">参考</a></h2><!-- RDLabel: "参考" -->
137
+ <ul>
138
+ <li><a href="cairo-user-font-face.html#label-7">Cairo::UserFontFace#on_text_to_glyphs</a></li>
139
+ <li><a href="cairo-glyph.html">Cairo::Glyph</a></li>
140
+ <li><a href="cairo-text-cluster.html">Cairo::TextCluster</a></li>
141
+ </ul>
142
+ <h2><a name="label-15" id="label-15">変更履歴</a></h2><!-- RDLabel: "変更履歴" -->
143
+ <ul>
144
+ <li>2008-08-17: kou: スタート。</li>
145
+ </ul>
146
+
147
+ <div class="footer">
148
+ <ul>
149
+ <li><a href="./">索引</a></li>
150
+ </ul>
151
+
152
+ </div>
153
+ </body>
154
+
155
+ </html>
data/doc/ja/cairo-user-font-face.html ADDED
@@ -0,0 +1,268 @@
1
+ <?xml version="1.0" encoding="UTF-8" ?>
2
+ <!DOCTYPE html
3
+ PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
4
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
5
+ <html xmlns="http://www.w3.org/1999/xhtml" lang="ja" xml:lang="ja">
6
+ <head>
7
+ <meta http-equiv="Content-type" content="text/html; charset=UTF-8" />
8
+ <title>Cairo::UserFontFaceクラス</title>
9
+ <link href="../doc.css" type="text/css" rel="stylesheet" />
10
+ </head>
11
+ <div class="footer">
12
+ <ul>
13
+ <li><a href="./">索引</a></li>
14
+ </ul>
15
+
16
+ </div>
17
+ </body>
18
+
19
+ <h1><a name="label-0" id="label-0">Cairo::UserFontFaceクラス</a></h1><!-- RDLabel: "Cairo::UserFontFaceクラス" -->
20
+ <p><em>Since 1.7</em>: ユーザが独自のフォントを使うためのフォント
21
+ フェイス。</p>
22
+ <p>on_XXXメソッドでコールバックを登録する方法と
23
+ <a href="cairo-user-font-face.html">Cairo::UserFontFace</a>を継承して、そのクラスにコールバック用のメ
24
+ ソッドを定義する方法があります。</p>
25
+ <p>継承した場合のコールバック用メソッドの名前はon_XXXメソッドか
26
+ ら「on_」を除いた部分です。例えば、on_initに対応するメソッド
27
+ 名はinitです。引数は同じです。以下は継承する例です。
28
+ render_glyph以外は定義しなくてもかまいません。</p>
29
+ <pre>class CustomUserFontFace &lt; Cairo::UserFontFace
30
+ def init(scaled_font, context, font_extents)
31
+ end
32
+
33
+ def render_glyph(scaled_font, glyph, context, text_extents)
34
+ end
35
+
36
+ def text_to_glyphs(scaled_font, utf8, data)
37
+ end
38
+
39
+ def unicode_to_glyph(scaled_font, unicode)
40
+ end
41
+ end</pre>
42
+ <h2><a name="label-1" id="label-1">オブジェクト階層</a></h2><!-- RDLabel: "オブジェクト階層" -->
43
+ <ul>
44
+ <li>Object
45
+ <ul>
46
+ <li><a href="cairo-font-face.html">Cairo::FontFace</a>
47
+ <ul>
48
+ <li>Cairo::UserFontFace</li>
49
+ </ul></li>
50
+ </ul></li>
51
+ </ul>
52
+ <h2><a name="label-2" id="label-2">クラスメソッド</a></h2><!-- RDLabel: "クラスメソッド" -->
53
+ <dl>
54
+ <dt><a name="label-3" id="label-3"><code>Cairo::UserFontFace.new</code></a></dt><!-- RDLabel: "Cairo::UserFontFace.new" -->
55
+ <dd>
56
+ <p><em>Since 1.7</em>: 新しくCario::UserFontFaceオブジェクト
57
+ を生成します。</p>
58
+ <p>オブジェクトを生成したら、on_XXXメソッドでコールバック
59
+ を登録してください。必須のコールバックは
60
+ <a href="cairo-user-font-face.html#label-6">Cairo::UserFontFace#on_render_glyph</a>です。それ以外のコー
61
+ ルバックは省略可能です。</p>
62
+ <p>継承して利用する場合、そのクラスのメソッドよりもon_XXX
63
+ メソッドで登録したコールバックの方が優先されます。</p>
64
+ <ul>
65
+ <li>戻り値: 新しく生成したCario::UserFontFaceオブジェク
66
+ ト。</li>
67
+ </ul></dd>
68
+ </dl>
69
+ <h2><a name="label-4" id="label-4">インタンスメソッド</a></h2><!-- RDLabel: "インタンスメソッド" -->
70
+ <dl>
71
+ <dt><a name="label-5" id="label-5"><code>on_init {|<var>scaled_font</var>, <var>context</var>, <var>font_extents</var>| ...}</code></a></dt><!-- RDLabel: "on_init" -->
72
+ <dd>
73
+ <p><em>Since 1.7</em>: 拡大・縮小したフォントを初期化するコー
74
+ ルバックを登録します。このコールバックは省略可能です。</p>
75
+ <p><var>context</var>は呼び出し元では使われませんが、フォント空
76
+ 間ように準備されています。これは
77
+ <a href="cairo-user-font-face.html#label-6">Cairo::UserFontFace#on_render_glyph</a>で登録するコールバッ
78
+ クに渡される<var>context</var>と同様です。コールバック中では
79
+ この<a href="cairo-context.html">Cairo::Context</a>をフォントの範囲を計算するために使う
80
+ ことができます。</p>
81
+ <p><var>font_extents</var>には<var>scaled_font</var>用のフォントの範
82
+ 囲を設定します。座標はフォント空間です。そのため、多く
83
+ の場合は<a href="cairo-font-extents.html#label-5">Cairo::FontExtents#ascent</a>と
84
+ <a href="cairo-font-extents.html#label-8">Cairo::FontExtents#descent</a>に1.0を足す必要があります。
85
+ <var>font_extents</var>は以下のように初期化されています。</p>
86
+ <ul>
87
+ <li>ascent: 1.0</li>
88
+ <li>descent: 0.0</li>
89
+ <li>height: 1.0</li>
90
+ <li>max_x_advance: 1.0</li>
91
+ <li>max_y_advance: 0.0</li>
92
+ </ul>
93
+ <p>このコールバックを指定しなかった場合は上記のデフォルト
94
+ のフォントの範囲が使われます。</p>
95
+ <p>注: <var>scaled_font</var>はこの時点では完全には初期化されて
96
+ いません。そのため、コールバック中でテキスト操作を行う
97
+ とデッドロックするでしょう。</p>
98
+ <p>コールバック中で問題が発生した場合は
99
+ <a href="cairo-user-font-error.html">Cairo::UserFontError</a>例外、あるいは問題に対応する例外を
100
+ 発生させてください。</p>
101
+ <ul>
102
+ <li>scaled_font: 生成中の拡大・縮小したフォント。
103
+ （<a href="cairo-scaled-font.html">Cairo::ScaledFont</a>）</li>
104
+ <li>context: <a href="cairo-context.html">Cairo::Context</a>。座標はフォント空間。</li>
105
+ <li>font_extents: 設定するフォントの範囲
106
+ （<a href="cairo-font-extents.html">Cairo::FontExtents</a>）。座標はフォント空間。</li>
107
+ </ul></dd>
108
+ <dt><a name="label-6" id="label-6"><code>on_render_glyph {|<var>scaled_font</var>, <var>glyph</var>, <var>context</var>, <var>text_extents</var>| ...}</code></a></dt><!-- RDLabel: "on_render_glyph" -->
109
+ <dd>
110
+ <p><em>Since 1.7</em>: グリフ描画コールバックを登録します。こ
111
+ のコールバックが唯一必須のコールバックです。</p>
112
+ <p>コードが<var>glyph</var>のグリフを<var>context</var>に描画してく
113
+ ださい。<var>context</var>はグリフ描画がフォント空間の座標で
114
+ 行われるように準備されています。つまり、<var>context</var>に
115
+ 設定されている変換行列は<var>scaled_font</var>の拡大・縮小行
116
+ 列です。</p>
117
+ <p><var>text_extents</var>には<var>scaled_font</var>のフォントの範囲
118
+ を設定してください。しかし、もし、ユーザ空間座標で描画
119
+ したい場合は<var>context</var>の変換行列を設定してください。
120
+ すべての<var>context</var>に対する操作は許可されていますが、
121
+ もし、<var>context</var>のデフォルトソース以外のソースが使わ
122
+ れた場合の動作は未定義です。つまり、グリフのビットマッ
123
+ プは<a href="cairo-context.html#label-82">Cairo::Context#paint</a>ではなく<a href="cairo-context.html#label-68">Cairo::Context#mask</a>で描
124
+ 画するべきだということです。</p>
125
+ <p>他のデフォルトではない<var>context</var>の設定は以下の通り
126
+ です。</p>
127
+ <ul>
128
+ <li>フォントサイズが1.0である（座標がフォント空間に設定
129
+ されているため）</li>
130
+ <li>フォントオプションの設定が<var>scaled_font</var>に対応し
131
+ ている</li>
132
+ </ul>
133
+ <p><var>text_extents</var>は以下のように設定されています。</p>
134
+ <ul>
135
+ <li>x_bearing: 0.0</li>
136
+ <li>y_bearing: -font_extents.ascent</li>
137
+ <li>width: 0.0</li>
138
+ <li>height: font_extents.ascent + font_extents.descent</li>
139
+ <li>x_advance: font_extents.max_x_advance</li>
140
+ <li>y_advance: 0.0</li>
141
+ </ul>
142
+ <p>多くの場合、設定しなければいけない項目はx_advanceだけで
143
+ す。もし、コールバックの後でもwidthが0（デフォルト値）
144
+ のままだった場合は、グリフの範囲は<var>context</var>への描画
145
+ 操作を元に自動的に計算されます。多くの場合、これは望ま
146
+ れた動作です。しかし、もし、コールバックがグリフの範囲
147
+ を設定する理由がある場合は、インクで塗る部分のグリフの
148
+ 範囲を設定してください。また、その範囲はコールバック中
149
+ で<var>context</var>に描画したものすべてを含むようにしてくだ
150
+ さい。</p>
151
+ <p>コールバック中で問題が発生した場合は
152
+ <a href="cairo-user-font-error.html">Cairo::UserFontError</a>例外、あるいは問題に対応する例外を
153
+ 発生させてください。</p>
154
+ <ul>
155
+ <li>scaled_font: ユーザ用の拡大・縮小したフォント。
156
+ （<a href="cairo-scaled-font.html">Cairo::ScaledFont</a>）</li>
157
+ <li>glyph: 描画するグリフコード（Integer）</li>
158
+ <li>context: <a href="cairo-context.html">Cairo::Context</a>。座標はフォント空間。</li>
159
+ <li>text_extents: 設定するグリフの範囲</li>
160
+ </ul>
161
+ <p>（<a href="cairo-text-extents.html">Cairo::TextExtents</a>）。座標はフォント空間。</p></dd>
162
+ <dt><a name="label-7" id="label-7"><code>on_text_to_glyphs {|<var>scaled_font</var>, <var>utf8</var>, <var>data</var>| ...}</code></a></dt><!-- RDLabel: "on_text_to_glyphs" -->
163
+ <dd>
164
+ <p><em>Since 1.7</em>: テキストをグリフに変換するコールバック
165
+ を登録します。このコールバックは省略可能です。</p>
166
+ <p>このコールバックは<a href="cairo-context.html#label-110">Cairo::Context#show_text</a>のときに使わ
167
+ れます。</p>
168
+ <p>このコールバックを使うとき、ユーザフォントはグリフとそ
169
+ の位置をすべて制御できます。つまり、リガチャ、カーニン
170
+ グといった機能や、アラビア語やインド語のような文字体系
171
+ が要求するような複雑な形を実現できます。</p>
172
+ <p>変換した結果は<var>data</var>に設定します。</p>
173
+ <p>もし、
174
+ <a href="cairo-user-font-face-text-to-glyphs-data.html#label-13">data.need_glyphs?</a>
175
+ が<code>true</code>の場合は
176
+ <a href="cairo-user-font-face-text-to-glyphs-data.html#label-12">data.glyphs=</a>
177
+ で計算したグリフのインデックスと位置を設定します。グリ
178
+ フの位置はフォント空間座標です。テキストは起点から表示
179
+ されると仮定しています。</p>
180
+ <p>もし、
181
+ <a href="cairo-user-font-face-text-to-glyphs-data.html#label-10">data.need_clusters?</a>
182
+ が<code>true</code>の場合は
183
+ <a href="cairo-user-font-face-text-to-glyphs-data.html#label-9">data.clusters=</a>
184
+ で計算したクラスタ対応情報を設定します。</p>
185
+ <p>もし、このコールバックが省略されているか
186
+ <a href="cairo-user-font-face-text-to-glyphs-data.html#label-11">data.glyphs</a>
187
+ が<code>nil</code>の場合は
188
+ <a href="cairo-user-font-face.html#label-8">Cairo::UserFontFace#on_unicode_to_glyph</a>が呼ばれます。</p>
189
+ <p>注: cairoはグリフのインデックス付けには制限を設けていま
190
+ せんが、いくつかのアプリケーションはグリフのインデック
191
+ スは16ビットの符号無し整数に収まると仮定しています。そ
192
+ のため、ユーザフォントはグリフの範囲を0から65535の範囲
193
+ に収めるようにするとよいでしょう。さらに、いくつかのアプ
194
+ リケーションは0番目のグリフは「グリフがない」という特別
195
+ なグリフと仮定しているかもしれません。ユーザフォントは0
196
+ 番目のグリフをそのような目的として使い、他の目的には使
197
+ わない方がよいでしょう。</p>
198
+ <p>コールバック中で問題が発生した場合は
199
+ <a href="cairo-user-font-error.html">Cairo::UserFontError</a>例外、あるいは問題に対応する例外を
200
+ 発生させてください。</p>
201
+ <ul>
202
+ <li>scaled_font: ユーザ用の拡大・縮小したフォント。
203
+ （<a href="cairo-scaled-font.html">Cairo::ScaledFont</a>）</li>
204
+ <li>utf8: UTF-8で符号化されたテキスト</li>
205
+ <li>data: 変換結果を保存するオブジェクト
206
+ （<a href="cairo-user-font-face-text-to-glyphs-data.html">Cairo::UserFontFace::TextToGlyphsData</a>）</li>
207
+ </ul></dd>
208
+ <dt><a name="label-8" id="label-8"><code>on_unicode_to_glyph {|<var>scaled_font</var>, <var>unicode</var>| ...}</code></a></dt><!-- RDLabel: "on_unicode_to_glyph" -->
209
+ <dd>
210
+ <p><em>Since 1.7</em>: Unicodeからグリフへ変換するコールバッ
211
+ クを登録します。このコールバックは省略可能です。</p>
212
+ <p>このコールバックは<a href="cairo-context.html#label-110">Cairo::Context#show_text</a>で使われます。</p>
213
+ <p>登録したコールバックは<var>unicode</var>で指定されたUnicode
214
+ のコードポイントに対応するグリフのインデックスを返して
215
+ ください。</p>
216
+ <p>このコールバックは<a href="cairo-user-font-face.html#label-7">Cairo::UserFontFace#on_text_to_glyphs</a>
217
+ で登録するコールバックと同じ機能を提供します。
218
+ on_text_to_glyphsほど出力を制御できませんが、使いやすい
219
+ です。このコールバックを使うということは、各文字はそれ
220
+ ぞれひとつのグリフに対応し、その対応は文脈に依存しない
221
+ という前提があるということです。また、グリフは前のグリ
222
+ フの幅に対応して配置されるという仮定もしています。つま
223
+ り、リガチャやカーニングや複雑な文字体系などはこのコー
224
+ ルバックを使っては実装できないということです。</p>
225
+ <p>このコールバックは<a href="cairo-user-font-face.html#label-7">Cairo::UserFontFace#on_text_to_glyphs</a>
226
+ でコールバックを登録していない場合や、登録したコールバッ
227
+ クがグリフを返せなかった場合にだけ呼ばれます。このコー
228
+ ルバックが登録されていない場合はUnicodeのコードポイ
229
+ ントがそのままグリフのインデックスになっていると仮定さ
230
+ れます。</p>
231
+ <p>注: cairoはグリフのインデックス付けには制限を設けていま
232
+ せんが、いくつかのアプリケーションはグリフのインデック
233
+ スは16ビットの符号無し整数に収まると仮定しています。そ
234
+ のため、ユーザフォントはグリフの範囲を0から65535の範囲
235
+ に収めるようにするとよいでしょう。さらに、いくつかのアプ
236
+ リケーションは0番目のグリフは「グリフがない」という特別
237
+ なグリフと仮定しているかもしれません。ユーザフォントは0
238
+ 番目のグリフをそのような目的として使い、他の目的には使
239
+ わない方がよいでしょう。</p>
240
+ <p>コールバック中で問題が発生した場合は
241
+ <a href="cairo-user-font-error.html">Cairo::UserFontError</a>例外、あるいは問題に対応する例外を
242
+ 発生させてください。</p>
243
+ <ul>
244
+ <li>scaled_font: ユーザ用の拡大・縮小したフォント。
245
+ （<a href="cairo-scaled-font.html">Cairo::ScaledFont</a>）</li>
246
+ <li>unicode: Unicode文字のコードポイント</li>
247
+ <li>ブロックの戻り値: グリフのインデックス</li>
248
+ </ul></dd>
249
+ </dl>
250
+ <h2><a name="label-9" id="label-9">参考</a></h2><!-- RDLabel: "参考" -->
251
+ <ul>
252
+ <li><a href="cairo-context.html#label-137">Cairo::Context#show_text_glyphs</a></li>
253
+ <li><a href="cairo-scaled-font.html#label-13">Cairo::ScaledFont#text_to_glyphs</a></li>
254
+ </ul>
255
+ <h2><a name="label-10" id="label-10">変更履歴</a></h2><!-- RDLabel: "変更履歴" -->
256
+ <ul>
257
+ <li>2008-08-17: kou: スタート。</li>
258
+ </ul>
259
+
260
+ <div class="footer">
261
+ <ul>
262
+ <li><a href="./">索引</a></li>
263
+ </ul>
264
+
265
+ </div>
266
+ </body>
267
+
268
+ </html>
data/doc/ja/cairo-user-font-immutable.html ADDED
@@ -0,0 +1,54 @@
1
+ <?xml version="1.0" encoding="UTF-8" ?>
2
+ <!DOCTYPE html
3
+ PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
4
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
5
+ <html xmlns="http://www.w3.org/1999/xhtml" lang="ja" xml:lang="ja">
6
+ <head>
7
+ <meta http-equiv="Content-type" content="text/html; charset=UTF-8" />
8
+ <title>Cairo::UserFontImmutableクラス</title>
9
+ <link href="../doc.css" type="text/css" rel="stylesheet" />
10
+ </head>
11
+ <div class="footer">
12
+ <ul>
13
+ <li><a href="./">索引</a></li>
14
+ </ul>
15
+
16
+ </div>
17
+ </body>
18
+
19
+ <h1><a name="label-0" id="label-0">Cairo::UserFontImmutableクラス</a></h1><!-- RDLabel: "Cairo::UserFontImmutableクラス" -->
20
+ <p><em>Since 1.7</em>: ユーザフォントが変更不可のときに発生します。</p>
21
+ <h2><a name="label-1" id="label-1">オブジェクト階層</a></h2><!-- RDLabel: "オブジェクト階層" -->
22
+ <ul>
23
+ <li>Object
24
+ <ul>
25
+ <li>Exception
26
+ <ul>
27
+ <li>StandardError
28
+ <ul>
29
+ <li><a href="cairo-error.html">Cairo::Error</a>
30
+ <ul>
31
+ <li>Cairo::UserFontImmutable</li>
32
+ </ul></li>
33
+ </ul></li>
34
+ </ul></li>
35
+ </ul></li>
36
+ </ul>
37
+ <h2><a name="label-2" id="label-2">参考</a></h2><!-- RDLabel: "参考" -->
38
+ <ul>
39
+ <li><a href="cairo-user-font-face.html">Cairo::UserFontFace</a></li>
40
+ </ul>
41
+ <h2><a name="label-3" id="label-3">変更履歴</a></h2><!-- RDLabel: "変更履歴" -->
42
+ <ul>
43
+ <li>2008-08-17: kou: スタート。</li>
44
+ </ul>
45
+
46
+ <div class="footer">
47
+ <ul>
48
+ <li><a href="./">索引</a></li>
49
+ </ul>
50
+
51
+ </div>
52
+ </body>
53
+
54
+ </html>