cairo 1.7.0-x86-mswin32 → 1.8.0-x86-mswin32
Sign up to get free protection for your applications and to get access to all the features.
Potentially problematic release.
This version of cairo might be problematic. Click here for more details.
- data/ChangeLog +32 -0
- data/NEWS +9 -1
- data/README +1 -0
- data/Rakefile +2 -2
- data/cairo/DLL_FAQ.txt +397 -0
- data/cairo/README.txt +53 -0
- data/cairo/USAGE.txt +94 -0
- data/cairo/bin/libcairo-2.dll +0 -0
- data/cairo/bin/libpng12-0.dll +0 -0
- data/cairo/bin/zlib1.dll +0 -0
- data/cairo/include/cairo/cairo-deprecated.h +0 -4
- data/cairo/include/cairo/cairo-features.h +7 -22
- data/cairo/include/cairo/cairo-pdf.h +1 -1
- data/cairo/include/cairo/cairo-ps.h +1 -1
- data/cairo/include/cairo/cairo-svg.h +1 -1
- data/cairo/include/cairo/cairo-version.h +8 -0
- data/cairo/include/cairo/cairo-win32.h +9 -1
- data/cairo/include/cairo/cairo.h +420 -32
- data/cairo/include/libpng12/png.h +3592 -0
- data/cairo/include/libpng12/pngconf.h +1481 -0
- data/cairo/include/png.h +36 -13
- data/cairo/include/pngconf.h +3 -3
- data/cairo/include/zconf.h +332 -0
- data/cairo/include/zlib.h +1357 -0
- data/cairo/lib/cairo.def +22 -0
- data/cairo/lib/cairo.lib +0 -0
- data/cairo/lib/libcairo.dll.a +0 -0
- data/cairo/lib/libpng.def +1 -0
- data/cairo/lib/libpng.lib +0 -0
- data/cairo/lib/libpng12.dll.a +0 -0
- data/cairo/lib/pkgconfig/cairo-pdf.pc +5 -5
- data/cairo/lib/pkgconfig/cairo-png.pc +5 -5
- data/cairo/lib/pkgconfig/cairo-ps.pc +5 -5
- data/cairo/lib/pkgconfig/cairo-svg.pc +4 -4
- data/cairo/lib/pkgconfig/cairo-win32-font.pc +4 -4
- data/cairo/lib/pkgconfig/cairo-win32.pc +4 -4
- data/cairo/lib/pkgconfig/cairo.pc +4 -4
- data/cairo/lib/pkgconfig/libpng.pc +3 -2
- data/cairo/lib/pkgconfig/libpng12.pc +3 -2
- data/cairo/lib/zdll.exp +0 -0
- data/cairo/lib/zdll.lib +0 -0
- data/cairo/lib/zlib.def +60 -0
- data/cairo/manifest/cairo-dev_1.8.0-1_win32.mft +76 -0
- data/cairo/manifest/cairo_1.8.0-1_win32.mft +5 -0
- data/cairo/manifest/{libpng-dev-1.2.29.mft → libpng-dev_1.2.32-1_win32.mft} +5 -2
- data/cairo/manifest/libpng_1.2.32-1_win32.mft +2 -0
- data/cairo/share/doc/{cairo-1.6.4-2 → cairo_1.8.0-1_win32}/COPYING +0 -0
- data/cairo/share/doc/{cairo-1.6.4-2 → cairo_1.8.0-1_win32}/COPYING-LGPL-2.1 +0 -0
- data/cairo/share/doc/{cairo-1.6.4-2 → cairo_1.8.0-1_win32}/COPYING-MPL-1.1 +0 -0
- data/cairo/share/gtk-doc/html/cairo/bindings-errors.html +15 -11
- data/cairo/share/gtk-doc/html/cairo/bindings-fonts.html +15 -11
- data/cairo/share/gtk-doc/html/cairo/bindings-memory.html +20 -16
- data/cairo/share/gtk-doc/html/cairo/bindings-overloading.html +16 -12
- data/cairo/share/gtk-doc/html/cairo/bindings-path.html +17 -13
- data/cairo/share/gtk-doc/html/cairo/bindings-patterns.html +25 -21
- data/cairo/share/gtk-doc/html/cairo/bindings-return-values.html +17 -13
- data/cairo/share/gtk-doc/html/cairo/bindings-streams.html +14 -10
- data/cairo/share/gtk-doc/html/cairo/bindings-surfaces.html +19 -15
- data/cairo/share/gtk-doc/html/cairo/cairo-context.html +2721 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-drawing.html +57 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-error-status.html +361 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-font-face.html +418 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-font-options.html +695 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-fonts.html +63 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-ft-font.html +318 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-image-surface.html +486 -0
- data/cairo/share/gtk-doc/html/cairo/{cairo-cairo-matrix-t.html → cairo-matrix.html} +137 -156
- data/cairo/share/gtk-doc/html/cairo/{cairo-Paths.html → cairo-paths.html} +275 -306
- data/cairo/share/gtk-doc/html/cairo/cairo-pattern.html +1524 -0
- data/cairo/share/gtk-doc/html/cairo/{cairo-PDF-Surfaces.html → cairo-pdf-surface.html} +60 -70
- data/cairo/share/gtk-doc/html/cairo/cairo-png-functions.html +332 -0
- data/cairo/share/gtk-doc/html/cairo/{cairo-PostScript-Surfaces.html → cairo-ps-surface.html} +131 -150
- data/cairo/share/gtk-doc/html/cairo/cairo-quartz-font.html +153 -0
- data/cairo/share/gtk-doc/html/cairo/{cairo-Quartz-Surfaces.html → cairo-quartz-surface.html} +53 -62
- data/cairo/share/gtk-doc/html/cairo/cairo-scaled-font.html +1051 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-support.html +54 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-surface.html +1064 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-surfaces.html +69 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-svg-surface.html +324 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-text.html +1264 -0
- data/cairo/share/gtk-doc/html/cairo/{cairo-Transformations.html → cairo-transformations.html} +98 -115
- data/cairo/share/gtk-doc/html/cairo/cairo-types.html +134 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-user-font.html +769 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-version-info.html +355 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-win32-font.html +366 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-win32-surface.html +321 -0
- data/cairo/share/gtk-doc/html/cairo/{cairo-XLib-Surfaces.html → cairo-xlib-surface.html} +104 -121
- data/cairo/share/gtk-doc/html/cairo/cairo.devhelp +390 -405
- data/cairo/share/gtk-doc/html/cairo/cairo.devhelp2 +390 -405
- data/cairo/share/gtk-doc/html/cairo/index-1.2.html +63 -59
- data/cairo/share/gtk-doc/html/cairo/index-1.4.html +45 -41
- data/cairo/share/gtk-doc/html/cairo/index-1.6.html +29 -23
- data/cairo/share/gtk-doc/html/cairo/index-1.8.html +107 -0
- data/cairo/share/gtk-doc/html/cairo/index-all.html +759 -0
- data/cairo/share/gtk-doc/html/cairo/index.html +51 -41
- data/cairo/share/gtk-doc/html/cairo/index.sgml +478 -466
- data/cairo/share/gtk-doc/html/cairo/language-bindings.html +22 -18
- data/cairo/share/gtk-doc/html/cairo/style.css +14 -2
- data/cairo/share/man/man3/libpng.3 +443 -17
- data/cairo/share/man/man3/libpngpf.3 +618 -102
- data/cairo/share/man/man5/png.5 +1 -1
- data/cairo/src/tml/make/cairo_1.8.0-1_win32.log +1021 -0
- data/cairo/src/tml/make/cairo_1.8.0-1_win32.sh +68 -0
- data/cairo/src/tml/make/libpng_1.2.32-1_win32.log +269 -0
- data/cairo/src/tml/make/libpng_1.2.32-1_win32.sh +63 -0
- data/cairo/test/example_d.exe +0 -0
- data/cairo/test/minigzip_d.exe +0 -0
- data/cairo/test/testzlib_d.exe +0 -0
- data/cairo/test/untgz_d.exe +0 -0
- data/doc/en/cairo-context.html +81 -91
- data/doc/en/cairo-font-options.html +11 -26
- data/doc/en/cairo-text-cluster-flag.html +35 -0
- data/doc/en/cairo-user-font-face-text-to-glyphs-data.html +3 -3
- data/doc/en/cairo.html +38 -42
- data/doc/en/index.html +129 -142
- data/doc/ja/cairo-font-options.html +3 -25
- data/doc/ja/cairo-text-cluster-flag.html +46 -0
- data/doc/ja/cairo-user-font-face-text-to-glyphs-data.html +16 -15
- data/doc/ja/cairo.html +3 -7
- data/doc/ja/index.html +9 -17
- data/src/cairo.def +1 -1
- data/src/cairo.so +0 -0
- data/src/lib/cairo/constants.rb +3 -1
- data/src/libruby-cairo.a +0 -0
- data/src/rb_cairo.c +2 -2
- data/src/rb_cairo.h +5 -5
- data/src/rb_cairo_constants.c +12 -19
- data/src/rb_cairo_context.c +25 -21
- data/src/rb_cairo_font_face.c +44 -29
- data/src/rb_cairo_font_options.c +1 -23
- data/src/rb_cairo_scaled_font.c +5 -5
- data/test/test_constants.rb +6 -9
- data/test/test_context.rb +0 -12
- data/test/test_font_face.rb +7 -7
- data/test/test_font_options.rb +2 -21
- data/test/test_scaled_font.rb +3 -3
- data/test/test_text_to_glyphs_data.rb +19 -15
- metadata +68 -45
- data/cairo/make/cairo-1.6.4-2.sh +0 -55
- data/cairo/make/libpng-1.2.29.sh +0 -35
- data/cairo/manifest/cairo-1.6.4-2.mft +0 -6
- data/cairo/manifest/cairo-dev-1.6.4-2.mft +0 -72
- data/cairo/manifest/libpng-1.2.29.mft +0 -2
- data/cairo/share/gtk-doc/html/cairo/Drawing.html +0 -53
- data/cairo/share/gtk-doc/html/cairo/Fonts.html +0 -56
- data/cairo/share/gtk-doc/html/cairo/Support.html +0 -50
- data/cairo/share/gtk-doc/html/cairo/Surfaces.html +0 -65
- data/cairo/share/gtk-doc/html/cairo/cairo-Error-Handling.html +0 -328
- data/cairo/share/gtk-doc/html/cairo/cairo-Font-Options.html +0 -720
- data/cairo/share/gtk-doc/html/cairo/cairo-FreeType-Fonts.html +0 -297
- data/cairo/share/gtk-doc/html/cairo/cairo-Image-Surfaces.html +0 -484
- data/cairo/share/gtk-doc/html/cairo/cairo-PNG-Support.html +0 -345
- data/cairo/share/gtk-doc/html/cairo/cairo-Patterns.html +0 -1560
- data/cairo/share/gtk-doc/html/cairo/cairo-Quartz-Fonts.html +0 -161
- data/cairo/share/gtk-doc/html/cairo/cairo-SVG-Surfaces.html +0 -337
- data/cairo/share/gtk-doc/html/cairo/cairo-Scaled-Fonts.html +0 -823
- data/cairo/share/gtk-doc/html/cairo/cairo-Text.html +0 -836
- data/cairo/share/gtk-doc/html/cairo/cairo-Types.html +0 -143
- data/cairo/share/gtk-doc/html/cairo/cairo-Version-Information.html +0 -325
- data/cairo/share/gtk-doc/html/cairo/cairo-Win32-Fonts.html +0 -381
- data/cairo/share/gtk-doc/html/cairo/cairo-Win32-Surfaces.html +0 -331
- data/cairo/share/gtk-doc/html/cairo/cairo-cairo-font-face-t.html +0 -427
- data/cairo/share/gtk-doc/html/cairo/cairo-cairo-surface-t.html +0 -995
- data/cairo/share/gtk-doc/html/cairo/cairo-cairo-t.html +0 -2795
- data/cairo/share/gtk-doc/html/cairo/ix01.html +0 -693
- data/doc/en/cairo-lcd-filter.html +0 -39
- data/doc/ja/cairo-lcd-filter.html +0 -63
|
@@ -1,119 +1,115 @@
|
|
|
1
1
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
2
2
|
<html>
|
|
3
3
|
<head>
|
|
4
|
-
<meta http-equiv="Content-Type" content="text/html; charset=
|
|
4
|
+
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
|
5
5
|
<title>Paths</title>
|
|
6
6
|
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
|
|
7
7
|
<link rel="start" href="index.html" title="Cairo: A Vector Graphics Library">
|
|
8
|
-
<link rel="up" href="
|
|
9
|
-
<link rel="prev" href="cairo-
|
|
10
|
-
<link rel="next" href="cairo-
|
|
11
|
-
<meta name="generator" content="GTK-Doc V1.
|
|
8
|
+
<link rel="up" href="cairo-drawing.html" title="Drawing">
|
|
9
|
+
<link rel="prev" href="cairo-context.html" title="cairo_t">
|
|
10
|
+
<link rel="next" href="cairo-pattern.html" title="cairo_pattern_t">
|
|
11
|
+
<meta name="generator" content="GTK-Doc V1.10 (XML mode)">
|
|
12
12
|
<link rel="stylesheet" href="style.css" type="text/css">
|
|
13
|
-
<link rel="chapter" href="
|
|
14
|
-
<link rel="chapter" href="
|
|
15
|
-
<link rel="chapter" href="
|
|
16
|
-
<link rel="chapter" href="
|
|
17
|
-
<link rel="index" href="
|
|
13
|
+
<link rel="chapter" href="cairo-drawing.html" title="Drawing">
|
|
14
|
+
<link rel="chapter" href="cairo-fonts.html" title="Fonts">
|
|
15
|
+
<link rel="chapter" href="cairo-surfaces.html" title="Surfaces">
|
|
16
|
+
<link rel="chapter" href="cairo-support.html" title="Utilities">
|
|
17
|
+
<link rel="index" href="index-all.html" title="Index">
|
|
18
18
|
<link rel="index" href="index-1.2.html" title="Index of new symbols in 1.2">
|
|
19
19
|
<link rel="index" href="index-1.4.html" title="Index of new symbols in 1.4">
|
|
20
20
|
<link rel="index" href="index-1.6.html" title="Index of new symbols in 1.6">
|
|
21
|
-
<link rel="
|
|
21
|
+
<link rel="index" href="index-1.8.html" title="Index of new symbols in 1.8">
|
|
22
|
+
<link rel="appendix" href="language-bindings.html" title="Appendix A. Creating a language binding for cairo">
|
|
22
23
|
</head>
|
|
23
24
|
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
|
24
25
|
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
|
|
25
26
|
<tr valign="middle">
|
|
26
|
-
<td><a accesskey="p" href="cairo-
|
|
27
|
-
<td><a accesskey="u" href="
|
|
27
|
+
<td><a accesskey="p" href="cairo-context.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
|
|
28
|
+
<td><a accesskey="u" href="cairo-drawing.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
|
|
28
29
|
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
|
|
29
30
|
<th width="100%" align="center">Cairo: A Vector Graphics Library</th>
|
|
30
|
-
<td><a accesskey="n" href="cairo-
|
|
31
|
+
<td><a accesskey="n" href="cairo-pattern.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
|
|
31
32
|
</tr>
|
|
32
|
-
<tr><td colspan="5" class="shortcuts"><nobr><a href="#
|
|
33
|
-
|
|
34
|
-
<a href="#
|
|
33
|
+
<tr><td colspan="5" class="shortcuts"><nobr><a href="#cairo-paths.synopsis" class="shortcut">Top</a>
|
|
34
|
+
|
|
|
35
|
+
<a href="#cairo-paths.description" class="shortcut">Description</a></nobr></td></tr>
|
|
35
36
|
</table>
|
|
36
37
|
<div class="refentry" lang="en">
|
|
37
|
-
<a name="cairo-
|
|
38
|
+
<a name="cairo-paths"></a><div class="titlepage"></div>
|
|
38
39
|
<div class="refnamediv"><table width="100%"><tr>
|
|
39
40
|
<td valign="top">
|
|
40
|
-
<h2>
|
|
41
|
-
<
|
|
42
|
-
</h2>
|
|
43
|
-
<p>Paths — Creating paths and manipulating path data</p>
|
|
41
|
+
<h2><span class="refentrytitle"><a name="cairo-paths.top_of_page"></a>Paths</span></h2>
|
|
42
|
+
<p>Paths — Creating paths and manipulating path data</p>
|
|
44
43
|
</td>
|
|
45
44
|
<td valign="top" align="right"></td>
|
|
46
45
|
</tr></table></div>
|
|
47
46
|
<div class="refsynopsisdiv">
|
|
48
|
-
<h2>Synopsis</h2>
|
|
47
|
+
<a name="cairo-paths.synopsis"></a><h2>Synopsis</h2>
|
|
49
48
|
<pre class="synopsis">
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
<a class="link" href="cairo-
|
|
57
|
-
<a class="link" href="cairo-
|
|
58
|
-
|
|
59
|
-
void <a class="link" href="cairo-
|
|
60
|
-
const <a class="link" href="cairo-Paths.html#cairo-path-t">cairo_path_t</a> *path);
|
|
61
|
-
<a class="link" href="cairo-Types.html#cairo-bool-t">cairo_bool_t</a> <a class="link" href="cairo-Paths.html#cairo-has-current-point">cairo_has_current_point</a> (<a class="link" href="cairo-cairo-t.html#cairo-t">cairo_t</a> *cr);
|
|
62
|
-
void <a class="link" href="cairo-Paths.html#cairo-get-current-point">cairo_get_current_point</a> (<a class="link" href="cairo-cairo-t.html#cairo-t">cairo_t</a> *cr,
|
|
49
|
+
<a class="link" href="cairo-paths.html#cairo-path-t" title="cairo_path_t">cairo_path_t</a>;
|
|
50
|
+
union <a class="link" href="cairo-paths.html#cairo-path-data-t" title="union cairo_path_data_t">cairo_path_data_t</a>;
|
|
51
|
+
enum <a class="link" href="cairo-paths.html#cairo-path-data-type-t" title="enum cairo_path_data_type_t">cairo_path_data_type_t</a>;
|
|
52
|
+
<a class="link" href="cairo-paths.html#cairo-path-t" title="cairo_path_t">cairo_path_t</a>* <a class="link" href="cairo-paths.html#cairo-copy-path" title="cairo_copy_path ()">cairo_copy_path</a> (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr);
|
|
53
|
+
<a class="link" href="cairo-paths.html#cairo-path-t" title="cairo_path_t">cairo_path_t</a>* <a class="link" href="cairo-paths.html#cairo-copy-path-flat" title="cairo_copy_path_flat ()">cairo_copy_path_flat</a> (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr);
|
|
54
|
+
void <a class="link" href="cairo-paths.html#cairo-path-destroy" title="cairo_path_destroy ()">cairo_path_destroy</a> (<a class="link" href="cairo-paths.html#cairo-path-t" title="cairo_path_t">cairo_path_t</a> *path);
|
|
55
|
+
void <a class="link" href="cairo-paths.html#cairo-append-path" title="cairo_append_path ()">cairo_append_path</a> (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
|
56
|
+
const <a class="link" href="cairo-paths.html#cairo-path-t" title="cairo_path_t">cairo_path_t</a> *path);
|
|
57
|
+
<a class="link" href="cairo-types.html#cairo-bool-t" title="cairo_bool_t">cairo_bool_t</a> <a class="link" href="cairo-paths.html#cairo-has-current-point" title="cairo_has_current_point ()">cairo_has_current_point</a> (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr);
|
|
58
|
+
void <a class="link" href="cairo-paths.html#cairo-get-current-point" title="cairo_get_current_point ()">cairo_get_current_point</a> (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
|
63
59
|
double *x,
|
|
64
60
|
double *y);
|
|
65
|
-
void <a class="link" href="cairo-
|
|
66
|
-
void <a class="link" href="cairo-
|
|
67
|
-
void <a class="link" href="cairo-
|
|
68
|
-
void <a class="link" href="cairo-
|
|
61
|
+
void <a class="link" href="cairo-paths.html#cairo-new-path" title="cairo_new_path ()">cairo_new_path</a> (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr);
|
|
62
|
+
void <a class="link" href="cairo-paths.html#cairo-new-sub-path" title="cairo_new_sub_path ()">cairo_new_sub_path</a> (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr);
|
|
63
|
+
void <a class="link" href="cairo-paths.html#cairo-close-path" title="cairo_close_path ()">cairo_close_path</a> (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr);
|
|
64
|
+
void <a class="link" href="cairo-paths.html#cairo-arc" title="cairo_arc ()">cairo_arc</a> (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
|
69
65
|
double xc,
|
|
70
66
|
double yc,
|
|
71
67
|
double radius,
|
|
72
68
|
double angle1,
|
|
73
69
|
double angle2);
|
|
74
|
-
void <a class="link" href="cairo-
|
|
70
|
+
void <a class="link" href="cairo-paths.html#cairo-arc-negative" title="cairo_arc_negative ()">cairo_arc_negative</a> (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
|
75
71
|
double xc,
|
|
76
72
|
double yc,
|
|
77
73
|
double radius,
|
|
78
74
|
double angle1,
|
|
79
75
|
double angle2);
|
|
80
|
-
void <a class="link" href="cairo-
|
|
76
|
+
void <a class="link" href="cairo-paths.html#cairo-curve-to" title="cairo_curve_to ()">cairo_curve_to</a> (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
|
81
77
|
double x1,
|
|
82
78
|
double y1,
|
|
83
79
|
double x2,
|
|
84
80
|
double y2,
|
|
85
81
|
double x3,
|
|
86
82
|
double y3);
|
|
87
|
-
void <a class="link" href="cairo-
|
|
83
|
+
void <a class="link" href="cairo-paths.html#cairo-line-to" title="cairo_line_to ()">cairo_line_to</a> (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
|
88
84
|
double x,
|
|
89
85
|
double y);
|
|
90
|
-
void <a class="link" href="cairo-
|
|
86
|
+
void <a class="link" href="cairo-paths.html#cairo-move-to" title="cairo_move_to ()">cairo_move_to</a> (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
|
91
87
|
double x,
|
|
92
88
|
double y);
|
|
93
|
-
void <a class="link" href="cairo-
|
|
89
|
+
void <a class="link" href="cairo-paths.html#cairo-rectangle" title="cairo_rectangle ()">cairo_rectangle</a> (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
|
94
90
|
double x,
|
|
95
91
|
double y,
|
|
96
92
|
double width,
|
|
97
93
|
double height);
|
|
98
|
-
void <a class="link" href="cairo-
|
|
99
|
-
const <a class="link" href="cairo-
|
|
94
|
+
void <a class="link" href="cairo-paths.html#cairo-glyph-path" title="cairo_glyph_path ()">cairo_glyph_path</a> (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
|
95
|
+
const <a class="link" href="cairo-text.html#cairo-glyph-t" title="cairo_glyph_t">cairo_glyph_t</a> *glyphs,
|
|
100
96
|
int num_glyphs);
|
|
101
|
-
void <a class="link" href="cairo-
|
|
97
|
+
void <a class="link" href="cairo-paths.html#cairo-text-path" title="cairo_text_path ()">cairo_text_path</a> (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
|
102
98
|
const char *utf8);
|
|
103
|
-
void <a class="link" href="cairo-
|
|
99
|
+
void <a class="link" href="cairo-paths.html#cairo-rel-curve-to" title="cairo_rel_curve_to ()">cairo_rel_curve_to</a> (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
|
104
100
|
double dx1,
|
|
105
101
|
double dy1,
|
|
106
102
|
double dx2,
|
|
107
103
|
double dy2,
|
|
108
104
|
double dx3,
|
|
109
105
|
double dy3);
|
|
110
|
-
void <a class="link" href="cairo-
|
|
106
|
+
void <a class="link" href="cairo-paths.html#cairo-rel-line-to" title="cairo_rel_line_to ()">cairo_rel_line_to</a> (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
|
111
107
|
double dx,
|
|
112
108
|
double dy);
|
|
113
|
-
void <a class="link" href="cairo-
|
|
109
|
+
void <a class="link" href="cairo-paths.html#cairo-rel-move-to" title="cairo_rel_move_to ()">cairo_rel_move_to</a> (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
|
114
110
|
double dx,
|
|
115
111
|
double dy);
|
|
116
|
-
void <a class="link" href="cairo-
|
|
112
|
+
void <a class="link" href="cairo-paths.html#cairo-path-extents" title="cairo_path_extents ()">cairo_path_extents</a> (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
|
117
113
|
double *x1,
|
|
118
114
|
double *y1,
|
|
119
115
|
double *x2,
|
|
@@ -121,18 +117,17 @@ void <a class="link" href="cairo-Paths.html#cairo-path-extents">c
|
|
|
121
117
|
</pre>
|
|
122
118
|
</div>
|
|
123
119
|
<div class="refsect1" lang="en">
|
|
124
|
-
<a name="
|
|
120
|
+
<a name="cairo-paths.description"></a><h2>Description</h2>
|
|
125
121
|
<p>
|
|
126
122
|
Paths are the most basic drawing tools and are primarily used to implicitly
|
|
127
123
|
generate simple masks.
|
|
128
124
|
</p>
|
|
129
125
|
</div>
|
|
130
126
|
<div class="refsect1" lang="en">
|
|
131
|
-
<a name="
|
|
127
|
+
<a name="cairo-paths.details"></a><h2>Details</h2>
|
|
132
128
|
<div class="refsect2" lang="en">
|
|
133
|
-
<a name="
|
|
134
|
-
<
|
|
135
|
-
<a class="indexterm" name="id2624902"></a><pre class="programlisting">typedef struct {
|
|
129
|
+
<a name="cairo-path-t"></a><h3>cairo_path_t</h3>
|
|
130
|
+
<pre class="programlisting">typedef struct {
|
|
136
131
|
cairo_status_t status;
|
|
137
132
|
cairo_path_data_t *data;
|
|
138
133
|
int num_data;
|
|
@@ -140,18 +135,18 @@ generate simple masks.
|
|
|
140
135
|
</pre>
|
|
141
136
|
<p>
|
|
142
137
|
A data structure for holding a path. This data structure serves as
|
|
143
|
-
the return value for <a class="link" href="cairo-
|
|
144
|
-
<a class="link" href="cairo-
|
|
145
|
-
<a class="link" href="cairo-
|
|
138
|
+
the return value for <a class="link" href="cairo-paths.html#cairo-copy-path" title="cairo_copy_path ()"><code class="function">cairo_copy_path()</code></a> and
|
|
139
|
+
<a class="link" href="cairo-paths.html#cairo-copy-path-flat" title="cairo_copy_path_flat ()"><code class="function">cairo_copy_path_flat()</code></a> as well the input value for
|
|
140
|
+
<a class="link" href="cairo-paths.html#cairo-append-path" title="cairo_append_path ()"><code class="function">cairo_append_path()</code></a>.
|
|
146
141
|
</p>
|
|
147
142
|
<p>
|
|
148
|
-
See <a class="link" href="cairo-
|
|
143
|
+
See <a class="link" href="cairo-paths.html#cairo-path-data-t" title="union cairo_path_data_t"><span class="type">cairo_path_data_t</span></a> for hints on how to iterate over the
|
|
149
144
|
actual data within the path.
|
|
150
145
|
</p>
|
|
151
146
|
<p>
|
|
152
147
|
The num_data member gives the number of elements in the data
|
|
153
148
|
array. This number is larger than the number of independent path
|
|
154
|
-
portions (defined in <a class="link" href="cairo-
|
|
149
|
+
portions (defined in <a class="link" href="cairo-paths.html#cairo-path-data-type-t" title="enum cairo_path_data_type_t"><span class="type">cairo_path_data_type_t</span></a>), since the data
|
|
155
150
|
includes both headers and coordinates for each portion.</p>
|
|
156
151
|
<p>
|
|
157
152
|
|
|
@@ -160,17 +155,17 @@ includes both headers and coordinates for each portion.</p>
|
|
|
160
155
|
<col align="left" valign="top">
|
|
161
156
|
<tbody>
|
|
162
157
|
<tr>
|
|
163
|
-
<td><p><span class="term"><a class="link" href="cairo-
|
|
158
|
+
<td><p><span class="term"><a class="link" href="cairo-error-status.html#cairo-status-t" title="enum cairo_status_t">cairo_status_t</a> <em class="structfield"><code>status</code></em>;</span></p></td>
|
|
164
159
|
<td> the current error status
|
|
165
160
|
</td>
|
|
166
161
|
</tr>
|
|
167
162
|
<tr>
|
|
168
|
-
<td><p><span class="term"><a class="link" href="cairo-
|
|
163
|
+
<td><p><span class="term"><a class="link" href="cairo-paths.html#cairo-path-data-t" title="union cairo_path_data_t">cairo_path_data_t</a> *<em class="structfield"><code>data</code></em>;</span></p></td>
|
|
169
164
|
<td> the elements in the path
|
|
170
165
|
</td>
|
|
171
166
|
</tr>
|
|
172
167
|
<tr>
|
|
173
|
-
<td><p><span class="term">int
|
|
168
|
+
<td><p><span class="term">int <em class="structfield"><code>num_data</code></em>;</span></p></td>
|
|
174
169
|
<td> the number of elements in the data array
|
|
175
170
|
</td>
|
|
176
171
|
</tr>
|
|
@@ -179,9 +174,8 @@ includes both headers and coordinates for each portion.</p>
|
|
|
179
174
|
</div>
|
|
180
175
|
<hr>
|
|
181
176
|
<div class="refsect2" lang="en">
|
|
182
|
-
<a name="
|
|
183
|
-
<
|
|
184
|
-
<a class="indexterm" name="id2577585"></a><pre class="programlisting">union cairo_path_data_t {
|
|
177
|
+
<a name="cairo-path-data-t"></a><h3>union cairo_path_data_t</h3>
|
|
178
|
+
<pre class="programlisting">union cairo_path_data_t {
|
|
185
179
|
struct {
|
|
186
180
|
cairo_path_data_type_t type;
|
|
187
181
|
int length;
|
|
@@ -192,13 +186,13 @@ includes both headers and coordinates for each portion.</p>
|
|
|
192
186
|
};
|
|
193
187
|
</pre>
|
|
194
188
|
<p>
|
|
195
|
-
<a class="link" href="cairo-
|
|
196
|
-
<a class="link" href="cairo-
|
|
189
|
+
<a class="link" href="cairo-paths.html#cairo-path-data-t" title="union cairo_path_data_t"><span class="type">cairo_path_data_t</span></a> is used to represent the path data inside a
|
|
190
|
+
<a class="link" href="cairo-paths.html#cairo-path-t" title="cairo_path_t"><span class="type">cairo_path_t</span></a>.
|
|
197
191
|
</p>
|
|
198
192
|
<p>
|
|
199
193
|
The data structure is designed to try to balance the demands of
|
|
200
194
|
efficiency and ease-of-use. A path is represented as an array of
|
|
201
|
-
<a class="link" href="cairo-
|
|
195
|
+
<a class="link" href="cairo-paths.html#cairo-path-data-t" title="union cairo_path_data_t"><span class="type">cairo_path_data_t</span></a>, which is a union of headers and points.
|
|
202
196
|
</p>
|
|
203
197
|
<p>
|
|
204
198
|
Each portion of the path is represented by one or more elements in
|
|
@@ -219,8 +213,8 @@ where the number of points for each element type is as follows:
|
|
|
219
213
|
</p>
|
|
220
214
|
<p>
|
|
221
215
|
The semantics and ordering of the coordinate values are consistent
|
|
222
|
-
with <a class="link" href="cairo-
|
|
223
|
-
<a class="link" href="cairo-
|
|
216
|
+
with <a class="link" href="cairo-paths.html#cairo-move-to" title="cairo_move_to ()"><code class="function">cairo_move_to()</code></a>, <a class="link" href="cairo-paths.html#cairo-line-to" title="cairo_line_to ()"><code class="function">cairo_line_to()</code></a>, <a class="link" href="cairo-paths.html#cairo-curve-to" title="cairo_curve_to ()"><code class="function">cairo_curve_to()</code></a>, and
|
|
217
|
+
<a class="link" href="cairo-paths.html#cairo-close-path" title="cairo_close_path ()"><code class="function">cairo_close_path()</code></a>.
|
|
224
218
|
</p>
|
|
225
219
|
<p>
|
|
226
220
|
Here is sample code for iterating through a <span class="type">""</span>
|
|
@@ -229,26 +223,26 @@ Here is sample code for iterating through a <span class="type">""</span>
|
|
|
229
223
|
</p>
|
|
230
224
|
<div class="informalexample"><pre class="programlisting">
|
|
231
225
|
int i;
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
226
|
+
cairo_path_t *path;
|
|
227
|
+
cairo_path_data_t *data;
|
|
228
|
+
|
|
235
229
|
path = cairo_copy_path (cr);
|
|
236
|
-
|
|
230
|
+
|
|
237
231
|
for (i=0; i < path->num_data; i += path->data[i].header.length) {
|
|
238
232
|
data = &path->data[i];
|
|
239
233
|
switch (data->header.type) {
|
|
240
|
-
case
|
|
234
|
+
case CAIRO_PATH_MOVE_TO:
|
|
241
235
|
do_move_to_things (data[1].point.x, data[1].point.y);
|
|
242
236
|
break;
|
|
243
|
-
case
|
|
237
|
+
case CAIRO_PATH_LINE_TO:
|
|
244
238
|
do_line_to_things (data[1].point.x, data[1].point.y);
|
|
245
239
|
break;
|
|
246
|
-
case
|
|
240
|
+
case CAIRO_PATH_CURVE_TO:
|
|
247
241
|
do_curve_to_things (data[1].point.x, data[1].point.y,
|
|
248
242
|
data[2].point.x, data[2].point.y,
|
|
249
243
|
data[3].point.x, data[3].point.y);
|
|
250
244
|
break;
|
|
251
|
-
case
|
|
245
|
+
case CAIRO_PATH_CLOSE_PATH:
|
|
252
246
|
do_close_path_things ();
|
|
253
247
|
break;
|
|
254
248
|
}
|
|
@@ -271,9 +265,8 @@ elements for each element type.</p>
|
|
|
271
265
|
</div>
|
|
272
266
|
<hr>
|
|
273
267
|
<div class="refsect2" lang="en">
|
|
274
|
-
<a name="
|
|
275
|
-
<
|
|
276
|
-
<a class="indexterm" name="id2577755"></a><pre class="programlisting">typedef enum _cairo_path_data_type {
|
|
268
|
+
<a name="cairo-path-data-type-t"></a><h3>enum cairo_path_data_type_t</h3>
|
|
269
|
+
<pre class="programlisting">typedef enum _cairo_path_data_type {
|
|
277
270
|
CAIRO_PATH_MOVE_TO,
|
|
278
271
|
CAIRO_PATH_LINE_TO,
|
|
279
272
|
CAIRO_PATH_CURVE_TO,
|
|
@@ -281,9 +274,9 @@ elements for each element type.</p>
|
|
|
281
274
|
} cairo_path_data_type_t;
|
|
282
275
|
</pre>
|
|
283
276
|
<p>
|
|
284
|
-
<a class="link" href="cairo-
|
|
285
|
-
of a path when represented as a <a class="link" href="cairo-
|
|
286
|
-
See <a class="link" href="cairo-
|
|
277
|
+
<a class="link" href="cairo-paths.html#cairo-path-data-t" title="union cairo_path_data_t"><span class="type">cairo_path_data_t</span></a> is used to describe the type of one portion
|
|
278
|
+
of a path when represented as a <a class="link" href="cairo-paths.html#cairo-path-t" title="cairo_path_t"><span class="type">cairo_path_t</span></a>.
|
|
279
|
+
See <a class="link" href="cairo-paths.html#cairo-path-data-t" title="union cairo_path_data_t"><span class="type">cairo_path_data_t</span></a> for details.</p>
|
|
287
280
|
<p>
|
|
288
281
|
|
|
289
282
|
</p>
|
|
@@ -291,22 +284,22 @@ See <a class="link" href="cairo-Paths.html#cairo-path-data-t"><span class="type"
|
|
|
291
284
|
<col align="left" valign="top">
|
|
292
285
|
<tbody>
|
|
293
286
|
<tr>
|
|
294
|
-
<td><p><
|
|
287
|
+
<td><p><a name="CAIRO-PATH-MOVE-TO:CAPS"></a><span class="term"><code class="literal">CAIRO_PATH_MOVE_TO</code></span></p></td>
|
|
295
288
|
<td> A move-to operation
|
|
296
289
|
</td>
|
|
297
290
|
</tr>
|
|
298
291
|
<tr>
|
|
299
|
-
<td><p><
|
|
292
|
+
<td><p><a name="CAIRO-PATH-LINE-TO:CAPS"></a><span class="term"><code class="literal">CAIRO_PATH_LINE_TO</code></span></p></td>
|
|
300
293
|
<td> A line-to operation
|
|
301
294
|
</td>
|
|
302
295
|
</tr>
|
|
303
296
|
<tr>
|
|
304
|
-
<td><p><
|
|
297
|
+
<td><p><a name="CAIRO-PATH-CURVE-TO:CAPS"></a><span class="term"><code class="literal">CAIRO_PATH_CURVE_TO</code></span></p></td>
|
|
305
298
|
<td> A curve-to operation
|
|
306
299
|
</td>
|
|
307
300
|
</tr>
|
|
308
301
|
<tr>
|
|
309
|
-
<td><p><
|
|
302
|
+
<td><p><a name="CAIRO-PATH-CLOSE-PATH:CAPS"></a><span class="term"><code class="literal">CAIRO_PATH_CLOSE_PATH</code></span></p></td>
|
|
310
303
|
<td> A close-path operation
|
|
311
304
|
</td>
|
|
312
305
|
</tr>
|
|
@@ -315,12 +308,11 @@ See <a class="link" href="cairo-Paths.html#cairo-path-data-t"><span class="type"
|
|
|
315
308
|
</div>
|
|
316
309
|
<hr>
|
|
317
310
|
<div class="refsect2" lang="en">
|
|
318
|
-
<a name="
|
|
319
|
-
<a
|
|
320
|
-
<a class="indexterm" name="id2577900"></a><pre class="programlisting"><a class="link" href="cairo-Paths.html#cairo-path-t">cairo_path_t</a>* cairo_copy_path (<a class="link" href="cairo-cairo-t.html#cairo-t">cairo_t</a> *cr);</pre>
|
|
311
|
+
<a name="cairo-copy-path"></a><h3>cairo_copy_path ()</h3>
|
|
312
|
+
<pre class="programlisting"><a class="link" href="cairo-paths.html#cairo-path-t" title="cairo_path_t">cairo_path_t</a>* cairo_copy_path (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr);</pre>
|
|
321
313
|
<p>
|
|
322
314
|
Creates a copy of the current path and returns it to the user as a
|
|
323
|
-
<a class="link" href="cairo-
|
|
315
|
+
<a class="link" href="cairo-paths.html#cairo-path-t" title="cairo_path_t"><span class="type">cairo_path_t</span></a>. See <a class="link" href="cairo-paths.html#cairo-path-data-t" title="union cairo_path_data_t"><span class="type">cairo_path_data_t</span></a> for hints on how to iterate
|
|
324
316
|
over the returned data structure.
|
|
325
317
|
</p>
|
|
326
318
|
<p>
|
|
@@ -334,16 +326,16 @@ conditions hold:
|
|
|
334
326
|
<div class="orderedlist"><ol type="1">
|
|
335
327
|
<li>If there is insufficient memory to copy the path. In this
|
|
336
328
|
case <code class="literal">path->status</code> will be set to
|
|
337
|
-
<a class="link" href="cairo-
|
|
329
|
+
<a class="link" href="cairo-error-status.html#CAIRO-STATUS-NO-MEMORY:CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a>.</li>
|
|
338
330
|
<li>If <em class="parameter"><code>cr</code></em> is already in an error state. In this case
|
|
339
331
|
<code class="literal">path->status</code> will contain the same status that
|
|
340
|
-
would be returned by <a class="link" href="cairo-
|
|
332
|
+
would be returned by <a class="link" href="cairo-context.html#cairo-status" title="cairo_status ()"><code class="function">cairo_status()</code></a>.</li>
|
|
341
333
|
</ol></div>
|
|
342
334
|
<p>
|
|
343
335
|
</p>
|
|
344
336
|
<p>
|
|
345
337
|
In either case, <code class="literal">path->status</code> will be set to
|
|
346
|
-
<a class="link" href="cairo-
|
|
338
|
+
<a class="link" href="cairo-error-status.html#CAIRO-STATUS-NO-MEMORY:CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a> (regardless of what the error status in
|
|
347
339
|
<em class="parameter"><code>cr</code></em> might have been).</p>
|
|
348
340
|
<p>
|
|
349
341
|
|
|
@@ -352,14 +344,14 @@ In either case, <code class="literal">path->status</code> will be set to
|
|
|
352
344
|
<col align="left" valign="top">
|
|
353
345
|
<tbody>
|
|
354
346
|
<tr>
|
|
355
|
-
<td><p><span class="term"><em class="parameter"><code>cr</code></em
|
|
347
|
+
<td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
|
|
356
348
|
<td> a cairo context
|
|
357
349
|
</td>
|
|
358
350
|
</tr>
|
|
359
351
|
<tr>
|
|
360
|
-
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span
|
|
352
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
361
353
|
<td> the copy of the current path. The caller owns the
|
|
362
|
-
returned object and should call <a class="link" href="cairo-
|
|
354
|
+
returned object and should call <a class="link" href="cairo-paths.html#cairo-path-destroy" title="cairo_path_destroy ()"><code class="function">cairo_path_destroy()</code></a> when finished
|
|
363
355
|
with it.
|
|
364
356
|
</td>
|
|
365
357
|
</tr>
|
|
@@ -368,21 +360,20 @@ with it.
|
|
|
368
360
|
</div>
|
|
369
361
|
<hr>
|
|
370
362
|
<div class="refsect2" lang="en">
|
|
371
|
-
<a name="
|
|
372
|
-
<a
|
|
373
|
-
<a class="indexterm" name="id2578104"></a><pre class="programlisting"><a class="link" href="cairo-Paths.html#cairo-path-t">cairo_path_t</a>* cairo_copy_path_flat (<a class="link" href="cairo-cairo-t.html#cairo-t">cairo_t</a> *cr);</pre>
|
|
363
|
+
<a name="cairo-copy-path-flat"></a><h3>cairo_copy_path_flat ()</h3>
|
|
364
|
+
<pre class="programlisting"><a class="link" href="cairo-paths.html#cairo-path-t" title="cairo_path_t">cairo_path_t</a>* cairo_copy_path_flat (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr);</pre>
|
|
374
365
|
<p>
|
|
375
366
|
Gets a flattened copy of the current path and returns it to the
|
|
376
|
-
user as a <a class="link" href="cairo-
|
|
367
|
+
user as a <a class="link" href="cairo-paths.html#cairo-path-t" title="cairo_path_t"><span class="type">cairo_path_t</span></a>. See <a class="link" href="cairo-paths.html#cairo-path-data-t" title="union cairo_path_data_t"><span class="type">cairo_path_data_t</span></a> for hints on
|
|
377
368
|
how to iterate over the returned data structure.
|
|
378
369
|
</p>
|
|
379
370
|
<p>
|
|
380
|
-
This function is like <a class="link" href="cairo-
|
|
371
|
+
This function is like <a class="link" href="cairo-paths.html#cairo-copy-path" title="cairo_copy_path ()"><code class="function">cairo_copy_path()</code></a> except that any curves
|
|
381
372
|
in the path will be approximated with piecewise-linear
|
|
382
373
|
approximations, (accurate to within the current tolerance
|
|
383
374
|
value). That is, the result is guaranteed to not have any elements
|
|
384
|
-
of type <a class="link" href="cairo-
|
|
385
|
-
series of <a class="link" href="cairo-
|
|
375
|
+
of type <a class="link" href="cairo-paths.html#CAIRO-PATH-CURVE-TO:CAPS"><code class="literal">CAIRO_PATH_CURVE_TO</code></a> which will instead be replaced by a
|
|
376
|
+
series of <a class="link" href="cairo-paths.html#CAIRO-PATH-LINE-TO:CAPS"><code class="literal">CAIRO_PATH_LINE_TO</code></a> elements.
|
|
386
377
|
</p>
|
|
387
378
|
<p>
|
|
388
379
|
This function will always return a valid pointer, but the result
|
|
@@ -395,10 +386,10 @@ conditions hold:
|
|
|
395
386
|
<div class="orderedlist"><ol type="1">
|
|
396
387
|
<li>If there is insufficient memory to copy the path. In this
|
|
397
388
|
case <code class="literal">path->status</code> will be set to
|
|
398
|
-
<a class="link" href="cairo-
|
|
389
|
+
<a class="link" href="cairo-error-status.html#CAIRO-STATUS-NO-MEMORY:CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a>.</li>
|
|
399
390
|
<li>If <em class="parameter"><code>cr</code></em> is already in an error state. In this case
|
|
400
391
|
<code class="literal">path->status</code> will contain the same status that
|
|
401
|
-
would be returned by <a class="link" href="cairo-
|
|
392
|
+
would be returned by <a class="link" href="cairo-context.html#cairo-status" title="cairo_status ()"><code class="function">cairo_status()</code></a>.</li>
|
|
402
393
|
</ol></div>
|
|
403
394
|
<p>
|
|
404
395
|
|
|
@@ -407,14 +398,14 @@ conditions hold:
|
|
|
407
398
|
<col align="left" valign="top">
|
|
408
399
|
<tbody>
|
|
409
400
|
<tr>
|
|
410
|
-
<td><p><span class="term"><em class="parameter"><code>cr</code></em
|
|
401
|
+
<td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
|
|
411
402
|
<td> a cairo context
|
|
412
403
|
</td>
|
|
413
404
|
</tr>
|
|
414
405
|
<tr>
|
|
415
|
-
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span
|
|
406
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
416
407
|
<td> the copy of the current path. The caller owns the
|
|
417
|
-
returned object and should call <a class="link" href="cairo-
|
|
408
|
+
returned object and should call <a class="link" href="cairo-paths.html#cairo-path-destroy" title="cairo_path_destroy ()"><code class="function">cairo_path_destroy()</code></a> when finished
|
|
418
409
|
with it.
|
|
419
410
|
</td>
|
|
420
411
|
</tr>
|
|
@@ -423,17 +414,16 @@ with it.
|
|
|
423
414
|
</div>
|
|
424
415
|
<hr>
|
|
425
416
|
<div class="refsect2" lang="en">
|
|
426
|
-
<a name="
|
|
427
|
-
<a
|
|
428
|
-
<a class="indexterm" name="id2578321"></a><pre class="programlisting">void cairo_path_destroy (<a class="link" href="cairo-Paths.html#cairo-path-t">cairo_path_t</a> *path);</pre>
|
|
417
|
+
<a name="cairo-path-destroy"></a><h3>cairo_path_destroy ()</h3>
|
|
418
|
+
<pre class="programlisting">void cairo_path_destroy (<a class="link" href="cairo-paths.html#cairo-path-t" title="cairo_path_t">cairo_path_t</a> *path);</pre>
|
|
429
419
|
<p>
|
|
430
420
|
Immediately releases all memory associated with <em class="parameter"><code>path</code></em>. After a call
|
|
431
|
-
to <a class="link" href="cairo-
|
|
421
|
+
to <a class="link" href="cairo-paths.html#cairo-path-destroy" title="cairo_path_destroy ()"><code class="function">cairo_path_destroy()</code></a> the <em class="parameter"><code>path</code></em> pointer is no longer valid and
|
|
432
422
|
should not be used further.
|
|
433
423
|
</p>
|
|
434
424
|
<p>
|
|
435
|
-
Note: <a class="link" href="cairo-
|
|
436
|
-
pointer to a <a class="link" href="cairo-
|
|
425
|
+
Note: <a class="link" href="cairo-paths.html#cairo-path-destroy" title="cairo_path_destroy ()"><code class="function">cairo_path_destroy()</code></a> should only be called with a
|
|
426
|
+
pointer to a <a class="link" href="cairo-paths.html#cairo-path-t" title="cairo_path_t"><span class="type">cairo_path_t</span></a> returned by a cairo function. Any path
|
|
437
427
|
that is created manually (ie. outside of cairo) should be destroyed
|
|
438
428
|
manually as well.</p>
|
|
439
429
|
<p>
|
|
@@ -442,26 +432,25 @@ manually as well.</p>
|
|
|
442
432
|
<div class="variablelist"><table border="0">
|
|
443
433
|
<col align="left" valign="top">
|
|
444
434
|
<tbody><tr>
|
|
445
|
-
<td><p><span class="term"><em class="parameter"><code>path</code></em
|
|
446
|
-
<td> a path previously returned by either <a class="link" href="cairo-
|
|
447
|
-
<a class="link" href="cairo-
|
|
435
|
+
<td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td>
|
|
436
|
+
<td> a path previously returned by either <a class="link" href="cairo-paths.html#cairo-copy-path" title="cairo_copy_path ()"><code class="function">cairo_copy_path()</code></a> or
|
|
437
|
+
<a class="link" href="cairo-paths.html#cairo-copy-path-flat" title="cairo_copy_path_flat ()"><code class="function">cairo_copy_path_flat()</code></a>.
|
|
448
438
|
</td>
|
|
449
439
|
</tr></tbody>
|
|
450
440
|
</table></div>
|
|
451
441
|
</div>
|
|
452
442
|
<hr>
|
|
453
443
|
<div class="refsect2" lang="en">
|
|
454
|
-
<a name="
|
|
455
|
-
<a
|
|
456
|
-
|
|
457
|
-
const <a class="link" href="cairo-Paths.html#cairo-path-t">cairo_path_t</a> *path);</pre>
|
|
444
|
+
<a name="cairo-append-path"></a><h3>cairo_append_path ()</h3>
|
|
445
|
+
<pre class="programlisting">void cairo_append_path (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
|
446
|
+
const <a class="link" href="cairo-paths.html#cairo-path-t" title="cairo_path_t">cairo_path_t</a> *path);</pre>
|
|
458
447
|
<p>
|
|
459
448
|
Append the <em class="parameter"><code>path</code></em> onto the current path. The <em class="parameter"><code>path</code></em> may be either the
|
|
460
|
-
return value from one of <a class="link" href="cairo-
|
|
461
|
-
<a class="link" href="cairo-
|
|
462
|
-
<a class="link" href="cairo-
|
|
449
|
+
return value from one of <a class="link" href="cairo-paths.html#cairo-copy-path" title="cairo_copy_path ()"><code class="function">cairo_copy_path()</code></a> or
|
|
450
|
+
<a class="link" href="cairo-paths.html#cairo-copy-path-flat" title="cairo_copy_path_flat ()"><code class="function">cairo_copy_path_flat()</code></a> or it may be constructed manually. See
|
|
451
|
+
<a class="link" href="cairo-paths.html#cairo-path-t" title="cairo_path_t"><span class="type">cairo_path_t</span></a> for details on how the path data structure should be
|
|
463
452
|
initialized, and note that <code class="literal">path->status</code> must be
|
|
464
|
-
initialized to <a class="link" href="cairo-
|
|
453
|
+
initialized to <a class="link" href="cairo-error-status.html#CAIRO-STATUS-SUCCESS:CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a>.</p>
|
|
465
454
|
<p>
|
|
466
455
|
|
|
467
456
|
</p>
|
|
@@ -469,12 +458,12 @@ initialized to <a class="link" href="cairo-Error-Handling.html#CAIRO-STATUS-SUCC
|
|
|
469
458
|
<col align="left" valign="top">
|
|
470
459
|
<tbody>
|
|
471
460
|
<tr>
|
|
472
|
-
<td><p><span class="term"><em class="parameter"><code>cr</code></em
|
|
461
|
+
<td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
|
|
473
462
|
<td> a cairo context
|
|
474
463
|
</td>
|
|
475
464
|
</tr>
|
|
476
465
|
<tr>
|
|
477
|
-
<td><p><span class="term"><em class="parameter"><code>path</code></em
|
|
466
|
+
<td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td>
|
|
478
467
|
<td> path to be appended
|
|
479
468
|
</td>
|
|
480
469
|
</tr>
|
|
@@ -483,12 +472,11 @@ initialized to <a class="link" href="cairo-Error-Handling.html#CAIRO-STATUS-SUCC
|
|
|
483
472
|
</div>
|
|
484
473
|
<hr>
|
|
485
474
|
<div class="refsect2" lang="en">
|
|
486
|
-
<a name="
|
|
487
|
-
<a
|
|
488
|
-
<a class="indexterm" name="id2578585"></a><pre class="programlisting"><a class="link" href="cairo-Types.html#cairo-bool-t">cairo_bool_t</a> cairo_has_current_point (<a class="link" href="cairo-cairo-t.html#cairo-t">cairo_t</a> *cr);</pre>
|
|
475
|
+
<a name="cairo-has-current-point"></a><h3>cairo_has_current_point ()</h3>
|
|
476
|
+
<pre class="programlisting"><a class="link" href="cairo-types.html#cairo-bool-t" title="cairo_bool_t">cairo_bool_t</a> cairo_has_current_point (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr);</pre>
|
|
489
477
|
<p>
|
|
490
478
|
Returns whether a current point is defined on the current path.
|
|
491
|
-
See <a class="link" href="cairo-
|
|
479
|
+
See <a class="link" href="cairo-paths.html#cairo-get-current-point" title="cairo_get_current_point ()"><code class="function">cairo_get_current_point()</code></a> for details on the current point.</p>
|
|
492
480
|
<p>
|
|
493
481
|
|
|
494
482
|
</p>
|
|
@@ -496,12 +484,12 @@ See <a class="link" href="cairo-Paths.html#cairo-get-current-point"><code class=
|
|
|
496
484
|
<col align="left" valign="top">
|
|
497
485
|
<tbody>
|
|
498
486
|
<tr>
|
|
499
|
-
<td><p><span class="term"><em class="parameter"><code>cr</code></em
|
|
487
|
+
<td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
|
|
500
488
|
<td> a cairo context
|
|
501
489
|
</td>
|
|
502
490
|
</tr>
|
|
503
491
|
<tr>
|
|
504
|
-
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span
|
|
492
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
505
493
|
<td> whether a current point is defined.
|
|
506
494
|
|
|
507
495
|
</td>
|
|
@@ -513,9 +501,8 @@ See <a class="link" href="cairo-Paths.html#cairo-get-current-point"><code class=
|
|
|
513
501
|
</div>
|
|
514
502
|
<hr>
|
|
515
503
|
<div class="refsect2" lang="en">
|
|
516
|
-
<a name="
|
|
517
|
-
<a
|
|
518
|
-
<a class="indexterm" name="id2578674"></a><pre class="programlisting">void cairo_get_current_point (<a class="link" href="cairo-cairo-t.html#cairo-t">cairo_t</a> *cr,
|
|
504
|
+
<a name="cairo-get-current-point"></a><h3>cairo_get_current_point ()</h3>
|
|
505
|
+
<pre class="programlisting">void cairo_get_current_point (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
|
519
506
|
double *x,
|
|
520
507
|
double *y);</pre>
|
|
521
508
|
<p>
|
|
@@ -526,26 +513,26 @@ conceptually the final point reached by the path so far.
|
|
|
526
513
|
The current point is returned in the user-space coordinate
|
|
527
514
|
system. If there is no defined current point or if <em class="parameter"><code>cr</code></em> is in an
|
|
528
515
|
error status, <em class="parameter"><code>x</code></em> and <em class="parameter"><code>y</code></em> will both be set to 0.0. It is possible to
|
|
529
|
-
check this in advance with <a class="link" href="cairo-
|
|
516
|
+
check this in advance with <a class="link" href="cairo-paths.html#cairo-has-current-point" title="cairo_has_current_point ()"><code class="function">cairo_has_current_point()</code></a>.
|
|
530
517
|
</p>
|
|
531
518
|
<p>
|
|
532
519
|
Most path construction functions alter the current point. See the
|
|
533
520
|
following for details on how they affect the current point:
|
|
534
|
-
<a class="link" href="cairo-
|
|
535
|
-
<a class="link" href="cairo-
|
|
536
|
-
<a class="link" href="cairo-
|
|
537
|
-
<a class="link" href="cairo-
|
|
538
|
-
<a class="link" href="cairo-
|
|
539
|
-
<a class="link" href="cairo-
|
|
521
|
+
<a class="link" href="cairo-paths.html#cairo-new-path" title="cairo_new_path ()"><code class="function">cairo_new_path()</code></a>, <a class="link" href="cairo-paths.html#cairo-new-sub-path" title="cairo_new_sub_path ()"><code class="function">cairo_new_sub_path()</code></a>,
|
|
522
|
+
<a class="link" href="cairo-paths.html#cairo-append-path" title="cairo_append_path ()"><code class="function">cairo_append_path()</code></a>, <a class="link" href="cairo-paths.html#cairo-close-path" title="cairo_close_path ()"><code class="function">cairo_close_path()</code></a>,
|
|
523
|
+
<a class="link" href="cairo-paths.html#cairo-move-to" title="cairo_move_to ()"><code class="function">cairo_move_to()</code></a>, <a class="link" href="cairo-paths.html#cairo-line-to" title="cairo_line_to ()"><code class="function">cairo_line_to()</code></a>, <a class="link" href="cairo-paths.html#cairo-curve-to" title="cairo_curve_to ()"><code class="function">cairo_curve_to()</code></a>,
|
|
524
|
+
<a class="link" href="cairo-paths.html#cairo-rel-move-to" title="cairo_rel_move_to ()"><code class="function">cairo_rel_move_to()</code></a>, <a class="link" href="cairo-paths.html#cairo-rel-line-to" title="cairo_rel_line_to ()"><code class="function">cairo_rel_line_to()</code></a>, <a class="link" href="cairo-paths.html#cairo-rel-curve-to" title="cairo_rel_curve_to ()"><code class="function">cairo_rel_curve_to()</code></a>,
|
|
525
|
+
<a class="link" href="cairo-paths.html#cairo-arc" title="cairo_arc ()"><code class="function">cairo_arc()</code></a>, <a class="link" href="cairo-paths.html#cairo-arc-negative" title="cairo_arc_negative ()"><code class="function">cairo_arc_negative()</code></a>, <a class="link" href="cairo-paths.html#cairo-rectangle" title="cairo_rectangle ()"><code class="function">cairo_rectangle()</code></a>,
|
|
526
|
+
<a class="link" href="cairo-paths.html#cairo-text-path" title="cairo_text_path ()"><code class="function">cairo_text_path()</code></a>, <a class="link" href="cairo-paths.html#cairo-glyph-path" title="cairo_glyph_path ()"><code class="function">cairo_glyph_path()</code></a>, <code class="function">cairo_stroke_to_path()</code>.
|
|
540
527
|
</p>
|
|
541
528
|
<p>
|
|
542
|
-
Some functions use and alter the current point but do not
|
|
543
|
-
change current path:
|
|
544
|
-
<a class="link" href="cairo-
|
|
529
|
+
Some functions use and alter the current point but do not
|
|
530
|
+
otherwise change current path:
|
|
531
|
+
<a class="link" href="cairo-text.html#cairo-show-text" title="cairo_show_text ()"><code class="function">cairo_show_text()</code></a>.
|
|
545
532
|
</p>
|
|
546
533
|
<p>
|
|
547
534
|
Some functions unset the current path and as a result, current point:
|
|
548
|
-
<a class="link" href="cairo-
|
|
535
|
+
<a class="link" href="cairo-context.html#cairo-fill" title="cairo_fill ()"><code class="function">cairo_fill()</code></a>, <a class="link" href="cairo-context.html#cairo-stroke" title="cairo_stroke ()"><code class="function">cairo_stroke()</code></a>.</p>
|
|
549
536
|
<p>
|
|
550
537
|
|
|
551
538
|
</p>
|
|
@@ -553,17 +540,17 @@ Some functions unset the current path and as a result, current point:
|
|
|
553
540
|
<col align="left" valign="top">
|
|
554
541
|
<tbody>
|
|
555
542
|
<tr>
|
|
556
|
-
<td><p><span class="term"><em class="parameter"><code>cr</code></em
|
|
543
|
+
<td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
|
|
557
544
|
<td> a cairo context
|
|
558
545
|
</td>
|
|
559
546
|
</tr>
|
|
560
547
|
<tr>
|
|
561
|
-
<td><p><span class="term"><em class="parameter"><code>x</code></em
|
|
548
|
+
<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
|
|
562
549
|
<td> return value for X coordinate of the current point
|
|
563
550
|
</td>
|
|
564
551
|
</tr>
|
|
565
552
|
<tr>
|
|
566
|
-
<td><p><span class="term"><em class="parameter"><code>y</code></em
|
|
553
|
+
<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
|
|
567
554
|
<td> return value for Y coordinate of the current point
|
|
568
555
|
</td>
|
|
569
556
|
</tr>
|
|
@@ -572,9 +559,8 @@ Some functions unset the current path and as a result, current point:
|
|
|
572
559
|
</div>
|
|
573
560
|
<hr>
|
|
574
561
|
<div class="refsect2" lang="en">
|
|
575
|
-
<a name="
|
|
576
|
-
<a
|
|
577
|
-
<a class="indexterm" name="id2579018"></a><pre class="programlisting">void cairo_new_path (<a class="link" href="cairo-cairo-t.html#cairo-t">cairo_t</a> *cr);</pre>
|
|
562
|
+
<a name="cairo-new-path"></a><h3>cairo_new_path ()</h3>
|
|
563
|
+
<pre class="programlisting">void cairo_new_path (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr);</pre>
|
|
578
564
|
<p>
|
|
579
565
|
Clears the current path. After this call there will be no path and
|
|
580
566
|
no current point.</p>
|
|
@@ -584,7 +570,7 @@ no current point.</p>
|
|
|
584
570
|
<div class="variablelist"><table border="0">
|
|
585
571
|
<col align="left" valign="top">
|
|
586
572
|
<tbody><tr>
|
|
587
|
-
<td><p><span class="term"><em class="parameter"><code>cr</code></em
|
|
573
|
+
<td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
|
|
588
574
|
<td> a cairo context
|
|
589
575
|
</td>
|
|
590
576
|
</tr></tbody>
|
|
@@ -592,30 +578,29 @@ no current point.</p>
|
|
|
592
578
|
</div>
|
|
593
579
|
<hr>
|
|
594
580
|
<div class="refsect2" lang="en">
|
|
595
|
-
<a name="
|
|
596
|
-
<a
|
|
597
|
-
<a class="indexterm" name="id2579082"></a><pre class="programlisting">void cairo_new_sub_path (<a class="link" href="cairo-cairo-t.html#cairo-t">cairo_t</a> *cr);</pre>
|
|
581
|
+
<a name="cairo-new-sub-path"></a><h3>cairo_new_sub_path ()</h3>
|
|
582
|
+
<pre class="programlisting">void cairo_new_sub_path (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr);</pre>
|
|
598
583
|
<p>
|
|
599
584
|
Begin a new sub-path. Note that the existing path is not
|
|
600
585
|
affected. After this call there will be no current point.
|
|
601
586
|
</p>
|
|
602
587
|
<p>
|
|
603
588
|
In many cases, this call is not needed since new sub-paths are
|
|
604
|
-
frequently started with <a class="link" href="cairo-
|
|
589
|
+
frequently started with <a class="link" href="cairo-paths.html#cairo-move-to" title="cairo_move_to ()"><code class="function">cairo_move_to()</code></a>.
|
|
605
590
|
</p>
|
|
606
591
|
<p>
|
|
607
|
-
A call to <a class="link" href="cairo-
|
|
608
|
-
beginning a new sub-path with one of the <a class="link" href="cairo-
|
|
592
|
+
A call to <a class="link" href="cairo-paths.html#cairo-new-sub-path" title="cairo_new_sub_path ()"><code class="function">cairo_new_sub_path()</code></a> is particularly useful when
|
|
593
|
+
beginning a new sub-path with one of the <a class="link" href="cairo-paths.html#cairo-arc" title="cairo_arc ()"><code class="function">cairo_arc()</code></a> calls. This
|
|
609
594
|
makes things easier as it is no longer necessary to manually
|
|
610
595
|
compute the arc's initial coordinates for a call to
|
|
611
|
-
<a class="link" href="cairo-
|
|
596
|
+
<a class="link" href="cairo-paths.html#cairo-move-to" title="cairo_move_to ()"><code class="function">cairo_move_to()</code></a>.</p>
|
|
612
597
|
<p>
|
|
613
598
|
|
|
614
599
|
</p>
|
|
615
600
|
<div class="variablelist"><table border="0">
|
|
616
601
|
<col align="left" valign="top">
|
|
617
602
|
<tbody><tr>
|
|
618
|
-
<td><p><span class="term"><em class="parameter"><code>cr</code></em
|
|
603
|
+
<td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
|
|
619
604
|
<td> a cairo context
|
|
620
605
|
</td>
|
|
621
606
|
</tr></tbody>
|
|
@@ -625,30 +610,29 @@ compute the arc's initial coordinates for a call to
|
|
|
625
610
|
</div>
|
|
626
611
|
<hr>
|
|
627
612
|
<div class="refsect2" lang="en">
|
|
628
|
-
<a name="
|
|
629
|
-
<a
|
|
630
|
-
<a class="indexterm" name="id2579201"></a><pre class="programlisting">void cairo_close_path (<a class="link" href="cairo-cairo-t.html#cairo-t">cairo_t</a> *cr);</pre>
|
|
613
|
+
<a name="cairo-close-path"></a><h3>cairo_close_path ()</h3>
|
|
614
|
+
<pre class="programlisting">void cairo_close_path (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr);</pre>
|
|
631
615
|
<p>
|
|
632
616
|
Adds a line segment to the path from the current point to the
|
|
633
617
|
beginning of the current sub-path, (the most recent point passed to
|
|
634
|
-
<a class="link" href="cairo-
|
|
618
|
+
<a class="link" href="cairo-paths.html#cairo-move-to" title="cairo_move_to ()"><code class="function">cairo_move_to()</code></a>), and closes this sub-path. After this call the
|
|
635
619
|
current point will be at the joined endpoint of the sub-path.
|
|
636
620
|
</p>
|
|
637
621
|
<p>
|
|
638
|
-
The behavior of <a class="link" href="cairo-
|
|
639
|
-
<a class="link" href="cairo-
|
|
622
|
+
The behavior of <a class="link" href="cairo-paths.html#cairo-close-path" title="cairo_close_path ()"><code class="function">cairo_close_path()</code></a> is distinct from simply calling
|
|
623
|
+
<a class="link" href="cairo-paths.html#cairo-line-to" title="cairo_line_to ()"><code class="function">cairo_line_to()</code></a> with the equivalent coordinate in the case of
|
|
640
624
|
stroking. When a closed sub-path is stroked, there are no caps on
|
|
641
625
|
the ends of the sub-path. Instead, there is a line join connecting
|
|
642
626
|
the final and initial segments of the sub-path.
|
|
643
627
|
</p>
|
|
644
628
|
<p>
|
|
645
|
-
If there is no current point before the call to <a class="link" href="cairo-
|
|
629
|
+
If there is no current point before the call to <a class="link" href="cairo-paths.html#cairo-close-path" title="cairo_close_path ()"><code class="function">cairo_close_path()</code></a>,
|
|
646
630
|
this function will have no effect.
|
|
647
631
|
</p>
|
|
648
632
|
<p>
|
|
649
|
-
Note: As of cairo version 1.2.4 any call to <a class="link" href="cairo-
|
|
633
|
+
Note: As of cairo version 1.2.4 any call to <a class="link" href="cairo-paths.html#cairo-close-path" title="cairo_close_path ()"><code class="function">cairo_close_path()</code></a> will
|
|
650
634
|
place an explicit MOVE_TO element into the path immediately after
|
|
651
|
-
the CLOSE_PATH element, (which can be seen in <a class="link" href="cairo-
|
|
635
|
+
the CLOSE_PATH element, (which can be seen in <a class="link" href="cairo-paths.html#cairo-copy-path" title="cairo_copy_path ()"><code class="function">cairo_copy_path()</code></a> for
|
|
652
636
|
example). This can simplify path processing in some cases as it may
|
|
653
637
|
not be necessary to save the "last move_to point" during processing
|
|
654
638
|
as the MOVE_TO immediately after the CLOSE_PATH will provide that
|
|
@@ -659,7 +643,7 @@ point.</p>
|
|
|
659
643
|
<div class="variablelist"><table border="0">
|
|
660
644
|
<col align="left" valign="top">
|
|
661
645
|
<tbody><tr>
|
|
662
|
-
<td><p><span class="term"><em class="parameter"><code>cr</code></em
|
|
646
|
+
<td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
|
|
663
647
|
<td> a cairo context
|
|
664
648
|
</td>
|
|
665
649
|
</tr></tbody>
|
|
@@ -667,9 +651,8 @@ point.</p>
|
|
|
667
651
|
</div>
|
|
668
652
|
<hr>
|
|
669
653
|
<div class="refsect2" lang="en">
|
|
670
|
-
<a name="
|
|
671
|
-
<a
|
|
672
|
-
<a class="indexterm" name="id2579347"></a><pre class="programlisting">void cairo_arc (<a class="link" href="cairo-cairo-t.html#cairo-t">cairo_t</a> *cr,
|
|
654
|
+
<a name="cairo-arc"></a><h3>cairo_arc ()</h3>
|
|
655
|
+
<pre class="programlisting">void cairo_arc (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
|
673
656
|
double xc,
|
|
674
657
|
double yc,
|
|
675
658
|
double radius,
|
|
@@ -686,7 +669,7 @@ until it is greater than <em class="parameter"><code>angle1</code></em>.
|
|
|
686
669
|
If there is a current point, an initial line segment will be added
|
|
687
670
|
to the path to connect the current point to the beginning of the
|
|
688
671
|
arc. If this initial line is undesired, it can be avoided by
|
|
689
|
-
calling <a class="link" href="cairo-
|
|
672
|
+
calling <a class="link" href="cairo-paths.html#cairo-new-sub-path" title="cairo_new_sub_path ()"><code class="function">cairo_new_sub_path()</code></a> before calling <a class="link" href="cairo-paths.html#cairo-arc" title="cairo_arc ()"><code class="function">cairo_arc()</code></a>.
|
|
690
673
|
</p>
|
|
691
674
|
<p>
|
|
692
675
|
Angles are measured in radians. An angle of 0.0 is in the direction
|
|
@@ -702,7 +685,7 @@ matrix, angles increase in a clockwise direction.
|
|
|
702
685
|
</p>
|
|
703
686
|
<p>
|
|
704
687
|
This function gives the arc in the direction of increasing angles;
|
|
705
|
-
see <a class="link" href="cairo-
|
|
688
|
+
see <a class="link" href="cairo-paths.html#cairo-arc-negative" title="cairo_arc_negative ()"><code class="function">cairo_arc_negative()</code></a> to get the arc in the direction of
|
|
706
689
|
decreasing angles.
|
|
707
690
|
</p>
|
|
708
691
|
<p>
|
|
@@ -727,32 +710,32 @@ cairo_restore (cr);
|
|
|
727
710
|
<col align="left" valign="top">
|
|
728
711
|
<tbody>
|
|
729
712
|
<tr>
|
|
730
|
-
<td><p><span class="term"><em class="parameter"><code>cr</code></em
|
|
713
|
+
<td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
|
|
731
714
|
<td> a cairo context
|
|
732
715
|
</td>
|
|
733
716
|
</tr>
|
|
734
717
|
<tr>
|
|
735
|
-
<td><p><span class="term"><em class="parameter"><code>xc</code></em
|
|
718
|
+
<td><p><span class="term"><em class="parameter"><code>xc</code></em> :</span></p></td>
|
|
736
719
|
<td> X position of the center of the arc
|
|
737
720
|
</td>
|
|
738
721
|
</tr>
|
|
739
722
|
<tr>
|
|
740
|
-
<td><p><span class="term"><em class="parameter"><code>yc</code></em
|
|
723
|
+
<td><p><span class="term"><em class="parameter"><code>yc</code></em> :</span></p></td>
|
|
741
724
|
<td> Y position of the center of the arc
|
|
742
725
|
</td>
|
|
743
726
|
</tr>
|
|
744
727
|
<tr>
|
|
745
|
-
<td><p><span class="term"><em class="parameter"><code>radius</code></em
|
|
728
|
+
<td><p><span class="term"><em class="parameter"><code>radius</code></em> :</span></p></td>
|
|
746
729
|
<td> the radius of the arc
|
|
747
730
|
</td>
|
|
748
731
|
</tr>
|
|
749
732
|
<tr>
|
|
750
|
-
<td><p><span class="term"><em class="parameter"><code>angle1</code></em
|
|
733
|
+
<td><p><span class="term"><em class="parameter"><code>angle1</code></em> :</span></p></td>
|
|
751
734
|
<td> the start angle, in radians
|
|
752
735
|
</td>
|
|
753
736
|
</tr>
|
|
754
737
|
<tr>
|
|
755
|
-
<td><p><span class="term"><em class="parameter"><code>angle2</code></em
|
|
738
|
+
<td><p><span class="term"><em class="parameter"><code>angle2</code></em> :</span></p></td>
|
|
756
739
|
<td> the end angle, in radians
|
|
757
740
|
</td>
|
|
758
741
|
</tr>
|
|
@@ -761,9 +744,8 @@ cairo_restore (cr);
|
|
|
761
744
|
</div>
|
|
762
745
|
<hr>
|
|
763
746
|
<div class="refsect2" lang="en">
|
|
764
|
-
<a name="
|
|
765
|
-
<a
|
|
766
|
-
<a class="indexterm" name="id2579679"></a><pre class="programlisting">void cairo_arc_negative (<a class="link" href="cairo-cairo-t.html#cairo-t">cairo_t</a> *cr,
|
|
747
|
+
<a name="cairo-arc-negative"></a><h3>cairo_arc_negative ()</h3>
|
|
748
|
+
<pre class="programlisting">void cairo_arc_negative (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
|
767
749
|
double xc,
|
|
768
750
|
double yc,
|
|
769
751
|
double radius,
|
|
@@ -777,7 +759,7 @@ greater than <em class="parameter"><code>angle1</code></em> it will be progressi
|
|
|
777
759
|
until it is less than <em class="parameter"><code>angle1</code></em>.
|
|
778
760
|
</p>
|
|
779
761
|
<p>
|
|
780
|
-
See <a class="link" href="cairo-
|
|
762
|
+
See <a class="link" href="cairo-paths.html#cairo-arc" title="cairo_arc ()"><code class="function">cairo_arc()</code></a> for more details. This function differs only in the
|
|
781
763
|
direction of the arc between the two angles.</p>
|
|
782
764
|
<p>
|
|
783
765
|
|
|
@@ -786,32 +768,32 @@ direction of the arc between the two angles.</p>
|
|
|
786
768
|
<col align="left" valign="top">
|
|
787
769
|
<tbody>
|
|
788
770
|
<tr>
|
|
789
|
-
<td><p><span class="term"><em class="parameter"><code>cr</code></em
|
|
771
|
+
<td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
|
|
790
772
|
<td> a cairo context
|
|
791
773
|
</td>
|
|
792
774
|
</tr>
|
|
793
775
|
<tr>
|
|
794
|
-
<td><p><span class="term"><em class="parameter"><code>xc</code></em
|
|
776
|
+
<td><p><span class="term"><em class="parameter"><code>xc</code></em> :</span></p></td>
|
|
795
777
|
<td> X position of the center of the arc
|
|
796
778
|
</td>
|
|
797
779
|
</tr>
|
|
798
780
|
<tr>
|
|
799
|
-
<td><p><span class="term"><em class="parameter"><code>yc</code></em
|
|
781
|
+
<td><p><span class="term"><em class="parameter"><code>yc</code></em> :</span></p></td>
|
|
800
782
|
<td> Y position of the center of the arc
|
|
801
783
|
</td>
|
|
802
784
|
</tr>
|
|
803
785
|
<tr>
|
|
804
|
-
<td><p><span class="term"><em class="parameter"><code>radius</code></em
|
|
786
|
+
<td><p><span class="term"><em class="parameter"><code>radius</code></em> :</span></p></td>
|
|
805
787
|
<td> the radius of the arc
|
|
806
788
|
</td>
|
|
807
789
|
</tr>
|
|
808
790
|
<tr>
|
|
809
|
-
<td><p><span class="term"><em class="parameter"><code>angle1</code></em
|
|
791
|
+
<td><p><span class="term"><em class="parameter"><code>angle1</code></em> :</span></p></td>
|
|
810
792
|
<td> the start angle, in radians
|
|
811
793
|
</td>
|
|
812
794
|
</tr>
|
|
813
795
|
<tr>
|
|
814
|
-
<td><p><span class="term"><em class="parameter"><code>angle2</code></em
|
|
796
|
+
<td><p><span class="term"><em class="parameter"><code>angle2</code></em> :</span></p></td>
|
|
815
797
|
<td> the end angle, in radians
|
|
816
798
|
</td>
|
|
817
799
|
</tr>
|
|
@@ -820,9 +802,8 @@ direction of the arc between the two angles.</p>
|
|
|
820
802
|
</div>
|
|
821
803
|
<hr>
|
|
822
804
|
<div class="refsect2" lang="en">
|
|
823
|
-
<a name="
|
|
824
|
-
<a
|
|
825
|
-
<a class="indexterm" name="id2579912"></a><pre class="programlisting">void cairo_curve_to (<a class="link" href="cairo-cairo-t.html#cairo-t">cairo_t</a> *cr,
|
|
805
|
+
<a name="cairo-curve-to"></a><h3>cairo_curve_to ()</h3>
|
|
806
|
+
<pre class="programlisting">void cairo_curve_to (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
|
826
807
|
double x1,
|
|
827
808
|
double y1,
|
|
828
809
|
double x2,
|
|
@@ -830,15 +811,15 @@ direction of the arc between the two angles.</p>
|
|
|
830
811
|
double x3,
|
|
831
812
|
double y3);</pre>
|
|
832
813
|
<p>
|
|
833
|
-
Adds a cubic
|
|
814
|
+
Adds a cubic Bézier spline to the path from the current point to
|
|
834
815
|
position (<em class="parameter"><code>x3</code></em>, <em class="parameter"><code>y3</code></em>) in user-space coordinates, using (<em class="parameter"><code>x1</code></em>, <em class="parameter"><code>y1</code></em>) and
|
|
835
816
|
(<em class="parameter"><code>x2</code></em>, <em class="parameter"><code>y2</code></em>) as the control points. After this call the current point
|
|
836
817
|
will be (<em class="parameter"><code>x3</code></em>, <em class="parameter"><code>y3</code></em>).
|
|
837
818
|
</p>
|
|
838
819
|
<p>
|
|
839
|
-
If there is no current point before the call to <a class="link" href="cairo-
|
|
820
|
+
If there is no current point before the call to <a class="link" href="cairo-paths.html#cairo-curve-to" title="cairo_curve_to ()"><code class="function">cairo_curve_to()</code></a>
|
|
840
821
|
this function will behave as if preceded by a call to
|
|
841
|
-
cairo_move_to
|
|
822
|
+
cairo_move_to(<em class="parameter"><code>cr</code></em>, <em class="parameter"><code>x1</code></em>, <em class="parameter"><code>y1</code></em>).</p>
|
|
842
823
|
<p>
|
|
843
824
|
|
|
844
825
|
</p>
|
|
@@ -846,37 +827,37 @@ cairo_move_to (<em class="parameter"><code>cr</code></em>, <em class="parameter"
|
|
|
846
827
|
<col align="left" valign="top">
|
|
847
828
|
<tbody>
|
|
848
829
|
<tr>
|
|
849
|
-
<td><p><span class="term"><em class="parameter"><code>cr</code></em
|
|
830
|
+
<td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
|
|
850
831
|
<td> a cairo context
|
|
851
832
|
</td>
|
|
852
833
|
</tr>
|
|
853
834
|
<tr>
|
|
854
|
-
<td><p><span class="term"><em class="parameter"><code>x1</code></em
|
|
835
|
+
<td><p><span class="term"><em class="parameter"><code>x1</code></em> :</span></p></td>
|
|
855
836
|
<td> the X coordinate of the first control point
|
|
856
837
|
</td>
|
|
857
838
|
</tr>
|
|
858
839
|
<tr>
|
|
859
|
-
<td><p><span class="term"><em class="parameter"><code>y1</code></em
|
|
840
|
+
<td><p><span class="term"><em class="parameter"><code>y1</code></em> :</span></p></td>
|
|
860
841
|
<td> the Y coordinate of the first control point
|
|
861
842
|
</td>
|
|
862
843
|
</tr>
|
|
863
844
|
<tr>
|
|
864
|
-
<td><p><span class="term"><em class="parameter"><code>x2</code></em
|
|
845
|
+
<td><p><span class="term"><em class="parameter"><code>x2</code></em> :</span></p></td>
|
|
865
846
|
<td> the X coordinate of the second control point
|
|
866
847
|
</td>
|
|
867
848
|
</tr>
|
|
868
849
|
<tr>
|
|
869
|
-
<td><p><span class="term"><em class="parameter"><code>y2</code></em
|
|
850
|
+
<td><p><span class="term"><em class="parameter"><code>y2</code></em> :</span></p></td>
|
|
870
851
|
<td> the Y coordinate of the second control point
|
|
871
852
|
</td>
|
|
872
853
|
</tr>
|
|
873
854
|
<tr>
|
|
874
|
-
<td><p><span class="term"><em class="parameter"><code>x3</code></em
|
|
855
|
+
<td><p><span class="term"><em class="parameter"><code>x3</code></em> :</span></p></td>
|
|
875
856
|
<td> the X coordinate of the end of the curve
|
|
876
857
|
</td>
|
|
877
858
|
</tr>
|
|
878
859
|
<tr>
|
|
879
|
-
<td><p><span class="term"><em class="parameter"><code>y3</code></em
|
|
860
|
+
<td><p><span class="term"><em class="parameter"><code>y3</code></em> :</span></p></td>
|
|
880
861
|
<td> the Y coordinate of the end of the curve
|
|
881
862
|
</td>
|
|
882
863
|
</tr>
|
|
@@ -885,9 +866,8 @@ cairo_move_to (<em class="parameter"><code>cr</code></em>, <em class="parameter"
|
|
|
885
866
|
</div>
|
|
886
867
|
<hr>
|
|
887
868
|
<div class="refsect2" lang="en">
|
|
888
|
-
<a name="
|
|
889
|
-
<a
|
|
890
|
-
<a class="indexterm" name="id2580189"></a><pre class="programlisting">void cairo_line_to (<a class="link" href="cairo-cairo-t.html#cairo-t">cairo_t</a> *cr,
|
|
869
|
+
<a name="cairo-line-to"></a><h3>cairo_line_to ()</h3>
|
|
870
|
+
<pre class="programlisting">void cairo_line_to (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
|
891
871
|
double x,
|
|
892
872
|
double y);</pre>
|
|
893
873
|
<p>
|
|
@@ -896,8 +876,8 @@ in user-space coordinates. After this call the current point
|
|
|
896
876
|
will be (<em class="parameter"><code>x</code></em>, <em class="parameter"><code>y</code></em>).
|
|
897
877
|
</p>
|
|
898
878
|
<p>
|
|
899
|
-
If there is no current point before the call to <a class="link" href="cairo-
|
|
900
|
-
this function will behave as cairo_move_to
|
|
879
|
+
If there is no current point before the call to <a class="link" href="cairo-paths.html#cairo-line-to" title="cairo_line_to ()"><code class="function">cairo_line_to()</code></a>
|
|
880
|
+
this function will behave as cairo_move_to(<em class="parameter"><code>cr</code></em>, <em class="parameter"><code>x</code></em>, <em class="parameter"><code>y</code></em>).</p>
|
|
901
881
|
<p>
|
|
902
882
|
|
|
903
883
|
</p>
|
|
@@ -905,17 +885,17 @@ this function will behave as cairo_move_to (<em class="parameter"><code>cr</code
|
|
|
905
885
|
<col align="left" valign="top">
|
|
906
886
|
<tbody>
|
|
907
887
|
<tr>
|
|
908
|
-
<td><p><span class="term"><em class="parameter"><code>cr</code></em
|
|
888
|
+
<td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
|
|
909
889
|
<td> a cairo context
|
|
910
890
|
</td>
|
|
911
891
|
</tr>
|
|
912
892
|
<tr>
|
|
913
|
-
<td><p><span class="term"><em class="parameter"><code>x</code></em
|
|
893
|
+
<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
|
|
914
894
|
<td> the X coordinate of the end of the new line
|
|
915
895
|
</td>
|
|
916
896
|
</tr>
|
|
917
897
|
<tr>
|
|
918
|
-
<td><p><span class="term"><em class="parameter"><code>y</code></em
|
|
898
|
+
<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
|
|
919
899
|
<td> the Y coordinate of the end of the new line
|
|
920
900
|
</td>
|
|
921
901
|
</tr>
|
|
@@ -924,9 +904,8 @@ this function will behave as cairo_move_to (<em class="parameter"><code>cr</code
|
|
|
924
904
|
</div>
|
|
925
905
|
<hr>
|
|
926
906
|
<div class="refsect2" lang="en">
|
|
927
|
-
<a name="
|
|
928
|
-
<a
|
|
929
|
-
<a class="indexterm" name="id2580354"></a><pre class="programlisting">void cairo_move_to (<a class="link" href="cairo-cairo-t.html#cairo-t">cairo_t</a> *cr,
|
|
907
|
+
<a name="cairo-move-to"></a><h3>cairo_move_to ()</h3>
|
|
908
|
+
<pre class="programlisting">void cairo_move_to (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
|
930
909
|
double x,
|
|
931
910
|
double y);</pre>
|
|
932
911
|
<p>
|
|
@@ -939,17 +918,17 @@ Begin a new sub-path. After this call the current point will be (<em class="para
|
|
|
939
918
|
<col align="left" valign="top">
|
|
940
919
|
<tbody>
|
|
941
920
|
<tr>
|
|
942
|
-
<td><p><span class="term"><em class="parameter"><code>cr</code></em
|
|
921
|
+
<td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
|
|
943
922
|
<td> a cairo context
|
|
944
923
|
</td>
|
|
945
924
|
</tr>
|
|
946
925
|
<tr>
|
|
947
|
-
<td><p><span class="term"><em class="parameter"><code>x</code></em
|
|
926
|
+
<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
|
|
948
927
|
<td> the X coordinate of the new position
|
|
949
928
|
</td>
|
|
950
929
|
</tr>
|
|
951
930
|
<tr>
|
|
952
|
-
<td><p><span class="term"><em class="parameter"><code>y</code></em
|
|
931
|
+
<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
|
|
953
932
|
<td> the Y coordinate of the new position
|
|
954
933
|
</td>
|
|
955
934
|
</tr>
|
|
@@ -958,9 +937,8 @@ Begin a new sub-path. After this call the current point will be (<em class="para
|
|
|
958
937
|
</div>
|
|
959
938
|
<hr>
|
|
960
939
|
<div class="refsect2" lang="en">
|
|
961
|
-
<a name="
|
|
962
|
-
<a
|
|
963
|
-
<a class="indexterm" name="id2580473"></a><pre class="programlisting">void cairo_rectangle (<a class="link" href="cairo-cairo-t.html#cairo-t">cairo_t</a> *cr,
|
|
940
|
+
<a name="cairo-rectangle"></a><h3>cairo_rectangle ()</h3>
|
|
941
|
+
<pre class="programlisting">void cairo_rectangle (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
|
964
942
|
double x,
|
|
965
943
|
double y,
|
|
966
944
|
double width,
|
|
@@ -986,27 +964,27 @@ cairo_close_path (cr);
|
|
|
986
964
|
<col align="left" valign="top">
|
|
987
965
|
<tbody>
|
|
988
966
|
<tr>
|
|
989
|
-
<td><p><span class="term"><em class="parameter"><code>cr</code></em
|
|
967
|
+
<td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
|
|
990
968
|
<td> a cairo context
|
|
991
969
|
</td>
|
|
992
970
|
</tr>
|
|
993
971
|
<tr>
|
|
994
|
-
<td><p><span class="term"><em class="parameter"><code>x</code></em
|
|
972
|
+
<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
|
|
995
973
|
<td> the X coordinate of the top left corner of the rectangle
|
|
996
974
|
</td>
|
|
997
975
|
</tr>
|
|
998
976
|
<tr>
|
|
999
|
-
<td><p><span class="term"><em class="parameter"><code>y</code></em
|
|
977
|
+
<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
|
|
1000
978
|
<td> the Y coordinate to the top left corner of the rectangle
|
|
1001
979
|
</td>
|
|
1002
980
|
</tr>
|
|
1003
981
|
<tr>
|
|
1004
|
-
<td><p><span class="term"><em class="parameter"><code>width</code></em
|
|
982
|
+
<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td>
|
|
1005
983
|
<td> the width of the rectangle
|
|
1006
984
|
</td>
|
|
1007
985
|
</tr>
|
|
1008
986
|
<tr>
|
|
1009
|
-
<td><p><span class="term"><em class="parameter"><code>height</code></em
|
|
987
|
+
<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td>
|
|
1010
988
|
<td> the height of the rectangle
|
|
1011
989
|
</td>
|
|
1012
990
|
</tr>
|
|
@@ -1015,15 +993,14 @@ cairo_close_path (cr);
|
|
|
1015
993
|
</div>
|
|
1016
994
|
<hr>
|
|
1017
995
|
<div class="refsect2" lang="en">
|
|
1018
|
-
<a name="
|
|
1019
|
-
<a
|
|
1020
|
-
|
|
1021
|
-
const <a class="link" href="cairo-Text.html#cairo-glyph-t">cairo_glyph_t</a> *glyphs,
|
|
996
|
+
<a name="cairo-glyph-path"></a><h3>cairo_glyph_path ()</h3>
|
|
997
|
+
<pre class="programlisting">void cairo_glyph_path (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
|
998
|
+
const <a class="link" href="cairo-text.html#cairo-glyph-t" title="cairo_glyph_t">cairo_glyph_t</a> *glyphs,
|
|
1022
999
|
int num_glyphs);</pre>
|
|
1023
1000
|
<p>
|
|
1024
1001
|
Adds closed paths for the glyphs to the current path. The generated
|
|
1025
1002
|
path if filled, achieves an effect similar to that of
|
|
1026
|
-
<a class="link" href="cairo-
|
|
1003
|
+
<a class="link" href="cairo-text.html#cairo-show-glyphs" title="cairo_show_glyphs ()"><code class="function">cairo_show_glyphs()</code></a>.</p>
|
|
1027
1004
|
<p>
|
|
1028
1005
|
|
|
1029
1006
|
</p>
|
|
@@ -1031,17 +1008,17 @@ path if filled, achieves an effect similar to that of
|
|
|
1031
1008
|
<col align="left" valign="top">
|
|
1032
1009
|
<tbody>
|
|
1033
1010
|
<tr>
|
|
1034
|
-
<td><p><span class="term"><em class="parameter"><code>cr</code></em
|
|
1011
|
+
<td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
|
|
1035
1012
|
<td> a cairo context
|
|
1036
1013
|
</td>
|
|
1037
1014
|
</tr>
|
|
1038
1015
|
<tr>
|
|
1039
|
-
<td><p><span class="term"><em class="parameter"><code>glyphs</code></em
|
|
1016
|
+
<td><p><span class="term"><em class="parameter"><code>glyphs</code></em> :</span></p></td>
|
|
1040
1017
|
<td> array of glyphs to show
|
|
1041
1018
|
</td>
|
|
1042
1019
|
</tr>
|
|
1043
1020
|
<tr>
|
|
1044
|
-
<td><p><span class="term"><em class="parameter"><code>num_glyphs</code></em
|
|
1021
|
+
<td><p><span class="term"><em class="parameter"><code>num_glyphs</code></em> :</span></p></td>
|
|
1045
1022
|
<td> number of glyphs to show
|
|
1046
1023
|
</td>
|
|
1047
1024
|
</tr>
|
|
@@ -1050,31 +1027,30 @@ path if filled, achieves an effect similar to that of
|
|
|
1050
1027
|
</div>
|
|
1051
1028
|
<hr>
|
|
1052
1029
|
<div class="refsect2" lang="en">
|
|
1053
|
-
<a name="
|
|
1054
|
-
<a
|
|
1055
|
-
<a class="indexterm" name="id2580764"></a><pre class="programlisting">void cairo_text_path (<a class="link" href="cairo-cairo-t.html#cairo-t">cairo_t</a> *cr,
|
|
1030
|
+
<a name="cairo-text-path"></a><h3>cairo_text_path ()</h3>
|
|
1031
|
+
<pre class="programlisting">void cairo_text_path (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
|
1056
1032
|
const char *utf8);</pre>
|
|
1057
1033
|
<p>
|
|
1058
1034
|
Adds closed paths for text to the current path. The generated
|
|
1059
1035
|
path if filled, achieves an effect similar to that of
|
|
1060
|
-
<a class="link" href="cairo-
|
|
1036
|
+
<a class="link" href="cairo-text.html#cairo-show-text" title="cairo_show_text ()"><code class="function">cairo_show_text()</code></a>.
|
|
1061
1037
|
</p>
|
|
1062
1038
|
<p>
|
|
1063
|
-
Text conversion and positioning is done similar to <a class="link" href="cairo-
|
|
1039
|
+
Text conversion and positioning is done similar to <a class="link" href="cairo-text.html#cairo-show-text" title="cairo_show_text ()"><code class="function">cairo_show_text()</code></a>.
|
|
1064
1040
|
</p>
|
|
1065
1041
|
<p>
|
|
1066
|
-
Like <a class="link" href="cairo-
|
|
1042
|
+
Like <a class="link" href="cairo-text.html#cairo-show-text" title="cairo_show_text ()"><code class="function">cairo_show_text()</code></a>, After this call the current point is
|
|
1067
1043
|
moved to the origin of where the next glyph would be placed in
|
|
1068
1044
|
this same progression. That is, the current point will be at
|
|
1069
1045
|
the origin of the final glyph offset by its advance values.
|
|
1070
|
-
This allows for chaining multiple calls to to <a class="link" href="cairo-
|
|
1046
|
+
This allows for chaining multiple calls to to <a class="link" href="cairo-paths.html#cairo-text-path" title="cairo_text_path ()"><code class="function">cairo_text_path()</code></a>
|
|
1071
1047
|
without having to set current point in between.
|
|
1072
1048
|
</p>
|
|
1073
1049
|
<p>
|
|
1074
|
-
Note: The <a class="link" href="cairo-
|
|
1050
|
+
Note: The <a class="link" href="cairo-paths.html#cairo-text-path" title="cairo_text_path ()"><code class="function">cairo_text_path()</code></a> function call is part of what the cairo
|
|
1075
1051
|
designers call the "toy" text API. It is convenient for short demos
|
|
1076
1052
|
and simple programs, but it is not expected to be adequate for
|
|
1077
|
-
serious text-using applications. See <a class="link" href="cairo-
|
|
1053
|
+
serious text-using applications. See <a class="link" href="cairo-paths.html#cairo-glyph-path" title="cairo_glyph_path ()"><code class="function">cairo_glyph_path()</code></a> for the
|
|
1078
1054
|
"real" text path API in cairo.</p>
|
|
1079
1055
|
<p>
|
|
1080
1056
|
|
|
@@ -1083,13 +1059,13 @@ serious text-using applications. See <a class="link" href="cairo-Paths.html#cair
|
|
|
1083
1059
|
<col align="left" valign="top">
|
|
1084
1060
|
<tbody>
|
|
1085
1061
|
<tr>
|
|
1086
|
-
<td><p><span class="term"><em class="parameter"><code>cr</code></em
|
|
1062
|
+
<td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
|
|
1087
1063
|
<td> a cairo context
|
|
1088
1064
|
</td>
|
|
1089
1065
|
</tr>
|
|
1090
1066
|
<tr>
|
|
1091
|
-
<td><p><span class="term"><em class="parameter"><code>utf8</code></em
|
|
1092
|
-
<td> a string of text encoded in UTF-8
|
|
1067
|
+
<td><p><span class="term"><em class="parameter"><code>utf8</code></em> :</span></p></td>
|
|
1068
|
+
<td> a NUL-terminated string of text encoded in UTF-8, or <code class="literal">NULL</code>
|
|
1093
1069
|
</td>
|
|
1094
1070
|
</tr>
|
|
1095
1071
|
</tbody>
|
|
@@ -1097,9 +1073,8 @@ serious text-using applications. See <a class="link" href="cairo-Paths.html#cair
|
|
|
1097
1073
|
</div>
|
|
1098
1074
|
<hr>
|
|
1099
1075
|
<div class="refsect2" lang="en">
|
|
1100
|
-
<a name="
|
|
1101
|
-
<a
|
|
1102
|
-
<a class="indexterm" name="id2580928"></a><pre class="programlisting">void cairo_rel_curve_to (<a class="link" href="cairo-cairo-t.html#cairo-t">cairo_t</a> *cr,
|
|
1076
|
+
<a name="cairo-rel-curve-to"></a><h3>cairo_rel_curve_to ()</h3>
|
|
1077
|
+
<pre class="programlisting">void cairo_rel_curve_to (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
|
1103
1078
|
double dx1,
|
|
1104
1079
|
double dy1,
|
|
1105
1080
|
double dx2,
|
|
@@ -1107,23 +1082,22 @@ serious text-using applications. See <a class="link" href="cairo-Paths.html#cair
|
|
|
1107
1082
|
double dx3,
|
|
1108
1083
|
double dy3);</pre>
|
|
1109
1084
|
<p>
|
|
1110
|
-
Relative-coordinate version of <a class="link" href="cairo-
|
|
1111
|
-
relative to the current point. Adds a cubic
|
|
1085
|
+
Relative-coordinate version of <a class="link" href="cairo-paths.html#cairo-curve-to" title="cairo_curve_to ()"><code class="function">cairo_curve_to()</code></a>. All offsets are
|
|
1086
|
+
relative to the current point. Adds a cubic Bézier spline to the
|
|
1112
1087
|
path from the current point to a point offset from the current
|
|
1113
1088
|
point by (<em class="parameter"><code>dx3</code></em>, <em class="parameter"><code>dy3</code></em>), using points offset by (<em class="parameter"><code>dx1</code></em>, <em class="parameter"><code>dy1</code></em>) and
|
|
1114
1089
|
(<em class="parameter"><code>dx2</code></em>, <em class="parameter"><code>dy2</code></em>) as the control points. After this call the current
|
|
1115
1090
|
point will be offset by (<em class="parameter"><code>dx3</code></em>, <em class="parameter"><code>dy3</code></em>).
|
|
1116
1091
|
</p>
|
|
1117
1092
|
<p>
|
|
1118
|
-
Given a current point of (x, y), cairo_rel_curve_to
|
|
1093
|
+
Given a current point of (x, y), cairo_rel_curve_to(<em class="parameter"><code>cr</code></em>, <em class="parameter"><code>dx1</code></em>,
|
|
1119
1094
|
<em class="parameter"><code>dy1</code></em>, <em class="parameter"><code>dx2</code></em>, <em class="parameter"><code>dy2</code></em>, <em class="parameter"><code>dx3</code></em>, <em class="parameter"><code>dy3</code></em>) is logically equivalent to
|
|
1120
|
-
cairo_curve_to
|
|
1121
|
-
<em class="parameter"><code>dx3</code></em>, y + <em class="parameter"><code>dy3</code></em>).
|
|
1095
|
+
cairo_curve_to(<em class="parameter"><code>cr</code></em>, x+<em class="parameter"><code>dx1</code></em>, y+<em class="parameter"><code>dy1</code></em>, x+<em class="parameter"><code>dx2</code></em>, y+<em class="parameter"><code>dy2</code></em>, x+<em class="parameter"><code>dx3</code></em>, y+<em class="parameter"><code>dy3</code></em>).
|
|
1122
1096
|
</p>
|
|
1123
1097
|
<p>
|
|
1124
1098
|
It is an error to call this function with no current point. Doing
|
|
1125
1099
|
so will cause <em class="parameter"><code>cr</code></em> to shutdown with a status of
|
|
1126
|
-
CAIRO_STATUS_NO_CURRENT_POINT
|
|
1100
|
+
<a class="link" href="cairo-error-status.html#CAIRO-STATUS-NO-CURRENT-POINT:CAPS"><code class="literal">CAIRO_STATUS_NO_CURRENT_POINT</code></a>.</p>
|
|
1127
1101
|
<p>
|
|
1128
1102
|
|
|
1129
1103
|
</p>
|
|
@@ -1131,37 +1105,37 @@ CAIRO_STATUS_NO_CURRENT_POINT.</p>
|
|
|
1131
1105
|
<col align="left" valign="top">
|
|
1132
1106
|
<tbody>
|
|
1133
1107
|
<tr>
|
|
1134
|
-
<td><p><span class="term"><em class="parameter"><code>cr</code></em
|
|
1108
|
+
<td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
|
|
1135
1109
|
<td> a cairo context
|
|
1136
1110
|
</td>
|
|
1137
1111
|
</tr>
|
|
1138
1112
|
<tr>
|
|
1139
|
-
<td><p><span class="term"><em class="parameter"><code>dx1</code></em
|
|
1113
|
+
<td><p><span class="term"><em class="parameter"><code>dx1</code></em> :</span></p></td>
|
|
1140
1114
|
<td> the X offset to the first control point
|
|
1141
1115
|
</td>
|
|
1142
1116
|
</tr>
|
|
1143
1117
|
<tr>
|
|
1144
|
-
<td><p><span class="term"><em class="parameter"><code>dy1</code></em
|
|
1118
|
+
<td><p><span class="term"><em class="parameter"><code>dy1</code></em> :</span></p></td>
|
|
1145
1119
|
<td> the Y offset to the first control point
|
|
1146
1120
|
</td>
|
|
1147
1121
|
</tr>
|
|
1148
1122
|
<tr>
|
|
1149
|
-
<td><p><span class="term"><em class="parameter"><code>dx2</code></em
|
|
1123
|
+
<td><p><span class="term"><em class="parameter"><code>dx2</code></em> :</span></p></td>
|
|
1150
1124
|
<td> the X offset to the second control point
|
|
1151
1125
|
</td>
|
|
1152
1126
|
</tr>
|
|
1153
1127
|
<tr>
|
|
1154
|
-
<td><p><span class="term"><em class="parameter"><code>dy2</code></em
|
|
1128
|
+
<td><p><span class="term"><em class="parameter"><code>dy2</code></em> :</span></p></td>
|
|
1155
1129
|
<td> the Y offset to the second control point
|
|
1156
1130
|
</td>
|
|
1157
1131
|
</tr>
|
|
1158
1132
|
<tr>
|
|
1159
|
-
<td><p><span class="term"><em class="parameter"><code>dx3</code></em
|
|
1133
|
+
<td><p><span class="term"><em class="parameter"><code>dx3</code></em> :</span></p></td>
|
|
1160
1134
|
<td> the X offset to the end of the curve
|
|
1161
1135
|
</td>
|
|
1162
1136
|
</tr>
|
|
1163
1137
|
<tr>
|
|
1164
|
-
<td><p><span class="term"><em class="parameter"><code>dy3</code></em
|
|
1138
|
+
<td><p><span class="term"><em class="parameter"><code>dy3</code></em> :</span></p></td>
|
|
1165
1139
|
<td> the Y offset to the end of the curve
|
|
1166
1140
|
</td>
|
|
1167
1141
|
</tr>
|
|
@@ -1170,25 +1144,24 @@ CAIRO_STATUS_NO_CURRENT_POINT.</p>
|
|
|
1170
1144
|
</div>
|
|
1171
1145
|
<hr>
|
|
1172
1146
|
<div class="refsect2" lang="en">
|
|
1173
|
-
<a name="
|
|
1174
|
-
<a
|
|
1175
|
-
<a class="indexterm" name="id2581283"></a><pre class="programlisting">void cairo_rel_line_to (<a class="link" href="cairo-cairo-t.html#cairo-t">cairo_t</a> *cr,
|
|
1147
|
+
<a name="cairo-rel-line-to"></a><h3>cairo_rel_line_to ()</h3>
|
|
1148
|
+
<pre class="programlisting">void cairo_rel_line_to (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
|
1176
1149
|
double dx,
|
|
1177
1150
|
double dy);</pre>
|
|
1178
1151
|
<p>
|
|
1179
|
-
Relative-coordinate version of <a class="link" href="cairo-
|
|
1152
|
+
Relative-coordinate version of <a class="link" href="cairo-paths.html#cairo-line-to" title="cairo_line_to ()"><code class="function">cairo_line_to()</code></a>. Adds a line to the
|
|
1180
1153
|
path from the current point to a point that is offset from the
|
|
1181
1154
|
current point by (<em class="parameter"><code>dx</code></em>, <em class="parameter"><code>dy</code></em>) in user space. After this call the
|
|
1182
1155
|
current point will be offset by (<em class="parameter"><code>dx</code></em>, <em class="parameter"><code>dy</code></em>).
|
|
1183
1156
|
</p>
|
|
1184
1157
|
<p>
|
|
1185
1158
|
Given a current point of (x, y), cairo_rel_line_to(<em class="parameter"><code>cr</code></em>, <em class="parameter"><code>dx</code></em>, <em class="parameter"><code>dy</code></em>)
|
|
1186
|
-
is logically equivalent to cairo_line_to
|
|
1159
|
+
is logically equivalent to cairo_line_to(<em class="parameter"><code>cr</code></em>, x + <em class="parameter"><code>dx</code></em>, y + <em class="parameter"><code>dy</code></em>).
|
|
1187
1160
|
</p>
|
|
1188
1161
|
<p>
|
|
1189
1162
|
It is an error to call this function with no current point. Doing
|
|
1190
1163
|
so will cause <em class="parameter"><code>cr</code></em> to shutdown with a status of
|
|
1191
|
-
CAIRO_STATUS_NO_CURRENT_POINT
|
|
1164
|
+
<a class="link" href="cairo-error-status.html#CAIRO-STATUS-NO-CURRENT-POINT:CAPS"><code class="literal">CAIRO_STATUS_NO_CURRENT_POINT</code></a>.</p>
|
|
1192
1165
|
<p>
|
|
1193
1166
|
|
|
1194
1167
|
</p>
|
|
@@ -1196,17 +1169,17 @@ CAIRO_STATUS_NO_CURRENT_POINT.</p>
|
|
|
1196
1169
|
<col align="left" valign="top">
|
|
1197
1170
|
<tbody>
|
|
1198
1171
|
<tr>
|
|
1199
|
-
<td><p><span class="term"><em class="parameter"><code>cr</code></em
|
|
1172
|
+
<td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
|
|
1200
1173
|
<td> a cairo context
|
|
1201
1174
|
</td>
|
|
1202
1175
|
</tr>
|
|
1203
1176
|
<tr>
|
|
1204
|
-
<td><p><span class="term"><em class="parameter"><code>dx</code></em
|
|
1177
|
+
<td><p><span class="term"><em class="parameter"><code>dx</code></em> :</span></p></td>
|
|
1205
1178
|
<td> the X offset to the end of the new line
|
|
1206
1179
|
</td>
|
|
1207
1180
|
</tr>
|
|
1208
1181
|
<tr>
|
|
1209
|
-
<td><p><span class="term"><em class="parameter"><code>dy</code></em
|
|
1182
|
+
<td><p><span class="term"><em class="parameter"><code>dy</code></em> :</span></p></td>
|
|
1210
1183
|
<td> the Y offset to the end of the new line
|
|
1211
1184
|
</td>
|
|
1212
1185
|
</tr>
|
|
@@ -1215,9 +1188,8 @@ CAIRO_STATUS_NO_CURRENT_POINT.</p>
|
|
|
1215
1188
|
</div>
|
|
1216
1189
|
<hr>
|
|
1217
1190
|
<div class="refsect2" lang="en">
|
|
1218
|
-
<a name="
|
|
1219
|
-
<a
|
|
1220
|
-
<a class="indexterm" name="id2581478"></a><pre class="programlisting">void cairo_rel_move_to (<a class="link" href="cairo-cairo-t.html#cairo-t">cairo_t</a> *cr,
|
|
1191
|
+
<a name="cairo-rel-move-to"></a><h3>cairo_rel_move_to ()</h3>
|
|
1192
|
+
<pre class="programlisting">void cairo_rel_move_to (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
|
1221
1193
|
double dx,
|
|
1222
1194
|
double dy);</pre>
|
|
1223
1195
|
<p>
|
|
@@ -1226,12 +1198,12 @@ by (<em class="parameter"><code>x</code></em>, <em class="parameter"><code>y</co
|
|
|
1226
1198
|
</p>
|
|
1227
1199
|
<p>
|
|
1228
1200
|
Given a current point of (x, y), cairo_rel_move_to(<em class="parameter"><code>cr</code></em>, <em class="parameter"><code>dx</code></em>, <em class="parameter"><code>dy</code></em>)
|
|
1229
|
-
is logically equivalent to cairo_move_to
|
|
1201
|
+
is logically equivalent to cairo_move_to(<em class="parameter"><code>cr</code></em>, x + <em class="parameter"><code>dx</code></em>, y + <em class="parameter"><code>dy</code></em>).
|
|
1230
1202
|
</p>
|
|
1231
1203
|
<p>
|
|
1232
1204
|
It is an error to call this function with no current point. Doing
|
|
1233
1205
|
so will cause <em class="parameter"><code>cr</code></em> to shutdown with a status of
|
|
1234
|
-
CAIRO_STATUS_NO_CURRENT_POINT
|
|
1206
|
+
<a class="link" href="cairo-error-status.html#CAIRO-STATUS-NO-CURRENT-POINT:CAPS"><code class="literal">CAIRO_STATUS_NO_CURRENT_POINT</code></a>.</p>
|
|
1235
1207
|
<p>
|
|
1236
1208
|
|
|
1237
1209
|
</p>
|
|
@@ -1239,17 +1211,17 @@ CAIRO_STATUS_NO_CURRENT_POINT.</p>
|
|
|
1239
1211
|
<col align="left" valign="top">
|
|
1240
1212
|
<tbody>
|
|
1241
1213
|
<tr>
|
|
1242
|
-
<td><p><span class="term"><em class="parameter"><code>cr</code></em
|
|
1214
|
+
<td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
|
|
1243
1215
|
<td> a cairo context
|
|
1244
1216
|
</td>
|
|
1245
1217
|
</tr>
|
|
1246
1218
|
<tr>
|
|
1247
|
-
<td><p><span class="term"><em class="parameter"><code>dx</code></em
|
|
1219
|
+
<td><p><span class="term"><em class="parameter"><code>dx</code></em> :</span></p></td>
|
|
1248
1220
|
<td> the X offset
|
|
1249
1221
|
</td>
|
|
1250
1222
|
</tr>
|
|
1251
1223
|
<tr>
|
|
1252
|
-
<td><p><span class="term"><em class="parameter"><code>dy</code></em
|
|
1224
|
+
<td><p><span class="term"><em class="parameter"><code>dy</code></em> :</span></p></td>
|
|
1253
1225
|
<td> the Y offset
|
|
1254
1226
|
</td>
|
|
1255
1227
|
</tr>
|
|
@@ -1258,9 +1230,8 @@ CAIRO_STATUS_NO_CURRENT_POINT.</p>
|
|
|
1258
1230
|
</div>
|
|
1259
1231
|
<hr>
|
|
1260
1232
|
<div class="refsect2" lang="en">
|
|
1261
|
-
<a name="
|
|
1262
|
-
<a
|
|
1263
|
-
<a class="indexterm" name="id2581651"></a><pre class="programlisting">void cairo_path_extents (<a class="link" href="cairo-cairo-t.html#cairo-t">cairo_t</a> *cr,
|
|
1233
|
+
<a name="cairo-path-extents"></a><h3>cairo_path_extents ()</h3>
|
|
1234
|
+
<pre class="programlisting">void cairo_path_extents (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
|
1264
1235
|
double *x1,
|
|
1265
1236
|
double *y1,
|
|
1266
1237
|
double *x2,
|
|
@@ -1272,23 +1243,23 @@ an empty rectangle ((0,0), (0,0)). Stroke parameters, fill rule,
|
|
|
1272
1243
|
surface dimensions and clipping are not taken into account.
|
|
1273
1244
|
</p>
|
|
1274
1245
|
<p>
|
|
1275
|
-
Contrast with <a class="link" href="cairo-
|
|
1246
|
+
Contrast with <a class="link" href="cairo-context.html#cairo-fill-extents" title="cairo_fill_extents ()"><code class="function">cairo_fill_extents()</code></a> and <a class="link" href="cairo-context.html#cairo-stroke-extents" title="cairo_stroke_extents ()"><code class="function">cairo_stroke_extents()</code></a> which
|
|
1276
1247
|
return the extents of only the area that would be "inked" by
|
|
1277
1248
|
the corresponding drawing operations.
|
|
1278
1249
|
</p>
|
|
1279
1250
|
<p>
|
|
1280
|
-
The result of <a class="link" href="cairo-
|
|
1281
|
-
limit of <a class="link" href="cairo-
|
|
1251
|
+
The result of <a class="link" href="cairo-paths.html#cairo-path-extents" title="cairo_path_extents ()"><code class="function">cairo_path_extents()</code></a> is defined as equivalent to the
|
|
1252
|
+
limit of <a class="link" href="cairo-context.html#cairo-stroke-extents" title="cairo_stroke_extents ()"><code class="function">cairo_stroke_extents()</code></a> with <a class="link" href="cairo-context.html#CAIRO-LINE-CAP-ROUND:CAPS"><code class="literal">CAIRO_LINE_CAP_ROUND</code></a> as the
|
|
1282
1253
|
line width approaches 0.0, (but never reaching the empty-rectangle
|
|
1283
|
-
returned by <a class="link" href="cairo-
|
|
1254
|
+
returned by <a class="link" href="cairo-context.html#cairo-stroke-extents" title="cairo_stroke_extents ()"><code class="function">cairo_stroke_extents()</code></a> for a line width of 0.0).
|
|
1284
1255
|
</p>
|
|
1285
1256
|
<p>
|
|
1286
1257
|
Specifically, this means that zero-area sub-paths such as
|
|
1287
|
-
<a class="link" href="cairo-
|
|
1258
|
+
<a class="link" href="cairo-paths.html#cairo-move-to" title="cairo_move_to ()"><code class="function">cairo_move_to()</code></a>;<a class="link" href="cairo-paths.html#cairo-line-to" title="cairo_line_to ()"><code class="function">cairo_line_to()</code></a> segments, (even degenerate cases
|
|
1288
1259
|
where the coordinates to both calls are identical), will be
|
|
1289
1260
|
considered as contributing to the extents. However, a lone
|
|
1290
|
-
<a class="link" href="cairo-
|
|
1291
|
-
<a class="link" href="cairo-
|
|
1261
|
+
<a class="link" href="cairo-paths.html#cairo-move-to" title="cairo_move_to ()"><code class="function">cairo_move_to()</code></a> will not contribute to the results of
|
|
1262
|
+
<a class="link" href="cairo-paths.html#cairo-path-extents" title="cairo_path_extents ()"><code class="function">cairo_path_extents()</code></a>.</p>
|
|
1292
1263
|
<p>
|
|
1293
1264
|
|
|
1294
1265
|
</p>
|
|
@@ -1296,27 +1267,27 @@ considered as contributing to the extents. However, a lone
|
|
|
1296
1267
|
<col align="left" valign="top">
|
|
1297
1268
|
<tbody>
|
|
1298
1269
|
<tr>
|
|
1299
|
-
<td><p><span class="term"><em class="parameter"><code>cr</code></em
|
|
1270
|
+
<td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
|
|
1300
1271
|
<td> a cairo context
|
|
1301
1272
|
</td>
|
|
1302
1273
|
</tr>
|
|
1303
1274
|
<tr>
|
|
1304
|
-
<td><p><span class="term"><em class="parameter"><code>x1</code></em
|
|
1275
|
+
<td><p><span class="term"><em class="parameter"><code>x1</code></em> :</span></p></td>
|
|
1305
1276
|
<td> left of the resulting extents
|
|
1306
1277
|
</td>
|
|
1307
1278
|
</tr>
|
|
1308
1279
|
<tr>
|
|
1309
|
-
<td><p><span class="term"><em class="parameter"><code>y1</code></em
|
|
1280
|
+
<td><p><span class="term"><em class="parameter"><code>y1</code></em> :</span></p></td>
|
|
1310
1281
|
<td> top of the resulting extents
|
|
1311
1282
|
</td>
|
|
1312
1283
|
</tr>
|
|
1313
1284
|
<tr>
|
|
1314
|
-
<td><p><span class="term"><em class="parameter"><code>x2</code></em
|
|
1285
|
+
<td><p><span class="term"><em class="parameter"><code>x2</code></em> :</span></p></td>
|
|
1315
1286
|
<td> right of the resulting extents
|
|
1316
1287
|
</td>
|
|
1317
1288
|
</tr>
|
|
1318
1289
|
<tr>
|
|
1319
|
-
<td><p><span class="term"><em class="parameter"><code>y2</code></em
|
|
1290
|
+
<td><p><span class="term"><em class="parameter"><code>y2</code></em> :</span></p></td>
|
|
1320
1291
|
<td> bottom of the resulting extents
|
|
1321
1292
|
</td>
|
|
1322
1293
|
</tr>
|
|
@@ -1326,11 +1297,9 @@ considered as contributing to the extents. However, a lone
|
|
|
1326
1297
|
</p>
|
|
1327
1298
|
</div>
|
|
1328
1299
|
</div>
|
|
1329
|
-
<div class="refsect1" lang="en">
|
|
1330
|
-
<a name="id2581908"></a><div class="refsect2" lang="en"><a name="id2581909"></a></div>
|
|
1331
|
-
<hr>
|
|
1332
|
-
<div class="refsect2" lang="en"><a name="id2581910"></a></div>
|
|
1333
|
-
</div>
|
|
1334
1300
|
</div>
|
|
1301
|
+
<div class="footer">
|
|
1302
|
+
<hr>
|
|
1303
|
+
Generated by GTK-Doc V1.10</div>
|
|
1335
1304
|
</body>
|
|
1336
1305
|
</html>
|