cesium-to-three 0.1.0

package/dist/types/lib/ground/polygon/polygon-wall-construction.d.ts

@@ -0,0 +1,77 @@
+import { Vector3 } from 'three';
+/**
+ * Polygon wall(单个 ring 的挤出墙)构造结果。
+ *
+ * 布局(匹配 Cesium computeWallGeometry):
+ *   positions = [
+ *     <top  vertex 0..perSide-1>,   // 高度 = maximumHeight,扁平 (x, y, z, x, y, z, ...)
+ *     <bottom vertex 0..perSide-1>, // 高度 = minimumHeight
+ *   ]
+ *   每个 vertex 占 3 个 Float64;perSide = 每条 edge 的 (subdivideLineCount + 1) 之和。
+ *
+ *   extrudeDirection 同样长度:
+ *     top 半 = (0, 0, 0)
+ *     bot 半 = -geodeticSurfaceNormal(top 半对应位置)
+ *
+ *   indices 引用本 wall 局部顶点 ID(0 到 perSide × 2 - 1);
+ *   合并到 prism 时由 caller 加偏移。
+ */
+export interface PolygonWallResult {
+    /** Float64 ECEF,长度 = 6 × perSideVertexCount */
+    positions: Float64Array;
+    /** Float32 extrudeDirection,长度同 positions */
+    extrudeDirection: Float32Array;
+    /** Uint16/32 索引,长度 = 6 × (perSideVertexCount - ringLength) */
+    indices: Uint16Array | Uint32Array;
+}
+/**
+ * 构造单个 polygon ring 的挤出墙。
+ *
+ * 算法 5 步,顺序与 Cesium computeWallGeometry + scaleToGeodeticHeightExtruded +
+ * computeAttributes(shadowVolume + wall 分支)一致:
+ *
+ *   步骤 1 · 计算 perSideVertexCount
+ *     遍历 length 条 edge(p1=ring[i], p2=ring[(i+1) % length]),
+ *     累加 subdivideLineCount(p1, p2, minDistance) + 1(每条 edge 产 N+1 顶点),
+ *     得到每一面(top 或 bot)的总顶点数。
+ *
+ *   步骤 2 · 写 chord 顶点到双面 buffer
+ *     对每条 edge:
+ *       a. subdivideLine(p1, p2) → 一维 [p1.x, p1.y, p1.z, mid1.x, ..., mid_{N-1}.z]
+ *          (注意:输出不含 p2 端点)
+ *       b. 把 subdivideLine 结果同时写入 top 半与 bottom 半
+ *       c. 显式写 p2.{x, y, z} 到 top 与 bot(edge 的终点;同时也是下一条 edge 的起点
+ *          —— 但下一条 edge 的 subdivideLine 输出 p2(next.p1)再次,所以 wall 上
+ *          相邻 edge 之间确实有"重复顶点对",由索引步骤的 corner-skipping 跳过)
+ *
+ *   步骤 3 · 生成索引(使用 chord 位置,top == bottom,所以位置相等判定可识别 corner)
+ *     for i in [0, perSideVertexCount):
+ *       UL = i,UR = i + 1
+ *       LL = UL + perSideVertexCount,LR = UR + perSideVertexCount
+ *       p_UL = positions[UL × 3..],p_UR = positions[UR × 3..]
+ *       if equalsEpsilon(p_UL, p_UR, EPSILON10): continue  // corner / wrap-around 自动跳过
+ *       否则写 2 个三角形:(UL, LL, UR) + (UR, LL, LR)
+ *
+ *   步骤 4 · scaleToGeodeticHeightExtruded:把 chord 位置投到指定高度
+ *     for i in [0, perSideFloatLength) step 3:
+ *       chord = positions[i..i+3]            (原始 chord 位置,top 半,bot 半相同)
+ *       surface = scaleToGeodeticSurface(chord)
+ *       normal  = geodeticSurfaceNormal(chord)
+ *       positions[i.. (top)] = surface + maxHeight * normal
+ *       positions[i + perSideFloatLength.. (bot)] = surface + minHeight * normal
+ *     注:Cesium 用 chord 位置(非 surface)算 normal;细微差异但与 Cesium 一致。
+ *
+ *   步骤 5 · extrudeDirection
+ *     top 半 = (0, 0, 0)(Float32Array 默认 0)
+ *     bot 半 = -geodeticSurfaceNormal(top 半对应位置)
+ *     Cesium 在 computeAttributes 的 shadowVolume + wall 分支里重新读取 top 半
+ *     位置(at maxHeight,已被 step 4 修改)算 normal,与本步骤一致。
+ *
+ * @param ringPositions 单个 ring 的椭球面 ECEF 顶点(已经过 winding 校正)。
+ * @param granularity   角分辨率,弧度(控制 minDistance 阈值)。
+ * @param minimumHeight 底面高度,米(典型 -55000)。
+ * @param maximumHeight 顶面高度,米(典型 +55000)。
+ * @returns             PolygonWallResult。
+ */
+export declare function constructPolygonWall(ringPositions: readonly Vector3[], granularity: number, minimumHeight: number, maximumHeight: number): PolygonWallResult;
+//# sourceMappingURL=polygon-wall-construction.d.ts.map

