summaryrefslogtreecommitdiff
path: root/html/en/drv/cairo.html
diff options
context:
space:
mode:
authorscuri <scuri>2010-10-13 19:19:03 +0000
committerscuri <scuri>2010-10-13 19:19:03 +0000
commiteef7ae01a9757f5e4a0693d539ee1fac5b09e756 (patch)
tree115563a582bdfc2df884eed611eec530db246142 /html/en/drv/cairo.html
parentccb038c14044d74e1a56f8fa20a9b3d958888735 (diff)
*** empty log message ***
Diffstat (limited to 'html/en/drv/cairo.html')
-rw-r--r--html/en/drv/cairo.html31
1 files changed, 19 insertions, 12 deletions
diff --git a/html/en/drv/cairo.html b/html/en/drv/cairo.html
index 04cb3e9..eea6f75 100644
--- a/html/en/drv/cairo.html
+++ b/html/en/drv/cairo.html
@@ -1,5 +1,5 @@
<!doctype HTML PUBLIC "-//IETF//DTD HTML//EN">
-<html>
+<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office">
<head>
<meta http-equiv="Content-Language" content="en-us">
@@ -22,19 +22,22 @@
<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> and Pango functions. This driver can be
+ <a href="http://cairographics.org/">Cairo</a> and
+ <a href="http://library.gnome.org/devel/pango/">Pango</a> functions. This driver can be
compiled and used in all systems Cairo is supported. The drivers <b>Native Window</b>,
<b>Image</b>, <b>EMF</b>, <b>Printer</b> and <b>Double Buffer</b> were implemented.</p>
+<p>It can be used as the context plus driver of the GDI, GDK and X-Win based
+drivers. But its primary focus is the GDK base driver.</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 other back-ends (support to rendering: PDF, PS, SVG and
IMAGERGB surfaces).</p>
-<p>This driver still does not completely replace the X-Windows and GDI Windows
+<p>This driver still does not completely replace the X-Windows, GDK and GDI Windows
base drivers, because Cairo does not have support for bitwise XOR operations and
for complex clipping regions.</p>
<p>So we let the programmer to choose what to use. We created the function <font face="Courier"><strong>
- cdUseContextPlus</strong></font> that allows to activate or to deactivate the use of
- Cairo for the available GDK, Win32 or X-Windows based drivers.
+ <a href="../func/init.html#cdUseContextPlus">cdUseContextPlus</a></strong></font> that allows to activate or to deactivate the use of
+ Cairo for the available GDK, Win32 or X-Win based drivers.
This function affects only the <font face="Courier"><strong>cdCreateCanvas</strong></font> function call, once created
the canvas will be always a Cairo canvas. In fact the function affects primary the definitions
<font face="Courier"><strong>CD_NATIVEWINDOW</strong></font>,
@@ -50,13 +53,17 @@ for complex clipping regions.</p>
<p>Using Cairo it is allowed to create more that one canvas at the same time for the same Window. And they can co-exist
with a standard GDK, Win32 or X-Windows canvas.</p>
<p>To enable the use of Cairo based drivers you must call the initialization function <font face="Courier"><strong>
- cdInitContextPlus()</strong></font> once and link to the libraries &quot;<strong>cdcairo</strong>&quot; and &quot;<strong>cairo</strong>&quot;. Also the Cairo library must be installed in your system.
- When using the GDK base driver you do not need to link with the &quot;<strong>cdcairo</strong>&quot;
- library. </p>
- <p>In CDLua it is not necessary any additional initialization, and <strong>require&quot;cdluacairo&quot;</strong> can be used when
- using dynamic libraries. But when using require there are some restrictions,
- in Win32 the GDK base driver can NOT be used, in Linux the X11 base driver
- can NOT be used, and in other UNICES the GDK base driver can NOT be used.</p>
+ <a href="../func/init.html#cdInitContextPlus">cdInitContextPlus</a></strong></font> once, and
+ do not need to link with any additional library when using the GDK base
+ driver. But when using with the GDI and X-Win base drivers you need to link to the libraries &quot;<strong>cdcairo</strong>&quot; and &quot;<strong>cairo</strong>&quot;.</p>
+<p>Also the Cairo library must be installed in your system.</p>
+ <p>In CDLua it is not necessary any additional initialization, and <strong>require&quot;cdluacontextplus&quot;</strong> can be used when
+ using dynamic libraries. But it is available only in Linux and only for the
+ GDK base driver.</p>
+<p>As an alternative you can use <strong>require</strong>&quot;<strong>cdluacairo&quot;</strong>,
+but there are some restrictions:
+ in Windows only the GDI base driver can be used; in Linux only the X-Win base driver
+ can be used.</p>
<h3>Extra Drivers (cdcairo.h)</h3>
<p>Only available in Lua when <strong>require&quot;cdluacairo&quot;</strong> is