Add comments and warnings for legacy options.
[dygraphs.git] / dygraph-canvas.js
... / ...
CommitLineData
1/**
2 * @license
3 * Copyright 2006 Dan Vanderkam (danvdk@gmail.com)
4 * MIT-licensed (http://opensource.org/licenses/MIT)
5 */
6
7/**
8 * @fileoverview Based on PlotKit.CanvasRenderer, but modified to meet the
9 * needs of dygraphs.
10 *
11 * In particular, support for:
12 * - grid overlays
13 * - error bars
14 * - dygraphs attribute system
15 */
16
17/**
18 * The DygraphCanvasRenderer class does the actual rendering of the chart onto
19 * a canvas. It's based on PlotKit.CanvasRenderer.
20 * @param {Object} element The canvas to attach to
21 * @param {Object} elementContext The 2d context of the canvas (injected so it
22 * can be mocked for testing.)
23 * @param {Layout} layout The DygraphLayout object for this graph.
24 * @constructor
25 */
26
27/*jshint globalstrict: true */
28/*global Dygraph:false,RGBColor:false */
29"use strict";
30
31
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 */
49var DygraphCanvasRenderer = function(dygraph, element, elementContext, layout) {
50 this.dygraph_ = dygraph;
51
52 this.layout = layout;
53 this.element = element;
54 this.elementContext = elementContext;
55 this.container = this.element.parentNode;
56
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
65 this.area = layout.getPlotArea();
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.
71 if (this.dygraph_.isUsingExcanvas_) {
72 this._createIEClipArea();
73 } else {
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();
81
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 }
87 }
88};
89
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);
97};
98
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 */
105DygraphCanvasRenderer.prototype.clear = function() {
106 var context;
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 }
114 context = this.elementContext;
115 }
116 catch (e) {
117 // TODO(danvk): this is broken, since MochiKit.Async is gone.
118 // this.clearDelay = MochiKit.Async.wait(this.IEDelay);
119 // this.clearDelay.addCallback(bind(this.clear, this));
120 return;
121 }
122 }
123
124 context = this.elementContext;
125 context.clearRect(0, 0, this.width, this.height);
126};
127
128/**
129 * Checks whether the browser supports the <canvas> tag.
130 * @private
131 */
132DygraphCanvasRenderer.isSupported = function(canvasName) {
133 var canvas = null;
134 try {
135 if (typeof(canvasName) == 'undefined' || canvasName === null) {
136 canvas = document.createElement("canvas");
137 } else {
138 canvas = canvasName;
139 }
140 canvas.getContext("2d");
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;
150};
151
152/**
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
158 */
159DygraphCanvasRenderer.prototype.render = function() {
160 // attaches point.canvas{x,y}
161 this._updatePoints();
162
163 // actually draws the chart.
164 this._renderLineChart();
165};
166
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) {
191 if (area.w === 0 || area.h === 0) {
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
207 createClipDiv({
208 x:0, y:0,
209 w:plotArea.x,
210 h:this.height
211 });
212
213 // Top
214 createClipDiv({
215 x: plotArea.x, y: 0,
216 w: this.width - plotArea.x,
217 h: plotArea.y
218 });
219
220 // Right side
221 createClipDiv({
222 x: plotArea.x + plotArea.w, y: 0,
223 w: this.width-plotArea.x - plotArea.w,
224 h: this.height
225 });
226
227 // Bottom
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};
235
236
237/**
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.
242 */
243DygraphCanvasRenderer._getIteratorPredicate = function(connectSeparatedPoints) {
244 return connectSeparatedPoints ?
245 DygraphCanvasRenderer._predicateThatSkipsEmptyPoints :
246 null;
247};
248
249DygraphCanvasRenderer._predicateThatSkipsEmptyPoints =
250 function(array, idx) {
251 return array[idx].yval !== null;
252};
253
254/**
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.
257 * @private
258 */
259DygraphCanvasRenderer._drawStyledLine = function(e,
260 color, strokeWidth, strokePattern, drawPoints,
261 drawPointCallback, pointSize) {
262 var g = e.dygraph;
263 // TODO(konigsberg): Compute attributes outside this method call.
264 var stepPlot = g.getOption("stepPlot"); // TODO(danvk): per-series
265 if (!Dygraph.isArrayLike(strokePattern)) {
266 strokePattern = null;
267 }
268
269 var drawGapPoints = g.getOption('drawGapEdgePoints', e.setName);
270
271 var points = e.points;
272 var iter = Dygraph.createIterator(points, 0, points.length,
273 DygraphCanvasRenderer._getIteratorPredicate(
274 g.getOption("connectSeparatedPoints"))); // TODO(danvk): per-series?
275
276 var stroking = strokePattern && (strokePattern.length >= 2);
277
278 var ctx = e.drawingContext;
279 ctx.save();
280 if (stroking) {
281 ctx.installPattern(strokePattern);
282 }
283
284 var pointsOnLine = DygraphCanvasRenderer._drawSeries(
285 e, iter, strokeWidth, pointSize, drawPoints, drawGapPoints, stepPlot, color);
286 DygraphCanvasRenderer._drawPointsOnLine(
287 e, pointsOnLine, drawPointCallback, color, pointSize);
288
289 if (stroking) {
290 ctx.uninstallPattern();
291 }
292
293 ctx.restore();
294};
295
296/**
297 * This does the actual drawing of lines on the canvas, for just one series.
298 * Returns a list of [canvasx, canvasy] pairs for points for which a
299 * drawPointCallback should be fired. These include isolated points, or all
300 * points if drawPoints=true.
301 * @param {Object} e The dictionary passed to the plotter function.
302 * @private
303 */
304DygraphCanvasRenderer._drawSeries = function(e,
305 iter, strokeWidth, pointSize, drawPoints, drawGapPoints, stepPlot, color) {
306
307 var prevCanvasX = null;
308 var prevCanvasY = null;
309 var nextCanvasY = null;
310 var isIsolated; // true if this point is isolated (no line segments)
311 var point; // the point being processed in the while loop
312 var pointsOnLine = []; // Array of [canvasx, canvasy] pairs.
313 var first = true; // the first cycle through the while loop
314
315 var ctx = e.drawingContext;
316 ctx.beginPath();
317 ctx.strokeStyle = color;
318 ctx.lineWidth = strokeWidth;
319
320 // NOTE: we break the iterator's encapsulation here for about a 25% speedup.
321 var arr = iter.array_;
322 var limit = iter.end_;
323 var predicate = iter.predicate_;
324
325 for (var i = iter.start_; i < limit; i++) {
326 point = arr[i];
327 if (predicate) {
328 while (i < limit && !predicate(arr, i)) {
329 i++;
330 }
331 if (i == limit) break;
332 point = arr[i];
333 }
334
335 if (point.canvasy === null || point.canvasy != point.canvasy) {
336 if (stepPlot && prevCanvasX !== null) {
337 // Draw a horizontal line to the start of the missing data
338 ctx.moveTo(prevCanvasX, prevCanvasY);
339 ctx.lineTo(point.canvasx, prevCanvasY);
340 }
341 prevCanvasX = prevCanvasY = null;
342 } else {
343 isIsolated = false;
344 if (drawGapPoints || !prevCanvasX) {
345 iter.nextIdx_ = i;
346 var peek = iter.next();
347 nextCanvasY = iter.hasNext ? iter.peek.canvasy : null;
348
349 var isNextCanvasYNullOrNaN = nextCanvasY === null ||
350 nextCanvasY != nextCanvasY;
351 isIsolated = (!prevCanvasX && isNextCanvasYNullOrNaN);
352 if (drawGapPoints) {
353 // Also consider a point to be "isolated" if it's adjacent to a
354 // null point, excluding the graph edges.
355 if ((!first && !prevCanvasX) ||
356 (iter.hasNext && isNextCanvasYNullOrNaN)) {
357 isIsolated = true;
358 }
359 }
360 }
361
362 if (prevCanvasX !== null) {
363 if (strokeWidth) {
364 if (stepPlot) {
365 ctx.moveTo(prevCanvasX, prevCanvasY);
366 ctx.lineTo(point.canvasx, prevCanvasY);
367 }
368
369 ctx.lineTo(point.canvasx, point.canvasy);
370 }
371 } else {
372 ctx.moveTo(point.canvasx, point.canvasy);
373 }
374 if (drawPoints || isIsolated) {
375 pointsOnLine.push([point.canvasx, point.canvasy]);
376 }
377 prevCanvasX = point.canvasx;
378 prevCanvasY = point.canvasy;
379 }
380 first = false;
381 }
382 ctx.stroke();
383 return pointsOnLine;
384};
385
386/**
387 * This fires the drawPointCallback functions, which draw dots on the points by
388 * default. This gets used when the "drawPoints" option is set, or when there
389 * are isolated points.
390 * @param {Object} e The dictionary passed to the plotter function.
391 * @private
392 */
393DygraphCanvasRenderer._drawPointsOnLine = function(
394 e, pointsOnLine, drawPointCallback, color, pointSize) {
395 var ctx = e.drawingContext;
396 for (var idx = 0; idx < pointsOnLine.length; idx++) {
397 var cb = pointsOnLine[idx];
398 ctx.save();
399 drawPointCallback(
400 e.dygraph, e.setName, ctx, cb[0], cb[1], color, pointSize);
401 ctx.restore();
402 }
403};
404
405/**
406 * Attaches canvas coordinates to the points array.
407 * @private
408 */
409DygraphCanvasRenderer.prototype._updatePoints = function() {
410 // Update Points
411 // TODO(danvk): here
412 //
413 // TODO(bhs): this loop is a hot-spot for high-point-count charts. These
414 // transformations can be pushed into the canvas via linear transformation
415 // matrices.
416 // NOTE(danvk): this is trickier than it sounds at first. The transformation
417 // needs to be done before the .moveTo() and .lineTo() calls, but must be
418 // undone before the .stroke() call to ensure that the stroke width is
419 // unaffected. An alternative is to reduce the stroke width in the
420 // transformed coordinate space, but you can't specify different values for
421 // each dimension (as you can with .scale()). The speedup here is ~12%.
422 var sets = this.layout.points;
423 for (var i = sets.length; i--;) {
424 var points = sets[i];
425 for (var j = points.length; j--;) {
426 var point = points[j];
427 point.canvasx = this.area.w * point.x + this.area.x;
428 point.canvasy = this.area.h * point.y + this.area.y;
429 }
430 }
431};
432
433/**
434 * Add canvas Actually draw the lines chart, including error bars.
435 * If opt_seriesName is specified, only that series will be drawn.
436 * (This is used for expedited redrawing with highlightSeriesOpts)
437 * Lines are typically drawn in the non-interactive dygraph canvas. If opt_ctx
438 * is specified, they can be drawn elsewhere.
439 *
440 * This function can only be called if DygraphLayout's points array has been
441 * updated with canvas{x,y} attributes, i.e. by
442 * DygraphCanvasRenderer._updatePoints.
443 * @private
444 */
445DygraphCanvasRenderer.prototype._renderLineChart = function(opt_seriesName, opt_ctx) {
446 var ctx = opt_ctx || this.elementContext;
447 var errorBars = this.attr_("errorBars") || this.attr_("customBars");
448 var fillGraph = this.attr_("fillGraph");
449 var i;
450
451 var sets = this.layout.points;
452 var setNames = this.layout.setNames;
453 var setCount = setNames.length;
454 var setName;
455
456 this.colors = this.dygraph_.colorsMap_;
457
458 // Determine which series have specialized plotters.
459 var plotter_attr = this.attr_("plotter");
460 var plotters = plotter_attr;
461 if (!Dygraph.isArrayLike(plotters)) {
462 plotters = [plotters];
463 }
464
465 var setPlotters = {}; // series name -> plotter fn.
466 for (i = 0; i < setNames.length; i++) {
467 setName = setNames[i];
468 var setPlotter = this.attr_("plotter", setName);
469 if (setPlotter == plotter_attr) continue; // not specialized.
470
471 setPlotters[setName] = setPlotter;
472 }
473
474 for (i = 0; i < plotters.length; i++) {
475 var plotter = plotters[i];
476 var is_last = (i == plotters.length - 1);
477
478 for (var j = 0; j < sets.length; j++) {
479 setName = setNames[j];
480 if (opt_seriesName && setName != opt_seriesName) continue;
481
482 var points = sets[j];
483
484 // Only throw in the specialized plotters on the last iteration.
485 var p = plotter;
486 if (setName in setPlotters) {
487 if (is_last) {
488 p = setPlotters[setName];
489 } else {
490 // Don't use the standard plotters in this case.
491 continue;
492 }
493 }
494
495 var color = this.colors[setName];
496 var strokeWidth = this.dygraph_.getOption("strokeWidth", setName);
497
498 ctx.save();
499 ctx.strokeStyle = color;
500 ctx.lineWidth = strokeWidth;
501 p({
502 points: points,
503 setName: setName,
504 drawingContext: ctx,
505 color: color,
506 strokeWidth: strokeWidth,
507 dygraph: this.dygraph_,
508 axis: this.dygraph_.axisPropertiesForSeries(setName),
509 plotArea: this.area,
510 seriesIndex: j,
511 seriesCount: sets.length,
512 allSeriesPoints: sets
513 });
514 ctx.restore();
515 }
516 }
517};
518
519/**
520 * Standard plotters. These may be used by clients via Dygraph.Plotters.
521 * See comments there for more details.
522 */
523DygraphCanvasRenderer._Plotters = {
524 linePlotter: function(e) {
525 DygraphCanvasRenderer._linePlotter(e);
526 },
527
528 fillPlotter: function(e) {
529 DygraphCanvasRenderer._fillPlotter(e);
530 },
531
532 errorPlotter: function(e) {
533 DygraphCanvasRenderer._errorPlotter(e);
534 }
535};
536
537/**
538 * Plotter which draws the central lines for a series.
539 * @private
540 */
541DygraphCanvasRenderer._linePlotter = function(e) {
542 var g = e.dygraph;
543 var setName = e.setName;
544 var strokeWidth = e.strokeWidth;
545
546 // TODO(danvk): Check if there's any performance impact of just calling
547 // getOption() inside of _drawStyledLine. Passing in so many parameters makes
548 // this code a bit nasty.
549 var borderWidth = g.getOption("strokeBorderWidth", setName);
550 var drawPointCallback = g.getOption("drawPointCallback", setName) ||
551 Dygraph.Circles.DEFAULT;
552 var strokePattern = g.getOption("strokePattern", setName);
553 var drawPoints = g.getOption("drawPoints", setName);
554 var pointSize = g.getOption("pointSize", setName);
555
556 if (borderWidth && strokeWidth) {
557 DygraphCanvasRenderer._drawStyledLine(e,
558 g.getOption("strokeBorderColor", setName),
559 strokeWidth + 2 * borderWidth,
560 strokePattern,
561 drawPoints,
562 drawPointCallback,
563 pointSize
564 );
565 }
566
567 DygraphCanvasRenderer._drawStyledLine(e,
568 e.color,
569 strokeWidth,
570 strokePattern,
571 drawPoints,
572 drawPointCallback,
573 pointSize
574 );
575};
576
577/**
578 * Draws the shaded error bars/confidence intervals for each series.
579 * This happens before the center lines are drawn, since the center lines
580 * need to be drawn on top of the error bars for all series.
581 * @private
582 */
583DygraphCanvasRenderer._errorPlotter = function(e) {
584 var g = e.dygraph;
585 var setName = e.setName;
586 var errorBars = g.getOption("errorBars") || g.getOption("customBars");
587 if (!errorBars) return;
588
589 var fillGraph = g.getOption("fillGraph", setName);
590 if (fillGraph) {
591 g.warn("Can't use fillGraph option with error bars");
592 }
593
594 var ctx = e.drawingContext;
595 var color = e.color;
596 var fillAlpha = g.getOption('fillAlpha', setName);
597 var stepPlot = g.getOption('stepPlot'); // TODO(danvk): per-series
598 var axis = e.axis;
599 var points = e.points;
600
601 var iter = Dygraph.createIterator(points, 0, points.length,
602 DygraphCanvasRenderer._getIteratorPredicate(
603 g.getOption("connectSeparatedPoints")));
604
605 var newYs;
606
607 // setup graphics context
608 var prevX = NaN;
609 var prevY = NaN;
610 var prevYs = [-1, -1];
611 var yscale = axis.yscale;
612 // should be same color as the lines but only 15% opaque.
613 var rgb = new RGBColor(color);
614 var err_color =
615 'rgba(' + rgb.r + ',' + rgb.g + ',' + rgb.b + ',' + fillAlpha + ')';
616 ctx.fillStyle = err_color;
617 ctx.beginPath();
618
619 var isNullUndefinedOrNaN = function(x) {
620 return (x === null ||
621 x === undefined ||
622 isNaN(x));
623 };
624
625 while (iter.hasNext) {
626 var point = iter.next();
627 if ((!stepPlot && isNullUndefinedOrNaN(point.y)) ||
628 (stepPlot && !isNaN(prevY) && isNullUndefinedOrNaN(prevY))) {
629 prevX = NaN;
630 continue;
631 }
632
633 if (stepPlot) {
634 newYs = [ point.y_bottom, point.y_top ];
635 prevY = point.y;
636 } else {
637 newYs = [ point.y_bottom, point.y_top ];
638 }
639 newYs[0] = e.plotArea.h * newYs[0] + e.plotArea.y;
640 newYs[1] = e.plotArea.h * newYs[1] + e.plotArea.y;
641 if (!isNaN(prevX)) {
642 if (stepPlot) {
643 ctx.moveTo(prevX, prevYs[0]);
644 ctx.lineTo(point.canvasx, prevYs[0]);
645 ctx.lineTo(point.canvasx, prevYs[1]);
646 } else {
647 ctx.moveTo(prevX, prevYs[0]);
648 ctx.lineTo(point.canvasx, newYs[0]);
649 ctx.lineTo(point.canvasx, newYs[1]);
650 }
651 ctx.lineTo(prevX, prevYs[1]);
652 ctx.closePath();
653 }
654 prevYs = newYs;
655 prevX = point.canvasx;
656 }
657 ctx.fill();
658};
659
660/**
661 * Draws the shaded regions when "fillGraph" is set. Not to be confused with
662 * error bars.
663 *
664 * For stacked charts, it's more convenient to handle all the series
665 * simultaneously. So this plotter plots all the points on the first series
666 * it's asked to draw, then ignores all the other series.
667 *
668 * @private
669 */
670DygraphCanvasRenderer._fillPlotter = function(e) {
671 // We'll handle all the series at once, not one-by-one.
672 if (e.seriesIndex !== 0) return;
673
674 var g = e.dygraph;
675 var setNames = g.getLabels().slice(1); // remove x-axis
676
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
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
698 var fillAlpha = g.getOption('fillAlpha');
699 var stepPlot = g.getOption('stepPlot');
700 var stackedGraph = g.getOption("stackedGraph");
701 var colors = g.getColors();
702
703 var baseline = {}; // for stacked graphs: baseline for filling
704 var currBaseline;
705
706 // process sets in reverse order (needed for stacked graphs)
707 for (var setIdx = setCount - 1; setIdx >= 0; setIdx--) {
708 var setName = setNames[setIdx];
709 if (!g.getOption('fillGraph', setName)) continue;
710
711 var color = colors[setIdx];
712 var axis = g.axisPropertiesForSeries(setName);
713 var axisY = 1.0 + axis.minyval * axis.yscale;
714 if (axisY < 0.0) axisY = 0.0;
715 else if (axisY > 1.0) axisY = 1.0;
716 axisY = area.h * axisY + area.y;
717
718 var points = sets[setIdx];
719 var iter = Dygraph.createIterator(points, 0, points.length,
720 DygraphCanvasRenderer._getIteratorPredicate(
721 g.getOption("connectSeparatedPoints")));
722
723 // setup graphics context
724 var prevX = NaN;
725 var prevYs = [-1, -1];
726 var newYs;
727 var yscale = axis.yscale;
728 // should be same color as the lines but only 15% opaque.
729 var rgb = new RGBColor(color);
730 var err_color =
731 'rgba(' + rgb.r + ',' + rgb.g + ',' + rgb.b + ',' + fillAlpha + ')';
732 ctx.fillStyle = err_color;
733 ctx.beginPath();
734 while(iter.hasNext) {
735 var point = iter.next();
736 if (!Dygraph.isOK(point.y)) {
737 prevX = NaN;
738 continue;
739 }
740 if (stackedGraph) {
741 currBaseline = baseline[point.canvasx];
742 var lastY;
743 if (currBaseline === undefined) {
744 lastY = axisY;
745 } else {
746 if(stepPlot) {
747 lastY = currBaseline[0];
748 } else {
749 lastY = currBaseline;
750 }
751 }
752 newYs = [ point.canvasy, lastY ];
753
754 if(stepPlot) {
755 // Step plots must keep track of the top and bottom of
756 // the baseline at each point.
757 if(prevYs[0] === -1) {
758 baseline[point.canvasx] = [ point.canvasy, axisY ];
759 } else {
760 baseline[point.canvasx] = [ point.canvasy, prevYs[0] ];
761 }
762 } else {
763 baseline[point.canvasx] = point.canvasy;
764 }
765
766 } else {
767 newYs = [ point.canvasy, axisY ];
768 }
769 if (!isNaN(prevX)) {
770 ctx.moveTo(prevX, prevYs[0]);
771
772 if (stepPlot) {
773 ctx.lineTo(point.canvasx, prevYs[0]);
774 if(currBaseline) {
775 // Draw to the bottom of the baseline
776 ctx.lineTo(point.canvasx, currBaseline[1]);
777 } else {
778 ctx.lineTo(point.canvasx, newYs[1]);
779 }
780 } else {
781 ctx.lineTo(point.canvasx, newYs[0]);
782 ctx.lineTo(point.canvasx, newYs[1]);
783 }
784
785 ctx.lineTo(prevX, prevYs[1]);
786 ctx.closePath();
787 }
788 prevYs = newYs;
789 prevX = point.canvasx;
790 }
791 ctx.fill();
792 }
793};