npm - @mapgis/webclient-cesium-plugin - Versions diffs - 17.8.0 → 17.10.9 - Mend

@mapgis/webclient-cesium-plugin 17.8.0 → 17.10.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (227) hide show

package/{documention → documentation}/WebMapServiceImageryProvider.html RENAMED Viewed

@@ -94,22 +94,15 @@
     </div>
-    <p class="summary"><h5>请参考以下示例：</h5>
-<a href='#example1'>1、添加一个WMS图层：原生接口开发</a><br>
-<a href='#example2'>2、添加一个WMS图层：混合接口开发</a><br>
-<a href='http://10.10.130.72:8086/#/modules/cesium/layer/layerControl/image-layer-elevation-mode-setting' target='_blank'>3、影像图层高程模式设置</a><br>
-<a href='http://10.10.130.72:8086/#/modules/cesium/analyse/compareAnalyse/roller-shutter' target='_blank'>4、卷帘</a><br>
-<a href='http://10.10.130.72:8086/#/modules/cesium/sceneControl/scene/globe-independent-translucency' target='_blank'>5、地表透明度独立控制</a><br>
-<a href='http://10.10.130.72:8086/#/example-gallery/cesium#OGCLayer' target='_blank'>6、更多图层加载示例</a>
-<h5>支持如下方法：</h5>
-<a href='#fromUrl'>[1、通过WMS服务的url获取WebMapServiceImageryProvider对象]</a><br/></p>
 </dt>
 <dd>
     <div class="description">
         <p>WMS服务接入类，现已不支持通过构造函数(new WebMapServiceImageryProvider())的方式初始化图层，而是使用fromUrl方法构造图层</p>
+<p>该类用于将 OGC WMS 服务接入 Cesium 影像系统，并统一处理不同版本 WMS 的参数差异。
+推荐通过 <code>fromUrl</code> 初始化，自动获取服务元信息并映射到 Cesium WebMapServiceImageryProvider 参数。
+当需要控制坐标轴顺序时，可通过 <code>isReverseXY</code> 明确覆盖默认策略。</p>
     </div>
@@ -164,6 +157,7 @@
     <pre class="prettyprint"><code>// ES5引入方式
 const { WebMapServiceImageryProvider } = zondy.cesium
 // ES6引入方式
 import { WebMapServiceImageryProvider } from "@mapgis/webclient-cesium-plugin"
@@ -186,6 +180,7 @@ addWMSLayer(url)</code></pre>
     <pre class="prettyprint"><code>// ES5引入方式
 const { WMSLayer } = zondy.layer
 const { initializeOptions } = zondy.cesium.util
 // ES6引入方式
 import { initializeOptions } from "@mapgis/webclient-cesium-plugin"
 import { WMSLayer } from "@mapgis/webclient-common"
