deeptwins-engine-3d 0.1.71 → 0.1.74

package/dist/esm/constant.js

@@ -572,7 +572,8 @@ export var DEFAULT_BASE_LAYER = {
       maximumLevel: 18,
       credit: 'gd_img'
     }, {
-      url: 'https://webst02.is.autonavi.com/appmaptile?x={x}&y={y}&z={z}&lang=zh_cn&size=1&scale=1&style=8',
+      url: 'https://webst0{s}.is.autonavi.com/appmaptile?x={x}&y={y}&z={z}&lang=zh_cn&size=1&scale=1&style=8',
+      subdomains: ['1', '2', '3', '4'],
       minimumLevel: 1,
       maximumLevel: 18,
       credit: 'gd_img_zj'
@@ -593,7 +594,8 @@ export var DEFAULT_BASE_LAYER = {
     name: '高德电子+注记',
     type: 'raster',
     layers: [{
-      url: 'https://wprd02.is.autonavi.com/appmaptile?x={x}&y={y}&z={z}&lang=zh_cn&size=1&scl=1&style=7',
+      url: 'http://webrd0{s}.is.autonavi.com/appmaptile?lang=zh_cn&size=1&scale=1&style=8&x={x}&y={y}&z={z}',
+      subdomains: ['1', '2', '3', '4'],
       minimumLevel: 1,
       maximumLevel: 18,
       credit: 'gd_vec_zj'

package/dist/esm/index.js

@@ -73,11 +73,11 @@ DEEP_TWINS_BASE_URL && (window.CESIUM_BASE_URL = DEEP_TWINS_BASE_URL);
 // 全局加载css
 loadCss(Cesium.buildModuleUrl('Widgets/widgets.css'));
 // 打印版本信息
-console.log('DeepTwinsEngine3D Version:', "0.1.71");
+console.log('DeepTwinsEngine3D Version:', "0.1.74");
 export var DeepTwinsEngine3D = /*#__PURE__*/_createClass(function DeepTwinsEngine3D() {
   _classCallCheck(this, DeepTwinsEngine3D);
 });
-_defineProperty(DeepTwinsEngine3D, "Version", "0.1.71");
+_defineProperty(DeepTwinsEngine3D, "Version", "0.1.74");
 _defineProperty(DeepTwinsEngine3D, "Map", Map);
 _defineProperty(DeepTwinsEngine3D, "GroundSkyBox", GroundSkyBox);
 _defineProperty(DeepTwinsEngine3D, "RasterLayer", RasterLayer);

package/dist/esm/tileLayer/CustomRasterLayer.d.ts

@@ -4,7 +4,7 @@ import ImageryLayer from './ImageryLayer';
 /**
  * CustomRasterLayer 是一个通用栅格瓦片图层：
  * - 使用 Cesium.UrlTemplateImageryProvider 加载任意 URL 模板瓦片。
- * - 使用 proj4 将瓦片范围和裁剪 GeoJSON 从 dataCrs 转到 renderCrs。
+ * - 使用 proj4 将瓦片范围和裁剪 GeoJSON 从各自 CRS 转到 renderCrs。
  * - GCJ02 渲染时按 tileLayer/test 的瓦片坐标方案计算瓦片范围。
  * - 可选按 GeoJSON 面要素裁剪瓦片。
  * - 裁剪前先求瓦片 bbox 与裁剪面的交集，避免多面重叠时误裁。
@@ -46,17 +46,20 @@ import ImageryLayer from './ImageryLayer';
  * - `source`：必填，Cesium.UrlTemplateImageryProvider 原生配置。
  * - `layerOptions`：可选，Cesium.ImageryLayer 原生配置。
  * - `bounds`：可选，瓦片范围 `[minX, minY, maxX, maxY]`。
- * - `dataCrs`：可选，bounds 与 clipFeature 的原始坐标系，默认 `EPSG:4326`。
+ * - `dataCrs`：可选，bounds 的原始坐标系，默认 `EPSG:4326`。
+ * - `clipFeatureCrs`：可选，clipFeature 的原始坐标系，默认跟随 dataCrs。
  * - `renderCrs`：可选，bounds、clipFeature 和瓦片范围转换后的目标坐标系，默认 `EPSG:4326`。
  * - `projectionDefs`：可选，自定义 proj4 坐标系定义。
  * - `clipFeature`：可选，GeoJSON Polygon/MultiPolygon/Feature/FeatureCollection。
  * - `autoFitBounds`：可选，创建后自动将相机定位到最终范围，需同时传入 `map`。
- * - `debug`：可选，`true` 使用 console.debug，函数则接收结构化调试事件。
+ * - `debug`：可选，`true` 使用 console.log 输出调试信息，函数则接收结构化调试事件。
  */
 /** 通用范围格式：[minX, minY, maxX, maxY]。 */
 export type CustomRasterBounds = [number, number, number, number];
 /** 调试事件类型，覆盖范围初始化、瓦片加载和裁剪决策。 */
 export type CustomRasterLayerDebugEventType = 'range' | 'tile-loaded' | 'tile-kept' | 'tile-clipped' | 'tile-discarded' | 'tile-error';
+/** 瓦片 debug 状态。 */
+export type CustomRasterLayerDebugStatus = 'loaded' | 'kept' | 'clipped' | 'filtered' | 'error';
 /** debug 回调收到的结构化事件。 */
 export type CustomRasterLayerDebugEvent = {
     /** 事件类型。 */
@@ -69,6 +72,16 @@ export type CustomRasterLayerDebugEvent = {
     y?: number;
     /** 瓦片层级。 */
     level?: number;
+    /** 瓦片标识，格式为 z/x/y。 */
+    tileKey?: string;
+    /** 瓦片是否已进入加载流程。 */
+    loaded?: boolean;
+    /** 瓦片是否被裁剪。 */
+    clipped?: boolean;
+    /** 瓦片是否被过滤为空透明瓦片。 */
+    filtered?: boolean;
+    /** 瓦片处理状态。 */
+    status?: CustomRasterLayerDebugStatus;
     /** 当前瓦片范围，格式为 [west, south, east, north]。 */
     bbox?: CustomRasterBounds;
     /** 用户传入的原始瓦片范围。 */
@@ -79,8 +92,12 @@ export type CustomRasterLayerDebugEvent = {
     clipBounds?: CustomRasterBounds;
     /** 最终用于瓦片调度的渲染范围。 */
     renderBounds?: CustomRasterBounds;
-    /** 原始数据坐标系。 */
+    /** 转换到 renderCrs 后的裁剪 GeoJSON。 */
+    clipFeature?: any;
+    /** bounds 原始坐标系。 */
     dataCrs?: string;
+    /** clipFeature 原始坐标系。 */
+    clipFeatureCrs?: string;
     /** bounds、clipFeature 和瓦片范围转换后的目标坐标系。 */
     renderCrs?: string;
     /** 裁剪或丢弃原因。 */
@@ -93,7 +110,7 @@ export type CustomRasterLayerDebugEvent = {
         height: number;
     };
 };
-/** debug 配置：关闭、console.debug 输出，或自定义事件处理函数。 */
+/** debug 配置：关闭、console.log 输出，或自定义事件处理函数。 */
 export type CustomRasterLayerDebug = boolean | ((event: CustomRasterLayerDebugEvent) => void);
 /** 内置切片方案名称，或 Cesium 原生 TilingScheme 实例。 */
 export type CustomRasterTilingSchemeOption = 'webMercator' | 'geographic' | Cesium.TilingScheme;
@@ -114,8 +131,10 @@ export type CustomRasterLayerOptions = {
     layerOptions?: Cesium.ImageryLayer.ConstructorOptions;
     /** 瓦片范围，格式为 [minX, minY, maxX, maxY]，坐标系跟随 dataCrs。 */
     bounds?: CustomRasterBounds;
-    /** bounds 和 clipFeature 的原始坐标系，默认 EPSG:4326。 */
+    /** bounds 的原始坐标系，默认 EPSG:4326。 */
     dataCrs?: string;
+    /** clipFeature 的原始坐标系，默认跟随 dataCrs。 */
+    clipFeatureCrs?: string;
     /** bounds、clipFeature 和瓦片范围转换后的目标坐标系，默认 EPSG:4326。 */
     renderCrs?: string;
     /** 自定义 proj4 坐标系定义，key 可为 EPSG:xxxx 或其他 proj4 名称。 */
@@ -182,6 +201,10 @@ export default class CustomRasterLayer extends ImageryLayer {
     private geometryToPathArray;
     /** 按 path 坐标裁剪当前瓦片画布。 */
     private clip;
+    private getTileKey;
+    private getDebugStatus;
+    private normalizeDebugEvent;
+    private logBuiltInDebug;
     /** 输出结构化 debug 事件。 */
     private logDebug;
 }

package/dist/esm/tileLayer/CustomRasterLayer.js

@@ -35,7 +35,7 @@ import ImageryLayer from "./ImageryLayer";
 /**
  * CustomRasterLayer 是一个通用栅格瓦片图层：
  * - 使用 Cesium.UrlTemplateImageryProvider 加载任意 URL 模板瓦片。
- * - 使用 proj4 将瓦片范围和裁剪 GeoJSON 从 dataCrs 转到 renderCrs。
+ * - 使用 proj4 将瓦片范围和裁剪 GeoJSON 从各自 CRS 转到 renderCrs。
  * - GCJ02 渲染时按 tileLayer/test 的瓦片坐标方案计算瓦片范围。
  * - 可选按 GeoJSON 面要素裁剪瓦片。
  * - 裁剪前先求瓦片 bbox 与裁剪面的交集，避免多面重叠时误裁。
@@ -77,21 +77,24 @@ import ImageryLayer from "./ImageryLayer";
  * - `source`：必填，Cesium.UrlTemplateImageryProvider 原生配置。
  * - `layerOptions`：可选，Cesium.ImageryLayer 原生配置。
  * - `bounds`：可选，瓦片范围 `[minX, minY, maxX, maxY]`。
- * - `dataCrs`：可选，bounds 与 clipFeature 的原始坐标系，默认 `EPSG:4326`。
+ * - `dataCrs`：可选，bounds 的原始坐标系，默认 `EPSG:4326`。
+ * - `clipFeatureCrs`：可选，clipFeature 的原始坐标系，默认跟随 dataCrs。
  * - `renderCrs`：可选，bounds、clipFeature 和瓦片范围转换后的目标坐标系，默认 `EPSG:4326`。
  * - `projectionDefs`：可选，自定义 proj4 坐标系定义。
  * - `clipFeature`：可选，GeoJSON Polygon/MultiPolygon/Feature/FeatureCollection。
  * - `autoFitBounds`：可选，创建后自动将相机定位到最终范围，需同时传入 `map`。
- * - `debug`：可选，`true` 使用 console.debug，函数则接收结构化调试事件。
+ * - `debug`：可选，`true` 使用 console.log 输出调试信息，函数则接收结构化调试事件。
  */
 
 /** 通用范围格式：[minX, minY, maxX, maxY]。 */
 
 /** 调试事件类型，覆盖范围初始化、瓦片加载和裁剪决策。 */
 
+/** 瓦片 debug 状态。 */
+
 /** debug 回调收到的结构化事件。 */
 
-/** debug 配置：关闭、console.debug 输出，或自定义事件处理函数。 */
+/** debug 配置：关闭、console.log 输出，或自定义事件处理函数。 */
 
 /** 内置切片方案名称，或 Cesium 原生 TilingScheme 实例。 */
 
@@ -453,6 +456,28 @@ var getImageSize = function getImageSize(image) {
     height: image.height
   };
 };
+var DEBUG_STATUS_STYLES = {
+  loaded: {
+    label: '瓦片已加载',
+    consoleColor: '#16a34a'
+  },
+  kept: {
+    label: '瓦片已保留',
+    consoleColor: '#16a34a'
+  },
+  clipped: {
+    label: '瓦片已裁剪',
+    consoleColor: '#eab308'
+  },
+  filtered: {
+    label: '瓦片已过滤',
+    consoleColor: '#dc2626'
+  },
+  error: {
+    label: '瓦片处理异常',
+    consoleColor: '#b91c1c'
+  }
+};
 
 /**
  * 通用自定义栅格图层。
@@ -473,8 +498,9 @@ var CustomRasterLayer = /*#__PURE__*/function (_ImageryLayer) {
     }
     registerProjectionDefs(options.projectionDefs);
     var dataCrs = normalizeCrs(options.dataCrs || DEFAULT_CRS);
+    var clipFeatureCrs = normalizeCrs(options.clipFeatureCrs || dataCrs);
     var renderCrs = normalizeCrs(options.renderCrs || DEFAULT_CRS);
-    var transformedClipFeature = transformGeoJson(options.clipFeature, dataCrs, renderCrs);
+    var transformedClipFeature = transformGeoJson(options.clipFeature, clipFeatureCrs, renderCrs);
     var clipFeatures = collectPolygonFeatures(transformedClipFeature);
     var _options$source = options.source,
       sourceTilingSchemeOption = _options$source.tilingScheme,
@@ -515,7 +541,9 @@ var CustomRasterLayer = /*#__PURE__*/function (_ImageryLayer) {
       tileBounds: tileBounds,
       clipBounds: clipBounds,
       renderBounds: renderBounds,
+      clipFeature: transformedClipFeature,
       dataCrs: dataCrs,
+      clipFeatureCrs: clipFeatureCrs,
       renderCrs: renderCrs
     });
     if (options.autoFitBounds && normalizeBounds(fitBounds)) {
@@ -753,6 +781,94 @@ var CustomRasterLayer = /*#__PURE__*/function (_ImageryLayer) {
       context.fill();
       context.restore();
     }
+  }, {
+    key: "getTileKey",
+    value: function getTileKey(event) {
+      if (event.x === undefined || event.y === undefined || event.level === undefined) {
+        return undefined;
+      }
+      return "".concat(event.level, "/").concat(event.x, "/").concat(event.y);
+    }
+  }, {
+    key: "getDebugStatus",
+    value: function getDebugStatus(event) {
+      if (event.status) {
+        return event.status;
+      }
+      if (event.type === 'tile-loaded') {
+        return 'loaded';
+      }
+      if (event.type === 'tile-kept') {
+        return 'kept';
+      }
+      if (event.type === 'tile-clipped') {
+        return 'clipped';
+      }
+      if (event.type === 'tile-discarded') {
+        return 'filtered';
+      }
+      if (event.type === 'tile-error') {
+        return 'error';
+      }
+      return undefined;
+    }
+  }, {
+    key: "normalizeDebugEvent",
+    value: function normalizeDebugEvent(event) {
+      var status = this.getDebugStatus(event);
+      return _objectSpread(_objectSpread(_objectSpread({}, event), this.getTileKey(event) ? {
+        tileKey: this.getTileKey(event)
+      } : {}), status ? {
+        status: status,
+        loaded: true,
+        clipped: status === 'clipped',
+        filtered: status === 'filtered'
+      } : {});
+    }
+  }, {
+    key: "logBuiltInDebug",
+    value: function logBuiltInDebug(event) {
+      if (event.type === 'range') {
+        console.log('[CustomRasterLayer] 渲染范围/裁剪范围', {
+          renderBounds: event.renderBounds,
+          clipBounds: event.clipBounds,
+          clipFeature: event.clipFeature,
+          tileBounds: event.tileBounds,
+          bounds: event.bounds,
+          dataCrs: event.dataCrs,
+          clipFeatureCrs: event.clipFeatureCrs,
+          renderCrs: event.renderCrs
+        });
+        return;
+      }
+      if (!event.status) {
+        return;
+      }
+      if (event.type === 'tile-loaded' && this._clipFeatures.length) {
+        return;
+      }
+      var style = DEBUG_STATUS_STYLES[event.status];
+      var title = "[CustomRasterLayer] ".concat(style.label);
+      var consoleStyle = "color: ".concat(style.consoleColor, "; font-weight: bold;");
+      var tileInfo = "z=".concat(event.level, " x=").concat(event.x, " y=").concat(event.y);
+      if (event.type === 'tile-error') {
+        console.error("%c".concat(title, " ").concat(tileInfo), consoleStyle, event.error, event);
+        return;
+      }
+      console.log("%c".concat(title, " ").concat(tileInfo), consoleStyle, {
+        tileKey: event.tileKey,
+        z: event.level,
+        x: event.x,
+        y: event.y,
+        loaded: event.loaded,
+        clipped: event.clipped,
+        filtered: event.filtered,
+        status: event.status,
+        reason: event.reason,
+        bbox: event.bbox,
+        imageSize: event.imageSize
+      });
+    }
 
     /** 输出结构化 debug 事件。 */
   }, {
@@ -761,14 +877,14 @@ var CustomRasterLayer = /*#__PURE__*/function (_ImageryLayer) {
       if (!this._debug) {
         return;
       }
-      var debugEvent = _objectSpread({
+      var debugEvent = this.normalizeDebugEvent(_objectSpread({
         layerId: this.id
-      }, event);
+      }, event));
       if (typeof this._debug === 'function') {
         this._debug(debugEvent);
         return;
       }
-      console.debug('[CustomRasterLayer]', debugEvent);
+      this.logBuiltInDebug(debugEvent);
     }
   }]);
   return CustomRasterLayer;