From cc487d4de29a48d8e20a9a8492957a5950d5c181 Mon Sep 17 00:00:00 2001 From: scuri Date: Fri, 21 May 2010 04:51:07 +0000 Subject: *** empty log message *** --- html/en/drv/cairo.html | 42 ++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 40 insertions(+), 2 deletions(-) (limited to 'html/en/drv/cairo.html') diff --git a/html/en/drv/cairo.html b/html/en/drv/cairo.html index 4977258..c0ad80f 100644 --- a/html/en/drv/cairo.html +++ b/html/en/drv/cairo.html @@ -6,6 +6,11 @@ CAIRO + @@ -15,8 +20,9 @@

This driver represents a basic driver for all system-dependent drivers implemented in the X-Windows and MS-Windows systems. The implementation uses the Cairo API - functions and some GTK functions to support Unicode text. This driver can be - compiled and used in all systems Cairo is supported.

+ functions and Pango functions to support Unicode text. This driver can be + compiled and used in all systems Cairo is supported. The drivers Native Window, + Image, Printer and Double Buffer were implemented.

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 @@ -24,6 +30,25 @@ PNG surfaces).

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.

+

So we let the programmer to choose what to use. We created the function + cdUseContextPlus that allows to activate or to deactivate the use of + Cairo for the available GDK, Win32 or X-Windows based drivers. + This function affects only the cdCreateCanvas function call, once created + the canvas will be always a Cairo canvas. In fact the function affects primary the definitions + CD_NATIVEWINDOW, + CD_IMAGE and + CD_DBUFFER, because they are + function calls and not static defines.

+

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 GD, Win32 or X-Windows canvas.

+

To enable the use of Cairo based drivers you must call the initialization function + cdInitContextPlus() once and link to the libraries "cdcairo" and "cairo". + When using the GDK base driver you do not need to link with the "cdcairo" + library. Also the Cairo library must be installed in your system.

+

In CDLua it is not necessary any additional initialization, but the + application must still be linked with the cdcontextplus.lib + library or a require"cdluacontextplus" can be used when + using dynamic libraries.

Behavior of Functions

Control 

@@ -39,6 +64,13 @@ for complex clipping regions.

UpdateYAxis: the orientation of axis Y is the opposite to its orientation in the CD library. +

Primitives

+

Attributes

+ +