@soonspacejs/plugin-tiles 2.15.8 → 2.15.10

package/dist/plot/plugins/types.d.ts

@@ -1,115 +1,166 @@
-/** 经纬度顶点：[经度°, 纬度°]（与 RTT / shader 中 lon/lat 一致） */
+/** 经纬度顶点：[经度°, 纬度°]，单位度。 */
 export type LonLatPoint = [number, number];
-/** 标绘类别 */
+/** 标绘类别枚举，与 8 个 GisPlot* 子类一一对应；也是桥接器 switch(category) 的分支依据。 */
 export type GisPlotCategory = 'point' | 'line' | 'polygon' | 'rectangle' | 'sector' | 'arrow' | 'text' | 'circle';
 /**
- * 标绘公共基类型。
- * stroke* / fill* 不透明度为 **0–100** 整数百分比（与 GroundDecalManager / shader 一致）。
+ * 标绘公共基类型。所有 GisPlot*Options 都继承自它。
+ *
+ * 关键口径：
+ *   - strokeOpacity / fillOpacity 为 0..100 整数百分比（非 0..1）。
+ *   - strokeColor / fillColor 为 CSS 颜色字符串。
+ *   - points 元素顺序固定为 [lon, lat]。
  */
 export type GisPlotBaseOptions = {
-    /** 图形的顶点坐标 [[lon, lat], ...] */
+    /** 图形顶点列表 [[lon, lat], ...] */
     points: LonLatPoint[];
+    /** 描边色（CSS 字符串） */
     strokeColor: string;
+    /** 描边宽（米） */
     strokeWidth: number;
+    /** 描边不透明度：0..100 整数百分比 */
     strokeOpacity: number;
+    /** 填充色（CSS 字符串） */
     fillColor: string;
+    /** 填充不透明度：0..100 整数百分比 */
     fillOpacity: number;
+    /** 可见性 */
     visible: boolean;
 };
-/** {@link GisPlotBase.getSnapshot} / {@link GisPlotBase.getSnapshotDeep} 返回值 */
+/**
+ * 通用浅快照结构：{ type, options }。type 即 category。
+ * {@link GisPlotBase.getSnapshot} / {@link GisPlotBase.getSnapshotDeep} 的返回结构。
+ */
 export type GisPlotSnapshot<T extends GisPlotBaseOptions = GisPlotBaseOptions> = {
     type: GisPlotCategory;
     options: T;
 };
-/** 点标绘：样式（圆/方）、大小（米） */
+/**
+ * 箭头专用快照：在 { type, options } 之外额外带 generatedCoords（闭合多边形顶点）。
+ * 管理器 getItem 的返回联合类型 GisPlotItemSnapshot = GisPlotSnapshot | GisPlotArrowSnapshot 由此而来。
+ */
+export type GisPlotArrowSnapshot = GisPlotSnapshot<PlotArrowOptions> & {
+    generatedCoords: LonLatPoint[];
+};
+/** 点标绘形状：'circle' = 圆点，'square' = 方点。 */
+export type PlotPointStyle = 'circle' | 'square';
+/**
+ * 点标绘选项。points[0] 为点中心；size 在 cesium-to-three 侧：
+ * circle 解释为直径、square 解释为边长。
+ */
 export type PlotPointOptions = GisPlotBaseOptions & {
-    pointStyle: 'circle' | 'square';
+    /** 点形状：'circle' / 'square' */
+    pointStyle: PlotPointStyle;
+    /** 尺寸（米）：circle 为直径、square 为边长 */
     size: number;
 };
