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
data/cairo/share/gtk-doc/html/cairo/{cairo-PostScript-Surfaces.html → cairo-ps-surface.html}
RENAMED
|
@@ -1,95 +1,90 @@
|
|
|
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>PostScript Surfaces</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-surfaces.html" title="Surfaces">
|
|
9
|
+
<link rel="prev" href="cairo-png-functions.html" title="PNG Support">
|
|
10
|
+
<link rel="next" href="cairo-win32-surface.html" title="Win32 Surfaces">
|
|
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-png-functions.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
|
|
28
|
+
<td><a accesskey="u" href="cairo-surfaces.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-win32-surface.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-ps-surface.synopsis" class="shortcut">Top</a>
|
|
34
|
+
|
|
|
35
|
+
<a href="#cairo-ps-surface.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-ps-surface"></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>PostScript Surfaces — Rendering PostScript documents</p>
|
|
41
|
+
<h2><span class="refentrytitle"><a name="cairo-ps-surface.top_of_page"></a>PostScript Surfaces</span></h2>
|
|
42
|
+
<p>PostScript Surfaces — Rendering PostScript documents</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-ps-surface.synopsis"></a><h2>Synopsis</h2>
|
|
49
48
|
<pre class="synopsis">
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
#define <a class="link" href="cairo-PostScript-Surfaces.html#CAIRO-HAS-PS-SURFACE:CAPS">CAIRO_HAS_PS_SURFACE</a>
|
|
54
|
-
<a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t">cairo_surface_t</a>* <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-create">cairo_ps_surface_create</a> (const char *filename,
|
|
49
|
+
#define <a class="link" href="cairo-ps-surface.html#CAIRO-HAS-PS-SURFACE:CAPS" title="CAIRO_HAS_PS_SURFACE">CAIRO_HAS_PS_SURFACE</a>
|
|
50
|
+
<a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a>* <a class="link" href="cairo-ps-surface.html#cairo-ps-surface-create" title="cairo_ps_surface_create ()">cairo_ps_surface_create</a> (const char *filename,
|
|
55
51
|
double width_in_points,
|
|
56
52
|
double height_in_points);
|
|
57
|
-
<a class="link" href="cairo-
|
|
53
|
+
<a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a>* <a class="link" href="cairo-ps-surface.html#cairo-ps-surface-create-for-stream" title="cairo_ps_surface_create_for_stream ()">cairo_ps_surface_create_for_stream</a> (<a class="link" href="cairo-png-functions.html#cairo-write-func-t" title="cairo_write_func_t ()">cairo_write_func_t</a> write_func,
|
|
58
54
|
void *closure,
|
|
59
55
|
double width_in_points,
|
|
60
56
|
double height_in_points);
|
|
61
|
-
void <a class="link" href="cairo-
|
|
62
|
-
<a class="link" href="cairo-
|
|
63
|
-
enum <a class="link" href="cairo-
|
|
64
|
-
void <a class="link" href="cairo-
|
|
57
|
+
void <a class="link" href="cairo-ps-surface.html#cairo-ps-surface-restrict-to-level" title="cairo_ps_surface_restrict_to_level ()">cairo_ps_surface_restrict_to_level</a> (<a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a> *surface,
|
|
58
|
+
<a class="link" href="cairo-ps-surface.html#cairo-ps-level-t" title="enum cairo_ps_level_t">cairo_ps_level_t</a> level);
|
|
59
|
+
enum <a class="link" href="cairo-ps-surface.html#cairo-ps-level-t" title="enum cairo_ps_level_t">cairo_ps_level_t</a>;
|
|
60
|
+
void <a class="link" href="cairo-ps-surface.html#cairo-ps-get-levels" title="cairo_ps_get_levels ()">cairo_ps_get_levels</a> (<a class="link" href="cairo-ps-surface.html#cairo-ps-level-t" title="enum cairo_ps_level_t">cairo_ps_level_t</a> const **levels,
|
|
65
61
|
int *num_levels);
|
|
66
|
-
const char* <a class="link" href="cairo-
|
|
67
|
-
void <a class="link" href="cairo-
|
|
68
|
-
<a class="link" href="cairo-
|
|
69
|
-
<a class="link" href="cairo-
|
|
70
|
-
void <a class="link" href="cairo-
|
|
62
|
+
const char* <a class="link" href="cairo-ps-surface.html#cairo-ps-level-to-string" title="cairo_ps_level_to_string ()">cairo_ps_level_to_string</a> (<a class="link" href="cairo-ps-surface.html#cairo-ps-level-t" title="enum cairo_ps_level_t">cairo_ps_level_t</a> level);
|
|
63
|
+
void <a class="link" href="cairo-ps-surface.html#cairo-ps-surface-set-eps" title="cairo_ps_surface_set_eps ()">cairo_ps_surface_set_eps</a> (<a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a> *surface,
|
|
64
|
+
<a class="link" href="cairo-types.html#cairo-bool-t" title="cairo_bool_t">cairo_bool_t</a> eps);
|
|
65
|
+
<a class="link" href="cairo-types.html#cairo-bool-t" title="cairo_bool_t">cairo_bool_t</a> <a class="link" href="cairo-ps-surface.html#cairo-ps-surface-get-eps" title="cairo_ps_surface_get_eps ()">cairo_ps_surface_get_eps</a> (<a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a> *surface);
|
|
66
|
+
void <a class="link" href="cairo-ps-surface.html#cairo-ps-surface-set-size" title="cairo_ps_surface_set_size ()">cairo_ps_surface_set_size</a> (<a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a> *surface,
|
|
71
67
|
double width_in_points,
|
|
72
68
|
double height_in_points);
|
|
73
|
-
void <a class="link" href="cairo-
|
|
74
|
-
void <a class="link" href="cairo-
|
|
75
|
-
(<a class="link" href="cairo-
|
|
76
|
-
void <a class="link" href="cairo-
|
|
69
|
+
void <a class="link" href="cairo-ps-surface.html#cairo-ps-surface-dsc-begin-setup" title="cairo_ps_surface_dsc_begin_setup ()">cairo_ps_surface_dsc_begin_setup</a> (<a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a> *surface);
|
|
70
|
+
void <a class="link" href="cairo-ps-surface.html#cairo-ps-surface-dsc-begin-page-setup" title="cairo_ps_surface_dsc_begin_page_setup ()">cairo_ps_surface_dsc_begin_page_setup</a>
|
|
71
|
+
(<a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a> *surface);
|
|
72
|
+
void <a class="link" href="cairo-ps-surface.html#cairo-ps-surface-dsc-comment" title="cairo_ps_surface_dsc_comment ()">cairo_ps_surface_dsc_comment</a> (<a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a> *surface,
|
|
77
73
|
const char *comment);
|
|
78
74
|
</pre>
|
|
79
75
|
</div>
|
|
80
76
|
<div class="refsect1" lang="en">
|
|
81
|
-
<a name="
|
|
77
|
+
<a name="cairo-ps-surface.description"></a><h2>Description</h2>
|
|
82
78
|
<p>
|
|
83
79
|
The PostScript surface is used to render cairo graphics to Adobe
|
|
84
80
|
PostScript files and is a multi-page vector surface backend.
|
|
85
81
|
</p>
|
|
86
82
|
</div>
|
|
87
83
|
<div class="refsect1" lang="en">
|
|
88
|
-
<a name="
|
|
84
|
+
<a name="cairo-ps-surface.details"></a><h2>Details</h2>
|
|
89
85
|
<div class="refsect2" lang="en">
|
|
90
|
-
<a name="
|
|
91
|
-
<
|
|
92
|
-
<a class="indexterm" name="id2666944"></a><pre class="programlisting">#define CAIRO_HAS_PS_SURFACE 1
|
|
86
|
+
<a name="CAIRO-HAS-PS-SURFACE:CAPS"></a><h3>CAIRO_HAS_PS_SURFACE</h3>
|
|
87
|
+
<pre class="programlisting">#define CAIRO_HAS_PS_SURFACE 1
|
|
93
88
|
</pre>
|
|
94
89
|
<p>
|
|
95
90
|
Defined if the PostScript surface backend is available.
|
|
@@ -98,20 +93,19 @@ This macro can be used to conditionally compile backend-specific code.
|
|
|
98
93
|
</div>
|
|
99
94
|
<hr>
|
|
100
95
|
<div class="refsect2" lang="en">
|
|
101
|
-
<a name="
|
|
102
|
-
<a
|
|
103
|
-
<a class="indexterm" name="id2666975"></a><pre class="programlisting"><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t">cairo_surface_t</a>* cairo_ps_surface_create (const char *filename,
|
|
96
|
+
<a name="cairo-ps-surface-create"></a><h3>cairo_ps_surface_create ()</h3>
|
|
97
|
+
<pre class="programlisting"><a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a>* cairo_ps_surface_create (const char *filename,
|
|
104
98
|
double width_in_points,
|
|
105
99
|
double height_in_points);</pre>
|
|
106
100
|
<p>
|
|
107
101
|
Creates a PostScript surface of the specified size in points to be
|
|
108
|
-
written to <em class="parameter"><code>filename</code></em>. See <a class="link" href="cairo-
|
|
102
|
+
written to <em class="parameter"><code>filename</code></em>. See <a class="link" href="cairo-ps-surface.html#cairo-ps-surface-create-for-stream" title="cairo_ps_surface_create_for_stream ()"><code class="function">cairo_ps_surface_create_for_stream()</code></a> for
|
|
109
103
|
a more flexible mechanism for handling the PostScript output than
|
|
110
104
|
simply writing it to a named file.
|
|
111
105
|
</p>
|
|
112
106
|
<p>
|
|
113
107
|
Note that the size of individual pages of the PostScript output can
|
|
114
|
-
vary. See <a class="link" href="cairo-
|
|
108
|
+
vary. See <a class="link" href="cairo-ps-surface.html#cairo-ps-surface-set-size" title="cairo_ps_surface_set_size ()"><code class="function">cairo_ps_surface_set_size()</code></a>.</p>
|
|
115
109
|
<p>
|
|
116
110
|
|
|
117
111
|
</p>
|
|
@@ -119,29 +113,29 @@ vary. See <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-
|
|
|
119
113
|
<col align="left" valign="top">
|
|
120
114
|
<tbody>
|
|
121
115
|
<tr>
|
|
122
|
-
<td><p><span class="term"><em class="parameter"><code>filename</code></em
|
|
116
|
+
<td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td>
|
|
123
117
|
<td> a filename for the PS output (must be writable)
|
|
124
118
|
</td>
|
|
125
119
|
</tr>
|
|
126
120
|
<tr>
|
|
127
|
-
<td><p><span class="term"><em class="parameter"><code>width_in_points</code></em
|
|
121
|
+
<td><p><span class="term"><em class="parameter"><code>width_in_points</code></em> :</span></p></td>
|
|
128
122
|
<td> width of the surface, in points (1 point == 1/72.0 inch)
|
|
129
123
|
</td>
|
|
130
124
|
</tr>
|
|
131
125
|
<tr>
|
|
132
|
-
<td><p><span class="term"><em class="parameter"><code>height_in_points</code></em
|
|
126
|
+
<td><p><span class="term"><em class="parameter"><code>height_in_points</code></em> :</span></p></td>
|
|
133
127
|
<td> height of the surface, in points (1 point == 1/72.0 inch)
|
|
134
128
|
</td>
|
|
135
129
|
</tr>
|
|
136
130
|
<tr>
|
|
137
|
-
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span
|
|
131
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
138
132
|
<td> a pointer to the newly created surface. The caller
|
|
139
|
-
owns the surface and should call <a class="link" href="cairo-
|
|
133
|
+
owns the surface and should call <a class="link" href="cairo-surface.html#cairo-surface-destroy" title="cairo_surface_destroy ()"><code class="function">cairo_surface_destroy()</code></a> when done
|
|
140
134
|
with it.
|
|
141
135
|
|
|
142
136
|
This function always returns a valid pointer, but it will return a
|
|
143
137
|
pointer to a "nil" surface if an error such as out of memory
|
|
144
|
-
occurs. You can use <a class="link" href="cairo-
|
|
138
|
+
occurs. You can use <a class="link" href="cairo-surface.html#cairo-surface-status" title="cairo_surface_status ()"><code class="function">cairo_surface_status()</code></a> to check for this.
|
|
145
139
|
|
|
146
140
|
</td>
|
|
147
141
|
</tr>
|
|
@@ -152,21 +146,20 @@ occurs. You can use <a class="link" href="cairo-cairo-surface-t.html#cairo-surfa
|
|
|
152
146
|
</div>
|
|
153
147
|
<hr>
|
|
154
148
|
<div class="refsect2" lang="en">
|
|
155
|
-
<a name="
|
|
156
|
-
<a
|
|
157
|
-
<a class="indexterm" name="id2659875"></a><pre class="programlisting"><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t">cairo_surface_t</a>* cairo_ps_surface_create_for_stream (<a class="link" href="cairo-PNG-Support.html#cairo-write-func-t">cairo_write_func_t</a> write_func,
|
|
149
|
+
<a name="cairo-ps-surface-create-for-stream"></a><h3>cairo_ps_surface_create_for_stream ()</h3>
|
|
150
|
+
<pre class="programlisting"><a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a>* cairo_ps_surface_create_for_stream (<a class="link" href="cairo-png-functions.html#cairo-write-func-t" title="cairo_write_func_t ()">cairo_write_func_t</a> write_func,
|
|
158
151
|
void *closure,
|
|
159
152
|
double width_in_points,
|
|
160
153
|
double height_in_points);</pre>
|
|
161
154
|
<p>
|
|
162
155
|
Creates a PostScript surface of the specified size in points to be
|
|
163
156
|
written incrementally to the stream represented by <em class="parameter"><code>write_func</code></em> and
|
|
164
|
-
<em class="parameter"><code>closure</code></em>. See <a class="link" href="cairo-
|
|
157
|
+
<em class="parameter"><code>closure</code></em>. See <a class="link" href="cairo-ps-surface.html#cairo-ps-surface-create" title="cairo_ps_surface_create ()"><code class="function">cairo_ps_surface_create()</code></a> for a more convenient way
|
|
165
158
|
to simply direct the PostScript output to a named file.
|
|
166
159
|
</p>
|
|
167
160
|
<p>
|
|
168
161
|
Note that the size of individual pages of the PostScript
|
|
169
|
-
output can vary. See <a class="link" href="cairo-
|
|
162
|
+
output can vary. See <a class="link" href="cairo-ps-surface.html#cairo-ps-surface-set-size" title="cairo_ps_surface_set_size ()"><code class="function">cairo_ps_surface_set_size()</code></a>.</p>
|
|
170
163
|
<p>
|
|
171
164
|
|
|
172
165
|
</p>
|
|
@@ -174,34 +167,34 @@ output can vary. See <a class="link" href="cairo-PostScript-Surfaces.html#cairo-
|
|
|
174
167
|
<col align="left" valign="top">
|
|
175
168
|
<tbody>
|
|
176
169
|
<tr>
|
|
177
|
-
<td><p><span class="term"><em class="parameter"><code>write_func</code></em
|
|
178
|
-
<td> a <a class="link" href="cairo-
|
|
170
|
+
<td><p><span class="term"><em class="parameter"><code>write_func</code></em> :</span></p></td>
|
|
171
|
+
<td> a <a class="link" href="cairo-png-functions.html#cairo-write-func-t" title="cairo_write_func_t ()"><span class="type">cairo_write_func_t</span></a> to accept the output data
|
|
179
172
|
</td>
|
|
180
173
|
</tr>
|
|
181
174
|
<tr>
|
|
182
|
-
<td><p><span class="term"><em class="parameter"><code>closure</code></em
|
|
175
|
+
<td><p><span class="term"><em class="parameter"><code>closure</code></em> :</span></p></td>
|
|
183
176
|
<td> the closure argument for <em class="parameter"><code>write_func</code></em>
|
|
184
177
|
</td>
|
|
185
178
|
</tr>
|
|
186
179
|
<tr>
|
|
187
|
-
<td><p><span class="term"><em class="parameter"><code>width_in_points</code></em
|
|
180
|
+
<td><p><span class="term"><em class="parameter"><code>width_in_points</code></em> :</span></p></td>
|
|
188
181
|
<td> width of the surface, in points (1 point == 1/72.0 inch)
|
|
189
182
|
</td>
|
|
190
183
|
</tr>
|
|
191
184
|
<tr>
|
|
192
|
-
<td><p><span class="term"><em class="parameter"><code>height_in_points</code></em
|
|
185
|
+
<td><p><span class="term"><em class="parameter"><code>height_in_points</code></em> :</span></p></td>
|
|
193
186
|
<td> height of the surface, in points (1 point == 1/72.0 inch)
|
|
194
187
|
</td>
|
|
195
188
|
</tr>
|
|
196
189
|
<tr>
|
|
197
|
-
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span
|
|
190
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
198
191
|
<td> a pointer to the newly created surface. The caller
|
|
199
|
-
owns the surface and should call <a class="link" href="cairo-
|
|
192
|
+
owns the surface and should call <a class="link" href="cairo-surface.html#cairo-surface-destroy" title="cairo_surface_destroy ()"><code class="function">cairo_surface_destroy()</code></a> when done
|
|
200
193
|
with it.
|
|
201
194
|
|
|
202
195
|
This function always returns a valid pointer, but it will return a
|
|
203
196
|
pointer to a "nil" surface if an error such as out of memory
|
|
204
|
-
occurs. You can use <a class="link" href="cairo-
|
|
197
|
+
occurs. You can use <a class="link" href="cairo-surface.html#cairo-surface-status" title="cairo_surface_status ()"><code class="function">cairo_surface_status()</code></a> to check for this.
|
|
205
198
|
|
|
206
199
|
</td>
|
|
207
200
|
</tr>
|
|
@@ -212,13 +205,12 @@ occurs. You can use <a class="link" href="cairo-cairo-surface-t.html#cairo-surfa
|
|
|
212
205
|
</div>
|
|
213
206
|
<hr>
|
|
214
207
|
<div class="refsect2" lang="en">
|
|
215
|
-
<a name="
|
|
216
|
-
<a
|
|
217
|
-
<a class="
|
|
218
|
-
<a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-level-t">cairo_ps_level_t</a> level);</pre>
|
|
208
|
+
<a name="cairo-ps-surface-restrict-to-level"></a><h3>cairo_ps_surface_restrict_to_level ()</h3>
|
|
209
|
+
<pre class="programlisting">void cairo_ps_surface_restrict_to_level (<a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a> *surface,
|
|
210
|
+
<a class="link" href="cairo-ps-surface.html#cairo-ps-level-t" title="enum cairo_ps_level_t">cairo_ps_level_t</a> level);</pre>
|
|
219
211
|
<p>
|
|
220
212
|
Restricts the generated PostSript file to <em class="parameter"><code>level</code></em>. See
|
|
221
|
-
<a class="link" href="cairo-
|
|
213
|
+
<a class="link" href="cairo-ps-surface.html#cairo-ps-get-levels" title="cairo_ps_get_levels ()"><code class="function">cairo_ps_get_levels()</code></a> for a list of available level values that
|
|
222
214
|
can be used here.
|
|
223
215
|
</p>
|
|
224
216
|
<p>
|
|
@@ -233,12 +225,12 @@ surface.</p>
|
|
|
233
225
|
<col align="left" valign="top">
|
|
234
226
|
<tbody>
|
|
235
227
|
<tr>
|
|
236
|
-
<td><p><span class="term"><em class="parameter"><code>surface</code></em
|
|
237
|
-
<td> a PostScript <a class="link" href="cairo-
|
|
228
|
+
<td><p><span class="term"><em class="parameter"><code>surface</code></em> :</span></p></td>
|
|
229
|
+
<td> a PostScript <a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a>
|
|
238
230
|
</td>
|
|
239
231
|
</tr>
|
|
240
232
|
<tr>
|
|
241
|
-
<td><p><span class="term"><em class="parameter"><code>level</code></em
|
|
233
|
+
<td><p><span class="term"><em class="parameter"><code>level</code></em> :</span></p></td>
|
|
242
234
|
<td> PostScript level
|
|
243
235
|
</td>
|
|
244
236
|
</tr>
|
|
@@ -249,15 +241,14 @@ surface.</p>
|
|
|
249
241
|
</div>
|
|
250
242
|
<hr>
|
|
251
243
|
<div class="refsect2" lang="en">
|
|
252
|
-
<a name="
|
|
253
|
-
<
|
|
254
|
-
<a class="indexterm" name="id2667663"></a><pre class="programlisting">typedef enum _cairo_ps_level {
|
|
244
|
+
<a name="cairo-ps-level-t"></a><h3>enum cairo_ps_level_t</h3>
|
|
245
|
+
<pre class="programlisting">typedef enum _cairo_ps_level {
|
|
255
246
|
CAIRO_PS_LEVEL_2,
|
|
256
247
|
CAIRO_PS_LEVEL_3
|
|
257
248
|
} cairo_ps_level_t;
|
|
258
249
|
</pre>
|
|
259
250
|
<p>
|
|
260
|
-
<a class="link" href="cairo-
|
|
251
|
+
<a class="link" href="cairo-ps-surface.html#cairo-ps-level-t" title="enum cairo_ps_level_t"><span class="type">cairo_ps_level_t</span></a> is used to describe the language level of the
|
|
261
252
|
PostScript Language Reference that a generated PostScript file will
|
|
262
253
|
conform to.</p>
|
|
263
254
|
<p>
|
|
@@ -267,12 +258,12 @@ conform to.</p>
|
|
|
267
258
|
<col align="left" valign="top">
|
|
268
259
|
<tbody>
|
|
269
260
|
<tr>
|
|
270
|
-
<td><p><
|
|
261
|
+
<td><p><a name="CAIRO-PS-LEVEL-2:CAPS"></a><span class="term"><code class="literal">CAIRO_PS_LEVEL_2</code></span></p></td>
|
|
271
262
|
<td> The language level 2 of the PostScript specification.
|
|
272
263
|
</td>
|
|
273
264
|
</tr>
|
|
274
265
|
<tr>
|
|
275
|
-
<td><p><
|
|
266
|
+
<td><p><a name="CAIRO-PS-LEVEL-3:CAPS"></a><span class="term"><code class="literal">CAIRO_PS_LEVEL_3</code></span></p></td>
|
|
276
267
|
<td> The language level 3 of the PostScript specification.
|
|
277
268
|
</td>
|
|
278
269
|
</tr>
|
|
@@ -281,13 +272,12 @@ conform to.</p>
|
|
|
281
272
|
</div>
|
|
282
273
|
<hr>
|
|
283
274
|
<div class="refsect2" lang="en">
|
|
284
|
-
<a name="
|
|
285
|
-
<a
|
|
286
|
-
<a class="indexterm" name="id2667746"></a><pre class="programlisting">void cairo_ps_get_levels (<a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-level-t">cairo_ps_level_t</a> const **levels,
|
|
275
|
+
<a name="cairo-ps-get-levels"></a><h3>cairo_ps_get_levels ()</h3>
|
|
276
|
+
<pre class="programlisting">void cairo_ps_get_levels (<a class="link" href="cairo-ps-surface.html#cairo-ps-level-t" title="enum cairo_ps_level_t">cairo_ps_level_t</a> const **levels,
|
|
287
277
|
int *num_levels);</pre>
|
|
288
278
|
<p>
|
|
289
279
|
Used to retrieve the list of supported levels. See
|
|
290
|
-
<a class="link" href="cairo-
|
|
280
|
+
<a class="link" href="cairo-ps-surface.html#cairo-ps-surface-restrict-to-level" title="cairo_ps_surface_restrict_to_level ()"><code class="function">cairo_ps_surface_restrict_to_level()</code></a>.</p>
|
|
291
281
|
<p>
|
|
292
282
|
|
|
293
283
|
</p>
|
|
@@ -295,12 +285,12 @@ Used to retrieve the list of supported levels. See
|
|
|
295
285
|
<col align="left" valign="top">
|
|
296
286
|
<tbody>
|
|
297
287
|
<tr>
|
|
298
|
-
<td><p><span class="term"><em class="parameter"><code>levels</code></em
|
|
288
|
+
<td><p><span class="term"><em class="parameter"><code>levels</code></em> :</span></p></td>
|
|
299
289
|
<td> supported level list
|
|
300
290
|
</td>
|
|
301
291
|
</tr>
|
|
302
292
|
<tr>
|
|
303
|
-
<td><p><span class="term"><em class="parameter"><code>num_levels</code></em
|
|
293
|
+
<td><p><span class="term"><em class="parameter"><code>num_levels</code></em> :</span></p></td>
|
|
304
294
|
<td> list length
|
|
305
295
|
</td>
|
|
306
296
|
</tr>
|
|
@@ -311,12 +301,11 @@ Used to retrieve the list of supported levels. See
|
|
|
311
301
|
</div>
|
|
312
302
|
<hr>
|
|
313
303
|
<div class="refsect2" lang="en">
|
|
314
|
-
<a name="
|
|
315
|
-
<a
|
|
316
|
-
<a class="indexterm" name="id2667849"></a><pre class="programlisting">const char* cairo_ps_level_to_string (<a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-level-t">cairo_ps_level_t</a> level);</pre>
|
|
304
|
+
<a name="cairo-ps-level-to-string"></a><h3>cairo_ps_level_to_string ()</h3>
|
|
305
|
+
<pre class="programlisting">const char* cairo_ps_level_to_string (<a class="link" href="cairo-ps-surface.html#cairo-ps-level-t" title="enum cairo_ps_level_t">cairo_ps_level_t</a> level);</pre>
|
|
317
306
|
<p>
|
|
318
307
|
Get the string representation of the given <em class="parameter"><code>level</code></em> id. This function
|
|
319
|
-
will return <code class="literal">NULL</code> if <em class="parameter"><code>level</code></em> id isn't valid. See <a class="link" href="cairo-
|
|
308
|
+
will return <code class="literal">NULL</code> if <em class="parameter"><code>level</code></em> id isn't valid. See <a class="link" href="cairo-ps-surface.html#cairo-ps-get-levels" title="cairo_ps_get_levels ()"><code class="function">cairo_ps_get_levels()</code></a>
|
|
320
309
|
for a way to get the list of valid level ids.</p>
|
|
321
310
|
<p>
|
|
322
311
|
|
|
@@ -325,12 +314,12 @@ for a way to get the list of valid level ids.</p>
|
|
|
325
314
|
<col align="left" valign="top">
|
|
326
315
|
<tbody>
|
|
327
316
|
<tr>
|
|
328
|
-
<td><p><span class="term"><em class="parameter"><code>level</code></em
|
|
317
|
+
<td><p><span class="term"><em class="parameter"><code>level</code></em> :</span></p></td>
|
|
329
318
|
<td> a level id
|
|
330
319
|
</td>
|
|
331
320
|
</tr>
|
|
332
321
|
<tr>
|
|
333
|
-
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span
|
|
322
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
334
323
|
<td> the string associated to given level.
|
|
335
324
|
|
|
336
325
|
</td>
|
|
@@ -342,10 +331,9 @@ for a way to get the list of valid level ids.</p>
|
|
|
342
331
|
</div>
|
|
343
332
|
<hr>
|
|
344
333
|
<div class="refsect2" lang="en">
|
|
345
|
-
<a name="
|
|
346
|
-
<a
|
|
347
|
-
<a class="
|
|
348
|
-
<a class="link" href="cairo-Types.html#cairo-bool-t">cairo_bool_t</a> eps);</pre>
|
|
334
|
+
<a name="cairo-ps-surface-set-eps"></a><h3>cairo_ps_surface_set_eps ()</h3>
|
|
335
|
+
<pre class="programlisting">void cairo_ps_surface_set_eps (<a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a> *surface,
|
|
336
|
+
<a class="link" href="cairo-types.html#cairo-bool-t" title="cairo_bool_t">cairo_bool_t</a> eps);</pre>
|
|
349
337
|
<p>
|
|
350
338
|
If <em class="parameter"><code>eps</code></em> is <code class="literal">TRUE</code>, the PostScript surface will output Encapsulated
|
|
351
339
|
PostScript.
|
|
@@ -363,12 +351,12 @@ than one page.</p>
|
|
|
363
351
|
<col align="left" valign="top">
|
|
364
352
|
<tbody>
|
|
365
353
|
<tr>
|
|
366
|
-
<td><p><span class="term"><em class="parameter"><code>surface</code></em
|
|
367
|
-
<td> a PostScript <a class="link" href="cairo-
|
|
354
|
+
<td><p><span class="term"><em class="parameter"><code>surface</code></em> :</span></p></td>
|
|
355
|
+
<td> a PostScript <a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a>
|
|
368
356
|
</td>
|
|
369
357
|
</tr>
|
|
370
358
|
<tr>
|
|
371
|
-
<td><p><span class="term"><em class="parameter"><code>eps</code></em
|
|
359
|
+
<td><p><span class="term"><em class="parameter"><code>eps</code></em> :</span></p></td>
|
|
372
360
|
<td> <code class="literal">TRUE</code> to output EPS format PostScript
|
|
373
361
|
</td>
|
|
374
362
|
</tr>
|
|
@@ -379,9 +367,8 @@ than one page.</p>
|
|
|
379
367
|
</div>
|
|
380
368
|
<hr>
|
|
381
369
|
<div class="refsect2" lang="en">
|
|
382
|
-
<a name="
|
|
383
|
-
<a
|
|
384
|
-
<a class="indexterm" name="id2668097"></a><pre class="programlisting"><a class="link" href="cairo-Types.html#cairo-bool-t">cairo_bool_t</a> cairo_ps_surface_get_eps (<a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t">cairo_surface_t</a> *surface);</pre>
|
|
370
|
+
<a name="cairo-ps-surface-get-eps"></a><h3>cairo_ps_surface_get_eps ()</h3>
|
|
371
|
+
<pre class="programlisting"><a class="link" href="cairo-types.html#cairo-bool-t" title="cairo_bool_t">cairo_bool_t</a> cairo_ps_surface_get_eps (<a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a> *surface);</pre>
|
|
385
372
|
<p>
|
|
386
373
|
Check whether the PostScript surface will output Encapsulated PostScript.</p>
|
|
387
374
|
<p>
|
|
@@ -391,12 +378,12 @@ Check whether the PostScript surface will output Encapsulated PostScript.</p>
|
|
|
391
378
|
<col align="left" valign="top">
|
|
392
379
|
<tbody>
|
|
393
380
|
<tr>
|
|
394
|
-
<td><p><span class="term"><em class="parameter"><code>surface</code></em
|
|
395
|
-
<td> a PostScript <a class="link" href="cairo-
|
|
381
|
+
<td><p><span class="term"><em class="parameter"><code>surface</code></em> :</span></p></td>
|
|
382
|
+
<td> a PostScript <a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a>
|
|
396
383
|
</td>
|
|
397
384
|
</tr>
|
|
398
385
|
<tr>
|
|
399
|
-
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span
|
|
386
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
400
387
|
<td> <code class="literal">TRUE</code> if the surface will output Encapsulated PostScript.
|
|
401
388
|
|
|
402
389
|
</td>
|
|
@@ -408,9 +395,8 @@ Check whether the PostScript surface will output Encapsulated PostScript.</p>
|
|
|
408
395
|
</div>
|
|
409
396
|
<hr>
|
|
410
397
|
<div class="refsect2" lang="en">
|
|
411
|
-
<a name="
|
|
412
|
-
<a
|
|
413
|
-
<a class="indexterm" name="id2668197"></a><pre class="programlisting">void cairo_ps_surface_set_size (<a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t">cairo_surface_t</a> *surface,
|
|
398
|
+
<a name="cairo-ps-surface-set-size"></a><h3>cairo_ps_surface_set_size ()</h3>
|
|
399
|
+
<pre class="programlisting">void cairo_ps_surface_set_size (<a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a> *surface,
|
|
414
400
|
double width_in_points,
|
|
415
401
|
double height_in_points);</pre>
|
|
416
402
|
<p>
|
|
@@ -422,7 +408,7 @@ This function should only be called before any drawing operations
|
|
|
422
408
|
have been performed on the current page. The simplest way to do
|
|
423
409
|
this is to call this function immediately after creating the
|
|
424
410
|
surface or immediately after completing a page with either
|
|
425
|
-
<a class="link" href="cairo-
|
|
411
|
+
<a class="link" href="cairo-context.html#cairo-show-page" title="cairo_show_page ()"><code class="function">cairo_show_page()</code></a> or <a class="link" href="cairo-context.html#cairo-copy-page" title="cairo_copy_page ()"><code class="function">cairo_copy_page()</code></a>.</p>
|
|
426
412
|
<p>
|
|
427
413
|
|
|
428
414
|
</p>
|
|
@@ -430,17 +416,17 @@ surface or immediately after completing a page with either
|
|
|
430
416
|
<col align="left" valign="top">
|
|
431
417
|
<tbody>
|
|
432
418
|
<tr>
|
|
433
|
-
<td><p><span class="term"><em class="parameter"><code>surface</code></em
|
|
434
|
-
<td> a PostScript <a class="link" href="cairo-
|
|
419
|
+
<td><p><span class="term"><em class="parameter"><code>surface</code></em> :</span></p></td>
|
|
420
|
+
<td> a PostScript <a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a>
|
|
435
421
|
</td>
|
|
436
422
|
</tr>
|
|
437
423
|
<tr>
|
|
438
|
-
<td><p><span class="term"><em class="parameter"><code>width_in_points</code></em
|
|
424
|
+
<td><p><span class="term"><em class="parameter"><code>width_in_points</code></em> :</span></p></td>
|
|
439
425
|
<td> new surface width, in points (1 point == 1/72.0 inch)
|
|
440
426
|
</td>
|
|
441
427
|
</tr>
|
|
442
428
|
<tr>
|
|
443
|
-
<td><p><span class="term"><em class="parameter"><code>height_in_points</code></em
|
|
429
|
+
<td><p><span class="term"><em class="parameter"><code>height_in_points</code></em> :</span></p></td>
|
|
444
430
|
<td> new surface height, in points (1 point == 1/72.0 inch)
|
|
445
431
|
</td>
|
|
446
432
|
</tr>
|
|
@@ -451,29 +437,28 @@ surface or immediately after completing a page with either
|
|
|
451
437
|
</div>
|
|
452
438
|
<hr>
|
|
453
439
|
<div class="refsect2" lang="en">
|
|
454
|
-
<a name="
|
|
455
|
-
<a
|
|
456
|
-
<a class="indexterm" name="id2668349"></a><pre class="programlisting">void cairo_ps_surface_dsc_begin_setup (<a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t">cairo_surface_t</a> *surface);</pre>
|
|
440
|
+
<a name="cairo-ps-surface-dsc-begin-setup"></a><h3>cairo_ps_surface_dsc_begin_setup ()</h3>
|
|
441
|
+
<pre class="programlisting">void cairo_ps_surface_dsc_begin_setup (<a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a> *surface);</pre>
|
|
457
442
|
<p>
|
|
458
443
|
This function indicates that subsequent calls to
|
|
459
|
-
<a class="link" href="cairo-
|
|
444
|
+
<a class="link" href="cairo-ps-surface.html#cairo-ps-surface-dsc-comment" title="cairo_ps_surface_dsc_comment ()"><code class="function">cairo_ps_surface_dsc_comment()</code></a> should direct comments to the Setup
|
|
460
445
|
section of the PostScript output.
|
|
461
446
|
</p>
|
|
462
447
|
<p>
|
|
463
448
|
This function should be called at most once per surface, and must
|
|
464
|
-
be called before any call to <a class="link" href="cairo-
|
|
449
|
+
be called before any call to <a class="link" href="cairo-ps-surface.html#cairo-ps-surface-dsc-begin-page-setup" title="cairo_ps_surface_dsc_begin_page_setup ()"><code class="function">cairo_ps_surface_dsc_begin_page_setup()</code></a>
|
|
465
450
|
and before any drawing is performed to the surface.
|
|
466
451
|
</p>
|
|
467
452
|
<p>
|
|
468
|
-
See <a class="link" href="cairo-
|
|
453
|
+
See <a class="link" href="cairo-ps-surface.html#cairo-ps-surface-dsc-comment" title="cairo_ps_surface_dsc_comment ()"><code class="function">cairo_ps_surface_dsc_comment()</code></a> for more details.</p>
|
|
469
454
|
<p>
|
|
470
455
|
|
|
471
456
|
</p>
|
|
472
457
|
<div class="variablelist"><table border="0">
|
|
473
458
|
<col align="left" valign="top">
|
|
474
459
|
<tbody><tr>
|
|
475
|
-
<td><p><span class="term"><em class="parameter"><code>surface</code></em
|
|
476
|
-
<td> a PostScript <a class="link" href="cairo-
|
|
460
|
+
<td><p><span class="term"><em class="parameter"><code>surface</code></em> :</span></p></td>
|
|
461
|
+
<td> a PostScript <a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a>
|
|
477
462
|
</td>
|
|
478
463
|
</tr></tbody>
|
|
479
464
|
</table></div>
|
|
@@ -482,31 +467,30 @@ See <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-co
|
|
|
482
467
|
</div>
|
|
483
468
|
<hr>
|
|
484
469
|
<div class="refsect2" lang="en">
|
|
485
|
-
<a name="
|
|
486
|
-
<
|
|
487
|
-
<a class="
|
|
488
|
-
(<a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t">cairo_surface_t</a> *surface);</pre>
|
|
470
|
+
<a name="cairo-ps-surface-dsc-begin-page-setup"></a><h3>cairo_ps_surface_dsc_begin_page_setup ()</h3>
|
|
471
|
+
<pre class="programlisting">void cairo_ps_surface_dsc_begin_page_setup
|
|
472
|
+
(<a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a> *surface);</pre>
|
|
489
473
|
<p>
|
|
490
474
|
This function indicates that subsequent calls to
|
|
491
|
-
<a class="link" href="cairo-
|
|
475
|
+
<a class="link" href="cairo-ps-surface.html#cairo-ps-surface-dsc-comment" title="cairo_ps_surface_dsc_comment ()"><code class="function">cairo_ps_surface_dsc_comment()</code></a> should direct comments to the
|
|
492
476
|
PageSetup section of the PostScript output.
|
|
493
477
|
</p>
|
|
494
478
|
<p>
|
|
495
479
|
This function call is only needed for the first page of a
|
|
496
480
|
surface. It should be called after any call to
|
|
497
|
-
<a class="link" href="cairo-
|
|
481
|
+
<a class="link" href="cairo-ps-surface.html#cairo-ps-surface-dsc-begin-setup" title="cairo_ps_surface_dsc_begin_setup ()"><code class="function">cairo_ps_surface_dsc_begin_setup()</code></a> and before any drawing is
|
|
498
482
|
performed to the surface.
|
|
499
483
|
</p>
|
|
500
484
|
<p>
|
|
501
|
-
See <a class="link" href="cairo-
|
|
485
|
+
See <a class="link" href="cairo-ps-surface.html#cairo-ps-surface-dsc-comment" title="cairo_ps_surface_dsc_comment ()"><code class="function">cairo_ps_surface_dsc_comment()</code></a> for more details.</p>
|
|
502
486
|
<p>
|
|
503
487
|
|
|
504
488
|
</p>
|
|
505
489
|
<div class="variablelist"><table border="0">
|
|
506
490
|
<col align="left" valign="top">
|
|
507
491
|
<tbody><tr>
|
|
508
|
-
<td><p><span class="term"><em class="parameter"><code>surface</code></em
|
|
509
|
-
<td> a PostScript <a class="link" href="cairo-
|
|
492
|
+
<td><p><span class="term"><em class="parameter"><code>surface</code></em> :</span></p></td>
|
|
493
|
+
<td> a PostScript <a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a>
|
|
510
494
|
</td>
|
|
511
495
|
</tr></tbody>
|
|
512
496
|
</table></div>
|
|
@@ -515,9 +499,8 @@ See <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-co
|
|
|
515
499
|
</div>
|
|
516
500
|
<hr>
|
|
517
501
|
<div class="refsect2" lang="en">
|
|
518
|
-
<a name="
|
|
519
|
-
<a
|
|
520
|
-
<a class="indexterm" name="id2668596"></a><pre class="programlisting">void cairo_ps_surface_dsc_comment (<a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t">cairo_surface_t</a> *surface,
|
|
502
|
+
<a name="cairo-ps-surface-dsc-comment"></a><h3>cairo_ps_surface_dsc_comment ()</h3>
|
|
503
|
+
<pre class="programlisting">void cairo_ps_surface_dsc_comment (<a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a> *surface,
|
|
521
504
|
const char *comment);</pre>
|
|
522
505
|
<p>
|
|
523
506
|
Emit a comment into the PostScript output for the given surface.
|
|
@@ -567,7 +550,7 @@ should be called after a call to <code class="function">cairo_ps_surface_begin_p
|
|
|
567
550
|
<p>
|
|
568
551
|
Note that it is only necessary to call <code class="function">cairo_ps_surface_begin_page_setup()</code>
|
|
569
552
|
for the first page of any surface. After a call to
|
|
570
|
-
<a class="link" href="cairo-
|
|
553
|
+
<a class="link" href="cairo-context.html#cairo-show-page" title="cairo_show_page ()"><code class="function">cairo_show_page()</code></a> or <a class="link" href="cairo-context.html#cairo-copy-page" title="cairo_copy_page ()"><code class="function">cairo_copy_page()</code></a> comments are unambiguously
|
|
571
554
|
directed to the PageSetup section of the current page. But it
|
|
572
555
|
doesn't hurt to call this function at the beginning of every page
|
|
573
556
|
as that consistency may make the calling code simpler.
|
|
@@ -597,7 +580,7 @@ Here is an example sequence showing how this function might be used:
|
|
|
597
580
|
<p>
|
|
598
581
|
</p>
|
|
599
582
|
<div class="informalexample"><pre class="programlisting">
|
|
600
|
-
<a class="link" href="cairo-
|
|
583
|
+
<a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a> *surface = cairo_ps_surface_create (filename, width, height);
|
|
601
584
|
...
|
|
602
585
|
cairo_ps_surface_dsc_comment (surface, "%%Title: My excellent document");
|
|
603
586
|
cairo_ps_surface_dsc_comment (surface, "%%Copyright: Copyright (C) 2006 Cairo Lover")
|
|
@@ -623,12 +606,12 @@ cairo_ps_surface_dsc_comment (surface, "%%IncludeFeature: *PageSize A5");
|
|
|
623
606
|
<col align="left" valign="top">
|
|
624
607
|
<tbody>
|
|
625
608
|
<tr>
|
|
626
|
-
<td><p><span class="term"><em class="parameter"><code>surface</code></em
|
|
627
|
-
<td> a PostScript <a class="link" href="cairo-
|
|
609
|
+
<td><p><span class="term"><em class="parameter"><code>surface</code></em> :</span></p></td>
|
|
610
|
+
<td> a PostScript <a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a>
|
|
628
611
|
</td>
|
|
629
612
|
</tr>
|
|
630
613
|
<tr>
|
|
631
|
-
<td><p><span class="term"><em class="parameter"><code>comment</code></em
|
|
614
|
+
<td><p><span class="term"><em class="parameter"><code>comment</code></em> :</span></p></td>
|
|
632
615
|
<td> a comment string to be emitted into the PostScript output
|
|
633
616
|
</td>
|
|
634
617
|
</tr>
|
|
@@ -639,18 +622,16 @@ cairo_ps_surface_dsc_comment (surface, "%%IncludeFeature: *PageSize A5");
|
|
|
639
622
|
</div>
|
|
640
623
|
</div>
|
|
641
624
|
<div class="refsect1" lang="en">
|
|
642
|
-
<a name="
|
|
625
|
+
<a name="cairo-ps-surface.see-also"></a><h2>See Also</h2>
|
|
643
626
|
<p>
|
|
644
627
|
</p>
|
|
645
|
-
<div class="itemizedlist"><ul type="disc"><li><a class="link" href="cairo-
|
|
628
|
+
<div class="itemizedlist"><ul type="disc"><li><a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a></li></ul></div>
|
|
646
629
|
<p>
|
|
647
630
|
</p>
|
|
648
631
|
</div>
|
|
649
|
-
<div class="refsect1" lang="en">
|
|
650
|
-
<a name="id2669042"></a><div class="refsect2" lang="en"><a name="id2669043"></a></div>
|
|
651
|
-
<hr>
|
|
652
|
-
<div class="refsect2" lang="en"><a name="id2669044"></a></div>
|
|
653
|
-
</div>
|
|
654
632
|
</div>
|
|
633
|
+
<div class="footer">
|
|
634
|
+
<hr>
|
|
635
|
+
Generated by GTK-Doc V1.10</div>
|
|
655
636
|
</body>
|
|
656
637
|
</html>
|