Add ol.render.canvas.Immediate#drawAsync

src/ol/render/canvas/canvasimmediate.exports

@@ -1,3 +1,4 @@
+@exportProperty ol.render.canvas.Immediate.prototype.drawAsync
 @exportProperty ol.render.canvas.Immediate.prototype.drawFeature
 @exportProperty ol.render.canvas.Immediate.prototype.drawPointGeometry
 @exportProperty ol.render.canvas.Immediate.prototype.drawLineStringGeometry

src/ol/render/canvas/canvasimmediate.js

@@ -4,7 +4,9 @@
 
 goog.provide('ol.render.canvas.Immediate');
 
+goog.require('goog.array');
 goog.require('goog.asserts');
+goog.require('goog.object');
 goog.require('goog.vec.Mat4');
 goog.require('ol.color');
 goog.require('ol.extent');
@@ -26,6 +28,13 @@ goog.require('ol.vec.Mat4');
  */
 ol.render.canvas.Immediate = function(context, pixelRatio, extent, transform) {
 
+  /**
+   * @private
+   * @type {Object.<string,
+   *        Array.<function(ol.render.canvas.Immediate)>>}
+   */
+  this.callbacksByZIndex_ = {};
+
   /**
    * @private
    * @type {CanvasRenderingContext2D}
@@ -240,6 +249,20 @@ ol.render.canvas.Immediate.prototype.drawRings_ =
 };
 
 
+/**
+ * @inheritDoc
+ */
+ol.render.canvas.Immediate.prototype.drawAsync = function(zIndex, callback) {
+  var zIndexKey = zIndex.toString();
+  var callbacks = this.callbacksByZIndex_[zIndexKey];
+  if (goog.isDef(callbacks)) {
+    callbacks.push(callback);
+  } else {
+    this.callbacksByZIndex_[zIndexKey] = [callback];
+  }
+};
+
+
 /**
  * @inheritDoc
  */
@@ -402,6 +425,23 @@ ol.render.canvas.Immediate.prototype.drawMultiPolygonGeometry =
 };
 
 
+/**
+ * FIXME: empty description for jsdoc
+ */
+ol.render.canvas.Immediate.prototype.flush = function() {
+  /** @type {Array.<number>} */
+  var zs = goog.array.map(goog.object.getKeys(this.callbacksByZIndex_), Number);
+  goog.array.sort(zs);
+  var i, ii, callbacks, j, jj;
+  for (i = 0, ii = zs.length; i < ii; ++i) {
+    callbacks = this.callbacksByZIndex_[zs[i].toString()];
+    for (j = 0, jj = callbacks.length; j < jj; ++j) {
+      callbacks[j](this);
+    }
+  }
+};
+
+
 /**
  * @inheritDoc
  */

src/ol/renderer/canvas/canvaslayerrenderer.js

@@ -90,6 +90,7 @@ ol.renderer.canvas.Layer.prototype.dispatchComposeEvent_ =
     var composeEvent = new ol.render.Event(type, layer, render, frameState,
         context, null);
     layer.dispatchEvent(composeEvent);
+    render.flush();
   }
 };
 

src/ol/renderer/canvas/canvasmaprenderer.js

@@ -109,6 +109,7 @@ ol.renderer.canvas.Map.prototype.dispatchComposeEvent_ =
     var composeEvent = new ol.render.Event(type, map, render, frameState,
         context, null);
     map.dispatchEvent(composeEvent);
+    render.flush();
   }
 };