@yituengine/keymap 1.0.0

package/dist/types/core/Assets.d.ts

@@ -0,0 +1,11 @@
+import { Asset } from '../types';
+export default class Assets {
+    private collection;
+    constructor();
+    add(asset: Asset): void;
+    getById(id?: string): Asset | undefined;
+    removeAll(): boolean;
+    removeById(id: string): boolean;
+    detach(id: string): boolean;
+    clear(): void;
+}

package/dist/types/core/Classification.d.ts

@@ -0,0 +1,17 @@
+import { TilesetLayer } from '../layer';
+interface IClpInfo {
+    id: string;
+    coordinates: number[];
+    maxHeight: number;
+    minHeight: number;
+}
+export default class Classification {
+    layer: TilesetLayer;
+    areasId: string[];
+    focus: string | null;
+    constructor(layer: TilesetLayer);
+    add(clpInfo: IClpInfo | IClpInfo[]): void;
+    removeById(id: string): void;
+    removeAll(): void;
+}
+export {};

package/dist/types/core/Flatten.d.ts

@@ -0,0 +1,74 @@
+import type { GeojsonCoordinate } from '../types';
+import * as Cesium from 'cesium';
+interface ShaderBlock {
+    id: string;
+    text: string;
+    display: boolean;
+}
+/**
+ * 3dtiles模型压平
+ */
+declare class Flatten {
+    tileset: Cesium.Cesium3DTileset;
+    center: Cesium.Cartesian3;
+    matrix: Cesium.Matrix4;
+    localMatrix: Cesium.Matrix4;
+    localPositionsArr: GeojsonCoordinate[][];
+    shaderArr: ShaderBlock[];
+    constructor(tileset: Cesium.Cesium3DTileset);
+    /**
+     * 添加压平面
+     * @param {Object}  [opt] 参数
+     * @param {Cesium.Cartesian3[]} [opt.positions] 压平面坐标
+     * @param {Number} [opt.height] 压平深度
+     */
+    add(opt: {
+        id?: string;
+        positions: Cesium.Cartesian3[];
+        height?: number;
+    }): void;
+    /**
+     * 根据id或下标 删除压平的区域，优先以id
+     * @param {Object} [opt]
+     * @param {string} [opt.id] 唯一标识
+     * @param {number} [opt.index] 指定下标
+     */
+    remove(opt: {
+        id: string;
+        index?: never;
+    } | {
+        id: never;
+        index: number;
+    }): void;
+    /**
+     * 隐藏全部选区
+     */
+    hide(): void;
+    /**
+     * 显示全部选区
+     */
+    show(): void;
+    /**
+     * 清空全部 选区 与 着色器块组
+     */
+    destroy(): void;
+    findShader(opt: {
+        id: string;
+        index?: never;
+    } | {
+        id?: never;
+        index: number;
+    }): {
+        shaderObj: ShaderBlock;
+        index: number;
+    } | null;
+    createShaderText(): {
+        vtx1: string;
+        vtx2: string;
+    };
+    getIsinPolygonFun(polygons: GeojsonCoordinate[][]): string;
+    updateShader(vtx1: string, vtx2: string): void;
+    getUniqueArray: (arr: number[]) => number[];
+    cartesiansToLocal(positions: Cesium.Cartesian3[]): GeojsonCoordinate[];
+}
+export default Flatten;

package/dist/types/core/Status.d.ts

@@ -0,0 +1,3 @@
+export default class Status {
+    isMeasure: boolean;
+}

package/dist/types/core/pathAnim.d.ts

@@ -0,0 +1,27 @@
+import * as Cesium from 'cesium';
+type PathRotation = number | {
+    heading: number;
+    pitch: number;
+    roll: number;
+};
+export type PathAnimOptions = {
+    positions?: Cesium.Cartesian3[];
+    rotation?: PathRotation;
+    speed?: number;
+    isLerpRotation?: boolean;
+    model?: Cesium.Entity | null;
+};
+export default class pathAnim {
+    pos: Cesium.Cartesian3[];
+    rotate: PathRotation;
+    speed: number;
+    isLerpRotation: boolean;
+    model: Cesium.Entity | null;
+    constructor(opt: PathAnimOptions);
+    start(): void;
+    getHeading(pointA: Cesium.Cartesian3, pointB: Cesium.Cartesian3): number;
+    getDistance(p1: Cesium.Cartesian3, p2: Cesium.Cartesian3): number;
+    private getRotationOffset;
+    FloatLerp(start: number, end: number, percent: number): number;
+}
+export {};

