@cesium/engine 9.2.0 → 10.1.0

package/Source/Scene/Globe.js

@@ -28,6 +28,7 @@ import ImageryLayerCollection from "./ImageryLayerCollection.js";
 import QuadtreePrimitive from "./QuadtreePrimitive.js";
 import SceneMode from "./SceneMode.js";
 import ShadowMode from "./ShadowMode.js";
+import CesiumMath from "../Core/Math.js";
 
 /**
  * The globe rendered in the scene, including its terrain ({@link Globe#terrainProvider})
@@ -36,11 +37,11 @@ import ShadowMode from "./ShadowMode.js";
  * @alias Globe
  * @constructor
  *
- * @param {Ellipsoid} [ellipsoid=Ellipsoid.WGS84] Determines the size and shape of the
+ * @param {Ellipsoid} [ellipsoid=Ellipsoid.default] Determines the size and shape of the
  * globe.
  */
 function Globe(ellipsoid) {
-  ellipsoid = defaultValue(ellipsoid, Ellipsoid.WGS84);
+  ellipsoid = defaultValue(ellipsoid, Ellipsoid.default);
   const terrainProvider = new EllipsoidTerrainProvider({
     ellipsoid: ellipsoid,
   });
@@ -191,9 +192,9 @@ function Globe(ellipsoid) {
    * Enable the ground atmosphere, which is drawn over the globe when viewed from a distance between <code>lightingFadeInDistance</code> and <code>lightingFadeOutDistance</code>.
    *
    * @type {boolean}
-   * @default true
+   * @default true when using the WGS84 ellipsoid, false otherwise
    */
-  this.showGroundAtmosphere = true;
+  this.showGroundAtmosphere = Ellipsoid.WGS84.equals(ellipsoid);
 
   /**
    * The intensity of the light that is used for computing the ground atmosphere color.
@@ -250,18 +251,19 @@ function Globe(ellipsoid) {
    * when <code>enableLighting</code> or <code>showGroundAtmosphere</code> is <code>true</code>.
    *
    * @type {number}
-   * @default 10000000.0
+   * @default 1/2 * pi * ellipsoid.minimumRadius
    */
-  this.lightingFadeOutDistance = 1.0e7;
+  this.lightingFadeOutDistance =
+    CesiumMath.PI_OVER_TWO * ellipsoid.minimumRadius;
 
   /**
    * The distance where lighting resumes. This only takes effect
    * when <code>enableLighting</code> or <code>showGroundAtmosphere</code> is <code>true</code>.
    *
    * @type {number}
-   * @default 20000000.0
+   * @default pi * ellipsoid.minimumRadius
    */
-  this.lightingFadeInDistance = 2.0e7;
+  this.lightingFadeInDistance = CesiumMath.PI * ellipsoid.minimumRadius;
 
   /**
    * The distance where the darkness of night from the ground atmosphere fades out to a lit ground atmosphere.
@@ -269,9 +271,9 @@ function Globe(ellipsoid) {
    * <code>dynamicAtmosphereLighting</code> are <code>true</code>.
    *
    * @type {number}
-   * @default 10000000.0
+   * @default 1/2 * pi * ellipsoid.minimumRadius
    */
-  this.nightFadeOutDistance = 1.0e7;
+  this.nightFadeOutDistance = CesiumMath.PI_OVER_TWO * ellipsoid.minimumRadius;
 
   /**
    * The distance where the darkness of night from the ground atmosphere fades in to an unlit ground atmosphere.
@@ -279,9 +281,10 @@ function Globe(ellipsoid) {
    * <code>dynamicAtmosphereLighting</code> are <code>true</code>.
    *
    * @type {number}
-   * @default 50000000.0
+   * @default 5/2 * pi * ellipsoid.minimumRadius
    */
-  this.nightFadeInDistance = 5.0e7;
+  this.nightFadeInDistance =
+    5.0 * CesiumMath.PI_OVER_TWO * ellipsoid.minimumRadius;
 
   /**
    * True if an animated wave effect should be shown in areas of the globe
@@ -809,7 +812,7 @@ Globe.prototype.pick = function (ray, scene, result) {
   if (defined(result) && scene.mode !== SceneMode.SCENE3D) {
     result = Cartesian3.fromElements(result.y, result.z, result.x, result);
     const carto = scene.mapProjection.unproject(result, cartoScratch);
-    result = scene.globe.ellipsoid.cartographicToCartesian(carto, result);
+    result = this._ellipsoid.cartographicToCartesian(carto, result);
   }
 
   return result;

package/Source/Scene/GltfLoaderUtil.js

@@ -142,10 +142,7 @@ GltfLoaderUtil.createModelTextureReader = function (options) {
   let texCoord = defaultValue(textureInfo.texCoord, 0);
   let transform;
 
-  const textureTransform = defaultValue(
-    textureInfo.extensions,
-    defaultValue.EMPTY_OBJECT
-  ).KHR_texture_transform;
+  const textureTransform = textureInfo.extensions?.KHR_texture_transform;
 
   if (defined(textureTransform)) {
     texCoord = defaultValue(textureTransform.texCoord, texCoord);
@@ -177,6 +174,7 @@ GltfLoaderUtil.createModelTextureReader = function (options) {
   modelTextureReader.index = textureInfo.index;
   modelTextureReader.texture = texture;
   modelTextureReader.texCoord = texCoord;
+  modelTextureReader.scale = textureInfo.scale;
   modelTextureReader.transform = transform;
   modelTextureReader.channels = channels;
 

package/Source/Scene/GoogleEarthEnterpriseImageryProvider.js

@@ -45,7 +45,7 @@ GoogleEarthEnterpriseDiscardPolicy.prototype.shouldDiscardImage = function (
  *
  * Initialization options for the GoogleEarthEnterpriseImageryProvider constructor
  *
- * @property {Ellipsoid} [ellipsoid] The ellipsoid.  If not specified, the WGS84 ellipsoid is used.
+ * @property {Ellipsoid} [ellipsoid=Ellipsoid.default] The ellipsoid.  If not specified, the default ellipsoid is used.
  * @property {TileDiscardPolicy} [tileDiscardPolicy] The policy that determines if a tile
  *        is invalid and should be discarded. If this value is not specified, a default
  *        is to discard tiles that fail to download.

package/Source/Scene/GoogleEarthEnterpriseMapsProvider.js

@@ -41,7 +41,7 @@ import ImageryProvider from "./ImageryProvider.js";
  * @property {TileDiscardPolicy} [tileDiscardPolicy] The policy that determines if a tile
  *        is invalid and should be discarded. To ensure that no tiles are discarded, construct and pass
  *        a {@link NeverTileDiscardPolicy} for this parameter.
- * @property {Ellipsoid} [ellipsoid] The ellipsoid.  If not specified, the WGS84 ellipsoid is used.
+ * @property {Ellipsoid} [ellipsoid=Ellipsoid.default] The ellipsoid.  If not specified, the default ellipsoid is used.
  */
 
 /**

package/Source/Scene/GridImageryProvider.js

@@ -14,9 +14,9 @@ const defaultBackgroundColor = new Color(0.0, 0.5, 0.0, 0.2);
  * Initialization options for the GridImageryProvider constructor
  *
  * @property {TilingScheme} [tilingScheme=new GeographicTilingScheme()] The tiling scheme for which to draw tiles.
- * @property {Ellipsoid} [ellipsoid] The ellipsoid.  If the tilingScheme is specified,
+ * @property {Ellipsoid} [ellipsoid=Ellipsoid.default] The ellipsoid.  If the tilingScheme is specified,
  *                    this parameter is ignored and the tiling scheme's ellipsoid is used instead. If neither
- *                    parameter is specified, the WGS84 ellipsoid is used.
+ *                    parameter is specified, the default ellipsoid is used.
  * @property {number} [cells=8] The number of grids cells.
  * @property {Color} [color=Color(1.0, 1.0, 1.0, 0.4)] The color to draw grid lines.
  * @property {Color} [glowColor=Color(0.0, 1.0, 0.0, 0.05)] The color to draw glow for grid lines.

package/Source/Scene/ImageBasedLighting.js

@@ -186,8 +186,8 @@ Object.defineProperties(ImageBasedLighting.prototype, {
    * </p>
    *
    * These values can be obtained by preprocessing the environment map using the <code>cmgen</code> tool of
-   * {@link https://github.com/google/filament/releases|Google's Filament project}. This will also generate a KTX file that can be
-   * supplied to {@link Model#specularEnvironmentMaps}.
+   * {@link https://github.com/google/filament/releases|Google's Filament project}.
+   * Be sure to use the <code>--no-mirror</code> option in <code>cmgen</code>.
    *
    * @memberof ImageBasedLighting.prototype
    *

package/Source/Scene/ImageryLayerCollection.js

@@ -436,7 +436,7 @@ ImageryLayerCollection.prototype.pickImageryLayers = function (ray, scene) {
     return;
   }
 
-  const pickedLocation = scene.globe.ellipsoid.cartesianToCartographic(
+  const pickedLocation = scene.ellipsoid.cartesianToCartographic(
     pickedPosition
   );
 
@@ -491,7 +491,7 @@ ImageryLayerCollection.prototype.pickImageryLayerFeatures = function (
     return;
   }
 
-  const pickedLocation = scene.globe.ellipsoid.cartesianToCartographic(
+  const pickedLocation = scene.ellipsoid.cartesianToCartographic(
     pickedPosition
   );
 

package/Source/Scene/MapboxImageryProvider.js

@@ -19,7 +19,7 @@ const defaultCredit = new Credit(
  * @property {string} mapId The Mapbox Map ID.
  * @property {string} accessToken The public access token for the imagery.
  * @property {string} [format='png'] The format of the image request.
- * @property {Ellipsoid} [ellipsoid] The ellipsoid.  If not specified, the WGS84 ellipsoid is used.
+ * @property {Ellipsoid} [ellipsoid=Ellipsoid.default] The ellipsoid.  If not specified, the default ellipsoid is used.
  * @property {number} [minimumLevel=0] The minimum level-of-detail supported by the imagery provider.  Take care when specifying
  *                 this that the number of tiles at the minimum level is small, such as four or less.  A larger number is likely
  *                 to result in rendering problems.

package/Source/Scene/MapboxStyleImageryProvider.js

@@ -21,7 +21,7 @@ const defaultCredit = new Credit(
  * @property {string} accessToken The public access token for the imagery.
  * @property {number} [tilesize=512] The size of the image tiles.
  * @property {boolean} [scaleFactor] Determines if tiles are rendered at a @2x scale factor.
- * @property {Ellipsoid} [ellipsoid] The ellipsoid.  If not specified, the WGS84 ellipsoid is used.
+ * @property {Ellipsoid} [ellipsoid=Ellipsoid.default] The ellipsoid.  If not specified, the default ellipsoid is used.
  * @property {number} [minimumLevel=0] The minimum level-of-detail supported by the imagery provider.  Take care when specifying
  *                 this that the number of tiles at the minimum level is small, such as four or less.  A larger number is likely
  *                 to result in rendering problems.

package/Source/Scene/MetadataSemantic.js

@@ -65,7 +65,7 @@ const MetadataSemantic = {
    */
   TILE_BOUNDING_SPHERE: "TILE_BOUNDING_SPHERE",
   /**
-   * The minimum height of a tile above (or below) the WGS84 ellipsoid, stored as a <code>FLOAT32</code> or a <code>FLOAT64</code>. This semantic is used to tighten bounding regions implicitly calculated in implicit tiling.
+   * The minimum height of a tile above (or below) the ellipsoid, stored as a <code>FLOAT32</code> or a <code>FLOAT64</code>. This semantic is used to tighten bounding regions implicitly calculated in implicit tiling.
    *
    * @type {string}
    * @constant
@@ -73,7 +73,7 @@ const MetadataSemantic = {
    */
   TILE_MINIMUM_HEIGHT: "TILE_MINIMUM_HEIGHT",
   /**
-   * The maximum height of a tile above (or below) the WGS84 ellipsoid, stored as a <code>FLOAT32</code> or a <code>FLOAT64</code>. This semantic is used to tighten bounding regions implicitly calculated in implicit tiling.
+   * The maximum height of a tile above (or below) the ellipsoid, stored as a <code>FLOAT32</code> or a <code>FLOAT64</code>. This semantic is used to tighten bounding regions implicitly calculated in implicit tiling.
    *
    * @type {string}
    * @constant
@@ -123,7 +123,7 @@ const MetadataSemantic = {
    */
   CONTENT_BOUNDING_SPHERE: "CONTENT_BOUNDING_SPHERE",
   /**
-   * The minimum height of the content of a tile above (or below) the WGS84 ellipsoid, stored as a <code>FLOAT32</code> or a <code>FLOAT64</code>
+   * The minimum height of the content of a tile above (or below) the ellipsoid, stored as a <code>FLOAT32</code> or a <code>FLOAT64</code>
    *
    * @type {string}
    * @constant
@@ -131,7 +131,7 @@ const MetadataSemantic = {
    */
   CONTENT_MINIMUM_HEIGHT: "CONTENT_MINIMUM_HEIGHT",
   /**
-   * The maximum height of the content of a tile above (or below) the WGS84 ellipsoid, stored as a <code>FLOAT32</code> or a <code>FLOAT64</code>
+   * The maximum height of the content of a tile above (or below) the ellipsoid, stored as a <code>FLOAT32</code> or a <code>FLOAT64</code>
    *
    * @type {string}
    * @constant

package/Source/Scene/Model/InstancingPipelineStage.js

@@ -276,7 +276,7 @@ function projectPositionTo2D(
     projectedPositionScratch
   );
 
-  result = SceneTransforms.computeActualWgs84Position(
+  result = SceneTransforms.computeActualEllipsoidPosition(
     frameState,
     finalPosition,
     result
@@ -432,7 +432,7 @@ function computeReferencePoint2D(renderResources, frameState) {
     scratchProjectedMin
   );
 
-  const projectedMin = SceneTransforms.computeActualWgs84Position(
+  const projectedMin = SceneTransforms.computeActualEllipsoidPosition(
     frameState,
     transformedPositionMin,
     transformedPositionMin
@@ -444,7 +444,7 @@ function computeReferencePoint2D(renderResources, frameState) {
     scratchProjectedMax
   );
 
-  const projectedMax = SceneTransforms.computeActualWgs84Position(
+  const projectedMax = SceneTransforms.computeActualEllipsoidPosition(
     frameState,
     transformedPositionMax,
     transformedPositionMax

package/Source/Scene/Model/MaterialPipelineStage.js

@@ -216,6 +216,44 @@ function processTextureTransform(
   };
 }
 
+/**
+ * Process a single texture scale and add it to the shader and uniform map.
+ *
+ * @param {ShaderBuilder} shaderBuilder The shader builder to modify
+ * @param {Object<string, Function>} uniformMap The uniform map to modify.
+ * @param {ModelComponents.TextureReader} textureReader The texture to add to the shader
+ * @param {string} uniformName The name of the sampler uniform such as <code>u_baseColorTexture</code>
+ * @param {string} defineName The name of the texture for use in the defines, minus any prefix or suffix. For example, "BASE_COLOR" or "EMISSIVE"
+ *
+ * @private
+ */
+function processTextureScale(
+  shaderBuilder,
+  uniformMap,
+  textureReader,
+  uniformName,
+  defineName
+) {
+  // Add a define to enable the texture transformation code in the shader.
+  const transformDefine = `HAS_${defineName}_TEXTURE_SCALE`;
+  shaderBuilder.addDefine(
+    transformDefine,
+    undefined,
+    ShaderDestination.FRAGMENT
+  );
+
+  // Add a uniform for the transformation matrix
+  const scaleUniformName = `${uniformName}Scale`;
+  shaderBuilder.addUniform(
+    "float",
+    scaleUniformName,
+    ShaderDestination.FRAGMENT
+  );
+  uniformMap[scaleUniformName] = function () {
+    return textureReader.scale;
+  };
+}
+
 /**
  * Process a single texture and add it to the shader and uniform map.
  *
@@ -274,6 +312,17 @@ function processTexture(
       defineName
     );
   }
+
+  const { scale } = textureReader;
+  if (defined(scale) && scale !== 1.0) {
+    processTextureScale(
+      shaderBuilder,
+      uniformMap,
+      textureReader,
+      uniformName,
+      defineName
+    );
+  }
 }
 
 function processMaterialUniforms(

package/Source/Scene/Model/Model.js

@@ -2123,8 +2123,7 @@ function updateClamping(model) {
     return;
   }
 
-  const globe = scene.globe;
-  const ellipsoid = defaultValue(globe?.ellipsoid, Ellipsoid.WGS84);
+  const ellipsoid = defaultValue(scene.ellipsoid, Ellipsoid.default);
 
   // Compute cartographic position so we don't recompute every update
   const modelMatrix = model.modelMatrix;
@@ -2206,7 +2205,7 @@ function updateComputedScale(model, modelMatrix, frameState) {
     Matrix4.getTranslation(modelMatrix, scratchPosition);
 
     if (model._sceneMode !== SceneMode.SCENE3D) {
-      SceneTransforms.computeActualWgs84Position(
+      SceneTransforms.computeActualEllipsoidPosition(
         frameState,
         scratchPosition,
         scratchPosition
@@ -2252,7 +2251,7 @@ function updatePickIds(model) {
 
 // Matrix3 is a row-major constructor.
 // The same constructor in GLSL will produce the transpose of this.
-const yUpToZUp = new Matrix3(-1, 0, 0, 0, 0, 1, 0, -1, 0);
+const yUpToZUp = new Matrix3(1, 0, 0, 0, 0, 1, 0, -1, 0);
 
 function updateReferenceMatrices(model, frameState) {
   const modelMatrix = defined(model._clampedModelMatrix)
@@ -2465,7 +2464,11 @@ function passesDistanceDisplayCondition(model, frameState) {
 
     // This will project the position if the scene is in Columbus View,
     // but leave the position as-is in 3D mode.
-    SceneTransforms.computeActualWgs84Position(frameState, position, position);
+    SceneTransforms.computeActualEllipsoidPosition(
+      frameState,
+      position,
+      position
+    );
 
     distanceSquared = Cartesian3.distanceSquared(
       position,

package/Source/Scene/Model/ModelSceneGraph.js

@@ -351,7 +351,7 @@ function computeModelMatrix2D(sceneGraph, frameState) {
     );
   } else {
     const center = sceneGraph.boundingSphere.center;
-    const to2D = Transforms.wgs84To2DModelMatrix(
+    const to2D = Transforms.ellipsoidTo2DModelMatrix(
       frameState.mapProjection,
       center,
       sceneGraph._computedModelMatrix2D

package/Source/Scene/Model/SceneMode2DPipelineStage.js

@@ -145,7 +145,7 @@ function computeBoundingSphere2D(renderResources, modelMatrix, frameState) {
     scratchProjectedMin
   );
 
-  const projectedMin = SceneTransforms.computeActualWgs84Position(
+  const projectedMin = SceneTransforms.computeActualEllipsoidPosition(
     frameState,
     transformedPositionMin,
     transformedPositionMin
@@ -157,7 +157,7 @@ function computeBoundingSphere2D(renderResources, modelMatrix, frameState) {
     scratchProjectedMax
   );
 
-  const projectedMax = SceneTransforms.computeActualWgs84Position(
+  const projectedMax = SceneTransforms.computeActualEllipsoidPosition(
     frameState,
     transformedPositionMax,
     transformedPositionMax
@@ -244,7 +244,7 @@ function createPositionsTypedArrayFor2D(
       initialPosition
     );
 
-    const projectedPosition = SceneTransforms.computeActualWgs84Position(
+    const projectedPosition = SceneTransforms.computeActualEllipsoidPosition(
       frameState,
       transformedPosition,
       transformedPosition

package/Source/Scene/Model/pickModel.js

@@ -35,7 +35,7 @@ const scratchBoundingSphere = new BoundingSphere();
  * @param {FrameState} frameState The frame state.
  * @param {number} [verticalExaggeration=1.0] A scalar used to exaggerate the height of a position relative to the ellipsoid. If the value is 1.0 there will be no effect.
  * @param {number} [relativeHeight=0.0] The ellipsoid height relative to which a position is exaggerated. If the value is 0.0 the position will be exaggerated relative to the ellipsoid surface.
- * @param {Ellipsoid} [ellipsoid=Ellipsoid.WGS84] The ellipsoid to which the exaggerated position is relative.
+ * @param {Ellipsoid} [ellipsoid=Ellipsoid.default] The ellipsoid to which the exaggerated position is relative.
  * @param {Cartesian3|undefined} [result] The intersection or <code>undefined</code> if none was found.
  * @returns {Cartesian3|undefined} The intersection or <code>undefined</code> if none was found.
  *
@@ -280,7 +280,7 @@ export default function pickModel(
         return;
       }
 
-      ellipsoid = defaultValue(ellipsoid, Ellipsoid.WGS84);
+      ellipsoid = defaultValue(ellipsoid, Ellipsoid.default);
       verticalExaggeration = defaultValue(verticalExaggeration, 1.0);
       relativeHeight = defaultValue(relativeHeight, 0.0);
 

package/Source/Scene/ModelComponents.js

@@ -1187,6 +1187,15 @@ function TextureReader() {
    */
   this.transform = Matrix3.clone(Matrix3.IDENTITY);
 
+  /**
+   * Scale to apply to texture values.
+   *
+   * @type {number}
+   * @default 1.0
+   * @private
+   */
+  this.scale = 1.0;
+
   /**
    * The texture channels to read from. When undefined all channels are read.
    *

package/Source/Scene/OctahedralProjectedCubeMap.js

@@ -337,11 +337,10 @@ OctahedralProjectedCubeMap.prototype.update = function (frameState) {
     },
   });
 
-  // We only need up to 6 mip levels to avoid artifacts.
-  const length = Math.min(cubeMapBuffers.length, 6);
-  this._maximumMipmapLevel = length - 1;
-  const cubeMaps = (this._cubeMaps = new Array(length));
-  const mipTextures = (this._mipTextures = new Array(length));
+  const mipLevels = cubeMapBuffers.length;
+  this._maximumMipmapLevel = mipLevels - 1;
+  const cubeMaps = (this._cubeMaps = new Array(mipLevels));
+  const mipTextures = (this._mipTextures = new Array(mipLevels));
   const originalSize = cubeMapBuffers[0].positiveX.width * 2.0;
   const uniformMap = {
     originalSize: function () {
@@ -350,7 +349,7 @@ OctahedralProjectedCubeMap.prototype.update = function (frameState) {
   };
 
   // First we project each cubemap onto a flat octahedron, and write that to a texture.
-  for (let i = 0; i < length; ++i) {
+  for (let i = 0; i < mipLevels; ++i) {
     // Swap +Y/-Y faces since the octahedral projection expects this order.
     const positiveY = cubeMapBuffers[i].positiveY;
     cubeMapBuffers[i].positiveY = cubeMapBuffers[i].negativeY;

package/Source/Scene/Picking.js

@@ -525,7 +525,7 @@ Picking.prototype.pickPositionWorldCoordinates = function (
         uniformState.updateFrustum(frustum);
       }
 
-      result = SceneTransforms.drawingBufferToWgs84Coordinates(
+      result = SceneTransforms.drawingBufferToWorldCoordinates(
         scene,
         drawingBufferPosition,
         depth,
@@ -1112,10 +1112,7 @@ const scratchSurfaceRay = new Ray();
 const scratchCartographic = new Cartographic();
 
 function getRayForSampleHeight(scene, cartographic) {
-  const globe = scene.globe;
-  const ellipsoid = defined(globe)
-    ? globe.ellipsoid
-    : scene.mapProjection.ellipsoid;
+  const ellipsoid = scene.ellipsoid;
   const height = ApproximateTerrainHeights._defaultMaxTerrainHeight;
   const surfaceNormal = ellipsoid.geodeticSurfaceNormalCartographic(
     cartographic,
@@ -1136,10 +1133,7 @@ function getRayForSampleHeight(scene, cartographic) {
 }
 
 function getRayForClampToHeight(scene, cartesian) {
-  const globe = scene.globe;
-  const ellipsoid = defined(globe)
-    ? globe.ellipsoid
-    : scene.mapProjection.ellipsoid;
+  const ellipsoid = scene.ellipsoid;
   const cartographic = Cartographic.fromCartesian(
     cartesian,
     ellipsoid,
@@ -1149,10 +1143,7 @@ function getRayForClampToHeight(scene, cartesian) {
 }
 
 function getHeightFromCartesian(scene, cartesian) {
-  const globe = scene.globe;
-  const ellipsoid = defined(globe)
-    ? globe.ellipsoid
-    : scene.mapProjection.ellipsoid;
+  const ellipsoid = scene.ellipsoid;
   const cartographic = Cartographic.fromCartesian(
     cartesian,
     ellipsoid,

package/Source/Scene/PointPrimitive.js

@@ -11,6 +11,7 @@ import Matrix4 from "../Core/Matrix4.js";
 import NearFarScalar from "../Core/NearFarScalar.js";
 import SceneMode from "./SceneMode.js";
 import SceneTransforms from "./SceneTransforms.js";
+import SplitDirection from "./SplitDirection.js";
 
 /**
  * <div class="notice">
@@ -117,6 +118,11 @@ function PointPrimitive(options, pointPrimitiveCollection) {
   this._pointPrimitiveCollection = pointPrimitiveCollection;
   this._dirty = false;
   this._index = -1; //Used only by PointPrimitiveCollection
+
+  this._splitDirection = defaultValue(
+    options.splitDirection,
+    SplitDirection.NONE
+  );
 }
 
 const SHOW_INDEX = (PointPrimitive.SHOW_INDEX = 0);
@@ -129,7 +135,8 @@ const SCALE_BY_DISTANCE_INDEX = (PointPrimitive.SCALE_BY_DISTANCE_INDEX = 6);
 const TRANSLUCENCY_BY_DISTANCE_INDEX = (PointPrimitive.TRANSLUCENCY_BY_DISTANCE_INDEX = 7);
 const DISTANCE_DISPLAY_CONDITION_INDEX = (PointPrimitive.DISTANCE_DISPLAY_CONDITION_INDEX = 8);
 const DISABLE_DEPTH_DISTANCE_INDEX = (PointPrimitive.DISABLE_DEPTH_DISTANCE_INDEX = 9);
-PointPrimitive.NUMBER_OF_PROPERTIES = 10;
+const SPLIT_DIRECTION_INDEX = (PointPrimitive.SPLIT_DIRECTION_INDEX = 10);
+PointPrimitive.NUMBER_OF_PROPERTIES = 11;
 
 function makeDirty(pointPrimitive, propertyChanged) {
   const pointPrimitiveCollection = pointPrimitive._pointPrimitiveCollection;
@@ -486,6 +493,24 @@ Object.defineProperties(PointPrimitive.prototype, {
       }
     },
   },
+
+  /**
+   * The {@link SplitDirection} to apply to this point.
+   * @memberof PointPrimitive.prototype
+   * @type {SplitDirection}
+   * @default {@link SplitDirection.NONE}
+   */
+  splitDirection: {
+    get: function () {
+      return this._splitDirection;
+    },
+    set: function (value) {
+      if (this._splitDirection !== value) {
+        this._splitDirection = value;
+        makeDirty(this, SPLIT_DIRECTION_INDEX);
+      }
+    },
+  },
 });
 
 PointPrimitive.prototype.getPickId = function (context) {
@@ -520,7 +545,10 @@ PointPrimitive._computeActualPosition = function (
   }
 
   Matrix4.multiplyByPoint(modelMatrix, position, tempCartesian3);
-  return SceneTransforms.computeActualWgs84Position(frameState, tempCartesian3);
+  return SceneTransforms.computeActualEllipsoidPosition(
+    frameState,
+    tempCartesian3
+  );
 };
 
 const scratchCartesian4 = new Cartesian4();
@@ -544,7 +572,7 @@ PointPrimitive._computeScreenSpacePosition = function (
     ),
     scratchCartesian4
   );
-  const positionWC = SceneTransforms.wgs84ToWindowCoordinates(
+  const positionWC = SceneTransforms.worldToWindowCoordinates(
     scene,
     positionWorld,
     result
@@ -657,7 +685,8 @@ PointPrimitive.prototype.equals = function (other) {
         this._distanceDisplayCondition,
         other._distanceDisplayCondition
       ) &&
-      this._disableDepthTestDistance === other._disableDepthTestDistance)
+      this._disableDepthTestDistance === other._disableDepthTestDistance &&
+      this._splitDirection === other._splitDirection)
   );
 };