-/** 线标绘：折线顶点 + 可选端点箭头（SDF） */
-export type PlotLineStrokeStyle = 'solid' | 'dashed' | 'dotted';
-export type PlotEndpointStyle = 'round' | 'square';
 /**
- * 折线端点箭头（仅四种；原 `filled` 已更名为 `filledArrow`）
- * - `filledArrow` — 三角箭头
- * - `filledDiamond` — 菱形
- * - `filledCircle` — 实心圆
- * - `bar` — 竖条 / 小段
+ * 折线描边样式：实线 / 虚线。cesium-to-three 贴地折线着色器只支持 solid / dash 两态。
+ */
+export type PlotLineStrokeStyle = 'solid' | 'dashed';
+/**
+ * 折线端点箭头样式：实心箭头 / 空心（不填充）箭头。
+ * cesium-to-three 折线只有 solid / open 两态：
+ *   - 'filledArrow'   → arrowStyle='solid'
+ *   - 'unfilledArrow' → arrowStyle='open'
+ */
+export type PlotArrowStyle = 'filledArrow' | 'unfilledArrow';
+/**
+ * 折线标绘选项。showArrow / startArrowStyle / endArrowStyle 是端点装饰相关
+ * 的可选字段；strokeStyle 控制实线 / 虚线。
  */
-export type PlotArrowStyle = 'filledArrow' | 'filledDiamond' | 'filledCircle' | 'bar';
 export type PlotLineOptions = GisPlotBaseOptions & {
     strokeStyle?: PlotLineStrokeStyle;
-    endpointStyle?: PlotEndpointStyle;
     showArrow?: boolean;
+    /** 起点箭头样式；null / 缺省表示无 */
     startArrowStyle?: PlotArrowStyle | null;
+    /** 终点箭头样式；null / 缺省表示无 */
     endArrowStyle?: PlotArrowStyle | null;
 };
-export type PlotStrokeStyle = 'solid' | 'dashed';
-export type PlotFillStyle = 'solid' | 'diagonal' | 'grid';
-/** 多边形标绘 */
-export type PlotPolygonOptions = GisPlotBaseOptions & {
-    strokeStyle?: PlotStrokeStyle;
-    fillStyle?: PlotFillStyle;
-};
-/** 矩形：4 个角点 [[lon,lat], ...] 按顺时针或逆时针顺序 */
-export type PlotRectangleOptions = GisPlotBaseOptions & {
-    strokeStyle?: PlotStrokeStyle;
-};
-/** 扇形：中心 + 半径与角度（度） */
+/** 多边形标绘选项：≥3 顶点 */
+export type PlotPolygonOptions = GisPlotBaseOptions;
+/** 矩形标绘选项：points 为 4 个角点（顺 / 逆时针） */
+export type PlotRectangleOptions = GisPlotBaseOptions;
+/** 扇形标绘选项：points[0] 为扇心；startAngle / sectorAngle 单位为度 */
 export type PlotSectorOptions = GisPlotBaseOptions & {
-    strokeStyle?: PlotStrokeStyle;
+    /** 半径（米） */
     radius: number;
+    /** 起始角（度） */
     startAngle: number;
+    /** 张开角（度） */
     sectorAngle: number;
 };
-/** 圆：圆心 + 半径（米） */
+/** 圆形标绘选项：points[0] 为圆心 */
 export type PlotCircleOptions = GisPlotBaseOptions & {
-    strokeStyle?: PlotStrokeStyle;
+    /** 半径（米） */
     radius: number;
 };
-/** 箭头：控制点生成多边形；`straight` 在 CPU 端退化为首尾两点的 fine 箭头 */
-export type PlotArrowType = 'straight' | 'curved' | 'fine' | 'attack';
+/**
+ * 箭头类型，与 cesium-to-three arrow SDK 的 5 个生成函数一一对应：
+ *   - 'fine'              → createFineArrow              细箭头（2 控制点：起 / 止）
+ *   - 'assaultDirection'  → createAssaultDirectionArrow  突击方向箭头（2 控制点：起 / 止）
+ *   - 'attack'            → createAttackArrow            攻击箭头（≥3 控制点：前 2 = 尾边、后 N-2 = 脊线，最后一个为 tip）
+ *   - 'swallowtailAttack' → createSwallowtailAttackArrow 燕尾攻击箭头（同 attack 控制点约定）
+ *   - 'curved'            → createCurvedArrow            曲线箭头（≥2 控制点，全部作为脊线）
+ */
+export type PlotArrowType = 'fine' | 'assaultDirection' | 'attack' | 'swallowtailAttack' | 'curved';
+/**
+ * 箭头标绘选项。points 为控制点；不同 arrowType 对 points 的解释见 PlotArrowType。
+ */
 export type PlotArrowOptions = GisPlotBaseOptions & {
-    strokeStyle?: PlotStrokeStyle;
     arrowType: PlotArrowType;
-    headSize: number;
 };