package/dist/types/core/transformFun.d.ts

@@ -0,0 +1,16 @@
+import type { WGS84Pos } from '../types';
+import * as Cesium from 'cesium';
+type RotationXYZ = {
+    x?: number;
+    y?: number;
+    z?: number;
+};
+type TransformableTileset = Cesium.Cesium3DTileset & {
+    _root?: {
+        transform: Cesium.Matrix4;
+    };
+};
+type TransformPosition = WGS84Pos | Cesium.Cartesian3;
+export declare function setTilesetTransform(_tileset: TransformableTileset | null, position: TransformPosition, rotation?: RotationXYZ | null): void;
+export declare function setEntityTransform(_entity: Cesium.Entity | null, position: WGS84Pos, rotation?: RotationXYZ | null): void;
+export {};

package/dist/types/draw/baseDraw.d.ts

@@ -0,0 +1,74 @@
+import KeyMap from '../map';
+import { Asset } from '../types';
+import * as Cesium from 'cesium';
+/**
+ * 交互式绘制工具基类。
+ *
+ * 负责创建 Cesium 事件处理器和绘制数据源，并统一维护绘制工具的激活、隐藏、清理和销毁生命周期。具体绘制工具通过实现事件注册逻辑完成交互。
+ */
+export default abstract class BaseDraw implements Asset {
+    /** 绘制实例的唯一标识。 */
+    id: string;
+    /** 绘制实例名称，默认由类名和唯一标识组成。 */
+    name: string;
+    /** 资源类型标识，当前沿用测量资源类型。 */
+    type: string;
+    /** 当前绘制工具是否处于交互状态。 */
+    isMeasure: boolean;
+    /** 当前绘制工具所属地图实例。 */
+    map: KeyMap;
+    /** 当前地图的 Cesium Viewer。 */
+    viewer: Cesium.Viewer;
+    /** 当前绘制工具独占的屏幕事件处理器。 */
+    handler: Cesium.ScreenSpaceEventHandler;
+    /** 存放绘制过程实体和结果实体的数据源。 */
+    dataSource: Cesium.CustomDataSource;
+    /** 绘制完成回调；未设置时为 `null`。 */
+    finishCallback: (() => void) | null;
+    /**
+     * 创建绘制工具实例。
+     *
+     * @param map - 地图实例，绘制数据源会添加到该地图的 Viewer 中。
+     */
+    constructor(map: KeyMap);
+    /**
+     * 激活当前绘制工具。
+     *
+     * 激活后会注册交互事件、将鼠标样式切换为十字光标、更新地图绘制状态，并将实例加入地图资源管理器。
+     */
+    activate(): void;
+    /**
+     * 停止当前绘制交互。
+     *
+     * 该方法只解除交互和状态，不会清除已经绘制到数据源中的结果。
+     */
+    deactivate(): void;
+    /**
+     * 设置绘制完成回调。
+     *
+     * @param callback - 绘制完成后调用的回调函数。
+     */
+    setFinishCallback(callback: () => void): void;
+    /** 显示绘制数据源。 */
+    show(): void;
+    /** 隐藏绘制数据源。 */
+    hide(): void;
+    /** 销毁绘制工具，停止交互、清理实体并注销事件。 */
+    destroy(): void;
+    /**
+     * 清空当前绘制结果并移除绘制数据源。
+     *
+     * 清理后实例会从地图资源管理器中解绑。
+     */
+    clear(): void;
+    /** 调用完成回调并停止绘制交互。 */
+    protected completeDrawing(): void;
+    /** 注销绘制工具注册的鼠标事件。 */
+    protected unRegisterEvents(): void;
+    /** 停止交互后的子类扩展钩子。 */
+    protected onDeactivate(): void;
+    /** 清空绘制结果后的子类扩展钩子。 */
+    protected onClear(): void;
+    /** 注册当前绘制工具需要的鼠标事件。 */
+    protected abstract registerEvents(): void;
+}

