@giro3d/giro3d - npm Package Versions

v0.42.0 (2025-02-10)

Improved 3D Tiles support

This release integrates the 3d-tiles-renderer package into Giro3D. This enables a much better support for the 3D Tiles format, including the 3D Tiles 1.1 specification. This makes it very easy to load Google Photorealistic 3D Tiles into Giro3D !

Cast shadows and dynamic lighting in Maps

Maps now support light-based shadows and lighting provided by three.js lights, in addition to the hillshade mode (which is still the default mode). When using this mode, the terrain is shaded by all directional and point lights in the scene. This allows for light-based simulations such as sun shadows for a given time of day for example.

BREAKING CHANGE

• Map lighting and shading options have changed:

  • Map lighting options are now under entities/ rather than core/
  • Map lighing options are renamed MapLightingOptions
  • Hillshade specific lighting options are prefixed hillshade (e.g hillshadeAzimuth, hillshadeIntensity...)

• The Tiles3D entity's API has changed and the Tiles3DSource class is removed. Please refer to the API documentation for more information.

• The ColorMap constructor now uses named parameters rather than positional parameters, i.e new ColorMap({ colors, min, max })

• ColorMap and ColorMapMode are moved from /core/layer/ into /core since they don't apply only to layers.

Feat

• Map: support light-based lighting and shadows (#502, #443)
• Sun: add functions to compute the position of sun
• AxisGrid: support adaptive labels (#555)
• AxisGrid: add "label-created" event to customize the DOM label after creation
• ColorMap: add .clone() method
• Tiles3D: replace underlying implementation with 3d-tiles-renderer (#191)
• StatusBar: add function to dynamically update attributions
• FeatureCollection: support shading through the style API
• WmsSource: add support for the .requestPriority constructor option (#305)
• VectorTileSource: add support for the .requestPriority constructor option (#305)
• VectorSource: add support for the .requestPriority constructor option (#305)
• TiledImageSource: add support for the .requestPriority constructor option (#305)
• StaticImageSource: add support for the .requestPriority constructor option (#305)
• GeoTIFFSource: add support for the .requestPriority constructor option (#305)
• ImageSource: support HTTP priorities (#305)
• Fetcher: support request priority (#305)
• PointCloud: add the .brightness, .constrast and .saturation properties

Fix

• GeoTIFFSource: fix incorrect count of images (#568)
• PointCloud: clone the default ColorMap
• PointCloudMaterial: enable transparent flag if colormap has an opacity array (#559)
• PointCloud: compute the world matrix of the node before the bounding box (#556)
• GeometryConverter: support triangulation of vertical polygons (#544)

v0.41.0 (2024-12-19)

This release brings support for LAS-based point clouds, such as LAS/LAZ files, COPC files and Potree 1 tilesets with LAZ tiles (not Potree 2.x tilesets however). Those data sources are now consumed by the new PointCloud entity. The new AggregatePointCloudSource allows users to display many point cloud datasets under a single entity.

The DrawTool is also improved with performance optimizations as well as better configurability.

BREAKING CHANGE

• PotreePointCloud is removed. Use the PointCloud entity with a PotreeSource instead.
• PotreeSource constructor options have changed to match other point cloud sources.

Feat

• entities: add PointCloud entity
• sources: add PointCloudSource
• sources: add COPCSource and LASSource (#292)
• sources: add AggregatePointCloudSource
• DrawTool: end drawing polygons when clicking on first point (#542)
• DrawTool: allow specifying end condition (#541)
• Cache: add configure() method (#545)

Fix

• PointCloudMaterial: stop applying the offset scale from the layer
• PointCloudMaterial: don't dispose the colormap in the setter
• ConstantSizeSphere: honor camera zoom for size computation (#549)
• DrawTool: ensure that the new shape is immediately displayed (#547)
• Inspector: disable autocomplete on <input> elements (#526)
• WorkerPool: use a better metric to select the least busy worker
• PickPointsAt: remove limits on point count per mesh (#537)

Refactor

• PointCloudMaterial: don't automatically update colormap uniforms
• ColorMap: dispose the cached texture as late as possible
• PotreeSource: migrate to new PointCloud entity
• PickPointsAt: improve readability of point picking logic

Perf

• DrawTool: optimize edition by picking only shapes when possible (#548)
• PointsVS.glsl: add support for decimation
• PointsFS.glsl: avoid useless computations if point should be discarded
• PointsFS.glsl: use a square length computation instead of a length
• View: optimize performance of isBox3Visible() and isSphereVisible()