All Versions
119
Latest Version
Avg Release Cycle
23 days
Latest Release
213 days ago
Changelog History
Page 1
Changelog History
Page 1
-
v1.99 Changes
November 01, 2022Major Announcements :loudspeaker:
- ๐ฆ Starting with version 1.100, CesiumJS will be published alongside two smaller packages
@cesium/engine
and@cesium/widgets
#10824:- The source code will been paritioned into two folders:
packages/engine
andpackages/widgets
. - These workspaces packages will follow semantic versioning.
- These workspaces packages will be published as ES modules with TypeScript definitions.
- The combined CesiumJS release will continue to be published, however, the
Source
folder will only contain the following: Cesium.js
Cesium.d.ts
Assets
ThirdParty
Widgets
(CSS files only)- The ability to import modules and TypeScript definitions from individual files will been removed. Any imports should originate from the
cesium
module (import { Cartesian3 } from "cesium";
) or the combinedCesium.js
file (import { Cartesian3 } from "Source/Cesium.js";
);
- The source code will been paritioned into two folders:
โ Additions :tada:
- โ Added support for I3S 3D Object and IntegratedMesh Layers. #9634
Deprecated :hourglass_flowing_sand:
- ๐ The viewer parameter in
KmlTour.prototype.play
was deprecated in Cesium 1.99. It will be removed in 1.100. Instead of aViewer
, pass aCesiumWidget
instead. #10845
๐ Fixes :wrench:
- ๐ Fixed a bug where the scale of a
Model
was being incorrectly applied to its bounding sphere. #10855 - ๐ Fixed a bug where rendering a
Model
with image-based lighting while specular environment maps were unsupported caused a crash. #10859 - ๐ Fixed a bug where request render mode was broken when a ground primitive is added. #10756
- ๐ฆ Starting with version 1.100, CesiumJS will be published alongside two smaller packages
-
v1.98.1 Changes
October 03, 2022- ๐ This is an npm only release to fix the improperly published 1.98.
-
v1.98 Changes
October 03, 2022๐ฅ Breaking Changes :mega:
- ๐ As of the previous release (1.97),
new Model()
is an internal constructor and must not be used directly. UseModel.fromGltf()
instead. #10778
โ Additions :tada:
- Added support for the
WEB3D_quantized_attributes
extension found in some glTF 1.0 models. #10758
๐ Fixes :wrench:
- ๐ Fixed a bug where instanced models without normals would not render. #10765
- ๐ Fixed a regression where
i3dm
with scale and without rotation would render incorrectly. #10808 - ๐ Fixed a regression where instanced feature IDs were not processed correctly #10771
- ๐ Fixed a regression where
Cesium3DTileFeature.setProperty()
was not creating properties for unknown property IDs. #10775 - Fixed a regression where
pnts
tiles with3DTILES_draco_point_compression
and <= 8 quantization bits were being rendered incorrectly. #10794 - ๐ Fixed a regression where glTF models with unused nodes would crash #10813
- ๐ Fixed a regression where tilesets would not load in multiple
Viewer
s. #10828 - ๐ Fixed a bug where camera would not follow the
Viewer.trackedEntity
if it had a model with aHeightReference
other thanNONE
. #10805 - ๐ Fixed a bug where calling
removeAll
on aClippingPlaneCollection
attached to aModel
would cause a crash. #10827 - ๐ Fixed a bug where replacing a
Model
'sClippingPlaneCollection
with one of the same length would cause a crash. #10831 - ๐ Fixed a bug where KMLs with a NetworkLink with viewRefreshMode=='onRegion' would cause Cesium to make numerous resource requests and possibly trigger an out of memory error. #10790
- ๐ Fixed a bug where calling
Vector3DTileContent.getFeature
before a render update could result in no feature being returned. #10819
- ๐ As of the previous release (1.97),
-
v1.97 Changes
September 01, 2022Major Announcements :loudspeaker:
- CesiumJS has switched to a new architecture for loading glTF models and tilesets to enable:
- User-defined GLSL shaders via [
CustomShader
](Documentation/CustomShaderGuide/README.md) - Support for 3D Tiles Next metadata extensions:
EXT_structural_metadata
,EXT_mesh_features
andEXT_instance_features
- Support for
EXT_mesh_gpu_instancing
- Support for
EXT_meshopt_compression
- Texture caching across different tiles
- Numerous bug fixes
- User-defined GLSL shaders via [
- Usage notes for the new glTF architecture:
- Those using
ModelExperimental.fromGltf()
should now useModel.fromGltf()
. - The
enableModelExperimental
flag was removed, as tilesets and entities always use the new architecture. - The new implementation of
Model
uses the same public API as before, so no other changes are necessary.
- Those using
๐ฅ Breaking Changes :mega:
- ๐ฑ glTF 1.0 assets are no longer fully supported. glTF 1.0 techniques are converted to PBR materials where possible, but more complex techniques will no longer function correctly. If custom GLSL shaders are needed, use
CustomShader
instead. #10648 - The glTF 2.0 extension
KHR_techniques_webgl
andKHR_materials_common
are also no longer fully supported. Materials are converted to PBR materials where possible. - ๐ Support for rendering instanced models on the CPU has been removed.
- ๐
Model.gltf
,Model.basePath
,Model.pendingTextureLoads
(properties), andModel.dequantizeInShader
(constructor option) have been removed. - ๐
ModelMesh
andModelMaterial
have been removed. new Model()
is an internal constructor and must not be used directly. UseModel.fromGltf()
instead. #10778
โ Additions :tada:
- ๐ฑ
Model
can now classify other assets with a givenclassificationType
. #10623 - ๐
Model
now supports back face culling for point clouds. #10703 - ๐ง Export asset files such as CSS in
package.json
, allowing bundlers to import without additional configuration. #9212 - ๐ฆ The
sideEffects
field inpackage.json
is now specified, allowing more conservative bundlers like Webpack to enable tree shaking by default. #10714 - ๐ Model entities now support
CustomShader
. #10747
๐ Fixes :wrench:
- Fixed bug with
Viewer.flyTo
where camera could go underground when target is anEntity
withModelGraphics
withHeightReference.CLAMP_TO_GROUND
orHeightReference.RELATIVE_TO_GROUND
. #10631 - ๐ Fixed issues running CesiumJS under Node.js when using ES modules. #10684
- ๐ Fixed the incorrect lighting of instanced models. #10690
- ๐ Fixed developer error with
Camera.flyTo
with anorientation
and aRectangle
value fordestination
. #10704 - ๐ Fixed rendering bug with points in .vctr format, where points wouldn't show until picked or styled. #10707
- Fixed bounding volume calculations for glTF models with
KHR_mesh_quantization
and normalized positions. #10741
- CesiumJS has switched to a new architecture for loading glTF models and tilesets to enable:
-
v1.96 Changes
August 01, 2022Major Announcements :loudspeaker:
- โก๏ธ Built
Cesium.js
is no longer AMD format. This may or may not be a breaking change depending on how you use Cesium in your app. See our blog post for the full details. #10399- Built
Cesium.js
has gone from12.5MB
to8.4MB
unminified and from4.3MB
to3.6MB
minified.Cesium.js.map
has gone from22MB
to17.2MB
. - If you were ingesting individual ESM-style modules from the combined file
Build/Cesium/Cesium.js
orBuild/CesiumUnminified/Cesium.js
, instead useBuild/Cesium/index.js
orBuild/CesiumUnminified/index.js
respectively. - Using ESM from
Source
will require a bundler to resolve third party node dependencies. CESIUM_BASE_URL
should be set to eitherBuild/Cesium
orBuild/CesiumUnminified
.
- Built
๐ฅ Breaking Changes :mega:
Model.boundingSphere
now returns the bounding sphere in ECEF coordinates instead of the local coordinate system. #10589
โ Additions :tada:
- Models and tilesets that use the
CESIUM_primitive_outline
extension can now toggle outlines at runtime with theshowOutline
property. Furthermore, the color of the outlines can now be controlled by theoutlineColor
property. #10506 - โ Added optional
blurActiveElementOnCanvasFocus
option to set the behavior of blurring the active element when interacting with the canvas. #10518 - โ Added
ModelExperimental.getNode
to allow users to modify the transforms of model nodes at runtime. #10540 - โ Added support for point cloud styling for tilesets loaded with
ModelExperimental
. #10569 - ๐ Upgraded earcut from version 2.2.2 to version 2.2.4 which includes 10-15% better performance in triangulation. #10593
๐ Fixes :wrench:
- Fixed crash when loading glTF models with the
EXT_mesh_features
andEXT_structural_metadata
extensions withoutchannels
property. #10511 - ๐ Fixed a crash in the 3D Tiles Feature Styling sandcastle that occurred when using
ModelExperimental
. #10514 - ๐ Fixed improper handling of double-sided materials in
ModelExperimental
. #10507 - ๐ Fixed a bug where the alpha component of
model.color
would not update in the 3D Models Coloring sandcastle when usingModelExperimental
. #10519 - ๐ Fixed a bug where .cmpt files were not cached correctly in
ModelExperimental
. #10524 - ๐ Fixed a crash in the 3D Tiles Formats sandcastle when loading draco-compressed point clouds with
ModelExperimental
. #10521 - ๐ Fixed a bug where per-feature post-processing was not working with
ModelExperimental
. #10528 - ๐ Fixed error in
loadAndExecuteScript
and favorite icon lost in sandcaslte when CesiumJS was running in cross-origin isloated evironment.#10515 - ๐ Fixed a bug where
Viewer.zoomTo
would continuously throw errors if aCesium3DTileset
failed to load.#10523 - ๐ Fixed a bug where styles would not apply to tilesets if they were applied while the tileset was hidden. #10582
- ๐ Fixed a bug where
.i3dm
models with quantized positions were not being correctly loaded byModelExperimental
. #10598 - ๐ Fixed a bug where dynamic geometry was not marked as
ready
. #10517
Deprecated :hourglass_flowing_sand:
- โก๏ธ Built
-
v1.95 Changes
July 01, 2022๐ฅ Breaking Changes :mega:
- Tilesets rendered with
ModelExperimental
must setprojectTo2D
to true in order to be accurately projected and rendered in 2D / CV mode. #10440
โ Additions :tada:
- ๐ Memory statistics for
ModelExperimental
now appear in theCesium3DTilesInspector
. This includes binary metadata memory, which is not counted byModel
. #10397 - Memory statistics for
ResourceCache
(used byModelExperimental
) now appear in theCesium3DTilesInspector
. #10413 - โ Added support for rendering individual models in 2D / CV using
ModelExperimental
. #10419 - โ Added support for rendering instanced tilesets in 2D / CV using
ModelExperimental
. #10433 - โ Added
modelUpAxis
andmodelForwardAxis
constructor options toCesium3DTileset
#10439 - โ Added
heightReference
toModelExperimental
. #10448 - โ Added
silhouetteSize
andsilhouetteColor
toModelExperimental
. #10457 - โ Added support for mipmapped textures in
ModelExperimental
. #10231 - โ Added
distanceDisplayCondition
toModelExperimental
. #10481 - โ Added support for
AGI_articulations
toModelExperimental
. #10479 - โ Added
credit
toModelExperimental
. #10489 - โ Added
asynchronous
toModelExperimental.fromGltf
. #10490 - โ Added
id
toModelExperimental
. #10491 ExperimentalFeatures.enableModelExperimental
now enablesModelExperimental
for entities and CZML in addition to 3D Tiles. #10492
๐ Fixes :wrench:
- ๐ Fixed
FeatureDetection
for Microsoft Edge. #10429 - ๐ Fixed broken links in documentation of
CesiumTerrainProvider
. #7478 - Warn if
Cesium3DTile
content.uri property is empty, and load empty tile. #7263 - ๐ Updated text highlighting for code examples in documentation. #10051
- โก๏ธ Updated ModelExperimental shader defaults to match glTF spec. #9992
- ๐ Fixed shadow rendering artifacts that appeared in
ModelExperimental
. #10501
Deprecated :hourglass_flowing_sand:
- ๐ The
.getPropertyNames
methods ofCesium3DTileFeature
,Cesium3DTilePointFeature
, andModelFeature
have been deprecated and will be removed in 1.98. Use the.getPropertyIds
methods instead.
- Tilesets rendered with
-
v1.94.3 Changes
June 10, 2022- ๐ Fixed a crash with vector tilesets with lines when clamping to terrain or 3D tiles. #10447
-
v1.94.2 Changes
June 03, 2022- ๐ This is an npm only release to fix the improperly published 1.94.1.
-
v1.94.1 Changes
June 03, 2022 -
v1.94 Changes
June 01, 2022๐ฅ Breaking Changes :mega:
- โ Removed individual image-based lighting parameters from
Model
andCesium3DTileset
. #10388 - Models and tilesets rendered with
ModelExperimental
must setenableDebugWireframe
to true in order fordebugWireframe
to work in WebGL1. #10344 - โ Removed
ImagerySplitPosition
andScene.imagerySplitPosition
. UseSplitDirection
andScene.splitPosition
instead.#10418 - โ Removed restriction on enabling
Scene.orderIndependentTranslucency
on iPad and iOS. #10417
โ Additions :tada:
- โ Added
Cesium3DTileStyle.fromUrl
for loading a style from a url. #10348 - โ Added
IndexDatatype.fromTypedArray
. #10350 - โ Added
ModelAnimationCollection.animateWhilePaused
andModelAnimation.animationTime
to allow explicit control over a model's animations. #9339 - Replaced
options.gltf
withoptions.url
inModelExperimental.fromGltf
. #10371 - โ Added support for 2D / CV mode for non-instanced tilesets rendered with
ModelExperimental
. #10384 - โ Added
PolygonGraphics.textureCoordinates
,PolygonGeometry.textureCoordinates
,CoplanarPolygonGeometry.textureCoordinates
, which override the defaultstRotation
-based texture coordinate calculation behaviour with the provided texture coordinates, specified in the form of aPolygonHierarchy
ofCartesian2
points. #10109
๐ Fixes :wrench:
- ๐ Fixed the rendering issues related to order-independent translucency on iOS devices. #10417
- ๐ Fixed the inaccurate computation of bounding spheres for models not centered at (0,0,0) in their local space. #10395
- ๐ Fixed the inaccurate computation of bounding spheres for
ModelExperimental
. #10339 - ๐ Fixed error when destroying a 3D tileset before it has finished loading. [#10363](Fixes https://github.com/CesiumGS/cesium/issues/10363)
- ๐ Fixed race condition which can occur when updating
Cesium3DTileStyle
before itsreadyPromise
has resolved. #10345 - ๐ Fixed label background rendering. #10342
- ๐ Enabled support for loading web assembly modules in Edge. #6541
- ๐ Fixed crash for zero-area
region
bounding volumes in a 3D Tileset. #10351 - ๐ Fixed
Cesium3DTileset.debugShowUrl
so that it works for implicit tiles too. #10372 - ๐ Fixed crash when loading a tileset without a metadata schema but has external tilesets with tile or content metadata. #10387
- ๐ Fixed winding order for negatively scaled models in
ModelExperimental
. #10405 - ๐ Fixed error when calling
sampleTerrain
over a large area that required lots of tile requests. #10425
Deprecated :hourglass_flowing_sand:
- ๐
Cesium3DTileStyle
constructor parameters ofstring
orResource
type have been deprecated and will be removed in CesiumJS 1.96. If loading a style from a url, useCesium3DTileStyle.fromUrl
instead. #10348 - ๐
Cesium3DTileStyle.readyPromise
andCesium3DTileStyle.ready
have been deprecated and will be removed in CesiumJS 1.96. If loading a style from a url, useCesium3DTileStyle.fromUrl
instead. #10348 - ๐
Model.gltf
,Model.basePath
,Model.pendingTextureLoads
(properties), andModel.dequantizeInShader
(constructor option) have been deprecated and will be removed in CesiumJS 1.97. #10415 - ๐ Support for glTF 1.0 assets has been deprecated and will be removed in CesiumJS 1.97. Please convert any glTF 1.0 assets to glTF 2.0. #10414
- Support for the glTF extension
KHR_techniques_webgl
has been deprecated and will be removed in CesiumJS 1.97. If custom GLSL shaders are needed, useCustomShader
instead. #10414 Model.boundingSphere
currently returns results in the model's local coordinate system, but in CesiumJS 1.96 it will be changed to return results in ECEF coordinates. #10415
- โ Removed individual image-based lighting parameters from