@cesium/engine 21.0.1-ion.0 → 22.0.0

package/Source/Scene/BillboardCollection.js

@@ -13,7 +13,6 @@ import EncodedCartesian3 from "../Core/EncodedCartesian3.js";
 import IndexDatatype from "../Core/IndexDatatype.js";
 import CesiumMath from "../Core/Math.js";
 import Matrix4 from "../Core/Matrix4.js";
-import WebGLConstants from "../Core/WebGLConstants.js";
 import Buffer from "../Renderer/Buffer.js";
 import BufferUsage from "../Renderer/BufferUsage.js";
 import ContextLimits from "../Renderer/ContextLimits.js";
@@ -34,6 +33,7 @@ import SceneMode from "./SceneMode.js";
 import SDFSettings from "./SDFSettings.js";
 import TextureAtlas from "../Renderer/TextureAtlas.js";
 import VerticalOrigin from "./VerticalOrigin.js";
+import Ellipsoid from "../Core/Ellipsoid.js";
 
 const SHOW_INDEX = Billboard.SHOW_INDEX;
 const POSITION_INDEX = Billboard.POSITION_INDEX;
@@ -315,6 +315,8 @@ function BillboardCollection(options) {
   ];
 
   this._highlightColor = Color.clone(Color.WHITE); // Only used by Vector3DTilePoints
