New: driver SVG.

author: scuri <scuri> 2009-12-02 20:30:55 +0000
committer: scuri <scuri> 2009-12-02 20:30:55 +0000
commit: 0a186150f085c34462b8c6cd5257849c73f80b65 (patch)
tree: f78781174c5f64d032efa0760a0ac06af8f8447b /html
parent: 3914ec6505021df1b3edac7a0b2648ace33e4ef4 (diff)
8 files changed, 243 insertions, 27 deletions
diff --git a/html/en/drv/gdk.html b/html/en/drv/gdk.html
new file mode 100644
index 0000000..df5aab2
--- /dev/null
+++ b/html/en/drv/gdk.html
@@ -0,0 +1,113 @@
+<!doctype HTML PUBLIC "-//IETF//DTD HTML//EN">
+<html>
+
+<head>
+<meta http-equiv="Content-Language" content="en-us">
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+<title>GDK</title>
+<link rel="stylesheet" type="text/css" href="../../style.css">
+</head>
+
+<body>
+
+<h2>GDK Base Driver</h2>
+
+  <p>This driver represents a basic driver for all system-dependent drivers 
+  implemented in the X-Windows system. The implementation uses the
+  <a href="http://library.gnome.org/devel/gdk/">GDK</a> and
+  <a href="http://library.gnome.org/devel/cairo/">Cairo</a> API 
+  functions. This driver was designed for the GTK+ version 2, and can be 
+  compiled and used in Microsoft Windows system.</p>
+
+<h3>Behavior of Functions</h3>
+<h4>Control&nbsp; </h4>
+<ul>
+  <li><a href="../func/other.html#cdPlay">
+  <font face="Courier"><strong>Play</strong></font></a>: does nothing, returns
+  <font face="Courier">CD_ERROR</font>. </li>
+</ul>
+<h4>Coordinate System and Clipping </h4>
+<ul>
+  <li>
+  <a href="../func/coordinates.html#cdUpdateYAxis">
+  <font face="Courier"><strong>UpdateYAxis</strong></font></a>: the 
+  orientation of axis Y is the opposite to its orientation in the CD library.</li>
+</ul>
+<h4>Attributes </h4>
+<ul>
+  <li>
+  <a href="../func/lines.html#cdLineWidth">
+  <font face="Courier"><strong>LineWidth</strong></font></a>: if
+  <font face="Courier">width</font> is 1, the driver will use 0 for a better 
+  performance.</li>
+  <li>
+  <a href="../func/lines.html#cdLineStyle">
+  <font face="Courier"><strong>LineStyle</strong></font></a>: thick lines have 
+  style only in the line's direction. For example, you will see small rectangles 
+  in a thick dotted line.</li>
+  <li>
+  <a href="../func/text.html#cdNativeFont">
+  <font face="Courier"><strong>NativeFont</strong></font></a>: also accepts the 
+  X-Windows font string format. A scaled font is generated using the font size 
+  and the font face.</li>
+  <li><a href="../func/text.html#cdFont">
+  <font face="Courier"><strong>Font</strong></font></a>: the old name &quot;System&quot; 
+  is mapped to &quot;fixed&quot;. A scaled font is generated using the font size 
+  and the font face.</li>
+</ul>
+<h4>Colors </h4>
+<ul>
+  <li>
+  <a href="../func/color.html#cdPalette">
+  <font face="Courier"><strong>Palette</strong></font></a>: When the number of 
+  bits per pixel is smaller than or equal to 8, the driver will use the system 
+  palette to solve colors passed as parameters to the canvas. The driver 
+  allocates colors as they are requested - if a color cannot be allocated, the 
+  closest color is used in the palette. For such, the driver sees all available 
+  colors, in the current application and others. If one of the applications is 
+  terminated, a color in the palette may become invalid and will only be updated 
+  by the driver when it is requested again. For this reason, a call to <strong>
+  cdForeground </strong>or <strong>cdBackground</strong> or <strong>cdPalette</strong> 
+  is recommended before drawing.<br>
+  When CD_FORCE is used, the driver forces color allocation. 
+  This may imply changing colors in other applications when a cursor moves in 
+  and out of the canvas. However, if the number of requested colors is smaller 
+  than the maximum number of possible colors in the palette, then the first 
+  colors in the default system palette will be preserved, minimizing this 
+  problem.<br>
+  When CD_POLITE is used, all colors allocated by the driver are liberated, and 
+  the requested colors are allocated. This is useful for the application to 
+  prioritize the colors that will be allocated, causing other colors to be 
+  mapped to their closest colors.<br>
+  Note that canvases in the same application interfere with one another, but 
+  when a canvas is terminated it liberates all allocated colors.</li>
+</ul>
+<h4>Exclusive Attributes</h4>
+<ul>
+  <li>&quot;<b><font face="Courier">GC</font></b>&quot;:&nbsp; returns the GDK graphics 
+  context (get only). In Lua is returned as a user data.</li>
+</ul>
+
+<ul>
+  <li>&quot;<b><font face="Courier">ROTATE</font></b>&quot;:&nbsp; allows the usage of 1 
+  angle and 1 coordinate (x, y), that define a global rotation transformation 
+  centered in the specified coordinate. Use 1 real and 2 integer values inside a 
+  string (&quot;%g %d %d&quot; = angle x y). In this driver will change the 
+  current transformation matrix, if removed will reset the current 
+  transformation matrix.</li>
+</ul>
+
+<ul>
+  <li>&quot;<b><font face="Courier">ANTIALIAS</font></b>&quot;: controls the use of 
+  anti-aliasing for the text, image zoom and line drawing primitives. Assumes 
+  values &quot;1&quot; (active) and &quot;0&quot; (inactive). Default value: &quot;1&quot;.</li>
+</ul>
+
+<ul>
+  <li><b><font face="Courier">&quot;CAIROVERSION&quot;: </font></b>returns a string with 
+  the Cairo version number. It is empty if the Cairo is not available.</li>
+</ul>
+
+</body>
+
+</html>
diff --git a/html/en/drv/svg.html b/html/en/drv/svg.html
new file mode 100644
index 0000000..e75451e
--- /dev/null
+++ b/html/en/drv/svg.html
@@ -0,0 +1,93 @@
+<!doctype HTML PUBLIC "-//IETF//DTD HTML//EN">
+<html>
+
+<head>
+<meta http-equiv="Content-Language" content="en-us">
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+<title>CD_SVG</title>
+<link rel="stylesheet" type="text/css" href="../../style.css">
+</head>
+
+<body>
+
+<h2 style="text-align: left">CD_SVG - CD Scalable Vector Graphics Driver (cdsvg.h)</h2>
+
+  <p>This driver allows the generation of a SVG file, a modularized language for 
+  describing two-dimensional vector and mixed vector/raster graphics in XML. The
+  <a href="http://www.w3.org/TR/SVG/">SVG specification</a> is an open standard 
+  that has been under development by the <a href="http://www.w3.org/">World Wide 
+  Web Consortium</a> (W3C) since 1999.</p>
+
+<h3>Use</h3>
+
+  <p>The file is created by calling function <font face="Courier">
+  <a href="../func/init.html#cdCreateCanvas"><strong>cdCreateCanvas</strong></a>(CD_SVG, 
+  Data)</font>. The <font face="Courier">Data</font> parameter is a string that must contain the filename and the canvas 
+  dimensions, in the following format:</p>
+  
+    <pre>&quot;<em>filename [widthxheight resolution]</em>&quot; or in C<em> &quot;<strong><tt>%s %gx%g %g</tt></strong>&quot;</em></pre>
+  
+  <p>Only the parameter <font face="Courier">filename</font> is required. The filename must be inside double quotes (&quot;) 
+  if it has spaces.<font face="Courier"> Width</font> and <font face="Courier">height</font> are provided in millimeters 
+  (note the lowercase &quot;x&quot; between them), and their default value in pixels is <font face="Courier">INT_MAX</font> for 
+  both dimensions. <font face="Courier">Resolution </font>is the number of pixels per millimeter; its default value is 
+  &quot;3.78 pixels/mm&quot; (96 DPI). <font face="Courier">Width</font>, <font face="Courier">height</font> and
+  <font face="Courier">resolution</font> are real values.</p>
+  <p>Any amount of such canvases may exist simultaneously. It is important to note that a call to function
+  <a href="../func/init.html#cdKillCanvas"><font face="Courier"><strong>
+  cdKillCanvas</strong></font></a> is required to <b>close</b> the file properly.</p>
+  <h3>Behavior of Functions</h3>
+<h4>Control</h4>
+<dir>
+  <li><a href="http://www.tecgraf.puc-rio.br/cd/en/func/other.html#cdPlay">
+  <font face="Courier"><strong>Play</strong></font></a>: does nothing, returns
+  <font face="Courier">CD_ERROR</font>.</li>
+	<li><a href="http://www.tecgraf.puc-rio.br/cd/en/func/control.html#cdClear">
+	<font face="Courier"><strong>Clear</strong></font></a>: is simulated using 
+	width and height to draw a rect.</li>
+</dir>
+<h4>Coordinate System and Clipping </h4>
+<dir>
+  <li><a href="../func/coordinates.html#cdUpdateYAxis"><font face="Courier">
+  <strong>UpdateYAxis</strong></font></a>: does nothing.</li>
+	<li><b>Complex Regions</b>: not supported.</li>
+</dir>
+<h4>Attributes</h4>
+<dir>
+    <li><a href="http://www.tecgraf.puc-rio.br/cd/en/func/text.html#cdFontDim">
+	<font face="Courier"><strong>FontDim</strong></font></a>: is simulated.</li>
+	<li><a href="http://www.tecgraf.puc-rio.br/cd/en/func/text.html#cdTextSize">
+	<font face="Courier"><strong>TextSize</strong></font></a>: is simulated.</li>
+	<li>
+	<a href="http://www.tecgraf.puc-rio.br/cd/en/func/attributes.html#cdWriteMode">
+	<font face="Courier"><strong>WriteMode</strong></font></a>: does nothing, 
+	returns <font face="Courier">CD_REPLACE</font>.</li>
+</dir>
+<h4>Colors</h4>
+<dir>
+  <li><a href="../func/color.html#cdGetColorPlanes"><font face="Courier">
+  <strong>
+  GetColorPlanes</strong></font></a>: always returns 24.</li>
+	<li><a href="http://www.tecgraf.puc-rio.br/cd/en/func/color.html#cdPalette">
+	<font face="Courier"><strong>Palette</strong></font></a>: does nothing.</li>
+</dir>
+<h4>Primitives</h4>
+<dir>
+  <li><font face="Courier"><strong>
+  <a href="http://www.tecgraf.puc-rio.br/cd/en/func/marks.html#cdPixel">Pixel</a></strong></font>: 
+  does not exist in SVG, is simulated using a circle with radius=0.1.</li>
+	<li>Floating point primitives are supported.</li>
+</dir>
+<h4>Client Images</h4>
+<dir>
+    <li><a href="../func/client.html#cdGetImageRGB"><font face="Courier"><strong>
+  GetImageRGB</strong></font></a>: does nothing.</li>
+</dir>
+<h4>Server Images</h4>
+<dir>
+    <li>All functions do nothing.</li>
+</dir>
+
+</body>
+
+</html>
diff --git a/html/en/history.html b/html/en/history.html
index ba6be12..9d82f3b 100644
--- a/html/en/history.html
+++ b/html/en/history.html
@@ -21,6 +21,7 @@
 <h2>History of Changes</h2>
 <h3>CVS (02/Dec/2009)</h3>
 <ul>
