@cesium/engine 22.2.0 → 23.0.0

package/Source/DataSources/CzmlDataSource.js

@@ -4817,7 +4817,7 @@ function DocumentPacket() {
  *
  * @param {string} [name] An optional name for the data source.  This value will be overwritten if a loaded document contains a name.
  *
- * @demo {@link https://sandcastle.cesium.com/index.html?src=CZML.html|Cesium Sandcastle CZML Demo}
+ * @demo {@link https://sandcastle.cesium.com/index.html?id=czml|Cesium Sandcastle CZML Demo}
  */
 function CzmlDataSource(name) {
   this._name = name;

package/Source/DataSources/EllipseGraphics.js

@@ -43,7 +43,7 @@ import createPropertyDescriptor from "./createPropertyDescriptor.js";
  *
  * @param {EllipseGraphics.ConstructorOptions} [options] Object describing initialization options
  *
- * @demo {@link https://sandcastle.cesium.com/index.html?src=Circles and Ellipses.html|Cesium Sandcastle Circles and Ellipses Demo}
+ * @demo {@link https://sandcastle.cesium.com/index.html?id=circles-and-ellipses|Cesium Sandcastle Circles and Ellipses Demo}
  */
 function EllipseGraphics(options) {
   this._definitionChanged = new Event();

package/Source/DataSources/EllipsoidGraphics.js

@@ -38,7 +38,7 @@ import createPropertyDescriptor from "./createPropertyDescriptor.js";
  *
  * @param {EllipsoidGraphics.ConstructorOptions} [options] Object describing initialization options
  *
- * @demo {@link https://sandcastle.cesium.com/index.html?src=Spheres%20and%20Ellipsoids.html|Cesium Sandcastle Spheres and Ellipsoids Demo}
+ * @demo {@link https://sandcastle.cesium.com/index.html?id=spheres-and-ellipsoids|Cesium Sandcastle Spheres and Ellipsoids Demo}
  */
 function EllipsoidGraphics(options) {
   this._definitionChanged = new Event();

package/Source/DataSources/Entity.js

@@ -302,7 +302,7 @@ Object.defineProperties(Entity.prototype, {
   },
   /**
    * Gets or sets the entity's tracking reference frame.
-   * @demo {@link https://sandcastle.cesium.com/index.html?src=Entity tracking.html|Cesium Sandcastle Entity tracking Demo}
+   * @demo {@link https://sandcastle.cesium.com/index.html?id=entity-tracking|Cesium Sandcastle Entity tracking Demo}
    *
    * @memberof Entity.prototype
    * @type {TrackingReferenceFrame}

package/Source/DataSources/EntityCluster.js

@@ -30,7 +30,7 @@ import KDBush from "kdbush";
  * @alias EntityCluster
  * @constructor
  *
- * @demo {@link https://sandcastle.cesium.com/index.html?src=Clustering.html|Cesium Sandcastle Clustering Demo}
+ * @demo {@link https://sandcastle.cesium.com/index.html?id=clustering|Cesium Sandcastle Clustering Demo}
  */
 function EntityCluster(options) {
   options = options ?? Frozen.EMPTY_OBJECT;
@@ -330,7 +330,7 @@ function createDeclutterCallback(entityCluster) {
     let collectionIndex;
 
     if (points.length > 0) {
-      const index = new KDBush(points.length, 64, Uint32Array);
+      const index = new KDBush(points.length, 64, Float64Array);
       for (let p = 0; p < points.length; ++p) {
         index.add(points[p].coord.x, points[p].coord.y);
       }

package/Source/DataSources/GeoJsonDataSource.js

@@ -578,8 +578,8 @@ function processTopology(dataSource, geoJson, geometry, crsFunction, options) {
  * @param {string} [name] The name of this data source.  If undefined, a name will be taken from
  *                        the name of the GeoJSON file.
  *
- * @demo {@link https://sandcastle.cesium.com/index.html?src=GeoJSON%20and%20TopoJSON.html|Cesium Sandcastle GeoJSON and TopoJSON Demo}
- * @demo {@link https://sandcastle.cesium.com/index.html?src=GeoJSON%20simplestyle.html|Cesium Sandcastle GeoJSON simplestyle Demo}
+ * @demo {@link https://sandcastle.cesium.com/index.html?id=geojson-and-topojson|Cesium Sandcastle GeoJSON and TopoJSON Demo}
+ * @demo {@link https://sandcastle.cesium.com/index.html?id=geojson-simplestyle|Cesium Sandcastle GeoJSON simplestyle Demo}
  *
  * @example
  * const viewer = new Cesium.Viewer('cesiumContainer');

package/Source/DataSources/GpxDataSource.js

@@ -738,7 +738,7 @@ function load(dataSource, entityCollection, data, options) {
  * @see {@link http://www.topografix.com/gpx.asp|Topografix GPX Standard}
  * @see {@link http://www.topografix.com/gpx/1/1/|Topografix GPX Documentation}
  *
- * @demo {@link http://sandcastle.cesium.com/index.html?src=GPX.html}
+ * @demo {@link http://sandcastle.cesium.com/index.html?id=gpx}
  *
  * @example
  * const viewer = new Cesium.Viewer('cesiumContainer');

package/Source/DataSources/KmlDataSource.js

@@ -3518,7 +3518,7 @@ function load(dataSource, entityCollection, data, options) {
  * @see {@link http://www.opengeospatial.org/standards/kml/|Open Geospatial Consortium KML Standard}
  * @see {@link https://developers.google.com/kml/|Google KML Documentation}
  *
- * @demo {@link https://sandcastle.cesium.com/index.html?src=KML.html|Cesium Sandcastle KML Demo}
+ * @demo {@link https://sandcastle.cesium.com/index.html?id=kml|Cesium Sandcastle KML Demo}
  *
  * @example
  * const viewer = new Cesium.Viewer('cesiumContainer');

package/Source/DataSources/KmlTour.js

@@ -14,7 +14,7 @@ import Event from "../Core/Event.js";
  * @see KmlTourFlyTo
  * @see KmlTourWait
  *
- * @demo {@link https://sandcastle.cesium.com/?src=KML%20Tours.html|KML Tours}
+ * @demo {@link https://sandcastle.cesium.com/?id=kml-tours|KML Tours}
  */
 function KmlTour(name, id) {
   /**

package/Source/DataSources/LabelGraphics.js

@@ -46,7 +46,7 @@ import createPropertyDescriptor from "./createPropertyDescriptor.js";
  *
  * @param {LabelGraphics.ConstructorOptions} [options] Object describing initialization options
  *
- * @demo {@link https://sandcastle.cesium.com/index.html?src=Labels.html|Cesium Sandcastle Labels Demo}
+ * @demo {@link https://sandcastle.cesium.com/index.html?id=labels|Cesium Sandcastle Labels Demo}
  */
 function LabelGraphics(options) {
   this._definitionChanged = new Event();

package/Source/DataSources/ModelGraphics.js

@@ -66,7 +66,7 @@ function createEnvironmentMapPropertyBag(value) {
  *
  * @param {ModelGraphics.ConstructorOptions} [options] Object describing initialization options
  *
- * @demo {@link https://sandcastle.cesium.com/index.html?src=3D%20Models.html|Cesium Sandcastle 3D Models Demo}
+ * @demo {@link https://sandcastle.cesium.com/index.html?id=3d-models|Cesium Sandcastle 3D Models Demo}
  */
 function ModelGraphics(options) {
   this._definitionChanged = new Event();

package/Source/DataSources/PlaneGraphics.js

@@ -30,7 +30,7 @@ import createPropertyDescriptor from "./createPropertyDescriptor.js";
  *
  * @param {PlaneGraphics.ConstructorOptions} [options] Object describing initialization options
  *
- * @demo {@link https://sandcastle.cesium.com/index.html?src=Plane.html|Cesium Sandcastle Plane Demo}
+ * @demo {@link https://sandcastle.cesium.com/index.html?id=plane|Cesium Sandcastle Plane Demo}
  */
 function PlaneGraphics(options) {
   this._definitionChanged = new Event();

package/Source/DataSources/PolygonGraphics.js

@@ -55,7 +55,7 @@ function createPolygonHierarchyProperty(value) {
  * @param {PolygonGraphics.ConstructorOptions} [options] Object describing initialization options
  *
  * @see Entity
- * @demo {@link https://sandcastle.cesium.com/index.html?src=Polygon.html|Cesium Sandcastle Polygon Demo}
+ * @demo {@link https://sandcastle.cesium.com/index.html?id=polygon|Cesium Sandcastle Polygon Demo}
  */
 function PolygonGraphics(options) {
   this._definitionChanged = new Event();

package/Source/DataSources/PolylineGraphics.js

@@ -35,7 +35,7 @@ import createPropertyDescriptor from "./createPropertyDescriptor.js";
  * @param {PolylineGraphics.ConstructorOptions} [options] Object describing initialization options
  *
  * @see Entity
- * @demo {@link https://sandcastle.cesium.com/index.html?src=Polyline.html|Cesium Sandcastle Polyline Demo}
+ * @demo {@link https://sandcastle.cesium.com/index.html?id=polyline|Cesium Sandcastle Polyline Demo}
  */
 function PolylineGraphics(options) {
   this._definitionChanged = new Event();

package/Source/DataSources/PolylineVolumeGraphics.js

@@ -34,7 +34,7 @@ import createPropertyDescriptor from "./createPropertyDescriptor.js";
  * @param {PolylineVolumeGraphics.ConstructorOptions} [options] Object describing initialization options
  *
  * @see Entity
- * @demo {@link https://sandcastle.cesium.com/index.html?src=Polyline%20Volume.html|Cesium Sandcastle Polyline Volume Demo}
+ * @demo {@link https://sandcastle.cesium.com/index.html?id=polyline-volume|Cesium Sandcastle Polyline Volume Demo}
  */
 function PolylineVolumeGraphics(options) {
   this._definitionChanged = new Event();

package/Source/DataSources/RectangleGraphics.js

@@ -41,7 +41,7 @@ import createPropertyDescriptor from "./createPropertyDescriptor.js";
  * @param {RectangleGraphics.ConstructorOptions} [options] Object describing initialization options
  *
  * @see Entity
- * @demo {@link https://sandcastle.cesium.com/index.html?src=Rectangle.html|Cesium Sandcastle Rectangle Demo}
+ * @demo {@link https://sandcastle.cesium.com/index.html?id=rectangle|Cesium Sandcastle Rectangle Demo}
  */
 function RectangleGraphics(options) {
   this._definitionChanged = new Event();

package/Source/DataSources/WallGraphics.js

@@ -34,7 +34,7 @@ import createPropertyDescriptor from "./createPropertyDescriptor.js";
  * @param {WallGraphics.ConstructorOptions} [options] Object describing initialization options
  *
  * @see Entity
- * @demo {@link https://sandcastle.cesium.com/index.html?src=Wall.html|Cesium Sandcastle Wall Demo}
+ * @demo {@link https://sandcastle.cesium.com/index.html?id=wall|Cesium Sandcastle Wall Demo}
  */
 function WallGraphics(options) {
   this._definitionChanged = new Event();

package/Source/DataSources/exportKml.js

@@ -263,7 +263,7 @@ IdManager.prototype.get = function (id) {
  * @param {boolean} [options.kmz=false] If true KML and external files will be compressed into a kmz file.
  *
  * @returns {Promise<exportKmlResultKml|exportKmlResultKmz>} A promise that resolved to an object containing the KML string and a dictionary of external file blobs, or a kmz file as a blob if options.kmz is true.
- * @demo {@link https://sandcastle.cesium.com/index.html?src=Export%20KML.html|Cesium Sandcastle KML Export Demo}
+ * @demo {@link https://sandcastle.cesium.com/index.html?id=export-kml|Cesium Sandcastle KML Export Demo}
  * @example
  * Cesium.exportKml({
  *      entities: entityCollection

package/Source/Renderer/Context.js

@@ -86,32 +86,33 @@ function Context(canvas, options) {
 
   ContextLimits._maximumCombinedTextureImageUnits = gl.getParameter(
     gl.MAX_COMBINED_TEXTURE_IMAGE_UNITS,
-  ); // min: 8
+  );
   ContextLimits._maximumCubeMapSize = gl.getParameter(
     gl.MAX_CUBE_MAP_TEXTURE_SIZE,
-  ); // min: 16
+  );
   ContextLimits._maximumFragmentUniformVectors = gl.getParameter(
     gl.MAX_FRAGMENT_UNIFORM_VECTORS,
-  ); // min: 16
+  );
   ContextLimits._maximumTextureImageUnits = gl.getParameter(
     gl.MAX_TEXTURE_IMAGE_UNITS,
-  ); // min: 8
+  );
   ContextLimits._maximumRenderbufferSize = gl.getParameter(
     gl.MAX_RENDERBUFFER_SIZE,
-  ); // min: 1
-  ContextLimits._maximumTextureSize = gl.getParameter(gl.MAX_TEXTURE_SIZE); // min: 64
+  );
+  ContextLimits._maximumTextureSize = gl.getParameter(gl.MAX_TEXTURE_SIZE);
+  ContextLimits._maximum3DTextureSize = gl.getParameter(gl.MAX_3D_TEXTURE_SIZE);
   ContextLimits._maximumVaryingVectors = gl.getParameter(
     gl.MAX_VARYING_VECTORS,
-  ); // min: 8
+  );
   ContextLimits._maximumVertexAttributes = gl.getParameter(
     gl.MAX_VERTEX_ATTRIBS,
-  ); // min: 8
+  );
   ContextLimits._maximumVertexTextureImageUnits = gl.getParameter(
     gl.MAX_VERTEX_TEXTURE_IMAGE_UNITS,
-  ); // min: 0
+  );
   ContextLimits._maximumVertexUniformVectors = gl.getParameter(
     gl.MAX_VERTEX_UNIFORM_VECTORS,
-  ); // min: 128
+  );
 
   ContextLimits._maximumSamples = this._webgl2
     ? gl.getParameter(gl.MAX_SAMPLES)

package/Source/Renderer/ContextLimits.js

@@ -10,6 +10,7 @@ const ContextLimits = {
   _maximumTextureImageUnits: 0,
   _maximumRenderbufferSize: 0,
   _maximumTextureSize: 0,
+  _maximum3DTextureSize: 0,
   _maximumVaryingVectors: 0,
   _maximumVertexAttributes: 0,
   _maximumVertexTextureImageUnits: 0,
@@ -31,11 +32,13 @@ const ContextLimits = {
 Object.defineProperties(ContextLimits, {
   /**
    * The maximum number of texture units that can be used from the vertex and fragment
-   * shader with this WebGL implementation.  The minimum is eight.  If both shaders access the
-   * same texture unit, this counts as two texture units.
+   * shader with this WebGL implementation.
+   * If both shaders access the same texture unit, this counts as two texture units.
+   * The minimum in WebGL2 contexts is 32, or 8 in WebGL1 contexts.
    * @memberof ContextLimits
    * @type {number}
-   * @see {@link https://www.khronos.org/opengles/sdk/docs/man/xhtml/glGet.xml|glGet} with <code>MAX_COMBINED_TEXTURE_IMAGE_UNITS</code>.
+   * @see {@link https://registry.khronos.org/OpenGL-Refpages/es3.0/html/glGet.xhtml|glGet in OpenGL ES 3.0} with <code>MAX_COMBINED_TEXTURE_IMAGE_UNITS</code>.
+   * @see {@link https://registry.khronos.org/OpenGL-Refpages/es2.0/xhtml/glGet.xml|glGet in OpenGL ES 2.0} for WebGL1 contexts.
    */
   maximumCombinedTextureImageUnits: {
     get: function () {
@@ -45,10 +48,12 @@ Object.defineProperties(ContextLimits, {
 
   /**
    * The approximate maximum cube map width and height supported by this WebGL implementation.
-   * The minimum is 16, but most desktop and laptop implementations will support much larger sizes like 8,192.
+   * The minimum in WebGL2 contexts is 2048, but most desktop and laptop implementations will support much larger sizes like 8192.
+   * The minimum in WebGL1 contexts is 16.
    * @memberof ContextLimits
    * @type {number}
-   * @see {@link https://www.khronos.org/opengles/sdk/docs/man/xhtml/glGet.xml|glGet} with <code>MAX_CUBE_MAP_TEXTURE_SIZE</code>.
+   * @see {@link https://registry.khronos.org/OpenGL-Refpages/es3.0/html/glGet.xhtml|glGet in OpenGL ES 3.0} with <code>MAX_CUBE_MAP_TEXTURE_SIZE</code>.
+   * @see {@link https://registry.khronos.org/OpenGL-Refpages/es2.0/xhtml/glGet.xml|glGet in OpenGL ES 2.0} for WebGL1 contexts.
    */
   maximumCubeMapSize: {
     get: function () {
@@ -58,10 +63,12 @@ Object.defineProperties(ContextLimits, {
 
   /**
    * The maximum number of <code>vec4</code>, <code>ivec4</code>, and <code>bvec4</code>
-   * uniforms that can be used by a fragment shader with this WebGL implementation.  The minimum is 16.
+   * uniforms that can be used by a fragment shader with this WebGL implementation.
+   * The minimum in WebGL2 contexts is 224, or 16 in WebGL1 contexts.
    * @memberof ContextLimits
    * @type {number}
-   * @see {@link https://www.khronos.org/opengles/sdk/docs/man/xhtml/glGet.xml|glGet} with <code>MAX_FRAGMENT_UNIFORM_VECTORS</code>.
+   * @see {@link https://registry.khronos.org/OpenGL-Refpages/es3.0/html/glGet.xhtml|glGet in OpenGL ES 3.0} with <code>MAX_FRAGMENT_UNIFORM_VECTORS</code>.
+   * @see {@link https://registry.khronos.org/OpenGL-Refpages/es2.0/xhtml/glGet.xml|glGet in OpenGL ES 2.0} for WebGL1 contexts.
    */
   maximumFragmentUniformVectors: {
     get: function () {
@@ -70,10 +77,12 @@ Object.defineProperties(ContextLimits, {
   },
 
   /**
-   * The maximum number of texture units that can be used from the fragment shader with this WebGL implementation.  The minimum is eight.
+   * The maximum number of texture units that can be used from the fragment shader with this WebGL implementation.
+   * The minimum in WebGL2 contexts is 16, or 8 in WebGL1 contexts.
    * @memberof ContextLimits
    * @type {number}
-   * @see {@link https://www.khronos.org/opengles/sdk/docs/man/xhtml/glGet.xml|glGet} with <code>MAX_TEXTURE_IMAGE_UNITS</code>.
+   * @see {@link https://registry.khronos.org/OpenGL-Refpages/es3.0/html/glGet.xhtml|glGet in OpenGL ES 3.0} with <code>MAX_TEXTURE_IMAGE_UNITS</code>.
+   * @see {@link https://registry.khronos.org/OpenGL-Refpages/es2.0/xhtml/glGet.xml|glGet in OpenGL ES 2.0} for WebGL1 contexts.
    */
   maximumTextureImageUnits: {
     get: function () {
@@ -83,10 +92,12 @@ Object.defineProperties(ContextLimits, {
 
   /**
    * The maximum renderbuffer width and height supported by this WebGL implementation.
-   * The minimum is 16, but most desktop and laptop implementations will support much larger sizes like 8,192.
+   * The minimum in WebGL2 contexts is 2048, but most desktop and laptop implementations will support much larger sizes like 8192.
+   * The minimum in WebGL1 contexts is 1.
    * @memberof ContextLimits
    * @type {number}
-   * @see {@link https://www.khronos.org/opengles/sdk/docs/man/xhtml/glGet.xml|glGet} with <code>MAX_RENDERBUFFER_SIZE</code>.
+   * @see {@link https://registry.khronos.org/OpenGL-Refpages/es3.0/html/glGet.xhtml|glGet in OpenGL ES 3.0} with <code>MAX_RENDERBUFFER_SIZE</code>.
+   * @see {@link https://registry.khronos.org/OpenGL-Refpages/es2.0/xhtml/glGet.xml|glGet in OpenGL ES 2.0} for WebGL1 contexts.
    */
   maximumRenderbufferSize: {
     get: function () {
@@ -96,10 +107,12 @@ Object.defineProperties(ContextLimits, {
 
   /**
    * The approximate maximum texture width and height supported by this WebGL implementation.
-   * The minimum is 64, but most desktop and laptop implementations will support much larger sizes like 8,192.
+   * The minimum in WebGL2 contexts is 2048, but most desktop and laptop implementations will support much larger sizes like 8192.
+   * The minimum in WebGL1 contexts is 64.
    * @memberof ContextLimits
    * @type {number}
-   * @see {@link https://www.khronos.org/opengles/sdk/docs/man/xhtml/glGet.xml|glGet} with <code>MAX_TEXTURE_SIZE</code>.
+   * @see {@link https://registry.khronos.org/OpenGL-Refpages/es3.0/html/glGet.xhtml|glGet in OpenGL ES 3.0} with <code>MAX_TEXTURE_SIZE</code>.
+   * @see {@link https://registry.khronos.org/OpenGL-Refpages/es2.0/xhtml/glGet.xml|glGet in OpenGL ES 2.0} for WebGL1 contexts.
    */
   maximumTextureSize: {
     get: function () {
@@ -107,12 +120,27 @@ Object.defineProperties(ContextLimits, {
     },
   },
 
+  /**
+   * The approximate maximum texture width, height, and depth supported by this WebGL2 implementation.
+   * The minimum is 256, but most desktop and laptop implementations will support much larger sizes like 2048.
+   * 3D textures are not supported in WebGL1 contexts.
+   * @memberof ContextLimits
+   * @type {number}
+   * @see {@link https://registry.khronos.org/OpenGL-Refpages/es3.0/html/glGet.xhtml|glGet in OpenGL ES 3.0} with <code>MAX_3D_TEXTURE_SIZE</code>.
+   */
+  maximum3DTextureSize: {
+    get: function () {
+      return ContextLimits._maximum3DTextureSize;
+    },
+  },
+
   /**
    * The maximum number of <code>vec4</code> varying variables supported by this WebGL implementation.
-   * The minimum is eight.  Matrices and arrays count as multiple <code>vec4</code>s.
+   * The minimum is 15 in WebGL2 contexts, or 8 in WebGL1 contexts. Matrices and arrays count as multiple <code>vec4</code>s.
    * @memberof ContextLimits
    * @type {number}
-   * @see {@link https://www.khronos.org/opengles/sdk/docs/man/xhtml/glGet.xml|glGet} with <code>MAX_VARYING_VECTORS</code>.
+   * @see {@link https://registry.khronos.org/OpenGL-Refpages/es3.0/html/glGet.xhtml|glGet in OpenGL ES 3.0} with <code>MAX_VARYING_VECTORS</code>.
+   * @see {@link https://registry.khronos.org/OpenGL-Refpages/es2.0/xhtml/glGet.xml|glGet in OpenGL ES 2.0} for WebGL1 contexts.
    */
   maximumVaryingVectors: {
     get: function () {
@@ -121,10 +149,12 @@ Object.defineProperties(ContextLimits, {
   },
 
   /**
-   * The maximum number of <code>vec4</code> vertex attributes supported by this WebGL implementation.  The minimum is eight.
+   * The maximum number of <code>vec4</code> vertex attributes supported by this WebGL implementation.
+   * The minimum is 16 in WebGL2 contexts, or 8 in WebGL1 contexts.
    * @memberof ContextLimits
    * @type {number}
-   * @see {@link https://www.khronos.org/opengles/sdk/docs/man/xhtml/glGet.xml|glGet} with <code>MAX_VERTEX_ATTRIBS</code>.
+   * @see {@link https://registry.khronos.org/OpenGL-Refpages/es3.0/html/glGet.xhtml|glGet in OpenGL ES 3.0} with <code>MAX_VERTEX_ATTRIBS</code>.
+   * @see {@link https://registry.khronos.org/OpenGL-Refpages/es2.0/xhtml/glGet.xml|glGet in OpenGL ES 2.0} for WebGL1 contexts.
    */
   maximumVertexAttributes: {
     get: function () {
@@ -134,10 +164,11 @@ Object.defineProperties(ContextLimits, {
 
   /**
    * The maximum number of texture units that can be used from the vertex shader with this WebGL implementation.
-   * The minimum is zero, which means the GL does not support vertex texture fetch.
+   * The minimum is 16 in WebGL2 contexts, or 0 in WebGL1 contexts.
    * @memberof ContextLimits
    * @type {number}
-   * @see {@link https://www.khronos.org/opengles/sdk/docs/man/xhtml/glGet.xml|glGet} with <code>MAX_VERTEX_TEXTURE_IMAGE_UNITS</code>.
+   * @see {@link https://registry.khronos.org/OpenGL-Refpages/es3.0/html/glGet.xhtml|glGet in OpenGL ES 3.0} with <code>MAX_VERTEX_TEXTURE_IMAGE_UNITS</code>.
+   * @see {@link https://registry.khronos.org/OpenGL-Refpages/es2.0/xhtml/glGet.xml|glGet in OpenGL ES 2.0} for WebGL1 contexts.
    */
   maximumVertexTextureImageUnits: {
     get: function () {
@@ -147,10 +178,12 @@ Object.defineProperties(ContextLimits, {
 
   /**
    * The maximum number of <code>vec4</code>, <code>ivec4</code>, and <code>bvec4</code>
-   * uniforms that can be used by a vertex shader with this WebGL implementation.  The minimum is 16.
+   * uniforms that can be used by a vertex shader with this WebGL implementation.
+   * The minimum is 256 in WebGL2 contexts, or 128 in WebGL1 contexts.
    * @memberof ContextLimits
    * @type {number}
-   * @see {@link https://www.khronos.org/opengles/sdk/docs/man/xhtml/glGet.xml|glGet} with <code>MAX_VERTEX_UNIFORM_VECTORS</code>.
+   * @see {@link https://registry.khronos.org/OpenGL-Refpages/es3.0/html/glGet.xhtml|glGet in OpenGL ES 3.0} with <code>MAX_VERTEX_UNIFORM_VECTORS</code>.
+   * @see {@link https://registry.khronos.org/OpenGL-Refpages/es2.0/xhtml/glGet.xml|glGet in OpenGL ES 2.0} for WebGL1 contexts.
    */
   maximumVertexUniformVectors: {
     get: function () {
@@ -159,10 +192,10 @@ Object.defineProperties(ContextLimits, {
   },
 
   /**
-   * The minimum aliased line width, in pixels, supported by this WebGL implementation.  It will be at most one.
+   * The minimum aliased line width, in pixels, supported by this WebGL implementation. It will be at most one.
+   * @see {@link https://registry.khronos.org/OpenGL-Refpages/es3.0/html/glGet.xhtml|glGet in OpenGL ES 3.0} with <code>ALIASED_LINE_WIDTH_RANGE</code>.
    * @memberof ContextLimits
    * @type {number}
-   * @see {@link https://www.khronos.org/opengles/sdk/docs/man/xhtml/glGet.xml|glGet} with <code>ALIASED_LINE_WIDTH_RANGE</code>.
    */
   minimumAliasedLineWidth: {
     get: function () {
@@ -171,10 +204,10 @@ Object.defineProperties(ContextLimits, {
   },
 
   /**
-   * The maximum aliased line width, in pixels, supported by this WebGL implementation.  It will be at least one.
+   * The maximum aliased line width, in pixels, supported by this WebGL implementation. It will be at least one.
+   * @see {@link https://registry.khronos.org/OpenGL-Refpages/es3.0/html/glGet.xhtml|glGet in OpenGL ES 3.0} with <code>ALIASED_LINE_WIDTH_RANGE</code>.
    * @memberof ContextLimits
    * @type {number}
-   * @see {@link https://www.khronos.org/opengles/sdk/docs/man/xhtml/glGet.xml|glGet} with <code>ALIASED_LINE_WIDTH_RANGE</code>.
    */
   maximumAliasedLineWidth: {
     get: function () {
@@ -183,10 +216,10 @@ Object.defineProperties(ContextLimits, {
   },
 
   /**
-   * The minimum aliased point size, in pixels, supported by this WebGL implementation.  It will be at most one.
+   * The minimum aliased point size, in pixels, supported by this WebGL implementation. It will be at most one.
+   * @see {@link https://registry.khronos.org/OpenGL-Refpages/es3.0/html/glGet.xhtml|glGet in OpenGL ES 3.0} with <code>ALIASED_POINT_SIZE_RANGE</code>.
    * @memberof ContextLimits
    * @type {number}
-   * @see {@link https://www.khronos.org/opengles/sdk/docs/man/xhtml/glGet.xml|glGet} with <code>ALIASED_POINT_SIZE_RANGE</code>.
    */
   minimumAliasedPointSize: {
     get: function () {
@@ -195,10 +228,10 @@ Object.defineProperties(ContextLimits, {
   },
 
   /**
-   * The maximum aliased point size, in pixels, supported by this WebGL implementation.  It will be at least one.
+   * The maximum aliased point size, in pixels, supported by this WebGL implementation. It will be at least one.
+   * @see {@link https://registry.khronos.org/OpenGL-Refpages/es3.0/html/glGet.xhtml|glGet in OpenGL ES 3.0} with <code>ALIASED_POINT_SIZE_RANGE</code>.
    * @memberof ContextLimits
    * @type {number}
-   * @see {@link https://www.khronos.org/opengles/sdk/docs/man/xhtml/glGet.xml|glGet} with <code>ALIASED_POINT_SIZE_RANGE</code>.
    */
   maximumAliasedPointSize: {
     get: function () {
@@ -207,10 +240,10 @@ Object.defineProperties(ContextLimits, {
   },
 
   /**
-   * The maximum supported width of the viewport.  It will be at least as large as the visible width of the associated canvas.
+   * The maximum supported width of the viewport. It will be at least as large as the visible width of the associated canvas.
+   * @see {@link https://registry.khronos.org/OpenGL-Refpages/es3.0/html/glGet.xhtml|glGet in OpenGL ES 3.0} with <code>MAX_VIEWPORT_DIMS</code>.
    * @memberof ContextLimits
    * @type {number}
-   * @see {@link https://www.khronos.org/opengles/sdk/docs/man/xhtml/glGet.xml|glGet} with <code>MAX_VIEWPORT_DIMS</code>.
    */
   maximumViewportWidth: {
     get: function () {
@@ -219,10 +252,10 @@ Object.defineProperties(ContextLimits, {
   },
 
   /**
-   * The maximum supported height of the viewport.  It will be at least as large as the visible height of the associated canvas.
+   * The maximum supported height of the viewport. It will be at least as large as the visible height of the associated canvas.
+   * @see {@link https://registry.khronos.org/OpenGL-Refpages/es3.0/html/glGet.xhtml|glGet in OpenGL ES 3.0} with <code>MAX_VIEWPORT_DIMS</code>.
    * @memberof ContextLimits
    * @type {number}
-   * @see {@link https://www.khronos.org/opengles/sdk/docs/man/xhtml/glGet.xml|glGet} with <code>MAX_VIEWPORT_DIMS</code>.
    */
   maximumViewportHeight: {
     get: function () {

package/Source/Renderer/ShaderDestination.js

@@ -1,15 +1,17 @@
 import Check from "../Core/Check.js";
+import DeveloperError from "../Core/DeveloperError.js";
 
 /**
- * An enum describing whether a variable should be added to the
- * vertex shader, the fragment shader, or both.
+ * A bit flag describing whether a variable should be added to the
+ * vertex shader, the fragment shader, or both (or none).
  *
  * @private
  */
 const ShaderDestination = {
-  VERTEX: 0,
-  FRAGMENT: 1,
-  BOTH: 2,
+  NONE: 0,
+  VERTEX: 1,
+  FRAGMENT: 2,
+  BOTH: 3,
 };
 
 /**
@@ -24,10 +26,7 @@ ShaderDestination.includesVertexShader = function (destination) {
   Check.typeOf.number("destination", destination);
   //>>includeEnd('debug');
 
-  return (
-    destination === ShaderDestination.VERTEX ||
-    destination === ShaderDestination.BOTH
-  );
+  return (destination & ShaderDestination.VERTEX) !== 0;
 };
 
 /**
@@ -42,10 +41,52 @@ ShaderDestination.includesFragmentShader = function (destination) {
   Check.typeOf.number("destination", destination);
   //>>includeEnd('debug');
   //
-  return (
-    destination === ShaderDestination.FRAGMENT ||
-    destination === ShaderDestination.BOTH
-  );
+
+  return (destination & ShaderDestination.FRAGMENT) !== 0;
+};
+
+/**
+ * Compute the union of multiple ShaderDestinations (e.g., VERTEX | FRAGMENT yields BOTH)
+ * @param  {...ShaderDestination} destinations
+ * @returns {ShaderDestination} The union of the provided destinations
+ * @private
+ */
+ShaderDestination.union = function (...destinations) {
+  //>>includeStart('debug', pragmas.debug);
+  if (destinations.length === 0) {
+    throw new DeveloperError(
+      "ShaderDestination.union requires at least one destination.",
+    );
+  }
+  //>>includeEnd('debug');
+
+  let result = 0;
+  for (let i = 0; i < destinations.length; i++) {
+    result |= destinations[i];
+  }
+  return result;
+};
+
+/**
+ * Compute the intersection of multiple ShaderDestinations (e.g., VERTEX & FRAGMENT yields NONE)
+ * @param  {...ShaderDestination} destinations
+ * @returns {ShaderDestination} The intersection of the provided destinations
+ * @private
+ */
+ShaderDestination.intersection = function (...destinations) {
+  //>>includeStart('debug', pragmas.debug);
+  if (destinations.length === 0) {
+    throw new DeveloperError(
+      "ShaderDestination.intersection requires at least one destination.",
+    );
+  }
+  //>>includeEnd('debug');
+
+  let result = destinations[0];
+  for (let i = 1; i < destinations.length; i++) {
+    result &= destinations[i];
+  }
+  return result;
 };
 
 export default Object.freeze(ShaderDestination);