From eef7ae01a9757f5e4a0693d539ee1fac5b09e756 Mon Sep 17 00:00:00 2001 From: scuri Date: Wed, 13 Oct 2010 19:19:03 +0000 Subject: *** empty log message *** --- html/en/drv/cairo.html | 31 +++++++++++++++++++------------ html/en/drv/clipbd.html | 19 ++++++++++--------- html/en/drv/dbuf.html | 21 ++++++++++++--------- html/en/drv/emf.html | 32 ++++++++++++++++++++------------ html/en/drv/gdiplus.html | 9 +++++---- html/en/drv/gl.html | 4 ++-- html/en/drv/image.html | 19 ++++++++++--------- html/en/drv/iup.html | 22 +++++++++++++--------- html/en/drv/native.html | 36 ++++++++++++++++++++++-------------- html/en/drv/pdf.html | 2 +- html/en/drv/printer.html | 27 ++++++++++++++------------- html/en/drv/win32.html | 2 +- html/en/drv/xrender.html | 9 +++++---- html/en/history.html | 9 +++++++++ html/wb/wb_usr.lua | 2 +- html/wb_tree.html | 2 +- src/lua5/cdlua5ctx.c | 16 ++++++++-------- 17 files changed, 153 insertions(+), 109 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 @@ - + @@ -22,19 +22,22 @@

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 and Pango functions. This driver can be + Cairo and + Pango functions. This driver can be compiled and used in all systems Cairo is supported. The drivers Native Window, Image, EMF, Printer and Double Buffer were implemented.

+

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.

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).

-

This driver still does not completely replace the X-Windows and GDI Windows +

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.

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. + cdUseContextPlus 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 cdCreateCanvas function call, once created the canvas will be always a Cairo canvas. In fact the function affects primary the definitions CD_NATIVEWINDOW, @@ -50,13 +53,17 @@ for complex clipping regions.

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.

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

-

In CDLua it is not necessary any additional initialization, and require"cdluacairo" 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.

+ cdInitContextPlus 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 "cdcairo" and "cairo".

+

Also the Cairo library must be installed in your system.

+

In CDLua it is not necessary any additional initialization, and require"cdluacontextplus" can be used when + using dynamic libraries. But it is available only in Linux and only for the + GDK base driver.

+

As an alternative you can use require"cdluacairo", +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.

Extra Drivers (cdcairo.h)

Only available in Lua when require"cdluacairo" is diff --git a/html/en/drv/clipbd.html b/html/en/drv/clipbd.html index 888198c..a5f068e 100644 --- a/html/en/drv/clipbd.html +++ b/html/en/drv/clipbd.html @@ -51,18 +51,19 @@ Display where the metafile will be obtained. The cdRegisterCallback must be called for the driver that will interpret the file, except for bitmaps that the CD_CLIPBOARD driver must be used.

-

To use this driver in Windows using GDI+ is necessary to call - - cdUseContextPlus(1) -before creating the canvas.

Behavior of Functions

-

This driver is greatly platform-dependent. For further detail, see the - Behavior of Functions in each platform: Microsoft - Windows (GDI), X-Windows (XLIB). However, it - should be noted that some functions behave differently from the basic - functions of each platform.

+

This driver is very platform-dependent.

+ +

For further detail, see the + Behavior of Functions in each base driver: GDI, + GDK and X-Win. To use this driver + with a context plus base driver is necessary to call + + cdUseContextPlus(1) + before creating the canvas, see the GDI+Cairo +and XRender base drivers.

diff --git a/html/en/drv/dbuf.html b/html/en/drv/dbuf.html index 0393d10..59dff49 100644 --- a/html/en/drv/dbuf.html +++ b/html/en/drv/dbuf.html @@ -45,18 +45,21 @@ cdCanvasActivate.

We suggest you to implement rubber bands using XOR directly on the front buffer.

-

To use this driver in Windows using GDI+ is necessary to call - - cdUseContextPlus(1) -before creating the canvas.

Behavior of Functions

-

This driver is greatly platform-dependent. For further detail, see the - Behavior of Functions in each platform: Microsoft - Windows (GDI), Windows Using GDI+, - X-Windows (XLIB), GDK. However, it should be noted that - some functions behave differently from the basic functions of each platform.

+

This driver is very platform-dependent.

+ +

For further detail, see the + Behavior of Functions in each base driver: GDI, + GDK and X-Win. To use this driver + with a context plus base driver is necessary to call + + cdUseContextPlus(1) + before creating the canvas, see the GDI+Cairo +and XRender base drivers.

+

However, it should be noted that some functions behave differently from the +basic functions of each platform.

Control