@baidumap/mapv-three 1.0.0

package/dist/types/threemap/mapView/tileProvider/vector/HDTrafficTileProvider.d.ts

@@ -0,0 +1,36 @@
+export class HDTrafficTileProvider extends VectorTileProvider {
+    constructor(options?: {});
+    /** @private */
+    private _supportedTargetProjectionNames;
+    /** @private */
+    private _defaultMinLevel;
+    /** @private */
+    private _defaultMaxLevel;
+    _url: any;
+    _apiHost: any;
+    _options: {};
+    _replaceStr: {
+        x: string;
+        y: string;
+        z: string;
+        reverseY: string;
+    };
+    _asyncInit(): Promise<void>;
+    _dataLoader: AsyncDataTileLoader | undefined;
+    getTileURL(z: any, x: any, y: any, tile: any): any;
+    getWorkerOptions(): {};
+    doRequestTileData(tile: any): Promise<any[]>;
+    _request(data: any): Promise<any>;
+    /**
+     * @protected
+     */
+    protected onSurfaceTileAdded(surfaceTile: any, engine: any): void;
+    /**
+     * @protected
+     */
+    protected onSurfaceTileRemoved(surfaceTile: any, engine: any): void;
+    set apiHost(apiHost: any);
+    get apiHost(): any;
+}
+import { VectorTileProvider } from './VectorTileProvider';
+import { AsyncDataTileLoader } from '../AsyncDataTileLoader';

package/dist/types/threemap/mapView/tileProvider/vector/MapboxVectorTileProvider.d.ts

@@ -0,0 +1,77 @@
+export class MapboxVectorTileProvider extends VectorTileProvider {
+    constructor(options?: {});
+    /** @private */
+    private _shouldRenderPlaceholder;
+    /** @private */
+    private _defaultStartLevel;
+    /** @private */
+    private _defaultMaxLevel;
+    /** @private */
+    private _defaultMaterials;
+    /** @private */
+    private _symbols;
+    /** @private */
+    private _materialManager;
+    _style: any;
+    _accessToken: any;
+    _defaultStyle: any;
+    _dispalyOptions: any;
+    _options: {};
+    /**
+     * 异步初始化方法。
+     */
+    _asyncInit(): Promise<void>;
+    _dataLoader: AsyncDataTileLoader | undefined;
+    _loadStyle(): Promise<void>;
+    _stylePath: string | undefined;
+    _sourceUrl: any;
+    _styleJSON: any;
+    _defaultStyleJSON: any;
+    _spriteData: {
+        [_: string]: import("../../mapbox/sprite").SpriteDataItem;
+    } | undefined;
+    _spriteImage: any;
+    spriteTexture: any;
+    _ready: boolean | undefined;
+    /**
+     * @private
+     * @returns {Promise}
+     */
+    private _getTileJson;
+    /**
+     * @returns {Promise}
+     */
+    _getStyleJSON(): Promise<any>;
+    getTileURL(z: any, x: any, y: any, tile: any): any;
+    getWorkerOptions(): {
+        displayOptions: any;
+    };
+    /**
+     * 获取瓦片数据并返回对应的Group对象
+     * @param {*} tile
+     * @returns {Group} 返回一个包含瓦片数据的Group对象
+     */
+    doRequestTileData(tile: any): Group;
+    _hasBufferData(bufferData: any): any;
+    _getBackgroundMesh(data: any, meshType: any, maxLayerIndex: any): any;
+    _getFillOpaqueMesh(data: any, meshType: any, maxLayerIndex: any): any;
+    _getFillPatternMesh(data: any, meshType: any, maxLayerIndex: any): any;
+    _getFillTranslucentMesh(data: any, meshType: any, maxLayerIndex: any): any;
+    _getLineOpaqueMesh(data: any, meshType: any, maxLayerIndex: any): any;
+    _getLineTranslucentMesh(data: any, meshType: any, maxLayerIndex: any): any;
+    _getLineDashedMesh(data: any, meshType: any, maxLayerIndex: any, scale: any): any;
+    _getExtrusionOpaqueMesh(data: any, meshType: any, maxLayerIndex: any): any;
+    _getExtrusionTranslucentMesh(data: any, meshType: any, maxLayerIndex: any): any;
+    _getMaterial(type: any): any;
+    _setupSymbolData(symbolData: any, group: any): void;
+    _addTilePOI(surfaceTile: any, engine: any): void;
+    _removeTilePOI(surfaceTile: any, engine: any): void;
+    onSurfaceTileAdded(surfaceTile: any, engine: any): void;
+    onSurfaceTileRemoved(surfaceTile: any, engine: any): void;
+    addAllSymbols(): void;
+    removeAllSymbols(): void;
+    set materialManager(materialManager: null);
+    get materialManager(): null;
+}
+import { VectorTileProvider } from './VectorTileProvider';
+import { AsyncDataTileLoader } from '../AsyncDataTileLoader';

