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.
- data/ChangeLog +285 -0
- data/NEWS +33 -0
- data/README +15 -4
- data/Rakefile +3 -0
- data/cairo/bin/libcairo-2.dll +0 -0
- data/cairo/bin/libpng12-0.dll +0 -0
- data/cairo/include/{libpng13/png.h → png.h} +285 -135
- data/cairo/include/{libpng13/pngconf.h → pngconf.h} +116 -72
- data/cairo/lib/cairo.lib +0 -0
- data/cairo/lib/libcairo.dll.a +0 -0
- data/cairo/lib/libpng.def +361 -371
- data/cairo/lib/libpng.lib +0 -0
- data/cairo/lib/libpng12.dll.a +0 -0
- data/cairo/lib/pkgconfig/cairo-pdf.pc +1 -1
- data/cairo/lib/pkgconfig/cairo-png.pc +2 -2
- data/cairo/lib/pkgconfig/cairo-ps.pc +1 -1
- data/cairo/lib/pkgconfig/cairo-svg.pc +1 -1
- data/cairo/lib/pkgconfig/cairo-win32-font.pc +1 -1
- data/cairo/lib/pkgconfig/cairo-win32.pc +1 -1
- data/cairo/lib/pkgconfig/cairo.pc +2 -2
- data/cairo/lib/pkgconfig/libpng.pc +10 -14
- data/cairo/lib/pkgconfig/libpng12.pc +10 -0
- data/cairo/make/{cairo-1.6.4-1.sh → cairo-1.6.4-2.sh} +3 -3
- data/cairo/make/libpng-1.2.29.sh +35 -0
- data/cairo/manifest/cairo-1.6.4-2.mft +6 -0
- data/cairo/manifest/{cairo-dev-1.6.4-1.mft → cairo-dev-1.6.4-2.mft} +2 -2
- data/cairo/manifest/libpng-1.2.29.mft +2 -0
- data/cairo/manifest/libpng-dev-1.2.29.mft +12 -0
- data/cairo/share/doc/{cairo-1.6.4-1 → cairo-1.6.4-2}/COPYING +0 -0
- data/cairo/share/doc/{cairo-1.6.4-1 → cairo-1.6.4-2}/COPYING-LGPL-2.1 +0 -0
- data/cairo/share/doc/{cairo-1.6.4-1 → cairo-1.6.4-2}/COPYING-MPL-1.1 +0 -0
- data/cairo/share/man/man3/libpng.3 +3680 -0
- data/cairo/share/man/man3/libpngpf.3 +274 -0
- data/cairo/share/man/man5/png.5 +74 -0
- data/doc/en/cairo-antialias.html +0 -3
- data/doc/en/cairo-clip-not-representable-error.html +0 -3
- data/doc/en/cairo-color-base.html +0 -3
- data/doc/en/cairo-color-cmyk.html +0 -3
- data/doc/en/cairo-color-hsv.html +0 -3
- data/doc/en/cairo-color-rgb.html +0 -3
- data/doc/en/cairo-color-x11.html +0 -3
- data/doc/en/cairo-color.html +0 -3
- data/doc/en/cairo-content.html +0 -3
- data/doc/en/cairo-context-blur.html +0 -3
- data/doc/en/cairo-context-circle.html +0 -3
- data/doc/en/cairo-context-color.html +0 -3
- data/doc/en/cairo-context-path.html +0 -3
- data/doc/en/cairo-context-rectangle.html +0 -3
- data/doc/en/cairo-context-triangle.html +0 -3
- data/doc/en/cairo-context.html +119 -102
- data/doc/en/cairo-error.html +0 -3
- data/doc/en/cairo-extend.html +0 -3
- data/doc/en/cairo-file-not-found.html +0 -3
- data/doc/en/cairo-fill-rule.html +0 -3
- data/doc/en/cairo-filter.html +0 -3
- data/doc/en/cairo-font-extents.html +67 -12
- data/doc/en/cairo-font-face.html +0 -3
- data/doc/en/cairo-font-options.html +26 -14
- data/doc/en/cairo-font-slant.html +0 -3
- data/doc/en/cairo-font-type-mismatch.html +47 -0
- data/doc/en/cairo-font-weight.html +0 -3
- data/doc/en/cairo-format.html +0 -3
- data/doc/en/cairo-glyph.html +0 -3
- data/doc/en/cairo-gradient-pattern.html +0 -3
- data/doc/en/cairo-hint-metrics.html +0 -3
- data/doc/en/cairo-hint-style.html +0 -3
- data/doc/en/cairo-image-surface.html +0 -3
- data/doc/en/cairo-invalid-clusters.html +47 -0
- data/doc/en/cairo-invalid-content-error.html +0 -3
- data/doc/en/cairo-invalid-dash-error.html +0 -3
- data/doc/en/cairo-invalid-dsc-comment-error.html +0 -3
- data/doc/en/cairo-invalid-format-error.html +0 -3
- data/doc/en/cairo-invalid-index-error.html +0 -3
- data/doc/en/cairo-invalid-matrix-error.html +0 -3
- data/doc/en/cairo-invalid-path-data-error.html +0 -3
- data/doc/en/cairo-invalid-pop-group-error.html +0 -3
- data/doc/en/cairo-invalid-restore-error.html +0 -3
- data/doc/en/cairo-invalid-slant.html +47 -0
- data/doc/en/cairo-invalid-status-error.html +0 -3
- data/doc/en/cairo-invalid-stride-error.html +0 -3
- data/doc/en/cairo-invalid-string-error.html +0 -3
- data/doc/en/cairo-invalid-visual-error.html +0 -3
- data/doc/en/cairo-invalid-weight.html +47 -0
- data/doc/en/cairo-lcd-filter.html +39 -0
- data/doc/en/cairo-line-cap.html +0 -3
- data/doc/en/cairo-line-join.html +0 -3
- data/doc/en/cairo-linear-pattern.html +0 -3
- data/doc/en/cairo-matrix.html +43 -41
- data/doc/en/cairo-negative-count.html +47 -0
- data/doc/en/cairo-no-current-point-error.html +0 -3
- data/doc/en/cairo-null-pointer-error.html +0 -3
- data/doc/en/cairo-operator.html +0 -3
- data/doc/en/cairo-paper-parse-error.html +0 -3
- data/doc/en/cairo-paper-unknown-paper-name.html +0 -3
- data/doc/en/cairo-paper-unknown-unit.html +0 -3
- data/doc/en/cairo-paper-unrecognized-paper-description.html +0 -3
- data/doc/en/cairo-paper.html +0 -3
- data/doc/en/cairo-path-close-path.html +0 -3
- data/doc/en/cairo-path-curve-to.html +0 -3
- data/doc/en/cairo-path-data-type.html +0 -3
- data/doc/en/cairo-path-data.html +0 -3
- data/doc/en/cairo-path-line-to.html +0 -3
- data/doc/en/cairo-path-move-to.html +0 -3
- data/doc/en/cairo-path.html +0 -3
- data/doc/en/cairo-pattern-type-mismatch-error.html +0 -3
- data/doc/en/cairo-pattern.html +0 -3
- data/doc/en/cairo-pdf-surface.html +0 -3
- data/doc/en/cairo-point.html +0 -3
- data/doc/en/cairo-ps-level.html +0 -3
- data/doc/en/cairo-ps-surface.html +0 -3
- data/doc/en/cairo-quartz-image-surface.html +0 -3
- data/doc/en/cairo-quartz-surface.html +0 -3
- data/doc/en/cairo-radial-pattern.html +0 -3
- data/doc/en/cairo-read-error.html +0 -3
- data/doc/en/cairo-rectangle.html +0 -3
- data/doc/en/cairo-scaled-font.html +13 -6
- data/doc/en/cairo-solid-pattern.html +0 -3
- data/doc/en/cairo-subpixel-order.html +0 -3
- data/doc/en/cairo-surface-finished-error.html +0 -3
- data/doc/en/cairo-surface-pattern.html +0 -3
- data/doc/en/cairo-surface-type-mismatch-error.html +0 -3
- data/doc/en/cairo-surface.html +22 -15
- data/doc/en/cairo-svg-surface.html +0 -3
- data/doc/en/cairo-svg-version.html +0 -3
- data/doc/en/cairo-temp-file-error.html +0 -3
- data/doc/en/cairo-text-cluster.html +84 -0
- data/doc/en/cairo-text-extents.html +78 -13
- data/doc/en/cairo-toy-font-face.html +67 -0
- data/doc/en/cairo-user-font-error.html +47 -0
- data/doc/en/cairo-user-font-face-text-to-glyphs-data.html +94 -0
- data/doc/en/cairo-user-font-face.html +72 -0
- data/doc/en/cairo-user-font-immutable.html +47 -0
- data/doc/en/cairo-win32-printing-surface.html +0 -3
- data/doc/en/cairo-win32-surface.html +0 -3
- data/doc/en/cairo-write-error.html +0 -3
- data/doc/en/cairo.html +92 -80
- data/doc/en/index.html +327 -240
- data/doc/ja/cairo-clip-not-representable-error.html +1 -1
- data/doc/ja/cairo-color-base.html +1 -1
- data/doc/ja/cairo-color-cmyk.html +9 -9
- data/doc/ja/cairo-color-hsv.html +8 -8
- data/doc/ja/cairo-color-rgb.html +9 -9
- data/doc/ja/cairo-color.html +8 -8
- data/doc/ja/cairo-context-circle.html +1 -1
- data/doc/ja/cairo-context-color.html +1 -1
- data/doc/ja/cairo-context-path.html +2 -2
- data/doc/ja/cairo-context.html +435 -342
- data/doc/ja/cairo-font-extents.html +69 -15
- data/doc/ja/cairo-font-face.html +3 -3
- data/doc/ja/cairo-font-options.html +37 -12
- data/doc/ja/cairo-font-slant.html +1 -1
- data/doc/ja/cairo-font-type-mismatch.html +52 -0
- data/doc/ja/cairo-glyph.html +5 -5
- data/doc/ja/cairo-gradient-pattern.html +6 -6
- data/doc/ja/cairo-image-surface.html +8 -8
- data/doc/ja/cairo-invalid-clusters.html +55 -0
- data/doc/ja/cairo-invalid-restore-error.html +1 -1
- data/doc/ja/cairo-invalid-slant.html +57 -0
- data/doc/ja/cairo-invalid-weight.html +57 -0
- data/doc/ja/cairo-lcd-filter.html +63 -0
- data/doc/ja/cairo-line-join.html +1 -1
- data/doc/ja/cairo-linear-pattern.html +2 -2
- data/doc/ja/cairo-matrix.html +35 -24
- data/doc/ja/cairo-negative-count.html +52 -0
- data/doc/ja/cairo-paper-unknown-paper-name.html +2 -2
- data/doc/ja/cairo-paper-unknown-unit.html +2 -2
- data/doc/ja/cairo-paper-unrecognized-paper-description.html +1 -1
- data/doc/ja/cairo-paper.html +12 -12
- data/doc/ja/cairo-path-close-path.html +1 -1
- data/doc/ja/cairo-path-curve-to.html +1 -1
- data/doc/ja/cairo-path-data.html +8 -8
- data/doc/ja/cairo-path-line-to.html +1 -1
- data/doc/ja/cairo-path-move-to.html +1 -1
- data/doc/ja/cairo-path.html +21 -21
- data/doc/ja/cairo-pattern.html +4 -4
- data/doc/ja/cairo-pdf-surface.html +2 -2
- data/doc/ja/cairo-point.html +5 -5
- data/doc/ja/cairo-ps-level.html +2 -2
- data/doc/ja/cairo-ps-surface.html +6 -6
- data/doc/ja/cairo-quartz-image-surface.html +2 -2
- data/doc/ja/cairo-quartz-surface.html +3 -3
- data/doc/ja/cairo-radial-pattern.html +2 -2
- data/doc/ja/cairo-rectangle.html +5 -5
- data/doc/ja/cairo-scaled-font.html +53 -17
- data/doc/ja/cairo-solid-pattern.html +3 -3
- data/doc/ja/cairo-surface-pattern.html +2 -2
- data/doc/ja/cairo-surface.html +58 -36
- data/doc/ja/cairo-svg-surface.html +4 -4
- data/doc/ja/cairo-svg-version.html +2 -2
- data/doc/ja/cairo-text-cluster.html +102 -0
- data/doc/ja/cairo-text-extents.html +84 -22
- data/doc/ja/cairo-toy-font-face.html +107 -0
- data/doc/ja/cairo-user-font-error.html +55 -0
- data/doc/ja/cairo-user-font-face-text-to-glyphs-data.html +155 -0
- data/doc/ja/cairo-user-font-face.html +268 -0
- data/doc/ja/cairo-user-font-immutable.html +54 -0
- data/doc/ja/cairo-win32-printing-surface.html +3 -3
- data/doc/ja/cairo-win32-surface.html +4 -4
- data/doc/ja/cairo.html +110 -77
- data/doc/ja/index.html +292 -205
- data/extconf.rb +3 -1
- data/misc/update-colors.rb +0 -0
- data/pkg-config.rb +54 -28
- data/samples/agg/aa_test.rb +0 -0
- data/samples/blur.rb +0 -0
- data/samples/png.rb +0 -0
- data/samples/scalable.rb +0 -0
- data/samples/text-on-path.rb +0 -0
- data/samples/text2.rb +0 -0
- data/src/cairo.def +8 -0
- data/src/cairo.so +0 -0
- data/src/lib/cairo.rb +12 -7
- data/src/lib/cairo/constants.rb +1 -0
- data/src/libruby-cairo.a +0 -0
- data/src/rb_cairo.c +25 -3
- data/src/rb_cairo.h +29 -18
- data/src/rb_cairo_constants.c +39 -10
- data/src/rb_cairo_context.c +156 -15
- data/src/rb_cairo_exception.c +143 -3
- data/src/rb_cairo_font_extents.c +81 -6
- data/src/rb_cairo_font_face.c +646 -4
- data/src/rb_cairo_font_options.c +24 -2
- data/src/rb_cairo_glyph.c +5 -3
- data/src/rb_cairo_matrix.c +17 -1
- data/src/rb_cairo_pattern.c +4 -4
- data/src/rb_cairo_private.c +169 -5
- data/src/rb_cairo_private.h +45 -3
- data/src/rb_cairo_scaled_font.c +61 -3
- data/src/rb_cairo_surface.c +174 -59
- data/src/rb_cairo_text_cluster.c +151 -0
- data/src/rb_cairo_text_extents.c +85 -2
- data/test-unit/Rakefile +30 -0
- data/test-unit/bin/testrb +5 -0
- data/test-unit/lib/test/unit.rb +280 -0
- data/test-unit/lib/test/unit/assertionfailederror.rb +14 -0
- data/test-unit/lib/test/unit/assertions.rb +722 -0
- data/test-unit/lib/test/unit/attribute.rb +125 -0
- data/test-unit/lib/test/unit/autorunner.rb +254 -0
- data/test-unit/lib/test/unit/collector.rb +43 -0
- data/test-unit/lib/test/unit/collector/descendant.rb +23 -0
- data/test-unit/lib/test/unit/collector/dir.rb +108 -0
- data/test-unit/lib/test/unit/collector/load.rb +135 -0
- data/test-unit/lib/test/unit/collector/objectspace.rb +34 -0
- data/test-unit/lib/test/unit/color.rb +61 -0
- data/test-unit/lib/test/unit/diff.rb +524 -0
- data/test-unit/lib/test/unit/error.rb +124 -0
- data/test-unit/lib/test/unit/exceptionhandler.rb +39 -0
- data/test-unit/lib/test/unit/failure.rb +110 -0
- data/test-unit/lib/test/unit/fixture.rb +185 -0
- data/test-unit/lib/test/unit/notification.rb +125 -0
- data/test-unit/lib/test/unit/omission.rb +143 -0
- data/test-unit/lib/test/unit/pending.rb +146 -0
- data/test-unit/lib/test/unit/priority.rb +146 -0
- data/test-unit/lib/test/unit/runner/console.rb +46 -0
- data/test-unit/lib/test/unit/runner/emacs.rb +8 -0
- data/test-unit/lib/test/unit/testcase.rb +281 -0
- data/test-unit/lib/test/unit/testresult.rb +89 -0
- data/test-unit/lib/test/unit/testsuite.rb +110 -0
- data/test-unit/lib/test/unit/ui/console/outputlevel.rb +14 -0
- data/test-unit/lib/test/unit/ui/console/testrunner.rb +195 -0
- data/test-unit/lib/test/unit/ui/emacs/testrunner.rb +49 -0
- data/test-unit/lib/test/unit/ui/testrunner.rb +20 -0
- data/test-unit/lib/test/unit/ui/testrunnermediator.rb +77 -0
- data/test-unit/lib/test/unit/ui/testrunnerutilities.rb +41 -0
- data/test-unit/lib/test/unit/util/backtracefilter.rb +41 -0
- data/test-unit/lib/test/unit/util/observable.rb +90 -0
- data/test-unit/lib/test/unit/util/procwrapper.rb +48 -0
- data/test-unit/lib/test/unit/version.rb +7 -0
- data/test-unit/sample/adder.rb +13 -0
- data/test-unit/sample/subtracter.rb +12 -0
- data/test-unit/sample/tc_adder.rb +18 -0
- data/test-unit/sample/tc_subtracter.rb +18 -0
- data/test-unit/sample/ts_examples.rb +7 -0
- data/test-unit/test/collector/test_descendant.rb +135 -0
- data/test-unit/test/collector/test_dir.rb +406 -0
- data/test-unit/test/collector/test_load.rb +333 -0
- data/test-unit/test/collector/test_objectspace.rb +98 -0
- data/test-unit/test/run-test.rb +13 -0
- data/test-unit/test/test_assertions.rb +693 -0
- data/test-unit/test/test_attribute.rb +86 -0
- data/test-unit/test/test_color.rb +37 -0
- data/test-unit/test/test_diff.rb +477 -0
- data/test-unit/test/test_emacs_runner.rb +60 -0
- data/test-unit/test/test_error.rb +26 -0
- data/test-unit/test/test_failure.rb +33 -0
- data/test-unit/test/test_fixture.rb +252 -0
- data/test-unit/test/test_notification.rb +33 -0
- data/test-unit/test/test_omission.rb +81 -0
- data/test-unit/test/test_pending.rb +70 -0
- data/test-unit/test/test_priority.rb +89 -0
- data/test-unit/test/test_testcase.rb +430 -0
- data/test-unit/test/test_testresult.rb +113 -0
- data/test-unit/test/test_testsuite.rb +129 -0
- data/test-unit/test/testunit_test_util.rb +14 -0
- data/test-unit/test/ui/test_testrunmediator.rb +20 -0
- data/test-unit/test/util/test_backtracefilter.rb +41 -0
- data/test-unit/test/util/test_observable.rb +102 -0
- data/test-unit/test/util/test_procwrapper.rb +36 -0
- data/test/cairo-test-utils.rb +18 -0
- data/test/run-test.rb +14 -1
- data/test/test_constants.rb +19 -0
- data/test/test_context.rb +117 -0
- data/test/test_exception.rb +27 -0
- data/test/test_font_extents.rb +36 -0
- data/test/test_font_face.rb +244 -0
- data/test/test_font_options.rb +32 -0
- data/test/test_pkg_config.rb +3 -2
- data/test/test_scaled_font.rb +34 -0
- data/test/test_surface.rb +41 -0
- data/test/test_text_cluster.rb +32 -0
- data/test/test_text_extents.rb +40 -0
- data/test/test_text_to_glyphs_data.rb +47 -0
- metadata +129 -109
- data/cairo/bin/libpng13.dll +0 -0
- data/cairo/lib/libpng13.dll.a +0 -0
- data/cairo/lib/pkgconfig/libpng13.pc +0 -14
- data/cairo/manifest/cairo-1.6.4-1.mft +0 -6
- data/cairo/manifest/libpng-dev-1.2.8.mft +0 -7
- data/doc/en/cairo-antialias.rd +0 -16
- data/doc/en/cairo-clip-not-representable-error.rd +0 -17
- data/doc/en/cairo-color-base.rd +0 -38
- data/doc/en/cairo-color-cmyk.rd +0 -107
- data/doc/en/cairo-color-hsv.rd +0 -91
- data/doc/en/cairo-color-rgb.rd +0 -95
- data/doc/en/cairo-color-x11.rd +0 -151
- data/doc/en/cairo-color.rd +0 -213
- data/doc/en/cairo-content.rd +0 -15
- data/doc/en/cairo-context-blur.rd +0 -15
- data/doc/en/cairo-context-circle.rd +0 -15
- data/doc/en/cairo-context-color.rd +0 -15
- data/doc/en/cairo-context-path.rd +0 -19
- data/doc/en/cairo-context-rectangle.rd +0 -15
- data/doc/en/cairo-context-triangle.rd +0 -15
- data/doc/en/cairo-context.rd +0 -491
- data/doc/en/cairo-error.rd +0 -16
- data/doc/en/cairo-extend.rd +0 -16
- data/doc/en/cairo-file-not-found.rd +0 -17
- data/doc/en/cairo-fill-rule.rd +0 -14
- data/doc/en/cairo-filter.rd +0 -18
- data/doc/en/cairo-font-extents.rd +0 -40
- data/doc/en/cairo-font-face.rd +0 -14
- data/doc/en/cairo-font-options.rd +0 -94
- data/doc/en/cairo-font-slant.rd +0 -15
- data/doc/en/cairo-font-weight.rd +0 -14
- data/doc/en/cairo-format.rd +0 -22
- data/doc/en/cairo-glyph.rd +0 -62
- data/doc/en/cairo-gradient-pattern.rd +0 -41
- data/doc/en/cairo-hint-metrics.rd +0 -15
- data/doc/en/cairo-hint-style.rd +0 -17
- data/doc/en/cairo-image-surface.rd +0 -47
- data/doc/en/cairo-invalid-content-error.rd +0 -17
- data/doc/en/cairo-invalid-dash-error.rd +0 -17
- data/doc/en/cairo-invalid-dsc-comment-error.rd +0 -17
- data/doc/en/cairo-invalid-format-error.rd +0 -17
- data/doc/en/cairo-invalid-index-error.rd +0 -17
- data/doc/en/cairo-invalid-matrix-error.rd +0 -17
- data/doc/en/cairo-invalid-path-data-error.rd +0 -17
- data/doc/en/cairo-invalid-pop-group-error.rd +0 -17
- data/doc/en/cairo-invalid-restore-error.rd +0 -17
- data/doc/en/cairo-invalid-status-error.rd +0 -17
- data/doc/en/cairo-invalid-stride-error.rd +0 -17
- data/doc/en/cairo-invalid-string-error.rd +0 -17
- data/doc/en/cairo-invalid-visual-error.rd +0 -17
- data/doc/en/cairo-line-cap.rd +0 -15
- data/doc/en/cairo-line-join.rd +0 -15
- data/doc/en/cairo-linear-pattern.rd +0 -28
- data/doc/en/cairo-matrix.rd +0 -186
- data/doc/en/cairo-no-current-point-error.rd +0 -17
- data/doc/en/cairo-null-pointer-error.rd +0 -17
- data/doc/en/cairo-operator.rd +0 -26
- data/doc/en/cairo-paper-parse-error.rd +0 -17
- data/doc/en/cairo-paper-unknown-paper-name.rd +0 -30
- data/doc/en/cairo-paper-unknown-unit.rd +0 -30
- data/doc/en/cairo-paper-unrecognized-paper-description.rd +0 -30
- data/doc/en/cairo-paper.rd +0 -141
- data/doc/en/cairo-path-close-path.rd +0 -21
- data/doc/en/cairo-path-curve-to.rd +0 -21
- data/doc/en/cairo-path-data-type.rd +0 -16
- data/doc/en/cairo-path-data.rd +0 -62
- data/doc/en/cairo-path-line-to.rd +0 -21
- data/doc/en/cairo-path-move-to.rd +0 -21
- data/doc/en/cairo-path.rd +0 -109
- data/doc/en/cairo-pattern-type-mismatch-error.rd +0 -17
- data/doc/en/cairo-pattern.rd +0 -62
- data/doc/en/cairo-pdf-surface.rd +0 -27
- data/doc/en/cairo-point.rd +0 -42
- data/doc/en/cairo-ps-level.rd +0 -24
- data/doc/en/cairo-ps-surface.rd +0 -55
- data/doc/en/cairo-quartz-image-surface.rd +0 -27
- data/doc/en/cairo-quartz-surface.rd +0 -27
- data/doc/en/cairo-radial-pattern.rd +0 -28
- data/doc/en/cairo-read-error.rd +0 -17
- data/doc/en/cairo-rectangle.rd +0 -54
- data/doc/en/cairo-scaled-font.rd +0 -50
- data/doc/en/cairo-solid-pattern.rd +0 -31
- data/doc/en/cairo-subpixel-order.rd +0 -17
- data/doc/en/cairo-surface-finished-error.rd +0 -17
- data/doc/en/cairo-surface-pattern.rd +0 -27
- data/doc/en/cairo-surface-type-mismatch-error.rd +0 -17
- data/doc/en/cairo-surface.rd +0 -72
- data/doc/en/cairo-svg-surface.rd +0 -44
- data/doc/en/cairo-svg-version.rd +0 -24
- data/doc/en/cairo-temp-file-error.rd +0 -17
- data/doc/en/cairo-text-extents.rd +0 -44
- data/doc/en/cairo-win32-printing-surface.rd +0 -27
- data/doc/en/cairo-win32-surface.rd +0 -31
- data/doc/en/cairo-write-error.rd +0 -17
- data/doc/en/cairo.rd +0 -95
- data/doc/en/index.rd +0 -1051
- data/samples/agg/aa_demo.rb +0 -47
@@ -37,7 +37,7 @@
|
|
37
37
|
</ul>
|
38
38
|
<h2><a name="label-2" id="label-2">参考</a></h2><!-- RDLabel: "参考" -->
|
39
39
|
<ul>
|
40
|
-
<li><a href="cairo-context.html#label-
|
40
|
+
<li><a href="cairo-context.html#label-19">Cairo::Context#clip_rectangle_list</a></li>
|
41
41
|
<li><a href="index.html#label-0">索引</a></li>
|
42
42
|
</ul>
|
43
43
|
<h2><a name="label-3" id="label-3">変更履歴</a></h2><!-- RDLabel: "変更履歴" -->
|
@@ -42,7 +42,7 @@
|
|
42
42
|
<dd>
|
43
43
|
アルファ値を返します。
|
44
44
|
<ul>
|
45
|
-
<li
|
45
|
+
<li>戻り値: アルファ値</li>
|
46
46
|
</ul></dd>
|
47
47
|
<dt><a name="label-7" id="label-7"><code>alpha=(<var>value</var>)</code></a></dt><!-- RDLabel: "alpha=" -->
|
48
48
|
<dt><a name="label-8" id="label-8"><code>a=(<var>value</var>)</code></a></dt><!-- RDLabel: "a=" -->
|
@@ -41,7 +41,7 @@ CMYKで表現した色を生成します。
|
|
41
41
|
<li>y: 黄色</li>
|
42
42
|
<li>k: キー・プレート(黒)</li>
|
43
43
|
<li>a: アルファ値</li>
|
44
|
-
<li
|
44
|
+
<li>戻り値: 生成した色</li>
|
45
45
|
</ul></dd>
|
46
46
|
</dl>
|
47
47
|
<h2><a name="label-4" id="label-4">インタンスメソッド</a></h2><!-- RDLabel: "インタンスメソッド" -->
|
@@ -51,7 +51,7 @@ CMYKで表現した色を生成します。
|
|
51
51
|
<dd>
|
52
52
|
シアンの値を返します。
|
53
53
|
<ul>
|
54
|
-
<li
|
54
|
+
<li>戻り値: シアンの値</li>
|
55
55
|
</ul></dd>
|
56
56
|
<dt><a name="label-7" id="label-7"><code>cyan=(<var>value</var>)</code></a></dt><!-- RDLabel: "cyan=" -->
|
57
57
|
<dt><a name="label-8" id="label-8"><code>c=(<var>value</var>)</code></a></dt><!-- RDLabel: "c=" -->
|
@@ -65,7 +65,7 @@ CMYKで表現した色を生成します。
|
|
65
65
|
<dd>
|
66
66
|
マゼンタの値を返します。
|
67
67
|
<ul>
|
68
|
-
<li
|
68
|
+
<li>戻り値: マゼンタの値</li>
|
69
69
|
</ul></dd>
|
70
70
|
<dt><a name="label-11" id="label-11"><code>magenta=(<var>value</var>)</code></a></dt><!-- RDLabel: "magenta=" -->
|
71
71
|
<dt><a name="label-12" id="label-12"><code>m=(<var>value</var>)</code></a></dt><!-- RDLabel: "m=" -->
|
@@ -79,7 +79,7 @@ CMYKで表現した色を生成します。
|
|
79
79
|
<dd>
|
80
80
|
黄色の値を返します。
|
81
81
|
<ul>
|
82
|
-
<li
|
82
|
+
<li>戻り値: 黄色の値</li>
|
83
83
|
</ul></dd>
|
84
84
|
<dt><a name="label-15" id="label-15"><code>yellow=(<var>value</var>)</code></a></dt><!-- RDLabel: "yellow=" -->
|
85
85
|
<dt><a name="label-16" id="label-16"><code>y=(<var>value</var>)</code></a></dt><!-- RDLabel: "y=" -->
|
@@ -93,7 +93,7 @@ CMYKで表現した色を生成します。
|
|
93
93
|
<dd>
|
94
94
|
キー・プレートの値を返します。
|
95
95
|
<ul>
|
96
|
-
<li
|
96
|
+
<li>戻り値: キー・プレートの値</li>
|
97
97
|
</ul></dd>
|
98
98
|
<dt><a name="label-19" id="label-19"><code>key_plate=(<var>value</var>)</code></a></dt><!-- RDLabel: "key_plate=" -->
|
99
99
|
<dt><a name="label-20" id="label-20"><code>k=(<var>value</var>)</code></a></dt><!-- RDLabel: "k=" -->
|
@@ -107,26 +107,26 @@ CMYKで表現した色を生成します。
|
|
107
107
|
<dd>
|
108
108
|
[cyan, magenta, yellow, key_plate, alpha]を返します。
|
109
109
|
<ul>
|
110
|
-
<li
|
110
|
+
<li>戻り値: シアン、マゼンタ、黄色、キー・プレート、アル
|
111
111
|
ファ値の配列</li>
|
112
112
|
</ul></dd>
|
113
113
|
<dt><a name="label-23" id="label-23"><code>to_cmyk</code></a></dt><!-- RDLabel: "to_cmyk" -->
|
114
114
|
<dd>
|
115
115
|
複製を返します。
|
116
116
|
<ul>
|
117
|
-
<li
|
117
|
+
<li>戻り値: 自分自身の複製</li>
|
118
118
|
</ul></dd>
|
119
119
|
<dt><a name="label-24" id="label-24"><code>to_hsv</code></a></dt><!-- RDLabel: "to_hsv" -->
|
120
120
|
<dd>
|
121
121
|
HSV形式に変換した色を返します。
|
122
122
|
<ul>
|
123
|
-
<li
|
123
|
+
<li>戻り値: <a href="cairo-color-hsv.html">Cairo::Color::HSV</a>オブジェクト</li>
|
124
124
|
</ul></dd>
|
125
125
|
<dt><a name="label-25" id="label-25"><code>to_rgb</code></a></dt><!-- RDLabel: "to_rgb" -->
|
126
126
|
<dd>
|
127
127
|
RGB形式に変換した色を返します。
|
128
128
|
<ul>
|
129
|
-
<li
|
129
|
+
<li>戻り値: <a href="cairo-color-rgb.html">Cairo::Color::RGB</a>オブジェクト</li>
|
130
130
|
</ul></dd>
|
131
131
|
</dl>
|
132
132
|
<h2><a name="label-26" id="label-26">参考</a></h2><!-- RDLabel: "参考" -->
|
data/doc/ja/cairo-color-hsv.html
CHANGED
@@ -39,7 +39,7 @@ HSVで表現した色を生成します。
|
|
39
39
|
<li>s: 彩度</li>
|
40
40
|
<li>v: 明度</li>
|
41
41
|
<li>a: アルファ値</li>
|
42
|
-
<li
|
42
|
+
<li>戻り値: 生成した色</li>
|
43
43
|
</ul></dd>
|
44
44
|
</dl>
|
45
45
|
<h2><a name="label-4" id="label-4">インタンスメソッド</a></h2><!-- RDLabel: "インタンスメソッド" -->
|
@@ -49,7 +49,7 @@ HSVで表現した色を生成します。
|
|
49
49
|
<dd>
|
50
50
|
色相の値返します。
|
51
51
|
<ul>
|
52
|
-
<li
|
52
|
+
<li>戻り値: 色相の値</li>
|
53
53
|
</ul></dd>
|
54
54
|
<dt><a name="label-7" id="label-7"><code>hue=(<var>value</var>)</code></a></dt><!-- RDLabel: "hue=" -->
|
55
55
|
<dt><a name="label-8" id="label-8"><code>h=(<var>value</var>)</code></a></dt><!-- RDLabel: "h=" -->
|
@@ -63,7 +63,7 @@ HSVで表現した色を生成します。
|
|
63
63
|
<dd>
|
64
64
|
彩度の値を返します。
|
65
65
|
<ul>
|
66
|
-
<li
|
66
|
+
<li>戻り値: 彩度の値</li>
|
67
67
|
</ul></dd>
|
68
68
|
<dt><a name="label-11" id="label-11"><code>saturation=(<var>value</var>)</code></a></dt><!-- RDLabel: "saturation=" -->
|
69
69
|
<dt><a name="label-12" id="label-12"><code>s=(<var>value</var>)</code></a></dt><!-- RDLabel: "s=" -->
|
@@ -77,7 +77,7 @@ HSVで表現した色を生成します。
|
|
77
77
|
<dd>
|
78
78
|
明度の値を返します。
|
79
79
|
<ul>
|
80
|
-
<li
|
80
|
+
<li>戻り値: 明度の値</li>
|
81
81
|
</ul></dd>
|
82
82
|
<dt><a name="label-15" id="label-15"><code>value=(<var>value</var>)</code></a></dt><!-- RDLabel: "value=" -->
|
83
83
|
<dt><a name="label-16" id="label-16"><code>v=(<var>value</var>)</code></a></dt><!-- RDLabel: "v=" -->
|
@@ -91,25 +91,25 @@ HSVで表現した色を生成します。
|
|
91
91
|
<dd>
|
92
92
|
[hue, saturation, value, alpha]を返します。
|
93
93
|
<ul>
|
94
|
-
<li
|
94
|
+
<li>戻り値: 色相、彩度、明度、アルファ値の配列</li>
|
95
95
|
</ul></dd>
|
96
96
|
<dt><a name="label-19" id="label-19"><code>to_cmyk</code></a></dt><!-- RDLabel: "to_cmyk" -->
|
97
97
|
<dd>
|
98
98
|
CMYK形式に変換した色を返します。
|
99
99
|
<ul>
|
100
|
-
<li
|
100
|
+
<li>戻り値: <a href="cairo-color-cmyk.html">Cairo::Color::CMYK</a>オブジェクト</li>
|
101
101
|
</ul></dd>
|
102
102
|
<dt><a name="label-20" id="label-20"><code>to_hsv</code></a></dt><!-- RDLabel: "to_hsv" -->
|
103
103
|
<dd>
|
104
104
|
複製を返します。
|
105
105
|
<ul>
|
106
|
-
<li
|
106
|
+
<li>戻り値: 自分自身の複製</li>
|
107
107
|
</ul></dd>
|
108
108
|
<dt><a name="label-21" id="label-21"><code>to_rgb</code></a></dt><!-- RDLabel: "to_rgb" -->
|
109
109
|
<dd>
|
110
110
|
RGB形式に変換した色を返します。
|
111
111
|
<ul>
|
112
|
-
<li
|
112
|
+
<li>戻り値: <a href="cairo-color-rgb.html">Cairo::Color::RGB</a>オブジェクト</li>
|
113
113
|
</ul></dd>
|
114
114
|
</dl>
|
115
115
|
<h2><a name="label-22" id="label-22">参考</a></h2><!-- RDLabel: "参考" -->
|
data/doc/ja/cairo-color-rgb.html
CHANGED
@@ -39,7 +39,7 @@ RGBで表現した色を生成します。
|
|
39
39
|
<li>g: 緑</li>
|
40
40
|
<li>b: 青</li>
|
41
41
|
<li>a: アルファ値</li>
|
42
|
-
<li
|
42
|
+
<li>戻り値: 生成した色</li>
|
43
43
|
</ul></dd>
|
44
44
|
</dl>
|
45
45
|
<h2><a name="label-4" id="label-4">インタンスメソッド</a></h2><!-- RDLabel: "インタンスメソッド" -->
|
@@ -49,7 +49,7 @@ RGBで表現した色を生成します。
|
|
49
49
|
<dd>
|
50
50
|
赤の値を返します。
|
51
51
|
<ul>
|
52
|
-
<li
|
52
|
+
<li>戻り値: 赤の値</li>
|
53
53
|
</ul></dd>
|
54
54
|
<dt><a name="label-7" id="label-7"><code>red=(<var>value</var>)</code></a></dt><!-- RDLabel: "red=" -->
|
55
55
|
<dt><a name="label-8" id="label-8"><code>r=(<var>value</var>)</code></a></dt><!-- RDLabel: "r=" -->
|
@@ -63,7 +63,7 @@ RGBで表現した色を生成します。
|
|
63
63
|
<dd>
|
64
64
|
緑の値を返します。
|
65
65
|
<ul>
|
66
|
-
<li
|
66
|
+
<li>戻り値: 緑の値</li>
|
67
67
|
</ul></dd>
|
68
68
|
<dt><a name="label-11" id="label-11"><code>green=(<var>value</var>)</code></a></dt><!-- RDLabel: "green=" -->
|
69
69
|
<dt><a name="label-12" id="label-12"><code>g=(<var>value</var>)</code></a></dt><!-- RDLabel: "g=" -->
|
@@ -77,7 +77,7 @@ RGBで表現した色を生成します。
|
|
77
77
|
<dd>
|
78
78
|
青の値を返します。
|
79
79
|
<ul>
|
80
|
-
<li
|
80
|
+
<li>戻り値: 青の値</li>
|
81
81
|
</ul></dd>
|
82
82
|
<dt><a name="label-15" id="label-15"><code>blue=(<var>value</var>)</code></a></dt><!-- RDLabel: "blue=" -->
|
83
83
|
<dt><a name="label-16" id="label-16"><code>b=(<var>value</var>)</code></a></dt><!-- RDLabel: "b=" -->
|
@@ -91,25 +91,25 @@ RGBで表現した色を生成します。
|
|
91
91
|
<dd>
|
92
92
|
[red, green, blue, alpha]を返します。
|
93
93
|
<ul>
|
94
|
-
<li
|
94
|
+
<li>戻り値: 赤、緑、青、アルファ値の配列</li>
|
95
95
|
</ul></dd>
|
96
96
|
<dt><a name="label-19" id="label-19"><code>to_cmyk</code></a></dt><!-- RDLabel: "to_cmyk" -->
|
97
97
|
<dd>
|
98
98
|
CMYK形式に変換した色を返します。
|
99
99
|
<ul>
|
100
|
-
<li
|
100
|
+
<li>戻り値: <a href="cairo-color-cmyk.html">Cairo::Color::CMYK</a>オブジェクト</li>
|
101
101
|
</ul></dd>
|
102
102
|
<dt><a name="label-20" id="label-20"><code>to_hsv</code></a></dt><!-- RDLabel: "to_hsv" -->
|
103
103
|
<dd>
|
104
104
|
HSV形式に変換した色を返します。
|
105
105
|
<ul>
|
106
|
-
<li
|
106
|
+
<li>戻り値: <a href="cairo-color-hsv.html">Cairo::Color::HSV</a>オブジェクト</li>
|
107
107
|
</ul></dd>
|
108
108
|
<dt><a name="label-21" id="label-21"><code>to_rgb</code></a></dt><!-- RDLabel: "to_rgb" -->
|
109
109
|
<dd>
|
110
110
|
複製を返します。
|
111
111
|
<ul>
|
112
|
-
<li
|
112
|
+
<li>戻り値: 自分自身の複製</li>
|
113
113
|
</ul></dd>
|
114
114
|
<dt><a name="label-22" id="label-22"><code>to_s</code></a></dt><!-- RDLabel: "to_s" -->
|
115
115
|
<dd>
|
@@ -119,7 +119,7 @@ BBは青を、AAはアルファ値を、それぞれ16進数2桁で表現した
|
|
119
119
|
<p>例えば、赤は"#FF0000FF"に、黒は"#FFFFFFFF"に、白は
|
120
120
|
"#000000FF"になります。</p>
|
121
121
|
<ul>
|
122
|
-
<li
|
122
|
+
<li>戻り値: #RRGGBBAA形式の文字列</li>
|
123
123
|
</ul></dd>
|
124
124
|
</dl>
|
125
125
|
<h2><a name="label-23" id="label-23">参考</a></h2><!-- RDLabel: "参考" -->
|
data/doc/ja/cairo-color.html
CHANGED
@@ -32,21 +32,21 @@
|
|
32
32
|
<dd>
|
33
33
|
RGB形式の色を生成します。
|
34
34
|
<ul>
|
35
|
-
<li
|
35
|
+
<li>戻り値: <a href="cairo-color-rgb.html">Cairo::Color::RGB</a>オブジェクト</li>
|
36
36
|
</ul></dd>
|
37
37
|
<dt><a name="label-6" id="label-6"><code>Cairo::Color.parse([:<var>cmyk</var>, <var>c</var>, <var>m</var>, <var>y</var>, <var>k</var>, <var>a</var>=<var>1</var>.<var>0</var>])</code></a></dt><!-- RDLabel: "Cairo::Color.parse" -->
|
38
38
|
<dt><a name="label-7" id="label-7"><code>Cairo::Color.parse([:<var>cmyka</var>, <var>c</var>, <var>m</var>, <var>y</var>, <var>k</var>, <var>a</var>=<var>1</var>.<var>0</var>])</code></a></dt><!-- RDLabel: "Cairo::Color.parse" -->
|
39
39
|
<dd>
|
40
40
|
CMYK形式の色を生成します。
|
41
41
|
<ul>
|
42
|
-
<li
|
42
|
+
<li>戻り値: <a href="cairo-color-cmyk.html">Cairo::Color::CMYK</a>オブジェクト</li>
|
43
43
|
</ul></dd>
|
44
44
|
<dt><a name="label-8" id="label-8"><code>Cairo::Color.parse([:<var>hsv</var>, <var>h</var>, <var>s</var>, <var>v</var>, <var>a</var>=<var>1</var>.<var>0</var>])</code></a></dt><!-- RDLabel: "Cairo::Color.parse" -->
|
45
45
|
<dt><a name="label-9" id="label-9"><code>Cairo::Color.parse([:<var>hsva</var>, <var>h</var>, <var>s</var>, <var>v</var>, <var>a</var>=<var>1</var>.<var>0</var>])</code></a></dt><!-- RDLabel: "Cairo::Color.parse" -->
|
46
46
|
<dd>
|
47
47
|
HSV形式の色を生成します。
|
48
48
|
<ul>
|
49
|
-
<li
|
49
|
+
<li>戻り値: <a href="cairo-color-hsv.html">Cairo::Color::HSV</a>オブジェクト</li>
|
50
50
|
</ul></dd>
|
51
51
|
<dt><a name="label-10" id="label-10"><code>Cairo::Color.parse("#<var>RGB</var>")</code></a></dt><!-- RDLabel: "Cairo::Color.parse" -->
|
52
52
|
<dt><a name="label-11" id="label-11"><code>Cairo::Color.parse("#<var>RGBA</var>")</code></a></dt><!-- RDLabel: "Cairo::Color.parse" -->
|
@@ -59,7 +59,7 @@ HSV形式の色を生成します。
|
|
59
59
|
ます。"#"からはじまるのに、上記以外のフォーマットの場合
|
60
60
|
はArgumentErrorが発生します。
|
61
61
|
<ul>
|
62
|
-
<li
|
62
|
+
<li>戻り値: <a href="cairo-color-rgb.html">Cairo::Color::RGB</a>オブジェクト</li>
|
63
63
|
</ul></dd>
|
64
64
|
<dt><a name="label-16" id="label-16"><code>Cairo::Color.parse(<var>color_name</var>, <var>robust</var>=<var>false</var>)</code></a></dt><!-- RDLabel: "Cairo::Color.parse" -->
|
65
65
|
<dd>
|
@@ -76,7 +76,7 @@ Cairo::Color.parse("PEACH_YELLOW")
|
|
76
76
|
Cairo::Color.parse("PEACH Yellow")</pre>
|
77
77
|
<ul>
|
78
78
|
<li>color_name: 色の名前。文字列またはシンボル。</li>
|
79
|
-
<li
|
79
|
+
<li>戻り値: <a href="cairo-color-rgb.html">Cairo::Color::RGB</a>オブジェクト</li>
|
80
80
|
</ul></dd>
|
81
81
|
<dt><a name="label-17" id="label-17"><code>Cairo::Color.parse(<var>color</var>)</code></a></dt><!-- RDLabel: "Cairo::Color.parse" -->
|
82
82
|
<dd>
|
@@ -84,7 +84,7 @@ Cairo::Color.parse("PEACH Yellow")</pre>
|
|
84
84
|
を指定した場合は、その色の複製を返します。
|
85
85
|
<ul>
|
86
86
|
<li>color: <a href="cairo-color-base.html">Cairo::Color::Base</a>のサブクラスのオブジェクト</li>
|
87
|
-
<li
|
87
|
+
<li>戻り値: colorの複製</li>
|
88
88
|
</ul></dd>
|
89
89
|
<dt><a name="label-18" id="label-18"><code>Cairo::Color.parse(<var>value</var>, <var>robust</var>=<var>false</var>)</code></a></dt><!-- RDLabel: "Cairo::Color.parse" -->
|
90
90
|
<dd>
|
@@ -92,7 +92,7 @@ robustがtrueの場合はArgumentErrorが発生します。そうでな
|
|
92
92
|
い場合は、valueをそのまま返します。
|
93
93
|
<ul>
|
94
94
|
<li>value: 上記以外のオブジェクト</li>
|
95
|
-
<li
|
95
|
+
<li>戻り値: value</li>
|
96
96
|
</ul></dd>
|
97
97
|
<dt><a name="label-19" id="label-19"><code>Cairo::Color.parse_hex_color(<var>value</var>)</code></a></dt><!-- RDLabel: "Cairo::Color.parse_hex_color" -->
|
98
98
|
<dd>
|
@@ -100,7 +100,7 @@ robustがtrueの場合はArgumentErrorが発生します。そうでな
|
|
100
100
|
<a href="cairo-color.html#label-3">Cairo::Color.parse</a>を使ってください。
|
101
101
|
<ul>
|
102
102
|
<li>value: "#..."形式の文字列</li>
|
103
|
-
<li
|
103
|
+
<li>戻り値: <a href="cairo-color-rgb.html">Cairo::Color::RGB</a>オブジェクト</li>
|
104
104
|
</ul></dd>
|
105
105
|
</dl>
|
106
106
|
<h2><a name="label-20" id="label-20">定数</a></h2><!-- RDLabel: "定数" -->
|
@@ -25,7 +25,7 @@
|
|
25
25
|
<dt><a name="label-2" id="label-2"><code>circle(<var>center_x</var>, <var>center_y</var>, <var>radius</var>)</code></a></dt><!-- RDLabel: "circle" -->
|
26
26
|
<dd>
|
27
27
|
<p>現在のパスに円を追加します。以下のように
|
28
|
-
<a href="cairo-context.html#label-
|
28
|
+
<a href="cairo-context.html#label-11">Cairo::Context#arc</a>を呼び出したのと同じです。</p>
|
29
29
|
<pre>context.arc(center_x, center_y, radius, 0, 2 * Math::PI)</pre>
|
30
30
|
<ul>
|
31
31
|
<li>center_x: 円の中心のx座標</li>
|
@@ -25,7 +25,7 @@
|
|
25
25
|
<dt><a name="label-2" id="label-2"><code>set_source_color(<var>color</var>)</code></a></dt><!-- RDLabel: "set_source_color" -->
|
26
26
|
<dd>
|
27
27
|
ソースの色を<var>color</var>にします。
|
28
|
-
<a href="cairo-context.html#label-
|
28
|
+
<a href="cairo-context.html#label-106">Cairo::Context#set_source_rgba</a>よりも便利です。
|
29
29
|
<ul>
|
30
30
|
<li>color: <a href="cairo-color.html#label-3">Cairo::Color.parse</a>でパースできるオブジェ
|
31
31
|
クト</li>
|
@@ -43,7 +43,7 @@ cr.fill</pre></dd>
|
|
43
43
|
<p><var>path</var>の各点をブロックで変換します。Array#collectの
|
44
44
|
ようなものです。以下は、パスを縦横それぞれ2倍の大きさに
|
45
45
|
する実用的ではない例です。(こういうときは
|
46
|
-
<a href="cairo-context.html#label-
|
46
|
+
<a href="cairo-context.html#label-98">Cairo::Context#scale</a>を使いましょう。)</p>
|
47
47
|
<pre>transformed_path = cr.transform_path(cr.copy_path) do |x, y|
|
48
48
|
[x * 2, y * 2]
|
49
49
|
end
|
@@ -53,7 +53,7 @@ cr.append_path(transformed_path)</pre>
|
|
53
53
|
<li>path: 変換対象のパス</li>
|
54
54
|
<li>x: 点のx座標</li>
|
55
55
|
<li>y: 点のy座標</li>
|
56
|
-
<li
|
56
|
+
<li>戻り値: 変換されたパス</li>
|
57
57
|
</ul></dd>
|
58
58
|
</dl>
|
59
59
|
<h2><a name="label-4" id="label-4">参考</a></h2><!-- RDLabel: "参考" -->
|
data/doc/ja/cairo-context.html
CHANGED
@@ -20,25 +20,25 @@
|
|
20
20
|
<p><a href="cairo-context.html">Cairo::Context</a>はrcairoで描画するときに使用する主要なオブジェ
|
21
21
|
クトです。rcairoで描画するためには、まず、描画対象となるサー
|
22
22
|
フェスを設定した<a href="cairo-context.html">Cairo::Context</a>を作ります。それから、描画オプ
|
23
|
-
ションを設定し、<a href="cairo-context.html#label-
|
24
|
-
<a href="cairo-context.html#label-
|
25
|
-
<a href="cairo-context.html#label-
|
23
|
+
ションを設定し、<a href="cairo-context.html#label-76">Cairo::Context#move_to</a>、
|
24
|
+
<a href="cairo-context.html#label-64">Cairo::Context#line_to</a>などで形を作り、その形を
|
25
|
+
<a href="cairo-context.html#label-112">Cairo::Context#stroke</a>か<a href="cairo-context.html#label-30">Cairo::Context#fill</a>で描画
|
26
26
|
します。</p>
|
27
27
|
<p><a href="cairo-context.html">Cairo::Context</a>の持っている描画情報は
|
28
|
-
<a href="cairo-context.html#label-
|
28
|
+
<a href="cairo-context.html#label-96">Cairo::Context#save</a>でスタックに積むことができます。そ
|
29
29
|
のため、現在の状態を失うことなく描画情報を安全に変更できます。
|
30
|
-
<a href="cairo-context.html#label-
|
30
|
+
<a href="cairo-context.html#label-94">Cairo::Context#restore</a>を呼べば保存した状態を復元するこ
|
31
31
|
とができます。</p>
|
32
32
|
<pre>context.save
|
33
33
|
...
|
34
34
|
context.restore</pre>
|
35
35
|
<p>よりRubyらしく書くなら、ブロックつきで
|
36
|
-
<a href="cairo-context.html#label-
|
36
|
+
<a href="cairo-context.html#label-96">Cairo::Context#save</a>を使用します。</p>
|
37
37
|
<pre>context.save do
|
38
38
|
...
|
39
39
|
end</pre>
|
40
40
|
<p>この場合は、ブロックを抜けた時点で自動的に
|
41
|
-
<a href="cairo-context.html#label-
|
41
|
+
<a href="cairo-context.html#label-94">Cairo::Context#restore</a>が呼び出されます。</p>
|
42
42
|
<p><a href="cairo-context.html">Cairo::Context</a>には、いくつかrcairoが拡張している機能もありま
|
43
43
|
す。</p>
|
44
44
|
<h2><a name="label-1" id="label-1">オブジェクト階層</a></h2><!-- RDLabel: "オブジェクト階層" -->
|
@@ -70,21 +70,31 @@ end</pre>
|
|
70
70
|
<ul>
|
71
71
|
<li>target: 描画対象のサーフェス
|
72
72
|
(<a href="cairo-image-surface.html">Cairo::ImageSurface</a>など)</li>
|
73
|
-
<li
|
73
|
+
<li>戻り値: <a href="cairo-context.html">Cairo::Context</a></li>
|
74
|
+
</ul></dd>
|
75
|
+
<dt><a name="label-5" id="label-5"><code>Cairo::Context.new(<var>target</var>) {|<var>context</var>| ...}</code></a></dt><!-- RDLabel: "Cairo::Context.new" -->
|
76
|
+
<dd>
|
77
|
+
<em>Since 1.7</em>ブロック無しで<a href="cairo-context.html#label-4">Cairo::Context.new</a>を呼び出
|
78
|
+
した場合と異なるのは、ブロックが終了した時点で
|
79
|
+
<a href="cairo-context.html#label-134">Cairo::Context#destroy</a>が呼ばれることです。
|
80
|
+
<ul>
|
81
|
+
<li>target: 描画対象のサーフェス
|
82
|
+
(<a href="cairo-image-surface.html">Cairo::ImageSurface</a>など)</li>
|
83
|
+
<li>context: <a href="cairo-context.html">Cairo::Context</a></li>
|
74
84
|
</ul></dd>
|
75
85
|
</dl>
|
76
|
-
<h2><a name="label-
|
86
|
+
<h2><a name="label-6" id="label-6">インタンスメソッド</a></h2><!-- RDLabel: "インタンスメソッド" -->
|
77
87
|
<dl>
|
78
|
-
<dt><a name="label-
|
88
|
+
<dt><a name="label-7" id="label-7"><code>antialias</code></a></dt><!-- RDLabel: "antialias" -->
|
79
89
|
<dd>
|
80
90
|
現在設定されている、形状に対するアンチエイリアスのモード
|
81
|
-
を返します。これは<a href="cairo-context.html#label-
|
91
|
+
を返します。これは<a href="cairo-context.html#label-8">Cairo::Context#antialias=</a>で設定で
|
82
92
|
きます。
|
83
93
|
<ul>
|
84
|
-
<li
|
94
|
+
<li>戻り値: <a href="cairo-antialias.html">Cairo::Antialias</a>に定義されている定数のどれか。</li>
|
85
95
|
</ul></dd>
|
86
|
-
<dt><a name="label-
|
87
|
-
<dt><a name="label-
|
96
|
+
<dt><a name="label-8" id="label-8"><code>antialias=(<var>antialias</var>)</code></a></dt><!-- RDLabel: "antialias=" -->
|
97
|
+
<dt><a name="label-9" id="label-9"><code>set_antialias(<var>antialias</var>)</code></a></dt><!-- RDLabel: "set_antialias" -->
|
88
98
|
<dd>
|
89
99
|
<p>形状を描画するために使われるラスタライザ(cairoで使われ
|
90
100
|
ているベクタベースの描画情報をラスタ(画素)ベースの描画
|
@@ -105,16 +115,16 @@ end</pre>
|
|
105
115
|
<a href="cairo-antialias.html">Cairo::Antialias</a>に定義されている定数を指定するこ
|
106
116
|
ともできます。</li>
|
107
117
|
</ul></dd>
|
108
|
-
<dt><a name="label-
|
118
|
+
<dt><a name="label-10" id="label-10"><code>append_path(<var>path</var>)</code></a></dt><!-- RDLabel: "append_path" -->
|
109
119
|
<dd>
|
110
120
|
<var>path</var>を現在のパス上に追加します。<var>path</var>は
|
111
|
-
<a href="cairo-context.html#label-
|
112
|
-
<a href="cairo-context.html#label-
|
121
|
+
<a href="cairo-context.html#label-22">Cairo::Context#copy_path</a>または
|
122
|
+
<a href="cairo-context.html#label-23">Cairo::Context#copy_path_flat</a>で取得します。あるい
|
113
123
|
は、<a href="cairo-path.html#label-4">Cairo::Path.new</a>で一から作成することもできます。
|
114
124
|
<ul>
|
115
125
|
<li>path: <a href="cairo-path.html">Cairo::Path</a>オブジェクト</li>
|
116
126
|
</ul></dd>
|
117
|
-
<dt><a name="label-
|
127
|
+
<dt><a name="label-11" id="label-11"><code>arc(<var>center_x</var>, <var>center_y</var>, <var>radius</var>, <var>angle1</var>, <var>angle2</var>)</code></a></dt><!-- RDLabel: "arc" -->
|
118
128
|
<dd>
|
119
129
|
<p>現在のパス上に指定された半径の円弧を追加します。円弧の
|
120
130
|
中心は(<var>center_x</var>, <var>center_y</var>)で、角度
|
@@ -133,7 +143,7 @@ X軸方向になります。角度<code>Math::PI / 2</code>(90度)は(ユ
|
|
133
143
|
180)</code>を使ってください。)</p>
|
134
144
|
<p>このメソッドは角度が増加する方向の円弧を描きます。角度
|
135
145
|
が減少する方向の円弧を描きたい場合は
|
136
|
-
<a href="cairo-context.html#label-
|
146
|
+
<a href="cairo-context.html#label-12">Cairo::Context#arc_negative</a>を見てください。</p>
|
137
147
|
<p>円弧はユーザ空間の円になります。楕円を描くためにはX方向
|
138
148
|
とY方向の値が異なった変換行列で拡大・縮小してください。
|
139
149
|
例えば、<var>x</var>, <var>y</var>, <var>width</var>, <var>height</var>の箱
|
@@ -150,7 +160,7 @@ end</pre>
|
|
150
160
|
<li>angle1: 開始角度(ラジアン)</li>
|
151
161
|
<li>angle2: 終端角度(ラジアン)</li>
|
152
162
|
</ul></dd>
|
153
|
-
<dt><a name="label-
|
163
|
+
<dt><a name="label-12" id="label-12"><code>arc_negative(<var>center_x</var>, <var>center_y</var>, <var>radius</var>, <var>angle1</var>, <var>angle2</var>)</code></a></dt><!-- RDLabel: "arc_negative" -->
|
154
164
|
<dd>
|
155
165
|
<p>現在のパス上に指定された半径の円弧を追加します。円弧の
|
156
166
|
中心は(<var>center_x</var>, <var>center_y</var>)で、角度
|
@@ -158,7 +168,7 @@ end</pre>
|
|
158
168
|
<var>angle2</var>まで進みます。もし<var>angle2</var>が
|
159
169
|
<var>angle1</var>よりも大きい場合は<var>angle1</var>より小さくな
|
160
170
|
るまで<code>2 * Math::PI</code>を引きます。</p>
|
161
|
-
<p>詳しくは<a href="cairo-context.html#label-
|
171
|
+
<p>詳しくは<a href="cairo-context.html#label-11">Cairo::Context#arc</a>を見てください。このメソッド
|
162
172
|
との違いはふたつの角度の間にある円弧の方向だけです。</p>
|
163
173
|
<ul>
|
164
174
|
<li>center_x: 円弧の中心のX座標</li>
|
@@ -167,31 +177,31 @@ end</pre>
|
|
167
177
|
<li>angle1: 開始角度(ラジアン)</li>
|
168
178
|
<li>angle2: 終端角度(ラジアン)</li>
|
169
179
|
</ul></dd>
|
170
|
-
<dt><a name="label-
|
180
|
+
<dt><a name="label-13" id="label-13"><code>circle(<var>center_x</var>, <var>center_y</var>, <var>radius</var>)</code></a></dt><!-- RDLabel: "circle" -->
|
171
181
|
<dd>
|
172
182
|
<a href="cairo-context-circle.html#label-2">Cairo::Context::Circle#circle</a>を見てください。</dd>
|
173
|
-
<dt><a name="label-
|
174
|
-
<dt><a name="label-
|
183
|
+
<dt><a name="label-14" id="label-14"><code>clip(<var>preserve</var>=<var>false</var>)</code></a></dt><!-- RDLabel: "clip" -->
|
184
|
+
<dt><a name="label-15" id="label-15"><code>clip(<var>preserve</var>=<var>false</var>) {|<var>self</var>| ...}</code></a></dt><!-- RDLabel: "clip" -->
|
175
185
|
<dd>
|
176
186
|
<p>現在の切り取り範囲と現在のパスから作る範囲の両方に含まれ
|
177
187
|
ている範囲が新しい切り取り範囲になります(intersect、交
|
178
188
|
差)。現在のパスの範囲は、現在の塗りつぶし規則
|
179
|
-
(<a href="cairo-context.html#label-
|
180
|
-
て<a href="cairo-context.html#label-
|
181
|
-
<p><var>preserve</var>が偽の場合、<a href="cairo-context.html#label-
|
189
|
+
(<a href="cairo-context.html#label-37">Cairo::Context#set_fill_rule</a>を見てください)にしたがっ
|
190
|
+
て<a href="cairo-context.html#label-30">Cairo::Context#fill</a>で塗りつぶされる箇所になります。</p>
|
191
|
+
<p><var>preserve</var>が偽の場合、<a href="cairo-context.html#label-14">Cairo::Context#clip</a>のあとは、
|
182
192
|
コンテキストから現在のパスは消去されます。</p>
|
183
193
|
<p>現在の切り取り範囲は全ての描画操作に影響します。現在の切
|
184
194
|
り取り範囲の外にあるサーフェスへの全ての変更は効果的に隠
|
185
195
|
されます(マスクされます)。</p>
|
186
|
-
<p><a href="cairo-context.html#label-
|
196
|
+
<p><a href="cairo-context.html#label-14">Cairo::Context#clip</a>は切り取り範囲を小さくすることしかで
|
187
197
|
きません。決して大きくなりません。しかし、現在の切り取り
|
188
|
-
範囲はグラフィック状態の一部なので、<a href="cairo-context.html#label-
|
189
|
-
<a href="cairo-context.html#label-
|
190
|
-
のブロックの中)で<a href="cairo-context.html#label-
|
198
|
+
範囲はグラフィック状態の一部なので、<a href="cairo-context.html#label-96">Cairo::Context#save</a>と
|
199
|
+
<a href="cairo-context.html#label-94">Cairo::Context#restore</a>の間(あるいは<a href="cairo-context.html#label-96">Cairo::Context#save</a>
|
200
|
+
のブロックの中)で<a href="cairo-context.html#label-14">Cairo::Context#clip</a>を呼ぶことで一時的
|
191
201
|
に切り取り範囲を制限することができます。これ以外の、切り
|
192
202
|
取り範囲の領域を増やす唯一の方法は
|
193
|
-
<a href="cairo-context.html#label-
|
194
|
-
<p>ブロックを指定した場合は、<a href="cairo-context.html#label-
|
203
|
+
<a href="cairo-context.html#label-93">Cairo::Context#reset_clip</a>です。</p>
|
204
|
+
<p>ブロックを指定した場合は、<a href="cairo-context.html#label-77">Cairo::Context#new_path</a>で新し
|
195
205
|
いパスをはじめてからブロックを呼び出します。以下のよう
|
196
206
|
に使います。</p>
|
197
207
|
<pre>context.clip do
|
@@ -204,12 +214,12 @@ context.clip</pre>
|
|
204
214
|
<ul>
|
205
215
|
<li>preserve: 真の場合はパスを消去しない</li>
|
206
216
|
</ul></dd>
|
207
|
-
<dt><a name="label-
|
217
|
+
<dt><a name="label-16" id="label-16"><code>clip_extents</code></a></dt><!-- RDLabel: "clip_extents" -->
|
208
218
|
<dd>
|
209
219
|
現在の切り取り範囲を含む最小の箱(バウンディングボック
|
210
220
|
ス、境界線で作った四角)をユーザ座標で計算します。
|
211
221
|
<ul>
|
212
|
-
<li
|
222
|
+
<li>戻り値: <code>[x1, y1, x2, y2]</code>
|
213
223
|
<ul>
|
214
224
|
<li>x1: 切り取り範囲の左</li>
|
215
225
|
<li>y1: 切り取り範囲の上</li>
|
@@ -217,45 +227,45 @@ context.clip</pre>
|
|
217
227
|
<li>y2: 切り取り範囲の下</li>
|
218
228
|
</ul></li>
|
219
229
|
</ul></dd>
|
220
|
-
<dt><a name="label-
|
221
|
-
<dt><a name="label-
|
230
|
+
<dt><a name="label-17" id="label-17"><code>clip_preserve</code></a></dt><!-- RDLabel: "clip_preserve" -->
|
231
|
+
<dt><a name="label-18" id="label-18"><code>clip_preserve {|<var>self</var>| ...}</code></a></dt><!-- RDLabel: "clip_preserve" -->
|
222
232
|
<dd>
|
223
|
-
<p><a href="cairo-context.html#label-
|
233
|
+
<p><a href="cairo-context.html#label-14">Cairo::Context#clip</a>を以下のように呼び出すことと同じです。</p>
|
224
234
|
<pre>context.clip(true)
|
225
235
|
context.clip(true) { ... }</pre></dd>
|
226
|
-
<dt><a name="label-
|
236
|
+
<dt><a name="label-19" id="label-19"><code>clip_rectangle_list</code></a></dt><!-- RDLabel: "clip_rectangle_list" -->
|
227
237
|
<dd>
|
228
238
|
<p>現在の切り取り範囲をユーザ座標の四角の配列として返しま
|
229
239
|
す。</p>
|
230
240
|
<p>切り取り範囲がユーザ座標の四角の配列として表現できない
|
231
241
|
場合は<a href="cairo-clip-not-representable-error.html">Cairo::ClipNotRepresentableError</a>が発生します。</p>
|
232
242
|
<ul>
|
233
|
-
<li
|
243
|
+
<li>戻り値: ユーザ座標の四角の配列として表現した現在の切
|
234
244
|
り取り範囲。<a href="cairo-rectangle.html">Cairo::Rectangle</a>の配列。</li>
|
235
245
|
</ul></dd>
|
236
|
-
<dt><a name="label-
|
246
|
+
<dt><a name="label-20" id="label-20"><code>close_path</code></a></dt><!-- RDLabel: "close_path" -->
|
237
247
|
<dd>
|
238
248
|
<p>現在の点から現在のサブパスの最初の点(一番最後に
|
239
|
-
<a href="cairo-context.html#label-
|
240
|
-
このサブパスを閉じます。<a href="cairo-context.html#label-
|
249
|
+
<a href="cairo-context.html#label-76">Cairo::Context#move_to</a>に渡した点)までの線分を追加し、
|
250
|
+
このサブパスを閉じます。<a href="cairo-context.html#label-20">Cairo::Context#close_path</a>の後は
|
241
251
|
現在の点はサブパスの結合終点(?FIXME: joined endpoint)
|
242
252
|
にあります。</p>
|
243
|
-
<p>ストロークの場合、<a href="cairo-context.html#label-
|
253
|
+
<p>ストロークの場合、<a href="cairo-context.html#label-20">Cairo::Context#close_path</a>の振舞は単純
|
244
254
|
に同等の座標(サブパスの最初の点)で
|
245
|
-
<a href="cairo-context.html#label-
|
255
|
+
<a href="cairo-context.html#label-64">Cairo::Context#line_to</a>を呼んだときとは異なります。閉じ
|
246
256
|
られたサブパスが描かれるときは、サブパスの最後にはキャッ
|
247
257
|
プ(ふた、線分の端の点のこと)はありません。代わりに、サ
|
248
258
|
ブパスの最初と最後を結ぶ線の結合があります。</p>
|
249
259
|
<p>もし<a href="cairo-context.html">Cairo::Context#close_patb</a>を呼ぶ前に現在の点がない場
|
250
260
|
合は、何も起こりません。</p></dd>
|
251
|
-
<dt><a name="label-
|
261
|
+
<dt><a name="label-21" id="label-21"><code>copy_page</code></a></dt><!-- RDLabel: "copy_page" -->
|
252
262
|
<dd>
|
253
263
|
複数のページをサポートしているバックエンドのために、現
|
254
264
|
在のページを発行します。しかし、現在のページの内容は消
|
255
265
|
去せずに、次のページのために保持します。発行後は空のペー
|
256
|
-
ジにしたい場合は<a href="cairo-context.html#label-
|
266
|
+
ジにしたい場合は<a href="cairo-context.html#label-109">Cairo::Context#show_page</a>を使ってくださ
|
257
267
|
い。</dd>
|
258
|
-
<dt><a name="label-
|
268
|
+
<dt><a name="label-22" id="label-22"><code>copy_path</code></a></dt><!-- RDLabel: "copy_path" -->
|
259
269
|
<dd>
|
260
270
|
<p>現在のパスのコピーを作成し<a href="cairo-path.html">Cairo::Path</a>オブジェクトとして
|
261
271
|
返します。</p>
|
@@ -268,22 +278,22 @@ context.clip(true) { ... }</pre></dd>
|
|
268
278
|
外が発生します。</li>
|
269
279
|
</ol>
|
270
280
|
<ul>
|
271
|
-
<li
|
281
|
+
<li>戻り値: 現在のパスのコピー。</li>
|
272
282
|
</ul></dd>
|
273
|
-
<dt><a name="label-
|
283
|
+
<dt><a name="label-23" id="label-23"><code>copy_path_flat</code></a></dt><!-- RDLabel: "copy_path_flat" -->
|
274
284
|
<dd>
|
275
285
|
<p>平坦にした現在のパスのコピーを作成し<a href="cairo-path.html">Cairo::Path</a>オブジェ
|
276
286
|
クトとして返します。</p>
|
277
|
-
<p><a href="cairo-context.html#label-
|
287
|
+
<p><a href="cairo-context.html#label-22">Cairo::Context#copy_path</a>とほとんど同じです。違いはパス
|
278
288
|
中のすべての曲線が区分的に線形な近似値で近似されること
|
279
289
|
です(確実に現在の許容値内にします)。つまり、結果には
|
280
290
|
ひとつも<a href="cairo-path.html#label-27">Cairo::Path::CURVE_TO</a>が無いことが保証されます。
|
281
291
|
<a href="cairo-path.html#label-27">Cairo::Path::CURVE_TO</a>は<a href="cairo-path.html#label-28">Cairo::Path::LINE_TO</a>に置き換えられ
|
282
292
|
ます。</p>
|
283
293
|
<ul>
|
284
|
-
<li
|
294
|
+
<li>戻り値: 平坦にした現在のパスのコピー。</li>
|
285
295
|
</ul></dd>
|
286
|
-
<dt><a name="label-
|
296
|
+
<dt><a name="label-24" id="label-24"><code>current_point</code></a></dt><!-- RDLabel: "current_point" -->
|
287
297
|
<dd>
|
288
298
|
<p>現在のパスの現在の点を返します。概念上はこれまでにパス
|
289
299
|
が到達した最後の点になります。</p>
|
@@ -293,25 +303,25 @@ context.clip(true) { ... }</pre></dd>
|
|
293
303
|
ドがどのように現在の点に影響を与えるかの詳細は以下を見
|
294
304
|
てください。</p>
|
295
305
|
<ul>
|
296
|
-
<li><a href="cairo-context.html#label-
|
297
|
-
<li><a href="cairo-context.html#label-
|
298
|
-
<li><a href="cairo-context.html#label-
|
299
|
-
<li><a href="cairo-context.html#label-
|
300
|
-
<li><a href="cairo-context.html#label-
|
301
|
-
<li><a href="cairo-context.html#label-
|
302
|
-
<li><a href="cairo-context.html#label-
|
303
|
-
<li><a href="cairo-context.html#label-
|
306
|
+
<li><a href="cairo-context.html#label-77">Cairo::Context#new_path</a></li>
|
307
|
+
<li><a href="cairo-context.html#label-76">Cairo::Context#move_to</a></li>
|
308
|
+
<li><a href="cairo-context.html#label-64">Cairo::Context#line_to</a></li>
|
309
|
+
<li><a href="cairo-context.html#label-25">Cairo::Context#curve_to</a></li>
|
310
|
+
<li><a href="cairo-context.html#label-11">Cairo::Context#arc</a></li>
|
311
|
+
<li><a href="cairo-context.html#label-92">Cairo::Context#rel_move_to</a></li>
|
312
|
+
<li><a href="cairo-context.html#label-91">Cairo::Context#rel_line_to</a></li>
|
313
|
+
<li><a href="cairo-context.html#label-90">Cairo::Context#rel_curve_to</a></li>
|
304
314
|
<li><a href="cairo-context.html">Cairo::Context#rel_arc</a></li>
|
305
|
-
<li><a href="cairo-context.html#label-
|
315
|
+
<li><a href="cairo-context.html#label-119">Cairo::Context#text_path</a></li>
|
306
316
|
</ul>
|
307
317
|
<ul>
|
308
|
-
<li
|
318
|
+
<li>戻り値: <code>[x, y]</code>:
|
309
319
|
<ul>
|
310
320
|
<li>x: 現在の点のX座標</li>
|
311
321
|
<li>y: 現在の点のY座標</li>
|
312
322
|
</ul></li>
|
313
323
|
</ul></dd>
|
314
|
-
<dt><a name="label-
|
324
|
+
<dt><a name="label-25" id="label-25"><code>curve_to(<var>x1</var>, <var>y1</var>, <var>x2</var>, <var>y2</var>, <var>x3</var>, <var>y3</var>)</code></a></dt><!-- RDLabel: "curve_to" -->
|
315
325
|
<dd>
|
316
326
|
<p>現在の点から(<var>x3</var>, <var>y3</var>)(ユーザ空間座標)までの
|
317
327
|
3次のベジエスプライン曲線をパスに追加します。制御点には
|
@@ -328,62 +338,62 @@ context.clip(true) { ... }</pre></dd>
|
|
328
338
|
<li>x3: 曲線の終点のX座標</li>
|
329
339
|
<li>y3: 曲線の終点のY座標</li>
|
330
340
|
</ul></dd>
|
331
|
-
<dt><a name="label-
|
341
|
+
<dt><a name="label-26" id="label-26"><code>dash</code></a></dt><!-- RDLabel: "dash" -->
|
332
342
|
<dd>
|
333
343
|
現在のダッシュの配列を返します。
|
334
344
|
<ul>
|
335
|
-
<li
|
345
|
+
<li>戻り値: <code>[dashes, offset]</code>:
|
336
346
|
<ul>
|
337
347
|
<li>dashes: ダッシュの配列</li>
|
338
348
|
<li>offset: 補正値</li>
|
339
349
|
</ul></li>
|
340
350
|
</ul></dd>
|
341
|
-
<dt><a name="label-
|
351
|
+
<dt><a name="label-27" id="label-27"><code>dash_count</code></a></dt><!-- RDLabel: "dash_count" -->
|
342
352
|
<dd>
|
343
353
|
<p>ダッシュの配列の長さを返します。(ダッシュが使われてい
|
344
354
|
ない場合は0)</p>
|
345
|
-
<p><a href="cairo-context.html#label-
|
355
|
+
<p><a href="cairo-context.html#label-103">Cairo::Context#set_dash</a>と<a href="cairo-context.html#label-26">Cairo::Context#dash</a>も見てくだ
|
346
356
|
さい。</p>
|
347
357
|
<ul>
|
348
|
-
<li
|
358
|
+
<li>戻り値: ダッシュの配列の長さ。ダッシュの配列が設定さ
|
349
359
|
れていない場合は0。</li>
|
350
360
|
</ul></dd>
|
351
|
-
<dt><a name="label-
|
361
|
+
<dt><a name="label-28" id="label-28"><code>device_to_user(<var>x</var>, <var>y</var>)</code></a></dt><!-- RDLabel: "device_to_user" -->
|
352
362
|
<dd>
|
353
363
|
装置空間からユーザ空間へ座標を変換します。与えられた点
|
354
364
|
に現在の変換行列(CTM)の逆行列を乗じて変換します。
|
355
365
|
<ul>
|
356
366
|
<li>x: 装置空間のX座標</li>
|
357
367
|
<li>y: 装置空間のY座標</li>
|
358
|
-
<li
|
368
|
+
<li>戻り値: <code>[user_x, user_y]</code>:
|
359
369
|
<ul>
|
360
370
|
<li>user_x: ユーザ空間に変換されたX座標</li>
|
361
371
|
<li>user_y: ユーザ空間に変換されたY座標</li>
|
362
372
|
</ul></li>
|
363
373
|
</ul></dd>
|
364
|
-
<dt><a name="label-
|
374
|
+
<dt><a name="label-29" id="label-29"><code>device_to_user_distance(<var>dx</var>, <var>dy</var>)</code></a></dt><!-- RDLabel: "device_to_user_distance" -->
|
365
375
|
<dd>
|
366
376
|
装置空間からユーザ空間へ距離ベクトルを変換します。この
|
367
|
-
メソッドは<a href="cairo-context.html#label-
|
377
|
+
メソッドは<a href="cairo-context.html#label-28">Cairo::Context#device_to_user</a>に似ています。違
|
368
378
|
いはCTMの逆行列の平行移動成分が無視されるということです。
|
369
379
|
<ul>
|
370
380
|
<li>dx: 装置空間の距離ベクトルのX座標</li>
|
371
381
|
<li>dy: 装置空間の距離ベクトルのY座標</li>
|
372
|
-
<li
|
382
|
+
<li>戻り値: <code>[user_dx, user_dy]</code>:
|
373
383
|
<ul>
|
374
384
|
<li>user_dx: ユーザ空間に変換された距離ベクトルのX座標</li>
|
375
385
|
<li>user_dy: ユーザ空間に変換された距離ベクトルのY座標</li>
|
376
386
|
</ul></li>
|
377
387
|
</ul></dd>
|
378
|
-
<dt><a name="label-
|
379
|
-
<dt><a name="label-
|
388
|
+
<dt><a name="label-30" id="label-30"><code>fill(<var>preserve</var>=<var>false</var>)</code></a></dt><!-- RDLabel: "fill" -->
|
389
|
+
<dt><a name="label-31" id="label-31"><code>fill(<var>preserve</var>=<var>false</var>) {|<var>self</var>| ...}</code></a></dt><!-- RDLabel: "fill" -->
|
380
390
|
<dd>
|
381
391
|
<p>現在の塗りつぶし規則にしたがって現在のパスを塗りつぶす
|
382
392
|
描画操作です。(塗りつぶす前に各サブパスは暗黙のうちに
|
383
393
|
閉じられます。)<var>preserve</var>が偽の場合は
|
384
|
-
<a href="cairo-context.html#label-
|
394
|
+
<a href="cairo-context.html#label-30">Cairo::Context#fill</a>を呼び出した後、現在のパスがコンテキ
|
385
395
|
ストから消去されます。</p>
|
386
|
-
<p>ブロックを指定した場合は、<a href="cairo-context.html#label-
|
396
|
+
<p>ブロックを指定した場合は、<a href="cairo-context.html#label-77">Cairo::Context#new_path</a>で新し
|
387
397
|
いパスをはじめてからブロックを呼び出します。以下のよう
|
388
398
|
に使います。</p>
|
389
399
|
<pre>context.fill do
|
@@ -393,24 +403,24 @@ end</pre>
|
|
393
403
|
<pre>context.new_path
|
394
404
|
context.rectangle(20, 20, 40, 40)
|
395
405
|
context.fill</pre>
|
396
|
-
<p><a href="cairo-context.html#label-
|
406
|
+
<p><a href="cairo-context.html#label-37">Cairo::Context#set_fill_rule</a>も見てください。</p>
|
397
407
|
<ul>
|
398
408
|
<li>preserve: 真の場合はパスを消去しない</li>
|
399
409
|
</ul></dd>
|
400
|
-
<dt><a name="label-
|
410
|
+
<dt><a name="label-32" id="label-32"><code>fill_extents</code></a></dt><!-- RDLabel: "fill_extents" -->
|
401
411
|
<dd>
|
402
|
-
<p>現在のパスと塗りつぶしパラメータで<a href="cairo-context.html#label-
|
412
|
+
<p>現在のパスと塗りつぶしパラメータで<a href="cairo-context.html#label-30">Cairo::Context#fill</a>を
|
403
413
|
呼び出したときに影響がある範囲を覆うユーザ空間のバウン
|
404
414
|
ディングボックスを計算します。現在のパスが空なら空の四
|
405
415
|
角(0,0, 0,0)を返します。サーフェスの大きさと切り取り領
|
406
416
|
域は関係ありません。</p>
|
407
417
|
<p>以下も見てください。</p>
|
408
418
|
<ul>
|
409
|
-
<li><a href="cairo-context.html#label-
|
410
|
-
<li><a href="cairo-context.html#label-
|
419
|
+
<li><a href="cairo-context.html#label-30">Cairo::Context#fill</a></li>
|
420
|
+
<li><a href="cairo-context.html#label-37">Cairo::Context#set_fill_rule</a></li>
|
411
421
|
</ul>
|
412
422
|
<ul>
|
413
|
-
<li
|
423
|
+
<li>戻り値: <code>[x1, y1, x2, y2]</code>:
|
414
424
|
<ul>
|
415
425
|
<li>x1: バウンディングボックスの左</li>
|
416
426
|
<li>y1: バウンディングボックスの上</li>
|
@@ -418,27 +428,27 @@ context.fill</pre>
|
|
418
428
|
<li>y2: バウンディングボックスの下</li>
|
419
429
|
</ul></li>
|
420
430
|
</ul></dd>
|
421
|
-
<dt><a name="label-
|
422
|
-
<dt><a name="label-
|
431
|
+
<dt><a name="label-33" id="label-33"><code>fill_preserve</code></a></dt><!-- RDLabel: "fill_preserve" -->
|
432
|
+
<dt><a name="label-34" id="label-34"><code>fill_preserve {|<var>self</var>| ...}</code></a></dt><!-- RDLabel: "fill_preserve" -->
|
423
433
|
<dd>
|
424
|
-
<p><a href="cairo-context.html#label-
|
434
|
+
<p><a href="cairo-context.html#label-30">Cairo::Context#fill</a>を以下のように呼び出すことと同じです。</p>
|
425
435
|
<pre>context.fill(true)
|
426
436
|
context.fill(true) { ... }</pre></dd>
|
427
|
-
<dt><a name="label-
|
437
|
+
<dt><a name="label-35" id="label-35"><code>fill_rule</code></a></dt><!-- RDLabel: "fill_rule" -->
|
428
438
|
<dd>
|
429
439
|
現在の塗りつぶし規則を返します。塗りつぶし規則は
|
430
|
-
<a href="cairo-context.html#label-
|
440
|
+
<a href="cairo-context.html#label-37">Cairo::Context#set_fill_rule</a>で設定します。
|
431
441
|
<ul>
|
432
|
-
<li
|
442
|
+
<li>戻り値: <a href="cairo-fill-rule.html">Cairo::FillRule</a>に定義されている定数のどれか。</li>
|
433
443
|
</ul></dd>
|
434
|
-
<dt><a name="label-
|
435
|
-
<dt><a name="label-
|
444
|
+
<dt><a name="label-36" id="label-36"><code>fill_rule=(<var>fill_rule</var>)</code></a></dt><!-- RDLabel: "fill_rule=" -->
|
445
|
+
<dt><a name="label-37" id="label-37"><code>set_fill_rule(<var>fill_rule</var>)</code></a></dt><!-- RDLabel: "set_fill_rule" -->
|
436
446
|
<dd>
|
437
447
|
コンテキスト中の現在の塗りつぶしルールを設定します。塗
|
438
448
|
りつぶし規則は領域が複雑な(自身で交差している可能性のあ
|
439
449
|
る)パスの内側にあるか外側にあるかを判断するために使わ
|
440
|
-
れます。現在の塗りつぶし規則は<a href="cairo-context.html#label-
|
441
|
-
<a href="cairo-context.html#label-
|
450
|
+
れます。現在の塗りつぶし規則は<a href="cairo-context.html#label-30">Cairo::Context#fill</a>と
|
451
|
+
<a href="cairo-context.html#label-14">Cairo::Context#clip</a>の両方に影響を与えます。有効な塗りつ
|
442
452
|
ぶし規則のそれぞれの意味の詳細は
|
443
453
|
<a href="cairo-fill-rule.html">Cairo::FillRule</a>を見てください。
|
444
454
|
<ul>
|
@@ -449,21 +459,21 @@ context.fill(true) { ... }</pre></dd>
|
|
449
459
|
<a href="cairo-fill-rule.html">Cairo::FillRule</a>に定義されている定数を指定すること
|
450
460
|
もできます。</li>
|
451
461
|
</ul></dd>
|
452
|
-
<dt><a name="label-
|
462
|
+
<dt><a name="label-38" id="label-38"><code>font_extents</code></a></dt><!-- RDLabel: "font_extents" -->
|
453
463
|
<dd>
|
454
464
|
現在選択しているフォントの範囲を返します。
|
455
465
|
<ul>
|
456
|
-
<li
|
466
|
+
<li>戻り値: <a href="cairo-font-extents.html">Cairo::FontExtents</a>オブジェクト</li>
|
457
467
|
</ul></dd>
|
458
|
-
<dt><a name="label-
|
468
|
+
<dt><a name="label-39" id="label-39"><code>font_face</code></a></dt><!-- RDLabel: "font_face" -->
|
459
469
|
<dd>
|
460
470
|
<p>現在のフォントフェイスを返します。</p>
|
461
471
|
<p>メモリがたりない場合はNoMemoryError例外が発生します。</p>
|
462
472
|
<ul>
|
463
|
-
<li
|
473
|
+
<li>戻り値: 現在の<a href="cairo-font-face.html">Cairo::FontFace</a>オブジェクト。</li>
|
464
474
|
</ul></dd>
|
465
|
-
<dt><a name="label-
|
466
|
-
<dt><a name="label-
|
475
|
+
<dt><a name="label-40" id="label-40"><code>font_face=(<var>font_face</var>)</code></a></dt><!-- RDLabel: "font_face=" -->
|
476
|
+
<dt><a name="label-41" id="label-41"><code>set_font_face(<var>font_face</var>)</code></a></dt><!-- RDLabel: "set_font_face" -->
|
467
477
|
<dd>
|
468
478
|
コンテキストの現在の<a href="cairo-font-face.html">Cairo::FontFace</a>オブジェクトを
|
469
479
|
<var>font_face</var>で置き換えます。
|
@@ -471,40 +481,40 @@ context.fill(true) { ... }</pre></dd>
|
|
471
481
|
<li>font_face: <a href="cairo-font-face.html">Cairo::FontFace</a>オブジェクト。<code>nil</code>の場
|
472
482
|
合はデフォルトのフォントに戻します。</li>
|
473
483
|
</ul></dd>
|
474
|
-
<dt><a name="label-
|
484
|
+
<dt><a name="label-42" id="label-42"><code>font_matrix</code></a></dt><!-- RDLabel: "font_matrix" -->
|
475
485
|
<dd>
|
476
486
|
現在のフォント用行列を返します。
|
477
|
-
<a href="cairo-context.html#label-
|
487
|
+
<a href="cairo-context.html#label-44">Cairo::Context#set_font_matrix</a>も見てください。
|
478
488
|
<ul>
|
479
|
-
<li
|
489
|
+
<li>戻り値: フォント用行列を<a href="cairo-matrix.html">Cairo::Matrix</a>オブジェクトで
|
480
490
|
返します。</li>
|
481
491
|
</ul></dd>
|
482
|
-
<dt><a name="label-
|
483
|
-
<dt><a name="label-
|
492
|
+
<dt><a name="label-43" id="label-43"><code>font_matrix=(<var>matrix</var>)</code></a></dt><!-- RDLabel: "font_matrix=" -->
|
493
|
+
<dt><a name="label-44" id="label-44"><code>set_font_matrix(<var>matrix</var>)</code></a></dt><!-- RDLabel: "set_font_matrix" -->
|
484
494
|
<dd>
|
485
495
|
<var>matrix</var>を現在のフォント用行列に設定します。フォン
|
486
496
|
ト用行列はフォントのデザイン空間(この空間ではemの四角
|
487
497
|
は1単位 x 1単位です)からユーザ空間への変換方法になりま
|
488
498
|
す。通常は単純な拡大・縮小が使われます
|
489
|
-
(<a href="cairo-context.html#label-
|
499
|
+
(<a href="cairo-context.html#label-49">Cairo::Context#set_font_size</a>を見てください)。しかし、
|
490
500
|
フォントを剪断(斜めに傾ける)したり長さの異なる平行な
|
491
501
|
ふたつの軸に対して(?FIXME)伸縮させたりなど、複雑なフォ
|
492
502
|
ント用行列を使うこともできます。
|
493
503
|
<ul>
|
494
504
|
<li>matrix: 現在のフォントに適用する変換行列</li>
|
495
505
|
</ul></dd>
|
496
|
-
<dt><a name="label-
|
506
|
+
<dt><a name="label-45" id="label-45"><code>font_options</code></a></dt><!-- RDLabel: "font_options" -->
|
497
507
|
<dd>
|
498
|
-
<a href="cairo-context.html#label-
|
508
|
+
<a href="cairo-context.html#label-47">Cairo::Context#set_font_options</a>で設定したフォント描画オ
|
499
509
|
プションを返します。返されるオプションにはコンテキスト
|
500
510
|
の下にあるサーフェスから得られたオプションは含まれませ
|
501
511
|
ん。つまり、このオプションはそのまま
|
502
|
-
<a href="cairo-context.html#label-
|
512
|
+
<a href="cairo-context.html#label-47">Cairo::Context#set_font_options</a>に渡すことができます。
|
503
513
|
<ul>
|
504
|
-
<li
|
514
|
+
<li>戻り値: <a href="cairo-font-options.html">Cairo::FontOptions</a>オブジェクト</li>
|
505
515
|
</ul></dd>
|
506
|
-
<dt><a name="label-
|
507
|
-
<dt><a name="label-
|
516
|
+
<dt><a name="label-46" id="label-46"><code>font_options=(<var>options</var>)</code></a></dt><!-- RDLabel: "font_options=" -->
|
517
|
+
<dt><a name="label-47" id="label-47"><code>set_font_options(<var>options</var>)</code></a></dt><!-- RDLabel: "set_font_options" -->
|
508
518
|
<dd>
|
509
519
|
コンテキストにフォント描画オプションを設定します。描画
|
510
520
|
オプションはコンテキストの下にあるサーフェスから得たオ
|
@@ -514,12 +524,12 @@ context.fill(true) { ... }</pre></dd>
|
|
514
524
|
<ul>
|
515
525
|
<li>options: <a href="cairo-font-options.html">Cairo::FontOptions</a>オブジェクト</li>
|
516
526
|
</ul></dd>
|
517
|
-
<dt><a name="label-
|
518
|
-
<dt><a name="label-
|
527
|
+
<dt><a name="label-48" id="label-48"><code>font_size=(<var>size</var>)</code></a></dt><!-- RDLabel: "font_size=" -->
|
528
|
+
<dt><a name="label-49" id="label-49"><code>set_font_size(<var>size</var>)</code></a></dt><!-- RDLabel: "set_font_size" -->
|
519
529
|
<dd>
|
520
530
|
現在のフォント用行列を<var>size</var>倍に拡大する行列に設定
|
521
|
-
します。以前に<a href="cairo-context.html#label-
|
522
|
-
<a href="cairo-context.html#label-
|
531
|
+
します。以前に<a href="cairo-context.html#label-49">Cairo::Context#set_font_size</a>あるいは
|
532
|
+
<a href="cairo-context.html#label-44">Cairo::Context#set_font_matrix</a>で設定したフォント用行列
|
523
533
|
は置き換えられます。<var>size</var>のフォントサイズはユーザ
|
524
534
|
空間の単位になります。(より正確にいうと、この行列はフォ
|
525
535
|
ントのem正方形をユーザ空間での<var>size</var> x <var>size</var>の
|
@@ -527,54 +537,54 @@ context.fill(true) { ... }</pre></dd>
|
|
527
537
|
<ul>
|
528
538
|
<li>size: ユーザ空間の単位での新しいフォントサイズ</li>
|
529
539
|
</ul></dd>
|
530
|
-
<dt><a name="label-
|
540
|
+
<dt><a name="label-50" id="label-50"><code>glyph_extents(<var>glyphs</var>)</code></a></dt><!-- RDLabel: "glyph_extents" -->
|
531
541
|
<dd>
|
532
542
|
<p>グリフの範囲を返します。範囲はグリフをインクで塗る部分
|
533
543
|
を囲む(ユーザ空間での)四角を示しています。(グリフは
|
534
|
-
<a href="cairo-context.html#label-
|
544
|
+
<a href="cairo-context.html#label-108">Cairo::Context#show_glyphs</a>で描画できます。)さらに、
|
535
545
|
範囲(<a href="cairo-text-extents.html">Cairo::TextExtents</a>)の<var>x_advance</var>と
|
536
|
-
<var>y_advance</var>の値は<a href="cairo-context.html#label-
|
546
|
+
<var>y_advance</var>の値は<a href="cairo-context.html#label-108">Cairo::Context#show_glyphs</a>が進める
|
537
547
|
現在の点の合計を示しています。
|
538
|
-
(<a href="cairo-context.html#label-
|
548
|
+
(<a href="cairo-context.html#label-108">Cairo::Context#show_glyphs</a>はグリフを描画すると、描画
|
539
549
|
した分だけ現在の点を進めます。)</p>
|
540
550
|
<p>空白のグリフは四角のサイズ(extents.widthと
|
541
551
|
extents.height)に貢献しないことに注意してください。</p>
|
542
552
|
<ul>
|
543
553
|
<li>glyphs: <a href="cairo-glyph.html">Cairo::Glyph</a>の配列</li>
|
544
|
-
<li
|
554
|
+
<li>戻り値: グリフの範囲を示す<a href="cairo-text-extents.html">Cairo::TextExtents</a>オブジェ
|
545
555
|
クト。</li>
|
546
556
|
</ul></dd>
|
547
|
-
<dt><a name="label-
|
557
|
+
<dt><a name="label-51" id="label-51"><code>glyph_path(<var>glyphs</var>)</code></a></dt><!-- RDLabel: "glyph_path" -->
|
548
558
|
<dd>
|
549
559
|
現在のパスにグリフの閉じたパスを追加します。
|
550
560
|
生成されたパスを塗りつぶすと、
|
551
|
-
<a href="cairo-context.html#label-
|
561
|
+
<a href="cairo-context.html#label-108">Cairo::Context#show_glyphs</a>のような効果を実現できます。
|
552
562
|
<ul>
|
553
563
|
<li>glyphs: 表示するグリフ(<a href="cairo-glyph.html">Cairo::Glyph</a>)の配列</li>
|
554
564
|
</ul></dd>
|
555
|
-
<dt><a name="label-
|
565
|
+
<dt><a name="label-52" id="label-52"><code>group_target</code></a></dt><!-- RDLabel: "group_target" -->
|
556
566
|
<dd>
|
557
|
-
<p>一番最後に呼んだ<a href="cairo-context.html#label-
|
567
|
+
<p>一番最後に呼んだ<a href="cairo-context.html#label-86">Cairo::Context#push_group</a>または
|
558
568
|
<a href="cairo-context.html">Cairo::Context#push_with_content</a>ではじまった現在のグルー
|
559
569
|
プ用の対象サーフェスを返します。</p>
|
560
570
|
<p>もし全てのグループ描画ブロックの外で呼んだ場合は
|
561
571
|
<code>nil</code>を返します。(つまり、最後のつりあった
|
562
|
-
<a href="cairo-context.html#label-
|
572
|
+
<a href="cairo-context.html#label-84">Cairo::Context#pop_group</a>あるいは
|
563
573
|
<a href="cairo-context.html">Cairo::Context#pop_group_to_surface</a>のあとに<code>nil</code>が
|
564
574
|
返ります。(そんなことあるかなぁ))</p>
|
565
575
|
<ul>
|
566
|
-
<li
|
576
|
+
<li>戻り値: 対象グループサーフェス。もしなければ
|
567
577
|
<code>nil</code>。</li>
|
568
578
|
</ul></dd>
|
569
|
-
<dt><a name="label-
|
579
|
+
<dt><a name="label-53" id="label-53"><code>identity_matrix</code></a></dt><!-- RDLabel: "identity_matrix" -->
|
570
580
|
<dd>
|
571
581
|
現在の変換行列(CTM)をリセットして単位行列にします。つ
|
572
582
|
まり、ユーザ空間と装置空間の軸が揃い、1ユーザ空間単位は
|
573
583
|
1装置空間単位に変換されます。</dd>
|
574
|
-
<dt><a name="label-
|
575
|
-
<dt><a name="label-
|
584
|
+
<dt><a name="label-54" id="label-54"><code>in_fill?(<var>x</var>, <var>y</var>)</code></a></dt><!-- RDLabel: "in_fill?" -->
|
585
|
+
<dt><a name="label-55" id="label-55"><code>in_fill?(<var>x</var>, <var>y</var>) {|<var>self</var>| ...}</code></a></dt><!-- RDLabel: "in_fill?" -->
|
576
586
|
<dd>
|
577
|
-
<p>指定された点が<a href="cairo-context.html#label-
|
587
|
+
<p>指定された点が<a href="cairo-context.html#label-30">Cairo::Context#fill</a>操作で影響がある範囲の
|
578
588
|
中にあるかどうかをテストします。その際、現在のパスと現
|
579
589
|
在の塗りつぶしパラメータが使われます。サーフェスの面積
|
580
590
|
と切り取り範囲は関係ありません。</p>
|
@@ -583,20 +593,20 @@ extents.height)に貢献しないことに注意してください。</p>
|
|
583
593
|
してください。</p>
|
584
594
|
<p>以下のメソッドも見てください。</p>
|
585
595
|
<ul>
|
586
|
-
<li><a href="cairo-context.html#label-
|
587
|
-
<li><a href="cairo-context.html#label-
|
588
|
-
<li><a href="cairo-context.html#label-
|
596
|
+
<li><a href="cairo-context.html#label-30">Cairo::Context#fill</a></li>
|
597
|
+
<li><a href="cairo-context.html#label-37">Cairo::Context#set_fill_rule</a></li>
|
598
|
+
<li><a href="cairo-context.html#label-33">Cairo::Context#fill_preserve</a></li>
|
589
599
|
</ul>
|
590
600
|
<ul>
|
591
601
|
<li>x: テストする点のX座標</li>
|
592
602
|
<li>y: テストする点のY座標</li>
|
593
|
-
<li
|
603
|
+
<li>戻り値: 点が内側にあれば<code>true</code>。外にあれば
|
594
604
|
<code>false</code>。</li>
|
595
605
|
</ul></dd>
|
596
|
-
<dt><a name="label-
|
597
|
-
<dt><a name="label-
|
606
|
+
<dt><a name="label-56" id="label-56"><code>in_stroke?(<var>x</var>, <var>y</var>)</code></a></dt><!-- RDLabel: "in_stroke?" -->
|
607
|
+
<dt><a name="label-57" id="label-57"><code>in_stroke?(<var>x</var>, <var>y</var>) {|<var>self</var>| ...}</code></a></dt><!-- RDLabel: "in_stroke?" -->
|
598
608
|
<dd>
|
599
|
-
<p>指定された点が<a href="cairo-context.html#label-
|
609
|
+
<p>指定された点が<a href="cairo-context.html#label-112">Cairo::Context#stroke</a>操作で影響がある範囲
|
600
610
|
の中にあるかどうかをテストします。その際、現在のパスと
|
601
611
|
現在の描きパラメータが使われます。サーフェスの面積と切り
|
602
612
|
取り範囲は関係ありません。</p>
|
@@ -605,36 +615,36 @@ extents.height)に貢献しないことに注意してください。</p>
|
|
605
615
|
してください。</p>
|
606
616
|
<p>以下のメソッドも見てください。</p>
|
607
617
|
<ul>
|
608
|
-
<li><a href="cairo-context.html#label-
|
618
|
+
<li><a href="cairo-context.html#label-112">Cairo::Context#stroke</a></li>
|
609
619
|
<li><a href="cairo-context.html">Cairo::Context#set_line_with</a></li>
|
610
|
-
<li><a href="cairo-context.html#label-
|
611
|
-
<li><a href="cairo-context.html#label-
|
612
|
-
<li><a href="cairo-context.html#label-
|
613
|
-
<li><a href="cairo-context.html#label-
|
620
|
+
<li><a href="cairo-context.html#label-63">Cairo::Context#set_line_join</a></li>
|
621
|
+
<li><a href="cairo-context.html#label-60">Cairo::Context#set_line_cap</a></li>
|
622
|
+
<li><a href="cairo-context.html#label-103">Cairo::Context#set_dash</a></li>
|
623
|
+
<li><a href="cairo-context.html#label-115">Cairo::Context#stroke_preserve</a></li>
|
614
624
|
</ul>
|
615
625
|
<ul>
|
616
626
|
<li>x: テストする点のX座標</li>
|
617
627
|
<li>y: テストする点のY座標</li>
|
618
|
-
<li
|
628
|
+
<li>戻り値: 点が内側にあれば<code>true</code>。外にあれば
|
619
629
|
<code>false</code>。</li>
|
620
630
|
</ul></dd>
|
621
|
-
<dt><a name="label-
|
631
|
+
<dt><a name="label-58" id="label-58"><code>line_cap</code></a></dt><!-- RDLabel: "line_cap" -->
|
622
632
|
<dd>
|
623
|
-
<a href="cairo-context.html#label-
|
633
|
+
<a href="cairo-context.html#label-60">Cairo::Context#set_line_cap</a>で設定した現在のラインキャッ
|
624
634
|
プスタイル(終点を描画する方法)を返します。
|
625
635
|
<ul>
|
626
|
-
<li
|
636
|
+
<li>戻り値: 現在のラインキャップスタイル。
|
627
637
|
<a href="cairo-line-cap.html">Cairo::LineCap</a>に定義されている定数のどれか。</li>
|
628
638
|
</ul></dd>
|
629
|
-
<dt><a name="label-
|
630
|
-
<dt><a name="label-
|
639
|
+
<dt><a name="label-59" id="label-59"><code>line_cap=(<var>line_cap</var>)</code></a></dt><!-- RDLabel: "line_cap=" -->
|
640
|
+
<dt><a name="label-60" id="label-60"><code>set_line_cap(<var>line_cap</var>)</code></a></dt><!-- RDLabel: "set_line_cap" -->
|
631
641
|
<dd>
|
632
642
|
<p>コンテキスト中の現在のラインキャップスタイルを設定しま
|
633
643
|
す。どのようにラインキャップスタイルが描画されるかは
|
634
644
|
<a href="cairo-line-cap.html">Cairo::LineCap</a>を見てください。</p>
|
635
645
|
<p>他の描きパラメータと同じように、現在のラインキャップスタ
|
636
|
-
イルは<a href="cairo-context.html#label-
|
637
|
-
<a href="cairo-context.html#label-
|
646
|
+
イルは<a href="cairo-context.html#label-112">Cairo::Context#stroke</a>,
|
647
|
+
<a href="cairo-context.html#label-114">Cairo::Context#stroke_extents</a>
|
638
648
|
で参照されますが、パスを作っているときはまったく影響を
|
639
649
|
与えません。</p>
|
640
650
|
<ul>
|
@@ -644,23 +654,23 @@ extents.height)に貢献しないことに注意してください。</p>
|
|
644
654
|
ることもできます。もちろん、
|
645
655
|
<a href="cairo-line-cap.html">Cairo::LineCap</a>に定義されている定数を指定することもできます。</li>
|
646
656
|
</ul></dd>
|
647
|
-
<dt><a name="label-
|
657
|
+
<dt><a name="label-61" id="label-61"><code>line_join</code></a></dt><!-- RDLabel: "line_join" -->
|
648
658
|
<dd>
|
649
|
-
<a href="cairo-context.html#label-
|
659
|
+
<a href="cairo-context.html#label-63">Cairo::Context#set_line_join</a>で設定した現在の結合点スタ
|
650
660
|
イル(線分中の点を描画する方法)を返します。
|
651
661
|
<ul>
|
652
|
-
<li
|
662
|
+
<li>戻り値: 現在の結合点スタイル。
|
653
663
|
<a href="cairo-line-join.html">Cairo::LineJoin</a>に定義されている定数のどれか。</li>
|
654
664
|
</ul></dd>
|
655
|
-
<dt><a name="label-
|
656
|
-
<dt><a name="label-
|
665
|
+
<dt><a name="label-62" id="label-62"><code>line_join=(<var>line_join</var>)</code></a></dt><!-- RDLabel: "line_join=" -->
|
666
|
+
<dt><a name="label-63" id="label-63"><code>set_line_join(<var>line_join</var>)</code></a></dt><!-- RDLabel: "set_line_join" -->
|
657
667
|
<dd>
|
658
668
|
<p>コンテキスト中の現在の結合点スタイルを設定します。どの
|
659
669
|
ように結合点スタイルが描画されるかは
|
660
670
|
<a href="cairo-line-join.html">Cairo::LineJoin</a>を見てください。</p>
|
661
671
|
<p>他の描きパラメータと同じように、現在の結合点スタイルは
|
662
|
-
<a href="cairo-context.html#label-
|
663
|
-
<a href="cairo-context.html#label-
|
672
|
+
<a href="cairo-context.html#label-112">Cairo::Context#stroke</a>,
|
673
|
+
<a href="cairo-context.html#label-114">Cairo::Context#stroke_extents</a>
|
664
674
|
で参照されますが、パスを作っているときはまったく影響を
|
665
675
|
与えません。</p>
|
666
676
|
<ul>
|
@@ -671,7 +681,7 @@ extents.height)に貢献しないことに注意してください。</p>
|
|
671
681
|
<a href="cairo-line-join.html">Cairo::LineJoin</a>に定義されている定数を指定することもで
|
672
682
|
きます。</li>
|
673
683
|
</ul></dd>
|
674
|
-
<dt><a name="label-
|
684
|
+
<dt><a name="label-64" id="label-64"><code>line_to(<var>x</var>, <var>y</var>)</code></a></dt><!-- RDLabel: "line_to" -->
|
675
685
|
<dd>
|
676
686
|
<p>現在の点からユーザ空間座標で(<var>x</var>, <var>y</var>)の点まで
|
677
687
|
の線分をパスに追加します。呼び出した後は現在の点は
|
@@ -682,18 +692,18 @@ extents.height)に貢献しないことに注意してください。</p>
|
|
682
692
|
<li>x: 新しい線分の終点のX座標</li>
|
683
693
|
<li>y: 新しい線分の終点のY座標</li>
|
684
694
|
</ul></dd>
|
685
|
-
<dt><a name="label-
|
695
|
+
<dt><a name="label-65" id="label-65"><code>line_width</code></a></dt><!-- RDLabel: "line_width" -->
|
686
696
|
<dd>
|
687
|
-
<a href="cairo-context.html#label-
|
697
|
+
<a href="cairo-context.html#label-67">Cairo::Context#set_line_width</a>で設定した値と正確に同じ現
|
688
698
|
在の線幅を返します。この値はたとえ
|
689
|
-
<a href="cairo-context.html#label-
|
690
|
-
<a href="cairo-context.html#label-
|
699
|
+
<a href="cairo-context.html#label-67">Cairo::Context#set_line_width</a>と
|
700
|
+
<a href="cairo-context.html#label-65">Cairo::Context#line_width</a>の呼び出しの間にCTMを変えたと
|
691
701
|
しても変わりません。
|
692
702
|
<ul>
|
693
|
-
<li
|
703
|
+
<li>戻り値: 現在の線幅。</li>
|
694
704
|
</ul></dd>
|
695
|
-
<dt><a name="label-
|
696
|
-
<dt><a name="label-
|
705
|
+
<dt><a name="label-66" id="label-66"><code>line_width=(<var>width</var>)</code></a></dt><!-- RDLabel: "line_width=" -->
|
706
|
+
<dt><a name="label-67" id="label-67"><code>set_line_width(<var>width</var>)</code></a></dt><!-- RDLabel: "set_line_width" -->
|
697
707
|
<dd>
|
698
708
|
<p>コンテキスト中の現在の線幅を設定します。線幅の値はユー
|
699
709
|
ザ空間での丸いペンの直径を指定します。(にもかかわらず
|
@@ -701,23 +711,23 @@ extents.height)に貢献しないことに注意してください。</p>
|
|
701
711
|
大・縮小・剪断・回転のためです。)</p>
|
702
712
|
<p>注: 上記の説明でユーザ空間とCTMにふれたとき、ユーザ空間
|
703
713
|
とCTMは描き操作のときに影響があり、
|
704
|
-
<a href="cairo-context.html#label-
|
714
|
+
<a href="cairo-context.html#label-67">Cairo::Context#set_line_width</a>のときには影響がないといい
|
705
715
|
ました。もっとも単純な使用法はふたつの空間を等しくする
|
706
|
-
ことです。つまり、もし<a href="cairo-context.html#label-
|
716
|
+
ことです。つまり、もし<a href="cairo-context.html#label-67">Cairo::Context#set_line_width</a>と描
|
707
717
|
き操作の間にCTMを変更しなければ、単純にユーザ空間の値を
|
708
|
-
<a href="cairo-context.html#label-
|
718
|
+
<a href="cairo-context.html#label-67">Cairo::Context#set_line_width</a>に渡すことができ、この注は
|
709
719
|
無視することができます。</p>
|
710
720
|
<p>他の描きパラメータと同じように、現在の線幅は
|
711
|
-
<a href="cairo-context.html#label-
|
712
|
-
<a href="cairo-context.html#label-
|
721
|
+
<a href="cairo-context.html#label-112">Cairo::Context#stroke</a>,
|
722
|
+
<a href="cairo-context.html#label-114">Cairo::Context#stroke_extents</a>
|
713
723
|
で参照されますが、パスを作っているときはまったく影響を
|
714
724
|
与えません。</p>
|
715
725
|
<p>デフォルトの線幅は<code>2.0</code>です。</p>
|
716
726
|
<ul>
|
717
727
|
<li>width: 線幅</li>
|
718
728
|
</ul></dd>
|
719
|
-
<dt><a name="label-
|
720
|
-
<dt><a name="label-
|
729
|
+
<dt><a name="label-68" id="label-68"><code>mask(<var>pattern</var>)</code></a></dt><!-- RDLabel: "mask" -->
|
730
|
+
<dt><a name="label-69" id="label-69"><code>mask(<var>surface</var>, <var>x</var>, <var>y</var>)</code></a></dt><!-- RDLabel: "mask" -->
|
721
731
|
<dd>
|
722
732
|
<var>pattern</var>(または<var>surface</var>)のアルファチャンネル
|
723
733
|
をマスクとして使って現在のソースを塗る描画操作です。
|
@@ -733,28 +743,28 @@ extents.height)に貢献しないことに注意してください。</p>
|
|
733
743
|
<li>x: <var>surface</var>を置く基点のX座標</li>
|
734
744
|
<li>y: <var>surface</var>を置く基点のY座標</li>
|
735
745
|
</ul></dd>
|
736
|
-
<dt><a name="label-
|
746
|
+
<dt><a name="label-70" id="label-70"><code>matrix</code></a></dt><!-- RDLabel: "matrix" -->
|
737
747
|
<dd>
|
738
748
|
現在の変換行列(CTM)を返します。
|
739
749
|
<ul>
|
740
|
-
<li
|
750
|
+
<li>戻り値: <a href="cairo-matrix.html">Cairo::Matrix</a>オブジェクト</li>
|
741
751
|
</ul></dd>
|
742
|
-
<dt><a name="label-
|
743
|
-
<dt><a name="label-
|
752
|
+
<dt><a name="label-71" id="label-71"><code>matrix=(<var>matrix</var>)</code></a></dt><!-- RDLabel: "matrix=" -->
|
753
|
+
<dt><a name="label-72" id="label-72"><code>set_matrix(<var>matrix</var>)</code></a></dt><!-- RDLabel: "set_matrix" -->
|
744
754
|
<dd>
|
745
755
|
現在の変換行列(CTM)を<var>matrix</var>に変更します。
|
746
756
|
<ul>
|
747
757
|
<li>matrix: <a href="cairo-matrix.html">Cairo::Matrix</a>オブジェクト</li>
|
748
758
|
</ul></dd>
|
749
|
-
<dt><a name="label-
|
759
|
+
<dt><a name="label-73" id="label-73"><code>miter_limit</code></a></dt><!-- RDLabel: "miter_limit" -->
|
750
760
|
<dd>
|
751
|
-
<a href="cairo-context.html#label-
|
761
|
+
<a href="cairo-context.html#label-75">Cairo::Context#set_miter_limit</a>で設定した現在の留め継ぎ
|
752
762
|
限界を返します。
|
753
763
|
<ul>
|
754
|
-
<li
|
764
|
+
<li>戻り値: 留め継ぎ限界値</li>
|
755
765
|
</ul></dd>
|
756
|
-
<dt><a name="label-
|
757
|
-
<dt><a name="label-
|
766
|
+
<dt><a name="label-74" id="label-74"><code>miter_limit=(<var>limit</var>)</code></a></dt><!-- RDLabel: "miter_limit=" -->
|
767
|
+
<dt><a name="label-75" id="label-75"><code>set_miter_limit(<var>limit</var>)</code></a></dt><!-- RDLabel: "set_miter_limit" -->
|
758
768
|
<dd>
|
759
769
|
<p>コンテキストの中に現在の留め継ぎ限界を設定します。</p>
|
760
770
|
<p>現在の結合点スタイルが<a href="cairo-line-join.html#label-3">Cairo::LineJoin::MITER</a>の場合は
|
@@ -768,14 +778,14 @@ extents.height)に貢献しないことに注意してください。</p>
|
|
768
778
|
<p>cairoは留め継ぎの長さを線幅で割ります。その結果が留め
|
769
779
|
継ぎ限界よりも大きい場合は、斜角スタイルを使います。</p>
|
770
780
|
<p>他の描きパラメータと同じように、現在の留め継ぎ限界は
|
771
|
-
<a href="cairo-context.html#label-
|
772
|
-
<a href="cairo-context.html#label-
|
781
|
+
<a href="cairo-context.html#label-112">Cairo::Context#stroke</a>,
|
782
|
+
<a href="cairo-context.html#label-114">Cairo::Context#stroke_extents</a>
|
773
783
|
で参照されますが、パスを作っているときはまったく影響を
|
774
784
|
与えません。</p>
|
775
785
|
<ul>
|
776
786
|
<li>limit: 留め継ぎ限界</li>
|
777
787
|
</ul></dd>
|
778
|
-
<dt><a name="label-
|
788
|
+
<dt><a name="label-76" id="label-76"><code>move_to(<var>x</var>, <var>y</var>)</code></a></dt><!-- RDLabel: "move_to" -->
|
779
789
|
<dd>
|
780
790
|
新しいサブパスを始めます。呼び出した後は現在の点は
|
781
791
|
(<var>x</var>, <var>y</var>)になります。
|
@@ -783,30 +793,30 @@ extents.height)に貢献しないことに注意してください。</p>
|
|
783
793
|
<li>x: 新しい位置のX座標</li>
|
784
794
|
<li>y: 新しい位置のY座標</li>
|
785
795
|
</ul></dd>
|
786
|
-
<dt><a name="label-
|
796
|
+
<dt><a name="label-77" id="label-77"><code>new_path</code></a></dt><!-- RDLabel: "new_path" -->
|
787
797
|
<dd>
|
788
798
|
現在のパスを消去します。呼び出した後はパスも現在の点も
|
789
799
|
なくなります。</dd>
|
790
|
-
<dt><a name="label-
|
800
|
+
<dt><a name="label-78" id="label-78"><code>new_sub_path</code></a></dt><!-- RDLabel: "new_sub_path" -->
|
791
801
|
<dd>
|
792
802
|
<p>新しいサブパスを始めます。既存のパスには影響を与えない
|
793
803
|
ことに注意してください。呼び出した後は現在の点はなくな
|
794
804
|
ります。</p>
|
795
805
|
<p>多くの場合、この呼び出しは必要ありません。なぜなら新し
|
796
|
-
いサブパスの多くは<a href="cairo-context.html#label-
|
806
|
+
いサブパスの多くは<a href="cairo-context.html#label-76">Cairo::Context#move_to</a>で始めるからで
|
797
807
|
す。</p>
|
798
|
-
<p><a href="cairo-context.html#label-
|
799
|
-
<a href="cairo-context.html#label-
|
800
|
-
物事を簡単にします。もう手動で<a href="cairo-context.html#label-
|
808
|
+
<p><a href="cairo-context.html#label-78">Cairo::Context#new_sub_path</a>は新しいサブパスを
|
809
|
+
<a href="cairo-context.html#label-11">Cairo::Context#arc</a>で始める場合に特に役立ちます。これは
|
810
|
+
物事を簡単にします。もう手動で<a href="cairo-context.html#label-76">Cairo::Context#move_to</a>を
|
801
811
|
呼び出すための円弧の初期座標を計算する必要がないのです。</p></dd>
|
802
|
-
<dt><a name="label-
|
812
|
+
<dt><a name="label-79" id="label-79"><code>operator</code></a></dt><!-- RDLabel: "operator" -->
|
803
813
|
<dd>
|
804
814
|
現在の合成操作を返します。
|
805
815
|
<ul>
|
806
|
-
<li
|
816
|
+
<li>戻り値: <a href="cairo-operator.html">Cairo::Operator</a>に定義されている定数のどれか。</li>
|
807
817
|
</ul></dd>
|
808
|
-
<dt><a name="label-
|
809
|
-
<dt><a name="label-
|
818
|
+
<dt><a name="label-80" id="label-80"><code>operator=(<var>operator</var>)</code></a></dt><!-- RDLabel: "operator=" -->
|
819
|
+
<dt><a name="label-81" id="label-81"><code>set_operator(<var>operator</var>)</code></a></dt><!-- RDLabel: "set_operator" -->
|
810
820
|
<dd>
|
811
821
|
全ての描画操作で使われる合成操作を設定します。利用可能
|
812
822
|
な各合成操作の意味の詳細は<a href="cairo-operator.html">Cairo::Operator</a>を見てください。
|
@@ -817,22 +827,22 @@ extents.height)に貢献しないことに注意してください。</p>
|
|
817
827
|
ることもできます。もちろん、<a href="cairo-operator.html">Cairo::Operator</a>に定義され
|
818
828
|
ている定数を指定することもできます。</li>
|
819
829
|
</ul></dd>
|
820
|
-
<dt><a name="label-
|
821
|
-
<dt><a name="label-
|
830
|
+
<dt><a name="label-82" id="label-82"><code>paint</code></a></dt><!-- RDLabel: "paint" -->
|
831
|
+
<dt><a name="label-83" id="label-83"><code>paint(<var>alpha</var>)</code></a></dt><!-- RDLabel: "paint" -->
|
822
832
|
<dd>
|
823
833
|
現在のソースを現在の切り取り範囲全体に塗る描画操作です。
|
824
834
|
<var>alpha</var>を指定すると、指定したアルファ値で塗られます。
|
825
835
|
<ul>
|
826
836
|
<li>alpha: アルファ値。0(透明)〜1(不透明)の間。</li>
|
827
837
|
</ul></dd>
|
828
|
-
<dt><a name="label-
|
838
|
+
<dt><a name="label-84" id="label-84"><code>pop_group(<var>to_source</var>=<var>false</var>)</code></a></dt><!-- RDLabel: "pop_group" -->
|
829
839
|
<dd>
|
830
|
-
<p><a href="cairo-context.html#label-
|
840
|
+
<p><a href="cairo-context.html#label-86">Cairo::Context#push_group</a>ではじめた出力先の変更を終了し
|
831
841
|
ます。グループに実行した全ての描画操作の結果を含んだ新
|
832
842
|
しいパターンを返します。</p>
|
833
|
-
<p><a href="cairo-context.html#label-
|
834
|
-
出します(<a href="cairo-context.html#label-
|
835
|
-
<a href="cairo-context.html#label-
|
843
|
+
<p><a href="cairo-context.html#label-84">Cairo::Context#pop_group</a>は<a href="cairo-context.html#label-94">Cairo::Context#restore</a>を呼び
|
844
|
+
出します(<a href="cairo-context.html#label-86">Cairo::Context#push_group</a>が呼び出した
|
845
|
+
<a href="cairo-context.html#label-96">Cairo::Context#save</a>に対応します)。グループ内で行ったグ
|
836
846
|
ラフィックス状態の変更はグループの外側には見えません。</p>
|
837
847
|
<p><var>to_source</var>が真の場合は以下と同じ動作になります。</p>
|
838
848
|
<pre>group = context.pop_group(false)
|
@@ -840,22 +850,22 @@ context.set_source(group)</pre>
|
|
840
850
|
<ul>
|
841
851
|
<li>to_source: グループをコンテキストのソースに設定するか
|
842
852
|
どうか。</li>
|
843
|
-
<li
|
853
|
+
<li>戻り値: <var>to_source</var>が真の場合は<code>nil</code>。偽の場
|
844
854
|
合は新しく作られた(サーフェス)パターン。パターンは
|
845
855
|
グループに実行した全ての描画操作の結果を含んでいます。</li>
|
846
856
|
</ul></dd>
|
847
|
-
<dt><a name="label-
|
857
|
+
<dt><a name="label-85" id="label-85"><code>pop_group_to_source</code></a></dt><!-- RDLabel: "pop_group_to_source" -->
|
848
858
|
<dd>
|
849
|
-
<p>以下と同じです。詳しくは<a href="cairo-context.html#label-
|
859
|
+
<p>以下と同じです。詳しくは<a href="cairo-context.html#label-84">Cairo::Context#pop_group</a>を見て
|
850
860
|
ください。</p>
|
851
861
|
<pre>context.pop_group(true)</pre></dd>
|
852
|
-
<dt><a name="label-
|
853
|
-
<dt><a name="label-
|
862
|
+
<dt><a name="label-86" id="label-86"><code>push_group(<var>context</var>=<var>nil</var>)</code></a></dt><!-- RDLabel: "push_group" -->
|
863
|
+
<dt><a name="label-87" id="label-87"><code>push_group(<var>context</var>=<var>nil</var>, <var>pop_to_source</var>=<var>true</var>) {|<var>self</var>| ...}</code></a></dt><!-- RDLabel: "push_group" -->
|
854
864
|
<dd>
|
855
865
|
<p>一時的にグループとして知られている中間サーフェスに描画
|
856
866
|
の出力先を変更します。出力先の変更は
|
857
|
-
<a href="cairo-context.html#label-
|
858
|
-
す。<a href="cairo-context.html#label-
|
867
|
+
<a href="cairo-context.html#label-84">Cairo::Context#pop_group</a>でグループを終了するまで続きま
|
868
|
+
す。<a href="cairo-context.html#label-84">Cairo::Context#pop_group</a>はグループに対する全ての描
|
859
869
|
画の結果をパターンとして返します(パターンオブジェクト
|
860
870
|
そのものを返すか、ソースパターンに設定します)。</p>
|
861
871
|
<p>グループ機能は中間合成を行うのに便利です。グループの一
|
@@ -863,19 +873,19 @@ context.set_source(group)</pre>
|
|
863
873
|
クトを描画し、その結果を本当の描画先上に透明度つきで混
|
864
874
|
ぜ合わせるというものです。</p>
|
865
875
|
<p>グループは任意の深さで入れ子にすることができます。この
|
866
|
-
ためには釣り合いの取れた<a href="cairo-context.html#label-
|
867
|
-
<a href="cairo-context.html#label-
|
876
|
+
ためには釣り合いの取れた<a href="cairo-context.html#label-86">Cairo::Context#push_group</a>と
|
877
|
+
<a href="cairo-context.html#label-84">Cairo::Context#pop_group</a>のペアを使います。各push/popは
|
868
878
|
新しい対象グループをスタックの上に置くあるいは取り除き
|
869
879
|
ます。</p>
|
870
|
-
<p><a href="cairo-context.html#label-
|
880
|
+
<p><a href="cairo-context.html#label-86">Cairo::Context#push_group</a>は<a href="cairo.html">Cairo</a>:Context#saveを呼ぶので、
|
871
881
|
いかなるグラフィックス状態の変更もグループの外には見え
|
872
|
-
ません。(<a href="cairo-context.html#label-
|
873
|
-
<a href="cairo-context.html#label-
|
882
|
+
ません。(<a href="cairo-context.html#label-84">Cairo::Context#pop_group</a>は
|
883
|
+
<a href="cairo-context.html#label-94">Cairo::Context#restore</a>を呼びます。)</p>
|
874
884
|
<p>デフォルトでは中間グループの中身の種類は
|
875
885
|
<a href="cairo-content.html#label-4">Cairo::Content::COLOR_ALPHA</a>になります。他の種類を選ぶに
|
876
886
|
は<var>content</var>を指定します。</p>
|
877
887
|
<p>ブロックを指定すると、ブロックを抜けた時点で自動的に
|
878
|
-
<a href="cairo-context.html#label-
|
888
|
+
<a href="cairo-context.html#label-84">Cairo::Context#pop_group</a>を呼び出します。
|
879
889
|
<var>pop_to_group</var>が真または<code>nil</code>の場合は、ポップし
|
880
890
|
たときにグループをソースに設定します。</p>
|
881
891
|
<p>以下は、描きの下にある塗りを見せることなく、半透明の塗
|
@@ -898,15 +908,15 @@ context.paint(alpha)</pre>
|
|
898
908
|
<li>pop_to_source: 真あるいは<code>nil</code>ならブロックを抜け
|
899
909
|
るときに<code>context.pop_group(false)</code>ではなく、
|
900
910
|
<code>context.pop_group(true)</code>を使います(違いは
|
901
|
-
<a href="cairo-context.html#label-
|
911
|
+
<a href="cairo-context.html#label-84">Cairo::Context#pop_group</a>を見てください)。ブロックが指
|
902
912
|
定されていない場合は何の影響もありません。</li>
|
903
913
|
</ul></dd>
|
904
|
-
<dt><a name="label-
|
914
|
+
<dt><a name="label-88" id="label-88"><code>rectangle(<var>x</var>, <var>y</var>, <var>width</var>, <var>height</var>)</code></a></dt><!-- RDLabel: "rectangle" -->
|
905
915
|
<dd>
|
906
916
|
<p>指定された大きさの閉じた四角いサブパスを現在のパスに追
|
907
917
|
加します。四角はユーザ空間座標で(<var>x</var>, <var>y</var>)の位
|
908
918
|
置に作られます。角を丸くしたい場合は
|
909
|
-
<a href="cairo-context.html#label-
|
919
|
+
<a href="cairo-context.html#label-89">Cairo::Context#rounded_rectangle</a>を使ってください。</p>
|
910
920
|
<p>論理的には以下と等しいです。</p>
|
911
921
|
<pre>context.move_to(x, y)
|
912
922
|
context.rel_line_to(width, 0)
|
@@ -919,13 +929,13 @@ context.close_path</pre>
|
|
919
929
|
<li>width: 四角の幅</li>
|
920
930
|
<li>height: 四角の高さ</li>
|
921
931
|
</ul></dd>
|
922
|
-
<dt><a name="label-
|
932
|
+
<dt><a name="label-89" id="label-89"><code>rounded_rectangle(<var>x</var>, <var>y</var>, <var>width</var>, <var>height</var>, <var>x_radius</var>, <var>y_radius</var>=<var>nil</var>)</code></a></dt><!-- RDLabel: "rounded_rectangle" -->
|
923
933
|
<dd>
|
924
934
|
<a href="cairo-context-rectangle.html#label-2">Cairo::Context::Rectangle#rounded_rectangle</a>を見てくださ
|
925
935
|
い。</dd>
|
926
|
-
<dt><a name="label-
|
936
|
+
<dt><a name="label-90" id="label-90"><code>rel_curve_to(<var>dx1</var>, <var>dy1</var>, <var>dx2</var>, <var>dy2</var>, <var>dx3</var>, <var>dy3</var>)</code></a></dt><!-- RDLabel: "rel_curve_to" -->
|
927
937
|
<dd>
|
928
|
-
<p><a href="cairo-context.html#label-
|
938
|
+
<p><a href="cairo-context.html#label-25">Cairo::Context#curve_to</a>の相対座標版です。全ての
|
929
939
|
値は現在の点からの相対的な値になります。現在の点から相
|
930
940
|
対点(<var>dx3</var>, <var>dy3</var>)((現在の点のX座標 +
|
931
941
|
<var>dx3</var>, 現在の点のY座標 + <var>dy3</var>)の点のこと)まで
|
@@ -949,9 +959,9 @@ context.curve_to(x + dx1, y + dy1,
|
|
949
959
|
<li>dx3: 曲線の終点のX方向の補正値</li>
|
950
960
|
<li>dy3: 曲線の終点のY方向の補正値</li>
|
951
961
|
</ul></dd>
|
952
|
-
<dt><a name="label-
|
962
|
+
<dt><a name="label-91" id="label-91"><code>rel_line_to(<var>dx</var>, <var>dy</var>)</code></a></dt><!-- RDLabel: "rel_line_to" -->
|
953
963
|
<dd>
|
954
|
-
<p><a href="cairo-context.html#label-
|
964
|
+
<p><a href="cairo-context.html#label-64">Cairo::Context#line_to</a>の相対座標版です。現在の点から相
|
955
965
|
対点(<var>dx</var>, <var>dy</var>)((現在の点のX座標 +
|
956
966
|
<var>dx</var>, 現在の点のY座標 + <var>dy</var>)の点のこと)までの
|
957
967
|
線分を追加します。相対点はユーザ空間を用います。呼び出
|
@@ -966,7 +976,7 @@ context.line_to(x + dx, y + dy)</pre>
|
|
966
976
|
<li>dx: 新しい線分の終点のX方向の補正値</li>
|
967
977
|
<li>dy: 新しい線分の終点のY方向の補正値</li>
|
968
978
|
</ul></dd>
|
969
|
-
<dt><a name="label-
|
979
|
+
<dt><a name="label-92" id="label-92"><code>rel_move_to(<var>dx</var>, <var>dy</var>)</code></a></dt><!-- RDLabel: "rel_move_to" -->
|
970
980
|
<dd>
|
971
981
|
<p>新しいサブパスを始めます。呼び出した後は現在の点は相
|
972
982
|
対点(<var>dx</var>, <var>dy</var>)((現在の点のX座標 +
|
@@ -982,7 +992,7 @@ context.move_to(x + dx, y + dy)</pre>
|
|
982
992
|
<li>dx: 新しい位置のX方向の補正値</li>
|
983
993
|
<li>dy: 新しい位置のY方向の補正値</li>
|
984
994
|
</ul></dd>
|
985
|
-
<dt><a name="label-
|
995
|
+
<dt><a name="label-93" id="label-93"><code>reset_clip</code></a></dt><!-- RDLabel: "reset_clip" -->
|
986
996
|
<dd>
|
987
997
|
<p>現在の切り取り領域を元のなにも制限されていない状態に戻
|
988
998
|
します。つまり、切り取り領域を対象サーフェスを含む無限
|
@@ -990,17 +1000,17 @@ context.move_to(x + dx, y + dy)</pre>
|
|
990
1000
|
ことが難しいなら、切り取り領域を対象サーフェスの境界と
|
991
1001
|
まったく同じ大きさに設定しなおすと考えても同じことです。</p>
|
992
1002
|
<p>コードを再利用可能にしたいなら、
|
993
|
-
<a href="cairo-context.html#label-
|
994
|
-
い。そうしないと<a href="cairo-context.html#label-
|
1003
|
+
<a href="cairo-context.html#label-93">Cairo::Context#reset_clip</a>を呼ばないように注意してくださ
|
1004
|
+
い。そうしないと<a href="cairo-context.html#label-14">Cairo::Context#clip</a>を呼んでいる高レベル
|
995
1005
|
なコードが予期しない結果になるでしょう。一時的に切り取
|
996
|
-
り領域を制限するより堅牢な方法は<a href="cairo-context.html#label-
|
997
|
-
<a href="cairo-context.html#label-
|
1006
|
+
り領域を制限するより堅牢な方法は<a href="cairo-context.html#label-96">Cairo::Context#save</a>と
|
1007
|
+
<a href="cairo-context.html#label-94">Cairo::Context#restore</a>で<a href="cairo-context.html#label-14">Cairo::Context#clip</a>を囲むことで
|
998
1008
|
す。</p></dd>
|
999
|
-
<dt><a name="label-
|
1009
|
+
<dt><a name="label-94" id="label-94"><code>restore</code></a></dt><!-- RDLabel: "restore" -->
|
1000
1010
|
<dd>
|
1001
|
-
ひとつ前の<a href="cairo-context.html#label-
|
1011
|
+
ひとつ前の<a href="cairo-context.html#label-96">Cairo::Context#save</a>で保存した状態を復元します。
|
1002
1012
|
復元された状態はスタックから削除されます。</dd>
|
1003
|
-
<dt><a name="label-
|
1013
|
+
<dt><a name="label-95" id="label-95"><code>rotate(<var>angle</var>)</code></a></dt><!-- RDLabel: "rotate" -->
|
1004
1014
|
<dd>
|
1005
1015
|
<var>angle</var>ラジアンだけユーザ空間の軸を回転するように、
|
1006
1016
|
現在の変換行列(CTM)を変更します。すでに存在するユーザ
|
@@ -1009,18 +1019,18 @@ context.move_to(x + dx, y + dy)</pre>
|
|
1009
1019
|
<ul>
|
1010
1020
|
<li>angle: ユーザ空間の軸を回転させる角度(ラジアン)</li>
|
1011
1021
|
</ul></dd>
|
1012
|
-
<dt><a name="label-
|
1013
|
-
<dt><a name="label-
|
1022
|
+
<dt><a name="label-96" id="label-96"><code>save</code></a></dt><!-- RDLabel: "save" -->
|
1023
|
+
<dt><a name="label-97" id="label-97"><code>save {|<var>self</var>| ...}</code></a></dt><!-- RDLabel: "save" -->
|
1014
1024
|
<dd>
|
1015
1025
|
<p>現在の状態のコピーを作成し、保存された状態の内部スタッ
|
1016
|
-
クに保存します。<a href="cairo-context.html#label-
|
1017
|
-
保存された状態を復元します。複数の<a href="cairo-context.html#label-
|
1018
|
-
<a href="cairo-context.html#label-
|
1019
|
-
<a href="cairo-context.html#label-
|
1026
|
+
クに保存します。<a href="cairo-context.html#label-94">Cairo::Context#restore</a>が呼ばれたときは、
|
1027
|
+
保存された状態を復元します。複数の<a href="cairo-context.html#label-96">Cairo::Context#save</a>と
|
1028
|
+
<a href="cairo-context.html#label-94">Cairo::Context#restore</a>が入れ子にできます。各
|
1029
|
+
<a href="cairo-context.html#label-94">Cairo::Context#restore</a>は対応する<a href="cairo-context.html#label-96">Cairo::Context#save</a>が保
|
1020
1030
|
存した状態を復元します。</p>
|
1021
1031
|
<p>ブロックを指定した場合はブロックを抜けるときに自動的に
|
1022
|
-
<a href="cairo-context.html#label-
|
1023
|
-
<dt><a name="label-
|
1032
|
+
<a href="cairo-context.html#label-94">Cairo::Context#restore</a>を呼び出します。</p></dd>
|
1033
|
+
<dt><a name="label-98" id="label-98"><code>scale(<var>sx</var>, <var>sy</var>)</code></a></dt><!-- RDLabel: "scale" -->
|
1024
1034
|
<dd>
|
1025
1035
|
ユーザ空間のX軸とY軸をそれぞれ<var>sx</var>と<var>sy</var>で拡大す
|
1026
1036
|
るように現在の変換行列を変更します。すでに存在するユー
|
@@ -1029,16 +1039,16 @@ context.move_to(x + dx, y + dy)</pre>
|
|
1029
1039
|
<li>sx: X方向の拡大率</li>
|
1030
1040
|
<li>sy: Y方向の拡大率</li>
|
1031
1041
|
</ul></dd>
|
1032
|
-
<dt><a name="label-
|
1042
|
+
<dt><a name="label-99" id="label-99"><code>scaled_font</code></a></dt><!-- RDLabel: "scaled_font" -->
|
1033
1043
|
<dd>
|
1034
1044
|
<p>コンテキストに現在設定されている<a href="cairo-scaled-font.html">Cairo::ScaledFont</a>を返し
|
1035
1045
|
ます。</p>
|
1036
1046
|
<p>メモリがたりない場合はNoMemoryError例外が発生します。</p>
|
1037
1047
|
<ul>
|
1038
|
-
<li
|
1048
|
+
<li>戻り値: 現在の<a href="cairo-scaled-font.html">Cairo::ScaledFont</a></li>
|
1039
1049
|
</ul></dd>
|
1040
|
-
<dt><a name="label-
|
1041
|
-
<dt><a name="label-
|
1050
|
+
<dt><a name="label-100" id="label-100"><code>scaled_font=(<var>font</var>)</code></a></dt><!-- RDLabel: "scaled_font=" -->
|
1051
|
+
<dt><a name="label-101" id="label-101"><code>set_scaled_font(<var>font</var>)</code></a></dt><!-- RDLabel: "set_scaled_font" -->
|
1042
1052
|
<dd>
|
1043
1053
|
現在のフォントフェイス、フォント用行列、フォントオプショ
|
1044
1054
|
ンを指定した<var>font</var>の値で置き換えます。いくつかの変
|
@@ -1048,18 +1058,40 @@ context.move_to(x + dx, y + dy)</pre>
|
|
1048
1058
|
<ul>
|
1049
1059
|
<li>font: <a href="cairo-scaled-font.html">Cairo::ScaledFont</a>オブジェクト</li>
|
1050
1060
|
</ul></dd>
|
1051
|
-
<dt><a name="label-
|
1052
|
-
<dd>
|
1053
|
-
|
1054
|
-
|
1055
|
-
|
1056
|
-
|
1057
|
-
|
1058
|
-
|
1059
|
-
|
1060
|
-
|
1061
|
-
|
1062
|
-
|
1061
|
+
<dt><a name="label-102" id="label-102"><code>select_font_face(<var>family</var>=<var>nil</var>, <var>slant</var>=<var>nil</var>, <var>weight</var>=<var>nil</var>)</code></a></dt><!-- RDLabel: "select_font_face" -->
|
1062
|
+
<dd>
|
1063
|
+
<p>注: このメソッドはcairoの設計者が「おもちゃのような」テ
|
1064
|
+
キストAPIと呼んでいるものの一部です。小さなデモや胆汁な
|
1065
|
+
プログラムには便利ですが、まじめにテキストを使うアプリ
|
1066
|
+
ケーションに十分な能力があることは期待されていません。</p>
|
1067
|
+
<p>フォント名、傾き、重みという単純化した記述からフォント
|
1068
|
+
ファミリーとスタイルを選択します。cairoはシステムで利用
|
1069
|
+
可能な全てのフォントの一覧を返すなどというような操作は
|
1070
|
+
提供しません。(このAPIは「おもちゃ」であることを思いだ
|
1071
|
+
してください。)しかし、CSS2の仕様にある標準的なファミ
|
1072
|
+
リー名("serif", "sans-serif", "cursive", "fantasy",
|
1073
|
+
"monospace")は期待通りに動きます。</p>
|
1074
|
+
<p>利用可能なフォント一覧のような「本当の」フォント対応が
|
1075
|
+
必要な場合は、下位にあるフォントシステムを直接呼び出す
|
1076
|
+
必要があるでしょう。(例えばfontconfやfreetype)</p>
|
1077
|
+
<p>多くのアプリケーションはcairoに加えてより包括的なフォント
|
1078
|
+
処理とテキスト配置ライブラリを使う必要があるでしょう。
|
1079
|
+
(例えばPango)</p>
|
1080
|
+
<p><a href="cairo-context.html#label-102">Cairo::Context#select_font_face</a>または
|
1081
|
+
<a href="cairo-context.html#label-40">Cairo::Context#font_face=</a>や<a href="cairo-context.html#label-100">Cairo::Context#scaled_font=</a>
|
1082
|
+
のような関連するフォント選択APIを呼び出さずにテキストを
|
1083
|
+
描画した場合は、プラットフォーム依存のデフォルトのフォ
|
1084
|
+
ントファミリーが使われます。これは本質的には
|
1085
|
+
"sans-serif"です。デフォルトの傾きは
|
1086
|
+
<a href="cairo-font-slant.html#label-3">Cairo::FontSlant::NORMAL</a>で重みは
|
1087
|
+
<a href="cairo-font-weight.html#label-3">Cairo::FontWeight::NORMAL</a>です。</p>
|
1088
|
+
<p>このメソッドは<a href="cairo-toy-font-face.html#label-3">Cairo::ToyFontFace.new</a>で作成したフォント
|
1089
|
+
フェイスを<a href="cairo-context.html#label-40">Cairo::Context#font_face=</a>で設定することと等価
|
1090
|
+
です。</p>
|
1091
|
+
<ul>
|
1092
|
+
<li>family: "serif"のようなUTF-8で符号化されたフォントファ
|
1093
|
+
ミリー名。<code>nil</code>や空文字列の場合はプラットフォーム
|
1094
|
+
依存のフォンファミリー名が使われます。</li>
|
1063
1095
|
<li>slant: フォントの傾き。:normalや:italicなど
|
1064
1096
|
<a href="cairo-font-slant.html">Cairo::FontSlant</a>に定義されている定数名と同じもの。
|
1065
1097
|
大文字小文字は関係ありません。また、シンボル
|
@@ -1075,9 +1107,9 @@ context.move_to(x + dx, y + dy)</pre>
|
|
1075
1107
|
<code>nil</code>の場合はデフォルト値として
|
1076
1108
|
<a href="cairo-font-weight.html#label-3">Cairo::FontWeight::NORMAL</a>が使われます。</li>
|
1077
1109
|
</ul></dd>
|
1078
|
-
<dt><a name="label-
|
1110
|
+
<dt><a name="label-103" id="label-103"><code>set_dash(<var>dashes</var>, <var>offset</var>=<var>0</var>)</code></a></dt><!-- RDLabel: "set_dash" -->
|
1079
1111
|
<dd>
|
1080
|
-
<p><a href="cairo-context.html#label-
|
1112
|
+
<p><a href="cairo-context.html#label-112">Cairo::Context#stroke</a>で使われるダッシュのパターンを設定
|
1081
1113
|
します。ダッシュのパターンは正の値の配列として
|
1082
1114
|
<var>dashes</var>で指定します。それぞれの値は描かれるときに
|
1083
1115
|
交互にon/offになる部分(線を描く部分と描かない部分)の
|
@@ -1089,7 +1121,7 @@ context.move_to(x + dx, y + dy)</pre>
|
|
1089
1121
|
<a href="cairo-line-cap.html#label-3">Cairo::LineCap::ROUND</a>/<a href="cairo-line-cap.html#label-4">Cairo::LineCap::SQUARE</a>を設定して
|
1090
1122
|
0.0の長さのonを使う場合は有効です。</p>
|
1091
1123
|
<p>注: 長さの値は描きのときに評価されたユーザ空間の単位で
|
1092
|
-
す。つまり、<a href="cairo-context.html#label-
|
1124
|
+
す。つまり、<a href="cairo-context.html#label-103">Cairo::Context#set_dash</a>のときにユーザ空間を
|
1093
1125
|
合わせる必要はありません。</p>
|
1094
1126
|
<p>もし<var>dashes</var>が<code>nil</code>または空配列ならダッシュは無
|
1095
1127
|
効になります。</p>
|
@@ -1108,12 +1140,12 @@ context.move_to(x + dx, y + dy)</pre>
|
|
1108
1140
|
<li>offset: ダッシュパターンを描きを始めるべき位置を補正
|
1109
1141
|
する値。</li>
|
1110
1142
|
</ul></dd>
|
1111
|
-
<dt><a name="label-
|
1143
|
+
<dt><a name="label-104" id="label-104"><code>set_source(<var>source</var>)</code></a></dt><!-- RDLabel: "set_source" -->
|
1112
1144
|
<dd>
|
1113
1145
|
<p>コンテキストのソースパターンを<var>source</var>に設定します。
|
1114
1146
|
このパターンは新しいソースパターンを指定するまでその後の
|
1115
1147
|
すべての描画操作に使われます。</p>
|
1116
|
-
<p>注: パターンの変換行列は<a href="cairo-context.html#label-
|
1148
|
+
<p>注: パターンの変換行列は<a href="cairo-context.html#label-104">Cairo::Context#set_source</a>を使っ
|
1117
1149
|
た時点のユーザ空間の効果に固定されます。これは、さらに現
|
1118
1150
|
在の変換行列を変更してもソースパターンには影響はないとい
|
1119
1151
|
うことです。<a href="cairo-pattern.html#label-14">Cairo::Pattern#set_matrix</a>を見てください。</p>
|
@@ -1121,8 +1153,8 @@ context.move_to(x + dx, y + dy)</pre>
|
|
1121
1153
|
<li>source: 今後の描画操作で仕様する<a href="cairo-pattern.html">Cairo::Pattern</a>オブジェ
|
1122
1154
|
クト。</li>
|
1123
1155
|
</ul></dd>
|
1124
|
-
<dt><a name="label-
|
1125
|
-
<dt><a name="label-
|
1156
|
+
<dt><a name="label-105" id="label-105"><code>set_source_rgb(<var>red</var>, <var>green</var>, <var>blue</var>)</code></a></dt><!-- RDLabel: "set_source_rgb" -->
|
1157
|
+
<dt><a name="label-106" id="label-106"><code>set_source_rgba(<var>red</var>, <var>green</var>, <var>blue</var>, <var>alpha</var>=<var>1</var>.<var>0</var>)</code></a></dt><!-- RDLabel: "set_source_rgba" -->
|
1126
1158
|
<dd>
|
1127
1159
|
<p>コンテキストのソースパターンの色を指定します。
|
1128
1160
|
<var>alpha</var>を指定することによって半透明にすることもでき
|
@@ -1131,17 +1163,17 @@ context.move_to(x + dx, y + dy)</pre>
|
|
1131
1163
|
<p>色とアルファ値は0から1までの浮動小数点です。もし、この範
|
1132
1164
|
囲におさまらなかった場合は強制的にこの範囲におさめます。</p>
|
1133
1165
|
<p>より簡単に色を指定したい場合は
|
1134
|
-
<a href="cairo-context.html#label-
|
1166
|
+
<a href="cairo-context.html#label-107">Cairo::Context#set_source_color</a>を使ってください。</p>
|
1135
1167
|
<ul>
|
1136
1168
|
<li>red: 色の赤の部分</li>
|
1137
1169
|
<li>green: 色の緑の部分</li>
|
1138
1170
|
<li>blue: 色の青の部分</li>
|
1139
1171
|
<li>alpha: 色のアルファチャンネルの部分</li>
|
1140
1172
|
</ul></dd>
|
1141
|
-
<dt><a name="label-
|
1173
|
+
<dt><a name="label-107" id="label-107"><code>set_source_color(<var>color</var>)</code></a></dt><!-- RDLabel: "set_source_color" -->
|
1142
1174
|
<dd>
|
1143
1175
|
<a href="cairo-context-color.html#label-2">Cairo::Context::Color#set_source_color</a>を見てください。</dd>
|
1144
|
-
<dt><a name="label-
|
1176
|
+
<dt><a name="label-108" id="label-108"><code>show_glyphs(<var>glyphs</var>)</code></a></dt><!-- RDLabel: "show_glyphs" -->
|
1145
1177
|
<dd>
|
1146
1178
|
グリフの配列から形を生成する描画操作です。描画には現在の
|
1147
1179
|
フォントフェイス、フォントサイズ(フォント用変換行列)、
|
@@ -1149,13 +1181,13 @@ context.move_to(x + dx, y + dy)</pre>
|
|
1149
1181
|
<ul>
|
1150
1182
|
<li>glyphs: <a href="cairo-glyph.html">Cairo::Glyph</a>の配列。</li>
|
1151
1183
|
</ul></dd>
|
1152
|
-
<dt><a name="label-
|
1184
|
+
<dt><a name="label-109" id="label-109"><code>show_page</code></a></dt><!-- RDLabel: "show_page" -->
|
1153
1185
|
<dd>
|
1154
1186
|
現在のページを発行して消去します。これは複数ページをサポー
|
1155
1187
|
トしているバックエンドのためです。もし、現在のページを
|
1156
|
-
消去したくないのであれば<a href="cairo-context.html#label-
|
1188
|
+
消去したくないのであれば<a href="cairo-context.html#label-21">Cairo::Context#copy_page</a>を使っ
|
1157
1189
|
てください。</dd>
|
1158
|
-
<dt><a name="label-
|
1190
|
+
<dt><a name="label-110" id="label-110"><code>show_text(<var>utf8</var>)</code></a></dt><!-- RDLabel: "show_text" -->
|
1159
1191
|
<dd>
|
1160
1192
|
<p>UTF-8文字列から形を生成する描画操作です。描画には現在の
|
1161
1193
|
フォントフェイス、フォントサイズ(フォント用変換行列)、
|
@@ -1168,36 +1200,36 @@ context.move_to(x + dx, y + dy)</pre>
|
|
1168
1200
|
ときに基準にする点に移動します。つまり、現在の点は最後
|
1169
1201
|
のグリフが進めた値で相殺された最後のグリフの基準点とな
|
1170
1202
|
ります。(?FIXME)これはひとつの論理的な文字列を複数の
|
1171
|
-
<a href="cairo-context.html#label-
|
1172
|
-
<p>注: <a href="cairo-context.html#label-
|
1203
|
+
<a href="cairo-context.html#label-110">Cairo::Context#show_text</a>で簡単に表示できるようにします。</p>
|
1204
|
+
<p>注: <a href="cairo-context.html#label-110">Cairo::Context#show_text</a>はcairoの設計者がおもちゃの
|
1173
1205
|
テキストAPIと呼んでいるものの一部です。短いデモや簡単な
|
1174
1206
|
プログラムには便利ですが、真剣にテキストを使おうとして
|
1175
1207
|
いるアプリケーションには適していないでしょう。cairoの本
|
1176
|
-
当のテキスト表示APIは<a href="cairo-context.html#label-
|
1208
|
+
当のテキスト表示APIは<a href="cairo-context.html#label-108">Cairo::Context#show_glyphs</a>を見てく
|
1177
1209
|
ださい。</p>
|
1178
1210
|
<ul>
|
1179
1211
|
<li>utf8: UTF-8で符号化されたテキスト。</li>
|
1180
1212
|
</ul></dd>
|
1181
|
-
<dt><a name="label-
|
1213
|
+
<dt><a name="label-111" id="label-111"><code>source</code></a></dt><!-- RDLabel: "source" -->
|
1182
1214
|
<dd>
|
1183
1215
|
現在のソースパターンを返します。
|
1184
1216
|
<ul>
|
1185
|
-
<li
|
1217
|
+
<li>戻り値: <a href="cairo-pattern.html">Cairo::Pattern</a>オブジェクト。</li>
|
1186
1218
|
</ul></dd>
|
1187
|
-
<dt><a name="label-
|
1188
|
-
<dt><a name="label-
|
1219
|
+
<dt><a name="label-112" id="label-112"><code>stroke(<var>preserve</var>=<var>false</var>)</code></a></dt><!-- RDLabel: "stroke" -->
|
1220
|
+
<dt><a name="label-113" id="label-113"><code>stroke(<var>preserve</var>=<var>false</var>) {|<var>self</var>| ...}</code></a></dt><!-- RDLabel: "stroke" -->
|
1189
1221
|
<dd>
|
1190
1222
|
<p>現在のパスを現在の線幅、結合点、キャップ、ダッシュの設
|
1191
1223
|
定にしたがって描く描画操作です。<var>preserve</var>が偽の場
|
1192
1224
|
合は呼び出した後は現在のパスは消去されます。以下も見て
|
1193
1225
|
ください。</p>
|
1194
1226
|
<ul>
|
1195
|
-
<li><a href="cairo-context.html#label-
|
1196
|
-
<li><a href="cairo-context.html#label-
|
1197
|
-
<li><a href="cairo-context.html#label-
|
1198
|
-
<li><a href="cairo-context.html#label-
|
1227
|
+
<li><a href="cairo-context.html#label-67">Cairo::Context#set_line_width</a></li>
|
1228
|
+
<li><a href="cairo-context.html#label-63">Cairo::Context#set_line_join</a></li>
|
1229
|
+
<li><a href="cairo-context.html#label-60">Cairo::Context#set_line_cap</a></li>
|
1230
|
+
<li><a href="cairo-context.html#label-103">Cairo::Context#set_dash</a></li>
|
1199
1231
|
</ul>
|
1200
|
-
<p>ブロックを指定した場合は、<a href="cairo-context.html#label-
|
1232
|
+
<p>ブロックを指定した場合は、<a href="cairo-context.html#label-77">Cairo::Context#new_path</a>で新し
|
1201
1233
|
いパスをはじめてからブロックを呼び出します。以下のよう
|
1202
1234
|
に使います。</p>
|
1203
1235
|
<pre>context.stroke do
|
@@ -1211,16 +1243,16 @@ context.stroke</pre>
|
|
1211
1243
|
利な結果を提供します。それらはふたつの異なった状況にな
|
1212
1244
|
ります。</p>
|
1213
1245
|
<ol>
|
1214
|
-
<li><a href="cairo-context.html#label-
|
1246
|
+
<li><a href="cairo-context.html#label-103">Cairo::Context#set_dash</a>で設定された長さ0のon線分。
|
1215
1247
|
もし、キャップスタイルが<a href="cairo-line-cap.html#label-3">Cairo::LineCap::ROUND</a>か
|
1216
1248
|
<a href="cairo-line-cap.html#label-4">Cairo::LineCap::SQUARE</a>ならそれらの線分はそれぞれ
|
1217
1249
|
丸い点あるいは四角として描画されます。
|
1218
1250
|
<a href="cairo-line-cap.html#label-4">Cairo::LineCap::SQUARE</a>の場合は四角の方向はその下
|
1219
1251
|
にあるパスの方向によって決まります。</li>
|
1220
|
-
<li><a href="cairo-context.html#label-
|
1221
|
-
<a href="cairo-context.html#label-
|
1222
|
-
<a href="cairo-context.html#label-
|
1223
|
-
<a href="cairo-context.html#label-
|
1252
|
+
<li><a href="cairo-context.html#label-76">Cairo::Context#move_to</a>とその後の
|
1253
|
+
<a href="cairo-context.html#label-20">Cairo::Context#close_path</a>あるいは最初の
|
1254
|
+
<a href="cairo-context.html#label-76">Cairo::Context#move_to</a>と同じ座標に対する1回以上の
|
1255
|
+
<a href="cairo-context.html#label-64">Cairo::Context#line_to</a>で作られたサブパス。キャッ
|
1224
1256
|
プスタイルが<a href="cairo-line-cap.html#label-3">Cairo::LineCap::ROUND</a>ならサブパスは丸
|
1225
1257
|
い点として描画されるでしょう。
|
1226
1258
|
<a href="cairo-line-cap.html#label-4">Cairo::LineCap::SQUARE</a>の場合は退化したサブパスは
|
@@ -1232,9 +1264,9 @@ context.stroke</pre>
|
|
1232
1264
|
<ul>
|
1233
1265
|
<li>preserve: 真の場合はパスを消去しない</li>
|
1234
1266
|
</ul></dd>
|
1235
|
-
<dt><a name="label-
|
1267
|
+
<dt><a name="label-114" id="label-114"><code>stroke_extents</code></a></dt><!-- RDLabel: "stroke_extents" -->
|
1236
1268
|
<dd>
|
1237
|
-
<p>現在のパスと描きパラメータで<a href="cairo-context.html#label-
|
1269
|
+
<p>現在のパスと描きパラメータで<a href="cairo-context.html#label-112">Cairo::Context#stroke</a>を呼び
|
1238
1270
|
出したときに影響がある範囲を覆うユーザ空間のバウンディ
|
1239
1271
|
ングボックスを計算します。現在のパスが空なら空の四
|
1240
1272
|
角(0,0, 0,0)を返します。サーフェスの大きさと切り取り領
|
@@ -1242,13 +1274,13 @@ context.stroke</pre>
|
|
1242
1274
|
<p>以下も見てください。</p>
|
1243
1275
|
<ul>
|
1244
1276
|
<li><a href="cairo-context.html">Cairo::Context#cairo_stroke</a></li>
|
1245
|
-
<li><a href="cairo-context.html#label-
|
1246
|
-
<li><a href="cairo-context.html#label-
|
1247
|
-
<li><a href="cairo-context.html#label-
|
1248
|
-
<li><a href="cairo-context.html#label-
|
1277
|
+
<li><a href="cairo-context.html#label-67">Cairo::Context#set_line_width</a></li>
|
1278
|
+
<li><a href="cairo-context.html#label-63">Cairo::Context#set_line_join</a></li>
|
1279
|
+
<li><a href="cairo-context.html#label-60">Cairo::Context#set_line_cap</a></li>
|
1280
|
+
<li><a href="cairo-context.html#label-103">Cairo::Context#set_dash</a></li>
|
1249
1281
|
</ul>
|
1250
1282
|
<ul>
|
1251
|
-
<li
|
1283
|
+
<li>戻り値: <code>[x1, y1, x2, y2]</code>:
|
1252
1284
|
<ul>
|
1253
1285
|
<li>x1: バウンディングボックスの左</li>
|
1254
1286
|
<li>y1: バウンディングボックスの上</li>
|
@@ -1256,28 +1288,28 @@ context.stroke</pre>
|
|
1256
1288
|
<li>y2: バウンディングボックスの下</li>
|
1257
1289
|
</ul></li>
|
1258
1290
|
</ul></dd>
|
1259
|
-
<dt><a name="label-
|
1260
|
-
<dt><a name="label-
|
1291
|
+
<dt><a name="label-115" id="label-115"><code>stroke_preserve</code></a></dt><!-- RDLabel: "stroke_preserve" -->
|
1292
|
+
<dt><a name="label-116" id="label-116"><code>stroke_preserve {|<var>self</var>| ...}</code></a></dt><!-- RDLabel: "stroke_preserve" -->
|
1261
1293
|
<dd>
|
1262
|
-
<p><a href="cairo-context.html#label-
|
1294
|
+
<p><a href="cairo-context.html#label-112">Cairo::Context#stroke</a>を以下のように呼び出すことと同じです。</p>
|
1263
1295
|
<pre>context.stroke(true)
|
1264
1296
|
context.stroke(true) { ... }</pre></dd>
|
1265
|
-
<dt><a name="label-
|
1297
|
+
<dt><a name="label-117" id="label-117"><code>target</code></a></dt><!-- RDLabel: "target" -->
|
1266
1298
|
<dd>
|
1267
1299
|
<a href="cairo-context.html#label-4">Cairo::Context.new</a>に渡されたコンテキストの対象とするサー
|
1268
1300
|
フェスを返します。
|
1269
1301
|
<ul>
|
1270
|
-
<li
|
1302
|
+
<li>戻り値: 対象のサーフェス。<a href="cairo-surface.html">Cairo::Surface</a>のサブクラス
|
1271
1303
|
のオブジェクト。</li>
|
1272
1304
|
</ul></dd>
|
1273
|
-
<dt><a name="label-
|
1305
|
+
<dt><a name="label-118" id="label-118"><code>text_extents(<var>utf8</var>)</code></a></dt><!-- RDLabel: "text_extents" -->
|
1274
1306
|
<dd>
|
1275
1307
|
<p>テキストの範囲を返します。範囲はテキストをインクで塗る
|
1276
1308
|
部分(テキストが描画される部分)を囲む(ユーザ空間での)
|
1277
1309
|
示しています。さらに、範囲(<a href="cairo-text-extents.html">Cairo::TextExtents</a>)の
|
1278
1310
|
<var>x_advance</var>と<var>y_advance</var>の値は
|
1279
|
-
<a href="cairo-context.html#label-
|
1280
|
-
ています。(<a href="cairo-context.html#label-
|
1311
|
+
<a href="cairo-context.html#label-108">Cairo::Context#show_glyphs</a>が進める現在の点の合計を示し
|
1312
|
+
ています。(<a href="cairo-context.html#label-110">Cairo::Context#show_text</a>はテキストを描画す
|
1281
1313
|
ると、描画した分だけ現在の点を進めます。)</p>
|
1282
1314
|
<p>空白文字は四角のサイズ(extents.widthとextents.height)
|
1283
1315
|
に貢献しないことに注意してください。空白文字は非空白文
|
@@ -1287,40 +1319,40 @@ context.stroke(true) { ... }</pre></dd>
|
|
1287
1319
|
響を与えます。</p>
|
1288
1320
|
<ul>
|
1289
1321
|
<li>utf8: UTF-8で符号化されたテキスト。</li>
|
1290
|
-
<li
|
1322
|
+
<li>戻り値: テキストの範囲を示す<a href="cairo-text-extents.html">Cairo::TextExtents</a>オブジェ
|
1291
1323
|
クト。</li>
|
1292
1324
|
</ul></dd>
|
1293
|
-
<dt><a name="label-
|
1325
|
+
<dt><a name="label-119" id="label-119"><code>text_path(<var>utf8</var>)</code></a></dt><!-- RDLabel: "text_path" -->
|
1294
1326
|
<dd>
|
1295
1327
|
<p>テキストの閉じたパスを現在のパスに追加します。生成され
|
1296
|
-
たを塗りつぶすと<a href="cairo-context.html#label-
|
1328
|
+
たを塗りつぶすと<a href="cairo-context.html#label-110">Cairo::Context#show_text</a>と同じような効
|
1297
1329
|
果が得られます。</p>
|
1298
|
-
<p>テキストの変換と配置は<a href="cairo-context.html#label-
|
1330
|
+
<p>テキストの変換と配置は<a href="cairo-context.html#label-110">Cairo::Context#show_text</a>と同じよ
|
1299
1331
|
うに行われます。</p>
|
1300
|
-
<p><a href="cairo-context.html#label-
|
1332
|
+
<p><a href="cairo-context.html#label-110">Cairo::Context#show_text</a>のように、呼び出した後、現在の点
|
1301
1333
|
は同じように次のグリフを配置したときに基準にする点に移
|
1302
1334
|
動します。つまり、現在の点は最後のグリフが進めた値で相殺
|
1303
1335
|
された最後のグリフの基準点となります。(?FIXME)このた
|
1304
1336
|
め、現在の点を設定しないで複数の
|
1305
|
-
<a href="cairo-context.html#label-
|
1337
|
+
<a href="cairo-context.html#label-119">Cairo::Context#text_path</a>を連続で呼び出せるようになりま
|
1306
1338
|
す。</p>
|
1307
|
-
<p>注: <a href="cairo-context.html#label-
|
1339
|
+
<p>注: <a href="cairo-context.html#label-119">Cairo::Context#text_path</a>はcairoの設計者がおもちゃの
|
1308
1340
|
テキストAPIと呼んでいるものの一部です。短いデモや簡単な
|
1309
1341
|
プログラムには便利ですが、真剣にテキストを使おうとして
|
1310
1342
|
いるアプリケーションには適していないでしょう。cairoの本
|
1311
|
-
当のテキスト表示APIは<a href="cairo-context.html#label-
|
1343
|
+
当のテキスト表示APIは<a href="cairo-context.html#label-51">Cairo::Context#glyph_path</a>を見てく
|
1312
1344
|
ださい。</p>
|
1313
1345
|
<ul>
|
1314
1346
|
<li>utf8: UTF-8で符号化れたテキスト。</li>
|
1315
1347
|
</ul></dd>
|
1316
|
-
<dt><a name="label-
|
1348
|
+
<dt><a name="label-120" id="label-120"><code>tolerance</code></a></dt><!-- RDLabel: "tolerance" -->
|
1317
1349
|
<dd>
|
1318
|
-
<a href="cairo-context.html#label-
|
1350
|
+
<a href="cairo-context.html#label-122">Cairo::Context#set_tolerance</a>で設定した現在の許容値を返します。
|
1319
1351
|
<ul>
|
1320
|
-
<li
|
1352
|
+
<li>戻り値: 現在の許容値。</li>
|
1321
1353
|
</ul></dd>
|
1322
|
-
<dt><a name="label-
|
1323
|
-
<dt><a name="label-
|
1354
|
+
<dt><a name="label-121" id="label-121"><code>tolerance=(<var>tolerance</var>)</code></a></dt><!-- RDLabel: "tolerance=" -->
|
1355
|
+
<dt><a name="label-122" id="label-122"><code>set_tolerance(<var>tolerance</var>)</code></a></dt><!-- RDLabel: "set_tolerance" -->
|
1324
1356
|
<dd>
|
1325
1357
|
パスを台形に変換するときに使う許容値を設定します。パス
|
1326
1358
|
の円弧の部分は、元のパスとポリゴン近似の最大偏差が
|
@@ -1332,19 +1364,19 @@ context.stroke(true) { ... }</pre></dd>
|
|
1332
1364
|
<ul>
|
1333
1365
|
<li>tolerance: 装置単位(普通はピクセル)での許容値。</li>
|
1334
1366
|
</ul></dd>
|
1335
|
-
<dt><a name="label-
|
1367
|
+
<dt><a name="label-123" id="label-123"><code>transform(<var>matrix</var>)</code></a></dt><!-- RDLabel: "transform" -->
|
1336
1368
|
<dd>
|
1337
1369
|
追加の変換として<var>matrix</var>を適用して現在の変換行列
|
1338
1370
|
(CTM)を変更します。ユーザ空間の新しい変換はすべての既
|
1339
1371
|
存の変換の後に行われます。</dd>
|
1340
|
-
<dt><a name="label-
|
1372
|
+
<dt><a name="label-124" id="label-124"><code>transform_path(<var>path</var>) {|<var>x</var>, <var>y</var>| ...}</code></a></dt><!-- RDLabel: "transform_path" -->
|
1341
1373
|
<dd>
|
1342
1374
|
<a href="cairo-context-path.html#label-3">Cairo::Context::Path#transform_path</a>を見てください。</dd>
|
1343
|
-
<dt><a name="label-
|
1375
|
+
<dt><a name="label-125" id="label-125"><code>translate(<var>tx</var>, <var>ty</var>)</code></a></dt><!-- RDLabel: "translate" -->
|
1344
1376
|
<dd>
|
1345
1377
|
ユーザ空間の基準点を(<var>tx</var>, <var>ty</var>)に動かすことに
|
1346
1378
|
より現在の変換行列(CTM)を変更します。この補正値
|
1347
|
-
((<var>tx</var>, <var>ty</var>))は<a href="cairo-context.html#label-
|
1379
|
+
((<var>tx</var>, <var>ty</var>))は<a href="cairo-context.html#label-125">Cairo::Context#translate</a>を適
|
1348
1380
|
用する前のCTMにしたがってユーザ空間座標として解釈されま
|
1349
1381
|
す。言い替えると、ユーザ空間の基準点の移動はすべての既
|
1350
1382
|
存の変換の後に行われます。
|
@@ -1352,7 +1384,7 @@ context.stroke(true) { ... }</pre></dd>
|
|
1352
1384
|
<li>tx: X方向への移動量</li>
|
1353
1385
|
<li>ty: Y方向への移動量</li>
|
1354
1386
|
</ul></dd>
|
1355
|
-
<dt><a name="label-
|
1387
|
+
<dt><a name="label-126" id="label-126"><code>user_to_device(<var>x</var>, <var>y</var>)</code></a></dt><!-- RDLabel: "user_to_device" -->
|
1356
1388
|
<dd>
|
1357
1389
|
ユーザ空間から装置空間へ座標を変換します。変換は与え
|
1358
1390
|
られた点に現在の変換行列(CTM)を乗じることによって行わ
|
@@ -1360,79 +1392,140 @@ context.stroke(true) { ... }</pre></dd>
|
|
1360
1392
|
<ul>
|
1361
1393
|
<li>x: ユーザ空間座標のX値</li>
|
1362
1394
|
<li>y: ユーザ空間座標のY値</li>
|
1363
|
-
<li
|
1395
|
+
<li>戻り値: <code>[dx, dy]</code>
|
1364
1396
|
<ul>
|
1365
1397
|
<li>dx: 装置空間座標のX値</li>
|
1366
1398
|
<li>dy: 装置空間座標のY値</li>
|
1367
1399
|
</ul></li>
|
1368
1400
|
</ul></dd>
|
1369
|
-
<dt><a name="label-
|
1401
|
+
<dt><a name="label-127" id="label-127"><code>user_to_device_distance(<var>dx</var>, <var>dy</var>)</code></a></dt><!-- RDLabel: "user_to_device_distance" -->
|
1370
1402
|
<dd>
|
1371
1403
|
ユーザ空間から装置空間へ距離ベクトルを変換します。
|
1372
|
-
<a href="cairo-context.html#label-
|
1404
|
+
<a href="cairo-context.html#label-126">Cairo::Context#user_to_device</a>に似ていますが、(<var>dx</var>,
|
1373
1405
|
<var>dy</var>)を変換するときにCTMの移動成分は無視されます。
|
1374
1406
|
<ul>
|
1375
1407
|
<li>dx: ユーザ空間の距離ベクトルのX値</li>
|
1376
1408
|
<li>dy: ユーザ空間の距離ベクトルのY値</li>
|
1377
|
-
<li
|
1409
|
+
<li>戻り値: <code>[ddx, ddy]</code>
|
1378
1410
|
<ul>
|
1379
1411
|
<li>ddx: 装置空間の距離ベクトルのX値</li>
|
1380
1412
|
<li>ddy: 装置空間の距離ベクトルのY値</li>
|
1381
1413
|
</ul></li>
|
1382
1414
|
</ul></dd>
|
1383
|
-
<dt><a name="label-
|
1415
|
+
<dt><a name="label-128" id="label-128"><code>map_path_onto(<var>path</var>)</code></a></dt><!-- RDLabel: "map_path_onto" -->
|
1384
1416
|
<dd>
|
1385
1417
|
<a href="cairo-context-path.html#label-2">Cairo::Context::Path#map_path_onto</a>を見てください。</dd>
|
1386
|
-
<dt><a name="label-
|
1418
|
+
<dt><a name="label-129" id="label-129"><code>pseudo_blur(<var>radius</var>=<var>3</var>) {|<var>self</var>| ...}</code></a></dt><!-- RDLabel: "pseudo_blur" -->
|
1387
1419
|
<dd>
|
1388
1420
|
<a href="cairo-context-blur.html#label-2">Cairo::Context::Blur#pseudo_blur</a>を見てください。</dd>
|
1389
|
-
<dt><a name="label-
|
1421
|
+
<dt><a name="label-130" id="label-130"><code>triangle(<var>x1</var>, <var>y1</var>, <var>x2</var>, <var>y2</var>, <var>x3</var>, <var>y3</var>)</code></a></dt><!-- RDLabel: "triangle" -->
|
1390
1422
|
<dd>
|
1391
1423
|
<a href="cairo-context-triangle.html#label-2">Cairo::Context::Triangle#triangle</a>を見てください。</dd>
|
1392
|
-
<dt><a name="label-
|
1393
|
-
<dt><a name="label-
|
1424
|
+
<dt><a name="label-131" id="label-131"><code>has_current_point?</code></a></dt><!-- RDLabel: "has_current_point?" -->
|
1425
|
+
<dt><a name="label-132" id="label-132"><code>have_current_point?</code></a></dt><!-- RDLabel: "have_current_point?" -->
|
1394
1426
|
<dd>
|
1395
1427
|
<em>Since 1.6</em>: 現在のパス上に現在の点が定義されている
|
1396
1428
|
かを返します。「現在の点」の詳細は
|
1397
|
-
<a href="cairo-context.html#label-
|
1429
|
+
<a href="cairo-context.html#label-24">Cairo::Context#current_point</a>を見てください。
|
1398
1430
|
<ul>
|
1399
|
-
<li
|
1431
|
+
<li>戻り値: 現在の点が定義されているかどうかの真偽値</li>
|
1400
1432
|
</ul></dd>
|
1401
|
-
<dt><a name="label-
|
1433
|
+
<dt><a name="label-133" id="label-133"><code>path_extents</code></a></dt><!-- RDLabel: "path_extents" -->
|
1402
1434
|
<dd>
|
1403
1435
|
<p><em>Since 1.6</em>: 現在のパス上の点を服務ユーザ空間座標の
|
1404
1436
|
バウンディングボックスを計算します。もし、現在のパスが空
|
1405
1437
|
であれば空の長方形((0,0), (0,0))を返します。ストロー
|
1406
1438
|
クのパラメータ、塗りつぶし規則、サーフェスの大きさ、ク
|
1407
1439
|
リップされた範囲は考慮しません。</p>
|
1408
|
-
<p><a href="cairo-context.html#label-
|
1409
|
-
<a href="cairo-context.html#label-
|
1440
|
+
<p><a href="cairo-context.html#label-32">Cairo::Context#fill_extents</a>と
|
1441
|
+
<a href="cairo-context.html#label-114">Cairo::Context#stroke_extents</a>は、対応
|
1410
1442
|
する描画操作で「インクが塗られる」範囲だけを返します。</p>
|
1411
|
-
<p><a href="cairo-context.html#label-
|
1412
|
-
線の太さがほぼ0.0で、<a href="cairo.html#label-
|
1413
|
-
<a href="cairo-context.html#label-
|
1443
|
+
<p><a href="cairo-context.html#label-133">Cairo::Context#path_extents</a>の結果は
|
1444
|
+
線の太さがほぼ0.0で、<a href="cairo.html#label-46">Cairo::LINE_CAP_ROUND</a>の時の
|
1445
|
+
<a href="cairo-context.html#label-114">Cairo::Context#stroke_extents</a>の境界と等しくなるように定
|
1414
1446
|
義されています。(ただし、線の太さが0.0の時に
|
1415
|
-
<a href="cairo-context.html#label-
|
1447
|
+
<a href="cairo-context.html#label-114">Cairo::Context#stroke_extents</a>が返す空の長方形には決して
|
1416
1448
|
なりません。)</p>
|
1417
1449
|
<p>厳密に言うと、以下のような領域のないサブパスは結果の範
|
1418
1450
|
囲に影響します。(以下の両方のメソッド呼び出しの座標が
|
1419
1451
|
同じ場合も含む)</p>
|
1420
1452
|
<pre>context.move_to(...)
|
1421
1453
|
context.line_to(...)</pre>
|
1422
|
-
<p>しかし、<a href="cairo-context.html#label-
|
1423
|
-
<a href="cairo-context.html#label-
|
1454
|
+
<p>しかし、<a href="cairo-context.html#label-76">Cairo::Context#move_to</a>だけの場合は
|
1455
|
+
<a href="cairo-context.html#label-133">Cairo::Context#path_extents</a>の結果には影響がありません。</p>
|
1424
1456
|
<ul>
|
1425
|
-
<li
|
1457
|
+
<li>戻り値: パスを含むバウンディングボックス。左上の頂点
|
1426
1458
|
が(x1, y1)で右下の頂点が(x2, y2)の長方形を表す配列:
|
1427
1459
|
[x1, y1, x2, y2]</li>
|
1428
1460
|
</ul></dd>
|
1461
|
+
<dt><a name="label-134" id="label-134"><code>destroy</code></a></dt><!-- RDLabel: "destroy" -->
|
1462
|
+
<dd>
|
1463
|
+
<p><em>Since 1.7</em>: <a href="cairo-context.html">Cairo::Context</a>を破棄します。この
|
1464
|
+
<a href="cairo-context.html">Cairo::Context</a>はもう使えません。</p>
|
1465
|
+
<p>通常はRubyのGC時に破棄されるので、このメソッドを意識す
|
1466
|
+
る必要はありません。Quartzバックエンドを使っているGTK+
|
1467
|
+
のGtk::Drawable#create_cairo_contextを使っている場合な
|
1468
|
+
ど、<a href="cairo-context.html">Cairo::Context</a>またはこの<a href="cairo-context.html">Cairo::Context</a>が対象として
|
1469
|
+
いる<a href="cairo-surface.html">Cairo::Surface</a>を明示的に破棄したい場合に利用します。</p>
|
1470
|
+
<p><a href="cairo-context.html#label-4">Cairo::Context.new</a>をブロック付きで呼ぶことも検討してみ
|
1471
|
+
てください。</p></dd>
|
1472
|
+
<dt><a name="label-135" id="label-135"><code>has_show_text_glyphs?</code></a></dt><!-- RDLabel: "has_show_text_glyphs?" -->
|
1473
|
+
<dt><a name="label-136" id="label-136"><code>have_show_text_glyphs?</code></a></dt><!-- RDLabel: "have_show_text_glyphs?" -->
|
1474
|
+
<dd>
|
1475
|
+
<p><em>Since 1.7</em>: 対象のサーフェスが
|
1476
|
+
<a href="cairo-context.html#label-137">Cairo::Context#show_text_glyphs</a>をサポートしているかどう
|
1477
|
+
かを返します。つまり、<a href="cairo-context.html#label-137">Cairo::Context#show_text_glyphs</a>が
|
1478
|
+
指定したテキストとクラスタデータを実際に使うかどうかで
|
1479
|
+
す。</p>
|
1480
|
+
<p>注: もし、このメソッドが<code>false</code>を返しても、
|
1481
|
+
<a href="cairo-context.html#label-137">Cairo::Context#show_text_glyphs</a>は成功します。単に
|
1482
|
+
<a href="cairo-context.html#label-108">Cairo::Context#show_glyphs</a>と同じように動きます。このメ
|
1483
|
+
ソッドは対象のサーフェスが
|
1484
|
+
<a href="cairo-context.html#label-137">Cairo::Context#show_text_glyphs</a>をサポートしていない場合
|
1485
|
+
にUTF-8のテキストとクラスタの対応を計算するコストを避け
|
1486
|
+
るために利用できます。</p>
|
1487
|
+
<ul>
|
1488
|
+
<li>戻り値: 対象のサーフェスが
|
1489
|
+
<a href="cairo-context.html#label-137">Cairo::Context#show_text_glyphs</a>をサポートしている場合
|
1490
|
+
は<code>true</code>。そうでない場合は<code>false</code>。</li>
|
1491
|
+
</ul></dd>
|
1492
|
+
<dt><a name="label-137" id="label-137"><code>show_text_glyphs(<var>utf8</var>, <var>glyphs</var>, <var>clusters</var>, <var>backward</var>)</code></a></dt><!-- RDLabel: "show_text_glyphs" -->
|
1493
|
+
<dd>
|
1494
|
+
<p><em>Since 1.7</em>: <a href="cairo-context.html#label-108">Cairo::Context#show_glyphs</a>のような表示
|
1495
|
+
効果があります。もし、対象のサーフェスが対応していれば、
|
1496
|
+
出力に表示するグリフのために、指定されたテキストと埋め
|
1497
|
+
込まれたテキストへのクラスタ対応を使います。</p>
|
1498
|
+
<p><var>utf8</var>と<var>glyphs</var>の対応は<var>clusters</var>で指定し
|
1499
|
+
ます。各クラスタはたくさんのテキスト(バイト)とグリフ
|
1500
|
+
を含みます。隣接しているクラスタは<var>utf8</var>と
|
1501
|
+
<var>glyphs</var>隣接している範囲を含みます。すべてのクラス
|
1502
|
+
タを集めるとすべての<var>utf8</var>と<var>glyphs</var>を含むべき
|
1503
|
+
です。</p>
|
1504
|
+
<p>最初のクラスタは常に<var>utf8</var>の最初のバイトを含みます。
|
1505
|
+
もし、<var>backward</var>が<code>false</code>なら、最初のクラスタは
|
1506
|
+
最初の<var>glyphs</var>も含みます。<code>true</code>の場合は
|
1507
|
+
<var>glyphs</var>の最後を含み、続くクラスタは後ろ向きに進み
|
1508
|
+
ます。</p>
|
1509
|
+
<p>妥当なクラスタのための制約は<a href="cairo-text-cluster.html">Cairo::TextCluster</a>を見てく
|
1510
|
+
ださい。</p>
|
1511
|
+
<ul>
|
1512
|
+
<li>utf8: UTF-8で符号化されたString</li>
|
1513
|
+
<li>glyphs: 表示する<a href="cairo-glyph.html">Cairo::Glyph</a>の配列</li>
|
1514
|
+
<li>clusters: クラスタ対応情報(<a href="cairo-text-cluster.html">Cairo::TextCluster</a>)の配
|
1515
|
+
列</li>
|
1516
|
+
<li>backward: テキストからグリフへの対応が後ろ方向かどう
|
1517
|
+
か</li>
|
1518
|
+
</ul></dd>
|
1429
1519
|
</dl>
|
1430
|
-
<h2><a name="label-
|
1520
|
+
<h2><a name="label-138" id="label-138">参考</a></h2><!-- RDLabel: "参考" -->
|
1431
1521
|
<ul>
|
1432
1522
|
<li><a href="index.html#label-0">索引</a></li>
|
1523
|
+
<li><a href="cairo-surface.html">Cairo::Surface</a></li>
|
1524
|
+
<li><a href="cairo-text-cluster.html">Cairo::TextCluster</a></li>
|
1433
1525
|
</ul>
|
1434
|
-
<h2><a name="label-
|
1526
|
+
<h2><a name="label-139" id="label-139">変更履歴</a></h2><!-- RDLabel: "変更履歴" -->
|
1435
1527
|
<ul>
|
1528
|
+
<li>2008-08-16: kou: 1.7.4対応。</li>
|
1436
1529
|
<li>2008-04-11: kou: 1.6.0対応。</li>
|
1437
1530
|
<li>2007-05-20: kou: 定数の扱いについて更新。</li>
|
1438
1531
|
<li>2007-05-19: kou: 初期バージョン完成。</li>
|