Skip to content

Latest commit

 

History

History
720 lines (495 loc) · 49.3 KB

CHANGES.md

File metadata and controls

720 lines (495 loc) · 49.3 KB
Raw

Change Log

? - ?

Breaking Changes 📣
  • Cesium Native is now only regularly tested on Visual Studio 2019+, GCC 11.x+, and Clang 12+. Other compilers - including older ones - are likely to work, but are not tested.
  • Removed PropertyTablePropertyViewType and NormalizedPropertyTablePropertyViewType, as well as their counterparts for property textures and property attributes. When compiled with Clang, the large std::variant definitions would significantly stall compilation.
Additions 🎉
  • Added getClass to PropertyTableView, PropertyTextureView, and PropertyAttributeView. This can be used to retrieve the metadata Class associated with the view.
  • Added PropertyViewStatus::EmptyPropertyWithDefault to indicate when a property contains no data, but has a valid default value.
Fixes 🔧
  • Fixed the handling of omitted metadata properties in PropertyTableView, PropertyTextureView, and PropertyAttributeView instances. Previously, if a property was not required and omitted, it would be initialized as invalid with the ErrorNonexistentProperty status. Now, it will be treated as valid as long as the property defines a valid defaultProperty. A special instance of PropertyTablePropertyView, PropertyTexturePropertyView, or PropertyAttributePropertyView will be constructed to allow the property's default value to be retrieved, either via defaultValue or get. getRaw may not be called on this special instance.
  • Updated the Cesium ion OAuth2 URL from https://cesium.com/ion/oauth to https://ion.cesium.com/oauth, avoiding a redirect.

v0.28.0 - 2023-09-08

Breaking Changes 📣
  • Views of the data contained by EXT_feature_metadata will no longer supported by Cesium Native. The extension will still be parsed, but it will log a warning.
  • Batch tables will be converted to EXT_structural_metadata instead of EXT_feature_metadata.
  • In CesiumGltf, all generated classes related to EXT_feature_metadata are now prefixed with ExtensionExtFeatureMetadata. For example, ClassProperty has become ExtensionExtFeatureMetadataClassProperty. This also extends to the glTF reader and writer.
  • In CesiumGltf, all generated classes related to EXT_structural_metadata have had their ExtensionExtStructuralMetadata prefix removed. For example, ExtensionExtStructuralMetadataClassProperty has become ClassProperty. This also extends to the glTF reader and writer.
  • In CesiumGltf, ExtensionExtMeshFeaturesFeatureId and ExtensionExtMeshFeaturesFeatureIdTexture have been renamed to FeatureId and FeatureIdTexture respectively.
  • Replaced FeatureIDTextureView with FeatureIdTextureView, which views a FeatureIdTexture in EXT_mesh_features. Feature ID textures from EXT_feature_metadata are no longer supported.
  • Replaced MetadataFeatureTableView with PropertyTableView, which views a PropertyTable in EXT_structural_metadata.
  • Replaced MetadataPropertyView with PropertyTablePropertyView, which is a view of a PropertyTableProperty in EXT_structural_metadata. This takes two template parameters: a typename T , and a bool indicating whether or not the values are normalized.
  • Replaced MetadataPropertyViewStatus with PropertyTablePropertyViewStatus. PropertyTablePropertyViewStatus is a class that inherits from PropertyViewStatus, defining additional error codes in the form of static const values.
  • Replaced FeatureTextureView with PropertyTextureView, which views a PropertyTexture in EXT_structural_metadata.
  • Replaced FeatureTexturePropertyView with PropertyTexturePropertyView, which is a view of a PropertyTextureProperty in EXT_structural_metadata. This takes two template parameters: a typename T , and a bool indicating whether or not the values are normalized.
  • Removed FeatureTexturePropertyComponentType, FeatureTexturePropertyChannelOffsets, and FeatureTexturePropertyValue. PropertyTextureProperty retrieves the values with the type indicated by its class property.
  • Replaced FeatureTexturePropertyViewStatus with PropertyTexturePropertyViewStatus. PropertyTexturePropertyViewStatus is a class that inherits from PropertyViewStatus, defining additional error codes in the form of static const values.
  • Renamed FeatureIDTextureViewStatus to FeatureIdTextureViewStatus for consistency.
  • Renamed MetadataArrayView to PropertyArrayView.
  • Renamed FeatureTextureViewStatus to PropertyTextureViewStatus.
  • Refactored PropertyType to reflect the values of type in a ClassProperty from EXT_structural_metadata.
Additions 🎉
  • Added PropertyView, which acts as a base class for all metadata property views. This takes two template parameters: a type T , and a bool indicating whether or not the values are normalized.
  • Added PropertyViewStatus, which defines public static const values for various property errors.
  • Added PropertyTableViewStatus to indicate whether a PropertyTableView is valid.
  • Added PropertyComponentType to reflect the values of componentType in a ClassProperty from EXT_structural_metadata.
  • Added PropertyAttributeView, which views a PropertyAttribute in EXT_structural_metadata.
  • Added PropertyAttributePropertyView, which views a PropertyAttributeProperty in EXT_structural_metadata.
  • Added PropertyAttributePropertyViewStatus, which reflects the status of a PropertyAttributePropertyView.

v0.27.3 - 2023-10-01

Additions 🎉
  • Added support for Cesium ion "externalType" assets.
Fixes 🔧
  • Fixed corner cases where Tileset::ComputeLoadProgress can incorrectly report done (100%) before all tiles are actually loaded for the current view.

v0.27.2 - 2023-09-20