package/dist/types/threemap/mapView/tileProvider/vector/PlaneVectorTileProvider.d.ts

@@ -0,0 +1,23 @@
+export class PlaneVectorTileProvider extends VectorTileProvider {
+    /** @private */
+    private _supportedTargetProjectionNames;
+    /**
+     * 请求瓦片数据
+     * @param tile 需要请求的瓦片对象
+     */
+    doRequestTileData(tile: any): Promise<any>;
+    /**
+     * 从瓦片中请求Web墨卡托数据。
+     *
+     * @param tile - 瓦片对象。
+     * @returns 返回网格和材质的组合。
+     */
+    _requestWebMercatorTileData(tile: any): any;
+    /**
+     * 生成请求ECEF瓦片数据的函数。
+     *
+     * @param tile - 瓦片对象。
+     */
+    _requestEcefTileData(tile: any): any;
+}
+import { VectorTileProvider } from './VectorTileProvider';

package/dist/types/threemap/mapView/tileProvider/vector/VectorTileProvider.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 矢量瓦片提供者，负责矢量瓦片数据的请求和缓存。<br/>
+ * 该类是所有矢量瓦片提供者的**抽象基类，不可直接使用，需要使用子类。**
+ *
+ * @category Internal
+ */
+export class VectorTileProvider extends TileProvider {
+    isVectorTileProvider: boolean;
+    errorFeedback(): any[];
+    /**
+     * @param {*} tile
+     * @returns
+     * Array[object, groundObject]：包含对象的完整transform
+     * object: 在3D场景中渲染的对象
+     * groundObject: 在地面上渲染的对象
+     * @desc 请求瓦片数据
+     */
+    doRequestTileData(tile: any): Promise<void>;
+    getGroundTileData(tile: any): any[];
+    _groundTileMaterial: any;
+}
+import { TileProvider } from '../TileProvider';

package/dist/types/threemap/mapView/utils/createGroundTileMesh.d.ts

@@ -0,0 +1,5 @@
+export function createGroundTileMesh(tileConfig: any, repeatedData: any): {
+    vertices: any;
+    uvs: any;
+    indices: any;
+};

package/dist/types/threemap/mapView/utils/projectVertices.d.ts

@@ -0,0 +1,8 @@
+export function reprojectCoordinate(sourceProjection: any, targetProjection: any, input: any, output: any): any;
+export function projectVertices(vertices: any, tileConfig: any, isMerge?: boolean, isSubCenter?: boolean): void;
+export function subdivideVertices(vertices: any, indices: any, uvs: any, tileConfig: any): {
+    vertices: any;
+    indices: any;
+    uvs: any;
+};
+export function subdivideLineVertices(vertices: any, tileConfig: any): any;

package/dist/types/threemap/materials/BatchBuildingMaterial.d.ts

@@ -0,0 +1,18 @@
+export class BatchBuildingMaterial {
+    constructor(parameters?: {});
+    type: string;
+    _textureGrid: any;
+    _buildingLevelCount: any;
+    _emissiveIntensity: any;
+    colorNode: any;
+    _emissiveMapNode: any;
+    emissiveNode: any;
+    _roughnessNode: any;
+    roughnessNode: any;
+    set customMap(map: any);
+    set customEmissiveMap(map: any);
+    set customEmissiveIntensity(intensity: any);
+    set levelCount(count: any);
+    set textureGrid(grid: any);
+    set customRoughnessMap(map: any);
+}

package/dist/types/threemap/materials/RoadMarkingMaterial.d.ts

