@cesium/engine 10.1.0 → 11.1.0

package/Source/Renderer/Buffer.js

@@ -19,13 +19,13 @@ function Buffer(options) {
 
   if (!defined(options.typedArray) && !defined(options.sizeInBytes)) {
     throw new DeveloperError(
-      "Either options.sizeInBytes or options.typedArray is required."
+      "Either options.sizeInBytes or options.typedArray is required.",
     );
   }
 
   if (defined(options.typedArray) && defined(options.sizeInBytes)) {
     throw new DeveloperError(
-      "Cannot pass in both options.sizeInBytes and options.typedArray."
+      "Cannot pass in both options.sizeInBytes and options.typedArray.",
     );
   }
 
@@ -33,7 +33,7 @@ function Buffer(options) {
     Check.typeOf.object("options.typedArray", options.typedArray);
     Check.typeOf.number(
       "options.typedArray.byteLength",
-      options.typedArray.byteLength
+      options.typedArray.byteLength,
     );
   }
 
@@ -184,7 +184,7 @@ Buffer.createIndexBuffer = function (options) {
     !options.context.elementIndexUint
   ) {
     throw new DeveloperError(
-      "IndexDatatype.UNSIGNED_INT requires OES_element_index_uint, which is not supported on this system.  Check context.elementIndexUint."
+      "IndexDatatype.UNSIGNED_INT requires OES_element_index_uint, which is not supported on this system.  Check context.elementIndexUint.",
     );
   }
   //>>includeEnd('debug');
@@ -250,7 +250,7 @@ Buffer.prototype.copyFromArrayView = function (arrayView, offsetInBytes) {
   Check.typeOf.number.lessThanOrEquals(
     "offsetInBytes + arrayView.byteLength",
     offsetInBytes + arrayView.byteLength,
-    this._sizeInBytes
+    this._sizeInBytes,
   );
   //>>includeEnd('debug');
 
@@ -265,7 +265,7 @@ Buffer.prototype.copyFromBuffer = function (
   readBuffer,
   readOffset,
   writeOffset,
-  sizeInBytes
+  sizeInBytes,
 ) {
   //>>includeStart('debug', pragmas.debug);
   if (!this._webgl2) {
@@ -276,7 +276,7 @@ Buffer.prototype.copyFromBuffer = function (
   }
   if (!defined(sizeInBytes) || sizeInBytes <= 0) {
     throw new DeveloperError(
-      "sizeInBytes must be defined and be greater than zero."
+      "sizeInBytes must be defined and be greater than zero.",
     );
   }
   if (
@@ -285,7 +285,7 @@ Buffer.prototype.copyFromBuffer = function (
     readOffset + sizeInBytes > readBuffer._sizeInBytes
   ) {
     throw new DeveloperError(
-      "readOffset must be greater than or equal to zero and readOffset + sizeInBytes must be less than of equal to readBuffer.sizeInBytes."
+      "readOffset must be greater than or equal to zero and readOffset + sizeInBytes must be less than of equal to readBuffer.sizeInBytes.",
     );
   }
   if (
@@ -294,7 +294,7 @@ Buffer.prototype.copyFromBuffer = function (
     writeOffset + sizeInBytes > this._sizeInBytes
   ) {
     throw new DeveloperError(
-      "writeOffset must be greater than or equal to zero and writeOffset + sizeInBytes must be less than of equal to this.sizeInBytes."
+      "writeOffset must be greater than or equal to zero and writeOffset + sizeInBytes must be less than of equal to this.sizeInBytes.",
     );
   }
   if (
@@ -303,7 +303,7 @@ Buffer.prototype.copyFromBuffer = function (
       (readOffset > writeOffset && readOffset < writeOffset + sizeInBytes))
   ) {
     throw new DeveloperError(
-      "When readBuffer is equal to this, the ranges [readOffset + sizeInBytes) and [writeOffset, writeOffset + sizeInBytes) must not overlap."
+      "When readBuffer is equal to this, the ranges [readOffset + sizeInBytes) and [writeOffset, writeOffset + sizeInBytes) must not overlap.",
     );
   }
   if (
@@ -313,7 +313,7 @@ Buffer.prototype.copyFromBuffer = function (
       readBuffer._bufferTarget === WebGLConstants.ELEMENT_ARRAY_BUFFER)
   ) {
     throw new DeveloperError(
-      "Can not copy an index buffer into another buffer type."
+      "Can not copy an index buffer into another buffer type.",
     );
   }
   //>>includeEnd('debug');
@@ -329,7 +329,7 @@ Buffer.prototype.copyFromBuffer = function (
     writeTarget,
     readOffset,
     writeOffset,
-    sizeInBytes
+    sizeInBytes,
   );
   gl.bindBuffer(writeTarget, null);
   gl.bindBuffer(readTarget, null);
@@ -339,7 +339,7 @@ Buffer.prototype.getBufferData = function (
   arrayView,
   sourceOffset,
   destinationOffset,
-  length
+  length,
 ) {
   sourceOffset = defaultValue(sourceOffset, 0);
   destinationOffset = defaultValue(destinationOffset, 0);
@@ -376,22 +376,22 @@ Buffer.prototype.getBufferData = function (
 
   if (destinationOffset < 0 || destinationOffset > arrayLength) {
     throw new DeveloperError(
-      "destinationOffset must be greater than zero and less than the arrayView length."
+      "destinationOffset must be greater than zero and less than the arrayView length.",
     );
   }
   if (destinationOffset + copyLength > arrayLength) {
     throw new DeveloperError(
-      "destinationOffset + length must be less than or equal to the arrayViewLength."
+      "destinationOffset + length must be less than or equal to the arrayViewLength.",
     );
   }
   if (sourceOffset < 0 || sourceOffset > this._sizeInBytes) {
     throw new DeveloperError(
-      "sourceOffset must be greater than zero and less than the buffers size."
+      "sourceOffset must be greater than zero and less than the buffers size.",
     );
   }
   if (sourceOffset + copyLength * elementSize > this._sizeInBytes) {
     throw new DeveloperError(
-      "sourceOffset + length must be less than the buffers size."
+      "sourceOffset + length must be less than the buffers size.",
     );
   }
   //>>includeEnd('debug');
@@ -404,7 +404,7 @@ Buffer.prototype.getBufferData = function (
     sourceOffset,
     arrayView,
     destinationOffset,
-    length
+    length,
   );
   gl.bindBuffer(target, null);
 };

package/Source/Renderer/ClearCommand.js

@@ -93,7 +93,7 @@ ClearCommand.ALL = Object.freeze(
     color: new Color(0.0, 0.0, 0.0, 0.0),
     depth: 1.0,
     stencil: 0.0,
-  })
+  }),
 );
 
 ClearCommand.prototype.execute = function (context, passState) {

package/Source/Renderer/ComputeEngine.js

@@ -76,7 +76,7 @@ ComputeEngine.prototype.execute = function (computeCommand) {
     !defined(computeCommand.shaderProgram)
   ) {
     throw new DeveloperError(
-      "computeCommand.fragmentShaderSource or computeCommand.shaderProgram is required."
+      "computeCommand.fragmentShaderSource or computeCommand.shaderProgram is required.",
     );
   }
 

package/Source/Renderer/Context.js

@@ -55,7 +55,7 @@ function Context(canvas, options) {
   webglOptions.stencil = defaultValue(webglOptions.stencil, true); // WebGL default is false
   webglOptions.powerPreference = defaultValue(
     webglOptions.powerPreference,
-    "high-performance"
+    "high-performance",
   ); // WebGL default is "default"
 
   const glContext = defined(getWebGLStub)
@@ -87,32 +87,32 @@ function Context(canvas, options) {
   this._stencilBits = gl.getParameter(gl.STENCIL_BITS);
 
   ContextLimits._maximumCombinedTextureImageUnits = gl.getParameter(
-    gl.MAX_COMBINED_TEXTURE_IMAGE_UNITS
+    gl.MAX_COMBINED_TEXTURE_IMAGE_UNITS,
   ); // min: 8
   ContextLimits._maximumCubeMapSize = gl.getParameter(
-    gl.MAX_CUBE_MAP_TEXTURE_SIZE
+    gl.MAX_CUBE_MAP_TEXTURE_SIZE,
   ); // min: 16
   ContextLimits._maximumFragmentUniformVectors = gl.getParameter(
-    gl.MAX_FRAGMENT_UNIFORM_VECTORS
+    gl.MAX_FRAGMENT_UNIFORM_VECTORS,
   ); // min: 16
   ContextLimits._maximumTextureImageUnits = gl.getParameter(
-    gl.MAX_TEXTURE_IMAGE_UNITS
+    gl.MAX_TEXTURE_IMAGE_UNITS,
   ); // min: 8
   ContextLimits._maximumRenderbufferSize = gl.getParameter(
-    gl.MAX_RENDERBUFFER_SIZE
+    gl.MAX_RENDERBUFFER_SIZE,
   ); // min: 1
   ContextLimits._maximumTextureSize = gl.getParameter(gl.MAX_TEXTURE_SIZE); // min: 64
   ContextLimits._maximumVaryingVectors = gl.getParameter(
-    gl.MAX_VARYING_VECTORS
+    gl.MAX_VARYING_VECTORS,
   ); // min: 8
   ContextLimits._maximumVertexAttributes = gl.getParameter(
-    gl.MAX_VERTEX_ATTRIBS
+    gl.MAX_VERTEX_ATTRIBS,
   ); // min: 8
   ContextLimits._maximumVertexTextureImageUnits = gl.getParameter(
-    gl.MAX_VERTEX_TEXTURE_IMAGE_UNITS
+    gl.MAX_VERTEX_TEXTURE_IMAGE_UNITS,
   ); // min: 0
   ContextLimits._maximumVertexUniformVectors = gl.getParameter(
-    gl.MAX_VERTEX_UNIFORM_VECTORS
+    gl.MAX_VERTEX_UNIFORM_VECTORS,
   ); // min: 128
 
   ContextLimits._maximumSamples = this._webgl2
@@ -133,7 +133,7 @@ function Context(canvas, options) {
 
   const highpFloat = gl.getShaderPrecisionFormat(
     gl.FRAGMENT_SHADER,
-    gl.HIGH_FLOAT
+    gl.HIGH_FLOAT,
   );
   ContextLimits._highpFloatSupported = highpFloat.precision !== 0;
   const highpInt = gl.getShaderPrecisionFormat(gl.FRAGMENT_SHADER, gl.HIGH_INT);
@@ -160,6 +160,8 @@ function Context(canvas, options) {
     "OES_texture_half_float_linear",
   ]);
 
+  this._supportsTextureLod = !!getExtension(gl, ["EXT_shader_texture_lod"]);
+
   this._colorBufferFloat = !!getExtension(gl, [
     "EXT_color_buffer_float",
     "WEBGL_color_buffer_float",
@@ -191,7 +193,7 @@ function Context(canvas, options) {
     this._astc,
     this._etc,
     this._etc1,
-    this._bc7
+    this._bc7,
   );
 
   const textureFilterAnisotropic = allowTextureFilterAnisotropic
@@ -202,7 +204,7 @@ function Context(canvas, options) {
     : undefined;
   this._textureFilterAnisotropic = textureFilterAnisotropic;
   ContextLimits._maximumTextureFilterAnisotropy = defined(
-    textureFilterAnisotropic
+    textureFilterAnisotropic,
   )
     ? gl.getParameter(textureFilterAnisotropic.MAX_TEXTURE_MAX_ANISOTROPY_EXT)
     : 1.0;
@@ -239,7 +241,7 @@ function Context(canvas, options) {
       count,
       type,
       offset,
-      instanceCount
+      instanceCount,
     ) {
       gl.drawElementsInstanced(mode, count, type, offset, instanceCount);
     };
@@ -274,14 +276,14 @@ function Context(canvas, options) {
         count,
         type,
         offset,
-        instanceCount
+        instanceCount,
       ) {
         instancedArrays.drawElementsInstancedANGLE(
           mode,
           count,
           type,
           offset,
-          instanceCount
+          instanceCount,
         );
       };
       glDrawArraysInstanced = function (mode, first, count, instanceCount) {
@@ -289,7 +291,7 @@ function Context(canvas, options) {
           mode,
           first,
           count,
-          instanceCount
+          instanceCount,
         );
       };
       glVertexAttribDivisor = function (index, divisor) {
@@ -413,7 +415,7 @@ function Context(canvas, options) {
 function getWebGLContext(canvas, webglOptions, requestWebgl1) {
   if (typeof WebGLRenderingContext === "undefined") {
     throw new RuntimeError(
-      "The browser does not support WebGL.  Visit http://get.webgl.org."
+      "The browser does not support WebGL.  Visit http://get.webgl.org.",
     );
   }
 
@@ -428,7 +430,7 @@ function getWebGLContext(canvas, webglOptions, requestWebgl1) {
 
   if (!defined(glContext)) {
     throw new RuntimeError(
-      "The browser supports WebGL, but initialization failed."
+      "The browser supports WebGL, but initialization failed.",
     );
   }
 
@@ -502,7 +504,7 @@ function throwOnError(gl, glFunc, glFuncArguments) {
   const error = gl.getError();
   if (error !== gl.NO_ERROR) {
     throw new RuntimeError(
-      createErrorMessage(gl, glFunc, glFuncArguments, error)
+      createErrorMessage(gl, glFunc, glFuncArguments, error),
     );
   }
 }
@@ -550,7 +552,7 @@ function wrapGL(gl, logFunction) {
       Object.defineProperty(
         glWrapper,
         propertyName,
-        makeGetterSetter(gl, propertyName, logFunction)
+        makeGetterSetter(gl, propertyName, logFunction),
       );
     }
   }
@@ -777,6 +779,19 @@ Object.defineProperties(Context.prototype, {
     },
   },
 
+  /**
+   * <code>true</code> if EXT_shader_texture_lod is supported. This extension provides
+   * access to explicit LOD selection in texture sampling functions.
+   * @memberof Context.prototype
+   * @type {boolean}
+   * @see {@link https://registry.khronos.org/webgl/extensions/EXT_shader_texture_lod/}
+   */
+  supportsTextureLod: {
+    get: function () {
+      return this._webgl2 || this._supportsTextureLod;
+    },
+  },
+
   /**
    * <code>true</code> if EXT_texture_filter_anisotropic is supported. This extension provides
    * access to anisotropic filtering for textured surfaces at an oblique angle from the viewer.
@@ -989,7 +1004,7 @@ Object.defineProperties(Context.prototype, {
       this._throwOnWebGLError = value;
       this._gl = wrapGL(
         this._originalGLContext,
-        value ? throwOnError : undefined
+        value ? throwOnError : undefined,
       );
     },
   },
@@ -1191,7 +1206,7 @@ function applyRenderState(context, renderState, passState, clear) {
     renderState,
     previousPassState,
     passState,
-    clear
+    clear,
   );
 }
 
@@ -1266,7 +1281,7 @@ Context.prototype.clear = function (clearCommand, passState) {
   // The command's framebuffer takes presidence over the pass' framebuffer, e.g., for off-screen rendering.
   const framebuffer = defaultValue(
     clearCommand.framebuffer,
-    passState.framebuffer
+    passState.framebuffer,
   );
   bindFramebuffer(this, framebuffer);
 
@@ -1278,13 +1293,13 @@ function beginDraw(
   framebuffer,
   passState,
   shaderProgram,
-  renderState
+  renderState,
 ) {
   //>>includeStart('debug', pragmas.debug);
   if (defined(framebuffer) && renderState.depthTest) {
     if (renderState.depthTest.enabled && !framebuffer.hasDepthAttachment) {
       throw new DeveloperError(
-        "The depth test can not be enabled (drawCommand.renderState.depthTest.enabled) because the framebuffer (drawCommand.framebuffer) does not have a depth or depth-stencil renderbuffer."
+        "The depth test can not be enabled (drawCommand.renderState.depthTest.enabled) because the framebuffer (drawCommand.framebuffer) does not have a depth or depth-stencil renderbuffer.",
       );
     }
   }
@@ -1295,7 +1310,7 @@ function beginDraw(
   shaderProgram._bind();
   context._maxFrameTextureUnitIndex = Math.max(
     context._maxFrameTextureUnitIndex,
-    shaderProgram.maximumTextureUnitIndex
+    shaderProgram.maximumTextureUnitIndex,
   );
 }
 
@@ -1309,7 +1324,7 @@ function continueDraw(context, drawCommand, shaderProgram, uniformMap) {
   //>>includeStart('debug', pragmas.debug);
   if (!PrimitiveType.validate(primitiveType)) {
     throw new DeveloperError(
-      "drawCommand.primitiveType is required and must be valid."
+      "drawCommand.primitiveType is required and must be valid.",
     );
   }
 
@@ -1321,7 +1336,7 @@ function continueDraw(context, drawCommand, shaderProgram, uniformMap) {
   Check.typeOf.number.greaterThanOrEquals(
     "drawCommand.instanceCount",
     instanceCount,
-    0
+    0,
   );
   if (instanceCount > 0 && !context.instancedArrays) {
     throw new DeveloperError("Instanced arrays extension is not supported");
@@ -1332,7 +1347,7 @@ function continueDraw(context, drawCommand, shaderProgram, uniformMap) {
   shaderProgram._setUniforms(
     uniformMap,
     context._us,
-    context.validateShaderProgram
+    context.validateShaderProgram,
   );
 
   va._bind();
@@ -1350,7 +1365,7 @@ function continueDraw(context, drawCommand, shaderProgram, uniformMap) {
         primitiveType,
         count,
         indexBuffer.indexDatatype,
-        offset
+        offset,
       );
     } else {
       context.glDrawElementsInstanced(
@@ -1358,7 +1373,7 @@ function continueDraw(context, drawCommand, shaderProgram, uniformMap) {
         count,
         indexBuffer.indexDatatype,
         offset,
-        instanceCount
+        instanceCount,
       );
     }
   } else {
@@ -1374,7 +1389,7 @@ function continueDraw(context, drawCommand, shaderProgram, uniformMap) {
         primitiveType,
         offset,
         count,
-        instanceCount
+        instanceCount,
       );
     }
   }
@@ -1386,7 +1401,7 @@ Context.prototype.draw = function (
   drawCommand,
   passState,
   shaderProgram,
-  uniformMap
+  uniformMap,
 ) {
   //>>includeStart('debug', pragmas.debug);
   Check.defined("drawCommand", drawCommand);
@@ -1394,14 +1409,14 @@ Context.prototype.draw = function (
   //>>includeEnd('debug');
 
   passState = defaultValue(passState, this._defaultPassState);
-  // The command's framebuffer takes presidence over the pass' framebuffer, e.g., for off-screen rendering.
+  // The command's framebuffer takes precedence over the pass' framebuffer, e.g., for off-screen rendering.
   const framebuffer = defaultValue(
     drawCommand._framebuffer,
-    passState.framebuffer
+    passState.framebuffer,
   );
   const renderState = defaultValue(
     drawCommand._renderState,
-    this._defaultRenderState
+    this._defaultRenderState,
   );
   shaderProgram = defaultValue(shaderProgram, drawCommand._shaderProgram);
   uniformMap = defaultValue(uniformMap, drawCommand._uniformMap);
@@ -1466,7 +1481,7 @@ Context.prototype.readPixels = function (readState) {
     PixelFormat.RGBA,
     pixelDatatype,
     width,
-    height
+    height,
   );
 
   bindFramebuffer(this, framebuffer);
@@ -1478,7 +1493,7 @@ Context.prototype.readPixels = function (readState) {
     height,
     PixelFormat.RGBA,
     PixelDatatype.toWebGLConstant(pixelDatatype, this),
-    pixels
+    pixels,
   );
 
   return pixels;
@@ -1529,7 +1544,7 @@ Context.prototype.getViewportQuadVertexArray = function () {
 
 Context.prototype.createViewportQuadCommand = function (
   fragmentShaderSource,
-  overrides
+  overrides,
 ) {
   overrides = defaultValue(overrides, defaultValue.EMPTY_OBJECT);