package/dist/types/lib/ground/polygon/polygon-wall-construction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polygon-wall-construction.d.ts","sourceRoot":"","sources":["../../../../../src/lib/ground/polygon/polygon-wall-construction.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAWhC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,iBAAiB;IACjC,+CAA+C;IAC/C,SAAS,EAAE,YAAY,CAAC;IAExB,6CAA6C;IAC7C,gBAAgB,EAAE,YAAY,CAAC;IAE/B,8DAA8D;IAC9D,OAAO,EAAE,WAAW,GAAG,WAAW,CAAC;CACnC;AAUD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,wBAAgB,oBAAoB,CACnC,aAAa,EAAE,SAAS,OAAO,EAAE,EACjC,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,GACnB,iBAAiB,CAkMnB"}

package/dist/types/lib/ground/polygon/triangulation.d.ts

@@ -0,0 +1,40 @@
+import type { Vector2 } from 'three';
+/**
+ * 对 2D 多边形(outer ring + 可选 holes)做三角剖分,返回索引数组。
+ *
+ * 顶点排列约定(必须与 caller polygon-rings.ts 输出一致):
+ *   positions2D = [
+ *     outer ring 顶点 0,
+ *     outer ring 顶点 1,
+ *     ...,
+ *     outer ring 顶点 (outerN - 1),
+ *     hole_0 顶点 0,
+ *     hole_0 顶点 1,
+ *     ...,
+ *     hole_M 顶点 (lastHoleN - 1),
+ *   ]
+ *   holeStartIndices = [ outer 之后的第一个 hole 起点, ... ]   (顶点索引,非浮点偏移)
+ *
+ * winding 约定:
+ *   - outer ring 必须 CCW(有向面积 > 0)
+ *   - 每个 hole 必须 CW(有向面积 < 0)
+ *
+ * 上述 winding 由 polygon-rings.ts 的 `processRing` 用 shoelace 公式校正,
+ * 本函数**不再做** winding 检查或反转 — 分层职责。
+ *
+ * earcut 库版本:本项目 `package.json:earcut@^3.0.2` 与 Cesium 通过 npm 解析后的
+ * earcut 是同一个安装(都 import "earcut" 字符串,Node 解析到同一 node_modules)。
+ * 因此 V5 字节级一致路径理论可达。
+ *
+ * 退化兜底:
+ *   - 若 positions2D 长度 < 3(< 1 个三角形),或 earcut 返回 < 3 个索引(共线 / 自相交
+ *     等极端情况),返回 `[0, 1, 2]` 占位三角形,避免下游 computeSubdivision 崩溃。
+ *     Cesium 在 createGeometryFromPositions(L974-977)做同样兜底,本函数把这一层
+ *     合并进来。
+ *
+ * @param positions2D      切平面 2D 顶点(由 ellipsoid-tangent-plane.projectPointsOntoPlane 产出)。
+ * @param holeStartIndices 每个洞的起始顶点索引(可选;无洞时省略或 undefined)。
+ * @returns                顶点索引数组,长度 = 3 × 三角形数(典型 N 顶点凸 polygon → 3·(N-2) 个索引)。
+ */
+export declare function triangulate(positions2D: readonly Vector2[], holeStartIndices?: readonly number[]): number[];
+//# sourceMappingURL=triangulation.d.ts.map

package/dist/types/lib/ground/polygon/triangulation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triangulation.d.ts","sourceRoot":"","sources":["../../../../../src/lib/ground/polygon/triangulation.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,WAAW,CAC1B,WAAW,EAAE,SAAS,OAAO,EAAE,EAC/B,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,GAClC,MAAM,EAAE,CAiCV"}

