1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/java/cewolf-1.0/src/site/brief.html Sun Mar 01 01:27:29 2009 +0100
1.3 @@ -0,0 +1,104 @@
1.4 +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
1.5 +<html>
1.6 +<head>
1.7 + <title></title>
1.8 + <meta name="author" content="Guido Laures">
1.9 + <link href="cewolf.css" rel="stylesheet" type="text/css">
1.10 +</head>
1.11 +<body>
1.12 +<h1>Introduction</h1>
1.13 +<p class="Body"> Cewolf can be used inside a Servlet/JSP based web
1.14 +application to embed complex graphical charts of all kinds (e.g. line,
1.15 +pie, bar chart, plots, etc.) into a web page. Therefore it provides a
1.16 +full featured tag library to define all properties of the chart (colors,
1.17 +strokes, legend, etc.). Thus the JSP which embedds the chart is not
1.18 +polluted with any java code. Everything is described with XML conform
1.19 +tags. </p>
1.20 +<p> Cewolf is based on <a
1.21 + href="http://www.object-refinery.com/jfreechart/">JFreeChart</a> and
1.22 +uses it's rendering engine to render the final chart image into the
1.23 +clients response stream. No files are created on server side. Everything
1.24 +is based on lightweight session objects and dynamic data analysis.
1.25 +Cewolf consists of one servlet which handles the chart rendering and a
1.26 +taglibrary which translates the chart definition included in the JSP
1.27 +into an HTML img tag which consults the rendering servlet for retrieval
1.28 +of the appropriate chart. </p>
1.29 +<p> Simce the project has been funded in the middle of 2002 there have
1.30 +been <b>more then 150.000 page views and 16.000 downloads</b>
1.31 +(Sourceforge activity max: >99,7%). </p>
1.32 +<p>
1.33 +<table border="1" cellpadding="5">
1.34 + <tbody>
1.35 + <tr>
1.36 + <th class="featureGroup">Fully free and open</th>
1.37 + <th class="featureGroup">100% Java compliant</th>
1.38 + </tr>
1.39 + <tr>
1.40 + <td valign="top">
1.41 + <ul>
1.42 + <li>LGPL license</li>
1.43 + <li>no charges</li>
1.44 + <li>no restrictions</li>
1.45 + <li>Support on <a
1.46 + href="http://sourceforge.net/projects/cewolf">SourceForge Forums</a></li>
1.47 + <li>short development and upgrade circles</li>
1.48 + </ul>
1.49 + </td>
1.50 + <td valign="top">
1.51 + <ul>
1.52 + <li>no usage of native libraries</li>
1.53 + <li>should run in every J2EE compliant server or servlet
1.54 +container</li>
1.55 + <li>extensive usage of available open source projects</li>
1.56 + </ul>
1.57 + </td>
1.58 + </tr>
1.59 + <tr>
1.60 + <th class="featureGroup">Full featured Chart Tag Library</th>
1.61 + <th class="featureGroup">Huge number of different Charts</th>
1.62 + </tr>
1.63 + <tr>
1.64 + <td valign="top">
1.65 + <ul>
1.66 + <li>no java coding inside the JSP needed</li>
1.67 + <li>XML description of a chart</li>
1.68 + <li>design time validation of chart tags</li>
1.69 + <li>extensive <a href="taglib.html">tag documentation</a></li>
1.70 + </ul>
1.71 + </td>
1.72 + <td valign="top">
1.73 + <ul>
1.74 + <li>Line [XY]</li>
1.75 + <li>[3D] Pie</li>
1.76 + <li>[3D] Horizonal Bar</li>
1.77 + <li>[3D] Vertical [XY] Bar</li>
1.78 + <li>[3D] Stacked Vertical Bar</li>
1.79 + <li>Area [XY]</li>
1.80 + <li>Scatter Plot</li>
1.81 + <li>Candlestick</li>
1.82 + <li>High Low</li>
1.83 + <li>Gantt</li>
1.84 + <li>Meter</li>
1.85 + <li>Overlaid</li>
1.86 + <li>Combined</li>
1.87 + </ul>
1.88 + </td>
1.89 + </tr>
1.90 + </tbody>
1.91 +</table>
1.92 +</p>
1.93 +<p> </p>
1.94 +<h1>Example</h1>
1.95 +<p> You can simply define a chart by including a chart tag into your JSP
1.96 +like this: </p>
1.97 +<pre><cewolf:chart <br> id="XYChart"<br> type="xy"<br> title="XYChart" <br> <cewolf:gradient><br> <cewolf:point x="0" y="0" color="#FFFFFF"/><br> <cewolf:point x="0" y="300" color="#C8C8C8"/><br> </cewolf:gradient><br> <cewolf:data><br> <cewolf:producer id="xyData"/><br> </cewolf:data><br></cewolf:chart><br><cewolf:img chartid="XYChart" renderer="cewolf" width="400" height="300"/><br></pre>
1.98 +<p> This results in a rendered chart like this: </p>
1.99 +<img alt="examplechart" src="img/examplexy.png">
1.100 +<p> As you can see only the view is defined in the JSP page. The model
1.101 +is produced by a so called DataProducer which must be available in the
1.102 +pageContext of the JSP. </p>
1.103 +<a href="http://sourceforge.net" target="new" height="30"><img
1.104 + src="http://sourceforge.net/sflogo.php?group_id=57282&type=5"
1.105 + height="30" border="0" alt="SourceForge Logo"></a>
1.106 +</body>
1.107 +</html>