cairo 1.6.1-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/AUTHORS +4 -0
- data/COPYING +59 -0
- data/ChangeLog +1320 -0
- data/GPL +340 -0
- data/NEWS +98 -0
- data/README +70 -0
- data/Rakefile +215 -0
- data/cairo/bin/libcairo-2.dll +0 -0
- data/cairo/bin/libpng13.dll +0 -0
- data/cairo/bin/zlib1.dll +0 -0
- data/cairo/include/cairo/cairo-deprecated.h +142 -0
- data/cairo/include/cairo/cairo-features.h +35 -0
- data/cairo/include/cairo/cairo-pdf.h +68 -0
- data/cairo/include/cairo/cairo-ps.h +114 -0
- data/cairo/include/cairo/cairo-svg.h +82 -0
- data/cairo/include/cairo/cairo-win32.h +104 -0
- data/cairo/include/cairo/cairo.h +1945 -0
- data/cairo/include/libpng13/png.h +3419 -0
- data/cairo/include/libpng13/pngconf.h +1437 -0
- data/cairo/lib/cairo.def +251 -0
- data/cairo/lib/cairo.lib +0 -0
- data/cairo/lib/libcairo.dll.a +0 -0
- data/cairo/lib/libpng.def +372 -0
- data/cairo/lib/libpng13.dll.a +0 -0
- data/cairo/lib/pkgconfig/cairo-pdf.pc +12 -0
- data/cairo/lib/pkgconfig/cairo-png.pc +12 -0
- data/cairo/lib/pkgconfig/cairo-ps.pc +12 -0
- data/cairo/lib/pkgconfig/cairo-svg.pc +12 -0
- data/cairo/lib/pkgconfig/cairo-win32-font.pc +12 -0
- data/cairo/lib/pkgconfig/cairo-win32.pc +12 -0
- data/cairo/lib/pkgconfig/cairo.pc +13 -0
- data/cairo/lib/pkgconfig/libpng.pc +14 -0
- data/cairo/lib/pkgconfig/libpng13.pc +14 -0
- data/cairo/make/cairo-1.6.4-1.sh +55 -0
- data/cairo/manifest/cairo-1.6.4-1.mft +6 -0
- data/cairo/manifest/cairo-dev-1.6.4-1.mft +72 -0
- data/cairo/manifest/libpng-dev-1.2.8.mft +7 -0
- data/cairo/share/doc/cairo-1.6.4-1/COPYING +32 -0
- data/cairo/share/doc/cairo-1.6.4-1/COPYING-LGPL-2.1 +510 -0
- data/cairo/share/doc/cairo-1.6.4-1/COPYING-MPL-1.1 +470 -0
- data/cairo/share/gtk-doc/html/cairo/Drawing.html +53 -0
- data/cairo/share/gtk-doc/html/cairo/Fonts.html +56 -0
- data/cairo/share/gtk-doc/html/cairo/Support.html +50 -0
- data/cairo/share/gtk-doc/html/cairo/Surfaces.html +65 -0
- data/cairo/share/gtk-doc/html/cairo/bindings-errors.html +128 -0
- data/cairo/share/gtk-doc/html/cairo/bindings-fonts.html +59 -0
- data/cairo/share/gtk-doc/html/cairo/bindings-memory.html +129 -0
- data/cairo/share/gtk-doc/html/cairo/bindings-overloading.html +127 -0
- data/cairo/share/gtk-doc/html/cairo/bindings-path.html +123 -0
- data/cairo/share/gtk-doc/html/cairo/bindings-patterns.html +63 -0
- data/cairo/share/gtk-doc/html/cairo/bindings-return-values.html +126 -0
- data/cairo/share/gtk-doc/html/cairo/bindings-streams.html +98 -0
- data/cairo/share/gtk-doc/html/cairo/bindings-surfaces.html +99 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-Error-Handling.html +328 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-Font-Options.html +720 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-FreeType-Fonts.html +297 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-Image-Surfaces.html +484 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-PDF-Surfaces.html +246 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-PNG-Support.html +345 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-Paths.html +1336 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-Patterns.html +1560 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-PostScript-Surfaces.html +656 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-Quartz-Fonts.html +161 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-Quartz-Surfaces.html +232 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-SVG-Surfaces.html +337 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-Scaled-Fonts.html +823 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-Text.html +836 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-Transformations.html +462 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-Types.html +143 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-Version-Information.html +325 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-Win32-Fonts.html +381 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-Win32-Surfaces.html +331 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-XLib-Surfaces.html +525 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-cairo-font-face-t.html +427 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-cairo-matrix-t.html +626 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-cairo-surface-t.html +995 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-cairo-t.html +2795 -0
- data/cairo/share/gtk-doc/html/cairo/cairo.devhelp +432 -0
- data/cairo/share/gtk-doc/html/cairo/cairo.devhelp2 +432 -0
- data/cairo/share/gtk-doc/html/cairo/home.png +0 -0
- data/cairo/share/gtk-doc/html/cairo/index-1.2.html +137 -0
- data/cairo/share/gtk-doc/html/cairo/index-1.4.html +105 -0
- data/cairo/share/gtk-doc/html/cairo/index-1.6.html +65 -0
- data/cairo/share/gtk-doc/html/cairo/index.html +134 -0
- data/cairo/share/gtk-doc/html/cairo/index.sgml +466 -0
- data/cairo/share/gtk-doc/html/cairo/ix01.html +693 -0
- data/cairo/share/gtk-doc/html/cairo/language-bindings.html +79 -0
- data/cairo/share/gtk-doc/html/cairo/left.png +0 -0
- data/cairo/share/gtk-doc/html/cairo/right.png +0 -0
- data/cairo/share/gtk-doc/html/cairo/style.css +148 -0
- data/cairo/share/gtk-doc/html/cairo/up.png +0 -0
- data/doc/doc.css +91 -0
- data/doc/en/cairo-antialias.html +41 -0
- data/doc/en/cairo-antialias.rd +16 -0
- data/doc/en/cairo-clip-not-representable-error.html +50 -0
- data/doc/en/cairo-clip-not-representable-error.rd +17 -0
- data/doc/en/cairo-color-base.html +72 -0
- data/doc/en/cairo-color-base.rd +38 -0
- data/doc/en/cairo-color-cmyk.html +160 -0
- data/doc/en/cairo-color-cmyk.rd +107 -0
- data/doc/en/cairo-color-hsv.html +140 -0
- data/doc/en/cairo-color-hsv.rd +91 -0
- data/doc/en/cairo-color-rgb.html +145 -0
- data/doc/en/cairo-color-rgb.rd +95 -0
- data/doc/en/cairo-color-x11.html +176 -0
- data/doc/en/cairo-color-x11.rd +151 -0
- data/doc/en/cairo-color.html +241 -0
- data/doc/en/cairo-color.rd +213 -0
- data/doc/en/cairo-content.html +40 -0
- data/doc/en/cairo-content.rd +15 -0
- data/doc/en/cairo-context-blur.html +42 -0
- data/doc/en/cairo-context-blur.rd +15 -0
- data/doc/en/cairo-context-circle.html +42 -0
- data/doc/en/cairo-context-circle.rd +15 -0
- data/doc/en/cairo-context-color.html +42 -0
- data/doc/en/cairo-context-color.rd +15 -0
- data/doc/en/cairo-context-path.html +47 -0
- data/doc/en/cairo-context-path.rd +19 -0
- data/doc/en/cairo-context-rectangle.html +42 -0
- data/doc/en/cairo-context-rectangle.rd +15 -0
- data/doc/en/cairo-context-triangle.html +42 -0
- data/doc/en/cairo-context-triangle.rd +15 -0
- data/doc/en/cairo-context.html +636 -0
- data/doc/en/cairo-context.rd +491 -0
- data/doc/en/cairo-error.html +47 -0
- data/doc/en/cairo-error.rd +16 -0
- data/doc/en/cairo-extend.html +41 -0
- data/doc/en/cairo-extend.rd +16 -0
- data/doc/en/cairo-file-not-found.html +50 -0
- data/doc/en/cairo-file-not-found.rd +17 -0
- data/doc/en/cairo-fill-rule.html +39 -0
- data/doc/en/cairo-fill-rule.rd +14 -0
- data/doc/en/cairo-filter.html +43 -0
- data/doc/en/cairo-filter.rd +18 -0
- data/doc/en/cairo-font-extents.html +74 -0
- data/doc/en/cairo-font-extents.rd +40 -0
- data/doc/en/cairo-font-face.html +41 -0
- data/doc/en/cairo-font-face.rd +14 -0
- data/doc/en/cairo-font-options.html +142 -0
- data/doc/en/cairo-font-options.rd +94 -0
- data/doc/en/cairo-font-slant.html +40 -0
- data/doc/en/cairo-font-slant.rd +15 -0
- data/doc/en/cairo-font-weight.html +39 -0
- data/doc/en/cairo-font-weight.rd +14 -0
- data/doc/en/cairo-format.html +49 -0
- data/doc/en/cairo-format.rd +22 -0
- data/doc/en/cairo-glyph.html +102 -0
- data/doc/en/cairo-glyph.rd +62 -0
- data/doc/en/cairo-gradient-pattern.html +77 -0
- data/doc/en/cairo-gradient-pattern.rd +41 -0
- data/doc/en/cairo-hint-metrics.html +40 -0
- data/doc/en/cairo-hint-metrics.rd +15 -0
- data/doc/en/cairo-hint-style.html +42 -0
- data/doc/en/cairo-hint-style.rd +17 -0
- data/doc/en/cairo-image-surface.html +85 -0
- data/doc/en/cairo-image-surface.rd +47 -0
- data/doc/en/cairo-invalid-content-error.html +50 -0
- data/doc/en/cairo-invalid-content-error.rd +17 -0
- data/doc/en/cairo-invalid-dash-error.html +50 -0
- data/doc/en/cairo-invalid-dash-error.rd +17 -0
- data/doc/en/cairo-invalid-dsc-comment-error.html +50 -0
- data/doc/en/cairo-invalid-dsc-comment-error.rd +17 -0
- data/doc/en/cairo-invalid-format-error.html +50 -0
- data/doc/en/cairo-invalid-format-error.rd +17 -0
- data/doc/en/cairo-invalid-index-error.html +50 -0
- data/doc/en/cairo-invalid-index-error.rd +17 -0
- data/doc/en/cairo-invalid-matrix-error.html +50 -0
- data/doc/en/cairo-invalid-matrix-error.rd +17 -0
- data/doc/en/cairo-invalid-path-data-error.html +50 -0
- data/doc/en/cairo-invalid-path-data-error.rd +17 -0
- data/doc/en/cairo-invalid-pop-group-error.html +50 -0
- data/doc/en/cairo-invalid-pop-group-error.rd +17 -0
- data/doc/en/cairo-invalid-restore-error.html +50 -0
- data/doc/en/cairo-invalid-restore-error.rd +17 -0
- data/doc/en/cairo-invalid-status-error.html +50 -0
- data/doc/en/cairo-invalid-status-error.rd +17 -0
- data/doc/en/cairo-invalid-stride-error.html +50 -0
- data/doc/en/cairo-invalid-stride-error.rd +17 -0
- data/doc/en/cairo-invalid-string-error.html +50 -0
- data/doc/en/cairo-invalid-string-error.rd +17 -0
- data/doc/en/cairo-invalid-visual-error.html +50 -0
- data/doc/en/cairo-invalid-visual-error.rd +17 -0
- data/doc/en/cairo-line-cap.html +40 -0
- data/doc/en/cairo-line-cap.rd +15 -0
- data/doc/en/cairo-line-join.html +40 -0
- data/doc/en/cairo-line-join.rd +15 -0
- data/doc/en/cairo-linear-pattern.html +63 -0
- data/doc/en/cairo-linear-pattern.rd +28 -0
- data/doc/en/cairo-matrix.html +257 -0
- data/doc/en/cairo-matrix.rd +186 -0
- data/doc/en/cairo-no-current-point-error.html +50 -0
- data/doc/en/cairo-no-current-point-error.rd +17 -0
- data/doc/en/cairo-null-pointer-error.html +50 -0
- data/doc/en/cairo-null-pointer-error.rd +17 -0
- data/doc/en/cairo-operator.html +51 -0
- data/doc/en/cairo-operator.rd +26 -0
- data/doc/en/cairo-paper-parse-error.html +50 -0
- data/doc/en/cairo-paper-parse-error.rd +17 -0
- data/doc/en/cairo-paper-unknown-paper-name.html +69 -0
- data/doc/en/cairo-paper-unknown-paper-name.rd +30 -0
- data/doc/en/cairo-paper-unknown-unit.html +69 -0
- data/doc/en/cairo-paper-unknown-unit.rd +30 -0
- data/doc/en/cairo-paper-unrecognized-paper-description.html +69 -0
- data/doc/en/cairo-paper-unrecognized-paper-description.rd +30 -0
- data/doc/en/cairo-paper.html +187 -0
- data/doc/en/cairo-paper.rd +141 -0
- data/doc/en/cairo-path-close-path.html +52 -0
- data/doc/en/cairo-path-close-path.rd +21 -0
- data/doc/en/cairo-path-curve-to.html +52 -0
- data/doc/en/cairo-path-curve-to.rd +21 -0
- data/doc/en/cairo-path-data-type.html +41 -0
- data/doc/en/cairo-path-data-type.rd +16 -0
- data/doc/en/cairo-path-data.html +101 -0
- data/doc/en/cairo-path-data.rd +62 -0
- data/doc/en/cairo-path-line-to.html +52 -0
- data/doc/en/cairo-path-line-to.rd +21 -0
- data/doc/en/cairo-path-move-to.html +52 -0
- data/doc/en/cairo-path-move-to.rd +21 -0
- data/doc/en/cairo-path.html +158 -0
- data/doc/en/cairo-path.rd +109 -0
- data/doc/en/cairo-pattern-type-mismatch-error.html +50 -0
- data/doc/en/cairo-pattern-type-mismatch-error.rd +17 -0
- data/doc/en/cairo-pattern.html +102 -0
- data/doc/en/cairo-pattern.rd +62 -0
- data/doc/en/cairo-pdf-surface.html +60 -0
- data/doc/en/cairo-pdf-surface.rd +27 -0
- data/doc/en/cairo-point.html +77 -0
- data/doc/en/cairo-point.rd +42 -0
- data/doc/en/cairo-ps-level.html +52 -0
- data/doc/en/cairo-ps-level.rd +24 -0
- data/doc/en/cairo-ps-surface.html +95 -0
- data/doc/en/cairo-ps-surface.rd +55 -0
- data/doc/en/cairo-quartz-image-surface.html +60 -0
- data/doc/en/cairo-quartz-image-surface.rd +27 -0
- data/doc/en/cairo-quartz-surface.html +60 -0
- data/doc/en/cairo-quartz-surface.rd +27 -0
- data/doc/en/cairo-radial-pattern.html +63 -0
- data/doc/en/cairo-radial-pattern.rd +28 -0
- data/doc/en/cairo-read-error.html +50 -0
- data/doc/en/cairo-read-error.rd +17 -0
- data/doc/en/cairo-rectangle.html +92 -0
- data/doc/en/cairo-rectangle.rd +54 -0
- data/doc/en/cairo-scaled-font.html +87 -0
- data/doc/en/cairo-scaled-font.rd +50 -0
- data/doc/en/cairo-solid-pattern.html +65 -0
- data/doc/en/cairo-solid-pattern.rd +31 -0
- data/doc/en/cairo-subpixel-order.html +42 -0
- data/doc/en/cairo-subpixel-order.rd +17 -0
- data/doc/en/cairo-surface-finished-error.html +50 -0
- data/doc/en/cairo-surface-finished-error.rd +17 -0
- data/doc/en/cairo-surface-pattern.html +60 -0
- data/doc/en/cairo-surface-pattern.rd +27 -0
- data/doc/en/cairo-surface-type-mismatch-error.html +50 -0
- data/doc/en/cairo-surface-type-mismatch-error.rd +17 -0
- data/doc/en/cairo-surface.html +114 -0
- data/doc/en/cairo-surface.rd +72 -0
- data/doc/en/cairo-svg-surface.html +80 -0
- data/doc/en/cairo-svg-surface.rd +44 -0
- data/doc/en/cairo-svg-version.html +52 -0
- data/doc/en/cairo-svg-version.rd +24 -0
- data/doc/en/cairo-temp-file-error.html +50 -0
- data/doc/en/cairo-temp-file-error.rd +17 -0
- data/doc/en/cairo-text-extents.html +79 -0
- data/doc/en/cairo-text-extents.rd +44 -0
- data/doc/en/cairo-win32-printing-surface.html +60 -0
- data/doc/en/cairo-win32-printing-surface.rd +27 -0
- data/doc/en/cairo-win32-surface.html +65 -0
- data/doc/en/cairo-win32-surface.rd +31 -0
- data/doc/en/cairo-write-error.html +50 -0
- data/doc/en/cairo-write-error.rd +17 -0
- data/doc/en/cairo.html +123 -0
- data/doc/en/cairo.rd +95 -0
- data/doc/en/index.html +1080 -0
- data/doc/en/index.rd +1051 -0
- data/doc/index.html +18 -0
- data/doc/ja/cairo-antialias.html +57 -0
- data/doc/ja/cairo-clip-not-representable-error.html +56 -0
- data/doc/ja/cairo-color-base.html +75 -0
- data/doc/ja/cairo-color-cmyk.html +152 -0
- data/doc/ja/cairo-color-hsv.html +135 -0
- data/doc/ja/cairo-color-rgb.html +145 -0
- data/doc/ja/cairo-color-x11.html +183 -0
- data/doc/ja/cairo-color.html +317 -0
- data/doc/ja/cairo-content.html +51 -0
- data/doc/ja/cairo-context-blur.html +53 -0
- data/doc/ja/cairo-context-circle.html +54 -0
- data/doc/ja/cairo-context-color.html +52 -0
- data/doc/ja/cairo-context-path.html +77 -0
- data/doc/ja/cairo-context-rectangle.html +60 -0
- data/doc/ja/cairo-context-triangle.html +47 -0
- data/doc/ja/cairo-context.html +1449 -0
- data/doc/ja/cairo-error.html +56 -0
- data/doc/ja/cairo-extend.html +56 -0
- data/doc/ja/cairo-file-not-found.html +51 -0
- data/doc/ja/cairo-fill-rule.html +58 -0
- data/doc/ja/cairo-filter.html +43 -0
- data/doc/ja/cairo-font-extents.html +110 -0
- data/doc/ja/cairo-font-face.html +55 -0
- data/doc/ja/cairo-font-options.html +186 -0
- data/doc/ja/cairo-font-slant.html +50 -0
- data/doc/ja/cairo-font-weight.html +47 -0
- data/doc/ja/cairo-format.html +81 -0
- data/doc/ja/cairo-glyph.html +115 -0
- data/doc/ja/cairo-gradient-pattern.html +119 -0
- data/doc/ja/cairo-hint-metrics.html +57 -0
- data/doc/ja/cairo-hint-style.html +64 -0
- data/doc/ja/cairo-image-surface.html +131 -0
- data/doc/ja/cairo-invalid-content-error.html +54 -0
- data/doc/ja/cairo-invalid-dash-error.html +54 -0
- data/doc/ja/cairo-invalid-dsc-comment-error.html +54 -0
- data/doc/ja/cairo-invalid-format-error.html +54 -0
- data/doc/ja/cairo-invalid-index-error.html +54 -0
- data/doc/ja/cairo-invalid-matrix-error.html +54 -0
- data/doc/ja/cairo-invalid-path-data-error.html +54 -0
- data/doc/ja/cairo-invalid-pop-group-error.html +54 -0
- data/doc/ja/cairo-invalid-restore-error.html +55 -0
- data/doc/ja/cairo-invalid-status-error.html +55 -0
- data/doc/ja/cairo-invalid-stride-error.html +55 -0
- data/doc/ja/cairo-invalid-string-error.html +54 -0
- data/doc/ja/cairo-invalid-visual-error.html +57 -0
- data/doc/ja/cairo-line-cap.html +50 -0
- data/doc/ja/cairo-line-join.html +53 -0
- data/doc/ja/cairo-linear-pattern.html +87 -0
- data/doc/ja/cairo-matrix.html +343 -0
- data/doc/ja/cairo-no-current-point-error.html +54 -0
- data/doc/ja/cairo-null-pointer-error.html +54 -0
- data/doc/ja/cairo-operator.html +51 -0
- data/doc/ja/cairo-paper-parse-error.html +55 -0
- data/doc/ja/cairo-paper-unknown-paper-name.html +76 -0
- data/doc/ja/cairo-paper-unknown-unit.html +75 -0
- data/doc/ja/cairo-paper-unrecognized-paper-description.html +76 -0
- data/doc/ja/cairo-paper.html +357 -0
- data/doc/ja/cairo-path-close-path.html +57 -0
- data/doc/ja/cairo-path-curve-to.html +70 -0
- data/doc/ja/cairo-path-data-type.html +53 -0
- data/doc/ja/cairo-path-data.html +127 -0
- data/doc/ja/cairo-path-line-to.html +62 -0
- data/doc/ja/cairo-path-move-to.html +62 -0
- data/doc/ja/cairo-path.html +144 -0
- data/doc/ja/cairo-pattern-type-mismatch-error.html +56 -0
- data/doc/ja/cairo-pattern.html +128 -0
- data/doc/ja/cairo-pdf-surface.html +86 -0
- data/doc/ja/cairo-point.html +90 -0
- data/doc/ja/cairo-ps-level.html +62 -0
- data/doc/ja/cairo-ps-surface.html +214 -0
- data/doc/ja/cairo-quartz-image-surface.html +75 -0
- data/doc/ja/cairo-quartz-surface.html +93 -0
- data/doc/ja/cairo-radial-pattern.html +93 -0
- data/doc/ja/cairo-read-error.html +55 -0
- data/doc/ja/cairo-rectangle.html +109 -0
- data/doc/ja/cairo-scaled-font.html +144 -0
- data/doc/ja/cairo-solid-pattern.html +87 -0
- data/doc/ja/cairo-subpixel-order.html +57 -0
- data/doc/ja/cairo-surface-finished-error.html +54 -0
- data/doc/ja/cairo-surface-pattern.html +68 -0
- data/doc/ja/cairo-surface-type-mismatch-error.html +56 -0
- data/doc/ja/cairo-surface.html +191 -0
- data/doc/ja/cairo-svg-surface.html +114 -0
- data/doc/ja/cairo-svg-version.html +66 -0
- data/doc/ja/cairo-temp-file-error.html +50 -0
- data/doc/ja/cairo-text-extents.html +101 -0
- data/doc/ja/cairo-win32-printing-surface.html +80 -0
- data/doc/ja/cairo-win32-surface.html +100 -0
- data/doc/ja/cairo-write-error.html +55 -0
- data/doc/ja/cairo.html +148 -0
- data/doc/ja/index.html +1080 -0
- data/extconf.rb +153 -0
- data/misc/update-colors.rb +143 -0
- data/pkg-config.rb +278 -0
- data/samples/agg/README +4 -0
- data/samples/agg/aa_demo.rb +47 -0
- data/samples/agg/aa_test.rb +304 -0
- data/samples/blur.rb +47 -0
- data/samples/pac.rb +99 -0
- data/samples/pac2.rb +171 -0
- data/samples/png.rb +45 -0
- data/samples/scalable.rb +56 -0
- data/samples/text-on-path.rb +60 -0
- data/samples/text2.rb +131 -0
- data/src/cairo.def +96 -0
- data/src/cairo.so +0 -0
- data/src/lib/cairo.rb +141 -0
- data/src/lib/cairo/color.rb +255 -0
- data/src/lib/cairo/colors.rb +656 -0
- data/src/lib/cairo/constants.rb +21 -0
- data/src/lib/cairo/context.rb +29 -0
- data/src/lib/cairo/context/blur.rb +45 -0
- data/src/lib/cairo/context/circle.rb +9 -0
- data/src/lib/cairo/context/color.rb +11 -0
- data/src/lib/cairo/context/path.rb +116 -0
- data/src/lib/cairo/context/rectangle.rb +33 -0
- data/src/lib/cairo/context/triangle.rb +12 -0
- data/src/lib/cairo/paper.rb +183 -0
- data/src/lib/cairo/papers.rb +41 -0
- data/src/lib/cairo/path.rb +15 -0
- data/src/lib/cairo/point.rb +7 -0
- data/src/libruby-cairo.a +0 -0
- data/src/rb_cairo.c +82 -0
- data/src/rb_cairo.h +264 -0
- data/src/rb_cairo_constants.c +456 -0
- data/src/rb_cairo_context.c +1548 -0
- data/src/rb_cairo_exception.c +214 -0
- data/src/rb_cairo_font_extents.c +125 -0
- data/src/rb_cairo_font_face.c +56 -0
- data/src/rb_cairo_font_options.c +197 -0
- data/src/rb_cairo_glyph.c +159 -0
- data/src/rb_cairo_matrix.c +350 -0
- data/src/rb_cairo_path.c +459 -0
- data/src/rb_cairo_pattern.c +540 -0
- data/src/rb_cairo_private.c +78 -0
- data/src/rb_cairo_private.h +72 -0
- data/src/rb_cairo_scaled_font.c +177 -0
- data/src/rb_cairo_surface.c +1252 -0
- data/src/rb_cairo_text_extents.c +138 -0
- data/test/run-test.rb +15 -0
- data/test/test_paper.rb +81 -0
- data/test/test_pkg_config.rb +122 -0
- metadata +490 -0
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
2
|
+
<html>
|
|
3
|
+
<head>
|
|
4
|
+
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
|
|
5
|
+
<title>Surfaces</title>
|
|
6
|
+
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
|
|
7
|
+
<link rel="start" href="index.html" title="Cairo: A Vector Graphics Library">
|
|
8
|
+
<link rel="up" href="language-bindings.html" title="Appendix A. Creating a language binding for cairo">
|
|
9
|
+
<link rel="prev" href="bindings-patterns.html" title="Patterns">
|
|
10
|
+
<link rel="next" href="bindings-fonts.html" title="Fonts">
|
|
11
|
+
<meta name="generator" content="GTK-Doc V1.9 (XML mode)">
|
|
12
|
+
<link rel="stylesheet" href="style.css" type="text/css">
|
|
13
|
+
<link rel="chapter" href="Drawing.html" title="Drawing">
|
|
14
|
+
<link rel="chapter" href="Fonts.html" title="Fonts">
|
|
15
|
+
<link rel="chapter" href="Surfaces.html" title="Surfaces">
|
|
16
|
+
<link rel="chapter" href="Support.html" title="Utilities">
|
|
17
|
+
<link rel="index" href="ix01.html" title="Index">
|
|
18
|
+
<link rel="index" href="index-1.2.html" title="Index of new symbols in 1.2">
|
|
19
|
+
<link rel="index" href="index-1.4.html" title="Index of new symbols in 1.4">
|
|
20
|
+
<link rel="index" href="index-1.6.html" title="Index of new symbols in 1.6">
|
|
21
|
+
<link rel="appendix" href="language-bindings.html" title="Appendix A. Creating a language binding for cairo">
|
|
22
|
+
</head>
|
|
23
|
+
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
|
24
|
+
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle">
|
|
25
|
+
<td><a accesskey="p" href="bindings-patterns.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
|
|
26
|
+
<td><a accesskey="u" href="language-bindings.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
|
|
27
|
+
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
|
|
28
|
+
<th width="100%" align="center">Cairo: A Vector Graphics Library</th>
|
|
29
|
+
<td><a accesskey="n" href="bindings-fonts.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
|
|
30
|
+
</tr></table>
|
|
31
|
+
<div class="sect1" lang="en">
|
|
32
|
+
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
|
|
33
|
+
<a name="bindings-surfaces"></a>Surfaces</h2></div></div></div>
|
|
34
|
+
<p>
|
|
35
|
+
Like patterns, surfaces, which use only the
|
|
36
|
+
<a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t"><span class="type">cairo_surface_t</span></a>
|
|
37
|
+
type in the C API should be broken up into a hierarchy of types
|
|
38
|
+
in a language binding.
|
|
39
|
+
</p>
|
|
40
|
+
<pre class="programlisting">
|
|
41
|
+
cairo_surface_t
|
|
42
|
+
cairo_image_surface_t
|
|
43
|
+
cairo_atsui_surface_t
|
|
44
|
+
cairo_win32_surface_t
|
|
45
|
+
cairo_xlib_surface_t
|
|
46
|
+
cairo_beos_surface_t
|
|
47
|
+
</pre>
|
|
48
|
+
<p>
|
|
49
|
+
Unlike patterns, the constructors and methods on these types are
|
|
50
|
+
clearly named, and can be trivially associated with the
|
|
51
|
+
appropriate subtype. Many language bindings will want to avoid
|
|
52
|
+
binding the platform-specific subtypes at all, since the
|
|
53
|
+
methods on these types are not useful without passing in native
|
|
54
|
+
C types. Unless there is a language binding for Xlib available,
|
|
55
|
+
there is no way to represent a XLib <span class="type">Display</span> * in
|
|
56
|
+
that language.
|
|
57
|
+
</p>
|
|
58
|
+
<p>
|
|
59
|
+
This doesn't mean that platform-specific surface types can't
|
|
60
|
+
be used in a language binding that doesn't bind the constructor.
|
|
61
|
+
A very common situation is to use a cairo language binding in
|
|
62
|
+
combination with a binding for a higher level system like
|
|
63
|
+
the <a class="ulink" href="http://www.gtk.org/" target="_top">GTK+</a> widget
|
|
64
|
+
toolkit. In such a situation, the higher level toolkit provides
|
|
65
|
+
ways to get references to platform specific surfaces.
|
|
66
|
+
</p>
|
|
67
|
+
<p>
|
|
68
|
+
The <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-set-user-data"><code class="function">cairo_surface_set_user_data()</code></a>,
|
|
69
|
+
and <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-get-user-data"><code class="function">cairo_surface_get_user_data()</code></a>
|
|
70
|
+
methods are provided for use in language bindings, and should
|
|
71
|
+
not be directly exposed to applications. One example of the use
|
|
72
|
+
of these functions in a language binding is creating a binding for:
|
|
73
|
+
</p>
|
|
74
|
+
<pre class="programlisting">
|
|
75
|
+
cairo_surface_t *
|
|
76
|
+
<a class="link" href="cairo-Image-Surfaces.html#cairo-image-surface-create-for-data"><code class="function">cairo_image_surface_create_for_data</code></a> (unsigned char *data,
|
|
77
|
+
cairo_format_t format,
|
|
78
|
+
int width,
|
|
79
|
+
int height,
|
|
80
|
+
int stride);
|
|
81
|
+
</pre>
|
|
82
|
+
<p>
|
|
83
|
+
The memory block passed in for <em class="parameter"><code>data</code></em> must be
|
|
84
|
+
kept around until the surface is destroyed, so the language
|
|
85
|
+
binding must have some way of determining when that happens. The
|
|
86
|
+
way to do this is to use the <em class="parameter"><code>destroy</code></em>
|
|
87
|
+
argument to <code class="function">cairo_surface_set_user_data()</code>.
|
|
88
|
+
</p>
|
|
89
|
+
<p class="remark"><i><span class="remark">
|
|
90
|
+
Some languages may not have a suitable “pointer to a block of
|
|
91
|
+
data” type to pass in for <em class="parameter"><code>data</code></em>. And even
|
|
92
|
+
where a language does have such a type, the user will be
|
|
93
|
+
frequently able to cause the backing store to be reallocated
|
|
94
|
+
to a different location or truncated. Should we recommend a
|
|
95
|
+
standard type name and binding for a buffer object here?
|
|
96
|
+
</span></i></p>
|
|
97
|
+
</div>
|
|
98
|
+
</body>
|
|
99
|
+
</html>
|
|
@@ -0,0 +1,328 @@
|
|
|
1
|
+
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
2
|
+
<html>
|
|
3
|
+
<head>
|
|
4
|
+
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
|
|
5
|
+
<title>Error handling</title>
|
|
6
|
+
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
|
|
7
|
+
<link rel="start" href="index.html" title="Cairo: A Vector Graphics Library">
|
|
8
|
+
<link rel="up" href="Support.html" title="Utilities">
|
|
9
|
+
<link rel="prev" href="cairo-cairo-matrix-t.html" title="cairo_matrix_t">
|
|
10
|
+
<link rel="next" href="cairo-Version-Information.html" title="Version Information">
|
|
11
|
+
<meta name="generator" content="GTK-Doc V1.9 (XML mode)">
|
|
12
|
+
<link rel="stylesheet" href="style.css" type="text/css">
|
|
13
|
+
<link rel="chapter" href="Drawing.html" title="Drawing">
|
|
14
|
+
<link rel="chapter" href="Fonts.html" title="Fonts">
|
|
15
|
+
<link rel="chapter" href="Surfaces.html" title="Surfaces">
|
|
16
|
+
<link rel="chapter" href="Support.html" title="Utilities">
|
|
17
|
+
<link rel="index" href="ix01.html" title="Index">
|
|
18
|
+
<link rel="index" href="index-1.2.html" title="Index of new symbols in 1.2">
|
|
19
|
+
<link rel="index" href="index-1.4.html" title="Index of new symbols in 1.4">
|
|
20
|
+
<link rel="index" href="index-1.6.html" title="Index of new symbols in 1.6">
|
|
21
|
+
<link rel="appendix" href="language-bindings.html" title="Appendix A. Creating a language binding for cairo">
|
|
22
|
+
</head>
|
|
23
|
+
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
|
24
|
+
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
|
|
25
|
+
<tr valign="middle">
|
|
26
|
+
<td><a accesskey="p" href="cairo-cairo-matrix-t.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
|
|
27
|
+
<td><a accesskey="u" href="Support.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
|
|
28
|
+
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
|
|
29
|
+
<th width="100%" align="center">Cairo: A Vector Graphics Library</th>
|
|
30
|
+
<td><a accesskey="n" href="cairo-Version-Information.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
|
|
31
|
+
</tr>
|
|
32
|
+
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2613704" class="shortcut">Top</a>
|
|
33
|
+
 | 
