Cesium for Unity v1.2.0

Cesium for Unity works on Windows (x86-64), macOS (x86-64 and Apple Silicon), Android (ARM64 and x86-64), and iOS.

🚀 Get Started

1. Download Cesium for Unity Samples.
2. Extract the .zip file into a suitable location on your computer.
3. If you have Unity Hub installed, click the "Open" button under the "Projects" tab. Otherwise, open the Unity Editor directly and select "Open Project". Then, point it to the extracted directory. Unity will load the project and also download Cesium for Unity using the Package Manager.
4. In the Asset Browser, select and load Assets -> Scenes -> 01_CesiumWorld. You can also select other scenes as you browse and explore the samples.

Or, to learn how to add it to your own project, see the Cesium for Unity Quickstart.

Have questions? Ask them on the community forum.

🕙 Change Log

Additions 🎉

• Added a scale property to CesiumGeoreference. This allows the entire globe to be scaled up or down with better precision than the scale property on the georeference's Transform.

Fixes 🔧

• Fixed a bug that caused tiles to be displaced when changing the transform of a CesiumGeoreference at runtime.
• Fixed a bug that caused primitive numbers to be negative in the names of tile game objects when the tile mesh had multiple primitives.

Cesium for Unity v1.1.0

Cesium for Unity works on Windows (x86-64), macOS (x86-64 and Apple Silicon), Android (ARM64 and x86-64), and iOS.

🚀 Get Started

1. Download Cesium for Unity Samples.
2. Extract the .zip file into a suitable location on your computer.
3. If you have Unity Hub installed, click the "Open" button under the "Projects" tab. Otherwise, open the Unity Editor directly and select "Open Project". Then, point it to the extracted directory. Unity will load the project and also download Cesium for Unity using the Package Manager.
4. In the Asset Browser, select and load Assets -> Scenes -> 01_CesiumWorld. You can also select other scenes as you browse and explore the samples.

Or, to learn how to add it to your own project, see the Cesium for Unity Quickstart.

Have questions? Ask them on the community forum.

🕙 Change Log

Breaking Changes 📣

• CesiumObjectPool is no longer accessible from outside the CesiumRuntime assembly.

Additions 🎉

• Added support for primitives with the TRIANGLE_STRIP and TRIANGLE_FAN topology types.
• Missing normals are now generated as "flat" normals by default, as required by the glTF specification. An option on Cesium3DTileset allows the user to request smooth normals instead, which will improve performance for most meshes by reducing geometry duplication.
• Moved mipmap generation from the main thread to a worker thread.

Fixes 🔧

• Added dependencies on the ShaderGraph and InputSystem packages to resolve material / script compilation errors.
• Fixed another bug where CesiumCameraController tried to access a non-existent input in the legacy input system.
• Removed an extra "delimiter" added to the end of on-screen credits in some cases.
• Fixed a memory leak of Mesh objects when entering and exiting Play mode in the Unity Editor.
• Fixed a crash that happened when attempting to create physics meshes for degenerate triangle meshes.

In addition to the above, this release updates cesium-native from v0.23.0 to v0.24.0. See the changelog for a complete list of changes in cesium-native.

Cesium for Unity v1.0.0

Cesium for Unity works on Windows (x86-64), macOS (x86-64 and Apple Silicon), Android (ARM64 and x86-64), and iOS.

🚀 Get Started

1. Download Cesium for Unity Samples.
2. Extract the .zip file into a suitable location on your computer.
3. If you have Unity Hub installed, click the "Open" button under the "Projects" tab. Otherwise, open the Unity Editor directly and select "Open Project". Then, point it to the extracted directory. Unity will load the project and also download Cesium for Unity using the Package Manager.
4. In the Asset Browser, select and load Assets -> Scenes -> 01_CesiumWorld. You can also select other scenes as you browse and explore the samples.

Or, to learn how to add it to your own project, see the Cesium for Unity Quickstart.

Have questions? Ask them on the community forum.

🕙 Change Log

Additions 🎉

• Added support for Unity's built-in render pipeline.
• Added CesiumPointCloudShading, which allows point cloud tilesets to be rendered with attenuation based on geometric error. Attenuation is currently only supported in the Universal Render Pipeline (URP).
• GameObject instances created for the tiles in a Cesium3DTileset now inherit the layer of the parent tileset.
• Added the CesiumTileExcluder abstract class. By creating a class derived from CesiumTileExcluder, then adding it to a Cesium3DTileset's game object, you can implement custom rules for excluding tiles in the Cesium3DTileset from loading and rendering.
• Added setting in CesiumRuntimeSettings to configure the maximum number of responses to keep in the request cache.
• Added setting in CesiumRuntimeSettings to configure the number of reads from the cache database before each prune.