@@ -0,0 +1,19 @@
+export class RoadMarkingMaterial {
+    constructor(parameters?: {});
+    /** @private */
+    private _diffuseMap;
+    /** @private */
+    private _metallicRoughnessMap;
+    /** @private */
+    private _uvMap;
+    type: string;
+    colorNode: any;
+    roughnessNode: any;
+    metalnessNode: any;
+    set diffuseMap(map: any);
+    get diffuseMap(): any;
+    set metallicRoughnessMap(map: any);
+    get metallicRoughnessMap(): any;
+    set uvMap(map: any);
+    get uvMap(): any;
+}

package/dist/types/threemap/materials/TerrainClassificationMaterial.d.ts

@@ -0,0 +1,14 @@
+export class TerrainClassificationMaterial {
+    constructor(parameters?: {});
+    type: string;
+    _diffuseColor: any;
+    _classificationColor1: any;
+    _classificationColor2: any;
+    colorNode: any;
+    alphaTestNode: any;
+    alphaTest: number;
+    _configTexture(texture: any): void;
+    set classificationMap1(map: any);
+    set classificationMap2(map: any);
+    set diffuseMap(map: any);
+}

package/dist/types/threemap/model/AnimationModel.d.ts

@@ -0,0 +1,14 @@
+export class AnimationModel extends SimpleModel {
+    constructor(params: any);
+    _updateData(gltf: any, model: any): void;
+    animations: any;
+    mixer: any;
+    animationActions: any;
+    play(actionIndex: any): void;
+    stop(actionIndex: any): void;
+    playAll(): void;
+    stopAll(): void;
+    setSpeed(speed: any, actionIndex: any): void;
+    setLoop(loop: any, actionIndex: any): void;
+}
+import { SimpleModel } from './SimpleModel';

package/dist/types/threemap/model/GLTFScene.d.ts

@@ -0,0 +1,12 @@
+export class GLTFScene {
+    constructor(options?: {});
+    _options: {};
+    afterAddToEngine(engine: any): void;
+    _engine: any;
+    _load(): Promise<void>;
+    _loadModels(): Promise<void>;
+    _loadInstancedStaticMesh(loader: any, modelDesc: any): Promise<void>;
+    _loadStaticMesh(loader: any, modelDesc: any): Promise<void>;
+    _loadMeta(): Promise<void>;
+    _meta: any;
+}

package/dist/types/threemap/model/LODModel.d.ts