|
|
34
|
+
<a href="#id2670967" class="shortcut">Description</a></nobr></td></tr>
|
|
35
|
+
</table>
|
|
36
|
+
<div class="refentry" lang="en">
|
|
37
|
+
<a name="cairo-Error-Handling"></a><div class="titlepage"></div>
|
|
38
|
+
<div class="refnamediv"><table width="100%"><tr>
|
|
39
|
+
<td valign="top">
|
|
40
|
+
<h2>
|
|
41
|
+
<a name="id2613704"></a><span class="refentrytitle">Error handling</span>
|
|
42
|
+
</h2>
|
|
43
|
+
<p>Error handling — Decoding cairo's status</p>
|
|
44
|
+
</td>
|
|
45
|
+
<td valign="top" align="right"></td>
|
|
46
|
+
</tr></table></div>
|
|
47
|
+
<div class="refsynopsisdiv">
|
|
48
|
+
<h2>Synopsis</h2>
|
|
49
|
+
<pre class="synopsis">
|
|
50
|
+
|
|
51
|
+
|
|
52
|
+
|
|
53
|
+
enum <a class="link" href="cairo-Error-Handling.html#cairo-status-t">cairo_status_t</a>;
|
|
54
|
+
const char* <a class="link" href="cairo-Error-Handling.html#cairo-status-to-string">cairo_status_to_string</a> (<a class="link" href="cairo-Error-Handling.html#cairo-status-t">cairo_status_t</a> status);
|
|
55
|
+
void <a class="link" href="cairo-Error-Handling.html#cairo-debug-reset-static-data">cairo_debug_reset_static_data</a> (void);
|
|
56
|
+
</pre>
|
|
57
|
+
</div>
|
|
58
|
+
<div class="refsect1" lang="en">
|
|
59
|
+
<a name="id2670967"></a><h2>Description</h2>
|
|
60
|
+
<p>
|
|
61
|
+
Cairo uses a single status type to represent all kinds of errors. A status
|
|
62
|
+
value of <a class="link" href="cairo-Error-Handling.html#CAIRO-STATUS-SUCCESS:CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> represents no error and has an integer value
|
|
63
|
+
of zero. All other status values represent an error.
|
|
64
|
+
</p>
|
|
65
|
+
<p>
|
|
66
|
+
Cairo's error handling is designed to be easy to use and safe. All major
|
|
67
|
+
cairo objects <em class="firstterm">retain</em> an error status internally which
|
|
68
|
+
can be queried anytime by the users using cairo*<code class="function">_status()</code> calls. In
|
|
69
|
+
the mean time, it is safe to call all cairo functions normally even if the
|
|
70
|
+
underlying object is in an error status. This means that no error handling
|
|
71
|
+
code is required before or after each individual cairo function call.
|
|
72
|
+
</p>
|
|
73
|
+
</div>
|
|
74
|
+
<div class="refsect1" lang="en">
|
|
75
|
+
<a name="id2671017"></a><h2>Details</h2>
|
|
76
|
+
<div class="refsect2" lang="en">
|
|
77
|
+
<a name="id2671028"></a><h3>
|
|
78
|
+
<a name="cairo-status-t"></a>enum cairo_status_t</h3>
|
|
79
|
+
<a class="indexterm" name="id2671039"></a><pre class="programlisting">typedef enum _cairo_status {
|
|
80
|
+
CAIRO_STATUS_SUCCESS = 0,
|
|
81
|
+
CAIRO_STATUS_NO_MEMORY,
|
|
82
|
+
CAIRO_STATUS_INVALID_RESTORE,
|
|
83
|
+
CAIRO_STATUS_INVALID_POP_GROUP,
|
|
84
|
+
CAIRO_STATUS_NO_CURRENT_POINT,
|
|
85
|
+
CAIRO_STATUS_INVALID_MATRIX,
|
|
86
|
+
CAIRO_STATUS_INVALID_STATUS,
|
|
87
|
+
CAIRO_STATUS_NULL_POINTER,
|
|
88
|
+
CAIRO_STATUS_INVALID_STRING,
|
|
89
|
+
CAIRO_STATUS_INVALID_PATH_DATA,
|
|
90
|
+
CAIRO_STATUS_READ_ERROR,
|
|
91
|
+
CAIRO_STATUS_WRITE_ERROR,
|
|
92
|
+
CAIRO_STATUS_SURFACE_FINISHED,
|
|
93
|
+
CAIRO_STATUS_SURFACE_TYPE_MISMATCH,
|
|
94
|
+
CAIRO_STATUS_PATTERN_TYPE_MISMATCH,
|
|
95
|
+
CAIRO_STATUS_INVALID_CONTENT,
|
|
96
|
+
CAIRO_STATUS_INVALID_FORMAT,
|
|
97
|
+
CAIRO_STATUS_INVALID_VISUAL,
|
|
98
|
+
CAIRO_STATUS_FILE_NOT_FOUND,
|
|
99
|
+
CAIRO_STATUS_INVALID_DASH,
|
|
100
|
+
CAIRO_STATUS_INVALID_DSC_COMMENT,
|
|
101
|
+
CAIRO_STATUS_INVALID_INDEX,
|
|
102
|
+
CAIRO_STATUS_CLIP_NOT_REPRESENTABLE,
|
|
103
|
+
CAIRO_STATUS_TEMP_FILE_ERROR,
|
|
104
|
+
CAIRO_STATUS_INVALID_STRIDE
|
|
105
|
+
/* after adding a new error: update CAIRO_STATUS_LAST_STATUS in cairoint.h */
|
|
106
|
+
} cairo_status_t;
|
|
107
|
+
</pre>
|
|
108
|
+
<p>
|
|
109
|
+
<a class="link" href="cairo-Error-Handling.html#cairo-status-t"><span class="type">cairo_status_t</span></a> is used to indicate errors that can occur when
|
|
110
|
+
using Cairo. In some cases it is returned directly by functions.
|
|
111
|
+
but when using <a class="link" href="cairo-cairo-t.html#cairo-t"><span class="type">cairo_t</span></a>, the last error, if any, is stored in
|
|
112
|
+
the context and can be retrieved with <a class="link" href="cairo-cairo-t.html#cairo-status"><code class="function">cairo_status()</code></a>.
|
|
113
|
+
</p>
|
|
114
|
+
<p>
|
|
115
|
+
New entries may be added in future versions. Use <a class="link" href="cairo-Error-Handling.html#cairo-status-to-string"><code class="function">cairo_status_to_string()</code></a>
|
|
116
|
+
to get a human-readable representation of an error message.</p>
|
|
117
|
+
<p>
|
|
118
|
+
|
|
119
|
+
</p>
|
|
120
|
+
<div class="variablelist"><table border="0">
|
|
121
|
+
<col align="left" valign="top">
|
|
122
|
+
<tbody>
|
|
123
|
+
<tr>
|
|
124
|
+
<td><p><span class="term"><a name="CAIRO-STATUS-SUCCESS:CAPS"></a><code class="literal">CAIRO_STATUS_SUCCESS</code></span></p></td>
|
|
125
|
+
<td> no error has occurred
|
|
126
|
+
</td>
|
|
127
|
+
</tr>
|
|
128
|
+
<tr>
|
|
129
|
+
<td><p><span class="term"><a name="CAIRO-STATUS-NO-MEMORY:CAPS"></a><code class="literal">CAIRO_STATUS_NO_MEMORY</code></span></p></td>
|
|
130
|
+
<td> out of memory
|
|
131
|
+
</td>
|
|
132
|
+
</tr>
|
|
133
|
+
<tr>
|
|
134
|
+
<td><p><span class="term"><a name="CAIRO-STATUS-INVALID-RESTORE:CAPS"></a><code class="literal">CAIRO_STATUS_INVALID_RESTORE</code></span></p></td>
|
|
135
|
+
<td> <a class="link" href="cairo-cairo-t.html#cairo-restore"><code class="function">cairo_restore()</code></a> called without matching <a class="link" href="cairo-cairo-t.html#cairo-save"><code class="function">cairo_save()</code></a>
|
|
136
|
+
</td>
|
|
137
|
+
</tr>
|
|
138
|
+
<tr>
|
|
139
|
+
<td><p><span class="term"><a name="CAIRO-STATUS-INVALID-POP-GROUP:CAPS"></a><code class="literal">CAIRO_STATUS_INVALID_POP_GROUP</code></span></p></td>
|
|
140
|
+
<td> no saved group to pop
|
|
141
|
+
</td>
|
|
142
|
+
</tr>
|
|
143
|
+
<tr>
|
|
144
|
+
<td><p><span class="term"><a name="CAIRO-STATUS-NO-CURRENT-POINT:CAPS"></a><code class="literal">CAIRO_STATUS_NO_CURRENT_POINT</code></span></p></td>
|
|
145
|
+
<td> no current point defined
|
|
146
|
+
</td>
|
|
147
|
+
</tr>
|
|
148
|
+
<tr>
|
|
149
|
+
<td><p><span class="term"><a name="CAIRO-STATUS-INVALID-MATRIX:CAPS"></a><code class="literal">CAIRO_STATUS_INVALID_MATRIX</code></span></p></td>
|
|
150
|
+
<td> invalid matrix (not invertible)
|
|
151
|
+
</td>
|
|
152
|
+
</tr>
|
|
153
|
+
<tr>
|
|
154
|
+
<td><p><span class="term"><a name="CAIRO-STATUS-INVALID-STATUS:CAPS"></a><code class="literal">CAIRO_STATUS_INVALID_STATUS</code></span></p></td>
|
|
155
|
+
<td> invalid value for an input <a class="link" href="cairo-Error-Handling.html#cairo-status-t"><span class="type">cairo_status_t</span></a>
|
|
156
|
+
</td>
|
|
157
|
+
</tr>
|
|
158
|
+
<tr>
|
|
159
|
+
<td><p><span class="term"><a name="CAIRO-STATUS-NULL-POINTER:CAPS"></a><code class="literal">CAIRO_STATUS_NULL_POINTER</code></span></p></td>
|
|
160
|
+
<td> <code class="literal">NULL</code> pointer
|
|
161
|
+
</td>
|
|
162
|
+
</tr>
|
|
163
|
+
<tr>
|
|
164
|
+
<td><p><span class="term"><a name="CAIRO-STATUS-INVALID-STRING:CAPS"></a><code class="literal">CAIRO_STATUS_INVALID_STRING</code></span></p></td>
|
|
165
|
+
<td> input string not valid UTF-8
|
|
166
|
+
</td>
|
|
167
|
+
</tr>
|
|
168
|
+
<tr>
|
|
169
|
+
<td><p><span class="term"><a name="CAIRO-STATUS-INVALID-PATH-DATA:CAPS"></a><code class="literal">CAIRO_STATUS_INVALID_PATH_DATA</code></span></p></td>
|
|
170
|
+
<td> input path data not valid
|
|
171
|
+
</td>
|
|
172
|
+
</tr>
|
|
173
|
+
<tr>
|
|
174
|
+
<td><p><span class="term"><a name="CAIRO-STATUS-READ-ERROR:CAPS"></a><code class="literal">CAIRO_STATUS_READ_ERROR</code></span></p></td>
|
|
175
|
+
<td> error while reading from input stream
|
|
176
|
+
</td>
|
|
177
|
+
</tr>
|
|
178
|
+
<tr>
|
|
179
|
+
<td><p><span class="term"><a name="CAIRO-STATUS-WRITE-ERROR:CAPS"></a><code class="literal">CAIRO_STATUS_WRITE_ERROR</code></span></p></td>
|
|
180
|
+
<td> error while writing to output stream
|
|
181
|
+
</td>
|
|
182
|
+
</tr>
|
|
183
|
+
<tr>
|
|
184
|
+
<td><p><span class="term"><a name="CAIRO-STATUS-SURFACE-FINISHED:CAPS"></a><code class="literal">CAIRO_STATUS_SURFACE_FINISHED</code></span></p></td>
|
|
185
|
+
<td> target surface has been finished
|
|
186
|
+
</td>
|
|
187
|
+
</tr>
|
|
188
|
+
<tr>
|
|
189
|
+
<td><p><span class="term"><a name="CAIRO-STATUS-SURFACE-TYPE-MISMATCH:CAPS"></a><code class="literal">CAIRO_STATUS_SURFACE_TYPE_MISMATCH</code></span></p></td>
|
|
190
|
+
<td> the surface type is not appropriate for the operation
|
|
191
|
+
</td>
|
|
192
|
+
</tr>
|
|
193
|
+
<tr>
|
|
194
|
+
<td><p><span class="term"><a name="CAIRO-STATUS-PATTERN-TYPE-MISMATCH:CAPS"></a><code class="literal">CAIRO_STATUS_PATTERN_TYPE_MISMATCH</code></span></p></td>
|
|
195
|
+
<td> the pattern type is not appropriate for the operation
|
|
196
|
+
</td>
|
|
197
|
+
</tr>
|
|
198
|
+
<tr>
|
|
199
|
+
<td><p><span class="term"><a name="CAIRO-STATUS-INVALID-CONTENT:CAPS"></a><code class="literal">CAIRO_STATUS_INVALID_CONTENT</code></span></p></td>
|
|
200
|
+
<td> invalid value for an input <a class="link" href="cairo-cairo-surface-t.html#cairo-content-t"><span class="type">cairo_content_t</span></a>
|
|
201
|
+
</td>
|
|
202
|
+
</tr>
|
|
203
|
+
<tr>
|
|
204
|
+
<td><p><span class="term"><a name="CAIRO-STATUS-INVALID-FORMAT:CAPS"></a><code class="literal">CAIRO_STATUS_INVALID_FORMAT</code></span></p></td>
|
|
205
|
+
<td> invalid value for an input <a class="link" href="cairo-Image-Surfaces.html#cairo-format-t"><span class="type">cairo_format_t</span></a>
|
|
206
|
+
</td>
|
|
207
|
+
</tr>
|
|
208
|
+
<tr>
|
|
209
|
+
<td><p><span class="term"><a name="CAIRO-STATUS-INVALID-VISUAL:CAPS"></a><code class="literal">CAIRO_STATUS_INVALID_VISUAL</code></span></p></td>
|
|
210
|
+
<td> invalid value for an input Visual*
|
|
211
|
+
</td>
|
|
212
|
+
</tr>
|
|
213
|
+
<tr>
|
|
214
|
+
<td><p><span class="term"><a name="CAIRO-STATUS-FILE-NOT-FOUND:CAPS"></a><code class="literal">CAIRO_STATUS_FILE_NOT_FOUND</code></span></p></td>
|
|
215
|
+
<td> file not found
|
|
216
|
+
</td>
|
|
217
|
+
</tr>
|
|
218
|
+
<tr>
|
|
219
|
+
<td><p><span class="term"><a name="CAIRO-STATUS-INVALID-DASH:CAPS"></a><code class="literal">CAIRO_STATUS_INVALID_DASH</code></span></p></td>
|
|
220
|
+
<td> invalid value for a dash setting
|
|
221
|
+
</td>
|
|
222
|
+
</tr>
|
|
223
|
+
<tr>
|
|
224
|
+
<td><p><span class="term"><a name="CAIRO-STATUS-INVALID-DSC-COMMENT:CAPS"></a><code class="literal">CAIRO_STATUS_INVALID_DSC_COMMENT</code></span></p></td>
|
|
225
|
+
<td> invalid value for a DSC comment (Since 1.2)
|
|
226
|
+
</td>
|
|
227
|
+
</tr>
|
|
228
|
+
<tr>
|
|
229
|
+
<td><p><span class="term"><a name="CAIRO-STATUS-INVALID-INDEX:CAPS"></a><code class="literal">CAIRO_STATUS_INVALID_INDEX</code></span></p></td>
|
|
230
|
+
<td> invalid index passed to getter (Since 1.4)
|
|
231
|
+
</td>
|
|
232
|
+
</tr>
|
|
233
|
+
<tr>
|
|
234
|
+
<td><p><span class="term"><a name="CAIRO-STATUS-CLIP-NOT-REPRESENTABLE:CAPS"></a><code class="literal">CAIRO_STATUS_CLIP_NOT_REPRESENTABLE</code></span></p></td>
|
|
235
|
+
<td> clip region not representable in desired format (Since 1.4)
|
|
236
|
+
</td>
|
|
237
|
+
</tr>
|
|
238
|
+
<tr>
|
|
239
|
+
<td><p><span class="term"><a name="CAIRO-STATUS-TEMP-FILE-ERROR:CAPS"></a><code class="literal">CAIRO_STATUS_TEMP_FILE_ERROR</code></span></p></td>
|
|
240
|
+
<td> error creating or writing to a temporary file (Since 1.6)
|
|
241
|
+
</td>
|
|
242
|
+
</tr>
|
|
243
|
+
<tr>
|
|
244
|
+
<td><p><span class="term"><a name="CAIRO-STATUS-INVALID-STRIDE:CAPS"></a><code class="literal">CAIRO_STATUS_INVALID_STRIDE</code></span></p></td>
|
|
245
|
+
<td> invalid value for stride (Since 1.6)
|
|
246
|
+
</td>
|
|
247
|
+
</tr>
|
|
248
|
+
</tbody>
|
|
249
|
+
</table></div>
|
|
250
|
+
</div>
|
|
251
|
+
<hr>
|
|
252
|
+
<div class="refsect2" lang="en">
|
|
253
|
+
<a name="id2674272"></a><h3>
|
|
254
|
+
<a name="cairo-status-to-string"></a>cairo_status_to_string ()</h3>
|
|
255
|
+
<a class="indexterm" name="id2674283"></a><pre class="programlisting">const char* cairo_status_to_string (<a class="link" href="cairo-Error-Handling.html#cairo-status-t">cairo_status_t</a> status);</pre>
|
|
256
|
+
<p>
|
|
257
|
+
Provides a human-readable description of a <a class="link" href="cairo-Error-Handling.html#cairo-status-t"><span class="type">cairo_status_t</span></a>.</p>
|
|
258
|
+
<p>
|
|
259
|
+
|
|
260
|
+
</p>
|
|
261
|
+
<div class="variablelist"><table border="0">
|
|
262
|
+
<col align="left" valign="top">
|
|
263
|
+
<tbody>
|
|
264
|
+
<tr>
|
|
265
|
+
<td><p><span class="term"><em class="parameter"><code>status</code></em> :</span></p></td>
|
|
266
|
+
<td> a cairo status
|
|
267
|
+
</td>
|
|
268
|
+
</tr>
|
|
269
|
+
<tr>
|
|
270
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
271
|
+
<td> a string representation of the status
|
|
272
|
+
</td>
|
|
273
|
+
</tr>
|
|
274
|
+
</tbody>
|
|
275
|
+
</table></div>
|
|
276
|
+
</div>
|
|
277
|
+
<hr>
|
|
278
|
+
<div class="refsect2" lang="en">
|
|
279
|
+
<a name="id2674354"></a><h3>
|
|
280
|
+
<a name="cairo-debug-reset-static-data"></a>cairo_debug_reset_static_data ()</h3>
|
|
281
|
+
<a class="indexterm" name="id2674366"></a><pre class="programlisting">void cairo_debug_reset_static_data (void);</pre>
|
|
282
|
+
<p>
|
|
283
|
+
Resets all static data within cairo to its original state,
|
|
284
|
+
(ie. identical to the state at the time of program invocation). For
|
|
285
|
+
example, all caches within cairo will be flushed empty.
|
|
286
|
+
</p>
|
|
287
|
+
<p>
|
|
288
|
+
This function is intended to be useful when using memory-checking
|
|
289
|
+
tools such as valgrind. When valgrind's memcheck analyzes a
|
|
290
|
+
cairo-using program without a call to <a class="link" href="cairo-Error-Handling.html#cairo-debug-reset-static-data"><code class="function">cairo_debug_reset_static_data()</code></a>,
|
|
291
|
+
it will report all data reachable via cairo's static objects as
|
|
292
|
+
"still reachable". Calling <a class="link" href="cairo-Error-Handling.html#cairo-debug-reset-static-data"><code class="function">cairo_debug_reset_static_data()</code></a> just prior
|
|
293
|
+
to program termination will make it easier to get squeaky clean
|
|
294
|
+
reports from valgrind.
|
|
295
|
+
</p>
|
|
296
|
+
<p>
|
|
297
|
+
WARNING: It is only safe to call this function when there are no
|
|
298
|
+
active cairo objects remaining, (ie. the appropriate destroy
|
|
299
|
+
functions have been called as necessary). If there are active cairo
|
|
300
|
+
objects, this call is likely to cause a crash, (eg. an assertion
|
|
301
|
+
failure due to a hash table being destroyed when non-empty).</p>
|
|
302
|
+
<p>
|
|
303
|
+
|
|
304
|
+
</p>
|
|
305
|
+
</div>
|
|
306
|
+
</div>
|
|
307
|
+
<div class="refsect1" lang="en">
|
|
308
|
+
<a name="id2674434"></a><h2>See Also</h2>
|
|
309
|
+
<p>
|
|
310
|
+
</p>
|
|
311
|
+
<div class="itemizedlist"><ul type="disc">
|
|
312
|
+
<li><a class="link" href="cairo-cairo-t.html#cairo-status"><code class="function">cairo_status()</code></a></li>
|
|
313
|
+
<li><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-status"><code class="function">cairo_surface_status()</code></a></li>
|
|
314
|
+
<li><a class="link" href="cairo-Patterns.html#cairo-pattern-status"><code class="function">cairo_pattern_status()</code></a></li>
|
|
315
|
+
<li><a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-status"><code class="function">cairo_font_face_status()</code></a></li>
|
|
316
|
+
<li><a class="link" href="cairo-Scaled-Fonts.html#cairo-scaled-font-status"><code class="function">cairo_scaled_font_status()</code></a></li>
|
|
317
|
+
</ul></div>
|
|
318
|
+
<p>
|
|
319
|
+
</p>
|
|
320
|
+
</div>
|
|
321
|
+
<div class="refsect1" lang="en">
|
|
322
|
+
<a name="id2674499"></a><div class="refsect2" lang="en"><a name="id2674500"></a></div>
|
|
323
|
+
<hr>
|
|
324
|
+
<div class="refsect2" lang="en"><a name="id2674501"></a></div>
|
|
325
|
+
</div>
|
|
326
|
+
</div>
|
|
327
|
+
</body>
|
|
328
|
+
</html>
|
|
@@ -0,0 +1,720 @@
|
|
|
1
|
+
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
2
|
+
<html>
|
|
3
|
+
<head>
|
|
4
|
+
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
|
|
5
|
+
<title>cairo_font_options_t</title>
|
|
6
|
+
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
|
|
7
|
+
<link rel="start" href="index.html" title="Cairo: A Vector Graphics Library">
|
|
8
|
+
<link rel="up" href="Fonts.html" title="Fonts">
|
|
9
|
+
<link rel="prev" href="cairo-Scaled-Fonts.html" title="cairo_scaled_font_t">
|
|
10
|
+
<link rel="next" href="cairo-FreeType-Fonts.html" title="FreeType Fonts">
|
|
11
|
+
<meta name="generator" content="GTK-Doc V1.9 (XML mode)">
|
|
12
|
+
<link rel="stylesheet" href="style.css" type="text/css">
|
|
13
|
+
<link rel="chapter" href="Drawing.html" title="Drawing">
|
|
14
|
+
<link rel="chapter" href="Fonts.html" title="Fonts">
|
|
15
|
+
<link rel="chapter" href="Surfaces.html" title="Surfaces">
|
|
16
|
+
<link rel="chapter" href="Support.html" title="Utilities">
|
|
17
|
+
<link rel="index" href="ix01.html" title="Index">
|
|
18
|
+
<link rel="index" href="index-1.2.html" title="Index of new symbols in 1.2">
|
|
19
|
+
<link rel="index" href="index-1.4.html" title="Index of new symbols in 1.4">
|
|
20
|
+
<link rel="index" href="index-1.6.html" title="Index of new symbols in 1.6">
|
|
21
|
+
<link rel="appendix" href="language-bindings.html" title="Appendix A. Creating a language binding for cairo">
|
|
22
|
+
</head>
|
|
23
|
+
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
|
24
|
+
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
|
|
25
|
+
<tr valign="middle">
|
|
26
|
+
<td><a accesskey="p" href="cairo-Scaled-Fonts.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
|
|
27
|
+
<td><a accesskey="u" href="Fonts.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
|
|
28
|
+
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
|
|
29
|
+
<th width="100%" align="center">Cairo: A Vector Graphics Library</th>
|
|
30
|
+
<td><a accesskey="n" href="cairo-FreeType-Fonts.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
|
|
31
|
+
</tr>
|
|
32
|
+
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2619108" class="shortcut">Top</a>
|
|
33
|
+
 | 
