From aebbf14badfa3bf8d78f0591750cc390a67cc29b Mon Sep 17 00:00:00 2001
From: "olau@iola.dk" <olau@iola.dk@1e0a6537-2640-0410-bfb7-f154510ff394>
Date: Sat, 4 Jul 2009 17:10:31 +0000
Subject: [PATCH] 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
---
 API.txt                             |  20 +++
 NEWS.txt                            |  10 +-
 examples/hs-2004-27-a-large_web.jpg | Bin 0 -> 34489 bytes
 examples/image.html                 |  45 +++++++
 examples/index.html                 |   3 +-
 jquery.flot.js                      | 196 ++++++++++++++++------------
 6 files changed, 183 insertions(+), 91 deletions(-)
 create mode 100644 examples/hs-2004-27-a-large_web.jpg
 create mode 100644 examples/image.html

diff --git a/API.txt b/API.txt
index 4ca03da..0df039b 100644
--- 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]
diff --git a/NEWS.txt b/NEWS.txt
index faf886a..df75aa3 100644
--- 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
diff --git a/examples/hs-2004-27-a-large_web.jpg b/examples/hs-2004-27-a-large_web.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..a1d5c05837576a37a8a7631d8549472154a74807
GIT binary patch
literal 34489
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
K0Y!iSAOG38#4Yy#

literal 0
HcmV?d00001

diff --git a/examples/image.html b/examples/image.html
new file mode 100644
index 0000000..177ea88
--- /dev/null
+++ b/examples/image.html
@@ -0,0 +1,45 @@
+<!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>
diff --git a/examples/index.html b/examples/index.html
index 1255948..8d881de 100644
--- 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>
diff --git a/jquery.flot.js b/jquery.flot.js
index 105ed5e..8938b3a 100644
--- a/jquery.flot.js
+++ b/jquery.flot.js
@@ -303,8 +303,16 @@
                     s.color = colors[s.color].toString();
 
                 // turn on lines automatically in case nothing is set
-                if (s.lines.show == null && !s.bars.show && !s.points.show)
-                    s.lines.show = true;
+                if (s.lines.show == null) {
+                    var v, show = true;
+                    for (var v in s)
+                        if (s[v].show) {
+                            show = false;
+                            break;
+                        }
+                    if (show)
+                        s.lines.show = true;
+                }
 
                 // setup axes
                 s.xaxis = axisSpecToRealAxis(s, "xaxis");
@@ -316,7 +324,7 @@
             var topSentry = Number.POSITIVE_INFINITY,
                 bottomSentry = Number.NEGATIVE_INFINITY,
                 i, j, k, m, length,
