@openglobus/og 1.0.0-rc15 → 1.0.0-rc18

package/lib/control/Sun.d.ts

@@ -23,18 +23,19 @@ interface ISunParams extends IControlParams {
  * @param {number} [options.offsetVertical=-5000000] - Vertical offset of the camera following light.
  * @param {number} [options.offsetHorizontal=5000000] - Horizontal offset of the camera following light.
  * @param {boolean} [options.stopped=false] - Stops the control, leaving the Sun on its real position by the clock.
- * @param {Date} [options.localDateTime] - Lights the scene by a fixed local apparent solar time under the camera
- * instead of the camera following light, below activationHeight. At 12:00 the Sun stands on the meridian there,
- * while the date sets the season. Read for the wall clock numbers it shows locally, so it is not an instant in
- * time: one parsed from an absolute timestamp reads as the machine's time zone renders it. The Clock is left
- * untouched, and while the control is stopped this is ignored.
+ * @param {Date} [options.localDateTime] - Lights the scene by the local apparent solar time under the camera
+ * instead of the camera following light. At 12:00 the Sun stands on the meridian there, while the date sets the
+ * season. Read by its UTC clock, so it is not an instant in time but the numbers a wall clock shows: build it
+ * with Date.UTC. While it is set it drives the light at any height, whether the control is stopped or not, and
+ * the Clock is left untouched.
  */
 export declare class Sun extends Control {
     activationHeight: number;
     offsetVertical: number;
     offsetHorizontal: number;
     /**
-     * Fixed local apparent solar time under the camera, or null for the camera following light.
+     * Local apparent solar time under the camera, read by its UTC clock,
+     * or null for the camera following light.
      * @public
      * @type {Date | null}
      */
@@ -57,7 +58,7 @@ export declare class Sun extends Control {
     bindClock(clock: Clock): void;
     getPosition(): Vec3;
     /**
-     * Sets a fixed local apparent solar time under the camera.
+     * Sets the local apparent solar time under the camera, read by its UTC clock.
      * @public
      * @param {Date | null} localDateTime - Local date and time, or null to restore the camera following light.
      */
@@ -72,14 +73,16 @@ export declare class Sun extends Control {
      */
     protected _getCameraFollowingPosition(cam: PlanetCamera): Vec3;
     /**
-     * Returns the julian date at which localDateTime is the local apparent solar time at lon.
-     * Local mean solar time is the first guess, then the measured subsolar longitude corrects it;
-     * that point drifts -360 degrees a day, so a residual of d degrees is worth -d / 360 of a day.
+     * Returns the julian date at which the clock of the given one, read as UTC, is the local apparent
+     * solar time at lon. Local mean solar time is the first guess, then the measured subsolar longitude
+     * corrects it; that point drifts -360 degrees a day, so a residual of d degrees is worth -d / 360
+     * of a day.
      * @protected
+     * @param {JulianDate} utc - Julian date to take the clock of.
      * @param {number} lon - Longitude under the camera, degrees.
      * @returns {JulianDate} -
      */
-    protected _getLocalDateTimeJulian(lon: number): JulianDate;
+    protected _getLocalJulian(utc: JulianDate, lon: number): JulianDate;
     /**
      * Returns the Sun position for localDateTime at the location under the camera.
      * @protected

package/lib/control/timeline/TimelineControl.d.ts

@@ -2,6 +2,7 @@ import { Dialog } from "../../ui/Dialog";
 import { ToggleButton } from "../../ui/ToggleButton";
 import { Control, type IControlParams } from "../Control";
 import { TimelineView } from "./TimelineView";
+import type { ITimelineSpan, ITimelineSpanParams, TimelineModel } from "./TimelineModel";
 import { type EventsHandler } from "../../Events";
 type TimelineControlEventsList = [
     "visibility",
@@ -15,7 +16,8 @@ type TimelineControlEventsList = [
     "startdrag",
     "stopdrag",
     "startdragcurrent",
-    "stopdragcurrent"
+    "stopdragcurrent",
+    "localtime"
 ];
 interface ITimelineControlParams extends IControlParams {
     name?: string;
@@ -30,6 +32,68 @@ declare class TimelineControl extends Control {
     protected _defaultClockWasRunningBeforeDrag: boolean;
     events: EventsHandler<TimelineControlEventsList>;
     constructor(options?: ITimelineControlParams);
+    /**
+     * Returns timeline data model.
+     * @public
+     */
+    get model(): TimelineModel;
+    /**
+     * Adds a colored time interval drawn on the scale, e.g. one per telemetry track.
+     * Spans that overlap in time are placed on separate rows automatically, and the
+     * rows share the scale height between them.
+     * @public
+     * @param {ITimelineSpanParams} params - Span start, end and color. An omitted id is generated.
+     * @returns {ITimelineSpan} - Stored span, with its id and assigned row.
+     */
+    addSpan(params: ITimelineSpanParams): ITimelineSpan;
+    /**
+     * Adds several spans at once, keeping the ones already on the scale.
+     * @public
+     * @param {ITimelineSpanParams[]} params - Spans to add.
+     * @returns {ITimelineSpan[]} - Stored spans, in the order they were given.
+     */
+    addSpans(params: ITimelineSpanParams[]): ITimelineSpan[];
+    /**
+     * Replaces every span on the scale, e.g. to redraw the whole set after a source
+     * was added or removed.
+     * @public
+     * @param {ITimelineSpanParams[]} params - Spans the scale is left with.
+     * @returns {ITimelineSpan[]} - Stored spans, in the order they were given.
+     */
+    setSpans(params: ITimelineSpanParams[]): ITimelineSpan[];
+    /**
+     * Replaces the time range, color and payload of a span, and reassigns the rows when
+     * its time range moved.
+     * @public
+     * @param {string} id - Span id.
+     * @param {ITimelineSpanParams} params - New span fields. Every field is replaced, the id is kept.
+     * @returns {ITimelineSpan | undefined} - Updated span, or undefined when the id is unknown.
+     */
+    updateSpan(id: string, params: ITimelineSpanParams): ITimelineSpan | undefined;
+    /**
+     * Removes a single span from the scale. An unknown id is ignored.
+     * @public
+     * @param {string} id - Span id.
+     */
+    removeSpan(id: string): void;
+    /**
+     * Removes every span from the scale.
+     * @public
+     */
+    clearSpans(): void;
+    /**
+     * Returns the spans currently on the scale.
+     * @public
+     * @returns {ITimelineSpan[]} - Stored spans, each carrying its assigned row.
+     */
+    getSpans(): ITimelineSpan[];
+    /**
+     * Returns a single span by its id.
+     * @public
+     * @param {string} id - Span id.
+     * @returns {ITimelineSpan | undefined} - Stored span, or undefined when the id is unknown.
+     */
+    getSpan(id: string): ITimelineSpan | undefined;
     oninit(): void;
 }
 export { TimelineControl };

package/lib/control/timeline/TimelineModel.d.ts

@@ -1,5 +1,22 @@
 import { type EventsHandler } from "../../Events";
-type TimelineEventsList = ["change", "current"];
+type TimelineEventsList = ["change", "current", "play", "stop", "spanschange"];
+/** A colored time interval shown on the timeline scale. */
+export interface ITimelineSpanParams {
+    id?: string;
+    start: Date;
+    end: Date;
+    color?: string;
+    data?: unknown;
+}
+export interface ITimelineSpan {
+    id: string;
+    start: Date;
+    end: Date;
+    color: string;
+    data?: unknown;
+    /** Row the span is drawn in, assigned so that overlapping spans never share one. */
+    lane: number;
+}
 interface ITimelineParams {
     current?: Date;
     rangeStart?: Date;
@@ -9,6 +26,7 @@ interface ITimelineParams {
     multiplier?: number;
 }
 declare class TimelineModel {
+    static __spanCounter__: number;
     events: EventsHandler<TimelineEventsList>;
     protected _current: Date;
     protected _rangeStart: Date;
@@ -18,9 +36,26 @@ declare class TimelineModel {
     protected _maxDate: Date | null;
     protected _requestAnimationFrameId: number;
     protected _prevNow: number;
+    protected _spans: ITimelineSpan[];
+    protected _laneCount: number;
     multiplier: number;
     dt: number;
     constructor(options?: ITimelineParams);
+    addSpan(params: ITimelineSpanParams): ITimelineSpan;
+    addSpans(params: ITimelineSpanParams[]): ITimelineSpan[];
+    setSpans(params: ITimelineSpanParams[]): ITimelineSpan[];
+    updateSpan(id: string, params: ITimelineSpanParams): ITimelineSpan | undefined;
+    removeSpan(id: string): void;
+    clearSpans(): void;
+    getSpans(): ITimelineSpan[];
+    getSpan(id: string): ITimelineSpan | undefined;
+    /**
+     * Number of rows the current spans need, at least one when
+     * there are any.
+     */
+    get laneCount(): number;
+    protected _onSpansChange(): void;
+    protected _assignLanes(): void;
     play(): void;
     stop(): void;
     stopped(): boolean;

package/lib/control/timeline/TimelineView.d.ts

@@ -1,5 +1,6 @@
 import type { EventsHandler } from "../../Events";
 import { ButtonGroup } from "../../ui/ButtonGroup";
+import { Checkbox } from "../../ui/Checkbox";
 import { View } from "../../ui/View";
 import type { IViewParams, ViewEventsList } from "../../ui/View";
 import { ToggleButton } from "../../ui/ToggleButton";
@@ -27,7 +28,8 @@ type TimelineViewEventsList = [
     "play",
     "playback",
     "pause",
-    "visibility"
+    "visibility",
+    "localtime"
 ];
 type TimelineTouchMode = typeof TOUCH_MODE_NONE | typeof TOUCH_MODE_CURRENT | typeof TOUCH_MODE_PINCH | typeof TOUCH_MODE_SCALE;
 interface ITimelineTouchPointer {
@@ -43,6 +45,9 @@ declare class TimelineView extends View<TimelineModel> {
     protected _currentEl: HTMLElement | null;
     protected _canvasEl: HTMLCanvasElement;
     protected _ctx: CanvasRenderingContext2D;
+    protected _spansCanvasEl: HTMLCanvasElement;
+    protected _spansCtx: CanvasRenderingContext2D;
+    protected _appliedFillStyle: string;
     protected _isMouseOver: boolean;
     protected _isDragging: boolean;
     protected _isCurrentDragging: boolean;
@@ -67,6 +72,7 @@ declare class TimelineView extends View<TimelineModel> {
     protected _pauseBtn: ToggleButton;
     protected _playBtn: ToggleButton;
     protected _buttons: ButtonGroup;
+    protected _localTimeCheckbox: Checkbox;
     protected _visibility: boolean;
     constructor(options?: ITimelineViewParams);
     protected _onResizeObserver(): void;
@@ -75,7 +81,15 @@ declare class TimelineView extends View<TimelineModel> {
     resize(): void;
     afterRender(parentNode: HTMLElement): void;
     render(): this;
+    /**
+     * True when the timeline scale is read as the local date and time at the viewed location.
+     * @public
+     * @type {boolean}
+     */
+    get localTime(): boolean;
+    set localTime(localTime: boolean);
     setVisibility(visibility: boolean): void;
+    protected _syncPlayButtons: () => void;
     reset(): void;
     play(): void;
     pause(): void;
@@ -119,6 +133,8 @@ declare class TimelineView extends View<TimelineModel> {
     protected _clearEvents(): void;
     remove(): void;
     protected _clearCanvas(): void;
+    protected _applyScaleBackground(): void;
+    protected _drawSpans: () => void;
     protected _drawCurrent(): void;
     draw(): void;
 }

package/lib/entity/Entity.d.ts

@@ -152,6 +152,12 @@ declare class Entity {
     protected _rootCartesian: Vec3;
     protected _localPosition: Vec3;
     protected _absoluteLocalPosition: Vec3;
+    /**
+     * Absolute cartesian position of the entity itself, i.e. `_rootCartesian + _absoluteLocalPosition`.
+     * @protected
+     * @type {Vec3}
+     */
+    protected _absoluteCartesian: Vec3;
     /**
      * Geodetic entity coordinates.
      * @public
@@ -265,6 +271,7 @@ declare class Entity {
     protected _absoluteScale: Vec3;
     protected _qFrame: Quat;
     protected _qRot: Quat;
+    protected _directQRot: Quat;
     _absoluteQRot: Quat;
     protected _useDirectQuaternion: boolean;
     protected _opacity: number | null;
@@ -377,6 +384,7 @@ declare class Entity {
      * @param {Vec3} scale - Scale vector.
      */
     setScale3v(scale: Vec3): void;
+    protected _propagateGlobalScale(scale: Vec3): void;
     /**
      * Sets uniform local scale.
      * @public
@@ -441,6 +449,14 @@ declare class Entity {
      * @param {number} val - The new roll angle in radians.
      */
     setRoll(val: number): void;
+    /**
+     * Sets pitch, yaw and roll at once.
+     * @public
+     * @param {number} pitch - The new pitch angle in radians.
+     * @param {number} yaw - The new yaw angle in radians.
+     * @param {number} roll - The new roll angle in radians.
+     */
+    setPitchYawRoll(pitch: number, yaw: number, roll: number): void;
     /**
      * Gets the pitch angle of the entity.
      * @public
@@ -524,8 +540,10 @@ declare class Entity {
      * @param {number} z - Z coordinate in 3D space.
      */
     setCartesian(x: number, y: number, z: number): void;
+    protected _propagateGlobalPosition(x: number, y: number, z: number): void;
     protected _updatePitchYawRoll(): void;
     _updateAbsolutePosition(): void;
+    protected _applyTransformToFeatures(): void;
     /**
      * Sets local cartesian position without dispatching events.
      * @public

package/lib/entity/EntityCollection.d.ts

@@ -8,6 +8,7 @@ import { GeoObjectHandler } from "./geoObject/GeoObjectHandler";
 import { LabelHandler } from "./label/LabelHandler";
 import { Vec3 } from "../math/Vec3";
 import type { NumberArray3 } from "../math/Vec3";
+import type { NumberArray4 } from "../math/Vec4";
 import { PointCloudHandler } from "./pointCloud/PointCloudHandler";
 import { PolylineHandler } from "./polyline/PolylineHandler";
 import { RayHandler } from "./ray/RayHandler";
@@ -25,7 +26,7 @@ interface IEntityCollectionParams {
     receiveProjectors?: boolean;
     receiveShadows?: boolean;
     receiveFrameTransparency?: boolean;
-    scaleByDistance?: NumberArray3;
+    scaleByDistance?: NumberArray3 | NumberArray4;
     pickingScale?: number | NumberArray3;
     opacity?: number;
     shadeMode?: ShadeModeInput;
@@ -45,10 +46,11 @@ interface IEntityCollectionParams {
  * @param {boolean} [options.receiveProjectors=true] - Enables/disables projector effect reception for this collection.
  * @param {boolean} [options.receiveFrameTransparency=false] - Enables/disables frame transparency reception for this collection.
  * @param {boolean} [options.receiveShadows=true] - Enables/disables shadow map reception for this collection.
- * @param {Array.<number>} [options.scaleByDistance] - Entity scale by distance parameters. (exactly 3 entries)
- * First index - near distance to the entity, after entity becomes full scale.
- * Second index - far distance to the entity, when the entity becomes zero scale.
- * Third index - far distance to the entity, when the entity becomes invisible.
+ * @param {Array.<number>} [options.scaleByDistance] - Scale by distance parameters:
+ * `[near, far, vanish, scale]`. The fourth entry is a plain multiplier and defaults to `1`, so
+ * three entries are accepted as well.
+ * See {@link EntityCollection#scaleByDistance} for what each entry means.
+ * Default is `[MAX32, MAX32, MAX32, 1]` (no distance scaling).
  * @param {number|Array.<number>} [options.pickingScale] - Picking scale value or xyz scale array.
  * @param {number} [options.opacity] - Entity global opacity.
  * @param {number|string} [options.shadeMode=1] - Geo object shading mode: `0|none|unlit`, `0.5|phong`, `1|pbr`.
@@ -167,13 +169,17 @@ declare class EntityCollection {
      */
     _entities: Entity[];
     /**
-     * First index - near distance to the entity, after entity becomes full scale.
-     * Second index - far distance to the entity, when entity becomes zero scale.
-     * Third index - far distance to the entity, when entity becomes invisible.
+     * Distance-based scaling for geoObjects, billboards, and labels.
+     * [0] near - GeoObjects keep a fixed world size below this distance, then scale to
+     * maintain a fixed screen size until `far`. Ignored by billboards and labels.
+     * Set `near` to `0` to disable distance-based scaling.
+     * [1] far - GeoObjects stop growing here. If `vanish > far`, all types start fading.
+     * [2] vanish - Distance where the entity fades to zero. `vanish <= far` disables fading.
+     * [3] scale - Optional multiplier for all types. Default is `1`.
      * @public
      * @type {Array.<number>}
      */
-    scaleByDistance: NumberArray3;
+    scaleByDistance: NumberArray4;
     pickingScale: Float32Array;
     /**
      * Global opacity.
@@ -291,11 +297,15 @@ declare class EntityCollection {
     /**
      * Sets scale by distance parameters.
      * @public
-     * @param {number} near - Full scale entity distance.
-     * @param {number} far - Zero scale entity distance.
-     * @param {number} [farInvisible] - Entity visibility distance.
+     * @param {number} near - Distance below which a geoObject keeps its world size. Billboards
+     * and labels ignore it; pass `0` to disable the world scale ramp.
+     * @param {number} far - Distance up to which an entity keeps its size.
+     * @param {number} [vanish] - Distance at which the size reaches zero. Defaults to `far`, which
+     * means no fading at all: past `far` a billboard or a label keeps its screen size, and a
+     * geoObject keeps the world size it reached there.
+     * @param {number} [scale] - Plain multiplier applied on top, for every entity type.
      */
-    setScaleByDistance(near: number, far: number, farInvisible?: number): void;
+    setScaleByDistance(near: number, far: number, vanish?: number, scale?: number): void;
     setVisibleSphere(p: Vec3, r: number): void;
     /**
      * Aligns collection entities to terrain.

package/lib/entity/billboard/BaseBillboardHandler.d.ts

@@ -43,6 +43,8 @@ declare class BaseBillboardHandler {
     protected _pickingColorArr: Float32Array;
     protected _buffersUpdateCallbacks: Function[];
     protected _changedBuffers: boolean[];
+    protected _changedPositionFrom: number;
+    protected _changedPositionTo: number;
     protected _configureDepthPass(depthWrite: boolean): void;
     protected _restoreDepthPass(depthWrite: boolean): void;
     constructor(entityCollection: EntityCollection);
@@ -62,6 +64,14 @@ declare class BaseBillboardHandler {
      * @param {number} index - Buffer index.
      */
     protected _setChangedBuffer(index: number): void;
+    /**
+     * Marks a half open range of the position arrays as changed, so that the next update uploads
+     * only that range instead of the whole buffer.
+     * @protected
+     * @param {number} from - First changed float index.
+     * @param {number} to - Index past the last changed float.
+     */
+    protected _setChangedPositionRange(from: number, to: number): void;
     protected _removeBillboards(): void;
     clear(): void;
     protected _deleteBuffers(): void;

package/lib/entity/label/Label.d.ts

@@ -32,7 +32,7 @@ declare const ALIGN: Record<string, number>;
  * @param {number} [options.size] - Font size in pixels.
  * @param {string} [options.style] - HTML5 font style. Example 'normal', 'italic'.
  * @param {string} [options.weight] - HTML5 font weight. Example 'normal', 'bold'.
- * @param {number} [options.outline] - Text outline size. 0 - no outline, 1 - maximum outline. Default 0.58.
+ * @param {number} [options.outline] - Text outline width in pixels. 0 - no outline. Default 0.
  * @param {Vec4|string|Array.<number>} [options.outlineColor] - Outline color.
  * @param {string} [options.align] - Text horizontal align: "left", "right" and "center".
  */
@@ -57,7 +57,7 @@ declare class Label extends BaseBillboard {
      */
     protected _size: number;
     /**
-     * Label outline.
+     * Label outline width in pixels.
      * @protected
      * @type {number}
      */
@@ -156,13 +156,15 @@ declare class Label extends BaseBillboard {
      */
     getSize(): number;
     /**
-     * Sets text outline border size. Where 0 - is no outline, and 1 - is the maximum outline size.
+     * Sets text outline border width in pixels. Where 0 - is no outline.
+     * The visible width is capped by the font atlas distance field range,
+     * which grows with the label font size.
      * @public
-     * @param {number} outline - Text outline size.
+     * @param {number} outline - Text outline width in pixels.
      */
     setOutline(outline: number): void;
     /**
-     * Gets text current outline size.
+     * Gets text current outline width in pixels.
      * @public
      * @returns {number}
      */

package/lib/index.d.ts

@@ -15,7 +15,7 @@ export * from "./entity/index";
 export * from "./layer/index";
 export * from "./Globe";
 export type { IControlParams } from "./control/Control";
-export type { ITouchState } from "./renderer/RendererEvents";
+export type { IMouseState, ITouchState } from "./renderer/RendererEvents";
 export type { IDeferredShadingPass } from "./renderer/IDeferredShadingPass";
 export type { ITransparencyPass } from "./renderer/ITransparencyPass";
 export type { ProjectorSourceType, ProjectorRenderMode, IProjectorParams } from "./renderer/projectors/Projector";
@@ -42,6 +42,7 @@ import { Camera, PlanetCamera } from "./camera/index";
 import { Line2, Line3, Mat3, Mat4, Plane, Quat, Ray, Vec2, Vec3, Vec4 } from "./math/index";
 import { Renderer } from "./renderer/Renderer";
 import { Clock } from "./Clock";
+import { TimelineModel } from "./control/timeline/TimelineModel";
 import { Events, type EventsHandler, createEvents } from "./Events";
 import { Extent } from "./Extent";
 import { LonLat } from "./LonLat";
@@ -57,4 +58,4 @@ import { MoveAxisEntity } from "./control/entityEditor/MoveAxisEntity";
 import { Gltf } from "./utils/gltf/gltfParser";
 import { Easing } from "./utils/easing";
 import type { EasingFunction } from "./utils/easing";
-export { bv, jd, math, mercator, utils, input, control, scene, quadTreeStrategyType, wgs84, moon, mars, terrain, layer, ui, webgl, Easing, EasingFunction, Framebuffer, EmptyTerrain, GlobusTerrain, RgbTerrain, GlobusRgbTerrain, MapterhornTerrain, rgbToHeightByEncoding, rgbToHeightRgb, rgbToHeightTerrarium, resolveRgbToHeightFunc, BilTerrain, Camera, Ellipsoid, Planet, PlanetCamera, ShaderProgram, Handler, Multisample, Renderer, Clock, Events, EventsHandler, createEvents, Extent, LonLat, Scene, Line2, Line3, Mat3, Mat4, Plane, Quat, Ray, Vec2, Vec3, Vec4, Geoid, Popup, QuadTreeStrategy, EquiQuadTreeStrategy, EarthQuadTreeStrategy, Wgs84QuadTreeStrategy, Object3d, Gltf, MoveAxisEntity, Loader, IResponse };
+export { bv, jd, math, mercator, utils, input, control, scene, quadTreeStrategyType, wgs84, moon, mars, terrain, layer, ui, webgl, Easing, EasingFunction, Framebuffer, EmptyTerrain, GlobusTerrain, RgbTerrain, GlobusRgbTerrain, MapterhornTerrain, rgbToHeightByEncoding, rgbToHeightRgb, rgbToHeightTerrarium, resolveRgbToHeightFunc, BilTerrain, Camera, Ellipsoid, Planet, PlanetCamera, ShaderProgram, Handler, Multisample, Renderer, Clock, TimelineModel, Events, EventsHandler, createEvents, Extent, LonLat, Scene, Line2, Line3, Mat3, Mat4, Plane, Quat, Ray, Vec2, Vec3, Vec4, Geoid, Popup, QuadTreeStrategy, EquiQuadTreeStrategy, EarthQuadTreeStrategy, Wgs84QuadTreeStrategy, Object3d, Gltf, MoveAxisEntity, Loader, IResponse };

package/lib/layer/Vector.d.ts

@@ -21,7 +21,7 @@ export interface IVectorParams extends IBaseTileMaterialLayerParams {
     clampToGround?: boolean;
     async?: boolean;
     pickingScale?: number | NumberArray3;
-    scaleByDistance?: NumberArray3;
+    scaleByDistance?: NumberArray3 | NumberArray4;
     labelMaxLetters?: number;
     shadeMode?: ShadeModeInput;
     depthOrder?: number;
@@ -54,11 +54,11 @@ export type VectorEventsType = EventsHandler<VectorEventsList> & EventsHandler<L
  * @param {boolean} [options.fading=false] - Enables layer fade-in/fade-out transition logic.
  * @param {number} [options.height=0] - Layer height level used for rendering order.
  * @param {Array.<Entity|IEntityParams>} [options.entities] - Entities array or entity init params.
- * @param {Array.<number>} [options.scaleByDistance] - Scale by distance parameters. (exactly 3 entries)
- *      First index - near distance to the entity, after entity becomes full scale.
- *      Second index - far distance to the entity, when entity becomes zero scale.
- *      Third index - far distance to the entity, when entity becomes invisible.
- *      Default is `[MAX32, MAX32, MAX32]` (no distance scaling).
+ * @param {Array.<number>} [options.scaleByDistance] - Scale by distance parameters:
+ * `[near, far, vanish, scale]`. The fourth entry is a plain multiplier and defaults to `1`, so
+ * three entries are accepted as well.
+ *      See {@link Vector#scaleByDistance} for what each entry means.
+ *      Default is `[MAX32, MAX32, MAX32, 1]` (no distance scaling).
  * @param {number|Array.<number>} [options.pickingScale=[1,1,1]] - Picking scale value or xyz scale array.
  * @param {number} [options.nodeCapacity=60] - Maximum entities quantity in a quadtree node.
  * @param {boolean} [options.async=true] - Asynchronous vector data handling before rendering.
@@ -91,13 +91,17 @@ declare class Vector extends BaseTileMaterialLayer {
      */
     protected _entities: Entity[];
     /**
-     * First index - near distance to the entity, after that entity becomes full scale.
-     * Second index - far distance to the entity, when entity becomes zero scale.
-     * Third index - far distance to the entity, when entity becomes invisible.
+     * Distance-based scaling for geoObjects, billboards, and labels.
+     * [0] near - GeoObjects keep a fixed world size below this distance, then scale to
+     * maintain a fixed screen size until `far`. Ignored by billboards and labels.
+     * Set `near` to `0` to disable distance-based scaling.
+     * [1] far - GeoObjects stop growing here. If `vanish > far`, all types start fading.
+     * [2] vanish - Distance where the entity fades to zero. `vanish <= far` disables fading.
+     * [3] scale - Optional multiplier for all types. Default is `1`.
      * @public
-     * @type {NumberArray3}
+     * @type {Array.<number>}
      */
-    scaleByDistance: NumberArray3;
+    scaleByDistance: NumberArray4;
     pickingScale: Float32Array;
     /**
      * Asynchronous data handling before rendering.

package/lib/math.d.ts

@@ -67,6 +67,14 @@ export declare const EPS20 = 1e-20;
  * //returns 6
  */
 export declare function log(n: number, base: number): number;
+/**
+ * Smooth Hermite interpolation between 0 and 1, the same as GLSL `smoothstep`.
+ * @param {number} edge0 - Lower edge.
+ * @param {number} edge1 - Upper edge.
+ * @param {number} x - Source value.
+ * @returns {number} -
+ */
+export declare function smoothstep(edge0: number, edge1: number, x: number): number;
 /**
  * Clamp the number.
  * @function