@@ -0,0 +1,161 @@
+/**
+ * LOD(Level of Detail)模型类，用于加载和管理不同细节层级的3D模型。
+ * 根据相机距离自动切换不同精度的模型，优化渲染性能。
+ *
+ * @category Model
+ * @extends Object3D
+ * @example
+ * ```javascript
+ * const lodModel = new LODModel({
+ *     hysteresis: 0.1,
+ *     levels: [
+ *         { distance: 100, file: 'models/high.glb' },
+ *         { distance: 500, file: 'models/medium.glb' },
+ *         { distance: 1000, file: 'models/low.glb' }
+ *     ]
+ * });
+ * engine.add(lodModel);
+ * ```
+ *
+ * @example
+ * ```javascript
+* // 监听单个模型加载完成事件
+* lodModel.addEventListener('loaded', (event) => {
+*     console.log('模型加载完成:', event.value);
+* });
+*
+* // 监听所有层级加载完成事件
+* lodModel.addEventListener('complete', (event) => {
+*     console.log('所有层级加载完成');
+* });
+ * ```
+*/
+export class LODModel {
+    /**
+     * LOD模型构造函数
+     * @param {Object} parameters 配置参数
+     * @param {number} parameters.hysteresis 缩进与拉远的缓冲参数，防止在临界点缩放时抖动，范围 0~1, 默认 0.1
+     * @param {Array} parameters.levels levels 层级数据 [{distance: 1000, hysteresis: 0.1, file: 'a/b/c.glb'}]
+     */
+    constructor(parameters: {
+        hysteresis: number;
+        levels: any[];
+    });
+    /** @private */
+    private _hysteresis;
+    /** @private */
+    private _levels;
+    /** @private */
+    private _currentLevel;
+    /** @private */
+    private _currentModel;
+    /** @private */
+    private _loader;
+    /**
+     * 设置缩进与拉远的缓冲参数，防止在临界点缩放时抖动
+     * @type {number}
+     * @example
+    * ```javascript
+    * lodModel.hysteresis = 0.2; // 设置20%的缓冲区间
+    * ```
+    */
+    set hysteresis(value: number);
+    /**
+     * 获取缩进与拉远的缓冲参数
+     * @return {number}
+     */
+    get hysteresis(): number;
+    /**
+     * 设置LOD层级配置数组
+     * @type {Array<Object>}
+     * @example
+     * ```javascript
+     * lodModel.levels = [
+     *     { distance: 100, file: 'high.glb' },
+     *     { distance: 500, file: 'medium.glb' },
+     *     { distance: 1000, file: 'low.glb' }
+     * ];
+     * ```
+    */
+    set levels(levels: Array<Object>);
+    /**
+     * 获取LOD层级配置数组
+     * @return {Array<Object>}
+     */
+    get levels(): Array<Object>;
+    afterAddToEngine(engine: any): void;
+    _engine: any;
+    _modelMeshSingleton: PromisedSingleton | undefined;
+    beforeRemoveFromEngine(engine: any): void;
+    /**
+     * @internal
+     */
+    _generateModelMesh: (key: any) => Promise<any>;
+    /**
+     * 添加一个LOD层级
+     * @param {string} file 模型文件路径
+     * @param {number} distance 切换距离
+     * @param {number} hysteresis 该层级的缓冲参数
+     * @returns {LODModel} 返回this
+     * @example
+    * ```javascript
+    * lodModel.addLevel('models/detail.glb', 200, 0.1)
+    *         .addLevel('models/simple.glb', 800, 0.1);
+    * ```
+    */
+    addLevel(file: string, distance?: number, hysteresis?: number): LODModel;
+    /**
+     * 移除指定文件的LOD层级
+     * @param {string} file 要移除的模型文件路径
+     * @returns {LODModel} 返回this以支持链式调用
+     * @example
+     * ```javascript
+     * lodModel.removeLevel('models/detail.glb');
+     * ```
+    */
+    removeLevel(file: string): LODModel;
+    /**
+     * 获取当前层级
+     * @return {number} 当前层级
+     */
+    getCurrentLevel(): number;
+    /**
+     * 获取当前模型
+     * @return {Promise<Object3D>} 当前模型
+     */
+    getCurrentModel(): Promise<Object3D>;
+    /**
+     * 获取指定层级的模型
+     * @param {number} level 层级索引
+     * @return {Promise<Object3D>} 模型
+     */
+    getModel(level: number): Promise<Object3D>;
+    update: () => Promise<void>;
+    handleLoaded(model: any): void;
+    dispose(): void;
+    /**
+     * 获取模型是否初始化
+     * @return {boolean}
+     */
+    get isInit(): boolean;
+    destroyModel(): void;
+    /**
+     * 设置模型变换参数
+     * @type {Object}
+     * @example
+     * ```javascript
+     * lodModel.transform = {
+     *     translate: [100, 0, 100],
+     *     rotation: [0, Math.PI/2, 0],
+     *     scale: 2
+     * };
+     * ```
+    */
+    set transform(value: Object);
+    /**
+     * 获取模型变换参数
+     * @return {Object}
+    */
+    get transform(): Object;
+}
+import { PromisedSingleton } from '../../util/PromisedSingleton';

package/dist/types/threemap/model/LODModelManager.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 暂不可用
+ * TODO: 定义config规格，补充解析config自动创建LODModel的过程
+ */
+export class LODModelManager {
+    constructor(engine: any, config: any);
+    _engine: any;
+    _config: any;
+    _lods: any[];
+    _enabled: boolean;
+    set enabled(enabled: boolean);
+    get enabled(): boolean;
+    set config(config: any);
+    get config(): any;
+    _i(): void;
+    dispose(): void;
+}

package/dist/types/threemap/model/LodModelCache.d.ts

@@ -0,0 +1,2 @@
+export const LodModelCache: LRUCache;
+import { LRUCache } from '../../util/LRUCache';

package/dist/types/threemap/model/SimpleModel.d.ts

