The 7.2.2 release adds back missing symbols to the full build. See the changelog for 7.2.0 for new features and fixes since 7.1.

What's Changed

• Updates for the 7.2.1 release by @ahocevar in https://github.com/openlayers/openlayers/pull/14399
• Fix build index by @ahocevar in https://github.com/openlayers/openlayers/pull/14402

Full Changelog: https://github.com/openlayers/openlayers/compare/v7.2.1...v7.2.2

The 7.2.1 release is a patch to provide a working full build. See the changelog for 7.2.0 for new features and fixes since 7.1.

What's Changed

• Updates for the 7.2.0 release by @marcjansen in https://github.com/openlayers/openlayers/pull/14396
• Use custom query function to replace missing taffydb query features by @ahocevar in https://github.com/openlayers/openlayers/pull/14398

Full Changelog: https://github.com/openlayers/openlayers/compare/v7.2.0...v7.2.1

The 7.2 release includes …

• …some new features (e.g. for icon styling),
• …performance optimisations (e.g. for canvas rendering),
• …better interoperability (e.g. OGC API - Tiles support, saner projection-handling for GeoTIFFs and a new PMTiles example),
• …the usual smaller bugfixes, and
• …a lot of dependency updates.

Please find below four aspects of this release that we want to highlight and make sure to scan over the full list of included changes (even further below).

OGC vector and map tile sources are now a stable part of the API

The OGC API – Tiles core v1 spec has been published, and as a consequence we marked the long existing vector and map tile sources as part of the stable API.

Introduce width and height configuration options to Icon styles

It is now possible to create an icon symbolizer with an explicit width and/or height, e.g.:

const myIcon = new Icon({
  src: 'data/icon.png',
  width: 32,
  height: 32
});

This is an additional configuration option to make working with image icons easier.

Rendered resolutions of ol/source/Raster

Previously, ol/source/Raster processed input sources at the current view resolution, which caused interpolation artefacts in cases where input sources were up- or downsampled. Now, ol/source/Raster picks up the resolutions from the first input source that has resolutions configured (either implicitly through a tile grid in the case of tile sources, or directly when configured through the resolutions constructor option). This improves the rendered output in most cases.

If the previous behavior is desired, configure the source with resolutions: null.

Fixed wrapX behavior of ol/control/MousePosition

Previously, ol/control/MousePosition always displayed coordinates as-is. Now it has a wrapX option, which is true by default. This avoids longitudes aoutside the -180 to 180 degrees range.

If you want the previous behavior, which displays coordinates with longitudes less than -180 or greater than 180, configure the control with wrapX: false.

List of all changes

See below for a complete list of features and fixes.

