Release 2.38.1

2.38.1 (2022-04-13)

Examples

• Navigation: fix addButton method call (c53ae71)

Workflow and chores

• release v2.38.1 (2ea8b0a)

Release 2.38.0

2.38.0 (2022-04-13)

Features

• FeatureGeometryLayer: introduce FeatureMesh, they are added to layer.object3d. (0d777ce)

  

• Widgets: add a searchbar widget (164b6ee)

• Widgets: add a widget to display a scale (d3a0154)

• Widgets: add show and hide methods (59ac32c)

• widgets: Navigation tooltips can be parametrized (094803f)

• Widgets: placeholder for searchbar can be modified (9bd81ce)

  

Bug Fixes

• Feature2Mesh: fix wrong computing of clockwise polygon. (bad5e34)
• GeoidLayer: transformation error on tileMesh. (472e39c)
• parser: GeoJsonParser add legacy identifier to fct readCRS() (a0195c6)
• VectorTileParser: clock wise polygon wasn't calculated. (135ee7a)
• View: fix pickCoordinates undefined parameter (0ec49f4)
• Widgets: fix focus policy and event propagation on widgets (7775a04)
• Widgets: fix in Navigation css (a85f8b4)

Examples

• change view source button style (e593237)
• FeatureGeometryLayer: add vector tile to 3d object. (53a42a6)
• view 3d: updates on widgets (30bee5f)
• Widgets: use minimap widget in view 3D example (5042ba7)

Code Refactoring

• Feature: move properties to private fields. (02604b9)
• Feature: simplify normals data. (0914834)
• GeometryLayer: reference to material properties from Layer properties. (23a0269)
• label: render only object with labels. (c317a8a)
• MainLoop: use class for MainLoop. (25a48fd)
• PlanarControls: change focus policy (99fadc0)
• view_3d_map: simplify example (3786dcf)
• View: move View properties to private fields. (51f5508)
• Widgets: add onClick property in Navigation (8d9f69e)
• Widgets: simplify Navigation usage (7c2bc89)

Workflow and chores

• add support ecma 2022 (25080d9)
• deps: bump deps to fix security vulnerability. (1db1ae7)
• deps: bump minimist from 1.2.5 to 1.2.6 (09e047a)
• deps: bump node-forge from 1.2.1 to 1.3.0 (e536532)
• submodule: use submodule for widgets. (44cc7d0)
• update packages. (e19809f)

Documentation

• core: Add doc for local execution (faf58be)
• Widgets: specify GlobeView support for navigation (c209fdc)
• Widgets: specify resources needed to use widgets (b65c081)

Tests

• Feature2Mesh: add test to calculate the difference with and without proj4. (1527c64)

Release 2.37.0

2.37.0 (2022-01-31)

Features

• Geoid: add support for geoid heights (38569f6)
• Parser: add parsers for GTX, ISG and GDF file formats (a55b154)
• View: add a method to pick world coordinates (91ccfe3)
• View: add support for ortho camera in getScale method (06eb805)
• View: dispatch an event when camera is moved (37cfb90)
• Widget: add a minimap widget (6d82c74)

Bug Fixes

• GlobeControl: stop damping when launching new animation (dad7641)
• test: fetch local laz files behind proxy. (b732c0a)
• View: fix picking radius with polygons (b7be8e9)

Examples

• Compass: add an example of a compass in a GlobeView (3290820)
• FileSource: add exemples of FileSource instantiation (7db9bcb)
• Potree: add an example of Potree intgration within iTowns (4bbc772)
• Potree: fix minor issues on the example (1ee50c8)
• source / file: simplify FileSource usage (21317b4)
• Widget: add an example of minimap widget (2b89f83)
• Widgets: add a plugin to display widgets (ec56fa9)
• add GeoidLayer implementation example (5df8cc5)

Code Refactoring

• TileMesh: refactorize bbox update method (18196b6)
• Widgets: rename widgets to navigation (509a042)

Workflow and chores

