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