-/** 文本标绘 */
+/** 文本水平对齐（框内） */
 export type PlotTextAlign = 'left' | 'center' | 'right';
+/** 文本垂直对齐（框内） */
 export type PlotTextVerticalAlign = 'top' | 'middle' | 'bottom';
+/** 文本框相对锚点的水平对齐 */
 export type PlotTextAnchorX = 'left' | 'center' | 'right';
+/** 文本框相对锚点的垂直对齐 */
 export type PlotTextAnchorY = 'top' | 'middle' | 'bottom';
+/** 文本排版方向：横排 / 竖排（自右向左 / 自左向右） */
 export type PlotTextLayoutDirection = 'horizontal' | 'vertical-rl' | 'vertical-lr';
 /**
- * Text box plot options.
- * `points[0]` is the textbox anchor point in lon / lat degrees.
- * `textAlign` / `verticalAlign` control content alignment inside the box.
- * `anchorX` / `anchorY` control where the box sits relative to the anchor point.
+ * 文本标绘选项。points[0] 为文本框锚点；
+ * textAlign / verticalAlign 控制框内对齐；
+ * anchorX / anchorY 控制框相对锚点位置。
  */
 export type PlotTextOptions = GisPlotBaseOptions & {
+    /** 文本内容；\n 在横排是换行、竖排是换列 */
     content: string;
+    /** 字色（CSS 字符串） */
     fontColor: string;
+    /** 字号（纹素像素，> 0） */
     fontSize: number;
+    /** 缩放倍率（米/像素） */
     scale?: number;
+    /** 文字在框内水平对齐，默认 'left' */
     textAlign?: PlotTextAlign;
+    /** 文字在框内垂直对齐，默认 'middle' */
     verticalAlign?: PlotTextVerticalAlign;
+    /** 框相对锚点水平对齐，默认 'center' */
     anchorX?: PlotTextAnchorX;
+    /** 框相对锚点垂直对齐，默认 'middle' */
     anchorY?: PlotTextAnchorY;
+    /** 固定框宽（纹素像素）；不传则按内容自适应 */
     boxWidth?: number;
+    /** 固定框高（纹素像素）；不传则按内容自适应 */
     boxHeight?: number;
-    padding?: number;
+    /** 内边距：单值或 [top, right, bottom, left]（纹素像素） */
+    padding?: number | [number, number, number, number];
+    /** 排版方向，默认 'horizontal' */
     layoutDirection?: PlotTextLayoutDirection;
+    /** 地平面内旋转，度，北向顺时针为正，默认 0 */
     rotation?: number;
+    /** X 方向偏移（米） */
     offsetX?: number;
+    /** Y 方向偏移（米） */
     offsetY?: number;
+    /** 是否显示框边框 */
     showBorder?: boolean;
 };