+	<li><span style="color: #0000FF">New:</span> driver SVG.</li>
 	<li><span style="color: #0000FF">New:</span> function <strong>
 	CanvasYAxisMode</strong> to control the Y axis orientation.</li>
 	<li><span style="color: #0000FF">New:</span> functions <strong>
diff --git a/html/en/prod.html b/html/en/prod.html
index 8cabf53..36605d8 100644
--- a/html/en/prod.html
+++ b/html/en/prod.html
@@ -10,16 +10,13 @@
 
 <h3><a name="Overview">Overview</a></h3>
 
-  <p>CD is a platform-independent graphics library. It is implemented in several 
-  platforms using native graphics libraries: Microsoft Windows (GDI and GDI+) 
+  <p>CD is a platform-independent graphics library. Its drivers are implemented in several 
+  platforms, some use portable code, others use native graphics libraries, such 
+	as Microsoft Windows (GDI and GDI+) 
   and X-Windows (XLIB). </p>
   <p>The library contains functions to support both vector and image 
   applications, and the visualization surface can be either a canvas or a more 
   abstract surface, such as Clipboard, Metafile, PS, and so on.</p>
-  <p>To make the Application Programmers Interface (API) simple, all data are 
-  standard C types (int, double or char). Thus the application program does not 
-  have to maintain parallel data structures to deal with the graphic library.
-  </p>
   <p>Furthermore, the list of parameters of the CD primitive functions contains 
   only the geometrical descriptions of the objects (line, circle, text, etc.). 
   Where these objects should appear and what is the their color, thickness, etc. 
