Merge remote-tracking branch 'origin' into cesium.com

Author: jjspace

Apps/Sandcastle/CesiumSandcastle.css

@@ -53,7 +53,7 @@ body {
   width: 40%;
 }
 
-#bottomPanel {
+#bottomSection {
   height: 225px;
 }
 

Apps/Sandcastle/CesiumSandcastle.js

@@ -621,7 +621,10 @@ require({
 
     // Apply user HTML to bucket.
     const htmlElement = bucketDoc.createElement("div");
-    htmlElement.innerHTML = htmlEditor.getValue();
+    // Stylesheet imports are weirdly broken in Firefox 140. This is a hacky workaround
+    // https://github.com/CesiumGS/cesium/issues/12700
+    const htmlCode = htmlEditor.getValue().replace(/@import/, "@import ");
+    htmlElement.innerHTML = htmlCode;
     bucketDoc.body.appendChild(htmlElement);
 
     const onScriptTagError = function () {
@@ -1179,7 +1182,9 @@ require({
     baseHref = `${baseHref.substring(0, pos)}/gallery/`;
 
     const code = jsEditor.getValue();
-    const html = htmlEditor.getValue();
+    // Stylesheet imports are weirdly broken in Firefox 140. This is a hacky workaround
+    // https://github.com/CesiumGS/cesium/issues/12700
+    const html = htmlEditor.getValue().replace(/@import/, "@import ");
     const data = makeCompressedBase64String([code, html, baseHref]);
 
     let url = getBaseUrl();

Apps/Sandcastle/gallery/3D Tiles Terrain Classification.html

@@ -38,7 +38,7 @@
         });
 
         const geocoder = viewer.geocoder.viewModel;
-        geocoder.searchText = "Vienna";
+        geocoder.searchText = "Vienna, Austria";
         geocoder.flightDuration = 0.0;
         geocoder.search();
 

Apps/Sandcastle/gallery/Voxel Picking.html

@@ -75,6 +75,8 @@
         function ProceduralMultiTileVoxelProvider(shape) {
           this.shape = shape;
           this.dimensions = new Cesium.Cartesian3(4, 4, 4);
+          this.minBounds = Cesium.VoxelShapeType.getMinBounds(shape).clone();
+          this.maxBounds = Cesium.VoxelShapeType.getMaxBounds(shape).clone();
           this.names = ["color"];
           this.types = [Cesium.MetadataType.VEC4];
           this.componentTypes = [Cesium.MetadataComponentType.FLOAT32];
@@ -134,11 +136,9 @@
           return dataColor;
         }
 
-        const provider = new ProceduralMultiTileVoxelProvider(Cesium.VoxelShapeType.BOX);
-
         const customShader = new Cesium.CustomShader({
           fragmentShaderText: `void fragmentMain(FragmentInput fsInput, inout czm_modelMaterial material)
-    {
+  {
       vec3 voxelNormal = fsInput.attributes.normalEC;
       float diffuse = max(0.0, dot(voxelNormal, czm_lightDirectionEC));
       float lighting = 0.5 + 0.5 * diffuse;
@@ -147,13 +147,13 @@
       int sampleIndex = fsInput.voxel.sampleIndex;
       vec3 cellColor = fsInput.metadata.color.rgb * lighting;
       if (tileIndex == u_selectedTile && sampleIndex == u_selectedSample) {
-        material.diffuse = mix(cellColor, vec3(1.0), 0.5);
-        material.alpha = fsInput.metadata.color.a;
+          material.diffuse = mix(cellColor, vec3(1.0), 0.5);
+          material.alpha = fsInput.metadata.color.a;
       } else {
-        material.diffuse = cellColor;
-        material.alpha = fsInput.metadata.color.a;
+          material.diffuse = cellColor;
+          material.alpha = fsInput.metadata.color.a;
       }
-    }`,
+  }`,
           uniforms: {
             u_selectedTile: {
               type: Cesium.UniformType.INT,
@@ -166,18 +166,54 @@
           },
         });
 
-        const voxelPrimitive = scene.primitives.add(
-          new Cesium.VoxelPrimitive({
+        function createPrimitive(provider) {
+          viewer.scene.primitives.removeAll();
+
+          const voxelPrimitive = new Cesium.VoxelPrimitive({
             provider: provider,
             customShader: customShader,
-          }),
-        );
+          });
+          voxelPrimitive.nearestSampling = true;
 
-        voxelPrimitive.nearestSampling = true;
+          viewer.scene.primitives.add(voxelPrimitive);
+          camera.flyToBoundingSphere(voxelPrimitive.boundingSphere, {
+            duration: 0.0,
+          });
 
-        camera.flyToBoundingSphere(voxelPrimitive.boundingSphere, {
-          duration: 0.0,
-        });
+          return voxelPrimitive;
+        }
+
+        Sandcastle.addToolbarMenu([
+          {
+            text: "Box - Procedural Tileset",
+            onselect: function () {
+              const provider = new ProceduralMultiTileVoxelProvider(
+                Cesium.VoxelShapeType.BOX,
+              );
+              const primitive = createPrimitive(provider);
+            },
+          },
+          {
+            text: "Ellipsoid - Procedural Tileset",
+            onselect: function () {
+              const provider = new ProceduralMultiTileVoxelProvider(
+                Cesium.VoxelShapeType.ELLIPSOID,
+              );
+              provider.minBounds.z = 0.0;
+              provider.maxBounds.z = 1000000.0;
+              const primitive = createPrimitive(provider);
+            },
+          },
+          {
+            text: "Cylinder - Procedural Tileset",
+            onselect: function () {
+              const provider = new ProceduralMultiTileVoxelProvider(
+                Cesium.VoxelShapeType.CYLINDER,
+              );
+              const primitive = createPrimitive(provider);
+            },
+          },
+        ]);
 
         const handler = new Cesium.ScreenSpaceEventHandler(scene.canvas);
         const pickedCoordinate = document.getElementById("pickedCoordinate");

Apps/Sandcastle/index.html

@@ -320,12 +320,13 @@
         </div>
       </div>
       <div
-        id="bottomPanel"
+        id="bottomSection"
         class="bottomPanel"
         data-dojo-type="dijit.layout.BorderContainer"
         data-dojo-props="region: 'bottom', splitter: true"
       >
         <div
+          id="bottomPanel"
           class="bottomPanel"
           data-dojo-type="dijit.layout.TabContainer"
           data-dojo-props="region: 'center', splitter: false"

CHANGES.md

@@ -1,6 +1,21 @@
 # Change Log
 
-## 1.130.1 - 2025-06-24
+## 1.131 - 2025-07-01
+
+### @cesium/engine
+
+### Fixes :wrench:
+
+- Updates use of deprecated options on createImageBitmap. [#12664](https://github.com/CesiumGS/cesium/pull/12664)
+- Fixed raymarching step size for cylindrical voxels. [#12681](https://github.com/CesiumGS/cesium/pull/12681)
+- Fixes handling of tileset `modelMatrix` changes for translations and rotations in `GaussianSplatPrimitive`. [#12706](https://github.com/CesiumGS/cesium/pull/12706)
+
+#### Additions :tada:
+
+- Added `HeightReference` to `Cesium3DTileset.ConstructorOptions` to allow clamping point features in 3D Tile vector data to terrain or 3D Tiles [#11710](https://github.com/CesiumGS/cesium/pull/11710)
+- Added the ability to pass `OffscreenCanvas` & `ImageBitmap` directly to `Material` uniforms. [#12558](https://github.com/CesiumGS/cesium/pull/12558)
+
+## 1.130.1 - 2025-06-16
 
 ### @cesium/engine
 
@@ -4056,10 +4071,8 @@ _This is an npm-only release to fix a publishing issue_.
 ## 1.0 - 2014-08-01
 
 - Breaking changes ([why so many?](https://community.cesium.com/t/moving-towards-cesium-1-0/1209))
-
   - All `Matrix2`, `Matrix3`, `Matrix4` and `Quaternion` functions that take a `result` parameter now require the parameter, except functions starting with `from`.
   - Removed `Billboard.imageIndex` and `BillboardCollection.textureAtlas`. Instead, use `Billboard.image`.
-
     - Code that looked like:
 
             var billboards = new Cesium.BillboardCollection();
@@ -4196,7 +4209,6 @@ _This is an npm-only release to fix a publishing issue_.
 ## b30 - 2014-07-01
 
 - Breaking changes ([why so many?](https://community.cesium.com/t/moving-towards-cesium-1-0/1209))
-
   - CZML property references now use a `#` symbol to separate identifier from property path. `objectId.position` should now be `objectId#position`.
   - All `Cartesian2`, `Cartesian3`, `Cartesian4`, `TimeInterval`, and `JulianDate` functions that take a `result` parameter now require the parameter (except for functions starting with `from`).
   - Modified `Transforms.pointToWindowCoordinates` and `SceneTransforms.wgs84ToWindowCoordinates` to return window coordinates with origin at the top left corner.
@@ -4245,7 +4257,6 @@ _This is an npm-only release to fix a publishing issue_.
     - `date.greaterThan(right)` -> `JulianDate.greaterThan(left, right)`
     - `date.greaterThanOrEquals(right)` -> `JulianDate.greaterThanOrEquals(left, right)`
   - Refactored `TimeInterval` to be in line with other Core types.
-
     - The constructor no longer requires parameters and now takes a single options parameter. Code that looked like:
 
             new TimeInterval(startTime, stopTime, true, true, data);
@@ -4259,7 +4270,6 @@ _This is an npm-only release to fix a publishing issue_.
                 isStopIncluded : true,
                 data : data
             });
-
     - `TimeInterval.fromIso8601` now takes a single options parameter. Code that looked like:
 
             TimeInterval.fromIso8601(intervalString, true, true, data);
@@ -4272,7 +4282,6 @@ _This is an npm-only release to fix a publishing issue_.
                 isStopIncluded : true,
                 data : data
             });