package/dist/types/draw/drawCircle.d.ts

@@ -0,0 +1,44 @@
+import KeyMap from '../map';
+import * as Cesium from 'cesium';
+import BaseDraw from './baseDraw';
+/**
+ * 圆形绘制工具。
+ *
+ * 首次左键设置圆心，鼠标移动动态调整半径并显示半径标签，再次左键或中键完成绘制；右键会重置当前绘制状态。
+ */
+export default class DrawCircle extends BaseDraw {
+    /** 圆心坐标；未设置或重置后为 `null`。 */
+    center: Cesium.Cartesian3 | null;
+    /** 当前圆半径，按圆心到预览点的 Cartesian 距离计算。 */
+    radius: number | null;
+    /** 鼠标移动时用于预览半径的临时终点。 */
+    previewPosition: Cesium.Cartesian3 | null;
+    /** 圆心点实体。 */
+    centerEntity: Cesium.Entity | null;
+    /** 半径虚线实体。 */
+    radiusEntity: Cesium.Entity | null;
+    /** 动态圆形轮廓实体。 */
+    circleEntity: Cesium.Entity | null;
+    /** 半径文本标签实体。 */
+    labelEntity: Cesium.Entity | null;
+    /** 完成绘制提示图标实体。 */
+    finishIconEntity: Cesium.Entity | null;
+    /**
+     * 创建圆形绘制工具。
+     *
+     * @param map - 地图实例。
+     */
+    constructor(map: KeyMap);
+    protected registerEvents(): void;
+    private leftClickEvent;
+    private mouseMoveEvent;
+    private middleClickEvent;
+    private rightClickEvent;
+    private createPointEntity;
+    private createRadiusEntity;
+    private createCircleEntity;
+    private updateLabelEntity;
+    private updateFinishIconEntity;
+    private resetDrawingState;
+    private finishDrawing;
+}

package/dist/types/draw/drawPoint.d.ts

@@ -0,0 +1,30 @@
+import type KeyMap from '../map';
+import * as Cesium from 'cesium';
+import BaseDraw from './baseDraw';
+/**
+ * 点绘制工具。
+ *
+ * 左键拾取一个有效场景坐标后创建点实体，并立即完成绘制。
+ */
+export default class DrawPoint extends BaseDraw {
+    /** 当前绘制点的世界坐标；未绘制或清空后为 `null`。 */
+    position: Cesium.Cartesian3 | null;
+    /** 当前点绘制关联实体引用；清空后为 `null`。 */
+    polygonEntity: Cesium.Entity | null;
+    /**
+     * 创建点绘制工具。
+     *
+     * @param map - 地图实例。
+     */
+    constructor(map: KeyMap);
+    protected registerEvents(): void;
+    /** 注册左键拾取点位并完成绘制的事件。 */
+    leftClickEvent(): void;
+    /**
+     * 创建点实体并添加到绘制数据源中。
+     *
+     * @param position - 点实体所在的世界坐标。
+     */
+    createPointEntity(position: Cesium.Cartesian3): void;
+    protected onClear(): void;
+}

package/dist/types/draw/drawPolygon.d.ts

