@cesium/engine 26.0.0 → 26.2.0

package/Source/Scene/GlobeSurfaceShaderSet.js

@@ -1,41 +1,517 @@
+// @ts-check
+
 import defined from "../Core/defined.js";
 import destroyObject from "../Core/destroyObject.js";
 import TerrainQuantization from "../Core/TerrainQuantization.js";
 import ShaderProgram from "../Renderer/ShaderProgram.js";
+import VectorCommon from "../Shaders/VectorCommon.js";
 import getClippingFunction from "./getClippingFunction.js";
 import SceneMode from "./SceneMode.js";
 
-function GlobeSurfaceShader(
-  numberOfDayTextures,
-  flags,
-  material,
-  shaderProgram,
-  clippingShaderState,
-  clippingPolygonShaderState,
-) {
-  this.numberOfDayTextures = numberOfDayTextures;
-  this.flags = flags;
-  this.material = material;
-  this.shaderProgram = shaderProgram;
-  this.clippingShaderState = clippingShaderState;
-  this.clippingPolygonShaderState = clippingPolygonShaderState;
+/** @import ClippingPlaneCollection from "./ClippingPlaneCollection.js"; */
+/** @import ClippingPolygonCollection from "./ClippingPolygonCollection.js"; */
+/** @import Context from "../Renderer/Context.js"; */
+/** @import FrameState from "./FrameState.js"; */
+/** @import GlobeSurfaceTile from "./GlobeSurfaceTile.js"; */
+
+/**
+ * @ignore
+ */
+class GlobeSurfaceShader {
+  /**
+   * @param {number} numberOfDayTextures
+   * @param {number} flags
+   * @param {*} material
+   * @param {ShaderProgram} shaderProgram
+   * @param {number} clippingShaderState
+   * @param {number} clippingPolygonShaderState
+   */
+  constructor(
+    numberOfDayTextures,
+    flags,
+    material,
+    shaderProgram,
+    clippingShaderState,
+    clippingPolygonShaderState,
+  ) {
+    /** @type {number} */
+    this.numberOfDayTextures = numberOfDayTextures;
+    this.flags = flags;
+    this.material = material;
+    /** @type {ShaderProgram} */
+    this.shaderProgram = shaderProgram;
+    this.clippingShaderState = clippingShaderState;
+    this.clippingPolygonShaderState = clippingPolygonShaderState;
+  }
 }
 
+/**
+ * @typedef {object} GlobeSurfaceShaderSetOptions
+ * @property {FrameState} [frameState]
+ * @property {GlobeSurfaceTile} [surfaceTile]
+ * @property {number} [numberOfDayTextures]
+ * @property {boolean} [applyBrightness]
+ * @property {boolean} [applyContrast]
+ * @property {boolean} [applyHue]
+ * @property {boolean} [applySaturation]
+ * @property {boolean} [applyGamma]
+ * @property {boolean} [applyAlpha]
+ * @property {boolean} [applyDayNightAlpha]
+ * @property {boolean} [applySplit]
+ * @property {boolean} [hasWaterMask]
+ * @property {boolean} [showReflectiveOcean]
+ * @property {boolean} [showOceanWaves]
+ * @property {boolean} [enableLighting]
+ * @property {boolean} [dynamicAtmosphereLighting]
+ * @property {boolean} [dynamicAtmosphereLightingFromSun]
+ * @property {boolean} [showGroundAtmosphere]
+ * @property {boolean} [perFragmentGroundAtmosphere]
+ * @property {boolean} [hasVertexNormals]
+ * @property {boolean} [useWebMercatorProjection]
+ * @property {boolean} [enableFog]
+ * @property {boolean} [enableClippingPlanes]
+ * @property {ClippingPlaneCollection} [clippingPlanes]
+ * @property {boolean} [enableClippingPolygons]
+ * @property {ClippingPolygonCollection} [clippingPolygons]
+ * @property {boolean} [clippedByBoundaries]
+ * @property {boolean} [hasImageryLayerCutout]
+ * @property {boolean} [colorCorrect]
+ * @property {boolean} [highlightFillTile]
+ * @property {boolean} [colorToAlpha]
+ * @property {boolean} [hasGeodeticSurfaceNormals]
+ * @property {boolean} [hasExaggeration]
+ * @property {boolean} [showUndergroundColor]
+ * @property {boolean} [translucent]
+ * @private
+ */
+
 /**
  * Manages the shaders used to shade the surface of a {@link Globe}.
  *
- * @alias GlobeSurfaceShaderSet
  * @private
  */
-function GlobeSurfaceShaderSet() {
-  this.baseVertexShaderSource = undefined;
-  this.baseFragmentShaderSource = undefined;
+class GlobeSurfaceShaderSet {
+  constructor() {
+    this.baseVertexShaderSource = undefined;
+    this.baseFragmentShaderSource = undefined;
+
+    /** @type {GlobeSurfaceShader[][]} */
+    this._shadersByTexturesFlags = [];
+
+    this.material = undefined;
+  }
+
+  /** @param {GlobeSurfaceShaderSetOptions} options */
+  getShaderProgram(options) {
+    const frameState = options.frameState;
+    const surfaceTile = options.surfaceTile;
+    const numberOfDayTextures = options.numberOfDayTextures;
+    const applyBrightness = options.applyBrightness;
+    const applyContrast = options.applyContrast;
+    const applyHue = options.applyHue;
+    const applySaturation = options.applySaturation;
+    const applyGamma = options.applyGamma;
+    const applyAlpha = options.applyAlpha;
+    const applyDayNightAlpha = options.applyDayNightAlpha;
+    const applySplit = options.applySplit;
+    const hasWaterMask = options.hasWaterMask;
+    const showReflectiveOcean = options.showReflectiveOcean;
+    const showOceanWaves = options.showOceanWaves;
+    const enableLighting = options.enableLighting;
+    const dynamicAtmosphereLighting = options.dynamicAtmosphereLighting;
+    const dynamicAtmosphereLightingFromSun =
+      options.dynamicAtmosphereLightingFromSun;
+    const showGroundAtmosphere = options.showGroundAtmosphere;
+    const perFragmentGroundAtmosphere = options.perFragmentGroundAtmosphere;
+    const hasVertexNormals = options.hasVertexNormals;
+    const useWebMercatorProjection = options.useWebMercatorProjection;
+    const enableFog = options.enableFog;
+    const enableClippingPlanes = options.enableClippingPlanes;
+    const clippingPlanes = options.clippingPlanes;
+    const enableClippingPolygons = options.enableClippingPolygons;
+    const clippingPolygons = options.clippingPolygons;
+    const clippedByBoundaries = options.clippedByBoundaries;
+    const hasImageryLayerCutout = options.hasImageryLayerCutout;
+    const colorCorrect = options.colorCorrect;
+    const highlightFillTile = options.highlightFillTile;
+    const colorToAlpha = options.colorToAlpha;
+    const hasGeodeticSurfaceNormals = options.hasGeodeticSurfaceNormals;
+    const hasExaggeration = options.hasExaggeration;
+    const showUndergroundColor = options.showUndergroundColor;
+    const translucent = options.translucent;
+    const vectorData = surfaceTile.vectorData;
+    const hasVectorLayer = vectorData?.show;
+
+    let quantization = 0;
+    let quantizationDefine = "";
+
+    const mesh = surfaceTile.renderedMesh;
+    const terrainEncoding = mesh.encoding;
+    const quantizationMode = terrainEncoding.quantization;
+    if (quantizationMode === TerrainQuantization.BITS12) {
+      quantization = 1;
+      quantizationDefine = "QUANTIZATION_BITS12";
+    }
+
+    let cartographicLimitRectangleFlag = 0;
+    let cartographicLimitRectangleDefine = "";
+    if (clippedByBoundaries) {
+      cartographicLimitRectangleFlag = 1;
+      cartographicLimitRectangleDefine = "TILE_LIMIT_RECTANGLE";
+    }
+
+    let imageryCutoutFlag = 0;
+    let imageryCutoutDefine = "";
+    if (hasImageryLayerCutout) {
+      imageryCutoutFlag = 1;
+      imageryCutoutDefine = "APPLY_IMAGERY_CUTOUT";
+    }
+
+    const sceneMode = frameState.mode;
+    // Bitwise OR uses 32-bit integers; bits 0-31 are packed below.
+    // Flags beyond bit 31 use arithmetic to avoid silent wrap-around
+    // (x << 32 === x << 0 in JavaScript).
+    const flags =
+      ((sceneMode |
+        (+applyBrightness << 2) |
+        (+applyContrast << 3) |
+        (+applyHue << 4) |
+        (+applySaturation << 5) |
+        (+applyGamma << 6) |
+        (+applyAlpha << 7) |
+        (+hasWaterMask << 8) |
+        (+showReflectiveOcean << 9) |
+        (+showOceanWaves << 10) |
+        (+enableLighting << 11) |
+        (+dynamicAtmosphereLighting << 12) |
+        (+dynamicAtmosphereLightingFromSun << 13) |
+        (+showGroundAtmosphere << 14) |
+        (+perFragmentGroundAtmosphere << 15) |
+        (+hasVertexNormals << 16) |
+        (+useWebMercatorProjection << 17) |
+        (+enableFog << 18) |
+        (quantization << 19) |
+        (+applySplit << 20) |
+        (+enableClippingPlanes << 21) |
+        (+enableClippingPolygons << 22) |
+        (cartographicLimitRectangleFlag << 23) |
+        (imageryCutoutFlag << 24) |
+        (+colorCorrect << 25) |
+        (+highlightFillTile << 26) |
+        (+colorToAlpha << 27) |
+        (+hasGeodeticSurfaceNormals << 28) |
+        (+hasExaggeration << 29) |
+        (+showUndergroundColor << 30) |
+        (+translucent << 31)) >>>
+        0) +
+      (applyDayNightAlpha ? 0x100000000 : 0) +
+      (hasVectorLayer ? 0x200000000 : 0);
+
+    let currentClippingShaderState = 0;
+    // @ts-expect-error Missing types.
+    if (defined(clippingPlanes) && clippingPlanes.length > 0) {
+      currentClippingShaderState = enableClippingPlanes
+        ? // @ts-expect-error Missing types.
+          clippingPlanes.clippingPlanesState
+        : 0;
+    }
+
+    let currentClippingPolygonsShaderState = 0;
+    // @ts-expect-error Missing types.
+    if (defined(clippingPolygons) && clippingPolygons.length > 0) {
+      currentClippingPolygonsShaderState = enableClippingPolygons
+        ? // @ts-expect-error Missing types.
+          clippingPolygons.clippingPolygonsState
+        : 0;
+    }
+
+    let surfaceShader = surfaceTile.surfaceShader;
+    if (
+      defined(surfaceShader) &&
+      surfaceShader.numberOfDayTextures === numberOfDayTextures &&
+      surfaceShader.flags === flags &&
+      surfaceShader.material === this.material &&
+      surfaceShader.clippingShaderState === currentClippingShaderState &&
+      surfaceShader.clippingPolygonShaderState ===
+        currentClippingPolygonsShaderState
+    ) {
+      return surfaceShader.shaderProgram;
+    }
+
+    // New tile, or tile changed number of textures, flags, or clipping planes
+    let shadersByFlags = this._shadersByTexturesFlags[numberOfDayTextures];
+    if (!defined(shadersByFlags)) {
+      shadersByFlags = this._shadersByTexturesFlags[numberOfDayTextures] = [];
+    }
+
+    surfaceShader = shadersByFlags[flags];
+    if (
+      !defined(surfaceShader) ||
+      surfaceShader.material !== this.material ||
+      surfaceShader.clippingShaderState !== currentClippingShaderState ||
+      surfaceShader.clippingPolygonShaderState !==
+        currentClippingPolygonsShaderState
+    ) {
+      // Cache miss - we've never seen this combination of numberOfDayTextures and flags before.
+      const vs = this.baseVertexShaderSource.clone();
+      const fs = this.baseFragmentShaderSource.clone();
+
+      // Need to go before GlobeFS
+      if (currentClippingShaderState !== 0) {
+        fs.sources.unshift(
+          getClippingFunction(clippingPlanes, frameState.context),
+        );
+      }
+
+      // Need to go before GlobeFS
+      if (currentClippingPolygonsShaderState !== 0) {
+        fs.sources.unshift(getPolygonClippingFunction(frameState.context));
+        vs.sources.unshift(getUnpackClippingFunction(frameState.context));
+      }
+
+      vs.defines.push(quantizationDefine);
+      fs.defines.push(
+        `TEXTURE_UNITS ${numberOfDayTextures}`,
+        cartographicLimitRectangleDefine,
+        imageryCutoutDefine,
+      );
+
+      if (applyBrightness) {
+        fs.defines.push("APPLY_BRIGHTNESS");
+      }
+      if (applyContrast) {
+        fs.defines.push("APPLY_CONTRAST");
+      }
+      if (applyHue) {
+        fs.defines.push("APPLY_HUE");
+      }
+      if (applySaturation) {
+        fs.defines.push("APPLY_SATURATION");
+      }
+      if (applyGamma) {
+        fs.defines.push("APPLY_GAMMA");
+      }
+      if (applyAlpha) {
+        fs.defines.push("APPLY_ALPHA");
+      }
+      if (applyDayNightAlpha) {
+        fs.defines.push("APPLY_DAY_NIGHT_ALPHA");
+      }
+      if (hasWaterMask) {
+        fs.defines.push("HAS_WATER_MASK");
+      }
+      if (showReflectiveOcean) {
+        fs.defines.push("SHOW_REFLECTIVE_OCEAN");
+        vs.defines.push("SHOW_REFLECTIVE_OCEAN");
+      }
+      if (showOceanWaves) {
+        fs.defines.push("SHOW_OCEAN_WAVES");
+      }
+      if (colorToAlpha) {
+        fs.defines.push("APPLY_COLOR_TO_ALPHA");
+      }
+      if (showUndergroundColor) {
+        vs.defines.push("UNDERGROUND_COLOR");
+        fs.defines.push("UNDERGROUND_COLOR");
+      }
+      if (translucent) {
+        vs.defines.push("TRANSLUCENT");
+        fs.defines.push("TRANSLUCENT");
+      }
+      if (enableLighting) {
+        if (hasVertexNormals) {
+          vs.defines.push("ENABLE_VERTEX_LIGHTING");
+          fs.defines.push("ENABLE_VERTEX_LIGHTING");
+        } else {
+          vs.defines.push("ENABLE_DAYNIGHT_SHADING");
+          fs.defines.push("ENABLE_DAYNIGHT_SHADING");
+        }
+      }
+
+      if (dynamicAtmosphereLighting) {
+        vs.defines.push("DYNAMIC_ATMOSPHERE_LIGHTING");
+        fs.defines.push("DYNAMIC_ATMOSPHERE_LIGHTING");
+        if (dynamicAtmosphereLightingFromSun) {
+          vs.defines.push("DYNAMIC_ATMOSPHERE_LIGHTING_FROM_SUN");
+          fs.defines.push("DYNAMIC_ATMOSPHERE_LIGHTING_FROM_SUN");
+        }
+      }
+
+      if (showGroundAtmosphere) {
+        vs.defines.push("GROUND_ATMOSPHERE");
+        fs.defines.push("GROUND_ATMOSPHERE");
+        if (perFragmentGroundAtmosphere) {
+          vs.defines.push("PER_FRAGMENT_GROUND_ATMOSPHERE");
+          fs.defines.push("PER_FRAGMENT_GROUND_ATMOSPHERE");
+        }
+      }
+
+      vs.defines.push("INCLUDE_WEB_MERCATOR_Y");
+      fs.defines.push("INCLUDE_WEB_MERCATOR_Y");
+
+      if (enableFog) {
+        vs.defines.push("FOG");
+        fs.defines.push("FOG");
+      }
+
+      if (applySplit) {
+        fs.defines.push("APPLY_SPLIT");
+      }
+
+      if (enableClippingPlanes) {
+        fs.defines.push("ENABLE_CLIPPING_PLANES");
+      }
+
+      if (enableClippingPolygons) {
+        fs.defines.push("ENABLE_CLIPPING_POLYGONS");
+        vs.defines.push("ENABLE_CLIPPING_POLYGONS");
+
+        if (clippingPolygons.inverse) {
+          fs.defines.push("CLIPPING_INVERSE");
+        }
 
-  this._shadersByTexturesFlags = [];
+        fs.defines.push(
+          // @ts-expect-error Missing types.
+          `CLIPPING_POLYGON_REGIONS_LENGTH ${clippingPolygons.extentsCount}`,
+        );
+        vs.defines.push(
+          // @ts-expect-error Missing types.
+          `CLIPPING_POLYGON_REGIONS_LENGTH ${clippingPolygons.extentsCount}`,
+        );
+      }
+
+      if (colorCorrect) {
+        fs.defines.push("COLOR_CORRECT");
+      }
+
+      if (highlightFillTile) {
+        fs.defines.push("HIGHLIGHT_FILL_TILE");
+      }
+
+      if (hasGeodeticSurfaceNormals) {
+        vs.defines.push("GEODETIC_SURFACE_NORMALS");
+      }
+
+      if (hasExaggeration) {
+        vs.defines.push("EXAGGERATION");
+      }
+
+      if (hasVectorLayer) {
+        vs.defines.push("HAS_VECTOR_LAYER");
+        fs.defines.push("HAS_VECTOR_LAYER");
+        fs.sources.unshift(VectorCommon); // before GlobeFS.
+      }
+
+      let computeDayColor =
+        "\
+      vec4 computeDayColor(vec4 initialColor, vec3 textureCoordinates, float nightBlend)\n\
+      {\n\
+          vec4 color = initialColor;\n";
+
+      if (hasImageryLayerCutout) {
+        computeDayColor +=
+          "\
+          vec4 cutoutAndColorResult;\n\
+          bool texelUnclipped;\n";
+      }
+
+      for (let i = 0; i < numberOfDayTextures; ++i) {
+        if (hasImageryLayerCutout) {
+          computeDayColor += `\
+          cutoutAndColorResult = u_dayTextureCutoutRectangles[${i}];\n\
+          texelUnclipped = v_textureCoordinates.x < cutoutAndColorResult.x || cutoutAndColorResult.z < v_textureCoordinates.x || v_textureCoordinates.y < cutoutAndColorResult.y || cutoutAndColorResult.w < v_textureCoordinates.y;\n\
+          cutoutAndColorResult = sampleAndBlend(\n`;
+        } else {
+          computeDayColor +=
+            "\
+          color = sampleAndBlend(\n";
+        }
+        computeDayColor += `\
+              color,\n\
+              u_dayTextures[${i}],\n\
+              u_dayTextureUseWebMercatorT[${i}] ? textureCoordinates.xz : textureCoordinates.xy,\n\
+              u_dayTextureTexCoordsRectangle[${i}],\n\
+              u_dayTextureTranslationAndScale[${i}],\n\
+              ${applyAlpha ? `u_dayTextureAlpha[${i}]` : "1.0"},\n\
+              ${applyDayNightAlpha ? `u_dayTextureNightAlpha[${i}]` : "1.0"},\n\
+              ${applyDayNightAlpha ? `u_dayTextureDayAlpha[${i}]` : "1.0"},\n\
+              ${applyBrightness ? `u_dayTextureBrightness[${i}]` : "0.0"},\n\
+              ${applyContrast ? `u_dayTextureContrast[${i}]` : "0.0"},\n\
+              ${applyHue ? `u_dayTextureHue[${i}]` : "0.0"},\n\
+              ${applySaturation ? `u_dayTextureSaturation[${i}]` : "0.0"},\n\
+              ${applyGamma ? `u_dayTextureOneOverGamma[${i}]` : "0.0"},\n\
+              ${applySplit ? `u_dayTextureSplit[${i}]` : "0.0"},\n\
+              ${colorToAlpha ? `u_colorsToAlpha[${i}]` : "vec4(0.0)"},\n\
+              nightBlend\);\n`;
+        if (hasImageryLayerCutout) {
+          computeDayColor +=
+            "\
+          color = czm_branchFreeTernary(texelUnclipped, cutoutAndColorResult, color);\n";
+        }
+      }
+
+      computeDayColor +=
+        "\
+          return color;\n\
+      }";
+
+      fs.sources.push(computeDayColor);
+
+      vs.sources.push(getPositionMode(sceneMode));
+      vs.sources.push(get2DYPositionFraction(useWebMercatorProjection));
+
+      const shader = ShaderProgram.fromCache({
+        context: frameState.context,
+        vertexShaderSource: vs,
+        fragmentShaderSource: fs,
+        attributeLocations: terrainEncoding.getAttributeLocations(),
+      });
+
+      surfaceShader = shadersByFlags[flags] = new GlobeSurfaceShader(
+        numberOfDayTextures,
+        flags,
+        this.material,
+        shader,
+        currentClippingShaderState,
+        currentClippingPolygonsShaderState,
+      );
+    }
+
+    surfaceTile.surfaceShader = surfaceShader;
+    return surfaceShader.shaderProgram;
+  }
+
+  destroy() {
+    let flags;
+    let shader;
+
+    const shadersByTexturesFlags = this._shadersByTexturesFlags;
+    for (const textureCount in shadersByTexturesFlags) {
+      if (shadersByTexturesFlags.hasOwnProperty(textureCount)) {
+        const shadersByFlags = shadersByTexturesFlags[textureCount];
+        if (!defined(shadersByFlags)) {
+          continue;
+        }
+
+        for (flags in shadersByFlags) {
+          if (shadersByFlags.hasOwnProperty(flags)) {
+            shader = shadersByFlags[flags];
+            if (defined(shader)) {
+              shader.shaderProgram.destroy();
+            }
+          }
+        }
+      }
+    }
 
-  this.material = undefined;
+    return destroyObject(this);
+  }
 }
 
+/**
+ * @param {SceneMode} sceneMode
+ * @ignore
+ */
 function getPositionMode(sceneMode) {
   const getPosition3DMode =
     "vec4 getPosition(vec3 position, float height, vec2 textureCoordinates) { return getPosition3DMode(position, height, textureCoordinates); }";
@@ -62,8 +538,13 @@ function getPositionMode(sceneMode) {
   return positionMode;
 }
 
+/**
+ * @param {Context} context
+ * @ignore
+ */
 function getPolygonClippingFunction(context) {
   // return a noop for webgl1
+  // @ts-expect-error Missing types.
   if (!context.webgl2) {
     return `void clipPolygons(highp sampler2D clippingDistance, int regionsLength, vec2 clippingPosition, int regionIndex) {
     }`;
@@ -74,8 +555,13 @@ function getPolygonClippingFunction(context) {
   }`;
 }
 
+/**
+ * @param {Context} context
+ * @ignore
+ */
 function getUnpackClippingFunction(context) {
   // return a noop for webgl1
+  // @ts-expect-error Missing types.
   if (!context.webgl2) {
     return `vec4 unpackClippingExtents(highp sampler2D extentsTexture, int index) {
       return vec4();
@@ -87,6 +573,11 @@ function getUnpackClippingFunction(context) {
   }`;
 }
 
+/**
+ * @param {boolean} useWebMercatorProjection
+ * @returns {string}
+ * @ignore
+ */
 function get2DYPositionFraction(useWebMercatorProjection) {
   const get2DYPositionFractionGeographicProjection =
     "float get2DYPositionFraction(vec2 textureCoordinates) { return get2DGeographicYPositionFraction(textureCoordinates); }";
@@ -97,393 +588,4 @@ function get2DYPositionFraction(useWebMercatorProjection) {
     : get2DYPositionFractionGeographicProjection;
 }
 
-GlobeSurfaceShaderSet.prototype.getShaderProgram = function (options) {
-  const frameState = options.frameState;
-  const surfaceTile = options.surfaceTile;
-  const numberOfDayTextures = options.numberOfDayTextures;
-  const applyBrightness = options.applyBrightness;
-  const applyContrast = options.applyContrast;
-  const applyHue = options.applyHue;
-  const applySaturation = options.applySaturation;
-  const applyGamma = options.applyGamma;
-  const applyAlpha = options.applyAlpha;
-  const applyDayNightAlpha = options.applyDayNightAlpha;
-  const applySplit = options.applySplit;
-  const hasWaterMask = options.hasWaterMask;
-  const showReflectiveOcean = options.showReflectiveOcean;
-  const showOceanWaves = options.showOceanWaves;
-  const enableLighting = options.enableLighting;
-  const dynamicAtmosphereLighting = options.dynamicAtmosphereLighting;
-  const dynamicAtmosphereLightingFromSun =
-    options.dynamicAtmosphereLightingFromSun;
-  const showGroundAtmosphere = options.showGroundAtmosphere;
-  const perFragmentGroundAtmosphere = options.perFragmentGroundAtmosphere;
-  const hasVertexNormals = options.hasVertexNormals;
-  const useWebMercatorProjection = options.useWebMercatorProjection;
-  const enableFog = options.enableFog;
-  const enableClippingPlanes = options.enableClippingPlanes;
-  const clippingPlanes = options.clippingPlanes;
-  const enableClippingPolygons = options.enableClippingPolygons;
-  const clippingPolygons = options.clippingPolygons;
-  const clippedByBoundaries = options.clippedByBoundaries;
-  const hasImageryLayerCutout = options.hasImageryLayerCutout;
-  const colorCorrect = options.colorCorrect;
-  const highlightFillTile = options.highlightFillTile;
-  const colorToAlpha = options.colorToAlpha;
-  const hasGeodeticSurfaceNormals = options.hasGeodeticSurfaceNormals;
-  const hasExaggeration = options.hasExaggeration;
-  const showUndergroundColor = options.showUndergroundColor;
-  const translucent = options.translucent;
-
-  let quantization = 0;
-  let quantizationDefine = "";
-
-  const mesh = surfaceTile.renderedMesh;
-  const terrainEncoding = mesh.encoding;
-  const quantizationMode = terrainEncoding.quantization;
-  if (quantizationMode === TerrainQuantization.BITS12) {
-    quantization = 1;
-    quantizationDefine = "QUANTIZATION_BITS12";
-  }
-
-  let cartographicLimitRectangleFlag = 0;
-  let cartographicLimitRectangleDefine = "";
-  if (clippedByBoundaries) {
-    cartographicLimitRectangleFlag = 1;
-    cartographicLimitRectangleDefine = "TILE_LIMIT_RECTANGLE";
-  }
-
-  let imageryCutoutFlag = 0;
-  let imageryCutoutDefine = "";
-  if (hasImageryLayerCutout) {
-    imageryCutoutFlag = 1;
-    imageryCutoutDefine = "APPLY_IMAGERY_CUTOUT";
-  }
-
-  const sceneMode = frameState.mode;
-  // Bitwise OR uses 32-bit integers; bits 0-31 are packed below.
-  // Flags beyond bit 31 use arithmetic to avoid silent wrap-around
-  // (x << 32 === x << 0 in JavaScript).
-  const flags =
-    ((sceneMode |
-      (applyBrightness << 2) |
-      (applyContrast << 3) |
-      (applyHue << 4) |
-      (applySaturation << 5) |
-      (applyGamma << 6) |
-      (applyAlpha << 7) |
-      (hasWaterMask << 8) |
-      (showReflectiveOcean << 9) |
-      (showOceanWaves << 10) |
-      (enableLighting << 11) |
-      (dynamicAtmosphereLighting << 12) |
-      (dynamicAtmosphereLightingFromSun << 13) |
-      (showGroundAtmosphere << 14) |
-      (perFragmentGroundAtmosphere << 15) |
-      (hasVertexNormals << 16) |
-      (useWebMercatorProjection << 17) |
-      (enableFog << 18) |
-      (quantization << 19) |
-      (applySplit << 20) |
-      (enableClippingPlanes << 21) |
-      (enableClippingPolygons << 22) |
-      (cartographicLimitRectangleFlag << 23) |
-      (imageryCutoutFlag << 24) |
-      (colorCorrect << 25) |
-      (highlightFillTile << 26) |
-      (colorToAlpha << 27) |
-      (hasGeodeticSurfaceNormals << 28) |
-      (hasExaggeration << 29) |
-      (showUndergroundColor << 30) |
-      (translucent << 31)) >>>
-      0) +
-    (applyDayNightAlpha ? 0x100000000 : 0);
-
-  let currentClippingShaderState = 0;
-  if (defined(clippingPlanes) && clippingPlanes.length > 0) {
-    currentClippingShaderState = enableClippingPlanes
-      ? clippingPlanes.clippingPlanesState
-      : 0;
-  }
-
-  let currentClippingPolygonsShaderState = 0;
-  if (defined(clippingPolygons) && clippingPolygons.length > 0) {
-    currentClippingPolygonsShaderState = enableClippingPolygons
-      ? clippingPolygons.clippingPolygonsState
-      : 0;
-  }
-
-  let surfaceShader = surfaceTile.surfaceShader;
-  if (
-    defined(surfaceShader) &&
-    surfaceShader.numberOfDayTextures === numberOfDayTextures &&
-    surfaceShader.flags === flags &&
-    surfaceShader.material === this.material &&
-    surfaceShader.clippingShaderState === currentClippingShaderState &&
-    surfaceShader.clippingPolygonShaderState ===
-      currentClippingPolygonsShaderState
-  ) {
-    return surfaceShader.shaderProgram;
-  }
-
-  // New tile, or tile changed number of textures, flags, or clipping planes
-  let shadersByFlags = this._shadersByTexturesFlags[numberOfDayTextures];
-  if (!defined(shadersByFlags)) {
-    shadersByFlags = this._shadersByTexturesFlags[numberOfDayTextures] = [];
-  }
-
-  surfaceShader = shadersByFlags[flags];
-  if (
-    !defined(surfaceShader) ||
-    surfaceShader.material !== this.material ||
-    surfaceShader.clippingShaderState !== currentClippingShaderState ||
-    surfaceShader.clippingPolygonShaderState !==
-      currentClippingPolygonsShaderState
-  ) {
-    // Cache miss - we've never seen this combination of numberOfDayTextures and flags before.
-    const vs = this.baseVertexShaderSource.clone();
-    const fs = this.baseFragmentShaderSource.clone();
-
-    // Need to go before GlobeFS
-    if (currentClippingShaderState !== 0) {
-      fs.sources.unshift(
-        getClippingFunction(clippingPlanes, frameState.context),
-      );
-    }
-
-    // Need to go before GlobeFS
-    if (currentClippingPolygonsShaderState !== 0) {
-      fs.sources.unshift(getPolygonClippingFunction(frameState.context));
-      vs.sources.unshift(getUnpackClippingFunction(frameState.context));
-    }
-
-    vs.defines.push(quantizationDefine);
-    fs.defines.push(
-      `TEXTURE_UNITS ${numberOfDayTextures}`,
-      cartographicLimitRectangleDefine,
-      imageryCutoutDefine,
-    );
-
-    if (applyBrightness) {
-      fs.defines.push("APPLY_BRIGHTNESS");
-    }
-    if (applyContrast) {
-      fs.defines.push("APPLY_CONTRAST");
-    }
-    if (applyHue) {
-      fs.defines.push("APPLY_HUE");
-    }
-    if (applySaturation) {
-      fs.defines.push("APPLY_SATURATION");
-    }
-    if (applyGamma) {
-      fs.defines.push("APPLY_GAMMA");
-    }
-    if (applyAlpha) {
-      fs.defines.push("APPLY_ALPHA");
-    }
-    if (applyDayNightAlpha) {
-      fs.defines.push("APPLY_DAY_NIGHT_ALPHA");
-    }
-    if (hasWaterMask) {
-      fs.defines.push("HAS_WATER_MASK");
-    }
-    if (showReflectiveOcean) {
-      fs.defines.push("SHOW_REFLECTIVE_OCEAN");
-      vs.defines.push("SHOW_REFLECTIVE_OCEAN");
-    }
-    if (showOceanWaves) {
-      fs.defines.push("SHOW_OCEAN_WAVES");
-    }
-    if (colorToAlpha) {
-      fs.defines.push("APPLY_COLOR_TO_ALPHA");
-    }
-    if (showUndergroundColor) {
-      vs.defines.push("UNDERGROUND_COLOR");
-      fs.defines.push("UNDERGROUND_COLOR");
-    }
-    if (translucent) {
-      vs.defines.push("TRANSLUCENT");
-      fs.defines.push("TRANSLUCENT");
-    }
-    if (enableLighting) {
-      if (hasVertexNormals) {
-        vs.defines.push("ENABLE_VERTEX_LIGHTING");
-        fs.defines.push("ENABLE_VERTEX_LIGHTING");
-      } else {
-        vs.defines.push("ENABLE_DAYNIGHT_SHADING");
-        fs.defines.push("ENABLE_DAYNIGHT_SHADING");
-      }
-    }
-
-    if (dynamicAtmosphereLighting) {
-      vs.defines.push("DYNAMIC_ATMOSPHERE_LIGHTING");
-      fs.defines.push("DYNAMIC_ATMOSPHERE_LIGHTING");
-      if (dynamicAtmosphereLightingFromSun) {
-        vs.defines.push("DYNAMIC_ATMOSPHERE_LIGHTING_FROM_SUN");
-        fs.defines.push("DYNAMIC_ATMOSPHERE_LIGHTING_FROM_SUN");
-      }
-    }
-
-    if (showGroundAtmosphere) {
-      vs.defines.push("GROUND_ATMOSPHERE");
-      fs.defines.push("GROUND_ATMOSPHERE");
-      if (perFragmentGroundAtmosphere) {
-        vs.defines.push("PER_FRAGMENT_GROUND_ATMOSPHERE");
-        fs.defines.push("PER_FRAGMENT_GROUND_ATMOSPHERE");
-      }
-    }
-
-    vs.defines.push("INCLUDE_WEB_MERCATOR_Y");
-    fs.defines.push("INCLUDE_WEB_MERCATOR_Y");
-
-    if (enableFog) {
-      vs.defines.push("FOG");
-      fs.defines.push("FOG");
-    }
-
-    if (applySplit) {
-      fs.defines.push("APPLY_SPLIT");
-    }
-
-    if (enableClippingPlanes) {
-      fs.defines.push("ENABLE_CLIPPING_PLANES");
-    }
-
-    if (enableClippingPolygons) {
-      fs.defines.push("ENABLE_CLIPPING_POLYGONS");
-      vs.defines.push("ENABLE_CLIPPING_POLYGONS");
-
-      if (clippingPolygons.inverse) {
-        fs.defines.push("CLIPPING_INVERSE");
-      }
-
-      fs.defines.push(
-        `CLIPPING_POLYGON_REGIONS_LENGTH ${clippingPolygons.extentsCount}`,
-      );
-      vs.defines.push(
-        `CLIPPING_POLYGON_REGIONS_LENGTH ${clippingPolygons.extentsCount}`,
-      );
-    }
-
-    if (colorCorrect) {
-      fs.defines.push("COLOR_CORRECT");
-    }
-
-    if (highlightFillTile) {
-      fs.defines.push("HIGHLIGHT_FILL_TILE");
-    }
-
-    if (hasGeodeticSurfaceNormals) {
-      vs.defines.push("GEODETIC_SURFACE_NORMALS");
-    }
-
-    if (hasExaggeration) {
-      vs.defines.push("EXAGGERATION");
-    }
-
-    let computeDayColor =
-      "\
-    vec4 computeDayColor(vec4 initialColor, vec3 textureCoordinates, float nightBlend)\n\
-    {\n\
-        vec4 color = initialColor;\n";
-
-    if (hasImageryLayerCutout) {
-      computeDayColor +=
-        "\
-        vec4 cutoutAndColorResult;\n\
-        bool texelUnclipped;\n";
-    }
-
-    for (let i = 0; i < numberOfDayTextures; ++i) {
-      if (hasImageryLayerCutout) {
-        computeDayColor += `\
-        cutoutAndColorResult = u_dayTextureCutoutRectangles[${i}];\n\
-        texelUnclipped = v_textureCoordinates.x < cutoutAndColorResult.x || cutoutAndColorResult.z < v_textureCoordinates.x || v_textureCoordinates.y < cutoutAndColorResult.y || cutoutAndColorResult.w < v_textureCoordinates.y;\n\
-        cutoutAndColorResult = sampleAndBlend(\n`;
-      } else {
-        computeDayColor +=
-          "\
-        color = sampleAndBlend(\n";
-      }
-      computeDayColor += `\
-            color,\n\
-            u_dayTextures[${i}],\n\
-            u_dayTextureUseWebMercatorT[${i}] ? textureCoordinates.xz : textureCoordinates.xy,\n\
-            u_dayTextureTexCoordsRectangle[${i}],\n\
-            u_dayTextureTranslationAndScale[${i}],\n\
-            ${applyAlpha ? `u_dayTextureAlpha[${i}]` : "1.0"},\n\
-            ${applyDayNightAlpha ? `u_dayTextureNightAlpha[${i}]` : "1.0"},\n\
-            ${applyDayNightAlpha ? `u_dayTextureDayAlpha[${i}]` : "1.0"},\n\
-            ${applyBrightness ? `u_dayTextureBrightness[${i}]` : "0.0"},\n\
-            ${applyContrast ? `u_dayTextureContrast[${i}]` : "0.0"},\n\
-            ${applyHue ? `u_dayTextureHue[${i}]` : "0.0"},\n\
-            ${applySaturation ? `u_dayTextureSaturation[${i}]` : "0.0"},\n\
-            ${applyGamma ? `u_dayTextureOneOverGamma[${i}]` : "0.0"},\n\
-            ${applySplit ? `u_dayTextureSplit[${i}]` : "0.0"},\n\
-            ${colorToAlpha ? `u_colorsToAlpha[${i}]` : "vec4(0.0)"},\n\
-            nightBlend\);\n`;
-      if (hasImageryLayerCutout) {
-        computeDayColor +=
-          "\
-        color = czm_branchFreeTernary(texelUnclipped, cutoutAndColorResult, color);\n";
-      }
-    }
-
-    computeDayColor +=
-      "\
-        return color;\n\
-    }";
-
-    fs.sources.push(computeDayColor);
-
-    vs.sources.push(getPositionMode(sceneMode));
-    vs.sources.push(get2DYPositionFraction(useWebMercatorProjection));
-
-    const shader = ShaderProgram.fromCache({
-      context: frameState.context,
-      vertexShaderSource: vs,
-      fragmentShaderSource: fs,
-      attributeLocations: terrainEncoding.getAttributeLocations(),
-    });
-
-    surfaceShader = shadersByFlags[flags] = new GlobeSurfaceShader(
-      numberOfDayTextures,
-      flags,
-      this.material,
-      shader,
-      currentClippingShaderState,
-      currentClippingPolygonsShaderState,
-    );
-  }
-
-  surfaceTile.surfaceShader = surfaceShader;
-  return surfaceShader.shaderProgram;
-};
-
-GlobeSurfaceShaderSet.prototype.destroy = function () {
-  let flags;
-  let shader;
-
-  const shadersByTexturesFlags = this._shadersByTexturesFlags;
-  for (const textureCount in shadersByTexturesFlags) {
-    if (shadersByTexturesFlags.hasOwnProperty(textureCount)) {
-      const shadersByFlags = shadersByTexturesFlags[textureCount];
-      if (!defined(shadersByFlags)) {
-        continue;
-      }
-
-      for (flags in shadersByFlags) {
-        if (shadersByFlags.hasOwnProperty(flags)) {
-          shader = shadersByFlags[flags];
-          if (defined(shader)) {
-            shader.shaderProgram.destroy();
-          }
-        }
-      }
-    }
-  }
-
-  return destroyObject(this);
-};
 export default GlobeSurfaceShaderSet;