1 | # 3.2.0
|
2 |
|
3 | ## Summary
|
4 |
|
5 | The 3.1.0 release includes 70 merged pull requests since 3.1.0. Of note, the KML format [now parses `NetworkingLink` tags](https://github.com/openlayers/openlayers/pull/3171). The [measure example](https://openlayers.org/en/v3.2.0/examples/measure.html) was [reworked](https://github.com/openlayers/openlayers/pull/3206) to display measurements and help messages while drawing. A WMTS GetCapabilities format was [added](https://github.com/openlayers/openlayers/pull/3026). The WebGL renderer [now supports feature hit detection](https://github.com/openlayers/openlayers/pull/3065) (on point features). And you can now [detect](https://github.com/openlayers/openlayers/pull/3172) features/colored pixels on image and tile layers! See the full list of [changes](#changes) below.
|
6 |
|
7 | ## Upgrade notes
|
8 |
|
9 | The 3.2.0 release maintains a backwards-compatible API with the 3.1.0 release, so upgrades should be painless. Some special considerations below.
|
10 |
|
11 | * You should not call `view.setRotation` with `undefined`, to reset the view rotation to `0` then use `view.setRotation(0)` (see [#3176](https://github.com/openlayers/openlayers/pull/3176)).
|
12 |
|
13 | * If you use `$(map.getViewport()).on('mousemove')` to detect features when the mouse is hovered on the map, you should now rely on the `pointermove` map event type and check in the `pointermove` listener that the `dragging` event property is `false` (see [#3190](https://github.com/openlayers/openlayers/pull/3190)).
|
14 |
|
15 | ## Changes
|
16 |
|
17 | * [#3171](https://github.com/openlayers/openlayers/pull/3171) - KML: Parsing of NetworkLink tag ([@oterral](https://github.com/oterral))
|
18 | * [#3209](https://github.com/openlayers/openlayers/pull/3209) - Coding style fixes ([@fredj](https://github.com/fredj))
|
19 | * [#3208](https://github.com/openlayers/openlayers/pull/3208) - Add setters and getters for imageLoadFunction ([@bartvde](https://github.com/bartvde))
|
20 | * [#3019](https://github.com/openlayers/openlayers/pull/3019) - Add option to allow Select interaction logic to select overlapping features ([@bjornharrtell](https://github.com/bjornharrtell))
|
21 | * [#3206](https://github.com/openlayers/openlayers/pull/3206) - Add tooltip to show measure + help message while drawing ([@pgiraud](https://github.com/pgiraud))
|
22 | * [#3205](https://github.com/openlayers/openlayers/pull/3205) - Use ol.extent.createOrUpdateFromCoordinate ([@fredj](https://github.com/fredj))
|
23 | * [#3026](https://github.com/openlayers/openlayers/pull/3026) - Add support of reading WMTS Get Cap document ([@htulipe](https://github.com/htulipe))
|
24 | * [#3201](https://github.com/openlayers/openlayers/pull/3201) - Pass on opt_fast to parent clear function in ol.source.ServerVector (r=@elemoine,@gberaudo) ([@bartvde](https://github.com/bartvde))
|
25 | * [#3199](https://github.com/openlayers/openlayers/pull/3199) - Minor jsdoc fixes ([@fredj](https://github.com/fredj))
|
26 | * [#3059](https://github.com/openlayers/openlayers/pull/3059) - Cache the buffered extent value ([@fredj](https://github.com/fredj))
|
27 | * [#3196](https://github.com/openlayers/openlayers/pull/3196) - Remove unnecessary newlines ([@fredj](https://github.com/fredj))
|
28 | * [#3099](https://github.com/openlayers/openlayers/pull/3099) - Fix up parsing of OGR GML with ol.format.GML ([@bartvde](https://github.com/bartvde))
|
29 | * [#3195](https://github.com/openlayers/openlayers/pull/3195) - Coding style ([@fredj](https://github.com/fredj))
|
30 | * [#3192](https://github.com/openlayers/openlayers/pull/3192) - Add "url" option to ol.source.MapQuest ([@elemoine](https://github.com/elemoine))
|
31 | * [#3172](https://github.com/openlayers/openlayers/pull/3172) - Introduce forEachLayerAtPixel ([@tsauerwein](https://github.com/tsauerwein))
|
32 | * [#3178](https://github.com/openlayers/openlayers/pull/3178) - GeoJSON externs fixes ([@fredj](https://github.com/fredj))
|
33 | * [#3179](https://github.com/openlayers/openlayers/pull/3179) - Disallow undefined values for ol.layer.Base ([@fredj](https://github.com/fredj))
|
34 | * [#3161](https://github.com/openlayers/openlayers/pull/3161) - Doc fix. writeFeaturesNode receives an array of Feature ([@3x0dv5](https://github.com/3x0dv5))
|
35 | * [#3169](https://github.com/openlayers/openlayers/pull/3169) - Fix default icon style in kml format ([@oterral](https://github.com/oterral))
|
36 | * [#3190](https://github.com/openlayers/openlayers/pull/3190) - Introduce `dragging` flag for MapBrowserEvent ([@tsauerwein](https://github.com/tsauerwein))
|
37 | * [#3135](https://github.com/openlayers/openlayers/pull/3135) - Make changing the label of ZoomToExtent/FullScreen control consistent ([@tsauerwein](https://github.com/tsauerwein))
|
38 | * [#3186](https://github.com/openlayers/openlayers/pull/3186) - Take the pixel ratio into account when clipping the layer ([@fredj](https://github.com/fredj))
|
39 | * [#3183](https://github.com/openlayers/openlayers/pull/3183) - Allow other params than 'mode' in example page query string. ([@htulipe](https://github.com/htulipe))
|
40 | * [#2791](https://github.com/openlayers/openlayers/pull/2791) - Re enable rotation button transition ([@fredj](https://github.com/fredj))
|
41 | * [#3180](https://github.com/openlayers/openlayers/pull/3180) - Add a getMap function to ol.FeatureOverlay (r=@ahocevar) ([@bartvde](https://github.com/bartvde))
|
42 | * [#3176](https://github.com/openlayers/openlayers/pull/3176) - Disallowed undefined rotation value ([@fredj](https://github.com/fredj))
|
43 | * [#3177](https://github.com/openlayers/openlayers/pull/3177) - Add example showing how to style polygon vertices ([@tsauerwein](https://github.com/tsauerwein))
|
44 | * [#3174](https://github.com/openlayers/openlayers/pull/3174) - Use view.getRotation or view.getResolution instead of view.getState ([@fredj](https://github.com/fredj))
|
45 | * [#3170](https://github.com/openlayers/openlayers/pull/3170) - Coding style ([@fredj](https://github.com/fredj))
|
46 | * [#3108](https://github.com/openlayers/openlayers/pull/3108) - Support skipping features in the WebGL renderer ([@tsauerwein](https://github.com/tsauerwein))
|
47 | * [#3163](https://github.com/openlayers/openlayers/pull/3163) - Use the layerStatesArray property from the frameState ([@fredj](https://github.com/fredj))
|
48 | * [#3159](https://github.com/openlayers/openlayers/pull/3159) - Don't pass specific options to the parent constructor ([@fredj](https://github.com/fredj))
|
49 | * [#3066](https://github.com/openlayers/openlayers/pull/3066) - Introduce hasFeatureAtPixel ([@tsauerwein](https://github.com/tsauerwein))
|
50 | * [#3065](https://github.com/openlayers/openlayers/pull/3065) - Add hit-detection support for WebGL ([@tsauerwein](https://github.com/tsauerwein))
|
51 | * [#3128](https://github.com/openlayers/openlayers/pull/3128) - Allow rendering of feature when download of icon failed ([@oterral](https://github.com/oterral))
|
52 | * [#3156](https://github.com/openlayers/openlayers/pull/3156) - Move readProjectionFrom* functions to the base classes ([@fredj](https://github.com/fredj))
|
53 | * [#3107](https://github.com/openlayers/openlayers/pull/3107) - Also listen on loading images ([@elemoine](https://github.com/elemoine))
|
54 | * [#3153](https://github.com/openlayers/openlayers/pull/3153) - Add missing GeoJSONFeature#bbox property ([@fredj](https://github.com/fredj))
|
55 | * [#3154](https://github.com/openlayers/openlayers/pull/3154) - Remove unnecessary newlines ([@fredj](https://github.com/fredj))
|
56 | * [#3146](https://github.com/openlayers/openlayers/pull/3146) - Enable tests for ol.geom.flat.reverse ([@icholy](https://github.com/icholy))
|
57 | * [#3152](https://github.com/openlayers/openlayers/pull/3152) - Update closure-library and closure-util version ([@fredj](https://github.com/fredj))
|
58 | * [#3145](https://github.com/openlayers/openlayers/pull/3145) - Add wrapX option to source.OSM and source.BingMaps ([@elemoine](https://github.com/elemoine))
|
59 | * [#3139](https://github.com/openlayers/openlayers/pull/3139) - Add ol.control.Control#setTarget ([@elemoine](https://github.com/elemoine))
|
60 | * [#3144](https://github.com/openlayers/openlayers/pull/3144) - Update CONTRIBUTING style guide with recent guidelines ([@bartvde](https://github.com/bartvde))
|
61 | * [#3136](https://github.com/openlayers/openlayers/pull/3136) - Use array.length = 0 instead of goog.array.clear ([@fredj](https://github.com/fredj))
|
62 | * [#3140](https://github.com/openlayers/openlayers/pull/3140) - Avoid use of goog.array.clone with arrays. ([@tschaub](https://github.com/tschaub))
|
63 | * [#3122](https://github.com/openlayers/openlayers/pull/3122) - Revert "Use offsetX and offsetY if available" ([@fredj](https://github.com/fredj))
|
64 | * [#2385](https://github.com/openlayers/openlayers/pull/2385) - Option to update vector layers while animating ([@ahocevar](https://github.com/ahocevar))
|
65 | * [#3129](https://github.com/openlayers/openlayers/pull/3129) - Only update the rbush item if the extent has changed ([@fredj](https://github.com/fredj))
|
66 | * [#3117](https://github.com/openlayers/openlayers/pull/3117) - Add pixelRatio support for DOM vector renderer ([@ahocevar](https://github.com/ahocevar))
|
67 | * [#3124](https://github.com/openlayers/openlayers/pull/3124) - Add a space between scale -value and -unit ([@sirtet](https://github.com/sirtet))
|
68 | * [#3130](https://github.com/openlayers/openlayers/pull/3130) - Document default value ([@fredj](https://github.com/fredj))
|
69 | * [#3105](https://github.com/openlayers/openlayers/pull/3105) - ol.geom.Geometry#getExtent re-factoring ([@fredj](https://github.com/fredj))
|
70 | * [#3118](https://github.com/openlayers/openlayers/pull/3118) - Bugfix: "Cannot read property 'firstElementChild' of null" (WFS) ([@naturalatlas](https://github.com/naturalatlas))
|
71 | * [#3114](https://github.com/openlayers/openlayers/pull/3114) - Specify node version in CONTRIBUTING.md ([@elemoine](https://github.com/elemoine))
|
72 | * [#3106](https://github.com/openlayers/openlayers/pull/3106) - Don't pass specific options to the parent constructor ([@fredj](https://github.com/fredj))
|
73 | * [#3110](https://github.com/openlayers/openlayers/pull/3110) - Use svg instead of png to get better image quality ([@PeterDaveHello](https://github.com/PeterDaveHello))
|
74 | * [#2707](https://github.com/openlayers/openlayers/pull/2707) - Generate source map of minified ol.js ([@gberaudo](https://github.com/gberaudo))
|
75 | * [#3104](https://github.com/openlayers/openlayers/pull/3104) - Don't pass renderBuffer option to the parent constructor ([@fredj](https://github.com/fredj))
|
76 | * [#3096](https://github.com/openlayers/openlayers/pull/3096) - popup example cleanup / simplification ([@fredj](https://github.com/fredj))
|
77 | * [#3072](https://github.com/openlayers/openlayers/pull/3072) - Optimize canvas hit detection by rendering features in a limited extent. ([@tschaub](https://github.com/tschaub))
|
78 | * [#3101](https://github.com/openlayers/openlayers/pull/3101) - Use bracket notation instead of goog.object functions. ([@tschaub](https://github.com/tschaub))
|
79 | * [#3079](https://github.com/openlayers/openlayers/pull/3079) - Exclude source files from docs. ([@tschaub](https://github.com/tschaub))
|
80 | * [#3100](https://github.com/openlayers/openlayers/pull/3100) - Assert that ol.layer.Tile#getPreload is always set ([@fredj](https://github.com/fredj))
|
81 | * [#3084](https://github.com/openlayers/openlayers/pull/3084) - Changes from the v3.1.x branch. ([@openlayers](https://github.com/openlayers))
|
82 | * [#3094](https://github.com/openlayers/openlayers/pull/3094) - Remove AUTHORS.md. ([@tschaub](https://github.com/tschaub))
|
83 | * [#3089](https://github.com/openlayers/openlayers/pull/3089) - Fixed URL link for test README ([@mike-mcgann](https://github.com/mike-mcgann))
|
84 | * [#2894](https://github.com/openlayers/openlayers/pull/2894) - Simplify CSS code in custom-controls example ([@fredj](https://github.com/fredj))
|
85 | * [#3085](https://github.com/openlayers/openlayers/pull/3085) - Fixed documentation typo for return value of ol.proj.Projection.isGlobal(). ([@mike-mcgann](https://github.com/mike-mcgann))
|
86 | * [#3073](https://github.com/openlayers/openlayers/pull/3073) - Make map's deviceOptions map options ([@ahocevar](https://github.com/ahocevar))
|