|
|
34
|
+
<a href="#id2651232" class="shortcut">Description</a></nobr></td></tr>
|
|
35
|
+
</table>
|
|
36
|
+
<div class="refentry" lang="en">
|
|
37
|
+
<a name="cairo-Font-Options"></a><div class="titlepage"></div>
|
|
38
|
+
<div class="refnamediv"><table width="100%"><tr>
|
|
39
|
+
<td valign="top">
|
|
40
|
+
<h2>
|
|
41
|
+
<a name="id2619108"></a><span class="refentrytitle">cairo_font_options_t</span>
|
|
42
|
+
</h2>
|
|
43
|
+
<p>cairo_font_options_t — How a font should be rendered</p>
|
|
44
|
+
</td>
|
|
45
|
+
<td valign="top" align="right"></td>
|
|
46
|
+
</tr></table></div>
|
|
47
|
+
<div class="refsynopsisdiv">
|
|
48
|
+
<h2>Synopsis</h2>
|
|
49
|
+
<pre class="synopsis">
|
|
50
|
+
|
|
51
|
+
|
|
52
|
+
|
|
53
|
+
typedef <a class="link" href="cairo-Font-Options.html#cairo-font-options-t">cairo_font_options_t</a>;
|
|
54
|
+
<a class="link" href="cairo-Font-Options.html#cairo-font-options-t">cairo_font_options_t</a>* <a class="link" href="cairo-Font-Options.html#cairo-font-options-create">cairo_font_options_create</a> (void);
|
|
55
|
+
<a class="link" href="cairo-Font-Options.html#cairo-font-options-t">cairo_font_options_t</a>* <a class="link" href="cairo-Font-Options.html#cairo-font-options-copy">cairo_font_options_copy</a> (const <a class="link" href="cairo-Font-Options.html#cairo-font-options-t">cairo_font_options_t</a> *original);
|
|
56
|
+
void <a class="link" href="cairo-Font-Options.html#cairo-font-options-destroy">cairo_font_options_destroy</a> (<a class="link" href="cairo-Font-Options.html#cairo-font-options-t">cairo_font_options_t</a> *options);
|
|
57
|
+
<a class="link" href="cairo-Error-Handling.html#cairo-status-t">cairo_status_t</a> <a class="link" href="cairo-Font-Options.html#cairo-font-options-status">cairo_font_options_status</a> (<a class="link" href="cairo-Font-Options.html#cairo-font-options-t">cairo_font_options_t</a> *options);
|
|
58
|
+
void <a class="link" href="cairo-Font-Options.html#cairo-font-options-merge">cairo_font_options_merge</a> (<a class="link" href="cairo-Font-Options.html#cairo-font-options-t">cairo_font_options_t</a> *options,
|
|
59
|
+
const <a class="link" href="cairo-Font-Options.html#cairo-font-options-t">cairo_font_options_t</a> *other);
|
|
60
|
+
unsigned long <a class="link" href="cairo-Font-Options.html#cairo-font-options-hash">cairo_font_options_hash</a> (const <a class="link" href="cairo-Font-Options.html#cairo-font-options-t">cairo_font_options_t</a> *options);
|
|
61
|
+
<a class="link" href="cairo-Types.html#cairo-bool-t">cairo_bool_t</a> <a class="link" href="cairo-Font-Options.html#cairo-font-options-equal">cairo_font_options_equal</a> (const <a class="link" href="cairo-Font-Options.html#cairo-font-options-t">cairo_font_options_t</a> *options,
|
|
62
|
+
const <a class="link" href="cairo-Font-Options.html#cairo-font-options-t">cairo_font_options_t</a> *other);
|
|
63
|
+
void <a class="link" href="cairo-Font-Options.html#cairo-font-options-set-antialias">cairo_font_options_set_antialias</a> (<a class="link" href="cairo-Font-Options.html#cairo-font-options-t">cairo_font_options_t</a> *options,
|
|
64
|
+
<a class="link" href="cairo-cairo-t.html#cairo-antialias-t">cairo_antialias_t</a> antialias);
|
|
65
|
+
<a class="link" href="cairo-cairo-t.html#cairo-antialias-t">cairo_antialias_t</a> <a class="link" href="cairo-Font-Options.html#cairo-font-options-get-antialias">cairo_font_options_get_antialias</a> (const <a class="link" href="cairo-Font-Options.html#cairo-font-options-t">cairo_font_options_t</a> *options);
|
|
66
|
+
enum <a class="link" href="cairo-Font-Options.html#cairo-subpixel-order-t">cairo_subpixel_order_t</a>;
|
|
67
|
+
void <a class="link" href="cairo-Font-Options.html#cairo-font-options-set-subpixel-order">cairo_font_options_set_subpixel_order</a>
|
|
68
|
+
(<a class="link" href="cairo-Font-Options.html#cairo-font-options-t">cairo_font_options_t</a> *options,
|
|
69
|
+
<a class="link" href="cairo-Font-Options.html#cairo-subpixel-order-t">cairo_subpixel_order_t</a> subpixel_order);
|
|
70
|
+
<a class="link" href="cairo-Font-Options.html#cairo-subpixel-order-t">cairo_subpixel_order_t</a> <a class="link" href="cairo-Font-Options.html#cairo-font-options-get-subpixel-order">cairo_font_options_get_subpixel_order</a>
|
|
71
|
+
(const <a class="link" href="cairo-Font-Options.html#cairo-font-options-t">cairo_font_options_t</a> *options);
|
|
72
|
+
enum <a class="link" href="cairo-Font-Options.html#cairo-hint-style-t">cairo_hint_style_t</a>;
|
|
73
|
+
void <a class="link" href="cairo-Font-Options.html#cairo-font-options-set-hint-style">cairo_font_options_set_hint_style</a> (<a class="link" href="cairo-Font-Options.html#cairo-font-options-t">cairo_font_options_t</a> *options,
|
|
74
|
+
<a class="link" href="cairo-Font-Options.html#cairo-hint-style-t">cairo_hint_style_t</a> hint_style);
|
|
75
|
+
<a class="link" href="cairo-Font-Options.html#cairo-hint-style-t">cairo_hint_style_t</a> <a class="link" href="cairo-Font-Options.html#cairo-font-options-get-hint-style">cairo_font_options_get_hint_style</a> (const <a class="link" href="cairo-Font-Options.html#cairo-font-options-t">cairo_font_options_t</a> *options);
|
|
76
|
+
enum <a class="link" href="cairo-Font-Options.html#cairo-hint-metrics-t">cairo_hint_metrics_t</a>;
|
|
77
|
+
void <a class="link" href="cairo-Font-Options.html#cairo-font-options-set-hint-metrics">cairo_font_options_set_hint_metrics</a> (<a class="link" href="cairo-Font-Options.html#cairo-font-options-t">cairo_font_options_t</a> *options,
|
|
78
|
+
<a class="link" href="cairo-Font-Options.html#cairo-hint-metrics-t">cairo_hint_metrics_t</a> hint_metrics);
|
|
79
|
+
<a class="link" href="cairo-Font-Options.html#cairo-hint-metrics-t">cairo_hint_metrics_t</a> <a class="link" href="cairo-Font-Options.html#cairo-font-options-get-hint-metrics">cairo_font_options_get_hint_metrics</a>
|
|
80
|
+
(const <a class="link" href="cairo-Font-Options.html#cairo-font-options-t">cairo_font_options_t</a> *options);
|
|
81
|
+
</pre>
|
|
82
|
+
</div>
|
|
83
|
+
<div class="refsect1" lang="en">
|
|
84
|
+
<a name="id2651232"></a><h2>Description</h2>
|
|
85
|
+
<p>
|
|
86
|
+
The font options specify how fonts should be rendered. Most of the time the
|
|
87
|
+
font options implied by a surface are just right and do not need any changes,
|
|
88
|
+
but for pixel-based targets tweaking font options may result in superior
|
|
89
|
+
output on a particular display.
|
|
90
|
+
</p>
|
|
91
|
+
</div>
|
|
92
|
+
<div class="refsect1" lang="en">
|
|
93
|
+
<a name="id2651252"></a><h2>Details</h2>
|
|
94
|
+
<div class="refsect2" lang="en">
|
|
95
|
+
<a name="id2651262"></a><h3>
|
|
96
|
+
<a name="cairo-font-options-t"></a>cairo_font_options_t</h3>
|
|
97
|
+
<a class="indexterm" name="id2651274"></a><pre class="programlisting">typedef struct _cairo_font_options cairo_font_options_t;
|
|
98
|
+
</pre>
|
|
99
|
+
<p>
|
|
100
|
+
An opaque structure holding all options that are used when
|
|
101
|
+
rendering fonts.
|
|
102
|
+
</p>
|
|
103
|
+
<p>
|
|
104
|
+
Individual features of a <a class="link" href="cairo-Font-Options.html#cairo-font-options-t"><span class="type">cairo_font_options_t</span></a> can be set or
|
|
105
|
+
accessed using functions named
|
|
106
|
+
cairo_font_options_set_<span class="emphasis"><em>feature_name</em></span> and
|
|
107
|
+
cairo_font_options_get_<span class="emphasis"><em>feature_name</em></span>, like
|
|
108
|
+
<a class="link" href="cairo-Font-Options.html#cairo-font-options-set-antialias"><code class="function">cairo_font_options_set_antialias()</code></a> and
|
|
109
|
+
<a class="link" href="cairo-Font-Options.html#cairo-font-options-get-antialias"><code class="function">cairo_font_options_get_antialias()</code></a>.
|
|
110
|
+
</p>
|
|
111
|
+
<p>
|
|
112
|
+
New features may be added to a <a class="link" href="cairo-Font-Options.html#cairo-font-options-t"><span class="type">cairo_font_options_t</span></a> in the
|
|
113
|
+
future. For this reason, <a class="link" href="cairo-Font-Options.html#cairo-font-options-copy"><code class="function">cairo_font_options_copy()</code></a>,
|
|
114
|
+
<a class="link" href="cairo-Font-Options.html#cairo-font-options-equal"><code class="function">cairo_font_options_equal()</code></a>, <a class="link" href="cairo-Font-Options.html#cairo-font-options-merge"><code class="function">cairo_font_options_merge()</code></a>, and
|
|
115
|
+
<a class="link" href="cairo-Font-Options.html#cairo-font-options-hash"><code class="function">cairo_font_options_hash()</code></a> should be used to copy, check
|
|
116
|
+
for equality, merge, or compute a hash value of
|
|
117
|
+
<a class="link" href="cairo-Font-Options.html#cairo-font-options-t"><span class="type">cairo_font_options_t</span></a> objects.</p>
|
|
118
|
+
<p>
|
|
119
|
+
|
|
120
|
+
</p>
|
|
121
|
+
</div>
|
|
122
|
+
<hr>
|
|
123
|
+
<div class="refsect2" lang="en">
|
|
124
|
+
<a name="id2651385"></a><h3>
|
|
125
|
+
<a name="cairo-font-options-create"></a>cairo_font_options_create ()</h3>
|
|
126
|
+
<a class="indexterm" name="id2651397"></a><pre class="programlisting"><a class="link" href="cairo-Font-Options.html#cairo-font-options-t">cairo_font_options_t</a>* cairo_font_options_create (void);</pre>
|
|
127
|
+
<p>
|
|
128
|
+
Allocates a new font options object with all options initialized
|
|
129
|
+
to default values.</p>
|
|
130
|
+
<p>
|
|
131
|
+
|
|
132
|
+
</p>
|
|
133
|
+
<div class="variablelist"><table border="0">
|
|
134
|
+
<col align="left" valign="top">
|
|
135
|
+
<tbody><tr>
|
|
136
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
137
|
+
<td> a newly allocated <a class="link" href="cairo-Font-Options.html#cairo-font-options-t"><span class="type">cairo_font_options_t</span></a>. Free with
|
|
138
|
+
<a class="link" href="cairo-Font-Options.html#cairo-font-options-destroy"><code class="function">cairo_font_options_destroy()</code></a>. This function always returns a
|
|
139
|
+
valid pointer; if memory cannot be allocated, then a special
|
|
140
|
+
error object is returned where all operations on the object do nothing.
|
|
141
|
+
You can check for this with <a class="link" href="cairo-Font-Options.html#cairo-font-options-status"><code class="function">cairo_font_options_status()</code></a>.
|
|
142
|
+
</td>
|
|
143
|
+
</tr></tbody>
|
|
144
|
+
</table></div>
|
|
145
|
+
</div>
|
|
146
|
+
<hr>
|
|
147
|
+
<div class="refsect2" lang="en">
|
|
148
|
+
<a name="id2651464"></a><h3>
|
|
149
|
+
<a name="cairo-font-options-copy"></a>cairo_font_options_copy ()</h3>
|
|
150
|
+
<a class="indexterm" name="id2651476"></a><pre class="programlisting"><a class="link" href="cairo-Font-Options.html#cairo-font-options-t">cairo_font_options_t</a>* cairo_font_options_copy (const <a class="link" href="cairo-Font-Options.html#cairo-font-options-t">cairo_font_options_t</a> *original);</pre>
|
|
151
|
+
<p>
|
|
152
|
+
Allocates a new font options object copying the option values from
|
|
153
|
+
<em class="parameter"><code>original</code></em>.</p>
|
|
154
|
+
<p>
|
|
155
|
+
|
|
156
|
+
</p>
|
|
157
|
+
<div class="variablelist"><table border="0">
|
|
158
|
+
<col align="left" valign="top">
|
|
159
|
+
<tbody>
|
|
160
|
+
<tr>
|
|
161
|
+
<td><p><span class="term"><em class="parameter"><code>original</code></em> :</span></p></td>
|
|
162
|
+
<td> a <a class="link" href="cairo-Font-Options.html#cairo-font-options-t"><span class="type">cairo_font_options_t</span></a>
|
|
163
|
+
</td>
|
|
164
|
+
</tr>
|
|
165
|
+
<tr>
|
|
166
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
167
|
+
<td> a newly allocated <a class="link" href="cairo-Font-Options.html#cairo-font-options-t"><span class="type">cairo_font_options_t</span></a>. Free with
|
|
168
|
+
<a class="link" href="cairo-Font-Options.html#cairo-font-options-destroy"><code class="function">cairo_font_options_destroy()</code></a>. This function always returns a
|
|
169
|
+
valid pointer; if memory cannot be allocated, then a special
|
|
170
|
+
error object is returned where all operations on the object do nothing.
|
|
171
|
+
You can check for this with <a class="link" href="cairo-Font-Options.html#cairo-font-options-status"><code class="function">cairo_font_options_status()</code></a>.
|
|
172
|
+
</td>
|
|
173
|
+
</tr>
|
|
174
|
+
</tbody>
|
|
175
|
+
</table></div>
|
|
176
|
+
</div>
|
|
177
|
+
<hr>
|
|
178
|
+
<div class="refsect2" lang="en">
|
|
179
|
+
<a name="id2651576"></a><h3>
|
|
180
|
+
<a name="cairo-font-options-destroy"></a>cairo_font_options_destroy ()</h3>
|
|
181
|
+
<a class="indexterm" name="id2651588"></a><pre class="programlisting">void cairo_font_options_destroy (<a class="link" href="cairo-Font-Options.html#cairo-font-options-t">cairo_font_options_t</a> *options);</pre>
|
|
182
|
+
<p>
|
|
183
|
+
Destroys a <a class="link" href="cairo-Font-Options.html#cairo-font-options-t"><span class="type">cairo_font_options_t</span></a> object created with with
|
|
184
|
+
<a class="link" href="cairo-Font-Options.html#cairo-font-options-create"><code class="function">cairo_font_options_create()</code></a> or <a class="link" href="cairo-Font-Options.html#cairo-font-options-copy"><code class="function">cairo_font_options_copy()</code></a>.</p>
|
|
185
|
+
<p>
|
|
186
|
+
|
|
187
|
+
</p>
|
|
188
|
+
<div class="variablelist"><table border="0">
|
|
189
|
+
<col align="left" valign="top">
|
|
190
|
+
<tbody><tr>
|
|
191
|
+
<td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
|
|
192
|
+
<td> a <a class="link" href="cairo-Font-Options.html#cairo-font-options-t"><span class="type">cairo_font_options_t</span></a>
|
|
193
|
+
</td>
|
|
194
|
+
</tr></tbody>
|
|
195
|
+
</table></div>
|
|
196
|
+
</div>
|
|
197
|
+
<hr>
|
|
198
|
+
<div class="refsect2" lang="en">
|
|
199
|
+
<a name="id2651667"></a><h3>
|
|
200
|
+
<a name="cairo-font-options-status"></a>cairo_font_options_status ()</h3>
|
|
201
|
+
<a class="indexterm" name="id2651679"></a><pre class="programlisting"><a class="link" href="cairo-Error-Handling.html#cairo-status-t">cairo_status_t</a> cairo_font_options_status (<a class="link" href="cairo-Font-Options.html#cairo-font-options-t">cairo_font_options_t</a> *options);</pre>
|
|
202
|
+
<p>
|
|
203
|
+
Checks whether an error has previously occurred for this
|
|
204
|
+
font options object</p>
|
|
205
|
+
<p>
|
|
206
|
+
|
|
207
|
+
</p>
|
|
208
|
+
<div class="variablelist"><table border="0">
|
|
209
|
+
<col align="left" valign="top">
|
|
210
|
+
<tbody>
|
|
211
|
+
<tr>
|
|
212
|
+
<td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
|
|
213
|
+
<td> a <a class="link" href="cairo-Font-Options.html#cairo-font-options-t"><span class="type">cairo_font_options_t</span></a>
|
|
214
|
+
</td>
|
|
215
|
+
</tr>
|
|
216
|
+
<tr>
|
|
217
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
218
|
+
<td> <a class="link" href="cairo-Error-Handling.html#CAIRO-STATUS-SUCCESS:CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> or <a class="link" href="cairo-Error-Handling.html#CAIRO-STATUS-NO-MEMORY:CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a>
|
|
219
|
+
</td>
|
|
220
|
+
</tr>
|
|
221
|
+
</tbody>
|
|
222
|
+
</table></div>
|
|
223
|
+
</div>
|
|
224
|
+
<hr>
|
|
225
|
+
<div class="refsect2" lang="en">
|
|
226
|
+
<a name="id2651764"></a><h3>
|
|
227
|
+
<a name="cairo-font-options-merge"></a>cairo_font_options_merge ()</h3>
|
|
228
|
+
<a class="indexterm" name="id2654570"></a><pre class="programlisting">void cairo_font_options_merge (<a class="link" href="cairo-Font-Options.html#cairo-font-options-t">cairo_font_options_t</a> *options,
|
|
229
|
+
const <a class="link" href="cairo-Font-Options.html#cairo-font-options-t">cairo_font_options_t</a> *other);</pre>
|
|
230
|
+
<p>
|
|
231
|
+
Merges non-default options from <em class="parameter"><code>other</code></em> into <em class="parameter"><code>options</code></em>, replacing
|
|
232
|
+
existing values. This operation can be thought of as somewhat
|
|
233
|
+
similar to compositing <em class="parameter"><code>other</code></em> onto <em class="parameter"><code>options</code></em> with the operation
|
|
234
|
+
of <code class="literal">CAIRO_OPERATION_OVER</code>.</p>
|
|
235
|
+
<p>
|
|
236
|
+
|
|
237
|
+
</p>
|
|
238
|
+
<div class="variablelist"><table border="0">
|
|
239
|
+
<col align="left" valign="top">
|
|
240
|
+
<tbody>
|
|
241
|
+
<tr>
|
|
242
|
+
<td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
|
|
243
|
+
<td> a <a class="link" href="cairo-Font-Options.html#cairo-font-options-t"><span class="type">cairo_font_options_t</span></a>
|
|
244
|
+
</td>
|
|
245
|
+
</tr>
|
|
246
|
+
<tr>
|
|
247
|
+
<td><p><span class="term"><em class="parameter"><code>other</code></em> :</span></p></td>
|
|
248
|
+
<td> another <a class="link" href="cairo-Font-Options.html#cairo-font-options-t"><span class="type">cairo_font_options_t</span></a>
|
|
249
|
+
</td>
|
|
250
|
+
</tr>
|
|
251
|
+
</tbody>
|
|
252
|
+
</table></div>
|
|
253
|
+
</div>
|
|
254
|
+
<hr>
|
|
255
|
+
<div class="refsect2" lang="en">
|
|
256
|
+
<a name="id2654676"></a><h3>
|
|
257
|
+
<a name="cairo-font-options-hash"></a>cairo_font_options_hash ()</h3>
|
|
258
|
+
<a class="indexterm" name="id2654687"></a><pre class="programlisting">unsigned long cairo_font_options_hash (const <a class="link" href="cairo-Font-Options.html#cairo-font-options-t">cairo_font_options_t</a> *options);</pre>
|
|
259
|
+
<p>
|
|
260
|
+
Compute a hash for the font options object; this value will
|
|
261
|
+
be useful when storing an object containing a <a class="link" href="cairo-Font-Options.html#cairo-font-options-t"><span class="type">cairo_font_options_t</span></a>
|
|
262
|
+
in a hash table.</p>
|
|
263
|
+
<p>
|
|
264
|
+
|
|
265
|
+
</p>
|
|
266
|
+
<div class="variablelist"><table border="0">
|
|
267
|
+
<col align="left" valign="top">
|
|
268
|
+
<tbody>
|
|
269
|
+
<tr>
|
|
270
|
+
<td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
|
|
271
|
+
<td> a <a class="link" href="cairo-Font-Options.html#cairo-font-options-t"><span class="type">cairo_font_options_t</span></a>
|
|
272
|
+
</td>
|
|
273
|
+
</tr>
|
|
274
|
+
<tr>
|
|
275
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
276
|
+
<td> the hash value for the font options object.
|
|
277
|
+
The return value can be cast to a 32-bit type if a
|
|
278
|
+
32-bit hash value is needed.
|
|
279
|
+
</td>
|
|
280
|
+
</tr>
|
|
281
|
+
</tbody>
|
|
282
|
+
</table></div>
|
|
283
|
+
</div>
|
|
284
|
+
<hr>
|
|
285
|
+
<div class="refsect2" lang="en">
|
|
286
|
+
<a name="id2654759"></a><h3>
|
|
287
|
+
<a name="cairo-font-options-equal"></a>cairo_font_options_equal ()</h3>
|
|
288
|
+
<a class="indexterm" name="id2654770"></a><pre class="programlisting"><a class="link" href="cairo-Types.html#cairo-bool-t">cairo_bool_t</a> cairo_font_options_equal (const <a class="link" href="cairo-Font-Options.html#cairo-font-options-t">cairo_font_options_t</a> *options,
|
|
289
|
+
const <a class="link" href="cairo-Font-Options.html#cairo-font-options-t">cairo_font_options_t</a> *other);</pre>
|
|
290
|
+
<p>
|
|
291
|
+
Compares two font options objects for equality.</p>
|
|
292
|
+
<p>
|
|
293
|
+
|
|
294
|
+
</p>
|
|
295
|
+
<div class="variablelist"><table border="0">
|
|
296
|
+
<col align="left" valign="top">
|
|
297
|
+
<tbody>
|
|
298
|
+
<tr>
|
|
299
|
+
<td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
|
|
300
|
+
<td> a <a class="link" href="cairo-Font-Options.html#cairo-font-options-t"><span class="type">cairo_font_options_t</span></a>
|
|
301
|
+
</td>
|
|
302
|
+
</tr>
|
|
303
|
+
<tr>
|
|
304
|
+
<td><p><span class="term"><em class="parameter"><code>other</code></em> :</span></p></td>
|
|
305
|
+
<td> another <a class="link" href="cairo-Font-Options.html#cairo-font-options-t"><span class="type">cairo_font_options_t</span></a>
|
|
306
|
+
</td>
|
|
307
|
+
</tr>
|
|
308
|
+
<tr>
|
|
309
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
310
|
+
<td> <code class="literal">TRUE</code> if all fields of the two font options objects match.
|
|
311
|
+
Note that this function will return <code class="literal">FALSE</code> if either object is in
|
|
312
|
+
error.
|
|
313
|
+
</td>
|
|
314
|
+
</tr>
|
|
315
|
+
</tbody>
|
|
316
|
+
</table></div>
|
|
317
|
+
</div>
|
|
318
|
+
<hr>
|
|
319
|
+
<div class="refsect2" lang="en">
|
|
320
|
+
<a name="id2654885"></a><h3>
|
|
321
|
+
<a name="cairo-font-options-set-antialias"></a>cairo_font_options_set_antialias ()</h3>
|
|
322
|
+
<a class="indexterm" name="id2654898"></a><pre class="programlisting">void cairo_font_options_set_antialias (<a class="link" href="cairo-Font-Options.html#cairo-font-options-t">cairo_font_options_t</a> *options,
|
|
323
|
+
<a class="link" href="cairo-cairo-t.html#cairo-antialias-t">cairo_antialias_t</a> antialias);</pre>
|
|
324
|
+
<p>
|
|
325
|
+
Sets the antialiasing mode for the font options object. This
|
|
326
|
+
specifies the type of antialiasing to do when rendering text.</p>
|
|
327
|
+
<p>
|
|
328
|
+
|
|
329
|
+
</p>
|
|
330
|
+
<div class="variablelist"><table border="0">
|
|
331
|
+
<col align="left" valign="top">
|
|
332
|
+
<tbody>
|
|
333
|
+
<tr>
|
|
334
|
+
<td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
|
|
335
|
+
<td> a <a class="link" href="cairo-Font-Options.html#cairo-font-options-t"><span class="type">cairo_font_options_t</span></a>
|
|
336
|
+
</td>
|
|
337
|
+
</tr>
|
|
338
|
+
<tr>
|
|
339
|
+
<td><p><span class="term"><em class="parameter"><code>antialias</code></em> :</span></p></td>
|
|
340
|
+
<td> the new antialiasing mode
|
|
341
|
+
</td>
|
|
342
|
+
</tr>
|
|
343
|
+
</tbody>
|
|
344
|
+
</table></div>
|
|
345
|
+
</div>
|
|
346
|
+
<hr>
|
|
347
|
+
<div class="refsect2" lang="en">
|
|
348
|
+
<a name="id2654977"></a><h3>
|
|
349
|
+
<a name="cairo-font-options-get-antialias"></a>cairo_font_options_get_antialias ()</h3>
|
|
350
|
+
<a class="indexterm" name="id2654991"></a><pre class="programlisting"><a class="link" href="cairo-cairo-t.html#cairo-antialias-t">cairo_antialias_t</a> cairo_font_options_get_antialias (const <a class="link" href="cairo-Font-Options.html#cairo-font-options-t">cairo_font_options_t</a> *options);</pre>
|
|
351
|
+
<p>
|
|
352
|
+
Gets the antialiasing mode for the font options object.</p>
|
|
353
|
+
<p>
|
|
354
|
+
|
|
355
|
+
</p>
|
|
356
|
+
<div class="variablelist"><table border="0">
|
|
357
|
+
<col align="left" valign="top">
|
|
358
|
+
<tbody>
|
|
359
|
+
<tr>
|
|
360
|
+
<td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
|
|
361
|
+
<td> a <a class="link" href="cairo-Font-Options.html#cairo-font-options-t"><span class="type">cairo_font_options_t</span></a>
|
|
362
|
+
</td>
|
|
363
|
+
</tr>
|
|
364
|
+
<tr>
|
|
365
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
366
|
+
<td> the antialiasing mode
|
|
367
|
+
</td>
|
|
368
|
+
</tr>
|
|
369
|
+
</tbody>
|
|
370
|
+
</table></div>
|
|
371
|
+
</div>
|
|
372
|
+
<hr>
|
|
373
|
+
<div class="refsect2" lang="en">
|
|
374
|
+
<a name="id2655058"></a><h3>
|
|
375
|
+
<a name="cairo-subpixel-order-t"></a>enum cairo_subpixel_order_t</h3>
|
|
376
|
+
<a class="indexterm" name="id2655069"></a><pre class="programlisting">typedef enum _cairo_subpixel_order {
|
|
377
|
+
CAIRO_SUBPIXEL_ORDER_DEFAULT,
|
|
378
|
+
CAIRO_SUBPIXEL_ORDER_RGB,
|
|
379
|
+
CAIRO_SUBPIXEL_ORDER_BGR,
|
|
380
|
+
CAIRO_SUBPIXEL_ORDER_VRGB,
|
|
381
|
+
CAIRO_SUBPIXEL_ORDER_VBGR
|
|
382
|
+
} cairo_subpixel_order_t;
|
|
383
|
+
</pre>
|
|
384
|
+
<p>
|
|
385
|
+
The subpixel order specifies the order of color elements within
|
|
386
|
+
each pixel on the display device when rendering with an
|
|
387
|
+
antialiasing mode of <a class="link" href="cairo-cairo-t.html#CAIRO-ANTIALIAS-SUBPIXEL:CAPS"><code class="literal">CAIRO_ANTIALIAS_SUBPIXEL</code></a>.</p>
|
|
388
|
+
<p>
|
|
389
|
+
|
|
390
|
+
</p>
|
|
391
|
+
<div class="variablelist"><table border="0">
|
|
392
|
+
<col align="left" valign="top">
|
|
393
|
+
<tbody>
|
|
394
|
+
<tr>
|
|
395
|
+
<td><p><span class="term"><a name="CAIRO-SUBPIXEL-ORDER-DEFAULT:CAPS"></a><code class="literal">CAIRO_SUBPIXEL_ORDER_DEFAULT</code></span></p></td>
|
|
396
|
+
<td> Use the default subpixel order for
|
|
397
|
+
for the target device
|
|
398
|
+
</td>
|
|
399
|
+
</tr>
|
|
400
|
+
<tr>
|
|
401
|
+
<td><p><span class="term"><a name="CAIRO-SUBPIXEL-ORDER-RGB:CAPS"></a><code class="literal">CAIRO_SUBPIXEL_ORDER_RGB</code></span></p></td>
|
|
402
|
+
<td> Subpixel elements are arranged horizontally
|
|
403
|
+
with red at the left
|
|
404
|
+
</td>
|
|
405
|
+
</tr>
|
|
406
|
+
<tr>
|
|
407
|
+
<td><p><span class="term"><a name="CAIRO-SUBPIXEL-ORDER-BGR:CAPS"></a><code class="literal">CAIRO_SUBPIXEL_ORDER_BGR</code></span></p></td>
|
|
408
|
+
<td> Subpixel elements are arranged horizontally
|
|
409
|
+
with blue at the left
|
|
410
|
+
</td>
|
|
411
|
+
</tr>
|
|
412
|
+
<tr>
|
|
413
|
+
<td><p><span class="term"><a name="CAIRO-SUBPIXEL-ORDER-VRGB:CAPS"></a><code class="literal">CAIRO_SUBPIXEL_ORDER_VRGB</code></span></p></td>
|
|
414
|
+
<td> Subpixel elements are arranged vertically
|
|
415
|
+
with red at the top
|
|
416
|
+
</td>
|
|
417
|
+
</tr>
|
|
418
|
+
<tr>
|
|
419
|
+
<td><p><span class="term"><a name="CAIRO-SUBPIXEL-ORDER-VBGR:CAPS"></a><code class="literal">CAIRO_SUBPIXEL_ORDER_VBGR</code></span></p></td>
|
|
420
|
+
<td> Subpixel elements are arranged vertically
|
|
421
|
+
with blue at the top
|
|
422
|
+
</td>
|
|
423
|
+
</tr>
|
|
424
|
+
</tbody>
|
|
425
|
+
</table></div>
|
|
426
|
+
</div>
|
|
427
|
+
<hr>
|
|
428
|
+
<div class="refsect2" lang="en">
|
|
429
|
+
<a name="id2655224"></a><h3>
|
|
430
|
+
<a name="cairo-font-options-set-subpixel-order"></a>cairo_font_options_set_subpixel_order ()</h3>
|
|
431
|
+
<a class="indexterm" name="id2655238"></a><pre class="programlisting">void cairo_font_options_set_subpixel_order
|
|
432
|
+
(<a class="link" href="cairo-Font-Options.html#cairo-font-options-t">cairo_font_options_t</a> *options,
|
|
433
|
+
<a class="link" href="cairo-Font-Options.html#cairo-subpixel-order-t">cairo_subpixel_order_t</a> subpixel_order);</pre>
|
|
434
|
+
<p>
|
|
435
|
+
Sets the subpixel order for the font options object. The subpixel
|
|
436
|
+
order specifies the order of color elements within each pixel on
|
|
437
|
+
the display device when rendering with an antialiasing mode of
|
|
438
|
+
<a class="link" href="cairo-cairo-t.html#CAIRO-ANTIALIAS-SUBPIXEL:CAPS"><code class="literal">CAIRO_ANTIALIAS_SUBPIXEL</code></a>. See the documentation for
|
|
439
|
+
<a class="link" href="cairo-Font-Options.html#cairo-subpixel-order-t"><span class="type">cairo_subpixel_order_t</span></a> for full details.</p>
|
|
440
|
+
<p>
|
|
441
|
+
|
|
442
|
+
</p>
|
|
443
|
+
<div class="variablelist"><table border="0">
|
|
444
|
+
<col align="left" valign="top">
|
|
445
|
+
<tbody>
|
|
446
|
+
<tr>
|
|
447
|
+
<td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
|
|
448
|
+
<td> a <a class="link" href="cairo-Font-Options.html#cairo-font-options-t"><span class="type">cairo_font_options_t</span></a>
|
|
449
|
+
</td>
|
|
450
|
+
</tr>
|
|
451
|
+
<tr>
|
|
452
|
+
<td><p><span class="term"><em class="parameter"><code>subpixel_order</code></em> :</span></p></td>
|
|
453
|
+
<td> the new subpixel order
|
|
454
|
+
</td>
|
|
455
|
+
</tr>
|
|
456
|
+
</tbody>
|
|
457
|
+
</table></div>
|
|
458
|
+
</div>
|
|
459
|
+
<hr>
|
|
460
|
+
<div class="refsect2" lang="en">
|
|
461
|
+
<a name="id2655335"></a><h3>
|
|
462
|
+
<a name="cairo-font-options-get-subpixel-order"></a>cairo_font_options_get_subpixel_order ()</h3>
|
|
463
|
+
<a class="indexterm" name="id2655349"></a><pre class="programlisting"><a class="link" href="cairo-Font-Options.html#cairo-subpixel-order-t">cairo_subpixel_order_t</a> cairo_font_options_get_subpixel_order
|
|
464
|
+
(const <a class="link" href="cairo-Font-Options.html#cairo-font-options-t">cairo_font_options_t</a> *options);</pre>
|
|
465
|
+
<p>
|
|
466
|
+
Gets the subpixel order for the font options object.
|
|
467
|
+
See the documentation for <a class="link" href="cairo-Font-Options.html#cairo-subpixel-order-t"><span class="type">cairo_subpixel_order_t</span></a> for full details.</p>
|
|
468
|
+
<p>
|
|
469
|
+
|
|
470
|
+
</p>
|
|
471
|
+
<div class="variablelist"><table border="0">
|
|
472
|
+
<col align="left" valign="top">
|
|
473
|
+
<tbody>
|
|
474
|
+
<tr>
|
|
475
|
+
<td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
|
|
476
|
+
<td> a <a class="link" href="cairo-Font-Options.html#cairo-font-options-t"><span class="type">cairo_font_options_t</span></a>
|
|
477
|
+
</td>
|
|
478
|
+
</tr>
|
|
479
|
+
<tr>
|
|
480
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
481
|
+
<td> the subpixel order for the font options object
|
|
482
|
+
</td>
|
|
483
|
+
</tr>
|
|
484
|
+
</tbody>
|
|
485
|
+
</table></div>
|
|
486
|
+
</div>
|
|
487
|
+
<hr>
|
|
488
|
+
<div class="refsect2" lang="en">
|
|
489
|
+
<a name="id2655424"></a><h3>
|
|
490
|
+
<a name="cairo-hint-style-t"></a>enum cairo_hint_style_t</h3>
|
|
491
|
+
<a class="indexterm" name="id2623835"></a><pre class="programlisting">typedef enum _cairo_hint_style {
|
|
492
|
+
CAIRO_HINT_STYLE_DEFAULT,
|
|
493
|
+
CAIRO_HINT_STYLE_NONE,
|
|
494
|
+
CAIRO_HINT_STYLE_SLIGHT,
|
|
495
|
+
CAIRO_HINT_STYLE_MEDIUM,
|
|
496
|
+
CAIRO_HINT_STYLE_FULL
|
|
497
|
+
} cairo_hint_style_t;
|
|
498
|
+
</pre>
|
|
499
|
+
<p>
|
|
500
|
+
Specifies the type of hinting to do on font outlines. Hinting
|
|
501
|
+
is the process of fitting outlines to the pixel grid in order
|
|
502
|
+
to improve the appearance of the result. Since hinting outlines
|
|
503
|
+
involves distorting them, it also reduces the faithfulness
|
|
504
|
+
to the original outline shapes. Not all of the outline hinting
|
|
505
|
+
styles are supported by all font backends.
|
|
506
|
+
</p>
|
|
507
|
+
<p>
|
|
508
|
+
New entries may be added in future versions.</p>
|
|
509
|
+
<p>
|
|
510
|
+
|
|
511
|
+
</p>
|
|
512
|
+
<div class="variablelist"><table border="0">
|
|
513
|
+
<col align="left" valign="top">
|
|
514
|
+
<tbody>
|
|
515
|
+
<tr>
|
|
516
|
+
<td><p><span class="term"><a name="CAIRO-HINT-STYLE-DEFAULT:CAPS"></a><code class="literal">CAIRO_HINT_STYLE_DEFAULT</code></span></p></td>
|
|
517
|
+
<td> Use the default hint style for
|
|
518
|
+
font backend and target device
|
|
519
|
+
</td>
|
|
520
|
+
</tr>
|
|
521
|
+
<tr>
|
|
522
|
+
<td><p><span class="term"><a name="CAIRO-HINT-STYLE-NONE:CAPS"></a><code class="literal">CAIRO_HINT_STYLE_NONE</code></span></p></td>
|
|
523
|
+
<td> Do not hint outlines
|
|
524
|
+
</td>
|
|
525
|
+
</tr>
|
|
526
|
+
<tr>
|
|
527
|
+
<td><p><span class="term"><a name="CAIRO-HINT-STYLE-SLIGHT:CAPS"></a><code class="literal">CAIRO_HINT_STYLE_SLIGHT</code></span></p></td>
|
|
528
|
+
<td> Hint outlines slightly to improve
|
|
529
|
+
contrast while retaining good fidelity to the original
|
|
530
|
+
shapes.
|
|
531
|
+
</td>
|
|
532
|
+
</tr>
|
|
533
|
+
<tr>
|
|
534
|
+
<td><p><span class="term"><a name="CAIRO-HINT-STYLE-MEDIUM:CAPS"></a><code class="literal">CAIRO_HINT_STYLE_MEDIUM</code></span></p></td>
|
|
535
|
+
<td> Hint outlines with medium strength
|
|
536
|
+
giving a compromise between fidelity to the original shapes
|
|
537
|
+
and contrast
|
|
538
|
+
</td>
|
|
539
|
+
</tr>
|
|
540
|
+
<tr>
|
|
541
|
+
<td><p><span class="term"><a name="CAIRO-HINT-STYLE-FULL:CAPS"></a><code class="literal">CAIRO_HINT_STYLE_FULL</code></span></p></td>
|
|
542
|
+
<td> Hint outlines to maximize contrast
|
|
543
|
+
</td>
|
|
544
|
+
</tr>
|
|
545
|
+
</tbody>
|
|
546
|
+
</table></div>
|
|
547
|
+
</div>
|
|
548
|
+
<hr>
|
|
549
|
+
<div class="refsect2" lang="en">
|
|
550
|
+
<a name="id2655565"></a><h3>
|
|
551
|
+
<a name="cairo-font-options-set-hint-style"></a>cairo_font_options_set_hint_style ()</h3>
|
|
552
|
+
<a class="indexterm" name="id2655578"></a><pre class="programlisting">void cairo_font_options_set_hint_style (<a class="link" href="cairo-Font-Options.html#cairo-font-options-t">cairo_font_options_t</a> *options,
|
|
553
|
+
<a class="link" href="cairo-Font-Options.html#cairo-hint-style-t">cairo_hint_style_t</a> hint_style);</pre>
|
|
554
|
+
<p>
|
|
555
|
+
Sets the hint style for font outlines for the font options object.
|
|
556
|
+
This controls whether to fit font outlines to the pixel grid,
|
|
557
|
+
and if so, whether to optimize for fidelity or contrast.
|
|
558
|
+
See the documentation for <a class="link" href="cairo-Font-Options.html#cairo-hint-style-t"><span class="type">cairo_hint_style_t</span></a> for full details.</p>
|
|
559
|
+
<p>
|
|
560
|
+
|
|
561
|
+
</p>
|
|
562
|
+
<div class="variablelist"><table border="0">
|
|
563
|
+
<col align="left" valign="top">
|
|
564
|
+
<tbody>
|
|
565
|
+
<tr>
|
|
566
|
+
<td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
|
|
567
|
+
<td> a <a class="link" href="cairo-Font-Options.html#cairo-font-options-t"><span class="type">cairo_font_options_t</span></a>
|
|
568
|
+
</td>
|
|
569
|
+
</tr>
|
|
570
|
+
<tr>
|
|
571
|
+
<td><p><span class="term"><em class="parameter"><code>hint_style</code></em> :</span></p></td>
|
|
572
|
+
<td> the new hint style
|
|
573
|
+
</td>
|
|
574
|
+
</tr>
|
|
575
|
+
</tbody>
|
|
576
|
+
</table></div>
|
|
577
|
+
</div>
|
|
578
|
+
<hr>
|
|
579
|
+
<div class="refsect2" lang="en">
|
|
580
|
+
<a name="id2655657"></a><h3>
|
|
581
|
+
<a name="cairo-font-options-get-hint-style"></a>cairo_font_options_get_hint_style ()</h3>
|
|
582
|
+
<a class="indexterm" name="id2655670"></a><pre class="programlisting"><a class="link" href="cairo-Font-Options.html#cairo-hint-style-t">cairo_hint_style_t</a> cairo_font_options_get_hint_style (const <a class="link" href="cairo-Font-Options.html#cairo-font-options-t">cairo_font_options_t</a> *options);</pre>
|
|
583
|
+
<p>
|
|
584
|
+
Gets the hint style for font outlines for the font options object.
|
|
585
|
+
See the documentation for <a class="link" href="cairo-Font-Options.html#cairo-hint-style-t"><span class="type">cairo_hint_style_t</span></a> for full details.</p>
|
|
586
|
+
<p>
|
|
587
|
+
|
|
588
|
+
</p>
|
|
589
|
+
<div class="variablelist"><table border="0">
|
|
590
|
+
<col align="left" valign="top">
|
|
591
|
+
<tbody>
|
|
592
|
+
<tr>
|
|
593
|
+
<td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
|
|
594
|
+
<td> a <a class="link" href="cairo-Font-Options.html#cairo-font-options-t"><span class="type">cairo_font_options_t</span></a>
|
|
595
|
+
</td>
|
|
596
|
+
</tr>
|
|
597
|
+
<tr>
|
|
598
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
599
|
+
<td> the hint style for the font options object
|
|
600
|
+
</td>
|
|
601
|
+
</tr>
|
|
602
|
+
</tbody>
|
|
603
|
+
</table></div>
|
|
604
|
+
</div>
|
|
605
|
+
<hr>
|
|
606
|
+
<div class="refsect2" lang="en">
|
|
607
|
+
<a name="id2655739"></a><h3>
|
|
608
|
+
<a name="cairo-hint-metrics-t"></a>enum cairo_hint_metrics_t</h3>
|
|
609
|
+
<a class="indexterm" name="id2655749"></a><pre class="programlisting">typedef enum _cairo_hint_metrics {
|
|
610
|
+
CAIRO_HINT_METRICS_DEFAULT,
|
|
611
|
+
CAIRO_HINT_METRICS_OFF,
|
|
612
|
+
CAIRO_HINT_METRICS_ON
|
|
613
|
+
} cairo_hint_metrics_t;
|
|
614
|
+
</pre>
|
|
615
|
+
<p>
|
|
616
|
+
Specifies whether to hint font metrics; hinting font metrics
|
|
617
|
+
means quantizing them so that they are integer values in
|
|
618
|
+
device space. Doing this improves the consistency of
|
|
619
|
+
letter and line spacing, however it also means that text
|
|
620
|
+
will be laid out differently at different zoom factors.</p>
|
|
621
|
+
<p>
|
|
622
|
+
|
|
623
|
+
</p>
|
|
624
|
+
<div class="variablelist"><table border="0">
|
|
625
|
+
<col align="left" valign="top">
|
|
626
|
+
<tbody>
|
|
627
|
+
<tr>
|
|
628
|
+
<td><p><span class="term"><a name="CAIRO-HINT-METRICS-DEFAULT:CAPS"></a><code class="literal">CAIRO_HINT_METRICS_DEFAULT</code></span></p></td>
|
|
629
|
+
<td> Hint metrics in the default
|
|
630
|
+
manner for the font backend and target device
|
|
631
|
+
</td>
|
|
632
|
+
</tr>
|
|
633
|
+
<tr>
|
|
634
|
+
<td><p><span class="term"><a name="CAIRO-HINT-METRICS-OFF:CAPS"></a><code class="literal">CAIRO_HINT_METRICS_OFF</code></span></p></td>
|
|
635
|
+
<td> Do not hint font metrics
|
|
636
|
+
</td>
|
|
637
|
+
</tr>
|
|
638
|
+
<tr>
|
|
639
|
+
<td><p><span class="term"><a name="CAIRO-HINT-METRICS-ON:CAPS"></a><code class="literal">CAIRO_HINT_METRICS_ON</code></span></p></td>
|
|
640
|
+
<td> Hint font metrics
|
|
641
|
+
</td>
|
|
642
|
+
</tr>
|
|
643
|
+
</tbody>
|
|
644
|
+
</table></div>
|
|
645
|
+
</div>
|
|
646
|
+
<hr>
|
|
647
|
+
<div class="refsect2" lang="en">
|
|
648
|
+
<a name="id2655838"></a><h3>
|
|
649
|
+
<a name="cairo-font-options-set-hint-metrics"></a>cairo_font_options_set_hint_metrics ()</h3>
|
|
650
|
+
<a class="indexterm" name="id2655850"></a><pre class="programlisting">void cairo_font_options_set_hint_metrics (<a class="link" href="cairo-Font-Options.html#cairo-font-options-t">cairo_font_options_t</a> *options,
|
|
651
|
+
<a class="link" href="cairo-Font-Options.html#cairo-hint-metrics-t">cairo_hint_metrics_t</a> hint_metrics);</pre>
|
|
652
|
+
<p>
|
|
653
|
+
Sets the metrics hinting mode for the font options object. This
|
|
654
|
+
controls whether metrics are quantized to integer values in
|
|
655
|
+
device units.
|
|
656
|
+
See the documentation for <a class="link" href="cairo-Font-Options.html#cairo-hint-metrics-t"><span class="type">cairo_hint_metrics_t</span></a> for full details.</p>
|
|
657
|
+
<p>
|
|
658
|
+
|
|
659
|
+
</p>
|
|
660
|
+
<div class="variablelist"><table border="0">
|
|
661
|
+
<col align="left" valign="top">
|
|
662
|
+
<tbody>
|
|
663
|
+
<tr>
|
|
664
|
+
<td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
|
|
665
|
+
<td> a <a class="link" href="cairo-Font-Options.html#cairo-font-options-t"><span class="type">cairo_font_options_t</span></a>
|
|
666
|
+
</td>
|
|
667
|
+
</tr>
|
|
668
|
+
<tr>
|
|
669
|
+
<td><p><span class="term"><em class="parameter"><code>hint_metrics</code></em> :</span></p></td>
|
|
670
|
+
<td> the new metrics hinting mode
|
|
671
|
+
</td>
|
|
672
|
+
</tr>
|
|
673
|
+
</tbody>
|
|
674
|
+
</table></div>
|
|
675
|
+
</div>
|
|
676
|
+
<hr>
|
|
677
|
+
<div class="refsect2" lang="en">
|
|
678
|
+
<a name="id2655930"></a><h3>
|
|
679
|
+
<a name="cairo-font-options-get-hint-metrics"></a>cairo_font_options_get_hint_metrics ()</h3>
|
|
680
|
+
<a class="indexterm" name="id2655943"></a><pre class="programlisting"><a class="link" href="cairo-Font-Options.html#cairo-hint-metrics-t">cairo_hint_metrics_t</a> cairo_font_options_get_hint_metrics
|
|
681
|
+
(const <a class="link" href="cairo-Font-Options.html#cairo-font-options-t">cairo_font_options_t</a> *options);</pre>
|
|
682
|
+
<p>
|
|
683
|
+
Gets the metrics hinting mode for the font options object.
|
|
684
|
+
See the documentation for <a class="link" href="cairo-Font-Options.html#cairo-hint-metrics-t"><span class="type">cairo_hint_metrics_t</span></a> for full details.</p>
|
|
685
|
+
<p>
|
|
686
|
+
|
|
687
|
+
</p>
|
|
688
|
+
<div class="variablelist"><table border="0">
|
|
689
|
+
<col align="left" valign="top">
|
|
690
|
+
<tbody>
|
|
691
|
+
<tr>
|
|
692
|
+
<td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
|
|
693
|
+
<td> a <a class="link" href="cairo-Font-Options.html#cairo-font-options-t"><span class="type">cairo_font_options_t</span></a>
|
|
694
|
+
</td>
|
|
695
|
+
</tr>
|
|
696
|
+
<tr>
|
|
697
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
698
|
+
<td> the metrics hinting mode for the font options object
|
|
699
|
+
</td>
|
|
700
|
+
</tr>
|
|
701
|
+
</tbody>
|
|
702
|
+
</table></div>
|
|
703
|
+
</div>
|
|
704
|
+
</div>
|
|
705
|
+
<div class="refsect1" lang="en">
|
|
706
|
+
<a name="id2656013"></a><h2>See Also</h2>
|
|
707
|
+
<p>
|
|
708
|
+
</p>
|
|
709
|
+
<div class="itemizedlist"><ul type="disc"><li><a class="link" href="cairo-Scaled-Fonts.html#cairo-scaled-font-t"><span class="type">cairo_scaled_font_t</span></a></li></ul></div>
|
|
710
|
+
<p>
|
|
711
|
+
</p>
|
|
712
|
+
</div>
|
|
713
|
+
<div class="refsect1" lang="en">
|
|
714
|
+
<a name="id2656034"></a><div class="refsect2" lang="en"><a name="id2656035"></a></div>
|
|
715
|
+
<hr>
|
|
716
|
+
<div class="refsect2" lang="en"><a name="id2656036"></a></div>
|
|
717
|
+
</div>
|
|
718
|
+
</div>
|
|
719
|
+
</body>
|
|
720
|
+
</html>
|