Merge pull request #229 from clocksmith/master
[dygraphs.git] / dygraph-canvas.js
CommitLineData
88e95c46
DV
1/**
2 * @license
3 * Copyright 2006 Dan Vanderkam (danvdk@gmail.com)
4 * MIT-licensed (http://opensource.org/licenses/MIT)
5 */
6a1aa64f
DV
6
7/**
74a5af31
DV
8 * @fileoverview Based on PlotKit.CanvasRenderer, but modified to meet the
9 * needs of dygraphs.
10 *
3df0ccf0 11 * In particular, support for:
0abfbd7e 12 * - grid overlays
3df0ccf0
DV
13 * - error bars
14 * - dygraphs attribute system
6a1aa64f
DV
15 */
16
6a1aa64f 17/**
423f5ed3
DV
18 * The DygraphCanvasRenderer class does the actual rendering of the chart onto
19 * a canvas. It's based on PlotKit.CanvasRenderer.
6a1aa64f 20 * @param {Object} element The canvas to attach to
2cf95fff
RK
21 * @param {Object} elementContext The 2d context of the canvas (injected so it
22 * can be mocked for testing.)
285a6bda 23 * @param {Layout} layout The DygraphLayout object for this graph.
74a5af31 24 * @constructor
6a1aa64f 25 */
c0f54d4f 26
758a629f 27/*jshint globalstrict: true */
a96b8ba3 28/*global Dygraph:false,RGBColorParser:false */
c0f54d4f
DV
29"use strict";
30
79253bd0 31
8cfe592f
DV
32/**
33 * @constructor
34 *
35 * This gets called when there are "new points" to chart. This is generally the
36 * case when the underlying data being charted has changed. It is _not_ called
37 * in the common case that the user has zoomed or is panning the view.
38 *
39 * The chart canvas has already been created by the Dygraph object. The
40 * renderer simply gets a drawing context.
41 *
42 * @param {Dyraph} dygraph The chart to which this renderer belongs.
43 * @param {Canvas} element The <canvas> DOM element on which to draw.
44 * @param {CanvasRenderingContext2D} elementContext The drawing context.
45 * @param {DygraphLayout} layout The chart's DygraphLayout object.
46 *
47 * TODO(danvk): remove the elementContext property.
48 */
c0f54d4f 49var DygraphCanvasRenderer = function(dygraph, element, elementContext, layout) {
9317362d 50 this.dygraph_ = dygraph;
fbe31dc8 51
fbe31dc8 52 this.layout = layout;
b0c3b730 53 this.element = element;
2cf95fff 54 this.elementContext = elementContext;
fbe31dc8
DV
55 this.container = this.element.parentNode;
56
fbe31dc8
DV
57 this.height = this.element.height;
58 this.width = this.element.width;
59
60 // --- check whether everything is ok before we return
61 if (!this.isIE && !(DygraphCanvasRenderer.isSupported(this.element)))
62 throw "Canvas is not supported.";
63
64 // internal state
70be5ed1 65 this.area = layout.getPlotArea();
423f5ed3
DV
66 this.container.style.position = "relative";
67 this.container.style.width = this.width + "px";
68
69 // Set up a clipping area for the canvas (and the interaction canvas).
70 // This ensures that we don't overdraw.
920208fb
PF
71 if (this.dygraph_.isUsingExcanvas_) {
72 this._createIEClipArea();
73 } else {
971870e5
DV
74 // on Android 3 and 4, setting a clipping area on a canvas prevents it from
75 // displaying anything.
76 if (!Dygraph.isAndroid()) {
77 var ctx = this.dygraph_.canvas_ctx_;
78 ctx.beginPath();
79 ctx.rect(this.area.x, this.area.y, this.area.w, this.area.h);
80 ctx.clip();
920208fb 81
971870e5
DV
82 ctx = this.dygraph_.hidden_ctx_;
83 ctx.beginPath();
84 ctx.rect(this.area.x, this.area.y, this.area.w, this.area.h);
85 ctx.clip();
86 }
920208fb 87 }
423f5ed3
DV
88};
89
38e3d209
DV
90/**
91 * This just forwards to dygraph.attr_.
92 * TODO(danvk): remove this?
93 * @private
94 */
95DygraphCanvasRenderer.prototype.attr_ = function(name, opt_seriesName) {
96 return this.dygraph_.attr_(name, opt_seriesName);
423f5ed3
DV
97};
98
8cfe592f
DV
99/**
100 * Clears out all chart content and DOM elements.
101 * This is called immediately before render() on every frame, including
102 * during zooms and pans.
103 * @private
104 */
fbe31dc8 105DygraphCanvasRenderer.prototype.clear = function() {
758a629f 106 var context;
fbe31dc8
DV
107 if (this.isIE) {
108 // VML takes a while to start up, so we just poll every this.IEDelay
109 try {
110 if (this.clearDelay) {
111 this.clearDelay.cancel();
112 this.clearDelay = null;
113 }
758a629f 114 context = this.elementContext;
fbe31dc8
DV
115 }
116 catch (e) {
76171648 117 // TODO(danvk): this is broken, since MochiKit.Async is gone.
758a629f
DV
118 // this.clearDelay = MochiKit.Async.wait(this.IEDelay);
119 // this.clearDelay.addCallback(bind(this.clear, this));
fbe31dc8
DV
120 return;
121 }
122 }
123
758a629f 124 context = this.elementContext;
fbe31dc8 125 context.clearRect(0, 0, this.width, this.height);
fbe31dc8
DV
126};
127
8cfe592f
DV
128/**
129 * Checks whether the browser supports the <canvas> tag.
130 * @private
131 */
fbe31dc8
DV
132DygraphCanvasRenderer.isSupported = function(canvasName) {
133 var canvas = null;
134 try {
758a629f 135 if (typeof(canvasName) == 'undefined' || canvasName === null) {
b0c3b730 136 canvas = document.createElement("canvas");
758a629f 137 } else {
b0c3b730 138 canvas = canvasName;
758a629f
DV
139 }
140 canvas.getContext("2d");
fbe31dc8
DV
141 }
142 catch (e) {
143 var ie = navigator.appVersion.match(/MSIE (\d\.\d)/);
144 var opera = (navigator.userAgent.toLowerCase().indexOf("opera") != -1);
145 if ((!ie) || (ie[1] < 6) || (opera))
146 return false;
147 return true;
148 }
149 return true;
6a1aa64f 150};
6a1aa64f
DV
151
152/**
8cfe592f
DV
153 * This method is responsible for drawing everything on the chart, including
154 * lines, error bars, fills and axes.
155 * It is called immediately after clear() on every frame, including during pans
156 * and zooms.
157 * @private
6a1aa64f 158 */
285a6bda 159DygraphCanvasRenderer.prototype.render = function() {
38e3d209
DV
160 // attaches point.canvas{x,y}
161 this._updatePoints();
162
163 // actually draws the chart.
2ce09b19 164 this._renderLineChart();
fbe31dc8
DV
165};
166
920208fb
PF
167DygraphCanvasRenderer.prototype._createIEClipArea = function() {
168 var className = 'dygraph-clip-div';
169 var graphDiv = this.dygraph_.graphDiv;
170
171 // Remove old clip divs.
172 for (var i = graphDiv.childNodes.length-1; i >= 0; i--) {
173 if (graphDiv.childNodes[i].className == className) {
174 graphDiv.removeChild(graphDiv.childNodes[i]);
175 }
176 }
177
178 // Determine background color to give clip divs.
179 var backgroundColor = document.bgColor;
180 var element = this.dygraph_.graphDiv;
181 while (element != document) {
182 var bgcolor = element.currentStyle.backgroundColor;
183 if (bgcolor && bgcolor != 'transparent') {
184 backgroundColor = bgcolor;
185 break;
186 }
187 element = element.parentNode;
188 }
189
190 function createClipDiv(area) {
758a629f 191 if (area.w === 0 || area.h === 0) {
920208fb
PF
192 return;
193 }
194 var elem = document.createElement('div');
195 elem.className = className;
196 elem.style.backgroundColor = backgroundColor;
197 elem.style.position = 'absolute';
198 elem.style.left = area.x + 'px';
199 elem.style.top = area.y + 'px';
200 elem.style.width = area.w + 'px';
201 elem.style.height = area.h + 'px';
202 graphDiv.appendChild(elem);
203 }
204
205 var plotArea = this.area;
206 // Left side
758a629f
DV
207 createClipDiv({
208 x:0, y:0,
209 w:plotArea.x,
210 h:this.height
211 });
212
920208fb 213 // Top
758a629f
DV
214 createClipDiv({
215 x: plotArea.x, y: 0,
216 w: this.width - plotArea.x,
217 h: plotArea.y
218 });
219
920208fb 220 // Right side
758a629f
DV
221 createClipDiv({
222 x: plotArea.x + plotArea.w, y: 0,
223 w: this.width-plotArea.x - plotArea.w,
224 h: this.height
225 });
226
920208fb 227 // Bottom
758a629f
DV
228 createClipDiv({
229 x: plotArea.x,
230 y: plotArea.y + plotArea.h,
231 w: this.width - plotArea.x,
232 h: this.height - plotArea.h - plotArea.y
233 });
234};
fbe31dc8 235
fbe31dc8 236
ccb0001c 237/**
8722284b
RK
238 * Returns a predicate to be used with an iterator, which will
239 * iterate over points appropriately, depending on whether
240 * connectSeparatedPoints is true. When it's false, the predicate will
241 * skip over points with missing yVals.
ccb0001c 242 */
8722284b 243DygraphCanvasRenderer._getIteratorPredicate = function(connectSeparatedPoints) {
42a9ebb8
DV
244 return connectSeparatedPoints ?
245 DygraphCanvasRenderer._predicateThatSkipsEmptyPoints :
246 null;
0f20de1c 247};
8722284b
RK
248
249DygraphCanvasRenderer._predicateThatSkipsEmptyPoints =
0f20de1c
DV
250 function(array, idx) {
251 return array[idx].yval !== null;
252};
04c104d7 253
9f6db80e 254/**
38e3d209
DV
255 * Draws a line with the styles passed in and calls all the drawPointCallbacks.
256 * @param {Object} e The dictionary passed to the plotter function.
9f6db80e
DV
257 * @private
258 */
38e3d209
DV
259DygraphCanvasRenderer._drawStyledLine = function(e,
260 color, strokeWidth, strokePattern, drawPoints,
5469113b 261 drawPointCallback, pointSize) {
38e3d209 262 var g = e.dygraph;
99a77a04 263 // TODO(konigsberg): Compute attributes outside this method call.
0ce5b19b 264 var stepPlot = g.getOption("stepPlot", e.setName);
2f56cd46 265
857a6931
KW
266 if (!Dygraph.isArrayLike(strokePattern)) {
267 strokePattern = null;
268 }
269
38e3d209
DV
270 var drawGapPoints = g.getOption('drawGapEdgePoints', e.setName);
271
272 var points = e.points;
a12a78ae 273 var iter = Dygraph.createIterator(points, 0, points.length,
9f6db80e 274 DygraphCanvasRenderer._getIteratorPredicate(
38e3d209 275 g.getOption("connectSeparatedPoints"))); // TODO(danvk): per-series?
7d1afbb9 276
fb63bf1b
DV
277 var stroking = strokePattern && (strokePattern.length >= 2);
278
38e3d209 279 var ctx = e.drawingContext;
0140347d 280 ctx.save();
fb63bf1b
DV
281 if (stroking) {
282 ctx.installPattern(strokePattern);
b843b52c 283 }
fb63bf1b 284
38e3d209
DV
285 var pointsOnLine = DygraphCanvasRenderer._drawSeries(
286 e, iter, strokeWidth, pointSize, drawPoints, drawGapPoints, stepPlot, color);
287 DygraphCanvasRenderer._drawPointsOnLine(
288 e, pointsOnLine, drawPointCallback, color, pointSize);
31f8e58b 289
fb63bf1b
DV
290 if (stroking) {
291 ctx.uninstallPattern();
292 }
b843b52c 293
fb63bf1b 294 ctx.restore();
31f8e58b
RK
295};
296
38e3d209
DV
297/**
298 * This does the actual drawing of lines on the canvas, for just one series.
299 * Returns a list of [canvasx, canvasy] pairs for points for which a
300 * drawPointCallback should be fired. These include isolated points, or all
301 * points if drawPoints=true.
302 * @param {Object} e The dictionary passed to the plotter function.
303 * @private
304 */
305DygraphCanvasRenderer._drawSeries = function(e,
306 iter, strokeWidth, pointSize, drawPoints, drawGapPoints, stepPlot, color) {
31f8e58b 307
31f8e58b
RK
308 var prevCanvasX = null;
309 var prevCanvasY = null;
310 var nextCanvasY = null;
311 var isIsolated; // true if this point is isolated (no line segments)
312 var point; // the point being processed in the while loop
b843b52c 313 var pointsOnLine = []; // Array of [canvasx, canvasy] pairs.
31f8e58b
RK
314 var first = true; // the first cycle through the while loop
315
38e3d209 316 var ctx = e.drawingContext;
0140347d
DV
317 ctx.beginPath();
318 ctx.strokeStyle = color;
319 ctx.lineWidth = strokeWidth;
31f8e58b 320
239454e2 321 // NOTE: we break the iterator's encapsulation here for about a 25% speedup.
c560c848
DV
322 var arr = iter.array_;
323 var limit = iter.end_;
324 var predicate = iter.predicate_;
325
326 for (var i = iter.start_; i < limit; i++) {
327 point = arr[i];
328 if (predicate) {
329 while (i < limit && !predicate(arr, i)) {
0f20de1c
DV
330 i++;
331 }
c560c848
DV
332 if (i == limit) break;
333 point = arr[i];
0f20de1c
DV
334 }
335
a02978e2 336 if (point.canvasy === null || point.canvasy != point.canvasy) {
31f8e58b 337 if (stepPlot && prevCanvasX !== null) {
857a6931 338 // Draw a horizontal line to the start of the missing data
42a9ebb8
DV
339 ctx.moveTo(prevCanvasX, prevCanvasY);
340 ctx.lineTo(point.canvasx, prevCanvasY);
857a6931 341 }
31f8e58b 342 prevCanvasX = prevCanvasY = null;
857a6931 343 } else {
0f20de1c
DV
344 isIsolated = false;
345 if (drawGapPoints || !prevCanvasX) {
0f20de1c 346 iter.nextIdx_ = i;
0cd1ad15 347 iter.next();
82f9b10f 348 nextCanvasY = iter.hasNext ? iter.peek.canvasy : null;
0f20de1c 349
0f20de1c
DV
350 var isNextCanvasYNullOrNaN = nextCanvasY === null ||
351 nextCanvasY != nextCanvasY;
352 isIsolated = (!prevCanvasX && isNextCanvasYNullOrNaN);
353 if (drawGapPoints) {
354 // Also consider a point to be "isolated" if it's adjacent to a
355 // null point, excluding the graph edges.
356 if ((!first && !prevCanvasX) ||
357 (iter.hasNext && isNextCanvasYNullOrNaN)) {
358 isIsolated = true;
359 }
19b84fe7
KW
360 }
361 }
0f20de1c 362
31f8e58b 363 if (prevCanvasX !== null) {
857a6931 364 if (strokeWidth) {
857a6931 365 if (stepPlot) {
0140347d
DV
366 ctx.moveTo(prevCanvasX, prevCanvasY);
367 ctx.lineTo(point.canvasx, prevCanvasY);
857a6931 368 }
239454e2 369
0140347d 370 ctx.lineTo(point.canvasx, point.canvasy);
b843b52c 371 }
9f636500
DV
372 } else {
373 ctx.moveTo(point.canvasx, point.canvasy);
b843b52c 374 }
b843b52c
RK
375 if (drawPoints || isIsolated) {
376 pointsOnLine.push([point.canvasx, point.canvasy]);
377 }
31f8e58b
RK
378 prevCanvasX = point.canvasx;
379 prevCanvasY = point.canvasy;
b843b52c 380 }
7d1afbb9 381 first = false;
b843b52c 382 }
0140347d 383 ctx.stroke();
31f8e58b 384 return pointsOnLine;
857a6931
KW
385};
386
38e3d209
DV
387/**
388 * This fires the drawPointCallback functions, which draw dots on the points by
389 * default. This gets used when the "drawPoints" option is set, or when there
390 * are isolated points.
391 * @param {Object} e The dictionary passed to the plotter function.
392 * @private
393 */
394DygraphCanvasRenderer._drawPointsOnLine = function(
395 e, pointsOnLine, drawPointCallback, color, pointSize) {
396 var ctx = e.drawingContext;
397 for (var idx = 0; idx < pointsOnLine.length; idx++) {
398 var cb = pointsOnLine[idx];
399 ctx.save();
400 drawPointCallback(
401 e.dygraph, e.setName, ctx, cb[0], cb[1], color, pointSize);
402 ctx.restore();
857a6931 403 }
42a9ebb8 404};
ce49c2fa 405
6a1aa64f 406/**
38e3d209 407 * Attaches canvas coordinates to the points array.
758a629f 408 * @private
6a1aa64f 409 */
38e3d209 410DygraphCanvasRenderer.prototype._updatePoints = function() {
ff00d3e2
DV
411 // Update Points
412 // TODO(danvk): here
b843b52c
RK
413 //
414 // TODO(bhs): this loop is a hot-spot for high-point-count charts. These
415 // transformations can be pushed into the canvas via linear transformation
416 // matrices.
e60234cd
DV
417 // NOTE(danvk): this is trickier than it sounds at first. The transformation
418 // needs to be done before the .moveTo() and .lineTo() calls, but must be
419 // undone before the .stroke() call to ensure that the stroke width is
420 // unaffected. An alternative is to reduce the stroke width in the
421 // transformed coordinate space, but you can't specify different values for
422 // each dimension (as you can with .scale()). The speedup here is ~12%.
a12a78ae 423 var sets = this.layout.points;
38e3d209 424 for (var i = sets.length; i--;) {
a12a78ae
DV
425 var points = sets[i];
426 for (var j = points.length; j--;) {
427 var point = points[j];
428 point.canvasx = this.area.w * point.x + this.area.x;
429 point.canvasy = this.area.h * point.y + this.area.y;
430 }
6a1aa64f 431 }
38e3d209 432};
6a1aa64f 433
38e3d209
DV
434/**
435 * Add canvas Actually draw the lines chart, including error bars.
436 * If opt_seriesName is specified, only that series will be drawn.
437 * (This is used for expedited redrawing with highlightSeriesOpts)
438 * Lines are typically drawn in the non-interactive dygraph canvas. If opt_ctx
439 * is specified, they can be drawn elsewhere.
440 *
441 * This function can only be called if DygraphLayout's points array has been
442 * updated with canvas{x,y} attributes, i.e. by
443 * DygraphCanvasRenderer._updatePoints.
444 * @private
445 */
446DygraphCanvasRenderer.prototype._renderLineChart = function(opt_seriesName, opt_ctx) {
447 var ctx = opt_ctx || this.elementContext;
38e3d209 448 var i;
6a834bbb 449
38e3d209
DV
450 var sets = this.layout.points;
451 var setNames = this.layout.setNames;
42a9ebb8 452 var setName;
38e3d209
DV
453
454 this.colors = this.dygraph_.colorsMap_;
455
456 // Determine which series have specialized plotters.
457 var plotter_attr = this.attr_("plotter");
458 var plotters = plotter_attr;
459 if (!Dygraph.isArrayLike(plotters)) {
460 plotters = [plotters];
80aaae18
DV
461 }
462
38e3d209
DV
463 var setPlotters = {}; // series name -> plotter fn.
464 for (i = 0; i < setNames.length; i++) {
42a9ebb8 465 setName = setNames[i];
38e3d209
DV
466 var setPlotter = this.attr_("plotter", setName);
467 if (setPlotter == plotter_attr) continue; // not specialized.
468
469 setPlotters[setName] = setPlotter;
470 }
471
472 for (i = 0; i < plotters.length; i++) {
473 var plotter = plotters[i];
474 var is_last = (i == plotters.length - 1);
475
476 for (var j = 0; j < sets.length; j++) {
42a9ebb8 477 setName = setNames[j];
4b2e41a4 478 if (opt_seriesName && setName != opt_seriesName) continue;
38e3d209
DV
479
480 var points = sets[j];
481
482 // Only throw in the specialized plotters on the last iteration.
483 var p = plotter;
484 if (setName in setPlotters) {
485 if (is_last) {
486 p = setPlotters[setName];
487 } else {
488 // Don't use the standard plotters in this case.
489 continue;
490 }
491 }
492
493 var color = this.colors[setName];
494 var strokeWidth = this.dygraph_.getOption("strokeWidth", setName);
495
496 ctx.save();
497 ctx.strokeStyle = color;
498 ctx.lineWidth = strokeWidth;
499 p({
500 points: points,
501 setName: setName,
502 drawingContext: ctx,
503 color: color,
504 strokeWidth: strokeWidth,
505 dygraph: this.dygraph_,
506 axis: this.dygraph_.axisPropertiesForSeries(setName),
507 plotArea: this.area,
508 seriesIndex: j,
509 seriesCount: sets.length,
3c080cd0 510 singleSeriesName: opt_seriesName,
38e3d209
DV
511 allSeriesPoints: sets
512 });
513 ctx.restore();
514 }
515 }
516};
517
518/**
519 * Standard plotters. These may be used by clients via Dygraph.Plotters.
520 * See comments there for more details.
521 */
522DygraphCanvasRenderer._Plotters = {
523 linePlotter: function(e) {
524 DygraphCanvasRenderer._linePlotter(e);
525 },
526
527 fillPlotter: function(e) {
528 DygraphCanvasRenderer._fillPlotter(e);
529 },
530
531 errorPlotter: function(e) {
532 DygraphCanvasRenderer._errorPlotter(e);
80aaae18 533 }
6a1aa64f 534};
79253bd0 535
01a14b85 536/**
38e3d209
DV
537 * Plotter which draws the central lines for a series.
538 * @private
539 */
540DygraphCanvasRenderer._linePlotter = function(e) {
541 var g = e.dygraph;
542 var setName = e.setName;
543 var strokeWidth = e.strokeWidth;
544
545 // TODO(danvk): Check if there's any performance impact of just calling
546 // getOption() inside of _drawStyledLine. Passing in so many parameters makes
547 // this code a bit nasty.
548 var borderWidth = g.getOption("strokeBorderWidth", setName);
549 var drawPointCallback = g.getOption("drawPointCallback", setName) ||
550 Dygraph.Circles.DEFAULT;
551 var strokePattern = g.getOption("strokePattern", setName);
552 var drawPoints = g.getOption("drawPoints", setName);
553 var pointSize = g.getOption("pointSize", setName);
554
555 if (borderWidth && strokeWidth) {
556 DygraphCanvasRenderer._drawStyledLine(e,
557 g.getOption("strokeBorderColor", setName),
558 strokeWidth + 2 * borderWidth,
559 strokePattern,
560 drawPoints,
561 drawPointCallback,
562 pointSize
563 );
564 }
565
566 DygraphCanvasRenderer._drawStyledLine(e,
567 e.color,
568 strokeWidth,
569 strokePattern,
570 drawPoints,
571 drawPointCallback,
572 pointSize
573 );
42a9ebb8 574};
38e3d209
DV
575
576/**
01a14b85
DV
577 * Draws the shaded error bars/confidence intervals for each series.
578 * This happens before the center lines are drawn, since the center lines
579 * need to be drawn on top of the error bars for all series.
01a14b85
DV
580 * @private
581 */
38e3d209
DV
582DygraphCanvasRenderer._errorPlotter = function(e) {
583 var g = e.dygraph;
e2d8db3a 584 var setName = e.setName;
38e3d209
DV
585 var errorBars = g.getOption("errorBars") || g.getOption("customBars");
586 if (!errorBars) return;
587
e2d8db3a 588 var fillGraph = g.getOption("fillGraph", setName);
38e3d209
DV
589 if (fillGraph) {
590 g.warn("Can't use fillGraph option with error bars");
591 }
6a6439da 592
38e3d209
DV
593 var ctx = e.drawingContext;
594 var color = e.color;
595 var fillAlpha = g.getOption('fillAlpha', setName);
0ce5b19b 596 var stepPlot = g.getOption("stepPlot", setName);
38e3d209 597 var points = e.points;
6a6439da 598
38e3d209
DV
599 var iter = Dygraph.createIterator(points, 0, points.length,
600 DygraphCanvasRenderer._getIteratorPredicate(
601 g.getOption("connectSeparatedPoints")));
6a6439da 602
38e3d209 603 var newYs;
6a6439da 604
38e3d209
DV
605 // setup graphics context
606 var prevX = NaN;
607 var prevY = NaN;
608 var prevYs = [-1, -1];
38e3d209 609 // should be same color as the lines but only 15% opaque.
a96b8ba3 610 var rgb = new RGBColorParser(color);
38e3d209
DV
611 var err_color =
612 'rgba(' + rgb.r + ',' + rgb.g + ',' + rgb.b + ',' + fillAlpha + ')';
613 ctx.fillStyle = err_color;
614 ctx.beginPath();
cf89eeed
DV
615
616 var isNullUndefinedOrNaN = function(x) {
617 return (x === null ||
618 x === undefined ||
619 isNaN(x));
620 };
621
38e3d209
DV
622 while (iter.hasNext) {
623 var point = iter.next();
cf89eeed
DV
624 if ((!stepPlot && isNullUndefinedOrNaN(point.y)) ||
625 (stepPlot && !isNaN(prevY) && isNullUndefinedOrNaN(prevY))) {
38e3d209
DV
626 prevX = NaN;
627 continue;
628 }
6a6439da 629
38e3d209
DV
630 if (stepPlot) {
631 newYs = [ point.y_bottom, point.y_top ];
632 prevY = point.y;
633 } else {
634 newYs = [ point.y_bottom, point.y_top ];
635 }
636 newYs[0] = e.plotArea.h * newYs[0] + e.plotArea.y;
637 newYs[1] = e.plotArea.h * newYs[1] + e.plotArea.y;
638 if (!isNaN(prevX)) {
a5701188 639 if (stepPlot) {
38e3d209 640 ctx.moveTo(prevX, prevYs[0]);
82dd90c5 641 ctx.lineTo(point.canvasx, prevYs[0]);
642 ctx.lineTo(point.canvasx, prevYs[1]);
38e3d209 643 } else {
82dd90c5 644 ctx.moveTo(prevX, prevYs[0]);
645 ctx.lineTo(point.canvasx, newYs[0]);
646 ctx.lineTo(point.canvasx, newYs[1]);
6a6439da 647 }
82dd90c5 648 ctx.lineTo(prevX, prevYs[1]);
38e3d209 649 ctx.closePath();
6a6439da 650 }
38e3d209
DV
651 prevYs = newYs;
652 prevX = point.canvasx;
6a6439da 653 }
38e3d209 654 ctx.fill();
42a9ebb8 655};
6a6439da 656
79253bd0 657/**
01a14b85
DV
658 * Draws the shaded regions when "fillGraph" is set. Not to be confused with
659 * error bars.
660 *
38e3d209
DV
661 * For stacked charts, it's more convenient to handle all the series
662 * simultaneously. So this plotter plots all the points on the first series
663 * it's asked to draw, then ignores all the other series.
664 *
01a14b85
DV
665 * @private
666 */
38e3d209 667DygraphCanvasRenderer._fillPlotter = function(e) {
3c080cd0
KW
668 // Skip if we're drawing a single series for interactive highlight overlay.
669 if (e.singleSeriesName) return;
670
38e3d209
DV
671 // We'll handle all the series at once, not one-by-one.
672 if (e.seriesIndex !== 0) return;
673
e2d8db3a 674 var g = e.dygraph;
38e3d209 675 var setNames = g.getLabels().slice(1); // remove x-axis
e2d8db3a 676
38e3d209
DV
677 // getLabels() includes names for invisible series, which are not included in
678 // allSeriesPoints. We remove those to make the two match.
679 // TODO(danvk): provide a simpler way to get this information.
680 for (var i = setNames.length; i >= 0; i--) {
681 if (!g.visibility()[i]) setNames.splice(i, 1);
682 }
683
e2d8db3a
DV
684 var anySeriesFilled = (function() {
685 for (var i = 0; i < setNames.length; i++) {
686 if (g.getOption("fillGraph", setNames[i])) return true;
687 }
688 return false;
689 })();
690
691 if (!anySeriesFilled) return;
692
693 var ctx = e.drawingContext;
694 var area = e.plotArea;
695 var sets = e.allSeriesPoints;
696 var setCount = sets.length;
697
38e3d209 698 var fillAlpha = g.getOption('fillAlpha');
38e3d209
DV
699 var stackedGraph = g.getOption("stackedGraph");
700 var colors = g.getColors();
01a14b85
DV
701
702 var baseline = {}; // for stacked graphs: baseline for filling
703 var currBaseline;
104d87c5 704 var prevStepPlot; // for different line drawing modes (line/step) per series
01a14b85
DV
705
706 // process sets in reverse order (needed for stacked graphs)
9e85a8f4
DV
707 for (var setIdx = setCount - 1; setIdx >= 0; setIdx--) {
708 var setName = setNames[setIdx];
e2d8db3a 709 if (!g.getOption('fillGraph', setName)) continue;
104d87c5 710
711 var stepPlot = g.getOption('stepPlot', setName);
38e3d209
DV
712 var color = colors[setIdx];
713 var axis = g.axisPropertiesForSeries(setName);
01a14b85
DV
714 var axisY = 1.0 + axis.minyval * axis.yscale;
715 if (axisY < 0.0) axisY = 0.0;
716 else if (axisY > 1.0) axisY = 1.0;
38e3d209 717 axisY = area.h * axisY + area.y;
01a14b85 718
38e3d209 719 var points = sets[setIdx];
9e85a8f4 720 var iter = Dygraph.createIterator(points, 0, points.length,
01a14b85 721 DygraphCanvasRenderer._getIteratorPredicate(
38e3d209 722 g.getOption("connectSeparatedPoints")));
01a14b85
DV
723
724 // setup graphics context
725 var prevX = NaN;
726 var prevYs = [-1, -1];
727 var newYs;
01a14b85 728 // should be same color as the lines but only 15% opaque.
a96b8ba3 729 var rgb = new RGBColorParser(color);
01a14b85
DV
730 var err_color =
731 'rgba(' + rgb.r + ',' + rgb.g + ',' + rgb.b + ',' + fillAlpha + ')';
732 ctx.fillStyle = err_color;
733 ctx.beginPath();
12b879f4
DV
734 var last_x, is_first = true;
735 while (iter.hasNext) {
01a14b85 736 var point = iter.next();
16febe6b
DV
737 if (!Dygraph.isOK(point.y)) {
738 prevX = NaN;
739 continue;
740 }
741 if (stackedGraph) {
12b879f4
DV
742 if (!is_first && last_x == point.xval) {
743 continue;
744 } else {
745 is_first = false;
746 last_x = point.xval;
747 }
748
16febe6b
DV
749 currBaseline = baseline[point.canvasx];
750 var lastY;
751 if (currBaseline === undefined) {
752 lastY = axisY;
753 } else {
104d87c5 754 if(prevStepPlot) {
16febe6b 755 lastY = currBaseline[0];
01a14b85 756 } else {
16febe6b 757 lastY = currBaseline;
01a14b85 758 }
16febe6b
DV
759 }
760 newYs = [ point.canvasy, lastY ];
01a14b85 761
16febe6b
DV
762 if(stepPlot) {
763 // Step plots must keep track of the top and bottom of
764 // the baseline at each point.
765 if(prevYs[0] === -1) {
766 baseline[point.canvasx] = [ point.canvasy, axisY ];
01a14b85 767 } else {
16febe6b 768 baseline[point.canvasx] = [ point.canvasy, prevYs[0] ];
01a14b85 769 }
01a14b85 770 } else {
16febe6b 771 baseline[point.canvasx] = point.canvasy;
01a14b85 772 }
01a14b85 773
16febe6b
DV
774 } else {
775 newYs = [ point.canvasy, axisY ];
776 }
777 if (!isNaN(prevX)) {
778 ctx.moveTo(prevX, prevYs[0]);
104d87c5 779
780 // Move to top fill point
16febe6b
DV
781 if (stepPlot) {
782 ctx.lineTo(point.canvasx, prevYs[0]);
16febe6b
DV
783 } else {
784 ctx.lineTo(point.canvasx, newYs[0]);
104d87c5 785 }
786 // Move to bottom fill point
787 if (prevStepPlot && currBaseline) {
788 // Draw to the bottom of the baseline
789 ctx.lineTo(point.canvasx, currBaseline[1]);
790 } else {
16febe6b 791 ctx.lineTo(point.canvasx, newYs[1]);
01a14b85 792 }
16febe6b
DV
793
794 ctx.lineTo(prevX, prevYs[1]);
795 ctx.closePath();
01a14b85 796 }
16febe6b
DV
797 prevYs = newYs;
798 prevX = point.canvasx;
01a14b85 799 }
104d87c5 800 prevStepPlot = stepPlot;
01a14b85
DV
801 ctx.fill();
802 }
803};