deeptwins-engine-3d 0.1.68 → 0.1.69

package/dist/esm/sceneFusion/Airway.js

@@ -1,692 +0,0 @@
-// import {
-//   centerMean,
-//   flattenEach,
-//   getCoords,
-//   points,
-//   type AllGeoJSON,
-//   type Feature,
-//   type FeatureCollection,
-//   type LineString,
-//   type Position,
-// } from '@turf/turf';
-// import * as Cesium from 'deeptwins-cesium';
-// import {
-//   CanvasTexture,
-//   CatmullRomCurve3,
-//   DoubleSide,
-//   Mesh,
-//   MeshBasicMaterial,
-//   MeshPhongMaterial,
-//   RepeatWrapping,
-//   TorusGeometry,
-//   TubeGeometry,
-//   Vector3,
-//   type BufferGeometry,
-//   type Group,
-//   type Material,
-//   type MeshPhongMaterialParameters,
-//   type Texture,
-// } from 'three';
-// import { MapContext } from '../map/Map';
-//
-// /** 航道 GeoJSON 坐标：[经度, 纬度, 高度]，高度默认 0。 */
-// export type AirwayCoordinate = [number, number, number?];
-//
-// /** 航道中心点或路径点的经纬高描述。 */
-// export type AirwayGeoPosition = {
-//   alt?: number;
-//   lat: number;
-//   lng: number;
-// };
-//
-// type NormalizedAirwayCoordinate = [number, number, number];
-//
-// type NormalizedAirwayGeoPosition = {
-//   alt: number;
-//   lat: number;
-//   lng: number;
-// };
-//
-// /** 航道支持的 GeoJSON 数据。 */
-// export type AirwayGeoJson = AllGeoJSON;
-//
-// /** 航道 LineString Feature 类型别名。 */
-// export type AirwayLineStringFeature = Feature<LineString>;
-//
-// /** 航道 FeatureCollection 类型别名。 */
-// export type AirwayFeatureCollection = FeatureCollection<LineString>;
-//
-// /** 航道程序化流动纹理参数。 */
-// export type AirwayFlowTextureOptions = {
-//   height?: number;
-//   width?: number;
-// };
-//
-// /** SceneFusion 等离子管线效果参数。 */
-// export type AirwayPlasmaOptions = {
-//   /** 纹理和噪声沿管线轴向的密度。 */
-//   density?: number;
-//   /** 边缘 Fresnel 辉光强度曲线。 */
-//   fresnelPower?: number;
-//   /** 最终发光颜色强度。 */
-//   intensity?: number;
-//   /** 流动动画速度。 */
-//   speed?: number;
-// };
-//
-// /** 航道外部辅助光圈参数。 */
-// export type AirwayHaloOptions = {
-//   /** 是否绘制沿路径流动的光圈。 */
-//   enabled?: boolean;
-//   /** 光圈数量。 */
-//   count?: number;
-//   /** 光圈颜色。 */
-//   color?: MeshPhongMaterialParameters['color'];
-//   /** 基础透明度。 */
-//   opacity?: number;
-//   /** 透明度脉冲幅度。 */
-//   opacityAmplitude?: number;
-//   /** 透明度脉冲速度。 */
-//   opacitySpeed?: number;
-//   /** 光圈相对主航道半径的外扩距离。 */
-//   radiusOffset?: number;
-//   /** 缩放脉冲基础值。 */
-//   scaleBase?: number;
-//   /** 缩放脉冲幅度。 */
-//   scaleAmplitude?: number;
-//   /** 缩放脉冲速度。 */
-//   scaleSpeed?: number;
-//   /** 光圈沿路径前进速度。 */
-//   speed?: number;
-//   /** 光圈截面分段。 */
-//   radialSegments?: number;
-//   /** 光圈管径。 */
-//   tubeRadius?: number;
-//   /** 光圈环向分段。 */
-//   tubularSegments?: number;
-// };
-//
-// /** 航道绘制参数。 */
-// export type AirwayOptions = {
-//   /** 自定义航道锚点；默认使用路径坐标平均中心。 */
-//   center?: AirwayGeoPosition;
-//   /** 是否闭合路径。 */
-//   closed?: boolean;
-//   /** 直接传入航道坐标；优先级高于 geoJson。 */
-//   coordinates?: AirwayCoordinate[];
-//   /** CatmullRom 曲线张力。 */
-//   curveTension?: number;
-//   /** 从 GeoJSON 中读取第一条 LineString，支持 Feature / FeatureCollection / Geometry。 */
-//   geoJson?: AirwayGeoJson;
-//   /** 外部辅助光圈参数。 */
-//   halo?: AirwayHaloOptions;
-//   /** Three MeshPhongMaterial 参数。 */
-//   material?: MeshPhongMaterialParameters;
-//   /** SceneFusion 等离子管线效果参数。 */
-//   plasma?: AirwayPlasmaOptions;
-//   /** 主航道半径，单位米。 */
-//   radius?: number;
-//   /** 主航道径向分段。 */
-//   radialSegments?: number;
-//   /** 程序化流动纹理参数。 */
-//   flowTexture?: AirwayFlowTextureOptions;
-//   /** 主航道轴向分段。 */
-//   tubularSegments?: number;
-// };
-//
-// type ResolvedAirwayOptions = {
-//   center?: AirwayGeoPosition;
-//   closed: boolean;
-//   coordinates?: AirwayCoordinate[];
-//   curveTension: number;
-//   flowTexture: Required<AirwayFlowTextureOptions>;
-//   geoJson?: AirwayGeoJson;
-//   halo: Required<AirwayHaloOptions>;
-//   material: MeshPhongMaterialParameters;
-//   plasma: Required<AirwayPlasmaOptions>;
-//   radialSegments: number;
-//   radius: number;
-//   tubularSegments: number;
-// };
-//
-// /** 主航道默认几何参数。 */
-// export const AIRWAY_DEFAULT_OPTIONS = {
-//   closed: false,
-//   curveTension: 0.12,
-//   radialSegments: 36,
-//   radius: 50,
-//   tubularSegments: 320,
-// } as const;
-//
-// /** 航道默认材质参数。 */
-// export const AIRWAY_DEFAULT_MATERIAL_OPTIONS = {
-//   color: '#1d4ed8',
-//   emissive: '#38bdf8',
-//   emissiveIntensity: 1.15,
-//   opacity: 0.58,
-//   shininess: 140,
-//   side: DoubleSide,
-//   specular: '#e0f2fe',
-//   transparent: true,
-// } as const;
-//
-// /** 航道默认等离子效果参数。 */
-// export const AIRWAY_DEFAULT_PLASMA_OPTIONS = {
-//   density: 2.2,
-//   fresnelPower: 2.4,
-//   intensity: 1.62,
-//   speed: 3,
-// } as const;
-//
-// /** 航道默认辅助光圈参数。 */
-// export const AIRWAY_DEFAULT_HALO_OPTIONS = {
-//   count: 7,
-//   color: '#93c5fd',
-//   enabled: true,
-//   opacity: 0.22,
-//   opacityAmplitude: 0.1,
-//   opacitySpeed: 5,
-//   radialSegments: 18,
-//   radiusOffset: 5.5,
-//   scaleAmplitude: 0.16,
-//   scaleBase: 0.92,
-//   scaleSpeed: 6,
-//   speed: 0.065,
-//   tubeRadius: 1.2,
-//   tubularSegments: 48,
-// } as const;
-//
-// /** 航道默认程序化纹理参数。 */
-// export const AIRWAY_DEFAULT_FLOW_TEXTURE_OPTIONS = {
-//   height: 256,
-//   width: 1024,
-// } as const;
-//
-// /**
-//  * 飞行航道封装。
-//  *
-//  * 负责把 GeoJSON LineString / 坐标数组转换成 SceneFusion 可渲染的 Three Tube，
-//  * 并内置程序化等离子材质与沿线流动光圈，调用侧只需要传入地图和路径数据。
-//  */
-// class Airway {
-//   /** 地图上下文。 */
-//   public _mapContext: MapContext | undefined;
-//   public center: NormalizedAirwayGeoPosition | undefined;
-//   public coordinates: NormalizedAirwayCoordinate[] | undefined;
-//   public primitive: any;
-//
-//   private fusion: any;
-//   private ownedFlowTexture: Texture | undefined;
-//   private ownsFusionLoop = false;
-//   private readonly baseOptions: AirwayOptions;
-//   private root: Group | undefined;
-//   private stopVisualEffects: () => void = () => {};
-//
-//   constructor(map: any, options: AirwayOptions = {}) {
-//     this._mapContext = map._mapContext;
-//     this.baseOptions = options;
-//
-//     if (this.hasRenderableSource(options)) {
-//       this.draw();
-//     }
-//   }
-//
-//   /** 获取 Cesium Viewer 实例。 */
-//   public getMap(): Cesium.Viewer | undefined {
-//     return this._mapContext && this._mapContext.getMap();
-//   }
-//
-//   /**
-//    * 绘制航道。
-//    * @param options 本次绘制参数，会覆盖构造函数中的同名参数。
-//    */
-//   public draw(options: AirwayOptions = {}) {
-//     const map = this.getMap() as any;
-//
-//     if (!map) {
-//       throw new Error('地图实例不存在，无法绘制航道。');
-//     }
-//
-//     const resolvedOptions = this.resolveOptions(options);
-//     const coordinates = this.resolveCoordinates(resolvedOptions);
-//     const center = this.normalizeGeoPosition(
-//       resolvedOptions.center ?? this.getCenter(coordinates),
-//     );
-//     const flowTexture =
-//       resolvedOptions.material.map ??
-//       this.createFlowTexture(resolvedOptions.flowTexture);
-//
-//     if (!resolvedOptions.material.map) {
-//       this.ownedFlowTexture = flowTexture;
-//     }
-//
-//     this.fusion = new SceneFusion(map);
-//     this.startFusionLoop(this.fusion);
-//
-//     const primitive = this.fusion.createPrimitive({
-//       center,
-//       createRoot: ({ group, convertToThreePosition }) => {
-//         const pathPoints = coordinates.map((coordinate) => {
-//           const position = convertToThreePosition(
-//             this.toGeoPosition(coordinate),
-//           );
-//           return new Vector3(position.x, position.y, position.z);
-//         });
-//         const curve = new CatmullRomCurve3(
-//           pathPoints,
-//           resolvedOptions.closed,
-//           'catmullrom',
-//           resolvedOptions.curveTension,
-//         );
-//         const material = SceneFusion.applyPlasmaTubeEffect(
-//           new MeshPhongMaterial({
-//             ...resolvedOptions.material,
-//             map: flowTexture,
-//           }),
-//           resolvedOptions.plasma,
-//         );
-//         const channelTube = new Mesh(
-//           new TubeGeometry(
-//             curve,
-//             resolvedOptions.tubularSegments,
-//             resolvedOptions.radius,
-//             resolvedOptions.radialSegments,
-//             resolvedOptions.closed,
-//           ),
-//           material,
-//         );
-//
-//         group.add(channelTube);
-//         this.root = group;
-//
-//         if (resolvedOptions.halo.enabled) {
-//           const haloEffects = this.createHaloRingEffects(
-//             curve,
-//             resolvedOptions.radius,
-//             resolvedOptions.halo,
-//           );
-//
-//           haloEffects.haloRings.forEach((mesh) => {
-//             group.add(mesh);
-//           });
-//
-//           this.stopVisualEffects = haloEffects.start();
-//         }
-//
-//         return group;
-//       },
-//     });
-//
-//     if (!primitive) {
-//       throw new Error('航道 Primitive 创建失败。');
-//     }
-//
-//     this.center = center;
-//     this.coordinates = coordinates;
-//     this.primitive = primitive;
-//   }
-//
-//   /** 销毁航道实例。 */
-//   public destroy() {
-//     this.stopVisualEffects();
-//     this.stopVisualEffects = () => {};
-//     this.releaseFusion();
-//     this.disposeRoot();
-//     this.ownedFlowTexture?.dispose();
-//     this.ownedFlowTexture = undefined;
-//     this.fusion?.removePrimitive(this.primitive);
-//     this.center = undefined;
-//     this.coordinates = undefined;
-//     this.primitive = undefined;
-//   }
-//
-//   private resolveOptions(options: AirwayOptions): ResolvedAirwayOptions {
-//     return {
-//       ...AIRWAY_DEFAULT_OPTIONS,
-//       ...this.baseOptions,
-//       ...options,
-//       flowTexture: {
-//         ...AIRWAY_DEFAULT_FLOW_TEXTURE_OPTIONS,
-//         ...this.baseOptions.flowTexture,
-//         ...options.flowTexture,
-//       },
-//       halo: {
-//         ...AIRWAY_DEFAULT_HALO_OPTIONS,
-//         ...this.baseOptions.halo,
-//         ...options.halo,
-//       },
-//       material: {
-//         ...AIRWAY_DEFAULT_MATERIAL_OPTIONS,
-//         ...this.baseOptions.material,
-//         ...options.material,
-//       },
-//       plasma: {
-//         ...AIRWAY_DEFAULT_PLASMA_OPTIONS,
-//         ...this.baseOptions.plasma,
-//         ...options.plasma,
-//       },
-//     };
-//   }
-//
-//   private resolveCoordinates(
-//     options: Pick<AirwayOptions, 'coordinates' | 'geoJson'>,
-//   ) {
-//     if (options.coordinates) {
-//       return this.normalizeCoordinates(options.coordinates);
-//     }
-//
-//     if (options.geoJson) {
-//       return this.getCoordinatesFromGeoJson(options.geoJson);
-//     }
-//
-//     throw new Error('绘制航道需要传入 coordinates 或 geoJson。');
-//   }
-//
-//   private normalizeGeoPosition(
-//     position: AirwayGeoPosition,
-//   ): NormalizedAirwayGeoPosition {
-//     return {
-//       alt: position.alt ?? 0,
-//       lat: position.lat,
-//       lng: position.lng,
-//     };
-//   }
-//
-//   private getCoordinatesFromGeoJson(
-//     geoJson: AirwayGeoJson,
-//   ): NormalizedAirwayCoordinate[] {
-//     let lineCoordinates: Position[] | undefined;
-//
-//     flattenEach(geoJson, (feature) => {
-//       if (lineCoordinates || feature.geometry?.type !== 'LineString') {
-//         return;
-//       }
-//
-//       lineCoordinates = (feature as Feature<LineString>).geometry.coordinates;
-//     });
-//
-//     if (!lineCoordinates) {
-//       throw new Error('geoJson 需要至少一条 LineString 作为航道路径。');
-//     }
-//
-//     return this.normalizeCoordinates(lineCoordinates);
-//   }
-//
-//   private normalizeCoordinates(
-//     coordinates: ReadonlyArray<AirwayCoordinate | Position>,
-//   ): NormalizedAirwayCoordinate[] {
-//     if (!Array.isArray(coordinates) || coordinates.length < 2) {
-//       throw new Error('航道路径至少需要两个坐标点。');
-//     }
-//
-//     return coordinates.map((coordinate) => {
-//       const [longitude, latitude, altitude = 0] = coordinate;
-//
-//       if (
-//         !Number.isFinite(longitude) ||
-//         !Number.isFinite(latitude) ||
-//         !Number.isFinite(altitude)
-//       ) {
-//         throw new Error('航道坐标必须是有效的经纬高数字。');
-//       }
-//
-//       return [longitude, latitude, altitude];
-//     });
-//   }
-//
-//   private hasRenderableSource(options: AirwayOptions) {
-//     return (
-//       (Array.isArray(options.coordinates) && options.coordinates.length > 1) ||
-//       !!options.geoJson
-//     );
-//   }
-//
-//   private createHaloRingEffects(
-//     curve: CatmullRomCurve3,
-//     channelRadius: number,
-//     options: Required<AirwayHaloOptions>,
-//   ) {
-//     const haloRingGeometry = new TorusGeometry(
-//       channelRadius + options.radiusOffset,
-//       options.tubeRadius,
-//       options.radialSegments,
-//       options.tubularSegments,
-//     );
-//     const zAxis = new Vector3(0, 0, 1);
-//     const haloRings: Mesh[] = [];
-//
-//     for (let index = 0; index < options.count; index += 1) {
-//       const haloRing = new Mesh(
-//         haloRingGeometry,
-//         new MeshBasicMaterial({
-//           color: options.color,
-//           opacity: options.opacity,
-//           transparent: true,
-//         }),
-//       );
-//       haloRing.userData.offset = index / options.count;
-//       haloRings.push(haloRing);
-//     }
-//
-//     const start = () => {
-//       let animationFrameId = 0;
-//       let disposed = false;
-//
-//       const tick = (time: number) => {
-//         if (disposed) {
-//           return;
-//         }
-//
-//         const seconds = time * 0.001;
-//
-//         haloRings.forEach((mesh, index) => {
-//           const progress = (seconds * options.speed + mesh.userData.offset) % 1;
-//           const point = curve.getPointAt(progress);
-//           const tangent = curve.getTangentAt(progress).normalize();
-//           const pulse =
-//             options.scaleBase +
-//             Math.sin(seconds * options.scaleSpeed + index * 0.9) *
-//               options.scaleAmplitude;
-//           const opacity =
-//             options.opacity +
-//             Math.sin(seconds * options.opacitySpeed + index * 0.75) *
-//               options.opacityAmplitude;
-//           const material = mesh.material as MeshBasicMaterial;
-//
-//           mesh.position.copy(point);
-//           mesh.quaternion.setFromUnitVectors(zAxis, tangent);
-//           mesh.scale.setScalar(pulse);
-//           material.opacity = Math.max(0, Math.min(1, opacity));
-//         });
-//
-//         animationFrameId = window.requestAnimationFrame(tick);
-//       };
-//
-//       animationFrameId = window.requestAnimationFrame(tick);
-//
-//       return () => {
-//         disposed = true;
-//         window.cancelAnimationFrame(animationFrameId);
-//       };
-//     };
-//
-//     return {
-//       haloRings,
-//       start,
-//     };
-//   }
-//
-//   private startFusionLoop(fusion: SceneFusion) {
-//     const map = this.getMap() as any;
-//
-//     if (typeof map?.addSceneFusion === 'function') {
-//       map.addSceneFusion(fusion);
-//       this.ownsFusionLoop = true;
-//     }
-//   }
-//
-//   private releaseFusion() {
-//     if (!this.fusion) {
-//       return;
-//     }
-//
-//     const map = this.getMap() as any;
-//
-//     if (
-//       this.ownsFusionLoop &&
-//       map?._fusion === this.fusion &&
-//       typeof map.removeSceneFusion === 'function'
-//     ) {
-//       map.removeSceneFusion();
-//     } else {
-//       this.fusion.destroy();
-//     }
-//
-//     this.fusion = undefined;
-//     this.ownsFusionLoop = false;
-//   }
-//
-//   private disposeRoot() {
-//     if (!this.root) {
-//       return;
-//     }
-//
-//     const geometries = new Set<BufferGeometry>();
-//     const materials = new Set<Material>();
-//
-//     this.root.traverse((node) => {
-//       if (!(node instanceof Mesh)) {
-//         return;
-//       }
-//
-//       geometries.add(node.geometry);
-//
-//       if (Array.isArray(node.material)) {
-//         node.material.forEach((material) => materials.add(material));
-//       } else {
-//         materials.add(node.material);
-//       }
-//     });
-//
-//     geometries.forEach((geometry) => geometry.dispose());
-//     materials.forEach((material) => material.dispose());
-//     this.root.clear();
-//     this.root = undefined;
-//   }
-//
-//   /** 把 GeoJSON 坐标转换为经纬高对象。 */
-//   private toGeoPosition(
-//     coordinate: AirwayCoordinate,
-//   ): NormalizedAirwayGeoPosition {
-//     const [longitude, latitude, altitude = 0] = coordinate;
-//
-//     return {
-//       alt: altitude,
-//       lat: latitude,
-//       lng: longitude,
-//     };
-//   }
-//
-//   /**
-//    * 计算航道坐标中心。
-//    * @param coordinates 航道路径坐标。
-//    */
-//   private getCenter(
-//     coordinates: AirwayCoordinate[],
-//   ): NormalizedAirwayGeoPosition {
-//     const normalizedCoordinates = this.normalizeCoordinates(coordinates);
-//     const centerPoint = centerMean(
-//       points(
-//         normalizedCoordinates.map(([longitude, latitude]) => [
-//           longitude,
-//           latitude,
-//         ]),
-//       ),
-//     );
-//     const [longitude, latitude] = getCoords(centerPoint) as Position;
-//     const altitude =
-//       normalizedCoordinates.reduce(
-//         (accumulator, [, , currentAltitude]) => accumulator + currentAltitude,
-//         0,
-//       ) / normalizedCoordinates.length;
-//
-//     return {
-//       alt: altitude,
-//       lat: latitude,
-//       lng: longitude,
-//     };
-//   }
-//
-//   /**
-//    * 创建航道内置流动纹理。
-//    * @param options 纹理尺寸参数。
-//    */
-//   private createFlowTexture(
-//     options: AirwayFlowTextureOptions = {},
-//   ): CanvasTexture {
-//     const width = options.width ?? AIRWAY_DEFAULT_FLOW_TEXTURE_OPTIONS.width;
-//     const height = options.height ?? AIRWAY_DEFAULT_FLOW_TEXTURE_OPTIONS.height;
-//     const canvas = document.createElement('canvas');
-//
-//     canvas.width = width;
-//     canvas.height = height;
-//
-//     const context = canvas.getContext('2d');
-//
-//     if (!context) {
-//       throw new Error('无法创建航道流动纹理。');
-//     }
-//
-//     const imageData = context.createImageData(width, height);
-//     const tau = Math.PI * 2;
-//
-//     for (let pixelY = 0; pixelY < height; pixelY += 1) {
-//       for (let pixelX = 0; pixelX < width; pixelX += 1) {
-//         const horizontalRatio = pixelX / width;
-//         const verticalRatio = pixelY / height;
-//         const flowRatio = horizontalRatio * 0.29;
-//         const centeredVertical = (verticalRatio - 0.5) * 2;
-//         const band = Math.exp(-centeredVertical * centeredVertical * 5.8);
-//         const waveA = Math.sin(flowRatio * tau * 1.0);
-//         const waveB = Math.sin(
-//           flowRatio * tau * 2.2 + verticalRatio * tau * 1.3,
-//         );
-//         const waveC = Math.sin(
-//           flowRatio * tau * 4.6 - verticalRatio * tau * 2.8,
-//         );
-//         const energy = 0.48 + waveA * 0.22 + waveB * 0.16 + waveC * 0.08;
-//         const filament = Math.max(
-//           0,
-//           Math.sin(
-//             flowRatio * tau * 3.6 + Math.sin(verticalRatio * tau * 2.0) * 0.45,
-//           ),
-//         );
-//         const glow = Math.min(
-//           1,
-//           band * (0.42 + energy * 0.5) + filament ** 7 * 0.9,
-//         );
-//         const red = Math.round(18 + glow * 70);
-//         const green = Math.round(110 + glow * 145);
-//         const blue = Math.round(210 + glow * 45);
-//         const alpha = Math.round(
-//           Math.min(1, band * 0.78 + filament ** 5 * 0.62) * 255,
-//         );
-//         const dataIndex = (pixelY * width + pixelX) * 4;
-//
-//         imageData.data[dataIndex] = Math.min(255, red);
-//         imageData.data[dataIndex + 1] = Math.min(255, green);
-//         imageData.data[dataIndex + 2] = Math.min(255, blue);
-//         imageData.data[dataIndex + 3] = alpha;
-//       }
-//     }
-//
-//     context.putImageData(imageData, 0, 0);
-//
-//     const texture = new CanvasTexture(canvas);
-//     texture.wrapS = RepeatWrapping;
-//     texture.wrapT = RepeatWrapping;
-//     return texture;
-//   }
-// }
-//
-// export default Airway;