@@ -0,0 +1,108 @@
+/**
+ * 单体模型，简易加载方式，兼容多种投影方式。用于加载单个3D模型并设置其位置、旋转和缩放。
+ *
+ * @category Model
+ * @example
+ * ```javascript
+ * let model = engine.add(new mapvthree.SimpleModel({
+ *  name: '模型名称',
+ *  url: '模型路径',
+ *  point: [lng, lat, z],
+ *  scale: [1, 1, 1],
+ *  rotation: [0, 0, 0],
+ * }))
+ * ```
+ *
+ * @example
+ * ```javascript
+ * // 监听模型加载完成事件
+ * model.addEventListener('loaded', e => {
+ *     console.log('模型加载完成:', e.value);
+ * });
+ * ```
+ */
+export class SimpleModel {
+    /**
+     * 构造函数
+     * @param {Object} parameters 配置参数
+     * @param {string} [parameters.name=''] 模型名称
+     * @param {string} [parameters.object] 模型URL文件路径或Object3D实例，URL模型支持glb/gltf格式
+     * @param {Array<number>|Vector3} [parameters.point=[0,0,0]] 模型位置，格式为[经度,纬度,高度]
+     * @param {Array<number>|Vector3|number} [parameters.scale=[1,1,1]] 模型缩放
+     * @param {Array<number>|Vector3} [parameters.rotation=[0,0,0]] 模型旋转,x,y,z三个分量分别代表roll,pitch,heading，单位为弧度
+     * @param {boolean} [parameters.autoYUpToZUp=true] 是否自动将Y轴向上转换为Z轴向上,默认true,仅对通过URL加载的模型有效
+     */
+    constructor(parameters: {
+        name?: string | undefined;
+        object?: string | undefined;
+        point?: Array<number> | Vector3;
+        scale?: Array<number> | Vector3 | number;
+        rotation?: Array<number> | Vector3;
+        autoYUpToZUp?: boolean | undefined;
+    });
+    /** @internal */
+    _autoYUpToZUp: boolean;
+    _parameters: {
+        name?: string | undefined;
+        object?: string | undefined;
+        point?: Array<number> | Vector3;
+        scale?: Array<number> | Vector3 | number;
+        rotation?: Array<number> | Vector3;
+        autoYUpToZUp?: boolean | undefined;
+    };
+    _name: string;
+    _object: any;
+    afterAddToEngine(engine: any): void;
+    _engine: any;
+    beforeRemoveFromEngine(): void;
+    _initModel(): Promise<void>;
+    dispose(): void;
+    /**
+     * 设置模型的变换参数
+     * @param {Object} transform 变换参数对象
+     * @param {Array<number>|Vector3} [transform.point] 位置坐标[经度,纬度,高度]
+     * @param {Array<number>|Vector3} [transform.rotation] 旋转角度，x,y,z三个分量分别代表roll,pitch,heading (单位为弧度)
+     * @param {Array<number>|Vector3|number} [transform.scale] 缩放比例
+     *
+     * @example
+     * ```javascript
+     * // 设置位置、旋转和缩放
+     * model.setTransform({
+     *     point: [116.404, 39.915, 100],
+     *     rotation: [Math.PI/2, 0, 0],
+     *     scale: [2, 2, 2]
+     * });
+     *
+     * // 只设置位置
+     * model.setTransform({
+     *     point: [116.404, 39.915, 100]
+     * });
+     *
+     * // 使用Vector3设置
+     * model.setTransform({
+     *     point: new Vector3(116.404, 39.915, 100),
+     *     scale: new Vector3(2, 2, 2)
+     * });
+     * ```
+    */
+    setTransform(transform?: {
+        point?: Array<number> | Vector3;
+        rotation?: Array<number> | Vector3;
+        scale?: Array<number> | Vector3 | number;
+    }): void;
+    /**
+     * 设置模型位置
+     * @param {Array<number>|Vector3} value 位置坐标[经度,纬度,高度]
+     * @example
+    * ```javascript
+    * model.point = [116.404, 39.915, 100];
+    * ```
+    */
+    set point(value: Array<number> | Vector3);
+    /**
+     * 是否自动将Y轴向上转换为Z轴向上，仅对通过URL加载的模型有效
+     * @type {boolean}
+     */
+    get autoYUpToZUp(): boolean;
+    _updateData(): void;
+}

