@yangyongtao/gaea 1.0.0

package/README.md

@@ -0,0 +1,115 @@
+# gaea-3dview
+
+Gaea 3D 可视化组件库，包含天气控制、沿线飞行、台风标注、点标注等功能。
+
+## 前置条件
+
+使用前需在 HTML 中加载 Gaea 运行库：
+
+```html
+<script src="path/to/Gaea.js"></script>
+```
+
+## 安装
+
+```bash
+npm install @your-scope/gaea-3dview
+```
+
+## 快速开始
+
+```js
+import { GaeaApp, setConfig } from '@your-scope/gaea-3dview';
+
+// 1. 配置全局参数（初始化前调用）
+setConfig({
+  serveLocal: 'http://localhost:9012',  // 静态资源地址
+  serveUrl: 'http://192.168.1.1:8088/gaeaExplorerServer/',
+});
+
+// 2. 创建实例
+const app = new GaeaApp();
+
+// 3. 初始化基础环境
+app.initDefaultEnvironment();
+
+// 4. 在指定坐标放置图标
+await app.drawPointIcon({ lat: 27.3809, lng: 120.4499 });
+
+// 5. 沿线飞行
+await app.flyAlongPath([
+  { x: 27.22, y: 120.45 },
+  { x: 27.35, y: 120.55 },
+]);
+```
+
+## API 文档
+
+### GaeaApp 类
+
+#### `setConfig(config)`
+初始化前设置全局配置，必传 `serveLocal`。
+
+#### `drawPointIcon(opts)` / `drawPointIcons(list)`
+在指定经纬度放置图标标记。
+
+```js
+await app.drawPointIcon({ lat: 27.22, lng: 120.45, iconSize: 150 });
+```
+
+#### `clearPointIcons()`
+清除所有点标注。
+
+#### `flyAlongPath(lineData, opts)`
+沿路径飞行。
+
+```js
+await app.flyAlongPath(
+  [{ x: 27.22, y: 120.45 }, { x: 27.35, y: 120.55 }],
+  { height: 150, duration: 20 }
+);
+```
+
+#### `stopFlyAlongPath()`
+停止飞行。
+
+#### `enableRain(params)` / `restoreNormalWeather()`
+天气控制。
+
+```js
+app.enableRain({ direction: 0, speed: 5, count: 30 });
+app.restoreNormalWeather();
+```
+
+#### `cameraReset()`
+重置相机到默认视角。
+
+#### `screenToLatLng(event)`
+屏幕坐标 → 经纬度。
+
+## Vue 组件
+
+```vue
+<script setup>
+import { GaeaApp } from '@your-scope/gaea-3dview';
+import { WeatherControl, FlyAlongRoute } from '@your-scope/gaea-3dview/components';
+
+const app = new GaeaApp();
+</script>
+
+<template>
+  <WeatherControl :appInstance="app" @close="..." />
+  <FlyAlongRoute :appInstance="app" @close="..." @fly="..." />
+</template>
+```
+
+## 静态资源
+
+发布时需要随包分发以下文件：
+- `public/static/1111.res` — 点标注图标
+- `public/static/SkyDay.png` — 天空纹理（可选）
+- `public/static/gltf/*.gltf` — 3D 模型文件
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@yangyongtao/gaea",
+  "version": "1.0.0",
+  "description": "Gaea 3D 可视化组件库，包含天气控制、沿线飞行、台风标注、模型加载等功能",
+  "type": "module",
+  "main": "src/index.js",
+  "module": "src/index.js",
+  "exports": {
+    ".": {
+      "import": "./src/index.js",
+      "default": "./src/index.js"
+    },
+    "./components": {
+      "import": "./src/components/index.js",
+      "default": "./src/components/index.js"
+    },
+    "./methods": {
+      "import": "./src/GaeaMethods.js",
+      "default": "./src/GaeaMethods.js"
+    }
+  },
+  "files": [
+    "src/",
+    "public/",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "echo \"No tests yet\""
+  },
+  "keywords": [
+    "gaea",
+    "3d",
+    "viewer",
+    "weather",
+    "typhoon",
+    "flight",
+    "vue",
+    "component"
+  ],
+  "peerDependencies": {
+    "element-plus": "^2.6.0",
+    "pinia": "^2.1.0",
+    "vue": "^3.4.0"
+  },
+  "peerDependenciesMeta": {
+    "element-plus": {
+      "optional": true
+    },
+    "pinia": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@tweenjs/tween.js": "^25.0.0"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "yangyongtao",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yangyongtao/gaea.git"
+  }
+}