Fixes 🔧

• Fixed a bug that prevented the use of pre-existing mipmaps, such as those loaded from KTX2.
• Fixed a bug where CesiumCameraController tried to access non-existent inputs in the legacy input system.
• Fixed a bug that could cause a crash when using the search box with a dataset already selected in the Cesium ion Assets window.
• Fixed a bug that prevented sorting the contents of the Cesium ion Assets window in descending order.

In addition to the above, this release updates cesium-native from v0.22.1 to v0.23.0. See the changelog for a complete list of changes in cesium-native.

Cesium for Unity v0.3.1

Cesium for Unity works on Windows (x86-64), macOS (x86-64 and Apple Silicon), Android (ARM64 and x86-64), and iOS.

🚀 Get Started

1. Download Cesium for Unity Samples.
2. Extract the .zip file into a suitable location on your computer.
3. If you have Unity Hub installed, click the "Open" button under the "Projects" tab. Otherwise, open the Unity Editor directly and select "Open Project". Then, point it to the extracted directory. Unity will load the project and also download Cesium for Unity using the Package Manager.
4. In the Asset Browser, select and load Assets -> Scenes -> 01_CesiumWorld. You can also select other scenes as you browse and explore the samples.

Or, to learn how to add it to your own project, see the Cesium for Unity Quickstart.

Have questions? Ask them on the community forum.

🕙 Change Log

Fixes 🔧

• Fixed a bug introduced in v0.3.0 that caused an exception when attempting load Cesium3DTilesets from a local file.

In addition to the above, this release updates cesium-native from v0.22.0 to v0.22.1. See the changelog for a complete list of changes in cesium-native.

Cesium for Unity v0.3.0

Cesium for Unity works on Windows (x86-64), macOS (x86-64 and Apple Silicon), Android (ARM64 and x86-64), and iOS.

🚀 Get Started

1. Download Cesium for Unity Samples.
2. Extract the .zip file into a suitable location on your computer.
3. If you have Unity Hub installed, click the "Open" button under the "Projects" tab. Otherwise, open the Unity Editor directly and select "Open Project". Then, point it to the extracted directory. Unity will load the project and also download Cesium for Unity using the Package Manager.
4. In the Asset Browser, select and load Assets -> Scenes -> 01_CesiumWorld. You can also select other scenes as you browse and explore the samples.

Or, to learn how to add it to your own project, see the Cesium for Unity Quickstart.

Have questions? Ask them on the community forum.

🕙 Change Log

Breaking Changes 📣

• Removed the positionAuthority, unityX, unityY, and unityZ properties from CesiumGlobeAnchor. Also removed the SetPositionUnity method.
• Removed the CesiumGlobeAnchorPositionAuthority enum. The authoritative position is now always found in the positionGlobeFixed property. The object's Unity world position can be obtained from its Transform.
• Marked the longitude, latitude, and height properties on CesiumGlobeAnchor as obsolete. Use the longitudeLatitudeHeight property instead.
• Marked the ecefX, ecefY, and ecefZ properties on CesiumGlobeAnchor as obsolete. Use the positionGlobeFixed property instead.
• Marked SetPositionLongitudeLatitudeHeight and SetPositionEarthCenteredEarthFixed methods on CesiumGlobeAnchor as obsolete. Set the longitudeLatitudeHeight or positionGlobeFixed property instead.
• Replaced MetadataProperty with CesiumFeature. Metadata features are now separated based on feature tables where properties are accessed by name.
• Replaced CesiumMetadata.GetProperties with CesiumMetadata.GetFeatures, which returns an array of CesiumFeatures.

Additions 🎉

• Added support for rendering point clouds (pnts).
• CesiumGlobeAnchor now stores a precise, globe-relative orientation and scale in addition to position.
• Added localToGlobeFixedMatrix, longitudeLatitudeHeight, positionGlobeFixed, rotationGlobeFixed, rotationEastUpNorth, scaleGlobeFixed, and scaleEastUpNorth properties to CesiumGlobeAnchor.
• Added the Restart method to CesiumGlobeAnchor, which can be use to reinitialize the component from its serialized values.
• Moved the Cesium tileset shaders from the Shader Graphs shader category to the new Cesium shader category.
• Added CesiumDebugColorizeTilesRasterOverlay to visualize how a tileset is divided into tiles.

Fixes 🔧

