cesium-native/CHANGES.md

254 lines
15 KiB
Markdown
Raw Normal View History

# Change Log
2022-01-18 23:24:34 +08:00
### v0.12.0 - ????
##### Fixes :wrench:
- Fixes a bug where `notifyTileDoneLoading` is not called when encountering Ion responses that can't be parsed.
2022-01-19 17:01:10 +08:00
2021-12-04 00:43:44 +08:00
### v0.11.0 - 2022-01-03
##### Breaking Changes :mega:
- 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.
2021-12-17 13:22:55 +08:00
##### Additions :tada:
- Added `Cesium3DTilesWriter` library.
##### Fixes :wrench:
- 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.
2021-12-01 11:06:42 +08:00
### v0.10.0 - 2021-12-01
2021-11-02 17:37:12 +08:00
##### Breaking Changes :mega:
- `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`.
2021-12-01 11:06:42 +08:00
- Removed `obtainGlobeRectangle` from `TileUtilities.h`. Use `estimateGlobeRectangle` in `BoundingVolume.h` instead.
2021-12-01 11:10:29 +08:00
- cesium-native now uses the following options with the `glm` library:
- `GLM_FORCE_XYZW_ONLY`
- `GLM_FORCE_EXPLICIT_CTOR`
- `GLM_FORCE_SIZE_T_LENGTH`
2021-11-02 17:37:12 +08:00
##### Additions :tada:
2021-12-01 11:06:42 +08:00
- Added support for the [3DTILES_implicit_tiling](https://github.com/CesiumGS/3d-tiles/tree/main/extensions/3DTILES_implicit_tiling) extension.
2021-11-05 13:59:44 +08:00
- Added support for the [3DTILES_bounding_volume_S2](https://github.com/CesiumGS/3d-tiles/tree/main/extensions/3DTILES_bounding_volume_S2) extension.
2021-11-02 17:37:12 +08:00
- Added support for raster overlays, including clipping polygons, on any 3D Tiles tileset.
2021-12-01 11:06:42 +08:00
- Added support for external glTF buffers and images.
2021-11-02 17:37:12 +08:00
- 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.
2021-11-16 13:05:47 +08:00
- Added `DebugColorizeTilesRasterOverlay`.
2021-11-23 13:54:53 +08:00
- 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 :wrench:
- 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.
2021-11-22 05:50:15 +08:00
- Fixed a bug that could cause memory corruption when a decoded Draco mesh was larger than indicated by the corresponding glTF accessor.
2021-11-24 17:54:00 +08:00
- Fixed a bug that could cause the wrong triangle indices to be used for a Draco-encoded glTF.
2021-11-02 17:37:12 +08:00
2021-11-01 11:51:21 +08:00
### v0.9.0 - 2021-11-01
2021-10-06 08:55:51 +08:00
2021-11-01 08:54:51 +08:00
##### Breaking Changes :mega:
- 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 :tada:
- Added new `Cesium3DTiles` and `Cesium3DTilesReader` libraries. They are useful for reading and working with 3D Tiles tilesets.
2021-10-06 08:55:51 +08:00
##### Fixes :wrench:
- Fixed a bug that could cause crashes or incorrect behavior when using raster overlays.
2021-11-01 08:54:51 +08:00
- 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.
2021-10-30 06:02:07 +08:00
- Fixes how `generate-classes` deals with reserved C++ keywords. Property names that are C++ keywords should be appended with "Property" as was already done,
2021-11-01 08:54:51 +08:00
but when parsing JSONs the original property name string should be used.
2021-10-06 08:55:51 +08:00
2021-10-01 23:23:07 +08:00
### v0.8.0 - 2021-10-01
2021-09-02 22:54:24 +08:00
2021-10-01 23:23:07 +08:00
##### Breaking Changes :mega:
2021-09-24 15:10:45 +08:00
2021-10-01 23:23:07 +08:00
- 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.
2021-09-24 15:10:45 +08:00
##### Fixes :wrench:
- 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.
2021-09-24 15:10:45 +08:00
### v0.7.2 - 2021-09-14
2021-09-09 20:31:18 +08:00
2021-09-02 22:54:24 +08:00
##### Fixes :wrench:
2021-09-14 18:39:16 +08:00
- Fixed a bug where the "forbidHoles" option was not working with raster overlays and external tilesets.
2021-09-14 14:00:48 +08:00
### v0.7.1 - 2021-09-14
2021-09-02 22:54:24 +08:00
##### Fixes :wrench:
2021-09-14 14:00:48 +08:00
- 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.
2021-09-02 22:54:24 +08:00
2021-09-01 14:41:31 +08:00
### v0.7.0 - 2021-09-01
2021-07-06 20:17:26 +08:00
##### Breaking Changes :mega:
2021-09-01 14:41:31 +08:00
- 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`.
2021-08-24 16:33:17 +08:00
- `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`.
2021-08-26 11:52:49 +08:00
- `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`.
2021-08-24 16:33:17 +08:00
- Removed `TilesetOptions::enableWaterMask`, which didn't have any effect anyway. `TilesetContentOptions::enableWaterMask` still exists and works.
##### Additions :tada:
2021-08-23 17:44:36 +08:00
- Added `Future<T>::isReady`.
- Added `Future<T>::share`, which returns a `SharedFuture<T>` and allows multiple continuations to be attached.
2021-08-18 22:53:41 +08:00
- Added an option in `TilesetOptions::ContentOptions` to generate smooth normals when the original glTFs were missing normals.
2021-08-23 20:26:37 +08:00
- Added `ImageManipulation` class to `CesiumGltfReader`.
2021-08-23 18:52:40 +08:00
- Added `Math::roundUp` and `Math::roundDown`.
- Added `Rectangle::computeUnion`.
2021-08-24 09:51:21 +08:00
##### Fixes :wrench:
- Fixed a bug that caused CesiumGltfWriter to write a material's normal texture info into a property named `normalTextureInfo` rather than `normalTexture`.
2021-08-26 12:51:35 +08:00
- Fixed a bug in `TileMapServiceRasterOverlay` that caused it to show only the lowest resolution tiles if missing a `tilemapresource.xml` file.
2021-08-24 09:51:21 +08:00
2021-08-02 22:46:01 +08:00
### v0.6.0 - 2021-08-02
2021-06-22 15:19:33 +08:00
##### Breaking Changes :mega:
- `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`.
2021-07-06 20:17:26 +08:00
##### Additions :tada:
2021-07-24 22:15:00 +08:00
- 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.
2021-07-07 12:14:25 +08:00
- Added `AsyncSystem::createPromise` to create a Promise directly, rather than via a callback as in `AsyncSystem::createFuture`.
2021-07-15 16:02:00 +08:00
- 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.
2021-07-06 20:17:26 +08:00
##### Fixes :wrench:
- Fixed a bug that prevented `.then` functions from being used on a `Future<void>` when CESIUM_TRACING_ENABLED was ON.
2021-07-01 13:59:22 +08:00
### v0.5.0 - 2021-07-01
2021-06-22 15:19:33 +08:00
##### Breaking Changes :mega:
- `TilesetExternals` now has an `AsyncSystem` instead of a shared pointer to an `ITaskProcessor`.
2021-06-22 15:19:33 +08:00
##### Additions :tada:
- 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.
2021-06-22 15:19:33 +08:00
### v0.4.0 - 2021-06-01
##### Additions :tada:
- 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.
2021-05-31 19:39:47 +08:00
- Added a configure-time build option, `PRIVATE_CESIUM_SQLITE`, to rename all `sqlite3*` symbols to `cesium_sqlite3*`.
##### Fixes :wrench:
- 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.
2021-05-31 19:42:34 +08:00
- 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.
2021-05-13 15:39:18 +08:00
### v0.3.1 - 2021-05-13
##### Fixes :wrench:
- 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`.
2021-05-13 03:38:17 +08:00
2021-05-03 14:11:32 +08:00
### v0.3.0 - 2021-05-03
2021-04-21 03:11:08 +08:00
##### Breaking Changes :mega:
2021-04-22 08:32:09 +08:00
- 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.
2021-04-22 08:32:09 +08:00
2021-04-21 03:11:08 +08:00
##### Additions :tada:
2021-05-03 14:53:29 +08:00
- Added support for loading the water mask from quantized-mesh terrain tiles.
2021-05-05 19:28:58 +08:00
2021-04-21 03:11:08 +08:00
##### Fixes :wrench:
2021-04-22 08:32:09 +08:00
- Let a tile be renderable if all its raster overlays are ready, even if some are still loading.
2021-04-21 03:11:08 +08:00
2021-04-20 06:18:54 +08:00
### v0.2.0 - 2021-04-19
##### Breaking Changes :mega:
- 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 :tada:
2021-04-19 12:35:54 +08:00
- Added `CesiumGltfWriter` library.
- Added `CesiumJsonReader` library.
- Added diagnostic details to error messages for invalid glTF inputs.
2021-04-20 06:18:20 +08:00
- Added diagnostic details to error messages for failed OAuth2 authorization with `CesiumIonClient::Connection`.
2021-04-12 23:47:41 +08:00
- 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 :wrench:
- 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.
2021-04-15 14:24:21 +08:00
- 3D Tiles geometric error is now scaled by the tile's transform.
2021-04-19 13:49:26 +08:00
- 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.