Skip to content
f86bad7
Compare
Choose a tag to compare

The 6.9 release brings a few new features and a number of fixes. GeoTIFF sources now have a normalize option. Set normalize: false if you want your style expressions to work with raw floating point values instead of normalized values from 0 to 1. The GeoTIFF source also now uses nodata values from the source imagery – so in most cases you don't need to specify this yourself. For people configuring vector layers with styles that use custom rendering, you can now get hit detection on the rendered result. See details on these features and other included fixes below.

Dependency Updates
b068a33
Compare
Choose a tag to compare

This is a patch release which updates ol.css to restore a legible control button size in applications that do not have a css font-size set for button elements.

a2d6bd3
Compare
Choose a tag to compare

The 6.8 release builds on the momentum of 6.7 with some great new enhancements. Data tiles now handle 32-bit data in addition to 8-bit. Views properties can now be provided that sources that fetch view-related data. Vector tile rendering got some performance enhancements. Find detail on these features and a number of fixes in the list of changes below.

List of all changes

Dependency Updates
b64b8af
Compare
Choose a tag to compare

The 6.7 release includes a great batch of usability improvements, fixes, and new features. See the full list of changes from 100 pull requests below, but here are some highlights:

  • New GeoTIFF source! With parsing support from the awesome geotiff.js library, you can now render layers from hosted GeoTIFF imagery. The GeoTIFF source gives you the ability to pull from multiple GeoTIFF images, read from arbitrary bands, run band math expressions, and style the imagery to your liking.
  • New WebGL tile renderer. The GeoTIFF source is rendered with a new WebGL-based tile renderer. In addition to GeoTIFFs, the renderer supports layers with a generic DataTile source – these can be used to render aribtrary raster data and leverage the same style expressions as described above.
  • More type checking. We continue to make improvements to the TypeScript definitions included in the ol package.
  • New sources supporting the draft OGC API - Tiles specification. The OGCMapTile and OGCVectorTile sources allow you to render data from services that implement the draft OGC tiles spec. Since the specification is not yet final, these sources are not yet part of the stable OpenLayers API and should be considered experimental.
  • Custom cluster creation support, improved KML icon rendering, lots of fixes, and more. See below for all the detail.

List of all changes

Dependency Updates
a8b949a
Compare
Choose a tag to compare

This is a bugfix release which brings improvements to the included TypeScript types, and fixes two minor issues with the Draw interaction and hit detection of regular shape symbols.

List of all changes

Dependency Updates
a59c80f
Compare
Choose a tag to compare

With more than 160 pull requests from 14 contributors, this release brings improved support for using OpenLayers in Node.js environments, a new WKB (well known binary) format, TypeScript declarations in the ol package, and more efficient vector tile rendering. In addition, several examples were added or improved, and many bugs were fixed.

Upgrade notes

Included TypeScript declarations

The ol package now includes TypeScript declarations as *.d.ts files.

If desired, e.g. when you don't want to adjust your code after upgrading from a previous version where you used @types/ol, you can opt out of the included types and use third-party types by specifying aliases in the compilerOptions section of tsconfig.json, e.g.

    "baseUrl": "./",
    "paths": {
      "ol": ["node_modules/@types/ol"],
      "ol/*": ["node_modules/@types/ol/*"]
    },

Deprecation of undefinedHTML option for the MousePosition control

The undefinedHTML option for the MousePosition control has been deprecated and will be removed in a future release. Use the new placeholder option instead.

New placeholder option for the MousePosition control

When the mouse position is not available, the control renders a non-breaking space. To render something else instead,
set the placeholder option. If you want to retain the last position when the mouse leaves the viewport, set
placeholder: false. This will be the default behavior in a future release.

The placeholder option has no effect if the deprecated undefinedHTML option is also used. You should use the placeholder option instead of undefinedHTML.

Deprecation of image render mode for vector tile layers

renderMode: 'image' for vector tile layers has been deprecated. Applications continue to work, but a warning will be issued to the console. To get rid of the warning, simply remove the renderMode option.

New features and improvements

  • New create-ol-app package to create a new app with an OpenLayers map.
  • Improved rendering quality of regular shapes and circles.
  • New placeholder option for better control of the MousePosition control's output.
  • TypeScript generated .d.ts files are now included in the ol package.
  • Improved zDirection option on tile sources to control when the tile z changes on fractional zoom levels.
  • Template mode for the TileDebug source for better debugging of tile coordinate issues.
  • More efficient vector tile rendering to save battery on mobile devices and memory.
  • New 'properties' option on layers for easier use of arbitrary properties in typed environments.
  • Hit detection support when using OffscreenCanvas and workers for rendering.
  • The ol package now uses "type": "module" in package.json for easier use of OpenLayers in Node.js.
  • New WKB (Well-Known Binary) format parser and serializer.
  • Console warning when map container's width or height are zero.
  • New snapToPointer option on the Modify interaction to control user experience when clicking a vertex far away from its center.

List of all changes

Dependency Updates
f72ab97
Compare
Choose a tag to compare

6.5.0

With more than 110 pull requests, this release not only brings WFS 2.0 support and improved touch support for drawing geometries and querying features. In addition to that, several improvements, many bugs fixes, and nicer API docs and examples have found their way into the 6.5.0 release.

Upgrade notes

Units of the hitTolerance option fixed

Previously, the hitTolerance option of the map's getFeaturesAtPixel(), forEachFeatureAtPixel() and hasFeatureAtPixel() methods behaved differently depending on the devicePixelRatio (or the pixelRatio of the map), because the original value was internally multiplied by the device pixel ratio twice instead of just once. Now this is fixed. Note: The hitTolerance's units are css pixels. The documentation was updated to reflect this.

If your application adjusts for that with code like

{ hitTolerance: 10 / devicePixelRatio, }

you'll have to change that code to

{ hitTolerance: 10, }

New features and improvements

  • New scale option in RegularShape and Circle style constructors
  • WFS 2.0.0 support
  • Added preRender and postRender methods to WebGLLayerRenderer
  • Added className constructor option in ol/layer/Heatmap
  • Added load events for ol/source/Vector
  • New iconUrlFunction option for ol/format/KML
  • Added transition option to OSM and CartoDB sources
  • DragAndDrop interaction support for formats that read ArrayBuffer sources
  • New padding option for ol/View
  • New cancel event for the DragBox interaction
  • When using hitTolerance, detect closest features first
  • Ability to draw Circle geometries with a custom renderer

List of all changes

Dependency Updates
246aded
Compare
Choose a tag to compare

This is a bugfix release which fixes a performance regression, a rendering issue, and adds improvements to a few examples.

See the v6.4.0 release notes for a complete list of changes and upgrade notes when upgrading from v6.3.x.

List of all changes

Dependency Updates
7c93439
Compare
Choose a tag to compare

This is a bugfix release which removes a few regressions that were introduced by v6.4.0, and fixes a few issues in examples.

See the v6.4.0 release notes for a complete list of changes and upgrade notes when upgrading from v6.3.x.

List of all changes

577c95e
Compare
Choose a tag to compare

6.4.1

This is a bugfix release which removes a few regressions that were introduced by v6.4.0, and fixes a few issues in examples caused by the website facelift.

List of all changes

Dependency Updates