Additions 🎉
  • Added CESIUM_GLM_STRICT_ENABLED option to the CMake scripts. It is ON by default, but when set to OFF it disables the GLM_FORCE_XYZW_ONLY, GLM_FORCE_EXPLICIT_CTOR, and GLM_FORCE_SIZE_T_LENGTH options in the GLM library.
Fixes 🔧
  • Added a missing include to FeatureTexturePropertyView.h.
  • The CMake scripts no longer attempt to add the Catch2 subdirectory when the tests are disabled.

v0.27.1 - 2023-09-03

Fixes 🔧
  • Fixed a bug that could cause a crash when loading tiles with a raster overlay.

v0.27.0 - 2023-09-01

Breaking Changes 📣
  • Renamed ExtensionReaderContext to JsonReaderOptions, and the getExtensions method on various JSON reader classes to getOptions.
  • IExtensionJsonHandler no longer derives from IJsonHandler. Instead, it has a new pure virtual method, getHandler, that must be implemented to allow clients to obtain the IJsonHandler. In almost all implementations, this should simply return *this.
  • In SubtreeReader, SchemaReader, and TilesetReader, the readSubtree, readSchema, and readTileset methods (respectively) have been renamed to readFromJson and return a templated ReadJsonResult instead of a bespoke result class.
  • TileExternalContent is now heap allocated and stored in TileContent with a std::unique_ptr.
  • The root Tile of a Cesium3DTilesSelection::Tileset now represents the tileset.json itself, and the root tile specified in the tileset.json is its only child. This makes the shape of the tile tree consistent between a standard top-level tileset and an external tileset embedded elsewhere in the tree. In both cases, the "tile" that represents the tileset.json itself has content of type TileExternalContent.
Additions 🎉
  • Added new constructors to LocalHorizontalCoordinateSystem taking ECEF<->Local transformation matrices directly.
  • Unknown properties in objects read with a JsonReader are now stored in the unknownProperties property on ExtensibleObject by default. To ignore them, as was done in previous versions, call setCaptureUnknownProperties on JsonReaderOptions.
  • Added ValueType type alias to ArrayJsonHandler, for consistency with other JSON handlers.
  • Added an overload of JsonReader::readJson that takes a rapidjson::Value instead of a byte buffer. This allows a subtree of a rapidjson::Document to be easily and efficiently converted into statically-typed classes via IJsonHandler.
  • Added *Reader classes to CesiumGltfReader and Cesium3DTilesReader to allow each of the classes to be individually read from JSON.
  • Added getExternalContent method to the TileContent class.
  • TileExternalContent now holds the metadata (schema, schemaUri, metadata, and groups) stored in the tileset.json.
  • Added loadMetadata and getMetadata methods to Cesium3DTilesSelection::Tileset. They provide access to TilesetMetadata instance representing the metadata associated with a tileset.json.
  • Added MetadataQuery class to make it easier to find properties with specific semantics in TilesetMetadata.
Fixes 🔧
  • Fixed a bug where an empty error message would get propagated to a tileset's loadErrorCallback.
  • Fixed several small build script issues to allow cesium-native to be used in Univeral Windows Platform (UWP) applications, such as those that run on Holo Lens 2.
  • When KTX2 transcoding fails, the image will now be fully decompressed instead of returning an error.
  • Fixed a bug that could cause higher-detail tiles to continue showing when zooming out quickly on a tileset that uses "additive" refinement.
  • Fixed a bug that could cause a tile to never finish upsampling because its non-rendered parent never finishes loading.

v0.26.0 - 2023-08-01

Additions 🎉
  • Added caching support for Google Maps Photorealistic 3D Tiles. Or other cases where the origin server is using combinations of HTTP header directives that previously caused tiles not to go to disk cache (such as max-age-0, stale-while-revalidate, and Expires).
  • Added support for the EXT_meshopt_compression extension, which allows decompressing mesh data using the meshoptimizer library. Also added support for the KHR_mesh_quantization and KHR_texture_transform extensions, which are often used together with the EXT_meshopt_compression extension to optimize the size and performance of glTF files.
Fixes 🔧
  • Fixed a bug in the 3D Tiles selection algorithm that could cause missing detail if a tileset had a leaf tile that was considered "unconditionally refined" due to having a geometric error larger than its parent's.
  • Fixed a bug where GltfReader::readImage would always populate mipPositions when reading KTX2 images, even when the KTX2 file indicated that it had no mip levels and that they should be created, if necessary, from the base image. As a result, generateMipMaps wouldn't generate any mipmaps for the image.

v0.25.1 - 2023-07-03

Additions 🎉
  • Included generated glTF and 3D Tiles classes in the generated referenced documentation.
  • Updated the 3D Tiles class generator to use the main branch instead of the draft-1.1 branch.

v0.25.0 - 2023-06-01

