mars3d-cesium 1.120.2 → 1.121.0

package/Build/Cesium/Cesium.d.ts

@@ -4689,6 +4689,10 @@ export class CompressedTextureBuffer {
      * The compressed texture buffer.
      */
     readonly bufferView: Uint8Array;
+    /**
+     * The compressed texture buffer. Alias for bufferView.
+     */
+    readonly arrayBufferView: Uint8Array;
     /**
      * Creates a shallow clone of a compressed texture buffer.
      * @param object - The compressed texture buffer to be cloned.
@@ -20868,7 +20872,7 @@ export namespace Entity {
         availability?: TimeIntervalCollection;
         show?: boolean;
         description?: Property | string;
-        position?: PositionProperty | Cartesian3;
+        position?: PositionProperty | Cartesian3 | CallbackProperty;
         orientation?: Property | Quaternion;
         viewFrom?: Property | Cartesian3;
         parent?: Entity;
@@ -34762,8 +34766,8 @@ export namespace Label {
      * @property [backgroundPadding = new Cartesian2(7, 5)] - A {@link Cartesian2} Specifying the horizontal and vertical background padding in pixels.
      * @property [pixelOffset = Cartesian2.ZERO] - A {@link Cartesian2} specifying the pixel offset in screen space from the origin of this label.
      * @property [eyeOffset = Cartesian3.ZERO] - A {@link Cartesian3} specifying the 3D Cartesian offset applied to this label in eye coordinates.
-     * @property [horizontalOrigin = HorizontalOrigin.CENTER] - A {@link HorizontalOrigin} specifying the horizontal origin of this label.
-     * @property [verticalOrigin = VerticalOrigin.CENTER] - A {@link VerticalOrigin} specifying the vertical origin of this label.
+     * @property [horizontalOrigin = HorizontalOrigin.LEFT] - A {@link HorizontalOrigin} specifying the horizontal origin of this label.
+     * @property [verticalOrigin = VerticalOrigin.BASELINE] - A {@link VerticalOrigin} specifying the vertical origin of this label.
      * @property [heightReference = HeightReference.NONE] - A {@link HeightReference} specifying the height reference of this label.
      * @property [fillColor = Color.WHITE] - A {@link Color} specifying the fill color of the label.
      * @property [outlineColor = Color.BLACK] - A {@link Color} specifying the outline color of the label.
@@ -35760,6 +35764,11 @@ Base material types and their uniforms:
      <li><code>heights</code>: image of heights sorted from lowest to highest.</li>
      <li><code>colors</code>: image of colors at the corresponding heights.</li>
 </ul>
+<li>WaterMask</li>
+<ul>
+     <li><code>waterColor</code>: diffuse color and alpha for the areas covered by water.</li>
+     <li><code>landColor</code>: diffuse color and alpha for the areas covered by land.</li>
+</ul>
 </ul>
 </ul>
 </div>
@@ -35787,7 +35796,6 @@ polygon.material = new Cesium.Material({
  * @param [options.minificationFilter = TextureMinificationFilter.LINEAR] - The {@link TextureMinificationFilter} to apply to this material's textures.
  * @param [options.magnificationFilter = TextureMagnificationFilter.LINEAR] - The {@link TextureMagnificationFilter} to apply to this material's textures.
  * @param options.fabric - The fabric JSON used to generate the material.
-ructor
  */
 export class Material {
     constructor(options?: {
@@ -35959,6 +35967,10 @@ export class Material {
      * Gets the name of the elevation band material.
      */
     static readonly ElevationBandType: string;
+    /**
+     * Gets the name of the water mask material.
+     */
+    static readonly WaterMaskType: string;
 }
 
 /**
@@ -39518,6 +39530,19 @@ export class PostProcessStageCollection {
      * The number of post-process stages in this collection.
      */
     readonly length: number;
+    /**
+     * Specifies the tonemapping algorithm used when rendering with high dynamic range.
+    {@link https://sandcastle.cesium.com/?src=High%20Dynamic%20Range.html|Sandcastle Demo}
+     * @example
+     * viewer.scene.postProcessStages.tonemapper = Cesium.Tonemapper.ACES;
+     */
+    tonemapper: Tonemapper;
+    /**
+     * Control the exposure when HDR is on. Less than 1.0 makes the tonemapping darker while greater than 1.0 makes it brighter.
+     * @example
+     * viewer.scene.postProcessStages.exposure = 1.0;
+     */
+    exposure: number;
     /**
      * Adds the post-process stage to the collection.
      * @param stage - The post-process stage to add to the collection.
@@ -40315,7 +40340,7 @@ const scene = new Cesium.Scene({
  * @param [options.requestRenderMode = false] - If true, rendering a frame will only occur when needed as determined by changes within the scene. Enabling improves performance of the application, but requires using {@link Scene#requestRender} to render a new frame explicitly in this mode. This will be necessary in many cases after making changes to the scene in other parts of the API. See {@link https://cesium.com/blog/2018/01/24/cesium-scene-rendering-performance/|Improving Performance with Explicit Rendering}.
  * @param [options.maximumRenderTimeChange = 0.0] - If requestRenderMode is true, this value defines the maximum change in simulation time allowed before a render is requested. See {@link https://cesium.com/blog/2018/01/24/cesium-scene-rendering-performance/|Improving Performance with Explicit Rendering}.
  * @param [options.depthPlaneEllipsoidOffset = 0.0] - Adjust the DepthPlane to address rendering artefacts below ellipsoid zero elevation.
- * @param [options.msaaSamples = 1] - If provided, this value controls the rate of multisample antialiasing. Typical multisampling rates are 2, 4, and sometimes 8 samples per pixel. Higher sampling rates of MSAA may impact performance in exchange for improved visual quality. This value only applies to WebGL2 contexts that support multisample render targets.
+ * @param [options.msaaSamples = 4] - If provided, this value controls the rate of multisample antialiasing. Typical multisampling rates are 2, 4, and sometimes 8 samples per pixel. Higher sampling rates of MSAA may impact performance in exchange for improved visual quality. This value only applies to WebGL2 contexts that support multisample render targets. Set to 1 to disable MSAA.
  */
 export class Scene {
     constructor(options: {
@@ -41051,24 +41076,6 @@ export namespace SceneTransforms {
      * @returns The modified result parameter or a new Cartesian2 instance if one was not provided.  This may be <code>undefined</code> if the input position is near the center of the ellipsoid.
      */
     function worldToWindowCoordinates(scene: Scene, position: Cartesian3, result?: Cartesian2): Cartesian2 | undefined;
-    /**
-     * Transforms a position in WGS84 coordinates to window coordinates.  This is commonly used to place an
-    HTML element at the same screen position as an object in the scene.
-     * @example
-     * // Output the window position of longitude/latitude (0, 0) every time the mouse moves.
-    const scene = widget.scene;
-    const ellipsoid = scene.ellipsoid;
-    const position = Cesium.Cartesian3.fromDegrees(0.0, 0.0);
-    const handler = new Cesium.ScreenSpaceEventHandler(scene.canvas);
-    handler.setInputAction(function(movement) {
-        console.log(Cesium.SceneTransforms.wgs84ToWindowCoordinates(scene, position));
-    }, Cesium.ScreenSpaceEventType.MOUSE_MOVE);
-     * @param scene - The scene.
-     * @param position - The position in WGS84 (world) coordinates.
-     * @param [result] - An optional object to return the input position transformed to window coordinates.
-     * @returns The modified result parameter or a new Cartesian2 instance if one was not provided.  This may be <code>undefined</code> if the input position is near the center of the ellipsoid.
-     */
-    function wgs84ToWindowCoordinates(scene: Scene, position: Cartesian3, result?: Cartesian2): Cartesian2 | undefined;
     /**
      * Transforms a position in world coordinates to drawing buffer coordinates.  This may produce different
     results from SceneTransforms.worldToWindowCoordinates when the browser zoom is not 100%, or on high-DPI displays.
@@ -41085,22 +41092,6 @@ export namespace SceneTransforms {
      * @returns The modified result parameter or a new Cartesian2 instance if one was not provided.  This may be <code>undefined</code> if the input position is near the center of the ellipsoid.
      */
     function worldToDrawingBufferCoordinates(scene: Scene, position: Cartesian3, result?: Cartesian2): Cartesian2 | undefined;
-    /**
-     * Transforms a position in world coordinates to drawing buffer coordinates.  This may produce different
-    results from SceneTransforms.wgs84ToWindowCoordinates when the browser zoom is not 100%, or on high-DPI displays.
-     * @example
-     * // Output the window position of longitude/latitude (0, 0) every time the mouse moves.
-    const position = Cesium.Cartesian3.fromDegrees(0.0, 0.0);
-    const handler = new Cesium.ScreenSpaceEventHandler(scene.canvas);
-    handler.setInputAction(function(movement) {
-        console.log(Cesium.SceneTransforms.wgs84ToWindowCoordinates(scene, position));
-    }, Cesium.ScreenSpaceEventType.MOUSE_MOVE);
-     * @param scene - The scene.
-     * @param position - The position in world (WGS84 or alternative ellipsoid) coordinates.
-     * @param [result] - An optional object to return the input position transformed to window coordinates.
-     * @returns The modified result parameter or a new Cartesian2 instance if one was not provided.  This may be <code>undefined</code> if the input position is near the center of the ellipsoid.
-     */
-    function wgs84ToDrawingBufferCoordinates(scene: Scene, position: Cartesian3, result?: Cartesian2): Cartesian2 | undefined;
 }
 
 /**
@@ -41180,6 +41171,10 @@ export class ScreenSpaceCameraController {
      * The maximum magnitude, in meters, of the camera position when zooming. Defaults to positive infinity.
      */
     maximumZoomDistance: number;
+    /**
+     * A multiplier for the speed at which the camera will zoom.
+     */
+    zoomFactor: number;
     /**
      * The input that allows the user to pan around the map. This only applies in 2D and Columbus view modes.
     <p>
@@ -42402,6 +42397,32 @@ export class TimeDynamicPointCloud {
     destroy(): void;
 }
 
+/**
+ * A tonemapping algorithm when rendering with high dynamic range.
+ */
+export enum Tonemapper {
+    /**
+     * Use the Reinhard tonemapping.
+     */
+    REINHARD = "REINHARD",
+    /**
+     * Use the modified Reinhard tonemapping.
+     */
+    MODIFIED_REINHARD = "MODIFIED_REINHARD",
+    /**
+     * Use the Filmic tonemapping.
+     */
+    FILMIC = "FILMIC",
+    /**
+     * Use the ACES tonemapping.
+     */
+    ACES = "ACES",
+    /**
+     * Use the PBR Neutral tonemapping {@link https://github.com/KhronosGroup/ToneMapping/tree/main/PBR_Neutral|from Khronos}.
+     */
+    PBR_NEUTRAL = "PBR_NEUTRAL"
+}
+
 export namespace UrlTemplateImageryProvider {
     /**
      * Initialization options for the UrlTemplateImageryProvider constructor
@@ -42927,11 +42948,6 @@ export class VoxelPrimitive {
      * Gets or sets whether or not to test against depth when rendering.
      */
     depthTest: boolean;
-    /**
-     * Gets or sets whether or not to jitter the view ray during the raymarch.
-    This reduces stair-step artifacts but introduces noise.
-     */
-    jitter: boolean;
     /**
      * Gets or sets the nearest sampling.
      */
@@ -43605,7 +43621,7 @@ const widget2 = new Cesium.CesiumWidget("cesiumContainer", {
  * @param [options.blurActiveElementOnCanvasFocus = true] - If true, the active element will blur when the viewer's canvas is clicked. Setting this to false is useful for cases when the canvas is clicked only for retrieving position or an entity data without actually meaning to set the canvas to be the active element.
  * @param [options.requestRenderMode = false] - If true, rendering a frame will only occur when needed as determined by changes within the scene. Enabling improves performance of the application, but requires using {@link Scene#requestRender} to render a new frame explicitly in this mode. This will be necessary in many cases after making changes to the scene in other parts of the API. See {@link https://cesium.com/blog/2018/01/24/cesium-scene-rendering-performance/|Improving Performance with Explicit Rendering}.
  * @param [options.maximumRenderTimeChange = 0.0] - If requestRenderMode is true, this value defines the maximum change in simulation time allowed before a render is requested. See {@link https://cesium.com/blog/2018/01/24/cesium-scene-rendering-performance/|Improving Performance with Explicit Rendering}.
- * @param [options.msaaSamples = 1] - If provided, this value controls the rate of multisample antialiasing. Typical multisampling rates are 2, 4, and sometimes 8 samples per pixel. Higher sampling rates of MSAA may impact performance in exchange for improved visual quality. This value only applies to WebGL2 contexts that support multisample render targets.
+ * @param [options.msaaSamples = 4] - If provided, this value controls the rate of multisample antialiasing. Typical multisampling rates are 2, 4, and sometimes 8 samples per pixel. Higher sampling rates of MSAA may impact performance in exchange for improved visual quality. This value only applies to WebGL2 contexts that support multisample render targets. Set to 1 to disable MSAA.
  */
 export class CesiumWidget {
     constructor(container: Element | string, options?: {
@@ -45730,7 +45746,7 @@ export namespace Viewer {
      * @property [requestRenderMode = false] - If true, rendering a frame will only occur when needed as determined by changes within the scene. Enabling reduces the CPU/GPU usage of your application and uses less battery on mobile, but requires using {@link Scene#requestRender} to render a new frame explicitly in this mode. This will be necessary in many cases after making changes to the scene in other parts of the API. See {@link https://cesium.com/blog/2018/01/24/cesium-scene-rendering-performance/|Improving Performance with Explicit Rendering}.
      * @property [maximumRenderTimeChange = 0.0] - If requestRenderMode is true, this value defines the maximum change in simulation time allowed before a render is requested. See {@link https://cesium.com/blog/2018/01/24/cesium-scene-rendering-performance/|Improving Performance with Explicit Rendering}.
      * @property [depthPlaneEllipsoidOffset = 0.0] - Adjust the DepthPlane to address rendering artefacts below ellipsoid zero elevation.
-     * @property [msaaSamples = 1] - If provided, this value controls the rate of multisample antialiasing. Typical multisampling rates are 2, 4, and sometimes 8 samples per pixel. Higher sampling rates of MSAA may impact performance in exchange for improved visual quality. This value only applies to WebGL2 contexts that support multisample render targets.
+     * @property [msaaSamples = 4] - If provided, this value controls the rate of multisample antialiasing. Typical multisampling rates are 2, 4, and sometimes 8 samples per pixel. Higher sampling rates of MSAA may impact performance in exchange for improved visual quality. This value only applies to WebGL2 contexts that support multisample render targets. Set to 1 to disable MSAA.
      */
     type ConstructorOptions = {
         animation?: boolean;