• deps-dev: bump marked from 4.0.8 to 4.0.10 (cfc9100)
• add potree repo and symbolic link to gitignore (d7bb92c)
• change itowns.github.io deploying (870299f)
• deploy itowns and potree bundle. (b104fd5)
• fix eslint rules. (6fff078)
• update CONTRIBUTING.md (96cfb21)
• update packages. (eb7c8d5)

Release 2.36.2

2.36.2 (2021-11-29)

Bug Fixes

• VectorTileSource: error if vector tile layer style is undefined. (b535583)

Code Refactoring

• Coordinates/Extent: rename dimension and distance methods. (6a436ac)
• examples: replace geoservice keys. (b81738c)
• Feature: defaults buildExtent parameter to true for 2d structure (3182075)

Release 2.36.1

2.36.1 (2021-11-22)

Bug Fixes

• View: wrong calculate pick radius with distance/zoom. (d5efa03)

Release 2.36.0

2.36.0 (2021-11-18)

Features

• Coordinates: add methods to calculate distance between coordinates. (acdf643)
• Crs: add isGeocentric method. (1ab76c8)
• Extent: add methods to calculate extent dimensions. (ed583d9)
• Label: add parameter to change labels padding property (33f8680)

Code Refactoring

• debug: remove id text in OBB helper. (d033279)
• Extent: throw error if the projection is geocentric. (e0048f7)
• Extent: use Extent.planarDimensions instead of Extent.dimensions (023d5fa)
• OBBHelper: remove OBBHelper text. (1e2fc31)
• TerrainMaterial: rename fogDepth -> vFogDepth (7d162ec)
• View: change label margin default. (8c6edf5)

Bug Fixes

• ColorLayer: fix shader when transparent is true (1a4f44d)
• ElevationLayer: scale elevation isn't updated (26d72da)
• Ellipsoid: wrong geodesic distance. (4d462f2)
• Extent: fix wrong calculating when apply matrix. (04abdd2)
• Feature: wrong altitude and altitude limits. (4746e86)
• Feature2Mesh: set scale transformation from FeatureCollection. (0f5cd07)
• FirstPersonControls: prevent context menu from poping (94bfd57)
• GlobeControls: fix black screen when zooming outside globe (3e0f23f)
• label2DRenderer: add frustum culling in global labels culling. (5ba4e9d)
• Point/3Dtiles: wrong geographical extent property for points cloud and 3Dtiles. (c663ce4)
• Style: copy order property when copying style (cab78ba)
• VectorTileSource: set style parent with style Layer (aba0743)

Examples

• 3dtiles_basic: update 3dtiles sources url (50d6733)
• 2.5d examples add wfs labels in 2.5d examples. (944e412)

Workflow and chores

• add contributor. (323b046)
• update packages. (ef204f9)

Documentation

• Ellipsoid: minor fix on geodesicDistance doc (a0cd2a3)

Release 2.35.0

2.35.0 (2021-09-16)

Features

• AnimationPlayer: add a callback ran at each animation frame (1280ce0)

Code Refactoring

• Controls: change deprecated mouseWheel event to wheel event (923d10c)
• Controls: handle mouse events in StateControls (ae1c30b)
• Controls: switch context menu management in StateControl (5fa010b)
• Controls: switch enabled property from GlobeControls to StateControl (76130b4)
• Controls: switch keyboard management to StateControls (a392a7b)
• Controls: switch wheel management to StateControl (4e64b75)
• StateControl: factorise handleMouse in pointer methods (0e626d8)
• StateControls: simplify setFromOptions method (a7d175f)

Bug Fixes

• c3DEngine: fix error when input renderer.domElement is a canvas (14567c1)
• CameraUtils: CameraTransformOptions parameter stopPlaceOnGroundAtEnd is no longer overriden (7f3a542)
• CameraUtils: compute precise altitude when setting CameraRig (011fcbc)
• Feature2Mesh: addapt indices array type from the size of polygon (378c092)
• GlobeControls: fix jittering move globe when devtool is open (825841c)
• Label: clamp labels altitude over 0 (ddd59e0)
• Label: enforce Labels div top position to 0 (08528d7)
• ShapefileParser: prevent ignoring input crs wen given (d2b90b7)

Examples