+  this._coarseDepthTestDistance = Ellipsoid.default.minimumRadius / 100;
+  this._threePointDepthTestDistance = Ellipsoid.default.minimumRadius / 1000;
 
   this._uniforms = {
     u_atlas: () => {
@@ -323,6 +325,16 @@ function BillboardCollection(options) {
     u_highlightColor: () => {
       return this._highlightColor;
     },
+    // An eye-space distance, beyond which, the billboard is simply tested against a camera-facing plane at the ellipsoid's center,
+    // rather than against a depth texture. Note: only if the disableDepthTestingDistance property permits.
+    u_coarseDepthTestDistance: () => {
+      return this._coarseDepthTestDistance;
+    },
+    // Within this distance, if the billboard is clamped to the ground, we'll depth-test 3 key points.
+    // If any key point is visible, the whole billboard will be visible.
+    u_threePointDepthTestDistance: () => {
+      return this._threePointDepthTestDistance;
+    },
   };
 
   const scene = this._scene;
@@ -1372,9 +1384,6 @@ function writeCompressedAttribute3(
   const clampToGround =
     isHeightReferenceClamp(billboard.heightReference) &&
     frameState.context.depthTexture;
-  if (!defined(disableDepthTestDistance)) {
-    disableDepthTestDistance = clampToGround ? 5000.0 : 0.0;
-  }
 
   disableDepthTestDistance *= disableDepthTestDistance;
   if (clampToGround || disableDepthTestDistance > 0.0) {
@@ -2030,8 +2039,7 @@ BillboardCollection.prototype.update = function (frameState) {
     ) {
       this._rsOpaque = RenderState.fromCache({
         depthTest: {
-          enabled: true,
-          func: WebGLConstants.LESS,
+          enabled: false,
         },
         depthMask: true,
       });
@@ -2042,7 +2050,6 @@ BillboardCollection.prototype.update = function (frameState) {
     // If OPAQUE_AND_TRANSLUCENT is in use, only the opaque pass gets the benefit of the depth buffer,
     // not the translucent pass.  Otherwise, if the TRANSLUCENT pass is on its own, it turns on
     // a depthMask in lieu of full depth sorting (because it has opaque-ish fragments that look bad in OIT).
-    // When the TRANSLUCENT depth mask is in use, label backgrounds require the depth func to be LEQUAL.
     const useTranslucentDepthMask =
       this._blendOption === BlendOption.TRANSLUCENT;
 
@@ -2052,10 +2059,7 @@ BillboardCollection.prototype.update = function (frameState) {
     ) {
       this._rsTranslucent = RenderState.fromCache({
         depthTest: {
-          enabled: true,
-          func: useTranslucentDepthMask
-            ? WebGLConstants.LEQUAL
-            : WebGLConstants.LESS,
+          enabled: false,
         },
         depthMask: useTranslucentDepthMask,
         blending: BlendingState.ALPHA_BLEND,
@@ -2141,9 +2145,9 @@ BillboardCollection.prototype.update = function (frameState) {
     }
     if (this._shaderClampToGround) {
       if (supportVSTextureReads) {
-        vs.defines.push("VERTEX_DEPTH_CHECK");
+        vs.defines.push("VS_THREE_POINT_DEPTH_CHECK");
       } else {
-        vs.defines.push("FRAGMENT_DEPTH_CHECK");
+        vs.defines.push("FS_THREE_POINT_DEPTH_CHECK");
       }
     }
 
@@ -2162,9 +2166,9 @@ BillboardCollection.prototype.update = function (frameState) {
       });
       if (this._shaderClampToGround) {
         if (supportVSTextureReads) {
-          fs.defines.push("VERTEX_DEPTH_CHECK");
+          fs.defines.push("VS_THREE_POINT_DEPTH_CHECK");
         } else {
-          fs.defines.push("FRAGMENT_DEPTH_CHECK");
+          fs.defines.push("FS_THREE_POINT_DEPTH_CHECK");
         }
       }
 
@@ -2187,9 +2191,9 @@ BillboardCollection.prototype.update = function (frameState) {
       });
       if (this._shaderClampToGround) {
         if (supportVSTextureReads) {
-          fs.defines.push("VERTEX_DEPTH_CHECK");
+          fs.defines.push("VS_THREE_POINT_DEPTH_CHECK");
         } else {
-          fs.defines.push("FRAGMENT_DEPTH_CHECK");
+          fs.defines.push("FS_THREE_POINT_DEPTH_CHECK");
         }
       }
       if (this._sdf) {
@@ -2212,9 +2216,9 @@ BillboardCollection.prototype.update = function (frameState) {
       });
       if (this._shaderClampToGround) {
         if (supportVSTextureReads) {
-          fs.defines.push("VERTEX_DEPTH_CHECK");
+          fs.defines.push("VS_THREE_POINT_DEPTH_CHECK");
         } else {
-          fs.defines.push("FRAGMENT_DEPTH_CHECK");
+          fs.defines.push("FS_THREE_POINT_DEPTH_CHECK");
         }
       }
       if (this._sdf) {
@@ -2237,9 +2241,9 @@ BillboardCollection.prototype.update = function (frameState) {
       });
       if (this._shaderClampToGround) {
         if (supportVSTextureReads) {
-          fs.defines.push("VERTEX_DEPTH_CHECK");
+          fs.defines.push("VS_THREE_POINT_DEPTH_CHECK");
         } else {
-          fs.defines.push("FRAGMENT_DEPTH_CHECK");
+          fs.defines.push("FS_THREE_POINT_DEPTH_CHECK");
         }
       }
       if (this._sdf) {

package/Source/Scene/BingMapsImageryProvider.js

@@ -457,7 +457,7 @@ Object.defineProperties(BingMapsImageryProvider.prototype, {
 /**
  * Creates an {@link ImageryProvider} which provides tiled imagery using the Bing Maps Imagery REST API.
  *
- * @param {Resource|String} url The url of the Bing Maps server hosting the imagery.
+ * @param {Resource|string} url The url of the Bing Maps server hosting the imagery.
  * @param {BingMapsImageryProvider.ConstructorOptions} options Object describing initialization options
  * @returns {Promise<BingMapsImageryProvider>} A promise that resolves to the created BingMapsImageryProvider
  *

package/Source/Scene/BoundingVolumeSemantics.js

@@ -12,89 +12,85 @@ const BoundingVolumeSemantics = {};
 
 /**
  * Parse the bounding volume-related semantics such as
- * <code>TILE_BOUNDING_BOX</code> and <code>CONTENT_BOUNDING_REGION</code> from
- * implicit tile metadata. Results are returned as a JSON object for use when
- * transcoding tiles (see {@link Implicit3DTileContent}).
+ * <code>TILE_BOUNDING_BOX</code> and <code>CONTENT_BOUNDING_BOX</code> from
+ * implicit tile or content metadata. Results are returned as a JSON object for
+ * use when transcoding tiles (see {@link Implicit3DTileContent}).
  * <p>
  * Bounding volumes are checked in the order box, region, then sphere. Only
  * the first valid bounding volume is returned.
  * </p>
+ * <p>
+ * This handles both tile and content bounding volumes, as the only difference
+ * is the prefix. e.g. <code>TILE_BOUNDING_BOX</code> and
+ * <code>CONTENT_BOUNDING_BOX</code> have the same memory layout.
+ * </p>
  *
  * @see {@link https://github.com/CesiumGS/3d-tiles/tree/main/specification/Metadata/Semantics|3D Metadata Semantic Reference} for the various bounding volumes and minimum/maximum heights.
  *
- * @param {TileMetadata} tileMetadata The metadata object for looking up values by semantic. In practice, this will typically be a {@link ImplicitMetadataView}
- * @return {object} An object containing a <code>tile</code> property and a <code>content</code> property. These contain the bounding volume, and any minimum or maximum height.
+ * @param {string} prefix Either "TILE" or "CONTENT"
+ * @param {TileMetadata|ContentMetadata} metadata The metadata object for looking up values by semantic. In practice, this will typically be a {@link ImplicitMetadataView}
+ * @return {object} An object containing the bounding volume, and any minimum or maximum height.
  *
  * @private
  * @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.
  */
 BoundingVolumeSemantics.parseAllBoundingVolumeSemantics = function (
-  tileMetadata,
+  prefix,
+  metadata,
 ) {
   //>>includeStart('debug', pragmas.debug);
-  Check.typeOf.object("tileMetadata", tileMetadata);
+  Check.typeOf.string("prefix", prefix);
+  if (prefix !== "TILE" && prefix !== "CONTENT") {
+    throw new DeveloperError("prefix must be either 'TILE' or 'CONTENT'");
+  }
+  Check.typeOf.object("metadata", metadata);
   //>>includeEnd('debug');
 
   return {
-    tile: {
-      boundingVolume: BoundingVolumeSemantics.parseBoundingVolumeSemantic(
-        "TILE",
-        tileMetadata,
-      ),
-      minimumHeight: BoundingVolumeSemantics._parseMinimumHeight(
-        "TILE",
-        tileMetadata,
-      ),
-      maximumHeight: BoundingVolumeSemantics._parseMaximumHeight(
-        "TILE",
-        tileMetadata,
-      ),
-    },
-    content: {
-      boundingVolume: BoundingVolumeSemantics.parseBoundingVolumeSemantic(
-        "CONTENT",
-        tileMetadata,
-      ),
-      minimumHeight: BoundingVolumeSemantics._parseMinimumHeight(
-        "CONTENT",
-        tileMetadata,
-      ),
-      maximumHeight: BoundingVolumeSemantics._parseMaximumHeight(
-        "CONTENT",
-        tileMetadata,
-      ),
-    },
+    boundingVolume: BoundingVolumeSemantics.parseBoundingVolumeSemantic(
+      prefix,
+      metadata,
+    ),
+    minimumHeight: BoundingVolumeSemantics._parseMinimumHeight(
+      prefix,
+      metadata,
+    ),
+    maximumHeight: BoundingVolumeSemantics._parseMaximumHeight(
+      prefix,
+      metadata,
+    ),
   };
 };
 
 /**
- * Parse the bounding volume from a tile metadata. If the metadata specify
- * multiple bounding volumes, only the first one is returned. Bounding volumes
- * are checked in the order box, region, then sphere.
- *
+ * Parse the bounding volume from tile or content metadata. If the metadata
+ * specify multiple bounding volumes, only the first one is returned. Bounding
+ * volumes are checked in the order box, region, then sphere.
+ * <p>
  * This handles both tile and content bounding volumes, as the only difference
  * is the prefix. e.g. <code>TILE_BOUNDING_BOX</code> and
  * <code>CONTENT_BOUNDING_BOX</code> have the same memory layout.
+ * </p>
  *
  * @param {string} prefix Either "TILE" or "CONTENT"
- * @param {TileMetadata} tileMetadata The tileMetadata for looking up values
- * @return {object} An object representing the JSON description of the tile metadata
+ * @param {TileMetadata|ContentMetadata} metadata The metadata for looking up values
+ * @return {object} An object representing the JSON description of the tile or content bounding volume
  * @private
  */
 BoundingVolumeSemantics.parseBoundingVolumeSemantic = function (
   prefix,
-  tileMetadata,
+  metadata,
 ) {
   //>>includeStart('debug', pragmas.debug);
   Check.typeOf.string("prefix", prefix);
   if (prefix !== "TILE" && prefix !== "CONTENT") {
     throw new DeveloperError("prefix must be either 'TILE' or 'CONTENT'");
   }
-  Check.typeOf.object("tileMetadata", tileMetadata);
+  Check.typeOf.object("metadata", metadata);
   //>>includeEnd('debug');
 
   const boundingBoxSemantic = `${prefix}_BOUNDING_BOX`;
-  const boundingBox = tileMetadata.getPropertyBySemantic(boundingBoxSemantic);
+  const boundingBox = metadata.getPropertyBySemantic(boundingBoxSemantic);
 
   if (defined(boundingBox)) {
     return {
@@ -103,9 +99,7 @@ BoundingVolumeSemantics.parseBoundingVolumeSemantic = function (
   }
 
   const boundingRegionSemantic = `${prefix}_BOUNDING_REGION`;
-  const boundingRegion = tileMetadata.getPropertyBySemantic(
-    boundingRegionSemantic,
-  );
+  const boundingRegion = metadata.getPropertyBySemantic(boundingRegionSemantic);
 
   if (defined(boundingRegion)) {
     return {
@@ -114,9 +108,7 @@ BoundingVolumeSemantics.parseBoundingVolumeSemantic = function (
   }
 
   const boundingSphereSemantic = `${prefix}_BOUNDING_SPHERE`;
-  const boundingSphere = tileMetadata.getPropertyBySemantic(
-    boundingSphereSemantic,
-  );
+  const boundingSphere = metadata.getPropertyBySemantic(boundingSphereSemantic);
 
   if (defined(boundingSphere)) {
     // ARRAY with 4 elements is automatically converted to a Cartesian4
@@ -129,49 +121,49 @@ BoundingVolumeSemantics.parseBoundingVolumeSemantic = function (
 };
 
 /**
- * Parse the minimum height from tile metadata. This is used for making tighter
- * quadtree bounds for implicit tiling. This works for both
+ * Parse the minimum height from tile or content metadata. This is used for making
+ * tighter quadtree bounds for implicit tiling. This works for both
  * <code>TILE_MINIMUM_HEIGHT</code> and <code>CONTENT_MINIMUM_HEIGHT</code>
  *
  * @param {string} prefix Either "TILE" or "CONTENT"
- * @param {TileMetadata} tileMetadata The tileMetadata for looking up values
+ * @param {TileMetadata|ContentMetadata} metadata The metadata for looking up values
  * @return {number} The minimum height
  * @private
  */
-BoundingVolumeSemantics._parseMinimumHeight = function (prefix, tileMetadata) {
+BoundingVolumeSemantics._parseMinimumHeight = function (prefix, metadata) {
   //>>includeStart('debug', pragmas.debug);
   Check.typeOf.string("prefix", prefix);
   if (prefix !== "TILE" && prefix !== "CONTENT") {
     throw new DeveloperError("prefix must be either 'TILE' or 'CONTENT'");
   }
-  Check.typeOf.object("tileMetadata", tileMetadata);
+  Check.typeOf.object("metadata", metadata);
   //>>includeEnd('debug');
 
   const minimumHeightSemantic = `${prefix}_MINIMUM_HEIGHT`;
-  return tileMetadata.getPropertyBySemantic(minimumHeightSemantic);
+  return metadata.getPropertyBySemantic(minimumHeightSemantic);
 };
 
 /**
- * Parse the maximum height from tile metadata. This is used for making tighter
- * quadtree bounds for implicit tiling. This works for both
+ * Parse the maximum height from tile or content metadata. This is used for
+ * making tighter quadtree bounds for implicit tiling. This works for both
  * <code>TILE_MAXIMUM_HEIGHT</code> and <code>CONTENT_MAXIMUM_HEIGHT</code>
  *
  * @param {string} prefix Either "TILE" or "CONTENT"
- * @param {TileMetadata} tileMetadata The tileMetadata for looking up values
+ * @param {TileMetadata|ContentMetadata} metadata The metadata for looking up values
  * @return {number} The maximum height
  * @private
  */
-BoundingVolumeSemantics._parseMaximumHeight = function (prefix, tileMetadata) {
+BoundingVolumeSemantics._parseMaximumHeight = function (prefix, metadata) {
   //>>includeStart('debug', pragmas.debug);
   Check.typeOf.string("prefix", prefix);
   if (prefix !== "TILE" && prefix !== "CONTENT") {
     throw new DeveloperError("prefix must be either 'TILE' or 'CONTENT'");
   }
-  Check.typeOf.object("tileMetadata", tileMetadata);
+  Check.typeOf.object("metadata", metadata);
   //>>includeEnd('debug');
 
   const maximumHeightSemantic = `${prefix}_MAXIMUM_HEIGHT`;
-  return tileMetadata.getPropertyBySemantic(maximumHeightSemantic);
+  return metadata.getPropertyBySemantic(maximumHeightSemantic);
 };
 
 export default BoundingVolumeSemantics;

package/Source/Scene/Cesium3DTile.js

@@ -795,7 +795,7 @@ const scratchCartesian = new Cartesian3();
  * @private
  * @param {Cesium3DTile} tile
  * @param {FrameState} frameState
- * @returns {Boolean}
+ * @returns {boolean}
  */
 function isPriorityDeferred(tile, frameState) {
   const { tileset, boundingSphere } = tile;
@@ -905,7 +905,7 @@ const scratchJulianDate = new JulianDate();
  *
  * @private
  * @param {FrameState} frameState
- * @param {Boolean} useParentGeometricError
+ * @param {boolean} useParentGeometricError
  * @param {number} progressiveResolutionHeightFraction
  */
 Cesium3DTile.prototype.getScreenSpaceError = function (
@@ -964,7 +964,7 @@ Cesium3DTile.prototype.getScreenSpaceError = function (
  * @private
  * @param {Cesium3DTileset} tileset
  * @param {Cesium3DTile} tile
- * @returns {Boolean}
+ * @returns {boolean}
  */
 function isPriorityProgressiveResolution(tileset, tile) {
   if (

package/Source/Scene/Cesium3DTilesVoxelProvider.js

@@ -25,7 +25,7 @@ import CesiumMath from "../Core/Math.js";
 import Quaternion from "../Core/Quaternion.js";
 
 /**
- * @typedef {Object} Cesium3DTilesVoxelProvider.ConstructorOptions
+ * @typedef {object} Cesium3DTilesVoxelProvider.ConstructorOptions
  *
  * Initialization options for the Cesium3DTilesVoxelProvider constructor
  *

package/Source/Scene/Cesium3DTileset.js

@@ -65,7 +65,7 @@ import DynamicEnvironmentMapManager from "./DynamicEnvironmentMapManager.js";
 import ImageryLayerCollection from "./ImageryLayerCollection.js";
 
 /**
- * @typedef {Object} Cesium3DTileset.ConstructorOptions
+ * @typedef {object} Cesium3DTileset.ConstructorOptions
  *
  * Initialization options for the Cesium3DTileset constructor
  *

package/Source/Scene/EdgeFramebuffer.js

@@ -0,0 +1,245 @@
+import defined from "../Core/defined.js";
+import destroyObject from "../Core/destroyObject.js";
+import PixelFormat from "../Core/PixelFormat.js";
+import Color from "../Core/Color.js";
+import PixelDatatype from "../Renderer/PixelDatatype.js";
+import FramebufferManager from "../Renderer/FramebufferManager.js";
+import ClearCommand from "../Renderer/ClearCommand.js";
+
+/**
+ * Creates and manages framebuffers for edge visibility rendering.
+ *
+ * @param {Object} options Object with the following properties:
+ *
+ * @alias EdgeFramebuffer
+ * @constructor
+ *
+ * @private
+ */
+function EdgeFramebuffer(options) {
+  options = options || {};
+
+  // Create framebuffer manager with multiple render targets (MRT)
+  // Color attachment 0: edge color output (visualization / debug)
+  // Color attachment 1: R: edge type, G: featureId (metadata / ids)
+  // Color attachment 2: packed depth (czm_packDepth) for edge fragments
+  this._framebufferManager = new FramebufferManager({
+    colorAttachmentsLength: 3, // MRT: Color + ID + Depth (packed RGBA)
+    createColorAttachments: true,
+    depthStencil: true,
+    supportsDepthTexture: true,
+    color: true,
+  });
+
+  this._framebuffer = undefined;
+  this._colorTexture = undefined;
+  this._idTexture = undefined;
+  this._depthTexture = undefined; // packed depth color attachment (location = 2)
+  this._depthStencilTexture = undefined;
+
+  this._clearCommand = new ClearCommand({
+    color: new Color(0.0, 0.0, 0.0, 0.0),
+    depth: 1.0,
+    stencil: 0,
+    owner: this,
+  });
+}
+
+Object.defineProperties(EdgeFramebuffer.prototype, {
+  /**
+   * Gets the framebuffer for edge rendering.
+   * @memberof EdgeFramebuffer.prototype
+   * @type {Framebuffer}
+   * @readonly
+   */
+  framebuffer: {
+    get: function () {
+      return this._framebuffer;
+    },
+  },
+
+  /**
+   * Gets the color texture.
+   * @memberof EdgeFramebuffer.prototype
+   * @type {Texture}
+   * @readonly
+   */
+  colorTexture: {
+    get: function () {
+      return this._colorTexture;
+    },
+  },
+
+  /**
+   * Gets the ID texture.
+   * @memberof EdgeFramebuffer.prototype
+   * @type {Texture}
+   * @readonly
+   */
+  idTexture: {
+    get: function () {
+      return this._idTexture;
+    },
+  },
+
+  /**
+   * Gets the packed depth texture written during the edge pass.
+   * @memberof EdgeFramebuffer.prototype
+   * @type {Texture}
+   * @readonly
+   */
+  depthTexture: {
+    get: function () {
+      return this._depthTexture;
+    },
+  },
+
+  /**
+   * Gets the depth-stencil texture.
+   * @memberof EdgeFramebuffer.prototype
+   * @type {Texture}
+   * @readonly
+   */
+  depthStencilTexture: {
+    get: function () {
+      return this._depthStencilTexture;
+    },
+  },
+});
+
+/**
+ * Updates the framebuffer.
+ *
+ * @param {Context} context The context.
+ * @param {Viewport} viewport The viewport.
+ * @param {boolean} hdr Whether HDR is enabled.
+ * @param {Texture} [existingColorTexture] Optional existing color texture to reuse.
+ * @param {Texture} [existingDepthTexture] Optional existing depth texture to reuse.
+ *
+ * @returns {boolean} True if the framebuffer was updated; otherwise, false.
+ */
+EdgeFramebuffer.prototype.update = function (
+  context,
+  viewport,
+  hdr,
+  existingColorTexture,
+  existingDepthTexture,
+) {
+  const width = viewport.width;
+  const height = viewport.height;
+
+  const pixelDatatype = hdr
+    ? context.halfFloatingPointTexture
+      ? PixelDatatype.HALF_FLOAT
+      : PixelDatatype.FLOAT
+    : PixelDatatype.UNSIGNED_BYTE;
+
+  const changed = this._framebufferManager.update(
+    context,
+    width,
+    height,
+    1, // No MSAA
+    pixelDatatype,
+    PixelFormat.RGBA,
+  );
+
+  // Always assign framebuffer if FramebufferManager has one
+  if (this._framebufferManager.framebuffer) {
+    this._framebuffer = this._framebufferManager.framebuffer;
+
+    // Get the textures from the framebuffer manager or use existing ones
+    this._colorTexture = defined(existingColorTexture)
+      ? existingColorTexture
+      : this._framebufferManager.getColorTexture(0); // Color attachment 0
+    this._idTexture = this._framebufferManager.getColorTexture(1); // Color attachment 1: ID texture
+    this._depthTexture = this._framebufferManager.getColorTexture(2); // Color attachment 2: packed depth
+    this._depthStencilTexture = defined(existingDepthTexture)
+      ? existingDepthTexture
+      : this._framebufferManager.getDepthStencilTexture();
+  }
+
+  return changed;
+};
+
+/**
+ * Clears the framebuffer using ClearCommand.
+ * @deprecated Use getClearCommand() instead for proper MRT clearing.
+ *
+ * @param {Context} context The context.
+ * @param {PassState} passState The pass state.
+ * @param {Color} clearColor The clear color.
+ */
+EdgeFramebuffer.prototype.clear = function (context, passState, clearColor) {
+  const clearCommand = this.getClearCommand(clearColor);
+  clearCommand.execute(context, passState);
+};
+
+/**
+ * Gets the clear command for this framebuffer.
+ *
+ * @param {Color} [clearColor] The clear color to use. If undefined, uses the default.
+ * @returns {ClearCommand} The clear command.
+ */
+EdgeFramebuffer.prototype.getClearCommand = function (clearColor) {
+  this._clearCommand.framebuffer = this._framebuffer;
+
+  if (defined(clearColor)) {
+    Color.clone(clearColor, this._clearCommand.color);
+  }
+
+  return this._clearCommand;
+};
+
+/**
+ * Gets the edge framebuffer, creating it if necessary.
+ *
+ * @param {Context} context The context.
+ * @param {Viewport} viewport The viewport.
+ * @param {Texture} [existingColorTexture] Optional existing color texture to reuse.
+ * @param {Texture} [existingDepthTexture] Optional existing depth texture to reuse.
+ *
+ * @returns {Framebuffer} The edge framebuffer.
+ */
+EdgeFramebuffer.prototype.getFramebuffer = function (
+  context,
+  viewport,
+  existingColorTexture,
+  existingDepthTexture,
+) {
+  this.update(
+    context,
+    viewport,
+    false,
+    existingColorTexture,
+    existingDepthTexture,
+  );
+  return this._framebuffer;
+};
+
+/**
+ * Returns true if this object was destroyed; otherwise, false.
+ *
+ * @returns {boolean} True if this object was destroyed; otherwise, false.
+ */
+EdgeFramebuffer.prototype.isDestroyed = function () {
+  return false;
+};
+
+/**
+ * Destroys the WebGL resources held by this object.  Destroying an object allows for deterministic
+ * release of WebGL resources, instead of relying on the garbage collector to destroy this object.
+ * <br /><br />
+ * Once an object is destroyed, it should not be used; calling any function other than
+ * <code>isDestroyed</code> will result in a {@link DeveloperError} exception.  Therefore,
+ * assign the return value (<code>undefined</code>) to the object as done in the example.
+ *
+ * @exception {DeveloperError} This object was destroyed, i.e., destroy() was called.
+ */
+EdgeFramebuffer.prototype.destroy = function () {
+  this._framebufferManager =
+    this._framebufferManager && this._framebufferManager.destroy();
+  this._clearCommand = undefined;
+  return destroyObject(this);
+};
+
+export default EdgeFramebuffer;

package/Source/Scene/FrameState.js

@@ -454,6 +454,18 @@ function FrameState(context, creditDisplay, jobScheduler) {
    * @type {PickedMetadataInfo|undefined}
    */
   this.pickedMetadataInfo = undefined;
+
+  /**
+   * Internal toggle indicating that at least one primitive for this frame requested
+   * edge visibility rendering (EXT_mesh_primitive_edge_visibility). This allows
+   * lazy allocation/activation of the edge MRT without storing a Scene reference
+   * on the frame state (avoids passing entire Scene through internal APIs).
+   * Set by model pipeline stages when they encounter edge visibility data.
+   * Consumed by Scene to flip its _enableEdgeVisibility flag.
+   * @type {boolean}
+   * @private
+   */
+  this.edgeVisibilityRequested = false;
 }
 
 /**