package/src/GaeaMethods.js

@@ -0,0 +1,391 @@
+/**
+ * gaea-3dview npm package
+ * 
+ * 使用前必须在项目 HTML 中加载 Gaea CDN：
+ * <script src="path/to/Gaea.js"></script>
+ * 
+ * 配置初始化：
+ * import { setConfig } from '@your-scope/gaea-3dview';
+ * setConfig({ serveUrl: '...', serveLocal: '...' });
+ * 
+ * 使用 GaeaApp：
+ * import { GaeaApp } from '@your-scope/gaea-3dview';
+ * const app = new GaeaApp();
+ * await app.drawPointIcon({ lat: 27.22, lng: 120.45 });
+ */
+
+// ==================== 基础工具函数 ====================
+
+/** 加载资源到 Gaea */
+function loadResource(url, name) {
+  return new Promise((res, rej) => {
+    if (!window.Gaea || !window.Gaea.GaeaResourceLoader) {
+      rej(new Error('Gaea 未初始化，请先加载 Gaea CDN'));
+      return;
+    }
+    window.Gaea.GaeaResourceLoader.Instance.LoadResourceFromUrl1(
+      url, name,
+      (code, msg) => {
+        if (code === 200) res(true);
+        else { console.warn(`加载资源失败: ${name}`, msg); rej(false); }
+      }
+    );
+  });
+}
+
+/** 获取文件名 */
+function getFileName(url) {
+  return url.split('/').pop().split('?')[0];
+}
+
+/** RGB 字符串转 Gaea Color */
+function rgbToGaeaColor(rgb) {
+  if (typeof rgb !== 'string') return null;
+  const match = rgb.match(/\((.+?)\)/);
+  if (!match) return null;
+  const arr = match[1].split(',').map(Number);
+  return new window.Gaea.Color(arr[0] / 255, arr[1] / 255, arr[2] / 255, 1);
+}
+
+
+// ==================== GaeaApp 类 ====================
+
+import { Tween, Group, Easing } from '@tweenjs/tween.js';
+import config from './config.js';
+
+export class GaeaApp {
+  constructor(options = {}) {
+    this.config = { ...config, ...options };
+
+    // ---- 飞行相关 ----
+    this._flyAnimation = null;
+    this._flyAnimationPlayer = null;
+    this._flyModelInstance = null;
+    this._flyEntityView = null;
+
+    // ---- 点标注相关 ----
+    this._pointIconElements = [];
+    this._pointIconLoaded = false;
+
+    // ---- 天气相关 ----
+    this._weatherInited = false;
+    this._fullScreenQuad = null;
+    this._sky = null;
+    this._sun = null;
+    this._environment = null;
+    this._defaultSkyMtl = null;
+    this._rainSkyMtl = null;
+    this._rainSkyTexture = null;
+
+    // ---- Tween 动画组 ----
+    this._tweenGroup = new Group();
+  }
+
+  // ==================== 点标注 ====================
+
+  /**
+   * 在指定经纬度放置图标标记
+   * @param {Object} opts - { lat, lng, alt?, iconSize?, enablePick? }
+   */
+  async drawPointIcon(opts = {}) {
+    const { lat, lng, alt = 0, iconSize = 150, enablePick = true } = opts;
+    if (lat == null || lng == null) {
+      console.error('drawPointIcon: lat 和 lng 不能为空');
+      return null;
+    }
+
+    const Gaea = window.Gaea;
+    const resName = 'pointIcon.res';
+
+    if (!this._pointIconLoaded) {
+      const resUrl = `${this.config.serveLocal}/static/1111.res`;
+      const loaded = await loadResource(resUrl, resName);
+      if (!loaded) return null;
+      this._pointIconLoaded = true;
+    }
+
+    const texId = Gaea.GaeaResourceLoader.Instance.GetResource(resName);
+    const tex = new Gaea.Texture(false);
+    tex.InstanceID = texId + '';
+
+    const pos = new Gaea.Vector3(lat, lng, alt);
+    const shape = Gaea.Geometry.Create1(Gaea.GeometryType.Point, [pos]);
+
+    const element = new Gaea.PointGeometryElement();
+    element.Shape = shape;
+
+    const iconSymbol = new Gaea.IconMarkSymbol();
+    iconSymbol.MarkSize = iconSize;
+    iconSymbol.Icon = tex;
+    element.Symbol = iconSymbol;
+    element.EnablePick = enablePick;
+    element.EnableEdit = false;
+
+    Gaea.World.Instance.RenderableObjectList.AddLast(element);
+    this._pointIconElements.push(element);
+    return element;
+  }
+
+  /**
+   * 批量添加图标标记
+   * @param {Array} pointList - [{ lat, lng, alt?, iconSize? }]
+   */
+  async drawPointIcons(pointList = []) {
+    const elements = [];
+    for (const p of pointList) {
+      const el = await this.drawPointIcon(p);
+      if (el) elements.push(el);
+    }
+    return elements;
+  }
+
+  /** 清除所有点标注 */
+  clearPointIcons() {
+    const Gaea = window.Gaea;
+    this._pointIconElements.forEach(el => {
+      Gaea.World.Instance.RenderableObjectList.Remove(el);
+    });
+    this._pointIconElements = [];
+  }
+
+  // ==================== 沿线飞行 ====================
+
+  /**
+   * 沿路径飞行
+   * @param {Array} lineData - [{ x: lat, y: lng }, ...]
+   * @param {Object} opts - { height, step, duration, xrotation, lockEye, minZoom, maxZoom }
+   */
+  async flyAlongPath(lineData, opts = {}) {
+    const Gaea = window.Gaea;
+    const {
+      height = 150, step = 1000, duration = 20,
+      xrotation = -30, lockEye = true, minZoom = 0, maxZoom = 400
+    } = opts;
+
+    if (!lineData || lineData.length < 2) {
+      return Promise.reject(new Error('至少需要2个路径点'));
+    }
+
+    try {
+      this._cleanupFlyResources();
+
+      const bezier = new Gaea.UniformCubicSpline();
+      for (let i = 0; i < lineData.length; i++) {
+        const ctrl = Gaea.GaeaMath.SphericalToCartesianDeg(
+          new Gaea.Vector3(lineData[i].x, lineData[i].y, height)
+        );
+        bezier.AddValue(i, ctrl);
+      }
+      bezier.Step = step;
+      bezier.Interpolate(true);
+      bezier.CalculateLengthAfterInterpolation();
+
+      const startPos = Gaea.GaeaMath.SphericalToCartesianDeg(
+        new Gaea.Vector3(lineData[0].x, lineData[0].y, height)
+      );
+
+      const mesh = new Gaea.CubeMesh();
+      mesh.Size = new Gaea.Vector3(1, 1, 1);
+      const mtl = new Gaea.SpatialMaterial();
+      mtl.AlbedoColor = new Gaea.Color(1, 0, 0, 1);
+      mesh.SurfaceSetMaterial(0, mtl);
+
+      this._flyModelInstance = new Gaea.MeshInstance();
+      this._flyModelInstance.Name = 'flyModel';
+      this._flyModelInstance.Visible = false;
+      this._flyModelInstance.Translation = startPos;
+      Gaea.World.Instance.AddChild(this._flyModelInstance, false);
+
+      this._flyEntityView = new Gaea.EntityView();
+      this._flyEntityView.Offset3D = new Gaea.Vector3(
+        -1, 0, Math.tan(xrotation / 180 * Math.PI)
+      );
+      this._flyEntityView.LockEye = lockEye;
+      this._flyEntityView.MinMaxZoom3D = new Gaea.Vector2(minZoom, maxZoom);
+      this._flyEntityView.Init(this._flyModelInstance);
+      Gaea.World.Instance.CameraController.LockedEntity = this._flyEntityView;
+
+      this._flyAnimation = bezier.ToAnimationByTime(
+        'flyAnim', true, duration, new Gaea.Vector3(1, 1, 1)
+      );
+      this._flyAnimation.TrackSetPath(0, '/root/World/flyModel');
+
+      this._flyAnimationPlayer = new Gaea.GaeaAnimationPlayer();
+      this._flyAnimationPlayer.AddAnimation('flyAnim', this._flyAnimation);
+      Gaea.World.Instance.AddChild(this._flyAnimationPlayer, false);
+
+      return new Promise((resolve) => {
+        this._flyAnimationPlayer.PlayWithCallback(
+          'flyAnim', Gaea.CallbackType.AnimatioFinished, () => resolve()
+        );
+      });
+    } catch (e) {
+      this._cleanupFlyResources();
+      return Promise.reject(e);
+    }
+  }
+
+  /** 停止飞行 */
+  stopFlyAlongPath() {
+    try {
+      if (this._flyAnimationPlayer) {
+        this._flyAnimationPlayer.Stop('flyAnim');
+      }
+    } catch (e) { /* ignore */ }
+    this._cleanupFlyResources();
+  }
+
+  _cleanupFlyResources() {
+    const Gaea = window.Gaea;
+    try {
+      if (this._flyAnimationPlayer) {
+        Gaea.World.Instance.RemoveChild(this._flyAnimationPlayer);
+        this._flyAnimationPlayer = null;
+      }
+      this._flyEntityView = null;
+      if (this._flyModelInstance) {
+        Gaea.World.Instance.RemoveChild(this._flyModelInstance);
+        this._flyModelInstance = null;
+      }
+      Gaea.World.Instance.CameraController.LockedEntity = null;
+      this._flyAnimation = null;
+    } catch (e) { /* ignore */ }
+  }
+
+  /** 重置相机视角 */
+  cameraReset() {
+    const Gaea = window.Gaea;
+    const camera = Gaea.World.Instance.DefaultCamera;
+    camera && camera.Reset();
+  }
+
+  // ==================== 天气控制 ====================
+
+  _initWeather() {
+    if (this._weatherInited) return;
+    const Gaea = window.Gaea;
+    this._fullScreenQuad = Gaea.World.Instance.FullScreenQuad;
+    this._sky = Gaea.MeshInstance.ConvertBy(Gaea.World.Instance.GetNode('Sky'));
+    this._sun = Gaea.Sun.ConvertBy(Gaea.World.Instance.GetNode('Sun'));
+    this._environment = Gaea.Environment.ConvertBy(
+      Gaea.GaeaResourceLoader.Instance.LoadLoaclResource('res://default_env.tres')
+    );
+    this._defaultSkyMtl = this._sky.MaterialOverride;
+    this._weatherInited = true;
+  }
+
+  /** 开启下雨 */
+  enableRain(params = {}) {
+    this._initWeather();
+    const Gaea = window.Gaea;
+    const fsq = this._fullScreenQuad;
+    if (!fsq) return;
+
+    const {
+      direction = 0, speed = 5, count = 30
+    } = params;
+
+    fsq.Visible = true;
+    fsq.NeedAtmosphere = true;
+
+    this._sun.TimeString = '2022-09-15 00:00:00';
+    this._sun.LightColor = new Gaea.Color(1, 1, 1, 1);
+    this._sun.LightEnergy = 0.05;
+    this._environment.BackgroundEnergy = 0.11;
+    this._environment.GlowBlendMode = 1;
+
+    fsq.RainyCount = count;
+    fsq.Speed = speed;
+    fsq.WindDirection = direction;
+    fsq.Rainy = true;
+  }
+
+  /** 更新雨参数 */
+  updateRain(params = {}) {
+    const Gaea = window.Gaea;
+    const fsq = this._fullScreenQuad;
+    if (!fsq) return;
+    if (params.direction !== undefined) fsq.WindDirection = params.direction;
+    if (params.speed !== undefined) fsq.Speed = params.speed;
+    if (params.count !== undefined) fsq.RainyCount = params.count;
+  }
+
+  /** 恢复正常天气 */
+  restoreNormalWeather() {
+    this._initWeather();
+    const Gaea = window.Gaea;
+    const fsq = this._fullScreenQuad;
+    if (!fsq) return;
+
+    fsq.Rainy = false;
+    fsq.Visible = false;
+    fsq.NeedAtmosphere = false;
+
+    this._sun.TimeString = '2022-09-15 12:00:00';
+    this._sun.LightColor = new Gaea.Color(1, 226 / 255, 164 / 255, 1);
+    this._sun.LightEnergy = 3.5;
+    this._environment.BackgroundEnergy = 0.2;
+    this._environment.GlowBlendMode = 2;
+
+    if (this._defaultSkyMtl && this._sky) {
+      this._sky.MaterialOverride = this._defaultSkyMtl;
+    }
+  }
+
+  /** 初始化基础环境（关闭默认雾、设置默认光照等） */
+  initDefaultEnvironment() {
+    const Gaea = window.Gaea;
+
+    // 关闭默认雾
+    const fogEnv = Gaea.Environment.ConvertBy(
+      Gaea.GaeaResourceLoader.Instance.LoadLoaclResource('res://default_env.tres')
+    );
+    fogEnv.FogEnabled = false;
+
+    // 基础环境光
+    const env = Gaea.Environment.ConvertBy(
+      Gaea.GaeaResourceLoader.Instance.LoadLoaclResource('res://default_env.tres')
+    );
+    env.BackgroundEnergy = 0.6;
+
+    const sun = Gaea.Sun.ConvertBy(Gaea.World.Instance.GetNode('Sun'));
+    sun.Power = 1.5;
+
+    Gaea.World.Instance.ForceCloudVisalbe = true;
+    Gaea.World.Instance.CloudVisalbe = false;
+
+    window.Gaea = Gaea;
+  }
+
+  /** 设置静止资源 Base URL */
+  setAssetHost(assetHost) {
+    const Gaea = window.Gaea;
+    const cfg = `[Engine]\nDefaultGlobalOverview="Global2.jpg"\nAssetHost="${assetHost}"`;
+    Gaea.World.Instance.EngineConfigString = cfg;
+  }
+
+  // ==================== 工具方法 ====================
+
+  /** 屏幕坐标 → 经纬度 */
+  screenToLatLng(event) {
+    const Gaea = window.Gaea;
+    if (!Gaea || !Gaea.GaeaMath) return null;
+    const result = Gaea.GaeaMath.ProjectPosition(
+      new Gaea.Vector2(event.offsetX, event.offsetY)
+    );
+    const lonlat = Gaea.GaeaMath.CartesianToSphericalDeg(result);
+    return { lat: lonlat.x, lng: lonlat.y, alt: lonlat.z };
+  }
+
+  /** Vector3 快捷创建 */
+  vec3(x = 0, y = 0, z = 0) {
+    return new window.Gaea.Vector3(x, y, z);
+  }
+
+  /** Color 快捷创建 (0-1) */
+  color(r, g, b, a = 1) {
+    return new window.Gaea.Color(r, g, b, a);
+  }
+}
+
+export default GaeaApp;