package/dist/types/lib/ground/primitives.d.ts

@@ -0,0 +1,262 @@
+import { Group, Mesh } from 'three';
+import { CesiumClassificationPrimitive } from './classification';
+import type { CartesianLike, CesiumGroundArrowMode, CesiumGroundArrowStyle, CesiumGroundCirclePrimitiveOptions, CesiumGroundFrameState, CesiumGroundPointPrimitiveOptions, CesiumGroundPointShape, CesiumGroundPolygonOptions, CesiumGroundPolylineOptions, CesiumGroundRectanglePrimitiveOptions, LonLatPoint, RectangleRadians } from './types';
+/**
+ * 使用本地 rectangle shadow-volume 管线实现的贴地矩形。
+ * classification 命令组保持复用，保留此前针对抖动问题落地的全部精度修复。
+ */
+export declare class CesiumGroundRectanglePrimitive {
+    readonly classification: CesiumClassificationPrimitive;
+    readonly debugSurface: Mesh | null;
+    readonly rectangle: RectangleRadians;
+    constructor(options: CesiumGroundRectanglePrimitiveOptions);
+    /**
+     * 更新逐帧 uniform。
+     *
+     * @param frameState 当前 Three 侧帧状态。
+     */
+    update(frameState: CesiumGroundFrameState): void;
+    /**
+     * 更新矩形命令块的渲染顺序。
+     *
+     * @param renderOrder 分配给 front-stencil 命令的基础顺序。
+     */
+    setRenderOrder(renderOrder: number): void;
+    /**
+     * 释放资源。
+     */
+    dispose(): void;
+}
+/**
+ * 使用本地 polygon shadow-volume 管线实现的贴地多边形。
+ * 描边通过 classification 图元的 polygon-border uniform 支持，是附加能力，
+ * 不影响精度关键路径。
+ *
+ * 支持两种调用形态:
+ *   1. 新的 ref 风格 API:`points`、可选 `holes` / `hole` / `rotationDegrees`，
+ *      以及独立的 `fillColor` / `strokeColor` 等字段。
+ *   2. 旧版 `polygonHierarchyDegrees` 形态，搭配 `color` / `alpha`。
+ *      构造器会检测实际输入并路由到对应路径。
+ */
+export declare class CesiumGroundPolygonPrimitive {
+    readonly classification: CesiumClassificationPrimitive;
+    readonly polygonHierarchy: {
+        positions: CartesianLike[];
+        holes: unknown[];
+    };
+    readonly rotationDegrees: number;
+    readonly hole: boolean;
+    constructor(options: CesiumGroundPolygonOptions);
+    /**
+     * 更新逐帧 uniform。
+     *
+     * @param frameState 当前 Three 侧帧状态。
+     */
+    update(frameState: CesiumGroundFrameState): void;
+    /**
+     * 更新多边形命令块的渲染顺序。
+     *
+     * @param renderOrder 分配给 front-stencil 命令的基础顺序。
+     */
+    setRenderOrder(renderOrder: number): void;
+    /**
+     * 释放资源。
+     */
+    dispose(): void;
+}
+/**
+ * 使用本地 circle shadow-volume 管线实现的贴地圆。
+ *
+ * plot-spec 选项与参考项目保持同形：`center` + `radius` + stroke/fill/visible，
+ * 以及可选装饰字段 `ringCount`、`ringGapMeters`、`sectorStartDegrees`、
+ * `sectorAngleDegrees`、`stRotationRadians`、`granularityRadians`，
+ * shadow-volume 窗口高度 `height` / `extrudedHeight`，以及
+ * `renderOrder` / `fragmentCull` 控制项。片元着色器的 circle 分支通过
+ * `classification.setCircleBorderStyle(...)` 激活；LOG_DEPTH 与 Float64 路径不受影响。
+ */
+export declare class CesiumGroundCirclePrimitive {
+    readonly classification: CesiumClassificationPrimitive;
+    readonly center: LonLatPoint;
+    readonly radius: number;
+    constructor(options: CesiumGroundCirclePrimitiveOptions);
+    /**
+     * 更新逐帧 uniform。
+     *
+     * @param frameState 当前 Three 侧帧状态。
+     */
+    update(frameState: CesiumGroundFrameState): void;
+    /**
+     * 更新圆形命令块的渲染顺序。
+     *
+     * @param renderOrder 分配给 front-stencil 命令的基础顺序。
+     */
+    setRenderOrder(renderOrder: number): void;
+    /**
+     * 释放资源。
+     */
+    dispose(): void;
+}
+/**
+ * 贴地点标绘。点本质上是一种"特殊"图元——把 lon/lat 锚点 + 米尺寸映射到既有
+ * 的圆形或矩形 shadow-volume 管线，而不是新增一套渲染路径：
+ *   - shape='circle' → 委托给 CesiumGroundCirclePrimitive，center=position，
+ *     radius=size/2。沿用圆形的扇区 / 环线 / 描边 shader 分支。
+ *   - shape='square' → 委托给 CesiumGroundRectanglePrimitive，4 角点由 ENU 米
+ *     偏移反算（±size/2 east/north），沿用矩形的轴对齐 fill + 描边路径。
+ *
+ * 这样描边 / 填充 / 命令 visibility / fragment culling / classification depth
+ * 等所有精度修复都自动继承，不会引入任何新的着色器分支或几何路径。
+ */
+export declare class CesiumGroundPointPrimitive {
+    readonly classification: CesiumClassificationPrimitive;
+    readonly position: LonLatPoint;
+    readonly shape: CesiumGroundPointShape;
+    readonly size: number;
+    private readonly delegate;
+    constructor(options: CesiumGroundPointPrimitiveOptions);
+    /**
+     * 更新底层图元的逐帧 uniform。
+     */
+    update(frameState: CesiumGroundFrameState): void;
+    /**
+     * 更新点图元命令块的渲染顺序。
+     */
+    setRenderOrder(renderOrder: number): void;
+    /**
+     * 释放资源。
+     */
+    dispose(): void;
+}
+/**
+ * 贴地折线（polyline）—— 与 polygon/rectangle/circle 等贴地面图元正交的
+ * 「深度纹理重建分类法」单 pass 管线：每段 8 顶点 box + FS 内重建地形点 +
+ * 三平面距离裁切 + 上色。无 stencil。详见 doc 00 §1。
+ *
+ * 公开方法：
+ *   primitive.group              // Three.Group，scene.add(primitive.group)
+ *   primitive.update(frameState) // 每帧
+ *   primitive.setColor(...)
+ *   primitive.setWidth(...)      // screen→px / world→m
+ *   primitive.setRenderOrder(n)
+ *   primitive.setVisible(b)
+ *   primitive.dispose()
+ */
+export declare class CesiumGroundPolylinePrimitive {
+    private readonly _group;
+    private readonly uniforms;
+    private readonly mesh;
+    private readonly material;
+    private geometry;
+    private readonly options;
+    private readonly cameraHigh;
+    private readonly cameraLow;
+    private arrowMesh?;
+    private arrowMaterial?;
+    private arrowGeometry?;
+    private arrowColorExplicit;
+    private disposed;
+    constructor(options: CesiumGroundPolylineOptions);
+    /**
+     * 构造或重建箭头 mesh。在 `options.arrowMode` 不是 NONE 时调用。
+     * 调用前需确保旧的 arrowMesh / Geometry / Material 已 dispose。
+     *
+     * @param userData 线几何 userData，含端点标架。
+     */
+    private buildArrowMesh;
+    /**
+     * 拆掉当前 arrowMesh + geometry + material。`setArrowMode` 切端 → 重建 /
+     * dispose() 总清理 都用这条路径。
+     */
+    private disposeArrowMesh;
+    /** 把图元挂到场景：`scene.add(primitive.group)`。 */
+    get group(): Group;
+    /** 每帧调用：刷新相机相关 uniform + 全局地形深度纹理。 */
+    update(frameState: CesiumGroundFrameState): void;
+    /**
+     * 改线色。
+     *
+     * @param strokeColor  '#rrggbb' 或 css 颜色。
+     * @param strokeOpacity 0..100 百分比（与其它图元一致）。
+     */
+    setColor(strokeColor: string, strokeOpacity?: number): void;
+    /**
+     * 改线宽。screen 模式传像素，world 模式传米。**只改当前模式对应的那一个
+     * uniform**——切换模式请用 `applyWidthState`，否则 `this.options.widthMode`
+     * 跟实际意图不一致时会写错 uniform。
+     *
+     * @param width 像素或米。
+     */
+    setWidth(width: number): void;
+    /**
+     * 一次性原子地刷新「线宽相关三件」——`u_lineWidthMode` + `u_lineWidthPixels`
+     * + `u_lineWidthMeters`，并同步 `this.options.widthMode/Pixels/Meters`。
+     *
+     * 为什么需要这条 API：单 `setWidth(value)` 用 `this.options.widthMode` 决定
+     * 写哪个 uniform。如果调用方在 GUI 上切了 `widthMode` 但没触发 rebuild，
+     * `this.options.widthMode` 还是旧值，`setWidth` 会写错 uniform，而且
+     * `u_lineWidthMode` 也没人更新 → 线的宽度模式跟显示对不上、且来回切
+     * 不回原状态。这条方法让宿主把 widthMode + 两个宽度值一次刷到位。
+     *
+     * @param mode         'screen' or 'world'。
+     * @param widthPixels  像素宽（即使当前是 world 模式也写入，便于切回）。
+     * @param widthMeters  米宽（即使当前是 screen 模式也写入，便于切回）。
+     */
+    applyWidthState(mode: 'screen' | 'world', widthPixels: number, widthMeters: number): void;
+    /** 改渲染顺序（直接设 mesh.renderOrder，无 stencil 三件套偏移）。 */
+    setRenderOrder(order: number): void;
+    /** 改可见性。 */
+    setVisible(visible: boolean): void;
+    /**
+     * 切换箭头放置模式。NONE → 拆掉 arrowMesh；其它 → 重建 arrowMesh（端点数
+     * 变化需要新的几何）。颜色 / 大小变化不必走这条路径，分别用
+     * `setArrowColor` / `setArrowSize`。
+     *
+     * @param mode 'none' / 'left' / 'right' / 'both'。
+     */
+    setArrowMode(mode: CesiumGroundArrowMode): void;
+    /**
+     * 切换箭头样式（实心三角 / 开口雪佛龙）。要换 material 的 define，所以
+     * 必须重建材质——但几何不变。
+     *
+     * @param style 'solid' / 'open'。
+     */
+    setArrowStyle(style: CesiumGroundArrowStyle): void;
+    /**
+     * 把 `u_lineArrowClip{Start,End}Enabled` 同步成「对应端是否有箭头」的逻辑值。
+     * `setArrowMode` 改变端数时必须调一遍——否则线 FS 的 V 形收口会停留在
+     * 上一个状态（拔掉箭头还在收口、加上箭头不收口）。
+     * 与 style 无关（SOLID / OPEN 共享同一套 V 形几何边界）。
+     */
+    private syncLineArrowClipUniforms;
+    /**
+     * 独立给箭头改色（设过之后 `setColor` 改线色不再波及箭头）。
+     *
+     * @param color   '#rrggbb' / css 颜色。
+     * @param opacity 0..100 百分比。缺省沿用线 strokeOpacity。
+     */
+    setArrowColor(color: string, opacity?: number): void;
+    /**
+     * 改箭头尺寸模式（'screen' = 屏幕像素恒定，'world' = 世界米恒定）。
+     * 与线 widthMode 独立，对应 Cesium `Billboard.sizeInMeters` 语义。
+     *
+     * @param mode 'screen' or 'world'。
+     */
+    setArrowWidthMode(mode: 'screen' | 'world'): void;
+    /**
+     * 改箭头屏幕像素尺寸（沿线长 + 基底全宽）。world 模式用 `setArrowSizeMeters`。
+     *
+     * @param lengthPixels 沿线长（屏幕像素）。
+     * @param widthPixels  基底全宽（屏幕像素）。
+     */
+    setArrowSize(lengthPixels: number, widthPixels: number): void;
+    /**
+     * 改箭头世界米尺寸（仅在 u_arrowWidthMode=1 时生效）。
+     *
+     * @param lengthMeters 沿线长（米）。
+     * @param widthMeters  基底全宽（米）。
+     */
+    setArrowSizeMeters(lengthMeters: number, widthMeters: number): void;
+    /** 释放 geometry / material（共享深度纹理由 CesiumGlobeDepth 管理，不动）。 */
+    dispose(): void;
+}
+//# sourceMappingURL=primitives.d.ts.map

