diff options
Diffstat (limited to 'html/en/drv/cairo.html')
| -rw-r--r-- | html/en/drv/cairo.html | 31 |
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 "<strong>cdcairo</strong>" and "<strong>cairo</strong>". Also the Cairo library must be installed in your system. - When using the GDK base driver you do not need to link with the "<strong>cdcairo</strong>" - library. </p> - <p>In CDLua it is not necessary any additional initialization, and <strong>require"cdluacairo"</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 "<strong>cdcairo</strong>" and "<strong>cairo</strong>".</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"cdluacontextplus"</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>"<strong>cdluacairo"</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"cdluacairo"</strong> is |