@@ -110,7 +107,8 @@ http://canvasdraw.cvs.sourceforge.net/canvasdraw/</a>.</p>
   <a href="http://www.ssec.wisc.edu/~brianp/Mesa.html" target="_blank">Mesa</a> 
   libraries, for making the source code available, which helped us improve our 
   implementation of the Simulation driver and of the X-Windows driver. Thanks to 
-  Alan Richardson for the XVertex rotines. Thanks to 
+  Alan Richardson for the XVertex rotines. Thanks to Lode Vandevenne for the 
+	LodePNG rotines used in the SVG driver. Thanks to 
   Jason Perkins for the <a href="http://premake.sourceforge.net/">Premake</a> 
   tool.</p>
   <p>The CD distribution includes the FreeType library, this is a third party 
diff --git a/html/en/to_do.html b/html/en/to_do.html
index 2fc0e11..7fbceaf 100644
--- a/html/en/to_do.html
+++ b/html/en/to_do.html
@@ -19,7 +19,6 @@
 <h3>CD</h3>
 <ul>
   <li class="style1">A new GDK base driver.</li>
-  <li>A new SVG driver.</li>
   <li>libEMF in UNIX.</li>
 </ul>
 <h3>MAC</h3>
diff --git a/html/wb/wb_usr.lua b/html/wb/wb_usr.lua
index fb8c4a7..8dbadf7 100644
--- a/html/wb/wb_usr.lua
+++ b/html/wb/wb_usr.lua
@@ -1000,6 +1000,10 @@ wb_usr.tree =
               link= "drv/ps.html"
             },
             {
+              name= {nl= "SVG"},
+              link= "drv/svg.html"
+            },
+            {
               name= {nl= "MF"},
               link= "drv/mf.html"
             },