package/dist/types/lib/ground/primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../../../src/lib/ground/primitives.ts"],"names":[],"mappings":"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"}

package/dist/types/lib/ground/rectangle/rectangle-attributes.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 计算每个顶点的椭球表面单位法向。
+ *
+ * 遍历 positions(Float64,长度必须是 3 的倍数),对每点调用
+ * `geodeticSurfaceNormal`,把单位法向写入新分配的 Float32Array。
+ *
+ * 法向 Float32 精度充裕(单位向量 |n|=1,Float32 有 ~7 位十进制精度)。
+ *
+ * @param positions ECEF 顶点数组(Float64,长度 = 3 × vertexCount)。
+ * @returns         单位法向数组(Float32,长度同 positions)。
+ * @throws          某个顶点位于椭球中心(geodeticSurfaceNormal 返回 undefined)。
+ */
+export declare function computeCapNormals(positions: Float64Array): Float32Array;
+/**
+ * 根据顶点数选择索引 TypedArray:
+ *   - vertexCount ≤ 65535 → Uint16Array(WebGL 1 默认支持)
+ *   - vertexCount > 65535 → Uint32Array(需 WebGL 2 或 ANGLE_instanced_arrays 等)
+ *
+ * Three BufferGeometry 在 setIndex 时自动检测 TypedArray 类型并选择对应
+ * GL 调用,两种返回值都能消费。
+ *
+ * Cesium 对应:IndexDatatype.js#createTypedArray
+ *
+ * @param vertexCount 顶点总数(决定索引值上限)。
+ * @param indexCount  索引数组长度(顶点 ID 个数)。
+ * @returns           Uint16Array 或 Uint32Array,长度 = indexCount。
+ */
+export declare function createIndexTypedArray(vertexCount: number, indexCount: number): Uint16Array | Uint32Array;
+//# sourceMappingURL=rectangle-attributes.d.ts.map

