Releases: CesiumGS/cesium-unreal
Cesium for Unreal v2.0.0
This release includes support for Unreal Engine v5.1, v5.2, and v5.3 for Windows, Linux, macOS, Android, and iOS. Please select the appropriate ZIP for your version.
Breaking Changes 📣
- Removed
FCesiumIntegerColor
,FCesiumFloatColor
,UCesiumFeatureTexturePropertyBlueprintLibrary::GetIntegerColorFromTextureCoordinates
andUCesiumFeatureTexturePropertyBlueprintLibrary::GetFloatColorFromTextureCoordinates
. Check out the upgrade guide for how retrieve metadata from property textures with the new API. - Renamed
GetTextureCoordinateIndex
toGetUnrealUVChannel
in bothUCesiumFeatureIdTextureBlueprintLibrary
andUCesiumPropertyTexturePropertyBlueprintLibrary
. Contrary to what the documentation claimed, this function retrieved the index of the texture coordinate set in the Unreal static mesh, which is not necessarily equal to the texture coordinate set index in the glTF primitive. For the latter value, useGetGltfTextureCoordinateSetIndex
instead. - Removed the old "exclusion zones" feature, which has been deprecated since v1.11.0. Use
CesiumCartographicPolygon
orCesiumTileExcluder
instead.
Additions 🎉
- Added new functions to
UCesiumPropertyTexturePropertyBlueprintLibrary
to retrieve detailed property information and get the values of the property as a certain type. Check out the upgrade guide for how retrieve metadata from property textures with the new API. - Added
UCesiumMetadataPickingBlueprintLibrary::FindUVFromHit
, which computes the UV coordinates from a line trace hit without requiring "Support UV Hit Info" to be enabled. This can used to retrieve more accurate feature IDs or metadata values by sampling at an intermediary point on the face. - Added
GetPropertyTableValuesFromHit
andGetPropertyTextureValuesFromHit
toUCesiumMetadataPickingBlueprintLibrary
to retrieve the respective metadata from a line trace hit. For both functions, the target to sample is specified by index. - Added
UCesiumFeatureIdSetBlueprintLibrary::GetFeatureIDFromHit
to retrieve the feature ID from a line trace hit on a primitive containing the feature ID set. This returns more accurate values for feature ID textures thanGetFeatureIDForVertex
. - Added
UCesiumPrimitiveFeaturesBlueprintLibrary::GetFeatureIDFromHit
to retrieve the feature ID from a line trace hit on a primitive, where the desired feature ID set is specified by index. For feature ID textures, this returns more accurate values thanGetFeatureIDFromFace
. - Added
UCesiumFeatureIdTextureBlueprintLibrary::GetFeatureIDForUV
, which samples a feature ID texture withFVector2D
UV coordinates. - Added
GetGltfTextureCoordinateSetIndex
toUCesiumFeatureIdTextureBlueprintLibrary
andUCesiumPropertyTexturePropertyBlueprintLibrary
to avoid ambiguity withGetUnrealUVChannel
. - Added
UCesiumMetadataValueBlueprintLibrary::GetValuesAsStrings
to convert a map ofFCesiumMetadataValues
to their string representations. - Added support for
file:///
URLs across all platforms and Unreal Engine versions. - Added "Create Sub Level Here" button on
CesiumGeoreference
. - Added "Place Georeference Origin Here" button to
CesiumSubLevelComponent
. - Added "Google Photorealistic 3D Tiles" to the Quick Add panel.
Fixes 🔧
- Fixed a bug that could cause tiles in a
Cesium3DTileset
to have an incorrect transformation. - Fixed a crash that occurred when a
LevelSequenceActor
in the level did not have aLevelSequencePlayer
assigned. - Fixed a bug that would spam Georeference-related messages to the log when editing a globe anchor component that is not embedded in a world. For example, when editing a Blueprint asset with a globe anchor.
- Fixed several problems that could cause tilesets in sub-levels to be misaligned with the rest of the globe.
Deprecated ⌛
UCesiumFeatureIdTextureBlueprintLibrary::GetFeatureIDForTextureCoordinates
has been deprecated. UseUCesiumFeatureIdTextureBlueprintLibrary::GetFeatureIDForUV
instead.UCesiumPropertyTexturePropertyBlueprintLibrary::GetSwizzle
andUCesiumPropertyTexturePropertyBlueprintLibrary::GetComponentCount
have been deprecated, since they are no longer necessary to handle property texture property values in the plugin. UseUCesiumPropertyTexturePropertyBlueprintLibrary::GetChannels
instead.UCesiumMetadataPickingBlueprintLibrary::GetMetadataValuesForFace
has been deprecated. UseUCesiumMetadataPickingBlueprintLibrary::GetPropertyTableValuesForHit
instead.UCesiumMetadataPickingBlueprintLibrary::GetMetadataValuesForFaceAsStrings
has been deprecated. UseUCesiumMetadataValueBlueprintLibrary::GetValuesAsStrings
to convert the output ofUCesiumMetadataPickingBlueprintLibrary::GetPropertyTableValuesForHit
instead.UCesiumPropertyTableBlueprintLibrary::GetMetadataValuesForFeatureAsStrings
has been deprecated. UseUCesiumMetadataValueBlueprintLibrary::GetValuesAsStrings
to convert the output ofUCesiumPropertyTableBlueprintLibrary::GetMetadataValuesForFeature
instead.
In addition to the above, this release updates cesium-native from v0.28.1 to v0.29.0. See the changelog for a complete list of changes in cesium-native.
Cesium for Unreal v1.31.2
This release includes support for Unreal Engine v5.0, v5.1, v5.2, and v5.3 for Windows, Linux, macOS, Android, and iOS. Please select the appropriate ZIP for your version.
NOTE: This is the last release of Cesium for Unreal that will support Unreal Engine v5.0. Future versions will require Unreal Engine v5.1+.
Additions 🎉
- Added "Google Photorealistic 3D Tiles" to the Quick Add panel.
Cesium for Unreal v2.0.0 Preview 1
This is a preview release of the upcoming Cesium for Unreal v2.0. It is a major version that comes with significant improvements to existing systems in the plugin, as well as some new enhancements.
Note: Please make a backup of your project before upgrading to Cesium for Unreal v2.0. We have done our best to add backwards compatibility for older projects, but there may be some breaking changes that we are unable prevent.
This release includes support for Unreal Engine v5.1, v5.2, and v5.3 for Windows, Linux, macOS, Android, and iOS. Please select the appropriate ZIP for your version.
Read more about the changes on the community forum here. You can also use the community forum to post feedback and report any bugs.
Cesium for Unreal v1.31.1
This release includes support for Unreal Engine v5.0, v5.1, v5.2, and v5.3 for Windows, Linux, macOS, Android, and iOS. Please select the appropriate ZIP for your version.
NOTE: This is the last release of Cesium for Unreal that will support Unreal Engine v5.0. Future versions will require Unreal Engine v5.1+.
Fixes 🔧
- Fixed a bug that could crash the editor when selecting an individual tile in the viewport, then moving the camera to look at something else.
In addition to the above, this release updates cesium-native from v0.27.2 to v0.27.3. See the changelog for a complete list of changes in cesium-native.
Cesium for Unreal v1.31.0
This release includes support for Unreal Engine v5.0, v5.1, v5.2, and v5.3 for Windows, Linux, macOS, Android, and iOS. Please select the appropriate ZIP for your version.
NOTE: With the release of Unreal Engine v5.3, we will soon be dropping support for Unreal Engine v5.0 in new versions of Cesium for Unreal. Please upgrade to a later version as soon as possible.
Additions 🎉
- Added support for Unreal Engine 5.3. There is currently a known issue with
Cesium3DTileset
textures on iOS, so we recommend that you continue to use Unreal Engine 5.2 for the time being if you are deploying to iOS.
In addition to the above, this release updates cesium-native from v0.27.1 to v0.27.2. See the changelog for a complete list of changes in cesium-native.
Cesium for Unreal v1.30.1
This release includes support for Unreal Engine v5.0, v5.1, and v5.2 for Windows, Linux, macOS, Android, and iOS. Please select the appropriate ZIP for your version.
This release fixes an important bug by updating cesium-native from v0.27.0 to v0.27.1. See the changelog for a complete list of changes in cesium-native.
Cesium for Unreal v1.30.0
This release includes support for Unreal Engine v5.0, v5.1, and v5.2 for Windows, Linux, macOS, Android, and iOS. Please select the appropriate ZIP for your version.
This release fix several important bugs by updating cesium-native from v0.26.0 to v0.27.0. See the changelog for a complete list of changes in cesium-native.
Cesium for Unreal v1.29.0
This release includes support for Unreal Engine v5.0, v5.1, and v5.2 for Windows, Linux, macOS, Android, and iOS. Please select the appropriate ZIP for your version.
Fixes 🔧
- Fixed a bug introduced in v1.28.0 that prevented point clouds from rendering with attenuation.
- Fixed a bug where Google Photorealistic 3D Tiles would sometimes not render in Movie Render Queue.
- Fixed a bug that caused
UnrealLightmass
to crash when attempting to build lighting containing static meshes created by aCesium3DTileset
.
In addition to the above, this release updates cesium-native from v0.25.1 to v0.26.0. See the changelog for a complete list of changes in cesium-native.
Cesium for Unreal v1.28.0
This release includes support for Unreal Engine v5.0, v5.1, and v5.2 for Windows, Linux, macOS, Android, and iOS. Please select the appropriate ZIP for your version.
Breaking Changes 📣
- Removed the
GetGeoreferencedToEllipsoidCenteredTransform
andGetEllipsoidCenteredToGeoreferencedTransform
methods fromGeoTransforms
. Because these were transformations between two right-handed coordinate systems, they are not of much use with Unreal's left-handed coordinate system. - Deprecated the
FlyToGranularityDegrees
property forAGlobeAwareDefaultPawn
. Flight interpolation is now computed per-frame, so this property is no longer needed. Any code that refers toFlyToGranularityDegrees
should be removed or changed toFlyToGranularityDegrees_DEPRECATED
to still compile.
Additions 🎉
- Added the ability to set the CesiumGeoreference
Scale
via Blueprints. - Added
ACesiumCameraManager::RemoveCamera
. It is available via both Blueprints and C++. This complements the existingACesiumCameraManager::AddCamera
.
Fixes 🔧
- Added a workaround for an apparent bug in Unreal Engine 5.1 that prevented collisions from working with Cesium3DTilesets.
- Fixed a bug that could cause the
AGlobeAwareDefaultPawn
/DynamicPawn
to suddenly move to a very high height for one render frame just as it arrives at its destination during a flight.
In addition to the above, this release updates cesium-native from v0.25.0 to v0.25.1. See the changelog for a complete list of changes in cesium-native.
Cesium for Unreal v1.27.1
This release includes support for Unreal Engine v5.0, v5.1, and v5.2 for Windows, Linux, macOS, Android, and iOS. Please select the appropriate ZIP for your version.
Fixes 🔧
- Fixed a shader compilation error introduced in v1.27.0 that prevented projects from opening in Unreal Engine 5.1 and 5.2.
- Fixed a debug assertion
!IsGarbageCollecting()
that could occur withinACesiumCreditSystem
when flying to different sublevels.