@@ -1040,6 +1044,10 @@ wb_usr.tree =
               link= "drv/sim.html"
             },
             {
+              name= {en= "GDK/Cairo"},
+              link= "drv/gdk.html"
+            },
+            {
               name= {nl= "Win32"},
               link= "drv/win32.html"
             },
diff --git a/html/wb_search.txt b/html/wb_search.txt
index 6c1523f..a8b5c89 100644
--- a/html/wb_search.txt
+++ b/html/wb_search.txt
@@ -8,32 +8,34 @@ en/drv/sim.html
 en/drv/native.html
 en/func/control.html
 en/drv/xrender.html
+en/drv/irgb.html
+en/drv/gdiplus.html
 en/func/vectortext.html
 en/cvs.html
 en/func/init.html
-en/drv/irgb.html
+en/drv/win32.html
 en/drv/picture.html
 en/func/attributes.html
-en/drv/gdiplus.html
+en/drv/gdk.html
 en/func/text.html
 en/func/filled.html
 en/prod.html
-en/drv/win32.html
-en/samples.html
 en/drv/ps.html
+en/samples.html
 en/drv/emf.html
-en/to_do.html
 en/func/marks.html
-en/drv.html
+en/to_do.html
 en/internal.html
+en/drv.html
 en/drv/cgm.html
 en/drv/mf.html