package/dist/types/lib/ground/rectangle/rectangle-attributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rectangle-attributes.d.ts","sourceRoot":"","sources":["../../../../../src/lib/ground/rectangle/rectangle-attributes.ts"],"names":[],"mappings":"AAqBA;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAE,SAAS,EAAE,YAAY,GAAI,YAAY,CAmBzE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACpC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GAChB,WAAW,GAAG,WAAW,CAK3B"}

package/dist/types/lib/ground/rectangle/rectangle-construct-cap.d.ts

@@ -0,0 +1,53 @@
+import { Vector3 } from 'three';
+import type { RectangleRadians } from './rectangle-radians';
+/**
+ * `constructRectangleCap` 的完整输出。
+ *
+ * 字段意义见 `RectangleCapResult` 注释。所有数组都是新分配的,caller
+ * 拥有全部所有权(下游 extruded 路径会原地修改 positions / normals)。
+ */
+export interface RectangleCapResult {
+    /**
+     * 顶点位置,ECEF 米,Float64。
+     * 长度 = 3 × vertexCount;vertexCount = width · rowHeight + capExtras。
+     */
+    positions: Float64Array;
+    /**
+     * 每顶点单位法向,Float32(单位向量精度充裕)。
+     * 长度 = positions.length。
+     */
+    normals: Float32Array;
+    /**
+     * 顶面三角形索引(从地表上方俯视为 CCW)。
+     * vertexCount ≤ 65535 → Uint16Array;否则 Uint32Array。
+     */
+    indices: Uint16Array | Uint32Array;
+    /** 网格列数(经度方向顶点数) */
+    width: number;
+    /** 网格行数(纬度方向顶点数,包含 cap 用) */
+    height: number;
+    /** 是否覆盖北极(north === π/2) */
+    northCap: boolean;
+    /** 是否覆盖南极(south === -π/2) */
+    southCap: boolean;
+}
+/**
+ * 构造矩形顶面 cap 网格。
+ *
+ * 算法 6 步:
+ *   1. computeRectangleGridOptions → width / height / nwCorner / capFlags
+ *   2. 计算 size = width · height + cap 修正,确定 rowStart / rowEnd / rowHeight
+ *   3. 主循环采样 ECEF 顶点(行主序)
+ *   4. (可选) cap 单点采样(north/south 极点单点表示)
+ *   5. 计算每顶点法向
+ *   6. 构造索引(主网格双三角化 + cap 扇形)
+ *
+ * Cesium 对应:RectangleGeometry.js:220-429
+ *
+ * @param rect         矩形(弧度)。
+ * @param granularity  网格精度(弧度)。
+ * @param radiiSquared 椭球半轴平方,用于 grid 采样的 gamma 投影法。
+ * @returns            完整 cap 结果。
+ */
+export declare function constructRectangleCap(rect: RectangleRadians, granularity: number, radiiSquared: Vector3): RectangleCapResult;
+//# sourceMappingURL=rectangle-construct-cap.d.ts.map