• Fixed a bug that prevented caching of 3D Tiles and overlay requests.
• Fixed a bug that could cause the Cesium ion Token Troubleshooting panel to crash the Unity Editor.
• Added a workaround for a crash in the Burst Compiler (bcl.exe) in Unity 2022.2 when using il2cpp.
• Fixed a bug that could cause incorrect metadata to be associated with a feature, especially in Draco-encoded tiles.

In addition to the above, this release updates cesium-native from v0.21.3 to v0.22.0. See the changelog for a complete list of changes in cesium-native.

Cesium for Unity v0.2.0

Cesium for Unity works on Windows (x86-64), macOS (x86-64 and Apple Silicon), Android (ARM64 and x86-64), and iOS.

🚀 Get Started

1. Download Cesium for Unity Samples.
2. Extract the .zip file into a suitable location on your computer.
3. If you have Unity Hub installed, click the "Open" button under the "Projects" tab. Otherwise, open the Unity Editor directly and select "Open Project". Then, point it to the extracted directory. Unity will load the project and also download Cesium for Unity using the Package Manager.
4. In the Asset Browser, select and load Assets -> Scenes -> 01_CesiumWorld. You can also select other scenes as you browse and explore the samples.

Or, to learn how to add it to your own project, see the Cesium for Unity Quickstart.

Have questions? Ask them on the community forum.

🕙 Change Log

Breaking Changes 📣

• Renamed CesiumTransforms to CesiumWgs84Ellipsoid.

Additions 🎉

• Added CesiumCameraController, a globe-aware controller that adapts its speed and clipping planes based on its height from the globe.
• Added CesiumFlyToController, a controller that can smoothly fly to locations across the globe.
• Added an option to add a DynamicCamera from the Cesium panel to the scene. The DynamicCamera contains CesiumCameraController and CesiumFlyToController components and offers easy navigation of the globe.
• Added support for building to iOS.
• Added support for building to Android x86-64 devices like the Magic Leap 2.

Fixes 🔧

• Fixed a bug where CesiumGeoreference, CesiumGlobeAnchor, and CesiumSubScene would not properly update when their values were changed by undos or pasted values.
• CesiumRuntimeSettings is now stored in Assets/CesiumSettings/Resources instead of Assets/Settings/Resources.
• Added an explicit Physics.SyncTransforms when CesiumOriginShift activates or deactivates sub-scenes, avoiding a brief period of potentially very incorrect collisions.

In addition to the above, this release updates cesium-native from v0.21.1 to v0.21.3. See the changelog for a complete list of changes in cesium-native.

Cesium for Unity v0.1.2

🚀 Get Started

1. Download Cesium for Unity Samples.
2. Extract the .zip file into a suitable location on your computer.
3. If you have Unity Hub installed, click the "Open" button under the "Projects" tab. Otherwise, open the Unity Editor directly and select "Open Project". Then, point it to the extracted directory. Unity will load the project and also download Cesium for Unity using the Package Manager.
4. In the Asset Browser, select and load Assets -> Scenes -> 01_CesiumWorld. You can also select other scenes as you browse and explore the samples.

To add Cesium to Unity to a new or existing project instead, see the Quickstart.

Have questions? Ask them on the community forum.

🕙 Change Log

Fixes 🔧

• Fixed a bug that caused Cesium for Unity to fail to compile in Unity 2022.2 and potentially in other scenarios.
• Fixed a bug that led to an exception when the project name included characters outside the printable ASCII range.

Cesium for Unity v0.1.1

🚀 Get Started

1. Download Cesium for Unity Samples.
2. Extract the .zip file into a suitable location on your computer.
3. If you have Unity Hub installed, click the "Open" button under the "Projects" tab. Otherwise, open the Unity Editor directly and select "Open Project". Then, point it to the extracted directory. Unity will load the project and also download Cesium for Unity using the Package Manager.
4. In the Asset Browser, select and load Assets -> Scenes -> 01_CesiumWorld. You can also select other scenes as you browse and explore the samples.

Have questions? Ask them on the community forum.

🕙 Change Log

Fixes 🔧

• Fixed a bug that caused raster overlay tiles to be missing or mixed up, especially when zooming in close and then back out.

Cesium for Unity v0.1.0

This is the initial public release of Cesium for Unity!

🚀 Get Started

1. Download Cesium for Unity Samples.
2. Extract the .zip file into a suitable location on your computer.
3. If you have Unity Hub installed, click the "Open" button under the "Projects" tab. Otherwise, open the Unity Editor directly and select "Open Project". Then, point it to the extracted directory. Unity will load the project and also download Cesium for Unity using the Package Manager.
4. In the Asset Browser, select and load Assets -> Scenes -> 01_CesiumWorld. You can also select other scenes as you browse and explore the samples.

Have questions? Ask them on the community forum.