@@ -0,0 +1,35 @@
+import KeyMap from '../map';
+import * as Cesium from 'cesium';
+import BaseDraw from './baseDraw';
+/**
+ * 多边形绘制工具。
+ *
+ * 左键添加多边形顶点，鼠标移动预览闭合边界，右键撤销上一个顶点，中键或点击最新结束节点完成绘制。
+ */
+export default class DrawPolygon extends BaseDraw {
+    /** 用户左键确认的多边形顶点。 */
+    positions: Cesium.Cartesian3[];
+    /** 鼠标移动时用于预览多边形边界的临时顶点。 */
+    previewPosition: Cesium.Cartesian3 | null;
+    /** 动态多边形边界线实体。 */
+    lineEntity: Cesium.Entity | null;
+    /** 多边形顶点标记实体集合。 */
+    vertexEntities: Cesium.Entity[];
+    /**
+     * 创建多边形绘制工具。
+     *
+     * @param map - 地图实例。
+     */
+    constructor(map: KeyMap);
+    private createLineEntity;
+    private createVertexEntity;
+    protected registerEvents(): void;
+    private leftClickEvent;
+    private mouseMoveEvent;
+    private middleClickEvent;
+    private rightClickEvent;
+    private isLatestVertexPicked;
+    private finishDrawing;
+    protected onDeactivate(): void;
+    protected onClear(): void;
+}

package/dist/types/draw/drawPolyline.d.ts

@@ -0,0 +1,35 @@
+import KeyMap from '../map';
+import * as Cesium from 'cesium';
+import BaseDraw from './baseDraw';
+/**
+ * 折线绘制工具。
+ *
+ * 左键添加折线节点，鼠标移动预览下一段，右键撤销上一个节点，中键或点击最新结束节点完成绘制。
+ */
+export default class DrawPolyline extends BaseDraw {
+    /** 用户左键确认的折线节点。 */
+    positions: Cesium.Cartesian3[];
+    /** 鼠标移动时用于预览下一段折线的临时节点。 */
+    previewPosition: Cesium.Cartesian3 | null;
+    /** 动态折线实体。 */
+    lineEntity: Cesium.Entity | null;
+    /** 折线节点标记实体集合。 */
+    vertexEntities: Cesium.Entity[];
+    /**
+     * 创建折线绘制工具。
+     *
+     * @param map - 地图实例。
+     */
+    constructor(map: KeyMap);
+    private createLineEntity;
+    private createVertexEntity;
+    protected registerEvents(): void;
+    private leftClickEvent;
+    private mouseMoveEvent;
+    private middleClickEvent;
+    private rightClickEvent;
+    private isLatestVertexPicked;
+    private finishDrawing;
+    protected onDeactivate(): void;
+    protected onClear(): void;
+}

package/dist/types/draw/index.d.ts

@@ -0,0 +1,17 @@
+import DrawPoint from './drawPoint';
+import DrawPolyline from './drawPolyline';
+import DrawCircle from './drawCircle';
+import DrawPolygon from './drawPolygon';
+export { default as DrawPoint } from './drawPoint';
+export { default as DrawPolyline } from './drawPolyline';
+export { default as DrawCircle } from './drawCircle';
+export { default as DrawPolygon } from './drawPolygon';
+/** SDK 内置交互式绘制工具实例类型。 */
+export type DrawType = DrawPoint | DrawPolyline | DrawCircle | DrawPolygon;
+declare const _default: {
+    DrawPoint: typeof DrawPoint;
+    DrawPolyline: typeof DrawPolyline;
+    DrawCircle: typeof DrawCircle;
+    DrawPolygon: typeof DrawPolygon;
+};
+export default _default;

package/dist/types/effect/cloud.d.ts

@@ -0,0 +1,34 @@
+import type KeyMap from '../map';
+/**
+ * 云层屏幕后处理效果。
+ *
+ * 通过 Cesium `PostProcessStage` 执行体积云 ray marching，并定时更新云层高度、厚度和风向等 uniform。构造函数当前保留 `_options` 参数但不读取配置。
+ */
+export default class CloudEffect {
+    private _map;
+    private t;
+    private addTimeout;
+    private cloudStage;
+    /**
+     * 创建云层效果。
+     *
+     * @param _options - 预留配置参数，当前实现不会读取该参数。
+     */
+    constructor(_options?: unknown);
+    /**
+     * 将云层后处理阶段添加到地图场景中，并启动定时更新。
+     *
+     * @param map - 地图实例。
+     */
+    add(map: KeyMap): void;
+    /** 从地图场景中移除并销毁云层后处理阶段，同时清理定时器。 */
+    destroy(): void;
+    /**
+     * 返回云层效果使用的 GLSL 片元着色器源码。
+     *
+     * @returns Cesium 后处理阶段使用的 shader 字符串。
+     */
+    cloud(): string;
+    /** 根据当前相机位置更新云层后处理阶段的地球半径、高度和厚度 uniform。 */
+    update(): void;
+}