package/dist/types/lib/ground/rectangle/rectangle-construct-cap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rectangle-construct-cap.d.ts","sourceRoot":"","sources":["../../../../../src/lib/ground/rectangle/rectangle-construct-cap.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAUhC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IAClC;;;OAGG;IACH,SAAS,EAAE,YAAY,CAAC;IAExB;;;OAGG;IACH,OAAO,EAAE,YAAY,CAAC;IAEtB;;;OAGG;IACH,OAAO,EAAE,WAAW,GAAG,WAAW,CAAC;IAEnC,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IAEd,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IAEf,4BAA4B;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAElB,6BAA6B;IAC7B,QAAQ,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CACpC,IAAI,EAAE,gBAAgB,EACtB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,OAAO,GACnB,kBAAkB,CAqKpB"}

package/dist/types/lib/ground/rectangle/rectangle-construct-extruded.d.ts

@@ -0,0 +1,35 @@
+import { Vector3 } from 'three';
+import type { RectangleRadians } from './rectangle-radians';
+/**
+ * `constructExtrudedRectangleShadowVolume` 的完整输出。
+ *
+ * 三个数组互相一致:
+ *   - positions / extrudeDirection 同长度,顶点对应。
+ *   - indices 已合并 top + bottom + wall,墙索引已加上 topBottomVertexCount 偏移。
+ *   - indices 末尾可能被 subarray 截断(因为墙角点重复检测会跳过 4 个 quad)。
+ */
+export interface RectangleShadowVolumeResult {
+    /** 全部顶点 ECEF 位置(top + bottom + walls),Float64,长度 = 3 × totalVertexCount */
+    positions: Float64Array;
+    /** 每顶点 extrudeDirection(top 半 = 0,bottom 半 = -normal),Float32,长度同 positions */
+    extrudeDirection: Float32Array;
+    /** 合并索引(top + bottom + wall),墙索引已偏移 topBottomVertexCount */
+    indices: Uint16Array | Uint32Array;
+}
+/**
+ * 构造矩形挤出 shadow volume prism。
+ *
+ * 完整 8 步算法(见文件头职责说明)。所有循环边界、winding 反向、
+ * EPSILON10 容差判定都与 Cesium 字节级一致。
+ *
+ * Cesium 对应:RectangleGeometry.js:457-908
+ *
+ * @param rect          矩形(弧度)。
+ * @param granularity   网格精度(弧度)。
+ * @param minimumHeight shadow volume 底面高度(米;可负)。
+ * @param maximumHeight shadow volume 顶面高度(米;> minimumHeight)。
+ * @param radiiSquared  椭球半轴平方(供 cap grid 采样用)。
+ * @returns             ECEF positions / extrudeDirection / 合并索引。
+ */
+export declare function constructExtrudedRectangleShadowVolume(rect: RectangleRadians, granularity: number, minimumHeight: number, maximumHeight: number, radiiSquared: Vector3): RectangleShadowVolumeResult;
+//# sourceMappingURL=rectangle-construct-extruded.d.ts.map

