ContextQMD
Back to Openlayers

v3.18.0

changelog/v3.18.0.md

10.9.021.3 KB
Original Source

v3.18.0

Summary

The v3.18.0 release includes features and fixes from almost 120 pull requests since the v3.17.1 release. Most of the changes are bug fixes and continuing removal of the dependency on Closure Library. New features include:

  • Addition of Intersects and Within filters to ol.format.ogc.filter #5668
  • New overlaps option for ol.source.Vector and ol.source.VectorTile to improve rendering performance for polygon topologies #5196
  • New rotateWithView option for ol.style.Text to control appearance of text on rotated views #5050
  • Add a #scale() method to ol.geom.Geometry and subclasses #5685
  • Parse id of features in ol.format.MVT #5613

Upgrade notes

Changes in the way assertions are handled

Previously, minified builds of the library did not have any assertions. This caused applications to fail silently or with cryptic stack traces. Starting with this release, developers get notified of many runtime errors through the new ol.AssertionError. This error has a code property. The meaning of the code can be found on https://openlayers.org/en/latest/doc/errors/. There are additional console assertion checks in debug mode when the goog.DEBUG compiler flag is true. As this is true by default, it is recommended that those creating custom builds set this to false so these assertions are stripped.'

Removal of ol.ENABLE_NAMED_COLORS

This option was previously needed to use named colors with the WebGL renderer but is no longer needed.

KML format now uses URL()

The URL constructor is supported by all modern browsers, but not by older ones, such as IE. To use the KML format in such older browsers, a URL polyfill will have to be loaded before use.

Changes only relevant to those who compile their applications together with the Closure Compiler

A number of internal types have been renamed. This will not affect those who use the API provided by the library, but if you are compiling your application together with OpenLayers and using type names, you'll need to do the following:

  • rename ol.CollectionEventType to ol.Collection.EventType
  • rename ol.CollectionEvent to ol.Collection.Event
  • rename ol.ViewHint to ol.View.Hint
  • rename ol.ViewProperty to ol.View.Property
  • rename ol.render.webgl.imagereplay.shader.Default.Locations to ol.render.webgl.imagereplay.defaultshader.Locations
  • rename ol.render.webgl.imagereplay.shader.DefaultFragment to ol.render.webgl.imagereplay.defaultshader.Fragment
  • rename ol.render.webgl.imagereplay.shader.DefaultVertex to ol.render.webgl.imagereplay.defaultshader.Vertex
  • rename ol.renderer.webgl.map.shader.Default.Locations to ol.renderer.webgl.defaultmapshader.Locations
  • rename ol.renderer.webgl.map.shader.Default.Locations to ol.renderer.webgl.defaultmapshader.Locations
  • rename ol.renderer.webgl.map.shader.DefaultFragment to ol.renderer.webgl.defaultmapshader.Fragment
  • rename ol.renderer.webgl.map.shader.DefaultVertex to ol.renderer.webgl.defaultmapshader.Vertex
  • rename ol.renderer.webgl.tilelayer.shader.Fragment to ol.renderer.webgl.tilelayershader.Fragment
  • rename ol.renderer.webgl.tilelayer.shader.Locations to ol.renderer.webgl.tilelayershader.Locations
  • rename ol.renderer.webgl.tilelayer.shader.Vertex to ol.renderer.webgl.tilelayershader.Vertex
  • rename ol.webgl.WebGLContextEventType to ol.webgl.ContextEventType
  • rename ol.webgl.shader.Fragment to ol.webgl.Fragment
  • rename ol.webgl.shader.Vertex to ol.webgl.Vertex

Full list of changes