-                s, points, ps, x, y, axis;
+                s, points, ps, x, y, axis, val, f, p;
 
             for (axis in axes) {
                 axes[axis].datamin = topSentry;
@@ -344,23 +352,25 @@
             for (i = 0; i < series.length; ++i) {
                 s = series[i];
 
-                if (s.datapoints.pointsize != null)
-                    continue; // already filled in
+                var data = s.data, format = s.datapoints.format;
 
-                var data = s.data, format = [], p;
+                if (!format) {
+                    format = []
+                    // find out how to copy
+                    format.push({ x: true, number: true, required: true })
+                    format.push({ y: true, number: true, required: true })
 
-                // determine the point size
-                if (s.bars.show) {
-                    s.datapoints.pointsize = 3;
-                    format.push({ d: 0 });
+                    if (s.bars.show)
+                        format.push({ y: true, number: true, required: false, default: 0 });
+                    
+                    s.datapoints.format = format;
                 }
-                else
-                    s.datapoints.pointsize = 2;
-                
-                /*
-                // examine data to find out how to copy
-                for (j = 0; j < data.length; ++j) {
-                }*/
+
+                if (s.datapoints.pointsize != null)
+                    continue; // already filled in
+
+                if (s.datapoints.pointsize == null)
+                    s.datapoints.pointsize = format.length;
                 
                 ps = s.datapoints.pointsize;
                 points = s.datapoints.points;
@@ -371,54 +381,62 @@
                 for (j = k = 0; j < data.length; ++j, k += ps) {
                     p = data[j];
 
-                    if (p != null) {
-                        x = p[0];
-                        y = p[1];
-                    }
-                    else
-                        y = x = null;
-
-                    if (x != null) {
-                        x = +x; // convert to number
-                        if (isNaN(x))
-                            x = null;
-                    }
-
-                    if (y != null) {
-                        y = +y; // convert to number
-                        if (isNaN(y))
-                            y = null;
-                    }
-
-                    // check validity of point, making sure both are cleared
-                    if (x == null && y != null) {
-                        // extract min/max info before we whack
-                        updateAxis(s.yaxis, y, y);
-                        y = null;
-                    }
-
-                    if (y == null && x != null) {
-                        updateAxis(s.xaxis, x, x);
-                        x = null;
-                    }
-                    
-                    if (insertSteps && x != null && k > 0
-                        && points[k - ps] != null
-                        && points[k - ps] != x && points[k - ps + 1] != y) {
-                        points[k + 1] = points[k - ps + 1];
-                        points[k] = x;
+                    var nullify = p == null;
+                    if (!nullify) {
+                        for (m = 0; m < ps; ++m) {
+                            val = p[m];
+                            f = format[m];
+
+                            if (f) {
+                                if (f.number && val != null) {
+                                    val = +val; // convert to number
+                                    if (isNaN(val))
+                                        val = null;
+                                }
+
+                                if (val == null) {
+                                    if (f.required) {
+                                        // extract min/max info before we whack it
+                                        if (f.x)
+                                            updateAxis(s.xaxis, val, val)
+                                        if (f.y)
+                                            updateAxis(s.yaxis, val, val)
+                                        val = null;
+                                        nullify = true;
+                                    }
+                                    
+                                    if (f.default != null)
+                                        val = f.default;
+                                }
+                            }
                             
-                        // copy the remainding from real point
-                        for (m = 2; m < ps; ++m)
-                            points[k + m] = p[m] == null ? format[m-2].d : p[m];
-                        k += ps;
+                            points[k + m] = val;
+                        }
                     }
-
-                    for (m = 2; m < ps; ++m)
-                        points[k + m] = p == null || p[m] == null ? format[m-2].d : p[m];
                     
-                    points[k] = x;
-                    points[k + 1] = y;
+                    if (nullify) {
+                        for (m = 0; m < ps; ++m)
+                            points[k + m] = null;
+                    }
+                    else {
+                        // a little bit of line specific stuff that
+                        // perhaps shouldn't be here, but lacking
+                        // better means...
+                        if (insertSteps && k > 0
+                            && points[k - ps] != null
+                            && points[k - ps] != points[k]
+                            && points[k - ps + 1] != points[k + 1]) {
+                            // copy the point to make room for a middle point
+                            for (m = 0; m < ps; ++m)
+                                points[k + ps + m] = points[k + m];
+
+                            // middle point has same y
+                            points[k + 1] = points[k - ps + 1];
+
+                            // we've added a point, better reflect that
+                            k += ps;
+                        }
+                    }
                 }
             }
 
@@ -438,22 +456,28 @@
                     xmax = bottomSentry, ymax = bottomSentry;
                 
                 for (j = 0; j < points.length; j += ps) {
-                    x = points[j];
-
-                    if (x == null)
+                    if (points[j] == null)
                         continue;
 
-                    if (x < xmin)
-                        xmin = x;
-                    if (x > xmax)
-                        xmax = x;
-
-                    y = points[j + 1];
-
-                    if (y < ymin)
-                        ymin = y;
-                    if (y > ymax)
-                        ymax = y;
+                    for (m = 0; m < ps; ++m) {
+                        val = points[j + m];
+                        f = format[m];
+                        if (!f)
+                            continue
+                        
+                        if (f.x) {
+                            if (val < xmin)
+                                xmin = val;
+                            if (val > xmax)
+                                xmax = val;
+                        }
+                        if (f.y) {
+                            if (val < ymin)
+                                ymin = val;
+                            if (val > ymax)
+                                ymax = val;
+                        }
+                    }
                 }
                 
                 if (s.bars.show) {
@@ -627,12 +651,14 @@
             if (typeof axisOptions.ticks == "number" && axisOptions.ticks > 0)
                 noTicks = axisOptions.ticks;
             else if (axis == axes.xaxis || axis == axes.x2axis)
-                noTicks = canvasWidth / 100;
+                 // heuristic based on the model a*sqrt(x) fitted to
+                 // some reasonable data points
+                noTicks = 0.3 * Math.sqrt(canvasWidth);
             else
-                noTicks = canvasHeight / 60;
+                noTicks = 0.3 * Math.sqrt(canvasHeight);
             
-            var delta = (axis.max - axis.min) / noTicks;
-            var size, generator, unit, formatter, i, magn, norm;
+            var delta = (axis.max - axis.min) / noTicks,
+                size, generator, unit, formatter, i, magn, norm;
 
             if (axisOptions.mode == "time") {
                 // pretty handling of time
@@ -801,7 +827,7 @@
                 var dec = -Math.floor(Math.log(delta) / Math.LN10);
                 if (maxDec != null && dec > maxDec)
                     dec = maxDec;
-                
+
                 magn = Math.pow(10, -dec);
                 norm = delta / magn; // norm is between 1.0 and 10.0
                 
@@ -827,9 +853,9 @@
 
                 if (axisOptions.tickSize != null)
                     size = axisOptions.tickSize;
-                
+
                 axis.tickDecimals = Math.max(0, (maxDec != null) ? maxDec : dec);
-                
+
                 generator = function (axis) {
                     var ticks = [];
 
@@ -2276,10 +2302,6 @@
             return new Color(this.r, this.b, this.g, this.a);
         };
 
-        var limit = function(val,minVal,maxVal) {
-            return Math.max(Math.min(val, maxVal), minVal);
-        };
-
         this.normalize = function() {
             this.r = clamp(0, parseInt(this.r), 255);
             this.g = clamp(0, parseInt(this.g), 255);