-/** 箭头快照：在 options 外附加 `generatedCoords` */
-export type GisPlotArrowSnapshot = GisPlotSnapshot<PlotArrowOptions> & {
-    generatedCoords: LonLatPoint[];
-};
 /**
- * `GroundDecalManager.addPlot` 入参：字段 `type` 与对应 `*Options` 组合，内部据此实例化 `GisPlot*`。
+ * 工厂入参：管理器 addPlot 的唯一入参类型。判别联合（discriminated union）。
+ * 管理器据此 switch(type) 实例化对应子类。
  */
 export type PlotAddOptions = ({
     type: 'point';

package/dist/plot/plugins/utils/ArrowUtils.d.ts

@@ -1,129 +1,46 @@
-/**
- * @module ArrowUtils
- *
- * 箭头标绘图形生成工具库。
- *
- * 移植自 cesium-plot-js，将原始 Cesium `Cartesian3` 逻辑改为纯 2D **[经度, 纬度]**（度）计算。
- * 各 `create*` 函数接收控制点，返回闭合多边形顶点序列，供 `GroundDecalManager.addArrowPlot()` 等以
- * **面多边形**（如 type 2 / polygon SDF）渲染。
- *
- * **约定**
- *
- * - 坐标：`[longitude, latitude]`，单位 **度**。
- * - 距离：在经纬度平面内按欧氏距离计算（**非**椭球大地线长或真实米制距离）。
- */
-/** 经纬度对：索引 0 为经度（°），索引 1 为纬度（°）。 */
+/** 经纬度顶点：[lon°, lat°] */
 export type LonLat = [number, number];
-/**
- * 两点在经纬度平面上的欧氏距离。
- *
- * @param p1 - 起点
- * @param p2 - 终点
- */
+/** 每段三次 Bézier 采样段数（getCurvePoints 用） */
+export declare const FITTING_COUNT = 100;
+/** 角平分线法向量长度阈值，小于视为共线 */
+export declare const ZERO_TOLERANCE = 0.0001;
+/** 经纬度平面欧氏距离（把度当作平面坐标） */
 export declare function MathDistance(p1: LonLat, p2: LonLat): number;
-/**
- * 折线顶点依次相连的总长度。
- *
- * @param points - 至少两个点；单点或空数组时循环不执行，返回 `0`。
- */
+/** 折线总长（顺序累加段长度） */
 export declare function wholeDistance(points: LonLat[]): number;
-/**
- * 作为箭头宽度尺度的基准长度：总折线长的 `0.99` 次幂。
- *
- * 幂次小于 1 使较长箭头的宽度增长略慢于线性，避免过长箭头翼展过大。
- *
- * @param points - 定义箭杆路径的控制点
- */
+/** 总长的 0.99 次幂（作为箭头宽度尺度） */
 export declare function getBaseLength(points: LonLat[]): number;
-/**
- * 两点的中点。
- */
+/** 两点中点 */
 export declare function Mid(p1: LonLat, p2: LonLat): LonLat;
 /**
- * 从 `startPnt` 指向 `endPnt` 的方位角（类似地平经度），弧度，范围 **[0, 2π)**。
- *
- * @param startPnt - 起点
- * @param endPnt - 终点（与起点重合时除零由调用方避免）
+ * 求由 startPnt 指向 endPnt 的方位角（与 +x 轴夹角，逆时针为正，单位弧度，
+ * 范围 [0, 2π) ）。
  */
 export declare function getAzimuth(startPnt: LonLat, endPnt: LonLat): number;
-/**
- * 在点 `b` 处，由 `b→a` 与 `b→c` 两方向方位角之差，归一化到 **[0, 2π)**。
- */
+/** 三点夹角（pntB 为顶点），返回 [0, π] 内的弧度 */
 export declare function getAngleOfThreePoints(a: LonLat, b: LonLat, c: LonLat): number;
-/**
- * 判断折线段 `p1 → p2 → p3` 在 `p2` 处是否为顺时针转向（2D 叉积符号）。
- */
+/** 判断 p1 → p2 → p3 是否顺时针 */
 export declare function isClockWise(p1: LonLat, p2: LonLat, p3: LonLat): boolean;
 /**
- * 从 `endPnt` 出发，沿 `startPnt → endPnt` 方向旋转 `angle`（弧度），再前进 `distance`（度制平面距离），得到第三点。
- *
- * `clockWise` 为 `true` 时向一侧偏转，为 `false` 时向另一侧偏转，用于箭头两翼、颈部等对称结构。
- */
-export declare function getThirdPoint(startPnt: LonLat, endPnt: LonLat, angle: number, distance: number, clockWise: boolean): LonLat;
-/**
- * 在顶点 `p2` 处，`p1→p2` 与 `p3→p2` 两方向单位向量之和，用作角平分线法向（未单位化）。
+ * 以 endPnt 为基，根据相对 startPnt 的方位角 ± angle、距离 distance 求第三点。
+ * 箭翼 / 颈的构造核心。
  */
+export declare function getThirdPoint(startPnt: LonLat, endPnt: LonLat, angle: number, distance: number, clockwise: boolean): LonLat;
+/** 取 (p2 - p1) 与 (p3 - p2) 的角平分线方向向量（未归一化） */
 export declare function getNormal(p1: LonLat, p2: LonLat, p3: LonLat): LonLat;
-/**
- * 在 `p2` 处沿角平分线方向生成左右两条 Bézier 控制点；`t` 控制偏移与邻边长的比例。
- *
- * @param t - 弯曲强度系数，典型值与 `getCurvePoints` 中一致（如 `0.3`）
- * @returns `[ rightControl, leftControl ]`（命名与原始 cesium-plot 一致）
- */
+/** 角平分线法向量对（曲线控制）。返回 [rightControl, leftControl] */
 export declare function getBisectorNormals(t: number, p1: LonLat, p2: LonLat, p3: LonLat): [LonLat, LonLat];
-/**
- * 由折线控制点生成 **三次 Bézier 链** 上的密化点列。
- *
- * 1. 内部顶点：角平分线法向 → 左右控制点（{@link getBisectorNormals}）。
- * 2. 首尾：镜像控制点（{@link getLeftMostControlPoint} / {@link getRightMostControlPoint}）。
- * 3. 相邻控制点间用标准三次 Bézier 公式采样 {@link FITTING_COUNT} 段。
- *
- * @param t - 控制点偏移强度（如 `0.3`）
- * @param controlPoints - 至少 **3** 个点
- */
+/** 用三次 Bézier 沿 controlPoints 拟合曲线并采样 FITTING_COUNT 段 */
 export declare function getCurvePoints(t: number, controlPoints: LonLat[]): LonLat[];
-/**
- * 均匀二次 B 样条对折线点列做平滑，步长 `0.05`。
- *
- * 用于攻击箭头左右侧边，使折线变为平滑曲线；适合「贴近控制点但不强制插值」的造型。
- *
- * @param points - 至少 2 个点；≤2 时原样返回
- */
+/** 二次 B 样条平滑（attack 箭身侧边用） */
 export declare function getQBSplinePoints(points: LonLat[]): LonLat[];
-/**
- * **直线箭头（线型）**：`p1 → p2` 的箭杆 + 末端约 **30°**（`π/6`）张角的翼。
- *
- * 返回 **5 个顶点** 的折线（非闭合）：`p1, p2, leftWing, p2, rightWing`，用于 `createCurvedArrow` 两点退化等场景。
- *
- * @param headSize - 头部尺度；`>0` 时翼长取 `min(距离/5, headSize*0.01)` 等组合逻辑
- */
-export declare function createStraightArrow(p1: LonLat, p2: LonLat, headSize: number): LonLat[];
-/**
- * **细箭头（填充多边形）**：两点定义箭杆方向，生成带尾翼、颈部、头部的 **8 顶点** 逆时针闭合多边形。
- *
- * 宽度相对 `getBaseLength([p1,p2])` 的比例：尾 **10%**、颈 **20%**、翼 **25%**；翼角约 **π/8.5**，颈角约 **π/13**。
- *
- * @param p1 - 尾部中心
- * @param p2 - 箭头尖端
- */
+/** 细箭头：闭合多边形（CCW、去重、≤120 顶点） */
 export declare function createFineArrow(p1: LonLat, p2: LonLat): LonLat[];
-/**
- * **曲线箭头（填充多边形）**：3 个及以上控制点定义箭杆曲率，末端为三角箭头。
- *
- * 流程概要：`getCurvePoints` → 降采样 → 沿曲线法向左右偏移形成带宽度体部 → 末端 `getThirdPoint` 生成翼与颈 →
- * 闭合顺序：左轮廓 → 头 → 右轮廓逆序。
- *
- * **2 点** 时退化为 {@link createFineArrow}。
- *
- * @param lnglatPoints - 控制点序列，至少 2 个
- */
-export declare function createCurvedArrow(lnglatPoints: LonLat[]): LonLat[];
-/**
- * **攻击箭头（填充多边形）**：首两点定义尾部宽度，后续点为脊线控制点（至少 3 点）。
- *
- * - 尾宽：`distance(points[0], points[1])`；顺逆时针决定 `tailLeft` / `tailRight`。
- * - 脊线：尾边中点接 `points[2..]`；体宽沿脊线由尾宽渐变到颈宽；侧边经 B 样条平滑并降采样。
- *
- * @param lnglatPoints - 至少 3 个点
- */
+/** 突击方向箭头 */
+export declare function createAssaultDirectionArrow(p1: LonLat, p2: LonLat): LonLat[];
+/** 攻击箭头：首 2 点定义尾宽、其余点定义脊线（最后一个为 tip） */
 export declare function createAttackArrow(lnglatPoints: LonLat[]): LonLat[];
+/** 燕尾攻击箭头：控制点约定与攻击箭头一致；尾部多一个燕尾凹口 */
+export declare function createSwallowtailAttackArrow(lnglatPoints: LonLat[]): LonLat[];
+/** 曲线箭头：2 点时退化为细箭头；≥3 点按曲线平滑构造 */
+export declare function createCurvedArrow(lnglatPoints: LonLat[]): LonLat[];

package/dist/plot/plugins/utils/colorUtils.d.ts

@@ -1,18 +1,9 @@
-/**
- * @module colorUtils
- *
- * 颜色与不透明度工具函数。
- *
- * 为 {@link GroundDecalManager} 及标绘渲染管线提供颜色字符串解析与不透明度兼容层。
- * SDF shader 中颜色以归一化 RGBA `[0,1]` 传入，alpha 通道通常已合并 `fillOpacity` / `strokeOpacity`。
- */
-/** 归一化 RGBA 四元组，各分量 ∈ [0, 1]。 */
+/** 归一化 RGBA：各分量 ∈ [0, 1] */
 export type NormalizedRGBA = readonly [number, number, number, number];
 /**
- * 可携带填充/描边不透明度或统一透明度的样式片段。
- *
- * - **store 格式（推荐）**：`fillOpacity` / `strokeOpacity` 为 **0–100** 的整数百分比。
- * - **旧版**：`opacity` 为 **0–1** 浮点数，同时作用于 fill 与 stroke。
+ * resolveOpacity 的输入对象。
+ *   - fillOpacity / strokeOpacity：0..100 整数百分比（推荐）
+ *   - opacity：0..1 浮点（旧版，同时作用于 fill 与 stroke）
  */
 export interface StyleOpacityInput {
     fillOpacity?: number;
@@ -20,32 +11,26 @@ export interface StyleOpacityInput {
     opacity?: number;
 }
 /**
- * 将颜色字符串解析为归一化 RGBA 数组 `[r, g, b, a]`，各分量 ∈ [0, 1]。
- *
- * **支持的输入格式**
- *
- * | 形式 | 说明 |
- * |------|------|
- * | `'#hex'` | 3 位或 6 位十六进制（如 `'#f00'`, `'#ff0000'`） |
- * | `'rgb(r,g,b)'` | RGB 分量 0–255 |
- * | `'rgba(r,g,b,a)'` | `a` ∈ [0, 1] |
- * | `'transparent'` | 全透明 `[0,0,0,0]` |
- * | `null` / `undefined` / 空字符串 | 全透明 `[0,0,0,0]` |
- *
- * 无法识别的字符串回退为 **不透明白** `[1,1,1,1]`。
- *
- * @param color - CSS 风格颜色字符串；空或透明则返回全透明。
- * @returns 长度为 4 的归一化 RGBA 数组（新数组，可安全修改副本若需）。
+ * 把 CSS 颜色字符串解析为归一化 RGBA `[r, g, b, a]`（各 ∈ [0, 1]）。
+ *
+ * 支持格式：
+ *   - `#hex`（3 / 6 / 8 位）
+ *   - `rgb(r, g, b)`（分量 0–255）
+ *   - `rgba(r, g, b, a)`（a ∈ [0, 1]）
+ *   - `'transparent'` / `null` / `undefined` / 空串 → `[0, 0, 0, 0]`
+ *   - 无法识别 → 回退不透明白 `[1, 1, 1, 1]`
  */
 export declare function parseColorToRGBA(color: string | null | undefined): number[];
 /**
- * 解析不透明度参数，兼容两种样式约定，并写入长度为 2 的输出数组。
+ * 把不透明度写进长度为 2 的输出数组：
+ *   - base[0] = 填充不透明度（0..1）
+ *   - base[1] = 描边不透明度（0..1）
  *
- * 1. **store 格式**：`fillOpacity` / `strokeOpacity` 为 0–100 整数 → 除以 100 得到 0–1。
- * 2. **旧版**：仅提供 `opacity`（0–1）时，填充与描边共用该值。
- * 3. 若某通道未指定，默认 **1**（完全不透明）。
+ * 兼容规则（逐通道独立判定）：
+ *   1. 有 fillOpacity（0..100）  → base[0] = fillOpacity / 100
+ *   2. 否则有 opacity（0..1）    → base[0] = opacity
+ *   3. 否则                       → base[0] = 1
  *
- * @param style - 图形样式对象（仅需不透明度相关字段）。
- * @param base - 长度为 2 的数组；执行后 `base[0]` = 填充不透明度，`base[1]` = 描边不透明度，均为 0–1。
+ *   strokeOpacity 同理写 base[1]。
  */
 export declare function resolveOpacity(style: StyleOpacityInput, base: [number, number]): void;

package/dist/terrain-tiles-renderer/TerrainTilesRenderer.d.ts

@@ -1,5 +1,5 @@
 import { Tile, TilesRenderer } from 'um-3d-tiles-renderer';
-import { TilesFadePlugin, UpdateOnChangePlugin, ImageOverlayPlugin, ReorientationPlugin, PlotSdfPlugin } from 'um-3d-tiles-renderer/plugins';
+import { TilesFadePlugin, UpdateOnChangePlugin, ImageOverlayPlugin, ReorientationPlugin } from 'um-3d-tiles-renderer/plugins';
 import { default as SoonSpace } from 'soonspacejs';
 import { TileCustomMaterialPlugin } from './plugins';
 import { OverlayManager } from './OverlayManager';
@@ -23,8 +23,16 @@ export declare class TerrainTilesRenderer {
     customMaterialPlugin?: TileCustomMaterialPlugin;
     imageOverlayPlugin?: ImageOverlayPlugin;
     reorientationPlugin?: ReorientationPlugin;
-    /** 标绘 SDF 插件（管理标绘实例） */
-    plotSDFPlugin?: PlotSdfPlugin;
+    /** 标绘贴地深度通道（cesium-to-three classification 图元每帧所需的地形 packed depth） */
+    private _globeDepth?;
+    /**
+     * 虚拟 ECEF 相机：把真实相机（在 reorientation 原点系）经 R⁻¹ 变回绝对 WGS84 ECEF，
+     * 供 cesium-to-three 标绘图元的 RTE 着色器使用。标绘几何烘焙在绝对 ECEF，只有用
+     * ECEF 相机投影才能与「重定向后地形」对齐，同时保持 reorientation 开启（地形不抖）。
+     */
+    private readonly _plotVirtualCamera;
+    private readonly _reorientInverse;
+    private readonly _virtualScale;
     /** 资源管理器（存储配置） */
     resourceManager: ResourceManager;
     /** 地形管理器（记录地形列表） */
@@ -204,6 +212,26 @@ export declare class TerrainTilesRenderer {
     setOverlayOpacity(id: string, opacity: number): boolean;
     render: () => void;
     beforeRenderHandler: () => void;
+    /**
+     * 把真实相机变换回绝对 WGS84 ECEF，得到供标绘 RTE 着色器使用的虚拟相机。
+     *
+     * 原理：地形经 reorientation 用 R = tiles.group.matrixWorld（ECEF → 重定向世界）
+     * 渲染;标绘几何烘焙在绝对 ECEF。令 vCam.matrixWorld = R⁻¹ · realCamera.matrixWorld，
+     * 则 V_virtual = V_real · R，标绘 clip = P·V_virtual·p_ecef = P·V_real·(R·p_ecef)
+     * 与地形 clip 完全一致 → 对齐;且相机与几何都在 ECEF、局部差值小 → RTE 不抖。
+     * 当 R 为单位阵（reorientation 关闭）时，vCam 退化为真实相机，行为不变。
+     *
+     * 注意：cesium-to-three 只读 camera 的 position / quaternion / fov / aspect /
+     * near / far / projectionMatrixInverse，故只需保证这些字段正确。
+     *
+     * @param camera 真实透视相机（soonspacejs 视口相机）。
+     * @returns      复用的虚拟相机实例（每帧原地更新）。
+     */
+    private _buildPlotVirtualCamera;
+    /**
+     * 惰性创建（或复用）贴地深度通道，尺寸对齐当前渲染器绘制缓冲。
+     */
+    private _ensureGlobeDepth;
     enable(): void;
     disable(): void;
     invalidate(lon: number, lat: number, alt: number): () => void;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@soonspacejs/plugin-tiles",
   "pluginName": "TilesPlugin",
-  "version": "2.15.8",
+  "version": "2.15.10",
   "description": "3D Tiles plugin for SoonSpace.js",
   "main": "dist/index.esm.js",
   "module": "dist/index.esm.js",
@@ -21,6 +21,7 @@
     "um-3d-tiles-renderer": "^0.4.48",
     "three": "^0.183.0",
     "@mapbox/geojson-merge": "^1.1.1",
-    "soonspacejs": "2.15.8"
+    "cesium-to-three": "^0.1.5",
+    "soonspacejs": "2.15.10"
   }
 }

package/dist/plot/plugins/utils/coordUtils.d.ts

@@ -1,48 +0,0 @@
-import { Vector3 } from 'three';
-/** 角度（度）→ 弧度，与 `THREE.MathUtils.DEG2RAD` 一致。 */
-export declare const DEG2RAD: number;
-/**
- * 标签 atlas 画布边长（像素）。
- *
- * 文字标签预渲染到 `LABEL_ATLAS × LABEL_ATLAS` 的 2D canvas，再上传为 `CanvasTexture` 供 shader 采样。
- */
-export declare const LABEL_ATLAS = 2048;
-/**
- * 椭球体接口：至少实现由大地坐标（弧度）到 ECEF 的转换。
- *
- * 与 Three.js / 瓦片渲染器中椭球实现兼容：`getCartographicToPosition( latRad, lonRad, height, target )`。
- */
-export interface EllipsoidLike {
-    /**
-     * @param latitude - 纬度（弧度）
-     * @param longitude - 经度（弧度）
-     * @param height - 椭球面以上高度（米），地表一般为 0
-     * @param result - 输出 ECEF 坐标（米）
-     */
-    getCartographicToPosition(latitude: number, longitude: number, height: number, result: Vector3): Vector3;
-}
-/** ENU 平面上的东向、北向分量（米）。 */
-export interface ENUMeters {
-    /** East（东向）分量，米。 */
-    e: number;
-    /** North（北向）分量，米。 */
-    n: number;
-}
-/**
- * 将经纬度（度）转换为以给定 ENU 原点为参考的局部东-北坐标（米）。
- *
- * **步骤概要**
- *
- * 1. `(lonDeg, latDeg)` → ECEF（通过椭球 `getCartographicToPosition`）。
- * 2. ECEF 减去参考点 ECEF，得位移向量。
- * 3. 位移分别与 `east`、`north` 单位向量点积，得到 `e`、`n`（米）。
- *
- * @param lonDeg - 经度（度）
- * @param latDeg - 纬度（度）
- * @param ellipsoid - 椭球体（WGS84 等）
- * @param east - ECEF 空间中东向单位向量（与 `north`、径向构成右手系）
- * @param north - ECEF 空间中北向单位向量
- * @param centerECEF - ENU 原点在 ECEF 下的位置（米）
- * @returns 局部平面坐标 `{ e, n }`（米）
- */
-export declare function lonLatToMeters(lonDeg: number, latDeg: number, ellipsoid: EllipsoidLike, east: Vector3, north: Vector3, centerECEF: Vector3): ENUMeters;