package/dist/types/threemap/natural/CustomStaticSky.d.ts

@@ -0,0 +1,55 @@
+/**
+ * 自定义静态天空，需要指定天空的贴图信息
+ * ![](media://custom_static_sky.png)
+ */
+export class CustomStaticSky extends EmptySky {
+    constructor(options?: {});
+    isCustomStaticSky: boolean;
+    /**
+     * @internal
+     * cube cubeuv
+     */
+    _textureIsCube: boolean;
+    /** @internal */ _textureIsHDR: boolean;
+    /** @internal */ _textureURL: null;
+    /**
+     * @internal
+     * 仅立方体贴图使用
+     */
+    _textureNames: null;
+    /** @internal */ _isVerticalTexture: null;
+    /** @internal */ _mesh: null;
+    /** @internal */ _material: null;
+    /** @internal */ _sphereGeometry: null;
+    /** @internal */ _envTexture: null;
+    /** @internal */ _engine: null;
+    /** @internal */ _PMREMGenerator: null;
+    /** @internal */ _fadeHeightStart: number;
+    /** @internal */ _fadeHeightRange: number;
+    /** @internal */ _envCaptureLocationKey: string;
+    set isVerticalTexture(value: any);
+    get isVerticalTexture(): any;
+    /** @protected */
+    protected afterAddToEngine(engine: any): void;
+    /** @protected */
+    protected onBeforeScenePrepareRender(engine: any, scene: any, camera: any): void;
+    /** @internal */
+    _onLocalTransform(mesh: any): void;
+    /** @internal */
+    _renderEnvTexture(): void;
+    _cubeRenderTarget: any;
+    _cubeCamera: any;
+    _envRT: any;
+    /** @internal */
+    _loadSkyTexture(): void;
+    set textureIsCube(value: boolean);
+    get textureIsCube(): boolean;
+    set textureURL(value: null);
+    /**
+     * 自定义天空贴图url
+     */
+    get textureURL(): null;
+    set affectWorld(value: boolean);
+    get affectWorld(): boolean;
+}
+import { EmptySky } from './EmptySky';

package/dist/types/threemap/natural/DefaultSky.d.ts

@@ -0,0 +1,71 @@
+/**
+ * 默认天空效果，提供简单的渐变天空效果，是性能开销与效果比较平衡的天空。
+ *
+ * DefaultSky类是{@link EmptySky}的扩展，添加了一个梯度天空后处理通道，可以创建简单的渐变天空效果，适用于不需要高级天空效果的场景。
+ *
+ * 如果需要更复杂的天空效果，可以使用{@link DynamicSky}
+ *
+ * @category Natural
+ * @example
+ * ```javascript
+ * const sky = engine.add(new mapvthree.DefaultSky());
+ * sky.color = new THREE.Color(0x87ceeb); // 设置天空基础颜色
+ * sky.highColor = new THREE.Color(0x67ceeb); // 设置天空高处颜色
+ * ```
+ */
+export class DefaultSky extends EmptySky {
+    /**
+     * 标识为DefaultSky
+     * @type {boolean}
+     * @readonly
+     */
+    readonly isDefaultSky: boolean;
+    /**
+     * 天空名称
+     * @type {string}
+     * @readonly
+     */
+    readonly name: string;
+    /** @private */ private _postPass;
+    /** @private */ private _engine;
+    _color: any;
+    _highColor: any;
+    /**
+     * 初始化环境和后处理效果
+     * @private
+     */
+    private initEnv;
+    /**
+     * 设置天空高处颜色
+     * @type {Color}
+     */
+    set highColor(color: Color);
+    /**
+     * 获取天空高处颜色
+     * @type {Color}
+     */
+    get highColor(): Color;
+    /**
+     * 设置天空基础颜色
+     * @type {Color}
+     */
+    set color(color: Color);
+    /**
+     * 获取天空基础颜色
+     * @type {Color}
+     */
+    get color(): Color;
+    /**
+     * 设置是否启用天空后处理效果
+     * @type {boolean}
+     * @internal
+     */
+    set enablePostPass(value: boolean);
+    /**
+     * 是否启用天空后处理效果
+     * @type {boolean}
+     * @internal
+     */
+    get enablePostPass(): boolean;
+}
+import { EmptySky } from './EmptySky';