-
     - `interval.intersect(otherInterval)` -> `TimeInterval.intersect(interval, otherInterval)`
     - `interval.contains(date)` -> `TimeInterval.contains(interval, date)`
 
@@ -4329,7 +4338,6 @@ _This is an npm-only release to fix a publishing issue_.
 ## b29 - 2014-06-02
 
 - Breaking changes ([why so many?](https://community.cesium.com/t/moving-towards-cesium-1-0/1209))
-
   - Replaced `Scene.createTextureAtlas` with `new TextureAtlas`.
   - Removed `CameraFlightPath.createAnimationCartographic`. Code that looked like:
 
@@ -4447,7 +4455,6 @@ _This is an npm-only release to fix a publishing issue_.
 ## b27 - 2014-04-01
 
 - Breaking changes:
-
   - All `CameraController` functions have been moved up to the `Camera`. Removed `CameraController`. For example, code that looked like:
 
            scene.camera.controller.viewExtent(extent);
@@ -4757,7 +4764,6 @@ _This is an npm-only release to fix a publishing issue_.
 ## b24 - 2014-01-06
 
 - Breaking changes:
-
   - Added `allowTextureFilterAnisotropic` (default: `true`) and `failIfMajorPerformanceCaveat` (default: `true`) properties to the `contextOptions` property passed to `Viewer`, `CesiumWidget`, and `Scene` constructors and moved the existing properties to a new `webgl` sub-property. For example, code that looked like:
 
            var viewer = new Viewer('cesiumContainer', {
@@ -4805,7 +4811,6 @@ _This is an npm-only release to fix a publishing issue_.
 ## b23 - 2013-12-02
 
 - Breaking changes:
-
   - Changed the `CatmullRomSpline` and `HermiteSpline` constructors from taking an array of structures to a structure of arrays. For example, code that looked like:
 
            var controlPoints = [
@@ -4919,7 +4924,6 @@ _This is an npm-only release to fix a publishing issue_.
 ## b21 - 2013-10-01
 
 - Breaking changes:
-
   - Cesium now prints a reminder to the console if your application uses Bing Maps imagery and you do not supply a Bing Maps key for your application. This is a reminder that you should create a Bing Maps key for your application as soon as possible and prior to deployment. You can generate a Bing Maps key by visiting [https://www.bingmapsportal.com/](https://www.bingmapsportal.com/). Set the `BingMapsApi.defaultKey` property to the value of your application's key before constructing the `CesiumWidget` or any other types that use the Bing Maps API.
 
            BingMapsApi.defaultKey = 'my-key-generated-with-bingmapsportal.com';
@@ -4941,7 +4945,6 @@ _This is an npm-only release to fix a publishing issue_.
   - Removed `getViewMatrix`, `getInverseViewMatrix`, `getInverseTransform`, `getPositionWC`, `getDirectionWC`, `getUpWC` and `getRightWC` from `Camera`. Instead, use the `viewMatrix`, `inverseViewMatrix`, `inverseTransform`, `positionWC`, `directionWC`, `upWC`, and `rightWC` properties.
   - Removed `getProjectionMatrix` and `getInfiniteProjectionMatrix` from `PerspectiveFrustum`, `PerspectiveOffCenterFrustum` and `OrthographicFrustum`. Instead, use the `projectionMatrix` and `infiniteProjectionMatrix` properties.
   - The following prototype functions were removed:
-
     - From `Quaternion`: `conjugate`, `magnitudeSquared`, `magnitude`, `normalize`, `inverse`, `add`, `subtract`, `negate`, `dot`, `multiply`, `multiplyByScalar`, `divideByScalar`, `getAxis`, `getAngle`, `lerp`, `slerp`, `equals`, `equalsEpsilon`
     - From `Cartesian2`, `Cartesian3`, and `Cartesian4`: `getMaximumComponent`, `getMinimumComponent`, `magnitudeSquared`, `magnitude`, `normalize`, `dot`, `multiplyComponents`, `add`, `subtract`, `multiplyByScalar`, `divideByScalar`, `negate`, `abs`, `lerp`, `angleBetween`, `mostOrthogonalAxis`, `equals`, and `equalsEpsilon`.
     - From `Cartesian3`: `cross`
@@ -4996,7 +4999,6 @@ _This is an npm-only release to fix a publishing issue_.
 _This releases fixes 2D and other issues with Chrome 29.0.1547.57 ([#1002](https://github.com/CesiumGS/cesium/issues/1002) and [#1047](https://github.com/CesiumGS/cesium/issues/1047))._
 
 - Breaking changes:
-
   - The `CameraFlightPath` functions `createAnimation`, `createAnimationCartographic`, and `createAnimationExtent` now take `scene` as their first parameter instead of `frameState`.
   - Completely refactored the `DynamicScene` property system to vastly improve the API. See [#1080](https://github.com/CesiumGS/cesium/pull/1080) for complete details.
     - Removed `CzmlBoolean`, `CzmlCartesian2`, `CzmlCartesian3`, `CzmlColor`, `CzmlDefaults`, `CzmlDirection`, `CzmlHorizontalOrigin`, `CzmlImage`, `CzmlLabelStyle`, `CzmlNumber`, `CzmlPosition`, `CzmlString`, `CzmlUnitCartesian3`, `CzmlUnitQuaternion`, `CzmlUnitSpherical`, and `CzmlVerticalOrigin` since they are no longer needed.
@@ -5174,7 +5176,6 @@ _This releases fixes 2D and other issues with Chrome 29.0.1547.57 ([#1002](https
 ## b16 - 2013-05-01
 
 - Breaking changes:
-
   - Removed the color, outline color, and outline width properties of polylines. Instead, use materials for polyline color and outline properties. Code that looked like:
 
            var polyline = polylineCollection.add({
@@ -5292,7 +5293,6 @@ _This releases fixes 2D and other issues with Chrome 29.0.1547.57 ([#1002](https
 ## b12a - 2013-01-18
 
 - Breaking changes:
-
   - Renamed the `server` property to `url` when constructing a `BingMapsImageryProvider`. Likewise, renamed `BingMapsImageryProvider.getServer` to `BingMapsImageryProvider.getUrl`. Code that looked like
 
            var bing = new BingMapsImageryProvider({
@@ -5420,7 +5420,6 @@ _This releases fixes 2D and other issues with Chrome 29.0.1547.57 ([#1002](https
 ## b8 - 2012-09-05
 
 - Breaking changes:
-
   - Materials are now created through a centralized Material class using a JSON schema called [Fabric](https://github.com/CesiumGS/cesium/wiki/Fabric). For example, change:
 
           polygon.material = new BlobMaterial({repeat : 10.0});
@@ -5486,7 +5485,6 @@ _This releases fixes 2D and other issues with Chrome 29.0.1547.57 ([#1002](https
 ## b7 - 2012-08-01
 
 - Breaking changes:
-
   - Removed keyboard input handling from `EventHandler`.
   - `TextureAtlas` takes an object literal in its constructor instead of separate parameters. Code that previously looked like:
 
@@ -5597,7 +5595,6 @@ _This releases fixes 2D and other issues with Chrome 29.0.1547.57 ([#1002](https
 ## b5 - 2012-05-15
 
 - Breaking changes:
-
   - Renamed Geoscope to Cesium. To update your code, change all `Geoscope.*` references to `Cesium.*`, and reference Cesium.js instead of Geoscope.js.
   - `CompositePrimitive.addGround` was removed; use `CompositePrimitive.add` instead. For example, change
 
@@ -5658,7 +5655,6 @@ _This releases fixes 2D and other issues with Chrome 29.0.1547.57 ([#1002](https
   - TileProviders now take a proxy object instead of a string, to allow more control over how proxy URLs are built. Construct a DefaultProxy, passing the previous proxy URL, to get the previous behavior.
   - `Ellipsoid.getScaledWgs84()` has been removed since it is not needed.
   - `getXXX()` methods which returned a new instance of what should really be a constant are now exposed as frozen properties instead. This should improve performance and memory pressure.
-
     - `Cartsian2/3/4.getUnitX()` -> `Cartsian2/3/4.UNIT_X`
     - `Cartsian2/3/4.getUnitY()` -> `Cartsian2/3/4.UNIT_Y`
     - `Cartsian2/3/4.getUnitZ()` -> `Cartsian3/4.UNIT_Z`
@@ -5678,7 +5674,6 @@ _This releases fixes 2D and other issues with Chrome 29.0.1547.57 ([#1002](https
 ## b4 - 2012-03-01
 
 - Breaking changes:
-
   - Replaced `Geoscope.SkyFromSpace` object with `CentralBody.showSkyAtmosphere` property.
   - For mouse click and double click events, replaced `event.x` and `event.y` with `event.position`.
   - For mouse move events, replaced `movement.startX` and `startY` with `movement.startPosition`. Replaced `movement.endX` and `movement.endY` with `movement.endPosition`.
@@ -5739,13 +5734,11 @@ _This releases fixes 2D and other issues with Chrome 29.0.1547.57 ([#1002](https
 - Added CameraFlightController to zoom smoothly from one point to another. See the new camera examples in the Sandbox.
 - Added row and column assessors to Matrix2, Matrix3, and Matrix4.
 - Added Scene, which reduces the amount of code required to use Geoscope. See the Skeleton. We recommend using this instead of explicitly calling update() and render() for individual or composite primitives. Existing code will need minor changes:
-
   - Calls to Context.pick() should be replaced with Scene.pick().
   - Primitive constructors no longer require a context argument.
   - Primitive update() and render() functions now require a context argument. However, when using the new Scene object, these functions do not need to be called directly.
   - TextureAtlas should no longer be created directly; instead, call Scene.getContext().createTextureAtlas().
   - Other breaking changes:
-
     - Camera get/set functions, e.g., getPosition/setPosition were replaced with properties, e.g., position.
     - Replaced CompositePrimitive, Polygon, and Polyline getShow/setShow functions with a show property.
     - Replaced Polyline, Polygon, BillboardCollection, and LabelCollection getBufferUsage/setBufferUsage functions with a bufferUsage property.

CONTRIBUTORS.md

@@ -207,6 +207,8 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for details on how to contribute to Cesiu
   - [IKangXu](https://github.com/IKangXu)
   - [EMapGIS](https://github.com/EMapGIS)
   - [CandyACE](https://github.com/CandyACE)
+- [EARTHBRAIN, Ltd.](https://www.earthbrain.com/en/)
+  - [Gregory Diehl](https://github.com/gdiehleb)
 
 ## [Individual CLA](Documentation/Contributors/CLAs/individual-contributor-license-agreement-v1.0.pdf)
 
@@ -421,3 +423,4 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for details on how to contribute to Cesiu
 - [Andrew Dassonville](https://github.com/andrewda)
 - [Cody Butler](https://github.com/CodyBu)
 - [Hiwen](https://github.com/Hiwen)
+- [Matt Schwartz](https://github.com/mzschwartz5)