Additions 🎉
  • Added computeTransformationToAnotherLocal method to LocalHorizontalCoordinateSystem.
  • Added support for the KHR_materials_variants extension to the glTF reader and writer.
  • Added GunzipAssetAccessor. It can decorate another asset accessor in order to automatically gunzip responses (if they're gzipped) even if they're missing the proper Content-Encoding header.
Fixes 🔧
  • On Tileset Load Failure, warning/error messages will always be logged even if the failure callback is set.
  • Fixed a bug that caused meshes to be missing entirely when upsampled from a parent with UNSIGNED_BYTE indices.

v0.24.0 - 2023-05-01

Additions 🎉
  • WebMapServiceRasterOverlay now allows query parameters in the base URL when building GetCapabilities and GetMap requests.
  • Added support for parsing implicit tilesets that conform to the 3D Tiles 1.1 Spec.
Fixes 🔧
  • Fixed various libjpeg-turbo build errors, including ones that occurred when building for iOS.

v0.23.0 - 2023-04-03

Breaking Changes 📣
  • Removed tilesLoadingLowPriority, tilesLoadingMediumPriority, and tilesLoadingHighPriority from ViewUpdateResult. Use workerThreadTileLoadQueueLength and mainThreadTileLoadQueueLength instead.
Additions 🎉
  • Added getOrientedBoundingBoxFromBoundingVolume to the Cesium3DTilesSelection namespace.
  • Added transform and toAxisAligned methods to OrientedBoundingBox.
  • Switched to libjpeg-turbo instead of stb for faster jpeg decoding.
  • Added getNumberOfTilesLoaded method to Tileset.
  • Changed how TilesetOptions::forbidHoles works so that it loads much more quickly, while still guaranteeing there are no holes in the tileset.
  • Added frameNumber property to ViewUpdateResult.
  • Added getters for the stride and data fields of AccessorView.
  • Added startNewFrame method to ITileExcluder.
  • Added CreditSystem.setShowOnScreen and Tileset.setShowCreditsOnScreen to allow on-screen credit rendering to be toggled at runtime.
Fixes 🔧
  • Fixed a bug that caused the center field of AxisAlignedBox to be incorrect.
  • Fixed a bug that caused the main thread to sometimes load low-priority tiles before high-priority ones. This could result in much longer waits than necessary for a tileset's appropriate level-of-detail to be shown.
  • Fixed a bug that prevented WebP and KTX2 textures from working in the common case where only the extension specified the source property, not the glTF's main Texture definition.

v0.22.1 - 2023-03-06

Fixes 🔧
  • Fixed a crash that could occur when a batch table property had fewer values than the model had features.

v0.22.0 - 2023-03-01

Breaking Changes 📣
  • Renamed CesiumGeometry::AxisTransforms to simply Transforms.
  • Renamed CesiumGeospatial::Transforms to GlobeTransforms.
Additions 🎉
  • Added GlobeAnchor, making it easy to define a coordinate system that anchors an object to the globe and maintains it as the object moves or as the local coordinate system it is defined in changes.
  • Added support for loading tilesets with pnts content. Point clouds are converted to glTFs with a single POINTS primitive, while batch tables are converted to EXT_feature_metadata.
  • Added createTranslationRotationScaleMatrix and computeTranslationRotationScaleFromMatrix methods to CesiumGeometry::Transforms.
  • Added CesiumUtility::AttributeCompression for encoding and decoding vertex attributes in different formats.
Fixes 🔧
  • Fixed a bug that could cause holes to appear in a tileset, even with frustum culling disabled, when the tileset includes some empty tiles with a geometric error greater than their parent's.

v0.21.3 - 2023-02-01

Fixes 🔧
  • Fixed a bug that could prevent loading in tilesets that are additively-refined and have external tilesets, such as Cesium OSM Buildings.
  • Fixed a bug that could cause parent tiles to be incorrectly culled in tilesets with additive ("ADD") refinement. This could cause geometry to disappear when moving in closer, or fail to appear at all.
  • When unloading tile content, raster overlay tiles are now detached from geometry tiles before the geometry tile content is unloaded.
  • Added missing #include <string> in generated glTF and 3D Tiles header files.
  • Replaced std::sprintf with std::snprintf, fixing a warning-as-error in newer versions of Xcode.
  • Upgraded tinyxml2 from commit 1aeb57d26bc303d5cfa1a9ff2a331df7ba278656 to commit e05956094c27117f989d22f25b75633123d72a83.

v0.21.2 - 2022-12-09

Additions 🎉
  • Added the ability to specify the endpoint URL of the Cesium ion API when constructing an IonRasterOverlay.
Fixes 🔧
  • Removed the logged warning about the use of the gltfUpAxis property in a 3D Tiles tileset.json. While not technically spec-compliant, this property is quite common and we are not going to remove support for it anytime soon.

v0.21.1 - 2022-12-02

Fixes 🔧
  • Fixed a bug that could cause an assertion failure - and on rare occasions a more serious problem - when creating a tile provider for a TileMapServiceRasterOverlay or a WebMapServiceRasterOverlay.

v0.21.0 - 2022-11-01

Breaking Changes 📣
  • On IPrepareRendererResources, the image parameter passed to prepareRasterInLoadThread and the rasterTile parameter passed to prepareRasterInMainThread are no longer const. These methods are now allowed to modify the parameters during load.
  • IPrepareRendererResources::prepareInLoadThread now takes a TileLoadResult and returns a Future<TileLoadResultAndRenderResources>, allowing it to work asynchronously rather than just blocking a worker thread until it is finished.
  • RasterOverlay::createTileProvider now takes the owner pointer as an IntrusivePointer instead of a raw pointer, and returns a future that resolves to a RasterOverlay::CreateTileProviderResult.
Additions 🎉
  • Added mainThreadLoadingTimeLimit and tileCacheUnloadTimeLimit properties to TilesetOptions, allowing a limit to be placed on how much time is spent loading and unloading tiles per frame.
  • Added GltfReader::generateMipMaps method.
  • Added the getImage method to RasterOverlayTile.
  • Added LocalHorizontalCoordinateSystem, which is used to create convenient right- or left-handeded coordinate systems with an origin at a point on the globe.
Fixes 🔧
  • Fixed a bug that could cause a crash when adding raster overlays to sparse tilesets and zooming close enough to cause them to be upsampled.

v0.20.0 - 2022-10-03

Breaking Changes 📣
  • TileRenderContent::lodTransitionPercentage now always goes from 0.0 --> 1.0 regardless of if the tile is fading in or out.
  • Added a new parameter to IPrepareRendererResources::prepareInLoadThread, rendererOptions, to allow passing arbitrary data from the renderer.
Fixes 🔧
  • In CesiumGltfWriter, accessor.byteOffset and bufferView.byteOffset are no longer written if the value is 0. This fixes validation errors for accessors that don't have buffer views, e.g. attributes that are Draco compressed.
  • Fixed a bug where failed tiles don't clean up any raster overlay tiles that are mapped to them, and therefore cannot be rendered as empty tiles.
  • Fixed a bug that prevented access to Cesium Ion assets by using expired Access Tokens.

v0.19.0 - 2022-09-01

Breaking Changes 📣
  • RasterOverlayCollection no longer accepts a Tileset in its constructor. Instead, it now accepts a Tile::LoadedLinkList and a TilesetExternals.
  • Removed TileContext. It has been replaced by the TilesetContentLoader interface.
  • Removed TileContentFactory. Instead, conversions of various types to glTF can be registered with GltfConverters.
  • Removed TileContentLoadInput. It has been replaced by TileLoadInput and TilesetContentLoader.
  • Removed TileContentLoadResult. It has been replaced by TileContent.
  • Removed TileContentLoader. It has been replaced by TilesetContentLoader and GltfConverters.
  • Removed ImplicitTraversal. It has been replaced by TilesetContentLoader and GltfConverters.
  • Removed many methods from the Cesium3DTilesSelection::Tileset class: getUrl(), getIonAssetID(), getIonAssetToken(), notifyTileStartLoading, notifyTileDoneLoading(), notifyTileUnloading(), loadTilesFromJson(), requestTileContent(), requestAvailabilitySubtree(), addContext(), and getGltfUpAxis(). Most of these were already not recommended for use outside of cesium-native.
  • Removed many methods from the Cesium3DTilesSelection::Tile class: getTileset(), getContext(), setContext(), getContent(), setEmptyContent(), getRendererResources(), setState(), loadContent(), processLoadedContent(), unloadContent(), update(), and markPermanentlyFailed(). Most of these were already not recommended for use outside of cesium-native.
Additions 🎉
  • Quantized-mesh terrain and implicit octree and quadtree tilesets can now skip levels-of-detail when traversing, so the correct detail is loaded more quickly.
  • Added new options to TilesetOptions supporting smooth transitions between tiles at different levels-of-detail. A tile's transition percentage can be retrieved from TileRenderContent::lodTransitionPercentage.
  • Added support for loading WebP images inside glTFs and raster overlays. WebP textures can be provided directly in a glTF texture or in the EXT_texture_webp extension.
  • Added support for KHR_texture_transform to CesiumGltf, CesiumGltfReader, and CesiumGltfWriter
  • Tileset can be constructed with a TilesetContentLoader and a root Tile for loading and rendering different 3D Tile-like formats or creating a procedural tileset.
Fixes 🔧
  • Fixed a bug where the Raster Overlay passed to the loadErrorCallback would not be the one that the user created, but instead an aggregated overlay that was created internally.

v0.18.1 - 2022-08-04

Fixes 🔧
  • Fixed a bug in SqliteCache where the last access time of resources was not updated correctly, sometimes causing more recently used resources to be evicted from the cache before less recently used ones.

v0.18.0 - 2022-08-01

Breaking Changes 📣
Additions 🎉
  • Added support for 3D Tiles 1.1 in TilesetWriter and TilesetReader.
  • Added a TileOcclusionRendererProxyPool to TilesetExternals. If a renderer implements and provides this interface, the tile occlusion information is used to avoid refining parent tiles that are completely occluded, reducing the number of tiles loaded.
  • Tileset can now estimate the percentage of the tiles for the current view that have been loaded by calling the computeLoadProgress method.
  • Enabled loading Tile Map Service (TMS) URLs that do not have a file named "tilemapresource.xml", such as from GeoServer.
  • Added support for Tile Map Service documents that use the "local" profile when the SRS is mercator or geodetic.

v0.17.0 - 2022-07-01

Fixes 🔧
  • Fixed crash when parsing an empty copyright string in the glTF model.

v0.16.0 - 2022-06-01

Additions 🎉
  • Added option to the RasterizedPolygonsOverlay to invert the selection, so everything outside the polygons gets rasterized instead of inside.
  • The RasterizedPolygonsTileExcluder excludes tiles outside the selection instead of inside when given an inverted RasterizedPolygonsOverlay.
  • Tiles are now upsampled using the projection of the first raster overlay in the list with more detail.
Fixes 🔧
  • For consistency with CesiumJS and compatibility with third-party terrain tilers widely used in the community, the bounds property of the layer.json file of a quantized-mesh terrain tileset is now ignored, and the terrain is assumed to cover the entire globe.

v0.15.2 - 2022-05-13

Fixes 🔧
  • Fixed a bug where upsampled quadtree tiles could have siblings with mismatching projections.

In addition to the above, this release updates the following third-party libraries used by cesium-native:

  • cpp-httplib to v0.10.3 (changes)
  • draco to v1.5.2 (changes)
  • earcut to v2.2.3 (changes)
  • PicoSHA2 to commit 1677374f23352716fc52183255a40c1b8e1d53eb (changes)
  • rapidjson to commit fcb23c2dbf561ec0798529be4f66394d3e4996d8 (changes)
  • spdlog to v1.10.0 (changes)
  • stb to commit af1a5bc352164740c1cc1354942b1c6b72eacb8a (changes)
  • uriparser to v0.9.6 (changes)

v0.15.1 - 2022-05-05

Fixes 🔧
  • Fixed a bug that could cause tiles in external tilesets to fail to load.

v0.15.0 - 2022-05-02

Additions 🎉
  • Improved the load performance when TilesetOptions::forbidHoles is enabled by only loading child tiles when their parent does not meet the necessary screen-space error requirement.
  • Added support for loading availability metadata from quantized-mesh layer.json. Previously, only availability embedded in terrain tiles was used.
  • Added support for quantized-mesh terrain tilesets that specify a parent layer.
  • Added support for metadata from the 3DTILES_batch_table_hierarchy extension.
Fixes 🔧
  • Fixed a bug that could cause the same tiles to be continually loaded and unloaded when TilesetOptions::forbidHoles was enabled.
  • Fixed a bug that could sometimes cause tilesets to fail to show their full detail when making changes to raster overlays.
  • Fixed a bug that could cause holes even with TilesetOptions::forbidHoles enabled, particularly when using external tilesets.
  • Tiles will no longer be selected to render when they have no content and they have a higher "geometric error" than their parent. In previous versions, this situation could briefly lead to holes while the children of such tiles loaded.
  • Fixed a bug where IPrepareRendererResources::prepareInMainThread was called on a Tile before that Tile was updated with loaded content.
  • Fixed a bug where getting bad data from the SQLite request cache could cause a crash. If the SQLite database is corrupt, it will now be deleted and recreated.

v0.14.1 - 2022-04-14

Fixes 🔧
  • Fixed a crash caused by using an aggregated overlay of IonRasterOverlay after it is freed.
  • Fix a bug introduced in v0.14.0 that caused Tile Map Service (TMS) overlays from Cesium ion to fail to load.

v0.14.0 - 2022-04-01

Breaking Changes 📣
  • Added a new parameter, rendererOptions, to IPrepareRendererResources::prepareRasterInLoadThread.
  • Changed the type of Cesium ion asset IDs from uint32_t to int64_t.
  • Various changes in the Cesium3DTiles, Cesium3DTilesReader, and Cesium3DTilesWriter namespaces to match the evolving 3D Tiles Next specifications.
  • Removed getTextureCoordinateIndex from FeatureIDTextureView and FeatureTexturePropertyView. Use getTextureCoordinateAttributeId instead.
Additions 🎉
  • Added WebMapServiceRasterOverlay to pull raster overlays from a WMS server.
  • Added support for the following glTF extensions to CesiumGltf, CesiumGltfReader, and CesiumGltfWriter:
    • EXT_instance_features
    • EXT_structural_metadata
    • MAXAR_mesh_variants
  • Added an in-memory cache for Cesium ion asset endpoint responses in order to avoid repeated requests.
  • Added ScopeGuard class to automatically a execute function when exiting a scope.
  • The glTF copyright property, if present, is now included in the credits that Tileset adds to the CreditSystem. If the copyright has multiple parts separate by semicolons, these are treated as separate credits.
  • Credits reported by CreditSystem::getCreditsToShowThisFrame are now sorted based on the number of occurrences, with the most common credits first.
  • Tileset and RasterOverlay credits can now be shown on the screen, rather than in a separate credit popup.
  • Added FeatureTexturePropertyView::getSwizzle method.
  • Added IsMetadataArray template to check if a type is a MetadataArrayView.
  • Added a rendererOptions property to RasterOverlayOptions to pass arbitrary data to prepareRasterInLoadThread.
  • Added Uri::escape.
Fixes 🔧
  • Fixed an issue that could lead to compilation failures when passing an lvalue reference to Promise::resolve().
  • Fixed upsampling for EXT_feature_metadata feature tables.
  • Fixed a bug that could cause the size of external images to be accounted for incorrectly when tracking the number of bytes loaded for caching purposes.
  • Fixed a bug that prevented tiles from loading when "Forbid Holes" option was enabled.

v0.13.0 - 2022-03-01

Breaking Changes 📣
  • Renamed constants in CesiumUtility::Math to use PascalCase instead of SCREAMING_SNAKE_CASE.
Additions 🎉
  • Added support for the CESIUM_RTC and KHR_texture_basisu glTF extensions.
  • Added support for 3D Tiles that do not have a geometric error, improving compatibility with tilesets that don't quite match the 3D Tiles spec.
  • Exposed the Cesium ion endpoint URL as a parameter on tilesets and raster overlays.
  • TilesetOptions and RasterOverlayOptions each have a new option to report which compressed textured formats are supported on the client platform. Ideal formats amongst the available ones are picked for each KTX2 texture that is later encountered.
  • The ImageCesium class nows convey which GPU pixel compression format (if any) is used. This informs what to expect in the image's pixel buffer.
  • The ImageCesium class can now contain pre-computed mipmaps, if they exist. In that case, all the mips will be in the pixel buffer and the delineation between each mip will be described in ImageCesium::mipPositions.
  • Tileset content with the known file extensions ".gltf", ".glb", and ".terrain" can now be loaded even if the Content-Type is incorrect. This is especially helpful for loading tilesets from file: URLs.
  • Created tighter fitting bounding volumes for terrain tiles by excluding skirt vertices.
Fixes 🔧
  • Fixed bug that could cause properties types in a B3DM Batch Table to be deduced incorrectly, leading to a crash when accessing property values.
  • Fixed a bug where implicit tiles were not receiving the root transform and so could sometimes end up in the wrong place.

v0.12.0 - 2022-02-01

Breaking Changes 📣
  • Renamed IAssetAccessor::requestAsset to get.
  • Renamed IAssetAccessor::post to request and added a new parameter in the second position to specify the HTTP verb to use.
  • Token in CesiumIonClient has been updated to match Cesium ion's v2 REST API endpoint, so several fields have been renamed. The tokens method also now returns future that resolves to a TokenList instead of a plain vector of Token instances.
  • Renamed GltfReader::readModel, ModelReaderResult, and ReadModelOptions to GltfReader::readGltf, GltfReaderResult, and GltfReaderOptions respectively.
  • Removed writeModelAsEmbeddedBytes, writeModelAndExternalFiles, WriteModelResult, WriteModelOptions, and WriteGLTFCallback. Use GltfWriter::writeGltf, GltfWriter::writeGlb, GltfWriterResult, and GltfWriterOptions instead.
Additions 🎉
  • Added TilesetWriterOptions for serializing tileset JSON.
  • Added support for the following extensions in GltfWriter and GltfReader:
  • Added support for the following extensions in TilesetWriter and TilesetReader:
  • Added SubtreeWriter and SubtreeReader for serializing and deserializing the subtree format in 3DTILES_implicit_tiling.
  • Added SchemaWriter and SchemaReader for serializing and deserializing schemas in EXT_mesh_features and 3DTILES_metadata.
  • Added hasExtension to ExtensibleObject.
  • Added CESIUM_TESTS_ENABLED option to the build system.
  • Added support in the JSON reader for reading doubles with no fractional value as integers.
  • Added case-insensitive comparison for Cesium 3D Tiles "refine" property values.
  • Added new capabilities to Connection in CesiumIonClient:
    • The tokens method now uses the v2 service endpoint and allows a number of options to be specified.
    • Added a token method to allow details of a single token to be retrieved.
    • Added nextPage and previousPage methods to allow paging through tokens.
    • Added modifyToken method.
    • Added static getIdFromToken method to obtain a token ID from a given token value.
  • Added loadErrorCallback to TilesetOptions and RasterOverlayOptions. This callback is invoked when the Tileset or RasterOverlay encounter a load error, allowing the error to be handled by application code.
  • Enable IntrusivePointer<T> to be converted to IntrusivePointer<U> if U is a base class of T.
Fixes 🔧
  • Fixes a bug where notifyTileDoneLoading was not called when encountering Ion responses that can't be parsed.
  • Fixed a bug that prevented a continuation attached to a SharedFuture from returning a Future itself.
  • Fixed incorrect child subtree index calculation in implicit tiles.
  • Fixed computeDistanceSquaredToPosition in BoundingSphere.

v0.11.0 - 2022-01-03

Breaking Changes 📣
  • The CesiumGltfReader project now uses the CesiumGltfReader namespace instead of the CesiumGltf namespace.
  • The CesiumGltfWriter project now uses the CesiumGltfWriter namespace instead of the CesiumGltf namespace.
  • The Cesium3DTilesReader project now uses the Cesium3DTilesReader namespace instead of the Cesium3DTiles namespace.
Additions 🎉
  • Added Cesium3DTilesWriter library.
Fixes 🔧
  • Fixed a bug in QuadtreeRasterOverlayTileProvider that caused incorrect level-of-detail selection for overlays that use a global (or otherwise large) tiling scheme but have non-global (or otherwise smaller) coverage.

v0.10.0 - 2021-12-01

Breaking Changes 📣
  • QuadtreeRasterOverlayTileProvider::computeLevelFromGeometricError has been removed. computeLevelFromTargetScreenPixels may be useful as a replacement.
  • The constructor of RasterOverlayTileProvider now requires a coverage rectangle.
  • RasterOverlayTileProvider::getTile now takes a targetScreenPixels instead of a targetGeometricError.
  • The constructor of RasterMappedTo3DTile now requires a texture coordinate index.
  • The constructor of RasterOverlayTile now takes a targetScreenPixels instead of a targetGeometricError. And the corresponding getTargetGeometricError has been removed.
  • Removed TileContentLoadResult::rasterOverlayProjections. This field is now found in the overlayDetails.
  • Removed obtainGlobeRectangle from TileUtilities.h. Use estimateGlobeRectangle in BoundingVolume.h instead.
  • cesium-native now uses the following options with the glm library:
    • GLM_FORCE_XYZW_ONLY
    • GLM_FORCE_EXPLICIT_CTOR
    • GLM_FORCE_SIZE_T_LENGTH
Additions 🎉
  • Added support for the 3DTILES_implicit_tiling extension.
  • Added support for the 3DTILES_bounding_volume_S2 extension.
  • Added support for raster overlays, including clipping polygons, on any 3D Tiles tileset.
  • Added support for external glTF buffers and images.
  • Raster overlay level-of detail is now selected using "target screen pixels" rather than the hard-to-interpret geometric error value.
  • A RasterOverlay can now be configured with a maximumScreenSpaceError independent of the screen-space error used for the geometry.
  • RasterOverlay::loadTileProvider now returns a SharedFuture, making it easy to attach a continuation to run when the load completes.
  • Added GltfContent::applyRtcCenter and applyGltfUpAxisTransform.
  • Clipping polygon edges now remain sharp even when zooming in past the available geometry detail.
  • Added DebugColorizeTilesRasterOverlay.
  • Added BoundingRegionBuilder to CesiumGeospatial.
  • Added GlobeRectangle::EMPTY static field and GlobeRectangle::isEmpty method.
  • Added the ability to set the coordinates of a GlobeRectangle after construction.
Fixes 🔧
  • Improved the computation of bounding regions and overlay texture coordinates from geometry, particularly for geometry that crosses the anti-meridian or touches the poles.
  • Fixed a bug that would result in incorrect geometry when upsampling a glTF with a position accessor pointing to a bufferView that did not start at the beginning of its buffer.
  • Fixed a problem that could cause incorrect distance computation for a degenerate bounding region that is a single point with a min/max height.
  • Improved the numerical stability of GlobeRectangle::computeCenter and GlobeRectangle::contains.
  • Error messages are no longer printed to the Output Log when an upsampled tile happens to have a primitive with no vertices.
  • Fixed a bug that could cause memory corruption when a decoded Draco mesh was larger than indicated by the corresponding glTF accessor.
  • Fixed a bug that could cause the wrong triangle indices to be used for a Draco-encoded glTF.

v0.9.0 - 2021-11-01

Breaking Changes 📣
  • Changed the following properties in CesiumGltf:
    • BufferView::target now defaults to std::nullopt instead of Target::ARRAY_BUFFER.
    • ClassProperty::type now defaults to Type::INT8 instead of empty string.
    • ClassProperty::componentType is now an optional string instead of a JsonValue.
    • FeatureTexture::classProperty is no longer optional, consistent with changes to the extension spec.
    • Image::mimeType now defaults to empty string instead of MimeType::image_jpeg.
    • Sampler::magFilter and Sampler::minFilter now default to std::nullopt instead of MagFilter::NEAREST.
  • The version of ExtensibleObject in the CesiumGltf library and namespace has been removed. Use the one in the CesiumUtility library and namespace instead.
  • Renamed the following glTF extension classes:
    • KHR_draco_mesh_compression -> ExtensionKhrDracoMeshCompression.
    • MeshPrimitiveEXT_feature_metadata -> ExtensionMeshPrimitiveExtFeatureMetadata
    • ModelEXT_feature_metadata -> ExtensionModelExtFeatureMetadata
  • CesiumGltf::ReaderContext has been removed. It has been replaced with either CesiumJsonReader::ExtensionReaderContext or GltfReader.
Additions 🎉
  • Added new Cesium3DTiles and Cesium3DTilesReader libraries. They are useful for reading and working with 3D Tiles tilesets.
Fixes 🔧
  • Fixed a bug that could cause crashes or incorrect behavior when using raster overlays.
  • Fixed a bug that caused 3D Tiles content to fail to load when the status code was zero. This code is used by libcurl for successful read of file:// URLs, so the bug prevented loading from such URLs in some environments.
  • Errors and warnings that occur while loading glTF textures are now include in the model load errors and warnings.
  • Fixes how generate-classes deals with reserved C++ keywords. Property names that are C++ keywords should be appended with "Property" as was already done, but when parsing JSONs the original property name string should be used.

v0.8.0 - 2021-10-01

Breaking Changes 📣
  • glTF enums are now represented in CesiumGltf as their underlying type (int32 or string) rather than as an enum class.
  • Tile content loaders now return a Future, which allows them to be asynchronous and make further network requests.
Fixes 🔧
  • Fixed a bug that caused the RTC_CENTER semantic in a B3DM feature table to be ignored if any of the values happened to be integers rather than floating-point numbers. This caused these tiles to render in the wrong location.

v0.7.2 - 2021-09-14

Fixes 🔧
  • Fixed a bug where the "forbidHoles" option was not working with raster overlays and external tilesets.

v0.7.1 - 2021-09-14

Fixes 🔧
  • Fixed a bug introduced in v0.7.0 where credits from a QuadtreeRasterOverlayTileProvider were not collected and reported.
  • Fixed a bug where disabling frustum culling caused external tilesets to not load.

v0.7.0 - 2021-09-01

Breaking Changes 📣
  • Renamed the Cesium3DTiles namespace and library to Cesium3DTilesSelection.
  • Deleted Cesium3DTilesSelection::Gltf and moved functionality into CesiumGltf::Model.
  • Renamed Rectangle::intersect and GlobeRectangle::intersect to computeIntersection.
  • RasterOverlay and derived classes now require a name parameter to their constructors.
  • Changed the type of texture coordinate IDs used in the raster overlay system from uint32_t to int32_t.
  • RasterOverlayTileProvider is no longer quadtree-oriented. Instead, it requires derived classes to provide an image for a particular requested rectangle and geometric error. Classes that previously derived from RasterOverlayTileProvider should now derive from QuadtreeRasterOverlayTileProvider and implement loadQuadtreeTileImage instead of loadTileImage.
  • Removed TilesetOptions::enableWaterMask, which didn't have any effect anyway. TilesetContentOptions::enableWaterMask still exists and works.
Additions 🎉
  • Added Future<T>::isReady.
  • Added Future<T>::share, which returns a SharedFuture<T> and allows multiple continuations to be attached.
  • Added an option in TilesetOptions::ContentOptions to generate smooth normals when the original glTFs were missing normals.
  • Added ImageManipulation class to CesiumGltfReader.
  • Added Math::roundUp and Math::roundDown.
  • Added Rectangle::computeUnion.
Fixes 🔧
  • Fixed a bug that caused CesiumGltfWriter to write a material's normal texture info into a property named normalTextureInfo rather than normalTexture.
  • Fixed a bug in TileMapServiceRasterOverlay that caused it to show only the lowest resolution tiles if missing a tilemapresource.xml file.

v0.6.0 - 2021-08-02

Breaking Changes 📣
  • Future<T>::wait now returns the resolved value and throws if the Future rejected, rather than returning a std::variant and slicing the exception to std::exception.
  • Tileset::updateView and Tileset::updateViewOffline now take std::vector<ViewState> instead of a single ViewState.
Additions 🎉
  • Added support for the EXT_feature_metadata glTF extension.
  • Added automatic conversion of the B3DM batch table to the EXT_feature_metadata extension.
  • Added CESIUM_COVERAGE_ENABLED option to the build system.
  • Added AsyncSystem::dispatchOneMainThreadTask to dispatch a single task, rather than all the tasks that are waiting.
  • Added AsyncSystem::createPromise to create a Promise directly, rather than via a callback as in AsyncSystem::createFuture.
  • Added AsyncSystem::catchImmediately to catch a Future rejection immediately in any thread.
  • Added AsyncSystem::all to create a Future that resolves when a list of Futures resolve.
  • Added support for multiple frustums in the Tileset selection algorithm.
Fixes 🔧
  • Fixed a bug that prevented .then functions from being used on a Future<void> when CESIUM_TRACING_ENABLED was ON.

v0.5.0 - 2021-07-01

Breaking Changes 📣
  • TilesetExternals now has an AsyncSystem instead of a shared pointer to an ITaskProcessor.
Additions 🎉
  • Added a performance tracing framework via CESIUM_TRACE_* macros.
  • Added Future<T>::thenImmediately.
  • Added AsyncSystem::createThreadPool and Future<T>::thenInThreadPool.
  • Future<T>::thenInWorkerThread and Future<T>::thenInMainThread now arrange for their continuations to be executed immediately when the Future is resolved, if the Future is resolved in the correct thread.
  • Moved all request cache database access to a dedicated thread, in order to free up worker threads for parallelizable work.

v0.4.0 - 2021-06-01

Additions 🎉
  • Added Cesium3DTiles::TileIdUtilities with a createTileIdString function to create logging/debugging strings for TileID objects.
  • Accessing the same Bing Maps layer multiple times in a single application run now reuses the same Bing Maps session instead of starting a new one each time.
  • Added a configure-time build option, PRIVATE_CESIUM_SQLITE, to rename all sqlite3* symbols to cesium_sqlite3*.
Fixes 🔧
  • Matched draco's decoded indices to gltf primitive if indices attribute does not match with the decompressed indices.
  • createAccessorView now creates an (invalid) AccessorView with a standard numeric type on error, rather than creating AccessorView<nullptr_t>. This makes it easier to use a simple lambda as the callback.
  • Disabled HTTPLIB_USE_ZLIB_IF_AVAILABLE and HTTPLIB_USE_OPENSSL_IF_AVAILABLE because these libraries are not required for our use for cpp-httplib and they cause problems on some systems.

v0.3.1 - 2021-05-13

Fixes 🔧
  • Fixed a memory leak when loading textures from a glTF model.
  • Fixed a use-after-free bug that could cause a crash when destroying a RasterOverlay.

v0.3.0 - 2021-05-03

Breaking Changes 📣
  • Converted magic_enum / CodeCoverage.cmake dependencies to external submodules.
  • Replaced CesiumGltf::WriteFlags bitmask with CesiumGltf::WriteModelOptions struct. CesiumGltf::writeModelAsEmbeddedBytes and CesiumGltf::writeModelAndExternalfiles now use this struct for configuration.
  • Removed all exceptions in WriterException.h, warnings / errors are now reported in WriteModelResult, which is returned from CesiumGltf::writeModelAsEmbeddedBytes and CesiumGltf::writeModelAndExternalFiles instead.
Additions 🎉
  • Added support for loading the water mask from quantized-mesh terrain tiles.
Fixes 🔧
  • Let a tile be renderable if all its raster overlays are ready, even if some are still loading.

v0.2.0 - 2021-04-19

Breaking Changes 📣
  • Moved JsonValue from the CesiumGltf library to the CesiumUtility library and changes some of its methods.
  • Renamed CesiumGltf::Reader to CesiumGltf::GltfReader.
  • Made the readModel and readImage methods on GltfReader instance methods instead of static methods.
Additions 🎉
  • Added CesiumGltfWriter library.
  • Added CesiumJsonReader library.
  • Added diagnostic details to error messages for invalid glTF inputs.
  • Added diagnostic details to error messages for failed OAuth2 authorization with CesiumIonClient::Connection.
  • Added an Axis enum and AxisTransforms class for coordinate system transforms
  • Added support for the legacy gltfUpVector string property in the asset part of tilesets. The up vector is read and passed as an Axis in the extras["gltfUpVector"] property, so that receivers may rotate the glTF model's up-vector to match the Z-up convention of 3D Tiles.
  • Unknown glTF extensions are now deserialized as a JsonValue. Previously, they were ignored.
  • Added the ability to register glTF extensions for deserialization using GltReader::registerExtension.
  • Added GltfReader::setExtensionState, which can be used to request that an extension not be deserialized or that it be deserialized as a JsonValue even though a statically-typed class is available for the extension.
Fixes 🔧
  • Gave glTFs created from quantized-mesh terrain tiles a more sensible material with a metallicFactor of 0.0 and a roughnessFactor of 1.0. Previously the default glTF material was used, which has a metallicFactor of 1.0, leading to an undesirable appearance.
  • Reported zero-length images as non-errors as BingMapsRasterOverlay purposely requests that the Bing servers return a zero-length image for non-existent tiles.
  • 3D Tiles geometric error is now scaled by the tile's transform.
  • Fixed a bug that that caused a 3D Tiles tile to fail to refine when any of its children had an unsupported type of content.

v0.1.0 - 2021-03-30

  • Initial release.