package/dist/types/effect/fog.d.ts

@@ -0,0 +1,44 @@
+import type KeyMap from '../map';
+import * as Cesium from 'cesium';
+/** 基础雾效配置项。 */
+export interface FogEffectOptions {
+    /** 雾效可见距离，默认 `500.0`。 */
+    visibility?: number;
+    /** 雾效颜色，支持 CSS 颜色字符串。 */
+    color?: string;
+}
+/**
+ * 基础屏幕后处理雾效。
+ *
+ * 通过 Cesium `PostProcessStage` 按相机距离混合雾色，用于给场景添加均匀距离雾效果。
+ */
+export default class FogEffect {
+    /** 雾效可见距离。 */
+    visibility: number;
+    /** 雾效颜色。 */
+    color: Cesium.Color;
+    /** Cesium 距离插值参数，用于控制雾效随距离增强。 */
+    fogByDistance: Cesium.Cartesian4;
+    private map;
+    private fogStage;
+    /**
+     * 创建基础雾效。
+     *
+     * @param options - 雾效配置项。
+     */
+    constructor(options?: FogEffectOptions);
+    /**
+     * 将雾效后处理阶段添加到地图场景中。
+     *
+     * @param map - 地图实例。
+     */
+    add(map: KeyMap): void;
+    /** 从地图场景中移除并销毁雾效后处理阶段。 */
+    destroy(): void;
+    /**
+     * 返回基础雾效使用的 GLSL 片元着色器源码。
+     *
+     * @returns Cesium 后处理阶段使用的 shader 字符串。
+     */
+    fog(): string;
+}

package/dist/types/effect/fogPro.d.ts

@@ -0,0 +1,46 @@
+import type KeyMap from '../map';
+import * as Cesium from 'cesium';
+/** 高度雾效配置项。 */
+export interface FogProEffectOptions {
+    /** 全局雾浓度，默认 `0.6`。 */
+    density?: number;
+    /** 雾效颜色，支持 CSS 颜色字符串。 */
+    color?: string;
+    /** 雾层最大影响高度，默认 `100`。 */
+    height?: number;
+}
+/**
+ * 高度雾屏幕后处理效果。
+ *
+ * 根据相机高度、像素粗略高程和全局浓度计算高度雾，并在保留透明度的前提下混合雾色。
+ */
+export default class FogProEffect {
+    /** 全局雾浓度。 */
+    density: number;
+    /** 雾效颜色。 */
+    color: Cesium.Color;
+    /** 雾层最大影响高度。 */
+    height: number;
+    private map;
+    private fogProStage;
+    /**
+     * 创建高度雾效果。
+     *
+     * @param options - 高度雾配置项。
+     */
+    constructor(options?: FogProEffectOptions);
+    /**
+     * 将高度雾后处理阶段添加到地图场景中。
+     *
+     * @param map - 地图实例。
+     */
+    add(map: KeyMap): void;
+    /** 从地图场景中移除并销毁高度雾后处理阶段。 */
+    destroy(): void;
+    /**
+     * 返回高度雾使用的 GLSL 片元着色器源码。
+     *
+     * @returns Cesium 后处理阶段使用的 shader 字符串。
+     */
+    fogPro(): string;
+}

package/dist/types/effect/index.d.ts

