@cesium/engine 18.0.1-splats.0 → 18.3.0

package/Build/Workers/gaussianSplatTextureGenerator.js

@@ -1,7 +1,7 @@
 /**
  * @license
  * Cesium - https://github.com/CesiumGS/cesium
- * Version 1.130.1-splats
+ * Version 1.131
  *
  * Copyright 2011-2022 Cesium Contributors
  *
@@ -26,13 +26,13 @@
 import {
   generate_splat_texture,
   initSync
-} from "./chunk-EYMZ5FSQ.js";
+} from "./chunk-PFBF3WJU.js";
 import {
   createTaskProcessorWorker_default
-} from "./chunk-DTVWE5YL.js";
+} from "./chunk-CSHXIRSO.js";
 import {
   defined_default
-} from "./chunk-LMTGCD6P.js";
+} from "./chunk-OSUQRKTM.js";
 
 // packages/engine/Source/Workers/gaussianSplatTextureGenerator.js
 async function initWorker(parameters, transferableObjects) {

package/Build/Workers/transcodeKTX2.js

@@ -1,7 +1,7 @@
 /**
  * @license
  * Cesium - https://github.com/CesiumGS/cesium
- * Version 1.130.1-splats
+ * Version 1.131
  *
  * Copyright 2011-2022 Cesium Contributors
  *
@@ -25,22 +25,22 @@
 
 import {
   createTaskProcessorWorker_default
-} from "./chunk-DTVWE5YL.js";
+} from "./chunk-CSHXIRSO.js";
 import {
   WebGLConstants_default
-} from "./chunk-LWZOYSSF.js";
+} from "./chunk-Y4UZFTIJ.js";
 import {
   RuntimeError_default
-} from "./chunk-RTUZ7MJB.js";
+} from "./chunk-6ZILMWWT.js";
 import {
   Check_default
-} from "./chunk-HDG3VHYL.js";
+} from "./chunk-GPIOZ7JH.js";
 import {
   __commonJS,
   __require,
   __toESM,
   defined_default
-} from "./chunk-LMTGCD6P.js";
+} from "./chunk-OSUQRKTM.js";
 
 // packages/engine/Source/ThirdParty/Workers/basis_transcoder.js
 var require_basis_transcoder = __commonJS({

package/Build/Workers/transferTypedArrayTest.js

@@ -1,7 +1,7 @@
 /**
  * @license
  * Cesium - https://github.com/CesiumGS/cesium
- * Version 1.130.1-splats
+ * Version 1.131
  *
  * Copyright 2011-2022 Cesium Contributors
  *

package/Build/Workers/upsampleQuantizedTerrainMesh.js

@@ -1,7 +1,7 @@
 /**
  * @license
  * Cesium - https://github.com/CesiumGS/cesium
- * Version 1.130.1-splats
+ * Version 1.131
  *
  * Copyright 2011-2022 Cesium Contributors
  *
@@ -26,48 +26,48 @@
 import {
   EllipsoidalOccluder_default,
   TerrainEncoding_default
-} from "./chunk-4GYIDPXP.js";
+} from "./chunk-JSLGNJ6G.js";
 import {
   createTaskProcessorWorker_default
-} from "./chunk-DTVWE5YL.js";
+} from "./chunk-CSHXIRSO.js";
 import {
   OrientedBoundingBox_default
-} from "./chunk-HOEUXPBL.js";
+} from "./chunk-E2ZVCKQO.js";
 import {
   AttributeCompression_default
-} from "./chunk-6Y6TVYHS.js";
-import "./chunk-AQKVFTWV.js";
-import "./chunk-DI7PHKC6.js";
-import "./chunk-PFD462OE.js";
-import "./chunk-V7LEBY53.js";
+} from "./chunk-2X55GKAZ.js";
+import "./chunk-SJYSTWZN.js";
+import "./chunk-UYWREKNU.js";
+import "./chunk-BOUULJGB.js";
+import "./chunk-ILTKII7E.js";
 import {
   IndexDatatype_default
-} from "./chunk-KPLU3WDY.js";
+} from "./chunk-IBBIUKYY.js";
 import {
   BoundingSphere_default
-} from "./chunk-6QOBORNG.js";
+} from "./chunk-VAZJ3S3Y.js";
 import {
   Rectangle_default
-} from "./chunk-FOMRN6II.js";
-import "./chunk-2J5ZZ7CY.js";
+} from "./chunk-ZAEJ2APC.js";
+import "./chunk-LVBAAA7Y.js";
 import {
   Cartesian2_default,
   Cartesian3_default,
   Cartographic_default,
   Ellipsoid_default
-} from "./chunk-FOTXJYKS.js";
+} from "./chunk-HPJTS3IN.js";
 import {
   Math_default
-} from "./chunk-6EP7ED36.js";
-import "./chunk-LWZOYSSF.js";
-import "./chunk-RTUZ7MJB.js";
+} from "./chunk-SK5ZPCFM.js";
+import "./chunk-Y4UZFTIJ.js";
+import "./chunk-6ZILMWWT.js";
 import {
   Check_default,
   DeveloperError_default
-} from "./chunk-HDG3VHYL.js";
+} from "./chunk-GPIOZ7JH.js";
 import {
   defined_default
-} from "./chunk-LMTGCD6P.js";
+} from "./chunk-OSUQRKTM.js";
 
 // packages/engine/Source/Core/Intersections2D.js
 var Intersections2D = {};

package/Source/Core/Ion.js

@@ -4,7 +4,7 @@ import Resource from "./Resource.js";
 
 let defaultTokenCredit;
 const defaultAccessToken =
-  "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI4ZTlhZTM1MC1lNjM0LTRkNTQtYTE3OC02NWI0YjQ3NTAxNzgiLCJpZCI6MjU5LCJpYXQiOjE3NDg4ODUxMzV9.8mGFxgmp1QW0MIdArET4EVn5c7DKlt_HHA_Gnnu7eF4";
+  "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiIwNDljNWFmZC03MzRlLTRiMDMtYWIwMi00Yjk4YWQ4NzQwZGEiLCJpZCI6MjU5LCJpYXQiOjE3NTEzNzkyMzR9.OTqPNs3UGNnT1LYkPTavV80wN8Es_YphpJgQcpdnqWc";
 /**
  * Default settings for accessing the Cesium ion API.
  *

package/Source/Core/Resource.js

@@ -231,7 +231,7 @@ Resource.supportsImageBitmapOptions = function () {
   })
     .then(function (blob) {
       const imageBitmapOptions = {
-        imageOrientation: "flipY", // default is "none"
+        imageOrientation: "flipY", // default is "from-image"
         premultiplyAlpha: "none", // default is "default"
         colorSpaceConversion: "none", // default is "default"
       };
@@ -2036,7 +2036,7 @@ Resource.createImageBitmapFromBlob = function (blob, options) {
   );
 
   return createImageBitmap(blob, {
-    imageOrientation: options.flipY ? "flipY" : "none",
+    imageOrientation: options.flipY ? "flipY" : "from-image",
     premultiplyAlpha: options.premultiplyAlpha ? "premultiply" : "none",
     colorSpaceConversion: options.skipColorSpaceConversion ? "none" : "default",
   });

package/Source/Renderer/Texture.js

@@ -18,7 +18,9 @@ import TextureMinificationFilter from "./TextureMinificationFilter.js";
  * @typedef {object} Texture.ConstructorOptions
  *
  * @property {Context} context
- * @property {object} [source] The source for texel values to be loaded into the texture.
+ * @property {object} [source] The source for texel values to be loaded into the texture. A {@link ImageData}, {@link HTMLImageElement}, {@link HTMLCanvasElement},
+ *                        {@link HTMLVideoElement}, {@link OffscreenCanvas}, or {@link ImageBitmap},
+ *                        or an object with width, height, and arrayBufferView properties.
  * @property {PixelFormat} [pixelFormat=PixelFormat.RGBA] The format of each pixel, i.e., the number of components it has and what they represent.
  * @property {PixelDatatype} [pixelDatatype=PixelDatatype.UNSIGNED_BYTE] The data type of each pixel.
  * @property {boolean} [flipY=true] If true, the source values will be read as if the y-axis is inverted (y=0 at the top).
@@ -484,7 +486,7 @@ function loadFramebufferSource(texture, source) {
  * Load texel data from an Image into a texture.
  *
  * @param {Texture} texture The texture to which texel values will be loaded.
- * @param {ImageData|HTMLImageElement|HTMLCanvasElement|HTMLVideoElement} source The source for texel values to be loaded into the texture.
+ * @param {ImageData|HTMLImageElement|HTMLCanvasElement|HTMLVideoElement|OffscreenCanvas|ImageBitmap} source The source for texel values to be loaded into the texture.
  *
  * @private
  */
