java/cewolf-1.0/src/site/brief.html
changeset 4 249560bcc466
     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 11:06:49 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: &gt;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>&lt;cewolf:chart <br>    id="XYChart"<br>    type="xy"<br>    title="XYChart" <br>    &lt;cewolf:gradient&gt;<br>        &lt;cewolf:point x="0" y="0" color="#FFFFFF"/&gt;<br>        &lt;cewolf:point x="0" y="300" color="#C8C8C8"/&gt;<br>    &lt;/cewolf:gradient&gt;<br>    &lt;cewolf:data&gt;<br>        &lt;cewolf:producer id="xyData"/&gt;<br>    &lt;/cewolf:data&gt;<br>&lt;/cewolf:chart&gt;<br>&lt;cewolf:img chartid="XYChart" renderer="cewolf" width="400" height="300"/&gt;<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&amp;type=5"
   1.105 + height="30" border="0" alt="SourceForge Logo"></a>
   1.106 +</body>
   1.107 +</html>