@@ -0,0 +1,32 @@
+import FogEffect from './fog';
+import FogProEffect from './fogPro';
+import RainyEffect from './rainy';
+import SnowCoverEffect from './snowCover';
+import SnowFallEffect from './snowFall';
+import LensFlareEffect from './lensflare';
+import CloudEffect from './cloud';
+export { default as FogEffect } from './fog';
+export { default as FogProEffect } from './fogPro';
+export { default as RainyEffect } from './rainy';
+export { default as SnowCoverEffect } from './snowCover';
+export { default as SnowFallEffect } from './snowFall';
+export { default as LensFlareEffect } from './lensflare';
+export { default as CloudEffect } from './cloud';
+export type { FogEffectOptions } from './fog';
+export type { FogProEffectOptions } from './fogPro';
+export type { LensEffectOptions } from './lensflare';
+export type { RainyEffectOptions } from './rainy';
+export type { SnowCoverEffectOptions } from './snowCover';
+export type { SnowFallEffectOptions } from './snowFall';
+/** SDK 内置场景特效实例类型。 */
+export type EffectType = FogEffect | FogProEffect | RainyEffect | SnowCoverEffect | SnowFallEffect | LensFlareEffect | CloudEffect;
+declare const _default: {
+    FogEffect: typeof FogEffect;
+    FogProEffect: typeof FogProEffect;
+    RainyEffect: typeof RainyEffect;
+    SnowCoverEffect: typeof SnowCoverEffect;
+    SnowFallEffect: typeof SnowFallEffect;
+    LensFlareEffect: typeof LensFlareEffect;
+    CloudEffect: typeof CloudEffect;
+};
+export default _default;

package/dist/types/effect/lensflare.d.ts

@@ -0,0 +1,38 @@
+import type KeyMap from '../map';
+import * as Cesium from 'cesium';
+/** 镜头光晕效果配置项。 */
+export interface LensEffectOptions {
+    /** 光晕颜色，支持 CSS 颜色字符串。 */
+    color?: string;
+}
+/**
+ * 镜头光晕屏幕后处理效果。
+ *
+ * 根据太阳在屏幕中的位置和相机朝向叠加镜头光晕。该类在模块出口中以 `LensFlareEffect` 名称导出。
+ */
+export default class lensEffect {
+    /** 镜头光晕颜色。 */
+    color: Cesium.Color;
+    private map;
+    private lensStage;
+    /**
+     * 创建镜头光晕效果。
+     *
+     * @param options - 镜头光晕效果配置项。
+     */
+    constructor(options?: LensEffectOptions);
+    /**
+     * 将镜头光晕后处理阶段添加到地图场景中。
+     *
+     * @param map - 地图实例。
+     */
+    add(map: KeyMap): void;
+    /** 从地图场景中移除并销毁镜头光晕后处理阶段。 */
+    destroy(): void;
+    /**
+     * 返回镜头光晕使用的 GLSL 片元着色器源码。
+     *
+     * @returns Cesium 后处理阶段使用的 shader 字符串。
+     */
+    lens(): string;
+}

package/dist/types/effect/rainy.d.ts

@@ -0,0 +1,47 @@
+import type KeyMap from '../map';
+import * as Cesium from 'cesium';
+/** 雨天效果配置项。 */
+export interface RainyEffectOptions {
+    /** 雨丝倾斜角度，默认 `0.1`。 */
+    angle?: number;
+    /** 雨滴动画速度，默认 `0.5`。 */
+    speed?: number;
+    /** 雨效颜色，支持 CSS 颜色字符串。 */
+    color?: string;
+}
+/**
+ * 雨天屏幕后处理效果。
+ *
+ * 通过 Cesium `PostProcessStage` 在画面上叠加带方向和速度的雨丝效果。
+ */
+declare class RainyEffect {
+    /** 雨丝倾斜角度。 */
+    angle: number;
+    /** 雨滴动画速度。 */
+    speed: number;
+    /** 雨效颜色。 */
+    color: Cesium.Color;
+    private map;
+    private rainyStage;
+    /**
+     * 创建雨天效果。
+     *
+     * @param options - 雨天效果配置项。
+     */
+    constructor(options?: RainyEffectOptions);
+    /**
+     * 将雨天后处理阶段添加到地图场景中。
+     *
+     * @param map - 地图实例。
+     */
+    add(map: KeyMap): void;
+    /** 从地图场景中移除并销毁雨天后处理阶段。 */
+    destroy(): void;
+    /**
+     * 返回雨天效果使用的 GLSL 片元着色器源码。
+     *
+     * @returns Cesium 后处理阶段使用的 shader 字符串。
+     */
+    rainy(): string;
+}
+export default RainyEffect;