@@ -831,7 +833,8 @@ function setupSampler(texture, sampler) {
  * Copy new image data into this texture, from a source {@link ImageData}, {@link HTMLImageElement}, {@link HTMLCanvasElement}, or {@link HTMLVideoElement}.
  * or an object with width, height, and arrayBufferView properties.
  * @param {object} options Object with the following properties:
- * @param {object} options.source The source {@link ImageData}, {@link HTMLImageElement}, {@link HTMLCanvasElement}, or {@link HTMLVideoElement},
+ * @param {object} options.source The source {@link ImageData}, {@link HTMLImageElement}, {@link HTMLCanvasElement}, {@link HTMLVideoElement},
+ *                        {@link OffscreenCanvas}, or {@link ImageBitmap},
  *                        or an object with width, height, and arrayBufferView properties.
  * @param {number} [options.xOffset=0] The offset in the x direction within the texture to copy into.
  * @param {number} [options.yOffset=0] The offset in the y direction within the texture to copy into.

package/Source/Scene/ArcGisMapService.js

@@ -4,7 +4,7 @@ import Resource from "../Core/Resource.js";
 
 let defaultTokenCredit;
 const defaultAccessToken =
-  "AAPTxy8BH1VEsoebNVZXo8HurEOF051kAEKlhkOhBEc9BmTP0IZoWRBEdmOPutLUJ2JcHWgott0sjyyyJ6-Nu6O_MLmmkiswXG4qzrOMMu0N8VU2LUbsVXxF7KR041TgbHlgZPBYpt4LZXFH4jpS6NIBFm_JqZPzxLgFhbAYSs4yh_vDo1I7Qxr9dPzWiIPm5KHQ99Hs2uH4JH4356FxozccoIsuX2H4LyTBRUZ36FqFikI.AT1_FcZPNruQ";
+  "AAPTxy8BH1VEsoebNVZXo8HurEOF051kAEKlhkOhBEc9BmTvj0sIevECBw-bvZAvk8zYQRQq68aswXB6_yVObhIYNHapUAk3eqDIvpDZAUjFHpy1wJdPnkcKqSGXXGM22C1fqVC0gbU2S_RjRHuIHK5WVIYP7fUJQPjRGD1weDGyD5vBqwZX1Ah4LLUPG9474k1fvB1_vIROH9r9R-Sd9f9pbBFr9FjKfISJZiiJdaXVas4.AT1_eWrg8X2i";
 /**
  * Default options for accessing the ArcGIS image tile service.
  *

package/Source/Scene/Cesium3DTileset.js

@@ -102,6 +102,8 @@ import ImageryLayerCollection from "./ImageryLayerCollection.js";
  * @property {ClippingPlaneCollection} [clippingPlanes] The {@link ClippingPlaneCollection} used to selectively disable rendering the tileset.
  * @property {ClippingPolygonCollection} [clippingPolygons] The {@link ClippingPolygonCollection} used to selectively disable rendering the tileset.
  * @property {ClassificationType} [classificationType] Determines whether terrain, 3D Tiles or both will be classified by this tileset. See {@link Cesium3DTileset#classificationType} for details about restrictions and limitations.
+ * @property {HeightReference} [heightReference] Sets the {@link HeightReference} for point features in vector tilesets.
+ * @property {Scene} [scene] The {@link CesiumWidget#scene} that the tileset will be rendered in, required for tilesets that specify a {@link heightReference} value for clamping 3D Tiles vector data content- like points, lines, and labels- to terrain or 3D tiles.
  * @property {Ellipsoid} [ellipsoid=Ellipsoid.WGS84] The ellipsoid determining the size and shape of the globe.
  * @property {object} [pointCloudShading] Options for constructing a {@link PointCloudShading} object to control point attenuation based on geometric error and lighting.
  * @property {Cartesian3} [lightColor] The light color when shading models. When <code>undefined</code> the scene's light color is used instead.
@@ -336,6 +338,8 @@ function Cesium3DTileset(options) {
   this._tileDebugLabels = undefined;
 
   this._classificationType = options.classificationType;
+  this._heightReference = options.heightReference;
+  this._scene = options.scene;
 
   this._ellipsoid = options.ellipsoid ?? Ellipsoid.WGS84;
 
@@ -1807,6 +1811,43 @@ Object.defineProperties(Cesium3DTileset.prototype, {
     },
   },
 
+  /**
+   * Specifies if the height is relative to terrain, 3D Tiles, or both.
+   * <p>
+   * This option is only applied to point features in tilesets containing vector data.
+   * This option requires the Viewer's scene to be passed in through options.scene.
+   * </p>
+   *
+   * @memberof Cesium3DTileset.prototype
+   *
+   * @type {HeightReference | undefined}
+   * @default undefined
+   *
+   * @experimental This feature is using part of the 3D Tiles spec that is not final and is subject to change without Cesium's standard deprecation policy.
+   * @readonly
+   */
+  heightReference: {
+    get: function () {
+      return this._heightReference;
+    },
+  },
+
+  /**
+   * The {@link CesiumWidget#scene} that the tileset will be rendered in, required for tilesets that specify a {@link heightReference} value for clamping 3D Tiles vector data content- like points, lines, and labels- to terrain or 3D tiles.
+   *
+   * @member of Cesium3DTileset.prototype
+   *
+   * @type {Scene | undefined}
+   * @default undefined
+   * @readonly
+   *
+   */
+  scene: {
+    get: function () {
+      return this._scene;
+    },
+  },
+
   /**
    * Gets an ellipsoid describing the shape of the globe.
    *

package/Source/Scene/ClippingPolygonCollection.js

@@ -66,7 +66,6 @@ function ClippingPolygonCollection(options) {
   /**
    * If true, clipping will be enabled.
    *
-   * @memberof ClippingPolygonCollection.prototype
    * @type {boolean}
    * @default true
    */
@@ -77,7 +76,6 @@ function ClippingPolygonCollection(options) {
    * collection. Otherwise, a region will only be clipped if it is
    * inside of any polygon.
    *
-   * @memberof ClippingPolygonCollection.prototype
    * @type {boolean}
    * @default false
    */

package/Source/Scene/GaussianSplat3DTileContent.js

@@ -5,6 +5,8 @@ import RuntimeError from "../Core/RuntimeError.js";
 import Axis from "./Axis.js";
 import GaussianSplatPrimitive from "./GaussianSplatPrimitive.js";
 import destroyObject from "../Core/destroyObject.js";
+import ModelUtility from "./Model/ModelUtility.js";
+import VertexAttributeSemantic from "./VertexAttributeSemantic.js";
 
 /**
  * Represents the contents of a glTF or glb using the {@link https://github.com/CesiumGS/glTF/tree/draft-spz-splat-compression/extensions/2.0/Khronos/KHR_spz_gaussian_splats_compression|KHR_spz_gaussian_splats_compression} extension.
@@ -28,6 +30,17 @@ function GaussianSplat3DTileContent(loader, tileset, tile, resource) {
     });
   }
 
+  /**
+   * Original position, scale and rotation values for splats. Used to maintain
+   * consistency when multiple transforms may occur. Downstream consumers otherwise may not know
+   * the underlying data was modified.
+   * @type {undefined|Float32Array}
+   * @private
+   */
+  this._originalPositions = undefined;
+  this._originalRotations = undefined;
+  this._originalScales = undefined;
+
   /**
    * glTF primitive data that contains the Gaussian splat data needed for rendering.
    * @type {undefined|Primitive}
@@ -350,7 +363,7 @@ GaussianSplat3DTileContent.fromGltf = async function (
 
 /**
  * Updates the content of the tile and prepares it for rendering.
- * @param {Cesium3DTileset}
+ * @param {Cesium3DTileset}Data attribution
  * @param {FrameState} frameState - The current frame state.
  * @private
  */
@@ -358,11 +371,7 @@ GaussianSplat3DTileContent.prototype.update = function (primitive, frameState) {
   const loader = this._loader;
 
   if (this._ready) {
-    if (
-      !this._transformed &&
-      this._tile !== primitive.root &&
-      primitive.root.content.ready
-    ) {
+    if (!this._transformed && primitive.root.content.ready) {
       GaussianSplatPrimitive.transformTile(this._tile);
       this._transformed = true;
     }
@@ -382,6 +391,27 @@ GaussianSplat3DTileContent.prototype.update = function (primitive, frameState) {
     this.worldTransform = loader.components.scene.nodes[0].matrix;
     this._ready = true;
 
+    this._originalPositions = new Float32Array(
+      ModelUtility.getAttributeBySemantic(
+        this.splatPrimitive,
+        VertexAttributeSemantic.POSITION,
+      ).typedArray,
+    );
+
+    this._originalRotations = new Float32Array(
+      ModelUtility.getAttributeBySemantic(
+        this.splatPrimitive,
+        VertexAttributeSemantic.ROTATION,
+      ).typedArray,
+    );
+
+    this._originalScales = new Float32Array(
+      ModelUtility.getAttributeBySemantic(
+        this.splatPrimitive,
+        VertexAttributeSemantic.SCALE,
+      ).typedArray,
+    );
+
     return;
   }
 

package/Source/Scene/GaussianSplatPrimitive.js

@@ -29,7 +29,6 @@ import AttributeType from "./AttributeType.js";
 import ModelComponents from "./ModelComponents.js";
 import Axis from "./Axis.js";
 import Cartesian3 from "../Core/Cartesian3.js";
-import Transforms from "../Core/Transforms.js";
 import Quaternion from "../Core/Quaternion.js";
 import SplitDirection from "./SplitDirection.js";
 import destroyObject from "../Core/destroyObject.js";
@@ -438,27 +437,31 @@ GaussianSplatPrimitive.transformTile = function (tile) {
     computedModelMatrix,
   );
 
-  const center = tile.tileset.boundingSphere.center;
-  const toGlobal = Transforms.eastNorthUpToFixedFrame(center);
-  const toLocal = Matrix4.inverse(toGlobal, scratchMatrix4B);
-
+  const toGlobal = Matrix4.multiply(
+    tile.tileset.modelMatrix,
+    Matrix4.fromArray(tile.tileset.root.transform),
+    scratchMatrix4B,
+  );
+  const toLocal = Matrix4.inverse(toGlobal, scratchMatrix4C);
   const transform = Matrix4.multiplyTransformation(
     toLocal,
     computedModelMatrix,
     scratchMatrix4A,
   );
-
-  const positions = ModelUtility.getAttributeBySemantic(
+  const positions = tile.content._originalPositions;
+  const rotations = tile.content._originalRotations;
+  const scales = tile.content._originalScales;
+  const attributePositions = ModelUtility.getAttributeBySemantic(
     splatPrimitive,
     VertexAttributeSemantic.POSITION,
   ).typedArray;
 
-  const rotations = ModelUtility.getAttributeBySemantic(
+  const attributeRotations = ModelUtility.getAttributeBySemantic(
     splatPrimitive,
     VertexAttributeSemantic.ROTATION,
   ).typedArray;
 
-  const scales = ModelUtility.getAttributeBySemantic(
+  const attributeScales = ModelUtility.getAttributeBySemantic(
     splatPrimitive,
     VertexAttributeSemantic.SCALE,
   ).typedArray;
@@ -493,18 +496,18 @@ GaussianSplatPrimitive.transformTile = function (tile) {
     Matrix4.getRotation(scratchMatrix4C, rotation);
     Matrix4.getScale(scratchMatrix4C, scale);
 
-    positions[i * 3] = position.x;
-    positions[i * 3 + 1] = position.y;
-    positions[i * 3 + 2] = position.z;
+    attributePositions[i * 3] = position.x;
+    attributePositions[i * 3 + 1] = position.y;
+    attributePositions[i * 3 + 2] = position.z;
 
-    rotations[i * 4] = rotation.x;
-    rotations[i * 4 + 1] = rotation.y;
-    rotations[i * 4 + 2] = rotation.z;
-    rotations[i * 4 + 3] = rotation.w;
+    attributeRotations[i * 4] = rotation.x;
+    attributeRotations[i * 4 + 1] = rotation.y;
+    attributeRotations[i * 4 + 2] = rotation.z;
+    attributeRotations[i * 4 + 3] = rotation.w;
 
-    scales[i * 3] = scale.x;
-    scales[i * 3 + 1] = scale.y;
-    scales[i * 3 + 2] = scale.z;
+    attributeScales[i * 3] = scale.x;
+    attributeScales[i * 3 + 1] = scale.y;
+    attributeScales[i * 3 + 2] = scale.z;
   }
 };
 
@@ -706,8 +709,11 @@ GaussianSplatPrimitive.buildGSplatDrawCommand = function (
 
   primitive._vertexArrayLen = primitive._indexes.length;
 
-  const center = tileset.boundingSphere.center;
-  const modelMatrix = Transforms.eastNorthUpToFixedFrame(center);
+  const modelMatrix = Matrix4.multiply(
+    tileset.modelMatrix,
+    Matrix4.fromArray(tileset.root.transform),
+    scratchMatrix4B,
+  );
 
   const command = new DrawCommand({
     boundingVolume: tileset.boundingSphere,
@@ -751,6 +757,11 @@ GaussianSplatPrimitive.prototype.update = function (frameState) {
     frameState.commandList.push(this._drawCommand);
   }
 
+  if (tileset._modelMatrixChanged) {
+    this._dirty = true;
+    return;
+  }
+
   if (frameState.passes.pick === true) {
     return;
   }

package/Source/Scene/Material.js

@@ -914,7 +914,9 @@ function createTexture2DUpdateFunction(uniformId) {
           });
       } else if (
         uniformValue instanceof HTMLCanvasElement ||
-        uniformValue instanceof HTMLImageElement
+        uniformValue instanceof HTMLImageElement ||
+        uniformValue instanceof ImageBitmap ||
+        uniformValue instanceof OffscreenCanvas
       ) {
         material._loadedImages.push({
           id: uniformId,
@@ -1091,7 +1093,9 @@ function getUniformType(uniformValue) {
       type === "string" ||
       uniformValue instanceof Resource ||
       uniformValue instanceof HTMLCanvasElement ||
-      uniformValue instanceof HTMLImageElement
+      uniformValue instanceof HTMLImageElement ||
+      uniformValue instanceof ImageBitmap ||
+      uniformValue instanceof OffscreenCanvas
     ) {
       if (/^([rgba]){1,4}$/i.test(uniformValue)) {
         uniformType = "channels";

package/Source/Scene/Model/UniformType.js

@@ -106,7 +106,7 @@ const UniformType = {
    */
   MAT3: "mat3",
   /**
-   * A 3x3 matrix of floating point values.
+   * A 4x4 matrix of floating point values.
    *
    * @type {string}
    * @constant

package/Source/Scene/Vector3DTileContent.js

@@ -524,7 +524,7 @@ function initialize(content, arrayBuffer, byteOffset) {
       modelMatrix: modelMatrix,
     });
   }
-
+  const tileset = content._tileset;
   if (numberOfPolylines > 0) {
     featureTable.featuresLength = numberOfPolylines;
 
@@ -570,7 +570,6 @@ function initialize(content, arrayBuffer, byteOffset) {
     );
     byteOffset += polylinePositionByteLength;
 
-    const tileset = content._tileset;
     const examineVectorLinesFunction = tileset.examineVectorLinesFunction;
     if (defined(examineVectorLinesFunction)) {
       const decodedPositions = decodeVectorPolylinePositions(
@@ -625,6 +624,8 @@ function initialize(content, arrayBuffer, byteOffset) {
       maximumHeight: maxHeight,
       rectangle: rectangle,
       batchTable: batchTable,
+      heightReference: tileset.heightReference,
+      scene: tileset.scene,
     });
   }
 }

package/Source/Scene/Vector3DTilePoints.js

@@ -15,6 +15,7 @@ import LabelCollection from "./LabelCollection.js";
 import LabelStyle from "./LabelStyle.js";
 import PolylineCollection from "./PolylineCollection.js";
 import VerticalOrigin from "./VerticalOrigin.js";
+import HeightReference from "./HeightReference.js";
 
 /**
  * Creates a batch of points or billboards and labels.
@@ -27,8 +28,10 @@ import VerticalOrigin from "./VerticalOrigin.js";
  * @param {number} options.minimumHeight The minimum height of the terrain covered by the tile.
  * @param {number} options.maximumHeight The maximum height of the terrain covered by the tile.
  * @param {Rectangle} options.rectangle The rectangle containing the tile.
+ * @param {HeightReference} options.heightReference Determines how billboard and label features are positioned relative to terrain or 3d tiles.
  * @param {Cesium3DTileBatchTable} options.batchTable The batch table for the tile containing the batched polygons.
  * @param {Uint16Array} options.batchIds The batch ids for each polygon.
+ * @param {Scene} options.scene  The Cesium Viewer {@link Scene}. This is required for clamping billboards and labels with {@link HeightReference}
  *
  * @private
  */
@@ -42,12 +45,15 @@ function Vector3DTilePoints(options) {
   this._rectangle = options.rectangle;
   this._minHeight = options.minimumHeight;
   this._maxHeight = options.maximumHeight;
+  this._heightReference = options.heightReference;
 
   this._billboardCollection = new BillboardCollection({
     batchTable: options.batchTable,
+    scene: options.scene,
   });
   this._labelCollection = new LabelCollection({
     batchTable: options.batchTable,
+    scene: options.scene,
   });
   this._polylineCollection = new PolylineCollection();
   this._polylineCollection._useHighlightColor = true;
@@ -175,6 +181,8 @@ function createPoints(points, ellipsoid) {
       const batchIds = points._batchIds;
       const numberOfPoints = positions.length / 3;
 
+      const heightReference = points._heightReference ?? HeightReference.NONE;
+
       for (let i = 0; i < numberOfPoints; ++i) {
         const id = batchIds[i];
 
@@ -183,11 +191,13 @@ function createPoints(points, ellipsoid) {
         const b = billboardCollection.add();
         b.position = position;
         b._batchIndex = id;
+        b.heightReference = heightReference;
 
         const l = labelCollection.add();
         l.text = " ";
         l.position = position;
         l._batchIndex = id;
+        l.heightReference = heightReference;
 
         const p = polylineCollection.add();
         p.positions = [Cartesian3.clone(position), Cartesian3.clone(position)];

package/Source/Shaders/Voxels/convertUvToCylinder.glsl

@@ -38,7 +38,7 @@ PointJacobianT convertUvToShapeSpaceDerivative(in vec3 positionUv) {
     vec3 east = normalize(vec3(-position.y, position.x, 0.0));
 
     vec3 point = vec3(radius, angle, height);
-    mat3 jacobianT = mat3(radial, z, east / length(position.xy));
+    mat3 jacobianT = mat3(radial, east / length(position.xy), z);
     return PointJacobianT(point, jacobianT);
 }
 

package/Source/Shaders/Voxels/convertUvToCylinder.js

@@ -39,7 +39,7 @@ PointJacobianT convertUvToShapeSpaceDerivative(in vec3 positionUv) {\n\
     vec3 east = normalize(vec3(-position.y, position.x, 0.0));\n\
 \n\
     vec3 point = vec3(radius, angle, height);\n\
-    mat3 jacobianT = mat3(radial, z, east / length(position.xy));\n\
+    mat3 jacobianT = mat3(radial, east / length(position.xy), z);\n\
     return PointJacobianT(point, jacobianT);\n\
 }\n\
 \n\