1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
|
<!doctype HTML PUBLIC "-//IETF//DTD HTML//EN">
<html>
<head>
<meta http-equiv="Content-Language" content="en-us">
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<title>CAIRO</title>
<link rel="stylesheet" type="text/css" href="../../style.css">
</head>
<body>
<h2>CAIRO Base Driver</h2>
<p>This driver represents a basic driver for all system-dependent drivers
implemented in the X-Windows and MS-Windows systems. The implementation uses the
<a href="http://library.gnome.org/devel/pango/">Cairo</a> API
functions and some GTK functions to support Unicode text. This driver can be
compiled and used in all systems Cairo is supported.</p>
<p>The main motivation for the use of Cairo was transparency for all the
primitives. Beyond that we got other features like anti-aliasing, gradient
filling, transformations and back-ends (support to rendering: PDF, PS, SVG and
PNG surfaces).</p>
<p>This driver still does not completely replace the X-Windows and GDI Windows
base drivers, because Cairo does not have support for bitwise XOR operations and
for complex clipping regions.</p>
<h3>Behavior of Functions</h3>
<h4>Control </h4>
<ul>
<li><a href="../func/other.html#cdPlay">
<font face="Courier"><strong>Play</strong></font></a>: does nothing, returns
<font face="Courier">CD_ERROR</font>. </li>
</ul>
<h4>Coordinate System and Clipping </h4>
<ul>
<li>
<a href="../func/coordinates.html#cdUpdateYAxis">
<font face="Courier"><strong>UpdateYAxis</strong></font></a>: the
orientation of axis Y is the opposite to its orientation in the CD library.</li>
</ul>
<h4>Attributes </h4>
<ul>
<li>
<a href="http://www.tecgraf.puc-rio.br/cd/en/func/attributes.html#cdWriteMode">
<font face="Courier"><strong>WriteMode</strong></font></a>: does nothing.
There is no support for XOR or NOT_XOR.</li>
<li>
<a href="../func/text.html#cdNativeFont">
<font face="Courier"><strong>NativeFont</strong></font></a>: also accepts the
X-Windows font string format.</li>
<li><a href="../func/text.html#cdFont">
<font face="Courier"><strong>Font</strong></font></a>: "Courier" is mapped to
"Courier New", "Helvetica" is mapped to "Arial", and "Times" is mapped to
"Times New Roman". Underline and Strikeout are NOT supported.</li>
</ul>
<h4>Colors </h4>
<ul>
<li>
<a href="../func/color.html#cdPalette">
<font face="Courier"><strong>Palette</strong></font></a>: NOT supported.</li>
</ul>
<h4>Exclusive Attributes</h4>
<ul>
<li>"<b><font face="Courier">ANTIALIAS</font></b>": controls
the use of anti-aliasing for the text and drawing shapes. Assumes values "1"
(active) and "0" (inactive). Default value: "1".</li>
</ul>
<ul>
<li>"<b><font face="Courier">CAIRODC</font></b>": returns the
Cairo drawing context (get only). In Lua is returned as a user data.</li>
</ul>
<ul>
<li><b><font face="Courier">"CAIROVERSION": </font></b>returns a string with
the Cairo version number. It is empty if the Cairo is not available.</li>
</ul>
<ul>
<li><strong><span style="font-family: Courier">"HATCHBOXSIZE"</span></strong>:
defines the size of smallest hatch box pattern. This affects the spacing
between the hatch lines. The value passed must be a string containing an
integer ("%d"). If the value of the attribute passed is NULL, the value is
rest to the default. When consulted returns the current value ("%d"). Default:
"8".</li>
</ul>
<ul>
<li>"<b><font face="Courier">IMGINTERP</font></b>": changes how
interpolation is used in image scale. Can be "BEST" (highest-quality),
"BILINEAR" (linear interpolation), "GOOD" (quality similar to BILINEAR),
"NEAREST" (nearest-neighbor filtering) or "FAST" (quality similar to NEAREST).
Default: "GOOD".</li>
</ul>
<ul>
<li>"<b><font face="Courier">LINEGRADIENT</font></b>": defines
a filled interior style that uses a line gradient between two colors. It uses
2 points ("%d %d %d %d" = x1 y1 x2 y2), one for the starting point using
(using the foreground color), and another one for the end point (using the
background color).</li>
</ul>
<ul>
<li>"<b><font face="Courier">POLYHOLE</font></b>": defines the index of
the vertex where there is a hole in a closed polygon. It will affect the next
<strong>cdEnd</strong>. Can be called several times between <strong>cdBegin</strong>
and <strong>cdEnd</strong> to define holes. The value passed must be a string
containing an integer ("%d"). If the value of the attribute passed is NULL,
all holes will no longer be considered. When consulted returns the current
number of holes ("%d"). It can have a maximum of 500 holes. Default: NULL.</li>
</ul>
<ul>
<li>"<b><font face="Courier">RADIALGRADIENT</font></b>": defines
a filled interior style that uses a radial gradient between two colors. It
uses 2 points and 2 radius ("%d %d %g %d %d %g" = x1 y1 rad1 x2 y2 rad2), one
for the starting point using (using the foreground color), and another one for
the end point (using the background color).</li>
</ul>
<ul>
<li>"<b><font face="Courier">ROTATE</font></b>": allows the usage of 1
angle and 1 coordinate (x, y), that define a global rotation transformation
centered in the specified coordinate. Use 1 real and 2 integer values inside
a string ("%g %d %d" = angle x y). Can not be set if a transformation is
already set.</li>
</ul>
</body>
</html>
|
