deeptwins-engine-3d 0.1.70 → 0.1.72

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.70");
+console.log('DeepTwinsEngine3D Version:', "0.1.72");
 export var DeepTwinsEngine3D = /*#__PURE__*/_createClass(function DeepTwinsEngine3D() {
   _classCallCheck(this, DeepTwinsEngine3D);
 });
-_defineProperty(DeepTwinsEngine3D, "Version", "0.1.70");
+_defineProperty(DeepTwinsEngine3D, "Version", "0.1.72");
 _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 与裁剪面的交集，避免多面重叠时误裁。
@@ -45,12 +45,13 @@ import ImageryLayer from './ImageryLayer';
  * @remarks API 文档
  * - `source`：必填，Cesium.UrlTemplateImageryProvider 原生配置。
  * - `layerOptions`：可选，Cesium.ImageryLayer 原生配置。
- * - `bounds`：可选，数据范围 `[minX, minY, maxX, maxY]`，未传时默认使用 turf 计算 clipFeature bbox。
- * - `dataCrs`：可选，bounds 与 clipFeature 的原始坐标系，默认 `EPSG:4326`。
- * - `renderCrs`：可选，bounds、clipFeature 和瓦片范围使用的坐标系，默认 `EPSG:4326`，支持 `GCJ02/gcj02/gcj-02`。
+ * - `bounds`：可选，瓦片范围 `[minX, minY, maxX, maxY]`。
+ * - `dataCrs`：可选，bounds 的原始坐标系，默认 `EPSG:4326`。
+ * - `clipFeatureCrs`：可选，clipFeature 的原始坐标系，默认跟随 dataCrs。
+ * - `renderCrs`：可选，bounds、clipFeature 和瓦片范围转换后的目标坐标系，默认 `EPSG:4326`。
  * - `projectionDefs`：可选，自定义 proj4 坐标系定义。
  * - `clipFeature`：可选，GeoJSON Polygon/MultiPolygon/Feature/FeatureCollection。
- * - `autoFitBounds`：可选，创建后自动将相机定位到最终渲染范围，需同时传入 `map`。
+ * - `autoFitBounds`：可选，创建后自动将相机定位到最终范围，需同时传入 `map`。
  * - `debug`：可选，`true` 使用 console.debug，函数则接收结构化调试事件。
  */
 /** 通用范围格式：[minX, minY, maxX, maxY]。 */