• Fix types and docs for GeolocationError (by @ahocevar in https://github.com/openlayers/openlayers/pull/14395)
• Introduce width and height to Icon style (by @KaiVolland in https://github.com/openlayers/openlayers/pull/14364)
• Fix typo in Helper.js & inconsistency in ShaderBuilder.js comment. (by @Tomcariello in https://github.com/openlayers/openlayers/pull/14368)
• Rendering tests instead of unit tests for MapboxVector layer background (by @openlayers in https://github.com/openlayers/openlayers/pull/14355)
• Mark OGC tile sources as stable (by @tschaub in https://github.com/openlayers/openlayers/pull/14354)
• Calculate snap tolerance extent allowing for rotation (by @mike-000 in https://github.com/openlayers/openlayers/pull/14344)
• Updated extensions for Stamen tiles (by @tschaub in https://github.com/openlayers/openlayers/pull/14347)
• Convert closest point on geometry edge to user coordinates for snap (by @mike-000 in https://github.com/openlayers/openlayers/pull/14349)
• Fix immediate renderer image and text rotation in rotated canvas (by @mike-000 in https://github.com/openlayers/openlayers/pull/14333)
• Consider rotation when obtaining vector context pixel ratio (by @mike-000 in https://github.com/openlayers/openlayers/pull/14332)
• Update ArcGIS REST Feature Service example (by @mike-000 in https://github.com/openlayers/openlayers/pull/14296)
• Assign variable to work around swc minification problem (by @openlayers in https://github.com/openlayers/openlayers/pull/14320)
• Support better detection of projection in GeoTIFF files (by @ahocevar in https://github.com/openlayers/openlayers/pull/14321)
• Use ResizeObserver to detect resizes, also when in Shadow DOM (by @ahocevar in https://github.com/openlayers/openlayers/pull/14305)
• Ensure change:position event is fired if identify transform used (by @mike-000 in https://github.com/openlayers/openlayers/pull/14319)
• Rename numberSafeCompareFunction to ascending (by @tschaub in https://github.com/openlayers/openlayers/pull/14311)
• Change ela-compil url (by @fredj in https://github.com/openlayers/openlayers/pull/14301)
• Update sponsors (by @ahocevar in https://github.com/openlayers/openlayers/pull/14293)
• Remove unused arguments (by @ahocevar in https://github.com/openlayers/openlayers/pull/14292)
• Also set version in full build (by @openlayers in https://github.com/openlayers/openlayers/pull/14288)
• Update example showing COG with external overviews (by @tschaub in https://github.com/openlayers/openlayers/pull/14286)
• Add resolutions option to Raster source (by @ahocevar in https://github.com/openlayers/openlayers/pull/14282)
• Handle layers that do not have a source yet (by @openlayers in https://github.com/openlayers/openlayers/pull/14280)
• Remove Babel (by @tschaub in https://github.com/openlayers/openlayers/pull/14279)
• Configurable log level (by @tschaub in https://github.com/openlayers/openlayers/pull/14278)
• Update geotiff to v2.0.7 (by @ahocevar in https://github.com/openlayers/openlayers/pull/14257)
• Include file extensions in examples and docs (by @tschaub in https://github.com/openlayers/openlayers/pull/14263)
• Avoid creating tiles with one row each (by @tschaub in https://github.com/openlayers/openlayers/pull/14260)
• Add support for images in data tiles (by @tschaub in https://github.com/openlayers/openlayers/pull/14258)
• Add a PMTiles example (by @tschaub in https://github.com/openlayers/openlayers/pull/14256)
• Update more COG paths (by @mike-000 in https://github.com/openlayers/openlayers/pull/14252)
• Update ArcGIS MapServer examples service url (by @mike-000 in https://github.com/openlayers/openlayers/pull/14251)
• Use wkt definitions in EPSG.io Search example (by @mike-000 in https://github.com/openlayers/openlayers/pull/14239)
• Update COG path (by @mike-000 in https://github.com/openlayers/openlayers/pull/14236)
• Add wrapX support to the MousePosition control (by @openlayers in https://github.com/openlayers/openlayers/pull/14232)
• Minor fixes to ReprojDataTile tests (by @mike-000 in https://github.com/openlayers/openlayers/pull/14217)
• Pass transition option along to reproj data tile (by @tschaub in https://github.com/openlayers/openlayers/pull/14216)
• Set willReadFrequently option on ol/source/Raster shared context (by @mike-000 in https://github.com/openlayers/openlayers/pull/14215)
• Do not use .getImageData where .createImageData can be used (by @mike-000 in https://github.com/openlayers/openlayers/pull/14213)
• Set willReadFrequently option on pixel contexts (by @ahocevar in https://github.com/openlayers/openlayers/pull/14204)
• Create hit and taint detection canvas with willReadFrequently set to true (by @ahocevar in https://github.com/openlayers/openlayers/pull/14203)
• Use jsdelivr instead of unpkg (by @openlayers in https://github.com/openlayers/openlayers/pull/14200)
• Take scale transform into account for viewport pixels (by @ahocevar in https://github.com/openlayers/openlayers/pull/14199)
• Typo were => where (by @nboisteault in https://github.com/openlayers/openlayers/pull/14197)
• RenderFeature cannot be modified (by @MoonE in https://github.com/openlayers/openlayers/pull/14194)
• Typo (by @JakobMiksch in https://github.com/openlayers/openlayers/pull/14195)
• Translate interaction can't work with RenderFeature (by @MoonE in https://github.com/openlayers/openlayers/pull/14172)
• Only TileImage as ReprojTile source tile type (by @MoonE in https://github.com/openlayers/openlayers/pull/14173)
• Correct return type for ol/layer/VectorTile~getFeatures() (by @MoonE in https://github.com/openlayers/openlayers/pull/14165)
• Use arrow functions instead of binding anonymous functions (by @tschaub in https://github.com/openlayers/openlayers/pull/14170)
• Fix if condition in clusters-dynamic example (by @ahocevar in https://github.com/openlayers/openlayers/pull/14150)
• hitdetect GeometryCollection (by @MoonE in https://github.com/openlayers/openlayers/pull/14138)
• Make track properties in Link interaction configurable (by @ahocevar in https://github.com/openlayers/openlayers/pull/14126)
• Add a sourceready event to layers (by @tschaub in https://github.com/openlayers/openlayers/pull/14124)
• Add support for fetching proj4 definitions from epsg.io (by @tschaub in https://github.com/openlayers/openlayers/pull/14122)
• Avoid the redirect to the OL 2 page (by @tschaub in https://github.com/openlayers/openlayers/pull/14118)
• No else after return (by @tschaub in https://github.com/openlayers/openlayers/pull/14103)
• Fix WMTS source key (by @ahocevar in https://github.com/openlayers/openlayers/pull/14100)
• Reproject DataTiles (by @mike-000 in https://github.com/openlayers/openlayers/pull/13654)
• Updates for ol-mapbox-style v9.2 (by @ahocevar in https://github.com/openlayers/openlayers/pull/14086)
• Add version dropdown for API link (by @KaiVolland in https://github.com/openlayers/openlayers/pull/14085)
• Updates for the 7.1.0 release (by @openlayers in https://github.com/openlayers/openlayers/pull/14082)

New Contributors

• @nboisteault made their first contribution in https://github.com/openlayers/openlayers/pull/14197
• @Tomcariello made their first contribution in https://github.com/openlayers/openlayers/pull/14368

Full Changelog: https://github.com/openlayers/openlayers/compare/v7.1.0...v7.2.0

The 7.1 release adds a handful of new features and updates the story for users of the full library build.

Draw with tracing

The draw interaction has a new trace option. When this is set, you can click on existing features to trace their outlines while creating new polygons or lines.

New GeoTIFF options

The GeoTIFF source now supports imagery with internal masks. In addition, the GeoTIFF source accepts a convertToRGB: 'auto' setting. With this new setting, the values will be converted to RGB in cases where the input data has three bands and the photometric interpretation is one of CMYK, YCbCr, CIELab, or ICCLab.

Notice to full build users

If you have been using the full build of the library, we now include this full build in the release package. This should mean stable URLs that you can point to in a <script> tag. See the https://openlayers.org/download/ page for more detail.

Deprecation of ol/AssertionError and error codes

Future versions will no longer throw ol/AssertionError with an error code. Instead, they will throw Error with just the error message.

Updating parameters in ol/source/ImageWMS and ol/source/TileWMS

The updateParams() method is the only way to update WMS parameters. Changes made directly to the params object passed as a constructor option will have no effect.

List of all changes

See below for a complete list of features and fixes.

• Fix control styles on Full Screen Mobile example (by @mike-000 in https://github.com/openlayers/openlayers/pull/14079)
• Include the full build in the ol package (by @openlayers in https://github.com/openlayers/openlayers/pull/14067)
• Add support for auto conversion to RGB (by @tschaub in https://github.com/openlayers/openlayers/pull/14066)
• Avoid stuck maps when resolving views from a GeoTIFF (by @tschaub in https://github.com/openlayers/openlayers/pull/14064)
• GeoTIFF mask support (by @tschaub in https://github.com/openlayers/openlayers/pull/14063)
• Use preferred tile.openstreetmap.org URL (by @Firefishy in https://github.com/openlayers/openlayers/pull/14062)
• Clarify proj4 version (by @ahocevar in https://github.com/openlayers/openlayers/pull/14061)
• Fix register import (by @openlayers in https://github.com/openlayers/openlayers/pull/14059)
• Clone the WMS params option (by @mike-000 in https://github.com/openlayers/openlayers/pull/14048)
• Clear cache when WebGL tile layer source reset (by @mike-000 in https://github.com/openlayers/openlayers/pull/14015)
• Consider both tracing directions when within snap tolerance (by @tschaub in https://github.com/openlayers/openlayers/pull/14057)
• Fix WebGL preload and empty reproj tiles (by @mike-000 in https://github.com/openlayers/openlayers/pull/14051)
• Avoid rate limits from the GitHub API (by @tschaub in https://github.com/openlayers/openlayers/pull/14056)
• Support tracing with the draw interaction (by @tschaub in https://github.com/openlayers/openlayers/pull/14046)
• Improve some examples (by @MoonE in https://github.com/openlayers/openlayers/pull/14039)
• Show how to use Skypack (by @ahocevar in https://github.com/openlayers/openlayers/pull/14038)
• Update to bootstrap 5.2 (by @MoonE in https://github.com/openlayers/openlayers/pull/13996)
• Move assertion messages into code and deprecate AssertionError (by @ahocevar in https://github.com/openlayers/openlayers/pull/14030)
• New URL to check for latest release (by @tschaub in https://github.com/openlayers/openlayers/pull/14025)
• Link to latest 6.x release (by @tschaub in https://github.com/openlayers/openlayers/pull/14026)
• Do not display TileJSON attributions if empty string (by @mike-000 in https://github.com/openlayers/openlayers/pull/14023)
• Updates for the 7.0.0 release (by @openlayers in https://github.com/openlayers/openlayers/pull/14019)

New Contributors

• @Firefishy made their first contribution in https://github.com/openlayers/openlayers/pull/14062

Full Changelog: https://github.com/openlayers/openlayers/compare/v7.0.0...v7.1.0

The 7.0 release includes an impressive batch of features and fixes from over 90 pull requests. We're excited about a new foundation for WebGL vector rendering. The previous point rendering functionality has been extended to include lines and polygons. The rendering API is still low level and experimental. Future releases will include a higher level styling API.

In developing the new WebGL rendering functionality, we changed the signature for a number of methods on a helper class that had been marked as part of the API in 6.x releases. While this is technically a breaking change, it is unlikely that applications were using this helper class, so upgrades should be straightforward.

We took advantage of the breaking change in the WebGL helper class to remove a few other deprecated parts of the API. In addition, since Microsoft ended support for Internet Explorer a few months ago, we decided to do the same.

Backwards incompatible changes

Removal of deprecated properties and methods

• The tilePixelRatio has been removed from the DataTile source.
• The imageSmoothing option has been removed from sources.
• The undefinedHTML option has been removed from the MousePosition control.
• The forEachLayerAtPixel method has been removed from the Map class.
• Deprecated options have been removed from the Overlay component.
• The labelCache has been removed from the ol/render/canvas.js module.

Internet Explorer is no longer supported

Please see https://docs.microsoft.com/en-us/lifecycle/announcements/internet-explorer-11-end-of-support.

ol/webgl/Helper.js

The Helper constructor from the ol/webgl/Helper.js module is no longer part of the public API.

ol/coordinate.js

The toStringHDMS function from the ol/coordinate.js module now formats longitude, latitude pairs so that the minutes and seconds are omitted if they are zero. This changes the values displayed on graticules.

ol/layer/Graticule

The default intervals now align with integer minutes and seconds better suited to the default label formatter. If formatting in decimal degrees you may wish to specify custom intervals suited to that format.

ol/Collection

Inserting with setAt or insertAt beyond the current length used to create a sparse Collection with undefined inserted for any missing indexes. This will now throw an error instead.

ol/control/MousePosition

The control will now by default keep displaying the last mouse position when the mouse leaves the viewport. With placeholder: ' ' you can keep the old behaviour. The placeholder option no longer accepts false as a valid value, instead simply omit the option. The undefinedHTML option has been removed. You should use placeholder instead.

ol/PluggableMap

The PluggableMap class has been removed. If you want to create a custom map class, extend the Map class instead.

ol/style/Icon and ol/style/RegularShape

ol/style/Image and subclasses displacement is no longer scaled with the image. If you previously expected this unintended behavior you should now increase the displacement when setting the scale.

List of all changes

See below for a complete list of features and fixes.

• Make the website deploy job succeed even if there are no changes (by @tschaub in https://github.com/openlayers/openlayers/pull/14017)
• Release actions (by @tschaub in https://github.com/openlayers/openlayers/pull/14014)
• Properly clear and refresh reprojected sources (by @ahocevar in https://github.com/openlayers/openlayers/pull/14013)
• Remove ENABLE_RASTER_REPROJECTION flag (by @ahocevar in https://github.com/openlayers/openlayers/pull/14011)
• Force render after update in Icon Scale example (by @mike-000 in https://github.com/openlayers/openlayers/pull/14012)
• Update ol-mapbox-style to v9.0.0 (by @ahocevar in https://github.com/openlayers/openlayers/pull/14009)
• Replace the Icon Scale example (by @mike-000 in https://github.com/openlayers/openlayers/pull/14007)
• Improve description of displacement in docs (by @mike-000 in https://github.com/openlayers/openlayers/pull/14006)
• Remove IE workarounds for legacy build, examples, and workers (by @tschaub in https://github.com/openlayers/openlayers/pull/13995)
• Use the full table for constructor options (by @tschaub in https://github.com/openlayers/openlayers/pull/13998)
• Do not scale Icon and RegularShape displacement (by @mike-000 in https://github.com/openlayers/openlayers/pull/13975)
• Support user projections in Drag and Drop (by @mike-000 in https://github.com/openlayers/openlayers/pull/14003)
• Avoid append only cache in WebGL tile layers (by @tschaub in https://github.com/openlayers/openlayers/pull/13997)
• Fix immediate renderer text rotation with offset (by @mike-000 in https://github.com/openlayers/openlayers/pull/13981)
• Build and deploy the website (by @openlayers in https://github.com/openlayers/openlayers/pull/13984)
• Small example template fixes (by @marcjansen in https://github.com/openlayers/openlayers/pull/13992)
• Fix wording in API docs (by @marcjansen in https://github.com/openlayers/openlayers/pull/13991)
• Nicer links in the API docs (by @tschaub in https://github.com/openlayers/openlayers/pull/13970)
• Minor adjustments to the website style (by @tschaub in https://github.com/openlayers/openlayers/pull/13989)
• Fix copying of non-linked ol.css, clean example build (by @MoonE in https://github.com/openlayers/openlayers/pull/13988)
• Fix kml-timezone example calculations (by @MoonE in https://github.com/openlayers/openlayers/pull/13982)
• Fix some errors in examples (by @MoonE in https://github.com/openlayers/openlayers/pull/13977)
• Update FontAwesome to v6.1.2 (by @MoonE in https://github.com/openlayers/openlayers/pull/13978)
• Use correct bands with LUMINANCE_ALPHA (by @mike-000 in https://github.com/openlayers/openlayers/pull/13974)
• Remove opt_ prefix (by @tschaub in https://github.com/openlayers/openlayers/pull/13972)
• Fix bandcount per texture for 8, 12, 16, etc. bands (by @mike-000 in https://github.com/openlayers/openlayers/pull/13973)
• Do not apply #12467 change to Icons (by @mike-000 in https://github.com/openlayers/openlayers/pull/13955)
• Remove more IE compatibility (by @MoonE in https://github.com/openlayers/openlayers/pull/13971)
• Remove workaround and docs for IE 11 (by @tschaub in https://github.com/openlayers/openlayers/pull/13965)
• Remove circular dependency (by @tschaub in https://github.com/openlayers/openlayers/pull/13967)
• Update link to sponsors (by @tschaub in https://github.com/openlayers/openlayers/pull/13968)
• Bundle code for the map on the homepage (by @tschaub in https://github.com/openlayers/openlayers/pull/13966)
• Website build (by @tschaub in https://github.com/openlayers/openlayers/pull/13961)
• Remove polyfills for IE and Android 4 (by @tschaub in https://github.com/openlayers/openlayers/pull/13963)
• Replace VERSION in un-transpiled source (by @MoonE in https://github.com/openlayers/openlayers/pull/13957)
• Use const in docs and other places (by @MoonE in https://github.com/openlayers/openlayers/pull/13958)
• Add few missing new lines in example source listing (by @MoonE in https://github.com/openlayers/openlayers/pull/13959)
• Fix js error in api pages on load (by @MoonE in https://github.com/openlayers/openlayers/pull/13956)
• Minor simplification (by @JakobMiksch in https://github.com/openlayers/openlayers/pull/13953)
• Fix typo and formatting in upgrade notes (by @mike-000 in https://github.com/openlayers/openlayers/pull/13946)
• Fixes to export examples (by @mike-000 in https://github.com/openlayers/openlayers/pull/13947)
• Fix WebGL points layer flaky test (by @jahow in https://github.com/openlayers/openlayers/pull/13944)
• Scaleline (by @MoonE in https://github.com/openlayers/openlayers/pull/13943)
• Improve loading of kmz file in example (by @MoonE in https://github.com/openlayers/openlayers/pull/13942)
• Fix KML default icon anchor with https icon url (by @MoonE in https://github.com/openlayers/openlayers/pull/13941)
• Use nicer functions, remove old code (by @MoonE in https://github.com/openlayers/openlayers/pull/13937)
• Render vector tile vectors in correct sequence for the postrender event (by @ahocevar in https://github.com/openlayers/openlayers/pull/13939)
• Remove workaround for missing TypedArray.from function (by @MoonE in https://github.com/openlayers/openlayers/pull/13936)
• Remove check for context.setLineDash (by @MoonE in https://github.com/openlayers/openlayers/pull/13933)
• Remove deprecated DataTile source tilePixelRatio (by @mike-000 in https://github.com/openlayers/openlayers/pull/13930)
• Remove input type="range" change event listeners where input events are also used (by @mike-000 in https://github.com/openlayers/openlayers/pull/13932)
• Remove deprecated imageSmoothing source options (by @mike-000 in https://github.com/openlayers/openlayers/pull/13931)
• Updated map background (by @tschaub in https://github.com/openlayers/openlayers/pull/13926)
• Include babel for CodeSandbox (by @tschaub in https://github.com/openlayers/openlayers/pull/13923)
• Remove reference to ES6 as ES2017 already listed (by @mike-000 in https://github.com/openlayers/openlayers/pull/13922)
• Style updates for examples and API docs (by @tschaub in https://github.com/openlayers/openlayers/pull/13917)
• Remove Google Analytics and cookie consent (by @tschaub in https://github.com/openlayers/openlayers/pull/13916)
• Fix map render test (by @MoonE in https://github.com/openlayers/openlayers/pull/13915)
• Uniformly grayscale controls (by @tschaub in https://github.com/openlayers/openlayers/pull/13908)
• Remove PluggableMap (by @tschaub in https://github.com/openlayers/openlayers/pull/13914)
• Remove MousePosition's deprecated undefinedHTML option (by @MoonE in https://github.com/openlayers/openlayers/pull/13911)
• Remove IconImage color fallback for IE (by @MoonE in https://github.com/openlayers/openlayers/pull/13912)
• Remove IE fallbacks (by @MoonE in https://github.com/openlayers/openlayers/pull/13907)
• Fix editing of export-map example on codesandbox (by @MoonE in https://github.com/openlayers/openlayers/pull/13910)
• Improve Collection type-safety (by @MoonE in https://github.com/openlayers/openlayers/pull/13902)
• Re-export the link interaction from the interactions module (by @tschaub in https://github.com/openlayers/openlayers/pull/13906)
• Replace enums with typedefs (by @MoonE in https://github.com/openlayers/openlayers/pull/13905)
• Accept an object literal for static layer styling (by @tschaub in https://github.com/openlayers/openlayers/pull/13900)
• Update jsdoc-plugin-typescript to fix markdown in type annotations (by @ahocevar in https://github.com/openlayers/openlayers/pull/13903)
• Wait until first load to create icon image (by @tschaub in https://github.com/openlayers/openlayers/pull/13899)
• Make Text options typesafe (by @MoonE in https://github.com/openlayers/openlayers/pull/13901)
• Align graticule default intervals to minutes and seconds (by @mike-000 in https://github.com/openlayers/openlayers/pull/13897)
• Publish untranspiled sources (by @tschaub in https://github.com/openlayers/openlayers/pull/13891)
• Improve reprojection WMS config for better performance (by @ahocevar in https://github.com/openlayers/openlayers/pull/13880)
• Omit minutes and seconds from HDMS formatting if zero (by @tschaub in https://github.com/openlayers/openlayers/pull/13893)
• Use Object.assign (by @tschaub in https://github.com/openlayers/openlayers/pull/13888)
• Remove unused worker (by @tschaub in https://github.com/openlayers/openlayers/pull/13892)
• Remove find and findIndex from array module (by @tschaub in https://github.com/openlayers/openlayers/pull/13887)
• Use Math.cosh and Math.log2 (by @tschaub in https://github.com/openlayers/openlayers/pull/13890)
• Use Object.values (by @tschaub in https://github.com/openlayers/openlayers/pull/13889)
• Remove workaround for Array.prototype.includes (by @tschaub in https://github.com/openlayers/openlayers/pull/13884)
• Codesandbox and bundler improvements for examples (by @ahocevar in https://github.com/openlayers/openlayers/pull/13879)
• Remove deprecated method PluggableMap#forEachLayerAtPixel ... (by @MoonE in https://github.com/openlayers/openlayers/pull/13868)
• Remove unused assertion numbers (by @MoonE in https://github.com/openlayers/openlayers/pull/13869)
• Remove deprecated Overlay options (by @MoonE in https://github.com/openlayers/openlayers/pull/13838)
• WebGL vector renderer for polygons, lines and points (by @jahow in https://github.com/openlayers/openlayers/pull/13461)
• Fix reloading tiles in case of an error with tile.load() (by @ahocevar in https://github.com/openlayers/openlayers/pull/13863)
• Handle multipolygons with empty polygons (by @ahocevar in https://github.com/openlayers/openlayers/pull/13860)
• Replace enums with typedef (by @MoonE in https://github.com/openlayers/openlayers/pull/13858)
• Remove deprecated label cache (by @MoonE in https://github.com/openlayers/openlayers/pull/13837)
• Update dev version to 7.0.0 (by @MoonE in https://github.com/openlayers/openlayers/pull/13850)
• Release v6.15.1 (by @openlayers in https://github.com/openlayers/openlayers/pull/13852)
• Recover from incorrect rebase after removal of string enums (by @ahocevar in https://github.com/openlayers/openlayers/pull/13835)
• Updates for the 6.15.0 release (by @openlayers in https://github.com/openlayers/openlayers/pull/13851)

The 6.15.1 release is a patch to ensure that a layer gets rendered when its source has completed loading. See the changelog for 6.15.0 for new features and fixes since 6.14.

List of all changes:

• Recover from incorrect rebase after removal of string enums (in #13835 by @ahocevar)

Full Changelog: https://github.com/openlayers/openlayers/compare/v6.15.0...v6.15.1

Overview

The 6.15 release brings several fixes and improvements:

• Faster vector tile rendering for soures with non-standard tile grids
• Reduced canvas memory footprint for increased stability on iOS devices and better rendering performance
• Fixed a bug that prevented tiles from expiring from the tile cache in the correct order
• Better type safety with an increasing number of null checks and union types
• New setFill and setStroke methods for RegularShape symbols
• Vector symbol and text decluttering on the style level
• Fixed pointer event handling on touch devices when layer visibility changes
• New justify option for text styles
• New Link interation for adding center, zoom, rotation and active layers to the URL
• Easier css styling of the scale bar, and in addition to minWidth, the scale line can now also be configured with a maxWidth

Details

Deprecated tilePixelRatio option for data tile sources.

If you were previously trying to scale data tiles using the tilePixelRatio property for data tile sources (this is rare), you should now use the explicit tileSize and tileGrid properties. The source's tileSize represents the source tile dimensions and the tile grid's tileSize represents the desired rendered dimensions.

const source = new DataTileSource({
  tileSize: [512, 512], // source tile size
  tileGrid: createXYZ({tileSize: [256, 256]}), // rendered tile size
});

Fixed coordinate dimension handling in ol/proj's addCoordinateTransforms

The forward and inverse functions passed to addCooordinateTransforms now receive a coordinate with all dimensions of the original coordinate, not just two. If you previosly had coordinates with more than two dimensions and added a transform like

addCoordinateTransforms(
    'EPSG:4326',
    new Projection({code: 'latlong', units: 'degrees'}),
    function(coordinate) { return coordinate.reverse(); },
    function(coordinate) { return coordinate.reverse(); }
);

you have to change that to

addCoordinateTransforms(
    'EPSG:4326',
    new Projection({code: 'latlong', units: 'degrees'}),
    function(coordinate) { return coordinate.slice(0, 2).reverse() },
    function(coordinate) { return coordinate.slice(0, 2).reverse() }
);

Replacement of string enums with union types

This change only affects users that were using the non-API string enums

• ol/OverlayPositioning
• ol/extent/Corner
• ol/format/FormatType
• ol/geom/GeometryType
• ol/source/State
• ol/source/WMSServerType
• ol/source/WMTSRequestEncoding

Instead of these, use the respective strings, which are now typesafe by means of union types.

List of all changes

See below for a complete list of features and fixes.

• Base vector tile render tile grid on the source grid (by @mike-000 in https://github.com/openlayers/openlayers/pull/13832)
• ability to change the color of the scalebar (by @jipexu in https://github.com/openlayers/openlayers/pull/13834)
• Reduce canvas memory footprint for better iOS stability (by @ahocevar in https://github.com/openlayers/openlayers/pull/13823)
• Use union types instead of enums (by @ahocevar in https://github.com/openlayers/openlayers/pull/12696)
• remove XYZ-ESRI -4326-512 example (by @jipexu in https://github.com/openlayers/openlayers/pull/13817)
• Remove HERE Maps example (by @mike-000 in https://github.com/openlayers/openlayers/pull/13819)
• Checkcontenteditable (by @jipexu in https://github.com/openlayers/openlayers/pull/13787)
• Add null return type for TileGrid functions (by @EvertEt in https://github.com/openlayers/openlayers/pull/13674)
• Add setFill and setStroke to Shapes (by @theduckylittle in https://github.com/openlayers/openlayers/pull/13747)
• Include displacement and declutterMode in Icon style clone (by @mike-000 in https://github.com/openlayers/openlayers/pull/13803)
• Do not refresh use time for tiles when collecting used source tiles (by @M393 in https://github.com/openlayers/openlayers/pull/13799)
• Change WKB readFeature(s) return type to Feature (by @mike-000 in https://github.com/openlayers/openlayers/pull/13800)
• d3 version update (by @jipexu in https://github.com/openlayers/openlayers/pull/13784)
• Better fix for changing pointer ids on event target change (by @ahocevar in https://github.com/openlayers/openlayers/pull/13771)
• Fix source band calculation when configured with multiple sources (by @ahocevar in https://github.com/openlayers/openlayers/pull/13762)
• Clean up tracked pointers when the event target has changed (by @ahocevar in https://github.com/openlayers/openlayers/pull/13770)
• Fix modifying polygons with overlapping vertices (by @hargasinski in https://github.com/openlayers/openlayers/pull/13745)
• Support GML polygons with ring curves instead of linear rings (by @ahocevar in https://github.com/openlayers/openlayers/pull/13749)
• Fix typo in method names (by @MoonE in https://github.com/openlayers/openlayers/pull/13750)
• Load GeoTiff from Blob #13189 #13703 (by @m-mohr in https://github.com/openlayers/openlayers/pull/13724)
• improve text width calculation (by @IQGeo in https://github.com/openlayers/openlayers/pull/12106)
• Fix tile pyramid getData() (by @mike-000 in https://github.com/openlayers/openlayers/pull/13712)
• Improve icon-sprite-webgl example (by @MoonE in https://github.com/openlayers/openlayers/pull/13709)
• Fix hitdetection for icon with offset and pixelratio != 1 (by @MoonE in https://github.com/openlayers/openlayers/pull/13627)
• Wait for icons to be loaded before firing rendercomplete event (by @MoonE in https://github.com/openlayers/openlayers/pull/13626)
• Change typedef to boolean (by @mike-000 in https://github.com/openlayers/openlayers/pull/13702)
• #13690 VectorSource#getFeaturesInExtent add projection parameter (by @burleight in https://github.com/openlayers/openlayers/pull/13691)
• Update ESLint config and plugins (by @tschaub in https://github.com/openlayers/openlayers/pull/13701)
• Flip extent coordinates for projections with ne* axis order (by @ahocevar in https://github.com/openlayers/openlayers/pull/13688)
• Link interaction (by @tschaub in https://github.com/openlayers/openlayers/pull/13689)
• Test improvements (by @MoonE in https://github.com/openlayers/openlayers/pull/13676)
• Add null return type (by @ahocevar in https://github.com/openlayers/openlayers/pull/13673)
• fix currentClip == null (by @CNS-Solutions in https://github.com/openlayers/openlayers/pull/13672)
• Handle NaN nodata (by @tschaub in https://github.com/openlayers/openlayers/pull/13669)
• Fix for parcel error while building examples (by @arekgotfryd in https://github.com/openlayers/openlayers/pull/13656)
• Explicit data tile size (by @tschaub in https://github.com/openlayers/openlayers/pull/13648)
• Decluttering mode by style (by @CNS-Solutions in https://github.com/openlayers/openlayers/pull/13566)
• Output GeoTIFF tile load errors to console (by @mike-000 in https://github.com/openlayers/openlayers/pull/13645)
• Fix typos in upgrade notes (by @openlayers in https://github.com/openlayers/openlayers/pull/13641)
• Let transform function transform all dimensions it is capable of (by @ahocevar in https://github.com/openlayers/openlayers/pull/13637)
• Fix dependabot config (by @tschaub in https://github.com/openlayers/openlayers/pull/13614)
• Include GitHub actions in the dependabot config (by @turrisxyz in https://github.com/openlayers/openlayers/pull/13611)
• Do not reload data tiles if already loaded or loading (by @mike-000 in https://github.com/openlayers/openlayers/pull/13594)
• Limit permissions for GitHub actions (by @turrisxyz in https://github.com/openlayers/openlayers/pull/13607)
• Handle rotation with non-square tiles (by @tschaub in https://github.com/openlayers/openlayers/pull/13603)
• Properly document loadstart and loadend events (by @ahocevar in https://github.com/openlayers/openlayers/pull/13595)
• Update OSM Vector Tiles attribution (by @mike-000 in https://github.com/openlayers/openlayers/pull/13568)
• WebGLPointsLayer wrapX support - partially addressing #11131 (by @burleight in https://github.com/openlayers/openlayers/pull/13528)
• Add justify option for text style (by @rycgar in https://github.com/openlayers/openlayers/pull/13571)
• Do not assert null projection (by @mike-000 in https://github.com/openlayers/openlayers/pull/13565)
• Improve Projection and Scale example calculations (by @mike-000 in https://github.com/openlayers/openlayers/pull/13496)
• Add geometryLayout property to Draw interaction (by @drnextgis in https://github.com/openlayers/openlayers/pull/13546)
• Updates for ol-mapbox-style v8 (by @ahocevar in https://github.com/openlayers/openlayers/pull/13552)
• NM symbol unit (by @jipexu in https://github.com/openlayers/openlayers/pull/13554)
• Update backgrounds when function returns a different color (by @ahocevar in https://github.com/openlayers/openlayers/pull/13550)
• Handle gutter in WebGL tile renderer (by @mike-000 in https://github.com/openlayers/openlayers/pull/13547)
• Do not add second interaction in Pinch Zoom example (by @mike-000 in https://github.com/openlayers/openlayers/pull/13551)
• Bugfix for GML parsing with multiple property elements with XML attributes (by @ejn in https://github.com/openlayers/openlayers/pull/12936)
• Fix small typo in docs (by @bartvde in https://github.com/openlayers/openlayers/pull/13536)
• Update type annotations for GMLBase (by @ahocevar in https://github.com/openlayers/openlayers/pull/13533)
• Add optional maxWidth for ScaleLine control (by @bartvde in https://github.com/openlayers/openlayers/pull/13531)
• Include tile gutter in offsets for getData() methods (by @mike-000 in https://github.com/openlayers/openlayers/pull/13521)
• Updates for the 6.14.1 release (by @openlayers in https://github.com/openlayers/openlayers/pull/13511)

New Contributors

• @burleight made their first contribution in https://github.com/openlayers/openlayers/pull/13528
• @naveensrinivasan made their first contribution in https://github.com/openlayers/openlayers/pull/13607
• @cns-solutions-admin made their first contribution in https://github.com/openlayers/openlayers/pull/13566
• @arekgotfryd made their first contribution in https://github.com/openlayers/openlayers/pull/13656
• @luiscamachopt made their first contribution in https://github.com/openlayers/openlayers/pull/12106
• @m-mohr made their first contribution in https://github.com/openlayers/openlayers/pull/13724
• @hargasinski made their first contribution in https://github.com/openlayers/openlayers/pull/13745

Full Changelog: https://github.com/openlayers/openlayers/compare/v6.14.1...v6.15.0

The 6.14.1 release is a patch to correct a version discrepancy in the package-lock.json file. See the changelog for 6.14.0 for new features and fixes since 6.13.

The 6.14 release includes a few new features and fixes. The new loadstart and loadend events make it easy to add loading indicators to your maps. Enhancements to the snap interaction add support for snapping to points coincident with lines and improve performance. A change to WebGL rendering works around an issue in Safari 15.4. Find detail on these improvements and more in the full list of changes below.

List of all changes

See below for a complete list of features and fixes.

• Store rendered source on the layer instead of the layer state (by @tschaub in https://github.com/openlayers/openlayers/pull/13509)
• Change imageSmoothing to interpolate in tests (by @mike-000 in https://github.com/openlayers/openlayers/pull/13506)
• Fallback if OES_texture_float_linear is not supported (by @mike-000 in https://github.com/openlayers/openlayers/pull/13505)
• Workaround for Safari WebGL issue (by @tschaub in https://github.com/openlayers/openlayers/pull/13492)
• Separate geometry and extent parsing (by @ahocevar in https://github.com/openlayers/openlayers/pull/13490)
• Add loadstart and loadend map events (by @ahocevar in https://github.com/openlayers/openlayers/pull/13491)
• Add documentation for precompose and postcopose to ol/layer/WebGLTile (by @ahocevar in https://github.com/openlayers/openlayers/pull/13482)
• Fix legacy build (by @ahocevar in https://github.com/openlayers/openlayers/pull/13469)
• Fix Text#setText jsDoc (by @rycgar in https://github.com/openlayers/openlayers/pull/13466)
• Do not warn about coordinates when view projection is configured (by @ahocevar in https://github.com/openlayers/openlayers/pull/13464)
• Reset image when empty (by @ahocevar in https://github.com/openlayers/openlayers/pull/13463)
• Revert image transition regression (by @ahocevar in https://github.com/openlayers/openlayers/pull/13460)
• Improve Snap interaction performance (by @MoonE in https://github.com/openlayers/openlayers/pull/13455)
• Snap Interaction can snap to Point on line segment (by @T-MAPY in https://github.com/openlayers/openlayers/pull/13446)
• Initialize variable before use in FullScreen control (by @MoonE in https://github.com/openlayers/openlayers/pull/13447)
• Ensure FullScreen button has classname set on render. (by @themoffster in https://github.com/openlayers/openlayers/pull/13444)
• Guard PluggableMap against null renderer (by @EvertEt in https://github.com/openlayers/openlayers/pull/13437)
• Fix rendercomplete with invisible WebGLPoints layer (by @M393 in https://github.com/openlayers/openlayers/pull/13434)
• Handle layers without renderer properly (by @ahocevar in https://github.com/openlayers/openlayers/pull/13424)

New Contributors

• @themoffster made their first contribution in https://github.com/openlayers/openlayers/pull/13444
• @langpavel made their first contribution in https://github.com/openlayers/openlayers/pull/13446
• @rycgar made their first contribution in https://github.com/openlayers/openlayers/pull/13466

Full Changelog: https://github.com/openlayers/openlayers/compare/v6.13.0...v6.14.0

Overview

The 6.13 release brings several exciting new features and improvements:

• A new layer.getData() method to get pixel data for a single layer (see details below).
• Support for rich text labels in ol/style/Text, to use different font styles and fonts in a single label.
• The useGeograpic() and setUserProjection() functions in the ol/proj module are now part of the official API. These functions make it easier to work with geographic coordinates or local projections.
• Improvements for WebGL Tile and Points layers.
• Performance improvements on ol/Feature, to avoid event creation when there are no listeners.
• Update of geotiff.js to v2, to fix some build issues that users reported.
• Improvements to the auto-generated TypeScript types.

Details

New layer.getData() method

Raster layers (static images, image tiles, data tiles) have a new layer.getData(pixel) method that returns the pixel data at the provided location. The return value depends on the underlying source data type. For example, a GeoTIFF may return a Float32Array with one value per band, while a PNG rendered from a tile layer will return a Uint8ClampedArray of RGBA values.

If you were previously using the map.forEachLayerAtPixel() method, you should use the new layer.getData() method instead. The old method returns composite pixel values from multiple layers and is limited to RGBA values. The new method doesn't suffer from these shortcomings and is more performant.

Deprecated map.forEachLayerAtPixel() method

The map.forEachLayerAtPixel() method has been deprecated. It will be removed (or its behavior may change) in the next major release. Please use the layer.getData() method instead.

List of all changes

See below for a complete list of features and fixes.

• Update ol-mapbox-style for rich text labels support (by @ahocevar in https://github.com/openlayers/openlayers/pull/13418)
• Increase GeoTIFF resolutions tolerance (by @ahocevar in https://github.com/openlayers/openlayers/pull/13417)
• Check for graticule resolution change and fix unrotated size (by @mike-000 in https://github.com/openlayers/openlayers/pull/13415)
• Rich text labels (by @ahocevar in https://github.com/openlayers/openlayers/pull/13410)
• Clear image when source's image is not ready (by @yonda-yonda in https://github.com/openlayers/openlayers/pull/13398)
• Fix setting View resolution or center to undefined (by @MoonE in https://github.com/openlayers/openlayers/pull/13393)
• Fix clone of icon loses imgSize when cache is full (by @MoonE in https://github.com/openlayers/openlayers/pull/13390)
• Use same clipping method for vector and image tiles (by @ahocevar in https://github.com/openlayers/openlayers/pull/13392)
• Less clipping of target resolution tiles (by @ahocevar in https://github.com/openlayers/openlayers/pull/13391)
• Change remaining links to point to class page instead of module (by @MoonE in https://github.com/openlayers/openlayers/pull/13385)
• User projection API (by @ahocevar in https://github.com/openlayers/openlayers/pull/13383)
• Fix wrong types when using "skipLibCheck": false (by @seravifer in https://github.com/openlayers/openlayers/pull/13382)
• Fix JsDoc references (by @MoonE in https://github.com/openlayers/openlayers/pull/13374)
• Fix VectorSource isEmpty without spatial index (by @MoonE in https://github.com/openlayers/openlayers/pull/13373)
• Document difference between Vector and VectorImage layers (by @ahocevar in https://github.com/openlayers/openlayers/pull/13371)
• Fix ol/source/Cluster#setSource type annotation (by @MoonE in https://github.com/openlayers/openlayers/pull/12998)
• Preload tiles for WebGL tile layers (by @tschaub in https://github.com/openlayers/openlayers/pull/13357)
• Avoid event creation when there are no listeners (by @MoonE in https://github.com/openlayers/openlayers/pull/13358)
• Add floor, round and ceil to style expressions (by @mike-000 in https://github.com/openlayers/openlayers/pull/13363)
• Support WebGL layers in ol/source/Raster (by @mike-000 in https://github.com/openlayers/openlayers/pull/13361)
• Improve some null types to prepare for strictNullChecks (by @EvertEt in https://github.com/openlayers/openlayers/pull/13301)
• Reset globalAlpha back to its initial after mutating it for drawing layers (by @Amirh0sseinHZ in https://github.com/openlayers/openlayers/pull/13351)
• Removing an unnecessary word from DEVELOPING.md (by @Amirh0sseinHZ in https://github.com/openlayers/openlayers/pull/13352)
• Get pixel data (by @tschaub in https://github.com/openlayers/openlayers/pull/13338)
• Remove warning for @type annotation by jsdoc (by @MoonE in https://github.com/openlayers/openlayers/pull/13350)
• Improve some null types for strictNullChecks (by @EvertEt in https://github.com/openlayers/openlayers/pull/13334)
• Dispose of webgl contexts (by @MoonE in https://github.com/openlayers/openlayers/pull/13336)
• Fix error when accessing ready property of renderer (by @MoonE in https://github.com/openlayers/openlayers/pull/13337)
• Pass tilePixelRatio and gutter to TileTexture (by @mike-000 in https://github.com/openlayers/openlayers/pull/13269)
• Improve some nullable map types (by @EvertEt in https://github.com/openlayers/openlayers/pull/13328)
• Avoid rendering outside WebGL layer and source extent (by @tschaub in https://github.com/openlayers/openlayers/pull/13333)
• Avoid duplicate imports (by @tschaub in https://github.com/openlayers/openlayers/pull/13332)
• Add updateStyleVariables method to WebGLPoints layer (by @ahocevar in https://github.com/openlayers/openlayers/pull/13294)
• Fix rendercomplete for WebGLPoints layer and subclasses (by @ahocevar in https://github.com/openlayers/openlayers/pull/13323)
• fix: fix casing for z-index (by @OSHistory in https://github.com/openlayers/openlayers/pull/13319)
• Fix typo CSS class name for the expanded attributions button (by @fredj in https://github.com/openlayers/openlayers/pull/13315)
• Improve types for tile layers (by @ahocevar in https://github.com/openlayers/openlayers/pull/13299)
• Document geometry type (by @ahocevar in https://github.com/openlayers/openlayers/pull/13298)
• Add function to convert RenderFeature to Feature (by @MoonE in https://github.com/openlayers/openlayers/pull/13297)
• Update to geotiff@2 (by @ahocevar in https://github.com/openlayers/openlayers/pull/13292)
• Re-assign style variables on setStyle() (by @ahocevar in https://github.com/openlayers/openlayers/pull/13293)
• add @api comment on getAllLayers method (by @XiaofengZeng in https://github.com/openlayers/openlayers/pull/13261)
• Allowing to pass additional options to the geotiff.js source (by @constantinius in https://github.com/openlayers/openlayers/pull/13290)
• Defaults for generic types (by @ahocevar in https://github.com/openlayers/openlayers/pull/13291)
• Load api navigation dynamically to reduce needed disk space (by @MoonE in https://github.com/openlayers/openlayers/pull/13229)
• Remove unneeded src="" (by @mike-000 in https://github.com/openlayers/openlayers/pull/13271)
• Support multiple sources for WebGL tile layers (by @ahocevar in https://github.com/openlayers/openlayers/pull/13212)
• Add crossOrigin option to LiteralSymbolStyle (by @mike-000 in https://github.com/openlayers/openlayers/pull/13259)
• Avoid the redirect from unpkg.com (by @tschaub in https://github.com/openlayers/openlayers/pull/13242)
• Updates for the 6.12.0 release (by @openlayers in https://github.com/openlayers/openlayers/pull/13241)

New Contributors

• @constantinius made their first contribution in https://github.com/openlayers/openlayers/pull/13290
• @XiaofengZeng made their first contribution in https://github.com/openlayers/openlayers/pull/13261
• @Amirh0sseinHZ made their first contribution in https://github.com/openlayers/openlayers/pull/13352
• @seravifer made their first contribution in https://github.com/openlayers/openlayers/pull/13382
• @yonda-yonda made their first contribution in https://github.com/openlayers/openlayers/pull/13398

Full Changelog: https://github.com/openlayers/openlayers/compare/v6.12.0...v6.13.0

The 6.12 release brings a few small fixes and enhancements. See below for a complete list.

List of all changes

• Transitive dependency update (by @openlayers in https://github.com/openlayers/openlayers/pull/13240)
• Re-enable image smoothing after rendering (by @mike-000 in https://github.com/openlayers/openlayers/pull/13236)
• Describe use of className with declutter (by @mike-000 in https://github.com/openlayers/openlayers/pull/13237)
• added run to npm command (by @lklepner in https://github.com/openlayers/openlayers/pull/13231)
• Document how to link package during development (by @lklepner in https://github.com/openlayers/openlayers/pull/13228)
• Default CORS mode for WebGL rendered sources (by @tschaub in https://github.com/openlayers/openlayers/pull/13227)
• Support the wrapX option for WebGL rendered tile sources (by @tschaub in https://github.com/openlayers/openlayers/pull/13226)
• Update ol-mapbox-style (by @tschaub in https://github.com/openlayers/openlayers/pull/13224)
• Do not fire modifyend event when nothing was modified (by @ahocevar in https://github.com/openlayers/openlayers/pull/13219)
• Draw VectorTiles with interpolate in hybrid mode again (by @M393 in https://github.com/openlayers/openlayers/pull/13221)
• Fix some typos in ModifyInteraction documentation (by @EvertEt in https://github.com/openlayers/openlayers/pull/13216)
• Fix MVT incorrect feature data handling (by @EvertEt in https://github.com/openlayers/openlayers/pull/13217)
• Format the changelog so contributors can be highlighted (by @tschaub in https://github.com/openlayers/openlayers/pull/13205)

New Contributors

• @lklepner made their first contribution in https://github.com/openlayers/openlayers/pull/13228

Full Changelog: https://github.com/openlayers/openlayers/compare/v6.11.0...v6.12.0

This release follows up on the 6.10 release with a fix for Mapbox vector layers rendered over other layers. A handful of other fixes and features are included. See below for more detail.

List of all changes

• Use getFeaturesInExtent (by @ahocevar in https://github.com/openlayers/openlayers/pull/13195)
• Use interpolate option in Sea Level example (by @mike-000 in https://github.com/openlayers/openlayers/pull/13200)
• Fix typo in example description (by @mike-000 in https://github.com/openlayers/openlayers/pull/13201)
• Use ecoregions data (by @tschaub in https://github.com/openlayers/openlayers/pull/13177)
• Avoid failure if existing target has no background color (by @tschaub in https://github.com/openlayers/openlayers/pull/13198)
• Add getDataAtPixel() method for WebGL (by @mike-000 in https://github.com/openlayers/openlayers/pull/13186)
• typo fix for cog-stretch example (by @bradh in https://github.com/openlayers/openlayers/pull/13196)
• Fix base vector layer template generics (by @ahocevar in https://github.com/openlayers/openlayers/pull/13190)
• Always use ES modules from geotiff.js (by @ahocevar in https://github.com/openlayers/openlayers/pull/13180)
• Use Buffer and data uri when Blob is not available (by @ahocevar in https://github.com/openlayers/openlayers/pull/13179)
• Use background property for vector layers (by @tschaub in https://github.com/openlayers/openlayers/pull/13178)
• Allow nodejs 12 to build the examples again (by @MoonE in https://github.com/openlayers/openlayers/pull/13175)
• Add attributions and attributionsCollapsible options to ol/source/DataTile (by @mike-000 in https://github.com/openlayers/openlayers/pull/13176)
• Correct scale bar in EPSG:4326 (by @mike-000 in https://github.com/openlayers/openlayers/pull/13171)

New Contributors

• @bradh made their first contribution in https://github.com/openlayers/openlayers/pull/13196

Full Changelog: https://github.com/openlayers/openlayers/compare/v6.10.0...v6.11.0

Just in time for the new year, the 6.10 release brings another great batch of features and fixes for your OpenLayers applications.

WebGL rendering

You can now update the style for your WebGL tile layers with layer.setStyle(). Keep in mind that it is more efficient to use style variables if you want to adjust styling on every render frame. However, in cases where you want to completely reconfigure the style, you can use the new layer.setStyle() method.

Additional WebGL tile layer rendering enhancements:

• A new palette operator was added that allows styling raster data based on a colormap.
• The band operator accepts expressions for the band number (in addition to numeric literals) – allowing for bands to be set by user provided style variables, for example.
• Tile layers now dispatch prerender, postrender, precompose and postcompose events with access to the WebGL rendering context.
• Layers that are adjacent to one another now share a single canvas element and rendering context – allowing for more layers in your maps before exhausting the browser's context limit.

Vector tiles

The Mapbox vector layer now works more easily with other vector tile providers. In addition, vector tile layers can now be configured with a background color.

New interpolate option for sources

Sources now have an interpolate option. This option controls whether data from the source is interpolated when resampling.

For ol/source/DataTile sources, the default is interpolate: false. This means that when a data tile source is used with a WebGL tile layer renderer, your style expression will have access to pixel values in the data tiles without interpolation. If this option is set to true, linear interpolation will be used when over- or under-sampling the data.

Deprecation of the imageSmoothing option for sources

The imageSmoothing option for sources has been deprecated and will be removed in the next major release. Use the interpolate option instead.

// if you were using `imageSmoothing`
const before = new TileSource({
  imageSmoothing: false
});

// use the `interpolate` option instead
const after = new TileSource({
  interpolate: false
});

List of all changes

See below for more features and fixes.

• #13155 - Allow interpolation to be configured for data tile sources (@tschaub)
• #13165 - Do not exceed maximum call stack when parsing TopoJSON (@ahocevar)
• #13158 - Add example for dynamic clusters (@ahocevar)
• #13156 - Ensure that tile range covers all pixels (@tschaub)
• #13154 - Update Export Map example to handle WebGL (@mike-000)
• #13147 - Support rendering with a palette in WebGL (@tschaub)
• #13142 - Include transpacific flights in Flight Animation example (@mike-000)
• #13150 - Include layer opacity in Heatmap shader (@mike-000)
• #13149 - Add layer also for programmatically selected features (@ahocevar)
• #13151 - Avoid error accessing attributes when context is lost (@mike-000)
• #13144 - Replace deprecated syntax in example (@mike-000)
• #13131 - Unset canvas css in stylesheet (@ahocevar)
• #13130 - Allow WebGL tile layers to be constructed without a source (@tschaub)
• #13126 - Preserve the drawing buffer by default for WebGL layers (@tschaub)
• #13127 - Fix for range slider on IE (@mike-000)
• #13095 - Render is only complete when no tiles are queued (@ahocevar)
• #13120 - Populate view's object properties (@ahocevar)
• #13102 - update line-arrows example (@jipexu)
• #13119 - Dispatch precompose and postcompose events for WebGL layers (@tschaub)
• #13118 - Add a layer opacity example (@tschaub)
• #13115 - Lazily create resources for worker (@tschaub)
• #13103 - Assume limited precision when rounding (@tschaub)
• #13097 - Use correct terrain-rgb tile size and update max zoom (@mike-000)
• #13101 - Fix View set center to undefined (@M393)
• #13085 - Add layer background (@ahocevar)
• #13083 - Support expressions for band arguments (@tschaub)
• #13084 - Normalize relative sprite and glyph urls for style url (@ahocevar)
• #13020 - Allow WebGL tile layer style to be updated (@tschaub)
• #13073 - Fall back to standard load handling when decode fails (@ahocevar)
• #13077 - update draw and modify features example (@jipexu)
• #13069 - Normalize based on GDAL stats metadata (@tschaub)
• #13070 - Use source minzoom if not configured otherwise (@ahocevar)
• #13065 - Fix typo in example (@jipexu)
• #13060 - Avoid fetching data outside the grid extent (@tschaub)
• #13054 - Updates for newer version of the OGC API spec draft (@ahocevar)
• #13045 - Fix tiles and background handling (@ahocevar)
• #13030 - Correctly set popover position in geographic example (@MoonE)
• #13031 - Allow data tile source loader to return a value or a promise (@tschaub)
• #13026 - Fix strokeStyle documentation (@ahocevar)
• #13027 - Restore the security scan workflow (@openlayers)
• #13025 - Add background to MapboxVector layer (@ahocevar)
• #13013 - Use appropriate UNPACK_ALIGNMENT for data textures (@mike-000)
• #13021 - Add the renderer type to generic layer template variables (@tschaub)
• #13022 - Update the security scan task (@tschaub)
• #13015 - Additional types for WebGL renderer, sources, and tiles (@tschaub)
• #13012 - Remove unused dependencies (@tschaub)
• #12976 - Handle ReprojTile in ol/layer/WebGLTile (@mike-000)
• #13011 - Use registry URL when publishing (@tschaub)
• #13009 - Use workflow_run event to deploy pull request previews (@tschaub)
• #12965 - Allow canvas reuse for WebGL layers (@tschaub)
• #12999 - Fix style related apidoc issues (@MoonE)
• #12978 - Add null to style jsdoc of VectorImage (@EvertEt)
• #12997 - Lazily create the WebGL helper (@tschaub)
• #12996 - Align labels with the Select elements in the Raster Reprojection example (@mike-000)
• #12994 - Add a map property to layers (@tschaub)
• #12987 - Browser test config update (@tschaub)
• #12939 - Example that demonstrates a color expression using variables (@tschaub)
• #12962 - No context sharing when layer opacity is set (@ahocevar)
• #12964 - Updated Bing Maps key (@tschaub)
• #12958 - Reuse temporary canvas in getDataAtPixel() (@mike-000)
• #12893 - Allow map target to be an external window (@andrewcoder002)
• #12955 - Make MapboxVector layer work in more access key scenarios (@ahocevar)
• #12935 - fix bug #12913 (@mrpan)
• #12933 - Include WebGL context in render events for WebGL layers (@tschaub)
• #12917 - Make removeFeature consistent with other remove methods (@mike-000)
• #12918 - Add setDisplacement method to ol/style/Image and subclasses (@mike-000)
• #12930 - Fix flaky view animation test (@MoonE)
• #12915 - Test the new pull request deploy previews (@tschaub)
• #12916 - Updates to deploy-preview job (@openlayers)
• #12914 - Build site preview as a GitHub action (@tschaub)
• #12891 - Restore browser compatibility where possible (@mike-000)
• #12899 - Update docs to mention Vite (@tschaub)
• #12890 - Release 6.9.0 (@openlayers)

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.

• #12813 - Do not replace icon color if image not loaded (@mike-000)
• #12870 - Fix publicPath problem in legacy build (@ahocevar)
• #12889 - Simplified ESLint config (@tschaub)
• #12875 - Only trigger change event if animating a tile transition (@tschaub)
• #12885 - Fix typeDefs for several Control modules (@MatthijsBon)
• #12861 - Update geotiff to 1.0.8; allow version range (@ahocevar)
• #12865 - Add a note about installing git before using create-ol-app (@tschaub)
• #12847 - Add more definitions for GeoTIFF types (@tschaub)
• #12850 - Fix issues with animate on View without center or resolution (@MoonE)
• #12846 - Use nodata values in the GeoTIFF headers for fill value (@tschaub)
• #12837 - forEachLayerAtPixel return null for unsupported layer types (@mike-000)
• #12836 - Support a normalize option on the GeoTIFF source (@tschaub)
• #12646 - Support for hit detection in styles with custom rendering (@ashchurova)
• #12831 - Fix rendering VectorImage with no features in view extent (@MoonE)
• #12830 - bugfix: Fix type of layers option in OverviewMap (@ejn)
• #12815 - Spelling correction (@tschaub)
• #12812 - Release v6.8.1 (@openlayers)

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.

• #12811 - Controls inherit font size from parent (@tschaub)

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

• #12785 - Promise.allSettled polyfill and other browser compatibilty (@mike-000)
• #12807 - Updated styles (@tschaub)
• #12806 - Update to the WebGL sea level example (@tschaub)
• #12808 - Update expectations for vector tile icon label rendering (@tschaub)
• #12804 - Make vector tiles rendering simpler and a bit faster (@ahocevar)
• #12802 - Enqueue tiles at the next step in the animation (@tschaub)
• #12801 - Update ol-mapbox-style to latest version without ol peer dependency (@ahocevar)
• #12792 - Do not do any canvas work when there are no features to render (@ahocevar)
• #12797 - Update geotiff (@ahocevar)
• #12799 - All layers now call dispose on the renderer (@tschaub)
• #12798 - More cleanup in the WebGL tile layer's dispose method (@tschaub)
• #12795 - New tile source for the WMTS example (@mike-000)
• #12793 - Add a method to set the map layers (@tschaub)
• #12789 - Handle TileJSON urls in Mapbox Style document (@ahocevar)
• #12790 - Allow maps to be configured with a promise for view props (@tschaub)
• #12777 - Fix offscreen-canvas example (@ahocevar)
• #12778 - Do not render vector tiles unless they are being used (@ahocevar)
• #12773 - Enable WebGL extensions when required (@tschaub)
• #12774 - Fix text decluttering when segment length is zero (@MoonE)
• #12770 - Use Uint8Array instead of Uint8ClampedArray for increased browser compatibility (@tschaub)
• #12759 - #12758: Allow undefined to be passed to control setMap(). Also fix type of getMap() (@jumpinjackie)
• #12760 - Fix opacity handling for tile and vector layers (@ahocevar)
• #12764 - Fix ImageInformationResponse typedef (@webwitcher)
• #12769 - Remove extra closing anchor tag (@tschaub)
• #12761 - Add Float Textures for GL Rendering / DataTiles (@theduckylittle)
• #12740 - Various fixes for browser compatibility issues (mike-000)
• #12741 - Minimal documentation for GMLBase (@mike-000)
• #12743 - Remove docs reference to unmanaged layer and Select (@mike-000)
• #12734 - Continue supporting IE11 in examples and legacy build (@ahocevar)
• #12739 - Change canvas style from initial to unset (@mike-000)
• #12731 - Handle resolution and tile loadingstrategy with user projection (@ahocevar)
• #12736 - OnSignatures return more specific type (@simonseyock)
• #12732 - Add to Quick Start (@mike-000)
• #12728 - Release v6.7.0 (@openlayers)

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

• #12727 - Add missing 'boxstart' event to OnSignature (@simonseyock)
• #12718 - Rename function to avoid minification failure (@tschaub)
• #12712 - Add convertToRGB option to GeoTIFF source (@ahocevar)
• #12716 - Spelling fix (@fredj)
• #12715 - Try harder to get the projection from GeoTIFF headers (@tschaub)
• #12714 - Avoid creating duplicate projections in COG examples (@tschaub)
• #12713 - Check for GeoTIFF CRS starting with last image (@tschaub)
• #12709 - Support rendering of GeoTIFF images in pixel coordinates (@tschaub)
• #12711 - Use band numbers starting with one (@tschaub)
• #12710 - Spelling fix in GeoTIFF docs (@tschaub)
• #12697 - Move description above type tag (@tschaub)
• #12695 - Update Google KML icon anchors and correct icon scaling (@mike-000)
• #12642 - Fix fullscreen in mapbox-style example (@ahocevar)
• #12624 - Improve API docs for optional properties (@ahocevar)
• #10963 - OGC map and vector tile sources (@tschaub)
• #12690 - Fix return stride of forEachSegment (@ahocevar)
• #12684 - Fix view resolutions in example (@mike-000)
• #12683 - Fix sprite offset for pixel ratio !== 1 (@ahocevar)
• #12671 - Configure cache on the layer instead of the source (@tschaub)
• #12669 - Add opaque and transition options to GeoTIFF source (@ahocevar)
• #12667 - Additional docs and type checking for raster source (@tschaub)
• #12666 - Re-add accidently removed events (@ahocevar)
• #12647 - Remove Translate option conflicts and update documentation (@mike-000)
• #12008 - Rendering raster tiles with WebGL (@tschaub)
• #12632 - Only warn of zero size when map should be visible (@mike-000)
• #12626 - Set canvas style to override problem 3rd party css (@mike-000)
• #12608 - Support more OGC CRS identifiers (@tschaub)
• #12607 - Don't add color as possible type if it was not set (@MoonE)
• #12605 - Some typing improvements (@simonseyock)
• #12600 - Make attribution getters public. (@simonseyock)
• #12597 - #12596 fix RasterSource does not end Tile transition (@mwerlitz)
• #12599 - Replace reference image to match that of the CI (@ahocevar)
• #12595 - Generate correct type definitions with null (@ahocevar)
• #12578 - Update rendering test reference image (@ahocevar)
• #12577 - Use shx for the build-site script, clean before run (@MoonE)
• #12575 - Add on(), un() and once() signatures for ol/source/Raster (@ahocevar)
• #12565 - Handle named colors as string in equal operator (@sebakerckhof)
• #12576 - Fix example and legacy build with nodejs 16.6 (@MoonE)
• #12551 - Add WKB to the exports of ol/format (@M393)
• #12550 - Add grid tag to examples. (@simonseyock)
• #12549 - Add change:layers event. (@simonseyock)
• #12545 - Restore simple axis order handling with fixed proj4 (@ahocevar)
• #12544 - Make Raster source work as generics type for Image layer (@ahocevar)
• #12527 - Treat custom loaders without success/fail handling as if they were a void loader (@mike-000)
• #12538 - Avoid creating context until needed (@tschaub)
• #12528 - Convert the hit tolerance priority example into a test (@MoonE)
• #12522 - Shorter name for the option to create a custom cluster (@tschaub)
• #12506 - Fix adding controls with map config (@M393)
• #12487 - Custom cluster feature creation function (@Razi91)
• #12520 - Fix typo in changelog (@ahocevar)
• #12519 - Release v6.6.1 (@openlayers)

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

• #12498 - CanvasLayerRenderer: Forward LayerType type parameter to LayerRenderer (@bryantevans00)
• #12518 - VectorEventType: Add 'changefeature' in @typedef (@DaniEll-AT)
• #12517 - Update ela-compil sponsors section of README (@ela-compil)
• #12511 - Add ela-compil to sponsors section of README (@ahocevar)
• #12513 - Draw a sketch point when adding a vertex programmatically (@ahocevar)
• #12507 - Fix regular shape hit detect transparent fill (@MoonE)
• #12509 - Allow any return type from listener functions (@ahocevar)
• #12505 - Fix type of PluggableMap#setTarget() argument (@ahocevar)
• #12495 - Edits to the changelog (@tschaub)

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

• #12442 - Fix layer render extent when it is not at all in view (@MoonE)
• #12492 - Use create-ol-app to create a new app (@tschaub)
• #12467 - Fixes / improvements for RegularShape (@MoonE)
• #12491 - Add a new placeholder option and deprecate undefinedHTML for the mouse position control (@tschaub)
• #12430 - Event listener typing (@simonseyock)
• #12488 - MousePosition: allow rendering of empty string (@JakobMiksch)
• #12464 - Make zDirection option available for all tile sources (@mike-000)
• #12489 - Update ol-mapbox-style to v6.4.0 (@ahocevar)
• #12484 - Add GeoSolutions as a monthly sponsor (@tschaub)
• #12480 - Fix gap in tiles due to floating point math (@MoonE)
• #12453 - Allow multiple LinearRings per innerBoundaryIs (@MoonE)
• #12466 - Fix getVectorContext on TileLayer with pixelRatio != 1 (@MoonE)
• #12463 - Improve animation examples (@MoonE)
• #12459 - Fix documentation for GML class. (@simonseyock)
• #12455 - Consistent use of quotes in example description (@mike-000)
• #12373 - Rework TileDebug to allow TMS coordinates and to fix reprojection (@mike-000)
• #12441 - Style-based measure example (@mike-000)
• #12438 - typo (@jipexu)
• #12431 - Add tsc-generated type definitions for opt-in (@ahocevar)
• #12417 - Use html2canvas instead of dom-to-image (@ahocevar)
• #12413 - Fix hitdetection image invalidation (@MoonE)
• #12405 - VectorTile getSourceTiles behaviour with loading source tiles (@ahocevar)
• #12212 - Ignore empty gx:coord elements in KML files (@voegelas)
• #12418 - Fix icon tinting with pixelRatio < 1 (@MoonE)
• #12409 - Fix WMTS wrapX detection if WGS84BoundingBox is not set (@M393)
• #12237 - Fix Modify interaction with hitDetection (@M393)
• #12416 - Use generics to limit event types in on(), once() and un() (@ahocevar)
• #12408 - Do not fire modifystart when nothing is being modified (@ahocevar)
• #12414 - Replace getChangeEventType() with add/removeChangeListener methods (@ahocevar)
• #12194 - Respect pixel ratio with immediate render (@MoonE)
• #12298 - Fix JSDoc generated links (@tschaub)
• #12231 - Move tolerance should not increase with higher pixel ratio (@MoonE)
• #12282 - Fix DragZoom with view padding (@M393)
• #12223 - generic source parameters for options (@simonseyock)
• #12219 - Add 'properties' to Layer constructors (@ahocevar)
• #12284 - Layers should inherit group z-index (@MoonE)
• #12304 - New example: Scale and Rotate using Modify Interaction (@mike-000)
• #12378 - Correct .split() calls to only split numeric srid for ArcgisRest (@mike-000)
• #12393 - Scale up static Image and round to nearest pixel to avoid rounding errors (@mike-000)
• #12394 - Ensure VectorSource getUrl() corresponds to last setUrl() (@mike-000)
• #12357 - Use calculateElevation function in Shaded Relief example (@mike-000)
• #12375 - Fix Vector Tile Selection example on old browsers (@mike-000)
• #12364 - Simpler and faster VectorTile loading (@ahocevar)
• #12359 - Fix broken link in docs (@mike-000)
• #12330 - Do not require PointerEvent constructor (@ahocevar)
• #12355 - document descending order of resolutions array (@simonseyock)
• #12349 - Document the input to an attribution function (@mike-000)
• #12340 - Fix raster example tooltips (@MoonE)
• #12338 - Do not use proto to restore instances after main thread - worker transfer (@ahocevar)
• #12339 - Fix confusing import in Mapbox Style example (@mike-000)
• #12306 - Fix layer canvas reuse (@M393)
• #12334 - More consistent example for ol/layer/MapboxVector (@MoonE)
• #12315 - Improve attribution accessibility (@MoonE)
• #12313 - Hitdetection offscreencanvas worker (@vittrup88)
• #12297 - Add condition option to Translate interaction (@mike-000)
• #12283 - Add link to yey'maps as a sponsor (@tschaub)
• #12277 - Lint the index file after generating the legacy build (@tschaub)
• #12266 - Fix legacy build (@MoonE)
• #12273 - Use lowercase module names for modules without a default export (@tschaub)
• #12264 - Run selected format tests in Node (@tschaub)
• #12263 - Fix the next-dev-version.js script (@tschaub)
• #12241 - Use modules everywhere (@tschaub)
• #12250 - Do not set projection extent in WMTS optionsFromCapabilities (@mike-000)
• #12259 - Make it clearer what fails in webgl point layer test (@tschaub)
• #12258 - Following the recommendation to run on a merge commit (@tschaub)
• #12251 - Test reorganization (@tschaub)
• #12249 - Update the name of the build job (@tschaub)
• #12248 - Avoid naming required checks with a changing version (@tschaub)
• #12238 - Use proxy url as interim fix for mixed content in the MapGuide example (@mike-000)
• #12239 - Add example showing how to Draw and Modify geodesic circles (@mike-000)
• #12247 - Build on Node 16 and update dev dependencies (@tschaub)
• #12230 - Fix @types/estree version and remove skipLibCheck: false from tsconfig (@ahocevar)
• #11952 - Draw 800km circles around both poles in Tissot example (@mike-000)
• #12229 - Prevent TypeScript Compiler from erroring out due to lib checks (@ahocevar)
• #12224 - Use a better maintained loader for test coverage (@ahocevar)
• #12227 - Fix event handling for map in shadow root (@MoonE)
• #12214 - Do not set invalid style (@ahocevar)
• #12216 - Fix ZoomSlider layout (@MoonE)
• #12217 - Fix building of examples with latest copy-webpack-plugin (@MoonE)
• #12198 - Add attributionsCollapsible option to source/TileWMS and source/WMTS (@sbx320)
• #12176 - Allow private class members to be mangled (@bz2)
• #12178 - Add WKB (Well-Known Binary) format (@kikuchan)
• #12180 - Fix rendering of MultiPolygon text styles (@MoonE)
• #12185 - MapBrowserEvent#preventDefault() behaves the same as with native events (@ahocevar)
• #12181 - Build for ie11 again (@MoonE)
• #12028 - Overview map no initial target (@MoonE)
• #12175 - Refresh available examples before each compilation (@MoonE)
• #12172 - Fix icon displacement (@ahocevar)
• #12170 - Link to GitHub sponsors page (@tschaub)
• #12168 - VectorSource#getFeatures() consistently returns a new array (@ahocevar)
• #12164 - Fix offscreen-canvas example (@ahocevar)
• #12163 - Fix how renderMode is derived from options (@ahocevar)
• #12137 - Load less tiles when low on frame budget (@ahocevar)
• #12143 - Fix singleclick and doubleclick events (@ahocevar)
• #12141 - call the success callback after the features are added (@kikitte)
• #12135 - Update webpack (@tschaub)
• #11405 - Fixes extent calculation in WMTS optionsFromCapabilities when BoundingBox exists (@amir-ba)
• #12128 - Package lockfile version update (@tschaub)
• #12102 - Update eslint-config-openlayers (@simonseyock)
• #12089 - Fix common misspellings (@marcjansen)
• #12062 - Fix kml-timezone example tooltip (@M393)
• #12088 - Fix broken url/description of ImageArcGISRest documentation (@dbretschneider)
• #12083 - Simplify event handling for custom elements (@ahocevar)
• #12080 - Add a minimum distance config to the cluster source (@MoonE)
• #12084 - Only preventDefault when event is cancelable (@ahocevar)
• #12079 - Change IGN WMTS example to use PLANIGNV2 layer (@mike-000)
• #12016 - Fix VectorLayer hitdetect problems (@MoonE)
• #11845 - Call finishCondition for all types for Draw interaction (@MoonE)
• #12066 - Always return Promise from getFeatures (@M393)
• #12057 - TileQueue tests with events instead of setTimeout (@ahocevar)
• #12058 - Fix map loading for basemap.at and add attributions (@M393)
• #12024 - Add a tile grid method for getting a tile range given a tile coord and zoom level (@tschaub)
• #12023 - Avoid collisions between user variables and internal names in WebGL shaders (@tschaub)
• #12027 - Update / fix links to external ressources (@MoonE)
• #11996 - Update links to external resources (@MoonE)
• #12025 - Remove watch option from webpack serve script (@fredj)
• #12021 - Allow source projection to be set after construction (@tschaub)
• #12022 - Throw when WebGL style parsing encounters an unexpected type (@tschaub)
• #12020 - Fix WebGL buffer deletion (@tschaub)
• #12018 - Only render vector tile image when needed (@ahocevar)
• #12019 - Always use same order for renderedTiles (@ahocevar)
• #12012 - Fix documentation for account parameter in ol/source/CartoDB (@geraldo)
• #11995 - Fix hitdetect inaccuracy for VectorLayer's getFeatures (@MoonE)
• #11990 - Remove renderMode: 'image' for vector tile layers (@ahocevar)
• #12007 - Report all features being modified (@ahocevar)
• #11991 - Fix some typings in format and format/WKT (@simonseyock)
• #11992 - Improve measure example ux (@MoonE)
• #11974 - Fix polyfill inconsistencies (@mike-000)
• #11987 - Respect opacity for vector instructions (@ahocevar)
• #11989 - Correct pixel ratio descriptions (@mike-000)
• #11988 - Warn when map container's width or height are zero (@ahocevar)
• #11978 - Add snapToPointer option (@ahocevar)
• #11981 - Add descriptions for properties. (@simonseyock)
• #11979 - Jsdoc types syntax (@simonseyock)
• #11977 - More consistent JSDoc syntax (@tschaub)
• #11975 - jsdoc linting (@simonseyock)
• #11967 - Simplify popup positioning in Icon Scale example (@mike-000)
• #11954 - Simplify icon example (@ahocevar)
• #11965 - Handle view rotation in d3 Integration example (@mike-000)
• #11950 - Make polygons in the GeoJSON example comply to GeoJSON specification (@mike-000)
• #11948 - Improve layer typings (@simonseyock)
• #11955 - Fix URLs in ol/source/CartoDB pointing to CartoDB API docs (@geraldo)
• #11947 - Demonstrates how to get the coordinates been clustered. (@yukihiratype2)
• #11938 - Take view padding into account for calculateExtent() (@ahocevar)
• #11941 - Fix loading flag for vector loading strategies (@ahocevar)
• #11925 - Mention unit of radius for Polygon.circular() (@kannes)
• #11914 - Fix image with text decluttering (@ahocevar)
• #11911 - Do not clip declutter executor groups (@ahocevar)
• #11856 - Use tilegrid extent as default attributionExtent for TileJSON (@mike-000)
• #11900 - Update pratique key to choisirgeoportail in the IGN WMTS example (@mike-000)
• #11913 - Handle null geometry in TopoJSON (@mike-000)
• #11893 - Pass the renderer function to the cloned style (@mjjurkoic)
• #11901 - Fix handling of VectorTile renderBuffer (@ahocevar)
• #11899 - Update HERE Map Tile API example to use API key (@mike-000)
• #11890 - Fix WFS writeFilter (@walkermatt)
• #11892 - Restore stopClick functionality (@ahocevar)
• #11882 - Improved documentation for feature load events. (@simonseyock)
• #11886 - Throw an error if shaders fail to compile or program fails to link (@tschaub)
• #11874 - Hit lines even if they are dashed (@tschaub)
• #11873 - Update Mapbox-gl Layer example to mapbox-gl-js version 1.13.0 and add note about why an old version is used (@mike-000)
• #11865 - Use ol/array#includes instead of Array.prototype.includes() (@mike-000)
• #11872 - Legacy build for legacy browsers (@ahocevar)
• #11871 - Fix examples and build for ie11 (@MoonE)

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

• #11859 - Do not fire duplicate postrender events (@MoonE)
• #11858 - Correct documented event names for VectorSourceEvent (@MoonE)
• #11844 - Fix Style expressions error message (@MoonE)
• #11838 - Custom circle render (@changqingom)
• #11811 - Better getPointResolution default when no transform available (@mike-000)
• #11821 - Call the finishCondition when drawing points / circles (@MoonE)
• #11824 - Add Units back to API docs (@ahocevar)
• #11817 - stopPropagation support for PluggableMap (@greggian)
• #11815 - Remove unnecessary line that breaks drawing with multi-touch (@ahocevar)
• #11800 - Fix removeLastPoint when removing last point (@ahocevar)
• #11769 - Modify interaction developer experience improvements (@ahocevar)
• #11803 - Modify fix vertex insertion (@MoonE)
• #11783 - Cache hit detect indexes and check closest pixels first. (@MoonE)
• #11791 - Now that pepjs was updated, we can point to the official package (@ahocevar)
• #11790 - Fix attributions links for WMS layers from swisstopo (@openlayers)
• #11781 - Pass geometry to forEachFeatureAtPixel callback (@ahocevar)
• #11778 - No need to adjust hitTolerance for pixel ratio twice (@ahocevar)
• #11780 - Add a cancel event to the DragBox interaction (@M393)
• #11779 - Restore Mode.CIRCLE in Draw interaction (@mike-000)
• #11753 - Use Mode.LINE_STRING in Draw interaction for Circle geometries (@mike-000)
• #11767 - Improve documentation of geometry rotation (@mike-000)
• #11755 - Add padding option for View (@ahocevar)
• #11754 - Fix typo that prevents Rotate icon from indicating the view rotation (@ahocevar)
• #11719 - Clamp EPSG:3857 y to lowest/highest possible value instead of validity extent (@ahocevar)
• #11737 - Write the correct SRS code in EsriJSON (@ahocevar)
• #11749 - Document that snapTolerance must be greater than 0 (@ahocevar)
• #11750 - Update TMS tileUrlFunction example in ol/source/XYZ documentation (@mike-000)
• #11739 - Fix: Check for layer extent in CanvasLayerRenderer.getDataAtPixel (@boeckMt)
• #11748 - Add fetch and TextDecoder to polyfill list in README (@mike-000)
• #11740 - Wfs bbox per feature type (@ger-benjamin)
• #11722 - Correct meaning of 'start' and 'end' text align for LTR text (@ahocevar)
• #11741 - Include LICENSE.md in built package (@bz2)
• #11718 - Initialize sketch point on Draw#extend() (@ahocevar)
• #11732 - Replace readURI with readStyleURL for KML StyleURLs (@mike-000)
• #11723 - Drag and Drop Interaction support for formats that read ArrayBuffer sources (@mike-000)
• #11724 - Add transition option to OSM and CartoDB sources, document default (@MoonE)
• #11721 - Handle empty Z coordinates in KML (@mike-000)
• #11587 - Determine orientation by actual text start and end x (@MoonE)
• #11720 - Return to simpler and less efficient winding order algorithm (@ahocevar)
• #11715 - Add all symbols to the legacy build (@ahocevar)
• #11716 - Treat svg as binary resource (@mike-000)
• #11698 - Draw pointer improvements (@ahocevar)
• #11490 - iconUrlFunction option for ol/format/KML (@mike-000)
• #11628 - VectorSource load events (@simonseyock)
• #11691 - Use Parcel v2 in copy/paste example code (@ahocevar)
• #11673 - Do not emulate dblclick and slingleclick on multi-touch (@ahocevar)
• #11676 - Fix countries.geojson Antarctica polygon so it wraps correctly (@mike-000)
• #11646 - Ensure a unique tile key for each tile coordinate (@ahocevar)
• #11655 - Fix documentation of image render mode for vector tile layers (@ahocevar)
• #11668 - Don't try to get image data for zero sized images (@tapioko)
• #11648 - Dwithin filter (@virtualcitySYSTEMS)
• #11658 - Make webpack dev server run with current version (@MoonE)
• #11590 - Export all the Event sub class (@sbrunner)
• #11594 - Display current OS copyright date in the Raster Reprojection example (@mike-000)
• #11657 - Use https to avoid security warnings (@mike-000)
• #11649 - Deal with undefined units from proj4 longlat projections (@ahocevar)
• #11403 - #11402 add CSS class name support for control buttons (@cazacugmihai)
• #11592 - New decluttering implementation (@ahocevar)
• #11618 - Update the Marker Animation example (@mike-000)
• #11620 - Add charset to the examples html below the map (@MoonE)
• #11613 - Allow mouse input if map is rendered in an other window (@elnabo)
• #11597 - Improved performance when removing feature with only one Select (@MoonE)
• #11607 - Reset attributions control to collapsible when no uncollapsible sources are visible (@mike-000)
• #11609 - Modify interaction insert only one vertex (@M393)
• #11605 - Remove context references when releasing tiles (@ahocevar)
• #11591 - Make permalink example less complex (@kannes)
• #11569 - Fix binary data exports to codesandbox in examples (@mike-000)
• #11579 - Replace Animated GIF example globe gif (@mike-000)
• #11565 - Animated GIF example (@mike-000)
• #11571 - Replace countryflags.io with flagcdn.com in the Style Renderer example (@mike-000)
• #11568 - Fix raster source crash bug when using multiple threads (@rgroothuijsen)
• #11563 - Fix end world calculation if projection is not symmetric (@MoonE)
• #11561 - Constrain resolution when fit called without duration (@M393)
• #11559 - Only draw visible worlds (@MoonE)
• #11519 - Do not draw multipoints outside render extent (@MoonE)
• #11532 - Make TileGrid behave as documented with extent and sizes options (@ahocevar)
• #11545 - Use the className param in ol.layer.Heatmap (@fredj)
• #11548 - Bind tileUrlFunction before returning it from getTileUrlFunction (@ahocevar)
• #11549 - Only use elementFromPoint with ShadowRoot (@ahocevar)
• #11502 - Fix issue with WMS Capabilities containing a single layer (@jbelien)
• #11540 - Avoid unnecessary transform in the MVT format (@gberaudo)
• #11537 - Add rotation and rotateWithView to ol/style/Circle clone method and options (@mike-000)
• #11543 - wmts matrixset null pointer fix and improved handling of Identifier (@sweco-dkjesh)
• #11509 - Add urn:x-ogc:def:crs:EPSG:6.6:4326 as WGS84 proj identifier (@fgravin)
• #11521 - Do not use fractional pixel ratio for rendering vector tiles (@ahocevar)
• #11517 - Make clockwise check work when coordinates are duplicated (@ahocevar)
• #11501 - Empty this.canvas_ for all pixel ratios when render() is called (@mike-000)
• #11471 - Feature: added preRender and postRender methods to WebGLLayerRenderer… (@MichaelLangbein)
• #11491 - Cosmetic fix to doc (missing closing quote) (@mike-000)
• #11488 - "Layer Z-Index" example bugfix (@michalzielanski)
• #11486 - guard for null (@davidiamaf)
• #11481 - Adding original properties to cloned geometry (@michalzielanski)
• #11404 - Add security scan (@tschaub)
• #11470 - Fix pointer events polyfill link (@ahocevar)
• #11467 - Style renderer example (@ahocevar)
• #11455 - Apidoc improvements (@MoonE)
• #11474 - fix: modify rbush package import (@haasz)
• #11472 - Typescript 4.0.2 (@ahocevar)
• #11454 - VectorTile source projection has to match the view projection (@ahocevar)
• #11438 - Better scroll behaviour for apidocs (@MoonE)
• #11446 - Checks before calling handleEvent on interactions (@ahocevar)
• #11305 - PluggableMap: avoid crash when multiple interactions are removed (@megawac)
• #11433 - Fix typo in module name (@fredj)
• #11419 - WFS 2.0.0 support (@bjornharrtell)
• #11418 - Icon color default to composite operation (@MoonE)
• #11416 - Examples add labels to inputs (@MoonE)
• #11417 - Fix sort order of examples search results (@ahocevar)
• #11413 - Include scale option in RegularShape and Circle style constructors (@mike-000)
• #11401 - Ensure image extent is valid when scale is negative (@mike-000)
• #11395 - Correct inchesPerMeter and add tests for ScaleBar text (@mike-000)
• #11407 - Support deprecated coordinates element for GML3+ formats (@bjornharrtell)
• #11398 - Fix link to workshop / download (@MoonE)
• #11391 - Simplify scale calculation used for WMS getLegendUrl() (@mike-000)

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

• #11379 - tooltip bs on fullscreen (@jipexu)
• #11378 - Fix imageSmoothing: false when ImageStatic is stretched to fit extent (@mike-000)
• #11367 - Use https for mapbox tiles (@MoonE)
• #11377 - Only include renderBuffer when decluttering (@ahocevar)
• #11376 - Overlay Eample - Show the popup in front of the other overlays (@MoonE)

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

• #11364 - Load pointer events polyfill - before other polyfills (@ahocevar)
• #11365 - Revert to original method proposed in #11193 (@mike-000)
• #11359 - check projection can wrap before getting width (@mike-000)
• #11355 - Cloak API key with instructions where to get one (@ahocevar)
• #11354 - Fix line breaks in changelog (@ahocevar)

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

• #11346 - Fix text instruction flat coordinates when stride is not 2 (@ahocevar)
• #11348 - Add all layers to layer export (@M393)
• #11337 - Do not rely on old value for target (@ahocevar)
• #11345 - Fix the popup in the geographic example (@MoonE)
• #11336 - Hit detect with pixelRatio of 1 (@ahocevar)
• #11341 - update link to BS doc (@jipexu)
• #11340 - Examples fix / improvement (@MoonE)
• #11339 - Use bootstrap 4.5.0 in all examples (@MoonE)
• #11327 - Fix Internet Explorer issues (@ahocevar)
• #11315 - Examples fix html (@MoonE)

With more than 120 pull requests, this release brings a facelift of the website, as well as many bug fixes and several exciting new features.

Upgrade notes

Pointer events polyfill removed

Now that all major browsers support Pointer events natively, we removed the elm-pep dependency. If you are targeting older browsers that do not support Pointer events, you now need to include a pointer events polyfill (elm-pep or pepjs) in your application.

New features and improvements

• Several event handling fixes and improvements for seamless integration into scrollable web pages and improved support for maps in web components.
• Map interactions work again when ol.css is not included in the build.
• More stable map views with decluttered labels during panning.
• Image smoothing can be disabled, so raster cells can have sharp edges in image layers now.
• Better cache management for tile layers.
• Retina/HiDPI support for regular shape and svg icon styles.

List of all changes

• #11322 - same dropdown hover than the site (@jipexu)
• #11321 - dropdown margin bottom (@jipexu)
• #11320 - margin bottom for dropdown (@jipexu)
• #11319 - dropdown margin bottom (@jipexu)
• #11318 - Mark active nav item (@ahocevar)
• #11317 - Make header and menu navigation consistent with web site (@ahocevar)
• #11277 - Have high resolution regular shape (@sbrunner)
• #11313 - Add direct link to other examples to tags (@MoonE)
• #11310 - Update bootstrap, cleanup css, make pages more responsive (@ahocevar)
• #11304 - Reuse empty canvas (@ahocevar)
• #11309 - Do not extract comments to avoid asset name conflicts (@ahocevar)
• #11306 - Replace/remove usage of tileserver.maptiler.com (@petrsloup)
• #11270 - Fix handling of events originating from overlayContainerStopEvent children (@ahocevar)
• #11269 - Register and unregister events in set target handler (@ahocevar)
• #11300 - Drag and Drop to update source and fire event only if features added (@mike-000)
• #11286 - Allow line breaks before slashes in apidoc navigation (@MoonE)
• #11287 - Examples index page fixes (@MoonE)
• #11197 - Added '&&' logical operator to expressions (@RydingM)
• #11283 - Remove update while interacting/animating from VectorImage (@yonzmeer)
• #11267 - Fix upright labels on vector tiles (@ahocevar)
• #11263 - Fix rotation reset in Mapbox-gl Layer example (@mike-000)
• #11268 - Cache size (@ahocevar)
• #11271 - Make style override CSS compatible with importing ol.css and with IE (@mike-000)
• #11253 - Only clamp to source extent for safe transforms (@ahocevar)
• #11258 - Replace ol tag with openlayers (@ahocevar)
• #11256 - Add dispose API docs to raster source (#10856) (@EvertEt)
• #11255 - GetDataAtPixel performance improvement (@Shekenix)
• #11252 - Add missing SimpleGeometry export (@jmacura)
• #11226 - By modifying the common vertex, not all geometries were changed when … (@michalzielanski)
• #11225 - Use 'source-over' to render reprojection edges (@mike-000)
• #11224 - Quote . in RegExp (@mohawk2)
• #11219 - Make proj4 transforms behave like built-in transforms (@ahocevar)
• #11218 - getFeatures() uses wrong transforms after resetting rotation (@ahocevar)
• #11217 - Additional test coverage for serializing GeoJSON (@tschaub)
• #11215 - Fix MVT multipolygons with featureClass: Feature (@ahocevar)
• #11193 - Fix VectorImage layer clipping with rotation (@mike-000)
• #11195 - getExtent() to return getEmpty() if geometry is unprojectable (@mike-000)
• #11188 - Late object initialization (@michalzielanski)
• #11194 - ol/geom/LineString#getCoordinateAt() to return Z and M values if available (@mike-000)
• #11198 - Add condition option to Extent interaction (@mike-000)
• #11202 - Branch name changes (@tschaub)
• #11192 - Use pepjs in examples to support more old/exotic browsers (@ahocevar)
• #11190 - Correct vector layer clipping with rotation (@mike-000)
• #11037 - Allow icon and text styles to be scaled in two dimensions (@mike-000)
• #11165 - Use drag-pan default condition with onFocusOnly (@ahocevar)
• #11172 - Use cross-browser find (@ahocevar)
• #11171 - Allow using un() for events registered with once() (@ahocevar)
• #11148 - Vectortile label flicker (@ahocevar)
• #11174 - Improve types and docs for getStyle/setStyle (@ahocevar)
• #11173 - Remove elm-pep dependency (@ahocevar)
• #11146 - Update JSTS example to use JSTS 2.3.0 (@bjornharrtell)
• #11135 - Re-enable onFocusOnly option for interaction defaults (@ahocevar)
• #11106 - Defer ZoomSlider initialization until its size is available (@M393)
• #11120 - correct scalebar box sizing (@mike-000)
• #11116 - No search autocomplete (@ahocevar)
• #11088 - Transform without axis order in proj4 (@ahocevar)
• #11089 - Use assign function instead of Object.assign (@ahocevar)
• #11082 - Fix outside window dragging (@ahocevar)
• #11066 - Move code of conduct to the root (@tschaub)
• #11065 - Remove CircleCI integration (@tschaub)
• #11054 - Add a code of conduct (@openlayers)
• #11053 - Build examples and API docs (@tschaub)
• #11050 - Run rendering and spec tests in parallel (@tschaub)
• #11051 - Clear event listeners when disposing a raster source. (@tschaub)
• #11046 - Reprojection: Just draw everything on pixel boundaries (always) (@pjsg)
• #11049 - Fix tile opaque (@alexisig)
• #11048 - Run tests as a GitHub CI workflow (@openlayers)
• #11047 - Include processor from pixelworks and terminate workers before creating new ones (@tschaub)
• #11045 - Install headless Chrome dependencies (@tschaub)
• #11044 - Remove personal Mapbox key (@tschaub)
• #11042 - Fix legacy build by defining ol alias (@ahocevar)
• #11041 - Fix custom controls with user-provided element (@ahocevar)
• #11025 - Get rid of MapBrowserPointerEvent (@ahocevar)
• #11024 - Make events work when inside a web component (@ahocevar)
• #11019 - Option to disable image smoothing for Image layer sources (@mike-000)
• #11023 - Add MapBrowserPointerEvent to apidoc (@MoonE)
• #11017 - Don't stop geolocation tracking on error (@fredj)
• #11011 - Set background fill style for each declutter label (@mike-000)
• #10977 - Only render vector tile when there are executor groups (@ahocevar)
• #10990 - Include context options in tile cache key (@mike-000)
• #10996 - Mapbox vector layer (@tschaub)
• #10998 - Show the main.js right below the map (@tschaub)
• #10997 - Update shelljs (@tschaub)
• #10987 - Use brokenDiagonalRendering reprojection processing if image smoothing is disabled (@mike-000)
• #10948 - Add constrainResolution option (@wussup)
• #10981 - Calculate WMTS TileGrid extent using TileMatrixSetLimit when available (@nielsmeijer)
• #10993 - Do not rely on custom type overrides (@ahocevar)
• #10989 - Add log2 function to ol/math (@mike-000)
• #10986 - Correct bold font tag closure in example description (@mike-000)
• #10982 - Handle scaled output canvas correctly (@ahocevar)
• #10983 - Trying to fix CI (@ahocevar)
• #10976 - Apply projection.getMetersPerUnit() to calculated WMTS resolution (@nielsmeijer)
• #10960 - Improve Vector Clipping Layer example with a background layer and intersect (@SDaron)
• #10956 - Add undefined check for navigator.userAgent (@pmulholland42)
• #10936 - Set pointerEvents style programmatically instead of relying on ol.css (@ahocevar)
• #10941 - Always prevent default after handleDragEvent (@ahocevar)
• #10939 - Losen listener type (@ahocevar)
• #10935 - Fix calling Overlay.panIntoView with no options (@ejn)
• #10937 - Use the tile coordinate as a tile pseudo URL in geojson-vt example (@mike-000)
• #10934 - Update TypeScript to v3.8 (@ahocevar)
• #10931 - Use a new cache key in hopes of fixing test failures (@tschaub)
• #10930 - Better test for uniform colors (@ahocevar)
• #10929 - Fix typo in 6.3.0 release doc (@nikolas)
• #10917 - Fix the IGN WMTS example dead links and attribution (@sambakk)
• #10911 - Remove link for fullscreen event from navigation (@MoonE)
• #10916 - Store additional artifacts to debug test failures (@tschaub)
• #10902 - Move readFromDocument implementation to the base class (@fredj)
• #10899 - Do not scroll page during feature translation (@ahocevar)
• #10862 - Use prettier (@tschaub)
• #10895 - Fix dependency source management for examples (@ahocevar)
• #10882 - Apidoc - Fix toggle state when there are no hidden members (@MoonE)
• #10893 - Fix focus condition (@ahocevar)
• #10878 - Avoid page scrolling when freehand drawing on mobile (@ahocevar)
• #10879 - Do not append hit canvas to document body (@ahocevar)
• #10877 - Remove .d.ts files from the package (@ahocevar)
• #10874 - fix return type (@mike-000)
• #10840 - Remove inherit doc (@fredj)
• #10872 - Use TypeScript 3.9 for type generation for better enums (@ahocevar)
• #10537 - Correct resolution used for scale bar and add dpi option (@mike-000)
• #10463 - Fix issue with reprojection and double drawing pixels. (@pjsg)
• #10429 - Option to disable image smoothing for Tile layer sources (including reprojected sources) (@mike-000)
• #10865 - View / avoid solving constraints related to map size during animation (@jahow)

This is a bugfix release which removes the auto-generated .d.ts TypeScript type files from the published package.

List of all changes

• #10877 - Remove .d.ts files from the package (@ahocevar)
• #10872 - Use TypeScript 3.9 for type generation for better enums (@ahocevar)

With more than 70 pull requests, this release not only brings significant improvements to the API documentation. It also fixes some old bugs and brings frequently requested improvements. And good news for TypeScript users: OpenLayers now ships with type definitions in .d.ts files.

New features and improvements

• Several improvements to the Graticule layer, like consistent labeling, no more missing graticule lines, and it now works for views that cross the date line.
• Better support for KML icon colors, as well as fills and outlines in PolyStyle
• Better ol/Overlay performance and support for panning off-screen overlays into view
• Most of the rendering code can now be run in web workers, e.g. to render to an OffscreenCanvas
• OpenLayers now works fine in web components with shadow root
• WebGL point layers now support rotation based on feature attributes

List of all changes

• #10490 - Select style multiple select interactions removed (@bepremeg)
• #10531 - Dynamically chose the number of subdivisions based on the size of the Image to reproject (@pjsg)
• #10618 - Add apidoc-debug task to debug the apidoc generation process (@MoonE)
• #10343 - Correct interactions with circle geometries when using user coordinates (@mike-000)
• #10864 - Update dependencies (@ahocevar)
• #10859 - Add an example of clipping layer based on a vector source (@SDaron)
• #10850 - API docs for enums (@ahocevar)
• #10857 - Make OSM XML example work at dateline and replace Bing with MapTiler (@mike-000)
• #10858 - Perform auto-pan when adding an Overlay to a Map (@ejn)
• #10646 - Write fill and outline in KML PolyStyle (@mike-000)
• #10800 - Make Overlay.panIntoView an API method (@ejn)
• #10807 - Handle Graticule wrapX without calculating excess meridians (@mike-000)
• #10795 - Show graticule labels in wrapped worlds (@mike-000)
• #10824 - Fix drawing svg icon with color option in ie11 (@MoonE)
• #10802 - Apidoc add default-exported enums (@MoonE)
• #10805 - make ImageSourceEventType available for consumers (@regileeso)
• #10822 - parsing color from IconStyle in KML files (@lysek)
• #10848 - Speed up Overlay element positioning using CSS translate() (@horsenit)
• #9590 - Calculate tile grid extent from extent of bottom-level tile matrix (@mloskot)
• #10845 - Fix createHitDetectionImageData error for features with no size (@gedaiu)
• #10842 - Fix custom symbol example short description (@mike-000)
• #10828 - Offscreen canvas example (@ahocevar)
• #10816 - Add 'funding' field to package.json (@marcjansen)
• #10813 - Add sponsors section to the readme (@tschaub)
• #10474 - Fix for undefined source in Image layer (@mike-000)
• #10785 - Detect Zoomify server-side retina tiles (@ahocevar)
• #10787 - Improved projection extent in the "Reprojection with EPSG.io Search" example (@mike-000)
• #10792 - Add support for EventListener Object (@flexjoly)
• #10777 - Keep the render loop running during simulation (@ahocevar)
• #10791 - iOS 12 touchmove: Prevent touchmove event default when no preceding pointer event (@sosmo)
• #10786 - Resolve constraints when updating size (@ahocevar)
• #10788 - Add safeguard to handleTouchMove (@sosmo)
• #10722 - fix: handle layer clear event in case clear(true) called (@jellyedwards)
• #10723 - Improve the extent transforms used by Graticule and handle extents crossing the dateline (@mike-000)
• #10744 - Ensure the Modify Features Test example opens at correct zoom (@mike-000)
• #10767 - Replace Bing layer with MapTiler in examples (@mike-000)
• #10751 - Sort events / observables in all cases (@MoonE)
• #10763 - TypeScript: Fix inconsistent optionality in various APIs (@jumpinjackie)
• #10758 - Allow using feature attributes for symbol rotation in WebGL layers (@jahow)
• #10748 - Fix "Cannot read property 'anchor' of undefined" in ol/View (@mike-000)
• #10746 - Fix building apidoc on windows (@MoonE)
• #10720 - Apidoc better search (@MoonE)
• #10743 - Ignore user provided tile cache size when too small (@ahocevar)
• #10736 - Allow cluster source to unlisten from its source (@M393)
• #10739 - Fix typo in trackpad timeout (@ahocevar)
• #10740 - Document tabindex behavior for MouseWheelZoom and DragPan (@matthias-ccri)
• #10738 - Fix text background decluttering (@ahocevar)
• #10715 - Fix disappearing graticule labels when rotation returns to 0 (@mike-000)
• #10713 - Draw graticule labels in a postrender function (@mike-000)
• #10711 - Make sure that optional args are typed accordingly (@ahocevar)
• #10710 - Fix stylefunction return type (@ahocevar)
• #10709 - Fix type and documentation of style function (@ahocevar)
• #10708 - Handle Select interactions with falsey select style (@ahocevar)
• #10707 - Get default projection for overview map from main map. (@AugustusKling)
• #10699 - Make Select interaction work when there are multiple instances (@ahocevar)
• #10694 - Draw image with configured opacity (@M393)
• #10703 - CI and test fixes (@ahocevar)
• #10698 - Shadow root (@ahocevar)
• #10688 - Publish type definition files (@ahocevar)
• #10691 - Do not exceed color range (@ahocevar)
• #10683 - Dispatch enterfullscreen and leavefullscreen from the FullScreen control (@fredj)
• #10676 - Document that overviewmap view must use same projection as main map (@mike-000)
• #10678 - Add maxResolution option to ol/tilegrid.createXYZ() and ol/source/XYZ (@mike-000)
• #10690 - Document minZoom and maxZoom options for all layers (@mike-000)
• #10672 - Nicer mousewheel and trackpad zooming (@ahocevar)
• #10687 - Increase timeout in listenImage test (@fredj)
• #10684 - perf: only do expensive reload when texture changes (@jellyedwards)
• #10675 - typo (@jipexu)
• #10669 - More browser compatible Export Map example (@mike-000)
• #10667 - Do not render label with the current linedash (@ahocevar)
• #10666 - Load polyfill before example specific scripts in examples template (@mike-000)
• #6526 - Draw interaction: add abortDrawing method and drawabort event (@tchandelle)
• #10657 - Changelog for v6.2.1 (@openlayers)

This is a bugfix release which resolves bundler issues due to a circular dependency, and brings a few documentation and example fixes.

List of all changes

• #10656 - Fix for export PDF example compatibility issues, and layer opacity handling. (@mike-000)
• #10653 - More reliable check for module content beyond classes (@ahocevar)
• #10617 - Improve apidoc generation performance (@MoonE)
• #10625 - Apidoc cleanup navigation html (@MoonE)
• #10649 - Remove circular dependency (@ahocevar)
• #10637 - Develop on 6.2.1 (@openlayers)

With almost 90 pull requests, this release brings several new features, performance improvements and bug fixes. In addition to that, we once again improved the API documentation and the example pages.

New features and improvements

• Mousewheel zooming now brings the same user experience as trackpad zooming. One click on the wheel no longer means a jump of a whole zoom level. Instead, depending on the speed of moving the wheel, the user has fine-grained control over zoom increments/decrements.
• Users now have better control over the initial map viewport when the aspect ratio of the map is different from a specified initial extent.
• Text rendering has been optimized for decluttering and improved for rotated views. This means lower memory footprint and no more blurry text when the map is rotated. Note: Whit this change, the label cache has been deprecated.
• A new displacement option for icon, circle and regular shape styles makes positioning of point symbolizers more flexible.
• Several improvements have been made to the KML parser for reading styles, bringing the rendered result much closer to Google Earth.
• OpenLayers is now less aggressive on stopping events and preventing event default behavior. This means that users have more control over events, making it easier to use interactive SVGs as layers and to embed maps on scrollable pages.
• Vector tile layers now have a vector render mode, which brings improved zooming experience for sources with not too much data.
• We replaced the previous pointer events polyfill to elm-pep, which should work better in web components.

List of all changes

• #10613 - Show KML name labels for Points in MultiGeometry (@mike-000)
• #10632 - Draw interaction: Append coordinates to polygons and lines (reworked) (@jahow)
• #9565 - Make mousewheel zoom behave like trackpad zoom. (@dbrnz)
• #10580 - Fix KML Polystyle outline 0 conflict with Linestyle for linestrings (@mike-000)
• #10612 - Make examples work in Internet Explorer (@ahocevar)
• #10587 - Adds option to View for using larger resolution value when clamping #10586 (@jeremy-smith-maco)
• #10607 - Update elm-pep to fix builds for IE < 11 (@ahocevar)
• #10598 - Remove inheritDoc to work around JSDoc issue (@ahocevar)
• #10574 - Text rendering improvements (@ahocevar)
• #10591 - Remove obsolete license notice (@ahocevar)
• #10588 - Sort doc navigation properly and add missing modules (@ahocevar)
• #10581 - Use package-lock.json for the checksum calculation (@DanielRuf)
• #10584 - fixed issue with version throwing an error if it is null (@MrSoUndso)
• #10575 - Fix ol/layer/Graticule rendercomplete problem (@mike-000)
• #10562 - Zoomify: Separate the service pixel ratio and the device pixel ratio (@crubier)
• #10573 - Replace Bing layer with MapTiler in example (@mike-000)
• #10570 - Use correct extent for the vector image (@ahocevar)
• #10572 - Assert each layer is only added to the map once (@ahocevar)
• #10563 - More compatible way of exporting a map as pdf (@ahocevar)
• #10545 - Make KML point feature styles compatible with declutter (@mike-000)
• #10542 - Replace Bing layer with MapTiler in KML example (@mike-000)
• #10543 - @api tag must not have a value. (@MoonE)
• #10547 - Only generate module apidoc pages when it contains api tags (@MoonE)
• #10502 - Stop events that originate with a removed target (@walkermatt)
• #10527 - Remove label cache, render text directly to target canvas (@ahocevar)
• #10534 - [GeoJSON] Read projection from CRS type EPSG (@wussup)
• #10430 - Offset regular shape (@Razi91)
• #10513 - fixed flag-name in upgrade notes (@fgubler)
• #10504 - Fix for reset north when rotation is 360 degrees (@mike-000)
• #10510 - Remove build/apidoc before running jsdoc again (@MoonE)
• #10498 - Fixing issue #10497 on behalf of LarryHuang (@gazza0)
• #10496 - Do not stop events when dragging (@ahocevar)
• #10478 - Do not abort and dispose of tiles (@ahocevar)
• #10495 - typo in view.fit (@danielklim)
• #10473 - Fix for undefined source in Vector layer (@mike-000)
• #10484 - Use a function to get the value of the gradient (@fredj)
• #10262 - Rework to make Document and XMLSerializer lazy and injectable (@bjornharrtell)
• #10461 - Fix link in apidocs to ObjectEvent. (@MoonE)
• #10413 - Limit the ZoomSlider's range to the view's constrained resolution. (@MoonE)
• #10438 - Avoid accessing the DOM to read the viewport size too often (@jahow)
• #10439 - WebGL points layer / add support for symbol rotation (@jahow)
• #10434 - Disable image smoothing for the DEM source in the Sea Level example (@mike-000)
• #10417 - Replace Bing layer with MapTiler (@mike-000)
• #10415 - Control button span element pointer events (@mike-000)
• #10409 - Improve viewport computation in WebGL Postprocessing (@jahow)
• #10119 - Add crossOrigin option to ol/format/KML for icons (@mike-000)
• #10181 - add tags to example docs (@roemhildtg)
• #10407 - Use render feature compatible extent check (@ahocevar)
• #10340 - Draw circles and custom geometry in user coordinates (@mike-000)
• #10393 - getFeaturesInExtent function for ol/source/VectorTile (@ahocevar)
• #10402 - Do not preventDefault on pointerdown (@ahocevar)
• #10269 - Replace the BNG layer source in the Raster Reprojection example (@mike-000)
• #10394 - Remove map renderer element when disposing (@ahocevar)
• #10391 - Use box-shadow css instead of filter (@ahocevar)
• #10392 - Fix interim tile handing for vector tiles (@ahocevar)
• #10380 - Adjust examples for layer canvas pixel ratio and rotation (@mike-000)
• #10384 - Include Transform typedef in API (@mike-000)
• #10385 - Import transpiled rbush (@walkermatt)
• #10363 - Interactive SVG layer example (@ahocevar)
• #10120 - Resolve constraints using anchor if following a cancelled animation (@mike-000)
• #10370 - Replace Bing layer with MapTiler (@mike-000)
• #10362 - Remove line that was accidently added with #10332 (@ahocevar)
• #10309 - Bring back vector render mode for vector tile layers (@ahocevar)
• #10332 - Conditional default prevention instead of touch-action: none (@ahocevar)
• #10301 - Create hit detection data per layer and without requestAnimationFrame (@ahocevar)
• #10347 - Set utfgrid tile as loaded after load instead of empty (@adube)
• #10344 - Fix lazy UTFGrid loading (@ahocevar)
• #10321 - Support touch events for DragBox interaction (@greggian)
• #10315 - Replace Bing sources in some examples (@mike-000)
• #10330 - Fix modifying circle geometries (@greggian)
• #10318 - Use a minimalist pointer events polyfill (@ahocevar)
• #10322 - Update tile grid option descriptions (@mike-000)
• #10308 - Fix feature lookup after removal of alpha (@ahocevar)
• #10310 - Ensure that OverviewMap respects the initial rotation of attached Maps (@brianhelba)
• #10302 - Do not use Math.sign() to support very old browsers (@ahocevar)
• #10295 - Do not fail when hit detecting features without style (@ahocevar)
• #10293 - Do not hit detect while tile is loading (@ahocevar)
• #10292 - Fix typo in jsdoc in ol/source/WMTS (@jomue)
• #10291 - tabindex without focus condition (@ahocevar)
• #10286 - Use passive option to avoid Chrome warning (@ahocevar)
• #10285 - Fix WMS GetLegendGraphic example codesandbox error (@mike-000)
• #10283 - Use the originalEvent in the targetNotEditable condition (@fredj)
• #10282 - Fix documentation of Stroke.lineDash default value (@jansule)
• #10259 - Remove all the sketch features in abortDrawing (@fredj)
• #10265 - Update operators doc in WebGL points layer example (@fredj)
• #10256 - Do not bypass measureTextWidth (@ahocevar)
• #10264 - Remove unused variable from vertex shader (@fredj)
• #10257 - Allow View.adjust* methods to take a null opt_anchor (@brianhelba)
• #10261 - WebGL / do not throw error when shader compilation gives a warning (@jahow)
• #10255 - Don't use instanceof HTMLElement in handleMapBrowserEvent (@fredj)

6.1.1

Hot on the heels of OpenLayers 6.x, this patch release includes a few fixes for existing functionality. There should be nothing special needed to upgrade an application from 6.x to 6.1.1. See the 6.0.0 release notes for details on upgrading from an older version.

Changes

• #10235 - Various optimizations and fixes for the WebGL points renderer (@jahow)
• #10244 - Update to new eslint config with no-multi-assign (@ahocevar)
• #10243 - Store correct font value (@ahocevar)
• #10239 - Simpler container reuse (@ahocevar)
• #10237 - Fix layer zIndex test with falsy values (@fredj)
• #10221 - Fix for undefined Source (@Kai-W)
• #10228 - Use render tiles instead of source tiles for hit detection (@ahocevar)
• #10226 - ABORT reproj tiles properly (@ahocevar)
• #10224 - Vector tile hit detection fixes (@ahocevar)
• #10218 - Documentation fixes in ol/style/expressions (@fredj)
• #10216 - Update changelog script to recognize dependabot instead of greenkeeper (@ahocevar)

With 47 pull requests, this release keeps up the momentum of the v6.x effort and brings several bug fixes, performance improvements and new features. In addition to that, we added some missing documentation to our API docs and gave them some usability improvements.

New features

• A new, performance optimized hit detection API on the layer level, Layer#getFeatures(pixel) has been introduced. At this point it is implemented for vector, vector tile and image vector layers, and is recommended when performance is critical, e.g. for hit detection on mouseover.
• For the WebGLPoints layer, we made several additions to the style expressions system. This includes a case operator, support for array and string types, and type checking.

List of all changes

• #10214 - WebGL / Add 'case' operator for style expressions (@jahow)
• #10198 - WebGL renderer / use the specified loading strategy for the vector data (@jahow)
• #10212 - Add config file for dependabot (@fredj)
• #10187 - Set touch-action to allow native touch gestures (@ahocevar)
• #10194 - Added check to make sure extent array has four objects. (@MrSoUndso)
• #10204 - Avoid scrolling over navigation (@tschaub)
• #10205 - Add the default to the type column (@tschaub)
• #10178 - Make ol/interaction/Select#handleEvent return always true. (@TieSKey)
• #10203 - Keep issues assigned to a milestone from going stale (@tschaub)
• #10200 - Carbon add on API docs (@tschaub)
• #10196 - Webgl / add support for string and arrays in style expressions (@jahow)
• #10197 - Restore node v8 compatibility (@ahocevar)
• #10195 - Treat hsl/hsla as named colors (@mike-000)
• #10188 - Document that map render events do not have a context set (@ahocevar)
• #10184 - Clamp the weight value between 0 and 1 (@fredj)
• #10175 - Remove description from type tag (@tschaub)
• #10176 - Avoid toggling when clicking the title (@tschaub)
• #10172 - Ensure inherited docs are shown (@ahocevar)
• #10171 - Open default attributions links in a new tab or window (@mike-000)
• #10047 - Apidoc changes (@KaiVolland)
• #10161 - Implement getFeatures() for ol/layer/VectorImage (@ahocevar)
• #10168 - Webgl / Add support for filtering and color interpolation in style expressions (@jahow)
• #10170 - Add back html from select-features example (@openlayers)
• #10093 - Set label text for Graticule option styles (@mike-000)
• #10160 - Improve test in case of async call (@ejn)
• #10159 - Fix target name collision in event.Target and Control (@ejn)
• #10142 - Fix tilechange events (@ahocevar)
• #10138 - Should be able to ovveride defaultvalue of style in selection. (@wirdehall)
• #10135 - Revise the description of applyTransform for geometries (@mike-000)
• #10133 - Properly unregister source tile change listeners (@ahocevar)
• #10094 - New Layer#getFeatures method with fast hit detection (@ahocevar)
• #10104 - Remove font sizing from the attribution control (@openlayers)
• #10108 - Fix documentation for handleMoveEvent (@notnotse)
• #10118 - Document the OSM crossOrigin default (@mike-000)
• #10112 - No ERROR state for render tiles (@ahocevar)
• #10115 - Improve Heatmap hit detection test (@jahow)
• #10111 - Correct the defaulting of ol/source/VectorTile maxZoom (@mike-000)
• #10102 - Cosmetic type fixes (@KlausBenndorf)
• #10107 - Update Vector Tile Info example test for no features (@mike-000)
• #10097 - Align layer canvas to the left (@fredj)
• #10101 - Add hit detection support on the Heatmap layer (@jahow)
• #10087 - Add example showing vector tiles in EPSG:4326 (@petrsloup)
• #10086 - Update mapbox-style example (@petrsloup)
• #10083 - webgl points layer example fixes (@MoonE)
• #10076 - Remove unnecessary typecast (@fredj)
• #10074 - Remove offsets from mouse position calculation (@mike-000)
• #10072 - Better typing (@fredj)