@openglobus/og 1.0.0-rc2 → 1.0.0-rc21

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";
@@ -22,7 +23,10 @@ interface IEntityCollectionParams {
     visibility?: boolean;
     labelMaxLetters?: number;
     pickingEnabled?: boolean;
-    scaleByDistance?: NumberArray3;
+    receiveProjectors?: boolean;
+    receiveShadows?: boolean;
+    receiveFrameTransparency?: boolean;
+    scaleByDistance?: NumberArray3 | NumberArray4;
     pickingScale?: number | NumberArray3;
     opacity?: number;
     shadeMode?: ShadeModeInput;
@@ -39,10 +43,14 @@ interface IEntityCollectionParams {
  * @param {boolean} [options.visibility=true] - Entity visibility.
  * @param {number} [options.labelMaxLetters] - Maximum label letters per line used by the label handler.
  * @param {boolean} [options.pickingEnabled] - Enables/disables picking for all entity handlers.
- * @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 entity becomes zero scale.
- * Third index - far distance to the entity, when entity becomes invisible.
+ * @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] - 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`.
@@ -161,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.
@@ -194,6 +206,25 @@ declare class EntityCollection {
     _layer?: Vector;
     _quadNode?: EntityCollectionNode;
     _shadeMode: ShadeMode;
+    /**
+     * Enables/disables projector effect reception for this collection.
+     * @public
+     * @type {boolean}
+     */
+    receiveProjectors: boolean;
+    /**
+     * Enables/disables frame transparency reception for this collection.
+     * @public
+     * @type {boolean}
+     */
+    receiveFrameTransparency: boolean;
+    /**
+     * Enables/disables shadow map reception for this collection.
+     * Stored in the same material flags channel as projectors and frame transparency.
+     * @public
+     * @type {boolean}
+     */
+    receiveShadows: boolean;
     /**
      * Disables `gl.CULL_FACE` for geo objects rendering passes (opaque/transparent).
      * Useful for rendering models with inverted/inconsistent triangle winding.
@@ -216,6 +247,11 @@ declare class EntityCollection {
      * @param {boolean} visibility - Visibility flag.
      */
     setVisibility(visibility: boolean): void;
+    /**
+     * Requests the next frame to be rendered.
+     * @public
+     */
+    requestRedraw(): void;
     /**
      * Returns collection visibility.
      * @public
@@ -234,6 +270,24 @@ declare class EntityCollection {
      * @param {boolean} enable - Picking enable flag.
      */
     setPickingEnabled(enable: boolean): void;
+    /**
+     * Sets whether this collection receives projector effects.
+     * @public
+     * @param {boolean} enable - `true` to receive projector effects, `false` to ignore them.
+     */
+    setReceiveProjectors(enable: boolean): void;
+    /**
+     * Sets whether this collection receives frame transparency.
+     * @public
+     * @param {boolean} enable - `true` to receive frame transparency, `false` to ignore it.
+     */
+    setReceiveFrameTransparency(enable: boolean): void;
+    /**
+     * Sets whether this collection receives shadow map effects.
+     * @public
+     * @param {boolean} enable - `true` to receive shadow map effects, `false` to ignore them.
+     */
+    setReceiveShadows(enable: boolean): void;
     /**
      * Gets collection opacity.
      * @public
@@ -243,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);
@@ -56,6 +58,20 @@ declare class BaseBillboardHandler {
     initProgram(): void;
     setRenderer(renderer: Renderer): void;
     refresh(): void;
+    /**
+     * Marks a buffer to be updated in the next frame and requests the frame to be rendered.
+     * @protected
+     * @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/geoObject/GeoObjectHandler.d.ts

@@ -8,6 +8,7 @@ import { Object3d } from "../../Object3d";
 import { InstanceData } from "./InstanceData";
 import type { Renderer } from "../../renderer/Renderer";
 import type { Scene } from "../../scene/Scene";
+import type { Camera } from "../../camera/Camera";
 import type { ShaderProgram } from "../../webgl/ShaderProgram";
 export declare const VERTEX_BUFFER = 0;
 export declare const RTC_POSITION_BUFFER = 1;
@@ -68,6 +69,8 @@ export declare class GeoObjectHandler {
     _displayForwardPASS(): void;
     protected _depthPASS(): void;
     drawDepth(): void;
+    protected _depthCameraPASS(camera: Camera): void;
+    drawDepthCameraPass(camera: Camera): void;
     drawPicking(): void;
     protected _pickingPASS(): void;
     setQRotArr(tagData: InstanceData, tagDataIndex: number, qRot: Quat): void;

package/lib/entity/geoObject/InstanceData.d.ts

@@ -79,6 +79,12 @@ export declare class InstanceData {
     createIndicesBuffer(): void;
     createPickingColorBuffer(): void;
     refresh(): void;
+    /**
+     * Marks a buffer to be updated in the next frame and requests the frame to be rendered.
+     * @public
+     * @param {number} index - Buffer index.
+     */
+    setChangedBuffer(index: number): void;
     update(): void;
     private _createColorTexture;
     private _createNormalTexture;

package/lib/entity/geometry/Geometry.d.ts

@@ -110,6 +110,24 @@ declare class Geometry {
     setLineColor(r: number, g: number, b: number, a?: number): Geometry;
     setStrokeColor4v(rgba: Vec4): Geometry;
     setLineColor4v(rgba: Vec4): Geometry;
+    /**
+     * Gets geometry fill color.
+     * @public
+     * @returns {Vec4} Copy of the normalized RGBA fill color.
+     */
+    getFillColor4v(): Vec4;
+    /**
+     * Gets geometry line color.
+     * @public
+     * @returns {Vec4} Copy of the normalized RGBA line color.
+     */
+    getLineColor4v(): Vec4;
+    /**
+     * Gets geometry stroke color.
+     * @public
+     * @returns {Vec4} Copy of the normalized RGBA stroke color.
+     */
+    getStrokeColor4v(): Vec4;
     setStrokeOpacity(opacity: number): Geometry;
     setLineOpacity(opacity: number): Geometry;
     setStrokeWidth(width: number): Geometry;

package/lib/entity/geometry/GeometryHandler.d.ts

@@ -60,6 +60,7 @@ declare class GeometryHandler {
     protected _refreshPlanetNode(treeNode: Node): void;
     protected _updatePlanet(): void;
     protected refresh(): void;
+    protected _setChangedBuffer(index: number): void;
     update(): void;
     setGeometryVisibility(geometry: Geometry): void;
     setPolyColorArr(geometry: Geometry, color: Vec4): 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}
      */
@@ -130,7 +130,7 @@ declare class Label extends BaseBillboard {
      * @public
      * @returns {string}
      */
-    getAlign(): number;
+    getAlign(): string;
     /**
      * Sets font face family.
      * @public
@@ -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/entity/pointCloud/PointCloud.d.ts

@@ -167,6 +167,7 @@ declare class PointCloud {
     insertPoint(index: number, point: Poi): void;
     draw(): void;
     drawPicking(): void;
+    protected _setChangedBuffer(index: number): void;
     /**
      * Update gl buffers.
      * @protected

package/lib/entity/pointCloud/PointCloudHandler.d.ts

@@ -30,6 +30,11 @@ declare class PointCloudHandler {
      */
     protected _pointClouds: PointCloud[];
     constructor(entityCollection: EntityCollection);
+    /**
+     * Requests the next frame to be rendered.
+     * @public
+     */
+    requestRedraw(): void;
     protected _initProgram(): void;
     bindScene(scene: Scene): void;
     add(pointCloud: PointCloud): void;

package/lib/entity/polyline/Polyline.d.ts

@@ -3,6 +3,7 @@ import { LonLat } from "../../LonLat";
 import { Vec3 } from "../../math/Vec3";
 import type { NumberArray3 } from "../../math/Vec3";
 import type { NumberArray2 } from "../../math/Vec2";
+import { Vec4 } from "../../math/Vec4";
 import type { NumberArray4 } from "../../math/Vec4";
 import type { HTMLImageElementExt } from "../../utils/ImagesCacheManager";
 import { PolylineHandler } from "./PolylineHandler";
@@ -228,6 +229,20 @@ declare class Polyline {
      * @param {string} htmlColor - HTML color.
      */
     setColorHTML(htmlColor: string): void;
+    /**
+     * Gets polyline HTML color.
+     * @public
+     * @param {number} [index=0] - Segment index.
+     * @returns {string | undefined} HTML color, or undefined when no color is set.
+     */
+    getColorHTML(index?: number): string | undefined;
+    /**
+     * Gets polyline color as a normalized RGBA vector.
+     * @public
+     * @param {number} [index=0] - Segment index.
+     * @returns {Vec4 | undefined} Normalized RGBA color, or undefined when no color is set.
+     */
+    getColor4v(index?: number): Vec4 | undefined;
     /**
      * Clear polyline data.
      * @public

package/lib/entity/polyline/PolylineBatchRenderer.d.ts

@@ -409,6 +409,7 @@ declare class PolylineBatchRenderer {
      * @protected
      */
     protected _refresh(): void;
+    protected _setChangedBuffer(index: number): void;
     /**
      * Updates render buffers.
      * @protected

package/lib/entity/polyline/PolylineHandler.d.ts

@@ -20,6 +20,11 @@ declare class PolylineHandler {
     protected _polylines: Polyline[];
     constructor(entityCollection: EntityCollection);
     setVisibleSphere(p: Vec3, r: number): void;
+    /**
+     * Requests the next frame to be rendered.
+     * @public
+     */
+    requestRedraw(): void;
     protected _initProgram(): void;
     bindScene(scene: Scene): void;
     add(polyline: Polyline): void;

package/lib/entity/ray/Ray.d.ts

@@ -114,6 +114,8 @@ declare class Ray {
      */
     setImage(image: HTMLImageElement): void;
     getImage(): HTMLImageElementExt | null;
+    protected _applyImageTexture(image: HTMLImageElementExt): void;
+    reloadTexture(): void;
     /**
      * Sets ray start position.
      * @public

package/lib/entity/ray/RayHandler.d.ts

@@ -55,6 +55,7 @@ declare class RayHandler {
     initProgram(): void;
     setRenderer(renderer: Renderer): void;
     refresh(): void;
+    protected _setChangedBuffer(index: number): void;
     protected _removeRays(): void;
     clear(): void;
     protected _deleteBuffers(): void;

package/lib/index.d.ts

@@ -15,13 +15,29 @@ 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";
+export { Projector } from "./renderer/projectors/Projector";
+export type { IShadowMapParams } from "./renderer/shadows/ShadowMap";
+export { ShadowMap } from "./renderer/shadows/ShadowMap";
+export { CascadeShadowMap } from "./renderer/cascadeShadows/CascadeShadowMap";
+export type { IDepthCameraParams } from "./control/depthCamera/DepthCamera";
+export { DepthCamera } from "./control/depthCamera/DepthCamera";
+export type { IDepthCameraHandlerParams } from "./control/depthCamera/DepthCameraHandler";
+export { DepthCameraHandler } from "./control/depthCamera/DepthCameraHandler";
 export { PhongDeferredShading } from "./renderer/PhongDeferredShading";
 export { AtmosphereDeferredShading } from "./renderer/AtmosphereDeferredShading";
 export { WOITPass } from "./renderer/WOITPass";
+export { ProjectorsPass } from "./renderer/projectors/ProjectorsPass";
+export { ProjectorManager } from "./renderer/projectors/ProjectorManager";
+export { ShadowManager } from "./renderer/shadows/ShadowManager";
 export { SHADE_UNLIT, SHADE_PHONG, SHADE_PBR, type ShadeMode, type ShadeModeInput } from "./shadeModeConstants";
+export type { CameraFootprintCorners, ICameraFootprintParams } from "./utils/cameraFootprint";
+export { CameraFootprint, getCameraFootprint } from "./utils/cameraFootprint";
+export type { ILightSpaceBounds, IOrthoBounds, IShadowCameraFitParams, IShadowCameraFitStats } from "./utils/shadowCameraFit";
+export { ShadowCameraFit } from "./utils/shadowCameraFit";
 export declare const version: string;
 import { Geoid } from "./terrain/Geoid";
 import { input } from "./input/input";
@@ -30,6 +46,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";
@@ -40,9 +57,9 @@ import { Loader, type IResponse } from "./utils/Loader";
 import { EarthQuadTreeStrategy, EquiQuadTreeStrategy, QuadTreeStrategy, quadTreeStrategyType, Wgs84QuadTreeStrategy } from "./quadTree/index";
 import { Object3d } from "./Object3d";
 import { Handler, ShaderProgram, Framebuffer, Multisample } from "./webgl/index";
-import { EmptyTerrain, GlobusTerrain, RgbTerrain, BilTerrain, GlobusRgbTerrain } from "./terrain/index";
+import { EmptyTerrain, GlobusTerrain, RgbTerrain, BilTerrain, GlobusRgbTerrain, MapterhornTerrain, rgbToHeightByEncoding, rgbToHeightRgb, rgbToHeightTerrarium, resolveRgbToHeightFunc } from "./terrain/index";
 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, 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/input/KeyboardHandler.d.ts

@@ -13,13 +13,17 @@ declare class KeyboardHandler {
     protected _event: KeyboardEvent | null;
     protected _active: boolean;
     protected _stampCache: Record<string, number>;
+    onKeyEvent: ((event: KeyboardEvent) => void) | null;
     constructor();
+    protected _onDocumentKeyDown: (event: KeyboardEvent) => void;
+    protected _onDocumentKeyUp: (event: KeyboardEvent) => void;
+    destroy(): void;
     getcurrentlyPressedKeys(): Record<number, boolean>;
     getPressedKeysCallbacks(): Record<number, ICallbackHandler[]>;
     getUnpressedKeysCallbacks(): Record<number, ICallbackHandler[]>;
     getCharkeysCallbacks(): Record<number, ICallbackHandler[]>;
     removeEvent(event: string, keyCode: number, callback: EventCallback): void;
-    protected _removeCallback(handlers: ICallbackHandler[], callback: EventCallbackStamp): void;
+    protected _removeCallback(handlers: ICallbackHandler[] | undefined, callback: EventCallbackStamp): void;
     protected _getStamp(name: string, keyCode: number, ogid: number): string;
     protected _stamp(name: string, keyCode: number, obj: any): boolean;
     setActivity(activity: boolean): void;

package/lib/layer/BaseTileMaterialLayer.d.ts

@@ -0,0 +1,36 @@
+import { Layer } from "./Layer";
+import type { ILayerParams } from "./Layer";
+import { Material } from "./Material";
+import type { NumberArray4 } from "../math/Vec4";
+import type { Node } from "../quadTree/Node";
+import { Segment } from "../segment/Segment";
+export interface IBaseTileMaterialLayerParams extends ILayerParams {
+    minNativeZoom?: number;
+    maxNativeZoom?: number;
+}
+/**
+ * Shared tile material application for imagery/canvas tile layers.
+ * It can be applied to any type of tiled data that can be displayed on the planet in either of these two ways, such as BUildings, vector tiles etc.
+ */
+export declare abstract class BaseTileMaterialLayer extends Layer {
+    minNativeZoom: number;
+    maxNativeZoom: number;
+    constructor(name?: string | null, options?: IBaseTileMaterialLayerParams);
+    applyMaterial(material: Material, forceLoading?: boolean): NumberArray4;
+    protected _applyMaterialDefaultCore(material: Material, forceLoading?: boolean): NumberArray4;
+    protected _applyMaterialFastCore(material: Material, forceLoading?: boolean): NumberArray4;
+    protected _applyReadyParentTexture(material: Material, segment: Segment, layerId: number): void;
+    protected _allowsLoadWithoutPassReady(): boolean;
+    protected _hasParentMaterial(psegm: Material): boolean;
+    protected _applyNoParentMaterial(material: Material, segment: Segment): void;
+    protected _onMaterialReady(_material: Material): void;
+    protected _onParentMaterialApplied(_material: Material, _psegm: Material): void;
+    protected _beforeFastMaterialParentWalk(material: Material, segment: Segment, forceLoading: boolean): void;
+    protected _applyFastPassReadyLoading(material: Material, segment: Segment, pn: Node, forceLoading: boolean): void;
+    /** pn from parent walk is at maxNativeZoom. */
+    protected _fastWhenWalkerAtMaxNativeZoom(material: Material, segment: Segment): void;
+    protected _fastLoadParentAtMaxNativeZoom(material: Material, segment: Segment, maxNativeZoom: number): void;
+    protected _triggerDefaultMaterialLoad(mat: Material, material: Material, targetNode: Node, forceLoading: boolean): void;
+    protected _defaultMaterialLoadForce(_mat: Material, material: Material, targetNode: Node, forceLoading: boolean): boolean;
+    clearMaterial(material: Material): void;
+}

package/lib/layer/CanvasTiles.d.ts

@@ -1,12 +1,12 @@
 import type { EventCallback, EventsHandler } from "../Events";
-import { Layer } from "./Layer";
-import type { ILayerParams, LayerEventsList } from "./Layer";
+import { BaseTileMaterialLayer } from "./BaseTileMaterialLayer";
+import type { IBaseTileMaterialLayerParams } from "./BaseTileMaterialLayer";
+import type { LayerEventsList } from "./Layer";
 import { Material } from "../layer/Material";
-import type { NumberArray4 } from "../math/Vec4";
 import { Planet } from "../scene/Planet";
 type ApplyImageFunc = (material: HTMLCanvasElement | ImageBitmap | HTMLImageElement) => void;
 type DrawTileCallback = (material: Material, applyImage: ApplyImageFunc) => void;
-export interface ICanvasTilesParams extends ILayerParams {
+export interface ICanvasTilesParams extends IBaseTileMaterialLayerParams {
     drawTile: DrawTileCallback;
     animated?: boolean;
     minNativeZoom?: number;
@@ -33,13 +33,11 @@ type CanvasTilesEventsType = EventsHandler<CanvasTilesEventsList> & EventsHandle
  * @fires load
  * @fires loadend
  */
-declare class CanvasTiles extends Layer {
+declare class CanvasTiles extends BaseTileMaterialLayer {
     static MAX_REQUESTS: number;
     static __requestsCounter: number;
     events: CanvasTilesEventsType;
     animated: boolean;
-    minNativeZoom: number;
-    maxNativeZoom: number;
     /**
      * Current creating tiles counter.
      * @protected
@@ -82,7 +80,7 @@ declare class CanvasTiles extends Layer {
      * @virtual
      * @param {Material} material -
      */
-    loadMaterial(material: Material): void;
+    loadMaterial(material: Material, _forceLoading?: boolean): void;
     /**
      * Loads material image and apply it to the planet segment.
      * @protected
@@ -98,9 +96,7 @@ declare class CanvasTiles extends Layer {
     abortMaterialLoading(material: Material): void;
     protected _dequeueRequest(): void;
     protected _whilePendings(): Material | null;
-    applyMaterial(material: Material): NumberArray4;
-    protected _apllyMaterialDefault(material: Material): NumberArray4;
-    protected _applyMaterialFast(material: Material): NumberArray4;
-    clearMaterial(material: Material): void;
+    protected _onMaterialReady(material: Material): void;
+    protected _onParentMaterialApplied(material: Material, _psegm: Material): void;
 }
 export { CanvasTiles };

package/lib/layer/Layer.d.ts

@@ -136,7 +136,7 @@ declare class Layer {
      */
     _planet: Planet | null;
     createTexture: Function | null;
-    nightTextureCoefficient: number;
+    protected _nightTextureCoefficient: number;
     protected _hasImageryTiles: boolean;
     /**
      * Layer global opacity.
@@ -225,6 +225,13 @@ declare class Layer {
     get instanceName(): string;
     get rendererEvents(): EventsHandler<LayerEventsList>;
     set opacity(opacity: number);
+    /**
+     * Night texture blending coefficient.
+     * @public
+     * @type {number}
+     */
+    set nightTextureCoefficient(coefficient: number);
+    get nightTextureCoefficient(): number;
     set pickingEnabled(picking: boolean);
     get pickingEnabled(): boolean;
     /**