package/dist/types/lib/ground/rectangle/rectangle-construct-extruded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rectangle-construct-extruded.d.ts","sourceRoot":"","sources":["../../../../../src/lib/ground/rectangle/rectangle-construct-extruded.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAWhC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D;;;;;;;GAOG;AACH,MAAM,WAAW,2BAA2B;IAC3C,2EAA2E;IAC3E,SAAS,EAAE,YAAY,CAAC;IAExB,+EAA+E;IAC/E,gBAAgB,EAAE,YAAY,CAAC;IAE/B,4DAA4D;IAC5D,OAAO,EAAE,WAAW,GAAG,WAAW,CAAC;CACnC;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sCAAsC,CACrD,IAAI,EAAE,gBAAgB,EACtB,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,OAAO,GACnB,2BAA2B,CAuT7B"}

package/dist/types/lib/ground/rectangle/rectangle-debug.d.ts

@@ -0,0 +1,22 @@
+import { BufferGeometry } from 'three';
+import type { RectangleRadians } from './rectangle-radians';
+/**
+ * 构造贴在椭球面上的矩形 debug 网格(线框可视化)。
+ *
+ * Classification 渲染路径使用 RTE 编码的 shadow volume 几何,Three 自带
+ * Mesh 材质无法直接渲染。此 helper 产出一个普通 POSITION-only 网格,
+ * 在同一个 ECEF 世界坐标系下贴在椭球面上,便于:
+ *   - 验证矩形地理位置是否正确
+ *   - 与 classification 输出对比 debug
+ *
+ * 网格分辨率默认 96×64(列 × 行),足够覆盖珠峰尺度矩形的曲面。
+ *
+ * @param rectangle         矩形(弧度,west < east, south < north)。
+ * @param height            网格点高度,米(在椭球面以上)。
+ * @param longitudeSegments 经度方向段数(顶点数 = segments + 1)。
+ * @param latitudeSegments  纬度方向段数。
+ * @returns                 Three BufferGeometry,含 `position` attribute(Float32, 3)
+ *                          + index(Uint32);computeBoundingSphere 已计算。
+ */
+export declare function createDebugRectangleSurfaceGeometry(rectangle: RectangleRadians, height: number, longitudeSegments?: number, latitudeSegments?: number): BufferGeometry;
+//# sourceMappingURL=rectangle-debug.d.ts.map

