@zhangdali1996/lr-map-viewer 0.0.4 → 0.0.5

package/README.md

@@ -7,6 +7,7 @@
 - 支持 Vue 3 项目中以组件方式挂载三维地图容器。
 - 支持龙软三维 SDK 的运行时加载。
 - 支持通过运行时配置传入云 GIS 参数。
+- 支持通过运行时配置显式传入三维场景 `basePoint`。
 - 支持按需显示区域显隐面板和调试面板。
 - 支持通过组件实例调用 `moveView(x, y, z)` 移动三维视角。
 - 支持通过组件实例注册 `registerModelInfoQuery(callback)` 查询点击模型信息。
@@ -56,16 +57,18 @@ const lr3dConfig = {
   cloud: {
     // 云 GIS 服务地址
     server: 'https://your-cloud-gis-server/',
-    // 地图服务地址
-    mapServerUrl: 'https://your-map-server/',
     // 云 GIS 用户名
     username: 'your_username',
     // 云 GIS 密码
     password: 'your_password',
     // 数据源 guid
     dsGuid: 'your_ds_guid',
-    // 数据源名称
-    dsname: 'your_ds_name',
+    // 三维场景基点
+    basePoint: {
+      x: 37517614.46684,
+      y: 4410289.679932,
+      z: 972.148557,
+    },
     // 需要加载的巷道图层名
     layers: ['your_lane_layer_name'],
     laneSize: {
@@ -74,15 +77,6 @@ const lr3dConfig = {
       // 巷道渲染高度
       height: 10,
     },
-    // 需要加载的煤层图层名数组
-    coalLayers: ['your_coal_layer_name'],
-    // 需要加载的断层图层名数组
-    geofaultLayers: [],
-    // 以下开关和要素编码均提供默认值，按需覆盖即可
-    workfaceFeatureTypes: ['0202030030'],
-    regionFeatureTypes: ['0202030030', '0106020009', '0202030004', '0202030006'],
-    enableRegionAssist: false,
-    enableLane: true,
   },
 }
 </script>
@@ -233,18 +227,19 @@ const lr3dConfig = {
   autoLoad: true,
   cloud: {
     server: 'https://your-cloud-gis-server/',
-    mapServerUrl: 'https://your-map-server/',
     username: 'your_username',
     password: 'your_password',
     dsGuid: 'your_ds_guid',
-    dsname: 'your_ds_name',
+    basePoint: {
+      x: 37517614.46684,
+      y: 4410289.679932,
+      z: 972.148557,
+    },
     layers: ['your_lane_layer_name'],
     laneSize: {
       width: 10,
       height: 10,
     },
-    coalLayers: ['your_coal_layer_name'],
-    geofaultLayers: [],
   },
 }
 ```
@@ -255,16 +250,18 @@ const lr3dConfig = {
   是否在场景初始化成功后自动加载云 GIS 数据。
 - `cloud.server`
   云 GIS 服务地址。
-- `cloud.mapServerUrl`
-  地图服务地址。
 - `cloud.username`
   云 GIS 用户名。
 - `cloud.password`
   云 GIS 密码。
 - `cloud.dsGuid`
   数据源 guid。
-- `cloud.dsname`
-  数据源名称。
+- `cloud.basePoint.x`
+  三维场景基点 x 坐标。
+- `cloud.basePoint.y`
+  三维场景基点 y 坐标。
+- `cloud.basePoint.z`
+  三维场景基点 z 坐标。
 
 可选字段：
 
@@ -274,22 +271,15 @@ const lr3dConfig = {
   巷道渲染宽度，默认 `10`
 - `cloud.laneSize.height`
   巷道渲染高度，默认 `10`
-- `cloud.coalLayers`
-  需要加载的煤层图层名数组。
-- `cloud.geofaultLayers`
-  需要加载的断层图层名数组。
-- `cloud.workfaceFeatureTypes`
-  工作面要素编码数组，不传时使用默认值。
-- `cloud.regionFeatureTypes`
-  区域要素编码数组，不传时使用默认值。
-- `cloud.enableRegionAssist`
-  是否启用掘进辅助数据，默认 `false`。
-- `cloud.enableLane`
-  是否启用巷道加载，默认 `true`。
+- `cloud.mapServerUrl`
+  可按业务需要继续透传，但不再用于组件内部计算 `basePoint`。
+- `cloud.dsname`
+  可按业务需要继续透传，但不再作为三维基础加载必填项。
 
 兼容说明：
 
 - 组件内部仍兼容完整的 `lr3dConfig` 写法。
+- `basePoint` 推荐传入 `{ x, y, z }` 对象。
 - 如果你需要覆盖 SDK 路径、容器参数、初始化参数等高级配置，仍然可以继续传入 `sdk`、`scene`、`initOptions`、`dataSource` 完整结构。
 
 ## 示例配置
@@ -301,22 +291,19 @@ const playgroundLr3dConfig = {
   autoLoad: true,
   cloud: {
     server: 'https://your-cloud-gis-server/',
-    mapServerUrl: 'https://your-map-server/',
     username: 'your_username',
     password: 'your_password',
     dsGuid: 'your_ds_guid',
-    dsname: 'your_ds_name',
+    basePoint: {
+      x: 37517614.46684,
+      y: 4410289.679932,
+      z: 972.148557,
+    },
     layers: ['your_lane_layer_name'],
     laneSize: {
       width: 10,
       height: 10,
     },
-    coalLayers: ['your_coal_layer_name'],
-    geofaultLayers: [],
-    workfaceFeatureTypes: ['0202030030'],
-    regionFeatureTypes: ['0202030030', '0106020009', '0202030004', '0202030006'],
-    enableRegionAssist: false,
-    enableLane: true,
   },
 }
 ```
@@ -353,8 +340,8 @@ const playgroundLr3dConfig = {
 典型原因：
 
 - 组件库默认配置已不再携带真实业务参数。
-- 接入方没有传入 `server`、`mapServerUrl`、`username`、`password`、`dsGuid`、`dsname`。
+- 接入方没有传入 `server`、`username`、`password`、`dsGuid`、`basePoint`。
 
 处理方式：
 
-- 在 `lr3dConfig.cloud` 中补齐实际项目所需字段。
+- 在 `lr3dConfig.cloud` 中补齐实际项目所需字段。