+en/drv/iup.html
 en/drv/wmf.html
 en/drv/pdf.html
 en/drv/dxf.html
 en/copyright.html
 en/drv/dbufrgb.html
-en/drv/iup.html
+en/drv/svg.html
 en/drv/xwin.html
 en/drv/printer.html
 en/cdluaim.html
diff --git a/html/wb_tree.html b/html/wb_tree.html
index f6d45f5..ed2fbb6 100644
--- a/html/wb_tree.html
+++ b/html/wb_tree.html
@@ -524,23 +524,25 @@
         <div id="folder.6.4">
           <p><img src="wb_img/blank.png"><img src="wb_img/vertline.png"><img src="wb_img/node.png"><a class="el" name="link195folder.6.4" href="en/drv/pdf.html">PDF</a></p>
           <p><img src="wb_img/blank.png"><img src="wb_img/vertline.png"><img src="wb_img/node.png"><a class="el" name="link196folder.6.4" href="en/drv/ps.html">PS</a></p>
-          <p><img src="wb_img/blank.png"><img src="wb_img/vertline.png"><img src="wb_img/node.png"><a class="el" name="link197folder.6.4" href="en/drv/mf.html">MF</a></p>
+          <p><img src="wb_img/blank.png"><img src="wb_img/vertline.png"><img src="wb_img/node.png"><a class="el" name="link197folder.6.4" href="en/drv/svg.html">SVG</a></p>
+          <p><img src="wb_img/blank.png"><img src="wb_img/vertline.png"><img src="wb_img/node.png"><a class="el" name="link198folder.6.4" href="en/drv/mf.html">MF</a></p>
           <p class="sep"><img src="wb_img/sepblank.png"><img src="wb_img/sepvertline.png"><img src="wb_img/sepnode.png"></p>
-          <p><img src="wb_img/blank.png"><img src="wb_img/vertline.png"><img src="wb_img/node.png"><a class="el" name="link198folder.6.4" href="en/drv/cgm.html">CGM</a></p>
-          <p><img src="wb_img/blank.png"><img src="wb_img/vertline.png"><img src="wb_img/node.png"><a class="el" name="link199folder.6.4" href="en/drv/dgn.html">DGN</a></p>
-          <p><img src="wb_img/blank.png"><img src="wb_img/vertline.png"><img src="wb_img/node.png"><a class="el" name="link200folder.6.4" href="en/drv/dxf.html">DXF</a></p>
+          <p><img src="wb_img/blank.png"><img src="wb_img/vertline.png"><img src="wb_img/node.png"><a class="el" name="link199folder.6.4" href="en/drv/cgm.html">CGM</a></p>
+          <p><img src="wb_img/blank.png"><img src="wb_img/vertline.png"><img src="wb_img/node.png"><a class="el" name="link200folder.6.4" href="en/drv/dgn.html">DGN</a></p>
+          <p><img src="wb_img/blank.png"><img src="wb_img/vertline.png"><img src="wb_img/node.png"><a class="el" name="link201folder.6.4" href="en/drv/dxf.html">DXF</a></p>
           <p class="sep"><img src="wb_img/sepblank.png"><img src="wb_img/sepvertline.png"><img src="wb_img/sepnode.png"></p>