package/dist/types/lib/ground/rectangle/rectangle-debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rectangle-debug.d.ts","sourceRoot":"","sources":["../../../../../src/lib/ground/rectangle/rectangle-debug.ts"],"names":[],"mappings":"AAaA,OAAO,EAAmB,cAAc,EAAW,MAAM,OAAO,CAAC;AAIjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mCAAmC,CAClD,SAAS,EAAE,gBAAgB,EAC3B,MAAM,EAAE,MAAM,EACd,iBAAiB,SAAK,EACtB,gBAAgB,SAAK,GACnB,cAAc,CAsDhB"}

package/dist/types/lib/ground/rectangle/rectangle-extents.d.ts

@@ -0,0 +1,33 @@
+import type { PlanarExtents } from '../types';
+import { type RectangleRadians } from './rectangle-radians';
+/**
+ * 计算矩形 ShadowVolume PlanarExtents uniform。
+ *
+ * 完整 7 步算法:
+ *   1. fill 矩形中心 cartographic(height = 0)→ ECEF
+ *   2. 在 center 处构造 ENU → ECEF 矩阵
+ *   3. invert 得到 ECEF → ENU 矩阵
+ *   4. render 矩形 8 角点采样到 ENU 平面,取包围盒
+ *   5. fill 矩形同样采样
+ *   6. SW 角点 ENU → ECEF;再计算 eastward / northward(从 SW 出发的单位 ENU 向量
+ *      在 ECEF 中的对应)
+ *   7. innerMetersRect = clamp(fillBounds 相对 renderBounds 的 SW 偏移),
+ *      并 RTE 编码 SW
+ *
+ * 输出对应 GLSL uniform:
+ *   - u_southWest_HIGH/LOW:SW ECEF 的 RTE 高 / 低分量
+ *   - u_eastward:SW 朝东 1 米的 ECEF 位移(模约 1)
+ *   - u_northward:SW 朝北 1 米的 ECEF 位移(模约 1)
+ *   - u_uvMinAndExtents:矩形固定 (0, 0, 1, 1)
+ *   - u_uMaxVmax:矩形固定 (0, 1, 1, 0)
+ *   - u_innerMetersRect:fill 区在 render 区中的米偏移(xMin, yMin, xMax, yMax)
+ *
+ * 当前位置:迁移自 geometry.ts:649-719 的 computePlanarExtents 矩形分支。
+ * 逻辑零改动,只是把 Cesium 数学依赖切换到 math/*。
+ *
+ * @param renderRect    渲染矩形(已外扩 border 的几何用矩形)。
+ * @param fillRect      实心矩形(border fragment 用)。
+ * @returns             PlanarExtents 完整 uniform 集。
+ */
+export declare function computeRectanglePlanarExtents(renderRect: RectangleRadians, fillRect: RectangleRadians): PlanarExtents;
+//# sourceMappingURL=rectangle-extents.d.ts.map

package/dist/types/lib/ground/rectangle/rectangle-extents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rectangle-extents.d.ts","sourceRoot":"","sources":["../../../../../src/lib/ground/rectangle/rectangle-extents.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAgB,aAAa,EAAE,MAAM,UAAU,CAAC;AAC5D,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAuF7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,6BAA6B,CAC5C,UAAU,EAAE,gBAAgB,EAC5B,QAAQ,EAAE,gBAAgB,GACxB,aAAa,CAmFf"}