source: pro-violet-viettel/docs/template/assets/js/uncompressed/flot/jquery.flot.js @ 400

Last change on this file since 400 was 400, checked in by dungnv, 11 years ago
  • Property svn:mime-type set to text/plain
File size: 116.3 KB
Line 
1/* Javascript plotting library for jQuery, version 0.8.1.
2
3Copyright (c) 2007-2013 IOLA and Ole Laursen.
4Licensed under the MIT license.
5
6*/
7
8// first an inline dependency, jquery.colorhelpers.js, we inline it here
9// for convenience
10
11/* Plugin for jQuery for working with colors.
12 *
13 * Version 1.1.
14 *
15 * Inspiration from jQuery color animation plugin by John Resig.
16 *
17 * Released under the MIT license by Ole Laursen, October 2009.
18 *
19 * Examples:
20 *
21 *   $.color.parse("#fff").scale('rgb', 0.25).add('a', -0.5).toString()
22 *   var c = $.color.extract($("#mydiv"), 'background-color');
23 *   console.log(c.r, c.g, c.b, c.a);
24 *   $.color.make(100, 50, 25, 0.4).toString() // returns "rgba(100,50,25,0.4)"
25 *
26 * Note that .scale() and .add() return the same modified object
27 * instead of making a new one.
28 *
29 * V. 1.1: Fix error handling so e.g. parsing an empty string does
30 * produce a color rather than just crashing.
31 */
32(function(B){B.color={};B.color.make=function(F,E,C,D){var G={};G.r=F||0;G.g=E||0;G.b=C||0;G.a=D!=null?D:1;G.add=function(J,I){for(var H=0;H<J.length;++H){G[J.charAt(H)]+=I}return G.normalize()};G.scale=function(J,I){for(var H=0;H<J.length;++H){G[J.charAt(H)]*=I}return G.normalize()};G.toString=function(){if(G.a>=1){return"rgb("+[G.r,G.g,G.b].join(",")+")"}else{return"rgba("+[G.r,G.g,G.b,G.a].join(",")+")"}};G.normalize=function(){function H(J,K,I){return K<J?J:(K>I?I:K)}G.r=H(0,parseInt(G.r),255);G.g=H(0,parseInt(G.g),255);G.b=H(0,parseInt(G.b),255);G.a=H(0,G.a,1);return G};G.clone=function(){return B.color.make(G.r,G.b,G.g,G.a)};return G.normalize()};B.color.extract=function(D,C){var E;do{E=D.css(C).toLowerCase();if(E!=""&&E!="transparent"){break}D=D.parent()}while(!B.nodeName(D.get(0),"body"));if(E=="rgba(0, 0, 0, 0)"){E="transparent"}return B.color.parse(E)};B.color.parse=function(F){var E,C=B.color.make;if(E=/rgb\(\s*([0-9]{1,3})\s*,\s*([0-9]{1,3})\s*,\s*([0-9]{1,3})\s*\)/.exec(F)){return C(parseInt(E[1],10),parseInt(E[2],10),parseInt(E[3],10))}if(E=/rgba\(\s*([0-9]{1,3})\s*,\s*([0-9]{1,3})\s*,\s*([0-9]{1,3})\s*,\s*([0-9]+(?:\.[0-9]+)?)\s*\)/.exec(F)){return C(parseInt(E[1],10),parseInt(E[2],10),parseInt(E[3],10),parseFloat(E[4]))}if(E=/rgb\(\s*([0-9]+(?:\.[0-9]+)?)\%\s*,\s*([0-9]+(?:\.[0-9]+)?)\%\s*,\s*([0-9]+(?:\.[0-9]+)?)\%\s*\)/.exec(F)){return C(parseFloat(E[1])*2.55,parseFloat(E[2])*2.55,parseFloat(E[3])*2.55)}if(E=/rgba\(\s*([0-9]+(?:\.[0-9]+)?)\%\s*,\s*([0-9]+(?:\.[0-9]+)?)\%\s*,\s*([0-9]+(?:\.[0-9]+)?)\%\s*,\s*([0-9]+(?:\.[0-9]+)?)\s*\)/.exec(F)){return C(parseFloat(E[1])*2.55,parseFloat(E[2])*2.55,parseFloat(E[3])*2.55,parseFloat(E[4]))}if(E=/#([a-fA-F0-9]{2})([a-fA-F0-9]{2})([a-fA-F0-9]{2})/.exec(F)){return C(parseInt(E[1],16),parseInt(E[2],16),parseInt(E[3],16))}if(E=/#([a-fA-F0-9])([a-fA-F0-9])([a-fA-F0-9])/.exec(F)){return C(parseInt(E[1]+E[1],16),parseInt(E[2]+E[2],16),parseInt(E[3]+E[3],16))}var D=B.trim(F).toLowerCase();if(D=="transparent"){return C(255,255,255,0)}else{E=A[D]||[0,0,0];return C(E[0],E[1],E[2])}};var A={aqua:[0,255,255],azure:[240,255,255],beige:[245,245,220],black:[0,0,0],blue:[0,0,255],brown:[165,42,42],cyan:[0,255,255],darkblue:[0,0,139],darkcyan:[0,139,139],darkgrey:[169,169,169],darkgreen:[0,100,0],darkkhaki:[189,183,107],darkmagenta:[139,0,139],darkolivegreen:[85,107,47],darkorange:[255,140,0],darkorchid:[153,50,204],darkred:[139,0,0],darksalmon:[233,150,122],darkviolet:[148,0,211],fuchsia:[255,0,255],gold:[255,215,0],green:[0,128,0],indigo:[75,0,130],khaki:[240,230,140],lightblue:[173,216,230],lightcyan:[224,255,255],lightgreen:[144,238,144],lightgrey:[211,211,211],lightpink:[255,182,193],lightyellow:[255,255,224],lime:[0,255,0],magenta:[255,0,255],maroon:[128,0,0],navy:[0,0,128],olive:[128,128,0],orange:[255,165,0],pink:[255,192,203],purple:[128,0,128],violet:[128,0,128],red:[255,0,0],silver:[192,192,192],white:[255,255,255],yellow:[255,255,0]}})(jQuery);
33
34// the actual Flot code
35(function($) {
36
37        // Cache the prototype hasOwnProperty for faster access
38
39        var hasOwnProperty = Object.prototype.hasOwnProperty;
40
41        ///////////////////////////////////////////////////////////////////////////
42        // The Canvas object is a wrapper around an HTML5 <canvas> tag.
43        //
44        // @constructor
45        // @param {string} cls List of classes to apply to the canvas.
46        // @param {element} container Element onto which to append the canvas.
47        //
48        // Requiring a container is a little iffy, but unfortunately canvas
49        // operations don't work unless the canvas is attached to the DOM.
50
51        function Canvas(cls, container) {
52
53                var element = container.children("." + cls)[0];
54
55                if (element == null) {
56
57                        element = document.createElement("canvas");
58                        element.className = cls;
59
60                        $(element).css({ direction: "ltr", position: "absolute", left: 0, top: 0 })
61                                .appendTo(container);
62
63                        // If HTML5 Canvas isn't available, fall back to [Ex|Flash]canvas
64
65                        if (!element.getContext) {
66                                if (window.G_vmlCanvasManager) {
67                                        element = window.G_vmlCanvasManager.initElement(element);
68                                } else {
69                                        throw new Error("Canvas is not available. If you're using IE with a fall-back such as Excanvas, then there's either a mistake in your conditional include, or the page has no DOCTYPE and is rendering in Quirks Mode.");
70                                }
71                        }
72                }
73
74                this.element = element;
75
76                var context = this.context = element.getContext("2d");
77
78                // Determine the screen's ratio of physical to device-independent
79                // pixels.  This is the ratio between the canvas width that the browser
80                // advertises and the number of pixels actually present in that space.
81
82                // The iPhone 4, for example, has a device-independent width of 320px,
83                // but its screen is actually 640px wide.  It therefore has a pixel
84                // ratio of 2, while most normal devices have a ratio of 1.
85
86                var devicePixelRatio = window.devicePixelRatio || 1,
87                        backingStoreRatio =
88                                context.webkitBackingStorePixelRatio ||
89                                context.mozBackingStorePixelRatio ||
90                                context.msBackingStorePixelRatio ||
91                                context.oBackingStorePixelRatio ||
92                                context.backingStorePixelRatio || 1;
93
94                this.pixelRatio = devicePixelRatio / backingStoreRatio;
95
96                // Size the canvas to match the internal dimensions of its container
97
98                this.resize(container.width(), container.height());
99
100                // Collection of HTML div layers for text overlaid onto the canvas
101
102                this.textContainer = null;
103                this.text = {};
104
105                // Cache of text fragments and metrics, so we can avoid expensively
106                // re-calculating them when the plot is re-rendered in a loop.
107
108                this._textCache = {};
109        }
110
111        // Resizes the canvas to the given dimensions.
112        //
113        // @param {number} width New width of the canvas, in pixels.
114        // @param {number} width New height of the canvas, in pixels.
115
116        Canvas.prototype.resize = function(width, height) {
117
118                if (width <= 0 || height <= 0) {
119                        throw new Error("Invalid dimensions for plot, width = " + width + ", height = " + height);
120                }
121
122                var element = this.element,
123                        context = this.context,
124                        pixelRatio = this.pixelRatio;
125
126                // Resize the canvas, increasing its density based on the display's
127                // pixel ratio; basically giving it more pixels without increasing the
128                // size of its element, to take advantage of the fact that retina
129                // displays have that many more pixels in the same advertised space.
130
131                // Resizing should reset the state (excanvas seems to be buggy though)
132
133                if (this.width != width) {
134                        element.width = width * pixelRatio;
135                        element.style.width = width + "px";
136                        this.width = width;
137                }
138
139                if (this.height != height) {
140                        element.height = height * pixelRatio;
141                        element.style.height = height + "px";
142                        this.height = height;
143                }
144
145                // Save the context, so we can reset in case we get replotted.  The
146                // restore ensure that we're really back at the initial state, and
147                // should be safe even if we haven't saved the initial state yet.
148
149                context.restore();
150                context.save();
151
152                // Scale the coordinate space to match the display density; so even though we
153                // may have twice as many pixels, we still want lines and other drawing to
154                // appear at the same size; the extra pixels will just make them crisper.
155
156                context.scale(pixelRatio, pixelRatio);
157        };
158
159        // Clears the entire canvas area, not including any overlaid HTML text
160
161        Canvas.prototype.clear = function() {
162                this.context.clearRect(0, 0, this.width, this.height);
163        };
164
165        // Finishes rendering the canvas, including managing the text overlay.
166
167        Canvas.prototype.render = function() {
168
169                var cache = this._textCache;
170
171                // For each text layer, add elements marked as active that haven't
172                // already been rendered, and remove those that are no longer active.
173
174                for (var layerKey in cache) {
175                        if (hasOwnProperty.call(cache, layerKey)) {
176
177                                var layer = this.getTextLayer(layerKey),
178                                        layerCache = cache[layerKey];
179
180                                layer.hide();
181
182                                for (var styleKey in layerCache) {
183                                        if (hasOwnProperty.call(layerCache, styleKey)) {
184                                                var styleCache = layerCache[styleKey];
185                                                for (var key in styleCache) {
186                                                        if (hasOwnProperty.call(styleCache, key)) {
187
188                                                                var positions = styleCache[key].positions;
189
190                                                                for (var i = 0, position; position = positions[i]; i++) {
191                                                                        if (position.active) {
192                                                                                if (!position.rendered) {
193                                                                                        layer.append(position.element);
194                                                                                        position.rendered = true;
195                                                                                }
196                                                                        } else {
197                                                                                positions.splice(i--, 1);
198                                                                                if (position.rendered) {
199                                                                                        position.element.detach();
200                                                                                }
201                                                                        }
202                                                                }
203
204                                                                if (positions.length == 0) {
205                                                                        delete styleCache[key];
206                                                                }
207                                                        }
208                                                }
209                                        }
210                                }
211
212                                layer.show();
213                        }
214                }
215        };
216
217        // Creates (if necessary) and returns the text overlay container.
218        //
219        // @param {string} classes String of space-separated CSS classes used to
220        //     uniquely identify the text layer.
221        // @return {object} The jQuery-wrapped text-layer div.
222
223        Canvas.prototype.getTextLayer = function(classes) {
224
225                var layer = this.text[classes];
226
227                // Create the text layer if it doesn't exist
228
229                if (layer == null) {
230
231                        // Create the text layer container, if it doesn't exist
232
233                        if (this.textContainer == null) {
234                                this.textContainer = $("<div class='flot-text'></div>")
235                                        .css({
236                                                position: "absolute",
237                                                top: 0,
238                                                left: 0,
239                                                bottom: 0,
240                                                right: 0,
241                                                'font-size': "smaller",
242                                                color: "#545454"
243                                        })
244                                        .insertAfter(this.element);
245                        }
246
247                        layer = this.text[classes] = $("<div></div>")
248                                .addClass(classes)
249                                .css({
250                                        position: "absolute",
251                                        top: 0,
252                                        left: 0,
253                                        bottom: 0,
254                                        right: 0
255                                })
256                                .appendTo(this.textContainer);
257                }
258
259                return layer;
260        };
261
262        // Creates (if necessary) and returns a text info object.
263        //
264        // The object looks like this:
265        //
266        // {
267        //     width: Width of the text's wrapper div.
268        //     height: Height of the text's wrapper div.
269        //     element: The jQuery-wrapped HTML div containing the text.
270        //     positions: Array of positions at which this text is drawn.
271        // }
272        //
273        // The positions array contains objects that look like this:
274        //
275        // {
276        //     active: Flag indicating whether the text should be visible.
277        //     rendered: Flag indicating whether the text is currently visible.
278        //     element: The jQuery-wrapped HTML div containing the text.
279        //     x: X coordinate at which to draw the text.
280        //     y: Y coordinate at which to draw the text.
281        // }
282        //
283        // Each position after the first receives a clone of the original element.
284        //
285        // The idea is that that the width, height, and general 'identity' of the
286        // text is constant no matter where it is placed; the placements are a
287        // secondary property.
288        //
289        // Canvas maintains a cache of recently-used text info objects; getTextInfo
290        // either returns the cached element or creates a new entry.
291        //
292        // @param {string} layer A string of space-separated CSS classes uniquely
293        //     identifying the layer containing this text.
294        // @param {string} text Text string to retrieve info for.
295        // @param {(string|object)=} font Either a string of space-separated CSS
296        //     classes or a font-spec object, defining the text's font and style.
297        // @param {number=} angle Angle at which to rotate the text, in degrees.
298        //     Angle is currently unused, it will be implemented in the future.
299        // @param {number=} width Maximum width of the text before it wraps.
300        // @return {object} a text info object.
301
302        Canvas.prototype.getTextInfo = function(layer, text, font, angle, width) {
303
304                var textStyle, layerCache, styleCache, info;
305
306                // Cast the value to a string, in case we were given a number or such
307
308                text = "" + text;
309
310                // If the font is a font-spec object, generate a CSS font definition
311
312                if (typeof font === "object") {
313                        textStyle = font.style + " " + font.variant + " " + font.weight + " " + font.size + "px/" + font.lineHeight + "px " + font.family;
314                } else {
315                        textStyle = font;
316                }
317
318                // Retrieve (or create) the cache for the text's layer and styles
319
320                layerCache = this._textCache[layer];
321
322                if (layerCache == null) {
323                        layerCache = this._textCache[layer] = {};
324                }
325
326                styleCache = layerCache[textStyle];
327
328                if (styleCache == null) {
329                        styleCache = layerCache[textStyle] = {};
330                }
331
332                info = styleCache[text];
333
334                // If we can't find a matching element in our cache, create a new one
335
336                if (info == null) {
337
338                        var element = $("<div></div>").html(text)
339                                .css({
340                                        position: "absolute",
341                                        'max-width': width,
342                                        top: -9999
343                                })
344                                .appendTo(this.getTextLayer(layer));
345
346                        if (typeof font === "object") {
347                                element.css({
348                                        font: textStyle,
349                                        color: font.color
350                                });
351                        } else if (typeof font === "string") {
352                                element.addClass(font);
353                        }
354
355                        info = styleCache[text] = {
356                                width: element.outerWidth(true),
357                                height: element.outerHeight(true),
358                                element: element,
359                                positions: []
360                        };
361
362                        element.detach();
363                }
364
365                return info;
366        };
367
368        // Adds a text string to the canvas text overlay.
369        //
370        // The text isn't drawn immediately; it is marked as rendering, which will
371        // result in its addition to the canvas on the next render pass.
372        //
373        // @param {string} layer A string of space-separated CSS classes uniquely
374        //     identifying the layer containing this text.
375        // @param {number} x X coordinate at which to draw the text.
376        // @param {number} y Y coordinate at which to draw the text.
377        // @param {string} text Text string to draw.
378        // @param {(string|object)=} font Either a string of space-separated CSS
379        //     classes or a font-spec object, defining the text's font and style.
380        // @param {number=} angle Angle at which to rotate the text, in degrees.
381        //     Angle is currently unused, it will be implemented in the future.
382        // @param {number=} width Maximum width of the text before it wraps.
383        // @param {string=} halign Horizontal alignment of the text; either "left",
384        //     "center" or "right".
385        // @param {string=} valign Vertical alignment of the text; either "top",
386        //     "middle" or "bottom".
387
388        Canvas.prototype.addText = function(layer, x, y, text, font, angle, width, halign, valign) {
389
390                var info = this.getTextInfo(layer, text, font, angle, width),
391                        positions = info.positions;
392
393                // Tweak the div's position to match the text's alignment
394
395                if (halign == "center") {
396                        x -= info.width / 2;
397                } else if (halign == "right") {
398                        x -= info.width;
399                }
400
401                if (valign == "middle") {
402                        y -= info.height / 2;
403                } else if (valign == "bottom") {
404                        y -= info.height;
405                }
406
407                // Determine whether this text already exists at this position.
408                // If so, mark it for inclusion in the next render pass.
409
410                for (var i = 0, position; position = positions[i]; i++) {
411                        if (position.x == x && position.y == y) {
412                                position.active = true;
413                                return;
414                        }
415                }
416
417                // If the text doesn't exist at this position, create a new entry
418
419                // For the very first position we'll re-use the original element,
420                // while for subsequent ones we'll clone it.
421
422                position = {
423                        active: true,
424                        rendered: false,
425                        element: positions.length ? info.element.clone() : info.element,
426                        x: x,
427                        y: y
428                }
429
430                positions.push(position);
431
432                // Move the element to its final position within the container
433
434                position.element.css({
435                        top: Math.round(y),
436                        left: Math.round(x),
437                        'text-align': halign    // In case the text wraps
438                });
439        };
440
441        // Removes one or more text strings from the canvas text overlay.
442        //
443        // If no parameters are given, all text within the layer is removed.
444        //
445        // Note that the text is not immediately removed; it is simply marked as
446        // inactive, which will result in its removal on the next render pass.
447        // This avoids the performance penalty for 'clear and redraw' behavior,
448        // where we potentially get rid of all text on a layer, but will likely
449        // add back most or all of it later, as when redrawing axes, for example.
450        //
451        // @param {string} layer A string of space-separated CSS classes uniquely
452        //     identifying the layer containing this text.
453        // @param {number=} x X coordinate of the text.
454        // @param {number=} y Y coordinate of the text.
455        // @param {string=} text Text string to remove.
456        // @param {(string|object)=} font Either a string of space-separated CSS
457        //     classes or a font-spec object, defining the text's font and style.
458        // @param {number=} angle Angle at which the text is rotated, in degrees.
459        //     Angle is currently unused, it will be implemented in the future.
460
461        Canvas.prototype.removeText = function(layer, x, y, text, font, angle) {
462                if (text == null) {
463                        var layerCache = this._textCache[layer];
464                        if (layerCache != null) {
465                                for (var styleKey in layerCache) {
466                                        if (hasOwnProperty.call(layerCache, styleKey)) {
467                                                var styleCache = layerCache[styleKey];
468                                                for (var key in styleCache) {
469                                                        if (hasOwnProperty.call(styleCache, key)) {
470                                                                var positions = styleCache[key].positions;
471                                                                for (var i = 0, position; position = positions[i]; i++) {
472                                                                        position.active = false;
473                                                                }
474                                                        }
475                                                }
476                                        }
477                                }
478                        }
479                } else {
480                        var positions = this.getTextInfo(layer, text, font, angle).positions;
481                        for (var i = 0, position; position = positions[i]; i++) {
482                                if (position.x == x && position.y == y) {
483                                        position.active = false;
484                                }
485                        }
486                }
487        };
488
489        ///////////////////////////////////////////////////////////////////////////
490        // The top-level container for the entire plot.
491
492    function Plot(placeholder, data_, options_, plugins) {
493        // data is on the form:
494        //   [ series1, series2 ... ]
495        // where series is either just the data as [ [x1, y1], [x2, y2], ... ]
496        // or { data: [ [x1, y1], [x2, y2], ... ], label: "some label", ... }
497
498        var series = [],
499            options = {
500                // the color theme used for graphs
501                colors: ["#edc240", "#afd8f8", "#cb4b4b", "#4da74d", "#9440ed"],
502                legend: {
503                    show: true,
504                    noColumns: 1, // number of colums in legend table
505                    labelFormatter: null, // fn: string -> string
506                    labelBoxBorderColor: "#ccc", // border color for the little label boxes
507                    container: null, // container (as jQuery object) to put legend in, null means default on top of graph
508                    position: "ne", // position of default legend container within plot
509                    margin: 5, // distance from grid edge to default legend container within plot
510                    backgroundColor: null, // null means auto-detect
511                    backgroundOpacity: 0.85, // set to 0 to avoid background
512                    sorted: null    // default to no legend sorting
513                },
514                xaxis: {
515                    show: null, // null = auto-detect, true = always, false = never
516                    position: "bottom", // or "top"
517                    mode: null, // null or "time"
518                    font: null, // null (derived from CSS in placeholder) or object like { size: 11, lineHeight: 13, style: "italic", weight: "bold", family: "sans-serif", variant: "small-caps" }
519                    color: null, // base color, labels, ticks
520                    tickColor: null, // possibly different color of ticks, e.g. "rgba(0,0,0,0.15)"
521                    transform: null, // null or f: number -> number to transform axis
522                    inverseTransform: null, // if transform is set, this should be the inverse function
523                    min: null, // min. value to show, null means set automatically
524                    max: null, // max. value to show, null means set automatically
525                    autoscaleMargin: null, // margin in % to add if auto-setting min/max
526                    ticks: null, // either [1, 3] or [[1, "a"], 3] or (fn: axis info -> ticks) or app. number of ticks for auto-ticks
527                    tickFormatter: null, // fn: number -> string
528                    labelWidth: null, // size of tick labels in pixels
529                    labelHeight: null,
530                    reserveSpace: null, // whether to reserve space even if axis isn't shown
531                    tickLength: null, // size in pixels of ticks, or "full" for whole line
532                    alignTicksWithAxis: null, // axis number or null for no sync
533                    tickDecimals: null, // no. of decimals, null means auto
534                    tickSize: null, // number or [number, "unit"]
535                    minTickSize: null // number or [number, "unit"]
536                },
537                yaxis: {
538                    autoscaleMargin: 0.02,
539                    position: "left" // or "right"
540                },
541                xaxes: [],
542                yaxes: [],
543                series: {
544                    points: {
545                        show: false,
546                        radius: 3,
547                        lineWidth: 2, // in pixels
548                        fill: true,
549                        fillColor: "#ffffff",
550                        symbol: "circle" // or callback
551                    },
552                    lines: {
553                        // we don't put in show: false so we can see
554                        // whether lines were actively disabled
555                        lineWidth: 2, // in pixels
556                        fill: false,
557                        fillColor: null,
558                        steps: false
559                        // Omit 'zero', so we can later default its value to
560                        // match that of the 'fill' option.
561                    },
562                    bars: {
563                        show: false,
564                        lineWidth: 2, // in pixels
565                        barWidth: 1, // in units of the x axis
566                        fill: true,
567                        fillColor: null,
568                        align: "left", // "left", "right", or "center"
569                        horizontal: false,
570                        zero: true
571                    },
572                    shadowSize: 3,
573                    highlightColor: null
574                },
575                grid: {
576                    show: true,
577                    aboveData: false,
578                    color: "#545454", // primary color used for outline and labels
579                    backgroundColor: null, // null for transparent, else color
580                    borderColor: null, // set if different from the grid color
581                    tickColor: null, // color for the ticks, e.g. "rgba(0,0,0,0.15)"
582                    margin: 0, // distance from the canvas edge to the grid
583                    labelMargin: 5, // in pixels
584                    axisMargin: 8, // in pixels
585                    borderWidth: 2, // in pixels
586                    minBorderMargin: null, // in pixels, null means taken from points radius
587                    markings: null, // array of ranges or fn: axes -> array of ranges
588                    markingsColor: "#f4f4f4",
589                    markingsLineWidth: 2,
590                    // interactive stuff
591                    clickable: false,
592                    hoverable: false,
593                    autoHighlight: true, // highlight in case mouse is near
594                    mouseActiveRadius: 10 // how far the mouse can be away to activate an item
595                },
596                interaction: {
597                    redrawOverlayInterval: 1000/60 // time between updates, -1 means in same flow
598                },
599                hooks: {}
600            },
601        surface = null,     // the canvas for the plot itself
602        overlay = null,     // canvas for interactive stuff on top of plot
603        eventHolder = null, // jQuery object that events should be bound to
604        ctx = null, octx = null,
605        xaxes = [], yaxes = [],
606        plotOffset = { left: 0, right: 0, top: 0, bottom: 0},
607        plotWidth = 0, plotHeight = 0,
608        hooks = {
609            processOptions: [],
610            processRawData: [],
611            processDatapoints: [],
612            processOffset: [],
613            drawBackground: [],
614            drawSeries: [],
615            draw: [],
616            bindEvents: [],
617            drawOverlay: [],
618            shutdown: []
619        },
620        plot = this;
621
622        // public functions
623        plot.setData = setData;
624        plot.setupGrid = setupGrid;
625        plot.draw = draw;
626        plot.getPlaceholder = function() { return placeholder; };
627        plot.getCanvas = function() { return surface.element; };
628        plot.getPlotOffset = function() { return plotOffset; };
629        plot.width = function () { return plotWidth; };
630        plot.height = function () { return plotHeight; };
631        plot.offset = function () {
632            var o = eventHolder.offset();
633            o.left += plotOffset.left;
634            o.top += plotOffset.top;
635            return o;
636        };
637        plot.getData = function () { return series; };
638        plot.getAxes = function () {
639            var res = {}, i;
640            $.each(xaxes.concat(yaxes), function (_, axis) {
641                if (axis)
642                    res[axis.direction + (axis.n != 1 ? axis.n : "") + "axis"] = axis;
643            });
644            return res;
645        };
646        plot.getXAxes = function () { return xaxes; };
647        plot.getYAxes = function () { return yaxes; };
648        plot.c2p = canvasToAxisCoords;
649        plot.p2c = axisToCanvasCoords;
650        plot.getOptions = function () { return options; };
651        plot.highlight = highlight;
652        plot.unhighlight = unhighlight;
653        plot.triggerRedrawOverlay = triggerRedrawOverlay;
654        plot.pointOffset = function(point) {
655            return {
656                left: parseInt(xaxes[axisNumber(point, "x") - 1].p2c(+point.x) + plotOffset.left, 10),
657                top: parseInt(yaxes[axisNumber(point, "y") - 1].p2c(+point.y) + plotOffset.top, 10)
658            };
659        };
660        plot.shutdown = shutdown;
661        plot.resize = function () {
662                var width = placeholder.width(),
663                        height = placeholder.height();
664            surface.resize(width, height);
665            overlay.resize(width, height);
666        };
667
668        // public attributes
669        plot.hooks = hooks;
670
671        // initialize
672        initPlugins(plot);
673        parseOptions(options_);
674        setupCanvases();
675        setData(data_);
676        setupGrid();
677        draw();
678        bindEvents();
679
680
681        function executeHooks(hook, args) {
682            args = [plot].concat(args);
683            for (var i = 0; i < hook.length; ++i)
684                hook[i].apply(this, args);
685        }
686
687        function initPlugins() {
688
689            // References to key classes, allowing plugins to modify them
690
691            var classes = {
692                Canvas: Canvas
693            };
694
695            for (var i = 0; i < plugins.length; ++i) {
696                var p = plugins[i];
697                p.init(plot, classes);
698                if (p.options)
699                    $.extend(true, options, p.options);
700            }
701        }
702
703        function parseOptions(opts) {
704
705            $.extend(true, options, opts);
706
707            // $.extend merges arrays, rather than replacing them.  When less
708            // colors are provided than the size of the default palette, we
709            // end up with those colors plus the remaining defaults, which is
710            // not expected behavior; avoid it by replacing them here.
711
712            if (opts && opts.colors) {
713                options.colors = opts.colors;
714            }
715
716            if (options.xaxis.color == null)
717                options.xaxis.color = $.color.parse(options.grid.color).scale('a', 0.22).toString();
718            if (options.yaxis.color == null)
719                options.yaxis.color = $.color.parse(options.grid.color).scale('a', 0.22).toString();
720
721            if (options.xaxis.tickColor == null) // grid.tickColor for back-compatibility
722                options.xaxis.tickColor = options.grid.tickColor || options.xaxis.color;
723            if (options.yaxis.tickColor == null) // grid.tickColor for back-compatibility
724                options.yaxis.tickColor = options.grid.tickColor || options.yaxis.color;
725
726            if (options.grid.borderColor == null)
727                options.grid.borderColor = options.grid.color;
728            if (options.grid.tickColor == null)
729                options.grid.tickColor = $.color.parse(options.grid.color).scale('a', 0.22).toString();
730
731            // Fill in defaults for axis options, including any unspecified
732            // font-spec fields, if a font-spec was provided.
733
734            // If no x/y axis options were provided, create one of each anyway,
735            // since the rest of the code assumes that they exist.
736
737            var i, axisOptions, axisCount,
738                fontDefaults = {
739                    style: placeholder.css("font-style"),
740                    size: Math.round(0.8 * (+placeholder.css("font-size").replace("px", "") || 13)),
741                    variant: placeholder.css("font-variant"),
742                    weight: placeholder.css("font-weight"),
743                    family: placeholder.css("font-family")
744                };
745
746            fontDefaults.lineHeight = fontDefaults.size * 1.15;
747
748            axisCount = options.xaxes.length || 1;
749            for (i = 0; i < axisCount; ++i) {
750
751                axisOptions = options.xaxes[i];
752                if (axisOptions && !axisOptions.tickColor) {
753                    axisOptions.tickColor = axisOptions.color;
754                }
755
756                axisOptions = $.extend(true, {}, options.xaxis, axisOptions);
757                options.xaxes[i] = axisOptions;
758
759                if (axisOptions.font) {
760                    axisOptions.font = $.extend({}, fontDefaults, axisOptions.font);
761                    if (!axisOptions.font.color) {
762                        axisOptions.font.color = axisOptions.color;
763                    }
764                }
765            }
766
767            axisCount = options.yaxes.length || 1;
768            for (i = 0; i < axisCount; ++i) {
769
770                axisOptions = options.yaxes[i];
771                if (axisOptions && !axisOptions.tickColor) {
772                    axisOptions.tickColor = axisOptions.color;
773                }
774
775                axisOptions = $.extend(true, {}, options.yaxis, axisOptions);
776                options.yaxes[i] = axisOptions;
777
778                if (axisOptions.font) {
779                    axisOptions.font = $.extend({}, fontDefaults, axisOptions.font);
780                    if (!axisOptions.font.color) {
781                        axisOptions.font.color = axisOptions.color;
782                    }
783                }
784            }
785
786            // backwards compatibility, to be removed in future
787            if (options.xaxis.noTicks && options.xaxis.ticks == null)
788                options.xaxis.ticks = options.xaxis.noTicks;
789            if (options.yaxis.noTicks && options.yaxis.ticks == null)
790                options.yaxis.ticks = options.yaxis.noTicks;
791            if (options.x2axis) {
792                options.xaxes[1] = $.extend(true, {}, options.xaxis, options.x2axis);
793                options.xaxes[1].position = "top";
794            }
795            if (options.y2axis) {
796                options.yaxes[1] = $.extend(true, {}, options.yaxis, options.y2axis);
797                options.yaxes[1].position = "right";
798            }
799            if (options.grid.coloredAreas)
800                options.grid.markings = options.grid.coloredAreas;
801            if (options.grid.coloredAreasColor)
802                options.grid.markingsColor = options.grid.coloredAreasColor;
803            if (options.lines)
804                $.extend(true, options.series.lines, options.lines);
805            if (options.points)
806                $.extend(true, options.series.points, options.points);
807            if (options.bars)
808                $.extend(true, options.series.bars, options.bars);
809            if (options.shadowSize != null)
810                options.series.shadowSize = options.shadowSize;
811            if (options.highlightColor != null)
812                options.series.highlightColor = options.highlightColor;
813
814            // save options on axes for future reference
815            for (i = 0; i < options.xaxes.length; ++i)
816                getOrCreateAxis(xaxes, i + 1).options = options.xaxes[i];
817            for (i = 0; i < options.yaxes.length; ++i)
818                getOrCreateAxis(yaxes, i + 1).options = options.yaxes[i];
819
820            // add hooks from options
821            for (var n in hooks)
822                if (options.hooks[n] && options.hooks[n].length)
823                    hooks[n] = hooks[n].concat(options.hooks[n]);
824
825            executeHooks(hooks.processOptions, [options]);
826        }
827
828        function setData(d) {
829            series = parseData(d);
830            fillInSeriesOptions();
831            processData();
832        }
833
834        function parseData(d) {
835            var res = [];
836            for (var i = 0; i < d.length; ++i) {
837                var s = $.extend(true, {}, options.series);
838
839                if (d[i].data != null) {
840                    s.data = d[i].data; // move the data instead of deep-copy
841                    delete d[i].data;
842
843                    $.extend(true, s, d[i]);
844
845                    d[i].data = s.data;
846                }
847                else
848                    s.data = d[i];
849                res.push(s);
850            }
851
852            return res;
853        }
854
855        function axisNumber(obj, coord) {
856            var a = obj[coord + "axis"];
857            if (typeof a == "object") // if we got a real axis, extract number
858                a = a.n;
859            if (typeof a != "number")
860                a = 1; // default to first axis
861            return a;
862        }
863
864        function allAxes() {
865            // return flat array without annoying null entries
866            return $.grep(xaxes.concat(yaxes), function (a) { return a; });
867        }
868
869        function canvasToAxisCoords(pos) {
870            // return an object with x/y corresponding to all used axes
871            var res = {}, i, axis;
872            for (i = 0; i < xaxes.length; ++i) {
873                axis = xaxes[i];
874                if (axis && axis.used)
875                    res["x" + axis.n] = axis.c2p(pos.left);
876            }
877
878            for (i = 0; i < yaxes.length; ++i) {
879                axis = yaxes[i];
880                if (axis && axis.used)
881                    res["y" + axis.n] = axis.c2p(pos.top);
882            }
883
884            if (res.x1 !== undefined)
885                res.x = res.x1;
886            if (res.y1 !== undefined)
887                res.y = res.y1;
888
889            return res;
890        }
891
892        function axisToCanvasCoords(pos) {
893            // get canvas coords from the first pair of x/y found in pos
894            var res = {}, i, axis, key;
895
896            for (i = 0; i < xaxes.length; ++i) {
897                axis = xaxes[i];
898                if (axis && axis.used) {
899                    key = "x" + axis.n;
900                    if (pos[key] == null && axis.n == 1)
901                        key = "x";
902
903                    if (pos[key] != null) {
904                        res.left = axis.p2c(pos[key]);
905                        break;
906                    }
907                }
908            }
909
910            for (i = 0; i < yaxes.length; ++i) {
911                axis = yaxes[i];
912                if (axis && axis.used) {
913                    key = "y" + axis.n;
914                    if (pos[key] == null && axis.n == 1)
915                        key = "y";
916
917                    if (pos[key] != null) {
918                        res.top = axis.p2c(pos[key]);
919                        break;
920                    }
921                }
922            }
923
924            return res;
925        }
926
927        function getOrCreateAxis(axes, number) {
928            if (!axes[number - 1])
929                axes[number - 1] = {
930                    n: number, // save the number for future reference
931                    direction: axes == xaxes ? "x" : "y",
932                    options: $.extend(true, {}, axes == xaxes ? options.xaxis : options.yaxis)
933                };
934
935            return axes[number - 1];
936        }
937
938        function fillInSeriesOptions() {
939
940            var neededColors = series.length, maxIndex = -1, i;
941
942            // Subtract the number of series that already have fixed colors or
943            // color indexes from the number that we still need to generate.
944
945            for (i = 0; i < series.length; ++i) {
946                var sc = series[i].color;
947                if (sc != null) {
948                    neededColors--;
949                    if (typeof sc == "number" && sc > maxIndex) {
950                        maxIndex = sc;
951                    }
952                }
953            }
954
955            // If any of the series have fixed color indexes, then we need to
956            // generate at least as many colors as the highest index.
957
958            if (neededColors <= maxIndex) {
959                neededColors = maxIndex + 1;
960            }
961
962            // Generate all the colors, using first the option colors and then
963            // variations on those colors once they're exhausted.
964
965            var c, colors = [], colorPool = options.colors,
966                colorPoolSize = colorPool.length, variation = 0;
967
968            for (i = 0; i < neededColors; i++) {
969
970                c = $.color.parse(colorPool[i % colorPoolSize] || "#666");
971
972                // Each time we exhaust the colors in the pool we adjust
973                // a scaling factor used to produce more variations on
974                // those colors. The factor alternates negative/positive
975                // to produce lighter/darker colors.
976
977                // Reset the variation after every few cycles, or else
978                // it will end up producing only white or black colors.
979
980                if (i % colorPoolSize == 0 && i) {
981                    if (variation >= 0) {
982                        if (variation < 0.5) {
983                            variation = -variation - 0.2;
984                        } else variation = 0;
985                    } else variation = -variation;
986                }
987
988                colors[i] = c.scale('rgb', 1 + variation);
989            }
990
991            // Finalize the series options, filling in their colors
992
993            var colori = 0, s;
994            for (i = 0; i < series.length; ++i) {
995                s = series[i];
996
997                // assign colors
998                if (s.color == null) {
999                    s.color = colors[colori].toString();
1000                    ++colori;
1001                }
1002                else if (typeof s.color == "number")
1003                    s.color = colors[s.color].toString();
1004
1005                // turn on lines automatically in case nothing is set
1006                if (s.lines.show == null) {
1007                    var v, show = true;
1008                    for (v in s)
1009                        if (s[v] && s[v].show) {
1010                            show = false;
1011                            break;
1012                        }
1013                    if (show)
1014                        s.lines.show = true;
1015                }
1016
1017                // If nothing was provided for lines.zero, default it to match
1018                // lines.fill, since areas by default should extend to zero.
1019
1020                if (s.lines.zero == null) {
1021                    s.lines.zero = !!s.lines.fill;
1022                }
1023
1024                // setup axes
1025                s.xaxis = getOrCreateAxis(xaxes, axisNumber(s, "x"));
1026                s.yaxis = getOrCreateAxis(yaxes, axisNumber(s, "y"));
1027            }
1028        }
1029
1030        function processData() {
1031            var topSentry = Number.POSITIVE_INFINITY,
1032                bottomSentry = Number.NEGATIVE_INFINITY,
1033                fakeInfinity = Number.MAX_VALUE,
1034                i, j, k, m, length,
1035                s, points, ps, x, y, axis, val, f, p,
1036                data, format;
1037
1038            function updateAxis(axis, min, max) {
1039                if (min < axis.datamin && min != -fakeInfinity)
1040                    axis.datamin = min;
1041                if (max > axis.datamax && max != fakeInfinity)
1042                    axis.datamax = max;
1043            }
1044
1045            $.each(allAxes(), function (_, axis) {
1046                // init axis
1047                axis.datamin = topSentry;
1048                axis.datamax = bottomSentry;
1049                axis.used = false;
1050            });
1051
1052            for (i = 0; i < series.length; ++i) {
1053                s = series[i];
1054                s.datapoints = { points: [] };
1055
1056                executeHooks(hooks.processRawData, [ s, s.data, s.datapoints ]);
1057            }
1058
1059            // first pass: clean and copy data
1060            for (i = 0; i < series.length; ++i) {
1061                s = series[i];
1062
1063                data = s.data;
1064                format = s.datapoints.format;
1065
1066                if (!format) {
1067                    format = [];
1068                    // find out how to copy
1069                    format.push({ x: true, number: true, required: true });
1070                    format.push({ y: true, number: true, required: true });
1071
1072                    if (s.bars.show || (s.lines.show && s.lines.fill)) {
1073                        var autoscale = !!((s.bars.show && s.bars.zero) || (s.lines.show && s.lines.zero));
1074                        format.push({ y: true, number: true, required: false, defaultValue: 0, autoscale: autoscale });
1075                        if (s.bars.horizontal) {
1076                            delete format[format.length - 1].y;
1077                            format[format.length - 1].x = true;
1078                        }
1079                    }
1080
1081                    s.datapoints.format = format;
1082                }
1083
1084                if (s.datapoints.pointsize != null)
1085                    continue; // already filled in
1086
1087                s.datapoints.pointsize = format.length;
1088
1089                ps = s.datapoints.pointsize;
1090                points = s.datapoints.points;
1091
1092                var insertSteps = s.lines.show && s.lines.steps;
1093                s.xaxis.used = s.yaxis.used = true;
1094
1095                for (j = k = 0; j < data.length; ++j, k += ps) {
1096                    p = data[j];
1097
1098                    var nullify = p == null;
1099                    if (!nullify) {
1100                        for (m = 0; m < ps; ++m) {
1101                            val = p[m];
1102                            f = format[m];
1103
1104                            if (f) {
1105                                if (f.number && val != null) {
1106                                    val = +val; // convert to number
1107                                    if (isNaN(val))
1108                                        val = null;
1109                                    else if (val == Infinity)
1110                                        val = fakeInfinity;
1111                                    else if (val == -Infinity)
1112                                        val = -fakeInfinity;
1113                                }
1114
1115                                if (val == null) {
1116                                    if (f.required)
1117                                        nullify = true;
1118
1119                                    if (f.defaultValue != null)
1120                                        val = f.defaultValue;
1121                                }
1122                            }
1123
1124                            points[k + m] = val;
1125                        }
1126                    }
1127
1128                    if (nullify) {
1129                        for (m = 0; m < ps; ++m) {
1130                            val = points[k + m];
1131                            if (val != null) {
1132                                f = format[m];
1133                                // extract min/max info
1134                                if (f.autoscale) {
1135                                    if (f.x) {
1136                                        updateAxis(s.xaxis, val, val);
1137                                    }
1138                                    if (f.y) {
1139                                        updateAxis(s.yaxis, val, val);
1140                                    }
1141                                }
1142                            }
1143                            points[k + m] = null;
1144                        }
1145                    }
1146                    else {
1147                        // a little bit of line specific stuff that
1148                        // perhaps shouldn't be here, but lacking
1149                        // better means...
1150                        if (insertSteps && k > 0
1151                            && points[k - ps] != null
1152                            && points[k - ps] != points[k]
1153                            && points[k - ps + 1] != points[k + 1]) {
1154                            // copy the point to make room for a middle point
1155                            for (m = 0; m < ps; ++m)
1156                                points[k + ps + m] = points[k + m];
1157
1158                            // middle point has same y
1159                            points[k + 1] = points[k - ps + 1];
1160
1161                            // we've added a point, better reflect that
1162                            k += ps;
1163                        }
1164                    }
1165                }
1166            }
1167
1168            // give the hooks a chance to run
1169            for (i = 0; i < series.length; ++i) {
1170                s = series[i];
1171
1172                executeHooks(hooks.processDatapoints, [ s, s.datapoints]);
1173            }
1174
1175            // second pass: find datamax/datamin for auto-scaling
1176            for (i = 0; i < series.length; ++i) {
1177                s = series[i];
1178                points = s.datapoints.points;
1179                ps = s.datapoints.pointsize;
1180                format = s.datapoints.format;
1181
1182                var xmin = topSentry, ymin = topSentry,
1183                    xmax = bottomSentry, ymax = bottomSentry;
1184
1185                for (j = 0; j < points.length; j += ps) {
1186                    if (points[j] == null)
1187                        continue;
1188
1189                    for (m = 0; m < ps; ++m) {
1190                        val = points[j + m];
1191                        f = format[m];
1192                        if (!f || f.autoscale === false || val == fakeInfinity || val == -fakeInfinity)
1193                            continue;
1194
1195                        if (f.x) {
1196                            if (val < xmin)
1197                                xmin = val;
1198                            if (val > xmax)
1199                                xmax = val;
1200                        }
1201                        if (f.y) {
1202                            if (val < ymin)
1203                                ymin = val;
1204                            if (val > ymax)
1205                                ymax = val;
1206                        }
1207                    }
1208                }
1209
1210                if (s.bars.show) {
1211                    // make sure we got room for the bar on the dancing floor
1212                    var delta;
1213
1214                    switch (s.bars.align) {
1215                        case "left":
1216                            delta = 0;
1217                            break;
1218                        case "right":
1219                            delta = -s.bars.barWidth;
1220                            break;
1221                        case "center":
1222                            delta = -s.bars.barWidth / 2;
1223                            break;
1224                        default:
1225                            throw new Error("Invalid bar alignment: " + s.bars.align);
1226                    }
1227
1228                    if (s.bars.horizontal) {
1229                        ymin += delta;
1230                        ymax += delta + s.bars.barWidth;
1231                    }
1232                    else {
1233                        xmin += delta;
1234                        xmax += delta + s.bars.barWidth;
1235                    }
1236                }
1237
1238                updateAxis(s.xaxis, xmin, xmax);
1239                updateAxis(s.yaxis, ymin, ymax);
1240            }
1241
1242            $.each(allAxes(), function (_, axis) {
1243                if (axis.datamin == topSentry)
1244                    axis.datamin = null;
1245                if (axis.datamax == bottomSentry)
1246                    axis.datamax = null;
1247            });
1248        }
1249
1250        function setupCanvases() {
1251
1252            // Make sure the placeholder is clear of everything except canvases
1253            // from a previous plot in this container that we'll try to re-use.
1254
1255            placeholder.css("padding", 0) // padding messes up the positioning
1256                .children(":not(.flot-base,.flot-overlay)").remove();
1257
1258            if (placeholder.css("position") == 'static')
1259                placeholder.css("position", "relative"); // for positioning labels and overlay
1260
1261            surface = new Canvas("flot-base", placeholder);
1262            overlay = new Canvas("flot-overlay", placeholder); // overlay canvas for interactive features
1263
1264            ctx = surface.context;
1265            octx = overlay.context;
1266
1267            // define which element we're listening for events on
1268            eventHolder = $(overlay.element).unbind();
1269
1270            // If we're re-using a plot object, shut down the old one
1271
1272            var existing = placeholder.data("plot");
1273
1274            if (existing) {
1275                existing.shutdown();
1276                overlay.clear();
1277            }
1278
1279            // save in case we get replotted
1280            placeholder.data("plot", plot);
1281        }
1282
1283        function bindEvents() {
1284            // bind events
1285            if (options.grid.hoverable) {
1286                eventHolder.mousemove(onMouseMove);
1287
1288                // Use bind, rather than .mouseleave, because we officially
1289                // still support jQuery 1.2.6, which doesn't define a shortcut
1290                // for mouseenter or mouseleave.  This was a bug/oversight that
1291                // was fixed somewhere around 1.3.x.  We can return to using
1292                // .mouseleave when we drop support for 1.2.6.
1293
1294                eventHolder.bind("mouseleave", onMouseLeave);
1295            }
1296
1297            if (options.grid.clickable)
1298                eventHolder.click(onClick);
1299
1300            executeHooks(hooks.bindEvents, [eventHolder]);
1301        }
1302
1303        function shutdown() {
1304            if (redrawTimeout)
1305                clearTimeout(redrawTimeout);
1306
1307            eventHolder.unbind("mousemove", onMouseMove);
1308            eventHolder.unbind("mouseleave", onMouseLeave);
1309            eventHolder.unbind("click", onClick);
1310
1311            executeHooks(hooks.shutdown, [eventHolder]);
1312        }
1313
1314        function setTransformationHelpers(axis) {
1315            // set helper functions on the axis, assumes plot area
1316            // has been computed already
1317
1318            function identity(x) { return x; }
1319
1320            var s, m, t = axis.options.transform || identity,
1321                it = axis.options.inverseTransform;
1322
1323            // precompute how much the axis is scaling a point
1324            // in canvas space
1325            if (axis.direction == "x") {
1326                s = axis.scale = plotWidth / Math.abs(t(axis.max) - t(axis.min));
1327                m = Math.min(t(axis.max), t(axis.min));
1328            }
1329            else {
1330                s = axis.scale = plotHeight / Math.abs(t(axis.max) - t(axis.min));
1331                s = -s;
1332                m = Math.max(t(axis.max), t(axis.min));
1333            }
1334
1335            // data point to canvas coordinate
1336            if (t == identity) // slight optimization
1337                axis.p2c = function (p) { return (p - m) * s; };
1338            else
1339                axis.p2c = function (p) { return (t(p) - m) * s; };
1340            // canvas coordinate to data point
1341            if (!it)
1342                axis.c2p = function (c) { return m + c / s; };
1343            else
1344                axis.c2p = function (c) { return it(m + c / s); };
1345        }
1346
1347        function measureTickLabels(axis) {
1348
1349            var opts = axis.options,
1350                ticks = axis.ticks || [],
1351                labelWidth = opts.labelWidth || 0,
1352                labelHeight = opts.labelHeight || 0,
1353                maxWidth = labelWidth || axis.direction == "x" ? Math.floor(surface.width / (ticks.length || 1)) : null;
1354                legacyStyles = axis.direction + "Axis " + axis.direction + axis.n + "Axis",
1355                layer = "flot-" + axis.direction + "-axis flot-" + axis.direction + axis.n + "-axis " + legacyStyles,
1356                font = opts.font || "flot-tick-label tickLabel";
1357
1358            for (var i = 0; i < ticks.length; ++i) {
1359
1360                var t = ticks[i];
1361
1362                if (!t.label)
1363                    continue;
1364
1365                var info = surface.getTextInfo(layer, t.label, font, null, maxWidth);
1366
1367                labelWidth = Math.max(labelWidth, info.width);
1368                labelHeight = Math.max(labelHeight, info.height);
1369            }
1370
1371            axis.labelWidth = opts.labelWidth || labelWidth;
1372            axis.labelHeight = opts.labelHeight || labelHeight;
1373        }
1374
1375        function allocateAxisBoxFirstPhase(axis) {
1376            // find the bounding box of the axis by looking at label
1377            // widths/heights and ticks, make room by diminishing the
1378            // plotOffset; this first phase only looks at one
1379            // dimension per axis, the other dimension depends on the
1380            // other axes so will have to wait
1381
1382            var lw = axis.labelWidth,
1383                lh = axis.labelHeight,
1384                pos = axis.options.position,
1385                tickLength = axis.options.tickLength,
1386                axisMargin = options.grid.axisMargin,
1387                padding = options.grid.labelMargin,
1388                all = axis.direction == "x" ? xaxes : yaxes,
1389                index, innermost;
1390
1391            // determine axis margin
1392            var samePosition = $.grep(all, function (a) {
1393                return a && a.options.position == pos && a.reserveSpace;
1394            });
1395            if ($.inArray(axis, samePosition) == samePosition.length - 1)
1396                axisMargin = 0; // outermost
1397
1398            // determine tick length - if we're innermost, we can use "full"
1399            if (tickLength == null) {
1400                var sameDirection = $.grep(all, function (a) {
1401                    return a && a.reserveSpace;
1402                });
1403
1404                innermost = $.inArray(axis, sameDirection) == 0;
1405                if (innermost)
1406                    tickLength = "full";
1407                else
1408                    tickLength = 5;
1409            }
1410
1411            if (!isNaN(+tickLength))
1412                padding += +tickLength;
1413
1414            // compute box
1415            if (axis.direction == "x") {
1416                lh += padding;
1417
1418                if (pos == "bottom") {
1419                    plotOffset.bottom += lh + axisMargin;
1420                    axis.box = { top: surface.height - plotOffset.bottom, height: lh };
1421                }
1422                else {
1423                    axis.box = { top: plotOffset.top + axisMargin, height: lh };
1424                    plotOffset.top += lh + axisMargin;
1425                }
1426            }
1427            else {
1428                lw += padding;
1429
1430                if (pos == "left") {
1431                    axis.box = { left: plotOffset.left + axisMargin, width: lw };
1432                    plotOffset.left += lw + axisMargin;
1433                }
1434                else {
1435                    plotOffset.right += lw + axisMargin;
1436                    axis.box = { left: surface.width - plotOffset.right, width: lw };
1437                }
1438            }
1439
1440             // save for future reference
1441            axis.position = pos;
1442            axis.tickLength = tickLength;
1443            axis.box.padding = padding;
1444            axis.innermost = innermost;
1445        }
1446
1447        function allocateAxisBoxSecondPhase(axis) {
1448            // now that all axis boxes have been placed in one
1449            // dimension, we can set the remaining dimension coordinates
1450            if (axis.direction == "x") {
1451                axis.box.left = plotOffset.left - axis.labelWidth / 2;
1452                axis.box.width = surface.width - plotOffset.left - plotOffset.right + axis.labelWidth;
1453            }
1454            else {
1455                axis.box.top = plotOffset.top - axis.labelHeight / 2;
1456                axis.box.height = surface.height - plotOffset.bottom - plotOffset.top + axis.labelHeight;
1457            }
1458        }
1459
1460        function adjustLayoutForThingsStickingOut() {
1461            // possibly adjust plot offset to ensure everything stays
1462            // inside the canvas and isn't clipped off
1463
1464            var minMargin = options.grid.minBorderMargin,
1465                margins = { x: 0, y: 0 }, i, axis;
1466
1467            // check stuff from the plot (FIXME: this should just read
1468            // a value from the series, otherwise it's impossible to
1469            // customize)
1470            if (minMargin == null) {
1471                minMargin = 0;
1472                for (i = 0; i < series.length; ++i)
1473                    minMargin = Math.max(minMargin, 2 * (series[i].points.radius + series[i].points.lineWidth/2));
1474            }
1475
1476            margins.x = margins.y = Math.ceil(minMargin);
1477
1478            // check axis labels, note we don't check the actual
1479            // labels but instead use the overall width/height to not
1480            // jump as much around with replots
1481            $.each(allAxes(), function (_, axis) {
1482                var dir = axis.direction;
1483                if (axis.reserveSpace)
1484                    margins[dir] = Math.ceil(Math.max(margins[dir], (dir == "x" ? axis.labelWidth : axis.labelHeight) / 2));
1485            });
1486
1487            plotOffset.left = Math.max(margins.x, plotOffset.left);
1488            plotOffset.right = Math.max(margins.x, plotOffset.right);
1489            plotOffset.top = Math.max(margins.y, plotOffset.top);
1490            plotOffset.bottom = Math.max(margins.y, plotOffset.bottom);
1491        }
1492
1493        function setupGrid() {
1494            var i, axes = allAxes(), showGrid = options.grid.show;
1495
1496            // Initialize the plot's offset from the edge of the canvas
1497
1498            for (var a in plotOffset) {
1499                var margin = options.grid.margin || 0;
1500                plotOffset[a] = typeof margin == "number" ? margin : margin[a] || 0;
1501            }
1502
1503            executeHooks(hooks.processOffset, [plotOffset]);
1504
1505            // If the grid is visible, add its border width to the offset
1506
1507            for (var a in plotOffset) {
1508                if(typeof(options.grid.borderWidth) == "object") {
1509                    plotOffset[a] += showGrid ? options.grid.borderWidth[a] : 0;
1510                }
1511                else {
1512                    plotOffset[a] += showGrid ? options.grid.borderWidth : 0;
1513                }
1514            }
1515
1516            // init axes
1517            $.each(axes, function (_, axis) {
1518                axis.show = axis.options.show;
1519                if (axis.show == null)
1520                    axis.show = axis.used; // by default an axis is visible if it's got data
1521
1522                axis.reserveSpace = axis.show || axis.options.reserveSpace;
1523
1524                setRange(axis);
1525            });
1526
1527            if (showGrid) {
1528
1529                var allocatedAxes = $.grep(axes, function (axis) { return axis.reserveSpace; });
1530
1531                $.each(allocatedAxes, function (_, axis) {
1532                    // make the ticks
1533                    setupTickGeneration(axis);
1534                    setTicks(axis);
1535                    snapRangeToTicks(axis, axis.ticks);
1536                    // find labelWidth/Height for axis
1537                    measureTickLabels(axis);
1538                });
1539
1540                // with all dimensions calculated, we can compute the
1541                // axis bounding boxes, start from the outside
1542                // (reverse order)
1543                for (i = allocatedAxes.length - 1; i >= 0; --i)
1544                    allocateAxisBoxFirstPhase(allocatedAxes[i]);
1545
1546                // make sure we've got enough space for things that
1547                // might stick out
1548                adjustLayoutForThingsStickingOut();
1549
1550                $.each(allocatedAxes, function (_, axis) {
1551                    allocateAxisBoxSecondPhase(axis);
1552                });
1553            }
1554
1555            plotWidth = surface.width - plotOffset.left - plotOffset.right;
1556            plotHeight = surface.height - plotOffset.bottom - plotOffset.top;
1557
1558            // now we got the proper plot dimensions, we can compute the scaling
1559            $.each(axes, function (_, axis) {
1560                setTransformationHelpers(axis);
1561            });
1562
1563            if (showGrid) {
1564                drawAxisLabels();
1565            }
1566
1567            insertLegend();
1568        }
1569
1570        function setRange(axis) {
1571            var opts = axis.options,
1572                min = +(opts.min != null ? opts.min : axis.datamin),
1573                max = +(opts.max != null ? opts.max : axis.datamax),
1574                delta = max - min;
1575
1576            if (delta == 0.0) {
1577                // degenerate case
1578                var widen = max == 0 ? 1 : 0.01;
1579
1580                if (opts.min == null)
1581                    min -= widen;
1582                // always widen max if we couldn't widen min to ensure we
1583                // don't fall into min == max which doesn't work
1584                if (opts.max == null || opts.min != null)
1585                    max += widen;
1586            }
1587            else {
1588                // consider autoscaling
1589                var margin = opts.autoscaleMargin;
1590                if (margin != null) {
1591                    if (opts.min == null) {
1592                        min -= delta * margin;
1593                        // make sure we don't go below zero if all values
1594                        // are positive
1595                        if (min < 0 && axis.datamin != null && axis.datamin >= 0)
1596                            min = 0;
1597                    }
1598                    if (opts.max == null) {
1599                        max += delta * margin;
1600                        if (max > 0 && axis.datamax != null && axis.datamax <= 0)
1601                            max = 0;
1602                    }
1603                }
1604            }
1605            axis.min = min;
1606            axis.max = max;
1607        }
1608
1609        function setupTickGeneration(axis) {
1610            var opts = axis.options;
1611
1612            // estimate number of ticks
1613            var noTicks;
1614            if (typeof opts.ticks == "number" && opts.ticks > 0)
1615                noTicks = opts.ticks;
1616            else
1617                // heuristic based on the model a*sqrt(x) fitted to
1618                // some data points that seemed reasonable
1619                noTicks = 0.3 * Math.sqrt(axis.direction == "x" ? surface.width : surface.height);
1620
1621            var delta = (axis.max - axis.min) / noTicks,
1622                dec = -Math.floor(Math.log(delta) / Math.LN10),
1623                maxDec = opts.tickDecimals;
1624
1625            if (maxDec != null && dec > maxDec) {
1626                dec = maxDec;
1627            }
1628
1629            var magn = Math.pow(10, -dec),
1630                norm = delta / magn, // norm is between 1.0 and 10.0
1631                size;
1632
1633            if (norm < 1.5) {
1634                size = 1;
1635            } else if (norm < 3) {
1636                size = 2;
1637                // special case for 2.5, requires an extra decimal
1638                if (norm > 2.25 && (maxDec == null || dec + 1 <= maxDec)) {
1639                    size = 2.5;
1640                    ++dec;
1641                }
1642            } else if (norm < 7.5) {
1643                size = 5;
1644            } else {
1645                size = 10;
1646            }
1647
1648            size *= magn;
1649
1650            if (opts.minTickSize != null && size < opts.minTickSize) {
1651                size = opts.minTickSize;
1652            }
1653
1654            axis.delta = delta;
1655            axis.tickDecimals = Math.max(0, maxDec != null ? maxDec : dec);
1656            axis.tickSize = opts.tickSize || size;
1657
1658            // Time mode was moved to a plug-in in 0.8, but since so many people use this
1659            // we'll add an especially friendly make sure they remembered to include it.
1660
1661            if (opts.mode == "time" && !axis.tickGenerator) {
1662                throw new Error("Time mode requires the flot.time plugin.");
1663            }
1664
1665            // Flot supports base-10 axes; any other mode else is handled by a plug-in,
1666            // like flot.time.js.
1667
1668            if (!axis.tickGenerator) {
1669
1670                axis.tickGenerator = function (axis) {
1671
1672                    var ticks = [],
1673                        start = floorInBase(axis.min, axis.tickSize),
1674                        i = 0,
1675                        v = Number.NaN,
1676                        prev;
1677
1678                    do {
1679                        prev = v;
1680                        v = start + i * axis.tickSize;
1681                        ticks.push(v);
1682                        ++i;
1683                    } while (v < axis.max && v != prev);
1684                    return ticks;
1685                };
1686
1687                                axis.tickFormatter = function (value, axis) {
1688
1689                                        var factor = axis.tickDecimals ? Math.pow(10, axis.tickDecimals) : 1;
1690                                        var formatted = "" + Math.round(value * factor) / factor;
1691
1692                                        // If tickDecimals was specified, ensure that we have exactly that
1693                                        // much precision; otherwise default to the value's own precision.
1694
1695                                        if (axis.tickDecimals != null) {
1696                                                var decimal = formatted.indexOf(".");
1697                                                var precision = decimal == -1 ? 0 : formatted.length - decimal - 1;
1698                                                if (precision < axis.tickDecimals) {
1699                                                        return (precision ? formatted : formatted + ".") + ("" + factor).substr(1, axis.tickDecimals - precision);
1700                                                }
1701                                        }
1702
1703                    return formatted;
1704                };
1705            }
1706
1707            if ($.isFunction(opts.tickFormatter))
1708                axis.tickFormatter = function (v, axis) { return "" + opts.tickFormatter(v, axis); };
1709
1710            if (opts.alignTicksWithAxis != null) {
1711                var otherAxis = (axis.direction == "x" ? xaxes : yaxes)[opts.alignTicksWithAxis - 1];
1712                if (otherAxis && otherAxis.used && otherAxis != axis) {
1713                    // consider snapping min/max to outermost nice ticks
1714                    var niceTicks = axis.tickGenerator(axis);
1715                    if (niceTicks.length > 0) {
1716                        if (opts.min == null)
1717                            axis.min = Math.min(axis.min, niceTicks[0]);
1718                        if (opts.max == null && niceTicks.length > 1)
1719                            axis.max = Math.max(axis.max, niceTicks[niceTicks.length - 1]);
1720                    }
1721
1722                    axis.tickGenerator = function (axis) {
1723                        // copy ticks, scaled to this axis
1724                        var ticks = [], v, i;
1725                        for (i = 0; i < otherAxis.ticks.length; ++i) {
1726                            v = (otherAxis.ticks[i].v - otherAxis.min) / (otherAxis.max - otherAxis.min);
1727                            v = axis.min + v * (axis.max - axis.min);
1728                            ticks.push(v);
1729                        }
1730                        return ticks;
1731                    };
1732
1733                    // we might need an extra decimal since forced
1734                    // ticks don't necessarily fit naturally
1735                    if (!axis.mode && opts.tickDecimals == null) {
1736                        var extraDec = Math.max(0, -Math.floor(Math.log(axis.delta) / Math.LN10) + 1),
1737                            ts = axis.tickGenerator(axis);
1738
1739                        // only proceed if the tick interval rounded
1740                        // with an extra decimal doesn't give us a
1741                        // zero at end
1742                        if (!(ts.length > 1 && /\..*0$/.test((ts[1] - ts[0]).toFixed(extraDec))))
1743                            axis.tickDecimals = extraDec;
1744                    }
1745                }
1746            }
1747        }
1748
1749        function setTicks(axis) {
1750            var oticks = axis.options.ticks, ticks = [];
1751            if (oticks == null || (typeof oticks == "number" && oticks > 0))
1752                ticks = axis.tickGenerator(axis);
1753            else if (oticks) {
1754                if ($.isFunction(oticks))
1755                    // generate the ticks
1756                    ticks = oticks(axis);
1757                else
1758                    ticks = oticks;
1759            }
1760
1761            // clean up/labelify the supplied ticks, copy them over
1762            var i, v;
1763            axis.ticks = [];
1764            for (i = 0; i < ticks.length; ++i) {
1765                var label = null;
1766                var t = ticks[i];
1767                if (typeof t == "object") {
1768                    v = +t[0];
1769                    if (t.length > 1)
1770                        label = t[1];
1771                }
1772                else
1773                    v = +t;
1774                if (label == null)
1775                    label = axis.tickFormatter(v, axis);
1776                if (!isNaN(v))
1777                    axis.ticks.push({ v: v, label: label });
1778            }
1779        }
1780
1781        function snapRangeToTicks(axis, ticks) {
1782            if (axis.options.autoscaleMargin && ticks.length > 0) {
1783                // snap to ticks
1784                if (axis.options.min == null)
1785                    axis.min = Math.min(axis.min, ticks[0].v);
1786                if (axis.options.max == null && ticks.length > 1)
1787                    axis.max = Math.max(axis.max, ticks[ticks.length - 1].v);
1788            }
1789        }
1790
1791        function draw() {
1792
1793            surface.clear();
1794
1795            executeHooks(hooks.drawBackground, [ctx]);
1796
1797            var grid = options.grid;
1798
1799            // draw background, if any
1800            if (grid.show && grid.backgroundColor)
1801                drawBackground();
1802
1803            if (grid.show && !grid.aboveData) {
1804                drawGrid();
1805            }
1806
1807            for (var i = 0; i < series.length; ++i) {
1808                executeHooks(hooks.drawSeries, [ctx, series[i]]);
1809                drawSeries(series[i]);
1810            }
1811
1812            executeHooks(hooks.draw, [ctx]);
1813
1814            if (grid.show && grid.aboveData) {
1815                drawGrid();
1816            }
1817
1818            surface.render();
1819
1820            // A draw implies that either the axes or data have changed, so we
1821            // should probably update the overlay highlights as well.
1822
1823            triggerRedrawOverlay();
1824        }
1825
1826        function extractRange(ranges, coord) {
1827            var axis, from, to, key, axes = allAxes();
1828
1829            for (var i = 0; i < axes.length; ++i) {
1830                axis = axes[i];
1831                if (axis.direction == coord) {
1832                    key = coord + axis.n + "axis";
1833                    if (!ranges[key] && axis.n == 1)
1834                        key = coord + "axis"; // support x1axis as xaxis
1835                    if (ranges[key]) {
1836                        from = ranges[key].from;
1837                        to = ranges[key].to;
1838                        break;
1839                    }
1840                }
1841            }
1842
1843            // backwards-compat stuff - to be removed in future
1844            if (!ranges[key]) {
1845                axis = coord == "x" ? xaxes[0] : yaxes[0];
1846                from = ranges[coord + "1"];
1847                to = ranges[coord + "2"];
1848            }
1849
1850            // auto-reverse as an added bonus
1851            if (from != null && to != null && from > to) {
1852                var tmp = from;
1853                from = to;
1854                to = tmp;
1855            }
1856
1857            return { from: from, to: to, axis: axis };
1858        }
1859
1860        function drawBackground() {
1861            ctx.save();
1862            ctx.translate(plotOffset.left, plotOffset.top);
1863
1864            ctx.fillStyle = getColorOrGradient(options.grid.backgroundColor, plotHeight, 0, "rgba(255, 255, 255, 0)");
1865            ctx.fillRect(0, 0, plotWidth, plotHeight);
1866            ctx.restore();
1867        }
1868
1869        function drawGrid() {
1870            var i, axes, bw, bc;
1871
1872            ctx.save();
1873            ctx.translate(plotOffset.left, plotOffset.top);
1874
1875            // draw markings
1876            var markings = options.grid.markings;
1877            if (markings) {
1878                if ($.isFunction(markings)) {
1879                    axes = plot.getAxes();
1880                    // xmin etc. is backwards compatibility, to be
1881                    // removed in the future
1882                    axes.xmin = axes.xaxis.min;
1883                    axes.xmax = axes.xaxis.max;
1884                    axes.ymin = axes.yaxis.min;
1885                    axes.ymax = axes.yaxis.max;
1886
1887                    markings = markings(axes);
1888                }
1889
1890                for (i = 0; i < markings.length; ++i) {
1891                    var m = markings[i],
1892                        xrange = extractRange(m, "x"),
1893                        yrange = extractRange(m, "y");
1894
1895                    // fill in missing
1896                    if (xrange.from == null)
1897                        xrange.from = xrange.axis.min;
1898                    if (xrange.to == null)
1899                        xrange.to = xrange.axis.max;
1900                    if (yrange.from == null)
1901                        yrange.from = yrange.axis.min;
1902                    if (yrange.to == null)
1903                        yrange.to = yrange.axis.max;
1904
1905                    // clip
1906                    if (xrange.to < xrange.axis.min || xrange.from > xrange.axis.max ||
1907                        yrange.to < yrange.axis.min || yrange.from > yrange.axis.max)
1908                        continue;
1909
1910                    xrange.from = Math.max(xrange.from, xrange.axis.min);
1911                    xrange.to = Math.min(xrange.to, xrange.axis.max);
1912                    yrange.from = Math.max(yrange.from, yrange.axis.min);
1913                    yrange.to = Math.min(yrange.to, yrange.axis.max);
1914
1915                    if (xrange.from == xrange.to && yrange.from == yrange.to)
1916                        continue;
1917
1918                    // then draw
1919                    xrange.from = xrange.axis.p2c(xrange.from);
1920                    xrange.to = xrange.axis.p2c(xrange.to);
1921                    yrange.from = yrange.axis.p2c(yrange.from);
1922                    yrange.to = yrange.axis.p2c(yrange.to);
1923
1924                    if (xrange.from == xrange.to || yrange.from == yrange.to) {
1925                        // draw line
1926                        ctx.beginPath();
1927                        ctx.strokeStyle = m.color || options.grid.markingsColor;
1928                        ctx.lineWidth = m.lineWidth || options.grid.markingsLineWidth;
1929                        ctx.moveTo(xrange.from, yrange.from);
1930                        ctx.lineTo(xrange.to, yrange.to);
1931                        ctx.stroke();
1932                    }
1933                    else {
1934                        // fill area
1935                        ctx.fillStyle = m.color || options.grid.markingsColor;
1936                        ctx.fillRect(xrange.from, yrange.to,
1937                                     xrange.to - xrange.from,
1938                                     yrange.from - yrange.to);
1939                    }
1940                }
1941            }
1942
1943            // draw the ticks
1944            axes = allAxes();
1945            bw = options.grid.borderWidth;
1946
1947            for (var j = 0; j < axes.length; ++j) {
1948                var axis = axes[j], box = axis.box,
1949                    t = axis.tickLength, x, y, xoff, yoff;
1950                if (!axis.show || axis.ticks.length == 0)
1951                    continue;
1952
1953                ctx.lineWidth = 1;
1954
1955                // find the edges
1956                if (axis.direction == "x") {
1957                    x = 0;
1958                    if (t == "full")
1959                        y = (axis.position == "top" ? 0 : plotHeight);
1960                    else
1961                        y = box.top - plotOffset.top + (axis.position == "top" ? box.height : 0);
1962                }
1963                else {
1964                    y = 0;
1965                    if (t == "full")
1966                        x = (axis.position == "left" ? 0 : plotWidth);
1967                    else
1968                        x = box.left - plotOffset.left + (axis.position == "left" ? box.width : 0);
1969                }
1970
1971                // draw tick bar
1972                if (!axis.innermost) {
1973                    ctx.strokeStyle = axis.options.color;
1974                    ctx.beginPath();
1975                    xoff = yoff = 0;
1976                    if (axis.direction == "x")
1977                        xoff = plotWidth + 1;
1978                    else
1979                        yoff = plotHeight + 1;
1980
1981                    if (ctx.lineWidth == 1) {
1982                        if (axis.direction == "x") {
1983                            y = Math.floor(y) + 0.5;
1984                        } else {
1985                            x = Math.floor(x) + 0.5;
1986                        }
1987                    }
1988
1989                    ctx.moveTo(x, y);
1990                    ctx.lineTo(x + xoff, y + yoff);
1991                    ctx.stroke();
1992                }
1993
1994                // draw ticks
1995
1996                ctx.strokeStyle = axis.options.tickColor;
1997
1998                ctx.beginPath();
1999                for (i = 0; i < axis.ticks.length; ++i) {
2000                    var v = axis.ticks[i].v;
2001
2002                    xoff = yoff = 0;
2003
2004                    if (isNaN(v) || v < axis.min || v > axis.max
2005                        // skip those lying on the axes if we got a border
2006                        || (t == "full"
2007                            && ((typeof bw == "object" && bw[axis.position] > 0) || bw > 0)
2008                            && (v == axis.min || v == axis.max)))
2009                        continue;
2010
2011                    if (axis.direction == "x") {
2012                        x = axis.p2c(v);
2013                        yoff = t == "full" ? -plotHeight : t;
2014
2015                        if (axis.position == "top")
2016                            yoff = -yoff;
2017                    }
2018                    else {
2019                        y = axis.p2c(v);
2020                        xoff = t == "full" ? -plotWidth : t;
2021
2022                        if (axis.position == "left")
2023                            xoff = -xoff;
2024                    }
2025
2026                    if (ctx.lineWidth == 1) {
2027                        if (axis.direction == "x")
2028                            x = Math.floor(x) + 0.5;
2029                        else
2030                            y = Math.floor(y) + 0.5;
2031                    }
2032
2033                    ctx.moveTo(x, y);
2034                    ctx.lineTo(x + xoff, y + yoff);
2035                }
2036
2037                ctx.stroke();
2038            }
2039
2040
2041            // draw border
2042            if (bw) {
2043                // If either borderWidth or borderColor is an object, then draw the border
2044                // line by line instead of as one rectangle
2045                bc = options.grid.borderColor;
2046                if(typeof bw == "object" || typeof bc == "object") {
2047                    if (typeof bw !== "object") {
2048                        bw = {top: bw, right: bw, bottom: bw, left: bw};
2049                    }
2050                    if (typeof bc !== "object") {
2051                        bc = {top: bc, right: bc, bottom: bc, left: bc};
2052                    }
2053
2054                    if (bw.top > 0) {
2055                        ctx.strokeStyle = bc.top;
2056                        ctx.lineWidth = bw.top;
2057                        ctx.beginPath();
2058                        ctx.moveTo(0 - bw.left, 0 - bw.top/2);
2059                        ctx.lineTo(plotWidth, 0 - bw.top/2);
2060                        ctx.stroke();
2061                    }
2062
2063                    if (bw.right > 0) {
2064                        ctx.strokeStyle = bc.right;
2065                        ctx.lineWidth = bw.right;
2066                        ctx.beginPath();
2067                        ctx.moveTo(plotWidth + bw.right / 2, 0 - bw.top);
2068                        ctx.lineTo(plotWidth + bw.right / 2, plotHeight);
2069                        ctx.stroke();
2070                    }
2071
2072                    if (bw.bottom > 0) {
2073                        ctx.strokeStyle = bc.bottom;
2074                        ctx.lineWidth = bw.bottom;
2075                        ctx.beginPath();
2076                        ctx.moveTo(plotWidth + bw.right, plotHeight + bw.bottom / 2);
2077                        ctx.lineTo(0, plotHeight + bw.bottom / 2);
2078                        ctx.stroke();
2079                    }
2080
2081                    if (bw.left > 0) {
2082                        ctx.strokeStyle = bc.left;
2083                        ctx.lineWidth = bw.left;
2084                        ctx.beginPath();
2085                        ctx.moveTo(0 - bw.left/2, plotHeight + bw.bottom);
2086                        ctx.lineTo(0- bw.left/2, 0);
2087                        ctx.stroke();
2088                    }
2089                }
2090                else {
2091                    ctx.lineWidth = bw;
2092                    ctx.strokeStyle = options.grid.borderColor;
2093                    ctx.strokeRect(-bw/2, -bw/2, plotWidth + bw, plotHeight + bw);
2094                }
2095            }
2096
2097            ctx.restore();
2098        }
2099
2100        function drawAxisLabels() {
2101
2102            $.each(allAxes(), function (_, axis) {
2103                if (!axis.show || axis.ticks.length == 0)
2104                    return;
2105
2106                var box = axis.box,
2107                    legacyStyles = axis.direction + "Axis " + axis.direction + axis.n + "Axis",
2108                    layer = "flot-" + axis.direction + "-axis flot-" + axis.direction + axis.n + "-axis " + legacyStyles,
2109                    font = axis.options.font || "flot-tick-label tickLabel",
2110                    tick, x, y, halign, valign;
2111
2112                surface.removeText(layer);
2113
2114                for (var i = 0; i < axis.ticks.length; ++i) {
2115
2116                    tick = axis.ticks[i];
2117                    if (!tick.label || tick.v < axis.min || tick.v > axis.max)
2118                        continue;
2119
2120                    if (axis.direction == "x") {
2121                        halign = "center";
2122                        x = plotOffset.left + axis.p2c(tick.v);
2123                        if (axis.position == "bottom") {
2124                            y = box.top + box.padding;
2125                        } else {
2126                            y = box.top + box.height - box.padding;
2127                            valign = "bottom";
2128                        }
2129                    } else {
2130                        valign = "middle";
2131                        y = plotOffset.top + axis.p2c(tick.v);
2132                        if (axis.position == "left") {
2133                            x = box.left + box.width - box.padding;
2134                            halign = "right";
2135                        } else {
2136                            x = box.left + box.padding;
2137                        }
2138                    }
2139
2140                    surface.addText(layer, x, y, tick.label, font, null, null, halign, valign);
2141                }
2142            });
2143        }
2144
2145        function drawSeries(series) {
2146            if (series.lines.show)
2147                drawSeriesLines(series);
2148            if (series.bars.show)
2149                drawSeriesBars(series);
2150            if (series.points.show)
2151                drawSeriesPoints(series);
2152        }
2153
2154        function drawSeriesLines(series) {
2155            function plotLine(datapoints, xoffset, yoffset, axisx, axisy) {
2156                var points = datapoints.points,
2157                    ps = datapoints.pointsize,
2158                    prevx = null, prevy = null;
2159
2160                ctx.beginPath();
2161                for (var i = ps; i < points.length; i += ps) {
2162                    var x1 = points[i - ps], y1 = points[i - ps + 1],
2163                        x2 = points[i], y2 = points[i + 1];
2164
2165                    if (x1 == null || x2 == null)
2166                        continue;
2167
2168                    // clip with ymin
2169                    if (y1 <= y2 && y1 < axisy.min) {
2170                        if (y2 < axisy.min)
2171                            continue;   // line segment is outside
2172                        // compute new intersection point
2173                        x1 = (axisy.min - y1) / (y2 - y1) * (x2 - x1) + x1;
2174                        y1 = axisy.min;
2175                    }
2176                    else if (y2 <= y1 && y2 < axisy.min) {
2177                        if (y1 < axisy.min)
2178                            continue;
2179                        x2 = (axisy.min - y1) / (y2 - y1) * (x2 - x1) + x1;
2180                        y2 = axisy.min;
2181                    }
2182
2183                    // clip with ymax
2184                    if (y1 >= y2 && y1 > axisy.max) {
2185                        if (y2 > axisy.max)
2186                            continue;
2187                        x1 = (axisy.max - y1) / (y2 - y1) * (x2 - x1) + x1;
2188                        y1 = axisy.max;
2189                    }
2190                    else if (y2 >= y1 && y2 > axisy.max) {
2191                        if (y1 > axisy.max)
2192                            continue;
2193                        x2 = (axisy.max - y1) / (y2 - y1) * (x2 - x1) + x1;
2194                        y2 = axisy.max;
2195                    }
2196
2197                    // clip with xmin
2198                    if (x1 <= x2 && x1 < axisx.min) {
2199                        if (x2 < axisx.min)
2200                            continue;
2201                        y1 = (axisx.min - x1) / (x2 - x1) * (y2 - y1) + y1;
2202                        x1 = axisx.min;
2203                    }
2204                    else if (x2 <= x1 && x2 < axisx.min) {
2205                        if (x1 < axisx.min)
2206                            continue;
2207                        y2 = (axisx.min - x1) / (x2 - x1) * (y2 - y1) + y1;
2208                        x2 = axisx.min;
2209                    }
2210
2211                    // clip with xmax
2212                    if (x1 >= x2 && x1 > axisx.max) {
2213                        if (x2 > axisx.max)
2214                            continue;
2215                        y1 = (axisx.max - x1) / (x2 - x1) * (y2 - y1) + y1;
2216                        x1 = axisx.max;
2217                    }
2218                    else if (x2 >= x1 && x2 > axisx.max) {
2219                        if (x1 > axisx.max)
2220                            continue;
2221                        y2 = (axisx.max - x1) / (x2 - x1) * (y2 - y1) + y1;
2222                        x2 = axisx.max;
2223                    }
2224
2225                    if (x1 != prevx || y1 != prevy)
2226                        ctx.moveTo(axisx.p2c(x1) + xoffset, axisy.p2c(y1) + yoffset);
2227
2228                    prevx = x2;
2229                    prevy = y2;
2230                    ctx.lineTo(axisx.p2c(x2) + xoffset, axisy.p2c(y2) + yoffset);
2231                }
2232                ctx.stroke();
2233            }
2234
2235            function plotLineArea(datapoints, axisx, axisy) {
2236                var points = datapoints.points,
2237                    ps = datapoints.pointsize,
2238                    bottom = Math.min(Math.max(0, axisy.min), axisy.max),
2239                    i = 0, top, areaOpen = false,
2240                    ypos = 1, segmentStart = 0, segmentEnd = 0;
2241
2242                // we process each segment in two turns, first forward
2243                // direction to sketch out top, then once we hit the
2244                // end we go backwards to sketch the bottom
2245                while (true) {
2246                    if (ps > 0 && i > points.length + ps)
2247                        break;
2248
2249                    i += ps; // ps is negative if going backwards
2250
2251                    var x1 = points[i - ps],
2252                        y1 = points[i - ps + ypos],
2253                        x2 = points[i], y2 = points[i + ypos];
2254
2255                    if (areaOpen) {
2256                        if (ps > 0 && x1 != null && x2 == null) {
2257                            // at turning point
2258                            segmentEnd = i;
2259                            ps = -ps;
2260                            ypos = 2;
2261                            continue;
2262                        }
2263
2264                        if (ps < 0 && i == segmentStart + ps) {
2265                            // done with the reverse sweep
2266                            ctx.fill();
2267                            areaOpen = false;
2268                            ps = -ps;
2269                            ypos = 1;
2270                            i = segmentStart = segmentEnd + ps;
2271                            continue;
2272                        }
2273                    }
2274
2275                    if (x1 == null || x2 == null)
2276                        continue;
2277
2278                    // clip x values
2279
2280                    // clip with xmin
2281                    if (x1 <= x2 && x1 < axisx.min) {
2282                        if (x2 < axisx.min)
2283                            continue;
2284                        y1 = (axisx.min - x1) / (x2 - x1) * (y2 - y1) + y1;
2285                        x1 = axisx.min;
2286                    }
2287                    else if (x2 <= x1 && x2 < axisx.min) {
2288                        if (x1 < axisx.min)
2289                            continue;
2290                        y2 = (axisx.min - x1) / (x2 - x1) * (y2 - y1) + y1;
2291                        x2 = axisx.min;
2292                    }
2293
2294                    // clip with xmax
2295                    if (x1 >= x2 && x1 > axisx.max) {
2296                        if (x2 > axisx.max)
2297                            continue;
2298                        y1 = (axisx.max - x1) / (x2 - x1) * (y2 - y1) + y1;
2299                        x1 = axisx.max;
2300                    }
2301                    else if (x2 >= x1 && x2 > axisx.max) {
2302                        if (x1 > axisx.max)
2303                            continue;
2304                        y2 = (axisx.max - x1) / (x2 - x1) * (y2 - y1) + y1;
2305                        x2 = axisx.max;
2306                    }
2307
2308                    if (!areaOpen) {
2309                        // open area
2310                        ctx.beginPath();
2311                        ctx.moveTo(axisx.p2c(x1), axisy.p2c(bottom));
2312                        areaOpen = true;
2313                    }
2314
2315                    // now first check the case where both is outside
2316                    if (y1 >= axisy.max && y2 >= axisy.max) {
2317                        ctx.lineTo(axisx.p2c(x1), axisy.p2c(axisy.max));
2318                        ctx.lineTo(axisx.p2c(x2), axisy.p2c(axisy.max));
2319                        continue;
2320                    }
2321                    else if (y1 <= axisy.min && y2 <= axisy.min) {
2322                        ctx.lineTo(axisx.p2c(x1), axisy.p2c(axisy.min));
2323                        ctx.lineTo(axisx.p2c(x2), axisy.p2c(axisy.min));
2324                        continue;
2325                    }
2326
2327                    // else it's a bit more complicated, there might
2328                    // be a flat maxed out rectangle first, then a
2329                    // triangular cutout or reverse; to find these
2330                    // keep track of the current x values
2331                    var x1old = x1, x2old = x2;
2332
2333                    // clip the y values, without shortcutting, we
2334                    // go through all cases in turn
2335
2336                    // clip with ymin
2337                    if (y1 <= y2 && y1 < axisy.min && y2 >= axisy.min) {
2338                        x1 = (axisy.min - y1) / (y2 - y1) * (x2 - x1) + x1;
2339                        y1 = axisy.min;
2340                    }
2341                    else if (y2 <= y1 && y2 < axisy.min && y1 >= axisy.min) {
2342                        x2 = (axisy.min - y1) / (y2 - y1) * (x2 - x1) + x1;
2343                        y2 = axisy.min;
2344                    }
2345
2346                    // clip with ymax
2347                    if (y1 >= y2 && y1 > axisy.max && y2 <= axisy.max) {
2348                        x1 = (axisy.max - y1) / (y2 - y1) * (x2 - x1) + x1;
2349                        y1 = axisy.max;
2350                    }
2351                    else if (y2 >= y1 && y2 > axisy.max && y1 <= axisy.max) {
2352                        x2 = (axisy.max - y1) / (y2 - y1) * (x2 - x1) + x1;
2353                        y2 = axisy.max;
2354                    }
2355
2356                    // if the x value was changed we got a rectangle
2357                    // to fill
2358                    if (x1 != x1old) {
2359                        ctx.lineTo(axisx.p2c(x1old), axisy.p2c(y1));
2360                        // it goes to (x1, y1), but we fill that below
2361                    }
2362
2363                    // fill triangular section, this sometimes result
2364                    // in redundant points if (x1, y1) hasn't changed
2365                    // from previous line to, but we just ignore that
2366                    ctx.lineTo(axisx.p2c(x1), axisy.p2c(y1));
2367                    ctx.lineTo(axisx.p2c(x2), axisy.p2c(y2));
2368
2369                    // fill the other rectangle if it's there
2370                    if (x2 != x2old) {
2371                        ctx.lineTo(axisx.p2c(x2), axisy.p2c(y2));
2372                        ctx.lineTo(axisx.p2c(x2old), axisy.p2c(y2));
2373                    }
2374                }
2375            }
2376
2377            ctx.save();
2378            ctx.translate(plotOffset.left, plotOffset.top);
2379            ctx.lineJoin = "round";
2380
2381            var lw = series.lines.lineWidth,
2382                sw = series.shadowSize;
2383            // FIXME: consider another form of shadow when filling is turned on
2384            if (lw > 0 && sw > 0) {
2385                // draw shadow as a thick and thin line with transparency
2386                ctx.lineWidth = sw;
2387                ctx.strokeStyle = "rgba(0,0,0,0.1)";
2388                // position shadow at angle from the mid of line
2389                var angle = Math.PI/18;
2390                plotLine(series.datapoints, Math.sin(angle) * (lw/2 + sw/2), Math.cos(angle) * (lw/2 + sw/2), series.xaxis, series.yaxis);
2391                ctx.lineWidth = sw/2;
2392                plotLine(series.datapoints, Math.sin(angle) * (lw/2 + sw/4), Math.cos(angle) * (lw/2 + sw/4), series.xaxis, series.yaxis);
2393            }
2394
2395            ctx.lineWidth = lw;
2396            ctx.strokeStyle = series.color;
2397            var fillStyle = getFillStyle(series.lines, series.color, 0, plotHeight);
2398            if (fillStyle) {
2399                ctx.fillStyle = fillStyle;
2400                plotLineArea(series.datapoints, series.xaxis, series.yaxis);
2401            }
2402
2403            if (lw > 0)
2404                plotLine(series.datapoints, 0, 0, series.xaxis, series.yaxis);
2405            ctx.restore();
2406        }
2407
2408        function drawSeriesPoints(series) {
2409            function plotPoints(datapoints, radius, fillStyle, offset, shadow, axisx, axisy, symbol) {
2410                var points = datapoints.points, ps = datapoints.pointsize;
2411
2412                for (var i = 0; i < points.length; i += ps) {
2413                    var x = points[i], y = points[i + 1];
2414                    if (x == null || x < axisx.min || x > axisx.max || y < axisy.min || y > axisy.max)
2415                        continue;
2416
2417                    ctx.beginPath();
2418                    x = axisx.p2c(x);
2419                    y = axisy.p2c(y) + offset;
2420                    if (symbol == "circle")
2421                        ctx.arc(x, y, radius, 0, shadow ? Math.PI : Math.PI * 2, false);
2422                    else
2423                        symbol(ctx, x, y, radius, shadow);
2424                    ctx.closePath();
2425
2426                    if (fillStyle) {
2427                        ctx.fillStyle = fillStyle;
2428                        ctx.fill();
2429                    }
2430                    ctx.stroke();
2431                }
2432            }
2433
2434            ctx.save();
2435            ctx.translate(plotOffset.left, plotOffset.top);
2436
2437            var lw = series.points.lineWidth,
2438                sw = series.shadowSize,
2439                radius = series.points.radius,
2440                symbol = series.points.symbol;
2441
2442            // If the user sets the line width to 0, we change it to a very
2443            // small value. A line width of 0 seems to force the default of 1.
2444            // Doing the conditional here allows the shadow setting to still be
2445            // optional even with a lineWidth of 0.
2446
2447            if( lw == 0 )
2448                lw = 0.0001;
2449
2450            if (lw > 0 && sw > 0) {
2451                // draw shadow in two steps
2452                var w = sw / 2;
2453                ctx.lineWidth = w;
2454                ctx.strokeStyle = "rgba(0,0,0,0.1)";
2455                plotPoints(series.datapoints, radius, null, w + w/2, true,
2456                           series.xaxis, series.yaxis, symbol);
2457
2458                ctx.strokeStyle = "rgba(0,0,0,0.2)";
2459                plotPoints(series.datapoints, radius, null, w/2, true,
2460                           series.xaxis, series.yaxis, symbol);
2461            }
2462
2463            ctx.lineWidth = lw;
2464            ctx.strokeStyle = series.color;
2465            plotPoints(series.datapoints, radius,
2466                       getFillStyle(series.points, series.color), 0, false,
2467                       series.xaxis, series.yaxis, symbol);
2468            ctx.restore();
2469        }
2470
2471        function drawBar(x, y, b, barLeft, barRight, offset, fillStyleCallback, axisx, axisy, c, horizontal, lineWidth) {
2472            var left, right, bottom, top,
2473                drawLeft, drawRight, drawTop, drawBottom,
2474                tmp;
2475
2476            // in horizontal mode, we start the bar from the left
2477            // instead of from the bottom so it appears to be
2478            // horizontal rather than vertical
2479            if (horizontal) {
2480                drawBottom = drawRight = drawTop = true;
2481                drawLeft = false;
2482                left = b;
2483                right = x;
2484                top = y + barLeft;
2485                bottom = y + barRight;
2486
2487                // account for negative bars
2488                if (right < left) {
2489                    tmp = right;
2490                    right = left;
2491                    left = tmp;
2492                    drawLeft = true;
2493                    drawRight = false;
2494                }
2495            }
2496            else {
2497                drawLeft = drawRight = drawTop = true;
2498                drawBottom = false;
2499                left = x + barLeft;
2500                right = x + barRight;
2501                bottom = b;
2502                top = y;
2503
2504                // account for negative bars
2505                if (top < bottom) {
2506                    tmp = top;
2507                    top = bottom;
2508                    bottom = tmp;
2509                    drawBottom = true;
2510                    drawTop = false;
2511                }
2512            }
2513
2514            // clip
2515            if (right < axisx.min || left > axisx.max ||
2516                top < axisy.min || bottom > axisy.max)
2517                return;
2518
2519            if (left < axisx.min) {
2520                left = axisx.min;
2521                drawLeft = false;
2522            }
2523
2524            if (right > axisx.max) {
2525                right = axisx.max;
2526                drawRight = false;
2527            }
2528
2529            if (bottom < axisy.min) {
2530                bottom = axisy.min;
2531                drawBottom = false;
2532            }
2533
2534            if (top > axisy.max) {
2535                top = axisy.max;
2536                drawTop = false;
2537            }
2538
2539            left = axisx.p2c(left);
2540            bottom = axisy.p2c(bottom);
2541            right = axisx.p2c(right);
2542            top = axisy.p2c(top);
2543
2544            // fill the bar
2545            if (fillStyleCallback) {
2546                c.beginPath();
2547                c.moveTo(left, bottom);
2548                c.lineTo(left, top);
2549                c.lineTo(right, top);
2550                c.lineTo(right, bottom);
2551                c.fillStyle = fillStyleCallback(bottom, top);
2552                c.fill();
2553            }
2554
2555            // draw outline
2556            if (lineWidth > 0 && (drawLeft || drawRight || drawTop || drawBottom)) {
2557                c.beginPath();
2558
2559                // FIXME: inline moveTo is buggy with excanvas
2560                c.moveTo(left, bottom + offset);
2561                if (drawLeft)
2562                    c.lineTo(left, top + offset);
2563                else
2564                    c.moveTo(left, top + offset);
2565                if (drawTop)
2566                    c.lineTo(right, top + offset);
2567                else
2568                    c.moveTo(right, top + offset);
2569                if (drawRight)
2570                    c.lineTo(right, bottom + offset);
2571                else
2572                    c.moveTo(right, bottom + offset);
2573                if (drawBottom)
2574                    c.lineTo(left, bottom + offset);
2575                else
2576                    c.moveTo(left, bottom + offset);
2577                c.stroke();
2578            }
2579        }
2580
2581        function drawSeriesBars(series) {
2582            function plotBars(datapoints, barLeft, barRight, offset, fillStyleCallback, axisx, axisy) {
2583                var points = datapoints.points, ps = datapoints.pointsize;
2584
2585                for (var i = 0; i < points.length; i += ps) {
2586                    if (points[i] == null)
2587                        continue;
2588                    drawBar(points[i], points[i + 1], points[i + 2], barLeft, barRight, offset, fillStyleCallback, axisx, axisy, ctx, series.bars.horizontal, series.bars.lineWidth);
2589                }
2590            }
2591
2592            ctx.save();
2593            ctx.translate(plotOffset.left, plotOffset.top);
2594
2595            // FIXME: figure out a way to add shadows (for instance along the right edge)
2596            ctx.lineWidth = series.bars.lineWidth;
2597            ctx.strokeStyle = series.color;
2598
2599            var barLeft;
2600
2601            switch (series.bars.align) {
2602                case "left":
2603                    barLeft = 0;
2604                    break;
2605                case "right":
2606                    barLeft = -series.bars.barWidth;
2607                    break;
2608                case "center":
2609                    barLeft = -series.bars.barWidth / 2;
2610                    break;
2611                default:
2612                    throw new Error("Invalid bar alignment: " + series.bars.align);
2613            }
2614
2615            var fillStyleCallback = series.bars.fill ? function (bottom, top) { return getFillStyle(series.bars, series.color, bottom, top); } : null;
2616            plotBars(series.datapoints, barLeft, barLeft + series.bars.barWidth, 0, fillStyleCallback, series.xaxis, series.yaxis);
2617            ctx.restore();
2618        }
2619
2620        function getFillStyle(filloptions, seriesColor, bottom, top) {
2621            var fill = filloptions.fill;
2622            if (!fill)
2623                return null;
2624
2625            if (filloptions.fillColor)
2626                return getColorOrGradient(filloptions.fillColor, bottom, top, seriesColor);
2627
2628            var c = $.color.parse(seriesColor);
2629            c.a = typeof fill == "number" ? fill : 0.4;
2630            c.normalize();
2631            return c.toString();
2632        }
2633
2634        function insertLegend() {
2635
2636            placeholder.find(".legend").remove();
2637
2638            if (!options.legend.show)
2639                return;
2640
2641            var fragments = [], entries = [], rowStarted = false,
2642                lf = options.legend.labelFormatter, s, label;
2643
2644            // Build a list of legend entries, with each having a label and a color
2645
2646            for (var i = 0; i < series.length; ++i) {
2647                s = series[i];
2648                if (s.label) {
2649                    label = lf ? lf(s.label, s) : s.label;
2650                    if (label) {
2651                        entries.push({
2652                            label: label,
2653                            color: s.color
2654                        });
2655                    }
2656                }
2657            }
2658
2659            // Sort the legend using either the default or a custom comparator
2660
2661            if (options.legend.sorted) {
2662                if ($.isFunction(options.legend.sorted)) {
2663                    entries.sort(options.legend.sorted);
2664                } else if (options.legend.sorted == "reverse") {
2665                        entries.reverse();
2666                } else {
2667                    var ascending = options.legend.sorted != "descending";
2668                    entries.sort(function(a, b) {
2669                        return a.label == b.label ? 0 : (
2670                            (a.label < b.label) != ascending ? 1 : -1   // Logical XOR
2671                        );
2672                    });
2673                }
2674            }
2675
2676            // Generate markup for the list of entries, in their final order
2677
2678            for (var i = 0; i < entries.length; ++i) {
2679
2680                var entry = entries[i];
2681
2682                if (i % options.legend.noColumns == 0) {
2683                    if (rowStarted)
2684                        fragments.push('</tr>');
2685                    fragments.push('<tr>');
2686                    rowStarted = true;
2687                }
2688
2689                fragments.push(
2690                    '<td class="legendColorBox"><div style="border:1px solid ' + options.legend.labelBoxBorderColor + ';padding:1px"><div style="width:4px;height:0;border:5px solid ' + entry.color + ';overflow:hidden"></div></div></td>' +
2691                    '<td class="legendLabel">' + entry.label + '</td>'
2692                );
2693            }
2694
2695            if (rowStarted)
2696                fragments.push('</tr>');
2697
2698            if (fragments.length == 0)
2699                return;
2700
2701            var table = '<table style="font-size:smaller;color:' + options.grid.color + '">' + fragments.join("") + '</table>';
2702            if (options.legend.container != null)
2703                $(options.legend.container).html(table);
2704            else {
2705                var pos = "",
2706                    p = options.legend.position,
2707                    m = options.legend.margin;
2708                if (m[0] == null)
2709                    m = [m, m];
2710                if (p.charAt(0) == "n")
2711                    pos += 'top:' + (m[1] + plotOffset.top) + 'px;';
2712                else if (p.charAt(0) == "s")
2713                    pos += 'bottom:' + (m[1] + plotOffset.bottom) + 'px;';
2714                if (p.charAt(1) == "e")
2715                    pos += 'right:' + (m[0] + plotOffset.right) + 'px;';
2716                else if (p.charAt(1) == "w")
2717                    pos += 'left:' + (m[0] + plotOffset.left) + 'px;';
2718                var legend = $('<div class="legend">' + table.replace('style="', 'style="position:absolute;' + pos +';') + '</div>').appendTo(placeholder);
2719                if (options.legend.backgroundOpacity != 0.0) {
2720                    // put in the transparent background
2721                    // separately to avoid blended labels and
2722                    // label boxes
2723                    var c = options.legend.backgroundColor;
2724                    if (c == null) {
2725                        c = options.grid.backgroundColor;
2726                        if (c && typeof c == "string")
2727                            c = $.color.parse(c);
2728                        else
2729                            c = $.color.extract(legend, 'background-color');
2730                        c.a = 1;
2731                        c = c.toString();
2732                    }
2733                    var div = legend.children();
2734                    $('<div style="position:absolute;width:' + div.width() + 'px;height:' + div.height() + 'px;' + pos +'background-color:' + c + ';"> </div>').prependTo(legend).css('opacity', options.legend.backgroundOpacity);
2735                }
2736            }
2737        }
2738
2739
2740        // interactive features
2741
2742        var highlights = [],
2743            redrawTimeout = null;
2744
2745        // returns the data item the mouse is over, or null if none is found
2746        function findNearbyItem(mouseX, mouseY, seriesFilter) {
2747            var maxDistance = options.grid.mouseActiveRadius,
2748                smallestDistance = maxDistance * maxDistance + 1,
2749                item = null, foundPoint = false, i, j, ps;
2750
2751            for (i = series.length - 1; i >= 0; --i) {
2752                if (!seriesFilter(series[i]))
2753                    continue;
2754
2755                var s = series[i],
2756                    axisx = s.xaxis,
2757                    axisy = s.yaxis,
2758                    points = s.datapoints.points,
2759                    mx = axisx.c2p(mouseX), // precompute some stuff to make the loop faster
2760                    my = axisy.c2p(mouseY),
2761                    maxx = maxDistance / axisx.scale,
2762                    maxy = maxDistance / axisy.scale;
2763
2764                ps = s.datapoints.pointsize;
2765                // with inverse transforms, we can't use the maxx/maxy
2766                // optimization, sadly
2767                if (axisx.options.inverseTransform)
2768                    maxx = Number.MAX_VALUE;
2769                if (axisy.options.inverseTransform)
2770                    maxy = Number.MAX_VALUE;
2771
2772                if (s.lines.show || s.points.show) {
2773                    for (j = 0; j < points.length; j += ps) {
2774                        var x = points[j], y = points[j + 1];
2775                        if (x == null)
2776                            continue;
2777
2778                        // For points and lines, the cursor must be within a
2779                        // certain distance to the data point
2780                        if (x - mx > maxx || x - mx < -maxx ||
2781                            y - my > maxy || y - my < -maxy)
2782                            continue;
2783
2784                        // We have to calculate distances in pixels, not in
2785                        // data units, because the scales of the axes may be different
2786                        var dx = Math.abs(axisx.p2c(x) - mouseX),
2787                            dy = Math.abs(axisy.p2c(y) - mouseY),
2788                            dist = dx * dx + dy * dy; // we save the sqrt
2789
2790                        // use <= to ensure last point takes precedence
2791                        // (last generally means on top of)
2792                        if (dist < smallestDistance) {
2793                            smallestDistance = dist;
2794                            item = [i, j / ps];
2795                        }
2796                    }
2797                }
2798
2799                if (s.bars.show && !item) { // no other point can be nearby
2800                    var barLeft = s.bars.align == "left" ? 0 : -s.bars.barWidth/2,
2801                        barRight = barLeft + s.bars.barWidth;
2802
2803                    for (j = 0; j < points.length; j += ps) {
2804                        var x = points[j], y = points[j + 1], b = points[j + 2];
2805                        if (x == null)
2806                            continue;
2807
2808                        // for a bar graph, the cursor must be inside the bar
2809                        if (series[i].bars.horizontal ?
2810                            (mx <= Math.max(b, x) && mx >= Math.min(b, x) &&
2811                             my >= y + barLeft && my <= y + barRight) :
2812                            (mx >= x + barLeft && mx <= x + barRight &&
2813                             my >= Math.min(b, y) && my <= Math.max(b, y)))
2814                                item = [i, j / ps];
2815                    }
2816                }
2817            }
2818
2819            if (item) {
2820                i = item[0];
2821                j = item[1];
2822                ps = series[i].datapoints.pointsize;
2823
2824                return { datapoint: series[i].datapoints.points.slice(j * ps, (j + 1) * ps),
2825                         dataIndex: j,
2826                         series: series[i],
2827                         seriesIndex: i };
2828            }
2829
2830            return null;
2831        }
2832
2833        function onMouseMove(e) {
2834            if (options.grid.hoverable)
2835                triggerClickHoverEvent("plothover", e,
2836                                       function (s) { return s["hoverable"] != false; });
2837        }
2838
2839        function onMouseLeave(e) {
2840            if (options.grid.hoverable)
2841                triggerClickHoverEvent("plothover", e,
2842                                       function (s) { return false; });
2843        }
2844
2845        function onClick(e) {
2846            triggerClickHoverEvent("plotclick", e,
2847                                   function (s) { return s["clickable"] != false; });
2848        }
2849
2850        // trigger click or hover event (they send the same parameters
2851        // so we share their code)
2852        function triggerClickHoverEvent(eventname, event, seriesFilter) {
2853            var offset = eventHolder.offset(),
2854                canvasX = event.pageX - offset.left - plotOffset.left,
2855                canvasY = event.pageY - offset.top - plotOffset.top,
2856            pos = canvasToAxisCoords({ left: canvasX, top: canvasY });
2857
2858            pos.pageX = event.pageX;
2859            pos.pageY = event.pageY;
2860
2861            var item = findNearbyItem(canvasX, canvasY, seriesFilter);
2862
2863            if (item) {
2864                // fill in mouse pos for any listeners out there
2865                item.pageX = parseInt(item.series.xaxis.p2c(item.datapoint[0]) + offset.left + plotOffset.left, 10);
2866                item.pageY = parseInt(item.series.yaxis.p2c(item.datapoint[1]) + offset.top + plotOffset.top, 10);
2867            }
2868
2869            if (options.grid.autoHighlight) {
2870                // clear auto-highlights
2871                for (var i = 0; i < highlights.length; ++i) {
2872                    var h = highlights[i];
2873                    if (h.auto == eventname &&
2874                        !(item && h.series == item.series &&
2875                          h.point[0] == item.datapoint[0] &&
2876                          h.point[1] == item.datapoint[1]))
2877                        unhighlight(h.series, h.point);
2878                }
2879
2880                if (item)
2881                    highlight(item.series, item.datapoint, eventname);
2882            }
2883
2884            placeholder.trigger(eventname, [ pos, item ]);
2885        }
2886
2887        function triggerRedrawOverlay() {
2888            var t = options.interaction.redrawOverlayInterval;
2889            if (t == -1) {      // skip event queue
2890                drawOverlay();
2891                return;
2892            }
2893
2894            if (!redrawTimeout)
2895                redrawTimeout = setTimeout(drawOverlay, t);
2896        }
2897
2898        function drawOverlay() {
2899            redrawTimeout = null;
2900
2901            // draw highlights
2902            octx.save();
2903            overlay.clear();
2904            octx.translate(plotOffset.left, plotOffset.top);
2905
2906            var i, hi;
2907            for (i = 0; i < highlights.length; ++i) {
2908                hi = highlights[i];
2909
2910                if (hi.series.bars.show)
2911                    drawBarHighlight(hi.series, hi.point);
2912                else
2913                    drawPointHighlight(hi.series, hi.point);
2914            }
2915            octx.restore();
2916
2917            executeHooks(hooks.drawOverlay, [octx]);
2918        }
2919
2920        function highlight(s, point, auto) {
2921            if (typeof s == "number")
2922                s = series[s];
2923
2924            if (typeof point == "number") {
2925                var ps = s.datapoints.pointsize;
2926                point = s.datapoints.points.slice(ps * point, ps * (point + 1));
2927            }
2928
2929            var i = indexOfHighlight(s, point);
2930            if (i == -1) {
2931                highlights.push({ series: s, point: point, auto: auto });
2932
2933                triggerRedrawOverlay();
2934            }
2935            else if (!auto)
2936                highlights[i].auto = false;
2937        }
2938
2939        function unhighlight(s, point) {
2940            if (s == null && point == null) {
2941                highlights = [];
2942                triggerRedrawOverlay();
2943                return;
2944            }
2945
2946            if (typeof s == "number")
2947                s = series[s];
2948
2949            if (typeof point == "number") {
2950                var ps = s.datapoints.pointsize;
2951                point = s.datapoints.points.slice(ps * point, ps * (point + 1));
2952            }
2953
2954            var i = indexOfHighlight(s, point);
2955            if (i != -1) {
2956                highlights.splice(i, 1);
2957
2958                triggerRedrawOverlay();
2959            }
2960        }
2961
2962        function indexOfHighlight(s, p) {
2963            for (var i = 0; i < highlights.length; ++i) {
2964                var h = highlights[i];
2965                if (h.series == s && h.point[0] == p[0]
2966                    && h.point[1] == p[1])
2967                    return i;
2968            }
2969            return -1;
2970        }
2971
2972        function drawPointHighlight(series, point) {
2973            var x = point[0], y = point[1],
2974                axisx = series.xaxis, axisy = series.yaxis,
2975                highlightColor = (typeof series.highlightColor === "string") ? series.highlightColor : $.color.parse(series.color).scale('a', 0.5).toString();
2976
2977            if (x < axisx.min || x > axisx.max || y < axisy.min || y > axisy.max)
2978                return;
2979
2980            var pointRadius = series.points.radius + series.points.lineWidth / 2;
2981            octx.lineWidth = pointRadius;
2982            octx.strokeStyle = highlightColor;
2983            var radius = 1.5 * pointRadius;
2984            x = axisx.p2c(x);
2985            y = axisy.p2c(y);
2986
2987            octx.beginPath();
2988            if (series.points.symbol == "circle")
2989                octx.arc(x, y, radius, 0, 2 * Math.PI, false);
2990            else
2991                series.points.symbol(octx, x, y, radius, false);
2992            octx.closePath();
2993            octx.stroke();
2994        }
2995
2996        function drawBarHighlight(series, point) {
2997            var highlightColor = (typeof series.highlightColor === "string") ? series.highlightColor : $.color.parse(series.color).scale('a', 0.5).toString(),
2998                fillStyle = highlightColor,
2999                barLeft = series.bars.align == "left" ? 0 : -series.bars.barWidth/2;
3000
3001            octx.lineWidth = series.bars.lineWidth;
3002            octx.strokeStyle = highlightColor;
3003
3004            drawBar(point[0], point[1], point[2] || 0, barLeft, barLeft + series.bars.barWidth,
3005                    0, function () { return fillStyle; }, series.xaxis, series.yaxis, octx, series.bars.horizontal, series.bars.lineWidth);
3006        }
3007
3008        function getColorOrGradient(spec, bottom, top, defaultColor) {
3009            if (typeof spec == "string")
3010                return spec;
3011            else {
3012                // assume this is a gradient spec; IE currently only
3013                // supports a simple vertical gradient properly, so that's
3014                // what we support too
3015                var gradient = ctx.createLinearGradient(0, top, 0, bottom);
3016
3017                for (var i = 0, l = spec.colors.length; i < l; ++i) {
3018                    var c = spec.colors[i];
3019                    if (typeof c != "string") {
3020                        var co = $.color.parse(defaultColor);
3021                        if (c.brightness != null)
3022                            co = co.scale('rgb', c.brightness);
3023                        if (c.opacity != null)
3024                            co.a *= c.opacity;
3025                        c = co.toString();
3026                    }
3027                    gradient.addColorStop(i / (l - 1), c);
3028                }
3029
3030                return gradient;
3031            }
3032        }
3033    }
3034
3035    // Add the plot function to the top level of the jQuery object
3036
3037    $.plot = function(placeholder, data, options) {
3038        //var t0 = new Date();
3039        var plot = new Plot($(placeholder), data, options, $.plot.plugins);
3040        //(window.console ? console.log : alert)("time used (msecs): " + ((new Date()).getTime() - t0.getTime()));
3041        return plot;
3042    };
3043
3044    $.plot.version = "0.8.1";
3045
3046    $.plot.plugins = [];
3047
3048    // Also add the plot function as a chainable property
3049
3050    $.fn.plot = function(data, options) {
3051        return this.each(function() {
3052            $.plot(this, data, options);
3053        });
3054    };
3055
3056    // round to nearby lower multiple of base
3057    function floorInBase(n, base) {
3058        return base * Math.floor(n / base);
3059    }
3060
3061})(jQuery);
Note: See TracBrowser for help on using the repository browser.