13

I'm implementing map exporting functionality using OpenLayers 3.

But there is one problem: one cannot determine whether the map view is completely loaded or a few tiles is missing yet.

It seems there is no such API or event. The close one is tileloadstart - tileloadend pair. But OpenLayers loads tiles asynchronously, and before the tile is actually loading the tileloadstart is not fired - that is, a tile that is queued in the tile queue does not fire the event before actually loading.

Hot can I detect the map view is completely loaded?

Jose Gómez
  • 3,110
  • 2
  • 32
  • 54
zeodtr
  • 10,645
  • 14
  • 43
  • 60

4 Answers4

14

postrender event seems to do the trick, like this:

map.once('postrender', function(event) {
    doyourmagic();
});

Works at least from OpenLayers 3.8.2. There is fine answer there about the subject.

Community
  • 1
  • 1
BartBiczBoży
  • 2,512
  • 2
  • 24
  • 33
  • 1
    keep in mind this will also be triggered every time the map moves. – lenooh Jun 26 '20 at 16:45
  • 1
    If you use `once` like this example does it will only be triggered once whereas `map.on('postrender'...` would trigger every time the map moves until it's taken off with `un` – quicklikerabbit Mar 25 '21 at 16:51
4

I eventually implemented the export function successfully. Below is the rough explanation.

  1. Register tileloadstart, tileloadend, tileloaderror event handlers on the ol.sources using ol.source.on(), and start managing the tile load count.
  2. Register postcompose event handlers on the ol.Map using ol.Map.once().
  3. call ol.Map.renderSync(). This triggers the tile loading, so from now if there is no tile loading, it will mean that all tile have been loaded.
  4. On postcompose event handler, capture the map content from event.context using event.context.canvas.toDataURL(), and register postrender function using event.frameState.postRenderFunctions.push() (a bit hacky).
  5. On the registered postrender function, check the tile load count (which can be managed by the tileload* event handlers). If the count is not zero, abandon the captured content. Else, the capture is done.
  6. On tileloadend and tileloaderror, if the tile load count becomes zero, retry from the step 3 above.
zeodtr
  • 10,645
  • 14
  • 43
  • 60
4

Meanwhile, OpenLayers provides a much sought after rendercomplete event which may be handy.

Christallkeks
  • 525
  • 5
  • 18
1

Basically to make sure everything is rendered on your map you need to listen for loadend events for each layer you have on the map. For wms and wfs layers this is clear and I guess you know how to do it. For the tile layers , check this example here

pavlos
  • 3,001
  • 18
  • 23
  • 1
    tileload* events do not work for this problem. Since the tile queue manager queues the tiles asynchronously for loading, event if there is no tile loading it does not necessarily mean that all tiles are loaded. – zeodtr Dec 18 '15 at 02:31