cairo 1.14.1-x86-mingw32 → 1.14.2-x86-mingw32
Sign up to get free protection for your applications and to get access to all the features.
Potentially problematic release.
This version of cairo might be problematic. Click here for more details.
- checksums.yaml +4 -4
- data/NEWS +21 -0
- data/Rakefile +18 -7
- data/ext/cairo/cairo.def +1 -0
- data/ext/cairo/extconf.rb +23 -10
- data/ext/cairo/rb_cairo.c +3 -0
- data/ext/cairo/rb_cairo.h +3 -3
- data/ext/cairo/rb_cairo_context.c +1 -1
- data/ext/cairo/rb_cairo_io.c +4 -0
- data/ext/cairo/rb_cairo_io.h +2 -0
- data/ext/cairo/rb_cairo_pattern.c +4 -4
- data/ext/cairo/rb_cairo_private.h +2 -0
- data/ext/cairo/rb_cairo_surface.c +64 -232
- data/lib/2.0/cairo.so +0 -0
- data/lib/2.1/cairo.so +0 -0
- data/lib/2.2/cairo.so +0 -0
- data/lib/cairo.rb +20 -19
- data/lib/cairo/region.rb +14 -0
- data/test/test_region.rb +26 -0
- data/vendor/local/bin/fc-cache.exe +0 -0
- data/vendor/local/bin/fc-cat.exe +0 -0
- data/vendor/local/bin/fc-list.exe +0 -0
- data/vendor/local/bin/fc-match.exe +0 -0
- data/vendor/local/bin/fc-pattern.exe +0 -0
- data/vendor/local/bin/fc-query.exe +0 -0
- data/vendor/local/bin/fc-scan.exe +0 -0
- data/vendor/local/bin/fc-validate.exe +0 -0
- data/vendor/local/bin/freetype-config +2 -2
- data/vendor/local/bin/libcairo-2.dll +0 -0
- data/vendor/local/bin/libcairo-gobject-2.dll +0 -0
- data/vendor/local/bin/libcairo-script-interpreter-2.dll +0 -0
- data/vendor/local/bin/libfontconfig-1.dll +0 -0
- data/vendor/local/bin/libfreetype-6.dll +0 -0
- data/vendor/local/bin/libgcc_s_sjlj-1.dll +0 -0
- data/vendor/local/bin/libpixman-1-0.dll +0 -0
- data/vendor/local/bin/libpng-config +1 -1
- data/vendor/local/bin/libpng16-16.dll +0 -0
- data/vendor/local/bin/libpng16-config +1 -1
- data/vendor/local/bin/libstdc++-6.dll +0 -0
- data/vendor/local/bin/libwinpthread-1.dll +0 -0
- data/vendor/local/bin/libxml2-2.dll +0 -0
- data/vendor/local/bin/png-fix-itxt.exe +0 -0
- data/vendor/local/bin/pngfix.exe +0 -0
- data/vendor/local/bin/xmlcatalog.exe +0 -0
- data/vendor/local/bin/xmllint.exe +0 -0
- data/vendor/local/bin/zlib1.dll +0 -0
- data/vendor/local/include/cairo/cairo-version.h +1 -1
- data/vendor/local/include/freetype2/config/ftconfig.h +19 -2
- data/vendor/local/include/freetype2/config/ftheader.h +7 -5
- data/vendor/local/include/freetype2/config/ftoption.h +9 -22
- data/vendor/local/include/freetype2/config/ftstdlib.h +2 -3
- data/vendor/local/include/freetype2/freetype.h +38 -17
- data/vendor/local/include/freetype2/ft2build.h +1 -1
- data/vendor/local/include/freetype2/ftadvanc.h +2 -2
- data/vendor/local/include/freetype2/ftautoh.h +50 -2
- data/vendor/local/include/freetype2/ftbbox.h +1 -1
- data/vendor/local/include/freetype2/ftbdf.h +1 -1
- data/vendor/local/include/freetype2/ftbitmap.h +11 -3
- data/vendor/local/include/freetype2/ftbzip2.h +1 -1
- data/vendor/local/include/freetype2/ftcache.h +3 -3
- data/vendor/local/include/freetype2/ftcffdrv.h +1 -1
- data/vendor/local/include/freetype2/ftcid.h +2 -1
- data/vendor/local/include/freetype2/fterrdef.h +1 -1
- data/vendor/local/include/freetype2/fterrors.h +1 -1
- data/vendor/local/include/freetype2/{ftxf86.h → ftfntfmt.h} +22 -14
- data/vendor/local/include/freetype2/ftgasp.h +1 -1
- data/vendor/local/include/freetype2/ftglyph.h +1 -1
- data/vendor/local/include/freetype2/ftgxval.h +1 -1
- data/vendor/local/include/freetype2/ftgzip.h +1 -1
- data/vendor/local/include/freetype2/ftimage.h +7 -13
- data/vendor/local/include/freetype2/ftincrem.h +1 -1
- data/vendor/local/include/freetype2/ftlcdfil.h +2 -2
- data/vendor/local/include/freetype2/ftlist.h +1 -1
- data/vendor/local/include/freetype2/ftlzw.h +1 -1
- data/vendor/local/include/freetype2/ftmac.h +1 -1
- data/vendor/local/include/freetype2/ftmm.h +17 -11
- data/vendor/local/include/freetype2/ftmodapi.h +4 -2
- data/vendor/local/include/freetype2/ftmoderr.h +1 -1
- data/vendor/local/include/freetype2/ftotval.h +1 -1
- data/vendor/local/include/freetype2/ftoutln.h +1 -1
- data/vendor/local/include/freetype2/ftpfr.h +1 -1
- data/vendor/local/include/freetype2/ftrender.h +3 -8
- data/vendor/local/include/freetype2/ftsizes.h +1 -1
- data/vendor/local/include/freetype2/ftsnames.h +1 -1
- data/vendor/local/include/freetype2/ftstroke.h +1 -1
- data/vendor/local/include/freetype2/ftsynth.h +5 -3
- data/vendor/local/include/freetype2/ftsystem.h +10 -1
- data/vendor/local/include/freetype2/fttrigon.h +1 -1
- data/vendor/local/include/freetype2/ftttdrv.h +85 -22
- data/vendor/local/include/freetype2/fttypes.h +1 -1
- data/vendor/local/include/freetype2/ftwinfnt.h +3 -3
- data/vendor/local/include/freetype2/t1tables.h +4 -3
- data/vendor/local/include/freetype2/ttnameid.h +116 -116
- data/vendor/local/include/freetype2/tttables.h +2 -2
- data/vendor/local/include/freetype2/tttags.h +1 -1
- data/vendor/local/include/freetype2/ttunpat.h +1 -1
- data/vendor/local/include/libpng16/png.h +63 -80
- data/vendor/local/include/libpng16/pngconf.h +8 -30
- data/vendor/local/include/libpng16/pnglibconf.h +10 -4
- data/vendor/local/include/png.h +63 -80
- data/vendor/local/include/pngconf.h +8 -30
- data/vendor/local/include/pnglibconf.h +10 -4
- data/vendor/local/lib/libcairo-gobject.a +0 -0
- data/vendor/local/lib/libcairo-gobject.dll.a +0 -0
- data/vendor/local/lib/libcairo-gobject.la +2 -2
- data/vendor/local/lib/libcairo-script-interpreter.a +0 -0
- data/vendor/local/lib/libcairo-script-interpreter.dll.a +0 -0
- data/vendor/local/lib/libcairo-script-interpreter.la +2 -2
- data/vendor/local/lib/libcairo.a +0 -0
- data/vendor/local/lib/libcairo.dll.a +0 -0
- data/vendor/local/lib/libcairo.la +2 -2
- data/vendor/local/lib/libfontconfig.dll.a +0 -0
- data/vendor/local/lib/libfreetype.a +0 -0
- data/vendor/local/lib/libfreetype.dll.a +0 -0
- data/vendor/local/lib/libfreetype.la +4 -4
- data/vendor/local/lib/libpixman-1.a +0 -0
- data/vendor/local/lib/libpixman-1.dll.a +0 -0
- data/vendor/local/lib/libpng.a +0 -0
- data/vendor/local/lib/libpng.dll.a +0 -0
- data/vendor/local/lib/libpng.la +4 -4
- data/vendor/local/lib/libpng16.a +0 -0
- data/vendor/local/lib/libpng16.dll.a +0 -0
- data/vendor/local/lib/libpng16.la +4 -4
- data/vendor/local/lib/libxml2.a +0 -0
- data/vendor/local/lib/libxml2.dll.a +0 -0
- data/vendor/local/lib/libz.a +0 -0
- data/vendor/local/lib/libz.dll.a +0 -0
- data/vendor/local/lib/pkgconfig/cairo-fc.pc +1 -1
- data/vendor/local/lib/pkgconfig/cairo-ft.pc +1 -1
- data/vendor/local/lib/pkgconfig/cairo-gobject.pc +1 -1
- data/vendor/local/lib/pkgconfig/cairo-pdf.pc +1 -1
- data/vendor/local/lib/pkgconfig/cairo-png.pc +1 -1
- data/vendor/local/lib/pkgconfig/cairo-ps.pc +1 -1
- data/vendor/local/lib/pkgconfig/cairo-script.pc +1 -1
- data/vendor/local/lib/pkgconfig/cairo-svg.pc +1 -1
- data/vendor/local/lib/pkgconfig/cairo-win32-font.pc +1 -1
- data/vendor/local/lib/pkgconfig/cairo-win32.pc +1 -1
- data/vendor/local/lib/pkgconfig/cairo.pc +1 -1
- data/vendor/local/lib/pkgconfig/freetype2.pc +1 -1
- data/vendor/local/lib/pkgconfig/libpng.pc +1 -1
- data/vendor/local/lib/pkgconfig/libpng16.pc +1 -1
- data/vendor/local/share/aclocal/freetype2.m4 +1 -1
- data/vendor/local/share/gtk-doc/html/cairo/bindings-errors.html +12 -12
- data/vendor/local/share/gtk-doc/html/cairo/bindings-fonts.html +12 -12
- data/vendor/local/share/gtk-doc/html/cairo/bindings-memory.html +12 -12
- data/vendor/local/share/gtk-doc/html/cairo/bindings-overloading.html +13 -13
- data/vendor/local/share/gtk-doc/html/cairo/bindings-path.html +12 -12
- data/vendor/local/share/gtk-doc/html/cairo/bindings-patterns.html +35 -35
- data/vendor/local/share/gtk-doc/html/cairo/bindings-return-values.html +10 -10
- data/vendor/local/share/gtk-doc/html/cairo/bindings-streams.html +11 -11
- data/vendor/local/share/gtk-doc/html/cairo/bindings-surfaces.html +13 -13
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Error-handling.html +294 -225
- data/vendor/local/share/gtk-doc/html/cairo/cairo-FreeType-Fonts.html +387 -269
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Image-Surfaces.html +432 -302
- data/vendor/local/share/gtk-doc/html/cairo/cairo-PDF-Surfaces.html +325 -217
- data/vendor/local/share/gtk-doc/html/cairo/cairo-PNG-Support.html +298 -193
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Paths.html +1121 -812
- data/vendor/local/share/gtk-doc/html/cairo/cairo-PostScript-Surfaces.html +513 -383
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Quartz-(CGFont)-Fonts.html +126 -83
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Quartz-Surfaces.html +172 -119
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Raster-Sources.html +581 -372
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Recording-Surfaces.html +179 -130
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Regions.html +888 -539
- data/vendor/local/share/gtk-doc/html/cairo/cairo-SVG-Surfaces.html +287 -192
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Script-Surfaces.html +374 -231
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Transformations.html +395 -219
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Types.html +125 -75
- data/vendor/local/share/gtk-doc/html/cairo/cairo-User-Fonts.html +630 -464
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Version-Information.html +225 -200
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Win32-Fonts.html +336 -214
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Win32-Surfaces.html +277 -186
- data/vendor/local/share/gtk-doc/html/cairo/cairo-XCB-Surfaces.html +495 -350
- data/vendor/local/share/gtk-doc/html/cairo/cairo-XLib-Surfaces.html +557 -362
- data/vendor/local/share/gtk-doc/html/cairo/cairo-XLib-XRender-Backend.html +158 -111
- data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-device-t.html +655 -441
- data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-font-face-t.html +389 -280
- data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-font-options-t.html +667 -451
- data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-matrix-t.html +579 -351
- data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-pattern-t.html +2006 -1545
- data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-scaled-font-t.html +892 -618
- data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-surface-t.html +1624 -1188
- data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-t.html +2903 -2104
- data/vendor/local/share/gtk-doc/html/cairo/cairo-drawing.html +13 -13
- data/vendor/local/share/gtk-doc/html/cairo/cairo-fonts.html +13 -13
- data/vendor/local/share/gtk-doc/html/cairo/cairo-support.html +13 -13
- data/vendor/local/share/gtk-doc/html/cairo/cairo-surfaces.html +13 -13
- data/vendor/local/share/gtk-doc/html/cairo/cairo-text.html +1115 -758
- data/vendor/local/share/gtk-doc/html/cairo/cairo.devhelp2 +419 -604
- data/vendor/local/share/gtk-doc/html/cairo/home.png +0 -0
- data/vendor/local/share/gtk-doc/html/cairo/index-1.10.html +56 -56
- data/vendor/local/share/gtk-doc/html/cairo/index-1.12.html +70 -70
- data/vendor/local/share/gtk-doc/html/cairo/index-1.2.html +58 -58
- data/vendor/local/share/gtk-doc/html/cairo/index-1.4.html +39 -39
- data/vendor/local/share/gtk-doc/html/cairo/index-1.6.html +30 -30
- data/vendor/local/share/gtk-doc/html/cairo/index-1.8.html +38 -38
- data/vendor/local/share/gtk-doc/html/cairo/index-all.html +426 -426
- data/vendor/local/share/gtk-doc/html/cairo/index.html +6 -6
- data/vendor/local/share/gtk-doc/html/cairo/index.sgml +234 -325
- data/vendor/local/share/gtk-doc/html/cairo/language-bindings.html +12 -12
- data/vendor/local/share/gtk-doc/html/cairo/left-insensitive.png +0 -0
- data/vendor/local/share/gtk-doc/html/cairo/left.png +0 -0
- data/vendor/local/share/gtk-doc/html/cairo/right-insensitive.png +0 -0
- data/vendor/local/share/gtk-doc/html/cairo/right.png +0 -0
- data/vendor/local/share/gtk-doc/html/cairo/style.css +221 -26
- data/vendor/local/share/gtk-doc/html/cairo/up-insensitive.png +0 -0
- data/vendor/local/share/gtk-doc/html/cairo/up.png +0 -0
- data/vendor/local/share/license/cairo/README +1 -1
- data/vendor/local/share/license/freetype/README +6 -6
- data/vendor/local/share/license/freetype/README.git +1 -1
- data/vendor/local/share/license/libpng/README +2 -2
- data/vendor/local/share/man/man1/freetype-config.1 +1 -1
- data/vendor/local/share/man/man3/libpng.3 +85 -92
- data/vendor/local/share/man/man3/libpngpf.3 +2 -2
- data/vendor/local/share/man/man5/png.5 +1 -1
- metadata +23 -19
@@ -2,30 +2,27 @@
|
|
2
2
|
<html>
|
3
3
|
<head>
|
4
4
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
5
|
-
<title>cairo_font_face_t</title>
|
6
|
-
<meta name="generator" content="DocBook XSL Stylesheets V1.
|
5
|
+
<title>Cairo: A Vector Graphics Library: cairo_font_face_t</title>
|
6
|
+
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
|
7
7
|
<link rel="home" href="index.html" title="Cairo: A Vector Graphics Library">
|
8
8
|
<link rel="up" href="cairo-fonts.html" title="Fonts">
|
9
9
|
<link rel="prev" href="cairo-fonts.html" title="Fonts">
|
10
10
|
<link rel="next" href="cairo-cairo-scaled-font-t.html" title="cairo_scaled_font_t">
|
11
|
-
<meta name="generator" content="GTK-Doc V1.
|
11
|
+
<meta name="generator" content="GTK-Doc V1.20 (XML mode)">
|
12
12
|
<link rel="stylesheet" href="style.css" type="text/css">
|
13
13
|
</head>
|
14
14
|
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
15
|
-
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="
|
16
|
-
<
|
17
|
-
<
|
18
|
-
<
|
19
|
-
<
|
20
|
-
|
21
|
-
<td><a accesskey="
|
22
|
-
|
23
|
-
<
|
24
|
-
<a href="
|
25
|
-
|
26
|
-
<a href="#cairo-cairo-font-face-t.description" class="shortcut">Description</a>
|
27
|
-
</td></tr>
|
28
|
-
</table>
|
15
|
+
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
|
16
|
+
<td width="100%" align="left" class="shortcuts">
|
17
|
+
<a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span>
|
18
|
+
<a href="#cairo-cairo-font-face-t.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span>
|
19
|
+
<a href="#cairo-cairo-font-face-t.object-hierarchy" class="shortcut">Object Hierarchy</a></span>
|
20
|
+
</td>
|
21
|
+
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
|
22
|
+
<td><a accesskey="u" href="cairo-fonts.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
|
23
|
+
<td><a accesskey="p" href="cairo-fonts.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
|
24
|
+
<td><a accesskey="n" href="cairo-cairo-scaled-font-t.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
|
25
|
+
</tr></table>
|
29
26
|
<div class="refentry">
|
30
27
|
<a name="cairo-cairo-font-face-t"></a><div class="titlepage"></div>
|
31
28
|
<div class="refnamediv"><table width="100%"><tr>
|
@@ -33,348 +30,460 @@
|
|
33
30
|
<h2><span class="refentrytitle"><a name="cairo-cairo-font-face-t.top_of_page"></a>cairo_font_face_t</span></h2>
|
34
31
|
<p>cairo_font_face_t — Base class for font faces</p>
|
35
32
|
</td>
|
36
|
-
<td valign="top" align="right"></td>
|
33
|
+
<td class="gallery_image" valign="top" align="right"></td>
|
37
34
|
</tr></table></div>
|
38
|
-
<div class="
|
39
|
-
<a name="cairo-cairo-font-face-t.
|
40
|
-
<
|
41
|
-
<
|
42
|
-
<
|
43
|
-
<
|
44
|
-
|
45
|
-
<
|
46
|
-
|
47
|
-
<
|
48
|
-
|
49
|
-
|
50
|
-
|
51
|
-
<
|
52
|
-
|
35
|
+
<div class="refsect1">
|
36
|
+
<a name="cairo-cairo-font-face-t.functions"></a><h2>Functions</h2>
|
37
|
+
<div class="informaltable"><table width="100%" border="0">
|
38
|
+
<colgroup>
|
39
|
+
<col width="150px" class="functions_return">
|
40
|
+
<col class="functions_name">
|
41
|
+
</colgroup>
|
42
|
+
<tbody>
|
43
|
+
<tr>
|
44
|
+
<td class="function_type">
|
45
|
+
<a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="returnvalue">cairo_font_face_t</span></a> *
|
46
|
+
</td>
|
47
|
+
<td class="function_name">
|
48
|
+
<a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-reference" title="cairo_font_face_reference ()">cairo_font_face_reference</a> <span class="c_punctuation">()</span>
|
49
|
+
</td>
|
50
|
+
</tr>
|
51
|
+
<tr>
|
52
|
+
<td class="function_type">
|
53
|
+
<span class="returnvalue">void</span>
|
54
|
+
</td>
|
55
|
+
<td class="function_name">
|
56
|
+
<a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-destroy" title="cairo_font_face_destroy ()">cairo_font_face_destroy</a> <span class="c_punctuation">()</span>
|
57
|
+
</td>
|
58
|
+
</tr>
|
59
|
+
<tr>
|
60
|
+
<td class="function_type">
|
61
|
+
<a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="returnvalue">cairo_status_t</span></a>
|
62
|
+
</td>
|
63
|
+
<td class="function_name">
|
64
|
+
<a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-status" title="cairo_font_face_status ()">cairo_font_face_status</a> <span class="c_punctuation">()</span>
|
65
|
+
</td>
|
66
|
+
</tr>
|
67
|
+
<tr>
|
68
|
+
<td class="function_type">
|
69
|
+
<a class="link" href="cairo-cairo-font-face-t.html#cairo-font-type-t" title="enum cairo_font_type_t"><span class="returnvalue">cairo_font_type_t</span></a>
|
70
|
+
</td>
|
71
|
+
<td class="function_name">
|
72
|
+
<a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-get-type" title="cairo_font_face_get_type ()">cairo_font_face_get_type</a> <span class="c_punctuation">()</span>
|
73
|
+
</td>
|
74
|
+
</tr>
|
75
|
+
<tr>
|
76
|
+
<td class="function_type">unsigned <span class="returnvalue">int</span>
|
77
|
+
</td>
|
78
|
+
<td class="function_name">
|
79
|
+
<a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-get-reference-count" title="cairo_font_face_get_reference_count ()">cairo_font_face_get_reference_count</a> <span class="c_punctuation">()</span>
|
80
|
+
</td>
|
81
|
+
</tr>
|
82
|
+
<tr>
|
83
|
+
<td class="function_type">
|
84
|
+
<a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="returnvalue">cairo_status_t</span></a>
|
85
|
+
</td>
|
86
|
+
<td class="function_name">
|
87
|
+
<a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-set-user-data" title="cairo_font_face_set_user_data ()">cairo_font_face_set_user_data</a> <span class="c_punctuation">()</span>
|
88
|
+
</td>
|
89
|
+
</tr>
|
90
|
+
<tr>
|
91
|
+
<td class="function_type">
|
92
|
+
<span class="returnvalue">void</span> *
|
93
|
+
</td>
|
94
|
+
<td class="function_name">
|
95
|
+
<a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-get-user-data" title="cairo_font_face_get_user_data ()">cairo_font_face_get_user_data</a> <span class="c_punctuation">()</span>
|
96
|
+
</td>
|
97
|
+
</tr>
|
98
|
+
</tbody>
|
99
|
+
</table></div>
|
100
|
+
</div>
|
101
|
+
<div class="refsect1">
|
102
|
+
<a name="cairo-cairo-font-face-t.other"></a><h2>Types and Values</h2>
|
103
|
+
<div class="informaltable"><table width="100%" border="0">
|
104
|
+
<colgroup>
|
105
|
+
<col width="150px" class="name">
|
106
|
+
<col class="description">
|
107
|
+
</colgroup>
|
108
|
+
<tbody>
|
109
|
+
<tr>
|
110
|
+
<td class="typedef_keyword">typedef</td>
|
111
|
+
<td class="function_name"><a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t">cairo_font_face_t</a></td>
|
112
|
+
</tr>
|
113
|
+
<tr>
|
114
|
+
<td class="datatype_keyword">enum</td>
|
115
|
+
<td class="function_name"><a class="link" href="cairo-cairo-font-face-t.html#cairo-font-type-t" title="enum cairo_font_type_t">cairo_font_type_t</a></td>
|
116
|
+
</tr>
|
117
|
+
</tbody>
|
118
|
+
</table></div>
|
119
|
+
</div>
|
120
|
+
<div class="refsect1">
|
121
|
+
<a name="cairo-cairo-font-face-t.object-hierarchy"></a><h2>Object Hierarchy</h2>
|
122
|
+
<pre class="screen">
|
53
123
|
</pre>
|
54
124
|
</div>
|
55
125
|
<div class="refsect1">
|
56
126
|
<a name="cairo-cairo-font-face-t.description"></a><h2>Description</h2>
|
57
|
-
<p>
|
58
|
-
|
59
|
-
|
60
|
-
</p>
|
61
|
-
<p>
|
62
|
-
Font faces are created using <em class="firstterm">font-backend</em>-specific
|
127
|
+
<p><a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a> represents a particular font at a particular weight,
|
128
|
+
slant, and other characteristic but no size, transformation, or size.</p>
|
129
|
+
<p>Font faces are created using <em class="firstterm">font-backend</em>-specific
|
63
130
|
constructors, typically of the form
|
64
131
|
<code class="function">cairo_<span class="emphasis"><em>backend</em></span>_font_face_create()</code>,
|
65
132
|
or implicitly using the <em class="firstterm">toy</em> text API by way of
|
66
|
-
<a class="link" href="cairo-text.html#cairo-select-font-face" title="cairo_select_font_face
|
67
|
-
<a class="link" href="cairo-text.html#cairo-get-font-face" title="cairo_get_font_face
|
68
|
-
</p>
|
133
|
+
<a class="link" href="cairo-text.html#cairo-select-font-face" title="cairo_select_font_face ()"><code class="function">cairo_select_font_face()</code></a>. The resulting face can be accessed using
|
134
|
+
<a class="link" href="cairo-text.html#cairo-get-font-face" title="cairo_get_font_face ()"><code class="function">cairo_get_font_face()</code></a>.</p>
|
69
135
|
</div>
|
70
136
|
<div class="refsect1">
|
71
|
-
<a name="cairo-cairo-font-face-t.
|
137
|
+
<a name="cairo-cairo-font-face-t.functions_details"></a><h2>Functions</h2>
|
72
138
|
<div class="refsect2">
|
73
|
-
<a name="cairo-font-face-
|
74
|
-
<pre class="programlisting"
|
75
|
-
</pre>
|
76
|
-
<p>
|
77
|
-
|
78
|
-
|
79
|
-
|
80
|
-
|
81
|
-
<a class="link" href="cairo-
|
82
|
-
<a class="link" href="cairo-
|
83
|
-
|
84
|
-
<
|
85
|
-
|
86
|
-
<
|
87
|
-
|
88
|
-
|
89
|
-
<
|
90
|
-
|
91
|
-
<
|
92
|
-
</p>
|
139
|
+
<a name="cairo-font-face-reference"></a><h3>cairo_font_face_reference ()</h3>
|
140
|
+
<pre class="programlisting"><a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="returnvalue">cairo_font_face_t</span></a> *
|
141
|
+
cairo_font_face_reference (<em class="parameter"><code><a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a> *font_face</code></em>);</pre>
|
142
|
+
<p>Increases the reference count on <em class="parameter"><code>font_face</code></em>
|
143
|
+
by one. This prevents
|
144
|
+
<em class="parameter"><code>font_face</code></em>
|
145
|
+
from being destroyed until a matching call to
|
146
|
+
<a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-destroy" title="cairo_font_face_destroy ()"><code class="function">cairo_font_face_destroy()</code></a> is made.</p>
|
147
|
+
<p>The number of references to a <a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a> can be get using
|
148
|
+
<a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-get-reference-count" title="cairo_font_face_get_reference_count ()"><code class="function">cairo_font_face_get_reference_count()</code></a>.</p>
|
149
|
+
<div class="refsect3">
|
150
|
+
<a name="id-1.4.2.7.2.6"></a><h4>Parameters</h4>
|
151
|
+
<div class="informaltable"><table width="100%" border="0">
|
152
|
+
<colgroup>
|
153
|
+
<col width="150px" class="parameters_name">
|
154
|
+
<col class="parameters_description">
|
155
|
+
<col width="200px" class="parameters_annotations">
|
156
|
+
</colgroup>
|
157
|
+
<tbody><tr>
|
158
|
+
<td class="parameter_name"><p>font_face</p></td>
|
159
|
+
<td class="parameter_description"><p>a <a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a>, (may be <code class="literal">NULL</code> in which case this
|
160
|
+
function does nothing).</p></td>
|
161
|
+
<td class="parameter_annotations"> </td>
|
162
|
+
</tr></tbody>
|
163
|
+
</table></div>
|
164
|
+
</div>
|
165
|
+
<div class="refsect3">
|
166
|
+
<a name="id-1.4.2.7.2.7"></a><h4>Returns</h4>
|
167
|
+
<p> the referenced <a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a>.</p>
|
168
|
+
<p></p>
|
169
|
+
</div>
|
93
170
|
<p class="since">Since 1.0</p>
|
94
171
|
</div>
|
95
172
|
<hr>
|
96
173
|
<div class="refsect2">
|
97
|
-
<a name="cairo-font-face-
|
98
|
-
<pre class="programlisting"><
|
99
|
-
<
|
100
|
-
|
101
|
-
|
102
|
-
<
|
103
|
-
|
104
|
-
<p>
|
105
|
-
|
106
|
-
<a
|
107
|
-
|
108
|
-
<
|
109
|
-
<col
|
110
|
-
<
|
111
|
-
<
|
112
|
-
|
113
|
-
<
|
114
|
-
|
115
|
-
</
|
116
|
-
<
|
117
|
-
|
118
|
-
<td>the referenced <a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a>.</td>
|
119
|
-
</tr>
|
120
|
-
</tbody>
|
174
|
+
<a name="cairo-font-face-destroy"></a><h3>cairo_font_face_destroy ()</h3>
|
175
|
+
<pre class="programlisting"><span class="returnvalue">void</span>
|
176
|
+
cairo_font_face_destroy (<em class="parameter"><code><a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a> *font_face</code></em>);</pre>
|
177
|
+
<p>Decreases the reference count on <em class="parameter"><code>font_face</code></em>
|
178
|
+
by one. If the result
|
179
|
+
is zero, then <em class="parameter"><code>font_face</code></em>
|
180
|
+
and all associated resources are freed.
|
181
|
+
See <a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-reference" title="cairo_font_face_reference ()"><code class="function">cairo_font_face_reference()</code></a>.</p>
|
182
|
+
<div class="refsect3">
|
183
|
+
<a name="id-1.4.2.7.3.5"></a><h4>Parameters</h4>
|
184
|
+
<div class="informaltable"><table width="100%" border="0">
|
185
|
+
<colgroup>
|
186
|
+
<col width="150px" class="parameters_name">
|
187
|
+
<col class="parameters_description">
|
188
|
+
<col width="200px" class="parameters_annotations">
|
189
|
+
</colgroup>
|
190
|
+
<tbody><tr>
|
191
|
+
<td class="parameter_name"><p>font_face</p></td>
|
192
|
+
<td class="parameter_description"><p>a <a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a></p></td>
|
193
|
+
<td class="parameter_annotations"> </td>
|
194
|
+
</tr></tbody>
|
121
195
|
</table></div>
|
196
|
+
</div>
|
122
197
|
<p class="since">Since 1.0</p>
|
123
198
|
</div>
|
124
199
|
<hr>
|
125
200
|
<div class="refsect2">
|
126
|
-
<a name="cairo-font-face-
|
127
|
-
<pre class="programlisting"><
|
128
|
-
<
|
129
|
-
|
130
|
-
|
131
|
-
|
132
|
-
</
|
133
|
-
<div class="
|
134
|
-
<
|
201
|
+
<a name="cairo-font-face-status"></a><h3>cairo_font_face_status ()</h3>
|
202
|
+
<pre class="programlisting"><a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="returnvalue">cairo_status_t</span></a>
|
203
|
+
cairo_font_face_status (<em class="parameter"><code><a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a> *font_face</code></em>);</pre>
|
204
|
+
<p>Checks whether an error has previously occurred for this
|
205
|
+
font face</p>
|
206
|
+
<div class="refsect3">
|
207
|
+
<a name="id-1.4.2.7.4.5"></a><h4>Parameters</h4>
|
208
|
+
<div class="informaltable"><table width="100%" border="0">
|
209
|
+
<colgroup>
|
210
|
+
<col width="150px" class="parameters_name">
|
211
|
+
<col class="parameters_description">
|
212
|
+
<col width="200px" class="parameters_annotations">
|
213
|
+
</colgroup>
|
135
214
|
<tbody><tr>
|
136
|
-
<td
|
137
|
-
<td>a <a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a>
|
138
|
-
</td>
|
215
|
+
<td class="parameter_name"><p>font_face</p></td>
|
216
|
+
<td class="parameter_description"><p>a <a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a></p></td>
|
217
|
+
<td class="parameter_annotations"> </td>
|
139
218
|
</tr></tbody>
|
140
219
|
</table></div>
|
220
|
+
</div>
|
221
|
+
<div class="refsect3">
|
222
|
+
<a name="id-1.4.2.7.4.6"></a><h4>Returns</h4>
|
223
|
+
<p> <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-SUCCESS:CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> or another error such as
|
224
|
+
<a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-NO-MEMORY:CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a>.</p>
|
225
|
+
<p></p>
|
226
|
+
</div>
|
141
227
|
<p class="since">Since 1.0</p>
|
142
228
|
</div>
|
143
229
|
<hr>
|
144
230
|
<div class="refsect2">
|
145
|
-
<a name="cairo-font-face-
|
146
|
-
<pre class="programlisting"><a class="link" href="cairo-
|
147
|
-
<
|
148
|
-
|
149
|
-
font face
|
150
|
-
|
151
|
-
<
|
152
|
-
<
|
153
|
-
<
|
154
|
-
<
|
155
|
-
<
|
156
|
-
<
|
157
|
-
</
|
158
|
-
|
159
|
-
<
|
160
|
-
<td
|
161
|
-
<td>
|
162
|
-
|
163
|
-
<a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-NO-MEMORY:CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a>.</td>
|
164
|
-
</tr>
|
165
|
-
</tbody>
|
231
|
+
<a name="cairo-font-face-get-type"></a><h3>cairo_font_face_get_type ()</h3>
|
232
|
+
<pre class="programlisting"><a class="link" href="cairo-cairo-font-face-t.html#cairo-font-type-t" title="enum cairo_font_type_t"><span class="returnvalue">cairo_font_type_t</span></a>
|
233
|
+
cairo_font_face_get_type (<em class="parameter"><code><a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a> *font_face</code></em>);</pre>
|
234
|
+
<p>This function returns the type of the backend used to create
|
235
|
+
a font face. See <a class="link" href="cairo-cairo-font-face-t.html#cairo-font-type-t" title="enum cairo_font_type_t"><span class="type">cairo_font_type_t</span></a> for available types.</p>
|
236
|
+
<div class="refsect3">
|
237
|
+
<a name="id-1.4.2.7.5.5"></a><h4>Parameters</h4>
|
238
|
+
<div class="informaltable"><table width="100%" border="0">
|
239
|
+
<colgroup>
|
240
|
+
<col width="150px" class="parameters_name">
|
241
|
+
<col class="parameters_description">
|
242
|
+
<col width="200px" class="parameters_annotations">
|
243
|
+
</colgroup>
|
244
|
+
<tbody><tr>
|
245
|
+
<td class="parameter_name"><p>font_face</p></td>
|
246
|
+
<td class="parameter_description"><p>a font face</p></td>
|
247
|
+
<td class="parameter_annotations"> </td>
|
248
|
+
</tr></tbody>
|
166
249
|
</table></div>
|
167
|
-
|
250
|
+
</div>
|
251
|
+
<div class="refsect3">
|
252
|
+
<a name="id-1.4.2.7.5.6"></a><h4>Returns</h4>
|
253
|
+
<p> The type of <em class="parameter"><code>font_face</code></em>
|
254
|
+
.</p>
|
255
|
+
<p></p>
|
256
|
+
</div>
|
257
|
+
<p class="since">Since 1.2</p>
|
168
258
|
</div>
|
169
259
|
<hr>
|
170
260
|
<div class="refsect2">
|
171
|
-
<a name="cairo-font-
|
172
|
-
<pre class="programlisting">
|
173
|
-
|
174
|
-
|
175
|
-
|
176
|
-
|
177
|
-
|
178
|
-
|
179
|
-
|
180
|
-
<
|
181
|
-
<
|
182
|
-
|
183
|
-
|
184
|
-
|
185
|
-
<p>
|
186
|
-
|
187
|
-
|
188
|
-
|
189
|
-
|
190
|
-
</
|
191
|
-
<
|
192
|
-
|
193
|
-
of
|
194
|
-
|
195
|
-
|
196
|
-
|
197
|
-
|
198
|
-
|
199
|
-
</
|
200
|
-
<
|
201
|
-
|
202
|
-
|
203
|
-
|
204
|
-
|
205
|
-
<
|
206
|
-
|
207
|
-
</
|
208
|
-
<p>
|
209
|
-
|
210
|
-
|
211
|
-
</
|
212
|
-
|
213
|
-
|
214
|
-
</
|
215
|
-
<div class="
|
216
|
-
<
|
261
|
+
<a name="cairo-font-face-get-reference-count"></a><h3>cairo_font_face_get_reference_count ()</h3>
|
262
|
+
<pre class="programlisting">unsigned <span class="returnvalue">int</span>
|
263
|
+
cairo_font_face_get_reference_count (<em class="parameter"><code><a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a> *font_face</code></em>);</pre>
|
264
|
+
<p>Returns the current reference count of <em class="parameter"><code>font_face</code></em>
|
265
|
+
.</p>
|
266
|
+
<div class="refsect3">
|
267
|
+
<a name="id-1.4.2.7.6.5"></a><h4>Parameters</h4>
|
268
|
+
<div class="informaltable"><table width="100%" border="0">
|
269
|
+
<colgroup>
|
270
|
+
<col width="150px" class="parameters_name">
|
271
|
+
<col class="parameters_description">
|
272
|
+
<col width="200px" class="parameters_annotations">
|
273
|
+
</colgroup>
|
274
|
+
<tbody><tr>
|
275
|
+
<td class="parameter_name"><p>font_face</p></td>
|
276
|
+
<td class="parameter_description"><p>a <a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a></p></td>
|
277
|
+
<td class="parameter_annotations"> </td>
|
278
|
+
</tr></tbody>
|
279
|
+
</table></div>
|
280
|
+
</div>
|
281
|
+
<div class="refsect3">
|
282
|
+
<a name="id-1.4.2.7.6.6"></a><h4>Returns</h4>
|
283
|
+
<p> the current reference count of <em class="parameter"><code>font_face</code></em>
|
284
|
+
. If the
|
285
|
+
object is a nil object, 0 will be returned.</p>
|
286
|
+
<p></p>
|
287
|
+
</div>
|
288
|
+
<p class="since">Since 1.4</p>
|
289
|
+
</div>
|
290
|
+
<hr>
|
291
|
+
<div class="refsect2">
|
292
|
+
<a name="cairo-font-face-set-user-data"></a><h3>cairo_font_face_set_user_data ()</h3>
|
293
|
+
<pre class="programlisting"><a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="returnvalue">cairo_status_t</span></a>
|
294
|
+
cairo_font_face_set_user_data (<em class="parameter"><code><a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a> *font_face</code></em>,
|
295
|
+
<em class="parameter"><code>const <a class="link" href="cairo-Types.html#cairo-user-data-key-t" title="cairo_user_data_key_t"><span class="type">cairo_user_data_key_t</span></a> *key</code></em>,
|
296
|
+
<em class="parameter"><code><span class="type">void</span> *user_data</code></em>,
|
297
|
+
<em class="parameter"><code><a class="link" href="cairo-Types.html#cairo-destroy-func-t" title="cairo_destroy_func_t ()"><span class="type">cairo_destroy_func_t</span></a> destroy</code></em>);</pre>
|
298
|
+
<p>Attach user data to <em class="parameter"><code>font_face</code></em>
|
299
|
+
. To remove user data from a font face,
|
300
|
+
call this function with the key that was used to set it and <code class="literal">NULL</code>
|
301
|
+
for <em class="parameter"><code>data</code></em>
|
302
|
+
.</p>
|
303
|
+
<div class="refsect3">
|
304
|
+
<a name="id-1.4.2.7.7.5"></a><h4>Parameters</h4>
|
305
|
+
<div class="informaltable"><table width="100%" border="0">
|
306
|
+
<colgroup>
|
307
|
+
<col width="150px" class="parameters_name">
|
308
|
+
<col class="parameters_description">
|
309
|
+
<col width="200px" class="parameters_annotations">
|
310
|
+
</colgroup>
|
217
311
|
<tbody>
|
218
312
|
<tr>
|
219
|
-
<td
|
220
|
-
<td>
|
221
|
-
</td>
|
222
|
-
</tr>
|
223
|
-
<tr>
|
224
|
-
<td><p><a name="CAIRO-FONT-TYPE-FT:CAPS"></a><span class="term"><code class="literal">CAIRO_FONT_TYPE_FT</code></span></p></td>
|
225
|
-
<td>The font is of type FreeType (Since: 1.2)
|
226
|
-
</td>
|
313
|
+
<td class="parameter_name"><p>font_face</p></td>
|
314
|
+
<td class="parameter_description"><p>a <a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a></p></td>
|
315
|
+
<td class="parameter_annotations"> </td>
|
227
316
|
</tr>
|
228
317
|
<tr>
|
229
|
-
<td
|
230
|
-
<td>
|
231
|
-
</td>
|
318
|
+
<td class="parameter_name"><p>key</p></td>
|
319
|
+
<td class="parameter_description"><p>the address of a <a class="link" href="cairo-Types.html#cairo-user-data-key-t" title="cairo_user_data_key_t"><span class="type">cairo_user_data_key_t</span></a> to attach the user data to</p></td>
|
320
|
+
<td class="parameter_annotations"> </td>
|
232
321
|
</tr>
|
233
322
|
<tr>
|
234
|
-
<td
|
235
|
-
<td>
|
236
|
-
|
237
|
-
</td>
|
323
|
+
<td class="parameter_name"><p>user_data</p></td>
|
324
|
+
<td class="parameter_description"><p>the user data to attach to the font face</p></td>
|
325
|
+
<td class="parameter_annotations"> </td>
|
238
326
|
</tr>
|
239
327
|
<tr>
|
240
|
-
<td
|
241
|
-
<td>
|
242
|
-
|
328
|
+
<td class="parameter_name"><p>destroy</p></td>
|
329
|
+
<td class="parameter_description"><p>a <a class="link" href="cairo-Types.html#cairo-destroy-func-t" title="cairo_destroy_func_t ()"><span class="type">cairo_destroy_func_t</span></a> which will be called when the
|
330
|
+
font face is destroyed or when new user data is attached using the
|
331
|
+
same key.</p></td>
|
332
|
+
<td class="parameter_annotations"> </td>
|
243
333
|
</tr>
|
244
334
|
</tbody>
|
245
335
|
</table></div>
|
246
|
-
|
336
|
+
</div>
|
337
|
+
<div class="refsect3">
|
338
|
+
<a name="id-1.4.2.7.7.6"></a><h4>Returns</h4>
|
339
|
+
<p> <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> if a
|
340
|
+
slot could not be allocated for the user data.</p>
|
341
|
+
<p></p>
|
342
|
+
</div>
|
343
|
+
<p class="since">Since 1.0</p>
|
247
344
|
</div>
|
248
345
|
<hr>
|
249
346
|
<div class="refsect2">
|
250
|
-
<a name="cairo-font-face-get-
|
251
|
-
<pre class="programlisting"><
|
252
|
-
<
|
253
|
-
|
254
|
-
|
255
|
-
|
256
|
-
|
257
|
-
<
|
347
|
+
<a name="cairo-font-face-get-user-data"></a><h3>cairo_font_face_get_user_data ()</h3>
|
348
|
+
<pre class="programlisting"><span class="returnvalue">void</span> *
|
349
|
+
cairo_font_face_get_user_data (<em class="parameter"><code><a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a> *font_face</code></em>,
|
350
|
+
<em class="parameter"><code>const <a class="link" href="cairo-Types.html#cairo-user-data-key-t" title="cairo_user_data_key_t"><span class="type">cairo_user_data_key_t</span></a> *key</code></em>);</pre>
|
351
|
+
<p>Return user data previously attached to <em class="parameter"><code>font_face</code></em>
|
352
|
+
using the specified
|
353
|
+
key. If no user data has been attached with the given key this
|
354
|
+
function returns <code class="literal">NULL</code>.</p>
|
355
|
+
<div class="refsect3">
|
356
|
+
<a name="id-1.4.2.7.8.5"></a><h4>Parameters</h4>
|
357
|
+
<div class="informaltable"><table width="100%" border="0">
|
358
|
+
<colgroup>
|
359
|
+
<col width="150px" class="parameters_name">
|
360
|
+
<col class="parameters_description">
|
361
|
+
<col width="200px" class="parameters_annotations">
|
362
|
+
</colgroup>
|
258
363
|
<tbody>
|
259
364
|
<tr>
|
260
|
-
<td
|
261
|
-
<td>a font
|
365
|
+
<td class="parameter_name"><p>font_face</p></td>
|
366
|
+
<td class="parameter_description"><p>a <a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a></p></td>
|
367
|
+
<td class="parameter_annotations"> </td>
|
262
368
|
</tr>
|
263
369
|
<tr>
|
264
|
-
<td
|
265
|
-
<td>
|
370
|
+
<td class="parameter_name"><p>key</p></td>
|
371
|
+
<td class="parameter_description"><p>the address of the <a class="link" href="cairo-Types.html#cairo-user-data-key-t" title="cairo_user_data_key_t"><span class="type">cairo_user_data_key_t</span></a> the user data was
|
372
|
+
attached to</p></td>
|
373
|
+
<td class="parameter_annotations"> </td>
|
266
374
|
</tr>
|
267
375
|
</tbody>
|
268
376
|
</table></div>
|
269
|
-
<p class="since">Since 1.2</p>
|
270
377
|
</div>
|
271
|
-
<
|
378
|
+
<div class="refsect3">
|
379
|
+
<a name="id-1.4.2.7.8.6"></a><h4>Returns</h4>
|
380
|
+
<p> the user data previously attached or <code class="literal">NULL</code>.</p>
|
381
|
+
<p></p>
|
382
|
+
</div>
|
383
|
+
<p class="since">Since 1.0</p>
|
384
|
+
</div>
|
385
|
+
</div>
|
386
|
+
<div class="refsect1">
|
387
|
+
<a name="cairo-cairo-font-face-t.other_details"></a><h2>Types and Values</h2>
|
272
388
|
<div class="refsect2">
|
273
|
-
<a name="cairo-font-face-
|
274
|
-
<pre class="programlisting">
|
275
|
-
|
276
|
-
|
277
|
-
|
278
|
-
|
279
|
-
<
|
280
|
-
<
|
281
|
-
<
|
282
|
-
<
|
283
|
-
<
|
284
|
-
</
|
285
|
-
</
|
286
|
-
<
|
287
|
-
<
|
288
|
-
<td>the current reference count of <em class="parameter"><code>font_face</code></em>. If the
|
289
|
-
object is a nil object, 0 will be returned.</td>
|
290
|
-
</tr>
|
291
|
-
</tbody>
|
292
|
-
</table></div>
|
293
|
-
<p class="since">Since 1.4</p>
|
389
|
+
<a name="cairo-font-face-t"></a><h3>cairo_font_face_t</h3>
|
390
|
+
<pre class="programlisting">typedef struct _cairo_font_face cairo_font_face_t;
|
391
|
+
</pre>
|
392
|
+
<p>A <a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a> specifies all aspects of a font other
|
393
|
+
than the size or font matrix (a font matrix is used to distort
|
394
|
+
a font by sheering it or scaling it unequally in the two
|
395
|
+
directions) . A font face can be set on a <a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> by using
|
396
|
+
<a class="link" href="cairo-text.html#cairo-set-font-face" title="cairo_set_font_face ()"><code class="function">cairo_set_font_face()</code></a>; the size and font matrix are set with
|
397
|
+
<a class="link" href="cairo-text.html#cairo-set-font-size" title="cairo_set_font_size ()"><code class="function">cairo_set_font_size()</code></a> and <a class="link" href="cairo-text.html#cairo-set-font-matrix" title="cairo_set_font_matrix ()"><code class="function">cairo_set_font_matrix()</code></a>.</p>
|
398
|
+
<p>There are various types of font faces, depending on the
|
399
|
+
<em class="firstterm">font backend</em> they use. The type of a
|
400
|
+
font face can be queried using <a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-get-type" title="cairo_font_face_get_type ()"><code class="function">cairo_font_face_get_type()</code></a>.</p>
|
401
|
+
<p>Memory management of <a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a> is done with
|
402
|
+
<a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-reference" title="cairo_font_face_reference ()"><code class="function">cairo_font_face_reference()</code></a> and <a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-destroy" title="cairo_font_face_destroy ()"><code class="function">cairo_font_face_destroy()</code></a>.</p>
|
403
|
+
<p class="since">Since 1.0</p>
|
294
404
|
</div>
|
295
405
|
<hr>
|
296
406
|
<div class="refsect2">
|
297
|
-
<a name="cairo-font-
|
298
|
-
<
|
299
|
-
|
300
|
-
|
301
|
-
|
302
|
-
|
303
|
-
|
304
|
-
|
305
|
-
|
306
|
-
|
307
|
-
<
|
308
|
-
<
|
407
|
+
<a name="cairo-font-type-t"></a><h3>enum cairo_font_type_t</h3>
|
408
|
+
<p><a class="link" href="cairo-cairo-font-face-t.html#cairo-font-type-t" title="enum cairo_font_type_t"><span class="type">cairo_font_type_t</span></a> is used to describe the type of a given font
|
409
|
+
face or scaled font. The font types are also known as "font
|
410
|
+
backends" within cairo.</p>
|
411
|
+
<p>The type of a font face is determined by the function used to
|
412
|
+
create it, which will generally be of the form
|
413
|
+
<code class="function">cairo_<span class="emphasis"><em>type</em></span>_font_face_create()</code>.
|
414
|
+
The font face type can be queried with <a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-get-type" title="cairo_font_face_get_type ()"><code class="function">cairo_font_face_get_type()</code></a></p>
|
415
|
+
<p>The various <a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a> functions can be used with a font face
|
416
|
+
of any type.</p>
|
417
|
+
<p>The type of a scaled font is determined by the type of the font
|
418
|
+
face passed to <a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-create" title="cairo_scaled_font_create ()"><code class="function">cairo_scaled_font_create()</code></a>. The scaled font type can
|
419
|
+
be queried with <a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-get-type" title="cairo_scaled_font_get_type ()"><code class="function">cairo_scaled_font_get_type()</code></a></p>
|
420
|
+
<p>The various <a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-t" title="cairo_scaled_font_t"><span class="type">cairo_scaled_font_t</span></a> functions can be used with scaled
|
421
|
+
fonts of any type, but some font backends also provide
|
422
|
+
type-specific functions that must only be called with a scaled font
|
423
|
+
of the appropriate type. These functions have names that begin with
|
424
|
+
<code class="function">cairo_<span class="emphasis"><em>type</em></span>_scaled_font()</code>
|
425
|
+
such as <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-scaled-font-lock-face" title="cairo_ft_scaled_font_lock_face ()"><code class="function">cairo_ft_scaled_font_lock_face()</code></a>.</p>
|
426
|
+
<p>The behavior of calling a type-specific function with a scaled font
|
427
|
+
of the wrong type is undefined.</p>
|
428
|
+
<p>New entries may be added in future versions.</p>
|
429
|
+
<div class="refsect3">
|
430
|
+
<a name="id-1.4.2.8.3.10"></a><h4>Members</h4>
|
431
|
+
<div class="informaltable"><table width="100%" border="0">
|
432
|
+
<colgroup>
|
433
|
+
<col width="300px" class="enum_members_name">
|
434
|
+
<col class="enum_members_description">
|
435
|
+
<col width="200px" class="enum_members_annotations">
|
436
|
+
</colgroup>
|
309
437
|
<tbody>
|
310
438
|
<tr>
|
311
|
-
<td
|
312
|
-
<td
|
439
|
+
<td class="enum_member_name"><p><a name="CAIRO-FONT-TYPE-TOY:CAPS"></a>CAIRO_FONT_TYPE_TOY</p></td>
|
440
|
+
<td class="enum_member_description">
|
441
|
+
<p>The font was created using cairo's toy font api (Since: 1.2)</p>
|
313
442
|
</td>
|
443
|
+
<td class="enum_member_annotations"> </td>
|
314
444
|
</tr>
|
315
445
|
<tr>
|
316
|
-
<td
|
317
|
-
<td
|
318
|
-
</
|
319
|
-
|
320
|
-
<td
|
321
|
-
<td>the user data to attach to the font face</td>
|
322
|
-
</tr>
|
323
|
-
<tr>
|
324
|
-
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
|
325
|
-
<td>a <a class="link" href="cairo-Types.html#cairo-destroy-func-t" title="cairo_destroy_func_t ()"><span class="type">cairo_destroy_func_t</span></a> which will be called when the
|
326
|
-
font face is destroyed or when new user data is attached using the
|
327
|
-
same key.</td>
|
328
|
-
</tr>
|
329
|
-
<tr>
|
330
|
-
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
331
|
-
<td>
|
332
|
-
<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> if a
|
333
|
-
slot could not be allocated for the user data.</td>
|
446
|
+
<td class="enum_member_name"><p><a name="CAIRO-FONT-TYPE-FT:CAPS"></a>CAIRO_FONT_TYPE_FT</p></td>
|
447
|
+
<td class="enum_member_description">
|
448
|
+
<p>The font is of type FreeType (Since: 1.2)</p>
|
449
|
+
</td>
|
450
|
+
<td class="enum_member_annotations"> </td>
|
334
451
|
</tr>
|
335
|
-
</tbody>
|
336
|
-
</table></div>
|
337
|
-
<p class="since">Since 1.0</p>
|
338
|
-
</div>
|
339
|
-
<hr>
|
340
|
-
<div class="refsect2">
|
341
|
-
<a name="cairo-font-face-get-user-data"></a><h3>cairo_font_face_get_user_data ()</h3>
|
342
|
-
<pre class="programlisting"><span class="returnvalue">void</span> * cairo_font_face_get_user_data (<em class="parameter"><code><a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a> *font_face</code></em>,
|
343
|
-
<em class="parameter"><code>const <a class="link" href="cairo-Types.html#cairo-user-data-key-t" title="cairo_user_data_key_t"><span class="type">cairo_user_data_key_t</span></a> *key</code></em>);</pre>
|
344
|
-
<p>
|
345
|
-
Return user data previously attached to <em class="parameter"><code>font_face</code></em> using the specified
|
346
|
-
key. If no user data has been attached with the given key this
|
347
|
-
function returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
|
348
|
-
</p>
|
349
|
-
<div class="variablelist"><table border="0">
|
350
|
-
<col align="left" valign="top">
|
351
|
-
<tbody>
|
352
452
|
<tr>
|
353
|
-
<td
|
354
|
-
<td
|
453
|
+
<td class="enum_member_name"><p><a name="CAIRO-FONT-TYPE-WIN32:CAPS"></a>CAIRO_FONT_TYPE_WIN32</p></td>
|
454
|
+
<td class="enum_member_description">
|
455
|
+
<p>The font is of type Win32 (Since: 1.2)</p>
|
355
456
|
</td>
|
457
|
+
<td class="enum_member_annotations"> </td>
|
356
458
|
</tr>
|
357
459
|
<tr>
|
358
|
-
<td
|
359
|
-
<td
|
360
|
-
|
460
|
+
<td class="enum_member_name"><p><a name="CAIRO-FONT-TYPE-QUARTZ:CAPS"></a>CAIRO_FONT_TYPE_QUARTZ</p></td>
|
461
|
+
<td class="enum_member_description">
|
462
|
+
<p>The font is of type Quartz (Since: 1.6, in 1.2 and
|
463
|
+
1.4 it was named CAIRO_FONT_TYPE_ATSUI)</p>
|
464
|
+
</td>
|
465
|
+
<td class="enum_member_annotations"> </td>
|
361
466
|
</tr>
|
362
467
|
<tr>
|
363
|
-
<td
|
364
|
-
<td
|
468
|
+
<td class="enum_member_name"><p><a name="CAIRO-FONT-TYPE-USER:CAPS"></a>CAIRO_FONT_TYPE_USER</p></td>
|
469
|
+
<td class="enum_member_description">
|
470
|
+
<p>The font was create using cairo's user font api (Since: 1.8)</p>
|
471
|
+
</td>
|
472
|
+
<td class="enum_member_annotations"> </td>
|
365
473
|
</tr>
|
366
474
|
</tbody>
|
367
475
|
</table></div>
|
368
|
-
|
476
|
+
</div>
|
477
|
+
<p class="since">Since 1.2</p>
|
369
478
|
</div>
|
370
479
|
</div>
|
371
480
|
<div class="refsect1">
|
372
481
|
<a name="cairo-cairo-font-face-t.see-also"></a><h2>See Also</h2>
|
373
|
-
<a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-t" title="cairo_scaled_font_t"><span class="type">cairo_scaled_font_t</span></a>
|
482
|
+
<p><a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-t" title="cairo_scaled_font_t"><span class="type">cairo_scaled_font_t</span></a></p>
|
374
483
|
</div>
|
375
484
|
</div>
|
376
485
|
<div class="footer">
|
377
486
|
<hr>
|
378
|
-
Generated by GTK-Doc V1.
|
487
|
+
Generated by GTK-Doc V1.20</div>
|
379
488
|
</body>
|
380
489
|
</html>
|