All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog and this project adheres to Semantic Versioning.
CesiumIonTilesRenderer
for more convenient use of the ion API.- Frustum check support for OBB bounding volumes resulting in more than 35-45% fewer tiles loading and displaying in some cases when OBB bounding volumes are used.
- Consolidate bounding volumes into a common class to simplify implementation.
- Progressively process recursive tileset tiles preventing frame stalls of up to and over 100ms in some cases when many or large child tilesets were loaded.
- GoogleTilesRenderer.setLatLonToYUp now sets X+ to north and Z+ to east
- TilesRenderer.dispose function not working correctly.
- Type declaration file for constants.
- Raycasting not working correctly with "additive" tile refinement.
- Case sensitivity when dealing with file formats.
- Race condition when setting the transformation of gltf files.
- Case where internal tilesets were not disposed of properly when calling "dispose".
- Incorrect calculation of geometric error when spheres are available.
- Support for rayasting tiles with sphere bounding volumes.
- Add "constructLatLonFrame" and "getNorthernTangent" to Ellipsoid class.
getBounds
andgetOrientedBounds
now return the AABB of a sphere if a tileset bounding box is not available.GoogleTilesRenderer
for rendering Google's Photorealistic 3D Tiles
- Support for DRACO-compressed PNTs files.
- Case where raycasting could return an incorrect result when
firstHitOnly
was true.
- Incorrect internal import statement.
- Incorrect type definitions.
- Export for glTF CESIUM_RTC extension.
- Removed unused exports.
- Classes for Ellipsoid and EllipsoidRegion.
- DebugTilesRenderer: Added "displayRegionBounds" flag.
- Support for region bounds by converting the volumes into sphere and box bounds.
- B3DMLoader: regression causing RTC_CENTER to not be respected.
- Support for GLTFLoader Cesium_RTC extension.
- Support for determining tile format based on magic bytes.
- Small fixes to the
dispose
function. - Re-add support for relative tile urls.
resetFailedTiles
to enable retry tile downloads that failed.
- Support for loading absolute URIs.
- Fix the application of the tile "up" axis adjustments.
- Incorrect argument order to
FeatureTable.getData
- ensuring the working path included a "/" at the end when generating new file paths for the GLTFExtension and B3DM loaders.
- "onPreprocessUrl" is now called for initial Tileset URL.
TilesRenderer.onTileVisibilityChange
callback.- Support for GLTF in tilesets (
3DTILES_content_gltf
extension).
- Improved type definitions.
PNTSLoader.parse
now returns a promise.- All model loaders on inherit from a common type.
- PriorityQueue: Added
schedulingCallback
to afford flexibility in job scheduling callback for scenarios whererequestAnimationFrame
will not work, such as with WebXR.
autoDisableRendererCulling
incorrectly applying the inverse of the documented effect.- Screen space error calculations now use the camera projectionMatrix rather than camera type to determine frustum type.
- Support for embedded tileset / tile geometry URLs with hashes, search query parameters.
- DebugTilesRenderer: Bounding boxes now colored down the tree based on depth.
- DebugTilesRenderer: "MeshStandardMaterial" is now used instead of "MeshBasicMaterial" for debugging.
- TilesRenderer: add
getBoundingSphere
function.
- DebugTilesRenderer: "RANDOM_NODE_COLOR" visualization setting.
- Names for various tile objects.
- DebugTilesRenderer: Added
getDebugColor
function for adjusing the debug visualization colors. - Support for computing screen space error for tiles that had sphere bounds but no box bounds.
- DebugTilesRenderer: Added
customColorCallback
andCUSTOM_COLOR
mode for custom debug coloring.
- I3DMLoader: Fixed embedded absolute URLs not working correctly.
- TilesRenderer: "getBounds" function throwing an error if no bounding box is present on the tileset.
- Case where tiles that were outside of the camera frustum would be loaded with a higher priority.
- Case where a single tiles renderer tiles would always be loaded with a higher priority.
- Case where bounding boxes with one dimension of 0 would not compute the distance to camera correctly.
path-browserify
dependency explicitly rather than relying on implicit polyfills forpath
package.
PriorityQueue.priorityCallback
now takes two arguments.- The default priority sort now accounts for most recently used tiles, screenspace error, and distance to the camera.
TilesRenderer.calculateError
no longer returns a value but is now expected to set__error
and__distanceToCamera
on the tile itself.
TilesRendererBase.preprocessURL
types definition.
- PNTS files incorrectly having a GLTF rotation adjustment applied.
TilesRenderer.optimizeRaycast
option to disable overriding the raycast function of loaded tiles.
- Added "sideEffects: false" to package.json.
- Bounding box visualization not displaying correctly with
DebugTilesRenderer
when the bounds have a width of 0 in one dimension.
onLoadTileSet
to the typescript definitions file.
- Feature table attributes like
RTC_CENTER
not being correctly applied to loaded tile geometry. B3DMLoader.load
not correctly resolving with a model.
- String decoding to use
TextDecoder
.
- Pass fetch options to B3DMLoader.
- Set working path for loaders from CMPTLoader, TilesRenderer callback.
- Adjust loader handler in examples and README to provide GLTFLoader directly.
- Add warnings if unsupported feature semantics are detected for I3DM and PNTS files
- Support for I3DM rotation, scale features.
- A case where I3DM instances could have an incorrect transformations by respecting existing Mesh transformations when converting them to InstancedMeshes.
- Make CMPTLoader group child order consistent between loads.
- I3DM files not correctly loading external gltf files.
- Incorrect use of
multiply
when computing world transformations resulting in incorrect positioning of tiles when non identity transformations are used.
- Feature and Batch Tables unnecessarily retaining full file buffer references.
getOrientedBounds
function toTilesRenderer
.preprocessURL
function toTilesRenderer
.
- Incorrectly removing the implicit y-up to z-up GTLF transformation.
- Support for external tile sets.
- B3DM support for RTC_CENTER.
- Add a readable message for when console.assert fails.
- Add url information to log when tile load fails.
- Jittering with I3DM files when instances are positioned at large scales.
- Compatible three.js version to v0.123.0.
PriorityQueue
to wait a frame to schedule new tasks instead of usingPromise.resolve
so tasks will only be started once per frame.
batchTable
andfeatureTable
fields onto loaded B3DM, I3DM, and PNTS scene objects directly.stopAtEmptyTiles
which defaults to false so tilesets correctly stop traversal at empty tiles.
- Tileset traversal now correctly stops at empty tiles if they do no meet the SSE requirement. Previous behavior can be retained for now by settings
stopAtEmptyTiles
tofalse
.
- Typescript declaration files for
CMPT
,I3DM
, andPNTS
loaders.
manager
field toTilesRenderer
to enable support for DRACO decompression.TilesRenderer.onLoadTileSet
callback function.- Support for "ADD" tile refinement.
CMPTLoader
not importingI3DMLoader
.- A case where if the tile at depth
maxDepth
was empty nothing would be rendered. - A case where an error was thrown if a mid tile had no content.
TilesRenderer.dispose
function to completely dispose of all loaded geometry, materials, and textures in the scene when the renderer is no longer needed.TilesRenderer.onDisposeModel
function which is called when a tile model is disposed of from the cache.
- Case where the url protocol was converted to use a single slash instead of two when loading a model.
- Corner case where an error was thrown if the tileset was dragged off screen out of camera view.
- Basic support for CMPT, PNTS, and I3DM file formats.
autoDisableRendererCulling
field toTilesRenderer
.- A count of the amount of failed tile content loads to
TilesRenderer.stats
.
- Failed tileset downloads being indefinitely retried.
- Tile content stats not being correctly updated if a tile failed to load.
- Not propagating image load errors.
- DebugTilesRenderer using a different color for every submesh in a tile. Now a single color is used for every submesh in a tile.
- Tiles not rendering if an empty tile is encountered.
- Child tiles not rendering if a parent tile content failed to load.
- Improved
update
function performance by deferring LRUCache array update.
- License text in README to remove unnecessary copy.
- Initial release.