@@ -243,7 +238,7 @@ wmsLayer.load().then((layer) => {
         <div class="tag-source">
-            engineExtensions/scene/imageryProvider/WebMapServiceImageryProvider.js, line 117
+            engineExtensions/scene/imageryProvider/WebMapServiceImageryProvider.js, line 115
         </div>
     </div>
@@ -1209,6 +1204,7 @@ an array, each element in the array is a subdomain.</p></td>
     <pre class="prettyprint"><code>// ES5引入方式
 const { WebMapServiceImageryProvider } = zondy.cesium
 // ES6引入方式
 import { WebMapServiceImageryProvider } from "@mapgis/webclient-cesium-plugin"
@@ -1237,7 +1233,7 @@ addImageryProvider(url)</code></pre>
         <footer>
-            Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> on Wed Feb 04 2026 18:31:34 GMT+0800 (中国标准时间)
+            Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> on Sat Sep 12 2026 11:56:00 GMT+0800 (中国标准时间)
         </footer>
     </div>
 </div>

package/{documention → documentation}/WebMapServiceSingleImageryProvider.html RENAMED Viewed

@@ -88,7 +88,7 @@
         <div class="tag-source">
-            engineExtensions/scene/imageryProvider/WebMapServiceSingleImageryProvider.js, line 13
+            engineExtensions/scene/imageryProvider/WebMapServiceSingleImageryProvider.js, line 14
         </div>
     </div>
@@ -99,7 +99,9 @@
     <div class="description">
-        <p>WMS服务一张图出图接入类</p>
+        <p>WMS 单图出图影像提供器。</p>
+<p>该类用于把 MapGIS WMS 或 ArcGIS WMS 服务封装为 Cesium 单图出图 provider。
+适用于需要保留 WMS 自定义参数、CRS/SRS 配置和 bbox 顺序控制的场景。</p>
     </div>
@@ -146,7 +148,7 @@
             <td class="description last">
-                <p>初始化时的构造参数</p>
+                <p>初始化参数。</p>
 <table class="params">
@@ -196,7 +198,7 @@
-                <p>cesium视图对象</p></td>
+                <p>Cesium 视图对象。</p></td>
         </tr>
@@ -235,12 +237,15 @@
-                <p>服务的基地址，支持url字符串和Cesium.Resource两种类型，当类型为Cesium.Resource时，支持传入额外请求参数、请求头参数等，具体请参考<a href='http://10.10.130.72:8086/static/modules/cesium/api/cesium/Resource.html' target='_blank'>Cesium.Resource</a><br/>
-格式如下：<br>
-1、支持MapGIS的WMS服务，格式为：
-1.1、IGS1.0: http://{ip}:{port}/igs/rest/ogc/doc/{folder}:{serviceName}/WMSServer，<br/>
-1.2、IGS2.0: http://{ip}:{port}/igs/rest/services/{folder}/{serviceName}/WMSServer，参考示例：<a href='#MapIGS'>[加载MapGIS的WMS服务]</a><br/>
-2、支持ArcGIS的WMS服务，格式为：http://{ip}:{port}/arcgis/rest/services/{ServiceName}/WMSServer，参考示例：<a href='#ArcGIS'>[加载ArcGIS的WMS服务]</a></p></td>
+                <p>WMS 服务基地址。
+格式如下：</p>
+<ol>
+<li>MapGIS WMS：
+<code>http://{ip}:{port}/igs/rest/ogc/doc/{folder}:{serviceName}/WMSServer</code>
+<code>http://{ip}:{port}/igs/rest/services/{folder}/{serviceName}/WMSServer</code></li>
+<li>ArcGIS WMS：
+<code>http://{ip}:{port}/arcgis/rest/services/{serviceName}/WMSServer</code></li>
+</ol></td>
         </tr>
@@ -276,7 +281,7 @@
-                <p>地图图层显示范围，超出范围不会额外请求瓦片，<a href='http://10.10.130.72:8086/static/modules/cesium/api/cesium/index.html?classFilter=Rectangle' target='_blank'>详见Cesium.Rectangle</a></p></td>
+                <p>图层显示范围。</p></td>
         </tr>
@@ -312,7 +317,7 @@
-                <p>图层空间参考系</p></td>
+                <p>图层空间参考。</p></td>
         </tr>
@@ -348,7 +353,7 @@
-                <p>HTTP请求方式，&quot;GET&quot;、&quot;POST&quot;，默认为GET请求</p></td>
+                <p>HTTP 请求方式。</p></td>
         </tr>
@@ -384,7 +389,7 @@
-                <p>图层最小请求瓦片级别，小于该级别不再请求瓦片</p></td>
+                <p>最小请求级别。</p></td>
         </tr>
@@ -420,7 +425,7 @@
-                <p>图层最大请求瓦片级别，大于该级别不再请求瓦片</p></td>
+                <p>最大请求级别。</p></td>
         </tr>
@@ -456,7 +461,7 @@
-                <p>转发代理</p></td>
+                <p>转发代理。</p></td>
         </tr>
@@ -492,7 +497,7 @@
-                <p>动态图层信息</p></td>
+                <p>动态图层信息。</p></td>
         </tr>
@@ -528,7 +533,7 @@
-                <p>重载build2DImageResource方法，来重载瓦片的请求逻辑</p></td>
+                <p>自定义图片请求资源构造函数。</p></td>
         </tr>
@@ -567,7 +572,7 @@
-                <p>是否翻转出图范围bbox参数的x、y坐标。默认为null，程序会根据已知服务发布厂商的规则计算该值，如果用户设置了该值则以用户设置的为准。</p></td>
+                <p>是否翻转 bbox 中的 X/Y 顺序。</p></td>
         </tr>
@@ -603,7 +608,7 @@
-                <p>坐标系名称(CRS)，当WMS版本大于等于1.3.0时，使用该值</p></td>
+                <p>WMS 1.3.0 及以上使用的坐标系名称。</p></td>
         </tr>
@@ -639,7 +644,7 @@
-                <p>坐标系名称(SRS)，当WMS版本是1.1.0或者1.1.1时，使用该值</p></td>
+                <p>WMS 1.1.0/1.1.1 使用的坐标系名称。</p></td>
         </tr>
@@ -668,7 +673,7 @@
             <td class="description last">
-                <p>在GetMap URL中传递给WMS服务器的其他参数</p></td>
+                <p>额外附加到 GetMap 请求中的参数。</p></td>
         </tr>
@@ -713,6 +718,28 @@
+        <h5>Example</h5>
+    <pre class="prettyprint"><code>// ES5引入方式
+const { WebMapServiceSingleImageryProvider } = zondy.cesium
+// ES6引入方式
+import { WebMapServiceSingleImageryProvider } from '@mapgis/webclient-cesium-plugin'
+const imageryProvider = new WebMapServiceSingleImageryProvider({
+  viewer,
+  url: 'http://localhost:8089/igs/rest/services/Map/example/WMSServer',
+  parameters: {
+    format: 'image/png',
+    transparent: true
+  }
+})
+viewer.imageryLayers.addImageryProvider(imageryProvider)</code></pre>
 </dd>
@@ -741,12 +768,12 @@
     <div class="nameContainer">
         <h4 class="name" id="fromUrl">
-            fromUrl<span class="signature">(url, options)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{zondy.cesium.WebMapServiceSingleImageryProvider}</span>
+            fromUrl<span class="signature">(url, <span class="optional">options</span>)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{<a href="Promise.html">Promise</a>.&lt;<a href="WebMapServiceSingleImageryProvider.html">WebMapServiceSingleImageryProvider</a>>}</span>
         </h4>
         <div class="tag-source">
-            engineExtensions/scene/imageryProvider/WebMapServiceSingleImageryProvider.js, line 117
+            engineExtensions/scene/imageryProvider/WebMapServiceSingleImageryProvider.js, line 129
         </div>
     </div>
@@ -756,6 +783,10 @@
 <dd>
+    <div class="description">
+        <p>根据服务地址解析 WMS 元信息并返回新的 provider 实例。</p>
+    </div>
@@ -774,6 +805,8 @@
 		<th>Type</th>
+		<th>Default</th>
 		<th class="last">Description</th>
 	</tr>
@@ -800,10 +833,19 @@
             </td>
+                <td class="default">
+                </td>
             <td class="description last">
-                <p>服务的基地址，支持url字符串和Cesium.Resource两种类型，当类型为Cesium.Resource时，支持传入额外请求参数、请求头参数等，具体请参考<a href='http://10.10.130.72:8086/static/modules/cesium/api/cesium/Resource.html' target='_blank'>Cesium.Resource</a></p></td>
+                <p>WMS 服务基地址。</p></td>
         </tr>
@@ -823,10 +865,23 @@
             </td>
+                <td class="default">
+                    {}
+                </td>
             <td class="description last">
-                <p>实例化对象时提供的额外配置参数，若该对象中包含构造参数则会覆盖对应的构造参数</p></td>
+                        <span class="optional"> 可选</span>
+                <p>附加配置。若与服务元信息存在同名项，优先使用传入值。</p></td>
         </tr>
@@ -887,11 +942,11 @@
             <td class="type">
-                        zondy.cesium.WebMapServiceSingleImageryProvider
+                        <a href="Promise.html">Promise</a>.&lt;<a href="WebMapServiceSingleImageryProvider.html">WebMapServiceSingleImageryProvider</a>>
             </td>
-            <td class="description last">初始化完毕的WebMapServiceSingleImageryProvider对象</td>
+            <td class="description last">已初始化的 provider 实例。</td>
         </tr>
     </tbody>
@@ -902,11 +957,18 @@
         <h5>Example</h5>
-        <p class="code-caption"><h7 id='fromUrl'>通过ArcGIS地图服务的url获取WebMapServiceSingleImageryProvider对象</h7></p>
-    <pre class="prettyprint"><code>// ES5引入方式
  const imageryProvider = await WebMapServiceSingleImageryProvider.fromUrl(url)
  viewer.imageryLayers.addImageryProvider(imageryProvider)
+    <pre class="prettyprint"><code>// ES5引入方式
+const { WebMapServiceSingleImageryProvider } = zondy.cesium
+// ES6引入方式
+import { WebMapServiceSingleImageryProvider } from '@mapgis/webclient-cesium-plugin'
+const provider = await new WebMapServiceSingleImageryProvider({ viewer }).fromUrl(
+  'http://localhost:8089/igs/rest/services/Map/example/WMSServer'
+)
+viewer.imageryLayers.addImageryProvider(provider)</code></pre>
@@ -926,7 +988,7 @@
         <footer>
-            Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> on Wed Feb 04 2026 18:31:34 GMT+0800 (中国标准时间)
+            Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> on Sat Sep 12 2026 11:56:00 GMT+0800 (中国标准时间)
         </footer>
     </div>
 </div>

package/{documention → documentation}/WebMapTileServiceImageryProvider.html RENAMED Viewed

@@ -88,29 +88,21 @@
         <div class="tag-source">
-            engineExtensions/scene/imageryProvider/WebMapTileServiceImageryProvider.js, line 6
+            engineExtensions/scene/imageryProvider/WebMapTileServiceImageryProvider.js, line 5
         </div>
     </div>
-    <p class="summary"><h5>请参考以下示例：</h5>
-<a href='#example1'>1、添加一个WMTS图层：原生接口开发</a><br>
-<a href='#example2'>2、添加一个WMTS图层：混合接口开发</a><br>
-<a href='http://10.10.130.72:8086/#/modules/cesium/layer/layerControl/image-layer-elevation-mode-setting' target='_blank'>3、影像图层高程模式设置</a><br>
-<a href='http://10.10.130.72:8086/#/modules/cesium/analyse/compareAnalyse/roller-shutter' target='_blank'>4、卷帘</a><br>
-<a href='http://10.10.130.72:8086/#/modules/cesium/layer/internetLayer/tdt' target='_blank'>5、天地图</a><br>
-<a href='http://10.10.130.72:8086/#/modules/cesium/sceneControl/scene/globe-independent-translucency' target='_blank'>6、地表透明度独立控制</a><br>
-<a href='http://10.10.130.72:8086/#/example-gallery/cesium#OGCLayer' target='_blank'>7、更多图层加载示例</a>
-<h5>支持如下方法：</h5>
-<a href='#fromUrl'>[1、通过WMTS服务的url初始化WebMapTileServiceImageryProvider对象]</a><br/></p>
 </dt>
 <dd>
     <div class="description">
         <p>WMTS服务接入类，现已不支持通过构造函数(new WebMapTileServiceImageryProvider())的方式初始化图层，而是使用fromUrl方法构造图层</p>
+<p>该类用于将 OGC WMTS 服务封装为 Cesium 影像提供器，支持通过服务元信息自动匹配矩阵集和级别标签。
+推荐使用 <code>fromUrl</code> 进行初始化，以保证图层参数与服务端能力保持一致。
+可通过 <code>isStretchImage</code> 控制超层级拉伸策略，适配不同地图显示需求。</p>
     </div>
@@ -165,6 +157,7 @@
     <pre class="prettyprint"><code>// ES5引入方式
 const { WebMapTileServiceImageryProvider } = zondy.cesium
 // ES6引入方式
 import { WebMapTileServiceImageryProvider } from "@mapgis/webclient-cesium-plugin"
@@ -187,9 +180,10 @@ addWMTSLayer()</code></pre>
     <pre class="prettyprint"><code>// ES5引入方式
 const { WMTSLayer } = zondy.layer
 const { initializeOptions } = zondy.cesium.util
 // ES6引入方式
 import { initializeOptions } from "@mapgis/webclient-cesium-plugin"
-import { WMSLayer } from "@mapgis/webclient-common"
+import { WMTSLayer } from "@mapgis/webclient-common"
 // 定义WMTS图层服务的基地址
 const url = 'http://10.10.130.72:8089/igs/rest/services/Tile/HuBei_4326/WMTSServer'
@@ -244,7 +238,7 @@ wmtsLayer.load().then((layer) => {
         <div class="tag-source">
-            engineExtensions/scene/imageryProvider/WebMapTileServiceImageryProvider.js, line 117
+            engineExtensions/scene/imageryProvider/WebMapTileServiceImageryProvider.js, line 113
         </div>
     </div>
@@ -1166,6 +1160,7 @@ an array, each element in the array is a subdomain.</p></td>
     <pre class="prettyprint"><code>// ES5引入方式
 const { WebMapTileServiceImageryProvider } = zondy.cesium
 // ES6引入方式
 import { WebMapTileServiceImageryProvider } from "@mapgis/webclient-cesium-plugin"
@@ -1194,7 +1189,7 @@ addImageryProvider(url)</code></pre>
         <footer>
-            Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> on Wed Feb 04 2026 18:31:34 GMT+0800 (中国标准时间)
+            Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> on Sat Sep 12 2026 11:56:00 GMT+0800 (中国标准时间)
         </footer>
     </div>
 </div>