Merge branch 'main' of github.com:CesiumGS/cesium-unreal into itwin-client

Author: azrogers

.github/pull_request_template.md

@@ -0,0 +1,42 @@
+<!--
+Thanks for the Pull Request!
+
+Please review the [Contributor Guide](https://cesium.com/learn/cesium-unreal/ref-doc/contributing-unreal.html) before opening your first Pull Request.
+
+To ensure your Pull Request is reviewed and accepted quickly, please refer to our [Pull Request Guidelines](https://cesium.com/learn/cesium-unreal/ref-doc/contributing-unreal.html#opening-a-pull-request).
+
+-->
+
+## Description
+
+<!-- Summarize the pull request. -- >
+
+< !-- Provide context for the reviewer to understand the pull request. Include what changes were made and why. -->
+
+<!-- Include screenshots if appropriate. -->
+
+## Issue number or link
+
+<!-- If it fixes an open issue, link to the issue here -->
+
+<!-- Consider: If suggesting a new feature or change, discuss it in an issue first. -->
+
+## Author checklist
+
+- [ ] I have submitted a [Contributor License Agreement](https://github.com/CesiumGS/community/tree/main/CLAs) (only needed once).
+- [ ] I have done a full self-review of my code.
+- [ ] I have updated `CHANGES.md` with a short summary of my change (for user-facing changes).
+- [ ] I have added or updated unit tests to ensure consistent code coverage as necessary.
+- [ ] I have updated the documentation as necessary.
+
+## Remaining Tasks
+
+<!-- Are there any remaining tasks to do or blocking questions to answer before we can merge this? -->
+
+<!-- If so, please convert this to a draft PR and let us know how we can help. Otherwise, you may remove this section. -->
+
+## Testing plan
+
+<!-- Describe in detail how you tested your changes. If this fixes a bug, list the steps to reproduce the original issue. -->
+
+<!-- Include links to any required data or screenshots. Mention any edge cases such as user error, invalid data, etc. -->

.github/workflows/prod.yml

@@ -15,9 +15,9 @@ jobs:
       - name: Install Doxygen
         run: |
           cd ~
-          wget https://github.com/doxygen/doxygen/releases/download/Release_1_12_0/doxygen-1.12.0.linux.bin.tar.gz
-          tar xzf doxygen-1.12.0.linux.bin.tar.gz
-          export PATH=$PWD/doxygen-1.12.0/bin:$PATH
+          wget https://github.com/doxygen/doxygen/releases/download/Release_1_13_2/doxygen-1.13.2.linux.bin.tar.gz
+          tar xzf doxygen-1.13.2.linux.bin.tar.gz
+          export PATH=$PWD/doxygen-1.13.2/bin:$PATH
           echo "PATH=$PATH" >> "$GITHUB_ENV"
           doxygen --version
       - name: Check out repository code

CHANGES.md

@@ -1,4 +1,43 @@
-# Change Log
+# Change Log {#changes}
+
+### v2.16.0 - 2025-05-01
+
+##### Additions :tada:
+
+- Added a Cesium -> Geocoder -> Geocode Blueprint function, making it easy to query the Cesium ion geocoder.
+- Added `UCesiumMetadataPickingBlueprintLibrary::FindPropertyTableProperty` to search for a `FCesiumPropertyTableProperty` by name on a given `UPrimitiveComponent`.
+
+##### Fixes :wrench:
+
+- Fixed a linking issue introduced in *v2.15.0* in `GoogleTilesTestSetup`.
+- The "unsupported primitive mode" warning is now only logged once to avoid console spam.
+- Request cache will now use `FPaths::ProjectUserDir` instead of `FPaths::EngineUserDir` on non-Android and non-iOS platforms, fixing a permissions issue in Development builds.
+- Fixed a build issue with KTX-Software's overlay port on Windows when there is no bash.exe in the system PATH and Git-for-windows is installed in a non-default directory.
+
+In addition to the above, this release updates [cesium-native](https://github.com/CesiumGS/cesium-native) from v0.46.0 to v0.47.0. See the [changelog](https://github.com/CesiumGS/cesium-native/blob/main/CHANGES.md) for a complete list of changes in cesium-native.
+
+### v2.15.0 - 2025-04-01
+
+##### Additions :tada:
+
+- Actors spawned through the Cesium editor panel, such as tilesets and cartographic polygons, will now be parented to the first selected georeference - if any - instead of always being parented to the first georeference in the scene.
+- `WorldHeight` Runtime Virtual Texture output is now set to the Z component of the world position.
+
+##### Fixes :wrench:
+
+- Fixed a bug where a glTF material with `alphaMode=BLEND` would be rendered as opaque if its `baseColorFactor` was not set.
+- Fixed a crash that could occur when rapidly refreshing a tileset.
+- Fixed crash when tilesets with point clouds were used in combination with Hardware Ray Tracing.
+- Worked around an apparent Metal problem that prevented polygon clipping from working correctly on macOS.
+- Fixed normals being incorrectly written to Runtime Virtual Texture output in tangent space instead of in world space.
+
+In addition to the above, this release updates [cesium-native](https://github.com/CesiumGS/cesium-native) from v0.45.0 to v0.46.0. See the [changelog](https://github.com/CesiumGS/cesium-native/blob/main/CHANGES.md) for a complete list of changes in cesium-native.
+
+### v2.14.1 - 2025-03-06
+
+##### Fixes :wrench:
+
+- Fixed the "Auto Fill" and "Generate Material" buttons on `UCesiumFeaturesMetadataComponent`, which broke with the previous release.
 
 ### v2.14.0 - 2025-03-03
 

CODE_OF_CONDUCT.md

@@ -1,4 +1,4 @@
-# Code of Conduct
+# Code of Conduct {#code-of-conduct}
 
 One of Cesium's strengths is our community. Our contributors and users are pushing the 3D geospatial field to amazing new levels. We rely on an open, friendly, inclusive environment to facilitate this. As such, we follow the [Contributor Covenant](https://www.contributor-covenant.org/)'s [Code of Conduct](https://www.contributor-covenant.org/version/2/0/code_of_conduct/) to ensure a harassment-free experience in the Cesium community. Any unacceptable behavior can be confidentially sent to the core team at [email protected].
 

CONTRIBUTING.md

@@ -1,4 +1,4 @@
-# Contribution Guide {#contributing-unreal}
+# Contributing {#contributing-unreal}
 
 Thanks for contributing to Cesium for Unreal!
 
@@ -8,7 +8,7 @@ Thanks for contributing to Cesium for Unreal!
 
 Here are the guidelines that we use for all contributions to this project:
 
-- [Submitting an issue](#submitting-an-issue),
+- [Submitting an issue](#submitting-an-issue)
 - [Getting started contributing](#getting-started-contributing)
 - [Opening a pull request](#opening-a-pull-request)
 
@@ -81,4 +81,4 @@ Our code is our lifeblood so maintaining Cesium's high code quality is important
 
 ## Code of Conduct
 
-To ensure an inclusive community, contributors and users in the Cesium community should follow the [code of conduct](./CODE_OF_CONDUCT.md).
+To ensure an inclusive community, contributors and users in the Cesium community should follow the <!--! \subpage code-of-conduct \cond DOXYGEN_EXCLUDE --> [code of conduct](./CODE_OF_CONDUCT.md)<!--! \endcond -->.

CesiumForUnreal.uplugin

@@ -1,7 +1,7 @@
 {
 	"FileVersion": 3,
-	"Version": 73,
-	"VersionName": "2.14.0",
+	"Version": 75,
+	"VersionName": "2.16.0",
 	"FriendlyName": "Cesium for Unreal",
 	"Description": "Unlock the 3D geospatial ecosystem in Unreal Engine with real-world 3D content and a high accuracy full-scale WGS84 globe.",
 	"Category": "Geospatial",

Content/Materials/M_CesiumBaseMaterial.uasset

@@ -1,4 +1,4 @@
-# API Design Guide
+# API Design Guide {#api-design}
 
 Cesium for Unreal unlocks geospatial capabilities in Unreal Engine while also enabling developers to take advantage of in-engine features. As a result, people who use the plugin can often come with existing Unreal knowledge.
 

Content/Materials/MaterialFunctions/CesiumSelectTexCoords.uasset

@@ -0,0 +1,11 @@
+# Contributor Guide {#contributor-guide}
+
+This section contains topics that are useful to anyone building Cesium for Unreal themselves, modifying it, or contributing to it. For information about using the plugin, see the [User Guide](#user-guide).
+
+- \subpage contributing-unreal
+- \subpage developer-setup-unreal
+- \subpage style-guide
+- \subpage api-design
+- \subpage performance-profiling
+- \subpage release-process
+- \subpage three-d-tiles-in-unreal