• camera traveling: add an example where user can pick points and have camera traveling between those points (6e79ff3)

Workflow and chores

• examples: change geoportail key. (36f0f40)
• move babel preset-env options to .babelrc (ad22bcc)
• remove import three examples polyfill. (48d52ae)
• up three 131.2 (aed4dbc)
• up to webpack 5. (ea36982)
• update packages. (909e96e)

Documentation

• minor update on Controls documentation (5f4ace1)
• Controls: minor doc fixes (d7c2ffa)

Release 2.34.0

2.34.0 (2021-07-30)

Features

• GlobeControls: add support for travel out animation (9db6ecb)
• Label: add support to pass custom domElements to labels (example) (b560005)
• Layer: add FeatureGeometryLayer. (0961787)
• StateControl: add a method to modify class properties (1e2e11e)
• Style: add support for custom icon in labels (7f355c4)
• Style: add support for custom label anchor (fe2a2d9)
• TMSSource: add support for specific TileMatrix identifier (e394255)
• View: add double right-click event (9ce7213)

Bug Fixes

• 3Dtiles: remove debugger command. (0a06614)
• eventToViewCoord: check if event.offset properties are defined (26f459a)
• example: generate correct URL when sharing EPT example (8ef0b34)
• FeatureToolTip: fix tooltip legend icon (f632308)
• Label: fix occlusion between icons and label text (29b6435)
• Label: fix Style.text.offset parameter (26b970b)
• Label: rounds the projected coordinates of labels (5d0ca6f)
• LayeredMaterialNodeProcessing: checks for source cache with the layer crs for command cancellation (7570cad)
• tutorial: fix internal link in tutorials (ce8029c)

Examples

• add an example where user can define custom controls (example) (00e62c2)
• GeoJSON raster: center the camera initial position on the displayed features (8d8ac2c)
• geojson-file: refactor example to illustrate two ways of displaying data from a file (4bc0774)
• vectorTile: replace expired source in vector tile examples (8ccc1a3)

Code Refactoring

• GlobeControls: switch travel animation to StateControl (d99827d)
• View: eventToViewCoords returns middle view coords by default (2e501c3)

Workflow and chores

• expose 3dtiles process methods. (7a94570)
• update packages. (50cd744)
• update html titles in some examples (7ea6538)

Documentation

• FeatureGeometryLayer: add jsdoc to documentation config (e77f102)
• README: update deprecated link (b483e0d)
• README: update integration badge to github action (4c77adf)
• Style: add precision on doc (bcee39f)
• tutorials: add support to sort tutorials in sections (e9c8510)
• Fundamentals: add links to documentation (cf30e37)
• Fundamentals: change section titles (296206f)
• Fundamentals: change tutorial links appearance (ac167ec)
• add tutorials on how to use iTowns (5916ac9)

Release 2.33.0

2.33.0 (2021-05-28)

BREAKING CHANGES

• Style/Convert: GeometryLayer.convert options are moved in Style properties.

  • color Convert option is replaced by:
    • Style.fill.color is replaced by:
    • Style.stroke.color
    • Style.point.color
  • altitude Convert option is replaced by:
    • Style.fill.base_altitude
    • Style.stroke.base_altitude
    • Style.point.base_altitude
  • extrude Convert option is replaced by:
    • Style.fill.extrusion_height
  • examples
    • wfs 2.5d
    • wfs 3d
    • gpx to 3d
    • geojson to 3d
  • documentation
    • Style
    • tutorial

• overrideAltitudeInToZero layer options is removed use Style.xxx.base_altitude instead.

• CameraUtils: The headings used in CameraUtils are now counted clockwise (they were
  previously counted counter-clockwise).

• Feature: FeatureCollection and Feature signature constructor are changed.

Features

• Use function to defines Style properties see example WFS to raster
• ColorLayer: add custom shader to ColorLayer. (2d32888)
• ColorLayer: add option to filtering textures Layer. (da245f9)
• Coordinates: add applyMatrix4 method. (061eda0)

Bug Fixes

