Releases: CesiumGS/cesium-unreal
Cesium for Unreal v2.4.1
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.
This release updates cesium-native from v0.33.0 to v0.34.0. See the changelog for a complete list of changes in cesium-native.
Cesium for Unreal v2.4.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.
Additions 🎉
- Significantly reduced CPU memory used by glTF and raster overlay textures.
- Improved texture creation performance on non-D3D platforms.
- Added support for the
KHR_texture_transform
glTF extension - including rotation - forCesiumFeatureIdTexture
andCesiumPropertyTextureProperty
. CesiumFeaturesMetadataComponent
now generates nodes forKHR_texture_transform
if the extension is present in a feature ID texture or property texture property.
Fixes 🔧
- Metadata-related textures are now created in
TEXTUREGROUP_8BitData
instead ofTEXTUREGROUP_World
. - Added some defensive nullptr checks to
CesiumSunSky
.
In addition to the above, this release updates cesium-native from v0.32.0 to v0.33.0. See the changelog for a complete list of changes in cesium-native.
Cesium for Unreal v2.3.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.
Additions 🎉
- Added support for Web Map Tile Service (WMTS) with
CesiumWebMapTileServiceRasterOverlay
. - Significantly reduced CPU memory usage by textures on non-Windows systems.
- Added support for the
KHR_texture_transform
glTF extension - including rotation - inbaseColorTexture
,metallicRoughnessTexture
,emissiveTexture
,normalTexture
, andocclusionTexture
. The transformation is now applied on the GPU via nodes in the Material, rather than on the CPU by directly modifying texture coordinates.
Fixes 🔧
- Fixed a bug in
MLB_DitherFade
that made glTF materials with analphaMode
ofMASK
incorrectly appear as fully opaque. - Fixed a bug in
CesiumFlyToComponent
that could cause the position of the object to shift suddenly at the very end of the flight. - Fixed a bug that caused textures created by Cesium for Unreal on D3D11 and D3D12 (only) to not be counted in the "Texture Memory Used" stat in the "Memory" stat group or in any counter in the "TextureGroup" stat group.
- Fixed a bug in
CesiumGltfComponent
that would cause a crash if theIgnore KHR_materials_unlit
setting was enabled on a point cloud. - Fixed a bug in
CesiumActors
that would cause the editor to crash when running in Standalone mode. - Fixed several build warnings when packing in Unreal Engine 5.3.
- Readded backwards compatibility for feature textures from
EXT_feature_metadata
, which was mistakenly removed. - Fixed a bug that caused nav mesh creation to be slow due to creating duplicate physics meshes.
In addition to the above, this release updates cesium-native from v0.31.0 to v0.32.0. See the changelog for a complete list of changes in cesium-native.
Cesium for Unreal v2.2.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 📣
- Deprecated
IonAssetEndpointUrl
onCesium3DTileset
andCesiumIonRasterOverlay
. Use the newCesiumIonServer
property instead.
Additions 🎉
- Added support for multiple Cesium ion servers by creating
CesiumIonServer
data assets.
In addition to the above, this release updates cesium-native from v0.30.0 to v0.31.0. See the changelog for a complete list of changes in cesium-native.
Cesium for Unreal v2.1.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.
Additions 🎉
- Added support for styling with property textures in
EXT_structural_metadata
. - Significantly improved tile download performance by adding
HttpThreadActiveFrameTimeInSeconds=0.001
toEngine.ini
. This results in a major performance improvement for all tilesets, particularly Google Photorealistic 3D Tiles. - Added
HttpMaxConnectionsPerServer=40
toEngine.ini
. By default, only 16 connections are allowed, which limits the performance when downloading tiles.
Fixes 🔧
- Fixed a bug in the "Select New Token" dialog that caused an error when trying to create a new token without being connected.
- Fixed a bug where an
EditConditio
n was not parsed correctly and caused Output Log window errors. - Removed query parameters from filepaths if present, as they are no longer ignored by Unreal. This fixes a bug where the URL would not load correctly in some cases.
- Fixed a Tile Excluder bug that computed incorrect tile bounds, making tiles invisible when moving the tileset in the sample scene.
- Fixed a bug where viewports could appear wider than configured in the Dynamic Pawn's Camera Field of View. Noticed in Unreal Engine v5.3 when in Play-In-Editor mode, or a packaged game. In extreme cases, tiles would be missing near the edges of the view.
In addition to the above, this release updates cesium-native from v0.29.0 to v0.30.0. See the changelog for a complete list of changes in cesium-native.
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.