@baidumap/mapv-three 1.3.3 → 1.4.1

package/dist/types/threejs/objects/point/Label.d.ts

@@ -168,7 +168,8 @@ export class Label extends GeoMesh {
      * @param {String} [parameters.textAnchor='center'] 文字锚点, 支持'left'|'right'|'top'|'bottom'|'top-left'|'top-right'|'bottom-left'|'bottom-right', 默认'center'
      * @param {Array} [parameters.textOffset=[0,0]] 文字偏移, 默认[0,0]
      * @param {String} [parameters.textWeight='400'] 文字粗细, 默认'400'
-     * @param {Array} [parameters.textPadding=[0,0]] 文字内边距, 默认[0,0]
+     * @param {Array} [parameters.textPadding=[0,2]] 文字内边距, 默认[0,0]
+     * @param {Array} [parameters.padding=[2, 2]] 文字与图标间距, 默认[2, 2]
      * @param {Number} [parameters.iconWidth=40] 图标宽度, 默认40
      * @param {Number} [parameters.iconHeight=40] 图标高度, 默认40
      * @param {Number} [parameters.rotateZ=0] 旋转角度, 默认0
@@ -193,6 +194,7 @@ export class Label extends GeoMesh {
         textOffset?: any[] | undefined;
         textWeight?: string | undefined;
         textPadding?: any[] | undefined;
+        padding?: any[] | undefined;
         iconWidth?: number | undefined;
         iconHeight?: number | undefined;
         rotateZ?: number | undefined;
@@ -225,6 +227,7 @@ export class Label extends GeoMesh {
     /** @protected */ protected iconUrlHash: LRUCache;
     /** @protected */ protected boxHash: Map<any, any>;
     /** @protected */ protected gap: number[];
+    /** @protected */ protected _labelQuadStarts: any[];
     /** @protected */ protected geometry: any;
     /** @protected */ protected material: any;
     /** @protected */ protected canvas: HTMLCanvasElement;
@@ -247,6 +250,7 @@ export class Label extends GeoMesh {
     _textWeight: any;
     _rotateZ: any;
     _textPadding: any;
+    _padding: any;
     textAlign: any;
     _iconWidth: any;
     _iconHeight: any;
@@ -445,9 +449,10 @@ export class Label extends GeoMesh {
         radius: number;
         fontFamily: any;
         fontWeight: string;
-        characterSet: any;
+        characterSet: any[];
         sdf: boolean;
     } | undefined;
+    updateTextSpriteTexture(): void;
     packTextBuffer(textData: any, indexOffset?: number): number | undefined;
     updateTextDataItem(data: any, indexOffset: any): any;
     packRotateZ(rotateZ: any): void;
@@ -456,6 +461,7 @@ export class Label extends GeoMesh {
     packFade(data: any): void;
     packOffset(offsetX: any, offsetY: any): void;
     packWH(frameWidth: any, frameHeight: any, iconSize: any): void;
+    packStretch(offsetX1: any, offsetX2: any, stretchRatio: any, stretchGap: any): void;
     packTypeAndPIndex(type: any): void;
     packIconStyle(opacity?: number): void;
     packIconUV(iconUV: any): void;
@@ -467,6 +473,13 @@ export class Label extends GeoMesh {
     _calculateTransform(position: any, outputMatrix: any): any;
     onBeforeScenePrepareRenderHook(engine: any, scene: any, camera: any): void;
     getPixelSize(position: any): any;
+    /**
+     * 根据quad索引找到对应的label索引
+     * @param {number} quadIndex - 当前quad的索引
+     * @returns {number} 对应的label索引
+     * @private
+     */
+    private _findLabelIndexByQuad;
     getVertexPosition(index: any, target: any): any;
     set enableFade(value: any);
     get enableFade(): any;

package/dist/types/threejs/objects/point/label/GeometryBufferBuilder.d.ts

@@ -10,6 +10,7 @@ export class GeometryBufferBuilder {
         offsets: Float32Array<ArrayBuffer>;
         instanceRotationMatrices: Float32Array<ArrayBuffer>;
         whs: Float32Array<ArrayBuffer>;
+        stretch: Float32Array<ArrayBuffer>;
         styles: Float32Array<ArrayBuffer>;
         fadeOpacityAndSince: Float32Array<ArrayBuffer>;
         indices: never[];
@@ -24,6 +25,7 @@ export class GeometryBufferBuilder {
         whsOffset: number;
         stylesOffset: number;
         fadeOpacityAndSinceOffset: number;
+        stretchOffset: number;
     } | undefined;
     _cachePositions: any[] | undefined;
     clear(): void;
@@ -34,6 +36,7 @@ export class GeometryBufferBuilder {
     packRotateZ(theta: any): void;
     packStyle(fill: any, stroke: any, strokeWidth: any): void;
     packWH(width: any, height: any, iconSize?: number): void;
+    packStretch(start?: number, end?: number, stretchRatio?: number, stretchGap?: number): void;
     packRotationMatrix(mat3: any): void;
     packFade(fadeOpacity: any, fadeSince: any): void;
     packQuadIndices(indexOffset: any): void;

package/dist/types/threejs/objects/point/label/TextBoxCalculator.d.ts

@@ -4,9 +4,11 @@ export class TextBoxCalculator {
     engine: any;
     dpr: any;
     padding: any;
-    defaultFontSize: any;
-    defaultFontFamily: any;
-    defaultTextStrokeWidth: any;
+    _textPadding: any;
+    _textSize: any;
+    _textWeight: any;
+    _textStrokeWidth: any;
+    _textFamily: any;
     getTextBox(data: any, isFlat: any): {
         width: number;
         height: number;

package/dist/types/threejs/objects/text/ScreenText.d.ts

@@ -0,0 +1,273 @@
+/**
+ * 屏幕文字对象, 支持沿线绘制文字
+ *
+ *
+ * @category Objects
+ */
+export class ScreenText extends GeoMesh {
+    /**
+     * 构造函数
+     * @param {Object} parameters 配置参数
+     * @param {number} [parameters.fontSize=26] 字体大小
+     * @param {string} [parameters.fontFamily='Arial'] 字体族
+     * @param {string} [parameters.color='#ffffff'] 文字颜色
+     * @param {number} [parameters.opacity=1] 不透明度
+     * @param {number} [parameters.strokeWidth=0] 描边宽度
+     * @param {string} [parameters.strokeColor='#000000'] 描边颜色
+     */
+    constructor(parameters?: {
+        fontSize?: number | undefined;
+        fontFamily?: string | undefined;
+        color?: string | undefined;
+        opacity?: number | undefined;
+        strokeWidth?: number | undefined;
+        strokeColor?: string | undefined;
+    });
+    /** @protected */ protected parameters: {
+        fontSize: number;
+        fontFamily: string;
+        color: string;
+        opacity: number;
+        strokeWidth: number;
+        strokeColor: string;
+        fontWeight: string;
+        keepUpright: boolean;
+        textMaxAngle: number;
+        clippingBuffer: number;
+        debug: boolean;
+    };
+    /** @protected */ protected fontAtlasManager: any;
+    /** @protected */ protected atlasTexture: any;
+    frustumCulled: boolean;
+    matrixAutoUpdate: boolean;
+    renderOrder: number;
+    FlipState: {
+        unknown: number;
+        flipRequired: number;
+        flipNotRequired: number;
+    };
+    _flipStates: Map<any, any>;
+    _textsAlongLinesData: any[];
+    _tempMatrix4: any;
+    _tempVector2: any;
+    _tempVector4: any;
+    _tempVector4_2: any;
+    _measureCanvas: HTMLCanvasElement;
+    _measureCtx: CanvasRenderingContext2D | null;
+    _emptyFrameCount: number;
+    _emptyFrameThreshold: number;
+    _placeTextCache: Map<any, any>;
+    _shapeCache: LRUCache;
+    _debugPolyline: Polyline | null;
+    _debugNormalPoints: SimplePoint | null;
+    _debugAnchorPoints: SimplePoint | null;
+    geometry: ScreenTextGeometry | undefined;
+    material: ScreenTextMaterial | undefined;
+    /**
+     * 初始化调试对象
+     * @private
+     */
+    private _initDebugObjects;
+    /**
+     * 碰撞检测（返回屏幕坐标的字符包围盒）
+     * @param {Object} data 数据项（来自 dataSource.userData）
+     * @returns {Object|null} 包围盒信息 {chars, isProjected, tolerance}
+     */
+    collisionTest(data: Object): Object | null;
+    /**
+     * 更新分辨率
+     * @private
+     */
+    private _updateResolution;
+    /**
+     * 初始化字体图集管理器
+     * @private
+     */
+    private _initFontAtlas;
+    /**
+     * 定义代理属性
+     * @private
+     */
+    private _defineProxyProperties;
+    /**
+     * 设置文字数据（核心API）
+     * @param {Array<Object>} chars 字符数据数组（注意：每个是单个字符！）
+     * @param {number} chars[].x 屏幕X坐标（像素）
+     * @param {number} chars[].y 屏幕Y坐标（像素）
+     * @param {string} chars[].char 单个字符
+     * @param {number} [chars[].rotation=0] 旋转角度（弧度）
+     * @param {number} [chars[].size] 字符大小（可选，默认使用fontSize）
+     * @example
+     * ```javascript
+     * screenText.setTexts([
+     *     { x: 100, y: 100, char: '建', rotation: 0, size: 26 },
+     *     { x: 126, y: 100, char: '国', rotation: 0, size: 26 },
+     *     { x: 152, y: 100, char: '门', rotation: 0, size: 26 }
+     * ]);
+     * ```
+     */
+    setTexts(chars: Array<Object>): void;
+    _lastCharCount: number | undefined;
+    /**
+     * 更新字体图集
+     * @private
+     */
+    private _updateFontAtlas;
+    /**
+     * 沿线绘制单组文字（向后兼容）
+     * @param {string} text 要显示的文字
+     * @param {Array<Array<number>>} line 世界坐标线段数组 [[x,y,z], [x,y,z], ...]
+     * @param {Array<number>} anchor 锚点世界坐标 [x,y,z]
+     * @example
+     * ```javascript
+     * screenText.setTextAlongLine('建国门南大街', line, [x, y, z]);
+     * ```
+     */
+    setTextAlongLine(text: string, line: Array<Array<number>>, anchor: Array<number>): void;
+    /**
+     * 沿线绘制多组文字
+     * @param {Array<Object>} textsData 多组文字数据
+     * @param {string} textsData[].text 要显示的文字
+     * @param {Array<Array<number>>} textsData[].line 世界坐标线段数组
+     * @param {Array<number>} textsData[].anchor 锚点世界坐标
+     * @example
+     * ```javascript
+     * screenText.setTextsAlongLines([
+     *     { text: '建国门南大街', line: line1, anchor: anchor1 },
+     *     { text: '西便门大街', line: line2, anchor: anchor2 }
+     * ]);
+     * ```
+     */
+    setTextsAlongLines(textsData: Array<Object>): void;
+    /**
+     * 渲染前更新
+     * @internal
+     */
+    onBeforeScenePrepareRenderHook(renderer: any, scene: any, camera: any): void;
+    /**
+     * 更新多组沿线文字（新方法）
+     * @private
+     */
+    private _updateTextsAlongLines;
+    /**
+     * 放置单组沿线文字（重构后的核心方法）
+     * @private
+     * @returns {Array} 字符数组，如果过滤则返回空数组
+     */
+    private _placeTextAlongLine;
+    _initializedGroups: Set<any> | undefined;
+    /**
+     * 解析颜色为RGBA数组（归一化到0-1）
+     * @private
+     * @param {string|Array} color - 颜色值（支持多种格式）
+     * @param {string} defaultColor - 默认颜色（十六进制）
+     * @returns {Array} RGBA数组 [r, g, b, a]（0-1范围）
+     */
+    private _parseColorToRgba;
+    /**
+     * 文字形状化（计算每个字符的位置和宽度）
+     * @private
+     */
+    private _shapeText;
+    /**
+     * 计算两点距离
+     * @private
+     */
+    private _distance;
+    /**
+     * 将世界坐标线段转换为屏幕坐标
+     * 包含近平面裁剪处理（处理 w < 0 的情况）
+     * @private
+     */
+    private _lineToScreenCoords;
+    /**
+     * 世界坐标转屏幕坐标
+     * @private
+     */
+    private _worldToScreen;
+    /**
+     * 查找锚点所在的线段
+     * @private
+     */
+    private _findSegmentForAnchor;
+    /**
+     * 计算点到线段的最短距离
+     * @private
+     */
+    private _pointToSegmentDistance;
+    /**
+     * 判断锚点是否在屏幕可见区域内
+     * @private
+     */
+    private _isAnchorVisible;
+    /**
+     * 判断点是否在相机后面（w <= 0）
+     * @private
+     */
+    private _isPointBehindCamera;
+    /**
+     * 判断是否在翻转保持范围内
+     * @private
+     */
+    private _isInFlipRetainRange;
+    /**
+     * 判断是否需要改变朝向（Mapbox 完整算法）
+     * @private
+     */
+    private _requiresOrientationChange;
+    /**
+     * 沿线放置字符
+     * @private
+     */
+    private _placeGlyphAlongLine;
+    _placeGlyphDebugDone: boolean | undefined;
+    /**
+     * 更新调试对象的数据
+     * @private
+     */
+    private _updateDebugObjects;
+    /**
+     * 显示 Atlas 纹理调试面板
+     * @param {Object} options 配置选项
+     * @param {number} [options.size=300] 显示尺寸（像素）
+     * @param {string} [options.position='top-right'] 位置：'top-left', 'top-right', 'bottom-left', 'bottom-right'
+     * @param {boolean} [options.autoUpdate=true] 是否自动更新
+     * @example
+     * ```javascript
+     * screenText.showAtlasDebug({ size: 400, position: 'bottom-right' });
+     * ```
+     */
+    showAtlasDebug(options?: {
+        size?: number | undefined;
+        position?: string | undefined;
+        autoUpdate?: boolean | undefined;
+    }): this;
+    _debugPanel: HTMLDivElement | null | undefined;
+    _debugUpdateInterval: number | null | undefined;
+    /**
+     * 隐藏 Atlas 纹理调试面板
+     */
+    hideAtlasDebug(): this;
+    /**
+     * 获取 Atlas 纹理（用于自定义调试）
+     * @returns {DataTexture} Atlas texture
+     */
+    getAtlasTexture(): DataTexture;
+    /**
+     * 获取字体图集管理器
+     * @returns {FontAtlasManager} Font atlas manager
+     */
+    getFontAtlasManager(): FontAtlasManager;
+    /**
+     * 获取字符集合（从实际的atlas mapping中提取）
+     * @returns {Set} 字符集合
+     */
+    getCharacterSet(): Set<any>;
+}
+import { GeoMesh } from '../GeoMesh';
+import { LRUCache } from '../../../util/LRUCache';
+import { Polyline } from '../line/Polyline';
+import { SimplePoint } from '../point/SimplePoint';
+import { ScreenTextGeometry } from '../../geometries/text/ScreenTextGeometry';
+import { ScreenTextMaterial } from '../../materials/text/ScreenTextMaterial';
+import { FontAtlasManager } from './font-atlas-manager';

package/dist/types/threejs/objects/text/font-atlas-manager.d.ts

@@ -2,20 +2,28 @@ export class FontAtlasManager {
     props: {};
     _entry: {};
     _textureData: Uint8Array<ArrayBuffer>;
+    _currentWidth: number;
+    _currentHeight: number;
     _xOffset: number;
     _yOffset: number;
     _mapping: {};
     _canvasHeight: number;
-    _oldMapping: {};
     /** @private */ private _atlas;
     _ctx: any;
+    _version: number;
     get atlas(): any;
     get mapping(): any;
     setProps(props?: {}): void;
     setPropsAsync(scheduler: any, props?: {}, batchSize?: number): Promise<any>;
     _prepareFontAtlas(): void;
     _generateFontAtlas(characterSet: any): void;
-    _processCharBatch(batch: any): true | undefined;
+    _processCharBatch(batch: any): void;
     _finalizeTextureData(): void;
+    /**
+     * 渲染 textureData
+     * @private
+     */
+    private _debugRenderTexture;
     _createTextureData(characterSet: any): any;
+    _reset(): void;
 }

package/dist/types/threejs/objects/text/utils.d.ts

@@ -34,7 +34,7 @@ export function buildMapping({ characterSet, getFontWidth, fontHeight, buffer, m
     canvasHeight: number;
 };
 export function autoWrapping(text: any, wordBreak: any, maxWidth: any, iconMapping: any, startIndex: number | undefined, endIndex: any): any[];
-export function transformParagraph(text: any, paragraph: any, lineHeight: any, wordBreak: any, maxWidth: any, iconMapping: any, gapSpace?: number): {
+export function transformParagraph(text: any, paragraph: any, lineHeight: any, wordBreak: any, maxWidth: any, iconMapping: any, gapSpace?: number, padding?: number[]): {
     x: any[];
     y: any[];
     rowWidth: any[];

package/dist/types/threemap/3dtiles/HDMap3DTiles.d.ts

@@ -15,6 +15,10 @@ export class HDMap3DTiles extends Default3DTiles {
     private _visibility;
     /** @private */
     private _grid;
+    /** @private */
+    private _tunnelTransparent;
+    /** @private */
+    private _tunnelOpacity;
     _setDefaultInstanceConfig(): void;
     _setDefaultInstanceConfigV2(): void;
     _setDefaultStyle(): void;
@@ -22,5 +26,27 @@ export class HDMap3DTiles extends Default3DTiles {
     get turn(): any;
     get visibility(): any;
     get grid(): any;
+    /**
+     * 设置材质分组的效果
+     * @param {string} groupName 材质分组名称 (如: 'tunnel', 'road', 'building', 'green', 'wall', 'water')
+     * @param {Object} properties 材质属性
+     * @returns {this}
+     * @example
+     * ```javascript
+     * // 设置隧道透明
+     * hdmap.setMaterialGroupEffect('tunnel', {
+     *     opacity: 0.5,
+     * });
+     * ```
+     */
+    setGroupMaterial(groupName: string, properties: Object): this;
+    /**
+     * 重置材质分组效果
+     */
+    resetGroupMaterial(groupName: any): this;
+    /**
+     * 获取所有可用的材质分组名称
+     */
+    getMaterialGroups(): any;
 }
 import { Default3DTiles } from './Default3DTiles';

package/dist/types/threemap/3dtiles/materials/Default3DTilesMaterialManager.d.ts

@@ -7,6 +7,11 @@ export class Default3DTilesMaterialManager {
      * @private
      */
     private _materrialMap;
+    /**
+     * 材质分组映射 key: 组名, value: Set<materialKey>
+     * @private
+     */
+    private _materialGroups;
     /**
      * 初始化标识
      * @private
@@ -23,15 +28,58 @@ export class Default3DTilesMaterialManager {
     getMaterialByKey(key: any): any;
     /**
      * 根据key添加材质
-     * @param key 材质key
-     * @param material 材质对象
+     * @param {string} key 材质key
+     * @param {Material} material 材质对象
+     * @param {string|string[]} [group] 材质分组名称，可以是单个分组或多个分组数组
      */
-    addMaterialByKey(key: any, material: any): void;
+    addMaterialByKey(key: string, material: Material, group?: string | string[]): void;
     /**
      * 删除替换材质
      * @param key 材质key
      */
     removeMaterialByKey(key: any): void;
+    /**
+     * 获取材质分组中的所有材质key
+     * @param {string} groupName 分组名称
+     * @returns {string[]} 材质key数组
+     */
+    getMaterialKeysByGroup(groupName: string): string[];
+    /**
+     * 获取材质分组中的所有材质对象
+     * @param {string} groupName 分组名称
+     * @returns {Material[]} 材质对象数组
+     */
+    getMaterialsByGroup(groupName: string): Material[];
+    /**
+     * 获取所有的分组名称
+     * @returns {string[]} 分组名称数组
+     */
+    getGroupNames(): string[];
+    /**
+     * 对材质分组应用效果
+     * @param {string} groupName 分组名称
+     * @param {Object} properties 要设置的材质属性
+     * @param {boolean} [properties.transparent] 是否透明
+     * @param {number} [properties.opacity] 透明度 0-1
+     * @param {boolean} [properties.visible] 是否可见
+     * @param {Color} [properties.color] 颜色
+     * @param {boolean} [properties.depthWrite] 深度写入
+     * @param {number} [properties.side] 渲染面
+     */
+    applyGroupMaterial(groupName: string, properties: {
+        transparent?: boolean | undefined;
+        opacity?: number | undefined;
+        visible?: boolean | undefined;
+        color?: any;
+        depthWrite?: boolean | undefined;
+        side?: number | undefined;
+    }): this;
+    /**
+     * 重置分组效果到默认状态
+     * @param {string} groupName 分组名称
+     * @returns {this}
+     */
+    resetGroupMaterial(groupName: string): this;
     dispose(): void;
     _getPresetTexture: (key: any, type: any, repeat: any, extraParameters: any, callback: any) => any;
     createPbrMaterial: (textureName: any, textureChannels: any, repeat: any, initParameters?: {}, extraParameters?: {}) => any;

package/dist/types/threemap/Engine.d.ts

@@ -1,11 +1,13 @@
 /**
  * 引擎核心入口，用来初始化渲染引擎。
  * 内部核心系统包括：
- * - {@link EngineMap} 地图系统
+ * - {@link EngineMap} 地图视野系统
  * - {@link EngineRendering} 渲染系统
  * - {@link EngineEvent} 事件系统
  * - {@link EngineWidgets} UI控件系统
  * - {@link EngineSelection} 选择器系统
+ * - {@link EngineController} 键鼠交互控制器系统
+ * - {@link EngineClock} 时钟系统
  *
  * @category Core
  * @example
@@ -31,13 +33,16 @@ export class Engine {
         selection: object;
         widgets: object;
     });
-    /** @internal */ _container: HTMLElement;
+    /** @internal */ _container: HTMLElement | null;
     /** @internal */ _event: EngineEvent;
     /** @internal */ _map: EngineMap;
     /** @internal */ _rendering: EngineRendering;
     /** @internal */ _selection: EngineSelection;
     /** @internal */ _widgets: EngineWidgets;
+    /** @internal */ _clock: EngineClock;
+    /** @internal */ _controller: EngineController;
     isEngine: boolean;
+    _id: number;
     /**
      * 将object放到渲染场景中
      * @param {Object3D} object threejs或者mapvthree的object对象
@@ -133,9 +138,9 @@ export class Engine {
     private unlockCamera;
     /**
      * 渲染电影
-     * @param {Movie} movie 电影对象
+     * @param {VideoConfig} videoConfig 影片配置对象
      */
-    renderVideo(videoConfig: any): Promise<void>;
+    renderVideo(videoConfig: VideoConfig): Promise<void>;
     /**
      * 容器对象
      * @type {HTMLElement}
@@ -176,6 +181,18 @@ export class Engine {
      * 物体选择器
      */
     get selection(): EngineSelection;
+    /**
+     * 时钟对象，用于模拟时间
+     */
+    get clock(): EngineClock;
+    /**
+     * 键鼠交互控制器对象
+     */
+    get controller(): EngineController;
+    /**
+     * 引擎实例唯一ID
+     */
+    get id(): number;
     /**
      * 释放全部资源，之后引擎实例不再可用
     */
@@ -191,3 +208,5 @@ import { EngineMap } from './engine/Map';
 import { EngineRendering } from './engine/Rendering';
 import { EngineSelection } from './engine/Selection';
 import { EngineWidgets } from './engine/Widgets';
+import { EngineClock } from './engine/Clock';
+import { EngineController } from './engine/Controller';