-          <p><img src="wb_img/blank.png"><img src="wb_img/vertline.png"><img src="wb_img/node.png"><a class="el" name="link201folder.6.4" href="en/drv/emf.html">EMF</a></p>
-          <p><img src="wb_img/blank.png"><img src="wb_img/vertline.png"><img src="wb_img/node.png"><a class="el" name="link202folder.6.4" href="en/drv/wmf.html">WMF</a></p>
-          <p><img src="wb_img/blank.png"><img src="wb_img/vertline.png"><img src="wb_img/nodelast.png"><a class="el" name="link203folder.6.4" href="en/drv/debug.html">DEBUG</a></p>
+          <p><img src="wb_img/blank.png"><img src="wb_img/vertline.png"><img src="wb_img/node.png"><a class="el" name="link202folder.6.4" href="en/drv/emf.html">EMF</a></p>
+          <p><img src="wb_img/blank.png"><img src="wb_img/vertline.png"><img src="wb_img/node.png"><a class="el" name="link203folder.6.4" href="en/drv/wmf.html">WMF</a></p>
+          <p><img src="wb_img/blank.png"><img src="wb_img/vertline.png"><img src="wb_img/nodelast.png"><a class="el" name="link204folder.6.4" href="en/drv/debug.html">DEBUG</a></p>
         </div>
         <p><img src="wb_img/blank.png"><img name="imgfolder.6.5" src="wb_img/plusnodelast.png" onclick="toggleFolder('folder.6.5')">  Base Drivers</p>
         <div id="folder.6.5">
-          <p><img src="wb_img/blank.png"><img src="wb_img/blank.png"><img src="wb_img/node.png"><a class="el" name="link204folder.6.5" href="en/drv/sim.html">Simulation</a></p>
-          <p><img src="wb_img/blank.png"><img src="wb_img/blank.png"><img src="wb_img/node.png"><a class="el" name="link205folder.6.5" href="en/drv/win32.html">Win32</a></p>
-          <p><img src="wb_img/blank.png"><img src="wb_img/blank.png"><img src="wb_img/node.png"><a class="el" name="link206folder.6.5" href="en/drv/gdiplus.html">Win32 GDI+</a></p>
-          <p><img src="wb_img/blank.png"><img src="wb_img/blank.png"><img src="wb_img/node.png"><a class="el" name="link207folder.6.5" href="en/drv/xwin.html">X-Win</a></p>
-          <p><img src="wb_img/blank.png"><img src="wb_img/blank.png"><img src="wb_img/nodelast.png"><a class="el" name="link208folder.6.5" href="en/drv/xrender.html">XRender</a></p>
+          <p><img src="wb_img/blank.png"><img src="wb_img/blank.png"><img src="wb_img/node.png"><a class="el" name="link205folder.6.5" href="en/drv/sim.html">Simulation</a></p>
+          <p><img src="wb_img/blank.png"><img src="wb_img/blank.png"><img src="wb_img/node.png"><a class="el" name="link206folder.6.5" href="en/drv/gdk.html">GDK/Cairo</a></p>
+          <p><img src="wb_img/blank.png"><img src="wb_img/blank.png"><img src="wb_img/node.png"><a class="el" name="link207folder.6.5" href="en/drv/win32.html">Win32</a></p>
+          <p><img src="wb_img/blank.png"><img src="wb_img/blank.png"><img src="wb_img/node.png"><a class="el" name="link208folder.6.5" href="en/drv/gdiplus.html">Win32 GDI+</a></p>
+          <p><img src="wb_img/blank.png"><img src="wb_img/blank.png"><img src="wb_img/node.png"><a class="el" name="link209folder.6.5" href="en/drv/xwin.html">X-Win</a></p>
+          <p><img src="wb_img/blank.png"><img src="wb_img/blank.png"><img src="wb_img/nodelast.png"><a class="el" name="link210folder.6.5" href="en/drv/xrender.html">XRender</a></p>
         </div>
       </div>
   </div>
author	scuri <scuri>	2009-12-02 20:30:55 +0000
committer	scuri <scuri>	2009-12-02 20:30:55 +0000
commit	0a186150f085c34462b8c6cd5257849c73f80b65 (patch)
tree	f78781174c5f64d032efa0760a0ac06af8f8447b /html
parent	3914ec6505021df1b3edac7a0b2648ace33e4ef4 (diff)