• CameraUtils: count heading in clockwise direction (880c67d)
• CameraUtils: fix rotation animation when start heading is 0 (1ca0c17)
• CameraUtils: the camera rotation animation take the shortest angle (ae194d3)
• Controls: replace deprecated THREE.Quaternion.slerp. (2e27408)
• debug: update coordinates event on mouse move (9b62770)
• Feature: wrong condition to choose extent crs projection. (73198c7)
• FeatureToolTip: avoid undefined layer on move. (6ae7305)
• FileSource: transform extent source if is needed. (0177503)
• GeojsonParser: store geojson properties within a separate property (121b796)
• LabelLayer: init LabelLayer visibility with attached ColorLayer. (67f25a1)
• LayeredMaterialNodeProcessing: prevent errors in layer update when removing layer (d9fda75)
• PlanarControls: prevent freezing zoom when clicking while zooming with an orthographic camera (b0f0a2d)
• test: use Extent.applyMatrix4 and Coordinates.applyMatrix4. (bdf50ab)

Examples

• add custom shader effect example. (15163d9)
• change buildings id for coloring (3f7ccd0)

Code Refactoring

• ColorLayer: add effect type ColorLayer parameter. (19d58c6)
• ColorLayer: remove useless features in ColorLayer command. (66ee340)
• example: remove unuseless variable. (041b62a)
• Feature: compute and apply local transform matrix in Feature. (e244f55)
• Feature: declare constant in file begining. (f44c29e)
• Feature: FeatureCollection extends by Object3D and use local transform matrix. (8d20315)
• Feature: normalize crs projection. (f9df7ff)
• Feature: remove optionsFeature from FeatureCollection. (b15c642)
• Feature: replace parsing option withNormal and withAltitude by structure. (420ba1a)
• Feature: simplify build extent check. (0091a5a)
• Layer: deprecate labelEnable option Layer and replace by addLabelLayer. (082d22c)
• ShaderChunk: introduce shader chunk manager class to instance ShaderChunk. (e93ed76)
• Source: avoid to cache raster data in Source. (521ca74)
• Style/Convert: move options from Converter to Style. (23de259)
• VectorTileParser: remove unnecessary parameters. (860d748)

Workflow and chores

• chart.js: update chart.js to 3.0. (6953e01)
• update packages. (0f54e2e)

Documentation

• FeatureCollection: clarify FeatureCollection.extent projection. (f612eb3)
• View: add diffuse parameter documentation. (fcc16da)

Tests

• unit: update unit tests with feature refactoring. (cbe3e68)

Release 2.32.0

2.32.0 (2021-04-09)

Features

• PlanarControls: add max and min resolution parameters to limit zoom (ad17590)
• PlanarControls: Add property 'Cursor' and method 'setCursor' for cursor modification (0870ede)
• Style: support mapbox expression. (0581d3d)

Bug Fixes

• Atmosphere: avoid several realistic atmosphere initializations. (b949f75)
• Camera: resize preserves the scale (e44de7f)
• extent: forget copy zoom in Extent#transformedCopy. (1a607ea)
• Extent: forgetting zoom property copy, in Extent.as(). (3efea0e)
• Label: wrong div translate. (5ef7197)
• PlanarControls: fix drag when moving out of view domElement (a4f0a3f)
• PlanarControls: prevent triggering new movement when already moving (66256bb)
• test: apply async icon label loading. (76d732a)
• test: update label test with default icon size. (72a98d4)
• test: update vector tile style test with context expression. (c9fc662)
• VectorTileSource: failing to open mapbox url format. (b6dd383)

Examples

• Orthographic: add resolution limit parameters in orthographic examples (aafd37b)
• add atmosphere mars example. (27e28ad)
• update irrelevant titles in some examples (2914286)

Code Refactoring

• Atmosphere: move realistic atmosphere options to Atmosphere constructor. (234a8ee)
• Source: remove extentsInsideLimit. (035701b)
• VectorTilesSource: remove useless styles by zoom. (baabbae)

Workflow and chores

• update packages. (e9ae835)

Documentation

• GeometryLayer: fix example and typo regarding Object3D (d77c8d6)
• TMSSource: add example in doc (dce0032)