diff options
Diffstat (limited to 'html/en/drv/cairo.html')
| -rw-r--r-- | html/en/drv/cairo.html | 56 |
1 files changed, 46 insertions, 10 deletions
diff --git a/html/en/drv/cairo.html b/html/en/drv/cairo.html index 2e04833..adb65ac 100644 --- a/html/en/drv/cairo.html +++ b/html/en/drv/cairo.html @@ -10,6 +10,9 @@ .style1 { font-family: Courier; } +.style3 { + text-decoration: underline; +} </style> </head> @@ -19,8 +22,7 @@ <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 Pango functions to support Unicode text. This driver can be + <a href="http://library.gnome.org/devel/pango/">Cairo</a> and Pango functions. This driver can be compiled and used in all systems Cairo is supported. The drivers <b>Native Window</b>, <b>Image</b>, <b>Printer</b> and <b>Double Buffer</b> were implemented.</p> <p>The main motivation for the use of Cairo was transparency for all the @@ -40,15 +42,49 @@ for complex clipping regions.</p> <span style="font-family: Courier">CD_DBUFFER</span></strong>, because they are function calls and not static defines.</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 GD, Win32 or X-Windows canvas.</p> + 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>". - When using the GDK base driver you do not need to link with the "<strong>cdcairo</strong>" - library. Also the Cairo library must be installed in your system.</p> - <p>In CDLua it is not necessary any additional initialization, but the - application must still be linked with the <strong>cdcontextplus.lib</strong> - library or a <strong>require"cdluacontextplus"</strong> can be used when - using dynamic libraries.</p> + 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> + +<h3>Extra Drivers (cdcairo.h)</h3> +<p>Only available in Lua when <strong>require"cdluacairo"</strong> is +used.</p> + +<h4>CD_CAIRO_PS - PostScript Driver</h4> + + <p>Similar to <a href="ps.html">CD_PS</a>, uses the same creation parameters. + But margins are not supported and Postscript level can be 2 (parameter -2) + or 3 (parameter -3).</p> + +<h4>CD_CAIRO_PDF - PDF Driver</h4> + + <p>Similar to <a href="pdf.html">CD_PDF</a>, uses the same creation + parameters. The driver also does not depends on the PDFLib. The additional + attributes "OPACITY", "PATTERN", "PDF", "PDFLIBVERSION" and the description + strings, are not supported.</p> +<h4>CD_CAIRO_SVG - Scalable Vector Graphics Driver</h4> + + <p>Similar to <a href="svg.html">CD_SVG</a>, uses the same creation + parameters. The additional attributes "OPACITY" and "CMD" are not supported.</p> + +<h4>CD_CAIRO_IMAGERGB - RGB Client Image Driver</h4> + + <p>Similar to <a href="irgb.html">CD_IMAGERGB</a>, uses <span class="style3"> + almost</span> the same creation parameters. The main difference is that the + data pointers are packed in RGBARGBARGBA... format. So it is used only 1 + pointer for data, instead of 3. Also the attributes "REDIMAGE", + "GREENIMAGE", "BLUEIMAGE" and "ALPHAIMAGE are not supported and replaced by + the "RGBDATA" attribute. There are also two new attributes, "STRIDE" that + returns the line size in bytes, when data is specified during creation then + stride is always width*32. Even when there is not alpha channel, data is + stored in 32 bits per pixel. Image data is also organized in top-bottom + orientation, it means the data pointer points to the top-left corner.</p> <h3>Behavior of Functions</h3> <h4>Control </h4> |