@terra.gl/core 0.0.1-alpha.17 → 0.0.1-alpha.18

package/dist/index.d.ts

@@ -288,6 +288,11 @@ export declare interface BaseStyle {
     zIndex?: number;
     /** 碰撞检测优先级 */
     collisionPriority?: number;
+    /** 可选：深度偏移等级（整数） */
+    depthOffset?: number;
+    depthTest?: boolean;
+    depthWrite?: boolean;
+    transparent?: boolean;
 }
 
 /**
@@ -1985,8 +1990,8 @@ export declare interface LabelStyle extends BaseStyle {
     type: 'canvas-label' | 'canvas-label-fixed';
     /** 文本内容 */
     text: string;
-    /** 字体大小 */
-    fontSize?: number;
+    /** 字体大小像素Dpi，默认不传，内部会自动处理 */
+    fontSizeDpi?: number;
     /** 字体家族 */
     fontFamily?: string;
     /** 字体粗细 */
@@ -2025,9 +2030,9 @@ export declare interface LabelStyle extends BaseStyle {
     bubbleBorderColor?: string;
     /** 气泡边框宽度 */
     bubbleBorderWidth?: number;
-    /** 固定显示大小 */
+    /** 固定显示大小（与 screenSpaceSize 含义一致，推荐使用 screenSpaceSize） */
     fixedSize?: number;
-    /** 屏幕空间大小 */
+    /** 屏幕空间大小，语义为在屏幕上的目标高度（CSS 像素） */
     screenSpaceSize?: number;
 }
 
@@ -2055,6 +2060,10 @@ declare abstract class Layer extends Layer_base {
     isSceneLayer: boolean;
     /** 当前高度记录 */
     protected _altitude: number;
+    /** 图层级深度偏移（作为样式 depthOffset 的默认值） */
+    depthOffset?: number;
+    /** 区域蒙版配置集合（所有子类通用） */
+    private _regionOverlays;
     /**
      * 创建图层实例
      * @param id 图层ID
@@ -2078,6 +2087,11 @@ declare abstract class Layer extends Layer_base {
      * @returns 当前层级
      */
     getZIndex(): number;
+    /**
+     * 获取图层深度偏移
+     * @returns 当前图层的 depthOffset
+     */
+    getDepthOffset(): number;
     /**
      * 获取图层透明度
      * @returns 当前透明度
@@ -2156,6 +2170,34 @@ declare abstract class Layer extends Layer_base {
      * @returns 图层配置
      */
     getOptions(): LayerOptions;
+    /**
+     * 批量设置区域蒙版
+     * @param overlays 区域蒙版配置数组
+     */
+    setRegionOverlays(overlays: RegionOverlayConfig[]): this;
+    /**
+     * 添加单个区域蒙版
+     * @param overlay 区域蒙版配置
+     * @returns 生成的蒙版 id
+     */
+    addRegionOverlay(overlay: RegionOverlayConfig): string;
+    /**
+     * 移除指定 id 的区域蒙版
+     * @param id 区域蒙版 id
+     */
+    removeRegionOverlay(id: string): this;
+    /**
+     * 清空所有区域蒙版
+     */
+    clearRegionOverlays(): this;
+    /**
+     * 获取当前所有区域蒙版（返回副本，避免外部直接修改）
+     */
+    getRegionOverlays(): RegionOverlayConfig[];
+    /**
+     * 生成区域蒙版 id
+     */
+    private _generateRegionOverlayId;
 }
 
 declare const Layer_base: {
@@ -2210,6 +2252,8 @@ declare type LayerOptions = {
     isSceneLayer?: boolean;
     /** 图层基础高度/海拔*/
     altitude?: number;
+    /** 图层级深度偏移（作为样式 depthOffset 的默认值） */
+    depthOffset?: number;
 };
 
 export declare interface LightStyle extends BaseStyle {
@@ -3161,6 +3205,12 @@ declare class Map extends Map_base {
          * @param enabled 是否启用自动更新
          */
         setAutoUpdate(enabled: boolean): void;
+        /**
+         * 从区域蒙版配置计算世界坐标系下的多边形顶点（XZ 平面）
+         * 优先使用 Terra 面 feature 中已有的世界坐标（_vertexPoints），
+         * 如果没有传 feature，才回退到 GeoJSON + geo2world。
+         */
+        private _computeOverlayVertices;
         /**
          * 渲染城市效果
          * @private
@@ -3711,6 +3761,23 @@ declare class Map extends Map_base {
     declare interface RasterTileLayerOptions extends BaseTileLayerOptions {
     }
 
+    declare interface RegionOverlayConfig {
+        id?: string;
+        /** 区域面几何（直接传 GeoJSON） */
+        geometry?: GeoJSON.Polygon | GeoJSON.MultiPolygon;
+        /**
+         * 区域面要素（直接传 Terra 的 Polygon/Surface Feature）
+         * NOTE: 为避免循环依赖，这里不强行约束类型，用 any。
+         */
+        feature?: any;
+        color?: string;
+        opacity?: number;
+        mode?: RegionOverlayMode;
+        zIndex?: number;
+    }
+
+    declare type RegionOverlayMode = 'overlay' | 'clip';
+
     export declare function registerDEMLoader(loader: ITileGeometryLoader): ITileGeometryLoader<BufferGeometry<NormalBufferAttributes>>;
 
     export declare function registerImgLoader(loader: ITileMaterialLoader): ITileMaterialLoader<Material>;