@@ -71,13 +72,19 @@ export type CustomRasterLayerDebugEvent = {
     level?: number;
     /** 当前瓦片范围，格式为 [west, south, east, north]。 */
     bbox?: CustomRasterBounds;
-    /** 用户传入的原始数据范围。 */
+    /** 用户传入的原始瓦片范围。 */
     bounds?: CustomRasterBounds;
-    /** 转换到 renderCrs 后的数据范围。 */
+    /** bounds 转换到 renderCrs 后的瓦片范围。 */
+    tileBounds?: CustomRasterBounds;
+    /** clipFeature 转换到 renderCrs 后通过 turf.bbox 生成的裁剪范围。 */
+    clipBounds?: CustomRasterBounds;
+    /** 最终用于瓦片调度的渲染范围。 */
     renderBounds?: CustomRasterBounds;
-    /** 原始数据坐标系。 */
+    /** bounds 原始坐标系。 */
     dataCrs?: string;
-    /** bounds、clipFeature 和瓦片范围使用的坐标系。 */
+    /** clipFeature 原始坐标系。 */
+    clipFeatureCrs?: string;
+    /** bounds、clipFeature 和瓦片范围转换后的目标坐标系。 */
     renderCrs?: string;
     /** 裁剪或丢弃原因。 */
     reason?: string;
@@ -108,11 +115,13 @@ export type CustomRasterLayerOptions = {
     source: CustomRasterSourceOptions;
     /** Cesium.ImageryLayer 原生配置。 */
     layerOptions?: Cesium.ImageryLayer.ConstructorOptions;
-    /** 数据范围，格式为 [minX, minY, maxX, maxY]；未传时默认使用 clipFeature bbox。 */
+    /** 瓦片范围，格式为 [minX, minY, maxX, maxY]，坐标系跟随 dataCrs。 */
     bounds?: CustomRasterBounds;
-    /** bounds 和 clipFeature 的原始坐标系，默认 EPSG:4326。 */
+    /** bounds 的原始坐标系，默认 EPSG:4326。 */
     dataCrs?: string;
-    /** bounds、clipFeature 和瓦片范围使用的坐标系，默认 EPSG:4326。 */
+    /** clipFeature 的原始坐标系，默认跟随 dataCrs。 */
+    clipFeatureCrs?: string;
+    /** bounds、clipFeature 和瓦片范围转换后的目标坐标系，默认 EPSG:4326。 */
     renderCrs?: string;
     /** 自定义 proj4 坐标系定义，key 可为 EPSG:xxxx 或其他 proj4 名称。 */
     projectionDefs?: Record<string, string>;

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 与裁剪面的交集，避免多面重叠时误裁。
@@ -76,12 +76,13 @@ import ImageryLayer from "./ImageryLayer";
  * @remarks API 文档
  * - `source`：必填，Cesium.UrlTemplateImageryProvider 原生配置。
  * - `layerOptions`：可选，Cesium.ImageryLayer 原生配置。
- * - `bounds`：可选，数据范围 `[minX, minY, maxX, maxY]`，未传时默认使用 turf 计算 clipFeature bbox。
- * - `dataCrs`：可选，bounds 与 clipFeature 的原始坐标系，默认 `EPSG:4326`。
- * - `renderCrs`：可选，bounds、clipFeature 和瓦片范围使用的坐标系，默认 `EPSG:4326`，支持 `GCJ02/gcj02/gcj-02`。
+ * - `bounds`：可选，瓦片范围 `[minX, minY, maxX, maxY]`。
+ * - `dataCrs`：可选，bounds 的原始坐标系，默认 `EPSG:4326`。
+ * - `clipFeatureCrs`：可选，clipFeature 的原始坐标系，默认跟随 dataCrs。
+ * - `renderCrs`：可选，bounds、clipFeature 和瓦片范围转换后的目标坐标系，默认 `EPSG:4326`。
  * - `projectionDefs`：可选，自定义 proj4 坐标系定义。
  * - `clipFeature`：可选，GeoJSON Polygon/MultiPolygon/Feature/FeatureCollection。
- * - `autoFitBounds`：可选，创建后自动将相机定位到最终渲染范围，需同时传入 `map`。
+ * - `autoFitBounds`：可选，创建后自动将相机定位到最终范围，需同时传入 `map`。
  * - `debug`：可选，`true` 使用 console.debug，函数则接收结构化调试事件。
  */
 
@@ -434,7 +435,7 @@ var collectPolygonFeatures = function collectPolygonFeatures(geoJson) {
   return [];
 };
 
-/** 使用 turf 计算裁剪面的 bbox，作为未显式传 bounds 时的默认调度范围。 */
+/** 使用 turf 计算裁剪面的 bbox，作为裁剪范围。 */
 var getClipFeatureBounds = function getClipFeatureBounds(clipFeatures) {
   if (!clipFeatures.length) {
     return undefined;
@@ -465,6 +466,7 @@ var CustomRasterLayer = /*#__PURE__*/function (_ImageryLayer) {
   var _super = _createSuper(CustomRasterLayer);
   /** 创建通用栅格图层。 */
   function CustomRasterLayer(options) {
+    var _options$map;
     var _this;
     _classCallCheck(this, CustomRasterLayer);
     if (!(options !== null && options !== void 0 && options.source)) {
@@ -472,17 +474,18 @@ 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,
       sourceOptionsRest = _objectWithoutProperties(_options$source, _excluded);
-    var renderBounds = options.bounds ? transformBounds(options.bounds, dataCrs, renderCrs) : undefined;
-    if (!renderBounds && !sourceOptionsRest.rectangle) {
-      renderBounds = getClipFeatureBounds(clipFeatures);
-    }
-    var fitBounds = renderBounds || (sourceOptionsRest.rectangle ? rectangleToBounds(sourceOptionsRest.rectangle) : undefined);
+    var tileBounds = options.bounds ? transformBounds(options.bounds, dataCrs, renderCrs) : undefined;
+    var clipBounds = getClipFeatureBounds(clipFeatures);
+    var renderBounds = clipBounds || tileBounds;
+    var sourceRectangleBounds = sourceOptionsRest.rectangle ? rectangleToBounds(sourceOptionsRest.rectangle) : undefined;
+    var fitBounds = clipBounds || tileBounds || sourceRectangleBounds;
     var tilingScheme = createRenderTilingScheme(createSourceTilingScheme(sourceTilingSchemeOption), renderCrs);
     var sourceOptions = _objectSpread(_objectSpread({}, sourceOptionsRest), {}, {
       tilingScheme: tilingScheme
@@ -507,15 +510,18 @@ var CustomRasterLayer = /*#__PURE__*/function (_ImageryLayer) {
     _this._debug = options.debug;
     _this._clipFeatures = clipFeatures;
     _this._fitBounds = fitBounds;
-    _this._mapContext = options.map._mapContext;
+    _this._mapContext = (_options$map = options.map) === null || _options$map === void 0 ? void 0 : _options$map._mapContext;
     _this.logDebug({
       type: 'range',
       bounds: options.bounds,
+      tileBounds: tileBounds,
+      clipBounds: clipBounds,
       renderBounds: renderBounds,
       dataCrs: dataCrs,
+      clipFeatureCrs: clipFeatureCrs,
       renderCrs: renderCrs
     });
-    if (options.autoFitBounds) {
+    if (options.autoFitBounds && normalizeBounds(fitBounds)) {
       _this.fitToBounds(options.map, options.fitBoundsOptions);
     }
     return _this;