Generalized the data normalization step so it can be parameterized

with a format spec (this should also fix the problem of bar bottoms not affecting the axis scaling), made the heuristic for determing the number of axis ticks to aim for smarter, added a new image plugin for plotting images git-svn-id: https://flot.googlecode.com/svn/trunk@177 1e0a6537-2640-0410-bfb7-f154510ff394

Generalized the data normalization step so it can be parameterized
with a format spec (this should also fix the problem of bar bottoms not affecting the axis scaling), made the heuristic for determing the number of axis ticks to aim for smarter, added a new image plugin for plotting images git-svn-id: https://flot.googlecode.com/svn/trunk@177 1e0a6537-2640-0410-bfb7-f154510ff394
aebbf14b · olau@iola.dk · 0dd400db · aebbf14b · aebbf14b · aebbf14b
Commit aebbf14b authored Jul 04, 2009 by olau@iola.dk
6 changed files
--- a/API.txt
+++ b/API.txt
@@ -914,6 +914,26 @@ Currently available hooks (when in doubt, check the Flot source):
   series. If the function fills in datapoints.points with normalized
   points and sets datapoints.pointsize to the size of the points,
   Flot will skip the copying/normalization step for this series.
+   
+   In any case, you might be interested in setting datapoints.format,
+   an array of objects for specifying how a point is normalized and
+   how it interferes with axis scaling.
+
+   The default format array for points is something along the lines of:
+
+     [
+       { x: true, number: true, required: true },
+       { y: true, number: true, required: true }
+     ]
+
+   The first object means that for the first coordinate it should be
+   taken into account when scaling the x axis, that it must be a
+   number, and that it is required - so if it is null or cannot be
+   converted to a number, the whole point will be zeroed out with
+   nulls. Beyond these you can also specify "default". If the
+   coordinate is null and default is set, then default is used for the
+   value. This is for instance handy for bars where we can omit the
+   third coordinate (the bottom of the bar) which then defaults to 0.


 - processDatapoints  [phase 3]

--- a/NEWS.txt
+++ b/NEWS.txt
@@ -89,8 +89,8 @@ Changes:

 - Hooks: you can register functions that are called while Flot is
  crunching the data and doing the plot. This can be used to modify
-  Flot without changing the source, useful for writing plugins. At
-  this point only some hooks are defined.
+  Flot without changing the source, useful for writing plugins. Some
+  hooks are defined, more are likely to come.
  
 - Threshold plugin: you can set a threshold and a color, and the data
  points below that threshold will then get the color. Useful for
@@ -102,7 +102,9 @@ Changes:

 - Crosshairs plugin: trace the mouse position on the axes, enable with
  crosshair: { mode: "x"} (see the new tracking example for a use).
-  
+
+- Image plugin: plot prerendered images.
+
  
 Bug fixes:

@@ -140,6 +142,8 @@ Bug fixes:
  with vertical lines.
 - Round tick positions to avoid possible problems with fractions
  (suggestion by Fred, issue 130).
+- Made the heuristic for determining how many ticks to aim for a bit
+  smarter.


 Flot 0.5

--- a/examples/hs-2004-27-a-large_web.jpg
+++ b/examples/hs-2004-27-a-large_web.jpg
--- a/examples/image.html
+++ b/examples/image.html
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+ <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+    <title>Flot Examples</title>
+    <link href="layout.css" rel="stylesheet" type="text/css"></link>
+    <!--[if IE]><script language="javascript" type="text/javascript" src="../excanvas.min.js"></script><![endif]-->
+    <script language="javascript" type="text/javascript" src="../jquery.js"></script>
+    <script language="javascript" type="text/javascript" src="../jquery.flot.js"></script>
+    <script language="javascript" type="text/javascript" src="../jquery.flot.image.js"></script>
+ </head>
+ <body>
+    <h1>Flot Examples</h1>
+
+    <div id="placeholder" style="width:400px;height:400px;"></div>
+
+    <p>The Cat's Eye Nebula (picture taken with <a href="http://hubblesite.org/gallery/album/nebula/pr2004027a/">Hubble</a>).</p>
+    
+    <p>With the image plugin, you can plot images. This is for example
+    useful for getting ticks on complex prerendered visualizations.
+    Instead of inputting data points, you put in the images and where
+    their two opposite corners are supposed to be in plot space.</p>
+
+    <p>Images represent a little further complication because you need
+    to make sure they are loaded before you can use them (Flot skips
+    incomplete images). The plugin comes with a couple of helpers
+    for doing that.</p>
+
+<script id="source" language="javascript" type="text/javascript">
+$(function () {
+    var data = [ [ ["hs-2004-27-a-large_web.jpg", -10, -10, 10, 10] ] ];
+    var options = {
+            series: { images: { show: true } },
+            xaxis: { min: -8, max: 4 },
+            yaxis: { min: -8, max: 4 }
+    };
+
+    $.plot.image.loadDataImages(data, options, function () {
+        $.plot($("#placeholder"), data, options);
+    });
+});
+</script>
+
+ </body>
+</html>
--- a/examples/index.html
+++ b/examples/index.html
@@ -35,7 +35,8 @@
      <li><a href="dual-axis.html">Dual axis support</a></li>
      <li><a href="thresholding.html">Thresholding the data</a> (with plugin)</li>
      <li><a href="stacking.html">Stacked charts</a> (with plugin)</li>
-      <li><a href="tracking.html">Tracking curves with crosshair</a></li>
+      <li><a href="tracking.html">Tracking curves with crosshair</a> (with plugin)</li>
+      <li><a href="image.html">Plotting prerendered images</a> (with plugin)</li>
    </ul>
 </body>
 </html>
--- a/jquery.flot.js
+++ b/jquery.flot.js